capt-hook 0.3.0__tar.gz → 0.4.0__tar.gz

{capt_hook-0.3.0 → capt_hook-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capt-hook
-Version: 0.3.0
+Version: 0.4.0
 Summary: Declarative hook framework for Claude Code
 Keywords: claude,claude-code,hooks,llm,agents,guardrails,cli
 Author: Yasyf Mohamedali
@@ -32,10 +32,11 @@ Requires-Dist: loguru>=0.7.3
 Requires-Dist: pytest>=8.0 ; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.24 ; extra == 'dev'
 Requires-Dist: pyright>=1.1 ; extra == 'dev'
+Requires-Dist: pyyaml>=6 ; extra == 'dev'
 Requires-Dist: ruff>=0.8 ; extra == 'dev'
 Requires-Python: >=3.12
 Project-URL: Homepage, https://github.com/yasyf/captain-hook
-Project-URL: Documentation, https://captain-hook.readthedocs.io
+Project-URL: Documentation, https://yasyf.github.io/captain-hook/
 Project-URL: Repository, https://github.com/yasyf/captain-hook
 Project-URL: Issues, https://github.com/yasyf/captain-hook/issues
 Project-URL: Changelog, https://github.com/yasyf/captain-hook/blob/main/CHANGELOG.md
@@ -46,7 +47,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI](https://img.shields.io/pypi/v/capt-hook.svg)](https://pypi.org/project/capt-hook/)
 [![Python](https://img.shields.io/pypi/pyversions/capt-hook.svg)](https://pypi.org/project/capt-hook/)
-[![Docs](https://readthedocs.org/projects/captain-hook/badge/?version=latest)](https://captain-hook.readthedocs.io)
+[![Docs](https://github.com/yasyf/captain-hook/actions/workflows/docs.yml/badge.svg)](https://yasyf.github.io/captain-hook/)
 [![License: PolyForm Noncommercial](https://img.shields.io/badge/License-PolyForm_Noncommercial_1.0.0-blue.svg)](https://github.com/yasyf/captain-hook/blob/main/LICENSE)
 
 Declarative hook framework for Claude Code. Write hooks as data, test them inline, and ship them to CI in the same shape they run in production.
@@ -99,6 +100,15 @@ capt-hook generate-settings > .claude/settings.local.json
 
 The next time Claude tries `git stash`, captain-hook returns a deny with your reason and hint.
 
+## Agent skills & plugin
+
+Don't want to write hooks by hand? capt-hook ships two [Agent Skills](https://yasyf.github.io/captain-hook/docs/getting-started/skills.html) — `bootstrapping-hooks` mines your repo's docs, CI, and git history into proposed gates and nudges; `translating-styleguides` turns a STYLEGUIDE.md into enforced rules. `uvx capt-hook init` installs them into `.claude/skills/`, or get them as a plugin:
+
+```
+/plugin marketplace add yasyf/captain-hook
+/plugin install captain-hook@captain-hook
+```
+
 ## What problems does this solve?
 
 - **Block dangerous tool calls** before they execute (`PreToolUse`) — force-push, package-manager footguns, raw `rm -rf`.
@@ -108,6 +118,6 @@ The next time Claude tries `git stash`, captain-hook returns a deny with your re
 
 ## Docs
 
-[Read the docs](https://captain-hook.readthedocs.io) for the full guide: conditions, primitives, LLM hooks, workflows, state, and real-world patterns.
+[Read the docs](https://yasyf.github.io/captain-hook/) for the full guide: conditions, primitives, LLM hooks, workflows, state, and real-world patterns.
 
-Working on captain-hook itself? See the [development guide](https://captain-hook.readthedocs.io/en/latest/development/).
+Working on captain-hook itself? See the [development guide](https://yasyf.github.io/captain-hook/docs/development/).

{capt_hook-0.3.0 → capt_hook-0.4.0}/README.md

@@ -2,7 +2,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/capt-hook.svg)](https://pypi.org/project/capt-hook/)
 [![Python](https://img.shields.io/pypi/pyversions/capt-hook.svg)](https://pypi.org/project/capt-hook/)
-[![Docs](https://readthedocs.org/projects/captain-hook/badge/?version=latest)](https://captain-hook.readthedocs.io)
+[![Docs](https://github.com/yasyf/captain-hook/actions/workflows/docs.yml/badge.svg)](https://yasyf.github.io/captain-hook/)
 [![License: PolyForm Noncommercial](https://img.shields.io/badge/License-PolyForm_Noncommercial_1.0.0-blue.svg)](https://github.com/yasyf/captain-hook/blob/main/LICENSE)
 
 Declarative hook framework for Claude Code. Write hooks as data, test them inline, and ship them to CI in the same shape they run in production.
@@ -55,6 +55,15 @@ capt-hook generate-settings > .claude/settings.local.json
 
 The next time Claude tries `git stash`, captain-hook returns a deny with your reason and hint.
 
+## Agent skills & plugin
+
+Don't want to write hooks by hand? capt-hook ships two [Agent Skills](https://yasyf.github.io/captain-hook/docs/getting-started/skills.html) — `bootstrapping-hooks` mines your repo's docs, CI, and git history into proposed gates and nudges; `translating-styleguides` turns a STYLEGUIDE.md into enforced rules. `uvx capt-hook init` installs them into `.claude/skills/`, or get them as a plugin:
+
+```
+/plugin marketplace add yasyf/captain-hook
+/plugin install captain-hook@captain-hook
+```
+
 ## What problems does this solve?
 
 - **Block dangerous tool calls** before they execute (`PreToolUse`) — force-push, package-manager footguns, raw `rm -rf`.
@@ -64,6 +73,6 @@ The next time Claude tries `git stash`, captain-hook returns a deny with your re
 
 ## Docs
 
-[Read the docs](https://captain-hook.readthedocs.io) for the full guide: conditions, primitives, LLM hooks, workflows, state, and real-world patterns.
+[Read the docs](https://yasyf.github.io/captain-hook/) for the full guide: conditions, primitives, LLM hooks, workflows, state, and real-world patterns.
 
-Working on captain-hook itself? See the [development guide](https://captain-hook.readthedocs.io/en/latest/development/).
+Working on captain-hook itself? See the [development guide](https://yasyf.github.io/captain-hook/docs/development/).

capt_hook-0.4.0/captain_hook/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "captain-hook",
+  "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": { "name": "Yasyf Mohamedali", "email": "yasyfm@gmail.com" },
+  "homepage": "https://yasyf.github.io/captain-hook/",
+  "repository": "https://github.com/yasyf/captain-hook",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "keywords": ["claude-code", "hooks", "guardrails", "styleguide"]
+}

capt_hook-0.4.0/captain_hook/__init__.py

@@ -0,0 +1,257 @@
+from __future__ import annotations
+
+from captain_hook import style as style
+from captain_hook.app import hook as hook
+from captain_hook.app import on as on
+from captain_hook.app import register as register
+from captain_hook.command import Command as Command
+from captain_hook.command import CommandLine as CommandLine
+from captain_hook.command import Redirect as Redirect
+from captain_hook.context import HookContext as HookContext
+from captain_hook.events import (
+    BaseHookEvent as BaseHookEvent,
+)
+from captain_hook.events import (
+    NotificationEvent as NotificationEvent,
+)
+from captain_hook.events import (
+    PostToolUseEvent as PostToolUseEvent,
+)
+from captain_hook.events import (
+    PostToolUseFailureEvent as PostToolUseFailureEvent,
+)
+from captain_hook.events import (
+    PreCompactEvent as PreCompactEvent,
+)
+from captain_hook.events import (
+    PreToolUseEvent as PreToolUseEvent,
+)
+from captain_hook.events import (
+    StopEvent as StopEvent,
+)
+from captain_hook.events import (
+    SubagentStartEvent as SubagentStartEvent,
+)
+from captain_hook.events import (
+    SubagentStopEvent as SubagentStopEvent,
+)
+from captain_hook.events import (
+    ToolHookEvent as ToolHookEvent,
+)
+from captain_hook.events import (
+    UserPromptSubmitEvent as UserPromptSubmitEvent,
+)
+from captain_hook.file import File as File
+from captain_hook.primitives import (
+    GateVerdict as GateVerdict,
+)
+from captain_hook.primitives import (
+    NudgeVerdict as NudgeVerdict,
+)
+from captain_hook.primitives import (
+    PromptCheckVerdict as PromptCheckVerdict,
+)
+from captain_hook.primitives import (
+    block_command as block_command,
+)
+from captain_hook.primitives import (
+    gate as gate,
+)
+from captain_hook.primitives import (
+    llm_evaluate as llm_evaluate,
+)
+from captain_hook.primitives import (
+    llm_gate as llm_gate,
+)
+from captain_hook.primitives import (
+    llm_nudge as llm_nudge,
+)
+from captain_hook.primitives import (
+    prompt_check as prompt_check,
+)
+from captain_hook.primitives import (
+    warn_command as warn_command,
+)
+
+# audit/lint/nudge are imported from their defining modules, not the
+# primitives package: the package attribute and the submodule share a name,
+# and an alias targeting captain_hook.primitives.<name> resolves to the
+# module under static analysis (griffe), shadowing the function.
+from captain_hook.primitives.audit import audit as audit
+from captain_hook.primitives.lint import lint as lint
+from captain_hook.primitives.nudge import nudge as nudge
+from captain_hook.primitives.workflow import (
+    Artifact as Artifact,
+)
+from captain_hook.primitives.workflow import (
+    Step as Step,
+)
+from captain_hook.primitives.workflow import (
+    Workflow as Workflow,
+)
+from captain_hook.primitives.workflow import (
+    text_matches as text_matches,
+)
+from captain_hook.primitives.workflow import (
+    workflow as workflow,
+)
+from captain_hook.prompt import Prompt as Prompt
+from captain_hook.session import SessionSlot as SessionSlot
+from captain_hook.session import SessionStore as SessionStore
+from captain_hook.session import session_state as session_state
+from captain_hook.settings import HooksSettings as HooksSettings
+from captain_hook.settings import build_settings as build_settings
+from captain_hook.signals.nlp import Clause as Clause
+from captain_hook.signals.nlp import NlpSignal as NlpSignal
+from captain_hook.signals.nlp import Phrase as Phrase
+from captain_hook.state import (
+    HookState as HookState,
+)
+from captain_hook.state import (
+    PrimitiveState as PrimitiveState,
+)
+from captain_hook.state import (
+    workflow_state as workflow_state,
+)
+from captain_hook.tasks import Task as Task
+from captain_hook.tasks import Tasks as Tasks
+from captain_hook.testing import (
+    Allow as Allow,
+)
+from captain_hook.testing import (
+    Block as Block,
+)
+from captain_hook.testing import (
+    InlineTests as InlineTests,
+)
+from captain_hook.testing import (
+    Input as Input,
+)
+from captain_hook.testing import (
+    TranscriptFixture as TranscriptFixture,
+)
+from captain_hook.testing import (
+    Warn as Warn,
+)
+from captain_hook.tools import EditOp as EditOp
+from captain_hook.tools import TaskOp as TaskOp
+from captain_hook.tools import WriteOp as WriteOp
+from captain_hook.transcript import (
+    ToolUse as ToolUse,
+)
+from captain_hook.transcript import (
+    ToolUseQuery as ToolUseQuery,
+)
+from captain_hook.transcript import (
+    ToolUseSequence as ToolUseSequence,
+)
+from captain_hook.transcript import (
+    Transcript as Transcript,
+)
+from captain_hook.transcript import (
+    TranscriptMessage as TranscriptMessage,
+)
+from captain_hook.transcript import (
+    TranscriptSlice as TranscriptSlice,
+)
+from captain_hook.transcript import (
+    Turn as Turn,
+)
+from captain_hook.transcript.inputs import (
+    AgentInput as AgentInput,
+)
+from captain_hook.transcript.inputs import (
+    BashInput as BashInput,
+)
+from captain_hook.transcript.inputs import (
+    EditInput as EditInput,
+)
+from captain_hook.transcript.inputs import (
+    FileInputBase as FileInputBase,
+)
+from captain_hook.transcript.inputs import (
+    GenericInput as GenericInput,
+)
+from captain_hook.transcript.inputs import (
+    GlobInput as GlobInput,
+)
+from captain_hook.transcript.inputs import (
+    GrepInput as GrepInput,
+)
+from captain_hook.transcript.inputs import (
+    InputBase as InputBase,
+)
+from captain_hook.transcript.inputs import (
+    ReadInput as ReadInput,
+)
+from captain_hook.transcript.inputs import (
+    SkillInput as SkillInput,
+)
+from captain_hook.transcript.inputs import (
+    TaskCreateInput as TaskCreateInput,
+)
+from captain_hook.transcript.inputs import (
+    TaskUpdateInput as TaskUpdateInput,
+)
+from captain_hook.transcript.inputs import (
+    WriteInput as WriteInput,
+)
+from captain_hook.transcript.models import ContentBlock as ContentBlock
+from captain_hook.transcript.models import ToolResult as ToolResult
+from captain_hook.types import (
+    Action as Action,
+)
+from captain_hook.types import (
+    Agent as Agent,
+)
+from captain_hook.types import (
+    Content as Content,
+)
+from captain_hook.types import (
+    CustomCondition as CustomCondition,
+)
+from captain_hook.types import (
+    Event as Event,
+)
+from captain_hook.types import (
+    FilePath as FilePath,
+)
+from captain_hook.types import (
+    HookResult as HookResult,
+)
+from captain_hook.types import (
+    InPlanMode as InPlanMode,
+)
+from captain_hook.types import (
+    RanCommand as RanCommand,
+)
+from captain_hook.types import (
+    ReadFile as ReadFile,
+)
+from captain_hook.types import (
+    Signal as Signal,
+)
+from captain_hook.types import (
+    Signals as Signals,
+)
+from captain_hook.types import (
+    SourceEdits as SourceEdits,
+)
+from captain_hook.types import (
+    TCondition as TCondition,
+)
+from captain_hook.types import (
+    TestFile as TestFile,
+)
+from captain_hook.types import (
+    Tool as Tool,
+)
+from captain_hook.types import (
+    TouchedFile as TouchedFile,
+)
+from captain_hook.types import (
+    UsedSkill as UsedSkill,
+)
+from captain_hook.types import (
+    Waiting as Waiting,
+)

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/cli.py

@@ -3,6 +3,8 @@ from __future__ import annotations
 import importlib.resources
 import json
 import os
+import shutil
+import subprocess
 import sys
 from collections import defaultdict
 from dataclasses import dataclass
@@ -22,6 +24,8 @@ from captain_hook.types import Event
 
 DIST_NAME = "capt-hook"
 EVENT_NAMES = ", ".join(n for e in Event if (n := e.name))
+MARKETPLACE = {"captain-hook": {"source": {"source": "github", "repo": "yasyf/captain-hook"}}}
+PLUGIN_ID = "captain-hook@captain-hook"
 
 
 @dataclass(frozen=True, slots=True)
@@ -40,6 +44,68 @@ def example_hook_source() -> str:
     return (importlib.resources.files("captain_hook") / "templates" / "example_hook.py.tmpl").read_text()
 
 
+def install_skills(root: Path, *, force: bool = False) -> dict[str, str]:
+    """Copy the bundled Claude Code skills into ``root/.claude/skills``.
+
+    Args:
+        root: Project root receiving the skills.
+        force: Replace existing skill directories wholesale instead of skipping them.
+
+    Returns:
+        Per-skill status of ``"installed"``, ``"replaced"``, or ``"skipped"``.
+    """
+    dest_root = root / ".claude" / "skills"
+    summary: dict[str, str] = {}
+    with importlib.resources.as_file(importlib.resources.files("captain_hook") / "skills") as src_root:
+        for skill in sorted(p for p in src_root.iterdir() if p.is_dir()):
+            dest = dest_root / skill.name
+            if dest.exists() and not force:
+                summary[skill.name] = "skipped"
+                continue
+            if dest.exists():
+                shutil.rmtree(dest)
+                summary[skill.name] = "replaced"
+            else:
+                summary[skill.name] = "installed"
+            shutil.copytree(skill, dest)
+    return summary
+
+
+def register_marketplace(root: Path) -> None:
+    """Enable the captain-hook plugin marketplace in ``root/.claude/settings.local.json``.
+
+    Merges ``extraKnownMarketplaces`` and ``enabledPlugins`` entries into the
+    existing settings so the bundled skills track the repository as a plugin.
+    """
+    settings_path = root / ".claude" / "settings.local.json"
+    settings_path.parent.mkdir(parents=True, exist_ok=True)
+    existing = json.loads(settings_path.read_text()) if settings_path.exists() else {}
+    merged = existing | {
+        "extraKnownMarketplaces": existing.get("extraKnownMarketplaces", {}) | MARKETPLACE,
+        "enabledPlugins": existing.get("enabledPlugins", {}) | {PLUGIN_ID: True},
+    }
+    settings_path.write_text(json.dumps(merged, indent=2) + "\n")
+
+
+def maybe_launch_bootstrap(root: Path) -> bool:
+    """Offer to launch Claude with the ``bootstrapping-hooks`` skill after ``init``.
+
+    Only fires in an interactive session with the ``claude`` CLI on PATH; CI and
+    scripted runs skip the prompt entirely. On acceptance, the captain-hook plugin
+    marketplace is registered in ``.claude/settings.local.json`` before launching.
+
+    Returns:
+        Whether Claude was launched.
+    """
+    if not (sys.stdin.isatty() and shutil.which("claude")):
+        return False
+    if not click.confirm("Bootstrap hooks now? (launches Claude with the bootstrapping-hooks skill)", default=True):
+        return False
+    register_marketplace(root)
+    subprocess.run(["claude", "/bootstrapping-hooks"], cwd=root, check=False)
+    return True
+
+
 def generate_settings(hooks_dir: str = ".claude/hooks", from_source: str = DIST_NAME) -> dict[str, Any]:
     events_by_async: defaultdict[bool, set[str]] = defaultdict(set)
     for entry in _state.hooks:
@@ -172,6 +238,8 @@ def init_project(root: Path) -> None:
     merged, summary = merge_init_settings(".claude/hooks", settings_path)
     settings_path.write_text(json.dumps(merged, indent=2) + "\n")
 
+    skills_summary = install_skills(root)
+
     print(f"Scaffolded {example.relative_to(root)} + {settings_path.relative_to(root)}.")
     print()
     print(f"{settings_path.relative_to(root)}:")
@@ -184,11 +252,20 @@ def init_project(root: Path) -> None:
     if unchanged:
         print(f"  unchanged: {', '.join(unchanged)} (already present)")
     print()
+    print(".claude/skills/:")
+    for name in (n for n, status in skills_summary.items() if status == "installed"):
+        print(f"  + installed {name}")
+    if skipped := [n for n, status in skills_summary.items() if status == "skipped"]:
+        print(f"  unchanged: {', '.join(skipped)} (already present; capt-hook skills install --force to refresh)")
+    print()
     print("Next:")
-    print("  1. Read the quickstart: docs/getting-started/quickstart.md")
+    print("  1. Read the quickstart: https://yasyf.github.io/captain-hook/")
     print("  2. Edit example.py or add new files under .claude/hooks/")
     print("  3. capt-hook test       # verify inline tests")
     print("  4. capt-hook generate-settings    # rewire after adding events")
+    print("  5. /bootstrapping-hooks in Claude  # mine hooks from this repo's conventions")
+    print()
+    maybe_launch_bootstrap(root)
 
 
 def show_logs(session: str | None = None, tail: int | None = None) -> None:
@@ -345,7 +422,7 @@ def test(state: CliState, json_output: bool) -> None:
 @cli.command()
 @click.pass_obj
 def init(state: CliState) -> None:
-    """Scaffold hooks directory, bin script, and settings."""
+    """Scaffold the hooks directory, install bundled skills, and wire settings."""
     init_project(state.root)
 
 
@@ -357,4 +434,18 @@ def logs(session: str | None, tail: int | None) -> None:
     show_logs(session=session, tail=tail)
 
 
+@cli.group()
+def skills() -> None:
+    """Manage the bundled Claude Code skills."""
+
+
+@skills.command(name="install")
+@click.option("--force", is_flag=True, default=False, help="Replace skills that already exist in .claude/skills")
+@click.pass_obj
+def skills_install(state: CliState, force: bool) -> None:
+    """Copy the bundled skills into .claude/skills/."""
+    for name, status in install_skills(state.root, force=force).items():
+        click.echo(f"  {status} {name}")
+
+
 main = cli

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/context.py

@@ -13,7 +13,7 @@ from pydantic import BaseModel
 from pydantic_settings import BaseSettings
 
 from captain_hook.llm import CodexBackend, LlmBackend, LlmBackends, TModel, TSpecialty
-from captain_hook.prompt import PromptMessage
+from captain_hook.prompt import Prompt
 from captain_hook.session import SessionStore
 
 if TYPE_CHECKING:
@@ -119,7 +119,7 @@ class HookContext:
 
     def call_llm(
         self,
-        template: str | PromptMessage,
+        template: str | Prompt,
         *args: Any,
         specialty: TSpecialty = "general",
         model: TModel = "small",
@@ -129,7 +129,7 @@ class HookContext:
         response_model: type[BaseModel] | None = None,
         **kwargs: Any,
     ) -> str | BaseModel:
-        if isinstance(template, PromptMessage):
+        if isinstance(template, Prompt):
             prompt = str(template)
             if transcript:
                 prompt = f"{self.transcript}\n\n<task>\n{prompt}\n</task>"

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/primitives/__init__.py

@@ -1,10 +1,8 @@
 from __future__ import annotations
 
 from captain_hook.primitives.audit import audit as audit
-from captain_hook.primitives.audit import session_id_for as session_id_for
 from captain_hook.primitives.commands import block_command as block_command
 from captain_hook.primitives.commands import warn_command as warn_command
-from captain_hook.primitives.lint import diff_lint as diff_lint
 from captain_hook.primitives.lint import lint as lint
 from captain_hook.primitives.llm import (
     GateVerdict as GateVerdict,
@@ -29,21 +27,3 @@ from captain_hook.primitives.llm import (
 )
 from captain_hook.primitives.nudge import gate as gate
 from captain_hook.primitives.nudge import nudge as nudge
-
-__all__ = [
-    "GateVerdict",
-    "NudgeVerdict",
-    "PromptCheckVerdict",
-    "audit",
-    "block_command",
-    "diff_lint",
-    "gate",
-    "lint",
-    "llm_evaluate",
-    "llm_gate",
-    "llm_nudge",
-    "nudge",
-    "prompt_check",
-    "session_id_for",
-    "warn_command",
-]

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/primitives/llm.py

@@ -12,7 +12,7 @@ from pydantic import BaseModel
 from captain_hook import state
 from captain_hook.app import on
 from captain_hook.primitives.audit import session_id_for
-from captain_hook.prompt import Prompt, PromptMessage
+from captain_hook.prompt import Prompt, Prompt
 from captain_hook.state import PrimitiveState, fired_this_turn, hook_name, record_fire
 from captain_hook.types import (
     Action,
@@ -335,7 +335,7 @@ def record_prompt_check_failure(
 
 def prompt_check(
     evt: BaseHookEvent,
-    template: str | PromptMessage,
+    template: str | Prompt,
     fmt: dict[str, Any] | None = None,
     *,
     prefix: str,
@@ -349,7 +349,7 @@ def prompt_check(
     if include_reasoning:
         reasoning = evt.ctx.t.recent(50).assistant_text() if hasattr(evt.ctx.t, "recent") else ""
 
-    base = template if isinstance(template, PromptMessage) else Prompt().system(template.format(**(fmt or {})))
+    base = template if isinstance(template, Prompt) else Prompt().system(template.format(**(fmt or {})))
     built = base.context("agent_reasoning", reasoning or None)
     prompt_str = str(built)
 

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/prompt.py

@@ -21,7 +21,7 @@ def _caller_dir() -> Path:
 
 
 @dataclass(frozen=True, kw_only=True)
-class PromptMessage:
+class Prompt:
     """Fluent builder for structured LLM prompts with system text, XML context sections, and a question.
 
     Chain ``.system()``, ``.context(tag, content)``, and ``.ask()`` to build prompts.
@@ -32,38 +32,38 @@ class PromptMessage:
     contexts: tuple[tuple[str, str], ...] = ()
     ask_text: str = ""
 
-    def system(self, text: str) -> PromptMessage:
-        return PromptMessage(
+    def system(self, text: str) -> Prompt:
+        return Prompt(
             system_text=dedent_text(text),
             contexts=self.contexts,
             ask_text=self.ask_text,
         )
 
-    def context(self, tag: str, content: str | None) -> PromptMessage:
+    def context(self, tag: str, content: str | None) -> Prompt:
         if content is None or not (normalized := dedent_text(content)):
             return self
-        return PromptMessage(
+        return Prompt(
             system_text=self.system_text,
             contexts=(*self.contexts, (tag, normalized)),
             ask_text=self.ask_text,
         )
 
-    def ask(self, text: str) -> PromptMessage:
-        return PromptMessage(
+    def ask(self, text: str) -> Prompt:
+        return Prompt(
             system_text=self.system_text,
             contexts=self.contexts,
             ask_text=dedent_text(text),
         )
 
     @classmethod
-    def from_template(cls, text: str, **vars: object) -> PromptMessage:
+    def from_template(cls, text: str, **vars: object) -> Prompt:
         try:
             return cls(system_text=textwrap.dedent(text).strip().format_map(vars))
         except KeyError as exc:
             raise KeyError(f"template variable {exc.args[0]!r} not supplied") from exc
 
     @classmethod
-    def load(cls, name: str, *, base: str | Path | None = None, **vars: object) -> PromptMessage:
+    def load(cls, name: str, *, base: str | Path | None = None, **vars: object) -> Prompt:
         """Load a prompt from a ``.md`` file and render it via :meth:`from_template`.
 
         Resolution searches directories in order, returning the first existing file:
@@ -77,7 +77,7 @@ class PromptMessage:
             **vars: Template variables substituted into the file via ``str.format_map``.
 
         Returns:
-            A :class:`PromptMessage` whose system text is the rendered file contents.
+            A :class:`Prompt` whose system text is the rendered file contents.
 
         Raises:
             FileNotFoundError: If no matching file exists in any searched directory.
@@ -100,4 +100,3 @@ class PromptMessage:
         return "\n\n".join(parts)
 
 
-Prompt = PromptMessage

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/signals/__init__.py

@@ -73,14 +73,3 @@ def resolve_signals(signals: Sequence[Signal | NlpSignal] | Signals | None) -> S
     if isinstance(signals, Signals):
         return signals
     return Signals(patterns=list(signals), threshold=1)
-
-
-__all__ = [
-    "Signal",
-    "Signals",
-    "cite_message",
-    "extract_signal_context",
-    "resolve_signals",
-    "score_signals",
-    "transcript_texts",
-]

{capt_hook-0.3.0 → capt_hook-0.4.0}/captain_hook/signals/nlp.py

@@ -8,9 +8,6 @@ from typing import TYPE_CHECKING
 if TYPE_CHECKING:
     from spacy.tokens import Doc, Span, Token
 
-__all__ = ["Clause", "NlpSignal", "Phrase", "dep_related", "nlp_scan"]
-
-
 @dataclass(frozen=True, slots=True, init=False)
 class Phrase:
     lemmas: tuple[str, ...]