capt-hook 12.75.2__tar.gz → 12.76.0__tar.gz

{capt_hook-12.75.2 → capt_hook-12.76.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: capt-hook
-Version: 12.75.2
+Version: 12.76.0
 Summary: Stop repeating yourself to Claude.
 Project-URL: Homepage, https://github.com/yasyf/captain-hook
 Project-URL: Documentation, https://yasyf.github.io/captain-hook/
@@ -22,7 +22,7 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Typing :: Typed
 Requires-Python: >=3.13
 Requires-Dist: ast-grep-py<0.45,>=0.44
-Requires-Dist: cc-transcript[judge]==14.32.1
+Requires-Dist: cc-transcript[judge]==14.33.0
 Requires-Dist: click>=8
 Requires-Dist: filelock>=3
 Requires-Dist: funcy>=2.0

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "captain-hook",
-  "version": "12.75.0",
+  "version": "12.75.2",
   "displayName": "Captain Hook",
   "description": "Skills for the capt-hook declarative hook framework: bootstrap gates and nudges from a repo's conventions, and translate style guides into enforced StyleRules.",
   "author": {

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/builtin_packs/steering/hooks/steering.py

@@ -25,6 +25,31 @@ from captain_hook import (
     nudge,
 )
 
+THINKING_MISFIRES = (
+    "Thinking it through more, the deploy applies the stack at the dev commit, so this addon update is likely just "
+    "dev catching up to whatever live already has — not something new introduced by my change.",
+    "Before escalating, I want to pin down whether TS release still runs anywhere, since if it doesn't, switching "
+    "pr-reviewer to target names might just be fixing an existing mismatch rather than introducing a new behavior "
+    "change.",
+    "The deeper problem is that leading-option binding stops at any unrecognized flag, meaning something like "
+    "`cc-notes --foo task validate x` would leave the verb words undetected and get approved by mistake — and the "
+    "old check has this same evasion flaw, so I need a more robust way to detect the dangerous verb regardless of "
+    "leading options.",
+    "The worktree removal is stuck on an idle-check tied to a known refusal pattern, so I'll leave it as a minor "
+    "issue to report later.",
+    "The root cause traces to deploy 8fbf85b landing outside the release pointer process, leaving SSM still pointing "
+    "at an older release expecting an outdated alembic revision while the DB had already migrated further — then a "
+    "box resize/reboot re-triggered that stale pointer deploy, causing a migration failure and 502s, which was "
+    "ultimately fixed by restoring 8fbf85b.",
+    'But I\'m second-guessing whether "placeholder" as a literal string is the right approach versus leaving it '
+    'unset, since a consumer that checks truthiness would pass the check with "placeholder" and then fail later with '
+    'a confusing opaque OAuth error rather than a clear "not configured" message — whereas leaving it empty/unset '
+    "lets the existing guard clauses report the clean error upfront.",
+    "For OUTAGE-level customer monitors I need to wrap handles with the pageOnAlert helper instead, covering chime "
+    "run errors, sofi ATO errors, the sofi pager stopped handles, and the polar undelivered/ATO run errors—while "
+    "leaving the chime composite alerts alone since they're already properly gated.",
+)
+
 
 class TypeCheckerContext(CustomCondition):
     """True when the recent assistant transcript is discussing a type checker / diagnostics."""
@@ -80,6 +105,7 @@ nudge(
         threshold=2,
         window=15,
         scope="text",
+        thinking=False,
         vetoes=[
             Signal(pattern=r"(?i)\b(?:which|that)\s+leaves?\b"),
             Signal(pattern=r"(?i)\bleaving\b[^.!?]{0,80}?\bmeans?\b"),
@@ -268,36 +294,12 @@ nudge(
             ]
         ): Allow(),
         Input(transcript=[T.assistant("I'll leave that CLAUDE.md issue unaddressed for now.")]): Warn(),
+        **{Input(transcript=[T.assistant(T.thinking(text))]): Allow() for text in THINKING_MISFIRES},
         Input(
             transcript=[
                 T.assistant(
-                    T.thinking(
-                        "Thinking it through more, the deploy applies the stack at the dev commit, so this addon "
-                        "update is likely just dev catching up to whatever live already has — not something new "
-                        "introduced by my change."
-                    )
-                )
-            ]
-        ): Allow(),
-        Input(
-            transcript=[
-                T.assistant(
-                    T.thinking(
-                        "Before escalating, I want to pin down whether TS release still runs anywhere, since if it "
-                        "doesn't, switching pr-reviewer to target names might just be fixing an existing mismatch "
-                        "rather than introducing a new behavior change."
-                    )
-                )
-            ]
-        ): Allow(),
-        Input(
-            transcript=[
-                T.assistant(
-                    T.thinking(
-                        "That test failure on #28529's own branch looks like a pre-existing bug in deploy-go, not "
-                        "something caused by my change, so I should report it upstream rather than try to fix it "
-                        "myself."
-                    )
+                    "That test failure on #28529's own branch looks like a pre-existing bug in deploy-go, not "
+                    "something caused by my change, so I should report it upstream rather than try to fix it myself."
                 )
             ]
         ): Warn(),

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/context.py

@@ -101,7 +101,7 @@ class HookEvidence:
     event_count: int
     window_start: int
     current_turn_event_count: int
-    signal_texts: tuple[tuple[tuple[int | Literal["turn"], str], tuple[str, ...]], ...]
+    signal_texts: tuple[tuple[tuple[int | Literal["turn"], str, bool], tuple[str, ...]], ...]
     prompt: str
 
 
@@ -116,7 +116,9 @@ class HookContext:
     transcript: Session | RemoteSession | LazyTranscript
     settings: HooksSettings | None
     project_root: Path | None = None
-    signal_evidence: dict[tuple[int | Literal["turn"], str], tuple[str, ...]] = field(default_factory=dict, init=False)
+    signal_evidence: dict[tuple[int | Literal["turn"], str, bool], tuple[str, ...]] = field(
+        default_factory=dict, init=False
+    )
     prepared_evidence: HookEvidence | None = field(default=None, init=False)
 
     def fork(self, transcript: Session | RemoteSession | LazyTranscript) -> HookContext:

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/primitives/llm.py

@@ -111,7 +111,7 @@ def llm_evaluate[M: BaseModel](
 
     if sig := resolve_signals(signals):
         ps = evt.ctx.s[PrimitiveState].get(PrimitiveState())
-        texts = ps.unechoed_candidates(transcript_texts(evt, sig.window, sig.origin))
+        texts = ps.unechoed_candidates(transcript_texts(evt, sig.window, sig.origin, sig.thinking))
         if not (contributing_texts := ps.match_signals(sig, texts, hook)):
             return None
     elif contexts and when is None:
@@ -183,7 +183,7 @@ def consume_signals(evt: BaseHookEvent, sig: Signals | None, hook: str) -> list[
     """
     if not sig:
         return None
-    texts = transcript_texts(evt, sig.window, sig.origin)
+    texts = transcript_texts(evt, sig.window, sig.origin, sig.thinking)
     with evt.ctx.s[PrimitiveState].mutate() as ps:
         return ps.match_signals(sig, ps.unechoed_candidates(texts), hook)
 

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/primitives/nudge.py

@@ -92,7 +92,7 @@ def nudge(
             tracker = EchoTracker(
                 window=ECHO_WINDOW + (sig.window if isinstance(sig.window, int) else TURN_ECHO_LOOKBACK)
             )
-            candidates = tracker.survivors(transcript_texts(evt, sig.window, sig.origin), evt=evt)
+            candidates = tracker.survivors(transcript_texts(evt, sig.window, sig.origin, sig.thinking), evt=evt)
             matches = matching_texts(sig, candidates, consumed=evt.ctx.s.load(PrimitiveState).consumed.get(name, ()))
             if not matches:
                 return None

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/signals/__init__.py

@@ -76,11 +76,11 @@ def extract_signal_context(patterns: Sequence[TSignalPattern], text: str) -> lis
     return result
 
 
-def block_texts(event: UserEvent | AssistantEvent) -> Iterator[str]:
+def block_texts(event: UserEvent | AssistantEvent, *, thinking: bool) -> Iterator[str]:
     for block in event.blocks:
         match block:
-            case ThinkingBlock(thinking=thinking):
-                yield thinking
+            case ThinkingBlock(thinking=text) if thinking:
+                yield text
             case ToolUseBlock(name=name, input=payload):
                 match parse_tool_call(name, payload, on_error="other"):
                     case (
@@ -97,7 +97,10 @@ def block_texts(event: UserEvent | AssistantEvent) -> Iterator[str]:
 
 
 def transcript_texts(
-    evt: BaseHookEvent, window: int | Literal["turn"], origin: Literal["assistant", "any"] = "any"
+    evt: BaseHookEvent,
+    window: int | Literal["turn"],
+    origin: Literal["assistant", "any"] = "any",
+    thinking: bool = True,
 ) -> list[str]:
     """Extract prose from recent transcript events for signal scoring.
 
@@ -111,7 +114,8 @@ def transcript_texts(
     assistant prose alike, while ``"assistant"`` drops user messages (and, on
     ``UserPromptSubmit``, the just-submitted prompt) so a stance hook scores only the
     agent's own words. Signal-driven hooks thread ``Signals.origin`` here, which
-    defaults to ``"assistant"``.
+    defaults to ``"assistant"``. ``thinking=False`` drops thinking blocks, so a hook scores
+    only what the agent wrote; signal-driven hooks thread ``Signals.thinking`` here.
 
     A fixed ``window`` counts scored prose entries, not raw JSONL events: tool calls
     and their results carry no prose, so they never crowd a message out of the window,
@@ -135,7 +139,7 @@ def transcript_texts(
     transcript, so scoring it would let one agent's words trip this agent's gate.
     """
 
-    key = (window, origin)
+    key = (window, origin, thinking)
     if (prepared := evt.ctx.prepared_evidence) is not None:
         for saved_key, texts in prepared.signal_texts:
             if saved_key == key:
@@ -144,7 +148,7 @@ def transcript_texts(
     if key in evt.ctx.signal_evidence:
         return list(evt.ctx.signal_evidence[key])
     if isinstance(evt.ctx.t, RemoteSession):
-        texts = evt.ctx.t.signal_texts(window=window, origin=origin)
+        texts = evt.ctx.t.signal_texts(window=window, origin=origin, thinking=thinking)
         if origin == "any" and evt.event == Event.UserPromptSubmit and evt.user_prompt:
             texts = [evt.user_prompt, *texts]
         evt.ctx.signal_evidence[key] = tuple(texts)
@@ -159,7 +163,7 @@ def transcript_texts(
         )
 
     def texts_of(event: UserEvent | AssistantEvent) -> list[str]:
-        return [text for text in (event.text, *block_texts(event)) if text]
+        return [text for text in (event.text, *block_texts(event, thinking=thinking)) if text]
 
     if window == "turn":
         texts = [text for event in evt.ctx.turn.events if eligible(event) for text in texts_of(event)]

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/snapshots/client.py

@@ -988,9 +988,16 @@ class RemoteSession:
     def assistant_text(self, n: int = 10, *, max_per_msg: int = 500) -> str:
         return "\n---\n".join(self.query({"kind": "assistant_text", "count": n, "max_per_message": max_per_msg}))
 
-    def signal_texts(self, window: int | Literal["turn"], origin: Literal["assistant", "any"]) -> list[str]:
+    def signal_texts(
+        self, window: int | Literal["turn"], origin: Literal["assistant", "any"], thinking: bool
+    ) -> list[str]:
         return self.query(
-            {"kind": "signal_texts", "window": "current_turn" if window == "turn" else window, "origin": origin}
+            {
+                "kind": "signal_texts",
+                "window": "current_turn" if window == "turn" else window,
+                "origin": origin,
+                "thinking": thinking,
+            }
         )
 
     def render(self, *, budget: Budget, tool_results: bool = False) -> str:

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/snapshots/schemas/host-request.schema.json

@@ -3228,6 +3228,10 @@
           "title": "Origin",
           "type": "string"
         },
+        "thinking": {
+          "title": "Thinking",
+          "type": "boolean"
+        },
         "window": {
           "anyOf": [
             {
@@ -3246,7 +3250,8 @@
       "required": [
         "kind",
         "window",
-        "origin"
+        "origin",
+        "thinking"
       ],
       "title": "SignalTexts",
       "type": "object"

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/snapshots/schemas/host-response.schema.json

@@ -3228,6 +3228,10 @@
           "title": "Origin",
           "type": "string"
         },
+        "thinking": {
+          "title": "Thinking",
+          "type": "boolean"
+        },
         "window": {
           "anyOf": [
             {
@@ -3246,7 +3250,8 @@
       "required": [
         "kind",
         "window",
-        "origin"
+        "origin",
+        "thinking"
       ],
       "title": "SignalTexts",
       "type": "object"

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/snapshots/schemas/request.schema.json

@@ -2006,6 +2006,10 @@
           "title": "Origin",
           "type": "string"
         },
+        "thinking": {
+          "title": "Thinking",
+          "type": "boolean"
+        },
         "window": {
           "anyOf": [
             {
@@ -2024,7 +2028,8 @@
       "required": [
         "kind",
         "window",
-        "origin"
+        "origin",
+        "thinking"
       ],
       "title": "SignalTexts",
       "type": "object"

{capt_hook-12.75.2 → capt_hook-12.76.0}/captain_hook/types.py

@@ -948,6 +948,10 @@ class Signals:
     prompt or correction (a ``UserPromptSubmit`` nudge, say), where the just-submitted
     prompt is prepended to the scan only under ``"any"``.
 
+    ``thinking`` keeps the agent's thinking blocks among the candidate texts. Pass
+    ``thinking=False`` for a stance nudge that judges what the agent wrote, not the
+    options it weighed privately on the way there.
+
     ``vetoes`` are presence-only suppressors: if any veto matches any window entry
     — including already-consumed ones — the bundle does not fire and consumes
     nothing. A veto's ``weight`` is meaningless and must be left at its default.
@@ -964,6 +968,7 @@ class Signals:
     window: int | Literal["turn"] = 15
     scope: Literal["text", "window"] = field(default="window", kw_only=True)
     origin: Literal["assistant", "any"] = field(default="assistant", kw_only=True)
+    thinking: bool = field(default=True, kw_only=True)
     vetoes: Sequence[Signal | NlpSignal] = ()
 
     def __post_init__(self) -> None:

{capt_hook-12.75.2 → capt_hook-12.76.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 = "12.75.2"
+version = "12.76.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]==14.32.1",
+    "cc-transcript[judge]==14.33.0",
     "pydantic>=2.0",
     "jsonschema>=4.26",
     "pydantic-settings>=2.0",