@libar-dev/architect 1.0.0-pre.3

package/dist/validation/dod-validator.js

@@ -0,0 +1,198 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern DoDValidator
+ * @architect-status completed
+ * @architect-arch-role service
+ * @architect-arch-context validation
+ * @architect-arch-layer application
+ * @architect-uses DoDValidationTypes, GherkinTypes, DualSourceExtractor
+ * @architect-extract-shapes isDeliverableComplete, hasAcceptanceCriteria, extractAcceptanceCriteriaScenarios, validateDoDForPhase, validateDoD, formatDoDSummary
+ *
+ * ## DoDValidator - Definition of Done Validation
+ *
+ * Validates that completed phases meet Definition of Done criteria:
+ * 1. All deliverables must be in a terminal state (complete, n/a, or superseded)
+ * 2. At least one @acceptance-criteria scenario must exist
+ *
+ * ### When to Use
+ *
+ * - Pre-release validation to ensure phases are truly complete
+ * - CI pipeline checks to prevent premature "done" declarations
+ * - Manual DoD checks during code review
+ */
+import { extractProcessMetadata, extractDeliverables } from '../extractor/dual-source-extractor.js';
+import { isDeliverableStatusComplete, isDeliverableStatusTerminal, isPatternComplete, } from '../taxonomy/index.js';
+/**
+ * Check if a deliverable has "complete" status.
+ *
+ * This checks for the literal 'complete' status value only.
+ * For DoD validation (which also accepts 'n/a' and 'superseded'),
+ * see isDeliverableStatusTerminal().
+ *
+ * @param deliverable - The deliverable to check
+ * @returns True if the deliverable status is 'complete'
+ */
+export function isDeliverableComplete(deliverable) {
+    return isDeliverableStatusComplete(deliverable.status);
+}
+/**
+ * Check if a feature has @acceptance-criteria scenarios
+ *
+ * Scans scenarios for the @acceptance-criteria tag, which indicates
+ * BDD-driven acceptance tests.
+ *
+ * @param feature - The scanned feature file to check
+ * @returns True if at least one @acceptance-criteria scenario exists
+ */
+export function hasAcceptanceCriteria(feature) {
+    return feature.scenarios.some((scenario) => scenario.tags.some((tag) => tag.toLowerCase() === 'acceptance-criteria'));
+}
+/**
+ * Extract acceptance criteria scenario names from a feature
+ *
+ * @param feature - The scanned feature file
+ * @returns Array of scenario names with @acceptance-criteria tag
+ */
+export function extractAcceptanceCriteriaScenarios(feature) {
+    return feature.scenarios
+        .filter((scenario) => scenario.tags.some((tag) => tag.toLowerCase() === 'acceptance-criteria'))
+        .map((scenario) => scenario.name);
+}
+/**
+ * Validate DoD for a single phase/pattern
+ *
+ * Checks:
+ * 1. All deliverables must be in a terminal state (complete, n/a, superseded)
+ * 2. At least one @acceptance-criteria scenario exists
+ *
+ * @param patternName - Name of the pattern being validated
+ * @param phase - Phase number being validated
+ * @param feature - The scanned feature file with deliverables and scenarios
+ * @returns DoD validation result
+ */
+export function validateDoDForPhase(patternName, phase, feature) {
+    const deliverables = extractDeliverables(feature);
+    const messages = [];
+    // Check deliverables — terminal states (complete, n/a, superseded) pass DoD
+    const incompleteDeliverables = deliverables.filter((d) => !isDeliverableStatusTerminal(d.status));
+    const allDeliverablesComplete = incompleteDeliverables.length === 0;
+    if (deliverables.length === 0) {
+        messages.push(`No deliverables defined for phase ${phase}`);
+    }
+    else if (!allDeliverablesComplete) {
+        messages.push(`${incompleteDeliverables.length}/${deliverables.length} deliverables incomplete`);
+        for (const d of incompleteDeliverables) {
+            messages.push(`  - "${d.name}" (status: ${d.status})`);
+        }
+    }
+    // Check acceptance criteria
+    const missingAcceptanceCriteria = !hasAcceptanceCriteria(feature);
+    if (missingAcceptanceCriteria) {
+        messages.push('No @acceptance-criteria scenarios found');
+    }
+    const isDoDMet = allDeliverablesComplete && !missingAcceptanceCriteria && deliverables.length > 0;
+    if (isDoDMet) {
+        messages.push(`DoD met: ${deliverables.length} deliverables complete, AC scenarios present`);
+    }
+    return {
+        patternName,
+        phase,
+        isDoDMet,
+        deliverables,
+        incompleteDeliverables,
+        missingAcceptanceCriteria,
+        messages,
+    };
+}
+/**
+ * Validate DoD across multiple phases
+ *
+ * Filters to completed phases and validates each against DoD criteria.
+ * Optionally filter to specific phases using phaseFilter.
+ *
+ * @param features - Array of scanned feature files
+ * @param phaseFilter - Optional array of phase numbers to validate (validates all if empty)
+ * @returns Aggregate DoD validation summary
+ *
+ * @example
+ * ```typescript
+ * // Validate all completed phases
+ * const summary = validateDoD(features);
+ *
+ * // Validate specific phase
+ * const summary = validateDoD(features, [14]);
+ * ```
+ */
+export function validateDoD(features, phaseFilter = []) {
+    const results = [];
+    const shouldFilterPhases = phaseFilter.length > 0;
+    for (const feature of features) {
+        const metadata = extractProcessMetadata(feature);
+        if (!metadata)
+            continue;
+        // Only validate completed phases (or phases matching filter)
+        const isCompleted = isPatternComplete(metadata.status);
+        // If phase filter specified, validate those specific phases
+        // Otherwise, only validate completed phases
+        const shouldValidate = shouldFilterPhases ? phaseFilter.includes(metadata.phase) : isCompleted;
+        if (!shouldValidate)
+            continue;
+        const result = validateDoDForPhase(metadata.pattern, metadata.phase, feature);
+        results.push(result);
+    }
+    const passedPhases = results.filter((r) => r.isDoDMet).length;
+    const failedPhases = results.filter((r) => !r.isDoDMet).length;
+    return {
+        results,
+        totalPhases: results.length,
+        passedPhases,
+        failedPhases,
+    };
+}
+/**
+ * Format DoD validation summary for console output
+ *
+ * @param summary - DoD validation summary to format
+ * @returns Multi-line string for pretty printing
+ */
+export function formatDoDSummary(summary) {
+    const lines = [];
+    lines.push('');
+    lines.push('DoD Validation Summary');
+    lines.push('======================');
+    lines.push('');
+    lines.push(`Total phases validated: ${summary.totalPhases}`);
+    lines.push(`Passed: ${summary.passedPhases}`);
+    lines.push(`Failed: ${summary.failedPhases}`);
+    lines.push('');
+    if (summary.results.length === 0) {
+        lines.push('No completed phases found to validate.');
+        return lines.join('\n');
+    }
+    // Group by pass/fail
+    const passed = summary.results.filter((r) => r.isDoDMet);
+    const failed = summary.results.filter((r) => !r.isDoDMet);
+    if (failed.length > 0) {
+        lines.push('Failed Phases:');
+        for (const result of failed) {
+            lines.push(`  [FAIL] Phase ${result.phase}: ${result.patternName}`);
+            for (const msg of result.messages) {
+                if (!msg.startsWith('DoD met')) {
+                    lines.push(`         ${msg}`);
+                }
+            }
+        }
+        lines.push('');
+    }
+    if (passed.length > 0) {
+        lines.push('Passed Phases:');
+        for (const result of passed) {
+            const deliverableCount = result.deliverables.length;
+            lines.push(`  [PASS] Phase ${result.phase}: ${result.patternName} (${deliverableCount} deliverables)`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=dod-validator.js.map

package/dist/validation/dod-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dod-validator.js","sourceRoot":"","sources":["../../src/validation/dod-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEpG,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAwB;IAC5D,OAAO,2BAA2B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,qBAAqB,CAAC,CACzE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAA2B;IAC5E,OAAO,OAAO,CAAC,SAAS;SACrB,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,qBAAqB,CAAC,CAAC;SAC9F,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,KAAa,EACb,OAA2B;IAE3B,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,4EAA4E;IAC5E,MAAM,sBAAsB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAClG,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,MAAM,KAAK,CAAC,CAAC;IAEpE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;IAC9D,CAAC;SAAM,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CACX,GAAG,sBAAsB,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,0BAA0B,CAClF,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,sBAAsB,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,yBAAyB,GAAG,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,yBAAyB,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,IAAI,CAAC,yBAAyB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAElG,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,MAAM,8CAA8C,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO;QACL,WAAW;QACX,KAAK;QACL,QAAQ;QACR,YAAY;QACZ,sBAAsB;QACtB,yBAAyB;QACzB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CACzB,QAAuC,EACvC,cAAiC,EAAE;IAEnC,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAElD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,6DAA6D;QAC7D,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEvD,4DAA4D;QAC5D,4CAA4C;QAC5C,MAAM,cAAc,GAAG,kBAAkB,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAE/F,IAAI,CAAC,cAAc;YAAE,SAAS;QAE9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9E,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC9D,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAE/D,OAAO;QACL,OAAO;QACP,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,YAAY;QACZ,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA6B;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,qBAAqB;IACrB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE1D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACpE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;YACpD,KAAK,CAAC,IAAI,CACR,kBAAkB,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,KAAK,gBAAgB,gBAAgB,CAC3F,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/validation/fsm/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern FSMModule
+ * @architect-status active
+ * @architect-depends-on:PDR005MvpWorkflow
+ *
+ * ## FSM Module - Phase State Machine Implementation
+ *
+ * Central export for the 4-state FSM defined in PDR-005:
+ *
+ * ```
+ * roadmap ──→ active ──→ completed
+ *    │          │
+ *    │          ↓
+ *    │       roadmap (blocked/regressed)
+ *    │
+ *    ↓
+ * deferred ──→ roadmap
+ * ```
+ *
+ * ### When to Use
+ *
+ * - When validating status transitions in pre-commit hooks
+ * - When checking protection levels for completed patterns
+ * - When implementing workflow enforcement in CI/CD
+ *
+ * ### Module Contents
+ *
+ * - **states.ts** - Status states and protection levels
+ * - **transitions.ts** - Valid transition matrix
+ * - **validator.ts** - Pure validation functions (Decider pattern)
+ *
+ * ### Usage Example
+ *
+ * ```typescript
+ * import {
+ *   validateStatus,
+ *   validateTransition,
+ *   getProtectionLevel,
+ *   isValidTransition
+ * } from "@libar-dev/architect/validation/fsm";
+ *
+ * // Validate a status value
+ * const result = validateStatus("roadmap");
+ * if (result.valid) {
+ *   console.log("Valid status");
+ * }
+ *
+ * // Check transition validity
+ * if (isValidTransition("roadmap", "active")) {
+ *   console.log("Can start work");
+ * }
+ * ```
+ */
+export { PROTECTION_LEVELS, type ProtectionLevel, getProtectionLevel, isTerminalState, isFullyEditable, isScopeLocked, PROCESS_STATUS_VALUES, type ProcessStatusValue, } from './states.js';
+export { VALID_TRANSITIONS, isValidTransition, getValidTransitionsFrom, getTransitionErrorMessage, type TransitionMessageOptions, } from './transitions.js';
+export { type StatusValidationResult, type TransitionValidationResult, type CompletionMetadataValidationResult, type PatternMetadata, type FSMValidationOptions, validateStatus, validateTransition, validateCompletionMetadata, validatePatternStatus, getProtectionSummary, } from './validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/fsm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/fsm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAGH,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EAEb,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,kCAAkC,EACvC,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/validation/fsm/index.js

@@ -0,0 +1,64 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern FSMModule
+ * @architect-status active
+ * @architect-depends-on:PDR005MvpWorkflow
+ *
+ * ## FSM Module - Phase State Machine Implementation
+ *
+ * Central export for the 4-state FSM defined in PDR-005:
+ *
+ * ```
+ * roadmap ──→ active ──→ completed
+ *    │          │
+ *    │          ↓
+ *    │       roadmap (blocked/regressed)
+ *    │
+ *    ↓
+ * deferred ──→ roadmap
+ * ```
+ *
+ * ### When to Use
+ *
+ * - When validating status transitions in pre-commit hooks
+ * - When checking protection levels for completed patterns
+ * - When implementing workflow enforcement in CI/CD
+ *
+ * ### Module Contents
+ *
+ * - **states.ts** - Status states and protection levels
+ * - **transitions.ts** - Valid transition matrix
+ * - **validator.ts** - Pure validation functions (Decider pattern)
+ *
+ * ### Usage Example
+ *
+ * ```typescript
+ * import {
+ *   validateStatus,
+ *   validateTransition,
+ *   getProtectionLevel,
+ *   isValidTransition
+ * } from "@libar-dev/architect/validation/fsm";
+ *
+ * // Validate a status value
+ * const result = validateStatus("roadmap");
+ * if (result.valid) {
+ *   console.log("Valid status");
+ * }
+ *
+ * // Check transition validity
+ * if (isValidTransition("roadmap", "active")) {
+ *   console.log("Can start work");
+ * }
+ * ```
+ */
+// States - Protection levels and state queries
+export { PROTECTION_LEVELS, getProtectionLevel, isTerminalState, isFullyEditable, isScopeLocked, 
+// Re-exported from taxonomy for convenience
+PROCESS_STATUS_VALUES, } from './states.js';
+// Transitions - Valid transition matrix and queries
+export { VALID_TRANSITIONS, isValidTransition, getValidTransitionsFrom, getTransitionErrorMessage, } from './transitions.js';
+// Validator - Pure validation functions
+export { validateStatus, validateTransition, validateCompletionMetadata, validatePatternStatus, getProtectionSummary, } from './validator.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/fsm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/fsm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,+CAA+C;AAC/C,OAAO,EACL,iBAAiB,EAEjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa;AACb,4CAA4C;AAC5C,qBAAqB,GAEtB,MAAM,aAAa,CAAC;AAErB,oDAAoD;AACpD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,GAE1B,MAAM,kBAAkB,CAAC;AAE1B,wCAAwC;AACxC,OAAO,EAML,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/validation/fsm/states.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @architect
+ * @architect-extract-shapes PROTECTION_LEVELS, ProtectionLevel, getProtectionLevel, isTerminalState, isFullyEditable, isScopeLocked
+ * @architect-validation
+ * @architect-pattern FSMStates
+ * @architect-status active
+ * @architect-implements PhaseStateMachineValidation
+ * @architect-depends-on:PDR005MvpWorkflow
+ * @architect-arch-role read-model
+ * @architect-arch-context validation
+ * @architect-arch-layer domain
+ *
+ * ## FSM States - Process Status States and Protection Levels
+ *
+ * Defines the 4-state FSM from PDR-005 MVP Workflow:
+ * - roadmap: Planned work (fully editable)
+ * - active: Work in progress (scope-locked)
+ * - completed: Done (hard-locked, requires unlock)
+ * - deferred: On hold (fully editable)
+ *
+ * ### When to Use
+ *
+ * - Use `getProtectionLevel()` to determine modification restrictions
+ * - Use `isTerminalState()` to check if state allows transitions
+ * - Use `PROTECTION_LEVELS` for direct lookups
+ */
+import { PROCESS_STATUS_VALUES, type ProcessStatusValue } from '../../taxonomy/index.js';
+/**
+ * Protection level types for FSM states
+ *
+ * - `none`: Fully editable, no restrictions
+ * - `scope`: Scope-locked, prevents adding new deliverables
+ * - `hard`: Hard-locked, requires explicit unlock-reason annotation
+ */
+export type ProtectionLevel = 'none' | 'scope' | 'hard';
+/**
+ * Protection level mapping per PDR-005
+ *
+ * | State     | Protection | Meaning                          |
+ * |-----------|------------|----------------------------------|
+ * | roadmap   | none       | Planning phase, fully editable   |
+ * | active    | scope      | In progress, no new deliverables |
+ * | completed | hard       | Done, requires unlock to modify  |
+ * | deferred  | none       | Parked, fully editable           |
+ */
+export declare const PROTECTION_LEVELS: Readonly<Record<ProcessStatusValue, ProtectionLevel>>;
+/**
+ * Get the protection level for a status
+ *
+ * @param status - Process status value
+ * @returns Protection level for the status
+ *
+ * @example
+ * ```typescript
+ * getProtectionLevel("active"); // → "scope"
+ * getProtectionLevel("completed"); // → "hard"
+ * ```
+ */
+export declare function getProtectionLevel(status: ProcessStatusValue): ProtectionLevel;
+/**
+ * Check if a status is a terminal state (cannot transition out)
+ *
+ * Terminal states require explicit unlock to modify.
+ *
+ * @param status - Process status value
+ * @returns true if the status is terminal
+ *
+ * @example
+ * ```typescript
+ * isTerminalState("completed"); // → true
+ * isTerminalState("active"); // → false
+ * ```
+ */
+export declare function isTerminalState(status: ProcessStatusValue): boolean;
+/**
+ * Check if a status is fully editable (no protection)
+ *
+ * @param status - Process status value
+ * @returns true if the status has no protection
+ */
+export declare function isFullyEditable(status: ProcessStatusValue): boolean;
+/**
+ * Check if a status is scope-locked
+ *
+ * @param status - Process status value
+ * @returns true if the status prevents scope changes
+ */
+export declare function isScopeLocked(status: ProcessStatusValue): boolean;
+/**
+ * Re-export status values for convenience
+ */
+export { PROCESS_STATUS_VALUES, type ProcessStatusValue };
+//# sourceMappingURL=states.d.ts.map

package/dist/validation/fsm/states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../../src/validation/fsm/states.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEzF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAK1E,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAE9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,CAAC"}

package/dist/validation/fsm/states.js

@@ -0,0 +1,98 @@
+/**
+ * @architect
+ * @architect-extract-shapes PROTECTION_LEVELS, ProtectionLevel, getProtectionLevel, isTerminalState, isFullyEditable, isScopeLocked
+ * @architect-validation
+ * @architect-pattern FSMStates
+ * @architect-status active
+ * @architect-implements PhaseStateMachineValidation
+ * @architect-depends-on:PDR005MvpWorkflow
+ * @architect-arch-role read-model
+ * @architect-arch-context validation
+ * @architect-arch-layer domain
+ *
+ * ## FSM States - Process Status States and Protection Levels
+ *
+ * Defines the 4-state FSM from PDR-005 MVP Workflow:
+ * - roadmap: Planned work (fully editable)
+ * - active: Work in progress (scope-locked)
+ * - completed: Done (hard-locked, requires unlock)
+ * - deferred: On hold (fully editable)
+ *
+ * ### When to Use
+ *
+ * - Use `getProtectionLevel()` to determine modification restrictions
+ * - Use `isTerminalState()` to check if state allows transitions
+ * - Use `PROTECTION_LEVELS` for direct lookups
+ */
+import { PROCESS_STATUS_VALUES } from '../../taxonomy/index.js';
+/**
+ * Protection level mapping per PDR-005
+ *
+ * | State     | Protection | Meaning                          |
+ * |-----------|------------|----------------------------------|
+ * | roadmap   | none       | Planning phase, fully editable   |
+ * | active    | scope      | In progress, no new deliverables |
+ * | completed | hard       | Done, requires unlock to modify  |
+ * | deferred  | none       | Parked, fully editable           |
+ */
+export const PROTECTION_LEVELS = {
+    roadmap: 'none',
+    active: 'scope',
+    completed: 'hard',
+    deferred: 'none',
+};
+/**
+ * Get the protection level for a status
+ *
+ * @param status - Process status value
+ * @returns Protection level for the status
+ *
+ * @example
+ * ```typescript
+ * getProtectionLevel("active"); // → "scope"
+ * getProtectionLevel("completed"); // → "hard"
+ * ```
+ */
+export function getProtectionLevel(status) {
+    return PROTECTION_LEVELS[status];
+}
+/**
+ * Check if a status is a terminal state (cannot transition out)
+ *
+ * Terminal states require explicit unlock to modify.
+ *
+ * @param status - Process status value
+ * @returns true if the status is terminal
+ *
+ * @example
+ * ```typescript
+ * isTerminalState("completed"); // → true
+ * isTerminalState("active"); // → false
+ * ```
+ */
+export function isTerminalState(status) {
+    return status === 'completed';
+}
+/**
+ * Check if a status is fully editable (no protection)
+ *
+ * @param status - Process status value
+ * @returns true if the status has no protection
+ */
+export function isFullyEditable(status) {
+    return PROTECTION_LEVELS[status] === 'none';
+}
+/**
+ * Check if a status is scope-locked
+ *
+ * @param status - Process status value
+ * @returns true if the status prevents scope changes
+ */
+export function isScopeLocked(status) {
+    return PROTECTION_LEVELS[status] === 'scope';
+}
+/**
+ * Re-export status values for convenience
+ */
+export { PROCESS_STATUS_VALUES };
+//# sourceMappingURL=states.js.map

package/dist/validation/fsm/states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.js","sourceRoot":"","sources":["../../../src/validation/fsm/states.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,qBAAqB,EAA2B,MAAM,yBAAyB,CAAC;AAWzF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA0D;IACtF,OAAO,EAAE,MAAM;IACf,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,MAAM;CACR,CAAC;AAEX;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,OAAO,MAAM,KAAK,WAAW,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,OAAO,iBAAiB,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAA2B,CAAC"}

package/dist/validation/fsm/transitions.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern FSMTransitions
+ * @architect-status active
+ * @architect-implements PhaseStateMachineValidation
+ * @architect-depends-on:PDR005MvpWorkflow
+ * @architect-extract-shapes VALID_TRANSITIONS, isValidTransition, getValidTransitionsFrom, getTransitionErrorMessage
+ * @architect-arch-role read-model
+ * @architect-arch-context validation
+ * @architect-arch-layer domain
+ *
+ * ## FSM Transitions - Valid State Transition Matrix
+ *
+ * Defines valid transitions between FSM states per PDR-005:
+ *
+ * ```
+ * roadmap ──→ active ──→ completed
+ *    │          │
+ *    │          ↓
+ *    │       roadmap (blocked/regressed)
+ *    │
+ *    ↓
+ * deferred ──→ roadmap
+ * ```
+ *
+ * ### When to Use
+ *
+ * - Use `isValidTransition()` to validate proposed status changes
+ * - Use `getValidTransitionsFrom()` to show available options
+ */
+import type { ProcessStatusValue } from '../../taxonomy/index.js';
+import type { TagRegistry } from '../../validation-schemas/tag-registry.js';
+/**
+ * Options for transition functions that generate messages
+ */
+export interface TransitionMessageOptions {
+    /** Tag registry providing prefix for error message formatting */
+    readonly registry?: TagRegistry;
+}
+/**
+ * Valid FSM transitions matrix
+ *
+ * Maps each state to the list of states it can transition to.
+ *
+ * | From      | Valid Targets              | Notes                        |
+ * |-----------|----------------------------|------------------------------|
+ * | roadmap   | active, deferred, roadmap  | Can start, park, or stay     |
+ * | active    | completed, roadmap         | Can finish or regress        |
+ * | completed | (none)                     | Terminal state               |
+ * | deferred  | roadmap                    | Must go through roadmap      |
+ */
+export declare const VALID_TRANSITIONS: Readonly<Record<ProcessStatusValue, readonly ProcessStatusValue[]>>;
+/**
+ * Check if a transition between two states is valid
+ *
+ * @param from - Current status
+ * @param to - Target status
+ * @returns true if the transition is allowed
+ *
+ * @example
+ * ```typescript
+ * isValidTransition("roadmap", "active"); // → true
+ * isValidTransition("roadmap", "completed"); // → false (must go through active)
+ * isValidTransition("completed", "active"); // → false (terminal state)
+ * ```
+ */
+export declare function isValidTransition(from: ProcessStatusValue, to: ProcessStatusValue): boolean;
+/**
+ * Get all valid transitions from a given state
+ *
+ * @param status - Current status
+ * @returns Array of valid target states (empty for terminal states)
+ *
+ * @example
+ * ```typescript
+ * getValidTransitionsFrom("roadmap"); // → ["active", "deferred", "roadmap"]
+ * getValidTransitionsFrom("completed"); // → []
+ * ```
+ */
+export declare function getValidTransitionsFrom(status: ProcessStatusValue): readonly ProcessStatusValue[];
+/**
+ * Get a human-readable description of why a transition is invalid
+ *
+ * @param from - Current status
+ * @param to - Attempted target status
+ * @param options - Optional message options with registry for prefix
+ * @returns Error message describing the violation
+ *
+ * @example
+ * ```typescript
+ * getTransitionErrorMessage("roadmap", "completed");
+ * // → "Cannot transition from 'roadmap' to 'completed'. Must go through 'active' first."
+ *
+ * getTransitionErrorMessage("completed", "active");
+ * // → "Cannot transition from 'completed' (terminal state). Use unlock-reason tag to modify."
+ * ```
+ */
+export declare function getTransitionErrorMessage(from: ProcessStatusValue, to: ProcessStatusValue, options?: TransitionMessageOptions): string;
+//# sourceMappingURL=transitions.d.ts.map

package/dist/validation/fsm/transitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../src/validation/fsm/transitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CACtC,MAAM,CAAC,kBAAkB,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAMjD,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAG3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,kBAAkB,EAAE,CAEjG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,kBAAkB,EACtB,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAyBR"}