@caddis/cli 0.4.29 → 0.4.32

package/bundles/antigravity-plugin/scripts/caddis_gate.py

@@ -37,6 +37,14 @@ import subprocess
 import sys
 from pathlib import Path
 
+try:
+    import caddis_frontmatter
+except ModuleNotFoundError as exc:
+    if exc.name != "caddis_frontmatter":
+        raise
+    sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "claude-harness" / "scripts"))
+    import caddis_frontmatter
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(encoding="utf-8", errors="replace")
     sys.stderr.reconfigure(encoding="utf-8", errors="replace")
@@ -145,16 +153,7 @@ def gate_lane(plan: Path, phase: int) -> int:
 # ── gate: verdict-gate ──────────────────────────────────────────────────────
 
 def _frontmatter(p: Path) -> dict:
-    t = p.read_text(encoding="utf-8", errors="ignore")
-    if not t.startswith("---"):
-        return {}
-    end = t.find("\n---", 3)
-    out = {}
-    for line in t[3:end if end > 0 else 400].splitlines():
-        if ":" in line:
-            k, _, v = line.partition(":")
-            out[k.strip()] = v.strip()
-    return out
+    return caddis_frontmatter.parse(p.read_text(encoding="utf-8", errors="ignore"))
 
 
 def _covers(phase_field: str, n: int) -> bool:
@@ -602,6 +601,22 @@ def gate_review_trigger(repo_root: Path, rev_range: str | None = None) -> int:
     return EXIT_NOTE
 
 
+def gate_docs_check(root: Path) -> int:
+    """Report every typed .caddis Markdown document with an invalid header."""
+    failures = 0
+    for path in sorted((root / ".caddis").rglob("*.md")):
+        relative = path.relative_to(root).as_posix()
+        if not caddis_frontmatter.doc_in_scope(relative, root):
+            continue
+        error = caddis_frontmatter.validate(
+            path.read_text(encoding="utf-8"), caddis_frontmatter.ALLOWED_TYPES
+        )
+        if error:
+            print(f"{relative}: {error}")
+            failures += 1
+    return EXIT_BLOCKED if failures else EXIT_OK
+
+
 def main(argv: list[str] | None = None) -> int:
     ap = argparse.ArgumentParser(description="caddis machine gates")
     sub = ap.add_subparsers(dest="cmd", required=True)
@@ -625,9 +640,17 @@ def main(argv: list[str] | None = None) -> int:
     hc = sub.add_parser("handover-check")
     hc.add_argument("--doc", required=True)
     hc.add_argument("--repo-root", default=".")
+    dc = sub.add_parser("docs-check")
+    dc.add_argument("--root", default=".")
     a = ap.parse_args(argv)
 
     plan = Path(getattr(a, "plan", "") or ".")
+    if a.cmd == "docs-check":
+        try:
+            return gate_docs_check(Path(a.root).resolve())
+        except Exception as exc:
+            sys.stderr.write(f"[caddis-gate] docs-check cannot evaluate: {type(exc).__name__}: {exc}\n")
+            return EXIT_BLOCKED  # CI must not pass without completing the scan.
     try:
         if a.cmd == "lane-check":
             return gate_lane(plan, a.phase)

package/bundles/antigravity-plugin/scripts/caddis_governor.py

@@ -55,8 +55,11 @@ import sys
 from dataclasses import dataclass
 from pathlib import Path
 
-EXIT_USAGE = 2
-EXIT_CONFIG = 3
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+import caddis_exit  # noqa: E402
+
+EXIT_USAGE = caddis_exit.ERROR
+EXIT_CONFIG = caddis_exit.NOT_RUN
 SCOPES = ("session", "lane")
 MAX_CPU_PERCENT = 100
 MAX_MEMORY_MB = 1_048_576

package/bundles/antigravity-plugin/scripts/caddis_lanes.py

@@ -20,11 +20,23 @@ from dataclasses import dataclass
 from datetime import datetime, timezone
 from pathlib import Path
 
+try:
+    import caddis_exit
+except ModuleNotFoundError as exc:
+    if exc.name != "caddis_exit":
+        raise
+    sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "claude-harness" / "scripts"))
+    import caddis_exit
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(encoding="utf-8", errors="replace")
     sys.stderr.reconfigure(encoding="utf-8", errors="replace")
 
-EXIT_OK, EXIT_FAIL, EXIT_USAGE, EXIT_CONFIG, EXIT_ALL_OUT = 0, 1, 2, 3, 4
+EXIT_OK = caddis_exit.CLEAN
+EXIT_FAIL = caddis_exit.BLOCKED
+EXIT_USAGE = caddis_exit.ERROR
+EXIT_CONFIG = caddis_exit.NOT_RUN
+EXIT_ALL_OUT = caddis_exit.NOT_RUN
 RESULT_OK = "OK"
 RESULT_LANE_FAILED = "LANE-FAILED"
 RESULT_OUT_OF_BUDGET = "OUT-OF-BUDGET"

package/bundles/antigravity-plugin/scripts/caddis_migrate_dir.py

@@ -45,7 +45,7 @@ NEW_DIR = ".caddis"
 OLD_DIR = ".claudster"
 
 #: Append-only JSONL logs: safe to concatenate when both dirs carry one (legacy lines first).
-JSONL_MERGE_NAMES = frozenset({"usage-log.jsonl", "agent-log.jsonl", "memory.jsonl"})
+JSONL_MERGE_NAMES = frozenset({"usage-log.jsonl", "agent-log.jsonl"})
 
 #: Files whose CONTENT may name the old dir and is read live after the migration. Historical
 #: artifacts (plans, handoffs, past reviews) are deliberately NOT rewritten — they are a record of

package/bundles/antigravity-plugin/scripts/caddis_spawn.py

@@ -273,7 +273,7 @@ def read_context_pct(repo_root: Path) -> tuple[float | None, str]:
         age = max(0, int(time.time()) - int(raw.get("at", 0)))
     except Exception:
         return None, ("no runtime context figure at "
-                      + f"{ART}/context-window.json — run `/caddis:statusline` to install the "
+                      + f"{ART}/context-window.json — run `/caddis:install-statusline` to install the "
                       "status line that writes it")
     if age > CONTEXT_MAX_AGE_S:
         return pct, f"runtime figure, STALE by {age}s (a lower bound — the real number is >= this)"
@@ -386,7 +386,7 @@ def _gate_context(p: Preflight, repo_root: Path, self_reported: float | None) ->
     if pct is None:
         p.refusals.append(
             "no context figure, so the 95% gate cannot be applied — and a gate that defaults to "
-            "proceed is not a gate. Either run `/caddis:statusline` (its status line caches the "
+            "proceed is not a gate. Either run `/caddis:install-statusline` (its status line caches the "
             "runtime figure for this repo), or pass `--context-pct <n>` with the number your "
             "harness reports. A self-reported figure is accepted and recorded as such.")
         return

package/bundles/antigravity-plugin/scripts/caddis_statusline.py

@@ -615,7 +615,6 @@ def render_agy(data: dict, cfg: dict) -> str:
             used = as_int(cw.get("total_input_tokens"))
         max_tokens = as_int(cw.get("context_window_size")) or 1_048_576
         pct = float(as_int(cw.get("used_percentage")))
-        record_context(cwd, pct)
         parts.append(context_segment(c, cfg, used, max_tokens, pct))
         loud = cached_segment(c, cfg, cached)
         if loud:

package/bundles/antigravity-plugin/scripts/caddis_tidy.py

@@ -38,6 +38,14 @@ import sys
 from dataclasses import dataclass, field
 from pathlib import Path
 
+try:
+    import caddis_frontmatter
+except ModuleNotFoundError as exc:
+    if exc.name != "caddis_frontmatter":
+        raise
+    sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "claude-harness" / "scripts"))
+    import caddis_frontmatter
+
 TERMINAL_STATUSES = {"done", "superseded", "shipped", "implemented"}
 
 # Legacy prompts written before the frontmatter convention existed (2026-07-23). They were
@@ -95,20 +103,7 @@ PARKING_LOT_MAX_BYTES = 20_000
 
 
 def _parse_frontmatter(text: str) -> dict:
-    text = text.lstrip("")
-    if not text.startswith("---"):
-        return {}
-    lines = text.splitlines()
-    if lines[0].strip() != "---":
-        return {}
-    fm: dict[str, str] = {}
-    for line in lines[1:]:
-        if line.strip() == "---":
-            break
-        if ":" in line:
-            k, _, v = line.partition(":")
-            fm[k.strip()] = v.strip()
-    return fm
+    return caddis_frontmatter.parse(text)
 
 
 def _phases_all_done(text: str) -> bool:

package/bundles/antigravity-plugin/scripts/claudster_doctor.py

@@ -15,11 +15,14 @@ Usage:
 from __future__ import annotations
 
 import argparse
+import importlib.util
 import json
 import os
+import re
 import shutil
 import subprocess
 import sys
+import time
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -97,6 +100,28 @@ def rules_findings(dest: Path) -> list[str]:
     return out
 
 
+def has_document_frontmatter_rule(dest: Path) -> bool:
+    """True when root AGENTS.md puts type: in its Document frontmatter section."""
+    path = Path(dest) / "AGENTS.md"
+    try:
+        lines = path.read_text(encoding="utf-8").splitlines()
+    except OSError:
+        return False
+    section = False
+    for line in lines:
+        if re.match(r"^\s*(?:#{1,6}\s+|[-*]\s+\*\*)Document frontmatter(?:\*\*)?\s*:?.*$", line):
+            section = True
+            if "type:" in line:
+                return True
+            continue
+        if section and ("type:" in line or re.match(r"^\s*[-*]\s+\*\*type\*\*\s*:", line)):
+            return True
+        if section and (re.match(r"^#{1,6}\s+", line) or
+                        re.match(r"^\s*[-*]\s+\*\*[^*]+\*\*\s*:", line)):
+            section = False
+    return False
+
+
 def oversize_rules_files(dest: Path, budget: int = AGENTS_MD_BUDGET) -> list[tuple[str, int]]:
     """Always-loaded rules files (AGENTS.md, or CLAUDE.md pre-migration) over the line budget."""
     dest = Path(dest)
@@ -287,6 +312,36 @@ def nudge_line(dest: Path) -> str | None:
     return f"[caddis] {head}{more}"
 
 
+def hook_errors(dest: Path) -> str:
+    """Recent hook failures, counted by hook. Empty when the ledger is clean."""
+    scripts = Path(__file__).resolve().parent
+    hook_log_path = scripts / "hook_log.py"
+    if not hook_log_path.is_file():  # source checkout; installed copies are siblings
+        hook_log_path = scripts.parent / "claude-harness" / "scripts" / "hook_log.py"
+    try:
+        spec = importlib.util.spec_from_file_location("caddis_hook_log", hook_log_path)
+        if spec is None or spec.loader is None:
+            return ""
+        hook_log = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(hook_log)
+        if not hook_log.summarise(str(dest), days=7):
+            return ""
+        cutoff = time.strftime("%Y-%m-%d", time.localtime(time.time() - 7 * 86400))
+        counts: dict[str, int] = {}
+        with (dest / ".caddis" / "hook-errors.jsonl").open(encoding="utf-8", errors="replace") as fh:
+            for line in fh:
+                try:
+                    row = json.loads(line)
+                except (ValueError, TypeError):
+                    continue
+                if isinstance(row, dict) and str(row.get("ts", ""))[:10] >= cutoff:
+                    hook = str(row.get("hook", "?"))
+                    counts[hook] = counts.get(hook, 0) + 1
+        return ", ".join(f"{hook} x{count}" for hook, count in sorted(counts.items()))
+    except Exception:
+        return ""  # a damaged ledger must not break the doctor
+
+
 # ── report ───────────────────────────────────────────────────────────────────
 def run(dest: Path, quiet: bool) -> int:
     if quiet:  # SessionStart mode: only the nudge, never non-zero
@@ -316,6 +371,11 @@ def run(dest: Path, quiet: bool) -> int:
         root = dest / "AGENTS.md"
         print(f"  OK   root AGENTS.md {'present' if root.is_file() else 'ABSENT (not migrated yet?)'}; shims are shims")
 
+    if has_document_frontmatter_rule(dest):
+        print("  OK   AGENTS.md carries the document-header rule")
+    else:
+        print("  WARN AGENTS.md carries the document-header rule: missing Document frontmatter section with type:")
+
     print("-- maintenance signals (deterministic — read-only)")
     sig = maintenance_signals(dest)
     if sig:
@@ -324,6 +384,12 @@ def run(dest: Path, quiet: bool) -> int:
     else:
         print("  none")
 
+    errors = hook_errors(dest)
+    if errors:
+        print(f"  WARN hook errors (7 days): {errors}")
+    else:
+        print("  OK   hook errors (7 days): 0")
+
     print("-- install registry")
     reg = _user_scope_path("installs.json")
     if reg.is_file():