its-magic 0.1.2-42 → 0.1.2-43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "its-magic",
-  "version": "0.1.2-42",
+  "version": "0.1.2-43",
   "description": "its-magic - AI dev team workflow for Cursor.",
   "license": "MIT",
   "bin": {

package/scripts/check_intake_template_parity.py

@@ -1,5 +1,11 @@
 #!/usr/bin/env python3
-"""Verify active vs template/scripts/ bytes match for DEC-0063 intake gate modules (BUG-0001)."""
+"""Verify active vs template/scripts/ bytes match for DEC-0063 intake gate modules (BUG-0001).
+
+Scoped modes (DEC-0073 §10 / US-0090):
+  --scope=intake          (default) DEC-0063 intake pair table.
+  --scope=caveman-compress DEC-0073 caveman input-compression pair table.
+  --scope=all              union of both tables.
+"""
 
 from __future__ import annotations
 
@@ -7,7 +13,6 @@ import argparse
 import sys
 from pathlib import Path
 
-# Normative pairs: repo scripts/ (canonical dev) → template/scripts/ (packaged ship path).
 INTAKE_TEMPLATE_PAIRS: tuple[tuple[str, str], ...] = (
     ("scripts/intake_evidence_validate.py", "template/scripts/intake_evidence_validate.py"),
     ("scripts/intake_evidence_lib.py", "template/scripts/intake_evidence_lib.py"),
@@ -16,6 +21,24 @@ INTAKE_TEMPLATE_PAIRS: tuple[tuple[str, str], ...] = (
     ("scripts/check_intake_template_parity.py", "template/scripts/check_intake_template_parity.py"),
 )
 
+# DEC-0073 §10 / US-0090 — Caveman input-compression surface pairs. Contents
+# must be byte-identical between active and template paths; installer delivers
+# template copies (BUG-0003 / DEC-0066).
+CAVEMAN_COMPRESS_PAIRS: tuple[tuple[str, str], ...] = (
+    ("scripts/caveman_compress_input.py", "template/scripts/caveman_compress_input.py"),
+    ("docs/engineering/context/installer-owned-paths.manifest",
+     "template/docs/engineering/context/installer-owned-paths.manifest"),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    ("docs/engineering/auto-orchestration-reference.md",
+     "template/docs/engineering/auto-orchestration-reference.md"),
+)
+
+SCOPES: dict[str, tuple[tuple[str, str], ...]] = {
+    "intake": INTAKE_TEMPLATE_PAIRS,
+    "caveman-compress": CAVEMAN_COMPRESS_PAIRS,
+    "all": INTAKE_TEMPLATE_PAIRS + CAVEMAN_COMPRESS_PAIRS,
+}
+
 
 def main() -> int:
     p = argparse.ArgumentParser(description=__doc__)
@@ -25,10 +48,17 @@ def main() -> int:
         default=Path(__file__).resolve().parent.parent,
         help="Repository root",
     )
+    p.add_argument(
+        "--scope",
+        choices=sorted(SCOPES.keys()),
+        default="intake",
+        help="Parity pair table to verify.",
+    )
     args = p.parse_args()
     root: Path = args.repo
+    pairs = SCOPES[args.scope]
     failed = False
-    for rel_active, rel_tpl in INTAKE_TEMPLATE_PAIRS:
+    for rel_active, rel_tpl in pairs:
         a = root / rel_active
         t = root / rel_tpl
         if not a.is_file() or not t.is_file():
@@ -45,7 +75,7 @@ def main() -> int:
             failed = True
     if failed:
         return 2
-    print("[INTAKE_TEMPLATE_PARITY_OK]")
+    print(f"[INTAKE_TEMPLATE_PARITY_OK] scope={args.scope}")
     return 0
 
 

package/scripts/guard_installer_publish.py

@@ -1,8 +1,5 @@
 #!/usr/bin/env python3
-"""Prepublish / CI guard: installer.sh LF + POSIX-safe startup tokens (US-0084 / AC-2).
-
-BUG-0008: reject CR bytes in installer-owned-paths.manifest (CRLF breaks POSIX awk section match).
-"""
+"""Prepublish / CI guard: installer.sh LF + POSIX-safe startup tokens (US-0084 / AC-2)."""
 
 from __future__ import annotations
 
@@ -13,10 +10,6 @@ from pathlib import Path
 
 ROOT = Path(__file__).resolve().parents[1]
 INSTALLER_SH = ROOT / "installer.sh"
-INSTALLER_MANIFESTS = (
-    ROOT / "docs" / "engineering" / "context" / "installer-owned-paths.manifest",
-    ROOT / "template" / "docs" / "engineering" / "context" / "installer-owned-paths.manifest",
-)
 
 FORBIDDEN_TOKENS = (
     "set -euo",
@@ -39,17 +32,6 @@ def main() -> int:
             file=sys.stderr,
         )
         return 1
-    for man in INSTALLER_MANIFESTS:
-        if not man.is_file():
-            continue
-        mdata = man.read_bytes()
-        if b"\r" in mdata:
-            print(
-                f"guard_installer_publish: CR/LF (\\r) bytes found in {man.relative_to(ROOT)} — "
-                "use LF only (.gitattributes *.manifest; BUG-0008).",
-                file=sys.stderr,
-            )
-            return 1
     text = data.decode("utf-8", errors="replace")
     for token in FORBIDDEN_TOKENS:
         if token in text:

package/template/.cursor/rules/caveman.mdc

@@ -0,0 +1,141 @@
+---
+description: "Caveman mode (US-0089) — optional response-side terse voice, default off"
+globs: ["**/*"]
+---
+
+# Caveman mode (US-0089)
+
+This rule composes an optional **response-side** terse / imperative assistant
+voice. It is **default off**. When `CAVEMAN_MODE` is unset or `0`, this rule
+adds **zero** behavioral change and the assistant responds exactly as it did
+pre-US-0089.
+
+Inspired by JuliusBrussee/caveman (MIT). External reference only; not vendored.
+
+## Scratchpad gate (authoritative across subagent spawns)
+
+Read the merged scratchpad (`.cursor/scratchpad.md`, then optional
+`.cursor/scratchpad.local.md` overrides per **DEC-0055**) for these keys:
+
+- `CAVEMAN_MODE=0|1` — default `0`. Absence is equivalent to `0`.
+- `CAVEMAN_LEVEL=lite|full|ultra` — default empty.
+  - With `CAVEMAN_MODE=0`: inert regardless of value.
+  - With `CAVEMAN_MODE=1` and `CAVEMAN_LEVEL` empty: treat as `full`
+    (mid-tier default, matching upstream reference).
+  - With `CAVEMAN_MODE=1` and a listed level: apply that level.
+  - With `CAVEMAN_MODE=1` and any other non-empty value: fail closed with
+    deterministic reason code `CAVEMAN_LEVEL_UNKNOWN` and fall back to
+    pre-US-0089 voice (no terseness applied) while continuing the turn.
+- `CAVEMAN_COMPRESS_INPUT=0|1` — **reserved for US-0090**; inert in US-0089;
+  no behavior until the compression story ships.
+- `CAVEMAN_FILE_SCOPE=` — **reserved for US-0090**; inert in US-0089; no
+  behavior until the compression story ships.
+
+Scratchpad values are **authoritative across subagent spawns**. Session
+toggle phrases (see below) are overlays for the current conversation only
+and do NOT persist across a fresh subagent context.
+
+## Literal-region invariant (9-zone hard MUST)
+
+When `CAVEMAN_MODE=1`, the following output regions remain **byte-literal**
+(no abbreviation, no rewording, no casing change). This rule is phrased as
+**MUST**, not SHOULD:
+
+1. **Fenced code blocks** — both plain triple-backtick blocks and CODE
+   REFERENCE blocks of the form `startLine:endLine:filepath`. Content, line
+   numbers, filepath, language tags, and whitespace preserved.
+2. **File / path strings** — anything matching
+   `` `[\w./-]+\.(md|py|ps1|sh|json|mdc|ts|tsx|js|jsx|yml|yaml|toml|ini|env|example|manifest)` ``
+   or enclosed in backticks that points to a repo path. Preserve extension
+   and case.
+3. **AC checklist items** — bullets of form `- [ ]` or `- [x]` and their
+   entire text (AC-1..AC-N).
+4. **Reason codes** — `ALL_CAPS_WITH_UNDERSCORES` tokens such as
+   `PHASE_CONTEXT_ISOLATION_VIOLATION`, `RUNTIME_PROOF_MISSING`,
+   `AUTO_RESUME_ERROR`, `AUTO_SCHEDULER_CONFLICT`, `REMOTE_TARGET_UNKNOWN`,
+   `CAVEMAN_LEVEL_UNKNOWN`, `INTAKE_PERSISTENCE_BLOCKED`.
+5. **IDs** — `US-xxxx`, `DEC-xxxx`, `R-xxxx`, `BUG-####`, `S0xxx`, `T-xxx`.
+6. **Contract markers** — `[BUG_VALIDATION_OK]`,
+   `[INTAKE_EVIDENCE_VALIDATION_OK]`, `[SCRATCHPAD_PAIR_OK]`,
+   `[ARTIFACT_ORDERING_ANCHOR_AMBIGUOUS]`, `[CODEBASE_MAP_OK]`, and siblings.
+7. **Strict-proof tuple fields** — `orchestrator_run_id`, `runtime_proof_id`,
+   `proof_hash`, `proof_issued_at`, `proof_ttl_seconds`, `phase_id`, `role`
+   (DEC-0038).
+8. **Isolation evidence fields** — `fresh_context_marker`, `evidence_ref`,
+   `timestamp` (DEC-0029).
+9. **Commit / git refs** — quoted `git commit` messages, branch names, SHAs,
+   `HEAD`, tag names.
+
+Forbidden "garbling" examples (never permitted even under `ultra`): dropping
+the `US-` prefix from an ID, lowercasing a reason code, collapsing a fenced
+code block into a bullet, truncating a path mid-filename, abbreviating a
+proof hash.
+
+## Non-suppressible gate vocabulary (inherited from US-0088)
+
+Caveman voice MUST NOT remove or abbreviate the following gate tokens — they
+render byte-literal even under `CAVEMAN_LEVEL=ultra`:
+
+- `decision_gate`
+- `error`
+- `pause`
+- `loop_max`
+- `blocked`
+- `missing input`
+- `[BUG_VALIDATION_OK]`
+- `[INTAKE_EVIDENCE_VALIDATION_OK]`
+- `[SCRATCHPAD_PAIR_OK]`
+
+## Operator toggle phrases (canonical set)
+
+| Phrase | Effect |
+|--------|--------|
+| `caveman on` | Enable Caveman voice for the session (overlay). Effective from the next assistant turn. |
+| `caveman off` | Disable Caveman voice for the session (overlay). Effective from the next assistant turn. |
+| `stop caveman` | Alias for `caveman off`. |
+| `normal mode` | Alias for `caveman off`. |
+| `caveman: lite|full|ultra` | Set level for the session (implies `caveman on`). Effective from the next assistant turn. Accepts the three literal tokens `caveman: lite`, `caveman: full`, `caveman: ultra`. |
+
+Determinism rules:
+
+- Scratchpad `CAVEMAN_MODE` / `CAVEMAN_LEVEL` are **authoritative across
+  subagent spawns**; session toggles are overlays for the current
+  conversation only and do NOT persist across a fresh subagent context.
+- Within a session, the **last explicit toggle wins**.
+- A mid-turn toggle applies **from the next turn onward**; current-turn
+  machine-verifiable artifacts (gate messages, reason codes, strict-proof
+  tuples, isolation-evidence fields) remain literal regardless of the
+  toggle.
+- Ambiguous phrases (`be caveman-lite`, `quiet caveman`, `cave man off`,
+  etc.) are **not recognized** — only the exact literal matches above fire.
+
+## Composition (non-substitution) with TOKEN_PROFILE
+
+`TOKEN_PROFILE` controls context breadth. `CAVEMAN_MODE` controls reply
+voice. Neither substitutes for the other; setting one does not change the
+other. Combine freely.
+
+## Default-off invariant
+
+With `CAVEMAN_MODE=0` or absent, this rule adds zero behavioral change:
+existing command strings, gate ordering, spawn-only phrasing (BUG-0006),
+contract-test token lists, `AUTO_QUIET` non-suppressible vocabulary
+(US-0088), user-visible ID metadata (US-0071), strict-proof tuples
+(DEC-0038), and isolation evidence fields (DEC-0029) all remain unchanged.
+
+## Non-goals (US-0089)
+
+- No input-side file compression. `CAVEMAN_COMPRESS_INPUT` and
+  `CAVEMAN_FILE_SCOPE` are documented no-ops here; US-0090 owns that
+  vertical.
+- No change to `TOKEN_PROFILE` (DEC-0035 / US-0080), context packs, archive
+  policy, or phase-context slimming.
+- No rewrite of canonical artifacts (`docs/product/backlog.md`,
+  `docs/product/acceptance.md`, `docs/engineering/state.md` schema,
+  `docs/engineering/decisions.md`, DEC files).
+- No new npm / Python dependencies. No `package.json` edit.
+- No vendor plugin install. No package-manager install recipe is surfaced;
+  the JuliusBrussee/caveman reference is documentation-only.
+- No change to spawn-only orchestration (US-0048 / DEC-0029 / BUG-0006),
+  strict runtime proof (DEC-0038), `AUTO_QUIET` non-suppressible list
+  (US-0088), or US-0071 visible-metadata rules.