@caddis/cli 0.2.6 → 0.3.0

package/bundles/antigravity-plugin/session_end_agy.py

@@ -22,6 +22,25 @@ def _artifact_root(root: str) -> str:
     return os.path.join(str(root), ".caddis")
 
 
+
+def _hook_note(feature, exc, root=None):
+    """Record a swallowed failure in the caddis hook ledger. Never raises, never prints.
+
+    agy hooks ship FLAT at the plugin root while hook_log.py ships under scripts/, and in
+    the source repo this file sits in claude-harness/agy/ with hook_log.py one level up in
+    claude-harness/scripts/. Try both layouts.
+    """
+    try:
+        _here = os.path.dirname(os.path.abspath(__file__))
+        for _cand in (os.path.join(_here, "scripts"),
+                      os.path.join(os.path.dirname(_here), "scripts")):
+            if os.path.isdir(_cand) and _cand not in sys.path:
+                sys.path.insert(0, _cand)
+        import hook_log as _hl  # noqa: E402
+        _hl.record(os.path.basename(__file__).replace(".py", ""), feature, exc, root)
+    except Exception:
+        pass
+
 def main() -> None:
     try:
         data = json.load(sys.stdin)
@@ -43,8 +62,8 @@ def main() -> None:
         }
         with open(os.path.join(art, "usage-log.jsonl"), "a", encoding="utf-8") as fh:
             fh.write(json.dumps(record) + "\n")
-    except Exception:
-        pass  # never fail the turn
+    except Exception as _exc:
+        _hook_note("agy usage-log write", _exc)  # never fail the turn
     # No stdout: agy interprets a Stop hook's stdout as a decision object.
 
 

package/bundles/antigravity-plugin/skills/_registry.md

@@ -86,6 +86,7 @@
 | Ship Pr | `ship-pr/` | Open a reviewed PR for the current feature branch — rebase-safe push, PR create/update, monitor CI, STOP at green. Never merges, never deploys (that's /ship-merge). |
 | Spawn Hub | `spawn-hub/` | Hand the Advisory Hub role to a fresh session — run the mechanical audit, then generate the succession prompt with a context self-check the new Hub must pass |
 | Spawn Session | `spawn-session/` | Hand the WORK to a fresh session — generate the handover from the repo, then validate the successor by re-deriving its answers |
+| Statusline | `statusline/` | Install the caddis status line into Claude Code and agy — one renderer, once per machine |
 | Tdd | `tdd/` | Run a strict red-green-refactor TDD cycle for a unit of behavior |
 | Ui Brief | `ui-brief/` | Design-first UI brief — lock the aesthetic before writing any code |
 | Usage Review | `usage-review/` | Review local caddis usage over a window, surface prioritised recommendations, and apply config changes in one step |

package/bundles/antigravity-plugin/skills/fastapi-dev/SKILL.md

@@ -295,6 +295,6 @@ async def create_record(record: RecordCreate, service: ...):
 | Resource | Path |
 |----------|------|
 | FastAPI instructions | `instructions/fastapi.instructions.md` |
-| SQL expert skill | `skills/coding/sql/SKILL.md` |
+| SQL expert skill | the `sql` skill |
 | Python instructions | `instructions/python.instructions.md` |
 | Security instructions | `instructions/security.instructions.md` |

package/bundles/antigravity-plugin/skills/ship/SKILL.md

@@ -103,5 +103,5 @@ Release tag:     <tag> → <sha> | n/a
 
 ## Skill reference
 Full procedures for the Gitea lane (CI monitoring, prod validation, queue triage, failure remediation)
-are in `skills/devops/deploy-local/SKILL.md`. For the GitHub lane, the `gh-cli` skill covers `gh run`
+are in the `deploy-local` skill (ships in the optional `caddis-extras` plugin — enable it with `claude plugin enable caddis-extras`). For the GitHub lane, the `gh-cli` skill covers `gh run`
 usage. Load whichever matches the detected lane when a step needs more detail.

package/bundles/antigravity-plugin/skills/ship-merge/SKILL.md

@@ -99,5 +99,5 @@ Cleanup:       remote branch ✗ deleted / local ✗ deleted / backup ref droppe
 - Local-only lane: no PR, no merge — refuse and point at `/ship`.
 
 ## Skill reference
-Gitea deploy monitoring, prod validation, failure triage: `skills/devops/deploy-local/SKILL.md`.
+Gitea deploy monitoring, prod validation, failure triage: the `deploy-local` skill (ships in the optional `caddis-extras` plugin — enable it with `claude plugin enable caddis-extras`).
 GitHub `gh pr merge` / `gh run` usage: the `gh-cli` skill.

package/bundles/antigravity-plugin/skills/ship-pr/SKILL.md

@@ -98,5 +98,5 @@ human-confirmed door.
 - Local-only lane: refuse + point at `/ship`. On the default branch: stop + point at `/ship`.
 
 ## Skill reference
-Gitea API monitoring + failure triage: `skills/devops/deploy-local/SKILL.md`. GitHub `gh pr` / `gh run`
+Gitea API monitoring + failure triage: the `deploy-local` skill (ships in the optional `caddis-extras` plugin — enable it with `claude plugin enable caddis-extras`). GitHub `gh pr` / `gh run`
 usage: the `gh-cli` skill. Load whichever matches the detected lane.

package/bundles/antigravity-plugin/skills/statusline/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: statusline
+description: Install the caddis status line into Claude Code and agy — one renderer, once per machine
+---
+
+# /statusline — set up the status bar
+
+Wire the caddis status line into every coding agent on this machine. One Python renderer serves
+both hosts. It installs at **user scope**, so every project gets the line and no project holds a
+copy that can drift.
+
+## What the user gets
+
+Claude Code:
+
+```
+⌂ claudster-source | saajunaid/caddis ⎇ main +2 ●1 ?3 ↑1 | ◆ Opus 5 (1M context) v2.1.239 |
+◉ 412k/1M [███░░░░░]  41%  | ⚡ 386k cached | effort:high | style:Plain | thinking |
+5h:12% 7d:40% | 💻 57% (37 GB) | ⏺ relay | ◷ 07:58
+```
+
+agy (Antigravity):
+
+```
+▛▜ agy | ● idle | 🧠 Gemini 3.6 Flash (High) (high) | 📁 claudster-source | ⎇ main ?3 |
+◉ 48.5k/1M [░░░░░░░░]  5%  | ⚡ 40k cached | q 62% | 💻 57% (37 GB) | ⏺ relay | ◷ 08:01
+```
+
+Both lines come from `caddis_statusline.py`. It has two profiles, because the two hosts send
+different field names — agy's payload is a sibling of Claude Code's, not a copy.
+
+## Run it
+
+Find the renderer in this install and run it. Try these paths in order and use the first that exists:
+
+- `${CLAUDE_PLUGIN_ROOT}/scripts/caddis_statusline.py`
+- `claude-harness/scripts/caddis_statusline.py` (working inside the caddis source repo)
+
+Then:
+
+```bash
+python <path>/caddis_statusline.py --install          # both hosts
+python <path>/caddis_statusline.py --install --host claude
+python <path>/caddis_statusline.py --install --host agy
+python <path>/caddis_statusline.py --install --dry-run # print, write nothing
+```
+
+`--install` does four things:
+
+1. Copies the renderer to `~/.caddis/statusline.py` — a **stable** path. Pointing the host
+   settings at the plugin cache would break on every caddis upgrade, because the version number
+   is in that path.
+2. Creates `~/.caddis/statusline.json` with the default toggles. It never overwrites an existing one.
+3. Backs up each host's `settings.json` to `settings.json.bak-caddis-statusline`.
+4. Sets `statusLine` in `~/.claude/settings.json` and `~/.gemini/antigravity-cli/settings.json`,
+   preserving every other key. A host that is not installed is skipped, not failed.
+
+Report the tool's own output to the user. Then tell them the line appears on the **next** session —
+neither host re-reads `settings.json` mid-session.
+
+## Verify
+
+```bash
+python ~/.caddis/statusline.py --check                        # what is wired where
+python ~/.caddis/statusline.py --sample --profile claude      # preview, no host needed
+python ~/.caddis/statusline.py --sample --profile agy
+```
+
+`--check` exits non-zero when a host's `statusLine` is missing or points somewhere else.
+
+## Change the look
+
+Edit `~/.caddis/statusline.json`. Every key is optional; a missing file means defaults.
+
+| key | default | what it controls |
+|---|---|---|
+| `color` | `true` | ANSI colour |
+| `icons` | `true` | Unicode segment icons. These are plain Unicode, **not** Nerd Font glyphs |
+| `progress_bar` | `true` | the `[███░░░░░]` context bar |
+| `bar_width` | `8` | bar cells |
+| `token_counts` | `true` | `◉ 412k/1M` |
+| `cached_tokens` | `true` | `⚡ 386k cached` — bold and bright by design, never width-gated |
+| `ram` | `true` | `💻 57% (37 GB)` |
+| `ram_min_width` | `0` | hide RAM below this terminal width; `0` always shows it |
+| `clock` | `true` | `◷ 07:58` |
+| `relay` | `true` | `⏺ relay` when a parked resume pointer exists |
+| `rate_limits` | `true` | `5h:12% 7d:40%` (Claude Code only) |
+| `session_id` | `false` | `#a1b2c3d4` |
+| `git` | `true` | branch, staged/unstaged/untracked counts, ahead/behind |
+| `separator` | `"\|"` | segment separator |
+
+Config changes take effect on the next render. No reinstall needed.
+
+## Notes for you, not the user
+
+- Do **not** hand-edit either `settings.json` to wire this. `--install` reads, merges and writes
+  back, so it cannot drop an unrelated key. Hand edits have dropped `trustedWorkspaces` before.
+- The renderer never crashes the host. A bad payload, a missing field, or an unreadable config
+  degrades to fewer segments; a hard failure degrades to the directory name.
+- RAM on Windows uses `ctypes` `GlobalMemoryStatusEx`, an in-process call. Do not replace it with
+  `Get-CimInstance Win32_OperatingSystem` — that cost about 300 ms on **every** render in the
+  PowerShell line this replaced.
+- If the user asks why their old `~/.claude/statusline-custom.sh` or
+  `~/.gemini/statusline/statusline.ps1` no longer runs: nothing points at them any more. They are
+  superseded, not deleted. Both are safe to remove once the user is happy with the new line.

package/bundles/antigravity-plugin/skills/use-model/SKILL.md

@@ -55,9 +55,21 @@ A wholly new provider: add a row to `PROVIDERS` in `oss_model.py` (base_url, mod
 pass an unknown provider name with `OSS_BASE_URL`+`OSS_MODEL` set — no table edit required.
 
 ## First-time install
-Put `claude-harness/scripts/` (or your plugin's `scripts/` dir) on `PATH`, or add a shell profile
-function. `/setup-project-ai` documents the one-liner for your platform (PowerShell profile function /
-bash alias) — it does not silently edit your shell profile.
+
+```
+npm i -g @caddis/cli     # puts claude-oss / claude-glm / claude-deepseek on PATH
+caddis keys              # prompts for each provider key, validates it, writes ~/.caddis/keys.env
+claude-glm --print-config    # zero-token check: endpoint, model, key all resolved
+```
+
+npm does the PATH work on Windows, macOS and Linux. No profile edit, no script copying, no
+Python needed on the lane path — the resolver is ported into the CLI, because the npm tarball
+ships only `dist` and `bundles`.
+
+`npx` runs the default `caddis` binary only; the lane binaries need the global install above.
+
+**Plugin-only installs** (no npm CLI) keep the original route: put the plugin's `scripts/`
+directory on `PATH`, or add a shell profile function. caddis never silently edits your profile.
 
 ## Exit codes
 `claude-oss`/`claude-glm` propagate the wrapped `claude` process's exit code, except a resolver failure

package/bundles/antigravity-plugin/warm_start_agy.py

@@ -131,14 +131,33 @@ def truncate_relay(text: str) -> str:
     return text
 
 
+
+def _hook_note(feature, exc, root=None):
+    """Record a swallowed failure in the caddis hook ledger. Never raises, never prints.
+
+    agy hooks ship FLAT at the plugin root while hook_log.py ships under scripts/, and in
+    the source repo this file sits in claude-harness/agy/ with hook_log.py one level up in
+    claude-harness/scripts/. Try both layouts.
+    """
+    try:
+        _here = os.path.dirname(os.path.abspath(__file__))
+        for _cand in (os.path.join(_here, "scripts"),
+                      os.path.join(os.path.dirname(_here), "scripts")):
+            if os.path.isdir(_cand) and _cand not in sys.path:
+                sys.path.insert(0, _cand)
+        import hook_log as _hl  # noqa: E402
+        _hl.record(os.path.basename(__file__).replace(".py", ""), feature, exc, root)
+    except Exception:
+        pass
+
 def main() -> None:
     try:
         _reconfig = getattr(sys.stdout, "reconfigure", None)
         if _reconfig:
             try:
                 _reconfig(encoding="utf-8")
-            except Exception:
-                pass
+            except Exception as _exc:
+                _hook_note("agy stdout utf-8 reconfigure", _exc)
         try:
             data = json.load(sys.stdin)
         except Exception:

package/bundles/antigravity-plugin-extras/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "caddis-extras",
-  "version": "1.3.24",
+  "version": "1.3.25",
   "description": "caddis-extras — the long-tail skills for the Antigravity (agy) caddis plugin; install alongside caddis for the full set."
 }

package/bundles/antigravity-plugin-extras/skills/architecture-design/SKILL.md

@@ -241,4 +241,4 @@ def fetch_records(status: str = None, page: int = 1):
 | Architect agent | `agents/architect.agent.md` |
 | FastAPI dev skill | `skills/coding/fastapi-dev/SKILL.md` |
 | Streamlit dev skill | `skills/frontend/streamlit-dev/SKILL.md` |
-| SQL expert skill | `skills/coding/sql/SKILL.md` |
+| SQL expert skill | the `sql` skill |

package/bundles/antigravity-plugin-extras/skills/caching-patterns/SKILL.md

@@ -382,4 +382,4 @@ This pattern is complementary to chunk retry (Step 6 + Gotcha 6) — the 3-layer
 |----------|------|
 | Streamlit dev skill | `skills/frontend/streamlit-dev/SKILL.md` |
 | Streamlit instructions | `instructions/streamlit.instructions.md` |
-| SQL expert skill | `skills/coding/sql/SKILL.md` |
+| SQL expert skill | the `sql` skill |

package/bundles/antigravity-plugin-extras/skills/webapp-development/SKILL.md

@@ -283,6 +283,6 @@ st.plotly_chart(create_trend_chart(filter_type), use_container_width=True)
 |----------|------|
 | Streamlit dev skill | `skills/frontend/streamlit-dev/SKILL.md` |
 | FastAPI dev skill | `skills/coding/fastapi-dev/SKILL.md` |
-| SQL expert skill | `skills/coding/sql/SKILL.md` |
+| SQL expert skill | the `sql` skill |
 | Caching patterns | `skills/coding/caching-patterns/SKILL.md` |
 | UX design skill | `skills/frontend/ux-design/SKILL.md` |

package/bundles/manifest.json

@@ -1,7 +1,7 @@
 {
-  "poolVersion": "1.3.75",
+  "poolVersion": "1.3.77",
   "bundles": {
-    "antigravity-plugin": "1.3.75",
-    "antigravity-plugin-extras": "1.3.24"
+    "antigravity-plugin": "1.3.77",
+    "antigravity-plugin-extras": "1.3.25"
   }
 }