olympus-ai 3.4.0 → 3.5.0

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

@@ -0,0 +1,128 @@
+/**
+ * IDEA Artifact Validation
+ *
+ * Validates completeness of IDEA stage artifacts against required criteria.
+ * An IDEA artifact must contain all essential sections for progression to PRD stage.
+ *
+ * Performance optimizations:
+ * - Parallel validation where possible
+ * - Cached file reads within validation session
+ * - Optimized regex patterns
+ */
+import { ValidationResult } from './types.js';
+/**
+ * Clear the file cache
+ */
+export declare function clearFileCache(): void;
+/**
+ * Validates an IDEA artifact for completeness.
+ *
+ * Checks 6 criteria:
+ * 1. Problem statement present (non-empty ## Problem Statement section)
+ * 2. Business context present (non-empty ## Business Context section)
+ * 3. At least 2 success metrics (check ## Success Metrics section has 2+ bullet points)
+ * 4. Constraints documented (## Constraints section present with content)
+ * 5. Risk tier assessed (YAML frontmatter has risk_tier field)
+ * 6. All required sections present (all 5 sections exist in document)
+ *
+ * @param artifactPath - Absolute path to the IDEA artifact file
+ * @returns ValidationResult with pass/fail status, coverage percentage, and any blocking issues
+ *
+ * @example
+ * const result = await validateIdea('.olympus/workflows/feature-x/idea.md');
+ * if (result.passed) {
+ *   console.log('IDEA artifact is complete!');
+ * } else {
+ *   console.log('Issues found:', result.blocking_issues);
+ * }
+ */
+export declare function validateIdea(artifactPath: string): Promise<ValidationResult>;
+/**
+ * Validates a PRD artifact for coverage against IDEA constraints.
+ *
+ * **Phase 2 MVP Stub Implementation**
+ * This is a simplified implementation that calculates coverage but does not
+ * invoke the Momus agent for critical review. Full Momus integration is
+ * deferred to Phase 3.
+ *
+ * Checks:
+ * - PRD addresses >= 90% of IDEA constraints
+ * - User stories are present
+ * - Requirement coverage section exists
+ *
+ * TODO (Phase 3): Integrate Momus agent for:
+ * - Scope drift detection
+ * - Acceptance criteria completeness check
+ * - Risk alignment verification
+ *
+ * @param artifactPath - Absolute path to the PRD artifact file
+ * @param ideaPath - Absolute path to the IDEA artifact file
+ * @returns ValidationResult with coverage percentage and Momus placeholder
+ *
+ * @example
+ * const result = await validatePrd(
+ *   '.olympus/workflows/feature-x/prd.md',
+ *   '.olympus/workflows/feature-x/idea.md'
+ * );
+ * if (result.coverage_percentage >= 90) {
+ *   console.log('PRD has sufficient coverage');
+ * }
+ */
+export declare function validatePrd(artifactPath: string, ideaPath: string): Promise<ValidationResult>;
+/**
+ * Validates a SPEC artifact for coverage against PRD user stories.
+ *
+ * **Phase 2 MVP Stub Implementation**
+ * This is a simplified implementation that calculates coverage but does not
+ * invoke the Metis agent for critical review. Full Metis integration is
+ * deferred to Phase 3.
+ *
+ * Checks:
+ * - SPEC implements >= 95% of PRD user stories
+ * - Requirement coverage section exists
+ * - All components documented
+ *
+ * TODO (Phase 3): Integrate Metis agent for:
+ * - Hidden requirements analysis
+ * - Dependency mapping completeness
+ * - Security considerations adequacy
+ * - Performance requirements coverage
+ *
+ * @param specPath - Absolute path to the SPEC artifact file
+ * @param prdPath - Absolute path to the PRD artifact file
+ * @returns ValidationResult with coverage percentage and Metis placeholder
+ *
+ * @example
+ * const result = await validateSpec(
+ *   '.olympus/workflows/feature-x/spec.md',
+ *   '.olympus/workflows/feature-x/prd.md'
+ * );
+ * if (result.coverage_percentage >= 95) {
+ *   console.log('SPEC has sufficient PRD coverage');
+ * }
+ */
+export declare function validateSpec(specPath: string, prdPath: string): Promise<ValidationResult>;
+/**
+ * Validates TASKS artifacts for coverage against SPEC components.
+ *
+ * Checks:
+ * - 100% of SPEC components have tasks
+ * - Dependency graph is valid (no circular dependencies)
+ * - All tasks have effort estimates
+ * - Effort estimates are reasonable (1, 2, 4, 8, or 16 hours)
+ *
+ * @param tasksDir - Absolute path to the tasks directory (contains INTENT files)
+ * @param specPath - Absolute path to the SPEC artifact file
+ * @returns ValidationResult with coverage percentage and validation details
+ *
+ * @example
+ * const result = await validateTasks(
+ *   '.olympus/workflows/feature-x/intents/',
+ *   '.olympus/workflows/feature-x/spec.md'
+ * );
+ * if (result.passed) {
+ *   console.log('All SPEC components have task coverage');
+ * }
+ */
+export declare function validateTasks(tasksDir: string, specPath: string): Promise<ValidationResult>;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/features/workflow-engine/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsB9C;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAaD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2HlF;AAkGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,WAAW,CAC/B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CA6G3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAsH3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAqL3B"}