@opensip-cli/graph 0.1.0

package/dist/__tests__/render/catalog-json.test.js

@@ -0,0 +1,435 @@
+// @fitness-ignore-file file-length-limit -- behavior fixture suite; related scenarios stay together while covered domains are split into focused tests.
+/**
+ * Tests for the catalog JSON renderer.
+ *
+ * Coverage:
+ *   1. Golden-fixture snapshot of a small representative catalog —
+ *      locks the wire format byte-for-byte.
+ *   2. Symbol-row invariants: id matches `deriveOpenSipSymbolId`
+ *      output, kind mapping, arity derivation, modulePath
+ *      derivation, isExported from visibility.
+ *   3. Edge-row invariants: id matches `deriveOpenSipEdgeId`,
+ *      polymorphic edges split into multiple rows, unresolved edges
+ *      carry the call-text as `toQualifiedNameUnresolved`.
+ *   4. Stable ordering: re-rendering the same catalog produces
+ *      byte-identical output.
+ *
+ * Phase 3 Task 3.3 per DEC-498.
+ */
+import { describe, expect, it } from 'vitest';
+import { renderCatalogJson } from '../../render/catalog-json.js';
+import { deriveOpenSipEdgeId, deriveOpenSipModulePath, deriveOpenSipSymbolId, } from '../../render/opensip-id-derivation.js';
+const REPO_ID = 'REP_test_repo';
+const GIT_SHA = 'abc1234567890abc1234567890abc1234567890a';
+const TENANT_ID = 'tenant_test';
+function makeProvenance() {
+    return {
+        runId: 'run_test_2026_05_27',
+        completeness: 'complete',
+        engineVersion: '1.0.0',
+        startedAt: '2026-05-27T00:00:00.000Z',
+        completedAt: '2026-05-27T00:01:00.000Z',
+        tenantId: TENANT_ID,
+    };
+}
+const FORMAT_NAME_OCCURRENCE = {
+    bodyHash: 'hash_format_name',
+    simpleName: 'formatName',
+    qualifiedName: 'src/format.formatName',
+    filePath: 'src/format.ts',
+    line: 10,
+    column: 0,
+    endLine: 15,
+    kind: 'function-declaration',
+    params: [{ name: 'raw', optional: false, rest: false }],
+    returnType: 'string',
+    enclosingClass: null,
+    decorators: [],
+    visibility: 'exported',
+    inTestFile: false,
+    definedInGenerated: false,
+    calls: [],
+};
+const GREET_OCCURRENCE = {
+    bodyHash: 'hash_greet',
+    simpleName: 'greet',
+    qualifiedName: 'src/greet.greet',
+    filePath: 'src/greet.ts',
+    line: 5,
+    column: 0,
+    endLine: 12,
+    kind: 'function-declaration',
+    params: [],
+    returnType: 'void',
+    enclosingClass: null,
+    decorators: [],
+    visibility: 'module-local',
+    inTestFile: false,
+    definedInGenerated: false,
+    calls: [
+        // Resolved call: greet → formatName
+        {
+            to: ['hash_format_name'],
+            line: 7,
+            column: 2,
+            resolution: 'static',
+            confidence: 'high',
+            text: 'formatName(rawName)',
+        },
+        // Unresolved call: external function
+        {
+            to: [],
+            line: 8,
+            column: 2,
+            resolution: 'unknown',
+            confidence: 'low',
+            text: 'externalLib.log("hi")',
+        },
+    ],
+};
+const FIXTURE_CATALOG = {
+    version: '3.0',
+    tool: 'graph',
+    language: 'typescript',
+    builtAt: '2026-05-27T00:00:00.000Z',
+    cacheKey: 'ts-5.7.0-test',
+    filesFingerprint: 'test-fp',
+    functions: {
+        greet: [GREET_OCCURRENCE],
+        formatName: [FORMAT_NAME_OCCURRENCE],
+    },
+};
+const FIXTURE_INDEXES = {
+    byBodyHash: new Map([
+        ['hash_greet', GREET_OCCURRENCE],
+        ['hash_format_name', FORMAT_NAME_OCCURRENCE],
+    ]),
+    byOccId: new Map(),
+    occurrencesByHash: new Map([
+        ['hash_greet', [GREET_OCCURRENCE]],
+        ['hash_format_name', [FORMAT_NAME_OCCURRENCE]],
+    ]),
+    importedPackagesByFile: new Map(),
+    bySimpleName: new Map([
+        ['greet', ['hash_greet']],
+        ['formatName', ['hash_format_name']],
+    ]),
+    callees: new Map(),
+    callers: new Map(),
+};
+describe('renderCatalogJson — golden fixture', () => {
+    it('matches the recorded shape for the test catalog', async () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        await expect(json).toMatchFileSnapshot('./__fixtures__/catalog-json/two-functions.json');
+    });
+});
+describe('renderCatalogJson — symbol rows', () => {
+    it('every symbol id matches deriveOpenSipSymbolId output', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        for (const sym of parsed.symbols) {
+            const expected = deriveOpenSipSymbolId({
+                repoId: REPO_ID,
+                modulePath: sym.modulePath,
+                kind: sym.kind,
+                qualifiedName: sym.qualifiedName,
+                arity: sym.arity,
+            });
+            expect(sym.id).toBe(expected);
+        }
+    });
+    it('modulePath strips the .ts extension', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        for (const sym of parsed.symbols) {
+            expect(sym.modulePath).toBe(deriveOpenSipModulePath(sym.filePath));
+            expect(sym.modulePath.endsWith('.ts')).toBe(false);
+        }
+    });
+    it('arity is derived from params.length', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        const greet = parsed.symbols.find((s) => s.qualifiedName === 'src/greet.greet');
+        const formatName = parsed.symbols.find((s) => s.qualifiedName === 'src/format.formatName');
+        expect(greet?.arity).toBe(0);
+        expect(formatName?.arity).toBe(1);
+    });
+    it('isExported reflects FunctionOccurrence.visibility', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        const greet = parsed.symbols.find((s) => s.qualifiedName === 'src/greet.greet');
+        const formatName = parsed.symbols.find((s) => s.qualifiedName === 'src/format.formatName');
+        expect(greet?.isExported).toBe(false); // visibility: 'module-local'
+        expect(formatName?.isExported).toBe(true); // visibility: 'exported'
+    });
+});
+describe('renderCatalogJson — edge rows', () => {
+    it('emits one resolved + one unresolved edge from the greet occurrence', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        expect(parsed.edges).toHaveLength(2);
+        const resolved = parsed.edges.find((e) => e.toSymbolId !== null);
+        const unresolved = parsed.edges.find((e) => e.toSymbolId === null);
+        expect(resolved?.edgeKind).toBe('calls');
+        expect(resolved?.sourceLine).toBe(7);
+        expect(unresolved?.toQualifiedNameUnresolved).toBe('externalLib.log("hi")');
+        expect(unresolved?.sourceLine).toBe(8);
+    });
+    it('every edge id matches deriveOpenSipEdgeId output', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        for (const edge of parsed.edges) {
+            const expected = deriveOpenSipEdgeId({
+                fromSymbolId: edge.fromSymbolId,
+                edgeKind: edge.edgeKind,
+                toSymbolId: edge.toSymbolId,
+                toQualifiedNameUnresolved: edge.toQualifiedNameUnresolved,
+            });
+            expect(edge.id).toBe(expected);
+        }
+    });
+});
+describe('renderCatalogJson — invariants', () => {
+    it('output is byte-identical across two renders of the same input', () => {
+        const a = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const b = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        expect(a).toBe(b);
+    });
+    it('provenance.tenantId is preserved verbatim', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        expect(parsed.provenance.tenantId).toBe(TENANT_ID);
+    });
+    it('every row carries the input repoId + gitSha', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        for (const sym of parsed.symbols) {
+            expect(sym.repoId).toBe(REPO_ID);
+            expect(sym.gitSha).toBe(GIT_SHA);
+        }
+        for (const edge of parsed.edges) {
+            expect(edge.repoId).toBe(REPO_ID);
+            expect(edge.gitSha).toBe(GIT_SHA);
+        }
+    });
+    it('version is "1.0"', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        expect(parsed.version).toBe('1.0');
+    });
+});
+// ── Phase 4 (DEC-498) — dependency edges ──────────────────────────────
+const FORMAT_MODULE_INIT = {
+    bodyHash: 'hash_module_init_format',
+    simpleName: '<module-init:src/format.ts>',
+    qualifiedName: '<module-init:src/format>',
+    filePath: 'src/format.ts',
+    line: 1,
+    column: 0,
+    endLine: 20,
+    kind: 'module-init',
+    params: [],
+    returnType: null,
+    enclosingClass: null,
+    decorators: [],
+    visibility: 'module-local',
+    inTestFile: false,
+    definedInGenerated: false,
+    calls: [],
+};
+const GREET_MODULE_INIT = {
+    bodyHash: 'hash_module_init_greet',
+    simpleName: '<module-init:src/greet.ts>',
+    qualifiedName: '<module-init:src/greet>',
+    filePath: 'src/greet.ts',
+    line: 1,
+    column: 0,
+    endLine: 15,
+    kind: 'module-init',
+    params: [],
+    returnType: null,
+    enclosingClass: null,
+    decorators: [],
+    visibility: 'module-local',
+    inTestFile: false,
+    definedInGenerated: false,
+    calls: [],
+    dependencies: [
+        // Resolved internal import: greet → format
+        {
+            to: ['hash_module_init_format'],
+            line: 2,
+            column: 0,
+            specifier: './format.js',
+        },
+        // Unresolved external import: greet → external pkg
+        {
+            to: [],
+            line: 3,
+            column: 0,
+            specifier: '@opensip/core',
+        },
+    ],
+};
+const FIXTURE_CATALOG_WITH_DEPS = {
+    version: '3.0',
+    tool: 'graph',
+    language: 'typescript',
+    builtAt: '2026-05-27T00:00:00.000Z',
+    cacheKey: 'ts-5.7.0-test',
+    filesFingerprint: 'test-fp-deps',
+    functions: {
+        '<module-init:src/format.ts>': [FORMAT_MODULE_INIT],
+        '<module-init:src/greet.ts>': [GREET_MODULE_INIT],
+    },
+};
+const FIXTURE_INDEXES_WITH_DEPS = {
+    byBodyHash: new Map([
+        ['hash_module_init_format', FORMAT_MODULE_INIT],
+        ['hash_module_init_greet', GREET_MODULE_INIT],
+    ]),
+    byOccId: new Map(),
+    occurrencesByHash: new Map([
+        ['hash_module_init_format', [FORMAT_MODULE_INIT]],
+        ['hash_module_init_greet', [GREET_MODULE_INIT]],
+    ]),
+    importedPackagesByFile: new Map(),
+    bySimpleName: new Map(),
+    callees: new Map(),
+    callers: new Map(),
+};
+describe('renderCatalogJson — dependency edges (Phase 4)', () => {
+    it('emits one resolved + one unresolved depends_on edge from greet module-init', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG_WITH_DEPS,
+            indexes: FIXTURE_INDEXES_WITH_DEPS,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        const dependsEdges = parsed.edges.filter((e) => e.edgeKind === 'depends_on');
+        expect(dependsEdges).toHaveLength(2);
+        const resolved = dependsEdges.find((e) => e.toSymbolId !== null);
+        const unresolved = dependsEdges.find((e) => e.toSymbolId === null);
+        expect(resolved?.sourceFile).toBe('src/greet.ts');
+        expect(resolved?.sourceLine).toBe(2);
+        expect(resolved?.toQualifiedNameUnresolved).toBeNull();
+        expect(unresolved?.toQualifiedNameUnresolved).toBe('@opensip/core');
+        expect(unresolved?.sourceLine).toBe(3);
+    });
+    it('depends_on edge id matches deriveOpenSipEdgeId', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG_WITH_DEPS,
+            indexes: FIXTURE_INDEXES_WITH_DEPS,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        for (const edge of parsed.edges.filter((e) => e.edgeKind === 'depends_on')) {
+            const expected = deriveOpenSipEdgeId({
+                fromSymbolId: edge.fromSymbolId,
+                edgeKind: edge.edgeKind,
+                toSymbolId: edge.toSymbolId,
+                toQualifiedNameUnresolved: edge.toQualifiedNameUnresolved,
+            });
+            expect(edge.id).toBe(expected);
+        }
+    });
+    it('occurrence without dependencies field produces no depends_on edges', () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG,
+            indexes: FIXTURE_INDEXES,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        const parsed = JSON.parse(json);
+        const dependsEdges = parsed.edges.filter((e) => e.edgeKind === 'depends_on');
+        expect(dependsEdges).toHaveLength(0);
+    });
+    it('depends_on golden fixture lock', async () => {
+        const json = renderCatalogJson({
+            catalog: FIXTURE_CATALOG_WITH_DEPS,
+            indexes: FIXTURE_INDEXES_WITH_DEPS,
+            provenance: makeProvenance(),
+            repoId: REPO_ID,
+            gitSha: GIT_SHA,
+        });
+        await expect(json).toMatchFileSnapshot('./__fixtures__/catalog-json/two-modules-with-deps.json');
+    });
+});
+//# sourceMappingURL=catalog-json.test.js.map

package/dist/__tests__/render/catalog-json.test.js.map

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

package/dist/__tests__/render/opensip-id-derivation.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tests for the engine-side mirror of opensip's content-derived
+ * symbol-ID / edge-ID hashing.
+ *
+ * Covers two layers:
+ *   1. Golden hex values — locks the algorithm byte-for-byte.
+ *      Computed independently via `node:crypto` against the exact
+ *      canonicalization string opensip's `computeSymbolId` produces.
+ *      A change to either side's algorithm fails these.
+ *   2. Invariants — determinism, divergence across each input field,
+ *      arity-null vs arity-0 distinction, unresolved-edge differentiation.
+ *
+ * Cross-repo validation (engine ↔ opensip symbol-id.ts byte-equivalence)
+ * belongs in a parity test that can import both implementations. The golden
+ * values here are pre-computed against opensip's algorithm and pin the local
+ * mirror until such a cross-repo fixture is available.
+ *
+ * Phase 3 Task 3.2 per DEC-498.
+ */
+export {};
+//# sourceMappingURL=opensip-id-derivation.test.d.ts.map

package/dist/__tests__/render/opensip-id-derivation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opensip-id-derivation.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/render/opensip-id-derivation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/__tests__/render/opensip-id-derivation.test.js

@@ -0,0 +1,159 @@
+/**
+ * Tests for the engine-side mirror of opensip's content-derived
+ * symbol-ID / edge-ID hashing.
+ *
+ * Covers two layers:
+ *   1. Golden hex values — locks the algorithm byte-for-byte.
+ *      Computed independently via `node:crypto` against the exact
+ *      canonicalization string opensip's `computeSymbolId` produces.
+ *      A change to either side's algorithm fails these.
+ *   2. Invariants — determinism, divergence across each input field,
+ *      arity-null vs arity-0 distinction, unresolved-edge differentiation.
+ *
+ * Cross-repo validation (engine ↔ opensip symbol-id.ts byte-equivalence)
+ * belongs in a parity test that can import both implementations. The golden
+ * values here are pre-computed against opensip's algorithm and pin the local
+ * mirror until such a cross-repo fixture is available.
+ *
+ * Phase 3 Task 3.2 per DEC-498.
+ */
+import { describe, expect, it } from 'vitest';
+import { deriveOpenSipEdgeId, deriveOpenSipModulePath, deriveOpenSipSymbolId, } from '../../render/opensip-id-derivation.js';
+describe('deriveOpenSipSymbolId — golden hex values', () => {
+    it('produces the canonical hash for a typical function symbol', () => {
+        expect(deriveOpenSipSymbolId({
+            repoId: 'REP_acme',
+            modulePath: 'packages/foo/src/bar',
+            kind: 'function',
+            qualifiedName: 'packages/foo/src/bar.greet',
+            arity: 1,
+        })).toBe('e2746cfead3b80b415c706ce0b1402259e3c24c4ba860ef7fcab1aedfa6e7a3b');
+    });
+    it('arity 0 differs from arity null (the empty-string vs "0" distinction)', () => {
+        expect(deriveOpenSipSymbolId({
+            repoId: 'REP_acme',
+            modulePath: 'packages/foo/src/bar',
+            kind: 'function',
+            qualifiedName: 'packages/foo/src/bar.greet',
+            arity: 0,
+        })).toBe('bb2797ecd3b90cb7e9d7d7f1e3363c11dcaa7efe9ea379f2883fd74975fe3746');
+        expect(deriveOpenSipSymbolId({
+            repoId: 'REP_acme',
+            modulePath: 'packages/foo/src/bar',
+            kind: 'function',
+            qualifiedName: 'packages/foo/src/bar.greet',
+            arity: null,
+        })).toBe('f21ecbb7ce5dc7b3900d7d302ad7d03c946541d54a63c90afa3c1b64c420a0c7');
+    });
+});
+describe('deriveOpenSipSymbolId — invariants', () => {
+    it('is deterministic — identical input produces identical hash', () => {
+        const input = {
+            repoId: 'REP_acme',
+            modulePath: 'm/n',
+            kind: 'function',
+            qualifiedName: 'm.n.greet',
+            arity: 1,
+        };
+        expect(deriveOpenSipSymbolId(input)).toBe(deriveOpenSipSymbolId(input));
+    });
+    it('produces 64-char hex output', () => {
+        expect(deriveOpenSipSymbolId({
+            repoId: 'r',
+            modulePath: 'm',
+            kind: 'function',
+            qualifiedName: 'q',
+            arity: 0,
+        })).toMatch(/^[0-9a-f]{64}$/);
+    });
+    it('different repoId produces different hash', () => {
+        const base = {
+            modulePath: 'm',
+            kind: 'function',
+            qualifiedName: 'm.f',
+            arity: 0,
+        };
+        expect(deriveOpenSipSymbolId({ ...base, repoId: 'r_a' })).not.toBe(deriveOpenSipSymbolId({ ...base, repoId: 'r_b' }));
+    });
+    it('different qualifiedName produces different hash', () => {
+        const base = { repoId: 'r', modulePath: 'm', kind: 'function', arity: 0 };
+        expect(deriveOpenSipSymbolId({ ...base, qualifiedName: 'a' })).not.toBe(deriveOpenSipSymbolId({ ...base, qualifiedName: 'b' }));
+    });
+    it('different kind produces different hash', () => {
+        const base = { repoId: 'r', modulePath: 'm', qualifiedName: 'q', arity: 0 };
+        expect(deriveOpenSipSymbolId({ ...base, kind: 'function' })).not.toBe(deriveOpenSipSymbolId({ ...base, kind: 'method' }));
+    });
+});
+describe('deriveOpenSipEdgeId — golden hex values', () => {
+    it('resolved edge', () => {
+        expect(deriveOpenSipEdgeId({
+            fromSymbolId: 'hash_A',
+            edgeKind: 'calls',
+            toSymbolId: 'hash_B',
+            toQualifiedNameUnresolved: null,
+        })).toBe('a0189de0e83a866ded1a039ba6a64f9aaf3df50fc0b10227e43339c92f732334');
+    });
+    it('unresolved edge — qname only', () => {
+        expect(deriveOpenSipEdgeId({
+            fromSymbolId: 'hash_A',
+            edgeKind: 'calls',
+            toSymbolId: null,
+            toQualifiedNameUnresolved: 'externalLib.someFn',
+        })).toBe('fca1ed2df3b1a37ca1a934b9bc04a73742b4d001e4120095e78f056100aaead9');
+    });
+    it('both targets null — canonicalized as "unresolved:"', () => {
+        expect(deriveOpenSipEdgeId({
+            fromSymbolId: 'hash_A',
+            edgeKind: 'calls',
+            toSymbolId: null,
+            toQualifiedNameUnresolved: null,
+        })).toBe('71187d153a18a0895fdcc33d9dd3309360be01a8e88ccf9d105577f155760523');
+    });
+});
+describe('deriveOpenSipEdgeId — invariants', () => {
+    it('two distinct unresolved qnames produce different hashes', () => {
+        const a = deriveOpenSipEdgeId({
+            fromSymbolId: 'x',
+            edgeKind: 'calls',
+            toSymbolId: null,
+            toQualifiedNameUnresolved: 'fnA',
+        });
+        const b = deriveOpenSipEdgeId({
+            fromSymbolId: 'x',
+            edgeKind: 'calls',
+            toSymbolId: null,
+            toQualifiedNameUnresolved: 'fnB',
+        });
+        expect(a).not.toBe(b);
+    });
+    it('resolved vs unresolved with same qname produce different hashes', () => {
+        const resolved = deriveOpenSipEdgeId({
+            fromSymbolId: 'x',
+            edgeKind: 'calls',
+            toSymbolId: 'y',
+            toQualifiedNameUnresolved: null,
+        });
+        const unresolved = deriveOpenSipEdgeId({
+            fromSymbolId: 'x',
+            edgeKind: 'calls',
+            toSymbolId: null,
+            toQualifiedNameUnresolved: 'y',
+        });
+        expect(resolved).not.toBe(unresolved);
+    });
+});
+describe('deriveOpenSipModulePath', () => {
+    it('strips the extension when the last dot is in the basename', () => {
+        expect(deriveOpenSipModulePath('packages/foo/src/bar.ts')).toBe('packages/foo/src/bar');
+    });
+    it('returns input unchanged when basename has no extension', () => {
+        expect(deriveOpenSipModulePath('packages/foo/src/bar')).toBe('packages/foo/src/bar');
+    });
+    it('normalizes Windows backslashes to POSIX separators', () => {
+        expect(deriveOpenSipModulePath(String.raw `packages\foo\src\bar.go`)).toBe('packages/foo/src/bar');
+    });
+    it('preserves dot in dirname (no extension stripped)', () => {
+        expect(deriveOpenSipModulePath('.config/release.notes')).toBe('.config/release');
+    });
+});
+//# sourceMappingURL=opensip-id-derivation.test.js.map

package/dist/__tests__/render/opensip-id-derivation.test.js.map

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

package/dist/__tests__/render/rule-id-mapping.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tests for the engine-slug → OpenSIP-rule-ID mapping (Phase 2 Task 2.1).
+ *
+ * Coverage invariants:
+ *   1. Every rule in `currentRules()` (the built-in registry) has an
+ *      entry in `RULE_ID_MAPPING`. Adding a rule without updating the
+ *      mapping fails this test.
+ *   2. Every mapped value matches the OpenSIP rule-ID regex
+ *      (`graph.<family>.<rule>`).
+ *   3. Unknown slugs throw `ValidationError`.
+ */
+export {};
+//# sourceMappingURL=rule-id-mapping.test.d.ts.map

package/dist/__tests__/render/rule-id-mapping.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-id-mapping.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/render/rule-id-mapping.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}