Filbert approved round 1 (f167b85e). Manifest 782bcb62, 21 files, plus the QUEUE.md markers and the TOOLS.md section. Lead decision 35. Co-Authored-By: Claude Opus 5.5 <[email protected]>
30 lines
1.3 KiB
Diff
30 lines
1.3 KiB
Diff
diff --git a/docs/TOOLS.md b/docs/TOOLS.md
|
|
index 5f993af0..02e0de9e 100644
|
|
--- a/docs/TOOLS.md
|
|
+++ b/docs/TOOLS.md
|
|
@@ -147,6 +147,24 @@ npm-global `mosaic` CLI; run by path. Exit codes: the launch script's own
|
|
once it runs; before that 1 could not start, 2 invalid config or seat, 4
|
|
usage. Details and the record's fields: `packages/seat/README.md`.
|
|
|
|
+## Work queue (`scripts/mosaic queue`)
|
|
+
|
|
+```bash
|
|
+scripts/mosaic queue list | show ID | next [SEAT]
|
|
+scripts/mosaic queue add|move|release|assign|note|set ... --op ID [--by NAME]
|
|
+scripts/mosaic queue verify [--current] | render [--check] | sync | unlock [--check-gate]
|
|
+scripts/queue-commit.sh -m MSG
|
|
+```
|
|
+
|
|
+`docs/plans/queue.json` holds the rows and an append-only log; the table in
|
|
+`docs/plans/QUEUE.md` between the `mosaic-queue` markers is rendered from it.
|
|
+Canonical checkout only. Every change needs an `--op ID` chosen before the
|
|
+first attempt and reused on retry; only an op whose `ok <op> rev N` receipt
|
|
+printed is done. The lead commits queue changes with `scripts/queue-commit.sh`;
|
|
+the pre-commit guard refuses any other commit that stages the two queue files.
|
|
+Exit codes: `0` ok · `1` failed · `2` invalid or refused · `3` uncertain,
|
|
+retry the same op · `4` usage. Details: `packages/queue/README.md`.
|
|
+
|
|
## Discord connector (`scripts/discord.sh`)
|
|
|
|
```bash
|