@kynetic-ai/spec 0.1.0

package/dist/cli/commands/ralph.js

@@ -0,0 +1,465 @@
+/**
+ * Ralph command - automated task loop via ACP.
+ *
+ * Runs an ACP-compliant agent in a loop to process tasks autonomously.
+ * Uses session event storage for full audit trail and streaming output.
+ */
+import chalk from 'chalk';
+import { ulid } from 'ulid';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { spawn, spawnSync } from 'node:child_process';
+import { initContext } from '../../parser/index.js';
+import { error, info, success } from '../output.js';
+import { gatherSessionContext } from './session.js';
+import { resolveAdapter, registerAdapter } from '../../agents/index.js';
+import { spawnAndInitialize } from '../../agents/spawner.js';
+import { createSession, updateSessionStatus, appendEvent, saveSessionContext, } from '../../sessions/index.js';
+import { createTranslator, createCliRenderer } from '../../ralph/index.js';
+import { errors } from '../../strings/index.js';
+import { EXIT_CODES } from '../exit-codes.js';
+// ─── Prompt Template ─────────────────────────────────────────────────────────
+function buildPrompt(sessionCtx, iteration, maxLoops, focus) {
+    const isFinal = iteration === maxLoops;
+    const focusSection = focus ? `
+## Session Focus (applies to ALL iterations)
+
+> **${focus}**
+
+Keep this focus in mind throughout your work. It takes priority over default task selection.
+` : '';
+    return `# Kspec Automation Session
+
+You are running as part of a kspec automation loop. This is iteration ${iteration} of ${maxLoops}.
+${focusSection}
+
+## Current State
+\`\`\`json
+${JSON.stringify(sessionCtx, null, 2)}
+\`\`\`
+
+## Working Procedure
+
+1. **Pick a task**: Review ready_tasks above. Pick the highest priority task (lowest number = higher priority). If there's an active (in_progress) task, continue that instead.
+
+2. **Start the task** (if not already in_progress):
+   \`\`\`bash
+   kspec task start @task-ref
+   \`\`\`
+
+3. **Do the work**:
+   - Read relevant files to understand the task
+   - Make changes as needed
+   - Run tests if applicable
+   - Document as you go with task notes
+
+4. **Document progress**:
+   \`\`\`bash
+   kspec task note @task-ref "What you did, decisions made, etc."
+   \`\`\`
+
+5. **Submit or checkpoint**:
+   - If code is DONE (ready for PR):
+     \`\`\`bash
+     kspec task submit @task-ref
+     \`\`\`
+   - If task is NOT done (WIP):
+     \`\`\`bash
+     kspec task note @task-ref "WIP: What's done, what remains..."
+     \`\`\`
+
+6. **Commit your work**:
+   \`\`\`bash
+   git add -A && git commit -m "feat/fix/chore: description
+
+   Task: @task-ref"
+   \`\`\`
+
+7. **Reflect on this iteration**:
+   Think about what you learned, any friction points, or patterns worth remembering.
+
+   For **systemic patterns** (friction or success worth documenting):
+   \`\`\`bash
+   kspec meta observe friction "Description of systemic issue..."
+   kspec meta observe success "Pattern worth replicating..."
+   \`\`\`
+
+   For **actionable improvements** (specific ideas that could become tasks):
+   \`\`\`bash
+   kspec inbox add "Improvement idea..." --tag reflection
+   \`\`\`
+
+## Important Notes
+- Stay focused on ONE task per iteration
+- The loop continues automatically - don't worry about picking the next task
+- kspec tracks state across iterations via task status and notes
+- Always commit before the iteration ends
+- Always reflect and capture at least one observation
+${isFinal ? `
+## FINAL ITERATION
+This is the last iteration of the loop. After completing your work:
+1. Commit any remaining changes
+2. Reflect on the overall session
+3. Capture any final insights as observations
+` : ''}`;
+}
+// ─── Streaming Output ────────────────────────────────────────────────────────
+// Translator and renderer are created per-session in the action handler.
+// This allows the architecture to be reused by future TUI renderers.
+// ─── Adapter Validation ──────────────────────────────────────────────────────
+// AC: @ralph-adapter-validation valid-adapter-proceeds, invalid-adapter-error, validation-before-spawn
+/**
+ * Validate that the specified ACP adapter package exists.
+ * Uses npx --no-install to check both global and local node_modules.
+ *
+ * @throws {Error} Never throws - exits process with code 3 if validation fails
+ */
+function validateAdapter(adapterPackage) {
+    // Use npx --no-install with --version to check if package exists
+    // This checks both global and local node_modules, handles scoped packages
+    const result = spawnSync('npx', ['--no-install', adapterPackage, '--version'], {
+        encoding: 'utf-8',
+        stdio: 'pipe',
+    });
+    if (result.status !== 0) {
+        error(`Adapter package not found: ${adapterPackage}. Install with: npm install -g ${adapterPackage}`);
+        process.exit(EXIT_CODES.NOT_FOUND);
+    }
+}
+// ─── Tool Request Handler ────────────────────────────────────────────────────
+/**
+ * Handle tool requests from ACP agent.
+ * Implements file operations, terminal commands, and permission handling.
+ */
+async function handleRequest(client, id, method, params, yolo) {
+    const p = params;
+    try {
+        switch (method) {
+            case 'session/request_permission': {
+                // In yolo mode, auto-approve all permissions
+                // In normal mode, would need to implement permission UI
+                const options = p.options || [];
+                if (yolo) {
+                    // Find an "allow" option (prefer allow_always, then allow_once)
+                    const allowOption = options.find(o => o.kind === 'allow_always')
+                        || options.find(o => o.kind === 'allow_once');
+                    if (allowOption) {
+                        client.respondPermission(id, {
+                            outcome: { outcome: 'selected', optionId: allowOption.optionId },
+                        });
+                    }
+                    else {
+                        // No allow option available - cancel
+                        client.respondPermission(id, { outcome: { outcome: 'cancelled' } });
+                    }
+                }
+                else {
+                    // TODO: Implement permission prompting
+                    client.respondPermission(id, { outcome: { outcome: 'cancelled' } });
+                }
+                break;
+            }
+            case 'file/read': {
+                const filePath = p.path;
+                const content = await fs.readFile(filePath, 'utf-8');
+                client.respond(id, { content });
+                break;
+            }
+            case 'file/write': {
+                const filePath = p.path;
+                const content = p.content;
+                await fs.mkdir(path.dirname(filePath), { recursive: true });
+                await fs.writeFile(filePath, content, 'utf-8');
+                client.respond(id, {});
+                break;
+            }
+            case 'terminal/run': {
+                const command = p.command;
+                const cwd = p.cwd || process.cwd();
+                const timeout = p.timeout || 60000;
+                const result = await new Promise((resolve) => {
+                    const child = spawn(command, [], {
+                        cwd,
+                        shell: true,
+                        timeout,
+                    });
+                    let stdout = '';
+                    let stderr = '';
+                    child.stdout?.on('data', (data) => {
+                        stdout += data.toString();
+                    });
+                    child.stderr?.on('data', (data) => {
+                        stderr += data.toString();
+                    });
+                    child.on('close', (code) => {
+                        resolve({ stdout, stderr, exitCode: code ?? 1 });
+                    });
+                    child.on('error', (err) => {
+                        resolve({ stdout, stderr: err.message, exitCode: 1 });
+                    });
+                });
+                client.respond(id, result);
+                break;
+            }
+            default:
+                // Unknown method - return error
+                client.respondError(id, -32601, `Method not found: ${method}`);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        client.respondError(id, -32000, message);
+    }
+}
+// ─── Command Registration ────────────────────────────────────────────────────
+export function registerRalphCommand(program) {
+    program
+        .command('ralph')
+        .description('Run ACP agent in a loop to process ready tasks')
+        .option('--max-loops <n>', 'Maximum iterations', '5')
+        .option('--max-retries <n>', 'Max retries per iteration on error', '3')
+        .option('--max-failures <n>', 'Max consecutive failed iterations before exit', '3')
+        .option('--dry-run', 'Show prompt without executing')
+        .option('--yolo', 'Use dangerously-skip-permissions (default)', true)
+        .option('--no-yolo', 'Require normal permission prompts')
+        .option('--adapter <id>', 'Agent adapter to use', 'claude-code-acp')
+        .option('--adapter-cmd <cmd>', 'Custom adapter command (for testing)')
+        .option('--focus <instructions>', 'Focus instructions included in every iteration prompt')
+        .action(async (options) => {
+        try {
+            const maxLoops = parseInt(options.maxLoops, 10);
+            const maxRetries = parseInt(options.maxRetries, 10);
+            const maxFailures = parseInt(options.maxFailures, 10);
+            if (isNaN(maxLoops) || maxLoops < 1) {
+                error(errors.usage.maxLoopsPositive);
+                process.exit(EXIT_CODES.ERROR);
+            }
+            if (isNaN(maxRetries) || maxRetries < 0) {
+                error(errors.usage.maxRetriesNonNegative);
+                process.exit(EXIT_CODES.ERROR);
+            }
+            if (isNaN(maxFailures) || maxFailures < 1) {
+                error(errors.usage.maxFailuresPositive);
+                process.exit(EXIT_CODES.ERROR);
+            }
+            // Handle custom adapter command for testing
+            if (options.adapterCmd) {
+                const parts = options.adapterCmd.split(/\s+/);
+                const customAdapter = {
+                    command: parts[0],
+                    args: parts.slice(1),
+                    description: 'Custom adapter via --adapter-cmd',
+                };
+                registerAdapter('custom', customAdapter);
+                options.adapter = 'custom';
+            }
+            // Resolve adapter
+            const adapter = resolveAdapter(options.adapter);
+            // Validate adapter package exists before proceeding
+            // Skip validation for custom adapters (--adapter-cmd) and non-npx adapters
+            if (!options.adapterCmd && adapter.command === 'npx' && adapter.args[0]) {
+                validateAdapter(adapter.args[0]);
+            }
+            // Add yolo flag to adapter args if needed
+            if (options.yolo && options.adapter === 'claude-code-acp') {
+                adapter.args = [...adapter.args, '--dangerously-skip-permissions'];
+            }
+            info(`Starting ralph loop (adapter=${options.adapter}, max ${maxLoops} iterations, ${maxRetries} retries, ${maxFailures} max failures)`);
+            if (options.focus) {
+                info(`Focus: ${options.focus}`);
+            }
+            // Initialize kspec context
+            const ctx = await initContext();
+            const specDir = ctx.specDir;
+            // Create session for event tracking
+            const sessionId = ulid();
+            await createSession(specDir, {
+                id: sessionId,
+                agent_type: options.adapter,
+                task_id: undefined, // Will be determined per iteration
+            });
+            // Log session start
+            await appendEvent(specDir, {
+                session_id: sessionId,
+                type: 'session.start',
+                data: {
+                    adapter: options.adapter,
+                    maxLoops,
+                    maxRetries,
+                    maxFailures,
+                    yolo: options.yolo,
+                    focus: options.focus,
+                },
+            });
+            let consecutiveFailures = 0;
+            let agent = null;
+            let acpSessionId = null;
+            // Create translator and renderer for this session
+            const translator = createTranslator();
+            const renderer = createCliRenderer();
+            try {
+                for (let iteration = 1; iteration <= maxLoops; iteration++) {
+                    renderer.newSection?.(`Iteration ${iteration}/${maxLoops}`);
+                    // Gather fresh context each iteration (only automation-eligible tasks)
+                    // AC: @cli-ralph ac-16
+                    const sessionCtx = await gatherSessionContext(ctx, { limit: '10', eligible: true });
+                    // Check for ready tasks or active tasks
+                    const hasActiveTasks = sessionCtx.active_tasks.length > 0;
+                    const hasReadyTasks = sessionCtx.ready_tasks.length > 0;
+                    if (!hasActiveTasks && !hasReadyTasks) {
+                        info('No active or eligible ready tasks. Exiting loop.');
+                        break;
+                    }
+                    // Build prompt
+                    const prompt = buildPrompt(sessionCtx, iteration, maxLoops, options.focus);
+                    if (options.dryRun) {
+                        console.log(chalk.yellow('=== DRY RUN - Prompt that would be sent ===\n'));
+                        console.log(prompt);
+                        console.log(chalk.yellow('\n=== END DRY RUN ==='));
+                        break;
+                    }
+                    // Log prompt
+                    await appendEvent(specDir, {
+                        session_id: sessionId,
+                        type: 'prompt.sent',
+                        data: {
+                            iteration,
+                            prompt,
+                            tasks: {
+                                active: sessionCtx.active_tasks.map(t => t.ref),
+                                ready: sessionCtx.ready_tasks.map(t => t.ref),
+                            },
+                        },
+                    });
+                    // Retry loop for this iteration
+                    let lastError = null;
+                    let succeeded = false;
+                    for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
+                        if (attempt > 1) {
+                            console.log(chalk.yellow(`\nRetry attempt ${attempt - 1}/${maxRetries}...`));
+                        }
+                        try {
+                            // Spawn agent if not already running
+                            if (!agent) {
+                                info('Spawning ACP agent...');
+                                agent = await spawnAndInitialize(adapter, {
+                                    cwd: process.cwd(),
+                                    clientOptions: {
+                                        clientInfo: {
+                                            name: 'kspec-ralph',
+                                            version: '0.1.0',
+                                        },
+                                    },
+                                });
+                                // Set up streaming update handler with translator + renderer
+                                agent.client.on('update', (_sid, update) => {
+                                    // Translate ACP event to RalphEvent and render
+                                    const event = translator.translate(update);
+                                    if (event) {
+                                        renderer.render(event);
+                                    }
+                                    // Log raw update event (async, non-blocking)
+                                    appendEvent(specDir, {
+                                        session_id: sessionId,
+                                        type: 'session.update',
+                                        data: { iteration, update },
+                                    }).catch(() => {
+                                        // Ignore logging errors during streaming
+                                    });
+                                });
+                                // Set up tool request handler
+                                agent.client.on('request', (reqId, method, params) => {
+                                    handleRequest(agent.client, reqId, method, params, options.yolo).catch((err) => {
+                                        agent.client.respondError(reqId, -32000, err.message);
+                                    });
+                                });
+                            }
+                            // Create fresh ACP session per iteration to keep context clean
+                            info('Creating ACP session...');
+                            acpSessionId = await agent.client.newSession({
+                                cwd: process.cwd(),
+                                mcpServers: [], // No MCP servers for now
+                            });
+                            info('Sending prompt to agent...');
+                            // Send prompt and wait for completion
+                            const response = await agent.client.prompt({
+                                sessionId: acpSessionId,
+                                prompt: [{ type: 'text', text: prompt }],
+                            });
+                            // Log completion
+                            await appendEvent(specDir, {
+                                session_id: sessionId,
+                                type: 'session.update',
+                                data: {
+                                    iteration,
+                                    stopReason: response.stopReason,
+                                    completed: true,
+                                },
+                            });
+                            // Check stop reason
+                            if (response.stopReason === 'cancelled') {
+                                throw new Error(errors.usage.agentPromptCancelled);
+                            }
+                            succeeded = true;
+                            break;
+                        }
+                        catch (err) {
+                            lastError = err;
+                            error(errors.failures.iterationFailed(lastError.message));
+                            // Clean up agent on error - will respawn next attempt
+                            if (agent) {
+                                agent.kill();
+                                agent = null;
+                                acpSessionId = null;
+                            }
+                        }
+                    }
+                    if (succeeded) {
+                        console.log(); // Newline after streaming output
+                        // Save session context snapshot for audit trail
+                        await saveSessionContext(specDir, sessionId, iteration, sessionCtx);
+                        success(`Completed iteration ${iteration}`);
+                        consecutiveFailures = 0;
+                    }
+                    else {
+                        consecutiveFailures++;
+                        error(errors.failures.iterationFailedAfterRetries(iteration, maxRetries, consecutiveFailures, maxFailures));
+                        if (lastError) {
+                            error(errors.failures.lastError(lastError.message));
+                        }
+                        if (consecutiveFailures >= maxFailures) {
+                            error(errors.failures.reachedMaxFailures(maxFailures));
+                            break;
+                        }
+                        info('Continuing to next iteration...');
+                    }
+                }
+            }
+            finally {
+                // Clean up agent
+                if (agent) {
+                    agent.kill();
+                }
+                // Log session end
+                const status = consecutiveFailures >= maxFailures ? 'abandoned' : 'completed';
+                await appendEvent(specDir, {
+                    session_id: sessionId,
+                    type: 'session.end',
+                    data: {
+                        status,
+                        consecutiveFailures,
+                    },
+                });
+                await updateSessionStatus(specDir, sessionId, status);
+            }
+            console.log(chalk.green(`\n${'─'.repeat(60)}`));
+            success('Ralph loop completed');
+            console.log(chalk.green(`${'─'.repeat(60)}\n`));
+        }
+        catch (err) {
+            error(errors.failures.ralphLoop, err);
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+}
+//# sourceMappingURL=ralph.js.map

package/dist/cli/commands/ralph.js.map

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

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * Register the search command
+ */
+export declare function registerSearchCommand(program: Command): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmEpC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwF5D"}

package/dist/cli/commands/search.js

@@ -0,0 +1,134 @@
+import chalk from 'chalk';
+import { initContext, buildIndexes, } from '../../parser/index.js';
+import { output, error } from '../output.js';
+import { grepItem, formatMatchedFields } from '../../utils/grep.js';
+import { errors } from '../../strings/index.js';
+import { EXIT_CODES } from '../exit-codes.js';
+/**
+ * Format a spec item for search results
+ */
+function formatSearchItem(item, matchedFields) {
+    const shortId = item._ulid.slice(0, 8);
+    const slugStr = item.slugs.length > 0 ? chalk.cyan(`@${item.slugs[0]}`) : '';
+    const typeStr = chalk.gray(`[${item.type}]`);
+    let status = '';
+    if (item.status && typeof item.status === 'object') {
+        const s = item.status;
+        if (s.implementation) {
+            const implColor = s.implementation === 'verified' ? chalk.green
+                : s.implementation === 'implemented' ? chalk.cyan
+                    : s.implementation === 'in_progress' ? chalk.yellow
+                        : chalk.gray;
+            status = implColor(s.implementation);
+        }
+    }
+    let line = `${chalk.gray(shortId)} ${typeStr} ${item.title}`;
+    if (slugStr)
+        line += ` ${slugStr}`;
+    if (status)
+        line += ` ${status}`;
+    console.log(line);
+    console.log(chalk.gray(`  matched: ${formatMatchedFields(matchedFields)}`));
+}
+/**
+ * Format a task for search results
+ */
+function formatSearchTask(task, matchedFields) {
+    const shortId = task._ulid.slice(0, 8);
+    const slugStr = task.slugs.length > 0 ? chalk.cyan(`@${task.slugs[0]}`) : '';
+    const statusColor = task.status === 'completed' ? chalk.green
+        : task.status === 'in_progress' ? chalk.blue
+            : task.status === 'blocked' ? chalk.red
+                : chalk.gray;
+    const priority = task.priority <= 2 ? chalk.red(`P${task.priority}`) : chalk.gray(`P${task.priority}`);
+    let line = `${chalk.gray(shortId)} ${statusColor(`[${task.status}]`)} ${priority} ${task.title}`;
+    if (slugStr)
+        line += ` ${slugStr}`;
+    console.log(line);
+    console.log(chalk.gray(`  matched: ${formatMatchedFields(matchedFields)}`));
+}
+/**
+ * Register the search command
+ */
+export function registerSearchCommand(program) {
+    program
+        .command('search <pattern>')
+        .description('Search across all items and tasks with regex pattern')
+        .option('-t, --type <type>', 'Filter by item type')
+        .option('-s, --status <status>', 'Filter by task status')
+        .option('--items-only', 'Search only spec items')
+        .option('--tasks-only', 'Search only tasks')
+        .option('--limit <n>', 'Limit results', '50')
+        .action(async (pattern, options) => {
+        try {
+            const ctx = await initContext();
+            const { itemIndex, tasks, items, refIndex } = await buildIndexes(ctx);
+            const results = [];
+            const limit = parseInt(options.limit, 10) || 50;
+            // Search spec items
+            if (!options.tasksOnly) {
+                for (const item of items) {
+                    // Apply type filter
+                    if (options.type && item.type !== options.type)
+                        continue;
+                    const match = grepItem(item, pattern);
+                    if (match) {
+                        results.push({
+                            type: 'item',
+                            item,
+                            matchedFields: match.matchedFields,
+                        });
+                    }
+                }
+            }
+            // Search tasks
+            if (!options.itemsOnly) {
+                for (const task of tasks) {
+                    // Apply status filter
+                    if (options.status && task.status !== options.status)
+                        continue;
+                    const match = grepItem(task, pattern);
+                    if (match) {
+                        results.push({
+                            type: 'task',
+                            item: task,
+                            matchedFields: match.matchedFields,
+                        });
+                    }
+                }
+            }
+            // Limit results
+            const limitedResults = results.slice(0, limit);
+            output({
+                pattern,
+                results: limitedResults.map(r => ({
+                    type: r.type,
+                    ulid: r.item._ulid,
+                    title: r.item.title,
+                    matchedFields: r.matchedFields,
+                })),
+                total: results.length,
+                showing: limitedResults.length,
+            }, () => {
+                if (limitedResults.length === 0) {
+                    console.log(chalk.gray(`No matches found for "${pattern}"`));
+                    return;
+                }
+                for (const result of limitedResults) {
+                    if (result.type === 'item') {
+                        formatSearchItem(result.item, result.matchedFields);
+                    }
+                    else {
+                        formatSearchTask(result.item, result.matchedFields);
+                    }
+                }
+                console.log(chalk.gray(`\n${limitedResults.length} result(s)${results.length > limit ? ` (showing first ${limit})` : ''}`));
+            });
+        }
+        catch (err) {
+            error(errors.failures.search, err);
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

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