capt-hook 3.8.0__tar.gz → 3.9.0__tar.gz

{capt_hook-3.8.0 → capt_hook-3.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capt-hook
-Version: 3.8.0
+Version: 3.9.0
 Summary: Declarative hook framework for Claude Code
 Keywords: claude,claude-code,hooks,llm,agents,guardrails,cli
 Author: Yasyf Mohamedali

capt_hook-3.9.0/captain_hook/packs/go/capt-hook.toml

@@ -0,0 +1,4 @@
+name = "go"
+version = "0.1.0"
+description = "Go-specific guards: a go-test-before-commit gate, gofumpt/golangci-lint toolchain guards, and a go.mod nudge on module-resolution errors."
+hooks = "."

capt_hook-3.9.0/captain_hook/packs/go/testing.py

@@ -0,0 +1,87 @@
+from __future__ import annotations
+
+from captain_hook import (
+    Allow,
+    BaseHookEvent,
+    Block,
+    CustomCondition,
+    Event,
+    FilePath,
+    Input,
+    RanCommand,
+    Tool,
+    Warn,
+    gate,
+    nudge,
+)
+from captain_hook.types import Command as CommandCondition
+
+nudge(
+    """
+    When a test fails, isolate the minimal failing case before retrying. Use a
+    `-run TestName/case` regex or a single package path. Broad `go test ./...`
+    re-runs after a failure waste cycles and hide the real breakage.
+    """,
+    only_if=[Tool("Edit|Write"), FilePath("*_test.go")],
+)
+
+
+class UserSaid(CustomCondition):
+    """Matches when the user's messages contain any of the given keywords."""
+
+    def __init__(self, *keywords: str) -> None:
+        self.keywords = keywords
+
+    def check(self, evt: BaseHookEvent) -> bool:
+        return evt.ctx.t.user_said(*self.keywords)
+
+
+class AllEditsUnder(CustomCondition):
+    """Matches when every edit this session is under one of the given path prefixes."""
+
+    def __init__(self, *prefixes: str) -> None:
+        self.prefixes = prefixes
+
+    def check(self, evt: BaseHookEvent) -> bool:
+        return bool(files := evt.ctx.t.edited_files) and all(f.under(*self.prefixes) for f in files)
+
+
+class CommitsGo(CustomCondition):
+    """Matches when the git command explicitly names a Go path."""
+
+    def check(self, evt: BaseHookEvent) -> bool:
+        return bool(cl := evt.command_line) and ".go" in str(cl.primary)
+
+
+gate(
+    "No `go test` execution found. Run tests before committing Go changes.",
+    only_if=[Tool("Bash"), CommandCondition(r"git\s+commit"), CommitsGo()],
+    skip_if=[
+        RanCommand(r"go test"),
+        UserSaid("commit", "just commit"),
+        AllEditsUnder("docs/", ".claude/", ".github/"),
+    ],
+    events=Event.PreToolUse,
+    tests={
+        Input(command="git status"): Allow(),
+        Input(command="git commit internal/cli/root.go"): Block(),
+    },
+)
+
+
+nudge(
+    "No `go test` execution detected in this session. If you changed Go files, run tests "
+    "before committing. If this is a docs/config-only change, proceed.",
+    only_if=[Tool("Bash"), CommandCondition(r"git\s+commit")],
+    skip_if=[
+        RanCommand(r"go test"),
+        UserSaid("commit", "just commit"),
+        AllEditsUnder("docs/", ".claude/", ".github/"),
+        CommitsGo(),
+    ],
+    events=Event.PreToolUse,
+    tests={
+        Input(command="git status"): Allow(),
+        Input(command="git commit -m wip"): Warn(),
+    },
+)

capt_hook-3.9.0/captain_hook/packs/go/toolchain.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+import re
+
+from captain_hook import Allow, Block, Event, Input, Tool, block_command, nudge
+from captain_hook.events import PostToolUseFailureEvent
+
+block_command(
+    r"^gofumpt\b",
+    reason="Do not run gofumpt manually — formatting is applied by the commit hook (golangci-lint fmt)",
+    hint="See AGENTS.md § Mechanical Linting. The prek hook formats on commit; `task fmt` runs it deliberately.",
+    tests={
+        Input(command="gofumpt -w ."): Block(),
+        Input(command="go build ./..."): Allow(),
+    },
+)
+
+block_command(
+    r"^golangci-lint\b",
+    reason="Do not run golangci-lint manually — CI and the commit hook own linting",
+    hint="See AGENTS.md § Mechanical Linting. Only fix issues requiring human judgment.",
+    tests={
+        Input(command="golangci-lint run"): Block(),
+        Input(command="golangci-lint fmt"): Block(),
+        Input(command="go vet ./..."): Allow(),
+        Input(command="uvx prek run --all-files"): Allow(),
+    },
+)
+
+nudge(
+    "MISSING DEPENDENCY: run `go mod tidy` (or `go get <module>`) to resolve it. "
+    "Do NOT make the import lazy, delete the importing code, or vendor by hand.",
+    events=Event.PostToolUseFailure,
+    only_if=[Tool("Bash")],
+    when=lambda evt: (
+        isinstance(evt, PostToolUseFailureEvent)
+        and bool(
+            re.search(
+                r"no required module provides package|missing go\.sum entry|"
+                r"cannot find module|updates to go\.mod needed",
+                evt.error,
+            )
+        )
+    ),
+    max_fires=2,
+)

{capt_hook-3.8.0 → capt_hook-3.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "capt-hook"
-version = "3.8.0"
+version = "3.9.0"
 description = "Declarative hook framework for Claude Code"
 readme = "README.md"
 license = "PolyForm-Noncommercial-1.0.0"