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

package/dist/api/summarize.js

@@ -1,97 +0,0 @@
-/**
- * @architect
- * @architect-core
- * @architect-pattern PatternSummarizerImpl
- * @architect-status active
- * @architect-implements DataAPIOutputShaping
- * @architect-uses ProcessStateAPI
- * @architect-used-by OutputPipeline, ProcessAPICLIImpl
- * @architect-arch-role service
- * @architect-arch-context api
- * @architect-arch-layer application
- *
- * ## PatternSummarizer — Compact Pattern Projection
- *
- * Projects the full ExtractedPattern (~3.5KB per pattern) down to a
- * PatternSummary (~100 bytes) for list queries. Reduces CLI output
- * from ~594KB to ~4KB for typical codebases.
- *
- * Uses Zod schema-first pattern: PatternSummarySchema defines the type,
- * and PatternSummary is inferred from it.
- *
- * **When to Use:** When projecting full ExtractedPattern data down to compact summaries for list and overview queries.
- */
-import { z } from 'zod';
-import { getPatternName } from './pattern-helpers.js';
-// ---------------------------------------------------------------------------
-// Schema
-// ---------------------------------------------------------------------------
-/**
- * Compact projection of ExtractedPattern for list queries.
- *
- * Fields selected for maximum information density at minimum size:
- * - patternName: identifies the pattern
- * - status: FSM state (roadmap/active/completed/deferred)
- * - category: domain classification
- * - phase: roadmap phase number (for sequencing)
- * - file: source file path (for navigation)
- * - source: typescript or gherkin (for filtering)
- */
-export const PatternSummarySchema = z.object({
-    patternName: z.string(),
-    status: z.string().optional(),
-    category: z.string(),
-    phase: z.number().int().optional(),
-    file: z.string(),
-    source: z.enum(['typescript', 'gherkin']),
-});
-/**
- * Valid field names for PatternSummary, used by --fields validation.
- */
-export const SUMMARY_FIELDS = new Set([
-    'patternName',
-    'status',
-    'category',
-    'phase',
-    'file',
-    'source',
-]);
-// ---------------------------------------------------------------------------
-// Functions
-// ---------------------------------------------------------------------------
-/**
- * Derive source type from file extension.
- */
-export function deriveSource(filePath) {
-    return filePath.endsWith('.feature') ? 'gherkin' : 'typescript';
-}
-/**
- * Project an ExtractedPattern to a compact PatternSummary.
- *
- * - `patternName` prefers explicit @architect-pattern tag, falls back to `name`
- * - `source` is derived from file extension (.feature -> gherkin, else typescript)
- * - Optional fields (status, phase) are included when present, omitted when undefined
- *
- * @param pattern - Full ExtractedPattern from the pipeline
- * @returns Compact PatternSummary (~100 bytes JSON)
- */
-export function summarizePattern(pattern) {
-    return {
-        patternName: getPatternName(pattern),
-        category: pattern.category,
-        file: pattern.source.file,
-        source: deriveSource(pattern.source.file),
-        ...(pattern.status !== undefined && { status: pattern.status }),
-        ...(pattern.phase !== undefined && { phase: pattern.phase }),
-    };
-}
-/**
- * Project an array of ExtractedPatterns to compact summaries.
- *
- * @param patterns - Array of ExtractedPatterns
- * @returns Array of PatternSummary objects
- */
-export function summarizePatterns(patterns) {
-    return patterns.map(summarizePattern);
-}
-//# sourceMappingURL=summarize.js.map

package/dist/api/summarize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/api/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;CAC1C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,aAAa;IACb,QAAQ;IACR,UAAU;IACV,OAAO;IACP,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AAEH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,OAAO;QACL,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;QACzB,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACzC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAqC;IAErC,OAAO,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC"}

package/dist/cache/file-cache.d.ts

@@ -1,72 +0,0 @@
-/**
- * @architect
- * @architect-pattern FileCache
- * @architect-status active
- * @architect-arch-role infrastructure
- * @architect-arch-context generator
- * @architect-arch-layer infrastructure
- *
- * ## File Cache - Request-Scoped Content Caching
- *
- * Simple Map-based cache for file contents during a single generation run.
- * Avoids repeated disk reads for files accessed multiple times during
- * extraction and deduplication phases.
- *
- * ### Design Rationale
- *
- * - **Request-scoped**: Created fresh per orchestrator run, naturally cleared when done
- * - **No eviction needed**: Generation runs are bounded in duration and file count
- * - **Thread-safe**: Single-threaded Node.js, no locking required
- * - **Stats tracking**: Optional hit/miss tracking for performance analysis
- *
- * **When to Use:** When a generation run reads the same file multiple times — create a cache instance per orchestrator run.
- */
-/**
- * File content cache interface
- */
-export interface FileCache {
-    /** Get cached content by absolute path */
-    get(path: string): string | undefined;
-    /** Store content in cache */
-    set(path: string, content: string): void;
-    /** Check if path is cached */
-    has(path: string): boolean;
-    /** Clear all cached content */
-    clear(): void;
-    /** Get cache statistics */
-    getStats(): FileCacheStats;
-}
-/**
- * Cache statistics for performance analysis
- */
-export interface FileCacheStats {
-    /** Number of cache hits */
-    hits: number;
-    /** Number of cache misses */
-    misses: number;
-    /** Number of entries currently in cache */
-    size: number;
-    /** Hit rate as percentage (0-100) */
-    hitRate: number;
-}
-/**
- * Create a new file content cache
- *
- * @returns Fresh FileCache instance
- *
- * @example
- * ```typescript
- * const cache = createFileCache();
- *
- * // First access reads from disk
- * const content = await readFile(path);
- * cache.set(path, content);
- *
- * // Subsequent access uses cache
- * if (cache.has(path)) {
- *   return cache.get(path);
- * }
- * ```
- */
-export declare function createFileCache(): FileCache;
-//# sourceMappingURL=file-cache.d.ts.map

package/dist/cache/file-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../src/cache/file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAEtC,6BAA6B;IAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzC,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAAC;IAEd,2BAA2B;IAC3B,QAAQ,IAAI,cAAc,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAwC3C"}

package/dist/cache/file-cache.js

@@ -1,80 +0,0 @@
-/**
- * @architect
- * @architect-pattern FileCache
- * @architect-status active
- * @architect-arch-role infrastructure
- * @architect-arch-context generator
- * @architect-arch-layer infrastructure
- *
- * ## File Cache - Request-Scoped Content Caching
- *
- * Simple Map-based cache for file contents during a single generation run.
- * Avoids repeated disk reads for files accessed multiple times during
- * extraction and deduplication phases.
- *
- * ### Design Rationale
- *
- * - **Request-scoped**: Created fresh per orchestrator run, naturally cleared when done
- * - **No eviction needed**: Generation runs are bounded in duration and file count
- * - **Thread-safe**: Single-threaded Node.js, no locking required
- * - **Stats tracking**: Optional hit/miss tracking for performance analysis
- *
- * **When to Use:** When a generation run reads the same file multiple times — create a cache instance per orchestrator run.
- */
-/**
- * Create a new file content cache
- *
- * @returns Fresh FileCache instance
- *
- * @example
- * ```typescript
- * const cache = createFileCache();
- *
- * // First access reads from disk
- * const content = await readFile(path);
- * cache.set(path, content);
- *
- * // Subsequent access uses cache
- * if (cache.has(path)) {
- *   return cache.get(path);
- * }
- * ```
- */
-export function createFileCache() {
-    const store = new Map();
-    let hits = 0;
-    let misses = 0;
-    return {
-        get(path) {
-            const content = store.get(path);
-            if (content !== undefined) {
-                hits++;
-            }
-            else {
-                misses++;
-            }
-            return content;
-        },
-        set(path, content) {
-            store.set(path, content);
-        },
-        has(path) {
-            return store.has(path);
-        },
-        clear() {
-            store.clear();
-            hits = 0;
-            misses = 0;
-        },
-        getStats() {
-            const total = hits + misses;
-            return {
-                hits,
-                misses,
-                size: store.size,
-                hitRate: total > 0 ? (hits / total) * 100 : 0,
-            };
-        },
-    };
-}
-//# sourceMappingURL=file-cache.js.map

package/dist/cache/file-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-cache.js","sourceRoot":"","sources":["../../src/cache/file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAuCH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO;QACL,GAAG,CAAC,IAAY;YACd,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,IAAI,EAAE,CAAC;YACT,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,CAAC;YACX,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,GAAG,CAAC,IAAY,EAAE,OAAe;YAC/B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QAED,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,KAAK;YACH,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,GAAG,CAAC,CAAC;YACT,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;QAED,QAAQ;YACN,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;YAC5B,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;aAC9C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cache/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Cache module exports
- */
-export { createFileCache, type FileCache, type FileCacheStats } from './file-cache.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cache/index.js

@@ -1,5 +0,0 @@
-/**
- * Cache module exports
- */
-export { createFileCache } from './file-cache.js';
-//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAuC,MAAM,iBAAiB,CAAC"}

package/dist/cli/dataset-cache.d.ts

@@ -1,66 +0,0 @@
-/**
- * @architect
- * @architect-cli
- * @architect-pattern DatasetCache
- * @architect-status active
- * @architect-implements DataAPICLIErgonomics
- * @architect-arch-role infrastructure
- * @architect-arch-context cli
- * @architect-arch-layer infrastructure
- * @architect-uses PipelineFactory, WorkflowConfigSchema
- *
- * ## Dataset Cache - MasterDataset Persistence with mtime Invalidation
- *
- * Caches the full PipelineResult (MasterDataset + ValidationSummary + warnings)
- * to a JSON file. Subsequent CLI invocations skip the 2-5s pipeline rebuild
- * when no source files have changed.
- *
- * ### Design Decisions
- *
- * - DD-1: Excludes LoadedWorkflow (contains Maps), reconstructs on load via createLoadedWorkflow()
- * - DD-2: Cache at node_modules/.cache/architect/dataset.json
- * - DD-3: Cache key = sha256(sorted file mtimes + pipeline options hash)
- * - DD-4: All errors produce cache miss (never throw)
- */
-import type { PipelineResult, PipelineOptions } from '../generators/pipeline/index.js';
-/**
- * Resolve the cache directory for a given base directory.
- */
-export declare function getCacheDir(baseDir: string): string;
-/**
- * Compute a cache key from pipeline options and source file mtimes.
- *
- * The key captures:
- * - Sorted list of source files with their modification times
- * - Pipeline options that affect output (input patterns, features, baseDir, workflowPath)
- *
- * Any change to source files or pipeline config produces a different key.
- */
-export declare function computeCacheKey(opts: PipelineOptions): Promise<string>;
-/**
- * Attempt to load a cached PipelineResult.
- *
- * Returns `undefined` on any error (corrupt cache, key mismatch, etc.).
- * Never throws — the caller should fall back to running the full pipeline.
- */
-export declare function tryLoadCache(cacheKey: string, cacheDir: string): Promise<{
-    result: PipelineResult;
-    ageMs: number;
-} | undefined>;
-/**
- * Write a PipelineResult to the cache file.
- *
- * Strips the non-serializable `workflow` field and stores the `WorkflowConfig`
- * separately for reconstruction on load. Uses atomic write (tmp + rename).
- *
- * Never throws — cache write failures are silently ignored.
- */
-export declare function writeCache(result: PipelineResult, cacheKey: string, cacheDir: string): Promise<void>;
-/**
- * Check whether a cache file exists (for dry-run reporting).
- */
-export declare function cacheFileExists(cacheDir: string): {
-    exists: boolean;
-    sizeBytes?: number;
-};
-//# sourceMappingURL=dataset-cache.d.ts.map

package/dist/cli/dataset-cache.js

@@ -1,179 +0,0 @@
-/**
- * @architect
- * @architect-cli
- * @architect-pattern DatasetCache
- * @architect-status active
- * @architect-implements DataAPICLIErgonomics
- * @architect-arch-role infrastructure
- * @architect-arch-context cli
- * @architect-arch-layer infrastructure
- * @architect-uses PipelineFactory, WorkflowConfigSchema
- *
- * ## Dataset Cache - MasterDataset Persistence with mtime Invalidation
- *
- * Caches the full PipelineResult (MasterDataset + ValidationSummary + warnings)
- * to a JSON file. Subsequent CLI invocations skip the 2-5s pipeline rebuild
- * when no source files have changed.
- *
- * ### Design Decisions
- *
- * - DD-1: Excludes LoadedWorkflow (contains Maps), reconstructs on load via createLoadedWorkflow()
- * - DD-2: Cache at node_modules/.cache/architect/dataset.json
- * - DD-3: Cache key = sha256(sorted file mtimes + pipeline options hash)
- * - DD-4: All errors produce cache miss (never throw)
- */
-import * as fs from 'fs';
-import * as fsp from 'fs/promises';
-import * as path from 'path';
-import * as crypto from 'crypto';
-import { glob } from 'glob';
-import { createLoadedWorkflow } from '../validation-schemas/workflow-config.js';
-/** Cache format version — bump when the serialization format changes. */
-const CACHE_VERSION = '1';
-// =============================================================================
-// Public API
-// =============================================================================
-/**
- * Resolve the cache directory for a given base directory.
- */
-export function getCacheDir(baseDir) {
-    return path.join(path.resolve(baseDir), 'node_modules', '.cache', 'architect');
-}
-/**
- * Compute a cache key from pipeline options and source file mtimes.
- *
- * The key captures:
- * - Sorted list of source files with their modification times
- * - Pipeline options that affect output (input patterns, features, baseDir, workflowPath)
- *
- * Any change to source files or pipeline config produces a different key.
- */
-export async function computeCacheKey(opts) {
-    const baseDir = path.resolve(opts.baseDir);
-    const hash = crypto.createHash('sha256');
-    // Hash pipeline options that affect dataset output
-    hash.update(JSON.stringify({
-        input: opts.input,
-        features: opts.features,
-        baseDir,
-        workflowPath: opts.workflowPath ?? null,
-        mergeConflictStrategy: opts.mergeConflictStrategy,
-        includeValidation: opts.includeValidation ?? true,
-    }));
-    // Resolve glob patterns to file lists and collect mtimes
-    const fileMtimes = [];
-    for (const pattern of [...opts.input, ...opts.features]) {
-        const files = await glob(pattern, { cwd: baseDir, absolute: true });
-        for (const file of files.sort()) {
-            try {
-                const stat = await fsp.stat(file);
-                fileMtimes.push(`${file}:${stat.mtimeMs}`);
-            }
-            catch {
-                // File disappeared between glob and stat — include as changed
-                fileMtimes.push(`${file}:missing`);
-            }
-        }
-    }
-    // Also include config file mtime if it exists (.ts or .js)
-    for (const configName of ['architect.config.ts', 'architect.config.js']) {
-        const configPath = path.join(baseDir, configName);
-        try {
-            const configStat = await fsp.stat(configPath);
-            fileMtimes.push(`${configPath}:${configStat.mtimeMs}`);
-        }
-        catch {
-            fileMtimes.push(`${configPath}:absent`);
-        }
-    }
-    hash.update(fileMtimes.join('\n'));
-    return hash.digest('hex');
-}
-/**
- * Attempt to load a cached PipelineResult.
- *
- * Returns `undefined` on any error (corrupt cache, key mismatch, etc.).
- * Never throws — the caller should fall back to running the full pipeline.
- */
-export async function tryLoadCache(cacheKey, cacheDir) {
-    try {
-        const cachePath = path.join(cacheDir, 'dataset.json');
-        const raw = await fsp.readFile(cachePath, 'utf-8');
-        const cached = JSON.parse(raw);
-        // Validate cache version and key
-        if (cached.metadata.version !== CACHE_VERSION)
-            return undefined;
-        if (cached.metadata.key !== cacheKey)
-            return undefined;
-        // Reconstruct RuntimeMasterDataset from plain MasterDataset + WorkflowConfig
-        const dataset = cached.dataset;
-        if (cached.workflowConfig !== null) {
-            const workflow = createLoadedWorkflow(cached.workflowConfig);
-            // Assign workflow back onto the deserialized dataset (Maps are not JSON-serializable)
-            Object.assign(dataset, { workflow });
-        }
-        const ageMs = Date.now() - new Date(cached.metadata.timestamp).getTime();
-        return {
-            result: {
-                dataset,
-                validation: cached.validation,
-                warnings: cached.warnings,
-                scanMetadata: cached.scanMetadata,
-            },
-            ageMs,
-        };
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Write a PipelineResult to the cache file.
- *
- * Strips the non-serializable `workflow` field and stores the `WorkflowConfig`
- * separately for reconstruction on load. Uses atomic write (tmp + rename).
- *
- * Never throws — cache write failures are silently ignored.
- */
-export async function writeCache(result, cacheKey, cacheDir) {
-    try {
-        await fsp.mkdir(cacheDir, { recursive: true });
-        // Extract WorkflowConfig (serializable) from LoadedWorkflow (has Maps)
-        const workflowConfig = result.dataset.workflow?.config ?? null;
-        // Strip the non-serializable workflow field from the dataset
-        const { workflow: _workflow, ...serializableDataset } = result.dataset;
-        const cacheData = {
-            metadata: {
-                key: cacheKey,
-                timestamp: new Date().toISOString(),
-                version: CACHE_VERSION,
-            },
-            dataset: serializableDataset,
-            workflowConfig,
-            validation: result.validation,
-            warnings: result.warnings,
-            scanMetadata: result.scanMetadata,
-        };
-        const cachePath = path.join(cacheDir, 'dataset.json');
-        const tmpPath = `${cachePath}.${process.pid}.${Date.now()}.tmp`;
-        await fsp.writeFile(tmpPath, JSON.stringify(cacheData), 'utf-8');
-        await fsp.rename(tmpPath, cachePath);
-    }
-    catch {
-        // Cache write failure is not fatal — next run will rebuild
-    }
-}
-/**
- * Check whether a cache file exists (for dry-run reporting).
- */
-export function cacheFileExists(cacheDir) {
-    try {
-        const cachePath = path.join(cacheDir, 'dataset.json');
-        const stat = fs.statSync(cachePath);
-        return { exists: true, sizeBytes: stat.size };
-    }
-    catch {
-        return { exists: false };
-    }
-}
-//# sourceMappingURL=dataset-cache.js.map

package/dist/cli/dataset-cache.js.map

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

package/dist/cli/error-handler.d.ts

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-/**
- * @architect
- * @architect-cli
- * @architect-pattern CLIErrorHandler
- * @architect-status completed
- * @architect-uses DocError
- * @architect-used-by LintPatternsCLI, ValidatePatternsCLI, DocumentationGeneratorCLI
- *
- * ## CLIErrorHandler - Unified CLI Error Handling Utilities
- *
- * Provides type-safe error handling for all CLI commands using the
- * DocError discriminated union pattern. Ensures structured error
- * context is preserved and formatted consistently.
- *
- * ### When to Use
- *
- * - In catch blocks of CLI main functions
- * - When formatting DocError for console output
- * - When checking if an unknown error is a DocError
- */
-import type { DocError } from '../types/errors.js';
-/**
- * Type guard to check if an unknown value is a DocError
- *
- * Uses the discriminated union `type` property to identify DocError instances.
- * All DocError variants have a `type` string property that uniquely identifies them.
- *
- * @param error - Unknown error value to check
- * @returns True if the error is a DocError with recognized type
- *
- * @example
- * ```typescript
- * try {
- *   await scanPatterns(config);
- * } catch (error) {
- *   if (isDocError(error)) {
- *     // TypeScript knows error is DocError here
- *     console.log(error.type, error.message);
- *   }
- * }
- * ```
- */
-export declare function isDocError(error: unknown): error is DocError;
-/**
- * Format a DocError for console output with structured context
- *
- * Extracts file paths, line numbers, and validation errors from the
- * DocError structure and formats them for human-readable output.
- *
- * @param error - DocError to format
- * @returns Formatted error string with context
- *
- * @example
- * ```typescript
- * const error = createFileParseError('/path/to/file.ts', 'Syntax error', { line: 42 });
- * console.error(formatDocError(error));
- * // Output: "FILE_PARSE_ERROR: Failed to parse /path/to/file.ts at line 42: Syntax error"
- * ```
- */
-export declare function formatDocError(error: DocError): string;
-/**
- * Unified CLI error handler that formats and exits
- *
- * Handles both DocError instances and generic Error/unknown values.
- * Outputs structured error information and exits with specified code.
- *
- * @param error - Error to handle (DocError, Error, or unknown)
- * @param exitCode - Process exit code (default: 1)
- * @returns Never - always calls process.exit
- *
- * @example
- * ```typescript
- * async function main(): Promise<void> {
- *   try {
- *     await doWork();
- *   } catch (error) {
- *     handleCliError(error, 1);
- *   }
- * }
- * ```
- */
-export declare function handleCliError(error: unknown, exitCode?: number): never;
-//# sourceMappingURL=error-handler.d.ts.map

package/dist/cli/error-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/cli/error-handler.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CA6B5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAqFtD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,KAAK,CAgBlE"}