@opensip-cli/graph 0.1.0

package/dist/__tests__/cli/orchestrate.test.js

@@ -0,0 +1,315 @@
+/**
+ * Tests for the pipeline orchestrator (`runGraph`).
+ *
+ * The orchestrator wires a `GraphLanguageAdapter`'s discoverFiles /
+ * parseProject / walkProject / resolveCallSites + index building +
+ * rule evaluation into a single linear pipeline, with a cache-hit
+ * fast-path and a Wave 4 incremental rebuild path. We drive it with a
+ * synthetic adapter that returns deterministic catalog data so each
+ * branch of `obtainCatalog` is reachable.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { runWithScope, runWithScopeSync } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { runGraph } from '../../cli/orchestrate.js';
+import { currentAdapterRegistry } from '../../lang-adapter/registry.js';
+import { CatalogRepo } from '../../persistence/catalog-repo.js';
+import { makeGraphTestScope } from '../test-utils/with-graph-scope.js';
+function fakeAdapter(input) {
+    const id = input.id ?? 'fake';
+    const cacheKey = input.cacheKey ?? 'fake-key-1';
+    const occurrences = input.occurrences ?? {};
+    const files = input.files ?? [join(input.projectDir, 'src', 'a.ts')];
+    return {
+        id,
+        fileExtensions: ['.ts'],
+        displayName: id,
+        discoverFiles: () => ({
+            projectDirAbs: input.projectDir,
+            files,
+            configPathAbs: input.configPathAbs,
+            compilerOptions: input.compilerOptions,
+        }),
+        parseProject: () => ({ project: { token: 'parsed' }, parseErrors: [] }),
+        walkProject: () => ({
+            occurrences,
+            callSites: [],
+            parseErrors: [],
+        }),
+        resolveCallSites: () => ({
+            edgesByOwner: new Map(),
+            stats: {
+                totalCallSites: 0,
+                resolvedHigh: 0,
+                resolvedMedium: 0,
+                resolvedLow: 0,
+                unresolved: 0,
+            },
+        }),
+        cacheKey: () => cacheKey,
+        ruleHints: input.ruleHints,
+    };
+}
+function occurrence(over) {
+    return {
+        bodyHash: 'h1',
+        bodySize: 100,
+        simpleName: 'fn',
+        qualifiedName: 'src/a.fn',
+        filePath: 'src/a.ts',
+        line: 1,
+        column: 0,
+        endLine: 5,
+        kind: 'function-declaration',
+        params: [],
+        returnType: null,
+        enclosingClass: null,
+        decorators: [],
+        visibility: 'module-local',
+        inTestFile: false,
+        definedInGenerated: false,
+        calls: [],
+        ...over,
+    };
+}
+describe('runGraph orchestrator', () => {
+    let datastore;
+    let projectDir;
+    let scope;
+    beforeEach(() => {
+        // Item 1: graph registries are per-RunScope.
+        scope = makeGraphTestScope();
+        datastore = DataStoreFactory.open({ backend: 'memory' });
+        projectDir = mkdtempSync(join(tmpdir(), 'orch-proj-'));
+    });
+    afterEach(() => {
+        runWithScopeSync(scope, () => currentAdapterRegistry().clear());
+        datastore.close();
+        rmSync(projectDir, { recursive: true, force: true });
+    });
+    function inGraphScope(fn) {
+        return runWithScope(scope, fn);
+    }
+    it('runs every pipeline stage end-to-end and emits a catalog with no signals', async () => {
+        await inGraphScope(async () => {
+            currentAdapterRegistry().register(fakeAdapter({
+                projectDir,
+                occurrences: {
+                    fn: [occurrence({ bodyHash: 'h1', simpleName: 'fn' })],
+                },
+            }));
+            const result = await runGraph({ cwd: projectDir, noCache: true, rules: [] });
+            expect(result.catalog).not.toBeNull();
+            expect(result.catalog?.language).toBe('fake');
+            expect(result.indexes).not.toBeNull();
+            expect(result.signals).toEqual([]);
+            expect(result.cacheHit).toBe(false);
+            expect(result.resolutionStats).not.toBeNull();
+        });
+    });
+    it('emits stage-start / stage-done progress events in canonical order', async () => {
+        await inGraphScope(async () => {
+            currentAdapterRegistry().register(fakeAdapter({ projectDir }));
+            const events = [];
+            await runGraph({
+                cwd: projectDir,
+                noCache: true,
+                rules: [],
+                onProgress: (e) => {
+                    events.push(`${e.type}:${e.stage}`);
+                },
+            });
+            const stageStarts = events.filter((e) => e.startsWith('stage-start:'));
+            const stageDones = events.filter((e) => e.startsWith('stage-done:'));
+            expect(stageStarts).toEqual([
+                'stage-start:discover',
+                'stage-start:parse',
+                'stage-start:walk',
+                'stage-start:resolve',
+                'stage-start:index',
+                'stage-start:features',
+                'stage-start:rules',
+            ]);
+            expect(stageDones).toEqual([
+                'stage-done:discover',
+                'stage-done:parse',
+                'stage-done:walk',
+                'stage-done:resolve',
+                'stage-done:index',
+                'stage-done:features',
+                'stage-done:rules',
+            ]);
+        });
+    });
+    it('writes the catalog to the datastore when one is provided and cache is enabled', async () => {
+        await inGraphScope(async () => {
+            currentAdapterRegistry().register(fakeAdapter({
+                projectDir,
+                occurrences: {
+                    fn: [occurrence({ bodyHash: 'h-persisted', simpleName: 'fn' })],
+                },
+            }));
+            const result = await runGraph({ cwd: projectDir, rules: [], datastore });
+            expect(result.cacheHit).toBe(false);
+            const persisted = new CatalogRepo(datastore).loadFullCatalog();
+            expect(persisted).not.toBeNull();
+            expect(persisted?.functions.fn?.[0]?.bodyHash).toBe('h-persisted');
+        });
+    });
+    it('returns a cache hit when the persisted catalog matches the current key', async () => {
+        await inGraphScope(async () => {
+            const adapter = fakeAdapter({
+                projectDir,
+                cacheKey: 'stable-key',
+                files: [join(projectDir, 'src', 'a.ts')],
+                occurrences: {
+                    fn: [occurrence({ bodyHash: 'h-fresh', simpleName: 'fn' })],
+                },
+            });
+            currentAdapterRegistry().register(adapter);
+            await runGraph({ cwd: projectDir, rules: [], datastore });
+            const events = [];
+            const result = await runGraph({
+                cwd: projectDir,
+                rules: [],
+                datastore,
+                onProgress: (e) => {
+                    if (e.type === 'stage-cached')
+                        events.push(e.stage);
+                },
+            });
+            expect(result.cacheHit).toBe(true);
+            expect(result.catalog).not.toBeNull();
+            expect(events).toEqual(['parse', 'walk', 'resolve']);
+            expect(result.resolutionStats).toBeNull();
+        });
+    });
+    it('runs rules against the produced catalog + indexes', async () => {
+        await inGraphScope(async () => {
+            currentAdapterRegistry().register(fakeAdapter({
+                projectDir,
+                occurrences: {
+                    fn: [occurrence({ bodyHash: 'h1', simpleName: 'fn' })],
+                },
+            }));
+            const evaluate = vi.fn().mockReturnValue([]);
+            const rule = { slug: 'graph:test', defaultSeverity: 'warning', evaluate };
+            const result = await runGraph({ cwd: projectDir, noCache: true, rules: [rule] });
+            expect(evaluate).toHaveBeenCalledTimes(1);
+            expect(result.signals).toEqual([]);
+        });
+    });
+    it('passes the runtime tsConfigPath override into adapter.discoverFiles', async () => {
+        await inGraphScope(async () => {
+            const seen = [];
+            const a = fakeAdapter({ projectDir });
+            const spy = vi.spyOn(a, 'discoverFiles').mockImplementation((inp) => {
+                seen.push(inp.configPathOverride ?? 'absent');
+                return { projectDirAbs: projectDir, files: [join(projectDir, 'src', 'a.ts')] };
+            });
+            currentAdapterRegistry().register(a);
+            await runGraph({
+                cwd: projectDir,
+                noCache: true,
+                rules: [],
+                tsConfigPath: join(projectDir, 'tsconfig.json'),
+            });
+            expect(seen).toEqual([join(projectDir, 'tsconfig.json')]);
+            spy.mockRestore();
+        });
+    });
+    it('skips writing to the datastore when noCache is true', async () => {
+        await inGraphScope(async () => {
+            currentAdapterRegistry().register(fakeAdapter({ projectDir }));
+            await runGraph({ cwd: projectDir, noCache: true, rules: [], datastore });
+            expect(new CatalogRepo(datastore).hasAnyCatalog()).toBe(false);
+        });
+    });
+    // Guards a real correctness regression: prior to the fix the
+    // orchestrator called `rule.evaluate(catalog, indexes, config)` and
+    // dropped the fourth argument, so every non-TypeScript adapter's
+    // ruleHints (sideEffectPrimitives, throwSyntaxRegex, isTestFile,
+    // generatedFilePatterns) silently fell back to TS-shaped regex.
+    it("threads the active adapter's ruleHints into every rule's evaluate call", async () => {
+        await inGraphScope(async () => {
+            const hints = {
+                sideEffectPrimitives: ['builtins.print', 'sys.exit'],
+                throwSyntaxRegex: /^\s*raise\s+\w+/,
+                generatedFilePatterns: ['**/_pb2.py'],
+                isTestFile: (p) => p.startsWith('tests/'),
+            };
+            currentAdapterRegistry().register(fakeAdapter({ projectDir, ruleHints: hints }));
+            const seenHints = [];
+            const capturingRule = {
+                slug: 'graph:test-hints-capture',
+                defaultSeverity: 'warning',
+                evaluate: (_catalog, _indexes, _config, h) => {
+                    seenHints.push(h);
+                    return [];
+                },
+            };
+            await runGraph({ cwd: projectDir, rules: [capturingRule], datastore });
+            expect(seenHints).toHaveLength(1);
+            expect(seenHints[0]).toBe(hints);
+        });
+    });
+});
+describe('runGraph — incremental rebuild path', () => {
+    let datastore;
+    let dir;
+    let scope;
+    beforeEach(() => {
+        scope = makeGraphTestScope();
+        datastore = DataStoreFactory.open({ backend: 'memory' });
+        dir = mkdtempSync(join(tmpdir(), 'orch-incr-'));
+    });
+    afterEach(() => {
+        runWithScopeSync(scope, () => currentAdapterRegistry().clear());
+        datastore.close();
+        rmSync(dir, { recursive: true, force: true });
+    });
+    function inGraphScope(fn) {
+        return runWithScope(scope, fn);
+    }
+    it('completes the incremental branch when a single file changes', async () => {
+        await inGraphScope(async () => {
+            const fileA = join(dir, 'src', 'a.ts');
+            const fileB = join(dir, 'src', 'b.ts');
+            mkdirSync(join(dir, 'src'), { recursive: true });
+            writeFileSync(fileA, 'v1');
+            writeFileSync(fileB, 'v1');
+            currentAdapterRegistry().register(fakeAdapter({
+                projectDir: dir,
+                cacheKey: 'k1',
+                files: [fileA, fileB],
+                occurrences: {
+                    fa: [occurrence({ bodyHash: 'hA', simpleName: 'fa', filePath: 'src/a.ts' })],
+                    fb: [occurrence({ bodyHash: 'hB', simpleName: 'fb', filePath: 'src/b.ts' })],
+                },
+            }));
+            await runGraph({ cwd: dir, rules: [], datastore });
+            writeFileSync(fileB, 'v2-changed');
+            currentAdapterRegistry().clear();
+            currentAdapterRegistry().register(fakeAdapter({
+                projectDir: dir,
+                cacheKey: 'k1',
+                files: [fileA, fileB],
+                occurrences: {
+                    fa: [occurrence({ bodyHash: 'hA', simpleName: 'fa', filePath: 'src/a.ts' })],
+                    fb: [occurrence({ bodyHash: 'hB-new', simpleName: 'fb', filePath: 'src/b.ts' })],
+                },
+            }));
+            const result = await runGraph({ cwd: dir, rules: [], datastore });
+            expect(result.catalog).not.toBeNull();
+            // The incremental path completes and produces a catalog without
+            // throwing. The merge semantics are exercised in detail by other
+            // tests (`graph-catalog-drift`); here we just want to drive the
+            // 'incremental' verdict branch in obtainCatalog.
+            expect(result.cacheHit).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=orchestrate.test.js.map

package/dist/__tests__/cli/orchestrate.test.js.map

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

package/dist/__tests__/cli/positional-paths.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for resolvePositionalPaths — happy paths and error branches.
+ */
+export {};
+//# sourceMappingURL=positional-paths.test.d.ts.map

package/dist/__tests__/cli/positional-paths.test.d.ts.map

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

package/dist/__tests__/cli/positional-paths.test.js

@@ -0,0 +1,87 @@
+/**
+ * Tests for resolvePositionalPaths — happy paths and error branches.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { ConfigurationError } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { positionalPathLabel, resolvePositionalPaths } from '../../cli/positional-paths.js';
+describe('resolvePositionalPaths', () => {
+    let cwd;
+    beforeEach(() => {
+        cwd = mkdtempSync(join(tmpdir(), 'osip-pos-'));
+    });
+    afterEach(() => {
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it('returns [] for an empty array', () => {
+        expect(resolvePositionalPaths([], cwd)).toEqual([]);
+    });
+    it('resolves a relative path against cwd', () => {
+        mkdirSync(join(cwd, 'sub'));
+        const result = resolvePositionalPaths(['sub'], cwd);
+        expect(result).toHaveLength(1);
+        expect(result[0]).toBe(resolve(cwd, 'sub'));
+        expect(isAbsolute(result[0] ?? '')).toBe(true);
+    });
+    it('passes through an absolute path', () => {
+        const abs = join(cwd, 'sub');
+        mkdirSync(abs);
+        const result = resolvePositionalPaths([abs], cwd);
+        expect(result).toEqual([abs]);
+    });
+    it('trims leading/trailing whitespace before resolution', () => {
+        mkdirSync(join(cwd, 'sub'));
+        const result = resolvePositionalPaths(['  sub  '], cwd);
+        expect(result[0]).toBe(resolve(cwd, 'sub'));
+    });
+    it('throws ConfigurationError on an empty string', () => {
+        expect(() => resolvePositionalPaths(['   '], cwd)).toThrow(ConfigurationError);
+        expect(() => resolvePositionalPaths(['   '], cwd)).toThrow(/empty/);
+    });
+    it('throws on a non-existent path and reports the original arg', () => {
+        let caught;
+        try {
+            resolvePositionalPaths(['nope'], cwd);
+        }
+        catch (error) {
+            caught = error;
+        }
+        expect(caught).toBeInstanceOf(ConfigurationError);
+        expect(caught.message).toContain('nope');
+        expect(caught.message).toContain('does not exist');
+    });
+    it('throws when the path is a file, not a directory', () => {
+        writeFileSync(join(cwd, 'file.txt'), 'hi');
+        expect(() => resolvePositionalPaths(['file.txt'], cwd)).toThrow(ConfigurationError);
+        expect(() => resolvePositionalPaths(['file.txt'], cwd)).toThrow(/not a directory/);
+    });
+    it('preserves argument order in the output', () => {
+        mkdirSync(join(cwd, 'a'));
+        mkdirSync(join(cwd, 'b'));
+        const result = resolvePositionalPaths(['b', 'a'], cwd);
+        expect(result.map((p) => p.split('/').pop())).toEqual(['b', 'a']);
+    });
+});
+describe('positionalPathLabel', () => {
+    let cwd;
+    beforeEach(() => {
+        cwd = mkdtempSync(join(tmpdir(), 'osip-pos-label-'));
+    });
+    afterEach(() => {
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it('returns "." when the path equals cwd', () => {
+        expect(positionalPathLabel(cwd, cwd)).toBe('.');
+    });
+    it('returns a relative label when the path is under cwd', () => {
+        const sub = join(cwd, 'a', 'b');
+        expect(positionalPathLabel(sub, cwd)).toBe('a/b');
+    });
+    it('returns the absolute path when not under cwd', () => {
+        const other = '/some/totally/different/path';
+        expect(positionalPathLabel(other, cwd)).toBe(other);
+    });
+});
+//# sourceMappingURL=positional-paths.test.js.map

package/dist/__tests__/cli/positional-paths.test.js.map

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

package/dist/__tests__/cli/pressure-monitor.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for the V8 pressure monitor.
+ *
+ * We can't reliably push the real V8 heap over the threshold in a unit
+ * test, so we exercise the monitor by varying its threshold instead.
+ * With threshold near 0, any non-empty heap trips it; with threshold
+ * 1.0, nothing does. This pins the comparison direction (used / limit)
+ * and the dispose contract.
+ */
+export {};
+//# sourceMappingURL=pressure-monitor.test.d.ts.map

package/dist/__tests__/cli/pressure-monitor.test.d.ts.map

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

package/dist/__tests__/cli/pressure-monitor.test.js

@@ -0,0 +1,94 @@
+/**
+ * Unit tests for the V8 pressure monitor.
+ *
+ * We can't reliably push the real V8 heap over the threshold in a unit
+ * test, so we exercise the monitor by varying its threshold instead.
+ * With threshold near 0, any non-empty heap trips it; with threshold
+ * 1.0, nothing does. This pins the comparison direction (used / limit)
+ * and the dispose contract.
+ */
+import { describe, it, expect } from 'vitest';
+import { createPressureMonitor, MemoryPressureError } from '../../cli/pressure-monitor.js';
+describe('createPressureMonitor', () => {
+    it('throws MemoryPressureError when threshold is exceeded', () => {
+        const monitor = createPressureMonitor({ threshold: 0, pollIntervalMs: 0 });
+        monitor.setStage('test-stage');
+        try {
+            expect(() => monitor.check()).toThrow(MemoryPressureError);
+        }
+        finally {
+            monitor.dispose();
+        }
+    });
+    it('attaches the bound stage name to the thrown error', () => {
+        const monitor = createPressureMonitor({ threshold: 0, pollIntervalMs: 0 });
+        monitor.setStage('walk');
+        try {
+            try {
+                monitor.check();
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(MemoryPressureError);
+                expect(error.stage).toBe('walk');
+            }
+        }
+        finally {
+            monitor.dispose();
+        }
+    });
+    it('does not throw when threshold is unreachable', () => {
+        const monitor = createPressureMonitor({ threshold: 1, pollIntervalMs: 0 });
+        try {
+            expect(() => monitor.check()).not.toThrow();
+        }
+        finally {
+            monitor.dispose();
+        }
+    });
+    it('respects OPENSIP_HEAP_NO_MONITOR=1 escape hatch', () => {
+        const prev = process.env.OPENSIP_HEAP_NO_MONITOR;
+        process.env.OPENSIP_HEAP_NO_MONITOR = '1';
+        try {
+            const monitor = createPressureMonitor({ threshold: 0, pollIntervalMs: 0 });
+            expect(() => monitor.check()).not.toThrow();
+            monitor.dispose();
+        }
+        finally {
+            if (prev === undefined) {
+                delete process.env.OPENSIP_HEAP_NO_MONITOR;
+            }
+            else {
+                process.env.OPENSIP_HEAP_NO_MONITOR = prev;
+            }
+        }
+    });
+    it('dispose is idempotent', () => {
+        const monitor = createPressureMonitor({ threshold: 1 });
+        monitor.dispose();
+        expect(() => monitor.dispose()).not.toThrow();
+    });
+    it('re-throws the same error on a subsequent check after a trip', () => {
+        const monitor = createPressureMonitor({ threshold: 0, pollIntervalMs: 0 });
+        try {
+            let first;
+            try {
+                monitor.check();
+            }
+            catch (error) {
+                first = error;
+            }
+            let second;
+            try {
+                monitor.check();
+            }
+            catch (error) {
+                second = error;
+            }
+            expect(first).toBe(second);
+        }
+        finally {
+            monitor.dispose();
+        }
+    });
+});
+//# sourceMappingURL=pressure-monitor.test.js.map

package/dist/__tests__/cli/pressure-monitor.test.js.map

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

package/dist/__tests__/cli/sarif-export.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for `runSarifExportMode` (the `sarif-export` subcommand
+ * helper, DEC-498). Drives the helper directly with synthetic signals —
+ * the subcommand-wiring is covered by the command-list drift tests in
+ * `tool.test.ts` / `tool-register.test.ts`.
+ */
+export {};
+//# sourceMappingURL=sarif-export.test.d.ts.map

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

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