qctl 0.4.0

Control in-repo YAML work queues
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

# qctl

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/banner-dark.svg">
  <img src="docs/banner.svg" alt="qctl — In-repo YAML work queues. One file, one active task.">
</picture>

Control in-repo YAML work queues. One file, one active task, file order is
priority. Replaces copied Ajv `test:ledger` scripts.

Every command returns typed data through ctl-core. Human output is pretty by
default; `--color never` or `--no-color` keeps the same layout without ANSI,
`--format json` emits the report as one JSON line, and `--quiet` suppresses
successful human output only. `-f` remains the ledger-file shorthand.

```sh
mise run q check
mise run q status
mise run q status --format json
mise run q check --format json
mise run q add -t 'Title' -s repo -o 'Done when…' -a 'Acceptance'
mise run q start OMX-001
mise run q archive OMX-001 -e 'Shipped.'
```

Consumer mise catalog — copy [`examples/mise.toml`](examples/mise.toml), which
pins the tool and the task include to the same release:

```toml
[task_config]
includes = [
  "git::https://github.com/victor-software-house/qctl.git//tasks/q?ref=v0.4.0",
  "mise-tasks",
]
```

Install:

```sh
cargo install qctl --locked
# or the native tarball:
mise x github:victor-software-house/qctl@0.4.0 -- qctl --version
```

Do not name this `taskctl` (existing Go Make alternative) or `pi-tasks`
(different VSH TypeScript product).