@tyroneross/navgator 0.2.2 → 0.10.0

package/dist/impact.js.map

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

package/dist/index.d.ts

@@ -7,10 +7,49 @@
  */
 export { scan, quickScan, getScanStatus, scanPromptsOnly, type ScanOptions } from './scanner.js';
 export { setup, fastSetup, fullSetup, isSetupComplete, formatSetupStatus } from './setup.js';
-export { getConfig, type NavGatorConfig } from './config.js';
+export { getConfig, SCHEMA_VERSION, type NavGatorConfig } from './config.js';
 export { loadIndex, loadAllComponents, loadAllConnections, loadGraph, storeComponent, storeConnection, deleteComponent, } from './storage.js';
 export { generateMermaidDiagram, generateComponentDiagram, generateLayerDiagram, generateSummaryDiagram, wrapInMarkdown, type DiagramOptions, } from './diagram.js';
-export type { ArchitectureComponent, ArchitectureConnection, ConnectionGraph, ArchitectureIndex, ArchitectureLayer, ComponentType, ConnectionType, ScanResult, ScanWarning, } from './types.js';
+export { computeArchitectureDiff, classifySignificance, loadTimeline, saveTimelineEntry, loadLatestSnapshot, buildCurrentSnapshot, formatTimeline, formatDiffSummary, formatDiffForSummary, } from './diff.js';
+export { registerProject, listProjects, formatProjectsList, updateProjectMeta, removeProject, pruneProjects, type ProjectEntry, type ProjectRegistry, type ProjectChangeSummary, } from './projects.js';
+export { readJournal, formatJournal, appendJournalEvent, appendJournalEventSync, defaultRegistryDir, journalPathForDir, type RegistryJournalEvent, type JournalActor, type JournalOp, } from './registry-journal.js';
+export { getGitInfo } from './git.js';
+export { memoryEnabled, memoryDir, projectMemoryPath, recordMemoryEvent, readProjectMemory, listProjectMemories, readMemoryEvents, memoryStoreStats, removeProjectMemory, rebuildMemoryIndex, reconcileMemory, slug as memoryProjectSlug, MEMORY_SCHEMA_VERSION, DEFAULT_MAX_EVENT_BYTES, MAX_MILESTONES, type MemoryEvent, type MemoryEventKind, type ProjectMemory, type RecordMemoryEventInput, } from './memory/store.js';
+export { mirrorStatus, mirrorProjectMemory, mirrorAll, type MirrorStatus, } from './memory/mirror.js';
+export { computeHealth, isTmpRootedPath, classifyRegistryEntries, selectPrunableEntries, HEALTH_SCHEMA_VERSION, type HealthReport, type HealthFinding, type RegistryEntryClassification, } from './memory/health.js';
+export { loadHomeConfig, homeConfigPath, resetHomeConfigCache, type NavGatorHomeConfig, } from './home-config.js';
+export { componentBaseName, identityKey, mergeComponentAliases } from './component-identity.js';
+export { writeSnapshotForCurrentRef, readCanonicalSnapshot, readBranchSnapshot, type WriteSnapshotResult, } from './git-aware/canonical.js';
+export { getDefaultBranch, getCurrentBranch, getCurrentRef, isDefaultBranch, isWorktree, slugifyRef } from './git-aware/refs.js';
+export { premergeDiff, type PremergeDiffOptions, type PremergeDiffResult } from './git-aware/premerge-diff.js';
+export { discoverRepos } from './portfolio/discover.js';
+export { scanPortfolio } from './portfolio/scan.js';
+export { buildCrossRepoMap } from './portfolio/cross-repo.js';
+export type { RepoDiscoveryOptions, DiscoveredRepo, PortfolioScanOptions, RepoScanStatus, RepoOutcome, PortfolioScanResult, CrossRepoRepoInput, SharedDependencyRepoVersion, SharedDependencyEntry, CrossRepoServiceCallBasis, CrossRepoServiceEdge, PortfolioStatus, CrossRepoMap, } from './portfolio/types.js';
+export { parseGitHubUrl, type ParsedGitHubUrl } from './remote/github-url.js';
+export { scanRemote, type ScanRemoteOptions, type ScanRemoteResult } from './remote/scan-remote.js';
+export { computeImpact, computeSeverity } from './impact.js';
+export { AGENT_OUTPUT_LIMITS, boundAgentCollection, wrapInEnvelope, buildExecutiveSummary, } from './agent-output.js';
+export type { ArchitectureComponent, ArchitectureConnection, ConnectionGraph, ArchitectureIndex, ArchitectureLayer, ComponentType, ConnectionType, ScanResult, ArchitectureScanStatus, ArchitectureScanStats, ArchitectureScanPayload, ArchitectureScanOutcome, ScanWarning, Snapshot, SnapshotComponent, SnapshotConnection, DiffResult, DiffSignificance, DiffTrigger, TimelineEntry, Timeline, ComponentChange, ComponentModification, ConnectionChange, GitInfo, ImpactSeverity, ImpactAnalysis, AffectedComponent, AgentEnvelope, ExecutiveSummary, AgentCollectionWindow, SummaryRuleHealth, SummaryRuleViolation, SummaryRisk, SummaryBlocker, SummaryAction, CompactComponent, CompactConnection, } from './types.js';
+export { toCompactComponent, toCompactConnection } from './types.js';
+export { resolveComponent, findCandidates } from './resolve.js';
+export { resolveFileConnections, looksLikeFilePath, formatFileImpact, formatFileConnections } from './file-resolve.js';
+export type { FileConnections } from './file-resolve.js';
+export { scanImports } from './scanners/connections/import-scanner.js';
+export { buildArchitectureIndex, writeArchitectureIndex, renderArchitectureMarkdown, stableStringify, ARCHITECTURE_INDEX_PATH, ARCHITECTURE_INDEX_SCHEMA_VERSION, ARCHITECTURE_MD_PATH, ARCHITECTURE_MODULES_PATH, } from './architecture-index.js';
+export type { ArchitectureIndex as CommittedArchitectureIndex, CoverageReport as ArchitectureIndexCoverage, ModuleEntry as ArchitectureIndexModule, } from './architecture-index.js';
+export { classifyConnection, classifyAllConnections } from './classify.js';
+export type { SemanticClassification, SemanticInfo } from './classify.js';
+export { traceDataflow, formatTraceOutput } from './trace.js';
+export type { TraceResult, TracePath, TraceStep, TraceOptions } from './trace.js';
+export { checkRules, getBuiltinRules, loadCustomRules, formatRulesOutput } from './rules.js';
+export type { ArchitectureRule, RuleViolation } from './rules.js';
+export { computeCoverage, formatCoverageOutput } from './coverage.js';
+export type { CoverageReport, CoverageGap } from './coverage.js';
+export { extractSubgraph, subgraphToMermaid } from './subgraph.js';
+export type { SubgraphOptions } from './subgraph.js';
+export { detectSandbox, isSandboxMode, getSandboxRestrictions } from './sandbox.js';
+export type { SandboxConfig } from './sandbox.js';
 export { scanPrompts, formatPromptsOutput, formatPromptDetail, convertToArchitecture, } from './scanners/prompts/index.js';
 export type { DetectedPrompt, PromptScanResult, PromptMessage, PromptVariable, PromptCategory, } from './scanners/prompts/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,11 +8,66 @@
 // Main exports
 export { scan, quickScan, getScanStatus, scanPromptsOnly } from './scanner.js';
 export { setup, fastSetup, fullSetup, isSetupComplete, formatSetupStatus } from './setup.js';
-export { getConfig } from './config.js';
+export { getConfig, SCHEMA_VERSION } from './config.js';
 // Storage
 export { loadIndex, loadAllComponents, loadAllConnections, loadGraph, storeComponent, storeConnection, deleteComponent, } from './storage.js';
 // Diagram generation
 export { generateMermaidDiagram, generateComponentDiagram, generateLayerDiagram, generateSummaryDiagram, wrapInMarkdown, } from './diagram.js';
+// Diff engine
+export { computeArchitectureDiff, classifySignificance, loadTimeline, saveTimelineEntry, loadLatestSnapshot, buildCurrentSnapshot, formatTimeline, formatDiffSummary, formatDiffForSummary, } from './diff.js';
+// Project registry
+export { registerProject, listProjects, formatProjectsList, updateProjectMeta, removeProject, pruneProjects, } from './projects.js';
+// Registry operation journal — every read and write of the project registry
+export { readJournal, formatJournal, appendJournalEvent, appendJournalEventSync, defaultRegistryDir, journalPathForDir, } from './registry-journal.js';
+// Git utilities
+export { getGitInfo } from './git.js';
+// gator-memory — durable narrative store for ~/.navgator/memory/
+export { memoryEnabled, memoryDir, projectMemoryPath, recordMemoryEvent, readProjectMemory, listProjectMemories, readMemoryEvents, memoryStoreStats, removeProjectMemory, rebuildMemoryIndex, reconcileMemory, slug as memoryProjectSlug, MEMORY_SCHEMA_VERSION, DEFAULT_MAX_EVENT_BYTES, MAX_MILESTONES, } from './memory/store.js';
+// gator-memory mirror — optional one-way export into a build-loop-memory tree
+export { mirrorStatus, mirrorProjectMemory, mirrorAll, } from './memory/mirror.js';
+// gator-memory / registry health — the single computation behind `navgator doctor`
+export { computeHealth, isTmpRootedPath, classifyRegistryEntries, selectPrunableEntries, HEALTH_SCHEMA_VERSION, } from './memory/health.js';
+// Home-scoped configuration — ~/.navgator/config.json
+export { loadHomeConfig, homeConfigPath, resetHomeConfigCache, } from './home-config.js';
+// Component identity — base-name normalization and alias merging
+export { componentBaseName, identityKey, mergeComponentAliases } from './component-identity.js';
+// Git-aware — canonical/branch snapshot storage (slice 3) and pre-merge diff (slice 4)
+export { writeSnapshotForCurrentRef, readCanonicalSnapshot, readBranchSnapshot, } from './git-aware/canonical.js';
+export { getDefaultBranch, getCurrentBranch, getCurrentRef, isDefaultBranch, isWorktree, slugifyRef } from './git-aware/refs.js';
+export { premergeDiff } from './git-aware/premerge-diff.js';
+// Portfolio — multi-repo scanning and cross-repo mapping
+export { discoverRepos } from './portfolio/discover.js';
+export { scanPortfolio } from './portfolio/scan.js';
+export { buildCrossRepoMap } from './portfolio/cross-repo.js';
+// Remote — GitHub URL parsing, clone, and scan
+export { parseGitHubUrl } from './remote/github-url.js';
+export { scanRemote } from './remote/scan-remote.js';
+// Impact analysis
+export { computeImpact, computeSeverity } from './impact.js';
+// Agent output
+export { AGENT_OUTPUT_LIMITS, boundAgentCollection, wrapInEnvelope, buildExecutiveSummary, } from './agent-output.js';
+// Compact serialization utilities
+export { toCompactComponent, toCompactConnection } from './types.js';
+// Resolve
+export { resolveComponent, findCandidates } from './resolve.js';
+// File-level resolution
+export { resolveFileConnections, looksLikeFilePath, formatFileImpact, formatFileConnections } from './file-resolve.js';
+// Import scanner
+export { scanImports } from './scanners/connections/import-scanner.js';
+// Architecture index (committed, deterministic projection of the import graph)
+export { buildArchitectureIndex, writeArchitectureIndex, renderArchitectureMarkdown, stableStringify, ARCHITECTURE_INDEX_PATH, ARCHITECTURE_INDEX_SCHEMA_VERSION, ARCHITECTURE_MD_PATH, ARCHITECTURE_MODULES_PATH, } from './architecture-index.js';
+// Classify
+export { classifyConnection, classifyAllConnections } from './classify.js';
+// Trace
+export { traceDataflow, formatTraceOutput } from './trace.js';
+// Rules
+export { checkRules, getBuiltinRules, loadCustomRules, formatRulesOutput } from './rules.js';
+// Coverage
+export { computeCoverage, formatCoverageOutput } from './coverage.js';
+// Subgraph
+export { extractSubgraph, subgraphToMermaid } from './subgraph.js';
+// Sandbox
+export { detectSandbox, isSandboxMode, getSandboxRestrictions } from './sandbox.js';
 // Prompt scanner exports
 export { scanPrompts, formatPromptsOutput, formatPromptDetail, convertToArchitecture, } from './scanners/prompts/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAE7D,UAAU;AACV,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,GAEf,MAAM,cAAc,CAAC;AAetB,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lessons-store.d.ts

@@ -0,0 +1,93 @@
+/**
+ * NavGator Lessons Store
+ *
+ * Manages per-project and global architectural lessons. Local lessons live at
+ * `<project>/.navgator/lessons/lessons.json`. Promoted lessons are copied (never
+ * moved) into `~/.navgator/lessons/global-lessons.json` and the local copy is
+ * marked with `promoted: true`.
+ *
+ * Zero external deps — uses node fs/path/os only. Writes are atomic (temp+rename).
+ */
+export type Severity = 'critical' | 'important' | 'minor';
+export type LessonCategory = 'api-contract' | 'data-flow' | 'component-communication' | 'llm-architecture' | 'infrastructure' | 'typespec' | 'database-structure';
+export interface LessonContext {
+    first_seen?: string;
+    last_seen?: string;
+    occurrences?: number;
+    files_affected?: string[];
+    resolution?: string;
+}
+export interface LessonExample {
+    bad?: string;
+    good?: string;
+    why?: string;
+}
+export interface Lesson {
+    id: string;
+    category: LessonCategory;
+    pattern: string;
+    signature?: string[];
+    severity: Severity;
+    context?: LessonContext;
+    example?: LessonExample;
+    /** Set to true on the local lesson after a successful promotion. */
+    promoted?: boolean;
+}
+export interface GlobalLesson extends Lesson {
+    source_project: string;
+    applies_to?: string[];
+    promoted_at: string;
+    promoted_from?: string;
+}
+export interface LessonsFile {
+    schema_version: string;
+    project: string;
+    lessons: Lesson[] | GlobalLesson[];
+    /** Preserved on read/write for backward compatibility with repo template file. */
+    _template?: unknown;
+}
+export declare const LESSONS_SCHEMA_VERSION = "1.0.0";
+export declare function globalLessonsPath(): string;
+export declare function localLessonsPath(projectRoot: string): string;
+export declare function readLessons(filePath: string): LessonsFile;
+/**
+ * Atomic write: write to a sibling temp file, then rename into place.
+ * On any failure the caller sees a thrown error and the original is untouched.
+ */
+export declare function writeLessons(filePath: string, data: LessonsFile): void;
+/**
+ * Ensure the global lessons file exists, seeded with an empty template.
+ * Safe to call repeatedly. Never touches `~/.navgator/projects.json`.
+ */
+export declare function ensureGlobalLessonsFile(): string;
+interface ListOpts {
+    scope: 'local' | 'global';
+    projectRoot?: string;
+}
+export declare function listLessons(opts: ListOpts): Lesson[] | GlobalLesson[];
+interface SearchOpts {
+    scope: 'local' | 'global' | 'all';
+    projectRoot?: string;
+    category?: LessonCategory;
+    severity?: Severity;
+    tags?: string[];
+}
+export declare function searchLessons(query: string, opts: SearchOpts): (Lesson | GlobalLesson)[];
+export declare function findLessonById(id: string, opts: ListOpts): Lesson | GlobalLesson | null;
+interface PromoteResult {
+    promoted: boolean;
+    globalLesson: GlobalLesson | null;
+    reason?: 'not-found' | 'already-global' | 'ok';
+}
+interface PromoteOpts {
+    applies_to?: string[];
+    project_name?: string;
+}
+export declare function promoteLesson(id: string, projectRoot: string, opts?: PromoteOpts): PromoteResult;
+interface DemoteResult {
+    demoted: boolean;
+    reason?: 'not-found' | 'ok';
+}
+export declare function demoteLesson(id: string): DemoteResult;
+export {};
+//# sourceMappingURL=lessons-store.d.ts.map

package/dist/lessons-store.d.ts.map

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

package/dist/lessons-store.js

@@ -0,0 +1,265 @@
+/**
+ * NavGator Lessons Store
+ *
+ * Manages per-project and global architectural lessons. Local lessons live at
+ * `<project>/.navgator/lessons/lessons.json`. Promoted lessons are copied (never
+ * moved) into `~/.navgator/lessons/global-lessons.json` and the local copy is
+ * marked with `promoted: true`.
+ *
+ * Zero external deps — uses node fs/path/os only. Writes are atomic (temp+rename).
+ */
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+const VALID_CATEGORIES = new Set([
+    'api-contract',
+    'data-flow',
+    'component-communication',
+    'llm-architecture',
+    'infrastructure',
+    'typespec',
+    'database-structure',
+]);
+const VALID_SEVERITIES = new Set([
+    'critical',
+    'important',
+    'minor',
+]);
+const ID_PATTERN = /^lesson-[a-z0-9-]+$/;
+export const LESSONS_SCHEMA_VERSION = '1.0.0';
+// =============================================================================
+// PATHS
+// =============================================================================
+/**
+ * Directory that holds the global lessons file. Honors the
+ * `NAVGATOR_GLOBAL_LESSONS_DIR` env var so tests can redirect to a tmpdir.
+ */
+function globalLessonsDir() {
+    const override = process.env.NAVGATOR_GLOBAL_LESSONS_DIR;
+    if (override && override.trim() !== '')
+        return override;
+    return path.join(os.homedir(), '.navgator', 'lessons');
+}
+export function globalLessonsPath() {
+    return path.join(globalLessonsDir(), 'global-lessons.json');
+}
+export function localLessonsPath(projectRoot) {
+    return path.join(projectRoot, '.navgator', 'lessons', 'lessons.json');
+}
+// =============================================================================
+// READ / WRITE
+// =============================================================================
+function emptyFile(project) {
+    return {
+        schema_version: LESSONS_SCHEMA_VERSION,
+        project,
+        lessons: [],
+    };
+}
+export function readLessons(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            schema_version: parsed.schema_version || LESSONS_SCHEMA_VERSION,
+            project: parsed.project ?? '',
+            lessons: Array.isArray(parsed.lessons) ? parsed.lessons : [],
+            ...(parsed._template !== undefined ? { _template: parsed._template } : {}),
+        };
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'ENOENT') {
+            return emptyFile('');
+        }
+        // Malformed JSON or other read error — return empty so callers can overwrite.
+        if (err instanceof SyntaxError)
+            return emptyFile('');
+        throw err;
+    }
+}
+/**
+ * Atomic write: write to a sibling temp file, then rename into place.
+ * On any failure the caller sees a thrown error and the original is untouched.
+ */
+export function writeLessons(filePath, data) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const tmp = path.join(dir, `.${path.basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
+    const payload = JSON.stringify(data, null, 2);
+    try {
+        fs.writeFileSync(tmp, payload, 'utf-8');
+        fs.renameSync(tmp, filePath);
+    }
+    catch (err) {
+        // Best-effort cleanup of the temp file.
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch { /* ignore */ }
+        throw err;
+    }
+}
+/**
+ * Ensure the global lessons file exists, seeded with an empty template.
+ * Safe to call repeatedly. Never touches `~/.navgator/projects.json`.
+ */
+export function ensureGlobalLessonsFile() {
+    const p = globalLessonsPath();
+    if (!fs.existsSync(p)) {
+        writeLessons(p, emptyFile(''));
+    }
+    return p;
+}
+// =============================================================================
+// VALIDATION
+// =============================================================================
+function isValidId(id) {
+    return typeof id === 'string' && ID_PATTERN.test(id);
+}
+function assertValidId(id) {
+    if (!isValidId(id)) {
+        throw new Error(`Invalid lesson id "${id}" — must match ${ID_PATTERN.source}`);
+    }
+}
+function assertValidCategory(c) {
+    if (!VALID_CATEGORIES.has(c)) {
+        throw new Error(`Invalid category "${String(c)}"`);
+    }
+}
+function assertValidSeverity(s) {
+    if (!VALID_SEVERITIES.has(s)) {
+        throw new Error(`Invalid severity "${String(s)}"`);
+    }
+}
+export function listLessons(opts) {
+    if (opts.scope === 'global') {
+        const file = readLessons(globalLessonsPath());
+        return file.lessons || [];
+    }
+    if (!opts.projectRoot) {
+        throw new Error('listLessons: projectRoot required for scope=local');
+    }
+    const file = readLessons(localLessonsPath(opts.projectRoot));
+    return file.lessons || [];
+}
+function lessonMatchesQuery(l, re) {
+    if (!re)
+        return true;
+    if (re.test(l.pattern || ''))
+        return true;
+    if (Array.isArray(l.signature) && l.signature.some((s) => re.test(s)))
+        return true;
+    if (l.example?.bad && re.test(l.example.bad))
+        return true;
+    if (l.example?.good && re.test(l.example.good))
+        return true;
+    if (l.context?.resolution && re.test(l.context.resolution))
+        return true;
+    if (re.test(l.id))
+        return true;
+    return false;
+}
+export function searchLessons(query, opts) {
+    let re = null;
+    if (query && query.trim() !== '') {
+        try {
+            re = new RegExp(query, 'i');
+        }
+        catch {
+            // Fall back to literal substring if regex is invalid.
+            const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            re = new RegExp(escaped, 'i');
+        }
+    }
+    const pool = [];
+    if (opts.scope === 'local' || opts.scope === 'all') {
+        if (opts.projectRoot) {
+            const local = readLessons(localLessonsPath(opts.projectRoot));
+            pool.push(...local.lessons);
+        }
+    }
+    if (opts.scope === 'global' || opts.scope === 'all') {
+        const global = readLessons(globalLessonsPath());
+        pool.push(...global.lessons);
+    }
+    return pool.filter((l) => {
+        if (!lessonMatchesQuery(l, re))
+            return false;
+        if (opts.category && l.category !== opts.category)
+            return false;
+        if (opts.severity && l.severity !== opts.severity)
+            return false;
+        if (opts.tags && opts.tags.length > 0) {
+            // Tags only apply to GlobalLesson.applies_to — filter out non-global matches.
+            const applies = l.applies_to;
+            if (!Array.isArray(applies))
+                return false;
+            const hasAll = opts.tags.every((t) => applies.includes(t));
+            if (!hasAll)
+                return false;
+        }
+        return true;
+    });
+}
+export function findLessonById(id, opts) {
+    const list = listLessons(opts);
+    return list.find((l) => l.id === id) || null;
+}
+export function promoteLesson(id, projectRoot, opts = {}) {
+    assertValidId(id);
+    const localPath = localLessonsPath(projectRoot);
+    const localFile = readLessons(localPath);
+    const localLessons = localFile.lessons;
+    const localIdx = localLessons.findIndex((l) => l.id === id);
+    if (localIdx === -1) {
+        return { promoted: false, globalLesson: null, reason: 'not-found' };
+    }
+    const localLesson = localLessons[localIdx];
+    // Re-validate the lesson so we never promote garbage.
+    assertValidCategory(localLesson.category);
+    assertValidSeverity(localLesson.severity);
+    const globalPath = globalLessonsPath();
+    const globalFile = readLessons(globalPath);
+    if (!globalFile.project)
+        globalFile.project = '';
+    const globalLessons = globalFile.lessons;
+    if (globalLessons.some((l) => l.id === id)) {
+        return { promoted: false, globalLesson: null, reason: 'already-global' };
+    }
+    const projectName = opts.project_name ||
+        localFile.project ||
+        path.basename(projectRoot) ||
+        projectRoot;
+    const globalLesson = {
+        ...localLesson,
+        source_project: projectName,
+        applies_to: opts.applies_to && opts.applies_to.length > 0 ? [...opts.applies_to] : undefined,
+        promoted_at: new Date().toISOString(),
+        promoted_from: localPath,
+    };
+    // Don't carry the local-only `promoted` marker into the global record.
+    delete globalLesson.promoted;
+    globalLessons.push(globalLesson);
+    globalFile.lessons = globalLessons;
+    writeLessons(globalPath, globalFile);
+    // Mark the local lesson (copy-then-mark — never move).
+    localLessons[localIdx] = { ...localLesson, promoted: true };
+    localFile.lessons = localLessons;
+    writeLessons(localPath, localFile);
+    return { promoted: true, globalLesson, reason: 'ok' };
+}
+export function demoteLesson(id) {
+    assertValidId(id);
+    const globalPath = globalLessonsPath();
+    const globalFile = readLessons(globalPath);
+    const globalLessons = globalFile.lessons;
+    const next = globalLessons.filter((l) => l.id !== id);
+    if (next.length === globalLessons.length) {
+        return { demoted: false, reason: 'not-found' };
+    }
+    globalFile.lessons = next;
+    writeLessons(globalPath, globalFile);
+    return { demoted: true, reason: 'ok' };
+}
+//# sourceMappingURL=lessons-store.js.map

package/dist/lessons-store.js.map

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

package/dist/llm-dedup.d.ts

@@ -0,0 +1,46 @@
+/**
+ * LLM Use Case Deduplication
+ *
+ * Transforms raw LLM service-call connections (often 100+) into distinct
+ * use cases (typically 5-15) by filtering noise and grouping by purpose.
+ *
+ * 3-layer pipeline:
+ *   Layer 1 — Filter: remove test/dev, import-only, duplicates
+ *   Layer 2 — Group: prompt match → function name → callType+model → file fallback
+ *   Layer 3 — Merge: combine groups connected via import graph
+ */
+import type { ArchitectureComponent, ArchitectureConnection } from './types.js';
+import type { DetectedPrompt } from './scanners/prompts/types.js';
+export interface LLMUseCase {
+    name: string;
+    category?: string;
+    provider: string;
+    model?: string;
+    primaryFile: string;
+    callSites: number;
+    productionCallSites: number;
+    groupedBy: 'prompt' | 'function' | 'calltype' | 'file';
+    /** Feature domain from features.yaml or directory inference */
+    feature?: string;
+    /** Downstream connections — what this LLM call feeds into (for agent classification) */
+    feedsInto?: string[];
+    /** Resolved provider tag from the LLM component's metadata (e.g. 'apple-on-device') */
+    providerTag?: string;
+    /** Resolved kind from the LLM component's metadata (e.g. 'foundation-models') */
+    kind?: string;
+    /** Structured-output contract names (e.g. @Generable schema names) from the LLM component's metadata */
+    structuredOutput?: string[];
+}
+export interface LLMDedupResult {
+    useCases: LLMUseCase[];
+    totalCallSites: number;
+    productionCallSites: number;
+    providers: string[];
+}
+/**
+ * Load feature annotations from .navgator/features.yaml if present.
+ * Returns a map of file glob → feature name.
+ */
+export declare function loadFeatureAnnotations(projectRoot: string): Map<string, string> | null;
+export declare function deduplicateLLMUseCases(components: ArchitectureComponent[], connections: ArchitectureConnection[], prompts?: DetectedPrompt[]): LLMDedupResult;
+//# sourceMappingURL=llm-dedup.d.ts.map

package/dist/llm-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-dedup.d.ts","sourceRoot":"","sources":["../src/llm-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAMlE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACvD,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wGAAwG;IACxG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AA+FD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA0CtF;AAqCD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,qBAAqB,EAAE,EACnC,WAAW,EAAE,sBAAsB,EAAE,EACrC,OAAO,CAAC,EAAE,cAAc,EAAE,GACzB,cAAc,CAuNhB"}