openplanr 0.1.0 → 0.2.0

package/dist/agents/agent-factory.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Factory for creating coding agent instances.
+ */
+import type { CodingAgent } from './types.js';
+import type { CodingAgentName } from '../models/types.js';
+export declare function createAgent(name: CodingAgentName): Promise<CodingAgent>;
+//# sourceMappingURL=agent-factory.d.ts.map

package/dist/agents/agent-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-factory.d.ts","sourceRoot":"","sources":["../../src/agents/agent-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAiB7E"}

package/dist/agents/agent-factory.js

@@ -0,0 +1,22 @@
+/**
+ * Factory for creating coding agent instances.
+ */
+export async function createAgent(name) {
+    switch (name) {
+        case 'claude': {
+            const { ClaudeAgent } = await import('./claude-agent.js');
+            return new ClaudeAgent();
+        }
+        case 'cursor': {
+            const { CursorAgent } = await import('./cursor-agent.js');
+            return new CursorAgent();
+        }
+        case 'codex': {
+            const { CodexAgent } = await import('./codex-agent.js');
+            return new CodexAgent();
+        }
+        default:
+            throw new Error(`Unknown coding agent: ${name}. Supported: claude, cursor, codex.`);
+    }
+}
+//# sourceMappingURL=agent-factory.js.map

package/dist/agents/agent-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-factory.js","sourceRoot":"","sources":["../../src/agents/agent-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC1D,OAAO,IAAI,WAAW,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC1D,OAAO,IAAI,WAAW,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACxD,OAAO,IAAI,UAAU,EAAE,CAAC;QAC1B,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,qCAAqC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/agents/claude-agent.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Code CLI agent adapter.
+ *
+ * Invokes the `claude` CLI binary with --print mode, piping
+ * the implementation prompt via stdin and streaming output.
+ */
+import type { CodingAgent, AgentOptions, AgentResult } from './types.js';
+export declare class ClaudeAgent implements CodingAgent {
+    readonly name = "claude";
+    isAvailable(): Promise<boolean>;
+    execute(prompt: string, options: AgentOptions): Promise<AgentResult>;
+}
+//# sourceMappingURL=claude-agent.d.ts.map

package/dist/agents/claude-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-agent.d.ts","sourceRoot":"","sources":["../../src/agents/claude-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,YAAY;IAEnB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAuC3E"}

package/dist/agents/claude-agent.js

@@ -0,0 +1,48 @@
+/**
+ * Claude Code CLI agent adapter.
+ *
+ * Invokes the `claude` CLI binary with --print mode, piping
+ * the implementation prompt via stdin and streaming output.
+ */
+import { spawn } from 'node:child_process';
+import { which } from './utils.js';
+export class ClaudeAgent {
+    name = 'claude';
+    async isAvailable() {
+        return (await which('claude')) !== null;
+    }
+    async execute(prompt, options) {
+        return new Promise((resolve, reject) => {
+            const args = ['--print', '-p', prompt];
+            const child = spawn('claude', args, {
+                cwd: options.cwd,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: { ...process.env },
+            });
+            const chunks = [];
+            child.stdout.on('data', (data) => {
+                const text = data.toString();
+                chunks.push(text);
+                if (options.stream) {
+                    process.stdout.write(text);
+                }
+            });
+            child.stderr.on('data', (data) => {
+                const text = data.toString();
+                if (options.stream) {
+                    process.stderr.write(text);
+                }
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Failed to launch claude CLI: ${err.message}`));
+            });
+            child.on('close', (code) => {
+                resolve({
+                    output: chunks.join(''),
+                    exitCode: code ?? 1,
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=claude-agent.js.map

package/dist/agents/claude-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-agent.js","sourceRoot":"","sources":["../../src/agents/claude-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,QAAQ,CAAC;IAEzB,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAqB;QACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE;gBAClC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;aACxB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAa,EAAE,CAAC;YAE5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,OAAO,CAAC;oBACN,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,QAAQ,EAAE,IAAI,IAAI,CAAC;iBACpB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/agents/codex-agent.d.ts

@@ -0,0 +1,13 @@
+/**
+ * OpenAI Codex CLI agent adapter.
+ *
+ * Invokes the `codex` CLI binary with the implementation prompt
+ * and streams output in real time.
+ */
+import type { CodingAgent, AgentOptions, AgentResult } from './types.js';
+export declare class CodexAgent implements CodingAgent {
+    readonly name = "codex";
+    isAvailable(): Promise<boolean>;
+    execute(prompt: string, options: AgentOptions): Promise<AgentResult>;
+}
+//# sourceMappingURL=codex-agent.d.ts.map

package/dist/agents/codex-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-agent.d.ts","sourceRoot":"","sources":["../../src/agents/codex-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,UAAW,YAAW,WAAW;IAC5C,QAAQ,CAAC,IAAI,WAAW;IAElB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAqC3E"}

package/dist/agents/codex-agent.js

@@ -0,0 +1,47 @@
+/**
+ * OpenAI Codex CLI agent adapter.
+ *
+ * Invokes the `codex` CLI binary with the implementation prompt
+ * and streams output in real time.
+ */
+import { spawn } from 'node:child_process';
+import { which } from './utils.js';
+export class CodexAgent {
+    name = 'codex';
+    async isAvailable() {
+        return (await which('codex')) !== null;
+    }
+    async execute(prompt, options) {
+        return new Promise((resolve, reject) => {
+            const child = spawn('codex', [prompt], {
+                cwd: options.cwd,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: { ...process.env },
+            });
+            const chunks = [];
+            child.stdout.on('data', (data) => {
+                const text = data.toString();
+                chunks.push(text);
+                if (options.stream) {
+                    process.stdout.write(text);
+                }
+            });
+            child.stderr.on('data', (data) => {
+                const text = data.toString();
+                if (options.stream) {
+                    process.stderr.write(text);
+                }
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Failed to launch codex CLI: ${err.message}`));
+            });
+            child.on('close', (code) => {
+                resolve({
+                    output: chunks.join(''),
+                    exitCode: code ?? 1,
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=codex-agent.js.map

package/dist/agents/codex-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-agent.js","sourceRoot":"","sources":["../../src/agents/codex-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,OAAO,CAAC;IAExB,KAAK,CAAC,WAAW;QACf,OAAO,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAqB;QACjD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;gBACrC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;aACxB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAa,EAAE,CAAC;YAE5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,OAAO,CAAC;oBACN,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,QAAQ,EAAE,IAAI,IAAI,CAAC;iBACpB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/agents/cursor-agent.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cursor agent adapter.
+ *
+ * Since Cursor is GUI-based, this agent writes the implementation
+ * prompt to a file that Cursor can read from its prompt panel.
+ */
+import type { CodingAgent, AgentOptions, AgentResult } from './types.js';
+export declare class CursorAgent implements CodingAgent {
+    readonly name = "cursor";
+    isAvailable(): Promise<boolean>;
+    execute(prompt: string, options: AgentOptions): Promise<AgentResult>;
+}
+//# sourceMappingURL=cursor-agent.d.ts.map

package/dist/agents/cursor-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-agent.d.ts","sourceRoot":"","sources":["../../src/agents/cursor-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,WAAY,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,YAAY;IAEnB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAO/B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CA2B3E"}

package/dist/agents/cursor-agent.js

@@ -0,0 +1,40 @@
+/**
+ * Cursor agent adapter.
+ *
+ * Since Cursor is GUI-based, this agent writes the implementation
+ * prompt to a file that Cursor can read from its prompt panel.
+ */
+import path from 'node:path';
+import { writeFile, ensureDir } from '../utils/fs.js';
+export class CursorAgent {
+    name = 'cursor';
+    async isAvailable() {
+        // Cursor is available if the project has a .cursor directory
+        // or the cursor binary exists
+        const fse = await import('fs-extra');
+        return fse.pathExists(path.join(process.cwd(), '.cursor'));
+    }
+    async execute(prompt, options) {
+        const promptDir = path.join(options.cwd, '.cursor', 'prompts');
+        await ensureDir(promptDir);
+        // Extract task ID from prompt for filename
+        const taskMatch = prompt.match(/TASK-\d{3}/);
+        const filename = taskMatch ? `${taskMatch[0]}.md` : `implement-${Date.now()}.md`;
+        const filePath = path.join(promptDir, filename);
+        await writeFile(filePath, prompt);
+        const output = [
+            `Implementation prompt saved to: ${filePath}`,
+            '',
+            'To implement in Cursor:',
+            '  1. Open Cursor in this project',
+            '  2. Open the Command Palette (Cmd+Shift+P)',
+            '  3. Run "Cursor: Open Prompt" and select the saved file',
+            '  4. Or paste the prompt directly into Cursor\'s AI chat',
+        ].join('\n');
+        if (options.stream) {
+            console.log(output);
+        }
+        return { output, exitCode: 0 };
+    }
+}
+//# sourceMappingURL=cursor-agent.js.map

package/dist/agents/cursor-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-agent.js","sourceRoot":"","sources":["../../src/agents/cursor-agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,QAAQ,CAAC;IAEzB,KAAK,CAAC,WAAW;QACf,6DAA6D;QAC7D,8BAA8B;QAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,OAAqB;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;QAE3B,2CAA2C;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;QACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhD,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAElC,MAAM,MAAM,GAAG;YACb,mCAAmC,QAAQ,EAAE;YAC7C,EAAE;YACF,yBAAyB;YACzB,kCAAkC;YAClC,6CAA6C;YAC7C,0DAA0D;YAC1D,0DAA0D;SAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/agents/implementation-bridge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Task implementation bridge.
+ *
+ * Orchestrates the full flow:
+ * 1. Read and parse the task artifact
+ * 2. Resolve target subtask(s)
+ * 3. Gather parent chain context (story → feature → epic)
+ * 4. Build codebase context
+ * 5. Compose the implementation prompt
+ * 6. Dispatch to the configured coding agent
+ */
+import type { OpenPlanrConfig } from '../models/types.js';
+export interface ImplementOptions {
+    subtask?: string;
+    next?: boolean;
+    agent?: string;
+    dryRun?: boolean;
+    markDone?: boolean;
+}
+export declare function executeImplementation(projectDir: string, config: OpenPlanrConfig, taskId: string, opts: ImplementOptions): Promise<void>;
+//# sourceMappingURL=implementation-bridge.d.ts.map

package/dist/agents/implementation-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-bridge.d.ts","sourceRoot":"","sources":["../../src/agents/implementation-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,oBAAoB,CAAC;AAY3E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Kf"}

package/dist/agents/implementation-bridge.js

@@ -0,0 +1,173 @@
+/**
+ * Task implementation bridge.
+ *
+ * Orchestrates the full flow:
+ * 1. Read and parse the task artifact
+ * 2. Resolve target subtask(s)
+ * 3. Gather parent chain context (story → feature → epic)
+ * 4. Build codebase context
+ * 5. Compose the implementation prompt
+ * 6. Dispatch to the configured coding agent
+ */
+import { readArtifact, readArtifactRaw, getParentChain, } from '../services/artifact-service.js';
+import { createAgent } from './agent-factory.js';
+import { parseTaskMarkdown, findSubtasks, getNextPending, formatSubtaskList } from './task-parser.js';
+import { composeImplementationPrompt } from './prompt-composer.js';
+import { logger } from '../utils/logger.js';
+import chalk from 'chalk';
+export async function executeImplementation(projectDir, config, taskId, opts) {
+    // 1. Read the task artifact
+    const taskData = await readArtifact(projectDir, config, 'task', taskId);
+    if (!taskData) {
+        logger.error(`Task list ${taskId} not found.`);
+        process.exit(1);
+    }
+    const taskRaw = await readArtifactRaw(projectDir, config, 'task', taskId);
+    logger.heading(`Implement: ${taskId}`);
+    // 2. Parse subtasks
+    const allSubtasks = parseTaskMarkdown(taskData.content);
+    if (allSubtasks.length === 0) {
+        logger.warn('No subtasks found in this task list.');
+        logger.info('Task list content:');
+        console.log(taskData.content);
+        return;
+    }
+    // 3. Resolve target subtask(s)
+    let targetSubtasks = allSubtasks;
+    if (opts.next) {
+        const next = getNextPending(allSubtasks);
+        if (!next) {
+            logger.success('All subtasks are completed!');
+            return;
+        }
+        targetSubtasks = [next];
+        logger.info(`Next pending: ${next.id} ${next.title}`);
+    }
+    else if (opts.subtask) {
+        const matches = findSubtasks(allSubtasks, opts.subtask);
+        if (matches.length === 0) {
+            logger.error(`No subtask matching "${opts.subtask}" found.`);
+            logger.dim('Available subtasks:');
+            console.log(formatSubtaskList(allSubtasks));
+            return;
+        }
+        targetSubtasks = matches;
+        logger.info(`Matched ${matches.length} subtask(s):`);
+        for (const m of matches) {
+            logger.dim(`  ${m.id} ${m.title}`);
+        }
+    }
+    else {
+        // Implementing all subtasks
+        logger.info(`Implementing all ${allSubtasks.length} subtasks`);
+    }
+    // 4. Gather parent chain context
+    const ora = (await import('ora')).default;
+    const spinner = ora('Preparing implementation context...').start();
+    const parents = await getParentChain(projectDir, config, 'task', taskId);
+    let storyContent;
+    let featureContent;
+    let epicContent;
+    const storyId = taskData.data.storyId;
+    if (storyId) {
+        storyContent = (await readArtifactRaw(projectDir, config, 'story', storyId)) || undefined;
+        spinner.text = `Read parent story ${storyId}`;
+    }
+    if (parents.feature) {
+        const featureId = parents.story?.data?.featureId;
+        if (featureId) {
+            featureContent = (await readArtifactRaw(projectDir, config, 'feature', featureId)) || undefined;
+            spinner.text = `Read parent feature ${featureId}`;
+        }
+    }
+    if (parents.epic) {
+        const epicId = parents.feature?.data?.epicId;
+        if (epicId) {
+            epicContent = (await readArtifactRaw(projectDir, config, 'epic', epicId)) || undefined;
+            spinner.text = `Read parent epic ${epicId}`;
+        }
+    }
+    // 5. Build codebase context
+    spinner.text = 'Scanning codebase...';
+    let codebaseContext;
+    try {
+        const { buildCodebaseContext, formatCodebaseContext, extractKeywords } = await import('../ai/codebase/index.js');
+        const textToAnalyze = [
+            taskData.content,
+            storyContent || '',
+            featureContent || '',
+        ].join(' ');
+        const keywords = extractKeywords(textToAnalyze);
+        const ctx = await buildCodebaseContext(projectDir, keywords);
+        codebaseContext = formatCodebaseContext(ctx);
+        if (ctx.techStack) {
+            spinner.text = `Stack: ${ctx.techStack.language}${ctx.techStack.framework ? ' + ' + ctx.techStack.framework : ''}`;
+        }
+    }
+    catch {
+        // Codebase scanning is best-effort
+    }
+    spinner.stop();
+    // Show context summary
+    logger.success(`Read ${taskId} (${allSubtasks.length} subtasks)`);
+    if (storyContent)
+        logger.success(`Read parent story`);
+    if (featureContent)
+        logger.success(`Read parent feature`);
+    if (epicContent)
+        logger.success(`Read parent epic`);
+    if (codebaseContext)
+        logger.success(`Scanned codebase`);
+    // 6. Compose prompt
+    const prompt = composeImplementationPrompt({
+        taskId,
+        taskTitle: taskData.data.title || taskId,
+        taskContent: taskData.content,
+        targetSubtasks,
+        allSubtasks,
+        storyContent,
+        featureContent,
+        epicContent,
+        codebaseContext,
+    });
+    // 7. Handle dry run
+    if (opts.dryRun) {
+        logger.heading('Dry Run — Composed Prompt:');
+        console.log(chalk.dim('━'.repeat(60)));
+        console.log(prompt);
+        console.log(chalk.dim('━'.repeat(60)));
+        logger.dim(`Prompt length: ${prompt.length} chars (~${Math.ceil(prompt.length / 4)} tokens)`);
+        return;
+    }
+    // 8. Resolve and launch coding agent
+    const agentName = (opts.agent || config.defaultAgent || 'claude');
+    const agent = await createAgent(agentName);
+    const available = await agent.isAvailable();
+    if (!available) {
+        logger.error(`Coding agent "${agentName}" is not available on this machine.`);
+        logger.dim(`Make sure the "${agentName}" CLI is installed and in your PATH.`);
+        logger.dim('');
+        logger.dim('Install instructions:');
+        logger.dim('  Claude: npm install -g @anthropic-ai/claude-code');
+        logger.dim('  Codex:  npm install -g @openai/codex');
+        logger.dim('  Cursor: Install from https://cursor.sh');
+        logger.dim('');
+        logger.dim('Or use --dry-run to see the prompt without executing.');
+        return;
+    }
+    logger.heading(`Launching ${agentName}...`);
+    console.log(chalk.dim('━'.repeat(60)));
+    const result = await agent.execute(prompt, {
+        cwd: projectDir,
+        stream: true,
+        dryRun: false,
+    });
+    console.log(chalk.dim('━'.repeat(60)));
+    if (result.exitCode === 0) {
+        logger.success(`${agentName} completed successfully.`);
+    }
+    else {
+        logger.warn(`${agentName} exited with code ${result.exitCode}.`);
+    }
+}
+//# sourceMappingURL=implementation-bridge.js.map

package/dist/agents/implementation-bridge.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,6 @@
+export type { CodingAgent, AgentOptions, AgentResult } from './types.js';
+export { createAgent } from './agent-factory.js';
+export { parseTaskMarkdown, findSubtasks, getNextPending } from './task-parser.js';
+export { composeImplementationPrompt } from './prompt-composer.js';
+export { executeImplementation } from './implementation-bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,5 @@
+export { createAgent } from './agent-factory.js';
+export { parseTaskMarkdown, findSubtasks, getNextPending } from './task-parser.js';
+export { composeImplementationPrompt } from './prompt-composer.js';
+export { executeImplementation } from './implementation-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/agents/prompt-composer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Composes rich implementation prompts for coding agents.
+ *
+ * Assembles a structured prompt from:
+ * 1. Target subtask details
+ * 2. Full task list context (what's done, what's next)
+ * 3. Parent story and feature context
+ * 4. Codebase context (tech stack, folder tree, related files)
+ *
+ * The output is a detailed markdown prompt that any coding agent
+ * (Claude, Cursor, Codex) can understand and act on.
+ */
+import type { ParsedSubtask } from './task-parser.js';
+export interface ImplementationContext {
+    taskId: string;
+    taskTitle: string;
+    taskContent: string;
+    targetSubtasks: ParsedSubtask[];
+    allSubtasks: ParsedSubtask[];
+    storyContent?: string;
+    featureContent?: string;
+    epicContent?: string;
+    codebaseContext?: string;
+}
+/**
+ * Compose a complete implementation prompt from gathered context.
+ * Returns a markdown string ready to be sent to a coding agent.
+ */
+export declare function composeImplementationPrompt(ctx: ImplementationContext): string;
+//# sourceMappingURL=prompt-composer.d.ts.map

package/dist/agents/prompt-composer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-composer.d.ts","sourceRoot":"","sources":["../../src/agents/prompt-composer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,qBAAqB,GAAG,MAAM,CAmE9E"}

package/dist/agents/prompt-composer.js

@@ -0,0 +1,81 @@
+/**
+ * Composes rich implementation prompts for coding agents.
+ *
+ * Assembles a structured prompt from:
+ * 1. Target subtask details
+ * 2. Full task list context (what's done, what's next)
+ * 3. Parent story and feature context
+ * 4. Codebase context (tech stack, folder tree, related files)
+ *
+ * The output is a detailed markdown prompt that any coding agent
+ * (Claude, Cursor, Codex) can understand and act on.
+ */
+import { formatSubtaskList } from './task-parser.js';
+/**
+ * Compose a complete implementation prompt from gathered context.
+ * Returns a markdown string ready to be sent to a coding agent.
+ */
+export function composeImplementationPrompt(ctx) {
+    const sections = [];
+    // Header
+    sections.push(`# Implementation Task: ${ctx.taskId}`);
+    // Target subtask(s)
+    if (ctx.targetSubtasks.length > 0) {
+        sections.push('## Target Subtask(s)\n');
+        sections.push('Implement ONLY the following subtask(s):');
+        sections.push('');
+        for (const st of ctx.targetSubtasks) {
+            sections.push(`- **${st.id}**: ${st.title}`);
+        }
+        // Parent group context
+        const parentId = ctx.targetSubtasks[0]?.parentId;
+        if (parentId) {
+            const parentGroup = ctx.allSubtasks.find((t) => t.id === parentId);
+            if (parentGroup) {
+                sections.push(`\nParent task group: **${parentGroup.id}** ${parentGroup.title}`);
+            }
+        }
+    }
+    // Full task list (shows what's done and what's pending)
+    sections.push('\n## Full Task List\n');
+    sections.push('```');
+    const targetIds = new Set(ctx.targetSubtasks.map((t) => t.id));
+    const firstTargetId = ctx.targetSubtasks[0]?.id;
+    sections.push(formatSubtaskList(ctx.allSubtasks, firstTargetId));
+    sections.push('```');
+    // Parent story context
+    if (ctx.storyContent) {
+        sections.push('\n## User Story Context\n');
+        sections.push(truncate(ctx.storyContent, 3000));
+    }
+    // Parent feature context
+    if (ctx.featureContent) {
+        sections.push('\n## Feature Context\n');
+        sections.push(truncate(ctx.featureContent, 2000));
+    }
+    // Parent epic context (brief)
+    if (ctx.epicContent) {
+        sections.push('\n## Epic Context (summary)\n');
+        sections.push(truncate(ctx.epicContent, 1000));
+    }
+    // Codebase context
+    if (ctx.codebaseContext) {
+        sections.push('\n## Codebase Context\n');
+        sections.push(ctx.codebaseContext);
+    }
+    // Instructions
+    sections.push('\n## Instructions\n');
+    sections.push('1. Implement ONLY the target subtask(s) listed above.');
+    sections.push('2. Follow existing code patterns and conventions in the codebase.');
+    sections.push('3. Write clean, well-documented code.');
+    sections.push('4. Include appropriate error handling.');
+    sections.push('5. Add or update tests for the changes.');
+    sections.push('6. Do NOT modify code unrelated to the target subtask(s).');
+    return sections.join('\n');
+}
+function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars) + '\n\n... (truncated)';
+}
+//# sourceMappingURL=prompt-composer.js.map

package/dist/agents/prompt-composer.js.map

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

package/dist/agents/task-parser.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Parses task list markdown files to extract subtask structure.
+ *
+ * Supports addressing subtasks by:
+ * - ID (e.g., "2.1")
+ * - Group ID (e.g., "2.0" returns the group + all subtasks)
+ * - Keyword search (e.g., "auth" fuzzy-matches against titles)
+ * - Next pending (returns the first unchecked subtask)
+ */
+export interface ParsedSubtask {
+    id: string;
+    title: string;
+    done: boolean;
+    parentId: string | null;
+    depth: number;
+}
+/**
+ * Parse a task list markdown file into structured subtasks.
+ * Expected format: `- [x] 1.0 Task title` or `  - [ ] 1.1 Subtask title`
+ */
+export declare function parseTaskMarkdown(content: string): ParsedSubtask[];
+/**
+ * Find subtasks matching a query.
+ *
+ * - Exact ID match: "2.1" → single subtask
+ * - Group match: "2.0" → group + all its subtasks
+ * - Keyword search: "auth" → fuzzy match on titles
+ */
+export declare function findSubtasks(tasks: ParsedSubtask[], query: string): ParsedSubtask[];
+/**
+ * Get the next pending (unchecked) subtask.
+ */
+export declare function getNextPending(tasks: ParsedSubtask[]): ParsedSubtask | null;
+/**
+ * Format subtasks for display in the terminal.
+ */
+export declare function formatSubtaskList(tasks: ParsedSubtask[], highlightId?: string): string;
+//# sourceMappingURL=task-parser.d.ts.map