its-magic 0.1.2-9 → 0.1.2

package/package.json

@@ -1,27 +1,31 @@
 {
   "name": "its-magic",
-  "version": "0.1.2-9",
+  "version": "0.1.2",
   "description": "its-magic - AI dev team workflow for Cursor.",
   "license": "MIT",
   "bin": {
     "its-magic": "bin/its-magic.js"
   },
   "files": [
-    ".cursor/",
-    ".github/",
-    "decisions/",
-    "docs/",
-    "handoffs/",
-    "milestones/",
-    "scripts/",
-    "sprints/",
-    "gsd-installer.ps1",
-    "gsd-installer.sh",
-    "gsd-installer.py",
-    "README.md",
-    "bin/its-magic.js"
+    "template/",
+    "installer.ps1",
+    "installer.sh",
+    "installer.py",
+    "scripts/doc_profile_lib.py",
+    "scripts/intake_evidence_validate.py",
+    "scripts/intake_evidence_lib.py",
+    "scripts/intake_bug_routing_guard.py",
+    "scripts/check_intake_template_parity.py",
+    "scripts/materialize_codebase_map.py",
+    "scripts/remote_config_summary.py",
+    "scripts/guard_installer_publish.py",
+    "bin/its-magic.js",
+    "bin/postinstall.js"
   ],
   "scripts": {
+    "guard:installer": "python scripts/guard_installer_publish.py",
+    "prepublishOnly": "npm run guard:installer",
+    "postinstall": "node bin/postinstall.js",
     "release:patch": "npm version patch && npm publish",
     "release:minor": "npm version minor && npm publish",
     "release:major": "npm version major && npm publish",

package/scripts/check_intake_template_parity.py

@@ -0,0 +1,284 @@
+#!/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",
+    ),
+)
+
+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,
+    "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
+    ),
+}
+
+
+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())