its-magic 0.1.2-9 → 0.1.3-0

package/template/scripts/check_downstream_ci_guard.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""
+Downstream CI drift guard CLI (BUG-0009 / DEC-0075).
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+_SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+_REPO_ROOT = os.path.normpath(os.path.join(_SCRIPT_DIR, ".."))
+
+if _SCRIPT_DIR not in sys.path:
+    sys.path.insert(0, _SCRIPT_DIR)
+
+import downstream_ci_guard_lib as dci  # noqa: E402
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="Downstream CI drift guard (template forbidden scan + active inventory)."
+    )
+    parser.add_argument(
+        "--repo",
+        default=_REPO_ROOT,
+        help="Target repository root (default: parent of scripts/).",
+    )
+    parser.add_argument(
+        "--self-test",
+        action="store_true",
+        help="Run stable marker subtests.",
+    )
+    parser.add_argument(
+        "--report",
+        action="store_true",
+        help="Emit JSON inventory to stdout.",
+    )
+    args = parser.parse_args()
+
+    if args.self_test:
+        try:
+            dci.self_test()
+        except AssertionError as exc:
+            print(f"self-test failed: {exc}", file=sys.stderr)
+            return 2
+        print("[DOWNSTREAM_CI_GUARD_SELF_TEST_OK]")
+        return 0
+
+    target = os.path.abspath(args.repo)
+    report, stderr_lines = dci.build_report(target)
+
+    if args.report:
+        print(json.dumps(dci.report_to_dict(report), sort_keys=True, separators=(",", ":")))
+
+    for line in stderr_lines:
+        print(line, file=sys.stderr)
+
+    if not report.ok:
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/template/scripts/check_intake_template_parity.py

@@ -0,0 +1,312 @@
+#!/usr/bin/env python3
+"""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=readme-feature-coverage DEC-0074 README feature-coverage pair table.
+  --scope=downstream-ci-guard   DEC-0075 downstream CI guard script pair table.
+  --scope=us-0092               DEC-0078 full-autonomy outer driver + probe surfaces.
+  --scope=us-0093               DEC-0079 browser UAT probe surfaces.
+  --scope=us-0095               DEC-0080 native in-chat auto-chain surfaces.
+  --scope=bug-0012              DEC-0081 native-chain compliance surfaces (BUG-0012).
+  --scope=us-0096               DEC-0082 delivery modes surfaces (US-0096).
+  --scope=project-readme        DEC-0083 project README bootstrap surfaces (US-0097).
+  --scope=dev-environment       DEC-0084 dev auto-launch profile surfaces (US-0098).
+  --scope=all              union of all tables.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import 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"),
+    ("scripts/intake_bug_routing_guard.py", "template/scripts/intake_bug_routing_guard.py"),
+    ("scripts/intake_bug_resume_brief_refresh.py", "template/scripts/intake_bug_resume_brief_refresh.py"),
+    ("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"),
+)
+
+README_FEATURE_COVERAGE_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        "scripts/validate_readme_feature_coverage.py",
+        "template/scripts/validate_readme_feature_coverage.py",
+    ),
+    (
+        "scripts/readme_feature_coverage_lib.py",
+        "template/scripts/readme_feature_coverage_lib.py",
+    ),
+    (
+        "docs/engineering/context/readme-section-affinity.json",
+        "template/docs/engineering/context/readme-section-affinity.json",
+    ),
+    (".cursor/commands/release.md", "template/.cursor/commands/release.md"),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "docs/engineering/context/installer-owned-paths.manifest",
+        "template/docs/engineering/context/installer-owned-paths.manifest",
+    ),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+US0092_PAIRS: tuple[tuple[str, str], ...] = (
+    ("scripts/auto_outer_driver.py", "template/scripts/auto_outer_driver.py"),
+    ("scripts/uat_probe_lib.py", "template/scripts/uat_probe_lib.py"),
+    (
+        "docs/engineering/context/installer-owned-paths.manifest",
+        "template/docs/engineering/context/installer-owned-paths.manifest",
+    ),
+    (".cursor/commands/auto.md", "template/.cursor/commands/auto.md"),
+    (".cursor/commands/verify-work.md", "template/.cursor/commands/verify-work.md"),
+    (".cursor/commands/qa.md", "template/.cursor/commands/qa.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+)
+
+US0093_PAIRS: tuple[tuple[str, str], ...] = (
+    ("scripts/uat_probe_lib.py", "template/scripts/uat_probe_lib.py"),
+    (".cursor/commands/verify-work.md", "template/.cursor/commands/verify-work.md"),
+    (".cursor/commands/qa.md", "template/.cursor/commands/qa.md"),
+    (".cursor/commands/execute.md", "template/.cursor/commands/execute.md"),
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    (
+        "docs/engineering/context/installer-owned-paths.manifest",
+        "template/docs/engineering/context/installer-owned-paths.manifest",
+    ),
+)
+
+US0095_PAIRS: tuple[tuple[str, str], ...] = (
+    (".cursor/commands/auto.md", "template/.cursor/commands/auto.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    ("README.md", "template/README.md"),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+BUG0012_PAIRS: tuple[tuple[str, str], ...] = (
+    (".cursor/commands/auto.md", "template/.cursor/commands/auto.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+US0096_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    (".cursor/commands/auto.md", "template/.cursor/commands/auto.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (".cursor/commands/quick.md", "template/.cursor/commands/quick.md"),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+    ("scripts/pack_json_validate.py", "template/scripts/pack_json_validate.py"),
+)
+
+PROJECT_README_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        "scripts/validate_project_readme_coverage.py",
+        "template/scripts/validate_project_readme_coverage.py",
+    ),
+    (
+        "scripts/project_readme_coverage_lib.py",
+        "template/scripts/project_readme_coverage_lib.py",
+    ),
+    (".cursor/commands/execute.md", "template/.cursor/commands/execute.md"),
+    (".cursor/commands/release.md", "template/.cursor/commands/release.md"),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "docs/engineering/context/installer-owned-paths.manifest",
+        "template/docs/engineering/context/installer-owned-paths.manifest",
+    ),
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+DEV_ENVIRONMENT_PAIRS: tuple[tuple[str, str], ...] = (
+    (".cursor/commands/execute.md", "template/.cursor/commands/execute.md"),
+    (".cursor/scratchpad.md", "template/.cursor/scratchpad.md"),
+    (
+        ".cursor/scratchpad.local.example.md",
+        "template/.cursor/scratchpad.local.example.md",
+    ),
+    (
+        "template/.cursor/dev-environment.json.example",
+        "template/.cursor/dev-environment.json.example",
+    ),
+    (
+        "scripts/dev_environment_lib.py",
+        "template/scripts/dev_environment_lib.py",
+    ),
+    ("docs/engineering/runbook.md", "template/docs/engineering/runbook.md"),
+    (
+        "docs/engineering/auto-orchestration-reference.md",
+        "template/docs/engineering/auto-orchestration-reference.md",
+    ),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+RELEASE_CHANGELOG_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        "scripts/release_changelog_lib.py",
+        "template/scripts/release_changelog_lib.py",
+    ),
+    (
+        "scripts/release_changelog_validate.py",
+        "template/scripts/release_changelog_validate.py",
+    ),
+    (
+        "scripts/release_changelog_backfill.py",
+        "template/scripts/release_changelog_backfill.py",
+    ),
+    ("CHANGELOG.md", "template/CHANGELOG.md"),
+    (".cursor/commands/release.md", "template/.cursor/commands/release.md"),
+    ("scripts/release-all.sh", "template/scripts/release-all.sh"),
+    (
+        "template/handoffs/releases/vX.Y.Z-release-notes.md.example",
+        "template/handoffs/releases/vX.Y.Z-release-notes.md.example",
+    ),
+    (
+        "scripts/check_intake_template_parity.py",
+        "template/scripts/check_intake_template_parity.py",
+    ),
+)
+
+DOWNSTREAM_CI_GUARD_PAIRS: tuple[tuple[str, str], ...] = (
+    (
+        "scripts/check_downstream_ci_guard.py",
+        "template/scripts/check_downstream_ci_guard.py",
+    ),
+    (
+        "scripts/downstream_ci_guard_lib.py",
+        "template/scripts/downstream_ci_guard_lib.py",
+    ),
+)
+
+SCOPES: dict[str, tuple[tuple[str, str], ...]] = {
+    "intake": INTAKE_TEMPLATE_PAIRS,
+    "caveman-compress": CAVEMAN_COMPRESS_PAIRS,
+    "readme-feature-coverage": README_FEATURE_COVERAGE_PAIRS,
+    "downstream-ci-guard": DOWNSTREAM_CI_GUARD_PAIRS,
+    "us-0092": US0092_PAIRS,
+    "us-0093": US0093_PAIRS,
+    "us-0095": US0095_PAIRS,
+    "bug-0012": BUG0012_PAIRS,
+    "us-0096": US0096_PAIRS,
+    "project-readme": PROJECT_README_PAIRS,
+    "dev-environment": DEV_ENVIRONMENT_PAIRS,
+    "release-changelog": RELEASE_CHANGELOG_PAIRS,
+    "all": (
+        INTAKE_TEMPLATE_PAIRS
+        + CAVEMAN_COMPRESS_PAIRS
+        + README_FEATURE_COVERAGE_PAIRS
+        + DOWNSTREAM_CI_GUARD_PAIRS
+        + US0092_PAIRS
+        + US0093_PAIRS
+        + US0095_PAIRS
+        + BUG0012_PAIRS
+        + US0096_PAIRS
+        + PROJECT_README_PAIRS
+        + DEV_ENVIRONMENT_PAIRS
+        + RELEASE_CHANGELOG_PAIRS
+    ),
+}
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(description=__doc__)
+    p.add_argument(
+        "--repo",
+        type=Path,
+        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 pairs:
+        a = root / rel_active
+        t = root / rel_tpl
+        if not a.is_file() or not t.is_file():
+            print(f"[INTAKE_TEMPLATE_PARITY_ERROR] missing file: {rel_active} or {rel_tpl}")
+            failed = True
+            continue
+        ba = a.read_bytes()
+        bt = t.read_bytes()
+        if ba != bt:
+            print(
+                f"[INTAKE_TEMPLATE_PARITY_ERROR] mismatch: {rel_active} ({len(ba)}b) "
+                f"!= {rel_tpl} ({len(bt)}b)"
+            )
+            failed = True
+    if failed:
+        return 2
+    print(f"[INTAKE_TEMPLATE_PARITY_OK] scope={args.scope}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/template/scripts/check_token_cost_parity.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""Verify active vs template/ bytes match for DEC-0062 token-cost parity manifest paths."""
+
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+from pathlib import Path
+
+_PAIR_RE = re.compile(r"`([^`]+)`\s*→\s*`([^`]+)`")
+
+
+def load_pairs(manifest_text: str) -> list[tuple[Path, Path]]:
+    pairs: list[tuple[Path, Path]] = []
+    for line in manifest_text.splitlines():
+        line = line.strip()
+        if not line.startswith("- "):
+            continue
+        m = _PAIR_RE.search(line)
+        if not m:
+            continue
+        pairs.append((Path(m.group(1)), Path(m.group(2))))
+    return pairs
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(description=__doc__)
+    p.add_argument(
+        "--repo",
+        type=Path,
+        default=Path(__file__).resolve().parent.parent,
+        help="Repository root",
+    )
+    args = p.parse_args()
+    root: Path = args.repo
+    manifest = root / "docs/engineering/token-cost-parity-manifest.md"
+    if not manifest.is_file():
+        print(f"[TOKEN_COST_PARITY_ERROR] missing manifest: {manifest}")
+        return 2
+    text = manifest.read_text(encoding="utf-8")
+    pairs = load_pairs(text)
+    if not pairs:
+        print("[TOKEN_COST_PARITY_ERROR] no path pairs parsed from manifest")
+        return 2
+    failed = False
+    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():
+            print(f"[TOKEN_COST_PARITY_ERROR] missing file: {rel_active} or {rel_tpl}")
+            failed = True
+            continue
+        ba = a.read_bytes()
+        bt = t.read_bytes()
+        if ba != bt:
+            print(
+                f"[TOKEN_COST_PARITY_ERROR] mismatch: {rel_active} ({len(ba)}b) "
+                f"!= {rel_tpl} ({len(bt)}b)"
+            )
+            failed = True
+    if failed:
+        return 2
+    print("[TOKEN_COST_PARITY_OK]")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())