@libar-dev/architect 1.0.0-pre.3

package/dist/renderable/codecs/validation-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-rules.d.ts","sourceRoot":"","sources":["../../../src/renderable/codecs/validation-rules.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA+B,CAAC"}

package/dist/renderable/codecs/validation-rules.js

@@ -0,0 +1,537 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern ValidationRulesCodec
+ * @architect-status completed
+ * @architect-convention codec-registry
+ * @architect-product-area:Generation
+ *
+ * ## ValidationRulesCodec
+ *
+ * Transforms MasterDataset into a RenderableDocument for Process Guard validation
+ * rules reference. Generates VALIDATION-RULES.md and detail files (validation/*.md).
+ *
+ * **Purpose:** Process Guard validation rules reference with FSM diagrams and protection level matrix.
+ *
+ * **Output Files:** `VALIDATION-RULES.md` (main reference), `validation/<category>.md` (category details)
+ *
+ * | Option | Type | Default | Description |
+ * | --- | --- | --- | --- |
+ * | includeFSMDiagram | boolean | true | Include FSM state diagram |
+ * | includeCLIUsage | boolean | true | Include CLI usage section |
+ * | includeEscapeHatches | boolean | true | Include escape hatches section |
+ * | includeProtectionMatrix | boolean | true | Include protection levels matrix |
+ * | includeErrorGuide | boolean | true | Include error guide with rationale and alternatives |
+ *
+ * ### When to Use
+ *
+ * - When generating validation rules reference documentation
+ * - When creating FSM state transition diagrams
+ * - When building protection level reference files
+ *
+ * ### Factory Pattern
+ *
+ * Use `createValidationRulesCodec(options)` to create a configured codec:
+ * ```typescript
+ * const codec = createValidationRulesCodec({ includeFSMDiagram: false });
+ * const doc = codec.decode(dataset);
+ * ```
+ *
+ * Or use the default export for standard behavior:
+ * ```typescript
+ * const doc = ValidationRulesCodec.decode(dataset);
+ * ```
+ */
+import { z } from 'zod';
+import { MasterDatasetSchema, } from '../../validation-schemas/master-dataset.js';
+import { heading, paragraph, separator, table, code, mermaid, linkOut, document, } from '../schema.js';
+import { DEFAULT_BASE_OPTIONS, mergeOptions } from './types/base.js';
+import { RenderableDocumentOutputSchema } from './shared-schema.js';
+import { VALID_TRANSITIONS } from '../../validation/fsm/transitions.js';
+import { PROTECTION_LEVELS, } from '../../validation/fsm/states.js';
+/**
+ * Default options for ValidationRulesCodec
+ */
+export const DEFAULT_VALIDATION_RULES_OPTIONS = {
+    ...DEFAULT_BASE_OPTIONS,
+    includeFSMDiagram: true,
+    includeCLIUsage: true,
+    includeEscapeHatches: true,
+    includeProtectionMatrix: true,
+    includeErrorGuide: true,
+};
+/**
+ * Process Guard rule definitions for documentation
+ *
+ * Centralized definitions ensure consistency between code and docs.
+ * These match the implementations in src/lint/process-guard/decider.ts
+ */
+export const RULE_DEFINITIONS = [
+    {
+        id: 'completed-protection',
+        severity: 'error',
+        description: 'Completed specs require unlock-reason tag to modify',
+        cause: 'File has `completed` status but no `@architect-unlock-reason` tag',
+        fix: "Add `@architect-unlock-reason:'your reason'` to proceed",
+    },
+    {
+        id: 'invalid-status-transition',
+        severity: 'error',
+        description: 'Status transitions must follow FSM path',
+        cause: 'Attempted transition not in VALID_TRANSITIONS matrix',
+        fix: 'Follow path: roadmap -> active -> completed',
+    },
+    {
+        id: 'scope-creep',
+        severity: 'error',
+        description: 'Active specs cannot add new deliverables',
+        cause: 'Added deliverable to spec with `active` status',
+        fix: 'Create new spec OR revert to `roadmap` status first',
+    },
+    {
+        id: 'session-scope',
+        severity: 'warning',
+        description: 'File outside session scope',
+        cause: "Modified file not in session's scopedSpecs list",
+        fix: 'Add to session scope OR use `--ignore-session` flag',
+    },
+    {
+        id: 'session-excluded',
+        severity: 'error',
+        description: 'File explicitly excluded from session',
+        cause: "File in session's excludedSpecs list",
+        fix: 'Remove from exclusion OR use different session',
+    },
+    {
+        id: 'deliverable-removed',
+        severity: 'warning',
+        description: 'Deliverable was removed from spec',
+        cause: 'Deliverable removed from Background table',
+        fix: 'Document reason for removal (completed or descoped)',
+    },
+];
+/**
+ * Compose rationale from convention-extracted content into rule definitions.
+ *
+ * Convention bundles extracted from `@architect-convention process-guard-errors`
+ * annotations contain per-rule sections with **Invariant:** and **Rationale:**
+ * markers plus situation/solution tables.
+ *
+ * @param rules - Static RULE_DEFINITIONS array
+ * @param conventionContent - Map of rule ID to extracted content
+ * @returns Enhanced rules with rationale and alternatives populated
+ */
+export function composeRationaleIntoRules(rules, conventionContent) {
+    return rules.map((rule) => {
+        const content = conventionContent.get(rule.id);
+        if (content) {
+            const enriched = {
+                ...rule,
+                rationale: content.rationale,
+            };
+            if (content.alternatives.length > 0) {
+                enriched.alternatives = content.alternatives;
+            }
+            return enriched;
+        }
+        return { ...rule, rationale: rule.description };
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// ValidationRules Document Codec
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Create a ValidationRulesCodec with custom options.
+ *
+ * @param options - Codec configuration options
+ * @returns Configured Zod codec
+ *
+ * @example
+ * ```typescript
+ * // Disable detail files for summary output
+ * const codec = createValidationRulesCodec({ generateDetailFiles: false });
+ *
+ * // Disable FSM diagram section
+ * const codec = createValidationRulesCodec({ includeFSMDiagram: false });
+ * ```
+ */
+export function createValidationRulesCodec(options) {
+    const opts = mergeOptions(DEFAULT_VALIDATION_RULES_OPTIONS, options);
+    return z.codec(MasterDatasetSchema, RenderableDocumentOutputSchema, {
+        // TODO: The _dataset parameter is unused because this codec builds from constants.
+        // Kept for interface consistency with other codecs that do use dataset.
+        // Future enhancement: derive validation rules from dataset if rules become dynamic.
+        decode: (_dataset) => {
+            return buildValidationRulesDocument(opts);
+        },
+        /** @throws Always - this codec is decode-only. See zod-codecs.md */
+        encode: () => {
+            throw new Error('ValidationRulesCodec is decode-only. See zod-codecs.md');
+        },
+    });
+}
+/**
+ * Default ValidationRules Document Codec
+ *
+ * Transforms MasterDataset -> RenderableDocument for validation rules reference.
+ * Uses default options with all features enabled.
+ *
+ * @example
+ * ```typescript
+ * const doc = ValidationRulesCodec.decode(masterDataset);
+ * const markdown = renderToMarkdown(doc);
+ * ```
+ */
+export const ValidationRulesCodec = createValidationRulesCodec();
+// ═══════════════════════════════════════════════════════════════════════════
+// Document Builder
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Build the validation rules document
+ */
+function buildValidationRulesDocument(options) {
+    const sections = [];
+    // 1. Overview section (always included)
+    sections.push(...buildOverviewSection());
+    // 2. Validation rules table (always included)
+    sections.push(...buildRulesTableSection(options));
+    // 3. FSM diagram (if enabled)
+    if (options.includeFSMDiagram) {
+        sections.push(...buildFSMDiagramSection(options));
+    }
+    // 4. Protection matrix (if enabled)
+    if (options.includeProtectionMatrix) {
+        sections.push(...buildProtectionMatrixSection(options));
+    }
+    // 5. CLI usage (if enabled)
+    if (options.includeCLIUsage) {
+        sections.push(...buildCLISection());
+    }
+    // 6. Escape hatches (if enabled)
+    if (options.includeEscapeHatches) {
+        sections.push(...buildEscapeHatchesSection());
+    }
+    // Build additional files for progressive disclosure (if enabled)
+    const additionalFiles = options.generateDetailFiles ? buildDetailFiles(options) : {};
+    const docOpts = {
+        purpose: 'Process Guard validation rules and FSM reference',
+        detailLevel: options.generateDetailFiles ? 'Overview with links to details' : 'Compact summary',
+    };
+    if (Object.keys(additionalFiles).length > 0) {
+        docOpts.additionalFiles = additionalFiles;
+    }
+    return document('Validation Rules', sections, docOpts);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Section Builders
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Build overview section explaining Process Guard
+ */
+function buildOverviewSection() {
+    const ruleCount = RULE_DEFINITIONS.length;
+    const stateCount = Object.keys(VALID_TRANSITIONS).length;
+    const protectionLevelCount = new Set(Object.values(PROTECTION_LEVELS)).size;
+    return [
+        heading(2, 'Overview'),
+        paragraph('Process Guard validates delivery workflow changes at commit time using a ' +
+            'Decider pattern. It enforces the 4-state FSM defined in PDR-005 and ' +
+            'prevents common workflow violations.'),
+        paragraph(`**${ruleCount} validation rules** | **${stateCount} FSM states** | **${protectionLevelCount} protection levels**`),
+        separator(),
+    ];
+}
+/**
+ * Build validation rules table section
+ */
+function buildRulesTableSection(options) {
+    const rows = RULE_DEFINITIONS.map((rule) => [`\`${rule.id}\``, rule.severity, rule.description]);
+    const sections = [
+        heading(2, 'Validation Rules'),
+        paragraph('Rules are checked in order. Errors block commit; warnings are informational.'),
+        table(['Rule ID', 'Severity', 'Description'], rows),
+    ];
+    if (options.generateDetailFiles) {
+        sections.push(linkOut('Full error catalog with fix instructions', 'validation/error-catalog.md'));
+    }
+    sections.push(separator());
+    return sections;
+}
+/**
+ * Build FSM state diagram section from VALID_TRANSITIONS
+ */
+function buildFSMDiagramSection(options) {
+    // Generate Mermaid diagram from VALID_TRANSITIONS constant
+    const lines = ['stateDiagram-v2'];
+    lines.push('    [*] --> roadmap: new pattern');
+    // Add transitions from the constant
+    for (const [from, targets] of Object.entries(VALID_TRANSITIONS)) {
+        for (const to of targets) {
+            if (from !== to) {
+                // Skip self-transitions in diagram for clarity
+                // Add labels for notable transitions
+                if (from === 'active' && to === 'roadmap') {
+                    lines.push(`    ${from} --> ${to}: blocked/regressed`);
+                }
+                else {
+                    lines.push(`    ${from} --> ${to}`);
+                }
+            }
+        }
+    }
+    lines.push('    completed --> [*]: terminal');
+    const sections = [
+        heading(2, 'FSM State Diagram'),
+        paragraph('Valid transitions per PDR-005 MVP Workflow:'),
+        mermaid(lines.join('\n')),
+        paragraph('**Valid Transitions:**\n' +
+            '- `roadmap` -> `active` -> `completed` (normal flow)\n' +
+            '- `active` -> `roadmap` (blocked/regressed)\n' +
+            '- `roadmap` <-> `deferred` (parking)'),
+    ];
+    if (options.generateDetailFiles) {
+        sections.push(linkOut('Detailed transition matrix', 'validation/fsm-transitions.md'));
+    }
+    sections.push(separator());
+    return sections;
+}
+/**
+ * Build protection levels matrix section
+ */
+function buildProtectionMatrixSection(options) {
+    const rows = Object.entries(PROTECTION_LEVELS).map(([status, level]) => {
+        const canAdd = level === 'none' ? 'Yes' : 'No';
+        const needsUnlock = level === 'hard' ? 'Yes' : 'No';
+        return [`\`${status}\``, level, canAdd, needsUnlock];
+    });
+    const sections = [
+        heading(2, 'Protection Levels'),
+        paragraph('Protection levels determine what modifications are allowed per status.'),
+        table(['Status', 'Protection', 'Can Add Deliverables', 'Needs Unlock'], rows),
+    ];
+    if (options.generateDetailFiles) {
+        sections.push(linkOut('Protection level details', 'validation/protection-levels.md'));
+    }
+    sections.push(separator());
+    return sections;
+}
+/**
+ * Build CLI usage section
+ */
+function buildCLISection() {
+    const cliCode = `# Pre-commit (default mode)
+lint-process --staged
+
+# CI pipeline with strict mode
+lint-process --all --strict
+
+# Override session scope checking
+lint-process --staged --ignore-session
+
+# Debug: show derived process state
+lint-process --staged --show-state`;
+    return [
+        heading(2, 'CLI Usage'),
+        code(cliCode, 'bash'),
+        heading(3, 'Options'),
+        table(['Flag', 'Description'], [
+            ['`--staged`', 'Validate staged files only (pre-commit)'],
+            ['`--all`', 'Validate all tracked files (CI)'],
+            ['`--strict`', 'Treat warnings as errors (exit 1)'],
+            ['`--ignore-session`', 'Skip session scope validation'],
+            ['`--show-state`', 'Debug: show derived process state'],
+            ['`--format json`', 'Machine-readable JSON output'],
+        ]),
+        heading(3, 'Exit Codes'),
+        table(['Code', 'Meaning'], [
+            ['`0`', 'No errors (warnings allowed unless `--strict`)'],
+            ['`1`', 'Errors found or warnings with `--strict`'],
+        ]),
+        separator(),
+    ];
+}
+/**
+ * Build escape hatches section
+ */
+function buildEscapeHatchesSection() {
+    return [
+        heading(2, 'Escape Hatches'),
+        paragraph('Override mechanisms for exceptional situations.'),
+        table(['Situation', 'Solution', 'Example'], [
+            [
+                'Fix bug in completed spec',
+                'Add unlock reason tag',
+                "`@architect-unlock-reason:'Fix-typo'`",
+            ],
+            [
+                'Modify outside session scope',
+                'Use ignore flag',
+                '`lint-process --staged --ignore-session`',
+            ],
+            ['CI treats warnings as errors', 'Use strict flag', '`lint-process --all --strict`'],
+        ]),
+        separator(),
+    ];
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Additional Detail Files (Progressive Disclosure)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Build additional validation detail files
+ */
+function buildDetailFiles(options) {
+    const files = {};
+    // validation/fsm-transitions.md - Full transition matrix with descriptions
+    files['validation/fsm-transitions.md'] = buildFSMTransitionsDetailDocument();
+    // validation/error-catalog.md - Full error messages with causes/fixes
+    files['validation/error-catalog.md'] = buildErrorCatalogDetailDocument(RULE_DEFINITIONS, options);
+    // validation/protection-levels.md - Detailed protection explanations
+    files['validation/protection-levels.md'] = buildProtectionLevelsDetailDocument();
+    return files;
+}
+/**
+ * Get a description for a specific transition
+ */
+function getTransitionDescription(from, to) {
+    const descriptions = {
+        'roadmap-active': 'Start implementation work',
+        'roadmap-deferred': 'Park work for later',
+        'roadmap-roadmap': 'Stay in planning (self-transition)',
+        'active-completed': 'Finish implementation',
+        'active-roadmap': 'Regress due to blocker or scope change',
+        'deferred-roadmap': 'Reactivate deferred work',
+    };
+    return descriptions[`${from}-${to}`] ?? 'Standard transition';
+}
+/**
+ * Build FSM transitions detail document
+ */
+function buildFSMTransitionsDetailDocument() {
+    const sections = [];
+    sections.push(heading(2, 'FSM Transition Matrix'), paragraph('Complete transition matrix showing all valid state changes per PDR-005.'));
+    // Full table with all transitions
+    const allRows = [];
+    for (const [from, targets] of Object.entries(VALID_TRANSITIONS)) {
+        if (targets.length === 0) {
+            allRows.push([`\`${from}\``, '(none)', 'Terminal state - no valid transitions']);
+        }
+        else {
+            for (const to of targets) {
+                allRows.push([`\`${from}\``, `\`${to}\``, getTransitionDescription(from, to)]);
+            }
+        }
+    }
+    sections.push(table(['From', 'To', 'Description'], allRows));
+    // Per-state breakdown
+    sections.push(heading(2, 'Transitions by State'));
+    for (const [from, targets] of Object.entries(VALID_TRANSITIONS)) {
+        sections.push(heading(3, `From \`${from}\``));
+        if (targets.length === 0) {
+            sections.push(paragraph(`**Terminal state** - no valid transitions. Use \`@architect-unlock-reason\` to modify.`));
+        }
+        else {
+            const rows = targets.map((to) => [
+                `\`${to}\``,
+                getTransitionDescription(from, to),
+            ]);
+            sections.push(table(['Target', 'Description'], rows));
+        }
+    }
+    // Back link
+    sections.push(separator(), linkOut('Back to Validation Rules', '../VALIDATION-RULES.md'));
+    return document('FSM Transitions', sections, {
+        purpose: 'Complete state transition reference for Process Guard FSM',
+    });
+}
+/**
+ * Build error catalog detail document
+ */
+function buildErrorCatalogDetailDocument(rules, options) {
+    const sections = [];
+    sections.push(heading(2, 'Error Catalog'), paragraph(`Complete error messages and fix instructions for all ${rules.length} validation rules.`));
+    // Summary table
+    const summaryRows = rules.map((rule) => [`\`${rule.id}\``, rule.severity, rule.description]);
+    sections.push(table(['Rule ID', 'Severity', 'Description'], summaryRows));
+    // Detailed breakdown per rule
+    sections.push(heading(2, 'Rule Details'));
+    for (const rule of rules) {
+        sections.push(heading(3, `\`${rule.id}\``), table(['Property', 'Value'], [
+            ['Severity', rule.severity],
+            ['Description', rule.description],
+            ['Cause', rule.cause],
+            ['Fix', rule.fix],
+        ]));
+        // Error guide content (if enabled and rationale exists)
+        if (options.includeErrorGuide && rule.rationale) {
+            sections.push(heading(4, 'Why This Rule Exists'), paragraph(rule.rationale));
+            if (rule.alternatives && rule.alternatives.length > 0) {
+                sections.push(heading(4, 'Alternative Approaches'), ...rule.alternatives.map((alt) => paragraph(`- ${alt}`)));
+            }
+        }
+    }
+    // Back link
+    sections.push(separator(), linkOut('Back to Validation Rules', '../VALIDATION-RULES.md'));
+    return document('Error Catalog', sections, {
+        purpose: 'Complete error message reference with fix instructions',
+    });
+}
+/**
+ * Build protection levels detail document
+ */
+function buildProtectionLevelsDetailDocument() {
+    const sections = [];
+    sections.push(heading(2, 'Protection Levels'), paragraph('Detailed explanation of protection levels per PDR-005 MVP Workflow.'));
+    // Derive statuses per protection level from PROTECTION_LEVELS (single source of truth)
+    const statusesByLevel = new Map();
+    for (const [status, level] of Object.entries(PROTECTION_LEVELS)) {
+        const existing = statusesByLevel.get(level) ?? [];
+        existing.push(status);
+        statusesByLevel.set(level, existing);
+    }
+    // Protection level descriptions (meaning, allowed, blocked are static documentation)
+    const protectionDescriptions = {
+        none: {
+            meaning: 'Fully editable, no restrictions',
+            allowed: 'All modifications including adding new deliverables',
+            blocked: 'Nothing',
+        },
+        scope: {
+            meaning: 'Scope-locked, prevents adding new deliverables',
+            allowed: 'Edit existing deliverables, change status',
+            blocked: 'Adding new deliverables (scope creep)',
+        },
+        hard: {
+            meaning: 'Hard-locked, requires explicit unlock to modify',
+            allowed: 'Nothing (without unlock-reason tag)',
+            blocked: 'All modifications',
+        },
+    };
+    // Combine derived statuses with static descriptions
+    const protectionDetails = ['none', 'scope', 'hard'].map((level) => ({
+        level,
+        statuses: statusesByLevel.get(level) ?? [],
+        ...protectionDescriptions[level],
+    }));
+    // Summary table
+    const summaryRows = protectionDetails.map((detail) => [
+        `\`${detail.level}\``,
+        detail.statuses.map((s) => `\`${s}\``).join(', '),
+        detail.meaning,
+    ]);
+    sections.push(table(['Level', 'Applies To', 'Meaning'], summaryRows));
+    // Detailed breakdown
+    sections.push(heading(2, 'Level Details'));
+    for (const detail of protectionDetails) {
+        sections.push(heading(3, `\`${detail.level}\` Protection`), paragraph(`**Applies to:** ${detail.statuses.map((s) => `\`${s}\``).join(', ')}`), table(['Aspect', 'Description'], [
+            ['Meaning', detail.meaning],
+            ['Allowed', detail.allowed],
+            ['Blocked', detail.blocked],
+        ]));
+    }
+    // Back link
+    sections.push(separator(), linkOut('Back to Validation Rules', '../VALIDATION-RULES.md'));
+    return document('Protection Levels', sections, {
+        purpose: 'Detailed protection level reference per PDR-005',
+    });
+}
+//# sourceMappingURL=validation-rules.js.map

package/dist/renderable/codecs/validation-rules.js.map

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