@speclife/core 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Configuration loading and validation
+ */
+import { type ImplementMode } from './types.js';
+import type { BootstrapStrategy } from './adapters/environment-adapter.js';
+/** Per-environment bootstrap configuration */
+export interface EnvironmentBootstrapConfig {
+    /** Override strategy for this environment */
+    strategy?: BootstrapStrategy;
+    /** Whether to enable this environment (default: true) */
+    enabled?: boolean;
+}
+/** Worktree configuration */
+export interface WorktreeConfig {
+    /** Bootstrap configuration for environment setup */
+    bootstrap: {
+        /** Default bootstrap strategy (default: "symlink") */
+        strategy: BootstrapStrategy;
+        /** Per-environment overrides */
+        environments?: Record<string, EnvironmentBootstrapConfig>;
+    };
+}
+/** SpecLife configuration schema */
+export interface SpecLifeConfig {
+    /** OpenSpec directory location (default: "openspec") */
+    specDir: string;
+    /** AI provider to use */
+    aiProvider: 'claude' | 'openai' | 'gemini';
+    /** AI model identifier */
+    aiModel: string;
+    /** Implementation mode for speclife_implement (default: "claude-cli") */
+    implementMode: ImplementMode;
+    /** GitHub configuration */
+    github: {
+        owner: string;
+        repo: string;
+        baseBranch: string;
+    };
+    /** Command to run tests */
+    testCommand: string;
+    /** Optional build command */
+    buildCommand?: string;
+    /** Files to always include in AI context */
+    contextFiles?: string[];
+    /** Worktree configuration */
+    worktree: WorktreeConfig;
+    /** Create draft PR during init (default: true) */
+    createDraftPR: boolean;
+}
+/**
+ * Load configuration from standard locations
+ *
+ * Search order:
+ * 1. .specliferc.yaml
+ * 2. .specliferc.json
+ * 3. speclife.config.js
+ * 4. package.json "speclife" key
+ */
+export declare function loadConfig(cwd?: string): Promise<SpecLifeConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,SAAS,EAAE;QACT,sDAAsD;QACtD,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,gCAAgC;QAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;KAC3D,CAAC;CACH;AAED,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAE3C,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAEhB,yEAAyE;IACzE,aAAa,EAAE,aAAa,CAAC;IAE7B,2BAA2B;IAC3B,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,QAAQ,EAAE,cAAc,CAAC;IAEzB,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;CACxB;AAsBD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiDrF"}

package/dist/config.js

@@ -0,0 +1,112 @@
+/**
+ * Configuration loading and validation
+ */
+import { cosmiconfig } from 'cosmiconfig';
+import { SpecLifeError, ErrorCodes } from './types.js';
+/** Default configuration values */
+const defaults = {
+    specDir: 'openspec',
+    aiProvider: 'claude',
+    aiModel: 'claude-sonnet-4-20250514',
+    implementMode: 'claude-cli',
+    github: {
+        owner: '',
+        repo: '',
+        baseBranch: 'main',
+    },
+    testCommand: 'npm test',
+    worktree: {
+        bootstrap: {
+            strategy: 'symlink',
+        },
+    },
+    createDraftPR: true,
+};
+/**
+ * Load configuration from standard locations
+ *
+ * Search order:
+ * 1. .specliferc.yaml
+ * 2. .specliferc.json
+ * 3. speclife.config.js
+ * 4. package.json "speclife" key
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    const explorer = cosmiconfig('speclife', {
+        searchPlaces: [
+            '.specliferc.yaml',
+            '.specliferc.yml',
+            '.specliferc.json',
+            '.specliferc',
+            'speclife.config.js',
+            'speclife.config.cjs',
+            'package.json',
+        ],
+    });
+    const result = await explorer.search(cwd);
+    const fileConfig = result?.config ?? {};
+    // Merge with defaults
+    const config = {
+        ...defaults,
+        ...fileConfig,
+        github: {
+            ...defaults.github,
+            ...fileConfig.github,
+        },
+        worktree: {
+            ...defaults.worktree,
+            ...fileConfig.worktree,
+            bootstrap: {
+                ...defaults.worktree?.bootstrap,
+                ...fileConfig.worktree?.bootstrap,
+            },
+        },
+    };
+    // Apply environment variable overrides
+    if (process.env.SPECLIFE_AI_PROVIDER) {
+        config.aiProvider = process.env.SPECLIFE_AI_PROVIDER;
+    }
+    if (process.env.SPECLIFE_AI_MODEL) {
+        config.aiModel = process.env.SPECLIFE_AI_MODEL;
+    }
+    if (process.env.SPECLIFE_IMPLEMENT_MODE) {
+        config.implementMode = process.env.SPECLIFE_IMPLEMENT_MODE;
+    }
+    // Validate required fields
+    validateConfig(config);
+    return config;
+}
+/** Valid bootstrap strategies */
+const validBootstrapStrategies = ['symlink', 'install', 'none'];
+/** Valid implementation modes */
+const validImplementModes = ['claude-cli', 'claude-sdk', 'cursor'];
+/**
+ * Validate configuration
+ */
+function validateConfig(config) {
+    if (!config.specDir) {
+        throw new SpecLifeError(ErrorCodes.CONFIG_INVALID, 'specDir is required', { field: 'specDir' });
+    }
+    if (!['claude', 'openai', 'gemini'].includes(config.aiProvider)) {
+        throw new SpecLifeError(ErrorCodes.CONFIG_INVALID, `Invalid aiProvider: ${config.aiProvider}. Must be one of: claude, openai, gemini`, { field: 'aiProvider', value: config.aiProvider });
+    }
+    // Validate implementMode
+    if (config.implementMode && !validImplementModes.includes(config.implementMode)) {
+        throw new SpecLifeError(ErrorCodes.CONFIG_INVALID, `Invalid implementMode: ${config.implementMode}. Must be one of: ${validImplementModes.join(', ')}`, { field: 'implementMode', value: config.implementMode });
+    }
+    // Validate worktree.bootstrap.strategy
+    if (config.worktree?.bootstrap?.strategy) {
+        if (!validBootstrapStrategies.includes(config.worktree.bootstrap.strategy)) {
+            throw new SpecLifeError(ErrorCodes.CONFIG_INVALID, `Invalid worktree.bootstrap.strategy: ${config.worktree.bootstrap.strategy}. Must be one of: ${validBootstrapStrategies.join(', ')}`, { field: 'worktree.bootstrap.strategy', value: config.worktree.bootstrap.strategy });
+        }
+    }
+    // Validate per-environment strategies
+    if (config.worktree?.bootstrap?.environments) {
+        for (const [envName, envConfig] of Object.entries(config.worktree.bootstrap.environments)) {
+            if (envConfig.strategy && !validBootstrapStrategies.includes(envConfig.strategy)) {
+                throw new SpecLifeError(ErrorCodes.CONFIG_INVALID, `Invalid worktree.bootstrap.environments.${envName}.strategy: ${envConfig.strategy}. Must be one of: ${validBootstrapStrategies.join(', ')}`, { field: `worktree.bootstrap.environments.${envName}.strategy`, value: envConfig.strategy });
+            }
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @speclife/core
+ *
+ * Core library for SpecLife - adapters and workflows for spec-driven development.
+ */
+export * from './types.js';
+export { loadConfig, type SpecLifeConfig, type WorktreeConfig, type EnvironmentBootstrapConfig, } from './config.js';
+export * from './adapters/index.js';
+export * from './workflows/index.js';
+//# 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":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAC;AAGrB,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @speclife/core
+ *
+ * Core library for SpecLife - adapters and workflows for spec-driven development.
+ */
+// Re-export types
+export * from './types.js';
+// Re-export config
+export { loadConfig, } from './config.js';
+// Re-export adapters
+export * from './adapters/index.js';
+// Re-export workflows
+export * from './workflows/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,mBAAmB;AACnB,OAAO,EACL,UAAU,GAIX,MAAM,aAAa,CAAC;AAErB,qBAAqB;AACrB,cAAc,qBAAqB,CAAC;AAEpC,sBAAsB;AACtB,cAAc,sBAAsB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Core types for SpecLife
+ */
+/** Change lifecycle states */
+export type ChangeState = 'created' | 'implementing' | 'testing' | 'submitted' | 'merged';
+/** A change proposal context */
+export interface Change {
+    id: string;
+    branch: string;
+    state: ChangeState;
+    proposal: ChangeProposal;
+    tasks: ChangeTask[];
+    design?: string;
+    createdAt: Date;
+}
+/** Parsed proposal.md content */
+export interface ChangeProposal {
+    why: string;
+    whatChanges: string[];
+    impact: {
+        affectedSpecs: string[];
+        affectedCode: string[];
+    };
+}
+/** A task from tasks.md */
+export interface ChangeTask {
+    id: string;
+    content: string;
+    completed: boolean;
+}
+/** Git status information */
+export interface GitStatus {
+    current: string | null;
+    staged: string[];
+    unstaged: string[];
+    untracked: string[];
+}
+/** Pull request information */
+export interface PullRequest {
+    number: number;
+    url: string;
+    title: string;
+    state: 'open' | 'closed' | 'merged';
+    mergeable: boolean | null;
+    draft: boolean;
+}
+/** Structured error for SpecLife operations */
+export declare class SpecLifeError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, context?: Record<string, unknown> | undefined);
+}
+/** Common error codes */
+export declare const ErrorCodes: {
+    readonly CONFIG_INVALID: "CONFIG_INVALID";
+    readonly CHANGE_EXISTS: "CHANGE_EXISTS";
+    readonly CHANGE_NOT_FOUND: "CHANGE_NOT_FOUND";
+    readonly BRANCH_EXISTS: "BRANCH_EXISTS";
+    readonly NO_CHANGES: "NO_CHANGES";
+    readonly GITHUB_ERROR: "GITHUB_ERROR";
+    readonly AI_ERROR: "AI_ERROR";
+    readonly MISSING_TOKEN: "MISSING_TOKEN";
+    readonly CLI_NOT_FOUND: "CLI_NOT_FOUND";
+    readonly TEST_FAILED: "TEST_FAILED";
+};
+/** Implementation modes for speclife_implement */
+export type ImplementMode = 'claude-cli' | 'claude-sdk' | 'cursor';
+/** Options for the implement workflow */
+export interface ImplementOptions {
+    /** Change ID to implement */
+    changeId: string;
+    /** Implementation mode (default: from config or 'claude-cli') */
+    mode?: ImplementMode;
+    /** Specific task ID to implement (e.g., "1.2") */
+    taskId?: string;
+    /** Return plan without executing */
+    dryRun?: boolean;
+}
+/** Result of the implement workflow */
+export interface ImplementResult {
+    /** Mode used for implementation */
+    mode: ImplementMode;
+    /** Overall status */
+    status: 'success' | 'partial' | 'failed' | 'manual';
+    /** Human-readable output/summary */
+    output: string;
+    /** Tasks that were completed */
+    tasksCompleted: string[];
+    /** Tasks that failed (with reasons) */
+    tasksFailed?: Array<{
+        taskId: string;
+        reason: string;
+    }>;
+    /** For dry-run: the planned prompt/actions */
+    plan?: string;
+}
+/** Progress event emitted during long operations */
+export interface ProgressEvent {
+    type: 'task_started' | 'task_completed' | 'file_written' | 'step_completed';
+    message: string;
+    data?: Record<string, unknown>;
+}
+/** Progress callback type */
+export type ProgressCallback = (event: ProgressEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,28 @@
+/**
+ * Core types for SpecLife
+ */
+/** Structured error for SpecLife operations */
+export class SpecLifeError extends Error {
+    code;
+    context;
+    constructor(code, message, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'SpecLifeError';
+    }
+}
+/** Common error codes */
+export const ErrorCodes = {
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    CHANGE_EXISTS: 'CHANGE_EXISTS',
+    CHANGE_NOT_FOUND: 'CHANGE_NOT_FOUND',
+    BRANCH_EXISTS: 'BRANCH_EXISTS',
+    NO_CHANGES: 'NO_CHANGES',
+    GITHUB_ERROR: 'GITHUB_ERROR',
+    AI_ERROR: 'AI_ERROR',
+    MISSING_TOKEN: 'MISSING_TOKEN',
+    CLI_NOT_FOUND: 'CLI_NOT_FOUND',
+    TEST_FAILED: 'TEST_FAILED',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwDH,+CAA+C;AAC/C,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,yBAAyB;AACzB,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/dist/workflows/implement.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Implement workflow - AI-driven code implementation with multiple modes
+ *
+ * Supports three implementation modes:
+ * - claude-cli: Uses Claude CLI with MCP servers (primary)
+ * - claude-sdk: Direct Anthropic SDK with tool-use (fully automated)
+ * - cursor: Opens Cursor IDE for manual implementation
+ */
+import { type OpenSpecAdapter } from '../adapters/openspec-adapter.js';
+import { type ClaudeCliAdapter } from '../adapters/claude-cli-adapter.js';
+import { type ClaudeSdkAdapter } from '../adapters/claude-sdk-adapter.js';
+import { type CursorAdapter } from '../adapters/cursor-adapter.js';
+import { type SpecLifeConfig } from '../config.js';
+import { type ImplementOptions, type ImplementResult, type ProgressCallback } from '../types.js';
+/** Dependencies for the implement workflow */
+interface ImplementDependencies {
+    openspec: OpenSpecAdapter;
+    config: SpecLifeConfig;
+    claudeCli?: ClaudeCliAdapter;
+    claudeSdk?: ClaudeSdkAdapter;
+    cursor?: CursorAdapter;
+}
+/**
+ * Implement a change using the specified mode
+ */
+export declare function implementWorkflow(options: ImplementOptions, deps: ImplementDependencies, onProgress?: ProgressCallback): Promise<ImplementResult>;
+export type { ImplementDependencies };
+//# sourceMappingURL=implement.d.ts.map

package/dist/workflows/implement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../../src/workflows/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,aAAa,CAAC;AAErB,8CAA8C;AAC9C,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,qBAAqB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA6E1B;AAgTD,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/workflows/implement.js

@@ -0,0 +1,277 @@
+/**
+ * Implement workflow - AI-driven code implementation with multiple modes
+ *
+ * Supports three implementation modes:
+ * - claude-cli: Uses Claude CLI with MCP servers (primary)
+ * - claude-sdk: Direct Anthropic SDK with tool-use (fully automated)
+ * - cursor: Opens Cursor IDE for manual implementation
+ */
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { createClaudeCliAdapter, generateImplementationPrompt } from '../adapters/claude-cli-adapter.js';
+import { createClaudeSdkAdapter, generateAgenticSystemPrompt } from '../adapters/claude-sdk-adapter.js';
+import { createCursorAdapter } from '../adapters/cursor-adapter.js';
+import { SpecLifeError, ErrorCodes, } from '../types.js';
+/**
+ * Implement a change using the specified mode
+ */
+export async function implementWorkflow(options, deps, onProgress) {
+    const { changeId, taskId, dryRun = false } = options;
+    const mode = options.mode ?? deps.config.implementMode;
+    // Verify change exists
+    if (!await deps.openspec.changeExists(changeId)) {
+        throw new SpecLifeError(ErrorCodes.CHANGE_NOT_FOUND, `Change '${changeId}' not found`, { changeId });
+    }
+    onProgress?.({
+        type: 'step_completed',
+        message: `Starting implementation with mode: ${mode}`,
+        data: { mode, changeId },
+    });
+    // Read change context
+    const change = await deps.openspec.readChange(changeId);
+    const proposalContent = await readChangeFile(changeId, 'proposal.md', deps);
+    const tasksContent = await readChangeFile(changeId, 'tasks.md', deps);
+    const designContent = await readChangeFile(changeId, 'design.md', deps).catch(() => undefined);
+    // Filter tasks if taskId specified
+    let tasksToImplement = change.tasks.filter(t => !t.completed);
+    if (taskId) {
+        tasksToImplement = tasksToImplement.filter(t => t.id === taskId);
+        if (tasksToImplement.length === 0) {
+            throw new SpecLifeError(ErrorCodes.CHANGE_NOT_FOUND, `Task '${taskId}' not found or already completed`, { changeId, taskId });
+        }
+    }
+    onProgress?.({
+        type: 'step_completed',
+        message: `Found ${tasksToImplement.length} task(s) to implement`,
+        data: { taskCount: tasksToImplement.length },
+    });
+    // Gather additional context files
+    const contextFiles = await gatherContextFiles(deps.config.contextFiles ?? [], process.cwd());
+    // Dispatch based on mode
+    switch (mode) {
+        case 'claude-cli':
+            return implementWithClaudeCli({ changeId, proposalContent, tasksContent, designContent, contextFiles, tasksToImplement, dryRun }, deps, onProgress);
+        case 'claude-sdk':
+            return implementWithClaudeSdk({ changeId, proposalContent, tasksContent, designContent, contextFiles, tasksToImplement, dryRun }, deps, onProgress);
+        case 'cursor':
+            return implementWithCursor({ changeId, dryRun }, deps, onProgress);
+        default:
+            throw new SpecLifeError(ErrorCodes.CONFIG_INVALID, `Unknown implementation mode: ${mode}`, { mode });
+    }
+}
+/**
+ * Implement using Claude CLI
+ */
+async function implementWithClaudeCli(context, deps, onProgress) {
+    const cli = deps.claudeCli ?? createClaudeCliAdapter();
+    // Check if CLI is available
+    if (!await cli.isAvailable()) {
+        throw new SpecLifeError(ErrorCodes.CLI_NOT_FOUND, 'Claude CLI not found. Install from https://docs.anthropic.com/claude-cli or use mode: claude-sdk', { mode: 'claude-cli' });
+    }
+    // Generate the implementation prompt
+    const prompt = generateImplementationPrompt({
+        changeId: context.changeId,
+        proposal: context.proposalContent,
+        tasks: context.tasksContent,
+        design: context.designContent,
+        contextFiles: context.contextFiles,
+    });
+    if (context.dryRun) {
+        return {
+            mode: 'claude-cli',
+            status: 'success',
+            output: 'Dry run - no changes made',
+            tasksCompleted: [],
+            plan: prompt,
+        };
+    }
+    onProgress?.({
+        type: 'step_completed',
+        message: 'Invoking Claude CLI...',
+    });
+    // Run Claude CLI with streaming
+    const result = await cli.runStreaming(prompt, { cwd: process.cwd(), model: deps.config.aiModel }, (chunk) => {
+        onProgress?.({
+            type: 'step_completed',
+            message: chunk,
+            data: { streaming: true },
+        });
+    });
+    if (!result.success) {
+        return {
+            mode: 'claude-cli',
+            status: 'failed',
+            output: result.stderr || 'Claude CLI execution failed',
+            tasksCompleted: [],
+            tasksFailed: context.tasksToImplement.map(t => ({
+                taskId: t.id,
+                reason: 'CLI execution failed',
+            })),
+        };
+    }
+    // Parse output to detect completed tasks
+    // This is a simple heuristic - look for task IDs mentioned with completion indicators
+    const completedTasks = detectCompletedTasks(result.stdout, context.tasksToImplement);
+    return {
+        mode: 'claude-cli',
+        status: completedTasks.length === context.tasksToImplement.length ? 'success' : 'partial',
+        output: result.stdout,
+        tasksCompleted: completedTasks,
+    };
+}
+/**
+ * Implement using Claude SDK (fully automated)
+ */
+async function implementWithClaudeSdk(context, deps, onProgress) {
+    const sdk = deps.claudeSdk ?? createClaudeSdkAdapter();
+    // Check if API key is configured
+    if (!sdk.isConfigured()) {
+        throw new SpecLifeError(ErrorCodes.MISSING_TOKEN, 'ANTHROPIC_API_KEY environment variable required for claude-sdk mode', { mode: 'claude-sdk' });
+    }
+    // Generate prompts
+    const systemPrompt = generateAgenticSystemPrompt();
+    const userPrompt = generateImplementationPrompt({
+        changeId: context.changeId,
+        proposal: context.proposalContent,
+        tasks: context.tasksContent,
+        design: context.designContent,
+        contextFiles: context.contextFiles,
+    });
+    if (context.dryRun) {
+        return {
+            mode: 'claude-sdk',
+            status: 'success',
+            output: 'Dry run - no changes made',
+            tasksCompleted: [],
+            plan: `System prompt:\n${systemPrompt}\n\nUser prompt:\n${userPrompt}`,
+        };
+    }
+    onProgress?.({
+        type: 'step_completed',
+        message: 'Starting agentic implementation loop...',
+    });
+    // Run the agentic loop
+    const result = await sdk.runAgenticLoop(systemPrompt, userPrompt, {
+        cwd: process.cwd(),
+        model: deps.config.aiModel,
+        maxIterations: 50,
+        onProgress,
+    });
+    if (!result.success) {
+        return {
+            mode: 'claude-sdk',
+            status: 'failed',
+            output: result.errors.join('\n'),
+            tasksCompleted: [],
+            tasksFailed: context.tasksToImplement.map(t => ({
+                taskId: t.id,
+                reason: result.errors[0] ?? 'Unknown error',
+            })),
+        };
+    }
+    // Detect completed tasks from the final response
+    const completedTasks = detectCompletedTasks(result.finalResponse, context.tasksToImplement);
+    onProgress?.({
+        type: 'step_completed',
+        message: `Implementation complete. ${result.iterations} iterations, ${result.filesModified.length} files modified`,
+        data: { iterations: result.iterations, filesModified: result.filesModified },
+    });
+    return {
+        mode: 'claude-sdk',
+        status: completedTasks.length === context.tasksToImplement.length ? 'success' : 'partial',
+        output: result.finalResponse,
+        tasksCompleted: completedTasks,
+    };
+}
+/**
+ * Implement using Cursor IDE (manual)
+ */
+async function implementWithCursor(context, deps, onProgress) {
+    const cursor = deps.cursor ?? createCursorAdapter();
+    // Check if Cursor is available
+    if (!await cursor.isAvailable()) {
+        throw new SpecLifeError(ErrorCodes.CLI_NOT_FOUND, "Cursor CLI not found. Install Cursor and ensure 'cursor' command is available", { mode: 'cursor' });
+    }
+    const worktreePath = process.cwd();
+    if (context.dryRun) {
+        return {
+            mode: 'cursor',
+            status: 'success',
+            output: 'Dry run - no changes made',
+            tasksCompleted: [],
+            plan: `Would open Cursor at: ${worktreePath}`,
+        };
+    }
+    onProgress?.({
+        type: 'step_completed',
+        message: 'Opening Cursor IDE...',
+    });
+    // Open Cursor
+    const result = await cursor.open(worktreePath);
+    if (!result.success) {
+        return {
+            mode: 'cursor',
+            status: 'failed',
+            output: result.message,
+            tasksCompleted: [],
+        };
+    }
+    return {
+        mode: 'cursor',
+        status: 'manual',
+        output: `Cursor opened at: ${worktreePath}\n\nImplement the tasks manually using Cursor's AI features, then mark them complete in tasks.md.`,
+        tasksCompleted: [],
+    };
+}
+/**
+ * Read a file from the change directory
+ */
+async function readChangeFile(changeId, filename, deps) {
+    const changePath = join(process.cwd(), deps.config.specDir, 'changes', changeId, filename);
+    return readFile(changePath, 'utf-8');
+}
+/**
+ * Gather context files from the project
+ */
+async function gatherContextFiles(paths, projectRoot) {
+    const files = [];
+    for (const path of paths) {
+        try {
+            const fullPath = join(projectRoot, path);
+            const content = await readFile(fullPath, 'utf-8');
+            files.push({ path, content });
+        }
+        catch {
+            // Skip files that don't exist or can't be read
+        }
+    }
+    return files;
+}
+/**
+ * Detect which tasks were completed based on output text
+ * This is a heuristic that looks for task IDs with completion indicators
+ */
+function detectCompletedTasks(output, tasks) {
+    const completed = [];
+    // Look for patterns like "completed task 1.1", "✓ 1.1", "task 1.1 done", etc.
+    const completionPatterns = [
+        /completed?\s+(?:task\s+)?(\d+\.\d+)/gi,
+        /✓\s*(\d+\.\d+)/g,
+        /(?:task\s+)?(\d+\.\d+)\s+(?:done|complete|finished)/gi,
+        /\[x\]\s*(\d+\.\d+)/gi,
+    ];
+    for (const task of tasks) {
+        for (const pattern of completionPatterns) {
+            pattern.lastIndex = 0; // Reset regex state
+            let match;
+            while ((match = pattern.exec(output)) !== null) {
+                if (match[1] === task.id) {
+                    completed.push(task.id);
+                    break;
+                }
+            }
+        }
+    }
+    return [...new Set(completed)]; // Remove duplicates
+}
+//# sourceMappingURL=implement.js.map