codhc 0.0.1__py3-none-any.whl

codhc/cli.py

@@ -0,0 +1,28 @@
+import json
+import sys
+from typing import TextIO
+
+from chc.hook_runner import run_hook_command
+
+
+def run_cli(*, argv: list[str], stdin_text: str) -> tuple[int, str, str]:
+    if not argv:
+        return (2, "", "Usage: chc <command> [args...]\n")
+
+    result = run_hook_command(command=argv, stdin_text=stdin_text)
+    return (0, f"{json.dumps(result.payload)}\n", result.stderr)
+
+
+def read_stdin_text(stdin: TextIO) -> str:
+    if stdin.isatty():
+        return ""
+    return stdin.read()
+
+
+def main() -> None:
+    exit_code, stdout_text, stderr_text = run_cli(argv=sys.argv[1:], stdin_text=read_stdin_text(sys.stdin))
+    if stderr_text:
+        sys.stderr.write(stderr_text)
+    if stdout_text:
+        sys.stdout.write(stdout_text)
+    raise SystemExit(exit_code)

codhc/hook_runner.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+import json
+import shlex
+import subprocess
+from dataclasses import dataclass
+from typing import Any
+
+
+@dataclass(frozen=True)
+class HookResult:
+    payload: dict[str, Any]
+    stderr: str
+
+
+def run_hook_command(*, command: list[str], stdin_text: str) -> HookResult:
+    stop_hook_active = _parse_stop_hook_active(stdin_text)
+    command_display = f"`{shlex.join(command)}`"
+    completed = _run_subprocess(command)
+
+    if completed.returncode == 0:
+        return HookResult(
+            payload={
+                "continue": False,
+                "systemMessage": f"{command_display} passed.",
+            },
+            stderr="",
+        )
+
+    if stop_hook_active:
+        return HookResult(
+            payload={
+                "continue": False,
+                "systemMessage": f"{command_display} failed after the Stop continuation pass.",
+            },
+            stderr=completed.output,
+        )
+
+    return HookResult(
+        payload={
+            "decision": "block",
+            "reason": f"{command_display} failed. Inspect the command output, fix the issues, then stop again.",
+        },
+        stderr=completed.output,
+    )
+
+
+@dataclass(frozen=True)
+class CommandResult:
+    returncode: int
+    output: str
+
+
+def _parse_stop_hook_active(stdin_text: str) -> bool:
+    if not stdin_text.strip():
+        return False
+
+    try:
+        payload = json.loads(stdin_text)
+    except json.JSONDecodeError:
+        return False
+
+    if not isinstance(payload, dict):
+        return False
+
+    return payload.get("stop_hook_active") is True
+
+
+def _run_subprocess(command: list[str]) -> CommandResult:
+    try:
+        completed = subprocess.run(
+            command,
+            check=False,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+        )
+    except FileNotFoundError as exc:
+        missing = exc.filename or command[0]
+        return CommandResult(returncode=127, output=f"{missing}: command not found\n")
+
+    return CommandResult(returncode=completed.returncode, output=completed.stdout)

codhc-0.0.1.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.3
+Name: codhc
+Version: 0.0.1
+Summary: 
+Author: narumi
+Author-email: narumi <toucans-cutouts0f@icloud.com>
+Requires-Dist: typer>=0.24.1
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Codex Hook Command
+
+`chc` is a small CLI wrapper for Codex hooks. It runs an external command,
+inspects the hook payload from `stdin`, and prints a JSON response that Codex
+can consume.
+
+## Usage
+
+```bash
+chc uv run ruff check --fix
+```
+
+For `Stop` hooks, the first failure returns a continuation payload using the
+legacy `decision: "block"` shape. Success, or failure after the continuation
+pass, returns `continue: false` with a `systemMessage`.

codhc-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+codhc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codhc/cli.py,sha256=moSbp_ejWKIrQiLV8qirx07coY7kMC7PfGIjNeniqFg,768
+codhc/hook_runner.py,sha256=3jEm1nUf_UpwwbOLhMvjGNfoVq-8UBOkXXDmj-ZpHxY,2106
+codhc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+codhc-0.0.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+codhc-0.0.1.dist-info/entry_points.txt,sha256=PIwrucppW06uEtXHoKgjOL3vNuaeYvuZ0yimsUxlrfo,42
+codhc-0.0.1.dist-info/METADATA,sha256=XaOUoZogmkGs-W55eQoyTa3CNNsPvrzhL7icI8LxtYs,670
+codhc-0.0.1.dist-info/RECORD,,

codhc-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.8.24
+Root-Is-Purelib: true
+Tag: py3-none-any

codhc-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+codhc = codhc.cli:main
+