@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.5

package/dist/validation/dod-validator.js

@@ -1,198 +0,0 @@
-/**
- * @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

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

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

@@ -1,59 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,64 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,93 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,98 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,100 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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"}