jan-cli 0.16.0

YAML-defined CLI trees with progressive help, optional exec aliases, merged extra specs, and SQLite audit logging keyed by git branch
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

metadata:
  name: jan
  description: |
    Example YAML spec for `jan-cli`: nested subcommands, progressive `--help`,
    optional `exec` aliases, and SQLite audit logging keyed by git branch.

commands:
  android:
    about: |
      Android-related workflows (illustrative tree only).
    commands:
      skills:
        about: Skill discovery and maintenance.
        commands:
          list:
            about: List skills (demo — runs echo).
            exec:
              argv: ["echo", "jan", "android", "skills", "list"]
            tests:
              given_no_args_when_listed_then_prints_path:
                then: |
                  test "$JAN_STATUS" -eq 0
                  printf '%s\n' "$JAN_STDOUT" | grep -q "jan android skills list"
          search:
            about: Search with extra CLI args forwarded to the child process.
            exec:
              argv: ["echo", "search"]
              passthrough: true

  # Script-style entry with PATH and utility requirements (see `jan-cli` README).
  sample-script:
    about: Example script with dependency PATH and external tools.
    path: ./bin/sample-script
    dependencies: [other-script]
    requires: [fzf]
    env:
      JAN_SAMPLE: "1"
    commands:
      run:
        about: Run the script; jan prepends dependency dirs and checks `requires`.
        exec:
          argv: ["bash", "-lc", "echo run"]
          passthrough: true