olympus-ai 3.4.0 → 3.5.0

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

@@ -0,0 +1,78 @@
+/**
+ * Workflow Engine Hooks
+ *
+ * Helper functions for generating workflow prompts that guide Claude through
+ * multi-stage feature development workflows.
+ */
+import type { WorkflowCheckpoint, WorkflowStage } from './types.js';
+/**
+ * Generate initial workflow instructions for Claude when starting structured workflow.
+ *
+ * Tells Claude which agent to invoke for the current stage and provides
+ * feature context and stage information.
+ *
+ * @param featureName - Name of the feature being developed
+ * @param checkpoint - Current workflow checkpoint state
+ * @returns Formatted prompt string with clear instructions
+ *
+ * @example
+ * const prompt = buildStructuredWorkflowPrompt('user-auth', checkpoint);
+ * // Returns:
+ * // You are beginning a structured workflow for feature: user-auth
+ * //
+ * // Current stage: idea
+ * // Status: in_progress
+ * //
+ * // Next step: Invoke the idea-intake agent to capture and validate the initial feature concept
+ * //
+ * // Use: Task(subagent_type="idea-intake", prompt="...")
+ */
+export declare function buildStructuredWorkflowPrompt(featureName: string, checkpoint: WorkflowCheckpoint): string;
+/**
+ * Generate resume instructions for interrupted workflow.
+ *
+ * Indicates which stage was interrupted and what to do next.
+ * Includes resume context if available from the checkpoint.
+ *
+ * @param featureName - Name of the feature being developed
+ * @param checkpoint - Current workflow checkpoint state
+ * @returns Formatted prompt string for resuming work
+ *
+ * @example
+ * const prompt = buildWorkflowResumptionPrompt('user-auth', checkpoint);
+ * // Returns:
+ * // Resuming workflow for feature: user-auth
+ * //
+ * // You were interrupted during: prd
+ * // Last update: 2024-01-15T12:00:00Z
+ * //
+ * // Resume context: [checkpoint data if available]
+ * //
+ * // Continue from where you left off: create a comprehensive Product Requirements Document
+ */
+export declare function buildWorkflowResumptionPrompt(featureName: string, checkpoint: WorkflowCheckpoint): string;
+/**
+ * Generate transition instructions between workflow stages.
+ *
+ * Tells Claude what was completed and what's next, providing context
+ * for validation gates and artifact status.
+ *
+ * @param checkpoint - Current workflow checkpoint state
+ * @param nextStage - The stage to transition to
+ * @returns Formatted prompt string for stage transition
+ *
+ * @example
+ * const prompt = buildWorkflowTransitionPrompt(checkpoint, 'spec');
+ * // Returns:
+ * // Stage prd complete! ✓
+ * //
+ * // Completed artifacts:
+ * // - PRD-001: .olympus/workflows/user-auth/prd.md (validated: true)
+ * //
+ * // Next stage: spec
+ * // Validation required: Technical specification review
+ * //
+ * // Proceed with: Invoke the spec-writer agent to write a detailed technical specification
+ */
+export declare function buildWorkflowTransitionPrompt(checkpoint: WorkflowCheckpoint, nextStage: WorkflowStage): string;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/features/workflow-engine/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiCpE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAgBR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAsBR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,aAAa,GACvB,MAAM,CAoCR"}

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

@@ -0,0 +1,188 @@
+/**
+ * Workflow Engine Hooks
+ *
+ * Helper functions for generating workflow prompts that guide Claude through
+ * multi-stage feature development workflows.
+ */
+/**
+ * Map workflow stages to their corresponding agent types.
+ */
+const STAGE_AGENT_MAP = {
+    idea: 'idea-intake',
+    prd: 'prd-writer',
+    spec: 'spec-writer',
+    intents: 'intent-generator',
+    complete: null, // No agent needed for complete stage
+};
+/**
+ * Get human-readable task description for a workflow stage.
+ */
+function getStageTaskDescription(stage) {
+    switch (stage) {
+        case 'idea':
+            return 'capture and validate the initial feature concept';
+        case 'prd':
+            return 'create a comprehensive Product Requirements Document';
+        case 'spec':
+            return 'write a detailed technical specification';
+        case 'intents':
+            return 'generate implementation intent files';
+        case 'complete':
+            return 'finalize and validate all workflow artifacts';
+        default:
+            return 'proceed with the next stage';
+    }
+}
+/**
+ * Generate initial workflow instructions for Claude when starting structured workflow.
+ *
+ * Tells Claude which agent to invoke for the current stage and provides
+ * feature context and stage information.
+ *
+ * @param featureName - Name of the feature being developed
+ * @param checkpoint - Current workflow checkpoint state
+ * @returns Formatted prompt string with clear instructions
+ *
+ * @example
+ * const prompt = buildStructuredWorkflowPrompt('user-auth', checkpoint);
+ * // Returns:
+ * // You are beginning a structured workflow for feature: user-auth
+ * //
+ * // Current stage: idea
+ * // Status: in_progress
+ * //
+ * // Next step: Invoke the idea-intake agent to capture and validate the initial feature concept
+ * //
+ * // Use: Task(subagent_type="idea-intake", prompt="...")
+ */
+export function buildStructuredWorkflowPrompt(featureName, checkpoint) {
+    const agent = STAGE_AGENT_MAP[checkpoint.current_stage];
+    const taskDescription = getStageTaskDescription(checkpoint.current_stage);
+    let prompt = `You are beginning a structured workflow for feature: ${featureName}\n\n`;
+    prompt += `Current stage: ${checkpoint.current_stage}\n`;
+    prompt += `Status: ${checkpoint.status}\n\n`;
+    if (agent) {
+        prompt += `Next step: Invoke the ${agent} agent to ${taskDescription}\n\n`;
+        prompt += `Use: Task(subagent_type="${agent}", prompt="...")\n`;
+    }
+    else {
+        prompt += `Next step: ${taskDescription}\n`;
+    }
+    return prompt;
+}
+/**
+ * Generate resume instructions for interrupted workflow.
+ *
+ * Indicates which stage was interrupted and what to do next.
+ * Includes resume context if available from the checkpoint.
+ *
+ * @param featureName - Name of the feature being developed
+ * @param checkpoint - Current workflow checkpoint state
+ * @returns Formatted prompt string for resuming work
+ *
+ * @example
+ * const prompt = buildWorkflowResumptionPrompt('user-auth', checkpoint);
+ * // Returns:
+ * // Resuming workflow for feature: user-auth
+ * //
+ * // You were interrupted during: prd
+ * // Last update: 2024-01-15T12:00:00Z
+ * //
+ * // Resume context: [checkpoint data if available]
+ * //
+ * // Continue from where you left off: create a comprehensive Product Requirements Document
+ */
+export function buildWorkflowResumptionPrompt(featureName, checkpoint) {
+    const agent = STAGE_AGENT_MAP[checkpoint.current_stage];
+    const taskDescription = getStageTaskDescription(checkpoint.current_stage);
+    let prompt = `Resuming workflow for feature: ${featureName}\n\n`;
+    prompt += `You were interrupted during: ${checkpoint.current_stage}\n`;
+    prompt += `Last update: ${checkpoint.updated_at}\n\n`;
+    if (checkpoint.resume_context) {
+        prompt += `Resume context: ${JSON.stringify(checkpoint.resume_context, null, 2)}\n\n`;
+    }
+    else {
+        prompt += `Resume context: No additional context available\n\n`;
+    }
+    if (agent) {
+        prompt += `Continue from where you left off: Invoke the ${agent} agent to ${taskDescription}\n\n`;
+        prompt += `Use: Task(subagent_type="${agent}", prompt="...")\n`;
+    }
+    else {
+        prompt += `Continue from where you left off: ${taskDescription}\n`;
+    }
+    return prompt;
+}
+/**
+ * Generate transition instructions between workflow stages.
+ *
+ * Tells Claude what was completed and what's next, providing context
+ * for validation gates and artifact status.
+ *
+ * @param checkpoint - Current workflow checkpoint state
+ * @param nextStage - The stage to transition to
+ * @returns Formatted prompt string for stage transition
+ *
+ * @example
+ * const prompt = buildWorkflowTransitionPrompt(checkpoint, 'spec');
+ * // Returns:
+ * // Stage prd complete! ✓
+ * //
+ * // Completed artifacts:
+ * // - PRD-001: .olympus/workflows/user-auth/prd.md (validated: true)
+ * //
+ * // Next stage: spec
+ * // Validation required: Technical specification review
+ * //
+ * // Proceed with: Invoke the spec-writer agent to write a detailed technical specification
+ */
+export function buildWorkflowTransitionPrompt(checkpoint, nextStage) {
+    const currentStage = checkpoint.current_stage;
+    const nextAgent = STAGE_AGENT_MAP[nextStage];
+    const nextTaskDescription = getStageTaskDescription(nextStage);
+    let prompt = `Stage ${currentStage} complete! ✓\n\n`;
+    prompt += `Completed artifacts:\n`;
+    // List artifacts for the current stage
+    const currentArtifact = checkpoint.artifacts[currentStage];
+    if (currentArtifact) {
+        const validationStatus = checkpoint.validation_results[currentStage]?.passed ?? false;
+        prompt += `- ${currentArtifact.id}: ${currentArtifact.path} (validated: ${validationStatus})\n`;
+    }
+    else {
+        prompt += `- No artifacts recorded for ${currentStage} stage\n`;
+    }
+    prompt += `\n`;
+    prompt += `Next stage: ${nextStage}\n`;
+    // Add validation context based on next stage
+    const validationType = getValidationType(nextStage);
+    if (validationType) {
+        prompt += `Validation required: ${validationType}\n`;
+    }
+    prompt += `\n`;
+    if (nextAgent) {
+        prompt += `Proceed with: Invoke the ${nextAgent} agent to ${nextTaskDescription}\n\n`;
+        prompt += `Use: Task(subagent_type="${nextAgent}", prompt="...")\n`;
+    }
+    else {
+        prompt += `Proceed with: ${nextTaskDescription}\n`;
+    }
+    return prompt;
+}
+/**
+ * Get the validation type description for a workflow stage.
+ */
+function getValidationType(stage) {
+    switch (stage) {
+        case 'prd':
+            return 'Product requirements completeness review';
+        case 'spec':
+            return 'Technical specification review';
+        case 'intents':
+            return 'Intent file validation';
+        case 'complete':
+            return 'Final workflow validation';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Workflow Engine Module
+ *
+ * Provides structured workflow system for plan execution with:
+ * - IDEA → PRD → SPEC → INTENTS stage progression
+ * - Checkpoint persistence and resume capability
+ * - Validation gates (Momus, Metis reviews)
+ * - Artifact generation and management
+ */
+export type { WorkflowStage, WorkflowStatus, ArtifactReference, ValidationResult, RequirementMapping, WorkflowCheckpoint, IntentTask, IntentNode, DependencyGraph, } from './types.js';
+export { saveCheckpoint, loadCheckpoint, listWorkflows, deleteWorkflow, } from './checkpoint.js';
+export { ensureWorkflowDir, getArtifactPath, writeArtifact, readArtifact, generateDependencyGraph, validateDependencyGraph, getExecutionOrder, linkMasterPlan, } from './artifacts.js';
+export type { TaskStatus, TaskStatusRecord } from './execution.js';
+export { updateTaskStatus, getTaskStatus, getBlockedTasks, getNextReadyTask, updateMasterPlanProgress, } from './execution.js';
+export { validateIdea, validatePrd, validateSpec, validateTasks } from './validation.js';
+export { WorkflowEngine, WorkflowStatusResponse } from './engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/workflow-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGzF,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Workflow Engine Module
+ *
+ * Provides structured workflow system for plan execution with:
+ * - IDEA → PRD → SPEC → INTENTS stage progression
+ * - Checkpoint persistence and resume capability
+ * - Validation gates (Momus, Metis reviews)
+ * - Artifact generation and management
+ */
+// Checkpoint persistence
+export { saveCheckpoint, loadCheckpoint, listWorkflows, deleteWorkflow, } from './checkpoint.js';
+// Artifact management
+export { ensureWorkflowDir, getArtifactPath, writeArtifact, readArtifact, generateDependencyGraph, validateDependencyGraph, getExecutionOrder, linkMasterPlan, } from './artifacts.js';
+export { updateTaskStatus, getTaskStatus, getBlockedTasks, getNextReadyTask, updateMasterPlanProgress, } from './execution.js';
+// Validation
+export { validateIdea, validatePrd, validateSpec, validateTasks } from './validation.js';
+// Engine
+export { WorkflowEngine } from './engine.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/workflow-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,sBAAsB;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzF,SAAS;AACT,OAAO,EAAE,cAAc,EAA0B,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,220 @@
+/**
+ * Workflow Engine Type Definitions
+ *
+ * Comprehensive types for the multi-stage workflow system that guides features
+ * through idea → PRD → spec → intents → implementation stages.
+ */
+/**
+ * Workflow stages representing the progression of feature development.
+ * Each stage produces artifacts that feed into the next stage.
+ *
+ * - idea: Initial feature concept and requirements
+ * - prd: Product Requirements Document
+ * - spec: Technical specification
+ * - intents: Intent files for implementation
+ * - complete: All stages finished and validated
+ */
+export type WorkflowStage = 'idea' | 'prd' | 'spec' | 'intents' | 'complete';
+/**
+ * Current status of a workflow or workflow stage.
+ *
+ * - not_started: Stage hasn't begun yet
+ * - in_progress: Currently working on this stage
+ * - paused: Temporarily halted, can resume
+ * - blocked: Cannot proceed due to validation failures or dependencies
+ * - complete: Stage is finished and validated
+ */
+export type WorkflowStatus = 'not_started' | 'in_progress' | 'paused' | 'blocked' | 'complete';
+/**
+ * Reference to a workflow artifact (file produced by a stage).
+ * Each stage creates artifacts that are tracked and validated.
+ *
+ * @example
+ * {
+ *   id: "IDEA-001",
+ *   path: ".olympus/workflows/user-auth/idea.md",
+ *   created_at: "2024-01-15T10:30:00Z",
+ *   validation_passed: true
+ * }
+ */
+export interface ArtifactReference {
+    /** Unique artifact identifier (e.g., "IDEA-001", "PRD-001") */
+    id: string;
+    /** Relative path to the artifact file from project root */
+    path: string;
+    /** ISO timestamp when artifact was created */
+    created_at: string;
+    /** Whether this artifact passed validation */
+    validation_passed: boolean;
+}
+/**
+ * Results from validating a workflow stage's artifacts.
+ * Used by reviewers (Momus, Metis) to assess completeness and quality.
+ *
+ * @example
+ * {
+ *   passed: true,
+ *   coverage_percentage: 95,
+ *   blocking_issues: [],
+ *   reviewer: 'momus',
+ *   timestamp: "2024-01-15T11:00:00Z"
+ * }
+ */
+export interface ValidationResult {
+    /** Overall validation pass/fail */
+    passed: boolean;
+    /** Percentage of requirements covered (0-100) */
+    coverage_percentage: number;
+    /** Critical issues that must be resolved before proceeding */
+    blocking_issues: string[];
+    /** Name of the agent that performed validation (e.g., 'momus', 'metis') */
+    reviewer?: string;
+    /** ISO timestamp when validation was performed */
+    timestamp: string;
+}
+/**
+ * Mapping between requirements across workflow stages.
+ * Ensures traceability from initial idea through to implementation.
+ *
+ * @example
+ * {
+ *   requirement_id: "REQ-001",
+ *   source_artifact: "IDEA-001",
+ *   target_artifact: "PRD-001",
+ *   covered: true,
+ *   notes: "Authentication requirement fully specified in PRD section 3.2"
+ * }
+ */
+export interface RequirementMapping {
+    /** Unique requirement identifier */
+    requirement_id: string;
+    /** Source artifact ID (e.g., "IDEA-001") */
+    source_artifact: string;
+    /** Target artifact ID that should cover this requirement (e.g., "PRD-001") */
+    target_artifact: string;
+    /** Whether the requirement is adequately covered in the target */
+    covered: boolean;
+    /** Additional notes about the mapping or coverage */
+    notes?: string;
+}
+/**
+ * Complete workflow checkpoint representing the state of a feature's development.
+ * This checkpoint is persisted to disk and can be resumed at any time.
+ *
+ * The checkpoint tracks:
+ * - Which stage the workflow is currently in
+ * - All artifacts produced at each stage
+ * - Validation results for each stage
+ * - Context needed to resume interrupted workflows
+ *
+ * @example
+ * {
+ *   schema_version: "1.0.0",
+ *   workflow_id: "wf-2024-01-15-user-auth",
+ *   feature_name: "user-authentication",
+ *   created_at: "2024-01-15T10:00:00Z",
+ *   updated_at: "2024-01-15T12:00:00Z",
+ *   current_stage: "prd",
+ *   status: "in_progress",
+ *   artifacts: {
+ *     idea: { id: "IDEA-001", path: ".olympus/workflows/user-auth/idea.md", ... },
+ *     prd: null,
+ *     spec: null,
+ *     intents: null,
+ *     complete: null
+ *   },
+ *   validation_results: {
+ *     idea: { passed: true, coverage_percentage: 100, ... },
+ *     prd: null,
+ *     spec: null,
+ *     intents: null,
+ *     complete: null
+ *   }
+ * }
+ */
+export interface WorkflowCheckpoint {
+    /** Version of the checkpoint format for migration compatibility */
+    schema_version: string;
+    /** Unique identifier for this workflow instance */
+    workflow_id: string;
+    /** Name of the feature being developed */
+    feature_name: string;
+    /** ISO timestamp when workflow was created */
+    created_at: string;
+    /** ISO timestamp of last update to this checkpoint */
+    updated_at: string;
+    /** Current stage of the workflow */
+    current_stage: WorkflowStage;
+    /** Overall status of the workflow */
+    status: WorkflowStatus;
+    /** Artifacts produced at each stage (null if stage not yet complete) */
+    artifacts: Record<WorkflowStage, ArtifactReference | null>;
+    /** Validation results for each stage (null if not yet validated) */
+    validation_results: Record<WorkflowStage, ValidationResult | null>;
+    /** Context data needed to resume interrupted workflows */
+    resume_context?: any;
+}
+/**
+ * Task definition for intent files.
+ * Represents a single task with dependencies and effort estimates.
+ *
+ * @example
+ * {
+ *   id: "TASK-001",
+ *   title: "Implement user authentication",
+ *   component: "AuthService",
+ *   estimated_effort: 5,
+ *   dependencies: ["TASK-002", "TASK-003"]
+ * }
+ */
+export interface IntentTask {
+    /** Unique task identifier */
+    id: string;
+    /** Human-readable task title */
+    title: string;
+    /** Component or module this task belongs to */
+    component: string;
+    /** Estimated effort in story points or hours */
+    estimated_effort: number;
+    /** Array of task IDs this task depends on */
+    dependencies: string[];
+}
+/**
+ * Node in a dependency graph.
+ * Represents a task without its dependency relationships.
+ */
+export interface IntentNode {
+    /** Unique task identifier */
+    id: string;
+    /** Human-readable task title */
+    title: string;
+    /** Component or module this task belongs to */
+    component: string;
+    /** Estimated effort in story points or hours */
+    estimated_effort: number;
+}
+/**
+ * Dependency graph representing task relationships.
+ * Used for topological sorting and cycle detection.
+ *
+ * @example
+ * {
+ *   nodes: [
+ *     { id: "TASK-001", title: "Setup database", component: "DB", estimated_effort: 3 },
+ *     { id: "TASK-002", title: "Create schema", component: "DB", estimated_effort: 2 }
+ *   ],
+ *   edges: [
+ *     { from: "TASK-001", to: "TASK-002" }  // TASK-002 depends on TASK-001
+ *   ]
+ * }
+ */
+export interface DependencyGraph {
+    /** Array of task nodes */
+    nodes: IntentNode[];
+    /** Array of directed edges (from -> to means 'to' depends on 'from') */
+    edges: {
+        from: string;
+        to: string;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Workflow Engine Type Definitions
+ *
+ * Comprehensive types for the multi-stage workflow system that guides features
+ * through idea → PRD → spec → intents → implementation stages.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/workflow-engine/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}