vralphy 0.8.0

package/dist/commands/init.js

@@ -0,0 +1,120 @@
+import { createInterface } from 'readline';
+import { initProject } from '../lib/init.js';
+/**
+ * Prompt user for confirmation
+ */
+async function confirm(message) {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            try {
+                rl.close();
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        };
+        rl.question(`${message} [y/N] `, (answer) => {
+            cleanup();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+        rl.on('error', (err) => {
+            cleanup();
+            reject(err);
+        });
+        // Handle SIGINT (Ctrl+C) to cleanup properly
+        const sigintHandler = () => {
+            cleanup();
+            resolve(false);
+        };
+        process.once('SIGINT', sigintHandler);
+        // Remove SIGINT handler after question is answered
+        rl.on('close', () => {
+            process.removeListener('SIGINT', sigintHandler);
+        });
+    });
+}
+/**
+ * Execute init command
+ */
+export async function initCommand(options) {
+    const dir = options.from ?? process.cwd();
+    console.log(`Initializing vralphy in: ${dir}`);
+    // Build init options
+    const initOptions = {
+        noAi: options.noAi,
+        noInject: options.noInject,
+        approve: options.approve,
+        verbose: options.verbose,
+    };
+    // Validate engine if specified
+    if (options.engine) {
+        const validEngines = ['claude', 'opencode', 'codex'];
+        if (!validEngines.includes(options.engine)) {
+            console.error(`Invalid engine: ${options.engine}. Valid options: ${validEngines.join(', ')}`);
+            process.exit(1);
+        }
+        initOptions.engine = options.engine;
+    }
+    try {
+        // If --approve flag is set, we need to handle the approval flow
+        if (options.approve && !options.noAi) {
+            // First run with approve mode - AI generates but we need to confirm
+            const result = await initProject(dir, { ...initOptions, approve: true });
+            if (result.agentsMdContent) {
+                console.log('\n--- Generated AGENTS.md Preview ---\n');
+                console.log(result.agentsMdContent);
+                console.log('\n--- End Preview ---\n');
+                const approved = await confirm('Save this AGENTS.md?');
+                if (!approved) {
+                    console.log('Initialization cancelled.');
+                    process.exit(0);
+                }
+            }
+            // Report results
+            reportResults(result.created, result.skipped, result.injected);
+        }
+        else {
+            // Normal flow (no approval needed)
+            const { created, skipped, injected } = await initProject(dir, initOptions);
+            reportResults(created, skipped, injected);
+        }
+        console.log('\nInitialization complete!');
+        console.log('\nNext steps:');
+        console.log('  1. Review and customize .vralphy/AGENTS.md');
+        console.log('  2. Create specs in specs/ directory');
+        console.log('  3. Run: vralphy plan');
+        console.log('  4. Run: vralphy build');
+    }
+    catch (e) {
+        console.error('Initialization failed:', e);
+        process.exit(1);
+    }
+}
+/**
+ * Report created, skipped, and injected files
+ */
+function reportResults(created, skipped, injected = []) {
+    if (created.length > 0) {
+        console.log('\nCreated:');
+        for (const file of created) {
+            console.log(`  + ${file}`);
+        }
+    }
+    if (injected.length > 0) {
+        console.log('\nInjected vralphy references:');
+        for (const file of injected) {
+            console.log(`  ↪ ${file}`);
+        }
+    }
+    if (skipped.length > 0) {
+        console.log('\nSkipped (already exist):');
+        for (const file of skipped) {
+            console.log(`  - ${file}`);
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/plan.d.ts

@@ -0,0 +1,9 @@
+import { VralphyConfig } from '../lib/config.js';
+export interface PlanOptions {
+    iterations?: number;
+}
+/**
+ * Execute plan mode
+ */
+export declare function planCommand(config: VralphyConfig, options: PlanOptions): Promise<void>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqJ5F"}

package/dist/commands/plan.js

@@ -0,0 +1,147 @@
+import { existsSync } from 'fs';
+import { basename } from 'path';
+import { getEngine } from '../lib/engines/index.js';
+import { CodexEngine } from '../lib/engines/codex.js';
+import { loadPrompt, interpolatePrompt, getDefaultPlanPrompt } from '../lib/prompts.js';
+import { sendSlack, sessionStartMessage, iterationEndMessage, sessionEndMessage, iterationErrorMessage } from '../lib/slack.js';
+import { initEventLogger, logEvent, generateSessionId } from '../lib/events.js';
+/**
+ * Execute plan mode
+ */
+export async function planCommand(config, options) {
+    const engine = getEngine(config.engine);
+    if (!(await engine.isAvailable())) {
+        throw new Error(`Engine '${config.engine}' is not available. Please install it first.`);
+    }
+    // Configure Codex-specific settings if using Codex engine
+    if (config.engine === 'codex' && engine instanceof CodexEngine) {
+        engine.configure({
+            maxAgents: config.codex?.maxAgents,
+            workerTimeout: config.codex?.workerTimeout,
+        });
+    }
+    const maxIterations = options.iterations ?? 0;
+    let iteration = 0;
+    const project = basename(process.cwd());
+    const sessionId = generateSessionId();
+    initEventLogger(sessionId, project);
+    const webhookUrl = config.slackWebhook;
+    const sessionStart = Date.now();
+    console.log(`Starting plan mode with ${config.engine} engine`);
+    console.log(`Planning Model: ${config.planningModel}, Executor Model: ${config.executorModel}`);
+    if (config.engine === 'codex') {
+        console.log(`Max agents: ${config.codex?.maxAgents ?? 8}, Worker timeout: ${config.codex?.workerTimeout ?? 300}s`);
+    }
+    console.log(`Max iterations: ${maxIterations || 'unlimited'}`);
+    // Log and notify session start
+    logEvent({
+        type: 'session.start',
+        command: 'plan',
+        engine: config.engine,
+        planningModel: config.planningModel,
+        executorModel: config.executorModel,
+        maxIterations,
+    });
+    if (webhookUrl) {
+        sendSlack(webhookUrl, sessionStartMessage(project, 'plan', maxIterations, config.engine, config.planningModel));
+    }
+    // Prompt locations in order of preference (engine-specific first)
+    const promptPaths = [
+        `.vralphy/prompts/${config.engine}/plan.md`, // Engine-specific location
+        '.vralphy/prompts/plan.md', // Generic new location
+        'PROMPT_plan.md', // Legacy location (backwards compat)
+    ];
+    let success = true;
+    try {
+        while (true) {
+            if (maxIterations > 0 && iteration >= maxIterations) {
+                console.log(`Reached max iterations (${maxIterations})`);
+                break;
+            }
+            const iterationStart = Date.now();
+            console.log(`\n=== Plan Iteration ${iteration + 1} ===\n`);
+            let prompt;
+            const promptContext = {
+                planningModel: config.planningModel,
+                executorModel: config.executorModel,
+                engine: config.engine,
+                maxAgents: config.codex?.maxAgents,
+                workerTimeout: config.codex?.workerTimeout,
+            };
+            // Find first existing prompt file
+            const existingPromptPath = promptPaths.find(p => existsSync(p));
+            if (existingPromptPath) {
+                prompt = await loadPrompt(existingPromptPath, promptContext);
+            }
+            else {
+                // Use engine-specific default prompt
+                const defaultPrompt = getDefaultPlanPrompt(config.engine);
+                prompt = interpolatePrompt(defaultPrompt, promptContext);
+            }
+            if (config.dryRun) {
+                console.log('--- DRY RUN: Would execute prompt ---');
+                console.log(prompt.slice(0, 500) + '...');
+                console.log('--- END DRY RUN ---');
+                break;
+            }
+            try {
+                // Engine handles output to terminal
+                for await (const chunk of engine.execute(prompt, {
+                    planningModel: config.planningModel,
+                    executorModel: config.executorModel,
+                    headless: true,
+                    skipPermissions: true,
+                    verbose: config.verbose,
+                    reasoningEffort: config.reasoningEffort,
+                })) {
+                    if (chunk.type === 'error') {
+                        console.error('Error:', chunk.error);
+                    }
+                }
+            }
+            catch (e) {
+                const errorMsg = e instanceof Error ? e.message : String(e);
+                console.error('Execution failed:', e);
+                // Log and notify error
+                logEvent({
+                    type: 'iteration.error',
+                    iteration: iteration + 1,
+                    maxIterations,
+                    error: errorMsg,
+                });
+                if (webhookUrl) {
+                    sendSlack(webhookUrl, iterationErrorMessage(project, iteration + 1, maxIterations, errorMsg));
+                }
+                success = false;
+                throw e;
+            }
+            iteration++;
+            // Log and notify iteration end
+            const iterationDuration = Date.now() - iterationStart;
+            logEvent({
+                type: 'iteration.end',
+                iteration,
+                maxIterations,
+                durationMs: iterationDuration,
+            });
+            if (webhookUrl) {
+                sendSlack(webhookUrl, iterationEndMessage(project, iteration, maxIterations, iterationDuration));
+            }
+        }
+    }
+    finally {
+        // Log and notify session end
+        const totalDuration = Date.now() - sessionStart;
+        logEvent({
+            type: 'session.end',
+            success,
+            iterationsCompleted: iteration,
+            durationMs: totalDuration,
+        });
+        if (webhookUrl) {
+            sendSlack(webhookUrl, sessionEndMessage(project, iteration, totalDuration, success));
+        }
+    }
+    console.log(`\nPlanning complete after ${iteration} iteration(s)`);
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/spec.d.ts

@@ -0,0 +1,9 @@
+import { VralphyConfig } from '../lib/config.js';
+export interface SpecOptions {
+    topic?: string;
+}
+/**
+ * Execute spec mode
+ */
+export declare function specCommand(config: VralphyConfig, options: SpecOptions): Promise<void>;
+//# sourceMappingURL=spec.d.ts.map

package/dist/commands/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKjD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG5F"}

package/dist/commands/spec.js

@@ -0,0 +1,111 @@
+import { existsSync } from 'fs';
+import { readdir, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { getEngine } from '../lib/engines/index.js';
+import { loadPrompt, interpolatePrompt, DEFAULT_SPEC_PROMPT } from '../lib/prompts.js';
+import { findProjectRoot } from '../lib/config.js';
+/**
+ * List existing specs
+ */
+async function listSpecs() {
+    const specsDir = 'specs';
+    if (!existsSync(specsDir))
+        return [];
+    const files = await readdir(specsDir);
+    return files.filter((f) => f.endsWith('.md')).map((f) => f.replace('.md', ''));
+}
+/**
+ * Execute spec mode
+ */
+export async function specCommand(config, options) {
+    const engine = getEngine(config.engine);
+    if (!(await engine.isAvailable())) {
+        throw new Error(`Engine '${config.engine}' is not available. Please install it first.`);
+    }
+    if (!options.topic) {
+        const existingSpecs = await listSpecs();
+        if (existingSpecs.length > 0) {
+            console.log('Existing specs:');
+            for (const spec of existingSpecs) {
+                console.log(`  - ${spec}`);
+            }
+            console.log('\nUsage: vralphy spec <topic>');
+        }
+        else {
+            console.log('No specs found. Create one with: vralphy spec <topic>');
+        }
+        return;
+    }
+    const topic = options.topic;
+    const existingSpecs = await listSpecs();
+    console.log(`Starting spec phase for: ${topic}`);
+    console.log(`Engine: ${config.engine}`);
+    if (!engine.supportsInteractive()) {
+        console.log('\nNote: Non-interactive mode (OpenCode engine)');
+        console.log('A template will be generated for manual editing.\n');
+    }
+    const projectRoot = findProjectRoot();
+    const projectName = projectRoot.split('/').pop() ?? 'project';
+    // Prompt locations in order of preference
+    const promptPaths = [
+        '.vralphy/prompts/spec.md', // New location
+        'PROMPT_spec.md', // Legacy location (backwards compat)
+    ];
+    const promptContext = {
+        planningModel: config.planningModel,
+        executorModel: config.executorModel,
+        engine: config.engine,
+        topic,
+        projectName,
+        existingSpecs,
+    };
+    // Find first existing prompt file
+    const existingPromptPath = promptPaths.find(p => existsSync(p));
+    let prompt;
+    if (existingPromptPath) {
+        prompt = await loadPrompt(existingPromptPath, promptContext);
+    }
+    else {
+        prompt = interpolatePrompt(DEFAULT_SPEC_PROMPT, promptContext);
+    }
+    if (config.dryRun) {
+        console.log('--- DRY RUN: Would execute prompt ---');
+        console.log(prompt);
+        console.log('--- END DRY RUN ---');
+        return;
+    }
+    let specContent = '';
+    try {
+        // Engine handles output to terminal, we just capture for saving
+        for await (const chunk of engine.execute(prompt, {
+            planningModel: config.planningModel,
+            executorModel: config.executorModel,
+            headless: false,
+            skipPermissions: false,
+            verbose: config.verbose,
+            reasoningEffort: config.reasoningEffort,
+        })) {
+            if (chunk.type === 'text' && chunk.content) {
+                specContent += chunk.content;
+            }
+            else if (chunk.type === 'error') {
+                console.error('Error:', chunk.error);
+            }
+        }
+    }
+    catch (e) {
+        console.error('Execution failed:', e);
+        throw e;
+    }
+    if (specContent.trim()) {
+        const specsDir = 'specs';
+        if (!existsSync(specsDir)) {
+            const { mkdir } = await import('fs/promises');
+            await mkdir(specsDir, { recursive: true });
+        }
+        const specPath = join(specsDir, `${topic}.md`);
+        await writeFile(specPath, specContent);
+        console.log(`\nSpec saved to: ${specPath}`);
+    }
+}
+//# sourceMappingURL=spec.js.map

package/dist/commands/spec.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}