@tyroneross/navgator 0.2.2 → 0.10.0

package/dist/llm-dedup.js

@@ -0,0 +1,382 @@
+/**
+ * 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 * as fs from 'fs';
+import * as path from 'path';
+// =============================================================================
+// HELPERS
+// =============================================================================
+function isMeaningfulSymbol(symbol) {
+    if (!symbol || symbol.length <= 2)
+        return false;
+    if (symbol === 'default')
+        return false;
+    if (symbol.startsWith('./') || symbol.startsWith('/') || symbol.startsWith('..'))
+        return false;
+    // Generic symbols that don't indicate purpose
+    if (['module', 'exports', 'require', 'import'].includes(symbol))
+        return false;
+    // Generic method names — too common to indicate a distinct use case
+    if (['create', 'call', 'invoke', 'run', 'execute', 'send', 'post', 'get', 'fetch',
+        'from', 'init', 'setup', 'config', 'use', 'with', 'wrap', 'log', 'emit',
+        'on', 'off', 'set', 'add', 'remove', 'update', 'delete', 'load', 'save',
+        'start', 'stop', 'open', 'close', 'connect', 'disconnect',
+        'enabled', 'disabled', 'model', 'capture', 'samplingRate',
+        'tracing_enabled', 'langsmith_enabled',
+    ].includes(symbol))
+        return false;
+    // Provider/class names — these indicate WHO is called, not WHY
+    const providerNames = [
+        'openai', 'anthropic', 'groq', 'cohere', 'mistral', 'replicate',
+        'chatopenai', 'chatgroq', 'chatanthropic', 'chatmistral',
+        'langsmith', 'langchain',
+    ];
+    if (providerNames.includes(symbol.toLowerCase()))
+        return false;
+    // Anonymous/auto-generated function names
+    if (/^anonymous_\d+$/.test(symbol))
+        return false;
+    // Common wrapper names that don't indicate purpose
+    if (['traceable', 'fromZodSchema', 'withRetry'].includes(symbol))
+        return false;
+    return true;
+}
+const PURPOSE_PATTERNS = [
+    // Specific patterns first (before generic ones like /generat/ that match too broadly)
+    [/chart|visual|plot|diagram/i, 'chart-generation'],
+    [/rerank|rank/i, 'reranking'],
+    [/summar/i, 'summarization'],
+    [/embed/i, 'embedding'],
+    [/extract/i, 'extraction'],
+    [/entity|ner|relation/i, 'entity-extraction'],
+    [/theme|topic|cluster/i, 'theme-extraction'],
+    [/trend|forecast/i, 'trend-analysis'],
+    [/classif|categor|label/i, 'classification'],
+    [/search|query|retriev/i, 'search'],
+    [/translat/i, 'translation'],
+    [/chat|convers|dialog/i, 'chat'],
+    [/agent|tool|function.?call/i, 'agent'],
+    [/synthe[sz]/i, 'synthesis'],
+    [/chunk/i, 'chunking'],
+    [/ingest|scrape|crawl|fetch.*rss/i, 'ingestion'],
+    [/aggregat/i, 'aggregation'],
+    // Generic patterns last (these match many file names)
+    [/generat|produc/i, 'generation'],
+    [/fallback|retry|backup/i, 'fallback'],
+    [/validat|verif/i, 'validation'],
+    [/analyz|analys/i, 'analysis'],
+];
+// Directory-to-domain mapping for purpose inference
+const DIRECTORY_DOMAINS = [
+    [/\/search\//i, 'search'],
+    [/\/synthesis\//i, 'synthesis'],
+    [/\/knowledge-graph\//i, 'knowledge-graph'],
+    [/\/kg\//i, 'knowledge-graph'],
+    [/\/queue\//i, 'queue-processing'],
+    [/\/queues\//i, 'queue-processing'],
+    [/\/workers?\//i, 'worker'],
+    [/\/ai\//i, 'ai-core'],
+    [/\/llm\//i, 'ai-core'],
+    [/\/services\//i, 'service'],
+    [/\/adapters?\//i, 'adapter'],
+    [/\/ingestion\//i, 'ingestion'],
+    [/\/aggregation\//i, 'aggregation'],
+    [/\/analytics?\//i, 'analytics'],
+];
+function inferPurpose(functionName, fileName) {
+    // Layer 1: Check function name (strongest signal)
+    for (const [pattern, purpose] of PURPOSE_PATTERNS) {
+        if (pattern.test(functionName))
+            return purpose;
+    }
+    // Layer 2: Check file basename
+    const basename = fileName.split('/').pop()?.replace(/\.[^.]+$/, '') || '';
+    for (const [pattern, purpose] of PURPOSE_PATTERNS) {
+        if (pattern.test(basename))
+            return purpose;
+    }
+    // Layer 3: Directory inference (domain-level grouping)
+    for (const [pattern, domain] of DIRECTORY_DOMAINS) {
+        if (pattern.test(fileName))
+            return domain;
+    }
+    return undefined;
+}
+/**
+ * Load feature annotations from .navgator/features.yaml if present.
+ * Returns a map of file glob → feature name.
+ */
+export function loadFeatureAnnotations(projectRoot) {
+    const featuresPath = path.join(projectRoot, '.navgator', 'features.yaml');
+    try {
+        const content = fs.readFileSync(featuresPath, 'utf-8');
+        const features = new Map();
+        // Simple YAML parser for our format:
+        // feature-name:
+        //   files: [glob1, glob2]
+        let currentFeature = '';
+        let inFiles = false;
+        for (const line of content.split('\n')) {
+            const featureMatch = line.match(/^(\S+):\s*$/);
+            if (featureMatch) {
+                currentFeature = featureMatch[1];
+                inFiles = false;
+                continue;
+            }
+            if (line.trim() === 'files:' || line.trim().startsWith('files:')) {
+                inFiles = true;
+                // Check inline: files: [glob1, glob2]
+                const inlineMatch = line.match(/files:\s*\[([^\]]+)\]/);
+                if (inlineMatch) {
+                    for (const glob of inlineMatch[1].split(',')) {
+                        features.set(glob.trim().replace(/['"]/g, ''), currentFeature);
+                    }
+                    inFiles = false;
+                }
+                continue;
+            }
+            if (inFiles && line.trim().startsWith('- ')) {
+                const glob = line.trim().slice(2).replace(/['"]/g, '').trim();
+                if (glob && currentFeature) {
+                    features.set(glob, currentFeature);
+                }
+            }
+            else if (inFiles && !line.trim().startsWith('-') && line.trim().length > 0) {
+                inFiles = false;
+            }
+        }
+        return features.size > 0 ? features : null;
+    }
+    catch {
+        return null; // No features.yaml
+    }
+}
+function parseDescriptionForCallType(description) {
+    if (!description)
+        return null;
+    // Common formats: "OpenAI.chat.completions.create (gpt-4)", "Groq.chat (llama-3.1-70b)"
+    const match = description.match(/\.(\w+(?:\.\w+)*?)(?:\s*\(([^)]+)\))?$/);
+    if (!match)
+        return null;
+    const method = match[1]; // e.g., "chat.completions.create" or "chat"
+    const model = match[2]?.trim();
+    if (!method)
+        return null;
+    return { method, model };
+}
+function mostCommonFile(conns) {
+    const counts = new Map();
+    for (const c of conns) {
+        const f = c.code_reference.file;
+        counts.set(f, (counts.get(f) || 0) + 1);
+    }
+    let best = '';
+    let bestCount = 0;
+    for (const [f, count] of counts) {
+        if (count > bestCount) {
+            best = f;
+            bestCount = count;
+        }
+    }
+    return best || conns[0]?.code_reference.file || 'unknown';
+}
+function fileBasename(filepath) {
+    const parts = filepath.split('/');
+    const file = parts[parts.length - 1] || filepath;
+    return file.replace(/\.[^.]+$/, ''); // strip extension
+}
+// =============================================================================
+// MAIN FUNCTION
+// =============================================================================
+export function deduplicateLLMUseCases(components, connections, prompts) {
+    // Step 1: Find LLM components
+    const llmComponents = components.filter(c => c.type === 'llm');
+    const llmIds = new Set(llmComponents.map(c => c.component_id));
+    const llmNameById = new Map(llmComponents.map(c => [c.component_id, c.name]));
+    const llmComponentById = new Map(llmComponents.map(c => [c.component_id, c]));
+    if (llmIds.size === 0) {
+        return { useCases: [], totalCallSites: 0, productionCallSites: 0, providers: [] };
+    }
+    // Step 2: Get all LLM connections
+    const allLLMConns = connections.filter(c => llmIds.has(c.to.component_id));
+    const totalCallSites = allLLMConns.length;
+    if (totalCallSites === 0) {
+        return { useCases: [], totalCallSites: 0, productionCallSites: 0, providers: llmComponents.map(c => c.name) };
+    }
+    // =========================================================================
+    // LAYER 1: Filter
+    // =========================================================================
+    // 1a. Remove test/dev-only/migration
+    let filtered = allLLMConns.filter(c => {
+        const cls = c.semantic?.classification;
+        return cls !== 'test' && cls !== 'dev-only' && cls !== 'migration';
+    });
+    // 1b. Remove import-only (import with no sibling call from same file+provider)
+    const hasCallFromFileProvider = new Set();
+    for (const c of filtered) {
+        if (c.code_reference.symbol_type !== 'import') {
+            hasCallFromFileProvider.add(`${c.code_reference.file}|${c.to.component_id}`);
+        }
+    }
+    filtered = filtered.filter(c => {
+        if (c.code_reference.symbol_type !== 'import')
+            return true;
+        // Keep import only if there's a sibling call from same file to same provider
+        return hasCallFromFileProvider.has(`${c.code_reference.file}|${c.to.component_id}`);
+    });
+    // 1c. Deduplicate same (file, symbol, target)
+    const seen = new Set();
+    filtered = filtered.filter(c => {
+        const key = `${c.code_reference.file}|${c.code_reference.symbol}|${c.to.component_id}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    const productionCallSites = filtered.length;
+    const groups = new Map();
+    // Step 1: Group all connections by their source file
+    for (const conn of filtered) {
+        const file = conn.code_reference.file;
+        if (!groups.has(file)) {
+            groups.set(file, {
+                name: '',
+                groupedBy: 'file',
+                providerIds: new Set(),
+                connections: [],
+            });
+        }
+        const group = groups.get(file);
+        group.providerIds.add(conn.to.component_id);
+        group.connections.push(conn);
+    }
+    // Step 2: Classify each file group — purpose + name
+    for (const [file, group] of groups) {
+        let purpose;
+        // Check prompt match
+        if (prompts && prompts.length > 0) {
+            const matchedPrompt = prompts.find(p => p.location.file === file || p.usedBy.some(u => u.file === file));
+            if (matchedPrompt) {
+                purpose = matchedPrompt.category && matchedPrompt.category !== 'unknown' ? matchedPrompt.category : undefined;
+                group.name = matchedPrompt.name;
+                if (purpose)
+                    group.groupedBy = 'prompt';
+            }
+        }
+        // Check meaningful function names in this group
+        if (!purpose) {
+            for (const conn of group.connections) {
+                if (isMeaningfulSymbol(conn.code_reference.symbol)) {
+                    const fnPurpose = inferPurpose(conn.code_reference.symbol, file);
+                    if (fnPurpose) {
+                        purpose = fnPurpose;
+                        group.name = conn.code_reference.symbol;
+                        group.groupedBy = 'function';
+                        break;
+                    }
+                }
+            }
+        }
+        // Basename + directory inference
+        if (!purpose) {
+            purpose = inferPurpose('', file);
+        }
+        // Set name from basename if still unnamed
+        if (!group.name) {
+            group.name = fileBasename(file);
+        }
+        group.category = purpose;
+    }
+    // =========================================================================
+    // BUILD RESULT
+    // =========================================================================
+    const useCases = [];
+    for (const group of groups.values()) {
+        // Resolve provider name — prefer actual LLM SDKs over observability wrappers
+        const OBSERVABILITY_PROVIDERS = new Set(['langsmith', 'datadog', 'opentelemetry', 'sentry']);
+        const providerCounts = new Map();
+        for (const pid of group.providerIds) {
+            providerCounts.set(pid, (providerCounts.get(pid) || 0) + 1);
+        }
+        let mainProviderId = '';
+        let maxCount = 0;
+        // First pass: find the best non-observability provider
+        let bestNonObsId = '';
+        let bestNonObsCount = 0;
+        for (const [pid, count] of providerCounts) {
+            const name = llmNameById.get(pid)?.toLowerCase() || '';
+            if (!OBSERVABILITY_PROVIDERS.has(name) && count > bestNonObsCount) {
+                bestNonObsId = pid;
+                bestNonObsCount = count;
+            }
+        }
+        // Fall back to any provider if all are observability
+        if (!bestNonObsId) {
+            for (const [pid, count] of providerCounts) {
+                if (count > maxCount) {
+                    mainProviderId = pid;
+                    maxCount = count;
+                }
+            }
+        }
+        else {
+            mainProviderId = bestNonObsId;
+        }
+        const providerName = llmNameById.get(mainProviderId) || 'unknown';
+        const providerComponent = llmComponentById.get(mainProviderId);
+        const providerTag = providerComponent?.metadata?.provider;
+        const kind = providerComponent?.metadata?.kind;
+        const structuredOutputRaw = providerComponent?.metadata?.generable_schemas;
+        const structuredOutput = structuredOutputRaw && structuredOutputRaw.length > 0 ? structuredOutputRaw : undefined;
+        // Find what the LLM call's file connects to downstream (for agent classification)
+        const primaryFileId = `FILE:${mostCommonFile(group.connections)}`;
+        const downstream = connections
+            .filter(c => c.from.component_id === primaryFileId && !llmIds.has(c.to.component_id))
+            .map(c => {
+            const target = components.find(comp => comp.component_id === c.to.component_id);
+            return target ? `${target.name} (${target.type})` : c.to.component_id;
+        })
+            .filter((v, i, a) => a.indexOf(v) === i) // deduplicate
+            .slice(0, 5); // limit to 5
+        useCases.push({
+            name: group.name,
+            category: group.category,
+            provider: providerName,
+            model: group.model,
+            primaryFile: mostCommonFile(group.connections),
+            callSites: group.connections.length,
+            productionCallSites: group.connections.length,
+            groupedBy: group.groupedBy,
+            feedsInto: downstream.length > 0 ? downstream : undefined,
+            providerTag,
+            kind,
+            structuredOutput,
+        });
+    }
+    // Final pass: re-classify any use case without a category by checking its primary file
+    for (const uc of useCases) {
+        if (!uc.category) {
+            const purpose = inferPurpose('', uc.primaryFile);
+            if (purpose) {
+                uc.category = purpose;
+                if (uc.name.includes('(uncategorized)')) {
+                    uc.name = `${uc.provider} ${purpose}`;
+                }
+            }
+        }
+    }
+    // Sort by productionCallSites descending
+    useCases.sort((a, b) => b.productionCallSites - a.productionCallSites);
+    // Collect unique provider names
+    const providers = [...new Set(useCases.map(u => u.provider))].filter(p => p !== 'unknown');
+    return { useCases, totalCallSites, productionCallSites, providers };
+}
+//# sourceMappingURL=llm-dedup.js.map

package/dist/llm-dedup.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * NavGator MCP Server
+ *
+ * JSON-RPC 2.0 over stdio (MCP protocol).
+ * Exposes architecture analysis tools: scan, status, impact, connections, diagram, trace, summary.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/mcp/server.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * NavGator MCP Server
+ *
+ * JSON-RPC 2.0 over stdio (MCP protocol).
+ * Exposes architecture analysis tools: scan, status, impact, connections, diagram, trace, summary.
+ */
+import { createInterface } from "readline";
+import { TOOLS, handleToolCall } from "./tools.js";
+import { NAVGATOR_VERSION } from "../version.js";
+// --- Lifecycle contract (mcp-lifecycle v1) ---
+// See the mcp-lifecycle v1 SPEC (docs/standards/mcp-lifecycle/SPEC.md in the standards repo).
+// A stdio server that exits only on stdin EOF leaks unboundedly under a host that keeps
+// the pipe write-end open (parent alive, no traffic, no signal — indistinguishable from a
+// quiet-but-live session). Four independent exit paths close that gap:
+//   L1 stdin EOF               — already the default Node readline behaviour, unchanged below.
+//   L2 SIGTERM/SIGINT/SIGHUP   — exit 0 (not the default-disposition death) within 2s.
+//   L3 ppid watchdog           — poll every 5s; ppid becoming 1 means the host died. exit 0.
+//   L4 idle timeout            — no inbound frame for MCP_IDLE_TIMEOUT_MS. exit 0.
+// L4's default is 0 (disabled). This host does not respawn a stdio MCP server once it exits —
+// its tools deregister for the rest of the session — so a non-zero default would silently strip
+// tools from any conversation that went quiet. L4 is always implemented; it activates only when
+// an operator sets MCP_IDLE_TIMEOUT_MS for a deployment known to reuse servers across sessions.
+// No host detection: every layer here is unconditional.
+function shutdown(reason) {
+    process.stderr.write(`NavGator MCP server: exiting (${reason})\n`);
+    // "Flush" is nominal on every exit path here, per SPEC.md — all four fire only when the
+    // connection is quiescent (peer gone, host tearing down, parent dead, or no traffic at all),
+    // so there is never a response in flight with a reader waiting on it.
+    process.exit(0);
+}
+// --- L2: termination signals ---
+for (const sig of ["SIGTERM", "SIGINT", "SIGHUP"]) {
+    process.on(sig, () => shutdown(sig));
+}
+// --- L3: parent-death watchdog (poll every 5s; ppid 1 means reparented to init/launchd) ---
+const ppidWatchdog = setInterval(() => {
+    if (process.ppid === 1)
+        shutdown("parent died (ppid=1)");
+}, 5000);
+ppidWatchdog.unref(); // never hold the event loop open on its own
+// --- L4: idle timeout, disabled unless MCP_IDLE_TIMEOUT_MS is a positive number ---
+const IDLE_TIMEOUT_MS = (() => {
+    const raw = process.env.MCP_IDLE_TIMEOUT_MS;
+    if (!raw)
+        return 0;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : 0;
+})();
+let idleTimer = null;
+function markActivity() {
+    if (IDLE_TIMEOUT_MS <= 0)
+        return; // disabled by default — see header comment
+    if (idleTimer)
+        clearTimeout(idleTimer);
+    idleTimer = setTimeout(() => shutdown(`idle for ${IDLE_TIMEOUT_MS}ms`), IDLE_TIMEOUT_MS);
+    idleTimer.unref(); // never hold the event loop open on its own
+}
+markActivity(); // start the clock at boot too, in case no frame ever arrives
+// --- JSON-RPC transport over stdio ---
+const rl = createInterface({ input: process.stdin, terminal: false });
+// Track concurrent frames so EOF drains responses without making a long scan
+// block lightweight protocol traffic such as tools/list. The bounded drain
+// preserves the lifecycle guarantee even if a tool never settles.
+const inflight = new Set();
+const EOF_DRAIN_TIMEOUT_MS = 30_000;
+rl.on("close", () => {
+    const drain = Promise.allSettled([...inflight]);
+    const timeout = new Promise(resolve => {
+        setTimeout(resolve, EOF_DRAIN_TIMEOUT_MS);
+    });
+    void Promise.race([drain, timeout]).then(() => shutdown("stdin EOF"));
+});
+rl.on("line", (line) => {
+    markActivity(); // last inbound JSON-RPC frame, per L4
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    try {
+        const msg = JSON.parse(trimmed);
+        let task;
+        task = handleMessage(msg).finally(() => inflight.delete(task));
+        inflight.add(task);
+    }
+    catch {
+        // Each line should be one complete JSON-RPC message.
+        // Log malformed lines to stderr and move on — don't accumulate.
+        process.stderr.write(`NavGator: malformed JSON-RPC line: ${trimmed.slice(0, 200)}\n`);
+    }
+});
+function send(msg) {
+    process.stdout.write(JSON.stringify(msg) + "\n");
+}
+function sendResult(id, result) {
+    send({ jsonrpc: "2.0", id, result });
+}
+function sendError(id, code, message) {
+    send({ jsonrpc: "2.0", id, error: { code, message } });
+}
+// --- MCP Protocol ---
+const SERVER_INFO = {
+    name: "navgator",
+    version: NAVGATOR_VERSION,
+};
+const CAPABILITIES = {
+    tools: {},
+};
+// --- Message handler ---
+async function handleMessage(msg) {
+    if (msg.jsonrpc !== "2.0")
+        return;
+    const { id, method, params } = msg;
+    try {
+        switch (method) {
+            case "initialize": {
+                sendResult(id, {
+                    protocolVersion: "2025-11-25",
+                    serverInfo: SERVER_INFO,
+                    capabilities: CAPABILITIES,
+                });
+                break;
+            }
+            case "notifications/initialized": {
+                // Client acknowledged — no response needed
+                break;
+            }
+            case "tools/list": {
+                sendResult(id, { tools: TOOLS });
+                break;
+            }
+            case "tools/call": {
+                const { name, arguments: args } = params;
+                const result = await handleToolCall(name, args || {});
+                sendResult(id, result);
+                break;
+            }
+            default: {
+                if (id !== undefined) {
+                    sendError(id, -32601, `Method not found: ${method}`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        if (id !== undefined) {
+            sendError(id, -32000, err instanceof Error ? err.message : "Internal error");
+        }
+    }
+}
+// Log to stderr so it doesn't interfere with the protocol
+process.stderr.write("NavGator MCP server started\n");
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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