@n-dx/core 0.1.0

package/packages/sourcevision/dist/analyzers/workspace-crossings.js

@@ -0,0 +1,239 @@
+/**
+ * Cross-repo crossing computation for workspace aggregation.
+ *
+ * When multiple repos are aggregated into a workspace, some "external" npm
+ * imports actually point to sibling workspace members. This module resolves
+ * those external imports into ZoneCrossing entries so the aggregated
+ * zones.json reflects true cross-repo architectural dependencies.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { toPosix } from "../util/paths.js";
+// ── Entry file resolution ────────────────────────────────────────────────────
+/** Common entry file conventions, checked in order. */
+const ENTRY_FILE_CONVENTIONS = [
+    "src/index.ts",
+    "src/public.ts",
+    "src/index.tsx",
+    "src/main.ts",
+    "index.ts",
+    "index.js",
+];
+/**
+ * Map a built output path to its likely source path.
+ *
+ * Common patterns:
+ *   dist/public.js  → src/public.ts
+ *   dist/index.mjs  → src/index.ts
+ *   lib/main.cjs    → src/main.ts
+ */
+function distToSource(distPath) {
+    return distPath
+        .replace(/^\.\//, "")
+        .replace(/^(dist|lib|build|out)\//, "src/")
+        .replace(/\.(js|mjs|cjs|jsx)$/, ".ts");
+}
+/**
+ * Extract the entry point path from a package.json exports or main field.
+ *
+ * Handles:
+ * - `exports["."]` as string: `"./dist/public.js"`
+ * - `exports["."]` as condition map: `{ import: "./dist/public.js" }`
+ * - `main`: `"dist/index.js"`
+ * - `module`: `"dist/index.mjs"`
+ */
+function extractEntryPath(pkgJson) {
+    // Try exports["."] first (most modern)
+    const exports = pkgJson.exports;
+    if (exports) {
+        const dotExport = exports["."];
+        if (typeof dotExport === "string") {
+            return dotExport;
+        }
+        if (dotExport && typeof dotExport === "object") {
+            const conditions = dotExport;
+            // Prefer: import > default > require
+            const path = conditions.import ?? conditions.default ?? conditions.require;
+            if (typeof path === "string") {
+                return path;
+            }
+        }
+    }
+    // Try main
+    if (typeof pkgJson.main === "string") {
+        return pkgJson.main;
+    }
+    // Try module
+    if (typeof pkgJson.module === "string") {
+        return pkgJson.module;
+    }
+    return null;
+}
+/**
+ * Resolve the source-level entry file for a package.
+ *
+ * Uses package.json fields to find the built entry point, maps it back to
+ * a source file, and verifies it exists in the member's zone files. Falls
+ * back to common conventions (src/index.ts, src/public.ts, etc.).
+ *
+ * @param pkgJson - Partial package.json contents (exports, main, module).
+ * @param allMemberFiles - All files across the member's zones (relative to member root).
+ * @returns The source entry file path (relative to member root), or null.
+ */
+export function resolveEntryFile(pkgJson, allMemberFiles) {
+    const fileSet = new Set(allMemberFiles);
+    // Try to resolve from package.json fields
+    const entryPath = extractEntryPath(pkgJson);
+    if (entryPath) {
+        const sourcePath = distToSource(entryPath);
+        if (fileSet.has(sourcePath)) {
+            return sourcePath;
+        }
+    }
+    // Fall back to conventions
+    for (const convention of ENTRY_FILE_CONVENTIONS) {
+        if (fileSet.has(convention)) {
+            return convention;
+        }
+    }
+    return null;
+}
+// ── Package map ──────────────────────────────────────────────────────────────
+/**
+ * Read package.json from a member's root directory and extract package info.
+ *
+ * The member root is derived from svDir (which is the absolute path to the
+ * member's .sourcevision/ directory).
+ */
+export function readMemberPackageInfo(member) {
+    const memberRoot = dirname(member.svDir);
+    const pkgJsonPath = join(memberRoot, "package.json");
+    let pkgJson;
+    try {
+        pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+    const name = pkgJson.name;
+    if (typeof name !== "string" || !name) {
+        return null;
+    }
+    // Collect all files across the member's zones for entry file resolution
+    const allFiles = member.zones?.zones.flatMap((z) => z.files) ?? [];
+    const entryFile = resolveEntryFile(pkgJson, allFiles) ?? undefined;
+    return { name, entryFile };
+}
+/**
+ * Build a map from npm package names to workspace members.
+ *
+ * @param members - The workspace members.
+ * @param readInfo - Function to read package info from a member.
+ *   Defaults to reading package.json from disk. Override for testing.
+ */
+export function buildPackageMap(members, readInfo = readMemberPackageInfo) {
+    const map = new Map();
+    for (const member of members) {
+        const info = readInfo(member);
+        if (!info?.name)
+            continue;
+        map.set(info.name, {
+            member,
+            entryFile: info.entryFile,
+        });
+    }
+    return map;
+}
+// ── Cross-repo crossing computation ──────────────────────────────────────────
+/**
+ * Find the target zone and file for a cross-repo import.
+ *
+ * When we know the entry file, we look it up in the promoted zones.
+ * When we don't, we fall back to the first zone entry point of the target member.
+ */
+function resolveTarget(targetMember, entryFile, fileToZone, allZones) {
+    // If we have a known entry file, look it up directly
+    if (entryFile) {
+        const prefixedFile = toPosix(join(targetMember.prefix, entryFile));
+        const zone = fileToZone.get(prefixedFile);
+        if (zone) {
+            return { toFile: prefixedFile, toZone: zone };
+        }
+    }
+    // Fallback: find the first promoted zone for this member that has entry points
+    const memberZonePrefix = `${targetMember.id}:`;
+    for (const zone of allZones) {
+        if (!zone.id.startsWith(memberZonePrefix))
+            continue;
+        if (zone.entryPoints.length > 0) {
+            return { toFile: zone.entryPoints[0], toZone: zone.id };
+        }
+    }
+    // Last resort: any zone for this member
+    for (const zone of allZones) {
+        if (!zone.id.startsWith(memberZonePrefix))
+            continue;
+        if (zone.files.length > 0) {
+            return { toFile: zone.files[0], toZone: zone.id };
+        }
+    }
+    return null;
+}
+/**
+ * Compute cross-repo zone crossings from workspace member external imports.
+ *
+ * Iterates over each member's external imports. When an external import's
+ * package name matches a sibling member in the package map, it creates
+ * zone crossings from the importing file's zone to the target member's
+ * entry zone.
+ *
+ * @param members - All workspace members with their loaded data.
+ * @param promotedZones - All promoted zones (with `{memberId}:{zoneId}` IDs).
+ * @param packageMap - Map from npm package names to members (from buildPackageMap).
+ * @returns Array of cross-repo zone crossings.
+ */
+export function computeCrossRepoCrossings(members, promotedZones, packageMap) {
+    // Build file→zone lookup for all promoted zones
+    const fileToZone = new Map();
+    for (const zone of promotedZones) {
+        for (const file of zone.files)
+            fileToZone.set(file, zone.id);
+    }
+    const crossings = [];
+    const seen = new Set();
+    for (const member of members) {
+        if (!member.imports?.external)
+            continue;
+        for (const ext of member.imports.external) {
+            const entry = packageMap.get(ext.package);
+            if (!entry)
+                continue;
+            // Skip self-imports (member importing its own package)
+            if (entry.member.id === member.id)
+                continue;
+            // Resolve target zone and file in the sibling member
+            const target = resolveTarget(entry.member, entry.entryFile, fileToZone, promotedZones);
+            if (!target)
+                continue;
+            for (const importingFile of ext.importedBy) {
+                const fromFilePrefixed = toPosix(join(member.prefix, importingFile));
+                const fromZone = fileToZone.get(fromFilePrefixed);
+                if (!fromZone)
+                    continue;
+                // Deduplicate: same from→to→fromZone→toZone
+                const key = `${fromFilePrefixed}\0${target.toFile}\0${fromZone}\0${target.toZone}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                crossings.push({
+                    from: fromFilePrefixed,
+                    to: target.toFile,
+                    fromZone,
+                    toZone: target.toZone,
+                });
+            }
+        }
+    }
+    return crossings;
+}
+//# sourceMappingURL=workspace-crossings.js.map

package/packages/sourcevision/dist/analyzers/workspace-crossings.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * Workspace analyzer — detects and incorporates pre-analyzed sub-directories.
+ *
+ * When a subdirectory already has `.sourcevision/`, it's treated as a
+ * pre-analyzed unit. Its zones are promoted into the parent analysis
+ * with prefixed IDs instead of re-running Louvain on its files.
+ */
+import type { Manifest, Inventory, Imports, Zones, Zone, ZoneCrossing, SubAnalysisRef } from "../schema/index.js";
+/** A detected sub-analysis with its loaded data. */
+export interface SubAnalysis {
+    /** Unique ID derived from directory path (e.g., "packages-rex"). */
+    id: string;
+    /** Path prefix relative to root (e.g., "packages/rex"). */
+    prefix: string;
+    /** Path to the .sourcevision directory. */
+    svDir: string;
+    /** Loaded manifest. */
+    manifest: Manifest;
+    /** Loaded zones (if available). */
+    zones?: Zones;
+    /** Loaded inventory (if available). */
+    inventory?: Inventory;
+    /** Loaded imports (if available). */
+    imports?: Imports;
+}
+/**
+ * Detect all sub-analyses within the project tree.
+ * Returns an array of SubAnalysis objects for directories that have
+ * their own .sourcevision/ with a valid manifest.
+ */
+export declare function detectSubAnalyses(rootDir: string): SubAnalysis[];
+/**
+ * Promote zones from a sub-analysis into the parent.
+ * - Prefixes zone IDs to avoid collisions
+ * - Adjusts file paths to be relative to root
+ * - Sets childId and depth on promoted zones
+ */
+export declare function promoteZones(sub: SubAnalysis): Zone[];
+/**
+ * Promote crossings from a sub-analysis.
+ * Prefixes zone IDs and adjusts file paths.
+ */
+export declare function promoteCrossings(sub: SubAnalysis): ZoneCrossing[];
+/**
+ * Get the path prefixes covered by sub-analyses.
+ * Files under these prefixes should be excluded from the root's Louvain analysis.
+ *
+ * We use prefix matching (not explicit file lists) because sub-analyses may be
+ * stale — new files added since the sub-analysis was run would otherwise leak
+ * into the root analysis.
+ */
+export declare function getSubAnalyzedPrefixes(subAnalyses: SubAnalysis[]): string[];
+/**
+ * Check if a file path is covered by any sub-analysis prefix.
+ */
+export declare function isSubAnalyzedFile(path: string, prefixes: string[]): boolean;
+/**
+ * Get the set of files that are covered by sub-analyses.
+ * @deprecated Use getSubAnalyzedPrefixes + isSubAnalyzedFile for prefix-based matching.
+ */
+export declare function getSubAnalyzedFiles(subAnalyses: SubAnalysis[]): Set<string>;
+/**
+ * Build SubAnalysisRef entries for the manifest.
+ */
+export declare function buildSubAnalysisRefs(subAnalyses: SubAnalysis[]): SubAnalysisRef[];

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

@@ -0,0 +1,243 @@
+/**
+ * Workspace analyzer — detects and incorporates pre-analyzed sub-directories.
+ *
+ * When a subdirectory already has `.sourcevision/`, it's treated as a
+ * pre-analyzed unit. Its zones are promoted into the parent analysis
+ * with prefixed IDs instead of re-running Louvain on its files.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { SV_DIR } from "../constants.js";
+import { DATA_FILES } from "../schema/data-files.js";
+import { toPosix } from "../util/paths.js";
+// ── Detection ────────────────────────────────────────────────────────────────
+/**
+ * Recursively scan for .sourcevision directories within the project tree.
+ * Skips the root .sourcevision itself and common excluded directories.
+ */
+function findSubSvDirs(rootDir, currentDir, results) {
+    const SKIP_DIRS = new Set([
+        "node_modules",
+        ".git",
+        "dist",
+        "build",
+        "__pycache__",
+        ".next",
+        ".nuxt",
+        ".svelte-kit",
+        ".turbo",
+        ".cache",
+        "coverage",
+        ".output",
+    ]);
+    let entries;
+    try {
+        entries = readdirSync(currentDir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const fullPath = join(currentDir, entry);
+        let stat;
+        try {
+            stat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        // Check if this directory has a .sourcevision subdirectory
+        if (entry === SV_DIR) {
+            // Skip the root's own .sourcevision
+            const relPath = relative(rootDir, currentDir);
+            if (relPath !== "") {
+                results.push(currentDir);
+            }
+            continue;
+        }
+        // Check for .sourcevision inside this directory
+        const svPath = join(fullPath, SV_DIR);
+        if (existsSync(svPath) && statSync(svPath).isDirectory()) {
+            results.push(fullPath);
+            // Don't recurse into sub-analyzed directories (they manage their own children)
+            continue;
+        }
+        // Recurse
+        findSubSvDirs(rootDir, fullPath, results);
+    }
+}
+/**
+ * Generate a unique ID from a relative path.
+ * "packages/rex" → "packages-rex"
+ */
+function pathToId(relativePath) {
+    return relativePath
+        .replace(/[\/\\]/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .toLowerCase();
+}
+/**
+ * Load a sub-analysis from a directory that has a .sourcevision folder.
+ */
+function loadSubAnalysis(rootDir, subDir) {
+    const svDir = join(subDir, SV_DIR);
+    const manifestPath = join(svDir, DATA_FILES.manifest);
+    if (!existsSync(manifestPath)) {
+        return null;
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+    const prefix = toPosix(relative(rootDir, subDir));
+    const id = pathToId(prefix);
+    const result = {
+        id,
+        prefix,
+        svDir,
+        manifest,
+    };
+    // Load zones if available
+    const zonesPath = join(svDir, DATA_FILES.zones);
+    if (existsSync(zonesPath)) {
+        try {
+            result.zones = JSON.parse(readFileSync(zonesPath, "utf-8"));
+        }
+        catch {
+            // Zones unavailable
+        }
+    }
+    // Load inventory if available
+    const inventoryPath = join(svDir, DATA_FILES.inventory);
+    if (existsSync(inventoryPath)) {
+        try {
+            result.inventory = JSON.parse(readFileSync(inventoryPath, "utf-8"));
+        }
+        catch {
+            // Inventory unavailable
+        }
+    }
+    // Load imports if available
+    const importsPath = join(svDir, DATA_FILES.imports);
+    if (existsSync(importsPath)) {
+        try {
+            result.imports = JSON.parse(readFileSync(importsPath, "utf-8"));
+        }
+        catch {
+            // Imports unavailable
+        }
+    }
+    return result;
+}
+/**
+ * Detect all sub-analyses within the project tree.
+ * Returns an array of SubAnalysis objects for directories that have
+ * their own .sourcevision/ with a valid manifest.
+ */
+export function detectSubAnalyses(rootDir) {
+    const subDirs = [];
+    findSubSvDirs(rootDir, rootDir, subDirs);
+    const results = [];
+    for (const subDir of subDirs) {
+        const sub = loadSubAnalysis(rootDir, subDir);
+        if (sub) {
+            results.push(sub);
+        }
+    }
+    return results.sort((a, b) => a.prefix.localeCompare(b.prefix));
+}
+// ── Zone Promotion ───────────────────────────────────────────────────────────
+/**
+ * Promote zones from a sub-analysis into the parent.
+ * - Prefixes zone IDs to avoid collisions
+ * - Adjusts file paths to be relative to root
+ * - Sets childId and depth on promoted zones
+ */
+export function promoteZones(sub) {
+    if (!sub.zones?.zones) {
+        return [];
+    }
+    return sub.zones.zones.map((zone) => ({
+        ...zone,
+        id: `${sub.id}:${zone.id}`,
+        // File paths in sub-analysis are relative to sub-analysis root
+        // Prefix them to make them relative to the parent root
+        files: zone.files.map((f) => toPosix(join(sub.prefix, f))),
+        entryPoints: zone.entryPoints.map((f) => toPosix(join(sub.prefix, f))),
+        childId: sub.id,
+        depth: 1,
+    }));
+}
+/**
+ * Promote crossings from a sub-analysis.
+ * Prefixes zone IDs and adjusts file paths.
+ */
+export function promoteCrossings(sub) {
+    if (!sub.zones?.crossings) {
+        return [];
+    }
+    return sub.zones.crossings.map((c) => ({
+        from: toPosix(join(sub.prefix, c.from)),
+        to: toPosix(join(sub.prefix, c.to)),
+        fromZone: `${sub.id}:${c.fromZone}`,
+        toZone: `${sub.id}:${c.toZone}`,
+    }));
+}
+/**
+ * Get the path prefixes covered by sub-analyses.
+ * Files under these prefixes should be excluded from the root's Louvain analysis.
+ *
+ * We use prefix matching (not explicit file lists) because sub-analyses may be
+ * stale — new files added since the sub-analysis was run would otherwise leak
+ * into the root analysis.
+ */
+export function getSubAnalyzedPrefixes(subAnalyses) {
+    return subAnalyses.map((sub) => sub.prefix + "/");
+}
+/**
+ * Check if a file path is covered by any sub-analysis prefix.
+ */
+export function isSubAnalyzedFile(path, prefixes) {
+    return prefixes.some((prefix) => path.startsWith(prefix));
+}
+/**
+ * Get the set of files that are covered by sub-analyses.
+ * @deprecated Use getSubAnalyzedPrefixes + isSubAnalyzedFile for prefix-based matching.
+ */
+export function getSubAnalyzedFiles(subAnalyses) {
+    const files = new Set();
+    for (const sub of subAnalyses) {
+        if (sub.inventory?.files) {
+            for (const f of sub.inventory.files) {
+                files.add(toPosix(join(sub.prefix, f.path)));
+            }
+        }
+        else if (sub.zones?.zones) {
+            // Fallback to zone files if inventory unavailable
+            for (const zone of sub.zones.zones) {
+                for (const f of zone.files) {
+                    files.add(toPosix(join(sub.prefix, f)));
+                }
+            }
+        }
+    }
+    return files;
+}
+/**
+ * Build SubAnalysisRef entries for the manifest.
+ */
+export function buildSubAnalysisRefs(subAnalyses) {
+    return subAnalyses.map((sub) => ({
+        id: sub.id,
+        prefix: sub.prefix,
+        manifestPath: toPosix(join(sub.prefix, SV_DIR, DATA_FILES.manifest)),
+    }));
+}
+//# sourceMappingURL=workspace.js.map

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

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

package/packages/sourcevision/dist/analyzers/zone-hash.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Zone content hashing utility.
+ *
+ * Extracted from zones.ts to break the circular dependency between
+ * zones.ts and enrich.ts. Both modules need this function: zones.ts
+ * uses it during zone analysis, and enrich.ts uses it for cache
+ * invalidation checks.
+ *
+ * @module sourcevision/analyzers/zone-hash
+ */
+/**
+ * Hash all zone content hashes into a single global content hash.
+ * Changes when any zone's content changes.
+ */
+export declare function computeGlobalContentHash(zoneContentHashes: Record<string, string>): string;

package/packages/sourcevision/dist/analyzers/zone-hash.js

@@ -0,0 +1,23 @@
+/**
+ * Zone content hashing utility.
+ *
+ * Extracted from zones.ts to break the circular dependency between
+ * zones.ts and enrich.ts. Both modules need this function: zones.ts
+ * uses it during zone analysis, and enrich.ts uses it for cache
+ * invalidation checks.
+ *
+ * @module sourcevision/analyzers/zone-hash
+ */
+import { createHash } from "node:crypto";
+/**
+ * Hash all zone content hashes into a single global content hash.
+ * Changes when any zone's content changes.
+ */
+export function computeGlobalContentHash(zoneContentHashes) {
+    const data = Object.keys(zoneContentHashes)
+        .sort()
+        .map((id) => `${id}\0${zoneContentHashes[id]}`)
+        .join("\n");
+    return createHash("sha256").update(data).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=zone-hash.js.map

package/packages/sourcevision/dist/analyzers/zone-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-hash.js","sourceRoot":"","sources":["../../src/analyzers/zone-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,iBAAyC;IAEzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC;SACxC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC;SAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/packages/sourcevision/dist/analyzers/zone-output.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Per-zone output emitter — writes zone-scoped context and summary files
+ * to .sourcevision/zones/{zone-id}/.
+ */
+import type { Inventory, Imports, Zones, Zone, ZoneSummary } from "../schema/index.js";
+/** Generate context.md content for a single zone. */
+export declare function generateZoneContext(zone: Zone, inventory: Inventory, imports: Imports, zones: Zones): string;
+/** Build summary.json for a single zone. */
+export declare function buildZoneSummary(zone: Zone, inventory: Inventory): ZoneSummary;
+/**
+ * Emit per-zone output files to .sourcevision/zones/{zone-id}/.
+ * Creates context.md and summary.json for each zone.
+ * Recursively emits sub-zone outputs to nested directories.
+ */
+export declare function emitZoneOutputs(outputDir: string, inventory: Inventory, imports: Imports, zones: Zones): void;
+/**
+ * Remove zone folders that no longer correspond to any active zone.
+ * Prevents stale folders from accumulating when zone IDs change between runs.
+ */
+export declare function pruneStaleZoneFolders(zonesDir: string, zones: Zones): void;