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

package/dist/api/context-formatter.js

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

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

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

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

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

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

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

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

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

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

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