@libar-dev/architect 1.0.0-pre.3

package/dist/api/context-formatter.js

@@ -0,0 +1,183 @@
+/**
+ * @architect
+ * @architect-pattern ContextFormatterImpl
+ * @architect-status active
+ * @architect-implements DataAPIContextAssembly
+ * @architect-uses ContextAssemblerImpl
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## ContextFormatter — Plain Text Renderer for Context Bundles
+ *
+ * First plain-text formatter in the codebase. All other rendering goes
+ * through the Codec/RenderableDocument/UniversalRenderer markdown pipeline.
+ * Context bundles are rendered as compact structured text with === section
+ * markers for easy AI parsing (see ADR-008).
+ *
+ * **When to Use:** When rendering a ContextBundle as plain text for CLI output — use this instead of the markdown codec pipeline.
+ */
+import { isDeliverableStatusComplete } from '../taxonomy/deliverable-status.js';
+// ---------------------------------------------------------------------------
+// Bundle Formatter
+// ---------------------------------------------------------------------------
+export function formatContextBundle(bundle) {
+    const sections = [];
+    // Metadata (always present)
+    for (const meta of bundle.metadata) {
+        const parts = [];
+        if (meta.status !== undefined)
+            parts.push(`Status: ${meta.status}`);
+        if (meta.phase !== undefined)
+            parts.push(`Phase: ${String(meta.phase)}`);
+        parts.push(`Category: ${meta.category}`);
+        sections.push(`=== PATTERN: ${meta.name} ===\n` +
+            `${parts.join(' | ')}\n` +
+            (meta.summary !== '' ? `${meta.summary}\n` : '') +
+            `File: ${meta.file}`);
+    }
+    // Spec files
+    if (bundle.specFiles.length > 0) {
+        sections.push('=== SPEC ===\n' + bundle.specFiles.join('\n'));
+    }
+    // Stubs
+    if (bundle.stubs.length > 0) {
+        const lines = bundle.stubs.map((s) => s.targetPath !== '' ? `${s.stubFile} -> ${s.targetPath}` : s.stubFile);
+        sections.push('=== STUBS ===\n' + lines.join('\n'));
+    }
+    // Dependencies
+    if (bundle.dependencies.length > 0) {
+        const lines = bundle.dependencies.map((d) => {
+            const status = d.status !== undefined ? `[${d.status}]` : '[unknown]';
+            const filePart = d.file !== '' ? ` ${d.file}` : '';
+            return `${status} ${d.name} (${d.kind})${filePart}`;
+        });
+        let header = '=== DEPENDENCIES ===';
+        if (bundle.sharedDependencies.length > 0) {
+            header += `\nShared: ${bundle.sharedDependencies.join(', ')}`;
+        }
+        sections.push(header + '\n' + lines.join('\n'));
+    }
+    // Consumers
+    if (bundle.consumers.length > 0) {
+        const lines = bundle.consumers.map((c) => {
+            const status = c.status ?? 'unknown';
+            return `${c.name} (${status})`;
+        });
+        sections.push('=== CONSUMERS ===\n' + lines.join('\n'));
+    }
+    // Architecture neighbors
+    if (bundle.architectureNeighbors.length > 0) {
+        const ctx = bundle.architectureNeighbors[0]?.archContext ?? 'unknown';
+        const lines = bundle.architectureNeighbors.map((n) => {
+            const status = n.status ?? 'unknown';
+            const role = n.archRole !== undefined ? `, ${n.archRole}` : '';
+            return `${n.name} (${status}${role})`;
+        });
+        sections.push(`=== ARCHITECTURE (context: ${ctx}) ===\n` + lines.join('\n'));
+    }
+    // Deliverables
+    if (bundle.deliverables.length > 0) {
+        const lines = bundle.deliverables.map((d) => {
+            const checkbox = isDeliverableStatusComplete(d.status) ? '[x]' : '[ ]';
+            return `${checkbox} ${d.name} (${d.location})`;
+        });
+        sections.push('=== DELIVERABLES ===\n' + lines.join('\n'));
+    }
+    // FSM
+    if (bundle.fsm !== undefined) {
+        const transitions = bundle.fsm.validTransitions.length > 0 ? bundle.fsm.validTransitions.join(', ') : 'none';
+        sections.push('=== FSM ===\n' +
+            `Status: ${bundle.fsm.currentStatus} | Transitions: ${transitions} | Protection: ${bundle.fsm.protectionLevel}`);
+    }
+    // Test files
+    if (bundle.testFiles.length > 0) {
+        sections.push('=== TEST FILES ===\n' + bundle.testFiles.join('\n'));
+    }
+    return sections.join('\n\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Dep-Tree Formatter
+// ---------------------------------------------------------------------------
+export function formatDepTree(tree) {
+    const lines = [];
+    renderTreeNode(tree, 0, lines);
+    return lines.join('\n') + '\n';
+}
+function renderTreeNode(node, depth, lines) {
+    const indent = depth > 0 ? '  '.repeat(depth) + '-> ' : '';
+    const phase = node.phase !== undefined ? `${String(node.phase)}, ` : '';
+    const status = node.status ?? 'unknown';
+    const focal = node.isFocal ? ' <- YOU ARE HERE' : '';
+    lines.push(`${indent}${node.name} (${phase}${status})${focal}`);
+    if (node.truncated) {
+        const truncIndent = '  '.repeat(depth + 1) + '-> ';
+        lines.push(`${truncIndent}... (depth limit reached)`);
+        return;
+    }
+    for (const child of node.children) {
+        renderTreeNode(child, depth + 1, lines);
+    }
+}
+// ---------------------------------------------------------------------------
+// File Reading List Formatter
+// ---------------------------------------------------------------------------
+export function formatFileReadingList(list) {
+    const sections = [];
+    if (list.primary.length > 0) {
+        sections.push('=== PRIMARY ===\n' + list.primary.join('\n'));
+    }
+    if (list.completedDeps.length > 0) {
+        sections.push('=== COMPLETED DEPENDENCIES ===\n' + list.completedDeps.join('\n'));
+    }
+    if (list.roadmapDeps.length > 0) {
+        sections.push('=== ROADMAP DEPENDENCIES ===\n' + list.roadmapDeps.join('\n'));
+    }
+    if (list.architectureNeighbors.length > 0) {
+        sections.push('=== ARCHITECTURE NEIGHBORS ===\n' + list.architectureNeighbors.join('\n'));
+    }
+    return sections.join('\n\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Overview Formatter
+// ---------------------------------------------------------------------------
+export function formatOverview(overview) {
+    const sections = [];
+    const { progress } = overview;
+    sections.push('=== PROGRESS ===\n' +
+        `${String(progress.total)} patterns (${String(progress.completed)} completed, ${String(progress.active)} active, ${String(progress.planned)} planned) = ${String(progress.percentage)}%`);
+    if (overview.activePhases.length > 0) {
+        const lines = overview.activePhases.map((p) => {
+            const name = p.name !== undefined ? `: ${p.name}` : '';
+            return `Phase ${String(p.phase)}${name} (${String(p.activeCount)} active)`;
+        });
+        sections.push('=== ACTIVE PHASES ===\n' + lines.join('\n'));
+    }
+    if (overview.blocking.length > 0) {
+        const lines = overview.blocking.map((b) => {
+            const blockers = b.blockedBy.join(', ');
+            return `${b.pattern} blocked by: ${blockers}`;
+        });
+        sections.push('=== BLOCKING ===\n' + lines.join('\n'));
+    }
+    sections.push('=== DATA API — Use Instead of Explore Agents ===\n' +
+        'pnpm architect:query -- <subcommand>\n' +
+        '\n' +
+        '  overview                             Project health (this output)\n' +
+        '  context <pattern> --session <type>   Curated context bundle (planning/design/implement)\n' +
+        '  scope-validate <pattern> <session>   Pre-flight check before starting work\n' +
+        '  dep-tree <pattern>                   Dependency chains\n' +
+        '  list --status roadmap                Available patterns to work on\n' +
+        '  stubs --unresolved                   Design stubs missing implementations\n' +
+        '  files <pattern>                      File paths for a pattern\n' +
+        '  rules                                Business rules from Gherkin\n' +
+        '  arch blocking                        Patterns stuck on incomplete deps\n' +
+        '\n' +
+        'Full reference: pnpm architect:query -- --help');
+    return sections.join('\n\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+//# sourceMappingURL=context-formatter.js.map

package/dist/api/context-formatter.js.map

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

package/dist/api/coverage-analyzer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @architect
+ * @architect-pattern CoverageAnalyzerImpl
+ * @architect-status active
+ * @architect-implements DataAPIArchitectureQueries
+ * @architect-uses Pattern Scanner, MasterDataset
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## CoverageAnalyzer — Annotation Coverage and Taxonomy Gap Detection
+ *
+ * Reports annotation completeness by comparing scannable files (from glob)
+ * against annotated patterns in MasterDataset. Uses independent glob via
+ * findFilesToScan() — cheap (~1ms) and avoids changing buildPipeline().
+ *
+ * **When to Use:** When checking annotation completeness or finding unannotated files via `arch coverage` or `unannotated` CLI subcommands.
+ */
+import type { MasterDataset } from '../validation-schemas/master-dataset.js';
+import type { TagRegistry } from '../validation-schemas/tag-registry.js';
+export interface UnusedTaxonomyReport {
+    readonly unusedCategories: readonly string[];
+    readonly unusedRoles: readonly string[];
+    readonly unusedLayers: readonly string[];
+    readonly unusedStatuses: readonly string[];
+}
+export interface CoverageReport {
+    readonly annotatedFileCount: number;
+    readonly totalScannableFiles: number;
+    readonly coveragePercentage: number;
+    readonly unannotatedFiles: readonly string[];
+    readonly unusedTaxonomy: UnusedTaxonomyReport;
+}
+export declare function findUnusedTaxonomy(dataset: MasterDataset, registry: TagRegistry): UnusedTaxonomyReport;
+export declare function findUnannotatedFiles(inputGlobs: readonly string[], baseDir: string, registry: TagRegistry, pathFilter?: string): Promise<readonly string[]>;
+export declare function analyzeCoverage(dataset: MasterDataset, inputGlobs: readonly string[], baseDir: string, registry: TagRegistry): Promise<CoverageReport>;
+//# sourceMappingURL=coverage-analyzer.d.ts.map

package/dist/api/coverage-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-analyzer.d.ts","sourceRoot":"","sources":["../../src/api/coverage-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAMzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;CAC/C;AAMD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,WAAW,GACpB,oBAAoB,CAsCtB;AAMD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAgB5B;AAMD,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,CAoCzB"}

package/dist/api/coverage-analyzer.js

@@ -0,0 +1,117 @@
+/**
+ * @architect
+ * @architect-pattern CoverageAnalyzerImpl
+ * @architect-status active
+ * @architect-implements DataAPIArchitectureQueries
+ * @architect-uses Pattern Scanner, MasterDataset
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## CoverageAnalyzer — Annotation Coverage and Taxonomy Gap Detection
+ *
+ * Reports annotation completeness by comparing scannable files (from glob)
+ * against annotated patterns in MasterDataset. Uses independent glob via
+ * findFilesToScan() — cheap (~1ms) and avoids changing buildPipeline().
+ *
+ * **When to Use:** When checking annotation completeness or finding unannotated files via `arch coverage` or `unannotated` CLI subcommands.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { findFilesToScan, hasFileOptIn } from '../scanner/pattern-scanner.js';
+// ---------------------------------------------------------------------------
+// findUnusedTaxonomy
+// ---------------------------------------------------------------------------
+export function findUnusedTaxonomy(dataset, registry) {
+    // Collect used values from patterns
+    const usedCategories = new Set();
+    const usedRoles = new Set();
+    const usedLayers = new Set();
+    const usedStatuses = new Set();
+    for (const p of dataset.patterns) {
+        usedCategories.add(String(p.category));
+        if (p.archRole !== undefined)
+            usedRoles.add(p.archRole);
+        if (p.archLayer !== undefined)
+            usedLayers.add(p.archLayer);
+        if (p.status !== undefined)
+            usedStatuses.add(p.status);
+    }
+    // Get defined values from registry
+    const definedCategories = registry.categories.map((c) => c.tag);
+    // Find arch-role and arch-layer enum values from metadataTags
+    let definedRoles = [];
+    let definedLayers = [];
+    let definedStatuses = [];
+    for (const tag of registry.metadataTags) {
+        if (tag.tag === 'arch-role' && tag.values !== undefined) {
+            definedRoles = tag.values;
+        }
+        else if (tag.tag === 'arch-layer' && tag.values !== undefined) {
+            definedLayers = tag.values;
+        }
+        else if (tag.tag === 'status' && tag.values !== undefined) {
+            definedStatuses = tag.values;
+        }
+    }
+    return {
+        unusedCategories: definedCategories.filter((c) => !usedCategories.has(c)),
+        unusedRoles: definedRoles.filter((r) => !usedRoles.has(r)),
+        unusedLayers: definedLayers.filter((l) => !usedLayers.has(l)),
+        unusedStatuses: definedStatuses.filter((s) => !usedStatuses.has(s)),
+    };
+}
+// ---------------------------------------------------------------------------
+// findUnannotatedFiles
+// ---------------------------------------------------------------------------
+export async function findUnannotatedFiles(inputGlobs, baseDir, registry, pathFilter) {
+    const patterns = pathFilter !== undefined ? [pathFilter] : [...inputGlobs];
+    const allFiles = await findFilesToScan({ patterns, baseDir });
+    const resolvedBaseDir = path.resolve(baseDir);
+    const unannotated = [];
+    for (const filePath of allFiles) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        if (!hasFileOptIn(content, registry)) {
+            // Return relative paths
+            const relative = path.relative(resolvedBaseDir, filePath);
+            unannotated.push(relative);
+        }
+    }
+    return unannotated.sort();
+}
+// ---------------------------------------------------------------------------
+// analyzeCoverage
+// ---------------------------------------------------------------------------
+export async function analyzeCoverage(dataset, inputGlobs, baseDir, registry) {
+    const allFiles = await findFilesToScan({ patterns: [...inputGlobs], baseDir });
+    const resolvedBaseDir = path.resolve(baseDir);
+    // Collect annotated file paths (normalized to absolute)
+    const annotatedFiles = new Set();
+    for (const p of dataset.patterns) {
+        const filePath = p.source.file;
+        // Normalize: resolve relative paths against baseDir
+        const absolute = path.isAbsolute(filePath) ? filePath : path.resolve(resolvedBaseDir, filePath);
+        annotatedFiles.add(absolute);
+    }
+    // Find unannotated files
+    const unannotatedFiles = [];
+    for (const filePath of allFiles) {
+        if (!annotatedFiles.has(filePath)) {
+            unannotatedFiles.push(path.relative(resolvedBaseDir, filePath));
+        }
+    }
+    unannotatedFiles.sort();
+    const totalScannableFiles = allFiles.length;
+    const annotatedFileCount = totalScannableFiles - unannotatedFiles.length;
+    const coveragePercentage = totalScannableFiles > 0 ? Math.round((annotatedFileCount / totalScannableFiles) * 100) : 0;
+    const unusedTaxonomy = findUnusedTaxonomy(dataset, registry);
+    return {
+        annotatedFileCount,
+        totalScannableFiles,
+        coveragePercentage,
+        unannotatedFiles,
+        unusedTaxonomy,
+    };
+}
+//# sourceMappingURL=coverage-analyzer.js.map

package/dist/api/coverage-analyzer.js.map

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

package/dist/api/fuzzy-match.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern FuzzyMatcherImpl
+ * @architect-status active
+ * @architect-implements DataAPIOutputShaping
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## FuzzyMatcher — Pattern Name Fuzzy Search
+ *
+ * Provides fuzzy matching for pattern names with tiered scoring:
+ * exact (1.0) > prefix (0.9) > substring (0.7) > Levenshtein (distance-based).
+ *
+ * No external dependencies — Levenshtein implementation is ~20 lines.
+ *
+ * Used by:
+ * - `search` subcommand: ranked results via fuzzyMatchPatterns()
+ * - `pattern` subcommand: "Did you mean...?" fallback via findBestMatch()
+ *
+ * **When to Use:** When resolving user-typed pattern names that may contain typos or partial matches.
+ */
+/**
+ * Result of a fuzzy match against a pattern name.
+ */
+export interface FuzzyMatch {
+    /** The matched pattern name */
+    readonly patternName: string;
+    /** Match quality score (0-1, higher is better) */
+    readonly score: number;
+    /** How the match was achieved */
+    readonly matchType: 'exact' | 'prefix' | 'substring' | 'fuzzy';
+}
+/**
+ * Compute Levenshtein edit distance between two strings.
+ *
+ * Pure implementation with no external dependencies.
+ * Uses dynamic programming O(m*n) approach.
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns Edit distance (0 = identical)
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+/**
+ * Find patterns matching a query with fuzzy matching.
+ *
+ * Scoring tiers (all case-insensitive):
+ * 1. Exact match: score = 1.0
+ * 2. Prefix match: score = 0.9 + (queryLen/nameLen) * 0.09 (shorter names rank higher)
+ * 3. Substring match: score = 0.7
+ * 4. Levenshtein distance <= 3: score = 1 - (distance / max(len1, len2))
+ *
+ * Results are sorted by score descending, with shorter names as tie-breaker.
+ *
+ * @param query - Search query string
+ * @param patternNames - All available pattern names to search
+ * @param maxResults - Maximum number of results to return (default: 10)
+ * @returns Sorted array of FuzzyMatch results
+ */
+export declare function fuzzyMatchPatterns(query: string, patternNames: readonly string[], maxResults?: number): readonly FuzzyMatch[];
+/**
+ * Find the single best match for a query.
+ *
+ * Used for "Did you mean...?" suggestions when an exact pattern lookup fails.
+ * Returns undefined if no match scores above the minimum threshold (0.3).
+ *
+ * @param query - Pattern name that wasn't found
+ * @param patternNames - All available pattern names
+ * @returns Best matching FuzzyMatch, or undefined if no good match
+ */
+export declare function findBestMatch(query: string, patternNames: readonly string[]): FuzzyMatch | undefined;
+//# sourceMappingURL=fuzzy-match.d.ts.map

package/dist/api/fuzzy-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.d.ts","sourceRoot":"","sources":["../../src/api/fuzzy-match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;CAChE;AAYD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBhE;AA0CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,UAAU,SAAK,GACd,SAAS,UAAU,EAAE,CAuBvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,UAAU,GAAG,SAAS,CAGxB"}

package/dist/api/fuzzy-match.js

@@ -0,0 +1,150 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern FuzzyMatcherImpl
+ * @architect-status active
+ * @architect-implements DataAPIOutputShaping
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## FuzzyMatcher — Pattern Name Fuzzy Search
+ *
+ * Provides fuzzy matching for pattern names with tiered scoring:
+ * exact (1.0) > prefix (0.9) > substring (0.7) > Levenshtein (distance-based).
+ *
+ * No external dependencies — Levenshtein implementation is ~20 lines.
+ *
+ * Used by:
+ * - `search` subcommand: ranked results via fuzzyMatchPatterns()
+ * - `pattern` subcommand: "Did you mean...?" fallback via findBestMatch()
+ *
+ * **When to Use:** When resolving user-typed pattern names that may contain typos or partial matches.
+ */
+/** Minimum score threshold for inclusion in results */
+const MIN_SCORE_THRESHOLD = 0.3;
+/** Maximum Levenshtein distance to consider */
+const MAX_LEVENSHTEIN_DISTANCE = 3;
+// ---------------------------------------------------------------------------
+// Functions
+// ---------------------------------------------------------------------------
+/**
+ * Compute Levenshtein edit distance between two strings.
+ *
+ * Pure implementation with no external dependencies.
+ * Uses dynamic programming O(m*n) approach.
+ *
+ * @param a - First string
+ * @param b - Second string
+ * @returns Edit distance (0 = identical)
+ */
+export function levenshteinDistance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    // Two-row DP: previous row and current row
+    let prevRow = Array.from({ length: n + 1 }, (_, i) => i);
+    let currRow = new Array(n + 1);
+    for (let i = 1; i <= m; i++) {
+        currRow[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            const deletion = (prevRow[j] ?? 0) + 1;
+            const insertion = (currRow[j - 1] ?? 0) + 1;
+            const substitution = (prevRow[j - 1] ?? 0) + cost;
+            currRow[j] = Math.min(deletion, insertion, substitution);
+        }
+        // Swap rows
+        [prevRow, currRow] = [currRow, prevRow];
+    }
+    return prevRow[n] ?? 0;
+}
+/**
+ * Score a single pattern name against a query using tiered matching.
+ */
+function scoreMatch(query, patternName) {
+    const queryLower = query.toLowerCase();
+    const nameLower = patternName.toLowerCase();
+    // Tier 1: Exact match (case-insensitive)
+    if (queryLower === nameLower) {
+        return { score: 1.0, matchType: 'exact' };
+    }
+    // Tier 2: Prefix match — score increases with query coverage of the name
+    if (nameLower.startsWith(queryLower)) {
+        const coverage = queryLower.length / nameLower.length;
+        const score = 0.9 + coverage * 0.09;
+        return { score: Math.min(score, 0.99), matchType: 'prefix' };
+    }
+    // Tier 3: Substring match
+    if (nameLower.includes(queryLower)) {
+        return { score: 0.7, matchType: 'substring' };
+    }
+    // Tier 4: Levenshtein distance
+    const distance = levenshteinDistance(queryLower, nameLower);
+    if (distance <= MAX_LEVENSHTEIN_DISTANCE) {
+        const maxLen = Math.max(queryLower.length, nameLower.length);
+        const score = maxLen > 0 ? 1 - distance / maxLen : 0;
+        if (score >= MIN_SCORE_THRESHOLD) {
+            return { score, matchType: 'fuzzy' };
+        }
+    }
+    return undefined;
+}
+/**
+ * Find patterns matching a query with fuzzy matching.
+ *
+ * Scoring tiers (all case-insensitive):
+ * 1. Exact match: score = 1.0
+ * 2. Prefix match: score = 0.9 + (queryLen/nameLen) * 0.09 (shorter names rank higher)
+ * 3. Substring match: score = 0.7
+ * 4. Levenshtein distance <= 3: score = 1 - (distance / max(len1, len2))
+ *
+ * Results are sorted by score descending, with shorter names as tie-breaker.
+ *
+ * @param query - Search query string
+ * @param patternNames - All available pattern names to search
+ * @param maxResults - Maximum number of results to return (default: 10)
+ * @returns Sorted array of FuzzyMatch results
+ */
+export function fuzzyMatchPatterns(query, patternNames, maxResults = 10) {
+    const matches = [];
+    for (const patternName of patternNames) {
+        const result = scoreMatch(query, patternName);
+        if (result !== undefined) {
+            matches.push({
+                patternName,
+                score: result.score,
+                matchType: result.matchType,
+            });
+        }
+    }
+    matches.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        // Tie-breaker: shorter name = more specific match
+        if (a.patternName.length !== b.patternName.length)
+            return a.patternName.length - b.patternName.length;
+        // Final tie-breaker: lexical ordering for deterministic results
+        return a.patternName.localeCompare(b.patternName);
+    });
+    return matches.slice(0, maxResults);
+}
+/**
+ * Find the single best match for a query.
+ *
+ * Used for "Did you mean...?" suggestions when an exact pattern lookup fails.
+ * Returns undefined if no match scores above the minimum threshold (0.3).
+ *
+ * @param query - Pattern name that wasn't found
+ * @param patternNames - All available pattern names
+ * @returns Best matching FuzzyMatch, or undefined if no good match
+ */
+export function findBestMatch(query, patternNames) {
+    const results = fuzzyMatchPatterns(query, patternNames, 1);
+    return results.length > 0 ? results[0] : undefined;
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/dist/api/fuzzy-match.js.map

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

package/dist/api/handoff-generator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @architect
+ * @architect-pattern HandoffGeneratorImpl
+ * @architect-status completed
+ * @architect-implements DataAPIDesignSessionSupport
+ * @architect-uses ProcessStateAPI, MasterDataset, ContextFormatterImpl
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-target src/api/handoff-generator.ts
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## HandoffGenerator — Session-End State Summary
+ *
+ * Pure function that assembles a handoff document from ProcessStateAPI
+ * and MasterDataset. Captures everything the next session needs to
+ * continue work without context loss.
+ *
+ * **When to Use:** When ending a work session and capturing state for the next session via the `handoff` CLI subcommand.
+ */
+import type { SessionType } from './context-assembler.js';
+import type { ProcessStateAPI } from './process-state.js';
+import type { MasterDataset } from '../validation-schemas/master-dataset.js';
+/** Handoff supports 'review' in addition to standard session types (DD-3). */
+export type HandoffSessionType = SessionType | 'review';
+export interface HandoffOptions {
+    readonly patternName: string;
+    readonly sessionType?: HandoffSessionType;
+    readonly modifiedFiles?: readonly string[];
+}
+export interface HandoffSection {
+    readonly title: string;
+    readonly items: readonly string[];
+}
+export interface HandoffDocument {
+    readonly pattern: string;
+    readonly sessionType: HandoffSessionType;
+    readonly date: string;
+    readonly status: string | undefined;
+    readonly sections: readonly HandoffSection[];
+}
+export declare function generateHandoff(api: ProcessStateAPI, _dataset: MasterDataset, // _dataset reserved for future use per design stub
+options: HandoffOptions): HandoffDocument;
+export declare function formatHandoff(doc: HandoffDocument): string;
+//# sourceMappingURL=handoff-generator.d.ts.map

package/dist/api/handoff-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-generator.d.ts","sourceRoot":"","sources":["../../src/api/handoff-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAc7E,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AAsBD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,aAAa,EAAE,mDAAmD;AAC5E,OAAO,EAAE,cAAc,GACtB,eAAe,CA8FjB;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAa1D"}