ralph-cli-sandboxed 0.4.0 → 0.4.2

package/README.md

@@ -505,6 +505,36 @@ Features:
 
 See [docs/DOCKER.md](docs/DOCKER.md) for detailed Docker configuration, customization, and troubleshooting.
 
+## Chat Integration
+
+Ralph can be controlled via chat platforms (Slack, Telegram, Discord) and includes intelligent chat responders powered by LLMs.
+
+### Chat Commands
+
+Control Ralph remotely via chat:
+- `/ralph run` - Start ralph automation
+- `/ralph status` - Check PRD status
+- `/ralph stop` - Stop running automation
+
+### Chat Responders
+
+Responders handle messages and can answer questions about your codebase:
+
+| Trigger | Type | Description |
+|---------|------|-------------|
+| `@qa` | LLM | Answer questions about the codebase |
+| `@review` | LLM | Review code changes (supports `@review diff`, `@review last`) |
+| `@code` | Claude Code | Make file modifications |
+| `!lint` | CLI | Run custom commands |
+
+**Features:**
+- **Automatic file detection**: Mention file paths (e.g., `src/config.ts:42`) and they're automatically included in context
+- **Git diff keywords**: Use `diff`, `staged`, `last`, `HEAD~N` to include git changes
+- **Multi-turn conversations**: Continue discussions in Slack/Discord threads
+- **Auto-notifications**: Results from `ralph run` are automatically sent to connected chat
+
+See [docs/CHAT-CLIENTS.md](docs/CHAT-CLIENTS.md) for chat platform setup and [docs/CHAT-RESPONDERS.md](docs/CHAT-RESPONDERS.md) for responder configuration.
+
 ## How It Works
 
 1. **Read PRD**: Claude reads your requirements from `prd.json`

package/dist/commands/action.js

@@ -1,7 +1,8 @@
 import { spawn } from "child_process";
 import { existsSync } from "fs";
 import { loadConfig, isRunningInContainer } from "../utils/config.js";
-import { getMessagesPath, sendMessage, waitForResponse, } from "../utils/message-queue.js";
+import { getMessagesPath, sendMessage, waitForResponse } from "../utils/message-queue.js";
+import { getDefaultActions, getBuiltInActionNames } from "../utils/daemon-actions.js";
 /**
  * Execute an action from config.json - works both inside and outside containers.
  *
@@ -46,64 +47,88 @@ export async function action(args) {
         console.error("Failed to load config. Run 'ralph init' first.");
         process.exit(1);
     }
-    // Get available actions from daemon config
-    const daemonActions = config.daemon?.actions || {};
-    const actionNames = Object.keys(daemonActions);
-    // If --list or no action specified, show available actions
-    if (showList || !actionName) {
+    // Get built-in actions and configured actions
+    const builtInActions = getDefaultActions(config);
+    const builtInNames = getBuiltInActionNames(config);
+    const configuredActions = config.daemon?.actions || {};
+    // Merge: configured actions override built-in ones
+    const allActions = { ...builtInActions, ...configuredActions };
+    const actionNames = Object.keys(allActions);
+    // If --list, no action specified, or "help" action, show available actions
+    if (showList || !actionName || actionName === "help") {
         if (actionNames.length === 0) {
-            console.log("No actions configured.");
+            console.log("No actions available.");
             console.log("");
             console.log("Configure actions in .ralph/config.json:");
-            console.log('  {');
+            console.log("  {");
             console.log('    "daemon": {');
             console.log('      "actions": {');
             console.log('        "build": {');
             console.log('          "command": "./scripts/build.sh",');
             console.log('          "description": "Build the project"');
-            console.log('        }');
-            console.log('      }');
-            console.log('    }');
-            console.log('  }');
+            console.log("        }");
+            console.log("      }");
+            console.log("    }");
+            console.log("  }");
         }
         else {
             console.log("Available actions:");
             console.log("");
-            for (const [name, actionConfig] of Object.entries(daemonActions)) {
-                const desc = actionConfig.description || actionConfig.command;
-                console.log(`  ${name.padEnd(20)} ${desc}`);
+            // Show built-in actions first
+            const builtInList = actionNames.filter((name) => builtInNames.has(name) && !configuredActions[name]);
+            const customList = actionNames.filter((name) => !builtInNames.has(name) || configuredActions[name]);
+            for (const name of builtInList) {
+                const action = allActions[name];
+                const desc = action.description || action.command;
+                console.log(`  ${name.padEnd(20)} ${desc} [built-in]`);
+            }
+            for (const name of customList) {
+                const action = allActions[name];
+                const desc = action.description || action.command;
+                // Mark if this is a custom override of a built-in action
+                const overrideMarker = builtInNames.has(name) ? " [override]" : "";
+                console.log(`  ${name.padEnd(20)} ${desc}${overrideMarker}`);
             }
             console.log("");
             console.log("Run an action: ralph action <name> [args...]");
+            console.log("");
+            console.log("Note: Built-in actions require the daemon to be running.");
         }
         return;
     }
     // Validate action exists
-    if (!daemonActions[actionName]) {
+    if (!allActions[actionName]) {
         console.error(`Unknown action: ${actionName}`);
         console.error("");
         if (actionNames.length > 0) {
             console.error(`Available actions: ${actionNames.join(", ")}`);
         }
         else {
-            console.error("No actions configured in .ralph/config.json");
+            console.error("No actions available");
         }
         process.exit(1);
     }
-    const actionConfig = daemonActions[actionName];
+    const actionConfig = allActions[actionName];
+    const isBuiltIn = builtInNames.has(actionName) && !configuredActions[actionName];
     const inContainer = isRunningInContainer();
     if (debug) {
         console.log(`[action] Name: ${actionName}`);
         console.log(`[action] Args: ${actionArgs.join(" ") || "(none)"}`);
         console.log(`[action] Command: ${actionConfig.command}`);
         console.log(`[action] In container: ${inContainer}`);
+        console.log(`[action] Is built-in: ${isBuiltIn}`);
     }
     if (inContainer) {
         // Inside container - use file-based message queue to execute on host
         await executeViaQueue(actionName, actionArgs, debug);
     }
+    else if (isBuiltIn) {
+        // Outside container, built-in action - also use message queue (daemon handles special actions)
+        // Built-in actions like telegram_notify, slack_notify use special markers that only the daemon understands
+        await executeViaQueue(actionName, actionArgs, debug);
+    }
     else {
-        // Outside container - execute directly
+        // Outside container, custom action - execute directly
         await executeDirectly(actionConfig.command, actionArgs, debug);
     }
 }
@@ -162,7 +187,7 @@ async function executeDirectly(command, args, debug) {
         // Build full command with arguments
         let fullCommand = command;
         if (args.length > 0) {
-            fullCommand = `${command} ${args.map(a => `"${a.replace(/"/g, '\\"')}"`).join(" ")}`;
+            fullCommand = `${command} ${args.map((a) => `"${a.replace(/"/g, '\\"')}"`).join(" ")}`;
         }
         if (debug) {
             console.log(`[action] Executing: ${fullCommand}`);
@@ -207,6 +232,7 @@ ralph action - Execute host actions from config.json
 USAGE:
   ralph action [name] [args...]    Execute an action
   ralph action --list              List available actions
+  ralph action help                List available actions
   ralph action --help              Show this help
 
 OPTIONS:
@@ -250,6 +276,7 @@ CONFIGURATION:
 EXAMPLES:
   # List available actions
   ralph action --list
+  ralph action help
   ralph action
 
   # Execute an action

package/dist/commands/chat.d.ts

@@ -1,5 +1,5 @@
 /**
- * Chat command for managing Telegram (and other) chat integrations.
+ * Chat command for managing Telegram, Slack, and other chat integrations.
  * Allows ralph to receive commands and send notifications via chat services.
  */
 /**