prizmkit 1.1.156 → 1.1.160

package/bundled/templates/hooks/commit-intent-status.py

@@ -1,48 +1,16 @@
 #!/usr/bin/env python3
-"""Report whether staged source changes include Prizm documentation updates."""
-
-from __future__ import annotations
-
-import subprocess
-
-SOURCE_EXTENSIONS = (".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java")
-PRIZM_DOCS_PREFIX = ".prizmkit/prizm-docs/"
-
-
-def staged_files() -> list[str]:
-    result = subprocess.run(
-        ["git", "diff", "--cached", "--name-only"],
-        text=True,
-        encoding="utf-8",
-        errors="replace",
-        stdout=subprocess.PIPE,
-        stderr=subprocess.DEVNULL,
-        check=False,
-    )
-    if result.returncode != 0:
-        return []
-    return [path for path in result.stdout.splitlines() if path.strip()]
+"""Emit Git-neutral PrizmKit lifecycle maintenance guidance."""
 
 
 def main() -> int:
-    files = staged_files()
-    source_files = [path for path in files if path.endswith(SOURCE_EXTENSIONS)]
-    if not source_files:
-        return 0
-
-    prizm_docs = [path for path in files if path.startswith(PRIZM_DOCS_PREFIX)]
-    if prizm_docs:
-        print(
-            f"PRIZMKIT_DOC_STATUS: {len(source_files)} source file(s) staged | "
-            f".prizmkit/prizm-docs/ updated ({len(prizm_docs)} file(s))",
-            end="",
-        )
-    else:
-        print(
-            f"PRIZMKIT_DOC_STATUS: {len(source_files)} source file(s) staged | "
-            ".prizmkit/prizm-docs/ NOT UPDATED — update if this is a feature change",
-            end="",
-        )
+    print(
+        "PRIZMKIT_MAINTENANCE_CHECK: If the validated change affects structure, "
+        "interfaces, dependencies, behavior, or durable TRAPS/RULES/DECISIONS, "
+        "run /prizmkit-retrospective before Committer. Retrospective never stages or "
+        "commits. Project Git policy controls whether .prizmkit paths are ignored, "
+        "untracked, or tracked; do not force-add or change ignore rules.",
+        end="",
+    )
     return 0
 
 

package/bundled/templates/hooks/commit-intent.json

@@ -6,18 +6,18 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 .prizmkit/scripts/commit-intent-status.py"
+            "command": "node .prizmkit/scripts/run-python-hook.cjs .prizmkit/scripts/commit-intent-status.py"
           }
         ]
       }
     ],
     "PostToolUse": [
       {
-        "matcher": "Bash",
+        "matcher": ".*",
         "hooks": [
           {
             "type": "command",
-            "command": "python3 .prizmkit/scripts/post-command-prizm-drift.py"
+            "command": "node .prizmkit/scripts/run-python-hook.cjs .prizmkit/scripts/post-command-prizm-drift.py"
           }
         ]
       }

package/bundled/templates/hooks/diff-prizm-docs.py

@@ -29,7 +29,9 @@ EXCLUDED_DIR_NAMES = {
     "__tests__",
     ".claude",
     ".codebuddy",
-    "dev-pipeline",
+    ".codex",
+    ".agents",
+    ".pi",
     "coverage",
     ".nyc_output",
     "out",

package/bundled/templates/hooks/prizm-pre-commit.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Git pre-commit hook that runs Prizm docs validation."""
+"""Fail-closed staged Prizm validation entry point for installed Git hooks."""
 
 from __future__ import annotations
 
@@ -7,6 +7,8 @@ import subprocess
 import sys
 from pathlib import Path
 
+DOCS_PREFIX = ".prizmkit/prizm-docs/"
+
 
 def run_git(args: list[str]) -> subprocess.CompletedProcess[str]:
     return subprocess.run(
@@ -15,29 +17,53 @@ def run_git(args: list[str]) -> subprocess.CompletedProcess[str]:
         encoding="utf-8",
         errors="replace",
         stdout=subprocess.PIPE,
-        stderr=subprocess.DEVNULL,
+        stderr=subprocess.PIPE,
         check=False,
     )
 
 
+def staged_prizm_docs() -> tuple[bool, str]:
+    result = run_git(["diff", "--cached", "--name-only", "-z", "--diff-filter=ACMRD"])
+    if result.returncode != 0:
+        return False, "PrizmKit: unable to inspect the staged index for Prizm validation."
+    paths = [path for path in result.stdout.split("\0") if path]
+    return any(path.startswith(DOCS_PREFIX) and path.endswith(".prizm") for path in paths), ""
+
+
 def main() -> int:
     root_result = run_git(["rev-parse", "--show-toplevel"])
     if root_result.returncode != 0:
         return 0
 
-    project_root = Path(root_result.stdout.strip())
-    if not (project_root / ".prizmkit/prizm-docs/root.prizm").is_file():
+    required, error = staged_prizm_docs()
+    if error:
+        print(error, file=sys.stderr)
+        return 1
+    if not required:
         return 0
 
+    project_root = Path(root_result.stdout.strip())
     candidates = [
         project_root / ".prizmkit/scripts/validate-prizm-docs.py",
         project_root / ".prizmkit/dev-pipeline/scripts/validate-prizm-docs.py",
     ]
     validate_script = next((candidate for candidate in candidates if candidate.is_file()), None)
     if validate_script is None:
-        return 0
+        print(
+            "PrizmKit: staged Prizm documents require validation, but the canonical validator is unavailable.",
+            file=sys.stderr,
+        )
+        return 1
 
-    result = subprocess.run([sys.executable, str(validate_script), "--staged"], cwd=project_root, check=False)
+    try:
+        result = subprocess.run(
+            [sys.executable, str(validate_script), "--staged"],
+            cwd=project_root,
+            check=False,
+        )
+    except OSError as exc:
+        print(f"PrizmKit: staged Prizm validation could not start: {exc}", file=sys.stderr)
+        return 1
     return result.returncode
 
 

package/bundled/templates/hooks/run-python-hook.cjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/* global process, require */
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+
+const [script, ...scriptArgs] = process.argv.slice(2);
+if (!script) {
+  process.stderr.write('PrizmKit: Python hook script path is required.\n');
+  process.exit(1);
+}
+
+const candidates = process.platform === 'win32'
+  ? [
+      { command: 'py', prefix: ['-3'] },
+      { command: 'python3', prefix: [] },
+      { command: 'python', prefix: [] },
+    ]
+  : [
+      { command: 'python3', prefix: [] },
+      { command: 'python', prefix: [] },
+      { command: 'py', prefix: ['-3'] },
+    ];
+
+for (const candidate of candidates) {
+  const result = spawnSync(
+    candidate.command,
+    [...candidate.prefix, script, ...scriptArgs],
+    { stdio: 'inherit', shell: false },
+  );
+  if (result.error && result.error.code === 'ENOENT') continue;
+  if (result.error) {
+    process.stderr.write(`PrizmKit: Python hook launch failed: ${result.error.message}\n`);
+    process.exit(1);
+  }
+  if (result.signal) {
+    process.stderr.write(`PrizmKit: Python hook terminated by ${result.signal}.\n`);
+    process.exit(1);
+  }
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+process.stderr.write('PrizmKit: Python 3 is required for this managed hook.\n');
+process.exit(1);