ralph-cli-sandboxed 0.4.1 → 0.4.2

package/dist/commands/init.js

@@ -1,10 +1,11 @@
 import { existsSync, writeFileSync, mkdirSync, copyFileSync, chmodSync } from "fs";
 import { join, basename, dirname } from "path";
 import { fileURLToPath } from "url";
-import { getLanguages, generatePromptTemplate, DEFAULT_PRD, DEFAULT_PROGRESS, getCliProviders, getSkillsForLanguage } from "../templates/prompts.js";
-import { generateGenXcodeScript, hasSwiftUI, hasFastlane, generateFastfile, generateAppfile, generateFastlaneReadmeSection } from "../templates/macos-scripts.js";
-import { promptSelectWithArrows, promptConfirm, promptInput, promptMultiSelectWithArrows } from "../utils/prompt.js";
+import { getLanguages, generatePromptTemplate, DEFAULT_PRD, DEFAULT_PROGRESS, getCliProviders, getSkillsForLanguage, } from "../templates/prompts.js";
+import { generateGenXcodeScript, hasSwiftUI, hasFastlane, generateFastfile, generateAppfile, generateFastlaneReadmeSection, } from "../templates/macos-scripts.js";
+import { promptSelectWithArrows, promptConfirm, promptInput, promptMultiSelectWithArrows, } from "../utils/prompt.js";
 import { dockerInit } from "./docker.js";
+import { getBundleDisplayOptions, displayOptionToBundleId, bundleToRespondersConfig, getPresetDisplayOptions, displayOptionToPresetId, presetsToRespondersConfig, } from "../utils/responder-presets.js";
 // Get package root directory (works for both dev and installed package)
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -41,6 +42,7 @@ export async function init(args) {
     let selectedKey;
     let selectedTechnologies = [];
     let selectedSkills = [];
+    let selectedResponders = {};
     let checkCommand;
     let testCommand;
     if (useDefaults) {
@@ -62,7 +64,7 @@ export async function init(args) {
     else {
         // Step 1: Select CLI provider (first)
         const providerKeys = Object.keys(CLI_PROVIDERS);
-        const providerNames = providerKeys.map(k => `${CLI_PROVIDERS[k].name} - ${CLI_PROVIDERS[k].description}`);
+        const providerNames = providerKeys.map((k) => `${CLI_PROVIDERS[k].name} - ${CLI_PROVIDERS[k].description}`);
         const selectedProviderName = await promptSelectWithArrows("Select your AI CLI provider:", providerNames);
         const selectedProviderIndex = providerNames.indexOf(selectedProviderName);
         selectedCliProviderKey = providerKeys[selectedProviderIndex];
@@ -73,9 +75,13 @@ export async function init(args) {
             const customArgsInput = await promptInput("Enter default arguments (space-separated): ");
             const customArgs = customArgsInput.trim() ? customArgsInput.trim().split(/\s+/) : [];
             const customYoloArgsInput = await promptInput("Enter yolo/auto-approve arguments (space-separated): ");
-            const customYoloArgs = customYoloArgsInput.trim() ? customYoloArgsInput.trim().split(/\s+/) : [];
+            const customYoloArgs = customYoloArgsInput.trim()
+                ? customYoloArgsInput.trim().split(/\s+/)
+                : [];
             const customPromptArgsInput = await promptInput("Enter prompt arguments (e.g., -p for flag-based, leave empty for positional): ");
-            const customPromptArgs = customPromptArgsInput.trim() ? customPromptArgsInput.trim().split(/\s+/) : [];
+            const customPromptArgs = customPromptArgsInput.trim()
+                ? customPromptArgsInput.trim().split(/\s+/)
+                : [];
             cliConfig = {
                 command: customCommand || "claude",
                 args: customArgs,
@@ -94,7 +100,7 @@ export async function init(args) {
         console.log(`\nSelected CLI provider: ${CLI_PROVIDERS[selectedCliProviderKey].name}`);
         // Step 2: Select language (second)
         const languageKeys = Object.keys(LANGUAGES);
-        const languageNames = languageKeys.map(k => `${LANGUAGES[k].name} - ${LANGUAGES[k].description}`);
+        const languageNames = languageKeys.map((k) => `${LANGUAGES[k].name} - ${LANGUAGES[k].description}`);
         const selectedName = await promptSelectWithArrows("Select your project language/runtime:", languageNames);
         const selectedIndex = languageNames.indexOf(selectedName);
         selectedKey = languageKeys[selectedIndex];
@@ -102,11 +108,11 @@ export async function init(args) {
         console.log(`\nSelected language: ${config.name}`);
         // Step 3: Select technology stack if available (third)
         if (config.technologies && config.technologies.length > 0) {
-            const techOptions = config.technologies.map(t => `${t.name} - ${t.description}`);
-            const techNames = config.technologies.map(t => t.name);
+            const techOptions = config.technologies.map((t) => `${t.name} - ${t.description}`);
+            const techNames = config.technologies.map((t) => t.name);
             selectedTechnologies = await promptMultiSelectWithArrows("Select your technology stack (optional):", techOptions);
             // Convert display names back to just technology names for predefined options
-            selectedTechnologies = selectedTechnologies.map(sel => {
+            selectedTechnologies = selectedTechnologies.map((sel) => {
                 const idx = techOptions.indexOf(sel);
                 return idx >= 0 ? techNames[idx] : sel;
             });
@@ -120,10 +126,10 @@ export async function init(args) {
         // Step 4: Select skills if available for this language
         const availableSkills = getSkillsForLanguage(selectedKey);
         if (availableSkills.length > 0) {
-            const skillOptions = availableSkills.map(s => `${s.name} - ${s.description}`);
+            const skillOptions = availableSkills.map((s) => `${s.name} - ${s.description}`);
             const selectedSkillNames = await promptMultiSelectWithArrows("Select AI coding rules/skills to enable (optional):", skillOptions);
             // Convert selected display names to SkillConfig objects
-            selectedSkills = selectedSkillNames.map(sel => {
+            selectedSkills = selectedSkillNames.map((sel) => {
                 const idx = skillOptions.indexOf(sel);
                 const skill = availableSkills[idx];
                 return {
@@ -134,18 +140,52 @@ export async function init(args) {
                 };
             });
             if (selectedSkills.length > 0) {
-                console.log(`\nSelected skills: ${selectedSkills.map(s => s.name).join(", ")}`);
+                console.log(`\nSelected skills: ${selectedSkills.map((s) => s.name).join(", ")}`);
             }
             else {
                 console.log("\nNo skills selected.");
             }
         }
+        // Step 5: Select chat responder presets (optional)
+        const setupResponders = await promptConfirm("\nWould you like to set up chat responders?", false);
+        if (setupResponders) {
+            // First, ask if they want a bundle or individual presets
+            const selectionType = await promptSelectWithArrows("How would you like to configure responders?", [
+                "Use a preset bundle (recommended)",
+                "Select individual presets",
+                "Skip - configure later",
+            ]);
+            if (selectionType === "Use a preset bundle (recommended)") {
+                const bundleOptions = getBundleDisplayOptions();
+                const selectedBundle = await promptSelectWithArrows("Select a responder bundle:", bundleOptions);
+                const bundleId = displayOptionToBundleId(selectedBundle);
+                if (bundleId) {
+                    selectedResponders = bundleToRespondersConfig(bundleId);
+                    console.log(`\nConfigured responders from bundle: ${Object.keys(selectedResponders).join(", ")}`);
+                }
+            }
+            else if (selectionType === "Select individual presets") {
+                const presetOptions = getPresetDisplayOptions();
+                const selectedPresets = await promptMultiSelectWithArrows("Select responder presets to enable:", presetOptions);
+                // Convert display options back to preset IDs
+                const presetIds = selectedPresets
+                    .map(displayOptionToPresetId)
+                    .filter((id) => id !== undefined);
+                if (presetIds.length > 0) {
+                    selectedResponders = presetsToRespondersConfig(presetIds);
+                    console.log(`\nConfigured responders: ${Object.keys(selectedResponders).join(", ")}`);
+                }
+            }
+            else {
+                console.log("\nSkipping responders - you can configure them later in config.json");
+            }
+        }
         // Allow custom commands for "none" language
         checkCommand = config.checkCommand;
         testCommand = config.testCommand;
         if (selectedKey === "none") {
-            checkCommand = await promptInput("\nEnter your type/build check command: ") || checkCommand;
-            testCommand = await promptInput("Enter your test command: ") || testCommand;
+            checkCommand = (await promptInput("\nEnter your type/build check command: ")) || checkCommand;
+            testCommand = (await promptInput("Enter your test command: ")) || testCommand;
         }
     }
     const finalConfig = {
@@ -154,7 +194,9 @@ export async function init(args) {
         testCommand,
     };
     // Generate image name from directory name
-    const projectName = basename(cwd).toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    const projectName = basename(cwd)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-");
     const imageName = `ralph-${projectName}`;
     // Generate macOS development actions for Swift + SwiftUI projects
     const macOsActions = {};
@@ -197,6 +239,14 @@ export async function init(args) {
         // CLI configuration
         cli: cliConfig,
         cliProvider: selectedCliProviderKey,
+        // LLM providers for chat responders (empty by default, uses defaults from env vars)
+        // Example:
+        // llmProviders: {
+        //   "claude": { type: "anthropic", model: "claude-sonnet-4-20250514" },
+        //   "gpt4": { type: "openai", model: "gpt-4o" },
+        //   "local": { type: "ollama", model: "llama3", baseUrl: "http://localhost:11434" }
+        // }
+        llmProviders: {},
         // Optional fields with defaults/empty values for discoverability
         notifyCommand: "",
         technologies: selectedTechnologies.length > 0 ? selectedTechnologies : [],
@@ -244,6 +294,17 @@ export async function init(args) {
                 botToken: "",
                 allowedChatIds: [],
             },
+            // Chat responders - handle incoming messages based on triggers
+            // Special "default" responder handles messages that don't match any trigger
+            // Trigger patterns: "@name" for mentions, "keyword" for prefix matching
+            // Use "ralph init" to select from preset bundles, or configure manually:
+            // responders: {
+            //   "default": { type: "llm", provider: "anthropic", systemPrompt: "You are a helpful assistant for {{project}}." },
+            //   "qa": { type: "llm", trigger: "@qa", provider: "anthropic", systemPrompt: "Answer questions about the codebase." },
+            //   "code": { type: "claude-code", trigger: "@code" },
+            //   "lint": { type: "cli", trigger: "!lint", command: "npm run lint" }
+            // }
+            responders: selectedResponders,
         },
         // Daemon configuration for sandbox-to-host communication
         daemon: {
@@ -332,7 +393,7 @@ docker/.config-hash
         const swiftProjectName = basename(cwd)
             .replace(/[^a-zA-Z0-9]+/g, " ")
             .split(" ")
-            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
             .join("") || "App";
         if (!existsSync(genXcodePath)) {
             writeFileSync(genXcodePath, generateGenXcodeScript(swiftProjectName));

package/dist/commands/listen.js

@@ -190,7 +190,9 @@ async function processMessage(message, messagesPath, debug) {
             proc.unref();
             respondToMessage(messagesPath, message.id, {
                 success: true,
-                output: message.args?.length ? `Ralph run started (category: ${message.args[0]})` : "Ralph run started",
+                output: message.args?.length
+                    ? `Ralph run started (category: ${message.args[0]})`
+                    : "Ralph run started",
             });
             break;
         }

package/dist/commands/notify.js

@@ -1,7 +1,7 @@
 import { isRunningInContainer } from "../utils/config.js";
 import { sendNotification } from "../utils/notification.js";
 import { loadConfig } from "../utils/config.js";
-import { getMessagesPath, sendMessage, waitForResponse, } from "../utils/message-queue.js";
+import { getMessagesPath, sendMessage, waitForResponse } from "../utils/message-queue.js";
 import { existsSync } from "fs";
 /**
  * Send a notification - works both inside and outside containers.

package/dist/commands/once.js

@@ -1,7 +1,7 @@
 import { spawn } from "child_process";
 import { existsSync, appendFileSync, mkdirSync } from "fs";
 import { join } from "path";
-import { checkFilesExist, loadConfig, loadPrompt, getPaths, getCliConfig, requireContainer } from "../utils/config.js";
+import { checkFilesExist, loadConfig, loadPrompt, getPaths, getCliConfig, requireContainer, } from "../utils/config.js";
 import { resolvePromptVariables, getCliProviders } from "../templates/prompts.js";
 import { getStreamJsonParser } from "../utils/stream-json.js";
 import { sendNotificationWithDaemonEvents } from "../utils/notification.js";
@@ -58,10 +58,7 @@ export async function once(args) {
     // Use yoloArgs from config if available, otherwise default to Claude's --dangerously-skip-permissions
     const yoloArgs = cliConfig.yoloArgs ?? ["--dangerously-skip-permissions"];
     const promptArgs = cliConfig.promptArgs ?? ["-p"];
-    const cliArgs = [
-        ...(cliConfig.args ?? []),
-        ...yoloArgs,
-    ];
+    const cliArgs = [...(cliConfig.args ?? []), ...yoloArgs];
     // Build the prompt value based on whether fileArgs is configured
     // fileArgs (e.g., ["--read"] for Aider) means files are passed as separate arguments
     // Otherwise, use @file syntax embedded in the prompt (Claude Code style)
@@ -98,7 +95,7 @@ export async function once(args) {
     }
     cliArgs.push(...promptArgs, promptValue);
     if (debug) {
-        console.log(`[debug] ${cliConfig.command} ${cliArgs.map(a => a.includes(" ") ? `"${a}"` : a).join(" ")}\n`);
+        console.log(`[debug] ${cliConfig.command} ${cliArgs.map((a) => (a.includes(" ") ? `"${a}"` : a)).join(" ")}\n`);
         if (jsonLogPath) {
             console.log(`[debug] Saving raw JSON to: ${jsonLogPath}\n`);
         }
@@ -106,7 +103,12 @@ export async function once(args) {
     // Create provider-specific stream-json parser
     const streamJsonParser = getStreamJsonParser(config.cliProvider, debug);
     // Notification options for this run
-    const notifyOptions = { command: config.notifyCommand, debug, daemonConfig: config.daemon };
+    const notifyOptions = {
+        command: config.notifyCommand,
+        debug,
+        daemonConfig: config.daemon,
+        chatConfig: config.chat,
+    };
     return new Promise((resolve, reject) => {
         let output = ""; // Accumulate output for PRD complete detection
         if (streamJsonEnabled) {
@@ -181,7 +183,10 @@ export async function once(args) {
                 if (code !== 0) {
                     console.error(`\n${cliConfig.command} exited with code ${code}`);
                     const errorMessage = `Iteration failed with exit code ${code}`;
-                    await sendNotificationWithDaemonEvents("error", `Ralph: ${errorMessage}`, { ...notifyOptions, errorMessage });
+                    await sendNotificationWithDaemonEvents("error", `Ralph: ${errorMessage}`, {
+                        ...notifyOptions,
+                        errorMessage,
+                    });
                 }
                 else if (output.includes("<promise>COMPLETE</promise>")) {
                     await sendNotificationWithDaemonEvents("prd_complete", undefined, notifyOptions);
@@ -210,7 +215,10 @@ export async function once(args) {
                 if (code !== 0) {
                     console.error(`\n${cliConfig.command} exited with code ${code}`);
                     const errorMessage = `Iteration failed with exit code ${code}`;
-                    await sendNotificationWithDaemonEvents("error", `Ralph: ${errorMessage}`, { ...notifyOptions, errorMessage });
+                    await sendNotificationWithDaemonEvents("error", `Ralph: ${errorMessage}`, {
+                        ...notifyOptions,
+                        errorMessage,
+                    });
                 }
                 else if (output.includes("<promise>COMPLETE</promise>")) {
                     await sendNotificationWithDaemonEvents("prd_complete", undefined, notifyOptions);

package/dist/commands/prd.js

@@ -234,7 +234,10 @@ export function parseListArgs(args) {
         else if (args[i] === "--passes" || args[i] === "--passed") {
             passesFilter = true;
         }
-        else if (args[i] === "--no-passes" || args[i] === "--no-passed" || args[i] === "--not-passed" || args[i] === "--not-passes") {
+        else if (args[i] === "--no-passes" ||
+            args[i] === "--no-passed" ||
+            args[i] === "--not-passed" ||
+            args[i] === "--not-passes") {
             passesFilter = false;
         }
     }

package/dist/commands/run.js

@@ -1,9 +1,9 @@
 import { spawn } from "child_process";
 import { existsSync, readFileSync, writeFileSync, unlinkSync, appendFileSync, mkdirSync } from "fs";
 import { join } from "path";
-import { checkFilesExist, loadConfig, loadPrompt, getPaths, getCliConfig, requireContainer } from "../utils/config.js";
+import { checkFilesExist, loadConfig, loadPrompt, getPaths, getCliConfig, requireContainer, } from "../utils/config.js";
 import { resolvePromptVariables, getCliProviders } from "../templates/prompts.js";
-import { validatePrd, smartMerge, readPrdFile, writePrd, expandPrdFileReferences } from "../utils/prd-validator.js";
+import { validatePrd, smartMerge, readPrdFile, writePrd, expandPrdFileReferences, } from "../utils/prd-validator.js";
 import { getStreamJsonParser } from "../utils/stream-json.js";
 import { sendNotificationWithDaemonEvents } from "../utils/notification.js";
 const CATEGORIES = ["ui", "feature", "bugfix", "setup", "development", "testing", "docs"];
@@ -32,10 +32,10 @@ function createFilteredPrd(prdPath, baseDir, category) {
         process.exit(1);
     }
     const items = parsed;
-    let filteredItems = items.filter(item => item.passes === false);
+    let filteredItems = items.filter((item) => item.passes === false);
     // Apply category filter if specified
     if (category) {
-        filteredItems = filteredItems.filter(item => item.category === category);
+        filteredItems = filteredItems.filter((item) => item.category === category);
     }
     // Expand @{filepath} references in description and steps
     const expandedItems = expandPrdFileReferences(filteredItems, baseDir);
@@ -44,7 +44,7 @@ function createFilteredPrd(prdPath, baseDir, category) {
     writeFileSync(tempPath, JSON.stringify(expandedItems, null, 2));
     return {
         tempPath,
-        hasIncomplete: filteredItems.length > 0
+        hasIncomplete: filteredItems.length > 0,
     };
 }
 /**
@@ -88,7 +88,7 @@ function syncPassesFromTasks(tasksPath, prdPath) {
         for (const task of tasks) {
             if (task.passes === true) {
                 // Find matching item in prd by description
-                const match = prd.find(item => item.description === task.description ||
+                const match = prd.find((item) => item.description === task.description ||
                     item.description.includes(task.description) ||
                     task.description.includes(item.description));
                 if (match && !match.passes) {
@@ -116,9 +116,7 @@ async function runIteration(prompt, paths, sandboxed, filteredPrdPath, cliConfig
         let jsonLogPath;
         let lineBuffer = ""; // Buffer for incomplete JSON lines
         // Build CLI arguments: config args + yolo args + model args + prompt args
-        const cliArgs = [
-            ...(cliConfig.args ?? []),
-        ];
+        const cliArgs = [...(cliConfig.args ?? [])];
         // Only add yolo args when running in a container
         // Use yoloArgs from config if available, otherwise default to Claude's --dangerously-skip-permissions
         if (sandboxed) {
@@ -163,7 +161,7 @@ async function runIteration(prompt, paths, sandboxed, filteredPrdPath, cliConfig
         }
         cliArgs.push(...promptArgs, promptValue);
         if (debug) {
-            console.log(`[debug] ${cliConfig.command} ${cliArgs.map(a => a.includes(" ") ? `"${a}"` : a).join(" ")}\n`);
+            console.log(`[debug] ${cliConfig.command} ${cliArgs.map((a) => (a.includes(" ") ? `"${a}"` : a)).join(" ")}\n`);
             if (jsonLogPath) {
                 console.log(`[debug] Saving raw JSON to: ${jsonLogPath}\n`);
             }
@@ -254,7 +252,7 @@ async function runIteration(prompt, paths, sandboxed, filteredPrdPath, cliConfig
  * Sleep for the specified number of milliseconds.
  */
 function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }
 /**
  * Formats elapsed time in a human-readable format.
@@ -299,14 +297,14 @@ function countPrdItems(prdPath, category) {
     const items = parsed;
     let filteredItems = items;
     if (category) {
-        filteredItems = items.filter(item => item.category === category);
+        filteredItems = items.filter((item) => item.category === category);
     }
-    const complete = filteredItems.filter(item => item.passes === true).length;
-    const incomplete = filteredItems.filter(item => item.passes === false).length;
+    const complete = filteredItems.filter((item) => item.passes === true).length;
+    const incomplete = filteredItems.filter((item) => item.passes === false).length;
     return {
         total: filteredItems.length,
         complete,
-        incomplete
+        incomplete,
     };
 }
 /**
@@ -340,7 +338,7 @@ function validateAndRecoverPrd(prdPath, validPrd) {
         console.log("\x1b[32mRecovered: restored valid PRD structure.\x1b[0m");
     }
     if (mergeResult.warnings.length > 0) {
-        mergeResult.warnings.forEach(w => console.log(`  \x1b[33m${w}\x1b[0m`));
+        mergeResult.warnings.forEach((w) => console.log(`  \x1b[33m${w}\x1b[0m`));
     }
     return { recovered: true, itemsUpdated: mergeResult.itemsUpdated };
 }
@@ -434,13 +432,15 @@ export async function run(args) {
     // Only use provider's streamJsonArgs if defined, otherwise empty array (no special args)
     // This allows providers without JSON streaming to still have output displayed
     const streamJsonArgs = providerConfig?.streamJsonArgs ?? [];
-    const streamJson = streamJsonConfig?.enabled ? {
-        enabled: true,
-        saveRawJson: streamJsonConfig.saveRawJson !== false, // default true
-        outputDir: config.docker?.asciinema?.outputDir || ".recordings",
-        args: streamJsonArgs,
-        parser: getStreamJsonParser(config.cliProvider, debug),
-    } : undefined;
+    const streamJson = streamJsonConfig?.enabled
+        ? {
+            enabled: true,
+            saveRawJson: streamJsonConfig.saveRawJson !== false, // default true
+            outputDir: config.docker?.asciinema?.outputDir || ".recordings",
+            args: streamJsonArgs,
+            parser: getStreamJsonParser(config.cliProvider, debug),
+        }
+        : undefined;
     // Progress tracking: stop only if no tasks complete after N iterations
     const MAX_ITERATIONS_WITHOUT_PROGRESS = 3;
     // Get requested iteration count (may be adjusted dynamically)
@@ -615,6 +615,7 @@ export async function run(args) {
                         command: config.notifyCommand,
                         debug,
                         daemonConfig: config.daemon,
+                        chatConfig: config.chat,
                     });
                     break;
                 }
@@ -629,6 +630,7 @@ export async function run(args) {
                     command: config.notifyCommand,
                     debug,
                     daemonConfig: config.daemon,
+                    chatConfig: config.chat,
                     taskName,
                 });
             }
@@ -664,7 +666,13 @@ export async function run(args) {
                     console.log("Check the PRD and task definitions for issues.");
                     // Send notification about stopped run
                     const stoppedMessage = `No progress after ${MAX_ITERATIONS_WITHOUT_PROGRESS} iterations. ${progressCounts.incomplete} tasks remaining.`;
-                    await sendNotificationWithDaemonEvents("run_stopped", `Ralph: Run stopped - ${stoppedMessage}`, { command: config.notifyCommand, debug, daemonConfig: config.daemon, errorMessage: stoppedMessage });
+                    await sendNotificationWithDaemonEvents("run_stopped", `Ralph: Run stopped - ${stoppedMessage}`, {
+                        command: config.notifyCommand,
+                        debug,
+                        daemonConfig: config.daemon,
+                        chatConfig: config.chat,
+                        errorMessage: stoppedMessage,
+                    });
                     break;
                 }
             }
@@ -684,7 +692,13 @@ export async function run(args) {
                     console.error("Please check your CLI configuration and try again.");
                     // Send notification about error
                     const errorMessage = `CLI failed ${consecutiveFailures} times with exit code ${exitCode}. Check configuration.`;
-                    await sendNotificationWithDaemonEvents("error", `Ralph: ${errorMessage}`, { command: config.notifyCommand, debug, daemonConfig: config.daemon, errorMessage });
+                    await sendNotificationWithDaemonEvents("error", `Ralph: ${errorMessage}`, {
+                        command: config.notifyCommand,
+                        debug,
+                        daemonConfig: config.daemon,
+                        chatConfig: config.chat,
+                        errorMessage,
+                    });
                     break;
                 }
                 console.log("Continuing to next iteration...");
@@ -729,6 +743,7 @@ export async function run(args) {
                         command: config.notifyCommand,
                         debug,
                         daemonConfig: config.daemon,
+                        chatConfig: config.chat,
                     });
                     break;
                 }

package/dist/commands/slack.js

@@ -106,12 +106,12 @@ async function createSlackApp(configToken, appName) {
         const response = await fetch("https://slack.com/api/apps.manifest.create", {
             method: "POST",
             headers: {
-                "Authorization": `Bearer ${configToken}`,
+                Authorization: `Bearer ${configToken}`,
                 "Content-Type": "application/json",
             },
             body: JSON.stringify({ manifest: JSON.stringify(manifest) }),
         });
-        const data = await response.json();
+        const data = (await response.json());
         if (!data.ok) {
             console.error(`\nError creating Slack app: ${data.error}`);
             if (data.errors) {

package/dist/config/responder-presets.json

@@ -0,0 +1,69 @@
+{
+  "presets": {
+    "qa": {
+      "name": "Q&A Assistant",
+      "description": "LLM responder optimized for answering questions about the codebase",
+      "type": "llm",
+      "trigger": "@qa",
+      "provider": "anthropic",
+      "systemPrompt": "You are a knowledgeable Q&A assistant for the {{project}} project. Your role is to:\n\n1. Answer questions accurately and concisely about the codebase, its architecture, and functionality\n2. Explain how specific features, components, or modules work\n3. Help developers understand code patterns, conventions, and best practices used in the project\n4. Clarify dependencies, APIs, and integration points\n5. Provide context about why certain design decisions were made\n\nKeep responses focused and practical. If you're unsure about something, say so rather than guessing. Reference specific files, functions, or code sections when helpful.",
+      "timeout": 60000,
+      "maxLength": 2000
+    },
+    "reviewer": {
+      "name": "Code Reviewer",
+      "description": "LLM responder for code review feedback and suggestions",
+      "type": "llm",
+      "trigger": "@review",
+      "provider": "anthropic",
+      "systemPrompt": "You are an expert code reviewer for the {{project}} project. Your role is to:\n\n1. Review code changes, diffs, or code snippets shared with you\n2. Identify potential bugs, security issues, and edge cases\n3. Suggest improvements for readability, maintainability, and performance\n4. Check for adherence to project conventions and best practices\n5. Highlight what's done well alongside areas for improvement\n\nProvide constructive, actionable feedback. Prioritize critical issues over minor style preferences. When suggesting changes, explain the reasoning. Be specific about file locations and line numbers when possible.",
+      "timeout": 90000,
+      "maxLength": 2500
+    },
+    "architect": {
+      "name": "Architecture Advisor",
+      "description": "LLM responder for architecture and design discussions",
+      "type": "llm",
+      "trigger": "@arch",
+      "provider": "anthropic",
+      "systemPrompt": "You are a software architecture advisor for the {{project}} project. Your role is to:\n\n1. Discuss high-level system design and architectural decisions\n2. Evaluate trade-offs between different approaches (scalability, maintainability, performance)\n3. Recommend design patterns and architectural styles appropriate for the use case\n4. Help plan major refactors or new feature implementations\n5. Identify potential technical debt and suggest mitigation strategies\n\nConsider the existing codebase constraints when making recommendations. Provide clear reasoning for architectural choices. Focus on practical, incremental improvements rather than complete rewrites. Draw diagrams in ASCII when helpful.",
+      "timeout": 120000,
+      "maxLength": 3000
+    },
+    "explain": {
+      "name": "Code Explainer",
+      "description": "LLM responder focused on explaining code in detail",
+      "type": "llm",
+      "trigger": "@explain",
+      "provider": "anthropic",
+      "systemPrompt": "You are a code explanation specialist for the {{project}} project. Your role is to:\n\n1. Break down complex code into understandable parts\n2. Explain the purpose and behavior of functions, classes, and modules\n3. Trace data flow and control flow through the codebase\n4. Describe how different components interact with each other\n5. Provide context about the 'why' behind implementation choices\n\nTailor explanations to the apparent experience level of the questioner. Use analogies and examples when helpful. Walk through code step-by-step when explaining algorithms or complex logic. Be thorough but avoid unnecessary jargon.",
+      "timeout": 60000,
+      "maxLength": 2500
+    },
+    "code": {
+      "name": "Code Editor",
+      "description": "Claude Code responder for making file modifications",
+      "type": "claude-code",
+      "trigger": "@code",
+      "timeout": 300000,
+      "maxLength": 2000
+    }
+  },
+  "bundles": {
+    "standard": {
+      "name": "Standard Bundle",
+      "description": "Common responders for development workflow (qa, reviewer, code)",
+      "presets": ["qa", "reviewer", "code"]
+    },
+    "full": {
+      "name": "Full Bundle",
+      "description": "All available responders",
+      "presets": ["qa", "reviewer", "architect", "explain", "code"]
+    },
+    "minimal": {
+      "name": "Minimal Bundle",
+      "description": "Just the essentials (qa, code)",
+      "presets": ["qa", "code"]
+    }
+  }
+}

package/dist/index.js

@@ -6,7 +6,7 @@ import { help } from "./commands/help.js";
 import { init } from "./commands/init.js";
 import { once } from "./commands/once.js";
 import { run } from "./commands/run.js";
-import { prd, prdAdd, prdList, prdStatus, prdToggle, prdClean, parseListArgs } from "./commands/prd.js";
+import { prd, prdAdd, prdList, prdStatus, prdToggle, prdClean, parseListArgs, } from "./commands/prd.js";
 import { docker } from "./commands/docker.js";
 import { prompt } from "./commands/prompt.js";
 import { fixPrd } from "./commands/fix-prd.js";

package/dist/providers/discord.d.ts

@@ -14,7 +14,35 @@ export declare class DiscordChatClient implements ChatClient {
     private client;
     private onCommand;
     private onMessage;
+    private responderMatcher;
+    private respondersConfig;
+    private botUserId;
     constructor(settings: DiscordSettings, debug?: boolean);
+    /**
+     * Initialize responder matching from config.
+     */
+    private initializeResponders;
+    /**
+     * Execute a responder and return the result.
+     */
+    private executeResponder;
+    /**
+     * Handle a message that might match a responder.
+     * Returns true if a responder was matched and executed.
+     */
+    private handleResponderMessage;
+    /**
+     * Check if the bot is mentioned in a message.
+     */
+    private isBotMentioned;
+    /**
+     * Remove bot mention from message text.
+     */
+    private removeBotMention;
+    /**
+     * Check if this is a DM (direct message) channel.
+     */
+    private isDMChannel;
     /**
      * Check if a guild ID is allowed.
      */