@caddis/cli 0.4.92 → 0.4.93

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 (64) hide show
  1. package/README.md +4 -0
  2. package/bundles/antigravity-plugin/agents/debug.md +2 -0
  3. package/bundles/antigravity-plugin/plugin.json +1 -1
  4. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_exit.cpython-311.pyc +0 -0
  5. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_file_lock.cpython-311.pyc +0 -0
  6. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_frontmatter.cpython-311.pyc +0 -0
  7. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_redact.cpython-311.pyc +0 -0
  8. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_roadmap.cpython-311.pyc +0 -0
  9. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_rows.cpython-311.pyc +0 -0
  10. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_status.cpython-311.pyc +0 -0
  11. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_tidy.cpython-311.pyc +0 -0
  12. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_todo.cpython-311.pyc +0 -0
  13. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_workstreams.cpython-311.pyc +0 -0
  14. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_worktree_safety.cpython-311.pyc +0 -0
  15. package/bundles/antigravity-plugin/scripts/caddis_checkout_guard.py +1 -1
  16. package/bundles/antigravity-plugin/scripts/caddis_fleet.py +26 -9
  17. package/bundles/antigravity-plugin/scripts/caddis_guide.json +58 -6
  18. package/bundles/antigravity-plugin/scripts/caddis_preload_review.py +554 -0
  19. package/bundles/antigravity-plugin/scripts/caddis_roadmap_run.py +9 -3
  20. package/bundles/antigravity-plugin/scripts/caddis_run.py +160 -0
  21. package/bundles/antigravity-plugin/scripts/caddis_spawn.py +17 -1
  22. package/bundles/antigravity-plugin/scripts/caddis_upstream_check.py +108 -10
  23. package/bundles/antigravity-plugin/scripts/setup_project_ai.py +65 -1
  24. package/bundles/antigravity-plugin/skills/_registry.md +3 -1
  25. package/bundles/antigravity-plugin/skills/brainstorming/SKILL.md +232 -40
  26. package/bundles/antigravity-plugin/skills/brainstorming/builder-check-prompt.md +25 -0
  27. package/bundles/antigravity-plugin/skills/feature-plan/SKILL.md +7 -1
  28. package/bundles/antigravity-plugin/skills/fleet-close/SKILL.md +4 -1
  29. package/bundles/antigravity-plugin/skills/graph-email/SKILL.md +15 -0
  30. package/bundles/antigravity-plugin/skills/handoff/SKILL.md +9 -2
  31. package/bundles/antigravity-plugin/skills/implement/SKILL.md +3 -0
  32. package/bundles/antigravity-plugin/skills/particle-art/SKILL.md +1 -3
  33. package/bundles/antigravity-plugin/skills/preload-review/SKILL.md +69 -0
  34. package/bundles/antigravity-plugin/skills/roadmap/SKILL.md +4 -0
  35. package/bundles/antigravity-plugin/skills/roadmap/assets/plan-resume-prompt.md +6 -5
  36. package/bundles/antigravity-plugin/skills/spawn-session/SKILL.md +5 -0
  37. package/bundles/antigravity-plugin/skills/tdd/SKILL.md +2 -1
  38. package/bundles/antigravity-plugin/skills/usage-review/SKILL.md +2 -0
  39. package/bundles/antigravity-plugin-extras/plugin.json +1 -1
  40. package/bundles/antigravity-plugin-extras/skills/_registry.md +1 -0
  41. package/bundles/antigravity-plugin-extras/skills/graph-email/SKILL.md +53 -0
  42. package/bundles/antigravity-plugin-extras/skills/graph-email/email.toml.example +44 -0
  43. package/bundles/antigravity-plugin-extras/skills/graph-email/scripts/send_email.py +432 -0
  44. package/bundles/codex/.codex/skills/media/particle-art/SKILL.md +1 -3
  45. package/bundles/codex/.codex/skills/workflow/brainstorming/SKILL.md +232 -40
  46. package/bundles/codex/.codex/skills/workflow/brainstorming/builder-check-prompt.md +25 -0
  47. package/bundles/codex/.codex/skills/workflow/roadmap/SKILL.md +4 -0
  48. package/bundles/codex/.codex/skills/workflow/roadmap/assets/plan-resume-prompt.md +6 -5
  49. package/bundles/manifest.json +3 -3
  50. package/dist/export/assets/export-CMtV-slT.css +1 -0
  51. package/dist/export/index.html +2 -2
  52. package/dist/ui/assets/{Activity-DZKPMOeV.js → Activity-BDjet2xd.js} +1 -1
  53. package/dist/ui/assets/Guide-Czn5sK0f.js +9 -0
  54. package/dist/ui/assets/Guide-D-Zy4cUT.css +1 -0
  55. package/dist/ui/assets/{RoadmapTab-DPsiSmIF.js → RoadmapTab-Bd8geyQx.js} +1 -1
  56. package/dist/ui/assets/index-Bd0Z4jR8.css +1 -0
  57. package/dist/ui/assets/{index-xl156OCN.js → index-CmngQ8Mk.js} +12 -12
  58. package/dist/ui/index.html +2 -2
  59. package/package.json +1 -1
  60. package/dist/export/assets/export-HxTgj3z2.css +0 -1
  61. package/dist/ui/assets/Guide-5ZFfL6sl.js +0 -9
  62. package/dist/ui/assets/Guide-Dnsb-TRd.css +0 -1
  63. package/dist/ui/assets/index-DGlNAmeA.css +0 -1
  64. /package/dist/export/assets/{export-B7BBDg5I.js → export-DtlDFN4L.js} +0 -0
package/README.md CHANGED
@@ -143,6 +143,10 @@ starts it in the background; `caddis hub stop` stops it.
143
143
 
144
144
  **Guide Poster and Details.** The Guide page has a `Poster` tab (with `Workflow` and `Mind map` views, plus a `Print` button for a two-page A3 landscape wall poster) and a `Details` tab. Every item on the poster links to its entry in Details.
145
145
 
146
+ **Guide Wall poster.** A third tab, `Wall poster` (`#/guide/wall`), shows one A4 landscape sheet: the daily commands in order, a card per stage (plan, build, review, ship, continuity, knowledge, setup), and the agents. The `Print` button prints exactly that sheet on one page. It is built from the same installed guide data as the other tabs, so a new command, agent or count appears by itself after `caddis update` and a hub restart. The text shrinks (to 60% at most) when the guide grows, so nothing is cut off. Each line is the first clause of the description; the Details tab has the full text.
147
+
148
+ **Guide Map.** A fourth tab, `Map` (`#/guide/map`), lays out the whole plugin: the daily loop (plan, build, review, ship) with its commands, the support lanes (continuity, knowledge, setup), the hooks as a timeline in the order a session fires them, the agents with their model and a `writes files` marker, the skills by family, and the runtimes that receive caddis. Every name links to its entry in Details. A filter box dims what does not match, and `Print` prints the map on A3 landscape. Nothing on the map is written by hand: it is built from the installed guide data, so a new command, agent, skill or hook appears by itself after `caddis update` and a hub restart.
149
+
146
150
  **Sessions from more than one agent.** Claude Code sessions come from `claude agents --json`. agy
147
151
  (Antigravity) sessions come from the caddis agy hooks: each agy turn writes a status file, and the
148
152
  hub lists that session with an `agy` chip. A turn that starts sets `working`. A turn that ends sets
@@ -8,6 +8,8 @@ hypothesis second, fix last** — never guess-and-check. You diagnose and return
8
8
  makes the edits. Keep its context clean: return the conclusion, not your whole investigation.
9
9
 
10
10
  ## Method
11
+ If the superpowers plugin is on, follow its `systematic-debugging` skill: no fix proposal before the root cause is proven.
12
+
11
13
  ### 1. Gather evidence (before touching anything)
12
14
  - Read the full error / stack trace / failing output.
13
15
  - Reproduce: run the failing test or trigger the bug. Record a baseline — run the suite and note
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "name": "caddis",
3
- "version": "1.3.176",
3
+ "version": "1.3.177",
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
  }
@@ -37,7 +37,7 @@ except ModuleNotFoundError as exc:
37
37
  # and they are not another session's edit. Patterns are fnmatch on the path inside the artifact folder; `*` crosses `/`.
38
38
  GENERATED_DIRS = ("relay/", "session-state/", "context-window/", ".relay-injected/")
39
39
  GENERATED_PATTERNS = (
40
- "relay.md", "usage-log.jsonl*", "agent-log.jsonl*", ".last-usage-review", "session-state.md",
40
+ "relay.md", "usage-log.jsonl*", "agent-log.jsonl*", ".last-usage-review", ".last-preload-review", "session-state.md",
41
41
  "context-window.json*", ".session-state-*.tmp", "hook-errors.jsonl", "memory.jsonl", "reviews/*.html",
42
42
  "*.lock", "*.bak",
43
43
  )
@@ -32,6 +32,14 @@ except ModuleNotFoundError as exc:
32
32
  sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "claude-harness" / "scripts"))
33
33
  import caddis_routing
34
34
 
35
+ try:
36
+ import caddis_run # stable_command: text a later session reads never names a versioned plugin path
37
+ except ModuleNotFoundError as exc:
38
+ if exc.name != "caddis_run":
39
+ raise
40
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
41
+ import caddis_run
42
+
35
43
  ACK_FIELDS = ("name", "role", "machine", "folder", "relay", "tasks", "mode", "owns-watchers", "worktrees")
36
44
  NO_ACK = "no ack"
37
45
  NO_NEW_SESSION = ("keeps-running", "nothing", NO_ACK)
@@ -136,6 +144,8 @@ def parse_ack(text: str) -> Ack:
136
144
  after = rest[fence:]
137
145
  body = after.split("\n", 1)[1] if "\n" in after else ""
138
146
  prompt, inline = _split_prompt(body)
147
+ if caddis_run.VERSIONED_PATH.search(prompt):
148
+ raise AckError(f"the resume prompt: {caddis_run.VERSIONED_PATH_HELP}")
139
149
  return Ack(
140
150
  name=fields["name"], role=fields["role"], machine=fields["machine"], folder=fields["folder"],
141
151
  relay=fields["relay"], tasks=fields["tasks"], mode=mode, owns_watchers=watchers == "yes",
@@ -309,6 +319,8 @@ def check_sheet(sheet_text: str, roster_text: str) -> list[str]:
309
319
  errors.append(f"{role}: the resume prompt does not load {tasks}")
310
320
  if "is now" not in prompt:
311
321
  errors.append(f"{role}: the resume prompt does not greet peers with `is now`")
322
+ if caddis_run.VERSIONED_PATH.search(prompt):
323
+ errors.append(f"{role}: the resume prompt {caddis_run.VERSIONED_PATH_HELP}")
312
324
  if _is_shared(r.get("Folder", ""), counts) and "origin/main" not in prompt:
313
325
  errors.append(f"{role}: shared checkout, but the resume prompt does not say origin/main")
314
326
  return errors
@@ -458,6 +470,8 @@ def resume_prompt(relay_text: str) -> str:
458
470
  prompt = "\n".join(body).strip("\n")
459
471
  if not prompt.strip():
460
472
  raise ResumeError("## Resume prompt fenced block is empty")
473
+ if caddis_run.VERSIONED_PATH.search(prompt):
474
+ raise ResumeError(f"## Resume prompt: {caddis_run.VERSIONED_PATH_HELP}")
461
475
  return prompt
462
476
 
463
477
 
@@ -471,12 +485,15 @@ def shell_arg(text: str) -> str:
471
485
  ANNOUNCE_ID = "<your session id>"
472
486
 
473
487
 
474
- def announce_text(script: Path, name: str, folder: str) -> str:
488
+ def announce_text(name: str, folder: str) -> str:
475
489
  """The sentence the start line adds, so the resumed session names itself and tells its live peers once.
476
490
 
477
- A new session cannot expand `${CLAUDE_PLUGIN_ROOT}`, so the script path is this script's own, written out. It
478
- holds no quote or double quote (`shell_arg` would change them). A peer without a name (`-`) is not messaged."""
479
- py = f"python {script.as_posix()}"
491
+ A new session cannot expand `${CLAUDE_PLUGIN_ROOT}`, and an expanded path holds the plugin version, which is gone
492
+ after an update. So the command is the stable launcher (`caddis_run.py`, never a versioned path). It holds no
493
+ double quote (`shell_arg` turns each into a typographic one), so the launcher path is NOT quoted here: a home
494
+ folder with a space needs the quotes, which the owner's machine does not have. A peer without a name (`-`) is
495
+ not messaged."""
496
+ py = f"python {caddis_run.launcher_path().as_posix()} caddis_fleet.py"
480
497
  return (f"Then announce yourself once. Run `{py} whoami --session-id {ANNOUNCE_ID} --name {name} --root .` and "
481
498
  f"`{py} peers --session-id {ANNOUNCE_ID} --root .` (your session id is printed at session start). "
482
499
  f"Send each peer that has a name (not `-`) one SendMessage: "
@@ -485,11 +502,11 @@ def announce_text(script: Path, name: str, folder: str) -> str:
485
502
 
486
503
 
487
504
  def render_resume(session: str, session_id: str, workstream: str, prompt: str, role: str, stamp: datetime,
488
- fleet_mode: bool = False, announce_script: Path | None = None, folder: str = "",
505
+ fleet_mode: bool = False, announce: bool = False, folder: str = "",
489
506
  root: Path | None = None) -> str:
490
507
  """The last output of `/caddis:handoff`. In a fleet close the restart sheet holds the only start line.
491
508
 
492
- With `announce_script`, the start line (not the fenced block, which stays the relay's text) ends with the
509
+ With `announce`, the start line (not the fenced block, which stays the relay's text) ends with the
493
510
  whoami + announce sentence: the start line is what the new session receives with its name.
494
511
  With `root`, the block names the repo and the start line first changes to it, because the relay's paths are
495
512
  repo-relative. `;`, as in the restart sheet: Windows PowerShell 5.1 has no `&&`."""
@@ -500,8 +517,8 @@ def render_resume(session: str, session_id: str, workstream: str, prompt: str, r
500
517
  start = "Start line: from the restart sheet"
501
518
  else:
502
519
  name = new_name(role, stamp)
503
- if announce_script is not None:
504
- prompt = f"{prompt}\n{announce_text(announce_script, name, folder)}"
520
+ if announce:
521
+ prompt = f"{prompt}\n{announce_text(name, folder)}"
505
522
  start = f"Start line:\n{cd}claude {_model_flags(role)} --name {name} {shell_arg(prompt)}"
506
523
  return (f"{model_line(role)}=== RESUME ===\nSession: {session} ({session_id})\nWorkstream: {workstream}\n"
507
524
  f"{repo}{_fenced(shown)}\n{start}\n")
@@ -580,7 +597,7 @@ def _resume_block_cli(args: argparse.Namespace) -> int:
580
597
  sys.stderr.write(f"resume-block failed: bad role {role!r}\n")
581
598
  return caddis_exit.BLOCKED
582
599
  print(render_resume(session, args.session_id, args.name, prompt, role, datetime.now(), args.fleet,
583
- Path(__file__).resolve(), root.name, root), end="")
600
+ True, root.name, root), end="")
584
601
  return caddis_exit.CLEAN
585
602
 
586
603
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema": 1,
3
- "version": "1.3.175",
4
- "generated": "2026-11-01 21:34 UTC",
3
+ "version": "1.3.176",
4
+ "generated": "2026-11-03 23:28 UTC",
5
5
  "commands": [
6
6
  {
7
7
  "name": "add-rules",
@@ -338,7 +338,6 @@
338
338
  ]
339
339
  ],
340
340
  "scripts": [
341
- "caddis_gate.py",
342
341
  "caddis_lanes.py",
343
342
  "caddis_routing.py",
344
343
  "caddis_spend.py",
@@ -499,6 +498,16 @@
499
498
  "stage": "knowledge",
500
499
  "daily": false
501
500
  },
501
+ {
502
+ "name": "graph-email",
503
+ "description": "Send a Markdown file as an email through Microsoft Graph or SMTP, as set in ~/.caddis/email.toml. Default recipient is the owner.",
504
+ "hint": "<file.md> [subject words] [--to address] [--attach file]",
505
+ "steps": [],
506
+ "scripts": [],
507
+ "noArgs": false,
508
+ "stage": "ship",
509
+ "daily": false
510
+ },
502
511
  {
503
512
  "name": "handoff",
504
513
  "description": "End-of-session handoff — capture exact state so the next session resumes with zero re-discovery",
@@ -935,6 +944,43 @@
935
944
  "stage": "plan",
936
945
  "daily": false
937
946
  },
947
+ {
948
+ "name": "preload-review",
949
+ "description": "Show what loads before the first prompt in every repo (rules, memory index, skills, MCP names) and list what to shorten",
950
+ "hint": "[--root PATH]",
951
+ "steps": [
952
+ [
953
+ "1",
954
+ "find the script"
955
+ ],
956
+ [
957
+ "2",
958
+ "run it"
959
+ ],
960
+ [
961
+ "3",
962
+ "show the output"
963
+ ],
964
+ [
965
+ "4",
966
+ "point to /context"
967
+ ],
968
+ [
969
+ "5",
970
+ "offer actions only"
971
+ ],
972
+ [
973
+ "6",
974
+ "record the review"
975
+ ]
976
+ ],
977
+ "scripts": [
978
+ "caddis_preload_review.py"
979
+ ],
980
+ "noArgs": false,
981
+ "stage": "setup",
982
+ "daily": false
983
+ },
938
984
  {
939
985
  "name": "rca",
940
986
  "description": "Record a root cause in one step — .caddis/rca/<date>-<slug>.md — or close one with the fixing commit",
@@ -1765,6 +1811,12 @@
1765
1811
  "description": "Create well-structured conventional commit messages following Conventional Commits standard. Use when committing changes, preparing PRs, or generating changelogs.",
1766
1812
  "core": true
1767
1813
  },
1814
+ {
1815
+ "name": "graph-email",
1816
+ "category": "devops",
1817
+ "description": "Email a Markdown file via Microsoft Graph or SMTP. Use to email a draft or note.",
1818
+ "core": false
1819
+ },
1768
1820
  {
1769
1821
  "name": "monorepo",
1770
1822
  "category": "devops",
@@ -2218,7 +2270,7 @@
2218
2270
  {
2219
2271
  "name": "brainstorming",
2220
2272
  "category": "workflow",
2221
- "description": "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.",
2273
+ "description": "Use before any creative work: new features, components or behavior changes, or planning anything new. Finds what the user wants first.",
2222
2274
  "core": true
2223
2275
  },
2224
2276
  {
@@ -2409,9 +2461,9 @@
2409
2461
  ]
2410
2462
  },
2411
2463
  "counts": {
2412
- "commands": 39,
2464
+ "commands": 41,
2413
2465
  "agents": 12,
2414
- "skills": 133,
2466
+ "skills": 134,
2415
2467
  "core": 50,
2416
2468
  "hooks": 17
2417
2469
  }