ralph-cli-sandboxed 0.4.0 → 0.4.2

package/dist/commands/docker.js

@@ -2,7 +2,7 @@ import { existsSync, writeFileSync, readFileSync, mkdirSync, chmodSync, openSync
 import { join, basename } from "path";
 import { spawn } from "child_process";
 import { createHash } from "crypto";
-import { loadConfig, getRalphDir } from "../utils/config.js";
+import { loadConfig, getRalphDir, } from "../utils/config.js";
 import { promptConfirm } from "../utils/prompt.js";
 import { getLanguagesJson, getCliProvidersJson } from "../templates/prompts.js";
 // Track background processes for cleanup
@@ -19,11 +19,11 @@ function computeConfigHash(config) {
         claude: config.claude,
     };
     const content = JSON.stringify(relevantConfig, null, 2);
-    return createHash('sha256').update(content).digest('hex').substring(0, 16);
+    return createHash("sha256").update(content).digest("hex").substring(0, 16);
 }
 // Save config hash to docker directory
 function saveConfigHash(dockerDir, hash) {
-    writeFileSync(join(dockerDir, CONFIG_HASH_FILE), hash + '\n');
+    writeFileSync(join(dockerDir, CONFIG_HASH_FILE), hash + "\n");
 }
 // Load saved config hash, returns null if not found
 function loadConfigHash(dockerDir) {
@@ -31,7 +31,7 @@ function loadConfigHash(dockerDir) {
     if (!existsSync(hashPath)) {
         return null;
     }
-    return readFileSync(hashPath, 'utf-8').trim();
+    return readFileSync(hashPath, "utf-8").trim();
 }
 // Check if config has changed since last docker init
 function hasConfigChanged(ralphDir, config) {
@@ -75,30 +75,30 @@ function generateDockerfile(language, javaVersion, cliProvider, dockerConfig) {
     const languageSnippet = getLanguageSnippet(language, javaVersion);
     const cliSnippet = getCliProviderSnippet(cliProvider);
     // Build custom packages section
-    let customPackages = '';
+    let customPackages = "";
     if (dockerConfig?.packages && dockerConfig.packages.length > 0) {
-        customPackages = dockerConfig.packages.map(pkg => `    ${pkg} \\`).join('\n') + '\n';
+        customPackages = dockerConfig.packages.map((pkg) => `    ${pkg} \\`).join("\n") + "\n";
     }
     // Build root build commands section
-    let rootBuildCommands = '';
+    let rootBuildCommands = "";
     if (dockerConfig?.buildCommands?.root && dockerConfig.buildCommands.root.length > 0) {
-        const commands = dockerConfig.buildCommands.root.map(cmd => `RUN ${cmd}`).join('\n');
+        const commands = dockerConfig.buildCommands.root.map((cmd) => `RUN ${cmd}`).join("\n");
         rootBuildCommands = `
 # Custom build commands (root)
 ${commands}
 `;
     }
     // Build node build commands section
-    let nodeBuildCommands = '';
+    let nodeBuildCommands = "";
     if (dockerConfig?.buildCommands?.node && dockerConfig.buildCommands.node.length > 0) {
-        const commands = dockerConfig.buildCommands.node.map(cmd => `RUN ${cmd}`).join('\n');
+        const commands = dockerConfig.buildCommands.node.map((cmd) => `RUN ${cmd}`).join("\n");
         nodeBuildCommands = `
 # Custom build commands (node user)
 ${commands}
 `;
     }
     // Build git config section if configured
-    let gitConfigSection = '';
+    let gitConfigSection = "";
     if (dockerConfig?.git && (dockerConfig.git.name || dockerConfig.git.email)) {
         const gitCommands = [];
         if (dockerConfig.git.name) {
@@ -109,15 +109,15 @@ ${commands}
         }
         gitConfigSection = `
 # Configure git identity
-RUN ${gitCommands.join(' \\\n    && ')}
+RUN ${gitCommands.join(" \\\n    && ")}
 `;
     }
     // Build asciinema installation section if enabled
-    let asciinemaInstall = '';
-    let asciinemaDir = '';
-    let streamScriptCopy = '';
+    let asciinemaInstall = "";
+    let asciinemaDir = "";
+    let streamScriptCopy = "";
     if (dockerConfig?.asciinema?.enabled) {
-        const outputDir = dockerConfig.asciinema.outputDir || '.recordings';
+        const outputDir = dockerConfig.asciinema.outputDir || ".recordings";
         asciinemaInstall = `
 # Install asciinema for terminal recording/streaming
 RUN apt-get update && apt-get install -y asciinema && rm -rf /var/lib/apt/lists/*
@@ -168,6 +168,7 @@ RUN apt-get update && apt-get install -y \\
     ipset \\
     iproute2 \\
     dnsutils \\
+    ripgrep \\
     zsh \\
 ${customPackages}    && rm -rf /var/lib/apt/lists/*
 
@@ -191,14 +192,14 @@ RUN cp -r /root/.oh-my-zsh /home/node/.oh-my-zsh && chown -R node:node /home/nod
     echo 'if [ -z "$RALPH_BANNER_SHOWN" ]; then' >> /home/node/.zshrc && \\
     echo '  export RALPH_BANNER_SHOWN=1' >> /home/node/.zshrc && \\
     echo '  echo ""' >> /home/node/.zshrc && \\
-    echo '  echo " ____      _    _     ____  _   _ "' >> /home/node/.zshrc && \\
-    echo '  echo "|  _ \\\\    / \\\\  | |   |  _ \\\\| | | |"' >> /home/node/.zshrc && \\
-    echo '  echo "| |_) |  / _ \\\\ | |   | |_) | |_| |"' >> /home/node/.zshrc && \\
-    echo '  echo "|  _ <  / ___ \\\\| |___|  __/|  _  |"' >> /home/node/.zshrc && \\
-    echo '  echo "|_| \\\\_\\\\/_/   \\\\_\\\\_____|_|   |_| |_|"' >> /home/node/.zshrc && \\
-    echo '  echo ""' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;2;255;245;157m██████╗  █████╗ ██╗     ██████╗ ██╗  ██╗     ██████╗██╗     ██╗\\033[0m"' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;2;255;238;88m██╔══██╗██╔══██╗██║     ██╔══██╗██║  ██║    ██╔════╝██║     ██║\\033[0m"' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;2;255;235;59m██████╔╝███████║██║     ██████╔╝███████║    ██║     ██║     ██║  sandboxed\\033[0m"' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;2;253;216;53m██╔══██╗██╔══██║██║     ██╔═══╝ ██╔══██║    ██║     ██║     ██║\\033[0m"' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;2;251;192;45m██║  ██║██║  ██║███████╗██║     ██║  ██║    ╚██████╗███████╗██║\\033[0m"' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;2;249;168;37m╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝     ╚═╝  ╚═╝     ╚═════╝╚══════╝╚═╝\\033[0m"' >> /home/node/.zshrc && \\
     echo '  RALPH_VERSION=$(ralph --version 2>/dev/null | head -1 || echo "unknown")' >> /home/node/.zshrc && \\
-    echo '  echo "CLI - Version $RALPH_VERSION"' >> /home/node/.zshrc && \\
+    echo '  echo "\\033[38;5;248mv$RALPH_VERSION\\033[0m"' >> /home/node/.zshrc && \\
     echo '  echo ""' >> /home/node/.zshrc && \\
     echo 'fi' >> /home/node/.zshrc
 
@@ -241,9 +242,9 @@ CMD ["zsh"]
 }
 function generateFirewallScript(customDomains = []) {
     // Generate custom domains section if any are configured
-    let customDomainsSection = '';
+    let customDomainsSection = "";
     if (customDomains.length > 0) {
-        const domainList = customDomains.join(' ');
+        const domainList = customDomains.join(" ");
         customDomainsSection = `
 # Custom allowed domains (from config)
 for ip in $(dig +short ${domainList}); do
@@ -253,8 +254,8 @@ done
     }
     // Generate echo line with custom domains if configured
     const allowedList = customDomains.length > 0
-        ? `GitHub, npm, Anthropic API, local network, ${customDomains.join(', ')}`
-        : 'GitHub, npm, Anthropic API, local network';
+        ? `GitHub, npm, Anthropic API, local network, ${customDomains.join(", ")}`
+        : "GitHub, npm, Anthropic API, local network";
     return `#!/bin/bash
 # Firewall initialization script for Ralph sandbox
 # Based on Claude Code devcontainer firewall
@@ -337,26 +338,26 @@ echo "Allowed: ${allowedList}"
 }
 function generateDockerCompose(imageName, dockerConfig) {
     // Build ports section if configured
-    let portsSection = '';
+    let portsSection = "";
     if (dockerConfig?.ports && dockerConfig.ports.length > 0) {
-        const portLines = dockerConfig.ports.map(port => `      - "${port}"`).join('\n');
+        const portLines = dockerConfig.ports.map((port) => `      - "${port}"`).join("\n");
         portsSection = `    ports:\n${portLines}\n`;
     }
     // Build volumes array: base volumes + custom volumes
     const baseVolumes = [
-        '      # Mount project root (two levels up from .ralph/docker/)',
-        '      - ../..:/workspace',
+        "      # Mount project root (two levels up from .ralph/docker/)",
+        "      - ../..:/workspace",
         "      # Mount host's ~/.claude for Pro/Max OAuth credentials",
-        '      - ${HOME}/.claude:/home/node/.claude',
+        "      - ${HOME}/.claude:/home/node/.claude",
         `      - ${imageName}-history:/commandhistory`,
     ];
     if (dockerConfig?.volumes && dockerConfig.volumes.length > 0) {
-        const customVolumeLines = dockerConfig.volumes.map(vol => `      - ${vol}`);
+        const customVolumeLines = dockerConfig.volumes.map((vol) => `      - ${vol}`);
         baseVolumes.push(...customVolumeLines);
     }
-    const volumesSection = baseVolumes.join('\n');
+    const volumesSection = baseVolumes.join("\n");
     // Build environment section if configured
-    let environmentSection = '';
+    let environmentSection = "";
     const envEntries = [];
     // Add user-configured environment variables
     if (dockerConfig?.environment && Object.keys(dockerConfig.environment).length > 0) {
@@ -365,7 +366,7 @@ function generateDockerCompose(imageName, dockerConfig) {
         }
     }
     if (envEntries.length > 0) {
-        environmentSection = `    environment:\n${envEntries.join('\n')}\n`;
+        environmentSection = `    environment:\n${envEntries.join("\n")}\n`;
     }
     else {
         // Keep the commented placeholder for users who don't have config
@@ -374,12 +375,12 @@ function generateDockerCompose(imageName, dockerConfig) {
     #   - ANTHROPIC_API_KEY=\${ANTHROPIC_API_KEY}\n`;
     }
     // Build command section if configured
-    let commandSection = '';
-    let streamJsonNote = '';
+    let commandSection = "";
+    let streamJsonNote = "";
     if (dockerConfig?.asciinema?.enabled && dockerConfig?.asciinema?.autoRecord) {
         // Wrap with asciinema recording
-        const outputDir = dockerConfig.asciinema.outputDir || '.recordings';
-        const innerCommand = dockerConfig.startCommand || 'zsh';
+        const outputDir = dockerConfig.asciinema.outputDir || ".recordings";
+        const innerCommand = dockerConfig.startCommand || "zsh";
         commandSection = `    command: bash -c "mkdir -p /workspace/${outputDir} && asciinema rec -c '${innerCommand}' /workspace/${outputDir}/session-$$(date +%Y%m%d-%H%M%S).cast"\n`;
         // Add note about stream-json if enabled
         if (dockerConfig.asciinema.streamJson?.enabled) {
@@ -401,14 +402,14 @@ function generateDockerCompose(imageName, dockerConfig) {
     }
     // Build restart policy section
     // Priority: restartCount (on-failure with max retries) > autoStart (unless-stopped)
-    let restartSection = '';
+    let restartSection = "";
     if (dockerConfig?.restartCount !== undefined && dockerConfig.restartCount > 0) {
         // Use on-failure policy with max retry count
         restartSection = `    restart: on-failure:${dockerConfig.restartCount}\n`;
     }
     else if (dockerConfig?.autoStart) {
         // Use unless-stopped for auto-restart on daemon start
-        restartSection = '    restart: unless-stopped\n';
+        restartSection = "    restart: unless-stopped\n";
     }
     return `# Ralph CLI Docker Compose
 # Generated by ralph-cli
@@ -439,10 +440,12 @@ dist
 `;
 // Generate stream wrapper script for clean asciinema recordings
 function generateStreamScript(outputDir, saveRawJson) {
-    const saveJsonSection = saveRawJson ? `
+    const saveJsonSection = saveRawJson
+        ? `
 # Save raw JSON for later analysis
 JSON_LOG="$OUTPUT_DIR/session-$TIMESTAMP.jsonl"
-TEE_CMD="tee \\"$JSON_LOG\\""` : `
+TEE_CMD="tee \\"$JSON_LOG\\""`
+        : `
 TEE_CMD="cat"`;
     return `#!/bin/bash
 # Ralph stream wrapper - formats Claude stream-json output for clean terminal display
@@ -519,12 +522,12 @@ function generateMcpJson(mcpServers) {
 }
 // Generate skill file content with YAML frontmatter
 function generateSkillFile(skill) {
-    const lines = ['---', `description: ${skill.description}`];
+    const lines = ["---", `description: ${skill.description}`];
     if (skill.userInvocable === false) {
-        lines.push('user-invocable: false');
+        lines.push("user-invocable: false");
     }
-    lines.push('---', '', skill.instructions, '');
-    return lines.join('\n');
+    lines.push("---", "", skill.instructions, "");
+    return lines.join("\n");
 }
 async function generateFiles(ralphDir, language, imageName, force = false, javaVersion, cliProvider, dockerConfig, claudeConfig) {
     const dockerDir = join(ralphDir, DOCKER_DIR);
@@ -535,14 +538,17 @@ async function generateFiles(ralphDir, language, imageName, force = false, javaV
     }
     const customDomains = dockerConfig?.firewall?.allowedDomains || [];
     const files = [
-        { name: "Dockerfile", content: generateDockerfile(language, javaVersion, cliProvider, dockerConfig) },
+        {
+            name: "Dockerfile",
+            content: generateDockerfile(language, javaVersion, cliProvider, dockerConfig),
+        },
         { name: "init-firewall.sh", content: generateFirewallScript(customDomains) },
         { name: "docker-compose.yml", content: generateDockerCompose(imageName, dockerConfig) },
         { name: ".dockerignore", content: DOCKERIGNORE },
     ];
     // Add stream script if streamJson is enabled
     if (dockerConfig?.asciinema?.enabled && dockerConfig.asciinema.streamJson?.enabled) {
-        const outputDir = dockerConfig.asciinema.outputDir || '.recordings';
+        const outputDir = dockerConfig.asciinema.outputDir || ".recordings";
         const saveRawJson = dockerConfig.asciinema.streamJson.saveRawJson !== false; // default true
         files.push({ name: "ralph-stream.sh", content: generateStreamScript(outputDir, saveRawJson) });
     }
@@ -565,28 +571,28 @@ async function generateFiles(ralphDir, language, imageName, force = false, javaV
     const projectRoot = process.cwd();
     // Generate .mcp.json if MCP servers are configured
     if (claudeConfig?.mcpServers && Object.keys(claudeConfig.mcpServers).length > 0) {
-        const mcpJsonPath = join(projectRoot, '.mcp.json');
+        const mcpJsonPath = join(projectRoot, ".mcp.json");
         if (existsSync(mcpJsonPath) && !force) {
-            const overwrite = await promptConfirm('.mcp.json already exists. Overwrite?');
+            const overwrite = await promptConfirm(".mcp.json already exists. Overwrite?");
             if (!overwrite) {
-                console.log('Skipped .mcp.json');
+                console.log("Skipped .mcp.json");
             }
             else {
                 writeFileSync(mcpJsonPath, generateMcpJson(claudeConfig.mcpServers));
-                console.log('Created .mcp.json');
+                console.log("Created .mcp.json");
             }
         }
         else {
             writeFileSync(mcpJsonPath, generateMcpJson(claudeConfig.mcpServers));
-            console.log('Created .mcp.json');
+            console.log("Created .mcp.json");
         }
     }
     // Generate skill files if skills are configured
     if (claudeConfig?.skills && claudeConfig.skills.length > 0) {
-        const commandsDir = join(projectRoot, '.claude', 'commands');
+        const commandsDir = join(projectRoot, ".claude", "commands");
         if (!existsSync(commandsDir)) {
             mkdirSync(commandsDir, { recursive: true });
-            console.log('Created .claude/commands/');
+            console.log("Created .claude/commands/");
         }
         for (const skill of claudeConfig.skills) {
             const skillPath = join(commandsDir, `${skill.name}.md`);
@@ -604,8 +610,8 @@ async function generateFiles(ralphDir, language, imageName, force = false, javaV
     // Save config hash for change detection
     const configForHash = {
         language,
-        checkCommand: '',
-        testCommand: '',
+        checkCommand: "",
+        testCommand: "",
         javaVersion,
         cliProvider,
         docker: dockerConfig,
@@ -626,12 +632,18 @@ async function buildImage(ralphDir) {
     if (hasConfigChanged(ralphDir, config)) {
         const regenerate = await promptConfirm("Config has changed since last docker init. Regenerate Docker files?");
         if (regenerate) {
-            await generateFiles(ralphDir, config.language, config.imageName || `ralph-${basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-")}`, true, config.javaVersion, config.cliProvider, config.docker, config.claude);
+            await generateFiles(ralphDir, config.language, config.imageName ||
+                `ralph-${basename(process.cwd())
+                    .toLowerCase()
+                    .replace(/[^a-z0-9-]/g, "-")}`, true, config.javaVersion, config.cliProvider, config.docker, config.claude);
             console.log("");
         }
     }
     console.log("Building Docker image...\n");
-    const imageName = config.imageName || `ralph-${basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-")}`;
+    const imageName = config.imageName ||
+        `ralph-${basename(process.cwd())
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "-")}`;
     return new Promise((resolve, reject) => {
         // Use --no-cache and --pull to ensure we always get the latest CLI versions
         // Use -p to set unique project name per ralph project
@@ -717,8 +729,7 @@ function startBackgroundServices(config) {
         services.push("daemon");
     }
     // Start chat if telegram is configured and not explicitly disabled
-    const telegramEnabled = config.chat?.telegram?.botToken &&
-        config.chat.telegram.enabled !== false;
+    const telegramEnabled = config.chat?.telegram?.botToken && config.chat.telegram.enabled !== false;
     if (telegramEnabled) {
         const logPath = join(ralphDir, "chat.log");
         const logFd = openSync(logPath, "w");
@@ -759,8 +770,8 @@ async function runContainer(ralphDir, imageName, language, javaVersion, cliProvi
     if (dockerfileExists) {
         const configForHash = {
             language,
-            checkCommand: '',
-            testCommand: '',
+            checkCommand: "",
+            testCommand: "",
             javaVersion,
             cliProvider,
             docker: dockerConfig,
@@ -876,7 +887,18 @@ async function cleanImage(imageName, ralphDir) {
         // Remove containers, volumes, networks, and local images
         // Use -p to target only this project's resources
         await new Promise((resolve) => {
-            const proc = spawn("docker", ["compose", "-p", imageName, "down", "--rmi", "local", "-v", "--remove-orphans", "--timeout", "5"], {
+            const proc = spawn("docker", [
+                "compose",
+                "-p",
+                imageName,
+                "down",
+                "--rmi",
+                "local",
+                "-v",
+                "--remove-orphans",
+                "--timeout",
+                "5",
+            ], {
                 cwd: dockerDir,
                 stdio: "inherit",
             });
@@ -903,7 +925,10 @@ async function cleanImage(imageName, ralphDir) {
             output += data.toString();
         });
         proc.on("close", async () => {
-            const containerIds = output.trim().split("\n").filter((id) => id.length > 0);
+            const containerIds = output
+                .trim()
+                .split("\n")
+                .filter((id) => id.length > 0);
             if (containerIds.length > 0) {
                 // Force remove these containers
                 await new Promise((innerResolve) => {
@@ -943,7 +968,10 @@ async function cleanImage(imageName, ralphDir) {
             output += data.toString();
         });
         proc.on("close", async () => {
-            const volumeNames = output.trim().split("\n").filter((name) => name.length > 0);
+            const volumeNames = output
+                .trim()
+                .split("\n")
+                .filter((name) => name.length > 0);
             if (volumeNames.length > 0) {
                 // Force remove these volumes
                 await new Promise((innerResolve) => {
@@ -984,7 +1012,10 @@ async function cleanImage(imageName, ralphDir) {
             output += data.toString();
         });
         proc.on("close", async () => {
-            const podIds = output.trim().split("\n").filter((id) => id.length > 0);
+            const podIds = output
+                .trim()
+                .split("\n")
+                .filter((id) => id.length > 0);
             if (podIds.length > 0) {
                 // Force remove these pods (this also removes their containers)
                 await new Promise((innerResolve) => {
@@ -1025,7 +1056,10 @@ async function cleanImage(imageName, ralphDir) {
 export async function dockerInit(silent = false) {
     const config = loadConfig();
     const ralphDir = getRalphDir();
-    const imageName = config.imageName ?? `ralph-${basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-")}`;
+    const imageName = config.imageName ??
+        `ralph-${basename(process.cwd())
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "-")}`;
     console.log(`\nGenerating Docker files for: ${config.language}`);
     if ((config.language === "java" || config.language === "kotlin") && config.javaVersion) {
         console.log(`Java version: ${config.javaVersion}`);
@@ -1111,7 +1145,10 @@ INSTALLING PACKAGES (works with Docker & Podman):
     }
     const config = loadConfig();
     // Get image name from config or generate default
-    const imageName = config.imageName || `ralph-${basename(process.cwd()).toLowerCase().replace(/[^a-z0-9-]/g, "-")}`;
+    const imageName = config.imageName ||
+        `ralph-${basename(process.cwd())
+            .toLowerCase()
+            .replace(/[^a-z0-9-]/g, "-")}`;
     const hasFlag = (flag) => subArgs.includes(flag);
     switch (subcommand) {
         case "build":
@@ -1133,8 +1170,8 @@ INSTALLING PACKAGES (works with Docker & Podman):
         default: {
             // Default to init if no subcommand or unrecognized subcommand
             const force = subcommand === "init"
-                ? (subArgs[0] === "-y" || subArgs[0] === "--yes")
-                : (subcommand === "-y" || subcommand === "--yes");
+                ? subArgs[0] === "-y" || subArgs[0] === "--yes"
+                : subcommand === "-y" || subcommand === "--yes";
             console.log(`Generating Docker files for: ${config.language}`);
             if ((config.language === "java" || config.language === "kotlin") && config.javaVersion) {
                 console.log(`Java version: ${config.javaVersion}`);

package/dist/commands/fix-config.js

@@ -206,7 +206,8 @@ function recoverSections(corruptContent, parsedPartial) {
             source = "parsed";
         }
         // If not found or invalid, try regex extraction for simple string fields
-        if ((value === undefined || !validateSection(section, value)) && typeof corruptContent === "string") {
+        if ((value === undefined || !validateSection(section, value)) &&
+            typeof corruptContent === "string") {
             const extracted = extractSectionFromCorrupt(corruptContent, section);
             if (extracted !== undefined && validateSection(section, extracted)) {
                 value = extracted;

package/dist/commands/fix-prd.js

@@ -31,7 +31,7 @@ function restoreFromBackup(prdPath, backupPath) {
         const validation = validatePrd(backupParsed);
         if (!validation.valid) {
             console.error("Error: Backup file contains invalid PRD structure:");
-            validation.errors.slice(0, 3).forEach(err => {
+            validation.errors.slice(0, 3).forEach((err) => {
                 console.error(`  - ${err}`);
             });
             return false;
@@ -138,7 +138,7 @@ export async function fixPrd(args = []) {
     }
     // PRD is invalid
     console.log("\x1b[31m✗ PRD structure is invalid:\x1b[0m");
-    validation.errors.slice(0, 5).forEach(err => {
+    validation.errors.slice(0, 5).forEach((err) => {
         console.log(`  - ${err}`);
     });
     if (validation.errors.length > 5) {

package/dist/commands/help.js

@@ -21,6 +21,7 @@ COMMANDS:
   notify [msg]      Send notification to host from sandbox
   action [name]     Execute host actions from config.json
   chat <sub>        Chat client integration (Telegram, etc.)
+  slack <sub>       Slack app setup and management
   help              Show this help message
 
   prd <subcommand>  (Alias) Manage PRD entries - same as add/list/status/toggle/clean
@@ -75,6 +76,11 @@ CHAT SUBCOMMANDS:
   chat test [id]    Test connection by sending a message
   chat help         Show chat help message
 
+SLACK SUBCOMMANDS:
+  slack setup       Create a new Slack app for this Ralph instance
+  slack status      Show current Slack configuration
+  slack help        Show slack help message
+
 NOTIFY OPTIONS:
   [message]              Message to send as notification
   --action, -a <name>    Execute specific daemon action (default: notify)
@@ -118,6 +124,7 @@ EXAMPLES:
   ralph notify "Task done!"  # Send notification from sandbox to host
   ralph chat start           # Start Telegram chat daemon
   ralph chat test 123456     # Test chat connection
+  ralph slack setup          # Create new Slack app for this project
   ralph action --list        # List available host actions
   ralph action build         # Execute 'build' action on host
 
@@ -173,7 +180,13 @@ DAEMON CONFIGURATION:
   3. From sandbox, notify:  ralph notify "Task complete!"
 
 CHAT CONFIGURATION:
-  Enable Telegram chat integration to control ralph from your phone:
+  Enable chat integration to control ralph remotely (Telegram, Slack, Discord).
+
+  For Slack (recommended for teams):
+    ralph slack setup          # Interactive wizard creates your Slack app
+    ralph chat start           # Start the chat daemon
+
+  For Telegram:
   {
     "chat": {
       "enabled": true,
@@ -185,11 +198,14 @@ CHAT CONFIGURATION:
     }
   }
 
-  Setup:
+  Telegram Setup:
   1. Create bot with @BotFather on Telegram
   2. Add bot token to config.json
   3. Start chat daemon: ralph chat start
-  4. Send commands to your bot: abc run, abc status, abc add <task>
+  4. Send commands to your bot: /run, /status, /add <task>
+
+  Important: Each Ralph instance needs its own Slack app.
+  Run 'ralph slack setup' in each project directory.
 `;
 export function help(_args) {
     console.log(HELP_TEXT.trim());