olympus-ai 3.4.1 → 3.5.0

package/dist/features/workflow-engine/artifacts.js

@@ -0,0 +1,399 @@
+import * as path from 'path';
+import * as fs from 'fs-extra';
+/**
+ * Ensures the workflow directory structure exists.
+ * Creates:
+ * - .olympus/workflow/{workflowId}/
+ * - .olympus/workflow/{workflowId}/intents/
+ * - .olympus/workflow/{workflowId}/validation/
+ * - .olympus/workflow/{workflowId}/checkpoint.json (if not exists)
+ *
+ * Idempotent - safe to call multiple times.
+ * @throws Error if disk is full or permissions are denied
+ */
+export async function ensureWorkflowDir(projectPath, workflowId) {
+    const workflowDir = path.join(projectPath, '.olympus', 'workflow', workflowId);
+    const intentsDir = path.join(workflowDir, 'intents');
+    const validationDir = path.join(workflowDir, 'validation');
+    const checkpointPath = path.join(workflowDir, 'checkpoint.json');
+    try {
+        // Create directories
+        await fs.ensureDir(workflowDir);
+        await fs.ensureDir(intentsDir);
+        await fs.ensureDir(validationDir);
+        // Initialize checkpoint.json if it doesn't exist
+        if (!await fs.pathExists(checkpointPath)) {
+            await fs.writeJson(checkpointPath, {
+                workflow_id: workflowId,
+                current_stage: 'idea',
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            }, { spaces: 2 });
+        }
+    }
+    catch (error) {
+        const err = error;
+        // Handle disk full error
+        if (err.code === 'ENOSPC') {
+            console.error(`[Artifacts] Failed to create workflow directory: Disk full`);
+            console.error(`[Artifacts] Please free up disk space and try again.`);
+            console.error(`[Artifacts] Attempted path: ${workflowDir}`);
+            throw new Error('Failed to create workflow directory: Disk is full. Please free up space and retry.');
+        }
+        // Handle permission denied error
+        if (err.code === 'EACCES' || err.code === 'EPERM') {
+            console.error(`[Artifacts] Failed to create workflow directory: Permission denied`);
+            console.error(`[Artifacts] Path: ${workflowDir}`);
+            throw new Error(`Failed to create workflow directory: Permission denied for ${workflowDir}`);
+        }
+        // Handle read-only filesystem
+        if (err.code === 'EROFS') {
+            console.error(`[Artifacts] Failed to create workflow directory: Read-only filesystem`);
+            console.error(`[Artifacts] Path: ${workflowDir}`);
+            throw new Error('Failed to create workflow directory: Filesystem is read-only');
+        }
+        // Generic error with context
+        console.error(`[Artifacts] Failed to create workflow directory: ${err.message}`);
+        console.error(`[Artifacts] Workflow ID: ${workflowId}`);
+        console.error(`[Artifacts] Path: ${workflowDir}`);
+        throw new Error(`Failed to create workflow directory for ${workflowId}: ${err.message}`);
+    }
+}
+/**
+ * Returns the file path for a given workflow stage artifact.
+ *
+ * @throws Error if stage is 'complete' (no artifact for complete stage)
+ * @throws Error if stage is 'intents' (intents is a directory, not a file)
+ */
+export function getArtifactPath(projectPath, workflowId, stage) {
+    if (stage === 'complete') {
+        throw new Error('No artifact file for complete stage');
+    }
+    if (stage === 'intents') {
+        throw new Error('Intents is a directory, not a single file. Use getIntentsDir() instead.');
+    }
+    const workflowDir = path.join(projectPath, '.olympus', 'workflow', workflowId);
+    const artifactMap = {
+        'idea': 'idea.md',
+        'prd': 'prd.md',
+        'spec': 'spec.md',
+    };
+    const filename = artifactMap[stage];
+    return path.join(workflowDir, filename);
+}
+/**
+ * Writes artifact content to the correct path for the given stage.
+ * Creates parent directories if needed.
+ *
+ * @throws Error if stage is 'intents' (use different function for multiple intent files)
+ * @throws Error if stage is 'complete' (no artifact for complete stage)
+ * @throws Error if disk is full or permissions are denied
+ */
+export async function writeArtifact(projectPath, workflowId, stage, content) {
+    if (stage === 'intents') {
+        throw new Error('Cannot write single artifact for intents stage. Use writeIntentFile() instead.');
+    }
+    const artifactPath = getArtifactPath(projectPath, workflowId, stage);
+    try {
+        await fs.ensureDir(path.dirname(artifactPath));
+        await fs.writeFile(artifactPath, content, 'utf-8');
+    }
+    catch (error) {
+        const err = error;
+        // Handle disk full error
+        if (err.code === 'ENOSPC') {
+            console.error(`[Artifacts] Failed to write ${stage} artifact: Disk full`);
+            console.error(`[Artifacts] Please free up disk space and try again.`);
+            console.error(`[Artifacts] Path: ${artifactPath}`);
+            throw new Error(`Failed to write ${stage} artifact: Disk is full. Please free up space and retry.`);
+        }
+        // Handle permission denied error
+        if (err.code === 'EACCES' || err.code === 'EPERM') {
+            console.error(`[Artifacts] Failed to write ${stage} artifact: Permission denied`);
+            console.error(`[Artifacts] Path: ${artifactPath}`);
+            throw new Error(`Failed to write ${stage} artifact: Permission denied for ${artifactPath}`);
+        }
+        // Handle read-only filesystem
+        if (err.code === 'EROFS') {
+            console.error(`[Artifacts] Failed to write ${stage} artifact: Read-only filesystem`);
+            console.error(`[Artifacts] Path: ${artifactPath}`);
+            throw new Error(`Failed to write ${stage} artifact: Filesystem is read-only`);
+        }
+        // Generic error with context
+        console.error(`[Artifacts] Failed to write ${stage} artifact: ${err.message}`);
+        console.error(`[Artifacts] Path: ${artifactPath}`);
+        throw new Error(`Failed to write ${stage} artifact: ${err.message}`);
+    }
+}
+/**
+ * Reads artifact content from the correct path for the given stage.
+ *
+ * @returns Content of the artifact, or null if the file doesn't exist
+ * @throws Error if stage is 'intents' (use different function to read multiple files)
+ * @throws Error if stage is 'complete' (no artifact for complete stage)
+ * @throws Error if permissions are denied or file is corrupt
+ */
+export async function readArtifact(projectPath, workflowId, stage) {
+    if (stage === 'intents') {
+        throw new Error('Cannot read single artifact for intents stage. Use readIntentFiles() instead.');
+    }
+    const artifactPath = getArtifactPath(projectPath, workflowId, stage);
+    try {
+        if (!await fs.pathExists(artifactPath)) {
+            return null;
+        }
+        return await fs.readFile(artifactPath, 'utf-8');
+    }
+    catch (error) {
+        const err = error;
+        // File not found is expected (return null)
+        if (err.code === 'ENOENT') {
+            return null;
+        }
+        // Handle permission denied error
+        if (err.code === 'EACCES' || err.code === 'EPERM') {
+            console.error(`[Artifacts] Failed to read ${stage} artifact: Permission denied`);
+            console.error(`[Artifacts] Path: ${artifactPath}`);
+            throw new Error(`Failed to read ${stage} artifact: Permission denied for ${artifactPath}`);
+        }
+        // Generic error with context
+        console.error(`[Artifacts] Failed to read ${stage} artifact: ${err.message}`);
+        console.error(`[Artifacts] Path: ${artifactPath}`);
+        throw new Error(`Failed to read ${stage} artifact: ${err.message}`);
+    }
+}
+/**
+ * Generates a dependency graph from an array of intent tasks.
+ * Creates nodes and edges representing task dependencies.
+ *
+ * @param tasks - Array of IntentTask objects with dependencies
+ * @returns DependencyGraph with nodes and edges
+ *
+ * @example
+ * const tasks = [
+ *   { id: "A", title: "Task A", component: "Auth", estimated_effort: 3, dependencies: [] },
+ *   { id: "B", title: "Task B", component: "Auth", estimated_effort: 2, dependencies: ["A"] }
+ * ];
+ * const graph = generateDependencyGraph(tasks);
+ * // Returns: { nodes: [...], edges: [{ from: "A", to: "B" }] }
+ */
+export function generateDependencyGraph(tasks) {
+    const nodes = tasks.map(task => ({
+        id: task.id,
+        title: task.title,
+        component: task.component,
+        estimated_effort: task.estimated_effort,
+    }));
+    const edges = [];
+    for (const task of tasks) {
+        for (const dep of task.dependencies) {
+            edges.push({ from: dep, to: task.id });
+        }
+    }
+    return { nodes, edges };
+}
+/**
+ * Validates a dependency graph for cycles and structural integrity.
+ * Throws errors if:
+ * - Circular dependencies are detected
+ * - Node IDs are not unique
+ * - Edge references point to non-existent nodes
+ *
+ * @param graph - The dependency graph to validate
+ * @throws Error if validation fails with detailed message
+ *
+ * @example
+ * validateDependencyGraph(graph); // Throws if graph has cycles
+ */
+export function validateDependencyGraph(graph) {
+    // Validate unique node IDs
+    const nodeIds = new Set();
+    for (const node of graph.nodes) {
+        if (nodeIds.has(node.id)) {
+            throw new Error(`Duplicate node ID detected: ${node.id}`);
+        }
+        nodeIds.add(node.id);
+    }
+    // Validate all edges reference existing nodes
+    for (const edge of graph.edges) {
+        if (!nodeIds.has(edge.from)) {
+            throw new Error(`Edge references non-existent node: ${edge.from}`);
+        }
+        if (!nodeIds.has(edge.to)) {
+            throw new Error(`Edge references non-existent node: ${edge.to}`);
+        }
+    }
+    // Detect circular dependencies using DFS
+    const adjacencyList = new Map();
+    for (const node of graph.nodes) {
+        adjacencyList.set(node.id, []);
+    }
+    for (const edge of graph.edges) {
+        adjacencyList.get(edge.from).push(edge.to);
+    }
+    const visited = new Set();
+    const recStack = new Set();
+    const path = [];
+    function dfs(nodeId) {
+        visited.add(nodeId);
+        recStack.add(nodeId);
+        path.push(nodeId);
+        const neighbors = adjacencyList.get(nodeId) || [];
+        for (const neighbor of neighbors) {
+            if (!visited.has(neighbor)) {
+                if (dfs(neighbor)) {
+                    return true;
+                }
+            }
+            else if (recStack.has(neighbor)) {
+                // Found a cycle
+                const cycleStart = path.indexOf(neighbor);
+                const cycle = path.slice(cycleStart).concat(neighbor);
+                throw new Error(`Circular dependency detected: ${cycle.join(' -> ')}`);
+            }
+        }
+        recStack.delete(nodeId);
+        path.pop();
+        return false;
+    }
+    for (const node of graph.nodes) {
+        if (!visited.has(node.id)) {
+            dfs(node.id);
+        }
+    }
+}
+/**
+ * Returns the execution order of tasks based on dependency graph.
+ * Uses topological sort (Kahn's algorithm) to determine order.
+ *
+ * @param graph - The dependency graph to sort
+ * @returns Array of task IDs in execution order
+ * @throws Error if graph contains cycles (should validate first)
+ *
+ * @example
+ * const order = getExecutionOrder(graph);
+ * // Returns: ["TASK-001", "TASK-002", "TASK-003"]
+ */
+export function getExecutionOrder(graph) {
+    // Build adjacency list and in-degree map
+    const adjacencyList = new Map();
+    const inDegree = new Map();
+    // Initialize
+    for (const node of graph.nodes) {
+        adjacencyList.set(node.id, []);
+        inDegree.set(node.id, 0);
+    }
+    // Build graph
+    for (const edge of graph.edges) {
+        adjacencyList.get(edge.from).push(edge.to);
+        inDegree.set(edge.to, (inDegree.get(edge.to) || 0) + 1);
+    }
+    // Kahn's algorithm
+    const queue = [];
+    const result = [];
+    // Start with nodes that have no dependencies
+    for (const [nodeId, degree] of inDegree.entries()) {
+        if (degree === 0) {
+            queue.push(nodeId);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        result.push(current);
+        // Reduce in-degree for neighbors
+        const neighbors = adjacencyList.get(current) || [];
+        for (const neighbor of neighbors) {
+            const newDegree = inDegree.get(neighbor) - 1;
+            inDegree.set(neighbor, newDegree);
+            if (newDegree === 0) {
+                queue.push(neighbor);
+            }
+        }
+    }
+    // If result doesn't contain all nodes, there's a cycle
+    if (result.length !== graph.nodes.length) {
+        throw new Error('Cannot determine execution order: graph contains cycles');
+    }
+    return result;
+}
+/**
+ * Links workflow artifacts to the master plan file.
+ * Creates or updates .olympus/plans/{workflowId}-plan.md with references
+ * to all structured workflow artifacts.
+ *
+ * @param projectPath - Root path of the project
+ * @param workflowId - Unique workflow identifier
+ * @throws Error if disk is full or permissions are denied
+ *
+ * @example
+ * await linkMasterPlan('/path/to/project', 'wf-2024-01-15-user-auth');
+ * // Creates/updates .olympus/plans/wf-2024-01-15-user-auth-plan.md
+ */
+export async function linkMasterPlan(projectPath, workflowId) {
+    const plansDir = path.join(projectPath, '.olympus', 'plans');
+    const planPath = path.join(plansDir, `${workflowId}-plan.md`);
+    try {
+        await fs.ensureDir(plansDir);
+        const artifactsSection = `## Structured Artifacts
+
+This feature was developed using the structured workflow system:
+
+- [IDEA Artifact](.olympus/workflow/${workflowId}/idea.md)
+- [PRD Artifact](.olympus/workflow/${workflowId}/prd.md)
+- [SPEC Artifact](.olympus/workflow/${workflowId}/spec.md)
+- [Intent Files](.olympus/workflow/${workflowId}/intents/)
+- [Dependency Graph](.olympus/workflow/${workflowId}/intents/dependency-graph.json)
+- [Workflow Checkpoint](.olympus/workflow/${workflowId}/checkpoint.json)
+`;
+        let content = '';
+        if (await fs.pathExists(planPath)) {
+            // Read existing file
+            content = await fs.readFile(planPath, 'utf-8');
+            // Check if Structured Artifacts section exists
+            const sectionRegex = /## Structured Artifacts[\s\S]*?(?=\n## |$)/;
+            if (sectionRegex.test(content)) {
+                // Replace existing section
+                content = content.replace(sectionRegex, artifactsSection.trim());
+            }
+            else {
+                // Append section at the end
+                content = content.trim() + '\n\n' + artifactsSection;
+            }
+        }
+        else {
+            // Create new file with header
+            content = `# Plan: ${workflowId}
+
+${artifactsSection}`;
+        }
+        await fs.writeFile(planPath, content, 'utf-8');
+    }
+    catch (error) {
+        const err = error;
+        // Handle disk full error
+        if (err.code === 'ENOSPC') {
+            console.error(`[Artifacts] Failed to link master plan: Disk full`);
+            console.error(`[Artifacts] Please free up disk space and try again.`);
+            console.error(`[Artifacts] Path: ${planPath}`);
+            throw new Error('Failed to link master plan: Disk is full. Please free up space and retry.');
+        }
+        // Handle permission denied error
+        if (err.code === 'EACCES' || err.code === 'EPERM') {
+            console.error(`[Artifacts] Failed to link master plan: Permission denied`);
+            console.error(`[Artifacts] Path: ${planPath}`);
+            throw new Error(`Failed to link master plan: Permission denied for ${planPath}`);
+        }
+        // Handle read-only filesystem
+        if (err.code === 'EROFS') {
+            console.error(`[Artifacts] Failed to link master plan: Read-only filesystem`);
+            console.error(`[Artifacts] Path: ${planPath}`);
+            throw new Error('Failed to link master plan: Filesystem is read-only');
+        }
+        // Generic error with context
+        console.error(`[Artifacts] Failed to link master plan: ${err.message}`);
+        console.error(`[Artifacts] Workflow ID: ${workflowId}`);
+        console.error(`[Artifacts] Path: ${planPath}`);
+        throw new Error(`Failed to link master plan for ${workflowId}: ${err.message}`);
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/features/workflow-engine/artifacts.js.map

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

package/dist/features/workflow-engine/checkpoint.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Checkpoint Persistence Module
+ *
+ * Handles saving, loading, and managing workflow checkpoints on disk.
+ * Checkpoints are stored in .olympus/workflow/{workflow_id}/checkpoint.json
+ *
+ * Performance optimizations:
+ * - In-memory cache to avoid redundant disk reads
+ * - Optimized JSON serialization
+ * - Batched writes to reduce I/O operations
+ */
+import { WorkflowCheckpoint } from './types.js';
+/**
+ * Clear the entire checkpoint cache
+ * Useful for testing or when you want to force fresh reads
+ */
+export declare function clearCache(): void;
+/**
+ * Invalidate a specific checkpoint in the cache
+ */
+export declare function invalidateCache(projectPath: string, workflowId: string): void;
+/**
+ * Save a workflow checkpoint to disk.
+ * Creates directory structure if it doesn't exist.
+ * Updates the checkpoint's updated_at timestamp before saving.
+ *
+ * Performance optimizations:
+ * - Updates in-memory cache
+ * - Uses optimized JSON serialization
+ * - Minimizes syscalls by combining directory check and write
+ *
+ * @param projectPath - Root path of the project
+ * @param checkpoint - Checkpoint data to save
+ * @throws Error if disk is full or write permissions are denied
+ */
+export declare function saveCheckpoint(projectPath: string, checkpoint: WorkflowCheckpoint): Promise<void>;
+/**
+ * Load a workflow checkpoint from disk.
+ * Returns null if checkpoint doesn't exist or if JSON is corrupt.
+ *
+ * Performance optimizations:
+ * - Uses in-memory cache to avoid redundant disk reads
+ * - Fast-path for cache hits
+ * - Optimized JSON parsing
+ *
+ * @param projectPath - Root path of the project
+ * @param workflowId - ID of the workflow to load
+ * @returns Checkpoint data or null if not found/invalid
+ */
+export declare function loadCheckpoint(projectPath: string, workflowId: string): Promise<WorkflowCheckpoint | null>;
+/**
+ * List all workflow IDs in the project.
+ * Returns an empty array if workflow directory doesn't exist.
+ *
+ * @param projectPath - Root path of the project
+ * @returns Array of workflow IDs
+ */
+export declare function listWorkflows(projectPath: string): Promise<string[]>;
+/**
+ * Delete a workflow and all its associated files.
+ * Idempotent - no error if workflow doesn't exist.
+ *
+ * @param projectPath - Root path of the project
+ * @param workflowId - ID of the workflow to delete
+ */
+export declare function deleteWorkflow(projectPath: string, workflowId: string): Promise<void>;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/features/workflow-engine/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../src/features/workflow-engine/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAiChD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAuEf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAqEpC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA+B1E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAyBf"}