jan-cli 0.27.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

# Command tests

Optional `tests:` on any command node. Names must follow `given_…_when_…_then_…` (spaces or hyphens are fine). `jan test <path>` runs that node and every nested descendant.

```yaml
commands:
  android:
    commands:
      skills:
        commands:
          list:
            about: List skills (demo)
            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"
```

## Fields

| Field | Meaning |
|-------|---------|
| `given` | Optional setup (files, fixtures). Runs in a temp dir as POSIX `sh`. |
| `when` | Extra argv for the command the test is declared on. **Do not** repeat the script path. Omit to invoke that command with no extra args. |
| `then` | Required. Assertions against the captured result and any files from `given`. |

`when` is extra argv only — jan already knows which command the test hangs off.

## Captured environment for `then`

| Variable | Content |
|----------|---------|
| `JAN_STATUS` | Exit code of the `when` invocation |
| `JAN_STDOUT` | Captured stdout |
| `JAN_STDERR` | Captured stderr |

Result lines print the script path and the test name (`ok` / `not ok`). `jan test` never writes the audit log (`--no-log` is implied, including nested `jan` invocations).

CLI: [`jan test`](../cli/test.md).