@opensip-cli/graph 0.1.0

package/dist/cli/orchestrate/__tests__/exact-boundary-recovery.test.js

@@ -0,0 +1,105 @@
+/**
+ * Exact-engine boundary recovery (Phase 3, Option A) — the helpers that make
+ * the single-program (exact) catalog run the SAME post-merge linker as the
+ * sharded engine. Covers: the no-op early returns, the package-root walk
+ * (found / nested-ancestor / declines at the project root), per-directory
+ * memoization, and the end-to-end recovery path against a real on-disk package.
+ */
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { derivePackageRoots, findPackageRoot, recoverExactBoundaryEdges, } from '../exact-boundary-recovery.js';
+function occ(simpleName, filePath, bodyHash) {
+    return {
+        bodyHash,
+        simpleName,
+        qualifiedName: `${filePath}.${simpleName}`,
+        filePath,
+        line: 1,
+        column: 0,
+        endLine: 1,
+        kind: 'function-declaration',
+        params: [],
+        returnType: null,
+        enclosingClass: null,
+        decorators: [],
+        visibility: 'exported',
+        inTestFile: false,
+        definedInGenerated: false,
+        calls: [],
+    };
+}
+function catalogOf(...occs) {
+    const functions = {};
+    for (const o of occs) {
+        const bucket = functions[o.simpleName] ?? [];
+        functions[o.simpleName] = bucket;
+        bucket.push(o);
+    }
+    return {
+        version: '3.0',
+        tool: 'graph',
+        language: 'typescript',
+        builtAt: 'x',
+        cacheKey: 'k',
+        resolutionMode: 'exact',
+        functions,
+    };
+}
+describe('recoverExactBoundaryEdges', () => {
+    const cat = catalogOf(occ('f', 'packages/a/src/f.ts', 'h1'));
+    it('returns the catalog unchanged when no boundary calls were emitted', () => {
+        expect(recoverExactBoundaryEdges({ catalog: cat }, [], '/root')).toBe(cat);
+    });
+    it('returns the catalog unchanged for an empty boundary-call array', () => {
+        expect(recoverExactBoundaryEdges({ catalog: cat, boundaryCalls: [] }, [], '/root')).toBe(cat);
+    });
+});
+describe('findPackageRoot / derivePackageRoots (on-disk walk)', () => {
+    let root;
+    let pkgDir;
+    beforeAll(() => {
+        root = mkdtempSync(join(tmpdir(), 'graph-recovery-'));
+        pkgDir = join(root, 'packages', 'a');
+        mkdirSync(join(pkgDir, 'src'), { recursive: true });
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: '@t/a' }));
+        // A bare directory under the project root with NO package.json anywhere up to root.
+        mkdirSync(join(root, 'loose'), { recursive: true });
+    });
+    afterAll(() => rmSync(root, { recursive: true, force: true }));
+    it('finds the nearest ancestor package.json from a nested source dir', () => {
+        expect(findPackageRoot(join(pkgDir, 'src'), root)).toBe(pkgDir);
+    });
+    it('returns the dir itself when it directly contains package.json', () => {
+        expect(findPackageRoot(pkgDir, root)).toBe(pkgDir);
+    });
+    it('declines (null) when no package.json exists up to the project root', () => {
+        expect(findPackageRoot(join(root, 'loose'), root)).toBeNull();
+    });
+    it('dedupes roots and memoizes per directory (two files, same package)', () => {
+        const roots = derivePackageRoots([
+            join(pkgDir, 'src', 'one.ts'),
+            join(pkgDir, 'src', 'two.ts'), // same dir → cache hit, no second walk
+            join(root, 'loose', 'x.ts'), // no package → contributes nothing (null branch)
+        ], root);
+        expect(roots).toEqual([pkgDir]);
+    });
+    it('runs the linker end-to-end when boundary calls are present (declines on external specifier)', () => {
+        const cat = catalogOf(occ('g', 'packages/a/src/g.ts', 'hg'));
+        const bc = {
+            ownerHash: 'hg',
+            ownerFile: 'packages/a/src/g.ts',
+            calleeName: 'somethingExternal',
+            importSpecifier: 'lodash', // not a workspace package → linker declines, no throw
+            line: 2,
+            column: 4,
+            text: 'somethingExternal()',
+            discarded: false,
+        };
+        const out = recoverExactBoundaryEdges({ catalog: cat, boundaryCalls: [bc] }, [join(pkgDir, 'src', 'g.ts')], root);
+        // The full path executed (manifest build + linker); the catalog's functions survive.
+        expect(out.functions.g).toBeDefined();
+    });
+});
+//# sourceMappingURL=exact-boundary-recovery.test.js.map

package/dist/cli/orchestrate/__tests__/exact-boundary-recovery.test.js.map

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

package/dist/cli/orchestrate/__tests__/export-index.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Linker data structures (Phase 1): export symbol index + package manifest
+ * index + specifier resolution.
+ *
+ * The load-bearing invariant: the package key `buildExportIndex` buckets by
+ * (`packageOf(filePath)`) and the `packageGroup` `resolveSpecifierToPackage`
+ * returns must be IDENTICAL, so Phase 2 can look up
+ * `exportIndex.get(resolveSpecifierToPackage(spec).packageGroup)`. The
+ * `reconciles ...` test asserts that linkage end-to-end.
+ */
+export {};
+//# sourceMappingURL=export-index.test.d.ts.map

package/dist/cli/orchestrate/__tests__/export-index.test.d.ts.map

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

package/dist/cli/orchestrate/__tests__/export-index.test.js

@@ -0,0 +1,346 @@
+/**
+ * Linker data structures (Phase 1): export symbol index + package manifest
+ * index + specifier resolution.
+ *
+ * The load-bearing invariant: the package key `buildExportIndex` buckets by
+ * (`packageOf(filePath)`) and the `packageGroup` `resolveSpecifierToPackage`
+ * returns must be IDENTICAL, so Phase 2 can look up
+ * `exportIndex.get(resolveSpecifierToPackage(spec).packageGroup)`. The
+ * `reconciles ...` test asserts that linkage end-to-end.
+ */
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { buildExportIndex, buildPackageManifestIndex, resolveSpecifierToPackage, } from '../../../cross-package/export-index.js';
+function occ(simpleName, filePath, bodyHash, visibility = 'exported') {
+    return {
+        bodyHash,
+        simpleName,
+        qualifiedName: `${filePath}.${simpleName}`,
+        filePath,
+        line: 1,
+        column: 0,
+        endLine: 1,
+        kind: 'function-declaration',
+        params: [],
+        returnType: null,
+        enclosingClass: null,
+        decorators: [],
+        visibility,
+        inTestFile: false,
+        definedInGenerated: false,
+        calls: [],
+    };
+}
+function catalog(...occs) {
+    const functions = {};
+    for (const o of occs) {
+        const bucket = functions[o.simpleName];
+        if (bucket)
+            bucket.push(o);
+        else
+            functions[o.simpleName] = [o];
+    }
+    return {
+        version: '3.0',
+        tool: 'graph',
+        language: 'typescript',
+        builtAt: 'x',
+        cacheKey: 'k',
+        resolutionMode: 'exact',
+        functions,
+    };
+}
+describe('buildExportIndex', () => {
+    it('includes exported occurrences and excludes module-local / private', () => {
+        const cat = catalog(occ('shown', 'packages/core/src/a.ts', 'A', 'exported'), occ('localOnly', 'packages/core/src/a.ts', 'B', 'module-local'), occ('privateOnly', 'packages/core/src/a.ts', 'C', 'private'));
+        const index = buildExportIndex(cat);
+        const core = index.get('core');
+        expect(core).toBeDefined();
+        expect([...(core?.keys() ?? [])]).toEqual(['shown']);
+        expect(core?.get('shown')?.map((o) => o.bodyHash)).toEqual(['A']);
+        expect(core?.get('localOnly')).toBeUndefined();
+        expect(core?.get('privateOnly')).toBeUndefined();
+    });
+    it('buckets exported occurrences by package group then name across packages', () => {
+        const cat = catalog(occ('build', 'packages/core/src/a.ts', 'A'), occ('build', 'packages/graph/engine/src/b.ts', 'B'), occ('run', 'packages/graph/engine/src/c.ts', 'C'));
+        const index = buildExportIndex(cat);
+        expect([...index.keys()].sort()).toEqual(['core', 'graph']);
+        expect(index
+            .get('core')
+            ?.get('build')
+            ?.map((o) => o.bodyHash)).toEqual(['A']);
+        expect(index
+            .get('graph')
+            ?.get('build')
+            ?.map((o) => o.bodyHash)).toEqual(['B']);
+        expect(index
+            .get('graph')
+            ?.get('run')
+            ?.map((o) => o.bodyHash)).toEqual(['C']);
+    });
+    it('collects multiple exported occurrences of one name in a package', () => {
+        const cat = catalog(occ('overload', 'packages/core/src/a.ts', 'A'), occ('overload', 'packages/core/src/b.ts', 'B'));
+        const index = buildExportIndex(cat);
+        expect(index
+            .get('core')
+            ?.get('overload')
+            ?.map((o) => o.bodyHash)
+            .sort()).toEqual(['A', 'B']);
+    });
+    it('keeps same-named exports in different packages separate (name collision)', () => {
+        const cat = catalog(occ('serialize', 'packages/core/src/a.ts', 'A'), occ('serialize', 'packages/output/src/b.ts', 'B'));
+        const index = buildExportIndex(cat);
+        expect(index
+            .get('core')
+            ?.get('serialize')
+            ?.map((o) => o.bodyHash)).toEqual(['A']);
+        expect(index
+            .get('output')
+            ?.get('serialize')
+            ?.map((o) => o.bodyHash)).toEqual(['B']);
+    });
+});
+/** Inline {@link PackageManifestIndex} — `dir` is what `packageOf` maps to a group. */
+function manifest(...entries) {
+    return new Map(entries.map(([name, dir]) => [name, { name, dir }]));
+}
+function withReExports(cat, reExports) {
+    return { ...cat, reExports };
+}
+describe('buildExportIndex — re-export following', () => {
+    it('does NOTHING without a manifest index (back-compatible base behavior)', () => {
+        const cat = withReExports(occCat(), [
+            reexp('packages/graph/graph-adapter-common/src/index.ts', 'childrenOf', 'childrenOf', '@opensip-cli/tree-sitter'),
+        ]);
+        const index = buildExportIndex(cat); // no manifest → no re-export pass
+        expect(index.get('graph')?.get('childrenOf')).toBeUndefined();
+        expect(index
+            .get('tree-sitter')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+    });
+    it('is a no-op with a manifest but no re-export facts (base index only)', () => {
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        // catalog with NO reExports field, and one with an empty array — both base-only.
+        expect(buildExportIndex(occCat(), mi).get('graph')?.get('childrenOf')).toBeUndefined();
+        expect(buildExportIndex(withReExports(occCat(), []), mi).get('graph')?.get('childrenOf')).toBeUndefined();
+        expect(buildExportIndex(occCat(), mi)
+            .get('tree-sitter')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+    });
+    it('resolves a name under the package that re-exports it from a workspace dep', () => {
+        const cat = withReExports(occCat(), [
+            reexp('packages/graph/graph-adapter-common/src/index.ts', 'childrenOf', 'childrenOf', '@opensip-cli/tree-sitter'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        // still defined under tree-sitter AND now reachable under the re-exporting group (graph)
+        expect(index
+            .get('tree-sitter')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+        expect(index
+            .get('graph')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+    });
+    it('handles an aliased re-export (export { x as y } from)', () => {
+        const cat = withReExports(occCat(), [
+            reexp('packages/graph/graph-adapter-common/src/index.ts', 'kids', 'childrenOf', '@opensip-cli/tree-sitter'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        expect(index
+            .get('graph')
+            ?.get('kids')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+        expect(index.get('graph')?.get('childrenOf')).toBeUndefined(); // exposed only as the alias
+    });
+    it('follows a chain to a fixpoint (A re-exports from B which re-exports from C)', () => {
+        // C=tree-sitter defines childrenOf; B=core re-exports it; A=graph re-exports from B.
+        const cat = withReExports(occCat(), [
+            reexp('packages/core/src/index.ts', 'childrenOf', 'childrenOf', '@opensip-cli/tree-sitter'),
+            reexp('packages/graph/engine/src/index.ts', 'childrenOf', 'childrenOf', '@opensip-cli/core'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter'], ['@opensip-cli/core', 'packages/core']);
+        const index = buildExportIndex(cat, mi);
+        expect(index
+            .get('core')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+        expect(index
+            .get('graph')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+    });
+    it('never overrides a local definition with a re-export (decline-beats-guess)', () => {
+        const cat = withReExports(catalog(occ('childrenOf', 'packages/tree-sitter/src/walk.ts', 'TS'), occ('childrenOf', 'packages/graph/engine/src/local.ts', 'LOCAL')), [
+            reexp('packages/graph/engine/src/index.ts', 'childrenOf', 'childrenOf', '@opensip-cli/tree-sitter'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        // graph keeps its own; the re-export does not clobber it.
+        expect(index
+            .get('graph')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['LOCAL']);
+    });
+    it('expands a star re-export (export * from) over the source package exports', () => {
+        const cat = withReExports(catalog(occ('childrenOf', 'packages/tree-sitter/src/walk.ts', 'TS'), occ('nameOf', 'packages/tree-sitter/src/walk.ts', 'NM')), [reexp('packages/graph/engine/src/index.ts', '*', '*', '@opensip-cli/tree-sitter')]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        expect(index
+            .get('graph')
+            ?.get('childrenOf')
+            ?.map((o) => o.bodyHash)).toEqual(['TS']);
+        expect(index
+            .get('graph')
+            ?.get('nameOf')
+            ?.map((o) => o.bodyHash)).toEqual(['NM']);
+    });
+    it('declines an unresolvable (external) re-export specifier', () => {
+        const cat = withReExports(occCat(), [
+            reexp('packages/graph/engine/src/index.ts', 'debounce', 'debounce', 'lodash'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']); // no lodash
+        const index = buildExportIndex(cat, mi);
+        expect(index.get('graph')?.get('debounce')).toBeUndefined();
+    });
+    it('treats a relative re-export as in-package (no-op when already exported)', () => {
+        // graph defines+exports `localFn`; a relative `export { localFn } from './x'`
+        // within graph adds nothing (the occurrence is already in graph's bucket).
+        const cat = withReExports(catalog(occ('localFn', 'packages/graph/engine/src/x.ts', 'LF')), [
+            reexp('packages/graph/engine/src/index.ts', 'localFn', 'localFn', './x.js'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        expect(index
+            .get('graph')
+            ?.get('localFn')
+            ?.map((o) => o.bodyHash)).toEqual(['LF']);
+    });
+    it('star re-export does not overwrite a name the package already owns', () => {
+        const cat = withReExports(catalog(occ('shared', 'packages/tree-sitter/src/walk.ts', 'TS'), occ('shared', 'packages/graph/engine/src/own.ts', 'OWN')), [reexp('packages/graph/engine/src/index.ts', '*', '*', '@opensip-cli/tree-sitter')]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        expect(index
+            .get('graph')
+            ?.get('shared')
+            ?.map((o) => o.bodyHash)).toEqual(['OWN']);
+    });
+    it('declines a named re-export whose name is not exported by the source package', () => {
+        const cat = withReExports(occCat(), [
+            reexp('packages/graph/engine/src/index.ts', 'missing', 'missing', '@opensip-cli/tree-sitter'),
+        ]);
+        const mi = manifest(['@opensip-cli/tree-sitter', 'packages/tree-sitter']);
+        const index = buildExportIndex(cat, mi);
+        expect(index.get('graph')?.get('missing')).toBeUndefined();
+    });
+});
+/** A catalog with a single exported `childrenOf` in the tree-sitter package. */
+function occCat() {
+    return catalog(occ('childrenOf', 'packages/tree-sitter/src/walk.ts', 'TS'));
+}
+function reexp(fromFile, exportedName, sourceName, specifier) {
+    return { fromFile, exportedName, sourceName, specifier };
+}
+describe('buildPackageManifestIndex + resolveSpecifierToPackage', () => {
+    let projectRoot;
+    let shards;
+    beforeAll(() => {
+        projectRoot = mkdtempSync(join(tmpdir(), 'export-index-'));
+        // @opensip-cli/core at packages/core, with subpath exports
+        writePackage('packages/core', {
+            name: '@opensip-cli/core',
+            exports: {
+                '.': './dist/index.js',
+                './errors': './dist/lib/errors.js',
+                './languages/parse-cache.js': './dist/languages/parse-cache.js',
+            },
+        });
+        // unscoped package at packages/output, no exports field
+        writePackage('packages/output', { name: 'plain-output' });
+        // a package whose name collides nowhere; bare root resolution
+        writePackage('packages/graph/engine', { name: '@opensip-cli/graph' });
+        shards = [
+            shard('pkg:core', 'packages/core'),
+            shard('pkg:output', 'packages/output'),
+            shard('pkg:graph', 'packages/graph/engine'),
+            // a shard pointing at a dir with no package.json — must be skipped, not throw
+            shard('pkg:missing', 'packages/nonexistent'),
+        ];
+    });
+    afterAll(() => {
+        rmSync(projectRoot, { recursive: true, force: true });
+    });
+    function writePackage(relDir, manifest) {
+        const abs = join(projectRoot, relDir);
+        mkdirSync(abs, { recursive: true });
+        writeFileSync(join(abs, 'package.json'), JSON.stringify(manifest), 'utf8');
+    }
+    function shard(id, relDir) {
+        return { id, rootDir: join(projectRoot, relDir), files: [] };
+    }
+    it('indexes each readable package by name and skips missing manifests', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect([...index.keys()].sort()).toEqual([
+            '@opensip-cli/core',
+            '@opensip-cli/graph',
+            'plain-output',
+        ]);
+        expect(index.get('@opensip-cli/core')?.dir).toBe('packages/core');
+    });
+    it('resolves a scoped bare root specifier to its package group', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        const resolved = resolveSpecifierToPackage('@opensip-cli/core', index);
+        expect(resolved).toEqual({ packageGroup: 'core' });
+    });
+    it('resolves an unscoped bare specifier', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect(resolveSpecifierToPackage('plain-output', index)).toEqual({ packageGroup: 'output' });
+    });
+    it('resolves a subpath declared in exports, carrying the subpath', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect(resolveSpecifierToPackage('@opensip-cli/core/errors', index)).toEqual({
+            packageGroup: 'core',
+            subpath: './errors',
+        });
+        expect(resolveSpecifierToPackage('@opensip-cli/core/languages/parse-cache.js', index)).toEqual({
+            packageGroup: 'core',
+            subpath: './languages/parse-cache.js',
+        });
+    });
+    it('declines a subpath NOT declared in exports', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect(resolveSpecifierToPackage('@opensip-cli/core/internal', index)).toBeUndefined();
+    });
+    it('declines any subpath against a package with no exports field', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect(resolveSpecifierToPackage('plain-output/sub', index)).toBeUndefined();
+    });
+    it('returns undefined for an unknown / external package', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect(resolveSpecifierToPackage('react', index)).toBeUndefined();
+        expect(resolveSpecifierToPackage('@scope/unknown', index)).toBeUndefined();
+    });
+    it('returns undefined for relative or malformed specifiers', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        expect(resolveSpecifierToPackage('./local.js', index)).toBeUndefined();
+        expect(resolveSpecifierToPackage('', index)).toBeUndefined();
+        expect(resolveSpecifierToPackage('@scope', index)).toBeUndefined();
+    });
+    it('reconciles a resolved packageGroup with buildExportIndex keys (the Phase-2 linkage)', () => {
+        const index = buildPackageManifestIndex(shards, projectRoot);
+        const cat = catalog(occ('parse', 'packages/core/src/parser.ts', 'P'));
+        const exportIndex = buildExportIndex(cat);
+        const resolved = resolveSpecifierToPackage('@opensip-cli/core', index);
+        expect(resolved).toBeDefined();
+        // The whole point: the specifier's group keys straight into the export index.
+        const byName = exportIndex.get(resolved?.packageGroup ?? '<none>');
+        expect(byName?.get('parse')?.map((o) => o.bodyHash)).toEqual(['P']);
+    });
+});
+//# sourceMappingURL=export-index.test.js.map

package/dist/cli/orchestrate/__tests__/export-index.test.js.map

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

package/dist/cli/orchestrate/__tests__/flat-large-fixture.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Determinism + warm-safety + structural contract of the flat-large fixture
+ * generator (`_flat-large-fixture.ts`, ADR-0045 B1 measurement plane):
+ *
+ *   (a) byte-identity — two generations with the same spec are identical
+ *       file-by-file;
+ *   (b) warm-safety — re-invoking on an existing dir is a strict no-op
+ *       (`skipped: true`, mtimes unchanged — the fragment cache fingerprint
+ *       is mtime+size, so any rewrite would poison warm measurements);
+ *   (c) resolvable imports — every emitted relative specifier resolves to a
+ *       generated file;
+ *   (d) misalignment — each `src/dN` directory mixes files from more than
+ *       one cluster (otherwise `hybrid` would trivially win the experiment).
+ */
+export {};
+//# sourceMappingURL=flat-large-fixture.test.d.ts.map

package/dist/cli/orchestrate/__tests__/flat-large-fixture.test.d.ts.map

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

package/dist/cli/orchestrate/__tests__/flat-large-fixture.test.js

@@ -0,0 +1,99 @@
+/**
+ * Determinism + warm-safety + structural contract of the flat-large fixture
+ * generator (`_flat-large-fixture.ts`, ADR-0045 B1 measurement plane):
+ *
+ *   (a) byte-identity — two generations with the same spec are identical
+ *       file-by-file;
+ *   (b) warm-safety — re-invoking on an existing dir is a strict no-op
+ *       (`skipped: true`, mtimes unchanged — the fragment cache fingerprint
+ *       is mtime+size, so any rewrite would poison warm measurements);
+ *   (c) resolvable imports — every emitted relative specifier resolves to a
+ *       generated file;
+ *   (d) misalignment — each `src/dN` directory mixes files from more than
+ *       one cluster (otherwise `hybrid` would trivially win the experiment).
+ */
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, posix } from 'node:path';
+import { afterAll, describe, expect, it } from 'vitest';
+import { generateFlatLargeFixture } from './_flat-large-fixture.js';
+const SMALL_SPEC = { fileCount: 60 };
+const work = mkdtempSync(join(tmpdir(), 'flat-large-fixture-test-'));
+afterAll(() => {
+    rmSync(work, { recursive: true, force: true });
+});
+/** Walk a generated tree, returning sorted POSIX-relative file paths. */
+function listFiles(root, rel = '') {
+    const out = [];
+    for (const entry of readdirSync(join(root, rel), { withFileTypes: true })) {
+        const entryRel = rel === '' ? entry.name : `${rel}/${entry.name}`;
+        if (entry.isDirectory())
+            out.push(...listFiles(root, entryRel));
+        else
+            out.push(entryRel);
+    }
+    out.sort();
+    return out;
+}
+describe('generateFlatLargeFixture', () => {
+    it('(a) two generations with the same spec are byte-identical file-by-file', () => {
+        const a = join(work, 'gen-a');
+        const b = join(work, 'gen-b');
+        const resultA = generateFlatLargeFixture(a, SMALL_SPEC);
+        const resultB = generateFlatLargeFixture(b, SMALL_SPEC);
+        expect(resultA).toEqual({ fileCount: 60, clusterCount: 30, skipped: false });
+        expect(resultB.skipped).toBe(false);
+        const filesA = listFiles(a);
+        expect(filesA).toEqual(listFiles(b));
+        expect(filesA.length).toBe(60 + 2); // 60 sources + package.json + tsconfig.json
+        for (const rel of filesA) {
+            expect(readFileSync(join(a, rel), 'utf8')).toBe(readFileSync(join(b, rel), 'utf8'));
+        }
+    });
+    it('(b) re-invoking on an existing dir is a no-op (skipped: true, mtimes unchanged)', () => {
+        const dir = join(work, 'gen-warm');
+        generateFlatLargeFixture(dir, SMALL_SPEC);
+        const before = new Map(listFiles(dir).map((rel) => [rel, statSync(join(dir, rel)).mtimeMs]));
+        const again = generateFlatLargeFixture(dir, SMALL_SPEC);
+        expect(again.skipped).toBe(true);
+        const after = listFiles(dir);
+        expect(after).toEqual([...before.keys()].sort());
+        for (const rel of after) {
+            expect(statSync(join(dir, rel)).mtimeMs).toBe(before.get(rel));
+        }
+    });
+    it('(c) every emitted import specifier resolves to a generated file', () => {
+        const dir = join(work, 'gen-imports');
+        generateFlatLargeFixture(dir, SMALL_SPEC);
+        const sources = listFiles(dir).filter((rel) => rel.endsWith('.ts'));
+        let importCount = 0;
+        for (const rel of sources) {
+            const text = readFileSync(join(dir, rel), 'utf8');
+            for (const match of text.matchAll(/from '([^']+)'/g)) {
+                importCount++;
+                const spec = match[1] ?? '';
+                const targetRel = posix.join(posix.dirname(rel), spec.replace(/\.js$/, '.ts'));
+                expect(existsSync(join(dir, targetRel)), `${rel} imports missing ${spec}`).toBe(true);
+            }
+        }
+        expect(importCount).toBeGreaterThan(0);
+    });
+    it('(d) each src/dN directory mixes files from more than one cluster', () => {
+        const dir = join(work, 'gen-mix');
+        const { clusterCount } = generateFlatLargeFixture(dir, SMALL_SPEC);
+        const byDir = new Map();
+        for (const rel of listFiles(dir)) {
+            const match = /^src\/(d\d+)\/f(\d+)\.ts$/.exec(rel);
+            if (match === null)
+                continue;
+            const clusters = byDir.get(match[1] ?? '') ?? new Set();
+            clusters.add(Number(match[2]) % clusterCount);
+            byDir.set(match[1] ?? '', clusters);
+        }
+        expect(byDir.size).toBeGreaterThan(1);
+        for (const [dirName, clusters] of byDir) {
+            expect(clusters.size, `${dirName} holds a single cluster`).toBeGreaterThan(1);
+        }
+    });
+});
+//# sourceMappingURL=flat-large-fixture.test.js.map

package/dist/cli/orchestrate/__tests__/flat-large-fixture.test.js.map

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