@opensip-cli/graph 0.1.0

package/dist/cli/workspace-runner.js

@@ -0,0 +1,166 @@
+// @fitness-ignore-file performance-anti-patterns -- discoverPolyglotUnits iterates the small fixed adapters list (5 languages); each adapter's discoverWorkspaceUnits performs I/O whose results depend on the per-adapter cwd state, so sequential await is intentional to keep error context attributable per adapter.
+/**
+ * `graph --workspace` parallel runner.
+ *
+ * Fans a graph run out across every workspace unit detected by the
+ * language adapters' `discoverWorkspaceUnits` hook by spawning one
+ * child process per unit, each running `graph <rootDir> --json`. Each
+ * child has its own Node heap, so the per-unit memory ceiling that
+ * Phase 6 already provides scales naturally:
+ * N units × ~per-unit-budget ≈ total budget. Concurrency is capped at
+ * `os.cpus().length - 1` (or a caller override) so we don't
+ * oversubscribe.
+ *
+ * Polyglot per spec D8b: callers compose units from multiple adapters
+ * via `discoverPolyglotUnits` and pass the flattened list. The runner
+ * itself is language-agnostic — it only sees opaque `WorkspaceUnit`s.
+ */
+import { spawn } from 'node:child_process';
+import { cpus } from 'node:os';
+import { relative } from 'node:path';
+import { ConfigurationError, logger, } from '@opensip-cli/core';
+import { runWorkerPool } from './orchestrate/worker-pool.js';
+/**
+ * Aggregate WorkspaceUnits across all adapters that implement the
+ * discovery hook. Per spec D8b: in a polyglot repo (e.g. TS frontend +
+ * Cargo backend) both adapters contribute units to one combined fan-
+ * out. Adapters without the hook contribute zero units (D5).
+ *
+ * Returns units sorted by `rootDir` for deterministic fan-out order.
+ */
+export async function discoverPolyglotUnits(rootDir, adapters) {
+    const all = [];
+    for (const adapter of adapters) {
+        if (!adapter.discoverWorkspaceUnits)
+            continue;
+        const units = await adapter.discoverWorkspaceUnits(rootDir);
+        all.push(...units);
+    }
+    all.sort((a, b) => a.rootDir.localeCompare(b.rootDir));
+    return all;
+}
+/**
+ * Spawn one child process per WorkspaceUnit, run `graph <rootDir>
+ * --json` in each, and aggregate the parsed findings. Concurrency is
+ * capped (default `cpus()-1`). Always resolves; child failures are
+ * surfaced via `anyChildFailed`.
+ */
+export async function runWorkspaceUnitsInParallel(input) {
+    if (input.units.length === 0) {
+        throw new ConfigurationError('--workspace: no workspace units found. Use `opensip graph` for whole-project analysis.');
+    }
+    const concurrency = Math.max(1, input.concurrency ?? Math.max(1, cpus().length - 1));
+    logger.info({
+        evt: 'graph.cli.workspace.start',
+        module: 'graph:cli',
+        units: input.units.length,
+        concurrency,
+    });
+    // Shared bounded worker pool (also used by the shard runner). Each slot
+    // spawns one child at a time and pulls the next unit when it finishes.
+    const results = await runWorkerPool(input.units, concurrency, (unit) => spawnGraphChild({
+        cliScript: input.cliScript,
+        unit,
+        cwd: input.cwd,
+        noCache: input.noCache === true,
+        resolution: input.resolution,
+        recipe: input.recipe,
+        ...(input.language === undefined ? {} : { language: input.language }),
+    }));
+    const anyChildFailed = results.some((r) => r.exitCode !== 0);
+    // Sort for deterministic display order regardless of completion
+    // order — units finish in unpredictable order under parallelism.
+    results.sort((a, b) => a.rootDir.localeCompare(b.rootDir));
+    logger.info({
+        evt: 'graph.cli.workspace.complete',
+        module: 'graph:cli',
+        units: input.units.length,
+        anyChildFailed,
+    });
+    return { perUnit: results, anyChildFailed };
+}
+function spawnGraphChild(input) {
+    return new Promise((resolvePromise) => {
+        const args = [input.cliScript, 'graph', input.unit.rootDir, '--json'];
+        if (input.noCache)
+            args.push('--no-cache');
+        if (input.resolution !== undefined)
+            args.push('--resolution', input.resolution);
+        if (input.language !== undefined && input.language.length > 0)
+            args.push('--language', input.language);
+        if (input.recipe !== undefined)
+            args.push('--recipe', input.recipe);
+        const child = spawn(process.execPath, args, {
+            cwd: input.cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: process.env,
+        });
+        let stdout = '';
+        let stderr = '';
+        // setEncoding routes chunks through a StringDecoder that buffers
+        // partial multi-byte UTF-8 sequences across 'data' chunk boundaries.
+        // Without it, a non-ASCII char split across two chunks decodes to
+        // replacement chars and corrupts the --json stdout parsed below.
+        child.stdout.setEncoding('utf8');
+        child.stderr.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk;
+        });
+        child.on('error', (err) => {
+            /* v8 ignore start */
+            resolvePromise({
+                unitId: input.unit.id,
+                rootDir: input.unit.rootDir,
+                displayPath: relative(input.cwd, input.unit.rootDir),
+                signals: [],
+                exitCode: -1,
+                stderr: `failed to spawn child: ${err.message}`,
+            });
+            /* v8 ignore stop */
+        });
+        child.on('close', (code) => {
+            const signals = parseChildSignals(stdout, input.unit.rootDir, stderr);
+            resolvePromise({
+                unitId: input.unit.id,
+                rootDir: input.unit.rootDir,
+                displayPath: relative(input.cwd, input.unit.rootDir),
+                signals,
+                /* v8 ignore next */
+                exitCode: code ?? -1,
+                stderr,
+            });
+        });
+    });
+}
+/**
+ * Parse a child's `--json` {@link SignalEnvelope} stdout into a flat
+ * `Signal[]` (ADR-0011 — `graph --json` now emits the envelope, not the
+ * legacy `CliOutput`). Returns an empty array on parse failure; the caller
+ * surfaces the child's stderr separately.
+ */
+function parseChildSignals(stdout, rootDir, stderr) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch (error) {
+        /* v8 ignore start */
+        logger.warn({
+            evt: 'graph.cli.workspace.parse-error',
+            module: 'graph:cli',
+            rootDir,
+            err: error instanceof Error ? error.message : String(error),
+            stderrPreview: stderr.slice(0, 200),
+        });
+        return [];
+        /* v8 ignore stop */
+    }
+    return parsed.signals ?? [];
+}
+//# sourceMappingURL=workspace-runner.js.map

package/dist/cli/workspace-runner.js.map

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

package/dist/cross-package/export-index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Linker data structures for semantic cross-shard resolution (plan #2, Phase 1).
+ *
+ * Two pure "symbol tables" the boundary resolver (Phase 2) links against —
+ * derivable entirely from data already present in a merged catalog plus the
+ * resolved `Shard[]`:
+ *
+ *   1. {@link ExportIndex} — per-package map of exported function name →
+ *      occurrences (`visibility === 'exported'`). The export symbol table:
+ *      "given a package and a callee name, which exported occurrences match?"
+ *   2. {@link PackageManifestIndex} — package `name` → its on-disk manifest
+ *      (`name`, dir, `exports` map). Lets {@link resolveSpecifierToPackage}
+ *      turn a bare import specifier (`@scope/pkg[/subpath]`) into the package
+ *      group the {@link ExportIndex} is keyed by.
+ *
+ * Engine-layer and language-agnostic: no TypeScript parser, no AST. The only
+ * effect is reading each package's `package.json` from disk in
+ * {@link buildPackageManifestIndex}; everything else is plain map/path/JSON
+ * math. These structures are UNUSED by resolution logic in Phase 1 — Phase 2
+ * wires them into `resolveCrossBoundaryCalls`.
+ *
+ * Package-key alignment (the linchpin Phase 2 depends on): the boundary
+ * resolver buckets occurrences by `packageOf(occ.filePath)` — the path segment
+ * under `packages/` (e.g. `core`, `graph`, `languages`), NOT the package.json
+ * `name`. So {@link buildExportIndex} keys by exactly that, and
+ * {@link resolveSpecifierToPackage} returns a `packageGroup` derived by running
+ * `packageOf` over the manifest's project-relative dir — so a specifier's
+ * resolved group matches the `ExportIndex` keys verbatim.
+ */
+import type { Shard } from '../cli/orchestrate/shard-model.js';
+import type { Catalog, FunctionOccurrence } from '../types.js';
+/**
+ * Per-package export symbol table: `package` → (`name` → exported occurrences).
+ *
+ * The outer key is `packageOf(filePath)` (the `packages/<segment>` group),
+ * matching the bucketing the boundary resolver uses; the inner key is a
+ * function's `simpleName`. Only `visibility === 'exported'` occurrences are
+ * present — module-local and private occurrences are excluded, since an import
+ * specifier can only reach a package's exports.
+ *
+ * Insertion order follows catalog iteration. Consumers MUST match by name, not
+ * order; the inner arrays are the deterministic candidate set for a name.
+ */
+export type ExportIndex = ReadonlyMap<string, ReadonlyMap<string, readonly FunctionOccurrence[]>>;
+/**
+ * Bucket every exported occurrence in `catalog` by its package group then by
+ * its simple name. Deterministic and allocation-lean: one pass over
+ * `catalog.functions`, no sorting (matching is by name, not order).
+ *
+ * The package key is `packageOf(occ.filePath)` — identical to what the
+ * cross-shard resolver buckets by — so Phase 2 can look up
+ * `exportIndex.get(packageGroup)` where `packageGroup` comes from
+ * {@link resolveSpecifierToPackage}.
+ */
+export declare function buildExportIndex(catalog: Catalog, manifestIndex?: PackageManifestIndex): ExportIndex;
+/**
+ * One workspace package's manifest facts the specifier resolver needs.
+ *
+ * `dir` is the package's PROJECT-RELATIVE root (e.g. `packages/core`) — the
+ * form `packageOf` expects — derived from the shard's absolute `rootDir`
+ * against the common project root. `exportsMap` is the raw `exports` field
+ * (when an object), used to gate subpath resolution.
+ */
+export interface PackageManifest {
+    readonly name: string;
+    readonly dir: string;
+    readonly exportsMap?: Record<string, unknown>;
+}
+/** Package `name` → its {@link PackageManifest}. */
+export type PackageManifestIndex = ReadonlyMap<string, PackageManifest>;
+/**
+ * Read each shard's `package.json` (`name`, `exports`) and index it by package
+ * name. Reuses the already-resolved `Shard[]` (no re-discovery); a shard whose
+ * `rootDir` has no readable/parseable `package.json`, or whose manifest has no
+ * string `name`, is skipped (it simply won't be specifier-resolvable).
+ *
+ * `projectRoot` is the common root all shard file paths are relativized
+ * against, so each manifest's `dir` is in the same project-relative form
+ * `packageOf` consumes.
+ */
+export declare function buildPackageManifestIndex(shards: readonly Shard[], projectRoot: string): PackageManifestIndex;
+/**
+ * Build a {@link PackageManifestIndex} from a bare list of package ROOT dirs
+ * (absolute), reading each `<rootDir>/package.json`. The `Shard`-free entry the
+ * single-program (exact) engine uses: it has no `Shard[]` to hand the shard
+ * overload, only the package roots it derived from the catalog. Same best-effort
+ * semantics — a root with no readable/parseable manifest, or a manifest with no
+ * string `name`, is skipped (it won't be specifier-resolvable). First write
+ * wins on a duplicate `name`.
+ */
+export declare function buildPackageManifestIndexFromRoots(rootDirs: readonly string[], projectRoot: string): PackageManifestIndex;
+/** The outcome of resolving a bare import specifier to a workspace package. */
+export interface ResolvedSpecifier {
+    /** The `packageOf`-aligned group key — looks up into an {@link ExportIndex}. */
+    readonly packageGroup: string;
+    /** The `exports` subpath (`./errors`) when the specifier addressed one. */
+    readonly subpath?: string;
+}
+/**
+ * Resolve a bare import specifier (`@scope/pkg` or `@scope/pkg/subpath`, or the
+ * unscoped `pkg` / `pkg/subpath`) to the package group an {@link ExportIndex}
+ * is keyed by, plus the addressed `exports` subpath when present.
+ *
+ * Returns `undefined` (→ Phase 2 declines, emits no edge) when:
+ *   - the specifier is relative (`./x`) or empty — not a bare package import;
+ *   - the package name is not in `manifestIndex` (external / untracked dep);
+ *   - a subpath is present but is NOT declared in the package's `exports` map.
+ *
+ * **V1 subpath scope (open question decided here):** resolve the package ROOT
+ * export and only those subpaths LITERALLY declared as keys in `exports`
+ * (`./errors`, `./languages/parse-cache.js`). Glob/conditional `exports`
+ * resolution is deferred. A package with no object `exports` is treated as
+ * exposing only its root — any subpath against it is unmappable → `undefined`.
+ * The returned `packageGroup` is the same for root and subpath (the subpath
+ * lives inside the same package); Phase 2 narrows by name within that group.
+ */
+export declare function resolveSpecifierToPackage(specifier: string, manifestIndex: PackageManifestIndex): ResolvedSpecifier | undefined;
+//# sourceMappingURL=export-index.d.ts.map

package/dist/cross-package/export-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-index.d.ts","sourceRoot":"","sources":["../../src/cross-package/export-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAWH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,aAAa,CAAC;AAI/E;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,CACnC,MAAM,EACN,WAAW,CAAC,MAAM,EAAa,SAAS,kBAAkB,EAAE,CAAC,CAC9D,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,oBAAoB,GACnC,WAAW,CAqBb;AAoGD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED,oDAAoD;AACpD,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,EAAqB,eAAe,CAAC,CAAC;AAE3F;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAKtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAOtB;AAkDD,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,oBAAoB,GAClC,iBAAiB,GAAG,SAAS,CAc/B"}

package/dist/cross-package/export-index.js

@@ -0,0 +1,296 @@
+/**
+ * Linker data structures for semantic cross-shard resolution (plan #2, Phase 1).
+ *
+ * Two pure "symbol tables" the boundary resolver (Phase 2) links against —
+ * derivable entirely from data already present in a merged catalog plus the
+ * resolved `Shard[]`:
+ *
+ *   1. {@link ExportIndex} — per-package map of exported function name →
+ *      occurrences (`visibility === 'exported'`). The export symbol table:
+ *      "given a package and a callee name, which exported occurrences match?"
+ *   2. {@link PackageManifestIndex} — package `name` → its on-disk manifest
+ *      (`name`, dir, `exports` map). Lets {@link resolveSpecifierToPackage}
+ *      turn a bare import specifier (`@scope/pkg[/subpath]`) into the package
+ *      group the {@link ExportIndex} is keyed by.
+ *
+ * Engine-layer and language-agnostic: no TypeScript parser, no AST. The only
+ * effect is reading each package's `package.json` from disk in
+ * {@link buildPackageManifestIndex}; everything else is plain map/path/JSON
+ * math. These structures are UNUSED by resolution logic in Phase 1 — Phase 2
+ * wires them into `resolveCrossBoundaryCalls`.
+ *
+ * Package-key alignment (the linchpin Phase 2 depends on): the boundary
+ * resolver buckets occurrences by `packageOf(occ.filePath)` — the path segment
+ * under `packages/` (e.g. `core`, `graph`, `languages`), NOT the package.json
+ * `name`. So {@link buildExportIndex} keys by exactly that, and
+ * {@link resolveSpecifierToPackage} returns a `packageGroup` derived by running
+ * `packageOf` over the manifest's project-relative dir — so a specifier's
+ * resolved group matches the `ExportIndex` keys verbatim.
+ */
+import { readFileSync } from 'node:fs';
+import { posix, relative } from 'node:path';
+import { logger } from '@opensip-cli/core';
+import { packageOf } from '../resolve-callee.js';
+import { toPosixPath } from './posix-path.js';
+/**
+ * Bucket every exported occurrence in `catalog` by its package group then by
+ * its simple name. Deterministic and allocation-lean: one pass over
+ * `catalog.functions`, no sorting (matching is by name, not order).
+ *
+ * The package key is `packageOf(occ.filePath)` — identical to what the
+ * cross-shard resolver buckets by — so Phase 2 can look up
+ * `exportIndex.get(packageGroup)` where `packageGroup` comes from
+ * {@link resolveSpecifierToPackage}.
+ */
+export function buildExportIndex(catalog, manifestIndex) {
+    const index = new Map();
+    for (const occs of Object.values(catalog.functions)) {
+        if (!occs)
+            continue;
+        for (const occ of occs) {
+            if (occ.visibility !== 'exported')
+                continue;
+            const pkg = packageOf(occ.filePath);
+            const byName = getOrCreateMap(index, pkg);
+            const bucket = byName.get(occ.simpleName);
+            if (bucket)
+                bucket.push(occ);
+            else
+                byName.set(occ.simpleName, [occ]);
+        }
+    }
+    // Re-export following: make a name reachable under the package that RE-EXPORTS
+    // it (not just its defining package). Needs the manifest index to turn a
+    // workspace specifier into a package group; callers without one get the
+    // base (defining-package-only) index — back-compatible.
+    if (manifestIndex !== undefined && catalog.reExports && catalog.reExports.length > 0) {
+        applyReExports(index, catalog.reExports, manifestIndex);
+    }
+    return index;
+}
+/**
+ * Fold re-export facts into the export index: for each `(reExportingPackage,
+ * exportedName)`, point at the SOURCE occurrence the name is defined as in the
+ * package the specifier resolves to. Runs to a FIXPOINT so chains resolve (A
+ * re-exports from B which re-exports from C). Decline-beats-guess: a name already
+ * present in the re-exporting package's bucket (a local definition, or an earlier
+ * deterministic re-export) is never overwritten; an unresolvable specifier
+ * (external npm) or absent source name is skipped.
+ *
+ * Relative specifiers (`'./x'`) resolve within the SAME package — the name is
+ * already an occurrence there — so they are effectively no-ops; the load-bearing
+ * case is a WORKSPACE specifier (`'@scope/pkg'`) crossing a package boundary.
+ */
+function applyReExports(index, reExports, manifestIndex) {
+    // Each (pkg, name) is added at most once (never overwritten), so the total
+    // number of additions is bounded and the fixpoint terminates; the cap is a
+    // belt-and-braces guard against a pathological re-export cycle.
+    const MAX_PASSES = 16;
+    for (let pass = 0; pass < MAX_PASSES; pass++) {
+        let changed = false;
+        for (const r of reExports) {
+            if (applyOneReExport(index, r, manifestIndex))
+                changed = true;
+        }
+        if (!changed)
+            break;
+    }
+}
+/** Apply one re-export fact; returns whether it added any new index entry. */
+function applyOneReExport(index, r, manifestIndex) {
+    // Relative re-export stays in-package (already indexed); workspace specifier
+    // resolves to its package group. External / untracked → skip.
+    const sourcePkg = r.specifier.startsWith('.')
+        ? packageOf(r.fromFile)
+        : resolveSpecifierToPackage(r.specifier, manifestIndex)?.packageGroup;
+    if (sourcePkg === undefined)
+        return false; // @silent-ok — external/untracked specifier; decline
+    const sourceBucket = index.get(sourcePkg);
+    if (sourceBucket === undefined)
+        return false; // @silent-ok — source package has no indexed exports
+    const fromBucket = getOrCreateMap(index, packageOf(r.fromFile));
+    return r.exportedName === '*'
+        ? expandStarReExport(sourceBucket, fromBucket)
+        : addNamedReExport(r, sourceBucket, fromBucket);
+}
+/** `export * from src` — expose every source export the re-exporting package
+ *  does not already own. Returns whether anything was added. */
+function expandStarReExport(sourceBucket, fromBucket) {
+    let changed = false;
+    for (const [name, occs] of sourceBucket) {
+        if (!fromBucket.has(name)) {
+            fromBucket.set(name, occs);
+            changed = true;
+        }
+    }
+    return changed;
+}
+/** `export { sourceName as exportedName } from src` — point the re-exporting
+ *  package's bucket at the source occurrence (never overriding a local def /
+ *  earlier re-export). Returns whether it was added. */
+function addNamedReExport(r, sourceBucket, fromBucket) {
+    if (fromBucket.has(r.exportedName))
+        return false; // @silent-ok — local def / earlier re-export wins
+    const occs = sourceBucket.get(r.sourceName);
+    if (occs === undefined || occs.length === 0)
+        return false; // @silent-ok — name not exported by source pkg
+    fromBucket.set(r.exportedName, occs);
+    return true;
+}
+/**
+ * Get `outer.get(key)`, creating + inserting a fresh inner `Map` when absent.
+ * A pure single-threaded grouping helper over a local in-memory `Map` (no shared
+ * state) — extracted so the get-then-insert lives behind one typed-`Map`
+ * parameter rather than inline in {@link buildExportIndex}.
+ */
+function getOrCreateMap(outer, key) {
+    const existing = outer.get(key);
+    if (existing !== undefined)
+        return existing;
+    const created = new Map();
+    outer.set(key, created);
+    return created;
+}
+/**
+ * Read each shard's `package.json` (`name`, `exports`) and index it by package
+ * name. Reuses the already-resolved `Shard[]` (no re-discovery); a shard whose
+ * `rootDir` has no readable/parseable `package.json`, or whose manifest has no
+ * string `name`, is skipped (it simply won't be specifier-resolvable).
+ *
+ * `projectRoot` is the common root all shard file paths are relativized
+ * against, so each manifest's `dir` is in the same project-relative form
+ * `packageOf` consumes.
+ */
+export function buildPackageManifestIndex(shards, projectRoot) {
+    return buildPackageManifestIndexFromRoots(shards.map((s) => s.rootDir), projectRoot);
+}
+/**
+ * Build a {@link PackageManifestIndex} from a bare list of package ROOT dirs
+ * (absolute), reading each `<rootDir>/package.json`. The `Shard`-free entry the
+ * single-program (exact) engine uses: it has no `Shard[]` to hand the shard
+ * overload, only the package roots it derived from the catalog. Same best-effort
+ * semantics — a root with no readable/parseable manifest, or a manifest with no
+ * string `name`, is skipped (it won't be specifier-resolvable). First write
+ * wins on a duplicate `name`.
+ */
+export function buildPackageManifestIndexFromRoots(rootDirs, projectRoot) {
+    const index = new Map();
+    for (const rootDir of rootDirs) {
+        const manifest = readManifest(rootDir, projectRoot);
+        if (manifest && !index.has(manifest.name))
+            index.set(manifest.name, manifest);
+    }
+    return index;
+}
+/** Read + parse one package's `package.json`; `undefined` on any failure. */
+function readManifest(rootDirAbs, projectRoot) {
+    const manifestPath = posix.join(toPosixPath(rootDirAbs), 'package.json');
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, 'utf8');
+    }
+    catch (error) {
+        // Best-effort: a shard without a readable package.json is simply not
+        // specifier-resolvable. Note the skip so the swallow isn't silent.
+        logger.debug({
+            evt: 'graph.export_index.manifest_read_skipped',
+            module: 'graph:export-index',
+            manifestPath,
+            err: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        // Best-effort: an unparseable package.json is not specifier-resolvable.
+        // Note the skip so the swallow isn't silent.
+        logger.debug({
+            evt: 'graph.export_index.manifest_parse_skipped',
+            module: 'graph:export-index',
+            manifestPath,
+            err: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const record = parsed;
+    const name = record.name;
+    if (typeof name !== 'string' || name.length === 0)
+        return undefined;
+    const exportsField = record.exports;
+    const exportsMap = typeof exportsField === 'object' && exportsField !== null
+        ? exportsField
+        : undefined;
+    return { name, dir: relativeDir(rootDirAbs, projectRoot), exportsMap };
+}
+/** Project-relative POSIX dir for a shard's absolute rootDir (the `packageOf` form). */
+function relativeDir(rootDirAbs, projectRoot) {
+    return toPosixPath(relative(projectRoot, rootDirAbs));
+}
+/**
+ * Resolve a bare import specifier (`@scope/pkg` or `@scope/pkg/subpath`, or the
+ * unscoped `pkg` / `pkg/subpath`) to the package group an {@link ExportIndex}
+ * is keyed by, plus the addressed `exports` subpath when present.
+ *
+ * Returns `undefined` (→ Phase 2 declines, emits no edge) when:
+ *   - the specifier is relative (`./x`) or empty — not a bare package import;
+ *   - the package name is not in `manifestIndex` (external / untracked dep);
+ *   - a subpath is present but is NOT declared in the package's `exports` map.
+ *
+ * **V1 subpath scope (open question decided here):** resolve the package ROOT
+ * export and only those subpaths LITERALLY declared as keys in `exports`
+ * (`./errors`, `./languages/parse-cache.js`). Glob/conditional `exports`
+ * resolution is deferred. A package with no object `exports` is treated as
+ * exposing only its root — any subpath against it is unmappable → `undefined`.
+ * The returned `packageGroup` is the same for root and subpath (the subpath
+ * lives inside the same package); Phase 2 narrows by name within that group.
+ */
+export function resolveSpecifierToPackage(specifier, manifestIndex) {
+    if (specifier.length === 0 || specifier.startsWith('.'))
+        return undefined;
+    const { packageName, subpath } = splitSpecifier(specifier);
+    if (packageName === undefined)
+        return undefined;
+    const manifest = manifestIndex.get(packageName);
+    if (manifest === undefined)
+        return undefined;
+    if (subpath !== undefined && !exportsDeclares(manifest.exportsMap, subpath)) {
+        return undefined; // unmappable subpath → decline
+    }
+    const packageGroup = packageOf(`${manifest.dir}/`);
+    return subpath === undefined ? { packageGroup } : { packageGroup, subpath };
+}
+/**
+ * Split a bare specifier into its package name (`@scope/pkg` or `pkg`) and the
+ * remaining `exports`-style subpath (`./rest`), or `undefined` subpath for a
+ * bare root import. Returns `packageName: undefined` for an unparseable
+ * specifier (e.g. a lone `@scope` with no package segment).
+ */
+function splitSpecifier(specifier) {
+    const parts = specifier.split('/');
+    if (specifier.startsWith('@')) {
+        // Scoped: @scope/pkg[/...rest]
+        if (parts.length < 2 || parts[0] === undefined || parts[1] === undefined) {
+            return { packageName: undefined, subpath: undefined };
+        }
+        const packageName = `${parts[0]}/${parts[1]}`;
+        const rest = parts.slice(2);
+        return { packageName, subpath: rest.length > 0 ? `./${rest.join('/')}` : undefined };
+    }
+    // Unscoped: pkg[/...rest]
+    const packageName = parts[0];
+    if (packageName === undefined || packageName.length === 0) {
+        return { packageName: undefined, subpath: undefined };
+    }
+    const rest = parts.slice(1);
+    return { packageName, subpath: rest.length > 0 ? `./${rest.join('/')}` : undefined };
+}
+/** True when `exports` literally declares `subpath` as a key (v1 — no globs). */
+function exportsDeclares(exportsMap, subpath) {
+    return exportsMap !== undefined && Object.prototype.hasOwnProperty.call(exportsMap, subpath);
+}
+//# sourceMappingURL=export-index.js.map

package/dist/cross-package/export-index.js.map

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

package/dist/cross-package/posix-path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `toPosixPath` — normalize OS path separators to POSIX `/`.
+ *
+ * The engine relativizes file paths against a project root and then matches them
+ * with `/`-anchored logic (`packageOf`'s regex, the package-group keys, subpath
+ * stems). On Windows `path.relative` yields `\`-separated paths, so every such
+ * path must be normalized first. Backslashes are collapsed UNCONDITIONALLY (not
+ * gated on `path.sep`) so a stray `\` from any caller still flattens to `/` and
+ * the normalization is self-consistent regardless of the path's origin.
+ *
+ * One shared helper so the export index, the manifest index, and the shard
+ * partitioner share a single normalization (they previously each inlined a
+ * slightly different `toPosix`).
+ */
+export declare function toPosixPath(p: string): string;
+//# sourceMappingURL=posix-path.d.ts.map

package/dist/cross-package/posix-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix-path.d.ts","sourceRoot":"","sources":["../../src/cross-package/posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/cross-package/posix-path.js

@@ -0,0 +1,18 @@
+/**
+ * `toPosixPath` — normalize OS path separators to POSIX `/`.
+ *
+ * The engine relativizes file paths against a project root and then matches them
+ * with `/`-anchored logic (`packageOf`'s regex, the package-group keys, subpath
+ * stems). On Windows `path.relative` yields `\`-separated paths, so every such
+ * path must be normalized first. Backslashes are collapsed UNCONDITIONALLY (not
+ * gated on `path.sep`) so a stray `\` from any caller still flattens to `/` and
+ * the normalization is self-consistent regardless of the path's origin.
+ *
+ * One shared helper so the export index, the manifest index, and the shard
+ * partitioner share a single normalization (they previously each inlined a
+ * slightly different `toPosix`).
+ */
+export function toPosixPath(p) {
+    return p.replaceAll('\\', '/');
+}
+//# sourceMappingURL=posix-path.js.map

package/dist/cross-package/posix-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix-path.js","sourceRoot":"","sources":["../../src/cross-package/posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC"}