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
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# list, search, show, validate

Inspection built-ins over the preferred tree. They do not run `exec` leaves.

## `jan list`

List script leaves (nodes that look like script entries: typically a `run` child).

```bash
jan list
jan list --category files
jan list --format names
```

| Flag | Description |
|------|-------------|
| `--category NAME` | Only scripts under this category segment (case-insensitive) |
| `--format FMT` | `table` (default) or `names` |

## `jan search`

Find script leaves by name, about text, or category. At least one filter is required. Patterns are case-insensitive substrings.

```bash
jan search --keyword git
jan search --name sum --category misc
```

| Flag | Description |
|------|-------------|
| `--name PAT` | Match script name |
| `--about PAT` | Match about / description |
| `--category NAME` | Exact category segment |
| `--keyword PAT` | Match name or about |

## `jan show`

Print details for a script leaf (name, chain, run line, category, about, deps, requires, env, inputs, cron, source include, exec form, packages).

```bash
jan show sum
jan show csv-summary
```

Ambiguous names list matching chains. Unknown names suggest similar leaves.

## `jan validate`

Load-time checks for the preferred tree: node constraints, declared include hashes, package path existence, missing `about` on script leaves.

```bash
jan validate
jan validate --requires
```

`--requires` also reports missing host binaries in `requires` and unset `env.private` variables.