@n-dx/core 0.1.0

package/packages/sourcevision/dist/analyzers/enrich-per-zone.js

@@ -0,0 +1,287 @@
+/**
+ * Per-zone AI enrichment — enriches each zone individually instead of batching.
+ *
+ * Benefits:
+ * - Smaller context per call → cheaper, faster, more focused
+ * - Incremental: change one file → re-enrich only its zone
+ * - Parallelizable: enrich multiple zones concurrently
+ */
+import { createHash } from "node:crypto";
+import { MAX_CONCURRENT_ZONES, PER_ZONE_MAX_FILES, getPassConfig, computePerZoneAttemptConfigs, } from "./enrich-config.js";
+import { callClaude, ClaudeClientError } from "./claude-client.js";
+import { tryParseJSON, extractFindings, deduplicateZoneIds } from "./enrich-parsing.js";
+import { emptyAnalyzeTokenUsage } from "./token-usage.js";
+import { startSpinner } from "../cli/output.js";
+// ── Per-zone structure hash ──────────────────────────────────────────────────
+/** Compute a hash of a single zone's file list for change detection. */
+export function computeZoneStructureHash(zone) {
+    const data = [...zone.files].sort().join("\n");
+    return createHash("sha256").update(data).digest("hex").slice(0, 16);
+}
+/**
+ * Enrich a single zone with the active LLM vendor.
+ * Sends only this zone's files + entry points + boundary crossings.
+ * Includes 1-line summaries of other zones for context.
+ */
+async function enrichSingleZone(zone, allZones, crossings, inventory, passNumber, passConfig, previousZone, fileArchetypes, hints) {
+    const ATTEMPT_CONFIGS = computePerZoneAttemptConfigs(zone.files.length, passNumber);
+    const isFirstPass = passNumber === 1;
+    const zoneTokenUsage = { calls: 0, input: 0, output: 0 };
+    // Build 1-line summaries of OTHER zones for context
+    const otherSummaries = allZones
+        .filter((z) => z.id !== zone.id)
+        .map((z) => `"${z.name}" (${z.files.length} files, cohesion: ${z.cohesion})`)
+        .join("; ");
+    const otherContext = otherSummaries
+        ? `\nOther zones in this codebase: ${otherSummaries}`
+        : "";
+    // Boundary crossings for this zone
+    const zoneCrossings = crossings.filter((c) => c.fromZone === zone.id || c.toZone === zone.id);
+    const crossingSummary = new Map();
+    for (const c of zoneCrossings) {
+        const key = c.fromZone === zone.id
+            ? `${zone.id} → ${c.toZone}`
+            : `${c.fromZone} → ${zone.id}`;
+        crossingSummary.set(key, (crossingSummary.get(key) ?? 0) + 1);
+    }
+    const sortedCrossings = [...crossingSummary.entries()]
+        .sort((a, b) => b[1] - a[1]);
+    for (let attempt = 0; attempt < ATTEMPT_CONFIGS.length; attempt++) {
+        const config = ATTEMPT_CONFIGS[attempt];
+        const crossingLines = sortedCrossings
+            .slice(0, config.maxCrossings)
+            .map(([pair, count]) => `  ${pair}: ${count} imports`)
+            .join("\n");
+        let prompt;
+        if (isFirstPass) {
+            const filesSample = zone.files.length > config.maxFiles + 2
+                ? [...zone.files.slice(0, config.maxFiles), `... and ${zone.files.length - config.maxFiles} more`]
+                : zone.files;
+            const entryLine = config.maxFiles >= 8
+                ? `\nEntry points: ${zone.entryPoints.map((f) => `"${f}"`).join(", ") || "none"}`
+                : "";
+            prompt = `Analyze this code zone. It was discovered by import-graph community detection.
+
+${passConfig.focus}
+
+Zone: "${zone.id}" (cohesion: ${zone.cohesion}, coupling: ${zone.coupling}, ${zone.files.length} files)
+Files: ${filesSample.map((f) => { const a = fileArchetypes?.get(f); return a ? `"${f}" [${a}]` : `"${f}"`; }).join(", ")}${entryLine}
+${otherContext}
+${hints ? `\nProject context from the developer:\n${hints}\n` : ""}
+Boundary crossings:
+${crossingLines || "  (none)"}
+
+Each finding MUST include a "severity" field: "info" (informational), "warning" (should fix), or "critical" (must fix).
+
+Respond with ONLY a JSON object (no markdown, no explanation):
+{"id":"kebab-case-id","name":"Title Case Name","description":"One sentence describing the zone's purpose.","insights":["actionable insight about this zone"],"findings":[{"type":"observation","scope":"${zone.id}","text":"finding text","severity":"info"}]}
+
+Use finding types: ${passConfig.expectedTypes.join(", ")}.`;
+        }
+        else {
+            // Pass 2+: only new insights
+            const prevInsights = previousZone?.insights ?? [];
+            const filesSample = zone.files.length > config.maxFiles + 2
+                ? [...zone.files.slice(0, config.maxFiles), `... and ${zone.files.length - config.maxFiles} more`]
+                : zone.files;
+            const maxInsights = config.maxFiles >= 8 ? prevInsights.length : Math.min(prevInsights.length, 3);
+            prompt = `You previously analyzed this zone. Here is the current state:
+
+Zone: "${zone.id}" (cohesion: ${zone.cohesion}, coupling: ${zone.coupling}, ${zone.files.length} files)
+Files: ${filesSample.map((f) => { const a = fileArchetypes?.get(f); return a ? `"${f}" [${a}]` : `"${f}"`; }).join(", ")}
+Known insights: ${prevInsights.slice(0, maxInsights).length > 0 ? prevInsights.slice(0, maxInsights).map((i) => `"${i}"`).join("; ") : "(none)"}
+${otherContext}
+${hints ? `\nProject context from the developer:\n${hints}\n` : ""}
+Boundary crossings:
+${crossingLines || "  (none)"}
+
+This is enrichment pass ${passNumber}. ${passConfig.focus}
+
+Add ONLY NEW insights not already captured above. Do not repeat or rephrase existing observations.
+
+Each finding MUST include a "severity" field: "info" (informational), "warning" (should fix), or "critical" (must fix).
+
+Respond with ONLY a JSON object:
+{"id":"${zone.id}","newInsights":["new insight"],"findings":[{"type":"${passConfig.expectedTypes[0]}","scope":"${zone.id}","text":"finding text","severity":"info"}]}
+
+Use finding types: ${passConfig.expectedTypes.join(", ")}. Empty arrays are fine if nothing new to add.`;
+        }
+        const promptLevel = config.maxFiles >= PER_ZONE_MAX_FILES ? "full" : config.maxFiles >= 8 ? "medium" : "minimal";
+        console.log(`  [enrich] Zone "${zone.id}" (attempt ${attempt + 1}/${ATTEMPT_CONFIGS.length}, ${promptLevel} prompt)...`);
+        let callText;
+        try {
+            const callResult = await callClaude(prompt);
+            zoneTokenUsage.calls++;
+            if (callResult.tokenUsage) {
+                zoneTokenUsage.input += callResult.tokenUsage.input;
+                zoneTokenUsage.output += callResult.tokenUsage.output;
+            }
+            callText = callResult.text;
+        }
+        catch (err) {
+            if (err instanceof ClaudeClientError) {
+                zoneTokenUsage.calls++;
+                if (err.reason === "auth" || err.reason === "not-found") {
+                    console.warn(`  [enrich] ${err.reason === "auth" ? "Authentication error — run 'ndx config' and verify vendor credentials" : "LLM CLI not found"}`);
+                    return { zone, newInsights: [], newFindings: [], tokenUsage: zoneTokenUsage, success: false };
+                }
+                const label = attempt < ATTEMPT_CONFIGS.length - 1 ? "retrying" : "giving up";
+                console.warn(`  [enrich] Zone "${zone.id}" attempt ${attempt + 1} failed (${err.reason}) — ${label}`);
+                continue;
+            }
+            throw err;
+        }
+        const candidate = tryParseJSON(callText);
+        if (!candidate) {
+            const label = attempt < ATTEMPT_CONFIGS.length - 1 ? "retrying" : "giving up";
+            console.warn(`  [enrich] Zone "${zone.id}" attempt ${attempt + 1}: invalid JSON — ${label}`);
+            continue;
+        }
+        // Apply result
+        if (isFirstPass) {
+            if (typeof candidate.id !== "string" || typeof candidate.name !== "string" || typeof candidate.description !== "string") {
+                const label = attempt < ATTEMPT_CONFIGS.length - 1 ? "retrying" : "giving up";
+                console.warn(`  [enrich] Zone "${zone.id}" attempt ${attempt + 1}: missing id/name/description — ${label}`);
+                continue;
+            }
+            const newInsights = Array.isArray(candidate.insights)
+                ? candidate.insights.filter((s) => typeof s === "string")
+                : [];
+            const newFindings = extractFindings({ zones: [candidate], findings: candidate.findings ?? [] }, passNumber, passConfig.expectedTypes);
+            const enrichedZone = {
+                ...zone,
+                id: candidate.id,
+                name: candidate.name,
+                description: candidate.description,
+            };
+            return { zone: enrichedZone, newInsights, newFindings, tokenUsage: zoneTokenUsage, success: true };
+        }
+        else {
+            // Pass 2+
+            const newInsights = Array.isArray(candidate.newInsights)
+                ? candidate.newInsights.filter((s) => typeof s === "string")
+                : [];
+            const newFindings = extractFindings({ zones: [candidate], findings: candidate.findings ?? [] }, passNumber, passConfig.expectedTypes);
+            return { zone, newInsights, newFindings, tokenUsage: zoneTokenUsage, success: true };
+        }
+    }
+    console.warn(`  [enrich] Zone "${zone.id}" all attempts exhausted — keeping algorithmic data`);
+    return { zone, newInsights: [], newFindings: [], tokenUsage: zoneTokenUsage, success: false };
+}
+/**
+ * Enrich zones using per-zone mode.
+ * Each zone is enriched individually, allowing:
+ * - Smaller context per call
+ * - Incremental enrichment (only re-enrich zones whose structure changed)
+ * - Concurrent processing
+ */
+export async function enrichZonesPerZone(zones, crossings, inventory, imports, previousZones, fileArchetypes, hints) {
+    const prevEnrichPass = previousZones?.enrichmentPass ?? 0;
+    const passNumber = prevEnrichPass + 1;
+    const isFirstPass = passNumber === 1;
+    const passConfig = getPassConfig(passNumber, (previousZones?.findings ?? []).length);
+    const empty = {
+        zones,
+        newZoneInsights: new Map(),
+        newGlobalInsights: [],
+        newFindings: [],
+        pass: previousZones?.enrichmentPass ?? 0,
+    };
+    // Compute per-zone structure hashes
+    const zoneHashes = new Map();
+    for (const zone of zones) {
+        zoneHashes.set(zone.id, computeZoneStructureHash(zone));
+    }
+    // Determine which zones need enrichment
+    const zonesToEnrich = [];
+    const unchangedZones = [];
+    for (const zone of zones) {
+        const hash = zoneHashes.get(zone.id);
+        const prevZone = previousZones?.zones.find((p) => p.files.length > 0 && p.files.some((f) => zone.files.includes(f)));
+        // Skip if structure unchanged and already enriched
+        if (prevZone?.structureHash === hash && prevEnrichPass > 0) {
+            unchangedZones.push({
+                ...zone,
+                id: prevZone.id,
+                name: prevZone.name,
+                description: prevZone.description,
+                insights: prevZone.insights,
+                structureHash: hash,
+                tokenUsage: prevZone.tokenUsage,
+            });
+        }
+        else {
+            zonesToEnrich.push(zone);
+        }
+    }
+    if (zonesToEnrich.length === 0) {
+        console.log(`  [enrich] All ${zones.length} zones unchanged — skipping enrichment`);
+        return {
+            zones: unchangedZones,
+            newZoneInsights: new Map(),
+            newGlobalInsights: [],
+            newFindings: [],
+            pass: prevEnrichPass,
+        };
+    }
+    console.log(`  [enrich] Per-zone mode: ${zonesToEnrich.length} zones to enrich (${unchangedZones.length} unchanged)`);
+    // Process zones with limited concurrency
+    const totalTokenUsage = emptyAnalyzeTokenUsage();
+    const results = [];
+    const totalBatches = Math.ceil(zonesToEnrich.length / MAX_CONCURRENT_ZONES);
+    // Process in batches of MAX_CONCURRENT_ZONES
+    for (let i = 0; i < zonesToEnrich.length; i += MAX_CONCURRENT_ZONES) {
+        const batch = zonesToEnrich.slice(i, i + MAX_CONCURRENT_ZONES);
+        const batchIndex = Math.floor(i / MAX_CONCURRENT_ZONES);
+        const batchLabel = totalBatches > 1 ? ` batch ${batchIndex + 1}/${totalBatches}` : "";
+        const spinner = startSpinner(`  [enrich] Enriching ${batch.length} zone${batch.length === 1 ? "" : "s"}${batchLabel}...`);
+        let batchResults;
+        try {
+            batchResults = await Promise.all(batch.map((zone) => {
+                const prevZone = previousZones?.zones.find((p) => p.files.length > 0 && p.files.some((f) => zone.files.includes(f)));
+                return enrichSingleZone(zone, zones, crossings, inventory, passNumber, passConfig, prevZone, fileArchetypes, hints);
+            }));
+        }
+        finally {
+            spinner.stop();
+        }
+        results.push(...batchResults);
+    }
+    // Aggregate results
+    const enrichedZones = [];
+    const newZoneInsights = new Map();
+    const allNewFindings = [];
+    for (const result of results) {
+        const hash = zoneHashes.get(result.zone.id) ?? computeZoneStructureHash(result.zone);
+        const enrichedZone = {
+            ...result.zone,
+            structureHash: hash,
+            tokenUsage: result.tokenUsage,
+        };
+        enrichedZones.push(enrichedZone);
+        newZoneInsights.set(enrichedZone.id, result.newInsights);
+        allNewFindings.push(...result.newFindings);
+        // Accumulate token usage
+        totalTokenUsage.calls += result.tokenUsage.calls;
+        totalTokenUsage.inputTokens += result.tokenUsage.input;
+        totalTokenUsage.outputTokens += result.tokenUsage.output;
+    }
+    // Combine enriched + unchanged zones
+    const allZones = [...enrichedZones, ...unchangedZones];
+    deduplicateZoneIds(allZones);
+    // Any failures?
+    const anySuccess = results.some((r) => r.success);
+    if (!anySuccess) {
+        console.warn("  [enrich] All zones failed enrichment — using algorithmic data");
+        return empty;
+    }
+    return {
+        zones: allZones,
+        newZoneInsights,
+        newGlobalInsights: [], // Per-zone mode doesn't produce global insights on its own
+        newFindings: allNewFindings,
+        pass: passNumber,
+        tokenUsage: totalTokenUsage,
+    };
+}
+//# sourceMappingURL=enrich-per-zone.js.map

package/packages/sourcevision/dist/analyzers/enrich-per-zone.js.map

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

package/packages/sourcevision/dist/analyzers/enrich.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AI enrichment for zone analysis.
+ * Orchestrator — delegates to enrich-config, enrich-batch, claude-client, and enrich-parsing.
+ */
+export { PASS_CONFIGS, getPassConfig, buildMetaPrompt, computeAttemptConfigs, computePerZoneAttemptConfigs, MAX_CONCURRENT_ZONES, PER_ZONE_MAX_FILES, PER_ZONE_MAX_CROSSINGS } from "./enrich-config.js";
+export type { PassConfig } from "./enrich-config.js";
+export { callClaude, callLLM, setClaudeConfig, setLLMConfig, setClaudeClient, setLLMClient, getAuthMode, getLLMVendor, ClaudeClientError, DEFAULT_MODEL, DEFAULT_CODEX_MODEL, } from "./claude-client.js";
+export type { CallClaudeResult } from "./claude-client.js";
+export { tryParseJSON, extractFindings, mergeZonesByName, deduplicateFindings } from "./enrich-parsing.js";
+export type { EnrichResult } from "./enrich-parsing.js";
+export { emptyAnalyzeTokenUsage, accumulateTokenUsage, formatTokenUsage } from "./token-usage.js";
+export { enrichZonesPerZone, computeZoneStructureHash } from "./enrich-per-zone.js";
+export type { PerZoneEnrichResult } from "./enrich-per-zone.js";
+import type { Inventory, Imports, Zone, ZoneCrossing, Zones } from "../schema/index.js";
+import type { EnrichResult } from "./enrich-parsing.js";
+/**
+ * Enrich zones using the Claude CLI with iterative deepening.
+ * Pass 1: names, describes, and provides initial insights.
+ * Pass 2+: adds deeper insights, preserving previous naming.
+ *
+ * Zones are processed in batches of ZONES_PER_BATCH to avoid timeout
+ * on larger codebases. If a batch fails, previously-completed batches
+ * are preserved. For <= ZONES_PER_BATCH zones, uses a single-batch fast path.
+ */
+export declare function enrichZonesWithAI(zones: Zone[], crossings: ZoneCrossing[], inventory: Inventory, imports: Imports, previousZones?: Zones, fileArchetypes?: Map<string, string | null>, currentContentHashes?: Record<string, string>, hints?: string): Promise<EnrichResult>;

package/packages/sourcevision/dist/analyzers/enrich.js

@@ -0,0 +1,255 @@
+/**
+ * AI enrichment for zone analysis.
+ * Orchestrator — delegates to enrich-config, enrich-batch, claude-client, and enrich-parsing.
+ */
+// ── Barrel re-exports (keep consumers' imports stable) ───────────────────────
+export { PASS_CONFIGS, getPassConfig, buildMetaPrompt, computeAttemptConfigs, computePerZoneAttemptConfigs, MAX_CONCURRENT_ZONES, PER_ZONE_MAX_FILES, PER_ZONE_MAX_CROSSINGS } from "./enrich-config.js";
+export { callClaude, callLLM, setClaudeConfig, setLLMConfig, setClaudeClient, setLLMClient, getAuthMode, getLLMVendor, ClaudeClientError, DEFAULT_MODEL, DEFAULT_CODEX_MODEL, } from "./claude-client.js";
+export { tryParseJSON, extractFindings, mergeZonesByName, deduplicateFindings } from "./enrich-parsing.js";
+export { emptyAnalyzeTokenUsage, accumulateTokenUsage, formatTokenUsage } from "./token-usage.js";
+export { enrichZonesPerZone, computeZoneStructureHash } from "./enrich-per-zone.js";
+import { ZONES_PER_BATCH, getPassConfig, } from "./enrich-config.js";
+import { computeGlobalContentHash } from "./zone-hash.js";
+import { extractFindings, mergeZonesByName, deduplicateZoneIds } from "./enrich-parsing.js";
+import { enrichBatch, runMetaEvaluation, aggregateBatchResults, } from "./enrich-batch.js";
+// ── Public entry point ───────────────────────────────────────────────────────
+/**
+ * Enrich zones using the Claude CLI with iterative deepening.
+ * Pass 1: names, describes, and provides initial insights.
+ * Pass 2+: adds deeper insights, preserving previous naming.
+ *
+ * Zones are processed in batches of ZONES_PER_BATCH to avoid timeout
+ * on larger codebases. If a batch fails, previously-completed batches
+ * are preserved. For <= ZONES_PER_BATCH zones, uses a single-batch fast path.
+ */
+export async function enrichZonesWithAI(zones, crossings, inventory, imports, previousZones, fileArchetypes, currentContentHashes, hints) {
+    const prevEnrichPass = previousZones?.enrichmentPass ?? 0;
+    const passNumber = prevEnrichPass + 1;
+    const isFirstPass = passNumber === 1;
+    const isMetaPass = passNumber >= 5;
+    const existingFindings = previousZones?.findings ?? [];
+    const passConfig = getPassConfig(passNumber, existingFindings.length);
+    const empty = {
+        zones,
+        newZoneInsights: new Map(),
+        newGlobalInsights: [],
+        newFindings: [],
+        pass: previousZones?.enrichmentPass ?? 0,
+    };
+    // 0. Content-hash skip: if nothing changed since last enrichment, skip entirely
+    if (currentContentHashes && previousZones?.zoneContentHashes && prevEnrichPass > 0) {
+        const prevGlobalHash = computeGlobalContentHash(previousZones.zoneContentHashes);
+        const curGlobalHash = computeGlobalContentHash(currentContentHashes);
+        if (prevGlobalHash === curGlobalHash && passNumber <= prevEnrichPass) {
+            console.log(`  [enrich] Content unchanged — skipping enrichment (pass ${prevEnrichPass} preserved)`);
+            // Preserve previous names/descriptions on current zones
+            const prevZones = previousZones.zones;
+            const preserved = zones.map((zone) => {
+                const prev = prevZones.find((p) => p.files.length > 0 && p.files.some((f) => zone.files.includes(f)));
+                if (prev) {
+                    return { ...zone, id: prev.id, name: prev.name, description: prev.description };
+                }
+                return zone;
+            });
+            return {
+                zones: preserved,
+                newZoneInsights: new Map(),
+                newGlobalInsights: [],
+                newFindings: [],
+                pass: prevEnrichPass,
+            };
+        }
+    }
+    // 1. Meta-evaluation path (pass 5+) — single prompt, no batching
+    if (isMetaPass && existingFindings.length > 0) {
+        const metaResult = await runMetaEvaluation(zones, existingFindings, crossings, passNumber, passConfig, hints);
+        if (!metaResult)
+            return empty;
+        return {
+            zones,
+            newZoneInsights: metaResult.newZoneInsights,
+            newGlobalInsights: metaResult.newGlobalInsights,
+            newFindings: metaResult.newFindings,
+            pass: passNumber,
+            _updatedFindings: metaResult.updatedFindings,
+            tokenUsage: metaResult.tokenUsage,
+        };
+    }
+    // 2. Per-zone content filtering: identify changed vs unchanged zones
+    //    Only applies when we have previous data and per-zone content hashes.
+    //    Unchanged zones preserve previous enrichment; only changed zones go to LLM.
+    let zonesToEnrich = zones;
+    let unchangedZones = [];
+    if (currentContentHashes && previousZones?.zoneContentHashes && passNumber <= prevEnrichPass) {
+        const changed = [];
+        const unchanged = [];
+        for (const zone of zones) {
+            if (currentContentHashes[zone.id] !== previousZones.zoneContentHashes[zone.id]) {
+                changed.push(zone);
+            }
+            else {
+                const prev = previousZones.zones.find((p) => p.files.length > 0 && p.files.some((f) => zone.files.includes(f)));
+                if (prev) {
+                    unchanged.push({
+                        ...zone,
+                        id: prev.id,
+                        name: prev.name,
+                        description: prev.description,
+                    });
+                }
+                else {
+                    changed.push(zone);
+                }
+            }
+        }
+        if (changed.length < zones.length) {
+            console.log(`  [enrich] ${changed.length}/${zones.length} zones changed — skipping ${unchanged.length} unchanged`);
+            zonesToEnrich = changed;
+            unchangedZones = unchanged;
+        }
+    }
+    // 3. Build cross-zone summary (shared across all batches — includes ALL zones for context)
+    const crossingSummary = new Map();
+    for (const c of crossings) {
+        const key = `${c.fromZone} \u2192 ${c.toZone}`;
+        crossingSummary.set(key, (crossingSummary.get(key) ?? 0) + 1);
+    }
+    const sortedCrossingsArr = [...crossingSummary.entries()]
+        .sort((a, b) => b[1] - a[1]);
+    // 4. Split changed zones into batches
+    const batches = [];
+    for (let i = 0; i < zonesToEnrich.length; i += ZONES_PER_BATCH) {
+        batches.push(zonesToEnrich.slice(i, i + ZONES_PER_BATCH));
+    }
+    if (batches.length > 1) {
+        console.log(`  [enrich] Processing ${zonesToEnrich.length} zones in ${batches.length} batches of up to ${ZONES_PER_BATCH}`);
+    }
+    // 5. Process batches sequentially, feeding enriched names forward
+    const allBatchResults = [];
+    const enrichedNames = new Map();
+    let authFailed = false;
+    for (let bi = 0; bi < batches.length; bi++) {
+        if (authFailed)
+            break;
+        try {
+            const result = await enrichBatch(batches[bi], zones, sortedCrossingsArr, passNumber, passConfig, previousZones, bi, batches.length, enrichedNames, fileArchetypes, hints);
+            if (result && "authError" in result) {
+                authFailed = true;
+            }
+            else if (result) {
+                allBatchResults.push(result);
+                // Track enriched names so subsequent batches can avoid duplicates
+                if (isFirstPass && Array.isArray(result.parsed.zones)) {
+                    for (const z of result.parsed.zones) {
+                        if (z?.algorithmicId && typeof z.name === "string") {
+                            enrichedNames.set(z.algorithmicId, z.name);
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.error(`  [enrich] batch ${bi + 1} rejected:`, err instanceof Error ? err.message : err);
+        }
+    }
+    if (allBatchResults.length === 0) {
+        if (authFailed) {
+            // auth error already logged upstream
+        }
+        else if (batches.length === 0 && unchangedZones.length > 0) {
+            // All zones preserved from previous enrichment — return them
+            return { ...empty, zones: unchangedZones, pass: prevEnrichPass };
+        }
+        else if (batches.length > 0) {
+            console.warn("  [enrich] All batches failed — using algorithmic names");
+        }
+        return empty;
+    }
+    // 6. Aggregate and apply results, merging unchanged zones back in
+    const agg = aggregateBatchResults(allBatchResults);
+    if (isFirstPass) {
+        const result = applyFirstPassResults(zonesToEnrich, agg, passConfig);
+        if (unchangedZones.length > 0) {
+            result.zones = [...result.zones, ...unchangedZones];
+        }
+        return result;
+    }
+    const result = applyLaterPassResults(zonesToEnrich, agg, passNumber, passConfig, previousZones);
+    if (unchangedZones.length > 0) {
+        result.zones = [...result.zones, ...unchangedZones];
+    }
+    return result;
+}
+// ── Result application (private) ─────────────────────────────────────────────
+/** Apply pass 1 results: rename zones, extract insights and findings. */
+function applyFirstPassResults(zones, agg, passConfig) {
+    const { allParsedZones, dedupedInsights, allParsedFindings, totalTokenUsage, successfulBatchIds } = agg;
+    const enrichedRaw = zones.map((zone) => {
+        if (!successfulBatchIds.has(zone.id))
+            return zone;
+        const e = allParsedZones.find((x) => x?.algorithmicId === zone.id);
+        if (!e ||
+            typeof e.id !== "string" ||
+            typeof e.name !== "string" ||
+            typeof e.description !== "string") {
+            return zone;
+        }
+        return { ...zone, id: e.id, name: e.name, description: e.description };
+    });
+    // Merge zones the LLM identified as semantically identical across batches
+    const enriched = mergeZonesByName(enrichedRaw);
+    if (enriched.length < enrichedRaw.length) {
+        console.log(`  [enrich] Merged ${enrichedRaw.length - enriched.length} duplicate zones (${enrichedRaw.length} → ${enriched.length})`);
+    }
+    deduplicateZoneIds(enriched);
+    const newZoneInsights = new Map();
+    for (const zone of enriched) {
+        const e = allParsedZones.find((x) => x?.algorithmicId === zone.id || x?.id === zone.id);
+        const aiInsights = Array.isArray(e?.insights)
+            ? e.insights.filter((s) => typeof s === "string")
+            : [];
+        newZoneInsights.set(zone.id, aiInsights);
+    }
+    const combinedParsed = { zones: allParsedZones, insights: dedupedInsights, findings: allParsedFindings };
+    const newFindings = extractFindings(combinedParsed, 1, passConfig.expectedTypes);
+    return {
+        zones: enriched,
+        newZoneInsights,
+        newGlobalInsights: dedupedInsights,
+        newFindings,
+        pass: 1,
+        tokenUsage: totalTokenUsage,
+    };
+}
+/** Apply pass 2+ results: preserve previous names, extract new insights. */
+function applyLaterPassResults(zones, agg, passNumber, passConfig, previousZones) {
+    const { allParsedZones, dedupedInsights, allParsedFindings, totalTokenUsage } = agg;
+    const prevZones = previousZones?.zones ?? [];
+    const enriched = zones.map((zone) => {
+        const prev = prevZones.find((p) => p.files.length > 0 && p.files.some((f) => zone.files.includes(f)));
+        if (prev) {
+            return { ...zone, id: prev.id, name: prev.name, description: prev.description };
+        }
+        return zone;
+    });
+    deduplicateZoneIds(enriched);
+    const newZoneInsights = new Map();
+    for (const zone of enriched) {
+        const entry = allParsedZones.find((n) => n?.id === zone.id);
+        const newInsights = Array.isArray(entry?.newInsights)
+            ? entry.newInsights.filter((s) => typeof s === "string")
+            : [];
+        newZoneInsights.set(zone.id, newInsights);
+    }
+    const combinedParsed = { zones: allParsedZones, insights: dedupedInsights, findings: allParsedFindings };
+    const newFindings = extractFindings(combinedParsed, passNumber, passConfig.expectedTypes);
+    return {
+        zones: enriched,
+        newZoneInsights,
+        newGlobalInsights: dedupedInsights,
+        newFindings,
+        pass: passNumber,
+        tokenUsage: totalTokenUsage,
+    };
+}
+//# sourceMappingURL=enrich.js.map

package/packages/sourcevision/dist/analyzers/enrich.js.map

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

package/packages/sourcevision/dist/analyzers/imports.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Deterministic import graph analyzer.
+ * Uses the TypeScript compiler API for AST parsing — no Claude invocation.
+ */
+import type { ImportType, Imports, Inventory } from "../schema/index.js";
+export interface RawImport {
+    specifier: string;
+    type: ImportType;
+    symbols: string[];
+}
+export declare function extractImports(sourceText: string, filePath: string): RawImport[];
+export declare function extractPackageName(specifier: string): string;
+export interface ImportsOptions {
+    previousImports?: Imports;
+    changedFiles?: Set<string>;
+    fileSetChanged?: boolean;
+}
+export declare function analyzeImports(targetDir: string, inventory: Inventory, options?: ImportsOptions): Promise<Imports>;