@n-dx/core 0.1.0

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

@@ -0,0 +1,58 @@
+/**
+ * JSON parsing and finding extraction for AI enrichment responses.
+ */
+import type { Zone, Finding, FindingType, AnalyzeTokenUsage } from "../schema/index.js";
+export declare function tryParseJSON(response: string): any | null;
+/**
+ * Extract findings from AI response. Handles both new `findings` format
+ * and legacy `insights` strings. Falls back to converting insights to findings.
+ */
+export declare function extractFindings(parsed: any, passNumber: number, expectedTypes: FindingType[]): Finding[];
+/**
+ * Merge zones that share the same LLM-assigned name.
+ * When the LLM recognizes zones across batches as semantically identical,
+ * it assigns the same name — this function combines their file lists,
+ * entry points, and insights into a single zone.
+ *
+ * Returns the deduplicated zone array (mutates nothing).
+ */
+export declare function mergeZonesByName(zones: Zone[]): Zone[];
+/**
+ * Enforce deterministic severity rules that the LLM can't override.
+ * Runs after findings are parsed to correct misclassified severities:
+ *
+ * - Positive/praise findings from LLM passes → downgrade to "info"
+ * - Test-coupling anti-patterns → downgrade to "info" (expected by design)
+ * - Pass 0 (deterministic heuristic) findings are never modified
+ */
+export declare function enforceSeverityRules(findings: Finding[]): Finding[];
+/**
+ * Deduplicate findings by detecting near-identical text within the same
+ * scope and type. When duplicates are found across different passes,
+ * the highest-severity version is kept.
+ *
+ * Matching is scoped to `(scope, type)` pairs — findings in different
+ * scopes or with different types are never merged.
+ *
+ * Uses bigram Dice similarity (threshold 0.8) for fuzzy text matching,
+ * with case-insensitive and whitespace-normalized comparison.
+ */
+export declare function deduplicateFindings(findings: Finding[]): Finding[];
+/** Ensure no two zones share the same ID (appends -2, -3, etc.) */
+export declare function deduplicateZoneIds(zones: Zone[]): void;
+export interface EnrichResult {
+    /** Zones with AI-assigned IDs/names/descriptions */
+    zones: Zone[];
+    /** Only the NEW per-zone AI insights from this pass */
+    newZoneInsights: Map<string, string[]>;
+    /** Only the NEW global AI insights from this pass */
+    newGlobalInsights: string[];
+    /** Structured findings from this pass */
+    newFindings: Finding[];
+    /** Pass number (1-based) */
+    pass: number;
+    /** Updated findings with reassessed severities from meta-evaluation */
+    _updatedFindings?: Finding[];
+    /** Aggregated token usage across all LLM calls in this enrichment */
+    tokenUsage?: AnalyzeTokenUsage;
+}

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

@@ -0,0 +1,401 @@
+/**
+ * JSON parsing and finding extraction for AI enrichment responses.
+ */
+// ── JSON parsing ─────────────────────────────────────────────────────────────
+export function tryParseJSON(response) {
+    // Direct parse
+    try {
+        const parsed = JSON.parse(response);
+        if (parsed && typeof parsed === "object")
+            return parsed;
+    }
+    catch { }
+    // Extract from markdown fences
+    const fenceMatch = response.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (fenceMatch) {
+        try {
+            const parsed = JSON.parse(fenceMatch[1].trim());
+            if (parsed && typeof parsed === "object")
+                return parsed;
+        }
+        catch { }
+    }
+    // Find largest JSON object in response
+    const objectMatch = response.match(/\{[\s\S]*\}/);
+    if (objectMatch) {
+        try {
+            const parsed = JSON.parse(objectMatch[0]);
+            if (parsed && typeof parsed === "object")
+                return parsed;
+        }
+        catch { }
+    }
+    // Find JSON array → wrap as {zones: [...]}
+    const arrayMatch = response.match(/\[[\s\S]*\]/);
+    if (arrayMatch) {
+        try {
+            const parsed = JSON.parse(arrayMatch[0]);
+            if (Array.isArray(parsed))
+                return { zones: parsed, insights: [] };
+        }
+        catch { }
+    }
+    return null;
+}
+// ── Finding extraction ───────────────────────────────────────────────────────
+/**
+ * Extract findings from AI response. Handles both new `findings` format
+ * and legacy `insights` strings. Falls back to converting insights to findings.
+ */
+export function extractFindings(parsed, passNumber, expectedTypes) {
+    const findings = [];
+    const defaultType = expectedTypes[0] ?? "observation";
+    const validTypes = ["observation", "pattern", "relationship", "anti-pattern", "suggestion"];
+    const validSeverities = ["info", "warning", "critical"];
+    const parseFinding = (f, fallbackScope) => {
+        if (f && typeof f === "object" && typeof f.text === "string") {
+            const type = validTypes.includes(f.type) ? f.type : defaultType;
+            findings.push({
+                type,
+                pass: passNumber,
+                scope: typeof f.scope === "string" ? f.scope : fallbackScope,
+                text: f.text,
+                ...(validSeverities.includes(f.severity) ? { severity: f.severity } : {}),
+                ...(Array.isArray(f.related) ? { related: f.related.filter((r) => typeof r === "string") } : {}),
+            });
+        }
+    };
+    // New format: parsed has a top-level "findings" array
+    if (Array.isArray(parsed.findings)) {
+        for (const f of parsed.findings)
+            parseFinding(f, "global");
+    }
+    // Also extract from per-zone findings in zones array
+    if (Array.isArray(parsed.zones)) {
+        for (const z of parsed.zones) {
+            if (!z || typeof z !== "object")
+                continue;
+            const zoneId = z.id ?? z.algorithmicId ?? "unknown";
+            if (Array.isArray(z.findings)) {
+                for (const f of z.findings)
+                    parseFinding(f, zoneId);
+            }
+        }
+    }
+    // Legacy fallback: convert insights strings to findings
+    if (findings.length === 0) {
+        // Global insights
+        if (Array.isArray(parsed.insights)) {
+            for (const s of parsed.insights) {
+                if (typeof s === "string") {
+                    findings.push({
+                        type: defaultType,
+                        pass: passNumber,
+                        scope: "global",
+                        text: s,
+                    });
+                }
+            }
+        }
+        // Per-zone insights
+        if (Array.isArray(parsed.zones)) {
+            for (const z of parsed.zones) {
+                if (!z || typeof z !== "object")
+                    continue;
+                const zoneId = z.id ?? z.algorithmicId ?? "unknown";
+                const insightsArr = z.insights ?? z.newInsights;
+                if (Array.isArray(insightsArr)) {
+                    for (const s of insightsArr) {
+                        if (typeof s === "string") {
+                            findings.push({
+                                type: defaultType,
+                                pass: passNumber,
+                                scope: zoneId,
+                                text: s,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return findings;
+}
+// ── Zone merging ─────────────────────────────────────────────────────────────
+/**
+ * Merge zones that share the same LLM-assigned name.
+ * When the LLM recognizes zones across batches as semantically identical,
+ * it assigns the same name — this function combines their file lists,
+ * entry points, and insights into a single zone.
+ *
+ * Returns the deduplicated zone array (mutates nothing).
+ */
+export function mergeZonesByName(zones) {
+    const byName = new Map();
+    for (const zone of zones) {
+        const key = zone.name.toLowerCase().trim();
+        const group = byName.get(key);
+        if (group) {
+            group.push(zone);
+        }
+        else {
+            byName.set(key, [zone]);
+        }
+    }
+    const merged = [];
+    for (const group of byName.values()) {
+        if (group.length === 1) {
+            merged.push(group[0]);
+            continue;
+        }
+        // Merge all zones in this group into one
+        const primary = group[0];
+        const allFiles = new Set(primary.files);
+        const allEntryPoints = new Set(primary.entryPoints);
+        const allInsights = [...(primary.insights ?? [])];
+        const seenInsights = new Set(allInsights);
+        for (let i = 1; i < group.length; i++) {
+            for (const f of group[i].files)
+                allFiles.add(f);
+            for (const ep of group[i].entryPoints)
+                allEntryPoints.add(ep);
+            for (const ins of group[i].insights ?? []) {
+                if (!seenInsights.has(ins)) {
+                    allInsights.push(ins);
+                    seenInsights.add(ins);
+                }
+            }
+        }
+        // Average cohesion/coupling weighted by file count
+        let totalFiles = 0;
+        let weightedCohesion = 0;
+        let weightedCoupling = 0;
+        for (const z of group) {
+            totalFiles += z.files.length;
+            weightedCohesion += z.cohesion * z.files.length;
+            weightedCoupling += z.coupling * z.files.length;
+        }
+        merged.push({
+            ...primary,
+            files: [...allFiles],
+            entryPoints: [...allEntryPoints],
+            cohesion: totalFiles > 0 ? Math.round((weightedCohesion / totalFiles) * 100) / 100 : primary.cohesion,
+            coupling: totalFiles > 0 ? Math.round((weightedCoupling / totalFiles) * 100) / 100 : primary.coupling,
+            insights: allInsights.length > 0 ? allInsights : undefined,
+        });
+    }
+    return merged;
+}
+// ── Programmatic severity enforcement ────────────────────────────────────────
+const POSITIVE_INDICATORS = [
+    "successfully", "exemplary", "masterful", "clean separation",
+    "well-defined", "well-isolated", "clean design", "good architecture",
+    "perfectly maintained", "exceptional", "zero-circular",
+    "clean.*hierarchy", "correctly implements", "proper implementation",
+];
+const TEST_COUPLING_INDICATORS = [
+    "test coupling to implementation",
+    "test.*suite.*direct calls.*internals",
+    "unit test.*coupling",
+    "test-to-implementation coupling",
+];
+/**
+ * LLM findings about "missing" zones are false positives when the packages are
+ * analyzed as sub-projects (they have their own `.sourcevision/` directories).
+ * The LLM doesn't receive sub-analysis context, so it incorrectly interprets
+ * partial zone coverage as missing packages.
+ */
+const ZONE_DETECTION_ARTIFACT_INDICATORS = [
+    "missing from zone detection",
+    "not.*(?:appear|present|detected).*(?:zone|cluster)",
+];
+/**
+ * Enforce deterministic severity rules that the LLM can't override.
+ * Runs after findings are parsed to correct misclassified severities:
+ *
+ * - Positive/praise findings from LLM passes → downgrade to "info"
+ * - Test-coupling anti-patterns → downgrade to "info" (expected by design)
+ * - Pass 0 (deterministic heuristic) findings are never modified
+ */
+export function enforceSeverityRules(findings) {
+    return findings.map(f => {
+        // Rule 1: LLM findings with positive language → info
+        if (f.pass >= 1 && f.severity !== "info") {
+            const lower = f.text.toLowerCase();
+            if (POSITIVE_INDICATORS.some(p => new RegExp(p, "i").test(lower))) {
+                return { ...f, severity: "info" };
+            }
+        }
+        // Rule 2: Test-coupling anti-patterns → info
+        if (f.pass >= 1 && f.type === "anti-pattern") {
+            const lower = f.text.toLowerCase();
+            if (TEST_COUPLING_INDICATORS.some(p => new RegExp(p, "i").test(lower))) {
+                return { ...f, severity: "info" };
+            }
+        }
+        // Rule 3: Zone detection artifacts (sub-analyzed packages appear "missing") → info
+        if (f.pass >= 1 && f.severity !== "info") {
+            const lower = f.text.toLowerCase();
+            if (ZONE_DETECTION_ARTIFACT_INDICATORS.some(p => new RegExp(p, "i").test(lower))) {
+                return { ...f, severity: "info" };
+            }
+        }
+        return f;
+    });
+}
+// ── Finding deduplication ────────────────────────────────────────────────────
+const SEVERITY_RANK = { critical: 0, warning: 1, info: 2 };
+/** Normalize finding text for comparison: lowercase, collapse whitespace. */
+function normalizeText(text) {
+    return text.toLowerCase().trim().replace(/\s+/g, " ");
+}
+/**
+ * Compute bigram Dice similarity between two normalized strings.
+ * Returns 0.0–1.0 where 1.0 is identical.
+ */
+function bigramSimilarity(a, b) {
+    if (a === b)
+        return 1.0;
+    if (a.length < 2 || b.length < 2)
+        return a === b ? 1.0 : 0;
+    const bigramsA = new Set();
+    for (let i = 0; i < a.length - 1; i++)
+        bigramsA.add(a.slice(i, i + 2));
+    const bigramsB = new Set();
+    for (let i = 0; i < b.length - 1; i++)
+        bigramsB.add(b.slice(i, i + 2));
+    let intersection = 0;
+    for (const gram of bigramsA) {
+        if (bigramsB.has(gram))
+            intersection++;
+    }
+    return (2 * intersection) / (bigramsA.size + bigramsB.size);
+}
+/** Similarity threshold above which two findings are considered near-duplicates. */
+const FINDING_SIMILARITY_THRESHOLD = 0.8;
+/**
+ * Pick the "best" finding from a cluster of near-duplicates.
+ * Prefers: pass 0 findings (calibrated heuristics) → highest severity →
+ * most related items → lowest pass number.
+ *
+ * Pass 0 findings have severity calibrated by code thresholds, so LLM
+ * duplicates should never override them. This prevents the meta-evaluation
+ * pass from escalating a heuristic "info" to "critical".
+ */
+function pickBest(cluster) {
+    if (cluster.length === 1)
+        return cluster[0];
+    return cluster.reduce((best, f) => {
+        // Pass 0 findings are authoritative — prefer them over LLM duplicates
+        if (best.pass === 0 && f.pass !== 0)
+            return best;
+        if (f.pass === 0 && best.pass !== 0)
+            return f;
+        const bestSev = SEVERITY_RANK[best.severity ?? ""] ?? 3;
+        const fSev = SEVERITY_RANK[f.severity ?? ""] ?? 3;
+        if (fSev < bestSev)
+            return f;
+        if (fSev > bestSev)
+            return best;
+        // Same severity: prefer more related items
+        const bestRelated = best.related?.length ?? 0;
+        const fRelated = f.related?.length ?? 0;
+        if (fRelated > bestRelated)
+            return f;
+        if (fRelated < bestRelated)
+            return best;
+        // Same related count: prefer lower pass number (earlier discovery)
+        return f.pass < best.pass ? f : best;
+    });
+}
+/**
+ * Deduplicate findings by detecting near-identical text within the same
+ * scope and type. When duplicates are found across different passes,
+ * the highest-severity version is kept.
+ *
+ * Matching is scoped to `(scope, type)` pairs — findings in different
+ * scopes or with different types are never merged.
+ *
+ * Uses bigram Dice similarity (threshold 0.8) for fuzzy text matching,
+ * with case-insensitive and whitespace-normalized comparison.
+ */
+export function deduplicateFindings(findings) {
+    if (findings.length === 0)
+        return [];
+    // Group findings by (scope, type) — only merge within same group
+    const groups = new Map();
+    for (const f of findings) {
+        const key = `${f.scope}\0${f.type}`;
+        const group = groups.get(key);
+        if (group) {
+            group.push(f);
+        }
+        else {
+            groups.set(key, [f]);
+        }
+    }
+    const result = [];
+    for (const group of groups.values()) {
+        if (group.length === 1) {
+            result.push(group[0]);
+            continue;
+        }
+        // Union-find clustering for near-duplicate detection
+        const n = group.length;
+        const parent = Array.from({ length: n }, (_, i) => i);
+        function find(i) {
+            while (parent[i] !== i) {
+                parent[i] = parent[parent[i]]; // path compression
+                i = parent[i];
+            }
+            return i;
+        }
+        function union(a, b) {
+            const ra = find(a);
+            const rb = find(b);
+            if (ra !== rb)
+                parent[ra] = rb;
+        }
+        // Pre-normalize texts once
+        const normalized = group.map((f) => normalizeText(f.text));
+        // Compare all pairs within this group
+        for (let i = 0; i < n; i++) {
+            for (let j = i + 1; j < n; j++) {
+                if (bigramSimilarity(normalized[i], normalized[j]) >= FINDING_SIMILARITY_THRESHOLD) {
+                    union(i, j);
+                }
+            }
+        }
+        // Collect clusters and pick best from each
+        const clusters = new Map();
+        for (let i = 0; i < n; i++) {
+            const root = find(i);
+            const cluster = clusters.get(root);
+            if (cluster) {
+                cluster.push(group[i]);
+            }
+            else {
+                clusters.set(root, [group[i]]);
+            }
+        }
+        for (const cluster of clusters.values()) {
+            result.push(pickBest(cluster));
+        }
+    }
+    return result;
+}
+// ── Zone ID deduplication ────────────────────────────────────────────────────
+/** Ensure no two zones share the same ID (appends -2, -3, etc.) */
+export function deduplicateZoneIds(zones) {
+    const usedIds = new Set();
+    for (const zone of zones) {
+        if (usedIds.has(zone.id)) {
+            let suffix = 2;
+            while (usedIds.has(`${zone.id}-${suffix}`))
+                suffix++;
+            zone.id = `${zone.id}-${suffix}`;
+        }
+        usedIds.add(zone.id);
+    }
+}
+//# sourceMappingURL=enrich-parsing.js.map

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

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

package/packages/sourcevision/dist/analyzers/enrich-per-zone.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 type { Inventory, Imports, Zone, ZoneCrossing, Zones, Finding, AnalyzeTokenUsage } from "../schema/index.js";
+/** Compute a hash of a single zone's file list for change detection. */
+export declare function computeZoneStructureHash(zone: Zone): string;
+export interface PerZoneEnrichResult {
+    zones: Zone[];
+    newZoneInsights: Map<string, string[]>;
+    newGlobalInsights: string[];
+    newFindings: Finding[];
+    pass: number;
+    tokenUsage?: AnalyzeTokenUsage;
+}
+/**
+ * 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 declare function enrichZonesPerZone(zones: Zone[], crossings: ZoneCrossing[], inventory: Inventory, imports: Imports, previousZones?: Zones, fileArchetypes?: Map<string, string | null>, hints?: string): Promise<PerZoneEnrichResult>;