@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.
- 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_guide.json +4 -4
- package/bundles/antigravity-plugin/scripts/caddis_lanes.py +4 -4
- package/bundles/antigravity-plugin/scripts/caddis_roadmap_run.py +4 -4
- package/bundles/antigravity-plugin/scripts/caddis_routing.py +2 -2
- package/bundles/antigravity-plugin/scripts/oss_review.py +20 -18
- package/bundles/antigravity-plugin/skills/_registry.md +1 -1
- package/bundles/antigravity-plugin/skills/cross-review/SKILL.md +8 -8
- package/bundles/antigravity-plugin/skills/implement/SKILL.md +1 -1
- package/bundles/antigravity-plugin/skills/use-model/SKILL.md +1 -1
- package/bundles/antigravity-plugin-extras/plugin.json +1 -1
- package/bundles/antigravity-plugin-extras/skills/_registry.md +1 -1
- package/bundles/antigravity-plugin-extras/skills/agent-orchestration/SKILL.md +2 -2
- package/bundles/antigravity-plugin-extras/skills/cross-review/SKILL.md +7 -7
- package/bundles/manifest.json +3 -3
- package/package.json +1 -1
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/bundles/antigravity-plugin/scripts/__pycache__/caddis_worktree_safety.cpython-311.pyc
CHANGED
|
Binary file
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema": 1,
|
|
3
|
-
"version": "1.3.
|
|
4
|
-
"generated": "2026-11-12
|
|
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
|
|
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
|
|
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-
|
|
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": "
|
|
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
|
|
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-
|
|
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>-
|
|
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"] + "-
|
|
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 (
|
|
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", "
|
|
42
|
+
"coding-phase": ("agy", "high"),
|
|
43
43
|
"mechanical-phase": ("haiku", "low"),
|
|
44
44
|
}
|
|
45
|
-
AGY_MODEL_BY_EFFORT: dict[str, str] = {"medium": "gemini-4-
|
|
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
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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
|
|
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
|
|
137
|
-
# so every unnamed review tried DeepSeek first and failed before it reached
|
|
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-
|
|
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
|
-
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
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
|
|
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-
|
|
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-
|
|
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
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
|
@@ -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
|
|
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-
|
|
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
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
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-
|
|
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
|
|
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
|
|
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.
|
package/bundles/manifest.json
CHANGED
package/package.json
CHANGED