@caddis/cli 0.4.108 → 0.4.109

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 (27) 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_guide.json +4 -4
  14. package/bundles/antigravity-plugin/scripts/caddis_lanes.py +4 -4
  15. package/bundles/antigravity-plugin/scripts/caddis_roadmap_run.py +4 -4
  16. package/bundles/antigravity-plugin/scripts/caddis_routing.py +2 -2
  17. package/bundles/antigravity-plugin/scripts/oss_review.py +20 -18
  18. package/bundles/antigravity-plugin/skills/_registry.md +1 -1
  19. package/bundles/antigravity-plugin/skills/cross-review/SKILL.md +8 -8
  20. package/bundles/antigravity-plugin/skills/implement/SKILL.md +1 -1
  21. package/bundles/antigravity-plugin/skills/use-model/SKILL.md +1 -1
  22. package/bundles/antigravity-plugin-extras/plugin.json +1 -1
  23. package/bundles/antigravity-plugin-extras/skills/_registry.md +1 -1
  24. package/bundles/antigravity-plugin-extras/skills/agent-orchestration/SKILL.md +2 -2
  25. package/bundles/antigravity-plugin-extras/skills/cross-review/SKILL.md +7 -7
  26. package/bundles/manifest.json +3 -3
  27. package/package.json +1 -1
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "caddis",
3
- "version": "1.3.192",
3
+ "version": "1.3.193",
4
4
  "description": "caddis — agent-agnostic dev harness as an Antigravity (agy) plugin: TDD skills + commands, single-sourced with the Claude Code plugin."
5
5
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema": 1,
3
- "version": "1.3.191",
4
- "generated": "2026-11-12 01:33 UTC",
3
+ "version": "1.3.192",
4
+ "generated": "2026-11-12 16:20 UTC",
5
5
  "commands": [
6
6
  {
7
7
  "name": "add-rules",
@@ -158,7 +158,7 @@
158
158
  },
159
159
  {
160
160
  "name": "cross-review",
161
- "description": "Cross-vendor code review of the current diff — a second-vendor model (agy Argon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses",
161
+ "description": "Cross-vendor code review of the current diff — a second-vendor model (agy Carbon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses",
162
162
  "hint": "[git range, e.g. origin/main..HEAD]",
163
163
  "steps": [
164
164
  [
@@ -1661,7 +1661,7 @@
1661
1661
  {
1662
1662
  "name": "cross-review",
1663
1663
  "category": "coding",
1664
- "description": "Have a different vendor's model (agy Argon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff.",
1664
+ "description": "Have a different vendor's model (agy Carbon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff.",
1665
1665
  "core": false
1666
1666
  },
1667
1667
  {
@@ -77,7 +77,7 @@ DEFAULT_MODELS = {
77
77
  "glm": "glm-5.3[1m]",
78
78
  "codex-sol": "gpt-5.6-sol",
79
79
  "codex-astra": "gpt-6-astra",
80
- "agy": "gemini-4-argon",
80
+ "agy": "gemini-4-carbon", # owner, 12 Nov 2026: Carbon high (was Argon medium)
81
81
  }
82
82
  AGY_FALLBACK_MODEL = "gemini-3.8-flash" # used when `agy models` does not offer the default (other teams)
83
83
  AGY_PROBE_TIMEOUT_S = 30
@@ -87,7 +87,7 @@ DEFAULT_EFFORT = {
87
87
  "glm": "medium",
88
88
  "codex-sol": "medium",
89
89
  "codex-astra": "high",
90
- "agy": "medium",
90
+ "agy": "high",
91
91
  }
92
92
  DEFAULT_CHAINS = {
93
93
  "backend": ("glm", "codex-sol", "claude"),
@@ -1198,8 +1198,8 @@ def _probe_agy_models() -> str:
1198
1198
  return listing
1199
1199
 
1200
1200
 
1201
- # The agy default is used at three effort levels: ci-watch uses -low, lanes -medium, review -high. Keep it only
1202
- # when `agy models` offers all three exact ids.
1201
+ # The agy default is used at three effort levels: ci-watch uses -low, lanes and review -high, and a plan phase may
1202
+ # ask for -medium. Keep it only when `agy models` offers all three exact ids.
1203
1203
  AGY_DEFAULT_EFFORT_IDS = ("low", "medium", "high")
1204
1204
  _AGY_FALLBACK_NOTED = False
1205
1205
 
@@ -154,7 +154,7 @@ import caddis_workstreams # noqa: E402
154
154
 
155
155
  ENGINES: dict[str, dict] = {
156
156
  "claude": {"live_tested": True, "default_model": "opus", "limit_key": "claude"},
157
- "agy": {"live_tested": False, "default_model": "gemini-4-argon-medium", "limit_key": "agy"},
157
+ "agy": {"live_tested": False, "default_model": "gemini-4-carbon-high", "limit_key": "agy"},
158
158
  "codex": {"live_tested": False, "default_model": "gpt-5", "limit_key": "codex-sol"},
159
159
  }
160
160
  PROMPT_ON_STDIN = {"claude"}
@@ -392,7 +392,7 @@ def parse_result(stdout: str) -> dict | None:
392
392
 
393
393
 
394
394
  def _agy_engine_model(repo: Path) -> str:
395
- """`<agy model>-medium`: the `[lanes.models] agy` pin in `<repo>/.caddis/config.toml` when set, else the default
395
+ """`<agy model>-high`: the `[lanes.models] agy` pin in `<repo>/.caddis/config.toml` when set, else the default
396
396
  agy model as `agy models` offers it here (see caddis_lanes.resolve_models)."""
397
397
  try:
398
398
  try:
@@ -400,7 +400,7 @@ def _agy_engine_model(repo: Path) -> str:
400
400
  except ModuleNotFoundError:
401
401
  sys.path.insert(0, str(_HERE))
402
402
  import caddis_lanes
403
- return caddis_lanes.resolve_models(caddis_lanes.load_lanes_config(repo))["agy"] + "-medium"
403
+ return caddis_lanes.resolve_models(caddis_lanes.load_lanes_config(repo))["agy"] + "-high"
404
404
  except Exception: # the lane engine is missing or the config is bad: the display default
405
405
  return ENGINES["agy"]["default_model"]
406
406
 
@@ -1239,7 +1239,7 @@ def run(*, repo: Path, plan: str | None = None, roadmap: str | None = None, caps
1239
1239
  if engine not in ENGINES:
1240
1240
  print(f"caddis_roadmap_run: unknown engine {engine!r}", file=sys.stderr)
1241
1241
  return caddis_exit.ERROR
1242
- if not model and engine == "agy": # the model this machine offers (Argon, else the fallback); the table is display only
1242
+ if not model and engine == "agy": # the model this machine offers (Carbon, else the fallback); the table is display only
1243
1243
  model = _agy_engine_model(repo)
1244
1244
  model = model or ENGINES[engine]["default_model"]
1245
1245
  template = prompt_template or find_prompt_template(target.prompt_name)
@@ -39,10 +39,10 @@ SESSION_DEFAULTS: dict[str, tuple[str, str]] = {
39
39
  "coordinator": ("sonnet", "low"),
40
40
  "measure": ("sonnet", "medium"),
41
41
  "critical-phase": ("opus", "medium"),
42
- "coding-phase": ("agy", "medium"),
42
+ "coding-phase": ("agy", "high"),
43
43
  "mechanical-phase": ("haiku", "low"),
44
44
  }
45
- AGY_MODEL_BY_EFFORT: dict[str, str] = {"medium": "gemini-4-argon-medium", "high": "gemini-4-argon-high"}
45
+ AGY_MODEL_BY_EFFORT: dict[str, str] = {"medium": "gemini-4-carbon-medium", "high": "gemini-4-carbon-high"}
46
46
  CLAUDE_SESSION_MODELS = frozenset({"opus", "sonnet", "haiku"})
47
47
 
48
48
 
@@ -3,15 +3,15 @@
3
3
 
4
4
  A different vendor's model has different blind spots, so a second model reviewing your diff
5
5
  catches bugs a same-vendor reviewer misses. This tool is provider-agnostic: point it at
6
- agy Argon (default since 2026-10-21; needs no key), DeepSeek (cheap, architecturally distinct from
6
+ agy Carbon (agy default since 2026-10-21, Carbon since 2026-11-12; needs no key), DeepSeek (cheap, architecturally distinct from
7
7
  Claude), GLM, OpenRouter, or any OpenAI-compatible `/chat/completions` endpoint via three env vars.
8
8
 
9
9
  Config precedence (highest wins): explicit CLI flag > env var > provider preset.
10
- REVIEW_PROVIDER preset name: agy-argon | deepseek | glm | openrouter (default agy-argon)
10
+ REVIEW_PROVIDER preset name: agy-carbon | deepseek | glm | openrouter (default agy-carbon; agy-argon is an old name)
11
11
  precedence: --provider flag, process env, then REVIEW_PROVIDER in ~/.caddis/keys.env
12
12
  REVIEW_BASE_URL base URL, no trailing /chat/completions (overrides the preset's URL)
13
13
  REVIEW_MODEL model id (overrides the preset's model)
14
- REVIEW_API_KEY bearer token (REQUIRED for an HTTP provider; agy-argon needs none)
14
+ REVIEW_API_KEY bearer token (REQUIRED for an HTTP provider; agy-carbon needs none)
15
15
 
16
16
  Future-proofing: model ids and endpoints churn. Two layers protect against that — (1) the PROVIDERS
17
17
  table below is the ONE place a renamed model/URL is edited; (2) REVIEW_MODEL / REVIEW_BASE_URL env
@@ -48,7 +48,7 @@ verdict (exit 4). When the secret filter drops some files, the output ends with
48
48
  `REVIEW:` line. The exit code is unchanged; a caller that needs the whole change reviewed looks
49
49
  for that exact text.
50
50
 
51
- Provider chain (owner policy, 2026-10-21; was deepseek first from 2026-10-16): agy-argon -> deepseek -> glm.
51
+ Provider chain (owner policy, 2026-10-21; was deepseek first from 2026-10-16): agy-carbon -> deepseek -> glm.
52
52
  A named --provider goes first, then the rest in policy order; a provider with no key (or no agy on PATH)
53
53
  is skipped. With no provider named, the chain starts at the first provider that is available. A provider failure
54
54
  moves to the next provider and never splits the diff. On HTTP 429 a `Retry-After` is honoured ONCE per
@@ -68,7 +68,7 @@ narrower case: a SINGLE file larger than the ceiling, which cannot be split, or
68
68
  MAX_REVIEW_BATCHES. Refusal was the original behaviour and is kept for those two - a silent false
69
69
  CLEAN is the worst outcome this tool has - but it no longer fires on an ordinary large phase diff.
70
70
 
71
- agy limit: when agy-argon is anywhere in the provider chain, each batch is ALSO packed so its whole
71
+ agy limit: when agy-carbon is anywhere in the provider chain, each batch is ALSO packed so its whole
72
72
  prompt (fixed text, the file list of a multi-batch run, the diff) fits AGY_MAX_PROMPT_CHARS (28,000)
73
73
  as quoted on the command line, so batches are smaller (under about 27,000 diff chars; fewer when the diff has many `"`). A single file
74
74
  whose prompt cannot fit gets its own batch: agy skips it and the next provider reviews it; with no
@@ -122,7 +122,7 @@ PROVIDERS: dict[str, dict[str, str]] = {
122
122
  # a key-lookup and label default only; it is NOT the review order (see REVIEW_ORDER).
123
123
  HTTP_DEFAULT_PROVIDER = "deepseek"
124
124
 
125
- # The review chain, in owner-policy order (2026-10-21): agy Argon, then DeepSeek, then GLM. A named
125
+ # The review chain, in owner-policy order (2026-10-21): agy, then DeepSeek, then GLM. A named
126
126
  # provider goes first and the rest follow in this order; a custom endpoint (REVIEW_BASE_URL /
127
127
  # REVIEW_MODEL) never falls back, because its owner named exactly who reviews.
128
128
  #
@@ -133,17 +133,18 @@ HTTP_DEFAULT_PROVIDER = "deepseek"
133
133
  # sessions recorded "cross-review inconclusive" and moved on. A review that silently does not
134
134
  # happen is the same failure class as a diff that silently is not read.
135
135
  #
136
- # Order matters: agy Argon leads since 2026-10-21 (owner decision) because DeepSeek ran out of credit,
137
- # so every unnamed review tried DeepSeek first and failed before it reached Argon. DeepSeek stays
136
+ # Order matters: agy leads since 2026-10-21 (owner decision) because DeepSeek ran out of credit,
137
+ # so every unnamed review tried DeepSeek first and failed before it reached agy. DeepSeek stays
138
138
  # second: it has actually found real bugs (a date-boundary bug two same-vendor passes missed, an
139
139
  # anchor bug, an orphaned-permission-rows bug). GLM is the spare tyre, not a co-equal — an alternation
140
140
  # policy that sends half the phases to a provider that times out buys variety it never actually collects.
141
- AGY_PROVIDER = "agy-argon"
141
+ AGY_PROVIDER = "agy-carbon"
142
+ AGY_OLD_NAMES = frozenset({"agy-argon"}) # the agy reviewer's name until 2026-11-12; still accepted
142
143
  DEFAULT_PROVIDER = AGY_PROVIDER
143
144
  REVIEW_ORDER: tuple[str, ...] = (AGY_PROVIDER, "deepseek", "glm")
144
145
 
145
146
  # agy runs headless through caddis_spend.py run: plan mode (it needs no tools, the diff is in the prompt).
146
- AGY_MODEL = "gemini-4-argon-high"
147
+ AGY_MODEL = "gemini-4-carbon-high" # owner, 12 Nov 2026 (was gemini-4-argon-high)
147
148
  AGY_TIMEOUT_S = 15 * 60
148
149
  # The prompt is one command-line argument (`--print=<prompt>`). A Windows command line holds at most
149
150
  # 32,767 characters, so a larger prompt skips agy instead of failing to start. The limit applies to the
@@ -290,7 +291,8 @@ def named_provider(args: argparse.Namespace, env: dict[str, str]) -> str:
290
291
  chosen = args.provider or env.get("REVIEW_PROVIDER")
291
292
  if not chosen:
292
293
  chosen = _parse_keys_file(env.get("CADDIS_KEYS_FILE") or DEFAULT_KEYS_FILE).get("REVIEW_PROVIDER")
293
- return (chosen or "").strip().lower()
294
+ chosen = (chosen or "").strip().lower()
295
+ return AGY_PROVIDER if chosen in AGY_OLD_NAMES else chosen
294
296
 
295
297
 
296
298
  def resolve_config(
@@ -706,7 +708,7 @@ def agy_prompt_chars(prompt: str) -> int:
706
708
 
707
709
 
708
710
  def call_agy(launcher: list[str], prompt: str, timeout: float = AGY_TIMEOUT_S) -> str:
709
- """One review by agy Argon through `caddis_spend.py run` -> the reply text.
711
+ """One review by agy Carbon through `caddis_spend.py run` -> the reply text.
710
712
 
711
713
  ProviderSkipped: caddis_spend refused (exit 75), agy is missing, or the prompt is too long for one argument.
712
714
  ProviderFailure: a non-zero exit, a status other than SUCCESS (ERROR, RESOURCE_EXHAUSTED), no JSON
@@ -813,12 +815,12 @@ def main(argv: list[str] | None = None, env: dict[str, str] | None = None) -> in
813
815
  # that can actually talk to a human. This half just answers "is it configured?" cheaply enough
814
816
  # to call before you need it, instead of finding out mid-commit.
815
817
  if args.check_config:
816
- # agy Argon is the default reviewer and needs no key: agy on PATH plus caddis_spend.py is enough.
818
+ # agy Carbon is the default reviewer and needs no key: agy on PATH plus caddis_spend.py is enough.
817
819
  available = ([AGY_PROVIDER] if agy_launcher() is not None else []) + configured_providers(env)
818
820
  if not available:
819
821
  sys.stderr.write(
820
822
  "no second-vendor reviewer is configured: no API key anywhere, and no agy on PATH\n"
821
- " (with caddis_spend.py) for the default agy-argon reviewer.\n"
823
+ " (with caddis_spend.py) for the default agy-carbon reviewer.\n"
822
824
  " Cross-review needs one — the whole point is a reviewer that does not share this\n"
823
825
  " model's blind spots, so a same-vendor fallback would be no review at all.\n"
824
826
  f" Add a key to {env.get('CADDIS_KEYS_FILE') or DEFAULT_KEYS_FILE}, e.g.\n"
@@ -873,7 +875,7 @@ def main(argv: list[str] | None = None, env: dict[str, str] | None = None) -> in
873
875
  # future-proofing path): it never falls back. A named preset falls back on a provider failure,
874
876
  # and the switch is printed, so the reviewer is never misreported.
875
877
  custom = bool(args.base_url or env.get("REVIEW_BASE_URL") or args.model or env.get("REVIEW_MODEL"))
876
- # With nothing named, the default is agy Argon. A custom endpoint with no provider named is an HTTP
878
+ # With nothing named, the default is agy Carbon. A custom endpoint with no provider named is an HTTP
877
879
  # call (never agy), keyed and labelled as before.
878
880
  primary_provider = named or (HTTP_DEFAULT_PROVIDER if custom else DEFAULT_PROVIDER)
879
881
  agy_cmd = agy_launcher()
@@ -896,7 +898,7 @@ def main(argv: list[str] | None = None, env: dict[str, str] | None = None) -> in
896
898
  chain = []
897
899
  else:
898
900
  chain = [_http_entry(primary_provider, *resolve_config(args, env))]
899
- # The rest of the chain in policy order (agy Argon -> DeepSeek -> GLM). A provider with no key, or
901
+ # The rest of the chain in policy order (agy -> DeepSeek -> GLM). A provider with no key, or
900
902
  # agy with no agy on PATH, is skipped: not an error, just nothing to fall back to.
901
903
  if not custom:
902
904
  for name in REVIEW_ORDER:
@@ -992,7 +994,7 @@ def main(argv: list[str] | None = None, env: dict[str, str] | None = None) -> in
992
994
  "reporting a verdict that looks whole.\n"
993
995
  " Narrow --range to a smaller commit span, or raise --max-diff-chars if you know "
994
996
  "your endpoint's real limit.\n"
995
- + (f" agy-argon is in the provider chain, so each batch prompt is also kept within "
997
+ + (f" agy-carbon is in the provider chain, so each batch prompt is also kept within "
996
998
  f"{AGY_MAX_PROMPT_CHARS:,} command-line chars.\n" if agy_in_chain else "")
997
999
  )
998
1000
  return EXIT_ERROR
@@ -1000,7 +1002,7 @@ def main(argv: list[str] | None = None, env: dict[str, str] | None = None) -> in
1000
1002
  print(
1001
1003
  f"[cross-review] diff is {len(diff_text):,} chars — reviewing in {len(batches)} batches split on "
1002
1004
  f"file boundaries (ceiling {max_diff_chars:,} diff chars"
1003
- + (f"; agy-argon is in the chain, so each whole prompt also stays within {AGY_MAX_PROMPT_CHARS:,} "
1005
+ + (f"; agy-carbon is in the chain, so each whole prompt also stays within {AGY_MAX_PROMPT_CHARS:,} "
1004
1006
  "command-line chars" if agy_in_chain else "")
1005
1007
  + "). Verdict is CLEAN only if every batch is clean."
1006
1008
  )
@@ -15,7 +15,7 @@
15
15
  | Backend Development | `backend-development/` | Backend API design, database schemas, microservices and TDD. Use for backend system architecture. |
16
16
  | Code Review | `code-review/` | Automated code review for quality, security, performance and best practices. Use when reviewing code changes, PRs, or doing code audits. |
17
17
  | Codebase Audit | `codebase-audit/` | Audit an unfamiliar codebase before architecture or implementation work. Use for a new codebase, pre-implementation audit, codebase review, technical due diligence or onboarding. Produces AUDIT-FINDINGS.md and QUESTIONS.md. |
18
- | Cross Review | `cross-review/` | Cross-vendor code review of the current diff — a second-vendor model (agy Argon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses |
18
+ | Cross Review | `cross-review/` | Cross-vendor code review of the current diff — a second-vendor model (agy Carbon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses |
19
19
  | Dashboard Perf Sweep | `dashboard-perf-sweep/` | Re-measure dashboard/API endpoints for load-time regressions. Use when the user says "sweep dashboard performance", "check if this app needs rs-kit", or "re-measure the perf tracker". |
20
20
  | Error Handling | `error-handling/` | Error handling for Python and TypeScript: error hierarchies, custom exceptions, result types, retries, circuit breakers, error boundaries, logging, user-facing messages. |
21
21
  | Fastapi Dev | `fastapi-dev/` | Build FastAPI backends with standard patterns, error handling, and testing |
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: cross-review
3
- description: Cross-vendor code review of the current diff — a second-vendor model (agy Argon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses
3
+ description: Cross-vendor code review of the current diff — a second-vendor model (agy Carbon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses
4
4
  ---
5
5
 
6
6
  # /caddis:cross-review — a second-vendor set of eyes on your diff
7
7
 
8
8
  Run a cross-vendor review of the current changes with a DIFFERENT model family than the one that wrote them
9
- (default **agy Argon** since 2026-10-21 — it needs no key; DeepSeek and GLM are fallbacks). Use after a phase
9
+ (default **agy Carbon** since 2026-10-21 — it needs no key; DeepSeek and GLM are fallbacks). Use after a phase
10
10
  is green and before you commit, or for a second opinion on a risky diff. This is the *cross-vendor*
11
11
  complement to `/caddis:code-review`, not a replacement.
12
12
 
@@ -16,7 +16,7 @@ complement to `/caddis:code-review`, not a replacement.
16
16
  python "$TOOL" --check-config # resolve $TOOL first, see "Run it" below
17
17
  ```
18
18
 
19
- Exit 0 means ready; it prints which providers are available (agy-argon needs no key, only agy on PATH and caddis_spend.py). **Exit 3 means nothing is configured —
19
+ Exit 0 means ready; it prints which providers are available (agy-carbon needs no key, only agy on PATH and caddis_spend.py). **Exit 3 means nothing is configured —
20
20
  STOP and ask the user now.** Do not proceed to the review, and do not silently skip it.
21
21
 
22
22
  Ask with `AskUserQuestion`: which provider to set up (DeepSeek, GLM, or another OpenAI-compatible
@@ -65,7 +65,7 @@ fi
65
65
  > copied weeks earlier silently won. `caddis_gate.py vendor-drift` now fails on the same condition.
66
66
  ```
67
67
  python "$TOOL" $ARGUMENTS # pass the user's flags THROUGH, raw
68
- python "$TOOL" # no arguments: agy Argon eyes on the working tree
68
+ python "$TOOL" # no arguments: agy Carbon eyes on the working tree
69
69
  ```
70
70
 
71
71
  **`$ARGUMENTS` goes through raw, and must not be re-prefixed.** Callers are told to type the flag
@@ -74,7 +74,7 @@ writes. This line used to prefix the flag itself, which turned that into a doubl
74
74
  `--range --range main..HEAD` and made every plan-emitted call fail. Whatever the user typed is already a complete flag list:
75
75
 
76
76
  ```
77
- /caddis:cross-review -> the working tree, agy Argon
77
+ /caddis:cross-review -> the working tree, agy Carbon
78
78
  /caddis:cross-review --range main..HEAD -> that range
79
79
  /caddis:cross-review --provider glm -> GLM eyes
80
80
  ```
@@ -82,7 +82,7 @@ Optional: `--base-url <url>`, `--model <id>` (env always overrides the preset).
82
82
 
83
83
  **A large diff is batched, not refused.** Over `REVIEW_MAX_DIFF_CHARS` (default 60,000) the tool splits
84
84
  on whole-file boundaries and reviews each batch, and the verdict is CLEAN only if every batch is. When agy
85
- Argon is anywhere in the provider chain, each batch is also kept small enough that its **whole prompt** fits
85
+ Carbon is anywhere in the provider chain, each batch is also kept small enough that its **whole prompt** fits
86
86
  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
87
87
  big for agy gets its own batch: agy skips it and the next provider reviews it. With no other provider (no
88
88
  DeepSeek or GLM key), that file gives exit **3**. Exit **4** means a **single file** over the 60,000 ceiling,
@@ -97,7 +97,7 @@ output ends with `REVIEW-SCOPE: PARTIAL (<n> file(s) excluded by the secret filt
97
97
  overall `REVIEW:` line. The exit code does not change, but the excluded files were **not reviewed**: say so,
98
98
  and never report the result as a full CLEAN.
99
99
 
100
- **Do not alternate providers on a schedule.** The order is the owner policy (21 Oct 2026): **agy Argon,
100
+ **Do not alternate providers on a schedule.** The order is the owner policy (21 Oct 2026): **agy Carbon,
101
101
  then DeepSeek, then GLM** (`REVIEW_ORDER` in `oss_review.py`). A named `--provider` goes first; on a provider failure
102
102
  (HTTP 429, any 5xx, a timeout, a connection error, an empty reply) the tool moves to the next one in
103
103
  that order and prints which provider gave the verdict. A provider with no key is skipped. agy runs
@@ -107,7 +107,7 @@ reply. A custom endpoint (`--base-url`/`--model`) never falls back. Name a provi
107
107
  a reason.
108
108
 
109
109
  **Change the default.** The first provider comes from `--provider`, then the process env `REVIEW_PROVIDER`, then
110
- `REVIEW_PROVIDER` in `~/.caddis/keys.env`, then agy Argon. The others follow in `REVIEW_ORDER`. To make DeepSeek the default again, add `REVIEW_PROVIDER=deepseek` to ~/.caddis/keys.env.
110
+ `REVIEW_PROVIDER` in `~/.caddis/keys.env`, then agy Carbon. The others follow in `REVIEW_ORDER`. To make DeepSeek the default again, add `REVIEW_PROVIDER=deepseek` to ~/.caddis/keys.env.
111
111
 
112
112
  ## Interpret the exit code
113
113
  - **0 — REVIEW: CLEAN** → no blocking issues. Proceed.
@@ -85,7 +85,7 @@ and 95-154 turns per session were started by background events. Each turn re-rea
85
85
  (source checkout: `claude-harness/scripts/caddis_routing.py`). Opus stays for plans, designs and
86
86
  critical-code subagents (`plan-writer`, `critical-phase`).
87
87
  - **Escalation.** Escalate to Opus through a SMALL subagent (by-reference brief, reply ≤ 10 lines), never `/model opus` mid-session (the prompt cache is per model, so a switch at 200k re-writes the whole cache), when: a card fails again after its one fix card; a measurement fails a rule (isolate the cause first, then give the owner options); a plan amendment changes the design, not only facts; a risk-high phase reaches review. A fresh Opus session only to write a new plan or a redesign.
88
- - **One phase review.** Run `/caddis:cross-review --range <base>..HEAD` (one other vendor; agy Argon by default).
88
+ - **One phase review.** Run `/caddis:cross-review --range <base>..HEAD` (one other vendor; agy Carbon by default).
89
89
  Never use a Claude reviewer subagent. Exception: every other-vendor provider failed. Then say so in the review file.
90
90
  - **Mechanical tasks** (literal tests, moves, deletes, renames) go to agy through
91
91
  `python "${CLAUDE_PLUGIN_ROOT}/scripts/caddis_spend.py" run --caller lane-pN -- agy ...`.
@@ -17,7 +17,7 @@ command is the quick-reference + do-it-now version.
17
17
  | **Primary** | `claude` | your Anthropic plan |
18
18
  | **OSS lane** | `claude-oss <provider> [claude args…]` | the provider's plan/pay-per-token |
19
19
  | **Convenience alias** | `claude-glm [claude args…]` | same as `claude-oss glm` |
20
- | **Cross-vendor review** | `/caddis:cross-review` (`oss_review.py`; default reviewer agy Argon, then DeepSeek, then GLM) | the reviewer's plan |
20
+ | **Cross-vendor review** | `/caddis:cross-review` (`oss_review.py`; default reviewer agy Carbon, then DeepSeek, then GLM) | the reviewer's plan |
21
21
 
22
22
  To make DeepSeek the default again, add `REVIEW_PROVIDER=deepseek` to ~/.caddis/keys.env.
23
23
 
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "caddis-extras",
3
- "version": "1.3.52",
3
+ "version": "1.3.53",
4
4
  "description": "caddis-extras — the long-tail skills for the Antigravity (agy) caddis plugin; install alongside caddis for the full set."
5
5
  }
@@ -30,7 +30,7 @@
30
30
  | Caching Patterns | `caching-patterns/` | Caching strategies for Streamlit and FastAPI applications |
31
31
  | Case Management | `case-management/` | >- |
32
32
  | Code Explainer | `code-explainer/` | Explain code with diagrams, analogies and step-by-step walkthroughs. Use when teaching a codebase or answering "how does this work?" |
33
- | Cross Review | `cross-review/` | Have a different vendor's model (agy Argon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff. |
33
+ | Cross Review | `cross-review/` | Have a different vendor's model (agy Carbon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff. |
34
34
  | Llm Application Dev | `llm-application-dev/` | LLM applications: prompt engineering, RAG and LLM integration. Use for AI-powered features, chatbots or LLM automation. |
35
35
  | Mcp Builder | `mcp-builder/` | Build high-quality MCP (Model Context Protocol) servers that let LLMs use external APIs and services, in Python (FastMCP) or Node/TypeScript (MCP SDK). |
36
36
  | Observability | `observability/` | Structured logging, correlation IDs, PII redaction, OpenTelemetry tracing, metrics (RED), SLO alerting, health probes and Sentry, in Python and TypeScript. Use when adding logs, traces, metrics or error tracking. |
@@ -458,7 +458,7 @@ LiteLLM cutover. **This table is the single place the intent→model mapping liv
458
458
  | **deepest** | Subtle correctness, security invariants, novel architecture, judgment-heavy seams | `opus` | `/model opus`; `Agent(model: "opus")` | **High** — Anthropic plan quota |
459
459
  | **broad** | Wide parallel coverage of a large but not-subtle surface; the workhorse | `sonnet` | `/model sonnet`; `Agent(model: "sonnet")` | Medium — the default; budget for several |
460
460
  | **mechanical** | Fully-specced, repeat-of-a-known-pattern, no judgment required | `haiku` | `/model haiku`; `Agent(model: "haiku")` | Low |
461
- | **cross-vendor-reviewer** | A *different vendor's* blind spots on a diff — **code review only** | `agy-argon` (default), `deepseek`, `glm` | `/caddis:cross-review`, `/glm`, `/deepseek` | **Scarce** — separate starter-tier subscription, NOT Anthropic quota. Ration it. |
461
+ | **cross-vendor-reviewer** | A *different vendor's* blind spots on a diff — **code review only** | `agy-carbon` (default), `deepseek`, `glm` | `/caddis:cross-review`, `/glm`, `/deepseek` | **Scarce** — separate starter-tier subscription, NOT Anthropic quota. Ration it. |
462
462
  | **synthesis / long-horizon** | Orchestrating many lanes, or work that can't self-verify across a large codebase | `fable` | `/model fable` | **Very high** — ~2× opus's rate-limit burn. RARE. |
463
463
 
464
464
  **Update this table, not the callers**, when a model is added, retired, or re-tiered. A plan that says
@@ -512,7 +512,7 @@ Invent no new machinery. Everything needed already ships:
512
512
  | Per-phase model + lane assignment in a plan | `/caddis:feature-plan` — every phase already carries **Model**, **Lane**, and a cross-review provider |
513
513
 
514
514
  **Reviewer rule (standing):** the reviewer is always a different vendor than whoever wrote the code.
515
- Claude or GLM implemented → agy Argon reviews by default (DeepSeek, then GLM, as fallbacks). Never same-vendor.
515
+ Claude or GLM implemented → agy Carbon reviews by default (DeepSeek, then GLM, as fallbacks). Never same-vendor.
516
516
 
517
517
  Full command/billing decision table: `docs/guide/multi-model-workflow.md`.
518
518
 
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: cross-review
3
- description: Have a different vendor's model (agy Argon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff.
3
+ description: Have a different vendor's model (agy Carbon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff.
4
4
  ---
5
5
 
6
6
  # Cross-Review — a second-vendor set of eyes on your diff
7
7
 
8
8
  A different vendor's model has different blind spots. Claude reviewing Claude's diff shares those
9
- blind spots; an **agy Argon** (default), DeepSeek, GLM or other OpenAI-compatible reviewer catches a different class of
9
+ blind spots; an **agy Carbon** (default), DeepSeek, GLM or other OpenAI-compatible reviewer catches a different class of
10
10
  issue. This skill runs that second reviewer over the current changes and acts on its verdict.
11
11
 
12
12
  ## When to use
@@ -20,7 +20,7 @@ issue. This skill runs that second reviewer over the current changes and acts on
20
20
  python "$TOOL" --check-config
21
21
  ```
22
22
 
23
- Exit 0 prints which providers are available (agy-argon needs no key, only agy on PATH and caddis_spend.py). **Exit 3 means nothing is configured — stop and ask the
23
+ Exit 0 prints which providers are available (agy-carbon needs no key, only agy on PATH and caddis_spend.py). **Exit 3 means nothing is configured — stop and ask the
24
24
  user before reading any diff.** Do not proceed, and do not silently skip the review.
25
25
 
26
26
  Ask with `AskUserQuestion` which provider to set up, then write the key to `~/.caddis/keys.env` as
@@ -36,16 +36,16 @@ If a key exists for a *different* provider than the one requested, the error nam
36
36
  exact flag (`--provider glm`). Read the message before concluding anything is missing.
37
37
 
38
38
  ## Prerequisites (one-time)
39
- The default reviewer is **agy Argon** (since 2026-10-21; no key, but agy and `caddis_spend.py` must be present). For an HTTP
39
+ The default reviewer is **agy Carbon** (agy since 2026-10-21, Carbon since 2026-11-12; no key, but agy and `caddis_spend.py` must be present). For an HTTP
40
40
  provider only the key is mandatory — the tool ships **provider presets** (`deepseek`, `glm`, `openrouter`):
41
41
  ```
42
42
  REVIEW_API_KEY = <your provider key> # REQUIRED (exit 3 without it)
43
- REVIEW_PROVIDER = deepseek # optional: agy-argon | deepseek | glm | openrouter (default agy-argon)
43
+ REVIEW_PROVIDER = deepseek # optional: agy-carbon | deepseek | glm | openrouter (default agy-carbon; agy-argon is an old name)
44
44
  REVIEW_BASE_URL = ... # optional: overrides the preset's URL
45
45
  REVIEW_MODEL = ... # optional: overrides the preset's model id
46
46
  ```
47
47
  Switch provider with one flag: `--provider glm` (or `REVIEW_PROVIDER=glm`, in the env or in `~/.caddis/keys.env`; flag, then env,
48
- then keys file, then agy Argon). To make DeepSeek the default again, add `REVIEW_PROVIDER=deepseek` to ~/.caddis/keys.env. **Future-proofing:** model ids
48
+ then keys file, then agy Carbon). To make DeepSeek the default again, add `REVIEW_PROVIDER=deepseek` to ~/.caddis/keys.env. **Future-proofing:** model ids
49
49
  churn — the preset table in `oss_review.py` is the one place to edit a rename, and `REVIEW_MODEL` /
50
50
  `REVIEW_BASE_URL` always win, so you can point at any new id without touching code.
51
51
 
@@ -80,7 +80,7 @@ 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). 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
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 Carbon 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
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
85
 
86
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.
@@ -1,8 +1,8 @@
1
1
  {
2
- "poolVersion": "1.3.192",
2
+ "poolVersion": "1.3.193",
3
3
  "bundles": {
4
- "antigravity-plugin": "1.3.192",
5
- "antigravity-plugin-extras": "1.3.52",
4
+ "antigravity-plugin": "1.3.193",
5
+ "antigravity-plugin-extras": "1.3.53",
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.108",
3
+ "version": "0.4.109",
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",