capt-hook 9.0.0__tar.gz → 9.2.0__tar.gz

{capt_hook-9.0.0 → capt_hook-9.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capt-hook
-Version: 9.0.0
+Version: 9.2.0
 Summary: Stop repeating yourself to Claude.
 Keywords: claude,claude-code,hooks,llm,agents,guardrails,cli
 Author: Yasyf Mohamedali
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Classifier: Typing :: Typed
-Requires-Dist: cc-transcript[judge]>=10.6,<11
+Requires-Dist: cc-transcript[judge]>=11,<12
 Requires-Dist: pydantic>=2.0
 Requires-Dist: pydantic-settings>=2.0
 Requires-Dist: ast-grep-py>=0.39,<1

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/cli.py

@@ -209,7 +209,7 @@ def run_event(state: CliState, event_name: str, *, async_: bool = False) -> None
     # Collapse the N byte-identical siblings Claude Code spawns per event to one
     # dispatch. Decision-capable events (DECISION_EVENTS) are exempt: swallowing a
     # sibling there could bypass a gate, which outweighs a duplicated side effect.
-    if event not in DECISION_EVENTS and not claim_once(event_name, raw_text.encode()):
+    if event not in DECISION_EVENTS and not claim_once(event_name, raw_text.encode(), async_=async_):
         return
 
     try:

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/hooks/hooks.json

@@ -80,7 +80,8 @@
     "SessionEnd": [
       {
         "hooks": [
-          { "type": "command", "command": "uvx capt-hook review run", "async": true }
+          { "type": "command", "command": "uvx capt-hook review run", "async": true },
+          { "type": "command", "command": "uvx capt-hook run SessionEnd --async", "async": true }
         ]
       }
     ]

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/once.py

@@ -26,12 +26,15 @@ DEFAULT_TTL = 10.0
 TTL_ENV = "CAPT_HOOK_ONCE_TTL"
 
 
-def claim_once(event_name: str, payload: bytes) -> bool:
-    """Claim the one-time dispatch of ``payload`` under ``event_name``.
+def claim_once(event_name: str, payload: bytes, *, async_: bool) -> bool:
+    """Claim the one-time dispatch of ``payload`` under ``event_name``'s ``async_`` variant.
 
     Returns True when this process won the claim and should dispatch, False when a
-    still-fresh sibling already claimed it (a duplicate that must exit silently).
-    ``CAPT_HOOK_ONCE_TTL=0`` disables the guard, so every call wins.
+    still-fresh sibling already claimed it (a duplicate that must exit silently). The sync
+    and async passes of one event dispatch disjoint hook sets (``dispatch`` filters on
+    ``spec.async_``), so ``async_`` is part of the key: each variant claims its own token and
+    both run even on byte-identical stdin. ``CAPT_HOOK_ONCE_TTL=0`` disables the guard, so
+    every call wins.
     """
     ttl = _ttl()
     if ttl <= 0:
@@ -40,7 +43,8 @@ def claim_once(event_name: str, payload: bytes) -> bool:
     if sentinel_dir is None:
         return True
     _reap(sentinel_dir, ttl)
-    key = hashlib.sha256(event_name.encode() + b"\0" + payload).hexdigest()
+    variant = b"async" if async_ else b"sync"
+    key = hashlib.sha256(event_name.encode() + b"\0" + variant + b"\0" + payload).hexdigest()
     return _try_claim(sentinel_dir / key, ttl)
 
 

capt_hook-9.2.0/captain_hook/packs/general/capt-hook.toml

@@ -0,0 +1,5 @@
+name = "general"
+version = "0.17.0"
+description = "Language-agnostic guards: git/jj command safety, doc & prompt nudges, task & plan discipline, model-routing nudges (review, security audit, and diagnosis route to gpt-5.6-sol via the codex-wrapper agent), code-review + docs-freshness gates, a detour check-in nudge, a verbose-comment nudge, and delegated-prose nudges that catch doc writing handed to a subagent or workflow without the writing-docs skill."
+hooks = "."
+nlp = true

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/packs/general/models.py

@@ -263,7 +263,7 @@ llm_nudge(
     message=lambda r: (
         f"This delegation would run on fable, but it reads as routine implementation. {r.reasoning} "
         "Implementation defaults to model='opus' + effort='xhigh' (~2x cheaper, nearly as capable); "
-        "a well-scoped edit to existing code can also go to gpt-5.5: spawn the codex:codex-wrapper "
+        "a well-scoped edit to existing code can also go to gpt-5.6-sol: spawn the codex:codex-wrapper "
         "agent with a self-contained prompt. Keep fable if this genuinely is sensitive or error-prone. "
         "See CLAUDE.md § Plan Execution & Orchestration (Models)."
     ),
@@ -291,7 +291,7 @@ llm_nudge(
     message=lambda r: (
         f"This inline edit reads as routine implementation on fable. {r.reasoning} "
         "Implementation delegates: spawn a model='opus', effort='xhigh' subagent to own the change, "
-        "or route a well-scoped edit to gpt-5.5 via the codex skill. Keep editing inline only when "
+        "or route a well-scoped edit to gpt-5.6-sol via the codex skill. Keep editing inline only when "
         "the change is small, sensitive, or bound to judgment you just exercised. "
         "See CLAUDE.md § Plan Execution & Orchestration (Models)."
     ),
@@ -352,9 +352,9 @@ llm_nudge(
     message=lambda r: (
         f"This review/diagnosis delegation would run on fable. {r.reasoning} "
         "Code/diff review, security review/audit and verification of security-sensitive code, "
-        "and bug diagnosis route to gpt-5.5: spawn the codex:codex-wrapper agent with the "
+        "and bug diagnosis route to gpt-5.6-sol: spawn the codex:codex-wrapper agent with the "
         "self-contained question as its prompt (from the main conversation, run the codex skill "
-        "directly), and escalate to fable only when gpt-5.5's output misses. "
+        "directly), and escalate to fable only when gpt-5.6-sol's output misses. "
         "Design review and findings synthesis stay on fable. "
         "See CLAUDE.md § Plan Execution & Orchestration (Models)."
     ),
@@ -378,7 +378,7 @@ llm_nudge(
     agent=False,
     transcript=False,
     tests={
-        Input(prompt="Review the diff for correctness and concurrency issues"): Warn(pattern="gpt-5.5"),
+        Input(prompt="Review the diff for correctness and concurrency issues"): Warn(pattern="gpt-5.6"),
         Input(model="fable", prompt="Adversarially refute this finding: the retry loop is wrong"): Warn(
             pattern="codex"
         ),
@@ -395,7 +395,7 @@ llm_nudge(
             prompt="Synthesize the confirmed review findings and decide which to fix",
             llm={"fire": False},
         ): Allow(),
-        Input(prompt="Audit auth/session.py for security vulnerabilities"): Warn(pattern="gpt-5.5"),
+        Input(prompt="Audit auth/session.py for security vulnerabilities"): Warn(pattern="gpt-5.6"),
         Input(prompt="Verify the input-validation change blocks path traversal"): Warn(pattern="codex"),
         Input(prompt="Verify the pagination change renders the last page correctly"): Allow(),
         Input(
@@ -456,7 +456,7 @@ llm_nudge(
     REVIEW_ROUTING_WORKFLOW_NUDGE,
     message=lambda r: (
         f"This workflow runs review/diagnosis stages on fable. {r.reasoning} "
-        "Route finder, refuter, security-audit, and diagnosis stages to gpt-5.5: give each stage "
+        "Route finder, refuter, security-audit, and diagnosis stages to gpt-5.6-sol: give each stage "
         "agentType: 'codex:codex-wrapper' with the self-contained question as its prompt; "
         "keep the synthesis/accept-reject stage on fable (inherit the session model). "
         "See CLAUDE.md § Plan Execution & Orchestration (Models)."
@@ -479,7 +479,7 @@ llm_nudge(
             pattern="codex"
         ),
         Input(script="agent(`Adversarially refute: ${f.title}`, {model: 'fable', effort: 'max'})"): Warn(
-            pattern="gpt-5.5"
+            pattern="gpt-5.6"
         ),
         Input(
             script="agent('Write a self-contained codex prompt reviewing this diff, "
@@ -496,7 +496,7 @@ llm_nudge(
             llm={"fire": False},
         ): Allow(),
         Input(script="agent(`Audit the login flow for auth bypass and injection; return findings as JSON`)"): Warn(
-            pattern="gpt-5.5"
+            pattern="gpt-5.6"
         ),
         Input(script="agent('Verify the CLI renders the last page correctly')"): Allow(),
     },

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/packs/general/prompts/models/implementation_spawn_nudge.md

@@ -7,7 +7,7 @@ The Models rubric: implementation delegates to opus-4.8 at xhigh — opus is ~2x
 than fable and nearly as capable. Fable's lanes are orchestration, design/architecture
 review, hard planning, all prose/writing, and implementation that is very sensitive or
 error-prone (auth, migrations, concurrency, data loss, crypto, subtle algorithms).
-Code/diff review, security review/audit, and bug diagnosis have their own gpt-5.5
+Code/diff review, security review/audit, and bug diagnosis have their own gpt-5.6-sol
 lanes with separate nudges.
 
 Set fire=true only when the prompt is clearly routine implementation — building, fixing,
@@ -28,7 +28,7 @@ Well-scoped feature wiring; the default implementation lane.
 </example>
 <example fire="false">
 Review the diff for correctness and concurrency issues.
-Not implementation — review routes via its own nudge (gpt-5.5's lane), not to opus.
+Not implementation — review routes via its own nudge (gpt-5.6-sol's lane), not to opus.
 </example>
 <example fire="false">
 Design the migration strategy for the sharded session store.

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/packs/general/prompts/models/inline_edit_nudge.md

@@ -7,7 +7,7 @@ and written.
 
 The Models rubric: implementation belongs to a delegated opus-4.8 subagent at xhigh —
 ~2x cheaper than fable and nearly as capable — or, for a well-scoped edit to existing
-code, to gpt-5.5 via the codex skill. Fable edits inline when the change is small or
+code, to gpt-5.6-sol via the codex skill. Fable edits inline when the change is small or
 judgment-bound: a fix-up finishing work it just reasoned through, a subtle algorithm,
 or a sensitive surface (auth, migrations, concurrency, data loss, crypto).
 

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/packs/general/prompts/models/review_routing_spawn_nudge.md

@@ -1,6 +1,6 @@
 Decide whether this delegated subagent runs code review, a security review/audit
 or verification of security-sensitive code, or bug diagnosis that should route to
-gpt-5.5 instead of fable.
+gpt-5.6-sol instead of fable.
 
 <delegated_spawn> holds the pending Agent/Task call: its model pin (or that it inherits
 the session model, fable), agent type, and prompt.
@@ -8,9 +8,9 @@ the session model, fable), agent type, and prompt.
 The Models rubric: code/diff review — sweeping a diff or codebase for bugs,
 correctness, or cleanups; finder and refuter passes over findings — security
 review/audit and verification of security-sensitive code (auth, input validation,
-crypto, secrets), and bug diagnosis route to gpt-5.5 via the codex-wrapper agent —
+crypto, secrets), and bug diagnosis route to gpt-5.6-sol via the codex-wrapper agent —
 spawn agent type 'codex:codex-wrapper' with the self-contained question; fable is
-the escalation target when gpt-5.5's output misses. Fable keeps design/architecture
+the escalation target when gpt-5.6-sol's output misses. Fable keeps design/architecture
 review, "is this the right approach" judgment, prose review, the synthesis/
 accept-reject pass over review findings — and security-sensitive implementation,
 which is not review.
@@ -26,7 +26,7 @@ shape: fire=true. Keep reasoning under 40 words.
 <examples>
 <example fire="true">
 Review the diff for correctness and concurrency issues; report findings as JSON.
-Diff review for defects — gpt-5.5's lane via the codex-wrapper agent.
+Diff review for defects — gpt-5.6-sol's lane via the codex-wrapper agent.
 </example>
 <example fire="true">
 Adversarially refute this finding: the retry loop double-increments the counter.
@@ -34,7 +34,7 @@ A refuter pass over a code finding is review work.
 </example>
 <example fire="true">
 Diagnose why the exporter hangs when two workers flush concurrently.
-Bug diagnosis starts on gpt-5.5; fable is the escalation target.
+Bug diagnosis starts on gpt-5.6-sol; fable is the escalation target.
 </example>
 <example fire="true">
 You are a low-cost wrapper: write a self-contained codex prompt reviewing this diff, then run the codex skill.
@@ -54,11 +54,11 @@ Prose review stays on fable.
 </example>
 <example fire="true">
 Audit the session-token handling in auth/middleware.py for vulnerabilities.
-Security review/audit of code — gpt-5.5's lane via the codex-wrapper agent.
+Security review/audit of code — gpt-5.6-sol's lane via the codex-wrapper agent.
 </example>
 <example fire="true">
 Verify the new input-validation layer rejects path traversal and injection payloads.
-Verification of security-sensitive code routes to gpt-5.5.
+Verification of security-sensitive code routes to gpt-5.6-sol.
 </example>
 <example fire="false">
 Implement mitigations for the security-audit findings in auth.py.

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/packs/general/prompts/models/review_routing_workflow_nudge.md

@@ -1,5 +1,5 @@
 Decide whether this workflow script runs code review or bug diagnosis stages on
-fable that should route to gpt-5.5.
+fable that should route to gpt-5.6-sol.
 
 <workflow_script> holds the pending Workflow call's script source.
 {workflow_script_header}
@@ -7,7 +7,7 @@ fable that should route to gpt-5.5.
 The Models rubric: code/diff review stages — finder sweeps over a diff or codebase,
 adversarial refuters over findings — security review/audit stages and verification
 of security-sensitive code (auth, input validation, crypto, secrets), and bug
-diagnosis route to gpt-5.5 via the codex-wrapper agent. A stage does that correctly
+diagnosis route to gpt-5.6-sol via the codex-wrapper agent. A stage does that correctly
 when its agent() call pins agentType 'codex:codex-wrapper' and its prompt is the
 self-contained question (or pointers to the files/diff to gather plus the questions
 to answer). A stage that pins a Claude model and asks its agent to run the codex

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/review/cli.py

@@ -8,7 +8,6 @@ machinery lazily once it actually runs, and async store calls bridge with
 
 from __future__ import annotations
 
-import json
 import os
 import sys
 from datetime import UTC, datetime
@@ -19,7 +18,6 @@ import click
 
 if TYPE_CHECKING:
     from collections.abc import Awaitable, Callable
-    from typing import Any
 
     from cc_transcript.corrections import Correction
     from cc_transcript.judge.similar import KeyOverlap
@@ -31,7 +29,6 @@ if TYPE_CHECKING:
     from captain_hook.review.store import ReviewStore, ThresholdStatus
     from captain_hook.review.sync import SyncReport
 
-REVIEW_RUN_COMMAND = "capt-hook review run"
 STATUS_CHOICES = ("watching", "pr_open", "stale", "accepted", "rejected")
 
 
@@ -51,33 +48,6 @@ def resolve_repo(repo_: str | None, root: Path) -> RepoKey:
     return RepoKey(repo_) if repo_ else current_repo(root)
 
 
-def group_commands(group: dict[str, Any]) -> list[str]:
-    entries: list[dict[str, Any]] = group.get("hooks") or []
-    return [str(entry.get("command") or "") for entry in entries]
-
-
-def review_wired(hooks: dict[str, Any]) -> bool:
-    groups: list[dict[str, Any]] = hooks.get("SessionEnd") or []
-    return any(REVIEW_RUN_COMMAND in command for group in groups for command in group_commands(group))
-
-
-def ensure_review_wiring(settings_path: Path) -> bool:
-    from captain_hook.cli import sibling_settings, write_settings
-
-    existing: dict[str, Any] = json.loads(settings_path.read_text()) if settings_path.exists() else {}
-    sibling = sibling_settings(settings_path)
-    sibling_hooks: dict[str, Any] = (json.loads(sibling.read_text()).get("hooks") or {}) if sibling.exists() else {}
-    hooks: dict[str, Any] = existing.get("hooks") or {}
-    if review_wired(hooks) or review_wired(sibling_hooks):
-        return False
-    group = {"hooks": [{"type": "command", "command": f"uvx {REVIEW_RUN_COMMAND}", "async": True}]}
-    write_settings(
-        settings_path,
-        existing | {"hooks": hooks | {"SessionEnd": [*(hooks.get("SessionEnd") or []), group]}},
-    )
-    return True
-
-
 def run_store[T](fn: Callable[[ReviewStore], Awaitable[T]]) -> T:
     """Open the review store, run ``fn`` against it, and bridge with ``asyncio.run`` at the command boundary."""
     import asyncio
@@ -136,14 +106,13 @@ def spawn(transcript: Path, cwd: str | None) -> None:
 @review.command()
 @click.pass_obj
 def enable(state: CliState) -> None:
-    """Watch the current repo, register the captain-hook plugin, and wire the SessionEnd hook."""
+    """Watch the current repo and register the captain-hook plugin."""
     from captain_hook.cli import register_marketplace
 
     repo = current_repo(state.root)
     watch_repo(repo)
     register_marketplace(state.root)
-    wired = ensure_review_wiring(state.root / ".claude" / "settings.json")
-    click.echo(f"watching {repo}" + (" (SessionEnd hook wired into .claude/settings.json)" if wired else ""))
+    click.echo(f"watching {repo}")
 
 
 @review.command()

{capt_hook-9.0.0 → capt_hook-9.2.0}/captain_hook/review/fix.py

@@ -46,11 +46,17 @@ from cc_transcript.mining.confidence import MEDIUM, VERY_HIGH, CandidateSignal
 from cc_transcript.mining.signals import MiningSignal
 from cc_transcript.mining.sourcekind import SourceKind
 from cc_transcript.mining.spec import CONFIDENCE_STEP, bump
-from cc_transcript.models import AssistantEvent, OtherEvent, ToolResultBlock, UserEvent
+from cc_transcript.models import (
+    AssistantEvent,
+    AttachmentEvent,
+    HookAdditionalContext,
+    HookBlockingError,
+    ToolResultBlock,
+    UserEvent,
+)
 
 if TYPE_CHECKING:
     from collections.abc import Iterator, Mapping, Sequence
-    from typing import Any
 
     from cc_transcript.decisions import Decision, DecisionLog
     from cc_transcript.ids import SessionId, ToolUseId
@@ -137,22 +143,10 @@ def classify_marker(text: str) -> Marker | None:
 
 def fingerprint_of(event: TranscriptEvent) -> Fingerprint | None:
     match event:
-        case OtherEvent(type="attachment", raw=raw):
-            attachment: Mapping[str, Any] = raw["attachment"]
-            match attachment.get("type"):
-                case "hook_additional_context":
-                    return Fingerprint(
-                        message="\n".join(str(part) for part in attachment["content"]),
-                        tool_use_id=attachment.get("toolUseID"),
-                        event=attachment.get("hookEvent"),
-                    )
-                case "hook_blocking_error":
-                    return Fingerprint(
-                        message=str(attachment["blockingError"]["blockingError"]),
-                        event=str(attachment.get("hookEvent") or "Stop"),
-                    )
-                case _:
-                    return None
+        case AttachmentEvent(detail=HookAdditionalContext(content=content, tool_use_id=tool_use_id, hook_event=hook_event)):
+            return Fingerprint(message="\n".join(content), tool_use_id=tool_use_id, event=hook_event)
+        case AttachmentEvent(detail=HookBlockingError(blocking_error={"blockingError": blocking_error}, hook_event=hook_event)):
+            return Fingerprint(message=str(blocking_error), event=str(hook_event or "Stop"))
         case UserEvent(meta=meta, text=text) if meta.is_meta and text.startswith(STOP_FEEDBACK_PREFIX):
             return Fingerprint(message=text.removeprefix(STOP_FEEDBACK_PREFIX), event="Stop")
         case UserEvent(blocks=blocks):

{capt_hook-9.0.0 → capt_hook-9.2.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "capt-hook"
 # Inert sentinel — the real version is stamped from the release tag (uv version --frozen).
-version = "9.0.0"
+version = "9.2.0"
 description = "Stop repeating yourself to Claude."
 readme = "README.md"
 license = "PolyForm-Noncommercial-1.0.0"
@@ -29,7 +29,7 @@ classifiers = [
 ]
 requires-python = ">=3.13"
 dependencies = [
-    "cc-transcript[judge]>=10.6,<11",
+    "cc-transcript[judge]>=11,<12",
     "pydantic>=2.0",
     "pydantic-settings>=2.0",
     "ast-grep-py>=0.39,<1",

capt_hook-9.0.0/captain_hook/packs/general/capt-hook.toml

@@ -1,5 +0,0 @@
-name = "general"
-version = "0.16.0"
-description = "Language-agnostic guards: git/jj command safety, doc & prompt nudges, task & plan discipline, model-routing nudges (review, security audit, and diagnosis route to gpt-5.5 via the codex-wrapper agent), code-review + docs-freshness gates, a detour check-in nudge, a verbose-comment nudge, and delegated-prose nudges that catch doc writing handed to a subagent or workflow without the writing-docs skill."
-hooks = "."
-nlp = true