@opensip-cli/graph 0.1.0

package/dist/cli/orchestrate/__tests__/flat-monorepo-strategy.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Tests for the Phase 12 flat-monorepo discovery strategy primitives —
+ * `detectMonorepoLayout`, `partitionFlatRepo`, `selectStrategyForLayout`.
+ *
+ * Pure-function coverage only. The actual subprocess fan-out for
+ * `synthetic-partition` mode (analogous to `runPackagesInParallel`) is
+ * a follow-up wiring change in `graph.ts`; integration validation lives
+ * in Phase 14.
+ */
+export {};
+//# sourceMappingURL=flat-monorepo-strategy.test.d.ts.map

package/dist/cli/orchestrate/__tests__/flat-monorepo-strategy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat-monorepo-strategy.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/orchestrate/__tests__/flat-monorepo-strategy.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/cli/orchestrate/__tests__/flat-monorepo-strategy.test.js

@@ -0,0 +1,271 @@
+/**
+ * Tests for the Phase 12 flat-monorepo discovery strategy primitives —
+ * `detectMonorepoLayout`, `partitionFlatRepo`, `selectStrategyForLayout`.
+ *
+ * Pure-function coverage only. The actual subprocess fan-out for
+ * `synthetic-partition` mode (analogous to `runPackagesInParallel`) is
+ * a follow-up wiring change in `graph.ts`; integration validation lives
+ * in Phase 14.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, sep } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { detectMonorepoLayout, partitionFlatRepo, selectStrategyForLayout, } from '../flat-monorepo-strategy.js';
+describe('detectMonorepoLayout', () => {
+    let dir;
+    beforeEach(() => {
+        dir = mkdtempSync(join(tmpdir(), 'flat-monorepo-detect-'));
+    });
+    afterEach(() => {
+        rmSync(dir, { recursive: true, force: true });
+    });
+    it('classifies a packages/* tree with nested package.json as workspaces', () => {
+        mkdirSync(join(dir, 'packages', 'a'), { recursive: true });
+        mkdirSync(join(dir, 'packages', 'b'), { recursive: true });
+        writeFileSync(join(dir, 'packages', 'a', 'package.json'), '{"name":"a"}', 'utf8');
+        writeFileSync(join(dir, 'packages', 'b', 'package.json'), '{"name":"b"}', 'utf8');
+        const layout = detectMonorepoLayout({
+            repoRoot: dir,
+            // Inject empty file list to skip the source walk — workspace
+            // detection should resolve before file enumeration.
+            files: [],
+        });
+        expect(layout.kind).toBe('workspaces');
+        if (layout.kind === 'workspaces') {
+            expect(layout.packageDirs).toHaveLength(2);
+            expect(layout.packageDirs[0]).toContain(`packages${sep}a`);
+            expect(layout.packageDirs[1]).toContain(`packages${sep}b`);
+        }
+    });
+    it('classifies a root package.json with `workspaces` declaration as workspaces', () => {
+        writeFileSync(join(dir, 'package.json'), JSON.stringify({ name: 'root', workspaces: ['apps/*', 'libs/*'] }), 'utf8');
+        const layout = detectMonorepoLayout({ repoRoot: dir, files: [] });
+        expect(layout.kind).toBe('workspaces');
+    });
+    it('classifies a small flat repo (no workspaces) as flat-small', () => {
+        // 100 synthetic .ts files — below the default 2500 threshold.
+        const files = Array.from({ length: 100 }, (_, i) => join(dir, 'src', `file-${String(i)}.ts`));
+        const layout = detectMonorepoLayout({
+            repoRoot: dir,
+            files,
+            nestedPackageDirs: [],
+            rootPackageJson: null,
+        });
+        expect(layout.kind).toBe('flat-small');
+        if (layout.kind === 'flat-small') {
+            expect(layout.files).toHaveLength(100);
+        }
+    });
+    it('classifies a large flat repo (no workspaces, > threshold) as flat-large', () => {
+        // 3000 synthetic .ts files — above the default 2500 threshold.
+        const files = Array.from({ length: 3000 }, (_, i) => join(dir, 'src', `file-${String(i)}.ts`));
+        const layout = detectMonorepoLayout({
+            repoRoot: dir,
+            files,
+            nestedPackageDirs: [],
+            rootPackageJson: null,
+        });
+        expect(layout.kind).toBe('flat-large');
+        if (layout.kind === 'flat-large') {
+            expect(layout.files).toHaveLength(3000);
+        }
+    });
+    it('respects a caller-supplied heap-elevation threshold', () => {
+        const files = Array.from({ length: 200 }, (_, i) => join(dir, 'src', `file-${String(i)}.ts`));
+        const layout = detectMonorepoLayout({
+            repoRoot: dir,
+            files,
+            nestedPackageDirs: [],
+            rootPackageJson: null,
+            heapElevationThreshold: 100,
+        });
+        expect(layout.kind).toBe('flat-large');
+    });
+    it('walks the filesystem when files are not injected', () => {
+        mkdirSync(join(dir, 'src', 'api'), { recursive: true });
+        writeFileSync(join(dir, 'src', 'api', 'foo.ts'), 'export const x = 1;', 'utf8');
+        writeFileSync(join(dir, 'src', 'api', 'bar.tsx'), 'export const y = 2;', 'utf8');
+        // Skipped artefact directories should NOT be picked up.
+        mkdirSync(join(dir, 'node_modules', 'junk'), { recursive: true });
+        writeFileSync(join(dir, 'node_modules', 'junk', 'index.ts'), 'x', 'utf8');
+        const layout = detectMonorepoLayout({
+            repoRoot: dir,
+            nestedPackageDirs: [],
+            rootPackageJson: null,
+        });
+        expect(layout.kind).toBe('flat-small');
+        if (layout.kind === 'flat-small') {
+            expect(layout.files).toHaveLength(2);
+            expect(layout.files.every((f) => !f.includes('node_modules'))).toBe(true);
+        }
+    });
+});
+describe('partitionFlatRepo — directory-depth', () => {
+    const repoRoot = '/repo';
+    it('buckets files by depth-N path segments', () => {
+        const files = [
+            `${repoRoot}/src/api/handlers/foo.ts`,
+            `${repoRoot}/src/api/routes/bar.ts`,
+            `${repoRoot}/src/lib/util.ts`,
+        ];
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'directory-depth',
+            depth: 2,
+        });
+        expect(partitions).toHaveLength(2);
+        const byId = new Map(partitions.map((p) => [p.id, p]));
+        expect(byId.get('src.api')?.files).toHaveLength(2);
+        expect(byId.get('src.lib')?.files).toHaveLength(1);
+    });
+    it('handles files shallower than the requested depth', () => {
+        // `src/foo.ts` has only one directory segment (`src`) — should
+        // bucket under `src`, not `src.<missing>`.
+        const files = [`${repoRoot}/src/foo.ts`, `${repoRoot}/src/bar.ts`];
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'directory-depth',
+            depth: 2,
+        });
+        expect(partitions).toHaveLength(1);
+        expect(partitions[0]?.id).toBe('src');
+        expect(partitions[0]?.files).toHaveLength(2);
+    });
+    it('buckets repo-root files under _root', () => {
+        const files = [`${repoRoot}/foo.ts`, `${repoRoot}/bar.ts`];
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'directory-depth',
+            depth: 2,
+        });
+        expect(partitions).toHaveLength(1);
+        expect(partitions[0]?.id).toBe('_root');
+    });
+    it('returns partitions in stable lexicographic order', () => {
+        const files = [`${repoRoot}/z/foo.ts`, `${repoRoot}/a/bar.ts`, `${repoRoot}/m/baz.ts`];
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'directory-depth',
+            depth: 1,
+        });
+        expect(partitions.map((p) => p.id)).toEqual(['a', 'm', 'z']);
+    });
+});
+describe('partitionFlatRepo — file-count-chunks', () => {
+    const repoRoot = '/repo';
+    it('splits a flat list into fixed-size chunks', () => {
+        const files = Array.from({ length: 5000 }, (_, i) => `${repoRoot}/src/f-${String(i).padStart(5, '0')}.ts`);
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'file-count-chunks',
+            chunkSize: 2000,
+        });
+        expect(partitions).toHaveLength(3);
+        expect(partitions[0]?.id).toBe('chunk-0');
+        expect(partitions[0]?.files).toHaveLength(2000);
+        expect(partitions[1]?.id).toBe('chunk-1');
+        expect(partitions[1]?.files).toHaveLength(2000);
+        expect(partitions[2]?.id).toBe('chunk-2');
+        expect(partitions[2]?.files).toHaveLength(1000);
+    });
+    it('produces a single chunk when input ≤ chunkSize', () => {
+        const files = Array.from({ length: 100 }, (_, i) => `${repoRoot}/src/f-${String(i)}.ts`);
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'file-count-chunks',
+            chunkSize: 2000,
+        });
+        expect(partitions).toHaveLength(1);
+        expect(partitions[0]?.id).toBe('chunk-0');
+    });
+});
+describe('partitionFlatRepo — hybrid', () => {
+    const repoRoot = '/repo';
+    it('falls back to chunking inside an oversized directory partition', () => {
+        // 5000 files in a single `src/api/` directory. directory-depth=2
+        // would yield ONE partition (`src.api`) with 5000 files, exceeding
+        // the 2000-file chunk size. Hybrid sub-partitions that one bucket
+        // into 3 chunks.
+        const files = Array.from({ length: 5000 }, (_, i) => `${repoRoot}/src/api/f-${String(i).padStart(5, '0')}.ts`);
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'hybrid',
+            depth: 2,
+            chunkSize: 2000,
+        });
+        expect(partitions).toHaveLength(3);
+        expect(partitions.map((p) => p.id)).toEqual([
+            'src.api.chunk-0',
+            'src.api.chunk-1',
+            'src.api.chunk-2',
+        ]);
+        expect(partitions[0]?.files).toHaveLength(2000);
+        expect(partitions[2]?.files).toHaveLength(1000);
+    });
+    it('keeps small directory partitions intact', () => {
+        // Mixed: one large directory + two small ones.
+        const large = Array.from({ length: 3000 }, (_, i) => `${repoRoot}/src/api/f-${String(i).padStart(5, '0')}.ts`);
+        const small1 = [`${repoRoot}/src/lib/a.ts`, `${repoRoot}/src/lib/b.ts`];
+        const small2 = [`${repoRoot}/src/util/x.ts`];
+        const files = [...large, ...small1, ...small2];
+        const partitions = partitionFlatRepo({
+            files,
+            repoRoot,
+            strategy: 'hybrid',
+            depth: 2,
+            chunkSize: 2000,
+        });
+        // src.api → 2 chunks (3000 / 2000); src.lib → 1; src.util → 1.
+        expect(partitions).toHaveLength(4);
+        const ids = partitions.map((p) => p.id);
+        expect(ids).toContain('src.api.chunk-0');
+        expect(ids).toContain('src.api.chunk-1');
+        expect(ids).toContain('src.lib');
+        expect(ids).toContain('src.util');
+    });
+});
+describe('partitionFlatRepo — input validation', () => {
+    it('throws on zero or negative chunkSize', () => {
+        expect(() => partitionFlatRepo({
+            files: ['/repo/a.ts'],
+            repoRoot: '/repo',
+            strategy: 'file-count-chunks',
+            chunkSize: 0,
+        })).toThrow(/chunkSize must be > 0/);
+    });
+});
+describe('selectStrategyForLayout', () => {
+    it('maps workspaces → packages-fanout', () => {
+        const selection = selectStrategyForLayout({
+            kind: 'workspaces',
+            packageDirs: ['/repo/packages/a'],
+        });
+        expect(selection.mode).toBe('packages-fanout');
+        expect(selection.partitionStrategy).toBeUndefined();
+    });
+    it('maps flat-small → single-process', () => {
+        const selection = selectStrategyForLayout({
+            kind: 'flat-small',
+            files: ['/repo/src/a.ts'],
+        });
+        expect(selection.mode).toBe('single-process');
+        expect(selection.partitionStrategy).toBeUndefined();
+    });
+    it('maps flat-large → synthetic-partition with hybrid strategy', () => {
+        const selection = selectStrategyForLayout({
+            kind: 'flat-large',
+            files: Array.from({ length: 3000 }, (_, i) => `/repo/src/f-${String(i)}.ts`),
+        });
+        expect(selection.mode).toBe('synthetic-partition');
+        expect(selection.partitionStrategy).toBe('hybrid');
+    });
+});
+//# sourceMappingURL=flat-monorepo-strategy.test.js.map

package/dist/cli/orchestrate/__tests__/flat-monorepo-strategy.test.js.map

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

package/dist/cli/orchestrate/__tests__/function-set-parity.test.d.ts

@@ -0,0 +1,38 @@
+/**
+ * PARITY of the exact-vs-sharded function set on the canonical file set
+ * (graph-sharded-exact-parity, Phase 1). Phase 0 characterized the gap as an
+ * expected-fail; Phase 1 unifies discovery on ONE canonical set so both engines
+ * see the identical files. This test now asserts that parity GREEN.
+ *
+ * ── THE PHASE-1 MODEL ──────────────────────────────────────────────────────
+ * Both engines start from the SAME project-wide root discovery (the root
+ * tsconfig's file set — every `.ts(x)`, fixtures + tests included) and reduce it
+ * via the SINGLE canonical filter (`resolveCanonicalFileSet`, which drops
+ * `__fixtures__/` and KEEPS real test files). The exact engine analyzes that set
+ * directly; the sharded engine PARTITIONS it across unit boundaries via
+ * `partitionFilesIntoShards` (files under no unit → synthetic `:root` shard).
+ * Because the sharded file set is `union(shard.files)` of a total + disjoint
+ * partition of the canonical set, the two engines analyze byte-identical files.
+ *
+ * ── CANONICAL DECISION (LOCKED, Phase 0) ───────────────────────────────────
+ *   - `__fixtures__/` (synthetic test-input code) is EXCLUDED from both engines.
+ *   - real test files (`*.test.ts`, `__tests__/`) are KEPT in both (needed for
+ *     test-only-reachable + test→production blast/coverage edges).
+ *
+ * ── FIXTURE (`__fixtures__/function-set-gap/`) ─────────────────────────────
+ *   packages/alpha — `src/index.ts` (kept) + `src/__fixtures__/sample.ts`
+ *                    (a fixture → EXCLUDED from the canonical set, both engines).
+ *   packages/beta  — `src/index.ts` (kept) + `src/__tests__/index.ts`
+ *                    (a real test file → KEPT in both engines).
+ *   scripts/       — `root-script.ts` outside `packages/**` → under no unit →
+ *                    lands in the synthetic `:root` shard (KEPT in both).
+ *
+ * ── METHOD ─────────────────────────────────────────────────────────────────
+ *   The engine layer may not import the real TypeScript graph adapter. So the
+ *   root discovery is modeled via `ts.parseJsonConfigFileContent` (the same
+ *   primitive that adapter's `discoverFiles` uses), and the canonical filter +
+ *   partition are the REAL engine primitives under test
+ *   (`resolveCanonicalFileSet`, `partitionFilesIntoShards`).
+ */
+export {};
+//# sourceMappingURL=function-set-parity.test.d.ts.map

package/dist/cli/orchestrate/__tests__/function-set-parity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-set-parity.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/orchestrate/__tests__/function-set-parity.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG"}

package/dist/cli/orchestrate/__tests__/function-set-parity.test.js

@@ -0,0 +1,163 @@
+/**
+ * PARITY of the exact-vs-sharded function set on the canonical file set
+ * (graph-sharded-exact-parity, Phase 1). Phase 0 characterized the gap as an
+ * expected-fail; Phase 1 unifies discovery on ONE canonical set so both engines
+ * see the identical files. This test now asserts that parity GREEN.
+ *
+ * ── THE PHASE-1 MODEL ──────────────────────────────────────────────────────
+ * Both engines start from the SAME project-wide root discovery (the root
+ * tsconfig's file set — every `.ts(x)`, fixtures + tests included) and reduce it
+ * via the SINGLE canonical filter (`resolveCanonicalFileSet`, which drops
+ * `__fixtures__/` and KEEPS real test files). The exact engine analyzes that set
+ * directly; the sharded engine PARTITIONS it across unit boundaries via
+ * `partitionFilesIntoShards` (files under no unit → synthetic `:root` shard).
+ * Because the sharded file set is `union(shard.files)` of a total + disjoint
+ * partition of the canonical set, the two engines analyze byte-identical files.
+ *
+ * ── CANONICAL DECISION (LOCKED, Phase 0) ───────────────────────────────────
+ *   - `__fixtures__/` (synthetic test-input code) is EXCLUDED from both engines.
+ *   - real test files (`*.test.ts`, `__tests__/`) are KEPT in both (needed for
+ *     test-only-reachable + test→production blast/coverage edges).
+ *
+ * ── FIXTURE (`__fixtures__/function-set-gap/`) ─────────────────────────────
+ *   packages/alpha — `src/index.ts` (kept) + `src/__fixtures__/sample.ts`
+ *                    (a fixture → EXCLUDED from the canonical set, both engines).
+ *   packages/beta  — `src/index.ts` (kept) + `src/__tests__/index.ts`
+ *                    (a real test file → KEPT in both engines).
+ *   scripts/       — `root-script.ts` outside `packages/**` → under no unit →
+ *                    lands in the synthetic `:root` shard (KEPT in both).
+ *
+ * ── METHOD ─────────────────────────────────────────────────────────────────
+ *   The engine layer may not import the real TypeScript graph adapter. So the
+ *   root discovery is modeled via `ts.parseJsonConfigFileContent` (the same
+ *   primitive that adapter's `discoverFiles` uses), and the canonical filter +
+ *   partition are the REAL engine primitives under test
+ *   (`resolveCanonicalFileSet`, `partitionFilesIntoShards`).
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join, relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import ts from 'typescript';
+import { describe, expect, it } from 'vitest';
+import { resolveCanonicalFileSet } from '../canonical-file-set.js';
+import { partitionFilesIntoShards, ROOT_SHARD_ID } from '../partition-files.js';
+const FIXTURE_ROOT = join(dirname(fileURLToPath(import.meta.url)), '__fixtures__', 'function-set-gap');
+/** Workspace units the sharded path discovers: `<root>/packages/*` dirs with a tsconfig. */
+const UNIT_DIRS = ['alpha', 'beta'].map((p) => join(FIXTURE_ROOT, 'packages', p));
+/** Resolve the ROOT tsconfig's raw file set the way the real TS adapter does. */
+function discoverRootFilesAbs() {
+    const tsconfigPath = join(FIXTURE_ROOT, 'tsconfig.json');
+    const read = ts.readConfigFile(tsconfigPath, (p) => ts.sys.readFile(p));
+    if (read.error)
+        throw new Error(`tsconfig read failed: ${tsconfigPath}`);
+    const parsed = ts.parseJsonConfigFileContent(read.config, ts.sys, dirname(tsconfigPath));
+    // Mirror the adapter's source-file filter: .ts(x) only, no declaration files.
+    return parsed.fileNames.filter((f) => /\.tsx?$/.test(f) && !f.endsWith('.d.ts')).sort();
+}
+function toProjectRel(absFile) {
+    const rel = relative(FIXTURE_ROOT, absFile);
+    return sep === '/' ? rel : rel.split(sep).join('/');
+}
+/**
+ * The canonical filter operates over PROJECT-RELATIVE paths here. In the real
+ * engine the project root is never itself under a `__fixtures__` segment, so the
+ * filter (run on absolute paths) only matches a project's OWN `__fixtures__`
+ * trees. This test's FIXTURE_ROOT, however, lives under the engine package's own
+ * `__tests__/__fixtures__/` — so filtering its absolute paths would
+ * (incorrectly) strip the entire tree. Converting to project-relative paths
+ * first reproduces the engine's semantics faithfully: only the fixture's OWN
+ * inner `src/__fixtures__/` is dropped, not the project root above it.
+ */
+function discoverRootFilesRel() {
+    return discoverRootFilesAbs().map(toProjectRel).sort();
+}
+/**
+ * exact engine's canonical set: ONE root discovery → resolveCanonicalFileSet.
+ * Models `runGraph`'s `discoverFiles({ cwd })` + canonical filter (orchestrate.ts).
+ */
+function exactCanonical() {
+    return [...resolveCanonicalFileSet(discoverRootFilesRel())].sort();
+}
+/**
+ * sharded engine's canonical set: the SAME root discovery + canonical filter,
+ * then PARTITIONED across unit boundaries (resolveShards, Phase 1). The sharded
+ * file set is `union(shard.files)`. Models `partitionFilesIntoShards`.
+ *
+ * The partition runs over project-relative paths (units' rootDirs are likewise
+ * project-relative) so the prefix math is self-consistent with the canonical set.
+ */
+function shardedCanonicalShards() {
+    const canonicalFiles = resolveCanonicalFileSet(discoverRootFilesRel());
+    return partitionFilesIntoShards({
+        canonicalFiles,
+        units: UNIT_DIRS.map((rootDir) => {
+            const rel = toProjectRel(rootDir);
+            return {
+                id: `pkg:${rel.replace('packages/', '')}`,
+                rootDir: rel,
+                configPathAbs: `${rel}/tsconfig.json`,
+            };
+        }),
+        projectRoot: '',
+        rootConfigPathAbs: 'tsconfig.json',
+    });
+}
+function shardedCanonical() {
+    return shardedCanonicalShards()
+        .flatMap((s) => s.files)
+        .sort();
+}
+/**
+ * Derive the function set from a file set. Each fixture source declares exactly
+ * one `export function <name>()`; extracting it grounds the function-set identity
+ * (`filePath::name`) in real content, mirroring the walk's "one occurrence per
+ * declared function."
+ */
+function functionSetOf(filesProjectRel) {
+    const set = [];
+    for (const rel of filesProjectRel) {
+        const text = readFileSync(join(FIXTURE_ROOT, rel), 'utf8');
+        const m = /export\s+function\s+([A-Za-z_]\w*)\(/.exec(text);
+        if (m?.[1])
+            set.push(`${rel}::${m[1]}`);
+    }
+    return set.sort();
+}
+describe('graph sharded-vs-exact function-set parity (canonical set)', () => {
+    it('the partition is total + disjoint over the canonical set', () => {
+        const canonical = [...resolveCanonicalFileSet(discoverRootFilesRel())].sort();
+        const shards = shardedCanonicalShards();
+        const partitioned = shards.flatMap((s) => s.files).sort();
+        // union(shard.files) === canonicalFiles (no file dropped, none invented).
+        expect(partitioned).toEqual(canonical);
+        // disjoint: every file in exactly one shard (no duplicates across shards).
+        expect(new Set(partitioned).size).toBe(partitioned.length);
+    });
+    it('the root script (under no unit) lands in the synthetic :root shard', () => {
+        const shards = shardedCanonicalShards();
+        const rootShard = shards.find((s) => s.id === ROOT_SHARD_ID);
+        expect(rootShard).toBeDefined();
+        expect(rootShard?.files).toContain('scripts/root-script.ts');
+        // It is anchored at the project root + root tsconfig so it parses correctly.
+        expect(rootShard?.rootDir).toBe('');
+        expect(rootShard?.configPathAbs).toBe('tsconfig.json');
+    });
+    it('sharded and exact discover the same canonical FILE set', () => {
+        expect(shardedCanonical()).toEqual(exactCanonical());
+    });
+    it('sharded and exact produce the same canonical FUNCTION set', () => {
+        expect(functionSetOf(shardedCanonical())).toEqual(functionSetOf(exactCanonical()));
+    });
+    it('NEITHER engine includes any /__fixtures__/ path', () => {
+        expect(exactCanonical().some((f) => f.includes('/__fixtures__/'))).toBe(false);
+        expect(shardedCanonical().some((f) => f.includes('/__fixtures__/'))).toBe(false);
+        // The fixture file specifically is gone from both.
+        expect(exactCanonical()).not.toContain('packages/alpha/src/__fixtures__/sample.ts');
+        expect(shardedCanonical()).not.toContain('packages/alpha/src/__fixtures__/sample.ts');
+    });
+    it('BOTH engines keep real test files (test → production edges depend on them)', () => {
+        expect(exactCanonical()).toContain('packages/beta/src/__tests__/index.ts');
+        expect(shardedCanonical()).toContain('packages/beta/src/__tests__/index.ts');
+    });
+});
+//# sourceMappingURL=function-set-parity.test.js.map

package/dist/cli/orchestrate/__tests__/function-set-parity.test.js.map

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

package/dist/cli/orchestrate/__tests__/incremental-merge.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Wave-4 incremental helpers: closure-expansion fixpoint, occurrence
+ * merging, and edge stitching. These drive the incremental rebuild path
+ * in catalog-builder. The tests exercise them directly with plain
+ * catalog data + a minimal walk-only adapter stub.
+ */
+export {};
+//# sourceMappingURL=incremental-merge.test.d.ts.map

package/dist/cli/orchestrate/__tests__/incremental-merge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-merge.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/orchestrate/__tests__/incremental-merge.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}