rafcode 1.0.0

package/dist/core/project-manager.js

@@ -0,0 +1,193 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getRafDir, ensureRafDir, getNextProjectNumber, formatProjectNumber, getProjectDir, getPlansDir, getOutcomesDir, getDecisionsPath, getInputPath, listProjects, } from '../utils/paths.js';
+import { sanitizeProjectName } from '../utils/validation.js';
+import { logger } from '../utils/logger.js';
+import { deriveProjectState, getDerivedStats } from './state-derivation.js';
+export class ProjectManager {
+    rafDir;
+    constructor() {
+        this.rafDir = getRafDir();
+    }
+    /**
+     * Create a new project folder with initial structure.
+     * Returns the project path.
+     */
+    createProject(projectName) {
+        ensureRafDir();
+        const sanitizedName = sanitizeProjectName(projectName);
+        const projectNumber = getNextProjectNumber(this.rafDir);
+        const folderName = `${formatProjectNumber(projectNumber)}-${sanitizedName}`;
+        const projectPath = path.join(this.rafDir, folderName);
+        // Create directory structure
+        fs.mkdirSync(projectPath, { recursive: true });
+        fs.mkdirSync(getPlansDir(projectPath), { recursive: true });
+        fs.mkdirSync(getOutcomesDir(projectPath), { recursive: true });
+        // Create empty decisions.md file
+        fs.writeFileSync(getDecisionsPath(projectPath), '# Project Decisions\n');
+        logger.debug(`Created project at ${projectPath}`);
+        return projectPath;
+    }
+    /**
+     * Find an existing project by name.
+     */
+    findProject(projectName) {
+        return getProjectDir(this.rafDir, projectName);
+    }
+    /**
+     * List all projects with derived state information.
+     */
+    listProjects() {
+        const projects = listProjects(this.rafDir);
+        return projects.map((p) => {
+            const info = {
+                number: p.number,
+                name: p.name,
+                path: p.path,
+            };
+            // Derive state from folder structure
+            try {
+                const state = deriveProjectState(p.path);
+                const stats = getDerivedStats(state);
+                info.taskCount = stats.total;
+                info.completedCount = stats.completed;
+                info.failedCount = stats.failed;
+            }
+            catch {
+                // Failed to derive state
+            }
+            return info;
+        });
+    }
+    /**
+     * Save user input to input.md.
+     */
+    saveInput(projectPath, content) {
+        const inputPath = getInputPath(projectPath);
+        fs.writeFileSync(inputPath, content);
+        logger.debug(`Saved input to ${inputPath}`);
+    }
+    /**
+     * Read user input from input.md.
+     */
+    readInput(projectPath) {
+        const inputPath = getInputPath(projectPath);
+        if (!fs.existsSync(inputPath)) {
+            throw new Error(`Input file not found: ${inputPath}`);
+        }
+        return fs.readFileSync(inputPath, 'utf-8');
+    }
+    /**
+     * Save an outcome file for a completed task.
+     */
+    saveOutcome(projectPath, taskId, content) {
+        const outcomesDir = getOutcomesDir(projectPath);
+        if (!fs.existsSync(outcomesDir)) {
+            fs.mkdirSync(outcomesDir, { recursive: true });
+        }
+        // Find the plan file name to match naming convention
+        const plansDir = getPlansDir(projectPath);
+        const planFiles = fs.readdirSync(plansDir);
+        const planFile = planFiles.find((f) => f.startsWith(`${taskId}-`));
+        const outcomeName = planFile ?? `${taskId}-task.md`;
+        const outcomePath = path.join(outcomesDir, outcomeName);
+        fs.writeFileSync(outcomePath, content);
+        logger.debug(`Saved outcome to ${outcomePath}`);
+    }
+    /**
+     * Read all outcomes for context.
+     */
+    readOutcomes(projectPath) {
+        const outcomesDir = getOutcomesDir(projectPath);
+        if (!fs.existsSync(outcomesDir)) {
+            return [];
+        }
+        const outcomes = [];
+        const files = fs.readdirSync(outcomesDir).filter((f) => f.endsWith('.md')).sort();
+        for (const file of files) {
+            const match = file.match(/^(\d{2,3})-/);
+            if (match && match[1]) {
+                const content = fs.readFileSync(path.join(outcomesDir, file), 'utf-8');
+                outcomes.push({ taskId: match[1], content });
+            }
+        }
+        return outcomes;
+    }
+    /**
+     * Save a log file to the project's logs directory.
+     */
+    saveLog(projectPath, taskId, content) {
+        const logsDir = path.join(projectPath, 'logs');
+        if (!fs.existsSync(logsDir)) {
+            fs.mkdirSync(logsDir, { recursive: true });
+        }
+        const logPath = path.join(logsDir, `${taskId}-task.log`);
+        fs.writeFileSync(logPath, content);
+        logger.debug(`Saved log to ${logPath}`);
+    }
+    /**
+     * Read a plan file.
+     */
+    readPlan(projectPath, planFile) {
+        const planPath = path.join(projectPath, planFile);
+        if (!fs.existsSync(planPath)) {
+            throw new Error(`Plan file not found: ${planPath}`);
+        }
+        return fs.readFileSync(planPath, 'utf-8');
+    }
+    /**
+     * Get absolute path to a plan file.
+     */
+    getPlanPath(projectPath, planFile) {
+        return path.join(projectPath, planFile);
+    }
+    /**
+     * Ensure logs directory exists in project folder.
+     */
+    ensureLogsDir(projectPath) {
+        const logsDir = path.join(projectPath, 'logs');
+        if (!fs.existsSync(logsDir)) {
+            fs.mkdirSync(logsDir, { recursive: true });
+        }
+    }
+    /**
+     * Check if a project folder is empty (contains no plan files).
+     * Returns true if the folder has no plan files, false otherwise.
+     */
+    isProjectFolderEmpty(projectPath) {
+        if (!fs.existsSync(projectPath)) {
+            return true;
+        }
+        const plansDir = getPlansDir(projectPath);
+        // If plans directory doesn't exist, consider it empty
+        if (!fs.existsSync(plansDir)) {
+            return true;
+        }
+        // Check if there are any .md files in the plans directory
+        const planFiles = fs.readdirSync(plansDir).filter((f) => f.endsWith('.md'));
+        return planFiles.length === 0;
+    }
+    /**
+     * Clean up an empty project folder.
+     * Only removes the folder if it contains no plan files.
+     * This is idempotent - safe to call multiple times.
+     */
+    cleanupEmptyProject(projectPath) {
+        if (!fs.existsSync(projectPath)) {
+            logger.debug(`Project folder does not exist: ${projectPath}`);
+            return;
+        }
+        if (!this.isProjectFolderEmpty(projectPath)) {
+            logger.debug(`Project folder is not empty (has plans), skipping cleanup: ${projectPath}`);
+            return;
+        }
+        try {
+            fs.rmSync(projectPath, { recursive: true, force: true });
+            logger.debug(`Cleaned up empty project folder: ${projectPath}`);
+        }
+        catch (error) {
+            logger.warn(`Failed to clean up empty project folder: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=project-manager.js.map

package/dist/core/project-manager.js.map

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

package/dist/core/retry-handler.d.ts

@@ -0,0 +1,19 @@
+export interface RetryOptions {
+    maxRetries: number;
+    onRetry?: (attempt: number, error: Error) => void;
+}
+export interface RetryResult<T> {
+    success: boolean;
+    result?: T;
+    attempts: number;
+    lastError?: Error;
+}
+/**
+ * Execute a function with retry logic.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<RetryResult<T>>;
+/**
+ * Determine if an error is retryable.
+ */
+export declare function isRetryableError(error: Error): boolean;
+//# sourceMappingURL=retry-handler.d.ts.map

package/dist/core/retry-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-handler.d.ts","sourceRoot":"","sources":["../../src/core/retry-handler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CA2BzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAmBtD"}

package/dist/core/retry-handler.js

@@ -0,0 +1,51 @@
+import { logger } from '../utils/logger.js';
+/**
+ * Execute a function with retry logic.
+ */
+export async function withRetry(fn, options) {
+    const { maxRetries, onRetry } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const result = await fn();
+            return {
+                success: true,
+                result,
+                attempts: attempt,
+            };
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < maxRetries) {
+                logger.debug(`Attempt ${attempt} failed, retrying...`);
+                onRetry?.(attempt, lastError);
+            }
+        }
+    }
+    return {
+        success: false,
+        attempts: maxRetries,
+        lastError,
+    };
+}
+/**
+ * Determine if an error is retryable.
+ */
+export function isRetryableError(error) {
+    const message = error.message.toLowerCase();
+    // Non-retryable errors
+    const nonRetryable = [
+        'context overflow',
+        'token limit',
+        'rate limit exceeded',
+        'authentication failed',
+        'permission denied',
+    ];
+    for (const pattern of nonRetryable) {
+        if (message.includes(pattern)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=retry-handler.js.map

package/dist/core/retry-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-handler.js","sourceRoot":"","sources":["../../src/core/retry-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAc5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,OAAqB;IAErB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACxC,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;gBACN,QAAQ,EAAE,OAAO;aAClB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,sBAAsB,CAAC,CAAC;gBACvD,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,UAAU;QACpB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAE5C,uBAAuB;IACvB,MAAM,YAAY,GAAG;QACnB,kBAAkB;QAClB,aAAa;QACb,qBAAqB;QACrB,uBAAuB;QACvB,mBAAmB;KACpB,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/shutdown-handler.d.ts

@@ -0,0 +1,30 @@
+import { ClaudeRunner } from './claude-runner.js';
+type CleanupCallback = () => void | Promise<void>;
+declare class ShutdownHandler {
+    private claudeRunner;
+    private cleanupCallbacks;
+    private isShuttingDown;
+    /**
+     * Register a Claude runner to be killed on shutdown.
+     */
+    registerClaudeRunner(runner: ClaudeRunner): void;
+    /**
+     * Register a custom cleanup callback.
+     */
+    onShutdown(callback: CleanupCallback): void;
+    /**
+     * Initialize signal handlers.
+     */
+    init(): void;
+    /**
+     * Handle graceful shutdown.
+     */
+    private handleShutdown;
+    /**
+     * Clear registrations (useful for testing).
+     */
+    clear(): void;
+}
+export declare const shutdownHandler: ShutdownHandler;
+export {};
+//# sourceMappingURL=shutdown-handler.d.ts.map

package/dist/core/shutdown-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-handler.d.ts","sourceRoot":"","sources":["../../src/core/shutdown-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,KAAK,eAAe,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElD,cAAM,eAAe;IACnB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,cAAc,CAAS;IAE/B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIhD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI3C;;OAEG;IACH,IAAI,IAAI,IAAI;IAgBZ;;OAEG;YACW,cAAc;IAqC5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/core/shutdown-handler.js

@@ -0,0 +1,79 @@
+import { logger } from '../utils/logger.js';
+class ShutdownHandler {
+    claudeRunner = null;
+    cleanupCallbacks = [];
+    isShuttingDown = false;
+    /**
+     * Register a Claude runner to be killed on shutdown.
+     */
+    registerClaudeRunner(runner) {
+        this.claudeRunner = runner;
+    }
+    /**
+     * Register a custom cleanup callback.
+     */
+    onShutdown(callback) {
+        this.cleanupCallbacks.push(callback);
+    }
+    /**
+     * Initialize signal handlers.
+     */
+    init() {
+        process.on('SIGINT', () => this.handleShutdown('SIGINT'));
+        process.on('SIGTERM', () => this.handleShutdown('SIGTERM'));
+        // Handle uncaught errors
+        process.on('uncaughtException', (error) => {
+            logger.error(`Uncaught exception: ${error.message}`);
+            this.handleShutdown('uncaughtException');
+        });
+        process.on('unhandledRejection', (reason) => {
+            logger.error(`Unhandled rejection: ${reason}`);
+            // Don't exit on unhandled rejection, just log
+        });
+    }
+    /**
+     * Handle graceful shutdown.
+     */
+    async handleShutdown(signal) {
+        if (this.isShuttingDown) {
+            // Force exit on second signal
+            logger.info('\nForce exiting...');
+            process.exit(130);
+        }
+        this.isShuttingDown = true;
+        logger.info(`\nReceived ${signal}, shutting down gracefully...`);
+        // Kill Claude process if running
+        if (this.claudeRunner?.isRunning()) {
+            logger.debug('Killing Claude process...');
+            this.claudeRunner.kill();
+        }
+        // Run cleanup callbacks
+        for (const callback of this.cleanupCallbacks) {
+            try {
+                await callback();
+            }
+            catch (error) {
+                logger.error(`Cleanup callback failed: ${error}`);
+            }
+        }
+        // Reset terminal if needed
+        if (process.stdin.isTTY) {
+            try {
+                process.stdin.setRawMode(false);
+            }
+            catch {
+                // Ignore
+            }
+        }
+        process.exit(130);
+    }
+    /**
+     * Clear registrations (useful for testing).
+     */
+    clear() {
+        this.claudeRunner = null;
+        this.cleanupCallbacks = [];
+    }
+}
+export const shutdownHandler = new ShutdownHandler();
+//# sourceMappingURL=shutdown-handler.js.map

package/dist/core/shutdown-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-handler.js","sourceRoot":"","sources":["../../src/core/shutdown-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI5C,MAAM,eAAe;IACX,YAAY,GAAwB,IAAI,CAAC;IACzC,gBAAgB,GAAsB,EAAE,CAAC;IACzC,cAAc,GAAG,KAAK,CAAC;IAE/B;;OAEG;IACH,oBAAoB,CAAC,MAAoB;QACvC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAyB;QAClC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;QAE5D,yBAAyB;QACzB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,MAAM,CAAC,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;YAC/C,8CAA8C;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,MAAc;QACzC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,8BAA8B;YAC9B,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,cAAc,MAAM,+BAA+B,CAAC,CAAC;QAEjE,iCAAiC;QACjC,IAAI,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC1C,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,wBAAwB;QACxB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,QAAQ,EAAE,CAAC;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,EAAE,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/core/state-derivation.d.ts

@@ -0,0 +1,82 @@
+export type DerivedTaskStatus = 'pending' | 'completed' | 'failed' | 'blocked';
+export type DerivedProjectStatus = 'planning' | 'ready' | 'executing' | 'completed' | 'failed';
+export interface DerivedTask {
+    id: string;
+    planFile: string;
+    status: DerivedTaskStatus;
+    dependencies: string[];
+}
+export interface DerivedProjectState {
+    tasks: DerivedTask[];
+    status: DerivedProjectStatus;
+}
+export interface DiscoveredProject {
+    number: number;
+    name: string;
+    path: string;
+}
+export interface DerivedStats {
+    pending: number;
+    completed: number;
+    failed: number;
+    blocked: number;
+    total: number;
+}
+/**
+ * Discover all projects in the RAF directory.
+ * Projects are directories matching the pattern NNN-project-name.
+ */
+export declare function discoverProjects(rafDir: string): DiscoveredProject[];
+/**
+ * Parse the Dependencies section from plan file content.
+ * Format: `## Dependencies\n001, 002` → ["001", "002"]
+ * Returns empty array if no Dependencies section exists.
+ */
+export declare function parseDependencies(content: string): string[];
+/**
+ * Parse an outcome file to extract its status.
+ * Status is determined by the presence of promise markers:
+ * - `<promise>COMPLETE</promise>` → completed
+ * - `<promise>FAILED</promise>` → failed
+ * - `<promise>BLOCKED</promise>` → blocked
+ * Uses the last occurrence if multiple markers exist.
+ */
+export declare function parseOutcomeStatus(content: string): DerivedTaskStatus | null;
+/**
+ * Derive project status from tasks.
+ * - planning: has input.md but no plans folder or empty plans
+ * - ready: has plan files but no outcome files
+ * - executing: has some outcome files but not all (or has failed outcomes without SUCCESS)
+ * - completed: all plan files have corresponding SUCCESS outcomes
+ * - failed: has FAILED outcome files
+ */
+export declare function deriveProjectStatus(projectPath: string, tasks: DerivedTask[]): DerivedProjectStatus;
+/**
+ * Derive project state from the folder structure.
+ * Scans plans/ for plan files and outcomes/ for outcome files.
+ * Matches them by task ID (NNN prefix) and determines status.
+ * Also parses dependencies and derives blocked status.
+ */
+export declare function deriveProjectState(projectPath: string): DerivedProjectState;
+/**
+ * Get the next pending task from derived state.
+ */
+export declare function getNextPendingTask(state: DerivedProjectState): DerivedTask | null;
+/**
+ * Get the next task that should be executed (pending or failed).
+ * Skips blocked tasks - they cannot be executed until their dependencies pass.
+ */
+export declare function getNextExecutableTask(state: DerivedProjectState): DerivedTask | null;
+/**
+ * Calculate statistics from derived state.
+ */
+export declare function getDerivedStats(state: DerivedProjectState): DerivedStats;
+/**
+ * Check if all tasks are completed.
+ */
+export declare function isProjectComplete(state: DerivedProjectState): boolean;
+/**
+ * Check if any task has failed.
+ */
+export declare function hasProjectFailed(state: DerivedProjectState): boolean;
+//# sourceMappingURL=state-derivation.d.ts.map

package/dist/core/state-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-derivation.d.ts","sourceRoot":"","sources":["../../src/core/state-derivation.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,OAAO,GACP,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsBpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB3D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAoB5E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,WAAW,EAAE,GACnB,oBAAoB,CAyCtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAoF3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAOjF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAcpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA2BxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEpE"}