@mindfoldhq/trellis 0.1.3 → 0.1.5

package/dist/{.claude → templates/claude}/hooks/inject-subagent-context.py

@@ -349,6 +349,41 @@ def get_check_context(repo_root: str, feature_dir: str) -> str:
     return "\n\n".join(context_parts)
 
 
+def get_finish_context(repo_root: str, feature_dir: str) -> str:
+    """
+    Complete context for Finish phase (final check before PR)
+
+    Read order:
+    1. All files in finish.jsonl (if exists)
+    2. Fallback to finish-work.md only (lightweight final check)
+    3. prd.md (for verifying requirements are met)
+    """
+    context_parts = []
+
+    # 1. Try finish.jsonl first
+    finish_entries = read_jsonl_entries(repo_root, f"{feature_dir}/finish.jsonl")
+
+    if finish_entries:
+        for file_path, content in finish_entries:
+            context_parts.append(f"=== {file_path} ===\n{content}")
+    else:
+        # Fallback: only finish-work.md (lightweight)
+        finish_work = read_file_content(repo_root, ".claude/commands/finish-work.md")
+        if finish_work:
+            context_parts.append(
+                f"=== .claude/commands/finish-work.md (Finish checklist) ===\n{finish_work}"
+            )
+
+    # 2. Requirements document (for verifying requirements are met)
+    prd_content = read_file_content(repo_root, f"{feature_dir}/prd.md")
+    if prd_content:
+        context_parts.append(
+            f"=== {feature_dir}/prd.md (Requirements - verify all met) ===\n{prd_content}"
+        )
+
+    return "\n\n".join(context_parts)
+
+
 def get_debug_context(repo_root: str, feature_dir: str) -> str:
     """
     Complete context for Debug Agent
@@ -452,15 +487,49 @@ All check specs and dev specs you need:
 1. **Get changes** - Run `git diff --name-only` and `git diff` to get code changes
 2. **Check against specs** - Check item by item against specs above
 3. **Self-fix** - Fix issues directly, don't just report
-4. **Run verification** - Reference .husky/pre-commit for typecheck and lint
+4. **Run verification** - Run project's lint and typecheck commands
 
 ## Important Constraints
 
 - Fix issues yourself, don't just report
-- Must execute complete checklist in finish-work.md
+- Must execute complete checklist in check specs
 - Pay special attention to impact radius analysis (L1-L5)"""
 
 
+def build_finish_prompt(original_prompt: str, context: str) -> str:
+    """Build complete prompt for Finish (final check before PR)"""
+    return f"""# Finish Agent Task
+
+You are performing the final check before creating a PR.
+
+## Your Context
+
+Finish checklist and requirements:
+
+{context}
+
+---
+
+## Your Task
+
+{original_prompt}
+
+---
+
+## Workflow
+
+1. **Review changes** - Run `git diff --name-only` to see all changed files
+2. **Verify requirements** - Check each requirement in prd.md is implemented
+3. **Run final checks** - Execute finish-work.md checklist
+4. **Confirm ready** - Ensure code is ready for PR
+
+## Important Constraints
+
+- This is a final verification, not a fix phase
+- If critical issues found, report them clearly
+- Verify all acceptance criteria in prd.md are met"""
+
+
 def build_debug_prompt(original_prompt: str, context: str) -> str:
     """Build complete prompt for Debug"""
     return f"""# Debug Agent Task
@@ -643,6 +712,9 @@ def main():
         # Update current_phase in feature.json (system-level enforcement)
         update_current_phase(repo_root, feature_dir, subagent_type)
 
+    # Check for [finish] marker in prompt (check agent with finish context)
+    is_finish_phase = "[finish]" in original_prompt.lower()
+
     # Get context and build prompt based on subagent type
     if subagent_type == AGENT_IMPLEMENT:
         assert feature_dir is not None  # validated above
@@ -650,8 +722,14 @@ def main():
         new_prompt = build_implement_prompt(original_prompt, context)
     elif subagent_type == AGENT_CHECK:
         assert feature_dir is not None  # validated above
-        context = get_check_context(repo_root, feature_dir)
-        new_prompt = build_check_prompt(original_prompt, context)
+        if is_finish_phase:
+            # Finish phase: use finish context (lighter, focused on final verification)
+            context = get_finish_context(repo_root, feature_dir)
+            new_prompt = build_finish_prompt(original_prompt, context)
+        else:
+            # Regular check phase: use check context (full specs for self-fix loop)
+            context = get_check_context(repo_root, feature_dir)
+            new_prompt = build_check_prompt(original_prompt, context)
     elif subagent_type == AGENT_DEBUG:
         assert feature_dir is not None  # validated above
         context = get_debug_context(repo_root, feature_dir)

package/dist/templates/claude/hooks/ralph-loop.py

@@ -0,0 +1,374 @@
+#!/usr/bin/env python3
+"""
+Ralph Loop - SubagentStop Hook for Check Agent Loop Control
+
+Based on the Ralph Wiggum technique for autonomous agent loops.
+Uses completion promises to control when the check agent can stop.
+
+Mechanism:
+- Intercepts when check subagent tries to stop (SubagentStop event)
+- If verify commands configured in worktree.yaml, runs them to verify
+- Otherwise, reads check.jsonl to get dynamic completion markers ({reason}_FINISH)
+- Blocks stopping until verification passes or all markers found
+- Has max iterations as safety limit
+
+State file: .trellis/.ralph-state.json
+- Tracks current iteration count per session
+- Resets when feature changes
+"""
+
+import json
+import os
+import subprocess
+import sys
+from datetime import datetime
+from pathlib import Path
+
+# =============================================================================
+# Configuration
+# =============================================================================
+
+MAX_ITERATIONS = 5  # Safety limit to prevent infinite loops
+STATE_TIMEOUT_MINUTES = 30  # Reset state if older than this
+STATE_FILE = ".trellis/.ralph-state.json"
+WORKTREE_YAML = ".trellis/worktree.yaml"
+DIR_WORKFLOW = ".trellis"
+FILE_CURRENT_FEATURE = ".current-feature"
+
+# Only control loop for check agent
+TARGET_AGENT = "check"
+
+
+def find_repo_root(start_path: str) -> str | None:
+    """Find git repo root from start_path upwards"""
+    current = Path(start_path).resolve()
+    while current != current.parent:
+        if (current / ".git").exists():
+            return str(current)
+        current = current.parent
+    return None
+
+
+def get_current_feature(repo_root: str) -> str | None:
+    """Read current feature directory path"""
+    current_feature_file = os.path.join(repo_root, DIR_WORKFLOW, FILE_CURRENT_FEATURE)
+    if not os.path.exists(current_feature_file):
+        return None
+
+    try:
+        with open(current_feature_file, "r", encoding="utf-8") as f:
+            content = f.read().strip()
+            return content if content else None
+    except Exception:
+        return None
+
+
+def get_verify_commands(repo_root: str) -> list[str]:
+    """
+    Read verify commands from worktree.yaml.
+
+    Returns list of commands to run, or empty list if not configured.
+    Uses simple YAML parsing without external dependencies.
+    """
+    yaml_path = os.path.join(repo_root, WORKTREE_YAML)
+    if not os.path.exists(yaml_path):
+        return []
+
+    try:
+        with open(yaml_path, "r", encoding="utf-8") as f:
+            content = f.read()
+
+        # Simple YAML parsing for verify section
+        # Look for "verify:" followed by list items
+        lines = content.split("\n")
+        in_verify_section = False
+        commands = []
+
+        for line in lines:
+            stripped = line.strip()
+
+            # Check for section start
+            if stripped.startswith("verify:"):
+                in_verify_section = True
+                continue
+
+            # Check for new section (not indented, ends with :)
+            if (
+                not line.startswith(" ")
+                and not line.startswith("\t")
+                and stripped.endswith(":")
+                and stripped != ""
+            ):
+                in_verify_section = False
+                continue
+
+            # If in verify section, look for list items
+            if in_verify_section:
+                # Skip comments and empty lines
+                if stripped.startswith("#") or stripped == "":
+                    continue
+                # Parse list item (- command)
+                if stripped.startswith("- "):
+                    cmd = stripped[2:].strip()
+                    if cmd:
+                        commands.append(cmd)
+
+        return commands
+    except Exception:
+        return []
+
+
+def run_verify_commands(repo_root: str, commands: list[str]) -> tuple[bool, str]:
+    """
+    Run verify commands and return (success, message).
+
+    All commands must pass for success.
+    """
+    for cmd in commands:
+        try:
+            result = subprocess.run(
+                cmd,
+                shell=True,
+                cwd=repo_root,
+                capture_output=True,
+                timeout=120,  # 2 minute timeout per command
+            )
+            if result.returncode != 0:
+                stderr = result.stderr.decode("utf-8", errors="replace")
+                stdout = result.stdout.decode("utf-8", errors="replace")
+                error_output = stderr or stdout
+                # Truncate long output
+                if len(error_output) > 500:
+                    error_output = error_output[:500] + "..."
+                return False, f"Command failed: {cmd}\n{error_output}"
+        except subprocess.TimeoutExpired:
+            return False, f"Command timed out: {cmd}"
+        except Exception as e:
+            return False, f"Command error: {cmd} - {str(e)}"
+
+    return True, "All verify commands passed"
+
+
+def get_completion_markers(repo_root: str, feature_dir: str) -> list[str]:
+    """
+    Read check.jsonl and generate completion markers from reasons.
+
+    Each entry's "reason" field becomes {REASON}_FINISH marker.
+    Example: {"file": "...", "reason": "TypeCheck"} -> "TYPECHECK_FINISH"
+    """
+    check_jsonl_path = os.path.join(repo_root, feature_dir, "check.jsonl")
+    markers = []
+
+    if not os.path.exists(check_jsonl_path):
+        # Fallback: if no check.jsonl, use default marker
+        return ["ALL_CHECKS_FINISH"]
+
+    try:
+        with open(check_jsonl_path, "r", encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    item = json.loads(line)
+                    reason = item.get("reason", "")
+                    if reason:
+                        # Convert to uppercase and add _FINISH suffix
+                        marker = f"{reason.upper().replace(' ', '_')}_FINISH"
+                        if marker not in markers:
+                            markers.append(marker)
+                except json.JSONDecodeError:
+                    continue
+    except Exception:
+        pass
+
+    # If no markers found, use default
+    if not markers:
+        markers = ["ALL_CHECKS_FINISH"]
+
+    return markers
+
+
+def load_state(repo_root: str) -> dict:
+    """Load Ralph Loop state from file"""
+    state_path = os.path.join(repo_root, STATE_FILE)
+    if not os.path.exists(state_path):
+        return {"feature": None, "iteration": 0, "started_at": None}
+
+    try:
+        with open(state_path, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except Exception:
+        return {"feature": None, "iteration": 0, "started_at": None}
+
+
+def save_state(repo_root: str, state: dict) -> None:
+    """Save Ralph Loop state to file"""
+    state_path = os.path.join(repo_root, STATE_FILE)
+    try:
+        # Ensure directory exists
+        os.makedirs(os.path.dirname(state_path), exist_ok=True)
+        with open(state_path, "w", encoding="utf-8") as f:
+            json.dump(state, f, indent=2, ensure_ascii=False)
+    except Exception:
+        pass
+
+
+def check_completion(agent_output: str, markers: list[str]) -> tuple[bool, list[str]]:
+    """
+    Check if all completion markers are present in agent output.
+
+    Returns:
+        (all_complete, missing_markers)
+    """
+    missing = []
+    for marker in markers:
+        if marker not in agent_output:
+            missing.append(marker)
+
+    return len(missing) == 0, missing
+
+
+def main():
+    try:
+        input_data = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        # If can't parse input, allow stop
+        sys.exit(0)
+
+    # Get event info
+    hook_event = input_data.get("hook_event_name", "")
+
+    # Only handle SubagentStop event
+    if hook_event != "SubagentStop":
+        sys.exit(0)
+
+    # Get subagent info
+    subagent_type = input_data.get("subagent_type", "")
+    agent_output = input_data.get("agent_output", "")
+    original_prompt = input_data.get("prompt", "")
+    cwd = input_data.get("cwd", os.getcwd())
+
+    # Only control check agent
+    if subagent_type != TARGET_AGENT:
+        sys.exit(0)
+
+    # Skip Ralph Loop for finish phase (already verified in check phase)
+    if "[finish]" in original_prompt.lower():
+        sys.exit(0)
+
+    # Find repo root
+    repo_root = find_repo_root(cwd)
+    if not repo_root:
+        sys.exit(0)
+
+    # Get current feature
+    feature_dir = get_current_feature(repo_root)
+    if not feature_dir:
+        sys.exit(0)
+
+    # Load state
+    state = load_state(repo_root)
+
+    # Reset state if feature changed or state is too old
+    should_reset = False
+    if state.get("feature") != feature_dir:
+        should_reset = True
+    elif state.get("started_at"):
+        try:
+            started = datetime.fromisoformat(state["started_at"])
+            if (datetime.now() - started).total_seconds() > STATE_TIMEOUT_MINUTES * 60:
+                should_reset = True
+        except (ValueError, TypeError):
+            should_reset = True
+
+    if should_reset:
+        state = {
+            "feature": feature_dir,
+            "iteration": 0,
+            "started_at": datetime.now().isoformat(),
+        }
+
+    # Increment iteration
+    state["iteration"] = state.get("iteration", 0) + 1
+    current_iteration = state["iteration"]
+
+    # Save state
+    save_state(repo_root, state)
+
+    # Safety check: max iterations
+    if current_iteration >= MAX_ITERATIONS:
+        # Allow stop, reset state for next run
+        state["iteration"] = 0
+        save_state(repo_root, state)
+        output = {
+            "decision": "allow",
+            "reason": f"Max iterations ({MAX_ITERATIONS}) reached. Stopping to prevent infinite loop.",
+        }
+        print(json.dumps(output, ensure_ascii=False))
+        sys.exit(0)
+
+    # Check if verify commands are configured
+    verify_commands = get_verify_commands(repo_root)
+
+    if verify_commands:
+        # Use programmatic verification
+        passed, message = run_verify_commands(repo_root, verify_commands)
+
+        if passed:
+            # All verify commands passed, allow stop
+            state["iteration"] = 0
+            save_state(repo_root, state)
+            output = {
+                "decision": "allow",
+                "reason": "All verify commands passed. Check phase complete.",
+            }
+            print(json.dumps(output, ensure_ascii=False))
+            sys.exit(0)
+        else:
+            # Verification failed, block stop
+            output = {
+                "decision": "block",
+                "reason": f"Iteration {current_iteration}/{MAX_ITERATIONS}. Verification failed:\n{message}\n\nPlease fix the issues and try again.",
+            }
+            print(json.dumps(output, ensure_ascii=False))
+            sys.exit(0)
+    else:
+        # No verify commands, fall back to completion markers
+        markers = get_completion_markers(repo_root, feature_dir)
+        all_complete, missing = check_completion(agent_output, markers)
+
+        if all_complete:
+            # All checks complete, allow stop
+            state["iteration"] = 0
+            save_state(repo_root, state)
+            output = {
+                "decision": "allow",
+                "reason": "All completion markers found. Check phase complete.",
+            }
+            print(json.dumps(output, ensure_ascii=False))
+            sys.exit(0)
+        else:
+            # Missing markers, block stop and continue
+            output = {
+                "decision": "block",
+                "reason": f"""Iteration {current_iteration}/{MAX_ITERATIONS}. Missing completion markers: {", ".join(missing)}.
+
+IMPORTANT: You must ACTUALLY run the checks, not just output the markers.
+- Did you run lint? What was the output?
+- Did you run typecheck? What was the output?
+- Did they actually pass with zero errors?
+
+Only output a marker (e.g., LINT_FINISH) AFTER:
+1. You have executed the corresponding command
+2. The command completed with zero errors
+3. You have shown the command output in your response
+
+Do NOT output markers just to escape the loop. The loop exists to ensure quality.""",
+            }
+            print(json.dumps(output, ensure_ascii=False))
+            sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/dist/templates/claude/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Claude Code templates
+ *
+ * These are GENERIC templates for user projects.
+ * Do NOT use Trellis project's own .claude/ directory (which may be customized).
+ *
+ * Directory structure:
+ *   claude/
+ *   ├── commands/       # Slash commands
+ *   ├── agents/         # Multi-agent pipeline agents
+ *   ├── hooks/          # Context injection hooks
+ *   └── settings.json   # Settings configuration
+ */
+export declare const settingsTemplate: string;
+/**
+ * Command template with name and content
+ */
+export interface CommandTemplate {
+    name: string;
+    content: string;
+}
+/**
+ * Agent template with name and content
+ */
+export interface AgentTemplate {
+    name: string;
+    content: string;
+}
+/**
+ * Hook template with target path and content
+ */
+export interface HookTemplate {
+    targetPath: string;
+    content: string;
+}
+/**
+ * Get all command templates
+ */
+export declare function getAllCommands(): CommandTemplate[];
+/**
+ * Get all agent templates
+ */
+export declare function getAllAgents(): AgentTemplate[];
+/**
+ * Get all hook templates
+ */
+export declare function getAllHooks(): HookTemplate[];
+/**
+ * Get settings template
+ */
+export declare function getSettingsTemplate(): HookTemplate;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/claude/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAalD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAa9C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAU5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAKlD"}

package/dist/templates/claude/index.js

@@ -0,0 +1,83 @@
+/**
+ * Claude Code templates
+ *
+ * These are GENERIC templates for user projects.
+ * Do NOT use Trellis project's own .claude/ directory (which may be customized).
+ *
+ * Directory structure:
+ *   claude/
+ *   ├── commands/       # Slash commands
+ *   ├── agents/         # Multi-agent pipeline agents
+ *   ├── hooks/          # Context injection hooks
+ *   └── settings.json   # Settings configuration
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function readTemplate(relativePath) {
+    return readFileSync(join(__dirname, relativePath), "utf-8");
+}
+function listFiles(dir) {
+    try {
+        return readdirSync(join(__dirname, dir));
+    }
+    catch {
+        return [];
+    }
+}
+// Settings
+export const settingsTemplate = readTemplate("settings.json");
+/**
+ * Get all command templates
+ */
+export function getAllCommands() {
+    const commands = [];
+    const files = listFiles("commands");
+    for (const file of files) {
+        if (file.endsWith(".md")) {
+            const name = file.replace(".md", "");
+            const content = readTemplate(`commands/${file}`);
+            commands.push({ name, content });
+        }
+    }
+    return commands;
+}
+/**
+ * Get all agent templates
+ */
+export function getAllAgents() {
+    const agents = [];
+    const files = listFiles("agents");
+    for (const file of files) {
+        if (file.endsWith(".md")) {
+            const name = file.replace(".md", "");
+            const content = readTemplate(`agents/${file}`);
+            agents.push({ name, content });
+        }
+    }
+    return agents;
+}
+/**
+ * Get all hook templates
+ */
+export function getAllHooks() {
+    const hooks = [];
+    const files = listFiles("hooks");
+    for (const file of files) {
+        const content = readTemplate(`hooks/${file}`);
+        hooks.push({ targetPath: `hooks/${file}`, content });
+    }
+    return hooks;
+}
+/**
+ * Get settings template
+ */
+export function getSettingsTemplate() {
+    return {
+        targetPath: "settings.json",
+        content: settingsTemplate,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/claude/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,WAAW;AACX,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AA0B9D;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC"}

package/dist/{.claude → templates/claude}/settings.json

@@ -11,6 +11,18 @@
           }
         ]
       }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "check",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/ralph-loop.py\"",
+            "timeout": 10
+          }
+        ]
+      }
     ]
   }
 }

package/dist/{.claude → templates/cursor}/commands/finish-work.md

@@ -21,7 +21,7 @@ pnpm test
 - [ ] `pnpm type-check` passes with no type errors?
 - [ ] Tests pass?
 - [ ] No `console.log` statements (use logger)?
-- [ ] No non-null assertions `!`?
+- [ ] No non-null assertions (the `x!` operator)?
 - [ ] No `any` types?
 
 ### 2. Documentation Sync