agentic-loop 3.13.0 → 3.14.2

package/dist/loopgram/loop-runner.js

@@ -0,0 +1,157 @@
+import { spawn } from 'child_process';
+import { existsSync, writeFileSync, readFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+const PID_FILE = '.ralph/loop.pid';
+/**
+ * Check if a Ralph loop is currently running for a project
+ */
+export function isLoopRunning(projectPath) {
+    const pidFile = join(projectPath, PID_FILE);
+    if (!existsSync(pidFile)) {
+        return false;
+    }
+    try {
+        const pid = parseInt(readFileSync(pidFile, 'utf-8').trim());
+        // Check if process is still running
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        // Process not running, clean up stale PID file
+        try {
+            unlinkSync(pidFile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        return false;
+    }
+}
+/**
+ * Start a Ralph loop for a project
+ */
+export function startLoop(projectPath) {
+    // Check if PRD exists
+    const prdPath = join(projectPath, '.ralph/prd.json');
+    if (!existsSync(prdPath)) {
+        return {
+            success: false,
+            message: 'No PRD found. Use /prd to create stories first.',
+        };
+    }
+    // Check if already running
+    if (isLoopRunning(projectPath)) {
+        return {
+            success: false,
+            message: 'Loop already running. Use /loop to check status.',
+        };
+    }
+    try {
+        // Start Ralph loop in background
+        const logFile = join(projectPath, '.ralph/loop.log');
+        // Use npx agentic-loop run
+        const child = spawn('npx', ['agentic-loop', 'run'], {
+            cwd: projectPath,
+            detached: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                // Ensure Claude runs non-interactively
+                CLAUDE_CODE_ENTRYPOINT: 'cli',
+            },
+        });
+        // Write output to log file
+        const logStream = require('fs').createWriteStream(logFile, { flags: 'a' });
+        child.stdout?.pipe(logStream);
+        child.stderr?.pipe(logStream);
+        // Save PID
+        const pidFile = join(projectPath, PID_FILE);
+        writeFileSync(pidFile, child.pid.toString());
+        // Detach child process
+        child.unref();
+        return {
+            success: true,
+            message: `Loop started (PID: ${child.pid}). Use /loop to check progress.`,
+            pid: child.pid,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to start loop: ${error}`,
+        };
+    }
+}
+/**
+ * Stop a running Ralph loop
+ */
+export function stopLoop(projectPath) {
+    const pidFile = join(projectPath, PID_FILE);
+    if (!existsSync(pidFile)) {
+        return {
+            success: false,
+            message: 'No loop running.',
+        };
+    }
+    try {
+        const pid = parseInt(readFileSync(pidFile, 'utf-8').trim());
+        // Kill the process and its children
+        try {
+            // Kill process group (negative PID)
+            process.kill(-pid, 'SIGTERM');
+        }
+        catch {
+            // Try killing just the process
+            process.kill(pid, 'SIGTERM');
+        }
+        // Clean up PID file
+        unlinkSync(pidFile);
+        return {
+            success: true,
+            message: 'Loop stopped.',
+        };
+    }
+    catch (error) {
+        // Clean up PID file even if kill failed
+        try {
+            unlinkSync(pidFile);
+        }
+        catch {
+            // Ignore
+        }
+        return {
+            success: false,
+            message: `Error stopping loop: ${error}`,
+        };
+    }
+}
+/**
+ * Get loop process info
+ */
+export function getLoopInfo(projectPath) {
+    const pidFile = join(projectPath, PID_FILE);
+    const logFile = join(projectPath, '.ralph/loop.log');
+    const running = isLoopRunning(projectPath);
+    let pid;
+    let logTail;
+    if (existsSync(pidFile)) {
+        try {
+            pid = parseInt(readFileSync(pidFile, 'utf-8').trim());
+        }
+        catch {
+            // Ignore
+        }
+    }
+    if (existsSync(logFile)) {
+        try {
+            // Get last 500 chars of log
+            const content = readFileSync(logFile, 'utf-8');
+            logTail = content.slice(-500);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return { running, pid, logTail };
+}
+//# sourceMappingURL=loop-runner.js.map

package/dist/loopgram/loop-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-runner.js","sourceRoot":"","sources":["../../src/loopgram/loop-runner.ts"],"names":[],"mappings":"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"}

package/dist/loopgram/prd-generator.d.ts

@@ -0,0 +1,37 @@
+import type { Message } from './types.js';
+interface Story {
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    testSteps: string[];
+    status: 'pending' | 'in_progress' | 'completed' | 'failed';
+}
+/**
+ * Generate PRD stories from a conversation
+ */
+export declare function generateStories(conversation: Message[], context: string | undefined, model: string): Promise<{
+    featureName: string;
+    featureDescription: string;
+    stories: Story[];
+}>;
+/**
+ * Append stories to existing PRD or create new one
+ */
+export declare function appendToPRD(projectPath: string, featureName: string, featureDescription: string, newStories: Story[]): {
+    added: number;
+    total: number;
+    prdPath: string;
+};
+/**
+ * Get current PRD status
+ */
+export declare function getPRDStatus(projectPath: string): {
+    exists: boolean;
+    featureName?: string;
+    total: number;
+    pending: number;
+    completed: number;
+} | null;
+export {};
+//# sourceMappingURL=prd-generator.d.ts.map

package/dist/loopgram/prd-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-generator.d.ts","sourceRoot":"","sources":["../../src/loopgram/prd-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC5D;AAmCD;;GAEG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,OAAO,EAAE,EACvB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC,CAwChF;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,KAAK,EAAE,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA4CnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAwBP"}

package/dist/loopgram/prd-generator.js

@@ -0,0 +1,134 @@
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import Anthropic from '@anthropic-ai/sdk';
+const anthropic = new Anthropic();
+const PRD_PROMPT = `You are generating stories for a PRD (Product Requirements Document) that will be executed by an autonomous coding agent called Ralph.
+
+Based on the conversation, generate 1-3 small, focused stories. Each story should be completable in a single coding session.
+
+Output ONLY valid JSON in this exact format:
+{
+  "featureName": "Brief feature name",
+  "featureDescription": "One sentence description",
+  "stories": [
+    {
+      "id": "kebab-case-id",
+      "title": "Short title",
+      "description": "What needs to be built",
+      "acceptanceCriteria": ["Criterion 1", "Criterion 2"],
+      "testSteps": ["npm test", "npm run lint"]
+    }
+  ]
+}
+
+Rules:
+- Story IDs must be unique kebab-case (e.g., "add-oauth-config")
+- Keep stories small and focused
+- Include realistic test commands in testSteps
+- Output ONLY the JSON, no markdown or explanation`;
+/**
+ * Generate PRD stories from a conversation
+ */
+export async function generateStories(conversation, context, model) {
+    let prompt = 'Generate PRD stories from this conversation:\n\n';
+    if (context) {
+        prompt += `## Codebase Context\n${context}\n\n`;
+    }
+    prompt += '## Conversation\n';
+    for (const msg of conversation) {
+        prompt += `${msg.role.toUpperCase()}: ${msg.content}\n\n`;
+    }
+    const response = await anthropic.messages.create({
+        model,
+        max_tokens: 2000,
+        system: PRD_PROMPT,
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const text = response.content[0];
+    if (text.type !== 'text') {
+        throw new Error('Unexpected response type');
+    }
+    // Parse JSON from response (handle markdown code blocks)
+    let jsonStr = text.text.trim();
+    if (jsonStr.startsWith('```')) {
+        jsonStr = jsonStr.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+    }
+    const result = JSON.parse(jsonStr);
+    return {
+        featureName: result.featureName,
+        featureDescription: result.featureDescription,
+        stories: result.stories.map((s) => ({
+            ...s,
+            status: 'pending',
+        })),
+    };
+}
+/**
+ * Append stories to existing PRD or create new one
+ */
+export function appendToPRD(projectPath, featureName, featureDescription, newStories) {
+    const prdPath = join(projectPath, '.ralph/prd.json');
+    let prd;
+    if (existsSync(prdPath)) {
+        // Load existing PRD
+        const content = readFileSync(prdPath, 'utf-8');
+        prd = JSON.parse(content);
+        // Check for duplicate story IDs and make unique
+        const existingIds = new Set(prd.stories.map((s) => s.id));
+        for (const story of newStories) {
+            let id = story.id;
+            let counter = 1;
+            while (existingIds.has(id)) {
+                id = `${story.id}-${counter}`;
+                counter++;
+            }
+            story.id = id;
+            existingIds.add(id);
+        }
+        // Append new stories
+        prd.stories.push(...newStories);
+    }
+    else {
+        // Create new PRD
+        prd = {
+            feature: {
+                name: featureName,
+                description: featureDescription,
+            },
+            stories: newStories,
+        };
+    }
+    // Write PRD
+    writeFileSync(prdPath, JSON.stringify(prd, null, 2));
+    return {
+        added: newStories.length,
+        total: prd.stories.length,
+        prdPath,
+    };
+}
+/**
+ * Get current PRD status
+ */
+export function getPRDStatus(projectPath) {
+    const prdPath = join(projectPath, '.ralph/prd.json');
+    if (!existsSync(prdPath)) {
+        return { exists: false, total: 0, pending: 0, completed: 0 };
+    }
+    try {
+        const content = readFileSync(prdPath, 'utf-8');
+        const prd = JSON.parse(content);
+        const pending = prd.stories.filter((s) => s.status === 'pending').length;
+        const completed = prd.stories.filter((s) => s.status === 'completed').length;
+        return {
+            exists: true,
+            featureName: prd.feature.name,
+            total: prd.stories.length,
+            pending,
+            completed,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=prd-generator.js.map

package/dist/loopgram/prd-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-generator.js","sourceRoot":"","sources":["../../src/loopgram/prd-generator.ts"],"names":[],"mappings":"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"}

package/dist/loopgram/saver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Save a brainstorming idea to docs/ideas/ in the specified project
+ */
+export declare function saveIdea(projectPath: string, filename: string, content: string): string;
+/**
+ * Generate a filename-safe slug from a title
+ */
+export declare function slugify(title: string): string;
+//# sourceMappingURL=saver.d.ts.map

package/dist/loopgram/saver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saver.d.ts","sourceRoot":"","sources":["../../src/loopgram/saver.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CAsBR;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/dist/loopgram/saver.js

@@ -0,0 +1,35 @@
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+/**
+ * Save a brainstorming idea to docs/ideas/ in the specified project
+ */
+export function saveIdea(projectPath, filename, content) {
+    const ideasDir = join(projectPath, 'docs/ideas');
+    // Ensure directory exists
+    if (!existsSync(ideasDir)) {
+        mkdirSync(ideasDir, { recursive: true });
+    }
+    const filepath = join(ideasDir, `${filename}.md`);
+    // Add metadata header
+    const fullContent = `---
+created: ${new Date().toISOString()}
+source: telegram-brainstorm
+status: idea
+---
+
+${content}
+`;
+    writeFileSync(filepath, fullContent);
+    return filepath;
+}
+/**
+ * Generate a filename-safe slug from a title
+ */
+export function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 50);
+}
+//# sourceMappingURL=saver.js.map

package/dist/loopgram/saver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saver.js","sourceRoot":"","sources":["../../src/loopgram/saver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,WAAmB,EACnB,QAAgB,EAChB,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEjD,0BAA0B;IAC1B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,KAAK,CAAC,CAAC;IAElD,sBAAsB;IACtB,MAAM,WAAW,GAAG;WACX,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;;;EAKjC,OAAO;CACR,CAAC;IAEA,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACrC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/loopgram/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * TypeScript interfaces for the Telegram Brainstorm Bot
+ */
+export interface Message {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface ProjectConfig {
+    name: string;
+    path: string;
+    description?: string;
+}
+export interface TelegramConfig {
+    allowedUserIds: string[];
+}
+export interface AnthropicConfig {
+    model: string;
+}
+export interface BrainstormConfig {
+    telegram: TelegramConfig;
+    anthropic: AnthropicConfig;
+    projects: Record<string, ProjectConfig>;
+}
+export interface SaveResult {
+    filepath: string;
+    summary: string;
+    title: string;
+}
+export interface LoopStatus {
+    isRunning: boolean;
+    currentStory: string | null;
+    completedStories: number;
+    totalStories: number;
+    lastUpdate: string;
+    errors: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/loopgram/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/loopgram/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/loopgram/types.js

@@ -0,0 +1,5 @@
+/**
+ * TypeScript interfaces for the Telegram Brainstorm Bot
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/loopgram/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/loopgram/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-loop",
-  "version": "3.13.0",
+  "version": "3.14.2",
   "description": "Autonomous AI coding loop - PRD-driven development with Claude Code",
   "author": "Allie Jones <allie@allthrive.ai>",
   "license": "MIT",
@@ -58,7 +58,9 @@
     "postinstall": "./bin/postinstall.sh",
     "release": "npm version patch && git push && git push --tags && npm publish",
     "release:minor": "npm version minor && git push && git push --tags && npm publish",
-    "release:major": "npm version major && git push && git push --tags && npm publish"
+    "release:major": "npm version major && git push && git push --tags && npm publish",
+    "loopgram": "tsx src/loopgram/index.ts",
+    "loopgram:bg": "nohup npm run loopgram > .ralph/loopgram.log 2>&1 &"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -72,6 +74,8 @@
     }
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.32.0",
+    "telegraf": "^4.16.0",
     "tsx": "^4.0.0"
   },
   "devDependencies": {

package/ralph/hooks/common.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# common.sh - Shared utilities for Claude Code hooks
+#
+# Source this file at the start of PostToolUse hooks:
+#   source "$(dirname "$0")/common.sh"
+#
+# Provides:
+#   - parse_hook_input: Sets HOOK_INPUT, TOOL_NAME, FILE_PATH, NEW_CONTENT
+#   - is_code_file: Check if FILE_PATH matches code extensions
+#   - is_test_file: Check if FILE_PATH is a test file
+#   - hook_allow: Output JSON to allow the operation
+#   - hook_warn: Output JSON warning (non-blocking)
+#   - hook_block: Output JSON to block the operation
+
+set -euo pipefail
+
+# Global variables set by parse_hook_input
+HOOK_INPUT=""
+TOOL_NAME=""
+FILE_PATH=""
+NEW_CONTENT=""
+
+# Parse hook input from stdin and extract common fields
+# Sets: HOOK_INPUT, TOOL_NAME, FILE_PATH, NEW_CONTENT
+parse_hook_input() {
+  HOOK_INPUT=$(cat)
+  TOOL_NAME=$(echo "$HOOK_INPUT" | jq -r '.tool_name // ""')
+  FILE_PATH=$(echo "$HOOK_INPUT" | jq -r '.tool_input.file_path // .tool_input.path // ""')
+
+  # Extract content based on tool type
+  NEW_CONTENT=""
+  if [[ "$TOOL_NAME" == "Write" ]]; then
+    NEW_CONTENT=$(echo "$HOOK_INPUT" | jq -r '.tool_input.content // ""')
+  elif [[ "$TOOL_NAME" == "Edit" ]]; then
+    NEW_CONTENT=$(echo "$HOOK_INPUT" | jq -r '.tool_input.new_string // ""')
+  fi
+}
+
+# Check if FILE_PATH matches given extensions
+# Usage: is_code_file "ts,tsx,js,jsx,py" && echo "yes"
+is_code_file() {
+  local extensions="$1"
+
+  # Files without extension don't match
+  [[ "$FILE_PATH" != *"."* ]] && return 1
+
+  local file_ext="${FILE_PATH##*.}"
+
+  # Check if file extension is in the comma-separated list
+  [[ ",$extensions," == *",$file_ext,"* ]]
+}
+
+# Check if FILE_PATH is a test file
+is_test_file() {
+  case "$FILE_PATH" in
+    *.test.*|*.spec.*|*/__tests__/*|*/test/*|*/tests/*|*/fixtures/*)
+      return 0
+      ;;
+  esac
+  return 1
+}
+
+# Output JSON to allow the operation (continue: true)
+hook_allow() {
+  echo '{"continue": true}'
+}
+
+# Output warning JSON (non-blocking, adds context)
+# Usage: hook_warn "Warning message"
+hook_warn() {
+  local message="$1"
+  jq -n --arg warn "$message" '{
+    "continue": true,
+    "hookSpecificOutput": {
+      "additionalContext": $warn
+    }
+  }'
+}
+
+# Output blocking JSON (continue: false)
+# Usage: hook_block "Error message"
+hook_block() {
+  local message="$1"
+  jq -n --arg msg "$message" '{
+    "continue": false,
+    "message": $msg
+  }'
+}

package/ralph/hooks/warn-debug.sh

@@ -1,54 +1,36 @@
 #!/usr/bin/env bash
+# shellcheck shell=bash
 # warn-debug.sh - Warn about debug statements in written code
 # Hook: PostToolUse matcher: "Edit|Write"
 
-set -euo pipefail
+source "$(dirname "$0")/common.sh"
 
-INPUT=$(cat)
-TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // ""')
-FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path // ""')
+parse_hook_input
 
 # Only check code files
-case "$FILE_PATH" in
-  *.ts|*.tsx|*.js|*.jsx|*.py|*.go|*.rs)
-    ;;
-  *)
-    echo '{"continue": true}'
-    exit 0
-    ;;
-esac
-
-# Get the content that was written
-NEW_CONTENT=""
-if [[ "$TOOL_NAME" == "Write" ]]; then
-  NEW_CONTENT=$(echo "$INPUT" | jq -r '.tool_input.content // ""')
-elif [[ "$TOOL_NAME" == "Edit" ]]; then
-  NEW_CONTENT=$(echo "$INPUT" | jq -r '.tool_input.new_string // ""')
+if ! is_code_file "ts,tsx,js,jsx,py,go,rs"; then
+  hook_allow
+  exit 0
 fi
 
 # Check for debug patterns
 WARNINGS=""
 
-if echo "$NEW_CONTENT" | grep -qE 'console\.(log|debug|info|warn|error)\s*\('; then
+if echo "$NEW_CONTENT" | grep -qE 'console\.(log|debug|info|warn|error)[[:space:]]*\('; then
   WARNINGS="⚠️  Debug statement detected: console.log/debug. Remove before commit."
 fi
 
-if echo "$NEW_CONTENT" | grep -qE '^\s*debugger\s*;?\s*$'; then
-  WARNINGS="${WARNINGS}\n⚠️  Debugger statement detected. Remove before commit."
+if echo "$NEW_CONTENT" | grep -qE '^[[:space:]]*debugger[[:space:]]*;?[[:space:]]*$'; then
+  WARNINGS="${WARNINGS}${WARNINGS:+\\n}⚠️  Debugger statement detected. Remove before commit."
 fi
 
-if echo "$NEW_CONTENT" | grep -qE '^\s*print\s*\('; then
-  WARNINGS="${WARNINGS}\n⚠️  Print statement detected. Remove before commit."
+if echo "$NEW_CONTENT" | grep -qE '^[[:space:]]*print[[:space:]]*\('; then
+  WARNINGS="${WARNINGS}${WARNINGS:+\\n}⚠️  Print statement detected. Remove before commit."
 fi
 
-# Output warning as additional context (non-blocking)
+# Output warning or allow
 if [[ -n "$WARNINGS" ]]; then
-  jq -n --arg warn "$WARNINGS" '{
-    "continue": true,
-    "hookSpecificOutput": {
-      "additionalContext": $warn
-    }
-  }'
+  hook_warn "$WARNINGS"
 else
-  echo '{"continue": true}'
+  hook_allow
 fi