red64-cli 0.1.0

package/dist/services/SpecInitService.js

@@ -0,0 +1,168 @@
+/**
+ * Spec Initialization Service
+ * Creates the spec directory structure with templates
+ * Replaces the /red64:spec-init command for orchestrator use
+ */
+import { mkdir, writeFile, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { sanitizeFeatureName } from './WorktreeService.js';
+/**
+ * Default spec.json template content
+ */
+const DEFAULT_SPEC_JSON_TEMPLATE = `{
+  "feature_name": "{{FEATURE_NAME}}",
+  "created_at": "{{TIMESTAMP}}",
+  "updated_at": "{{TIMESTAMP}}",
+  "language": "en",
+  "phase": "initialized",
+  "approvals": {
+    "requirements": {
+      "generated": false,
+      "approved": false
+    },
+    "design": {
+      "generated": false,
+      "approved": false
+    },
+    "tasks": {
+      "generated": false,
+      "approved": false
+    }
+  },
+  "ready_for_implementation": false
+}
+`;
+/**
+ * Default requirements.md template content
+ */
+const DEFAULT_REQUIREMENTS_TEMPLATE = `# Requirements Document
+
+## Project Description (Input)
+{{PROJECT_DESCRIPTION}}
+
+## Requirements
+<!-- Will be generated in /red64:spec-requirements phase -->
+
+`;
+/**
+ * Replace template placeholders
+ */
+function replacePlaceholders(template, featureName, description) {
+    const timestamp = new Date().toISOString();
+    return template
+        .replace(/\{\{FEATURE_NAME\}\}/g, featureName)
+        .replace(/\{\{TIMESTAMP\}\}/g, timestamp)
+        .replace(/\{\{PROJECT_DESCRIPTION\}\}/g, description);
+}
+/**
+ * Read template file or return default
+ */
+async function readTemplateOrDefault(workDir, templatePath, defaultContent) {
+    const fullPath = join(workDir, templatePath);
+    if (existsSync(fullPath)) {
+        try {
+            return await readFile(fullPath, 'utf-8');
+        }
+        catch {
+            return defaultContent;
+        }
+    }
+    return defaultContent;
+}
+/**
+ * Check if spec already exists
+ * Returns true if spec directory exists with spec.json
+ */
+async function specExists(workDir, featureName) {
+    const specJsonPath = join(workDir, '.red64', 'specs', featureName, 'spec.json');
+    return existsSync(specJsonPath);
+}
+/**
+ * Create spec init service
+ */
+export function createSpecInitService() {
+    return {
+        /**
+         * Initialize spec directory and files from templates
+         *
+         * Uses the sanitized feature name consistently (same as worktree/branch naming).
+         * If spec already exists, returns success without overwriting (supports resume).
+         *
+         * 1. Sanitize feature name (consistent with worktree naming)
+         * 2. Check if spec already exists (skip if so)
+         * 3. Create directory .red64/specs/[feature-name]/
+         * 4. Read templates and replace placeholders
+         * 5. Write spec.json and requirements.md
+         */
+        async init(workDir, featureName, description) {
+            const sanitizedName = sanitizeFeatureName(featureName);
+            const specDir = join(workDir, '.red64', 'specs', sanitizedName);
+            try {
+                // Check if spec already exists (resume scenario)
+                if (await specExists(workDir, sanitizedName)) {
+                    return {
+                        success: true,
+                        specDir,
+                        featureName: sanitizedName
+                    };
+                }
+                // Create spec directory
+                await mkdir(specDir, { recursive: true });
+                // Read templates (with fallback to defaults)
+                const specJsonTemplate = await readTemplateOrDefault(workDir, '.red64/settings/templates/specs/init.json', DEFAULT_SPEC_JSON_TEMPLATE);
+                const requirementsTemplate = await readTemplateOrDefault(workDir, '.red64/settings/templates/specs/requirements-init.md', DEFAULT_REQUIREMENTS_TEMPLATE);
+                // Replace placeholders
+                const specJsonContent = replacePlaceholders(specJsonTemplate, sanitizedName, description);
+                const requirementsContent = replacePlaceholders(requirementsTemplate, sanitizedName, description);
+                // Write files
+                await writeFile(join(specDir, 'spec.json'), specJsonContent, 'utf-8');
+                await writeFile(join(specDir, 'requirements.md'), requirementsContent, 'utf-8');
+                return {
+                    success: true,
+                    specDir,
+                    featureName: sanitizedName
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    specDir,
+                    featureName: sanitizedName,
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                };
+            }
+        },
+        /**
+         * Update spec.json when tasks are approved
+         * Sets tasks.approved = true and ready_for_implementation = true
+         * This is called by the orchestrator when transitioning from tasks-approval to implementing
+         */
+        async updateTaskApproval(workDir, featureName) {
+            const sanitizedName = sanitizeFeatureName(featureName);
+            const specJsonPath = join(workDir, '.red64', 'specs', sanitizedName, 'spec.json');
+            try {
+                // Read existing spec.json
+                const specJsonContent = await readFile(specJsonPath, 'utf-8');
+                const specJson = JSON.parse(specJsonContent);
+                // Update approval flags
+                specJson.approvals.tasks.approved = true;
+                specJson.approvals.tasks.approvedAt = new Date().toISOString();
+                specJson.approvals.tasks.approvedBy = 'orchestrator';
+                specJson.ready_for_implementation = true;
+                specJson.phase = 'ready-for-implementation';
+                specJson.updated_at = new Date().toISOString();
+                // Write back
+                await writeFile(specJsonPath, JSON.stringify(specJson, null, 2), 'utf-8');
+                return { success: true };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Failed to update spec.json'
+                };
+            }
+        }
+    };
+}
+//# sourceMappingURL=SpecInitService.js.map

package/dist/services/SpecInitService.js.map

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

package/dist/services/StateStore.d.ts

@@ -0,0 +1,24 @@
+/**
+ * State persistence service
+ * Requirements: 1.5, 1.7, 8.2
+ */
+import type { FlowState } from '../types/index.js';
+/**
+ * State store service interface
+ * Requirements: 1.5 - Persist and restore flow state through TypeScript file I/O
+ * Task 1.4: Extended with archive capability for abort flows
+ */
+export interface StateStoreService {
+    save(state: FlowState): Promise<void>;
+    load(feature: string): Promise<FlowState | undefined>;
+    list(): Promise<readonly FlowState[]>;
+    delete(feature: string): Promise<void>;
+    exists(feature: string): Promise<boolean>;
+    archive(feature: string): Promise<void>;
+}
+/**
+ * Create state store service
+ * Requirements: 1.5 - State persistence service factory
+ */
+export declare function createStateStore(baseDir: string): StateStoreService;
+//# sourceMappingURL=StateStore.d.ts.map

package/dist/services/StateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.d.ts","sourceRoot":"","sources":["../../src/services/StateStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACtD,IAAI,IAAI,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAgDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAkInE"}

package/dist/services/StateStore.js

@@ -0,0 +1,171 @@
+/**
+ * State persistence service
+ * Requirements: 1.5, 1.7, 8.2
+ */
+import { mkdir, readFile, writeFile, rm, readdir, rename, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { sanitizeFeatureName } from './WorktreeService.js';
+/**
+ * Get flows directory path
+ * Requirements: 8.2 - Use .red64/ as the unified directory
+ */
+function getFlowsDir(baseDir) {
+    return join(baseDir, '.red64', 'flows');
+}
+/**
+ * Get feature state file path
+ */
+function getStatePath(baseDir, feature) {
+    return join(getFlowsDir(baseDir), sanitizeFeatureName(feature), 'state.json');
+}
+/**
+ * Get feature directory path
+ */
+function getFeatureDir(baseDir, feature) {
+    return join(getFlowsDir(baseDir), sanitizeFeatureName(feature));
+}
+/**
+ * Validate loaded state structure
+ * Requirements: 1.7 - Validate state on load
+ */
+function isValidFlowState(data) {
+    if (typeof data !== 'object' || data === null) {
+        return false;
+    }
+    const obj = data;
+    return (typeof obj.feature === 'string' &&
+        typeof obj.phase === 'object' &&
+        obj.phase !== null &&
+        typeof obj.phase.type === 'string' &&
+        typeof obj.createdAt === 'string' &&
+        typeof obj.updatedAt === 'string' &&
+        Array.isArray(obj.history) &&
+        typeof obj.metadata === 'object' &&
+        obj.metadata !== null);
+}
+/**
+ * Create state store service
+ * Requirements: 1.5 - State persistence service factory
+ */
+export function createStateStore(baseDir) {
+    return {
+        /**
+         * Save flow state
+         * Requirements: 1.5 - Use atomic write pattern (temp file + rename)
+         */
+        async save(state) {
+            const featureDir = getFeatureDir(baseDir, state.feature);
+            const statePath = getStatePath(baseDir, state.feature);
+            // Ensure directory exists
+            await mkdir(featureDir, { recursive: true });
+            // Atomic write: write to temp file, then rename
+            const tempPath = join(featureDir, `state.${randomBytes(8).toString('hex')}.tmp`);
+            try {
+                await writeFile(tempPath, JSON.stringify(state, null, 2), 'utf-8');
+                await rename(tempPath, statePath);
+            }
+            catch (error) {
+                // Clean up temp file on error
+                try {
+                    await rm(tempPath, { force: true });
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+                throw error;
+            }
+        },
+        /**
+         * Load flow state
+         * Requirements: 1.5, 1.7 - Read and validate persisted state
+         */
+        async load(feature) {
+            const statePath = getStatePath(baseDir, feature);
+            try {
+                const content = await readFile(statePath, 'utf-8');
+                const data = JSON.parse(content);
+                if (!isValidFlowState(data)) {
+                    // Invalid state file - treat as non-existent
+                    return undefined;
+                }
+                return data;
+            }
+            catch {
+                // File doesn't exist or couldn't be read
+                return undefined;
+            }
+        },
+        /**
+         * List all flow states
+         * Requirements: 1.5 - Flow management operations
+         */
+        async list() {
+            const flowsDir = getFlowsDir(baseDir);
+            try {
+                const entries = await readdir(flowsDir, { withFileTypes: true });
+                const features = entries
+                    .filter(entry => entry.isDirectory())
+                    .map(entry => entry.name);
+                const states = [];
+                for (const feature of features) {
+                    const state = await this.load(feature);
+                    if (state) {
+                        states.push(state);
+                    }
+                }
+                return states;
+            }
+            catch {
+                // Directory doesn't exist
+                return [];
+            }
+        },
+        /**
+         * Delete flow state
+         * Requirements: 1.5 - Flow cleanup on abort
+         */
+        async delete(feature) {
+            const featureDir = getFeatureDir(baseDir, feature);
+            try {
+                await rm(featureDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore errors - feature may not exist
+            }
+        },
+        /**
+         * Check if flow exists
+         * Requirements: 1.5 - Quick existence check
+         */
+        async exists(feature) {
+            const statePath = getStatePath(baseDir, feature);
+            try {
+                await access(statePath);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        /**
+         * Archive flow state for historical preservation
+         * Task 1.4: Rename state.json to state.archived.json
+         * Requirements: 4.5 - Archive flow state on abort
+         */
+        async archive(feature) {
+            const statePath = getStatePath(baseDir, feature);
+            const featureDir = getFeatureDir(baseDir, feature);
+            const archivePath = join(featureDir, 'state.archived.json');
+            try {
+                await access(statePath);
+                // Atomic rename for archive
+                await rename(statePath, archivePath);
+            }
+            catch {
+                // State file doesn't exist - nothing to archive
+            }
+        }
+    };
+}
+//# sourceMappingURL=StateStore.js.map

package/dist/services/StateStore.js.map

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

package/dist/services/TaskParser.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Task Parser Service
+ * Task 4.1: Create task parser to extract tasks from tasks.md
+ * Requirements: 5.1
+ */
+/**
+ * Task interface
+ * Requirements: 5.1 - Extract task ID, title, description, completion status
+ */
+export interface Task {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly completed: boolean;
+    readonly priority: boolean;
+    readonly hasAsterisk: boolean;
+}
+/**
+ * Result of marking a task complete
+ */
+export interface MarkTaskCompleteResult {
+    readonly success: boolean;
+    readonly error?: string;
+}
+/**
+ * Task parser service interface
+ * Requirements: 5.1
+ */
+export interface TaskParserService {
+    parse(specDir: string): Promise<readonly Task[]>;
+    getPendingTasks(tasks: readonly Task[]): readonly Task[];
+    getTaskById(tasks: readonly Task[], id: string): Task | undefined;
+    /**
+     * Mark a task as complete in tasks.md (orchestrator-controlled)
+     * Updates checkbox from [ ] to [x]
+     */
+    markTaskComplete(specDir: string, taskId: string): Promise<MarkTaskCompleteResult>;
+}
+/**
+ * Create task parser service
+ * Requirements: 5.1 - Factory function for task parsing
+ */
+export declare function createTaskParser(): TaskParserService;
+//# sourceMappingURL=TaskParser.d.ts.map

package/dist/services/TaskParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskParser.d.ts","sourceRoot":"","sources":["../../src/services/TaskParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACjD,eAAe,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,SAAS,IAAI,EAAE,CAAC;IACzD,WAAW,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClE;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpF;AAgED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAuHpD"}

package/dist/services/TaskParser.js

@@ -0,0 +1,167 @@
+/**
+ * Task Parser Service
+ * Task 4.1: Create task parser to extract tasks from tasks.md
+ * Requirements: 5.1
+ */
+import { readFile, writeFile, rename, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+/**
+ * Task line pattern
+ * Matches: - [ ] 1.1 Task title or - [x] 1.1 Task title
+ * Also handles: - [ ]* 1.1 (P) Task title
+ */
+const TASK_LINE_PATTERN = /^-\s+\[([ x])\](\*)?\s+(\d+\.\d+)\s+(?:\(P\)\s+)?(.+)$/;
+/**
+ * Check if a line is a task line (subtask with number like 1.1, 2.3, etc.)
+ */
+function isTaskLine(line) {
+    return TASK_LINE_PATTERN.test(line.trim());
+}
+/**
+ * Parse a single task line
+ */
+function parseTaskLine(line) {
+    const match = line.trim().match(TASK_LINE_PATTERN);
+    if (!match) {
+        return null;
+    }
+    const [, checkmark, asterisk, id, titlePart] = match;
+    const completed = checkmark === 'x';
+    const hasAsterisk = asterisk === '*';
+    const priority = line.includes('(P)');
+    const title = titlePart.trim();
+    return { id, title, completed, priority, hasAsterisk };
+}
+/**
+ * Parse task description from indented lines following the task line
+ */
+function parseDescription(lines, startIndex) {
+    const descriptionLines = [];
+    for (let i = startIndex; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Stop at next task line or empty line sequence
+        if (isTaskLine(line) || line.match(/^-\s+\[\s*[x ]?\s*\]\s+\d+\./)) {
+            break;
+        }
+        // Include indented description lines (starting with -)
+        if (trimmed.startsWith('-') && !trimmed.startsWith('- [')) {
+            descriptionLines.push(trimmed.substring(1).trim());
+        }
+    }
+    return descriptionLines.join('\n');
+}
+/**
+ * Create task parser service
+ * Requirements: 5.1 - Factory function for task parsing
+ */
+export function createTaskParser() {
+    return {
+        /**
+         * Parse tasks.md from specification directory
+         * Requirements: 5.1 - Read and parse tasks.md
+         */
+        async parse(specDir) {
+            const tasksPath = join(specDir, 'tasks.md');
+            let content;
+            try {
+                content = await readFile(tasksPath, 'utf-8');
+            }
+            catch {
+                // File doesn't exist or couldn't be read
+                return [];
+            }
+            const lines = content.split('\n');
+            const tasks = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (isTaskLine(line)) {
+                    const parsed = parseTaskLine(line);
+                    if (parsed) {
+                        const description = parseDescription(lines, i + 1);
+                        tasks.push({
+                            id: parsed.id,
+                            title: parsed.title,
+                            description,
+                            completed: parsed.completed,
+                            priority: parsed.priority,
+                            hasAsterisk: parsed.hasAsterisk
+                        });
+                    }
+                }
+            }
+            return tasks;
+        },
+        /**
+         * Filter to get only pending (uncompleted) tasks
+         * Requirements: 5.1 - Track completion status
+         */
+        getPendingTasks(tasks) {
+            return tasks.filter(task => !task.completed);
+        },
+        /**
+         * Find task by ID
+         * Requirements: 5.1 - Access tasks by identifier
+         */
+        getTaskById(tasks, id) {
+            return tasks.find(task => task.id === id);
+        },
+        /**
+         * Mark a task as complete in tasks.md
+         * Orchestrator-controlled: updates checkbox from [ ] to [x]
+         * Uses atomic write pattern (temp file + rename)
+         */
+        async markTaskComplete(specDir, taskId) {
+            const tasksPath = join(specDir, 'tasks.md');
+            let content;
+            try {
+                content = await readFile(tasksPath, 'utf-8');
+            }
+            catch {
+                return { success: false, error: `Cannot read tasks.md at ${tasksPath}` };
+            }
+            const lines = content.split('\n');
+            let found = false;
+            // Find and update the task line
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                // Match: - [ ] taskId or - [ ]* taskId (with optional asterisk)
+                // Pattern: starts with "- [ ]" optionally followed by "*", then the task ID
+                const taskPattern = new RegExp(`^(-\\s+\\[) (\\]\\*?\\s+${taskId.replace('.', '\\.')}\\s)`);
+                const match = line.match(taskPattern);
+                if (match) {
+                    // Replace [ ] with [x]
+                    lines[i] = line.replace(taskPattern, '$1x$2');
+                    found = true;
+                    break;
+                }
+            }
+            if (!found) {
+                return { success: false, error: `Task ${taskId} not found in tasks.md` };
+            }
+            // Atomic write: temp file + rename
+            const tempPath = join(specDir, `tasks.${randomBytes(8).toString('hex')}.tmp`);
+            const newContent = lines.join('\n');
+            try {
+                await writeFile(tempPath, newContent, 'utf-8');
+                await rename(tempPath, tasksPath);
+                return { success: true };
+            }
+            catch (error) {
+                // Clean up temp file on error
+                try {
+                    await rm(tempPath, { force: true });
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Failed to write tasks.md'
+                };
+            }
+        }
+    };
+}
+//# sourceMappingURL=TaskParser.js.map

package/dist/services/TaskParser.js.map

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

package/dist/services/TaskRunner.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Task Runner Service
+ * Task 4.2: Implement task runner for incremental implementation execution
+ * Requirements: 5.2, 5.3, 5.4
+ */
+import type { AgentInvokerService } from './AgentInvoker.js';
+import type { CommitServiceInterface } from './CommitService.js';
+import type { TaskParserService, Task } from './TaskParser.js';
+import type { GlobalFlags } from '../types/index.js';
+/**
+ * Checkpoint decision type
+ * Requirements: 5.5 - Support continue, pause, and abort at checkpoints
+ */
+export type CheckpointDecision = 'continue' | 'pause' | 'abort';
+/**
+ * Task execution options
+ * Requirements: 5.2 - Execute tasks with configurable options
+ */
+export interface TaskExecutionOptions {
+    readonly feature: string;
+    readonly specDir: string;
+    readonly workingDir: string;
+    readonly startFromTask: number;
+    readonly onProgress: (current: number, total: number, task: Task) => void;
+    readonly onCheckpoint: (current: number, total: number) => Promise<CheckpointDecision>;
+    readonly flags: GlobalFlags;
+}
+/**
+ * Task execution result
+ * Requirements: 5.4 - Track progress and completion
+ */
+export interface TaskExecutionResult {
+    readonly success: boolean;
+    readonly completedTasks: number;
+    readonly totalTasks: number;
+    readonly pausedAt: number | undefined;
+    readonly error: string | undefined;
+}
+/**
+ * Task runner service interface
+ * Requirements: 5.2, 5.3, 5.4
+ */
+export interface TaskRunnerService {
+    execute(options: TaskExecutionOptions): Promise<TaskExecutionResult>;
+    abort(): void;
+}
+/**
+ * Create task runner service
+ * Requirements: 5.2, 5.3, 5.4 - Factory function for task execution
+ */
+export declare function createTaskRunner(agentInvoker: AgentInvokerService, commitService: CommitServiceInterface, taskParser: TaskParserService): TaskRunnerService;
+//# sourceMappingURL=TaskRunner.d.ts.map

package/dist/services/TaskRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRunner.d.ts","sourceRoot":"","sources":["../../src/services/TaskRunner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC1E,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrE,KAAK,IAAI,IAAI,CAAC;CACf;AA2BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,mBAAmB,EACjC,aAAa,EAAE,sBAAsB,EACrC,UAAU,EAAE,iBAAiB,GAC5B,iBAAiB,CAyHnB"}