statutor 0.5.0__tar.gz → 0.5.1__tar.gz

{statutor-0.5.0/core/statutor.egg-info → statutor-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: statutor
-Version: 0.5.0
+Version: 0.5.1
 Summary: Typed project-ledger framework for agentic repos: four planes, single-writer files, enforced mutation policies.
 Author: Hoo
 License-Expression: MIT
@@ -114,7 +114,7 @@ baselines); `worker compare <ref>` explains sibling handoffs read-only.
     # .pre-commit-config.yaml
     repos:
       - repo: https://github.com/hoohugokim/statutor
-        rev: v0.5.0
+        rev: v0.5.1
         hooks: [{id: statutor}]
 
 Per-repo policy lives in `.statutor.yaml`. In-loop checks use the committed

{statutor-0.5.0 → statutor-0.5.1}/README.md

@@ -89,7 +89,7 @@ baselines); `worker compare <ref>` explains sibling handoffs read-only.
     # .pre-commit-config.yaml
     repos:
       - repo: https://github.com/hoohugokim/statutor
-        rev: v0.5.0
+        rev: v0.5.1
         hooks: [{id: statutor}]
 
 Per-repo policy lives in `.statutor.yaml`. In-loop checks use the committed

{statutor-0.5.0 → statutor-0.5.1/core/statutor.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: statutor
-Version: 0.5.0
+Version: 0.5.1
 Summary: Typed project-ledger framework for agentic repos: four planes, single-writer files, enforced mutation policies.
 Author: Hoo
 License-Expression: MIT
@@ -114,7 +114,7 @@ baselines); `worker compare <ref>` explains sibling handoffs read-only.
     # .pre-commit-config.yaml
     repos:
       - repo: https://github.com/hoohugokim/statutor
-        rev: v0.5.0
+        rev: v0.5.1
         hooks: [{id: statutor}]
 
 Per-repo policy lives in `.statutor.yaml`. In-loop checks use the committed

{statutor-0.5.0 → statutor-0.5.1}/core/statutor_core.py

@@ -787,6 +787,13 @@ def _automatic_reason(tool: str, payload: dict, cwd: str) -> str | None:
     return None
 
 def run_hook() -> int:
+    if sys.stdin.isatty():
+        # A TTY means a human ran the hook with no piped event (harnesses
+        # always pipe JSON). Fail fast with usage instead of blocking on
+        # stdin forever; fail-open applies to hook *events*, not misuse.
+        print("statutor hook expects piped hook JSON on stdin; "
+              "run `statutor --help` for modes.", file=sys.stderr)
+        return 64
     try:
         event = json.load(sys.stdin)
         tool = event.get("tool_name", "")
@@ -1412,7 +1419,12 @@ def run_init(target: str) -> int:
 
 def main() -> None:
     argv = sys.argv[1:]
-    mode = argv[0] if argv else "hook"
+    if not argv or argv[0] in ("--help", "-h"):
+        # Bare invocation must never fall through to hook mode (which blocks
+        # on stdin); print usage instead. --help exits clean, bare exits 64.
+        print(__doc__)
+        sys.exit(0 if argv else 64)
+    mode = argv[0]
     if mode in ("hook", "--claude-hook"):
         sys.exit(run_hook())
     if mode == "check":

{statutor-0.5.0 → statutor-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "statutor"
-version = "0.5.0"
+version = "0.5.1"
 description = "Typed project-ledger framework for agentic repos: four planes, single-writer files, enforced mutation policies."
 readme = "README.md"
 license = "MIT"