codhc 0.0.1__tar.gz

codhc-0.0.1/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,15 @@
+# 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/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name            = "codhc"
+version         = "0.0.1"
+description     = ""
+readme          = "README.md"
+requires-python = ">=3.12"
+authors         = [{ name = "narumi", email = "toucans-cutouts0f@icloud.com" }]
+dependencies    = [
+  "typer>=0.24.1",
+]
+
+[project.scripts]
+codhc = "codhc.cli:main"
+
+[dependency-groups]
+dev = [
+  "pytest>=9.0.3",
+  "pytest-cov>=7.1.0",
+  "ruff>=0.15.10",
+  "ty>=0.0.29",
+]
+
+[build-system]
+requires      = ["uv_build>=0.8.17,<0.9.0"]
+build-backend = "uv_build"
+
+[tool.bumpversion]
+current_version  = "0.0.1"
+tag              = true
+commit           = true
+pre_commit_hooks = ["uv lock", "git add uv.lock"]
+
+[tool.pytest]
+filterwarnings = ["ignore::DeprecationWarning"]
+
+[tool.ruff]
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+  "ANN",     # flake8-annotations
+  "ASYNC",   # flake8-async
+  "B",       # flake8-bugbear
+  "BLE",     # flake8-blind-except
+  "C",       # flake8-comprehensions
+  "DTZ",     # flake8-datetimez
+  "E",       # pycodestyle errors
+  "F",       # pyflakes
+  "FURB",    # refurb
+  "I",       # isort
+  "G",       # flake8-logging-format
+  "N",       # pep8-naming
+  "PERF",    # perflint
+  "PIE",     # flake8-pie
+  "PTH",     # flake8-use-pathlib
+  "RET",     # flake8-return
+  "RSE",     # flake8-raise
+  "RUF",     # ruff-specific rules
+  "SIM",     # flake8-simplify
+  "TID",     # flake8-tidy-imports
+  "TRY002",  # raise-vanilla-class
+  "TRY004",  # type-check-without-type-error
+  "TRY203",  # useless-try-except
+  "TRY300",  # try-consider-else
+  "UP",      # pyupgrade
+  "W",       # pycodestyle warnings
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**.py" = ["ANN", "TRY", "PERF"]
+
+[tool.ruff.lint.isort]
+force-single-line = true
+
+[tool.tombi.format.rules]
+key-value-equals-sign-alignment = true
+trailing-comment-alignment      = true
+
+[tool.ty.rules]
+unresolved-import = "ignore"

codhc-0.0.1/src/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-0.0.1/src/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)