@caddis/cli 0.4.90 → 0.4.92

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/bundles/antigravity-plugin/plugin.json +1 -1
  2. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_exit.cpython-311.pyc +0 -0
  3. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_file_lock.cpython-311.pyc +0 -0
  4. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_frontmatter.cpython-311.pyc +0 -0
  5. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_redact.cpython-311.pyc +0 -0
  6. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_roadmap.cpython-311.pyc +0 -0
  7. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_rows.cpython-311.pyc +0 -0
  8. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_status.cpython-311.pyc +0 -0
  9. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_tidy.cpython-311.pyc +0 -0
  10. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_todo.cpython-311.pyc +0 -0
  11. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_workstreams.cpython-311.pyc +0 -0
  12. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_worktree_safety.cpython-311.pyc +0 -0
  13. package/bundles/antigravity-plugin/scripts/caddis_budget.py +26 -2
  14. package/bundles/antigravity-plugin/scripts/caddis_checkout_guard.py +31 -2
  15. package/bundles/antigravity-plugin/scripts/caddis_docs_pr.py +8 -0
  16. package/bundles/antigravity-plugin/scripts/caddis_gate.py +8 -8
  17. package/bundles/antigravity-plugin/scripts/caddis_guide.json +3 -3
  18. package/bundles/antigravity-plugin/scripts/caddis_handoff.py +73 -45
  19. package/bundles/antigravity-plugin/scripts/caddis_lanes.py +113 -31
  20. package/bundles/antigravity-plugin/scripts/caddis_review.py +1 -1
  21. package/bundles/antigravity-plugin/scripts/caddis_roadmap_run.py +22 -40
  22. package/bundles/antigravity-plugin/scripts/caddis_routing.py +1 -1
  23. package/bundles/antigravity-plugin/scripts/caddis_spend.py +121 -138
  24. package/bundles/antigravity-plugin/scripts/caddis_workstreams.py +60 -17
  25. package/bundles/antigravity-plugin/scripts/check_doc_coverage.py +17 -0
  26. package/bundles/antigravity-plugin/scripts/oss_review.py +102 -35
  27. package/bundles/antigravity-plugin/scripts/roadmap-recheck.ps1 +4 -2
  28. package/bundles/antigravity-plugin/scripts/schemas/hub-collect.schema.json +6 -0
  29. package/bundles/antigravity-plugin/scripts/schemas/hub-spend.schema.json +6 -0
  30. package/bundles/antigravity-plugin/scripts/templates/coordinator.md +1 -1
  31. package/bundles/antigravity-plugin/skills/coordinate/SKILL.md +17 -4
  32. package/bundles/antigravity-plugin/skills/cross-review/SKILL.md +18 -6
  33. package/bundles/antigravity-plugin/skills/feature-plan/SKILL.md +6 -1
  34. package/bundles/antigravity-plugin/skills/handoff/SKILL.md +12 -2
  35. package/bundles/antigravity-plugin/skills/implement/SKILL.md +11 -7
  36. package/bundles/antigravity-plugin/skills/roadmap/SKILL.md +8 -7
  37. package/bundles/antigravity-plugin/skills/roadmap/assets/plan-resume-prompt.md +2 -2
  38. package/bundles/antigravity-plugin-extras/plugin.json +1 -1
  39. package/bundles/antigravity-plugin-extras/skills/cross-review/SKILL.md +5 -5
  40. package/bundles/codex/.codex/skills/workflow/roadmap/SKILL.md +8 -7
  41. package/bundles/codex/.codex/skills/workflow/roadmap/assets/plan-resume-prompt.md +2 -2
  42. package/bundles/manifest.json +3 -3
  43. package/package.json +1 -1
@@ -80,10 +80,10 @@ python "$TOOL" --range origin/main..HEAD # review a branch's c
80
80
  ```
81
81
  Optional flags: `--cwd <repo>`, `--base-url <url>`, `--model <id>` (override the env).
82
82
 
83
- **Diff-size ceiling.** A diff over `REVIEW_MAX_DIFF_CHARS` (default 60,000 chars) is **split into batches** on whole-file boundaries and each batch reviewed separately (verdict is CLEAN only if every batch is). Exit 4 means a *single unsplittable file* over the ceiling, or too many batches — not an ordinary large diff. Previously it was refused before any LLM call
84
- *before* any LLM call — an oversized diff has been observed to come back either an empty response, or
85
- worse, a `REVIEW: CLEAN` with zero real engagement. If you hit this, narrow `--range` or review in
86
- smaller chunks; don't just raise `--max-diff-chars` without knowing the endpoint's real limit.
83
+ **Diff-size ceiling.** A diff over `REVIEW_MAX_DIFF_CHARS` (default 60,000 chars) is **split into batches** on whole-file boundaries and each batch reviewed separately (verdict is CLEAN only if every batch is). When agy Argon is anywhere in the provider chain, each batch is also kept small enough that its **whole prompt** fits the agy command line (28,000 chars once quoted, so under about 27,000 diff chars, fewer when the diff has many `"`). A *single file* too big for agy gets its own batch: agy skips it and the next provider reviews it; with no other provider (no DeepSeek or GLM key) that is exit 3. Exit 4 means a *single unsplittable file* over the 60,000 ceiling, or too many batches — not an ordinary large diff. The ceiling exists because an oversized diff has been observed to come back either an empty response, or
84
+ worse, a `REVIEW: CLEAN` with zero real engagement. If you hit this, review that file separately or narrow `--range`; don't just raise `--max-diff-chars` without knowing the endpoint's real limit.
85
+
86
+ **Verdict and scope.** Only the last non-empty line of the reply counts, and it must be exactly `REVIEW: CLEAN` or `REVIEW: BLOCKING`; a reply that quotes the marker earlier and ends some other way has no verdict (exit 4). An explicit `--range` with no changes is exit 3 (a review of nothing is not CLEAN); the working tree with no changes is still CLEAN. When the secret filter drops some files, the output ends with `REVIEW-SCOPE: PARTIAL (<n> file(s) excluded by the secret filter: <names>)` and then the overall `REVIEW:` line. The exit code does not change, but those files were not reviewed: say so, and never report it as a full CLEAN.
87
87
 
88
88
  ## Interpret the exit code
89
89
  - **0 — REVIEW: CLEAN** → no blocking issues. Proceed.
@@ -92,7 +92,7 @@ smaller chunks; don't just raise `--max-diff-chars` without knowing the endpoint
92
92
  Fix it, then re-review only the fix diff. After 3 rounds, ask the owner (rule 3).
93
93
  - **4 — error** → no verdict parsed, a git failure, or an endpoint/parse failure. Read stderr; do not
94
94
  treat this as CLEAN — investigate.
95
- - **3 — could not run** → no reviewer is available (no agy on PATH and no API key), or every provider failed. Fix it (see Prerequisites) and re-run.
95
+ - **3 — could not run** → no reviewer is available (no agy on PATH and no API key), an explicit `--range` has no changes, or every provider failed. Fix it (see Prerequisites) and re-run.
96
96
 
97
97
  ## Three rules: one attempt, one review
98
98
  1. **Think before you send.** Before a task goes to any coder, write its edge cases and check the facts it depends on (one query or one file read).
@@ -183,7 +183,8 @@ unattended; `-Plan <slug>` runs one plain plan instead (the two are exclusive).
183
183
  and deletes the claim.
184
184
  CONTINUE with the phase already merged on origin: `rollup` when every phase is merged, then back to 1. CONTINUE
185
185
  with no new commits and nothing merged stops FAILED. `STATUS: OWNER-GATE <r>` becomes an `owner-gate` blocker,
186
- `STATUS: BLOCKED <r>` an `external` one; then back to 1. `STATUS: FAILED` stops.
186
+ `STATUS: BLOCKED <r>` an `external` one; then back to 1. `STATUS: FAILED` stops. A relay the session did not
187
+ change (the same hash as before it, whatever its status line) stops `FAILED no relay written`.
187
188
  5. Every `**Risk:** high` phase done on the branch and not yet reviewed clean (record in the runner's own folder:
188
189
  `<git common dir>/caddis-runner/roadmap-<slug>/reviewed/<plan>.json`; another runner's record does not count) is
189
190
  reviewed BEFORE step 4 writes the claim and publishes
@@ -192,9 +193,9 @@ unattended; `-Plan <slug>` runs one plain plan instead (the two are exclusive).
192
193
  code `BLOCKED review not run` (neither restartable); the review cost counts against the USD caps.
193
194
 
194
195
  Stops (each one notifies and releases the lock): a STOP file (`~/.caddis/STOP` or `.local/STOP`), any cap (10 h,
195
- 12 sessions, 120 min and USD 25 per session, USD 150 total; per run, in memory; the global agy spend cap of
196
- `caddis_spend.py` still counts across runs), a lock or batch claim that cannot be written
197
- (`BLOCKED claim not written`, before any session), the agy spend cap refusing a reservation, three sessions
196
+ 12 sessions, 120 min and USD 25 per session, USD 150 total; per run, in memory; there is no agy EUR cap since
197
+ 1 Nov 2026, only the usage log of `caddis_spend.py` and its ADVISORY line), a lock or batch claim that cannot be written
198
+ (`BLOCKED claim not written`, before any session), an agy usage log that cannot be locked or written, three sessions
198
199
  with no newly merged phase, a roadmap write that fails, and the **snapshot guard**: one baseline for the whole run.
199
200
  The Milestones and Blockers tables (every cell of every row, rows added, removed or moved), the `Runner host` line
200
201
  and the `**Exit setup:**` line are frozen. Every origin read (each `next`, after the runner's own writes, after each session) is compared with the
@@ -249,8 +250,8 @@ the owner edits the roadmap during a merge wait, the restart stops `FAILED roadm
249
250
  recovery: `roadmap-run.ps1 -Roadmap <slug> -AcceptRoadmap` (owner only, refused headless) takes the runner lock (a live
250
251
  runner refuses it), prints the diff from the published baseline, asks you to type `accept` (or `--yes`), and accepts
251
252
  the origin roadmap as the new baseline of the wait; the next start goes on. With `-DryRun` it prints the diff only. `--last-stop` uses `--gh-account`, else the account the run recorded
252
- in its launch options. In all cases the lock must be absent or stale; for the agy engine `caddis_spend.py check` must exit 0 too (a
253
- claude-engine roadmap needs no spend-cap file). A restart after a merge writes `pending-rollup.json` in its runner
253
+ in its launch options. In all cases the lock must be absent or stale; for the agy engine `caddis_spend.py check` must exit 0 too (it
254
+ always does unless the script fails; there is no spend cap). A restart after a merge writes `pending-rollup.json` in its runner
254
255
  folder, runs the rollup first, then removes the claim and the branch, and only then the file. Every stop records
255
256
  itself: a failed rollup, a crash or a STOP file before that is not restartable (the owner decides), and the next start
256
257
  finds the file and does the rollup first. A merged
@@ -271,7 +272,7 @@ Sessions are cooperative (our own sessions): the runner guards against mistakes
271
272
  deliberately hostile session, which runs as the same OS user and could change anything the runner can. The state
272
273
  tripwire catches accidents in a runner's own state only. In particular, a session in another worktree of the repo can
273
274
  delete or rewrite ANOTHER runner's claim or lock under `<git common dir>/caddis-runner/`; that is not caught while it
274
- happens, and the victim runner fails closed only at its next restart (own claim missing or changed, orphaned claim). Caps are per run; the agy spend cap is the only limit across runs. Each roadmap has one
275
+ happens, and the victim runner fails closed only at its next restart (own claim missing or changed, orphaned claim). Caps are per run; nothing limits spend across runs (the agy usage log only advises). Each roadmap has one
275
276
  worktree, removed when the roadmap is finished and the worktree is clean.
276
277
 
277
278
  Owner-only rules are enforced by this tool; a direct PR that edits `roadmap.md` bypasses them; the runner stops
@@ -44,8 +44,8 @@ publish a branch that does). Commit the phase there, with its tracker row set to
44
44
  ## 4. Work
45
45
 
46
46
  - Do ONE batch with `/caddis:implement` discipline: tests first, the phase's exit gate, a commit per phase.
47
- - agy sessions only: run `python {{scripts}}/caddis_spend.py check` before each agy call. Stop at the cap (exit 1 over
48
- the cap, 3 not configured).
47
+ - agy sessions only: run `python {{scripts}}/caddis_spend.py check` before each agy call. There is no spend cap (it
48
+ always exits 0); if its line ends with ` - ADVISORY`, say so in the relay for the owner.
49
49
  - You may do everything except pass an owner gate. Never pass an owner gate. Never raise a cap. Never delete a STOP file.
50
50
  - The runner reviews `risk: high` phases. A phase marked `**Risk:** high`: do not halt for it and do not run the
51
51
  review yourself. When its exit gate is green, set its row `done` and end with `STATUS: CONTINUE`. The runner then
@@ -1,8 +1,8 @@
1
1
  {
2
- "poolVersion": "1.3.174",
2
+ "poolVersion": "1.3.176",
3
3
  "bundles": {
4
- "antigravity-plugin": "1.3.174",
5
- "antigravity-plugin-extras": "1.3.48",
4
+ "antigravity-plugin": "1.3.176",
5
+ "antigravity-plugin-extras": "1.3.49",
6
6
  "codex": "unknown"
7
7
  }
8
8
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@caddis/cli",
3
- "version": "0.4.90",
3
+ "version": "0.4.92",
4
4
  "description": "Install, update and diagnose the caddis dev harness across every coding agent you use (Claude Code, agy/Antigravity, and more).",
5
5
  "keywords": [
6
6
  "caddis",