ralph-cli-sandboxed 0.2.5 → 0.2.6

package/dist/commands/init.js

@@ -14,118 +14,174 @@ const PROMPT_FILE = "prompt.md";
 const PRD_FILE = "prd.json";
 const PROGRESS_FILE = "progress.txt";
 const PRD_GUIDE_FILE = "HOW-TO-WRITE-PRDs.md";
-export async function init(_args) {
+export async function init(args) {
     const cwd = process.cwd();
     const ralphDir = join(cwd, RALPH_DIR);
+    const useDefaults = args.includes("-y") || args.includes("--yes");
     console.log("Initializing ralph in current directory...\n");
     // Check for existing .ralph directory
     if (existsSync(ralphDir)) {
-        const reinit = await promptConfirm(".ralph/ directory already exists. Re-initialize?");
-        if (!reinit) {
-            console.log("Aborted.");
-            return;
+        if (!useDefaults) {
+            const reinit = await promptConfirm(".ralph/ directory already exists. Re-initialize?");
+            if (!reinit) {
+                console.log("Aborted.");
+                return;
+            }
         }
     }
     else {
         mkdirSync(ralphDir, { recursive: true });
         console.log(`Created ${RALPH_DIR}/`);
     }
-    // Step 1: Select CLI provider (first)
     const CLI_PROVIDERS = getCliProviders();
-    const providerKeys = Object.keys(CLI_PROVIDERS);
-    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);
-    const selectedCliProviderKey = providerKeys[selectedProviderIndex];
-    const selectedProvider = CLI_PROVIDERS[selectedCliProviderKey];
+    const LANGUAGES = getLanguages();
+    let selectedCliProviderKey;
     let cliConfig;
-    // Handle custom CLI provider
-    if (selectedCliProviderKey === "custom") {
-        const customCommand = await promptInput("\nEnter your CLI command: ");
-        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 customPromptArgsInput = await promptInput("Enter prompt arguments (e.g., -p for flag-based, leave empty for positional): ");
-        const customPromptArgs = customPromptArgsInput.trim() ? customPromptArgsInput.trim().split(/\s+/) : [];
+    let selectedKey;
+    let selectedTechnologies = [];
+    let checkCommand;
+    let testCommand;
+    if (useDefaults) {
+        // Use defaults: Claude CLI + Node.js
+        selectedCliProviderKey = "claude";
+        const provider = CLI_PROVIDERS[selectedCliProviderKey];
         cliConfig = {
-            command: customCommand || "claude",
-            args: customArgs,
-            yoloArgs: customYoloArgs.length > 0 ? customYoloArgs : undefined,
-            promptArgs: customPromptArgs,
+            command: provider.command,
+            args: provider.defaultArgs,
+            yoloArgs: provider.yoloArgs.length > 0 ? provider.yoloArgs : undefined,
+            promptArgs: provider.promptArgs ?? [],
         };
+        selectedKey = "node";
+        const config = LANGUAGES[selectedKey];
+        checkCommand = config.checkCommand;
+        testCommand = config.testCommand;
+        console.log(`Using defaults: ${CLI_PROVIDERS[selectedCliProviderKey].name} + ${LANGUAGES[selectedKey].name}`);
     }
     else {
-        cliConfig = {
-            command: selectedProvider.command,
-            args: selectedProvider.defaultArgs,
-            yoloArgs: selectedProvider.yoloArgs.length > 0 ? selectedProvider.yoloArgs : undefined,
-            promptArgs: selectedProvider.promptArgs ?? [],
-        };
-    }
-    console.log(`\nSelected CLI provider: ${CLI_PROVIDERS[selectedCliProviderKey].name}`);
-    // Step 2: Select language (second)
-    const LANGUAGES = getLanguages();
-    const languageKeys = Object.keys(LANGUAGES);
-    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);
-    const selectedKey = languageKeys[selectedIndex];
-    const config = LANGUAGES[selectedKey];
-    console.log(`\nSelected language: ${config.name}`);
-    // Step 3: Select technology stack if available (third)
-    let selectedTechnologies = [];
-    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);
-        selectedTechnologies = await promptMultiSelectWithArrows("Select your technology stack (optional):", techOptions);
-        // Convert display names back to just technology names for predefined options
-        selectedTechnologies = selectedTechnologies.map(sel => {
-            const idx = techOptions.indexOf(sel);
-            return idx >= 0 ? techNames[idx] : sel;
-        });
-        if (selectedTechnologies.length > 0) {
-            console.log(`\nSelected technologies: ${selectedTechnologies.join(", ")}`);
+        // 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 selectedProviderName = await promptSelectWithArrows("Select your AI CLI provider:", providerNames);
+        const selectedProviderIndex = providerNames.indexOf(selectedProviderName);
+        selectedCliProviderKey = providerKeys[selectedProviderIndex];
+        const selectedProvider = CLI_PROVIDERS[selectedCliProviderKey];
+        // Handle custom CLI provider
+        if (selectedCliProviderKey === "custom") {
+            const customCommand = await promptInput("\nEnter your CLI command: ");
+            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 customPromptArgsInput = await promptInput("Enter prompt arguments (e.g., -p for flag-based, leave empty for positional): ");
+            const customPromptArgs = customPromptArgsInput.trim() ? customPromptArgsInput.trim().split(/\s+/) : [];
+            cliConfig = {
+                command: customCommand || "claude",
+                args: customArgs,
+                yoloArgs: customYoloArgs.length > 0 ? customYoloArgs : undefined,
+                promptArgs: customPromptArgs,
+            };
         }
         else {
-            console.log("\nNo technologies selected.");
+            cliConfig = {
+                command: selectedProvider.command,
+                args: selectedProvider.defaultArgs,
+                yoloArgs: selectedProvider.yoloArgs.length > 0 ? selectedProvider.yoloArgs : undefined,
+                promptArgs: selectedProvider.promptArgs ?? [],
+            };
+        }
+        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 selectedName = await promptSelectWithArrows("Select your project language/runtime:", languageNames);
+        const selectedIndex = languageNames.indexOf(selectedName);
+        selectedKey = languageKeys[selectedIndex];
+        const config = LANGUAGES[selectedKey];
+        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);
+            selectedTechnologies = await promptMultiSelectWithArrows("Select your technology stack (optional):", techOptions);
+            // Convert display names back to just technology names for predefined options
+            selectedTechnologies = selectedTechnologies.map(sel => {
+                const idx = techOptions.indexOf(sel);
+                return idx >= 0 ? techNames[idx] : sel;
+            });
+            if (selectedTechnologies.length > 0) {
+                console.log(`\nSelected technologies: ${selectedTechnologies.join(", ")}`);
+            }
+            else {
+                console.log("\nNo technologies selected.");
+            }
+        }
+        // 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;
         }
-    }
-    // Allow custom commands for "none" language
-    let checkCommand = config.checkCommand;
-    let testCommand = config.testCommand;
-    if (selectedKey === "none") {
-        checkCommand = await promptInput("\nEnter your type/build check command: ") || checkCommand;
-        testCommand = await promptInput("Enter your test command: ") || testCommand;
     }
     const finalConfig = {
-        ...config,
+        ...LANGUAGES[selectedKey],
         checkCommand,
         testCommand,
     };
     // Generate image name from directory name
     const projectName = basename(cwd).toLowerCase().replace(/[^a-z0-9-]/g, "-");
     const imageName = `ralph-${projectName}`;
-    // Write config file
+    // Write config file with all available options (defaults or empty values)
     const configData = {
+        // Required fields
         language: selectedKey,
         checkCommand: finalConfig.checkCommand,
         testCommand: finalConfig.testCommand,
         imageName,
+        // CLI configuration
         cli: cliConfig,
         cliProvider: selectedCliProviderKey,
+        // Optional fields with defaults/empty values for discoverability
+        notifyCommand: "",
+        technologies: selectedTechnologies.length > 0 ? selectedTechnologies : [],
+        javaVersion: selectedKey === "java" ? 21 : null,
+        // Docker configuration options
+        docker: {
+            ports: [],
+            volumes: [],
+            environment: {},
+            git: {
+                name: "",
+                email: "",
+            },
+            packages: [],
+            buildCommands: {
+                root: [],
+                node: [],
+            },
+            startCommand: "",
+            asciinema: {
+                enabled: false,
+                autoRecord: false,
+                outputDir: ".recordings",
+            },
+            firewall: {
+                allowedDomains: [],
+            },
+        },
+        // Claude-specific configuration (MCP servers and skills)
+        claude: {
+            mcpServers: {},
+            skills: [],
+        },
     };
-    // Add technologies if any were selected
-    if (selectedTechnologies.length > 0) {
-        configData.technologies = selectedTechnologies;
-    }
     const configPath = join(ralphDir, CONFIG_FILE);
     writeFileSync(configPath, JSON.stringify(configData, null, 2) + "\n");
     console.log(`\nCreated ${RALPH_DIR}/${CONFIG_FILE}`);
     // Write prompt file (ask if exists) - uses template with $variables
     const prompt = generatePromptTemplate();
     const promptPath = join(ralphDir, PROMPT_FILE);
-    if (existsSync(promptPath)) {
+    if (existsSync(promptPath) && !useDefaults) {
         const overwritePrompt = await promptConfirm(`${RALPH_DIR}/${PROMPT_FILE} already exists. Overwrite?`);
         if (overwritePrompt) {
             writeFileSync(promptPath, prompt + "\n");
@@ -137,7 +193,7 @@ export async function init(_args) {
     }
     else {
         writeFileSync(promptPath, prompt + "\n");
-        console.log(`Created ${RALPH_DIR}/${PROMPT_FILE}`);
+        console.log(`${existsSync(promptPath) ? "Updated" : "Created"} ${RALPH_DIR}/${PROMPT_FILE}`);
     }
     // Create PRD if not exists
     const prdPath = join(ralphDir, PRD_FILE);

package/dist/config/languages.json

@@ -259,7 +259,7 @@
       "checkCommand": "swift build",
       "testCommand": "swift test",
       "docker": {
-        "install": "# Install Swift toolchain\nRUN apt-get update && apt-get install -y \\\n    binutils \\\n    git \\\n    gnupg2 \\\n    libc6-dev \\\n    libcurl4-openssl-dev \\\n    libedit2 \\\n    libgcc-11-dev \\\n    libpython3-dev \\\n    libsqlite3-0 \\\n    libstdc++-11-dev \\\n    libxml2-dev \\\n    libz3-dev \\\n    pkg-config \\\n    tzdata \\\n    unzip \\\n    zlib1g-dev \\\n    && rm -rf /var/lib/apt/lists/*\nRUN ARCH=$(dpkg --print-architecture) && \\\n    if [ \"$ARCH\" = \"amd64\" ]; then SWIFT_ARCH=\"x86_64\"; else SWIFT_ARCH=\"aarch64\"; fi && \\\n    curl -fsSL https://download.swift.org/swift-5.10-release/ubuntu2204/swift-5.10-RELEASE/swift-5.10-RELEASE-ubuntu22.04-${SWIFT_ARCH}.tar.gz | tar -xz -C /opt\nENV PATH=\"/opt/swift-5.10-RELEASE-ubuntu22.04/usr/bin:$PATH\""
+        "install": "# Install Swift toolchain\nRUN apt-get update && apt-get install -y \\\n    binutils \\\n    git \\\n    gnupg2 \\\n    libc6-dev \\\n    libcurl4-openssl-dev \\\n    libedit2 \\\n    libgcc-11-dev \\\n    libpython3-dev \\\n    libsqlite3-0 \\\n    libstdc++-11-dev \\\n    libxml2-dev \\\n    libz3-dev \\\n    pkg-config \\\n    tzdata \\\n    unzip \\\n    zlib1g-dev \\\n    && rm -rf /var/lib/apt/lists/*\nRUN ARCH=$(dpkg --print-architecture) && \\\n    if [ \"$ARCH\" = \"amd64\" ]; then \\\n        SWIFT_PLATFORM=\"ubuntu2204\"; \\\n        SWIFT_FILE=\"swift-5.10-RELEASE-ubuntu22.04\"; \\\n    else \\\n        SWIFT_PLATFORM=\"ubuntu2204-aarch64\"; \\\n        SWIFT_FILE=\"swift-5.10-RELEASE-ubuntu22.04-aarch64\"; \\\n    fi && \\\n    curl -fsSL https://download.swift.org/swift-5.10-release/${SWIFT_PLATFORM}/swift-5.10-RELEASE/${SWIFT_FILE}.tar.gz | tar -xz -C /opt && \\\n    mv /opt/${SWIFT_FILE} /opt/swift\nENV PATH=\"/opt/swift/usr/bin:$PATH\""
       },
       "technologies": [
         { "name": "Vapor", "description": "Server-side Swift web framework" },

package/dist/utils/config.d.ts

@@ -5,6 +5,22 @@ export interface CliConfig {
     promptArgs?: string[];
     modelArgs?: string[];
 }
+export interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface SkillConfig {
+    name: string;
+    description: string;
+    instructions: string;
+    userInvocable?: boolean;
+}
+export interface AsciinemaConfig {
+    enabled: boolean;
+    autoRecord?: boolean;
+    outputDir?: string;
+}
 export interface RalphConfig {
     language: string;
     checkCommand: string;
@@ -23,6 +39,20 @@ export interface RalphConfig {
             name?: string;
             email?: string;
         };
+        packages?: string[];
+        buildCommands?: {
+            root?: string[];
+            node?: string[];
+        };
+        startCommand?: string;
+        asciinema?: AsciinemaConfig;
+        firewall?: {
+            allowedDomains?: string[];
+        };
+    };
+    claude?: {
+        mcpServers?: Record<string, McpServerConfig>;
+        skills?: SkillConfig[];
     };
 }
 export declare const DEFAULT_CLI_CONFIG: CliConfig;

package/dist/utils/prompt.d.ts

@@ -5,6 +5,6 @@ export declare function createPrompt(): {
 export declare function promptSelectWithArrows(message: string, options: string[]): Promise<string>;
 export declare function promptInput(message: string): Promise<string>;
 export declare function promptSelect(message: string, options: string[]): Promise<string>;
-export declare function promptConfirm(message: string): Promise<boolean>;
+export declare function promptConfirm(message: string, defaultValue?: boolean): Promise<boolean>;
 export declare function promptMultiSelect(message: string, options: string[]): Promise<string[]>;
 export declare function promptMultiSelectWithArrows(message: string, options: string[]): Promise<string[]>;

package/dist/utils/prompt.js

@@ -96,11 +96,17 @@ export async function promptSelect(message, options) {
         console.log("Invalid selection.");
     }
 }
-export async function promptConfirm(message) {
+export async function promptConfirm(message, defaultValue = true) {
     const prompt = createPrompt();
+    const hint = defaultValue ? "(Y/n)" : "(y/N)";
     while (true) {
-        const answer = await prompt.question(`${message} (y/n): `);
+        const answer = await prompt.question(`${message} ${hint}: `);
         const normalized = answer.trim().toLowerCase();
+        // Empty input returns default
+        if (normalized === "") {
+            prompt.close();
+            return defaultValue;
+        }
         if (normalized === "y" || normalized === "yes") {
             prompt.close();
             return true;

package/docs/DEVELOPMENT.md

@@ -0,0 +1,161 @@
+# Development
+
+Guide for contributing to ralph-cli-sandboxed.
+
+## Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/choas/ralph-cli-sandboxed
+cd ralph-cli-sandboxed
+
+# Install dependencies
+npm install
+```
+
+## Development Mode
+
+Run ralph directly from TypeScript source without building:
+
+```bash
+npm run dev -- <args>
+
+# Examples:
+npm run dev -- --version
+npm run dev -- list
+npm run dev -- once
+npm run dev -- help
+```
+
+This uses `tsx` to run TypeScript directly, allowing you to test changes immediately.
+
+## Building
+
+```bash
+# Build for distribution
+npm run build
+
+# This runs:
+# 1. tsc - Compiles TypeScript to dist/
+# 2. Copies config files to dist/config/
+```
+
+## Project Structure
+
+```
+ralph-cli-sandboxed/
+├── src/
+│   ├── index.ts              # CLI entry point
+│   ├── commands/             # Command implementations
+│   │   ├── init.ts           # ralph init
+│   │   ├── run.ts            # ralph run
+│   │   ├── once.ts           # ralph once
+│   │   ├── prd.ts            # PRD management commands
+│   │   ├── docker.ts         # Docker commands
+│   │   ├── prompt.ts         # ralph prompt
+│   │   ├── fix-prd.ts        # ralph fix-prd
+│   │   └── help.ts           # ralph help
+│   ├── utils/
+│   │   ├── config.ts         # Configuration loading
+│   │   ├── prd-validator.ts  # PRD validation and recovery
+│   │   └── prompt.ts         # Interactive prompts
+│   ├── templates/
+│   │   └── prompts.ts        # Prompt template generation
+│   └── config/
+│       ├── languages.json    # Language configurations
+│       └── cli-providers.json # CLI provider configurations
+├── docs/                     # Documentation
+├── dist/                     # Compiled output (generated)
+└── package.json
+```
+
+## Adding a New Language
+
+Edit `src/config/languages.json`:
+
+```json
+{
+  "languages": {
+    "your-language": {
+      "name": "Your Language",
+      "description": "Description here",
+      "checkCommand": "your-check-command",
+      "testCommand": "your-test-command",
+      "docker": {
+        "install": "# Installation commands for Dockerfile"
+      },
+      "technologies": [
+        { "name": "Framework", "description": "Description" }
+      ]
+    }
+  }
+}
+```
+
+## Adding a New CLI Provider
+
+Edit `src/config/cli-providers.json`:
+
+```json
+{
+  "providers": {
+    "your-cli": {
+      "name": "Your CLI",
+      "description": "Description",
+      "command": "cli-command",
+      "defaultArgs": [],
+      "yoloArgs": ["--auto-approve-flag"],
+      "promptArgs": ["--prompt"],
+      "docker": {
+        "install": "# Installation commands"
+      },
+      "envVars": ["YOUR_API_KEY"],
+      "modelArgs": ["--model"]
+    }
+  }
+}
+```
+
+## Testing Changes
+
+Since ralph automates AI agents, testing requires caution:
+
+1. **Use a test project** - Create a sample project to test changes
+2. **Use `ralph once`** - Run single iterations for testing
+3. **Check output** - Review `.ralph/progress.txt` and git commits
+
+## Platform-Specific Dependencies
+
+The `node_modules` folder contains platform-specific binaries. If you switch between environments:
+
+```bash
+# When switching between host and container
+rm -rf node_modules && npm install
+```
+
+Or use a separate volume for container node_modules:
+
+```bash
+docker run -v $(pwd):/workspace -v /workspace/node_modules your-image
+```
+
+## Code Style
+
+- TypeScript with ES2022 target
+- Node.js 18+ required
+- Use async/await for asynchronous operations
+- Keep functions focused and small
+
+## Submitting Changes
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Test thoroughly
+5. Submit a pull request
+
+## Requirements
+
+- Node.js 18+
+- npm
+- Docker (for testing container functionality)