@libar-dev/architect 1.0.0-pre.3

package/dist/validation/fsm/transitions.js

@@ -0,0 +1,122 @@
+/**
+ * @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 { DEFAULT_TAG_PREFIX } from '../../config/defaults.js';
+/**
+ * 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 const VALID_TRANSITIONS = {
+    roadmap: ['active', 'deferred', 'roadmap'], // Can start work, park, or stay in planning
+    active: ['completed', 'roadmap'], // Can finish or regress if blocked
+    completed: [], // Terminal state - no transitions allowed
+    deferred: ['roadmap'], // Must reactivate through roadmap first
+};
+/**
+ * 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 function isValidTransition(from, to) {
+    const validTargets = VALID_TRANSITIONS[from];
+    return validTargets.includes(to);
+}
+/**
+ * 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 function getValidTransitionsFrom(status) {
+    return VALID_TRANSITIONS[status];
+}
+/**
+ * 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 function getTransitionErrorMessage(from, to, options) {
+    const tagPrefix = options?.registry?.tagPrefix ?? DEFAULT_TAG_PREFIX;
+    // Handle terminal state
+    if (from === 'completed') {
+        return `Cannot transition from 'completed' (terminal state). Use ${tagPrefix}unlock-reason to modify.`;
+    }
+    // Handle skipping active (roadmap → completed)
+    if (from === 'roadmap' && to === 'completed') {
+        return `Cannot transition from 'roadmap' to 'completed'. Must go through 'active' first.`;
+    }
+    // Handle deferred shortcuts
+    if (from === 'deferred' && (to === 'active' || to === 'completed')) {
+        return `Cannot transition from 'deferred' to '${to}'. Must reactivate to 'roadmap' first.`;
+    }
+    // Generic message
+    const validTargets = VALID_TRANSITIONS[from];
+    if (validTargets.length === 0) {
+        return `Cannot transition from '${from}' (terminal state).`;
+    }
+    return `Invalid transition from '${from}' to '${to}'. Valid targets: ${validTargets.join(', ')}.`;
+}
+//# sourceMappingURL=transitions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../../src/validation/fsm/transitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAU9D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAE1B;IACF,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,4CAA4C;IACxF,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,mCAAmC;IACrE,SAAS,EAAE,EAAE,EAAE,0CAA0C;IACzD,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,wCAAwC;CACvD,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAwB,EAAE,EAAsB;IAChF,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IAChE,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAwB,EACxB,EAAsB,EACtB,OAAkC;IAElC,MAAM,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,SAAS,IAAI,kBAAkB,CAAC;IAErE,wBAAwB;IACxB,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,4DAA4D,SAAS,0BAA0B,CAAC;IACzG,CAAC;IAED,+CAA+C;IAC/C,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;QAC7C,OAAO,kFAAkF,CAAC;IAC5F,CAAC;IAED,4BAA4B;IAC5B,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,WAAW,CAAC,EAAE,CAAC;QACnE,OAAO,yCAAyC,EAAE,wCAAwC,CAAC;IAC7F,CAAC;IAED,kBAAkB;IAClB,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,2BAA2B,IAAI,qBAAqB,CAAC;IAC9D,CAAC;IAED,OAAO,4BAA4B,IAAI,SAAS,EAAE,qBAAqB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACpG,CAAC"}

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

@@ -0,0 +1,163 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern FSMValidator
+ * @architect-status active
+ * @architect-implements PhaseStateMachineValidation
+ * @architect-uses FSMTransitions, FSMStates
+ * @architect-depends-on:PDR005MvpWorkflow
+ * @architect-arch-role decider
+ * @architect-arch-context validation
+ * @architect-arch-layer application
+ *
+ * ## FSM Validator - Pure Validation Functions
+ *
+ * Pure validation functions following the Decider pattern:
+ * - No I/O, no side effects
+ * - Return structured results, never throw
+ * - Composable and testable
+ *
+ * ### When to Use
+ *
+ * - Use `validateStatus()` to validate status values before processing
+ * - Use `validateTransition()` to check proposed status changes
+ * - Use `validateCompletionMetadata()` to enforce completed state requirements
+ */
+import { type ProcessStatusValue } from '../../taxonomy/index.js';
+import type { TagRegistry } from '../../validation-schemas/tag-registry.js';
+import { type ProtectionLevel } from './states.js';
+/**
+ * Result of validating a status value
+ */
+export interface StatusValidationResult {
+    /** Whether the status is valid */
+    valid: boolean;
+    /** The status that was validated */
+    status: string;
+    /** Error message if invalid */
+    error?: string;
+    /** Warnings (valid but with caveats) */
+    warnings?: string[];
+}
+/**
+ * Result of validating a status transition
+ */
+export interface TransitionValidationResult {
+    /** Whether the transition is valid */
+    valid: boolean;
+    /** The source status */
+    from: ProcessStatusValue;
+    /** The target status */
+    to: ProcessStatusValue;
+    /** Error message if invalid */
+    error?: string;
+    /** Valid alternatives if transition is invalid */
+    validAlternatives?: readonly ProcessStatusValue[];
+}
+/**
+ * Result of validating completion metadata
+ */
+export interface CompletionMetadataValidationResult {
+    /** Whether the metadata is valid/complete */
+    valid: boolean;
+    /** Warnings for missing optional metadata */
+    warnings: string[];
+}
+/**
+ * Pattern metadata for completion validation
+ */
+export interface PatternMetadata {
+    status: string;
+    completed?: string;
+    effortActual?: string;
+    effortPlanned?: string;
+}
+/**
+ * Options for FSM validation functions
+ */
+export interface FSMValidationOptions {
+    /** Tag registry for prefix-aware error messages (optional) */
+    readonly registry?: TagRegistry;
+}
+/**
+ * Validate a status value against PDR-005 FSM
+ *
+ * @param status - Status value to validate
+ * @param options - Optional validation options with registry
+ * @returns Validation result with error/warnings
+ *
+ * @example
+ * ```typescript
+ * validateStatus("roadmap"); // → { valid: true, status: "roadmap" }
+ * validateStatus("done"); // → { valid: false, status: "done", error: "Invalid status..." }
+ * ```
+ */
+export declare function validateStatus(status: string, options?: FSMValidationOptions): StatusValidationResult;
+/**
+ * Validate a status transition against FSM rules
+ *
+ * @param from - Current status
+ * @param to - Target status
+ * @returns Validation result with alternatives if invalid
+ *
+ * @example
+ * ```typescript
+ * validateTransition("roadmap", "active");
+ * // → { valid: true, from: "roadmap", to: "active" }
+ *
+ * validateTransition("roadmap", "completed");
+ * // → { valid: false, from: "roadmap", to: "completed",
+ * //     error: "Cannot transition...", validAlternatives: ["active", "deferred", "roadmap"] }
+ * ```
+ */
+export declare function validateTransition(from: string, to: string): TransitionValidationResult;
+/**
+ * Validate completion metadata requirements
+ *
+ * When a pattern has status "completed", it should have:
+ * - completed date tag (warning if missing)
+ * - effort-actual tag (warning if effort-planned exists but actual doesn't)
+ *
+ * @param pattern - Pattern metadata to validate
+ * @param options - Optional validation options with registry
+ * @returns Validation result with warnings
+ *
+ * @example
+ * ```typescript
+ * validateCompletionMetadata({ status: "completed" });
+ * // → { valid: true, warnings: ["Completed pattern missing completed date tag"] }
+ *
+ * validateCompletionMetadata({ status: "completed", completed: "2026-01-09" });
+ * // → { valid: true, warnings: [] }
+ * ```
+ */
+export declare function validateCompletionMetadata(pattern: PatternMetadata, options?: FSMValidationOptions): CompletionMetadataValidationResult;
+/**
+ * Full validation of a pattern's status and metadata
+ *
+ * Combines status validation with completion metadata checks.
+ *
+ * @param pattern - Pattern metadata to validate
+ * @param options - Optional validation options with registry
+ * @returns Combined validation result
+ */
+export declare function validatePatternStatus(pattern: PatternMetadata, options?: FSMValidationOptions): {
+    valid: boolean;
+    statusResult: StatusValidationResult;
+    completionResult: CompletionMetadataValidationResult;
+    allWarnings: string[];
+};
+/**
+ * Get a summary of FSM protection for a status
+ *
+ * @param status - Status to describe
+ * @param options - Optional validation options with registry
+ * @returns Human-readable protection description
+ */
+export declare function getProtectionSummary(status: ProcessStatusValue, options?: FSMValidationOptions): {
+    level: ProtectionLevel;
+    description: string;
+    canAddDeliverables: boolean;
+    requiresUnlock: boolean;
+};
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validation/fsm/validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAM5E,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAGxF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,wBAAwB;IACxB,EAAE,EAAE,kBAAkB,CAAC;IACvB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AASD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAC7B,sBAAsB,CAyBxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,0BAA0B,CAsCvF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,kCAAkC,CA0BpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B;IACD,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,sBAAsB,CAAC;IACrC,gBAAgB,EAAE,kCAAkC,CAAC;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAYA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B;IACD,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB,CAgBA"}

package/dist/validation/fsm/validator.js

@@ -0,0 +1,205 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern FSMValidator
+ * @architect-status active
+ * @architect-implements PhaseStateMachineValidation
+ * @architect-uses FSMTransitions, FSMStates
+ * @architect-depends-on:PDR005MvpWorkflow
+ * @architect-arch-role decider
+ * @architect-arch-context validation
+ * @architect-arch-layer application
+ *
+ * ## FSM Validator - Pure Validation Functions
+ *
+ * Pure validation functions following the Decider pattern:
+ * - No I/O, no side effects
+ * - Return structured results, never throw
+ * - Composable and testable
+ *
+ * ### When to Use
+ *
+ * - Use `validateStatus()` to validate status values before processing
+ * - Use `validateTransition()` to check proposed status changes
+ * - Use `validateCompletionMetadata()` to enforce completed state requirements
+ */
+import { PROCESS_STATUS_VALUES } from '../../taxonomy/index.js';
+import { VALID_TRANSITIONS, getValidTransitionsFrom, getTransitionErrorMessage, } from './transitions.js';
+import { isTerminalState, getProtectionLevel } from './states.js';
+import { DEFAULT_TAG_PREFIX } from '../../config/defaults.js';
+/**
+ * Check if a string is a valid ProcessStatusValue
+ */
+function isValidStatusValue(status) {
+    return PROCESS_STATUS_VALUES.includes(status);
+}
+/**
+ * Validate a status value against PDR-005 FSM
+ *
+ * @param status - Status value to validate
+ * @param options - Optional validation options with registry
+ * @returns Validation result with error/warnings
+ *
+ * @example
+ * ```typescript
+ * validateStatus("roadmap"); // → { valid: true, status: "roadmap" }
+ * validateStatus("done"); // → { valid: false, status: "done", error: "Invalid status..." }
+ * ```
+ */
+export function validateStatus(status, options) {
+    const tagPrefix = options?.registry?.tagPrefix ?? DEFAULT_TAG_PREFIX;
+    if (!isValidStatusValue(status)) {
+        return {
+            valid: false,
+            status,
+            error: `Invalid status '${status}'. Valid values: ${PROCESS_STATUS_VALUES.join(', ')}.`,
+        };
+    }
+    const warnings = [];
+    // Add contextual warnings for terminal state
+    if (isTerminalState(status)) {
+        warnings.push(`Status 'completed' is a terminal state. Use ${tagPrefix}unlock-reason to modify.`);
+    }
+    return {
+        valid: true,
+        status,
+        ...(warnings.length > 0 && { warnings }),
+    };
+}
+/**
+ * Validate a status transition against FSM rules
+ *
+ * @param from - Current status
+ * @param to - Target status
+ * @returns Validation result with alternatives if invalid
+ *
+ * @example
+ * ```typescript
+ * validateTransition("roadmap", "active");
+ * // → { valid: true, from: "roadmap", to: "active" }
+ *
+ * validateTransition("roadmap", "completed");
+ * // → { valid: false, from: "roadmap", to: "completed",
+ * //     error: "Cannot transition...", validAlternatives: ["active", "deferred", "roadmap"] }
+ * ```
+ */
+export function validateTransition(from, to) {
+    // First validate both status values
+    if (!isValidStatusValue(from)) {
+        return {
+            valid: false,
+            from: from, // Type assertion for interface compliance
+            to: to,
+            error: `Invalid source status '${from}'. Valid values: ${PROCESS_STATUS_VALUES.join(', ')}.`,
+        };
+    }
+    if (!isValidStatusValue(to)) {
+        return {
+            valid: false,
+            from,
+            to: to,
+            error: `Invalid target status '${to}'. Valid values: ${PROCESS_STATUS_VALUES.join(', ')}.`,
+        };
+    }
+    // Check if transition is valid
+    const validTargets = VALID_TRANSITIONS[from];
+    if (validTargets.includes(to)) {
+        return {
+            valid: true,
+            from,
+            to,
+        };
+    }
+    // Invalid transition - provide helpful error and alternatives
+    return {
+        valid: false,
+        from,
+        to,
+        error: getTransitionErrorMessage(from, to),
+        validAlternatives: getValidTransitionsFrom(from),
+    };
+}
+/**
+ * Validate completion metadata requirements
+ *
+ * When a pattern has status "completed", it should have:
+ * - completed date tag (warning if missing)
+ * - effort-actual tag (warning if effort-planned exists but actual doesn't)
+ *
+ * @param pattern - Pattern metadata to validate
+ * @param options - Optional validation options with registry
+ * @returns Validation result with warnings
+ *
+ * @example
+ * ```typescript
+ * validateCompletionMetadata({ status: "completed" });
+ * // → { valid: true, warnings: ["Completed pattern missing completed date tag"] }
+ *
+ * validateCompletionMetadata({ status: "completed", completed: "2026-01-09" });
+ * // → { valid: true, warnings: [] }
+ * ```
+ */
+export function validateCompletionMetadata(pattern, options) {
+    const tagPrefix = options?.registry?.tagPrefix ?? DEFAULT_TAG_PREFIX;
+    const warnings = [];
+    // Only check completion requirements for completed status
+    if (pattern.status !== 'completed') {
+        return { valid: true, warnings: [] };
+    }
+    // Check for completion date
+    if (!pattern.completed) {
+        warnings.push(`Completed pattern missing ${tagPrefix}completed date.`);
+    }
+    // Check for effort tracking consistency
+    if (pattern.effortPlanned && !pattern.effortActual) {
+        warnings.push(`Pattern has ${tagPrefix}effort but missing ${tagPrefix}effort-actual. ` +
+            'Consider adding actual effort for tracking.');
+    }
+    return {
+        valid: true,
+        warnings,
+    };
+}
+/**
+ * Full validation of a pattern's status and metadata
+ *
+ * Combines status validation with completion metadata checks.
+ *
+ * @param pattern - Pattern metadata to validate
+ * @param options - Optional validation options with registry
+ * @returns Combined validation result
+ */
+export function validatePatternStatus(pattern, options) {
+    const statusResult = validateStatus(pattern.status, options);
+    const completionResult = validateCompletionMetadata(pattern, options);
+    const allWarnings = [...(statusResult.warnings ?? []), ...completionResult.warnings];
+    return {
+        valid: statusResult.valid && completionResult.valid,
+        statusResult,
+        completionResult,
+        allWarnings,
+    };
+}
+/**
+ * Get a summary of FSM protection for a status
+ *
+ * @param status - Status to describe
+ * @param options - Optional validation options with registry
+ * @returns Human-readable protection description
+ */
+export function getProtectionSummary(status, options) {
+    const tagPrefix = options?.registry?.tagPrefix ?? DEFAULT_TAG_PREFIX;
+    const level = getProtectionLevel(status);
+    const descriptions = {
+        none: 'Fully editable - no restrictions',
+        scope: 'Scope-locked - cannot add new deliverables',
+        hard: `Hard-locked - requires ${tagPrefix}unlock-reason to modify`,
+    };
+    return {
+        level,
+        description: descriptions[level],
+        canAddDeliverables: level === 'none',
+        requiresUnlock: level === 'hard',
+    };
+}
+//# sourceMappingURL=validator.js.map

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

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

package/dist/validation/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern ValidationModule
+ * @architect-status completed
+ *
+ * ## ValidationModule - DoD Validation and Anti-Pattern Detection
+ *
+ * Barrel export for validation module providing:
+ * - Definition of Done (DoD) validation for completed phases
+ * - Anti-pattern detection for documentation architecture violations
+ *
+ * ### When to Use
+ *
+ * - Import validation functions for CLI integration
+ * - Import types for extending validation rules
+ */
+export type { AntiPatternId, AntiPatternThresholds, AntiPatternViolation, DoDValidationResult, DoDValidationSummary, WithTagRegistry, } from './types.js';
+export { AntiPatternThresholdsSchema, DEFAULT_THRESHOLDS, getPhaseStatusEmoji } from './types.js';
+export { isDeliverableComplete, hasAcceptanceCriteria, extractAcceptanceCriteriaScenarios, validateDoDForPhase, validateDoD, formatDoDSummary, } from './dod-validator.js';
+export { type AntiPatternDetectionOptions, detectProcessInCode, detectMagicComments, detectScenarioBloat, detectMegaFeature, detectAntiPatterns, formatAntiPatternReport, toValidationIssues, } from './anti-patterns.js';
+export * from './fsm/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGlG,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kCAAkC,EAClC,mBAAmB,EACnB,WAAW,EACX,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,2BAA2B,EAChC,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,gBAAgB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,25 @@
+/**
+ * @architect
+ * @architect-validation
+ * @architect-pattern ValidationModule
+ * @architect-status completed
+ *
+ * ## ValidationModule - DoD Validation and Anti-Pattern Detection
+ *
+ * Barrel export for validation module providing:
+ * - Definition of Done (DoD) validation for completed phases
+ * - Anti-pattern detection for documentation architecture violations
+ *
+ * ### When to Use
+ *
+ * - Import validation functions for CLI integration
+ * - Import types for extending validation rules
+ */
+export { AntiPatternThresholdsSchema, DEFAULT_THRESHOLDS, getPhaseStatusEmoji } from './types.js';
+// DoD Validator
+export { isDeliverableComplete, hasAcceptanceCriteria, extractAcceptanceCriteriaScenarios, validateDoDForPhase, validateDoD, formatDoDSummary, } from './dod-validator.js';
+// Anti-Pattern Detector
+export { detectProcessInCode, detectMagicComments, detectScenarioBloat, detectMegaFeature, detectAntiPatterns, formatAntiPatternReport, toValidationIssues, } from './anti-patterns.js';
+// FSM Module - Phase State Machine (PDR-005)
+export * from './fsm/index.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElG,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kCAAkC,EAClC,mBAAmB,EACnB,WAAW,EACX,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,wBAAwB;AACxB,OAAO,EAEL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,6CAA6C;AAC7C,cAAc,gBAAgB,CAAC"}