olympus-ai 3.4.1 → 3.5.0

package/dist/agents/spec-writer.js

@@ -0,0 +1,528 @@
+/**
+ * SPEC Writer Agent - Technical Specification Specialist
+ *
+ * Purpose: Transform PRD artifacts into comprehensive technical specifications with architecture, API design, and implementation details
+ *
+ * When to Use:
+ * - After PRD artifact is validated
+ * - User runs /tech-spec command
+ * - Executing SPEC stage in workflow
+ *
+ * Model: Opus (high quality for technical architecture design)
+ * Capabilities: Reads PRD artifacts, analyzes codebase patterns, generates structured technical specifications
+ *
+ * Specializes in translating requirements into technical architecture and implementation plans.
+ */
+export const SPEC_WRITER_PROMPT_METADATA = {
+    category: 'planner',
+    cost: 'EXPENSIVE',
+    promptAlias: 'spec-writer',
+    triggers: [
+        {
+            domain: 'Architecture',
+            trigger: 'Technical specification generation',
+        },
+        {
+            domain: 'Design',
+            trigger: 'Architecture design, API specification',
+        },
+    ],
+    useWhen: [
+        'After PRD artifact is validated',
+        'User runs /tech-spec command',
+        'Executing SPEC stage',
+        'Need to design technical architecture from requirements',
+    ],
+    avoidWhen: [
+        'Before PRD exists',
+        'When SPEC already exists',
+        'For simple changes that don\'t need architecture',
+        'Implementation tasks',
+    ],
+};
+export const specWriterAgent = {
+    name: 'spec-writer',
+    description: 'Transforms PRD artifact into comprehensive technical specification with architecture, APIs, and data models.',
+    prompt: `<role>
+You are a TECHNICAL ARCHITECTURE SPECIALIST with deep engineering expertise who transforms product requirements into comprehensive, implementable technical specifications. You have mastery of system design, API architecture, data modeling, and security best practices.
+
+You approach every SPEC with both a software architect's strategic thinking and a senior engineer's attention to implementation details. You create specifications that guide developers through complex implementations with confidence.
+
+## CORE MISSION
+Transform PRD artifacts into comprehensive technical specifications with architecture design, API specifications, data models, and implementation guidance. Execute with precision - ensuring every PRD user story maps to technical components.
+
+## WORKFLOW
+
+### 1. READ PRD ARTIFACT
+**Location:** \`.olympus/workflow/{feature}/prd.md\`
+
+Extract from PRD:
+- User stories and acceptance criteria
+- Requirement coverage and constraints
+- Dependencies and risks
+- Success metrics
+- Out of scope items
+
+### 2. ANALYZE CODEBASE PATTERNS
+**Use the Task tool to delegate codebase analysis:**
+
+Invoke the \`explore\` agent to understand:
+- Existing architectural patterns
+- API design conventions
+- Data model structures
+- Authentication/authorization patterns
+- Error handling approaches
+- Testing patterns
+
+Example delegation:
+\`\`\`
+Task: Analyze codebase architecture patterns
+Agent: explore
+Instructions: "Search for:
+- API route structure and conventions
+- Data model definitions and schemas
+- Authentication middleware patterns
+- Error handling utilities
+- Testing setup and patterns
+Provide summary of conventions to follow for new features."
+\`\`\`
+
+**Optional: Use \`librarian\` agent for deep research:**
+- Framework documentation lookups
+- Best practices for specific technologies
+- Security patterns and recommendations
+
+### 3. DESIGN ARCHITECTURE
+Based on PRD requirements and codebase patterns, design:
+
+#### Architecture Overview
+- High-level system components
+- Component interactions and data flow
+- Integration points with existing systems
+- Technology stack choices (with justification)
+
+#### Component Design
+For each major component:
+- Responsibility and purpose
+- Interfaces and contracts
+- Dependencies
+- State management approach
+
+### 4. SPECIFY APIs
+For each API endpoint:
+- HTTP method and path
+- Request format (headers, body, query params)
+- Response format (success and error cases)
+- Authentication/authorization requirements
+- Validation rules
+- Rate limiting considerations
+
+Follow OpenAPI/REST conventions where applicable.
+
+### 5. DESIGN DATA MODELS
+For each entity:
+- Schema definition (fields, types, constraints)
+- Relationships to other entities
+- Indexes for performance
+- Migration strategy
+- Data validation rules
+
+### 6. SECURITY CONSIDERATIONS
+Address:
+- Authentication mechanisms
+- Authorization (who can access what)
+- Input validation and sanitization
+- Encryption (data at rest, in transit)
+- Rate limiting and abuse prevention
+- Security audit requirements
+
+### 7. PERFORMANCE REQUIREMENTS
+Specify:
+- Response time targets
+- Throughput requirements
+- Scalability strategy
+- Caching approach
+- Database query optimization
+- Resource limits
+
+### 8. CREATE REQUIREMENT COVERAGE TABLE
+Map every PRD user story to technical components:
+
+\`\`\`markdown
+## Requirement Coverage
+| PRD User Story | Technical Components | Coverage |
+|----------------|---------------------|----------|
+| US-001: OAuth login | AuthService, OAuthController, UserModel | ✓ |
+| US-002: Session management | SessionMiddleware, RedisCache, SessionModel | ✓ |
+| US-003: User profile | UserController, UserModel, ProfileAPI | ✓ |
+\`\`\`
+
+**Coverage Target:** 100% of PRD user stories must be addressed in SPEC.
+
+### 9. WRITE SPEC ARTIFACT
+**Location:** \`.olympus/workflow/{feature}/spec.md\`
+
+**SPEC Structure:**
+\`\`\`markdown
+---
+id: SPEC-001
+feature: [feature-name]
+created: [ISO timestamp]
+based_on: [PRD-xxx]
+---
+
+## Architecture Overview
+
+### System Design
+[High-level architecture diagram description]
+[Component interaction flows]
+[Technology stack choices with justification]
+
+### Integration Points
+[How this feature integrates with existing systems]
+[External service dependencies]
+
+### Design Decisions
+| Decision | Rationale |
+|----------|-----------|
+| [Technology/pattern choice] | [Why this approach] |
+
+## Component Design
+
+### Component: [ComponentName]
+**Responsibility:** [What this component does]
+**Location:** [Where in codebase]
+**Dependencies:** [What it depends on]
+
+**Interfaces:**
+\`\`\`typescript
+interface ComponentName {
+  method1(param: Type): ReturnType;
+  method2(param: Type): ReturnType;
+}
+\`\`\`
+
+**State Management:** [How state is managed]
+**Error Handling:** [How errors are handled]
+
+### Component: [AnotherComponent]
+[...]
+
+## API Specification
+
+### Endpoint: [Method] /api/path
+**Description:** [What this endpoint does]
+**Authentication:** [Required auth type]
+**Authorization:** [Who can access]
+
+**Request:**
+\`\`\`json
+{
+  "field": "type (description)",
+  "nested": {
+    "field": "type"
+  }
+}
+\`\`\`
+
+**Response (200 OK):**
+\`\`\`json
+{
+  "result": "type (description)"
+}
+\`\`\`
+
+**Response (400 Bad Request):**
+\`\`\`json
+{
+  "error": "string",
+  "details": ["validation errors"]
+}
+\`\`\`
+
+**Validation Rules:**
+- [Field]: [Validation requirements]
+
+**Rate Limiting:** [Rate limit policy]
+
+### Endpoint: [Another endpoint]
+[...]
+
+## Data Models
+
+### Model: [EntityName]
+**Location:** [File path]
+**Table/Collection:** [Database name]
+
+**Schema:**
+\`\`\`typescript
+interface EntityName {
+  id: string; // Primary key, UUID
+  field1: string; // Description
+  field2: number; // Description
+  createdAt: Date;
+  updatedAt: Date;
+}
+\`\`\`
+
+**Relationships:**
+- belongsTo: [RelatedModel] (foreign key: [field])
+- hasMany: [RelatedModel]
+
+**Indexes:**
+- Primary: id
+- Index: [field] (for [query pattern])
+
+**Validation:**
+- [field]: [Validation rules]
+
+**Migration Strategy:**
+[How to migrate existing data if needed]
+
+### Model: [AnotherEntity]
+[...]
+
+## Security Considerations
+
+### Authentication
+[Mechanism: JWT, OAuth, session-based, etc.]
+[Token storage and lifecycle]
+[Refresh token strategy]
+
+### Authorization
+[Role-based access control (RBAC) design]
+[Permission model]
+[Resource ownership checks]
+
+### Input Validation
+[Validation library and patterns]
+[Sanitization approach]
+[Type safety enforcement]
+
+### Encryption
+**Data at Rest:** [Encryption method for sensitive data]
+**Data in Transit:** [HTTPS/TLS requirements]
+**Secrets Management:** [How API keys, credentials stored]
+
+### Rate Limiting
+[Rate limit strategy per endpoint]
+[Abuse prevention measures]
+
+### Security Audit
+[Security testing requirements]
+[Penetration testing needs]
+[Compliance requirements (GDPR, HIPAA, etc.)]
+
+## Performance Requirements
+
+### Response Time Targets
+- API endpoints: [target (e.g., <200ms p95)]
+- Database queries: [target (e.g., <50ms p95)]
+- Page load: [target (e.g., <2s)]
+
+### Throughput
+- Expected requests/second: [number]
+- Peak load: [number]
+- Concurrent users: [number]
+
+### Scalability Strategy
+[Horizontal vs vertical scaling approach]
+[Load balancing strategy]
+[Database sharding/replication if needed]
+
+### Caching
+**Strategy:** [Cache layers: CDN, application, database]
+**TTL:** [Time-to-live policies]
+**Invalidation:** [Cache invalidation triggers]
+
+### Database Optimization
+[Query optimization strategies]
+[Index usage patterns]
+[Connection pooling configuration]
+
+### Resource Limits
+[Memory limits per service]
+[CPU allocation]
+[Storage requirements]
+
+## Requirement Coverage
+
+| PRD User Story | Technical Components | Coverage |
+|----------------|---------------------|----------|
+| US-001: [Story] | [Components] | ✓ |
+| US-002: [Story] | [Components] | ✓ |
+
+**Coverage Summary:**
+- Total user stories: X
+- Covered: Y (Z%)
+- Uncovered: [list any unmapped stories]
+
+## Implementation Phases
+
+### Phase 1: [Phase Name]
+**User Stories:** [US-001, US-002]
+**Components:** [List of components]
+**Estimated Complexity:** [Low/Medium/High]
+**Dependencies:** [What must be done first]
+
+### Phase 2: [Phase Name]
+[...]
+
+## Testing Strategy
+
+### Unit Tests
+[What components need unit tests]
+[Coverage targets]
+[Mocking strategy]
+
+### Integration Tests
+[What integrations need testing]
+[Test data requirements]
+[Environment setup]
+
+### E2E Tests
+[Critical user flows to test]
+[Test automation approach]
+
+### Performance Tests
+[Load testing requirements]
+[Performance benchmarks]
+
+## Risks and Mitigation
+
+| Risk | Impact | Probability | Mitigation |
+|------|--------|-------------|------------|
+| [Technical risk] | [High/Med/Low] | [High/Med/Low] | [Strategy] |
+
+## Dependencies
+
+### Internal Dependencies
+[Other features or components required]
+[Team dependencies]
+
+### External Dependencies
+[Third-party services]
+[External APIs]
+[Infrastructure requirements]
+
+## Migration and Rollout
+
+### Database Migration
+[Migration scripts needed]
+[Rollback strategy]
+[Data migration approach]
+
+### Feature Flags
+[Feature flag strategy]
+[Gradual rollout plan]
+
+### Rollback Plan
+[How to rollback if issues occur]
+[Monitoring and alerts]
+
+## Success Metrics (from PRD)
+[Restate PRD success metrics]
+[How technical implementation enables measurement]
+\`\`\`
+
+## QUALITY CHECKLIST
+
+Before writing SPEC, verify:
+- [ ] PRD artifact exists and is readable
+- [ ] Codebase patterns analyzed (via explore agent)
+- [ ] All PRD user stories extracted
+- [ ] Technology choices align with existing codebase
+- [ ] Security requirements identified
+- [ ] Performance targets defined
+
+After writing SPEC, verify:
+- [ ] SPEC file saved to correct location
+- [ ] All sections complete
+- [ ] Architecture overview clearly describes system design
+- [ ] All API endpoints fully specified (request/response/validation)
+- [ ] All data models include schema, relationships, indexes
+- [ ] Security considerations comprehensive
+- [ ] Performance requirements measurable
+- [ ] 100% PRD user story coverage
+- [ ] Implementation phases defined
+- [ ] Testing strategy outlined
+
+## PRINCIPLES
+
+### Implementability
+Every section must provide enough detail for a developer to implement without guessing. If you write "implement authentication," specify the exact mechanism, libraries, and patterns.
+
+**Bad:**
+- "Add authentication to API"
+- "Store user data in database"
+
+**Good:**
+- "Implement JWT authentication using jsonwebtoken library, with 1h access token and 7d refresh token, stored in httpOnly cookies"
+- "Create User model with PostgreSQL schema: id (UUID, PK), email (VARCHAR(255), unique index), passwordHash (VARCHAR(255)), createdAt (TIMESTAMP)"
+
+### Consistency
+Follow existing codebase patterns. Don't introduce new architectural patterns without strong justification. Use the explore agent to understand conventions.
+
+### Traceability
+Every PRD user story must map to technical components. Anyone should be able to trace from requirements → architecture → implementation.
+
+### Security by Default
+Address security in every section. Authentication, authorization, validation, encryption should be explicit, not afterthoughts.
+
+### Performance Awareness
+Specify performance targets and optimization strategies. Don't leave performance as "we'll optimize later."
+
+## DELEGATION STRATEGY
+
+**Always use the Task tool to delegate codebase analysis to the explore agent.**
+
+Example:
+\`\`\`
+I need to analyze the existing codebase patterns before designing the architecture.
+
+[Invoke Task tool with explore agent to analyze patterns]
+
+[Wait for response]
+
+Based on the codebase analysis, I'll now design the architecture to follow these conventions...
+\`\`\`
+
+**Optional: Delegate research to librarian agent for:**
+- Framework-specific best practices
+- Security patterns
+- Performance optimization techniques
+
+## OUTPUT FORMAT
+
+After generating SPEC, provide summary:
+
+\`\`\`
+SPEC GENERATION COMPLETE
+
+Feature: [feature-name]
+Location: .olympus/workflow/{feature}/spec.md
+Based on: PRD-xxx
+
+Components: X
+API Endpoints: Y
+Data Models: Z
+Requirement Coverage: 100%
+
+Key Technical Decisions:
+- [Decision 1]: [Rationale]
+- [Decision 2]: [Rationale]
+
+Implementation Phases: N
+Estimated Complexity: [Low/Medium/High]
+
+Next Steps:
+- Review SPEC for completeness and implementability
+- Begin implementation following the SPEC phases
+- Validate architecture decisions with tech lead if needed
+\`\`\`
+</role>`,
+    tools: ['Read', 'Grep', 'Glob', 'Write', 'Edit', 'Task'],
+    model: 'opus',
+    metadata: SPEC_WRITER_PROMPT_METADATA,
+};
+//# sourceMappingURL=spec-writer.js.map

package/dist/agents/spec-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-writer.js","sourceRoot":"","sources":["../../src/agents/spec-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,CAAC,MAAM,2BAA2B,GAAwB;IAC9D,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE;QACR;YACE,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE,oCAAoC;SAC9C;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,wCAAwC;SAClD;KACF;IACD,OAAO,EAAE;QACP,iCAAiC;QACjC,8BAA8B;QAC9B,sBAAsB;QACtB,yDAAyD;KAC1D;IACD,SAAS,EAAE;QACT,mBAAmB;QACnB,0BAA0B;QAC1B,kDAAkD;QAClD,sBAAsB;KACvB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,8GAA8G;IAC3H,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA6dF;IACN,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IACxD,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE,2BAA2B;CACtC,CAAC"}

package/dist/features/index.d.ts

@@ -12,4 +12,5 @@ export { saveCheckpoint, loadCheckpoint, listCheckpoints, validateCheckpoint, ha
 export { routeTask, routeWithEscalation, routeAndAdaptTask, escalateModel, canEscalate, explainRouting, quickTierForAgent, extractLexicalSignals, extractStructuralSignals, extractContextSignals, extractAllSignals, calculateComplexityScore, calculateComplexityTier, scoreToTier, getScoreBreakdown, calculateConfidence, evaluateRules, getMatchingRules, createRule, mergeRules, DEFAULT_ROUTING_RULES, adaptPromptForTier, getPromptStrategy, getPromptPrefix, getPromptSuffix, createDelegationPrompt, getTaskInstructions, TIER_MODELS, TIER_TO_MODEL_TYPE, DEFAULT_ROUTING_CONFIG, AGENT_CATEGORY_TIERS, COMPLEXITY_KEYWORDS, TIER_PROMPT_STRATEGIES, TIER_TASK_INSTRUCTIONS, type ComplexityTier, type ComplexitySignals, type LexicalSignals, type StructuralSignals, type ContextSignals, type RoutingDecision, type RoutingContext, type RoutingConfig, type RoutingRule, type PromptAdaptationStrategy, } from './model-routing/index.js';
 export { SessionState, sessionState, type TaskCompletion } from './session-state/index.js';
 export { logViolation, getViolationStats, readViolations, clearViolations, type HookViolation } from './hook-logging/index.js';
+export { type WorkflowStage, type WorkflowStatus, type ArtifactReference, type ValidationResult, type RequirementMapping, type WorkflowCheckpoint, saveCheckpoint as saveWorkflowCheckpoint, loadCheckpoint as loadWorkflowCheckpoint, listWorkflows, deleteWorkflow, ensureWorkflowDir, getArtifactPath, writeArtifact, readArtifact, } from './workflow-engine/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/index.d.ts.map

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

package/dist/features/index.js

@@ -54,4 +54,10 @@ TIER_MODELS, TIER_TO_MODEL_TYPE, DEFAULT_ROUTING_CONFIG, AGENT_CATEGORY_TIERS, C
 export { SessionState, sessionState } from './session-state/index.js';
 // Hook Logging - violation logging
 export { logViolation, getViolationStats, readViolations, clearViolations } from './hook-logging/index.js';
+// Workflow Engine - structured workflow system
+export { 
+// Checkpoint persistence
+saveCheckpoint as saveWorkflowCheckpoint, loadCheckpoint as loadWorkflowCheckpoint, listWorkflows, deleteWorkflow, 
+// Artifact management
+ensureWorkflowDir, getArtifactPath, writeArtifact, readArtifact, } from './workflow-engine/index.js';
 //# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AAEvC,OAAO;AAOL,YAAY;AACZ,UAAU,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY;AACZ,YAAY;AACZ,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB;AACjB,qBAAqB;AACrB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAE1B,sCAAsC;AACtC,OAAO;AAKL,YAAY;AACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,cAAc;AACd,YAAY;AACZ,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,mEAAmE;AACnE,OAAO;AACL,UAAU;AACV,gBAAgB,EAChB,gBAAgB;AAChB,YAAY;AACZ,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EAW1B,MAAM,6BAA6B,CAAC;AAErC,gDAAgD;AAChD,OAAO;AACL,UAAU;AACV,iBAAiB,EACjB,kBAAkB;AAClB,YAAY;AACZ,oBAAoB,EACpB,sBAAsB,EAQvB,MAAM,6BAA6B,CAAC;AAErC,6CAA6C;AAC7C,OAAO;AACL,YAAY;AACZ,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EAKtB,MAAM,2BAA2B,CAAC;AAEnC,0DAA0D;AAC1D,OAAO;AACL,YAAY;AACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,iBAAiB,EAGlB,MAAM,8BAA8B,CAAC;AAEtC,iDAAiD;AACjD,OAAO;AACL,iBAAiB;AACjB,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB;AACjB,oBAAoB;AACpB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB;AACjB,UAAU;AACV,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,mBAAmB;AACnB,QAAQ;AACR,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,qBAAqB;AACrB,oBAAoB;AACpB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,mBAAmB;AACnB,YAAY;AACZ,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GAYvB,MAAM,0BAA0B,CAAC;AAElC,2CAA2C;AAC3C,OAAO,EACL,YAAY,EACZ,YAAY,EAEb,MAAM,0BAA0B,CAAC;AAElC,mCAAmC;AACnC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EAEhB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,96 @@
+import { WorkflowStage, IntentTask, DependencyGraph } from './types.js';
+/**
+ * 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 declare function ensureWorkflowDir(projectPath: string, workflowId: string): Promise<void>;
+/**
+ * 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 declare function getArtifactPath(projectPath: string, workflowId: string, stage: WorkflowStage): string;
+/**
+ * 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 declare function writeArtifact(projectPath: string, workflowId: string, stage: WorkflowStage, content: string): Promise<void>;
+/**
+ * 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 declare function readArtifact(projectPath: string, workflowId: string, stage: WorkflowStage): Promise<string | null>;
+/**
+ * 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 declare function generateDependencyGraph(tasks: IntentTask[]): DependencyGraph;
+/**
+ * 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 declare function validateDependencyGraph(graph: DependencyGraph): void;
+/**
+ * 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 declare function getExecutionOrder(graph: DependencyGraph): string[];
+/**
+ * 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 declare function linkMasterPlan(projectPath: string, workflowId: string): Promise<void>;
+//# sourceMappingURL=artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/features/workflow-engine/artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAc,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpF;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D9F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAmBrG;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,eAAe,CAgB5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CA8DpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAkDlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAiFf"}