@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.
- package/bundles/antigravity-plugin/plugin.json +1 -1
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_exit.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_file_lock.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_frontmatter.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_redact.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_roadmap.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_rows.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_status.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_tidy.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_todo.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_workstreams.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/__pycache__/caddis_worktree_safety.cpython-311.pyc +0 -0
- package/bundles/antigravity-plugin/scripts/caddis_budget.py +26 -2
- package/bundles/antigravity-plugin/scripts/caddis_checkout_guard.py +31 -2
- package/bundles/antigravity-plugin/scripts/caddis_docs_pr.py +8 -0
- package/bundles/antigravity-plugin/scripts/caddis_gate.py +8 -8
- package/bundles/antigravity-plugin/scripts/caddis_guide.json +3 -3
- package/bundles/antigravity-plugin/scripts/caddis_handoff.py +73 -45
- package/bundles/antigravity-plugin/scripts/caddis_lanes.py +113 -31
- package/bundles/antigravity-plugin/scripts/caddis_review.py +1 -1
- package/bundles/antigravity-plugin/scripts/caddis_roadmap_run.py +22 -40
- package/bundles/antigravity-plugin/scripts/caddis_routing.py +1 -1
- package/bundles/antigravity-plugin/scripts/caddis_spend.py +121 -138
- package/bundles/antigravity-plugin/scripts/caddis_workstreams.py +60 -17
- package/bundles/antigravity-plugin/scripts/check_doc_coverage.py +17 -0
- package/bundles/antigravity-plugin/scripts/oss_review.py +102 -35
- package/bundles/antigravity-plugin/scripts/roadmap-recheck.ps1 +4 -2
- package/bundles/antigravity-plugin/scripts/schemas/hub-collect.schema.json +6 -0
- package/bundles/antigravity-plugin/scripts/schemas/hub-spend.schema.json +6 -0
- package/bundles/antigravity-plugin/scripts/templates/coordinator.md +1 -1
- package/bundles/antigravity-plugin/skills/coordinate/SKILL.md +17 -4
- package/bundles/antigravity-plugin/skills/cross-review/SKILL.md +18 -6
- package/bundles/antigravity-plugin/skills/feature-plan/SKILL.md +6 -1
- package/bundles/antigravity-plugin/skills/handoff/SKILL.md +12 -2
- package/bundles/antigravity-plugin/skills/implement/SKILL.md +11 -7
- package/bundles/antigravity-plugin/skills/roadmap/SKILL.md +8 -7
- package/bundles/antigravity-plugin/skills/roadmap/assets/plan-resume-prompt.md +2 -2
- package/bundles/antigravity-plugin-extras/plugin.json +1 -1
- package/bundles/antigravity-plugin-extras/skills/cross-review/SKILL.md +5 -5
- package/bundles/codex/.codex/skills/workflow/roadmap/SKILL.md +8 -7
- package/bundles/codex/.codex/skills/workflow/roadmap/assets/plan-resume-prompt.md +2 -2
- package/bundles/manifest.json +3 -3
- 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.
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
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;
|
|
196
|
-
`caddis_spend.py`
|
|
197
|
-
(`BLOCKED claim not written`, before any session),
|
|
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 (
|
|
253
|
-
|
|
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;
|
|
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.
|
|
48
|
-
the
|
|
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
|
package/bundles/manifest.json
CHANGED
package/package.json
CHANGED