@opensip-cli/graph 0.1.0

package/dist/__tests__/test-utils/with-graph-scope.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Test helper — construct a RunScope with the graph
+ * subscope attached, then run a callback inside it.
+ *
+ * After Item 1 the adapter + rule registries are per-RunScope. Tests
+ * that touch them must build a scope first; this helper centralises
+ * the boilerplate.
+ */
+import { RunScope } from '@opensip-cli/core';
+/** Build a fresh RunScope with `scope.graph` populated. */
+export declare function makeGraphTestScope(): RunScope;
+/** Run `fn` inside a fresh graph-extended scope; returns its result. */
+export declare function withGraphScopeSync<T>(fn: () => T): T;
+//# sourceMappingURL=with-graph-scope.d.ts.map

package/dist/__tests__/test-utils/with-graph-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-graph-scope.d.ts","sourceRoot":"","sources":["../../../src/__tests__/test-utils/with-graph-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAoB,QAAQ,EAAkC,MAAM,mBAAmB,CAAC;AAW/F,2DAA2D;AAC3D,wBAAgB,kBAAkB,IAAI,QAAQ,CAI7C;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEpD"}

package/dist/__tests__/test-utils/with-graph-scope.js

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Test helper — construct a RunScope with the graph
+ * subscope attached, then run a callback inside it.
+ *
+ * After Item 1 the adapter + rule registries are per-RunScope. Tests
+ * that touch them must build a scope first; this helper centralises
+ * the boilerplate.
+ */
+import { LanguageRegistry, RunScope, ToolRegistry, runWithScopeSync } from '@opensip-cli/core';
+import { graphTool } from '../../tool.js';
+/** Fresh scope with empty registries — local equivalent of the retired
+ *  `@opensip-cli/core/test-utils` helper (ADR-0040: that sugar moved to
+ *  `@opensip-cli/test-support`, which this package's tests cannot use
+ *  without coupling its test graph to the fitness engine). */
+const makeTestScope = () => new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry() });
+/** Build a fresh RunScope with `scope.graph` populated. */
+export function makeGraphTestScope() {
+    const scope = makeTestScope();
+    Object.assign(scope, graphTool.contributeScope?.() ?? {});
+    return scope;
+}
+/** Run `fn` inside a fresh graph-extended scope; returns its result. */
+export function withGraphScopeSync(fn) {
+    return runWithScopeSync(makeGraphTestScope(), fn);
+}
+//# sourceMappingURL=with-graph-scope.js.map

package/dist/__tests__/test-utils/with-graph-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-graph-scope.js","sourceRoot":"","sources":["../../../src/__tests__/test-utils/with-graph-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE/F,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;;8DAG8D;AAC9D,MAAM,aAAa,GAAG,GAAa,EAAE,CACnC,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,EAAE,CAAC,CAAC;AAEjF,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAI,EAAW;IAC/C,OAAO,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/__tests__/tool-branches.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * graphTool — branch coverage for the spec-handler paths the primary
+ * tool-register suite doesn't reach: the `--resolution` choices declaration
+ * (+ the `fast` path), the graph-shard-worker handler, catalog-export's
+ * incremental + changed-file advisory branch, the error handler on a pipeline
+ * throw, and the contributeScope / collectReportData hooks.
+ *
+ * Since release 2.11.0 Phase 5 graph mounts via `commandSpecs`; we drive each
+ * spec's handler directly (the host invokes it post-parse), threading
+ * positionals on the parsed-opts object under `_args`. `--resolution` is now
+ * validated declaratively (`choices: ['exact','fast']`) by the host's mount
+ * layer — its rejection of an out-of-set value is covered in
+ * `cli/src/__tests__/mount-command-spec.test.ts`; here we assert the spec
+ * DECLARES the choices (the source of truth) and that the `fast` value flows
+ * through.
+ */
+export {};
+//# sourceMappingURL=tool-branches.test.d.ts.map

package/dist/__tests__/tool-branches.test.d.ts.map

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

package/dist/__tests__/tool-branches.test.js

@@ -0,0 +1,262 @@
+/**
+ * graphTool — branch coverage for the spec-handler paths the primary
+ * tool-register suite doesn't reach: the `--resolution` choices declaration
+ * (+ the `fast` path), the graph-shard-worker handler, catalog-export's
+ * incremental + changed-file advisory branch, the error handler on a pipeline
+ * throw, and the contributeScope / collectReportData hooks.
+ *
+ * Since release 2.11.0 Phase 5 graph mounts via `commandSpecs`; we drive each
+ * spec's handler directly (the host invokes it post-parse), threading
+ * positionals on the parsed-opts object under `_args`. `--resolution` is now
+ * validated declaratively (`choices: ['exact','fast']`) by the host's mount
+ * layer — its rejection of an out-of-set value is covered in
+ * `cli/src/__tests__/mount-command-spec.test.ts`; here we assert the spec
+ * DECLARES the choices (the source of truth) and that the `fast` value flows
+ * through.
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { enterScope, LanguageRegistry } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { currentAdapterRegistry } from '../lang-adapter/registry.js';
+import { graphTool } from '../tool.js';
+import { makeGraphTestScope } from './test-utils/with-graph-scope.js';
+/** Resolve a graph command-spec by name. */
+function specFor(name) {
+    const spec = (graphTool.commandSpecs ?? []).find((s) => s.name === name);
+    if (spec === undefined)
+        throw new Error(`graphTool exposes no command spec '${name}'`);
+    return spec;
+}
+/** Resolve a graph command-spec handler by name (the host invokes `handler(opts, ctx)`). */
+function handlerFor(name) {
+    return specFor(name).handler;
+}
+function fakeAdapter(projectDir) {
+    return {
+        id: 'typescript',
+        fileExtensions: ['.ts'],
+        displayName: 'Fake',
+        discoverFiles: () => ({
+            projectDirAbs: projectDir,
+            files: [join(projectDir, 'src', 'a.ts')],
+            configPathAbs: undefined,
+            compilerOptions: undefined,
+        }),
+        parseProject: () => ({ project: { x: 1 }, parseErrors: [] }),
+        walkProject: () => ({ occurrences: {}, callSites: [], parseErrors: [] }),
+        resolveCallSites: () => ({
+            edgesByOwner: new Map(),
+            stats: {
+                totalCallSites: 0,
+                resolvedHigh: 0,
+                resolvedMedium: 0,
+                resolvedLow: 0,
+                unresolved: 0,
+            },
+        }),
+        cacheKey: () => 'fake-v1',
+    };
+}
+function makeMockCli(datastore) {
+    const setExitCode = vi.fn();
+    const renderLive = vi.fn().mockResolvedValue(undefined);
+    const render = vi.fn().mockResolvedValue(undefined);
+    const cli = {
+        registerLiveView: vi.fn(),
+        renderLive,
+        render,
+        setExitCode,
+        emitJson: vi.fn(),
+        emitRaw: vi.fn(),
+        emitEnvelope: vi.fn(),
+        emitError: vi.fn(),
+        deliverSignals: vi.fn(() => Promise.resolve()),
+        writeSarif: vi.fn(() => Promise.resolve()),
+        datastore,
+        scope: { datastore: () => datastore, languages: new LanguageRegistry() },
+    };
+    return { cli, setExitCode, renderLive, render };
+}
+/** Force `process.stdout.isTTY` for one test, restoring the prior value after. */
+async function withTTY(value, fn) {
+    const prev = process.stdout.isTTY;
+    Object.defineProperty(process.stdout, 'isTTY', { value, configurable: true });
+    try {
+        await fn();
+    }
+    finally {
+        Object.defineProperty(process.stdout, 'isTTY', { value: prev, configurable: true });
+    }
+}
+let stdoutSpy;
+let stderrSpy;
+let workDir;
+beforeEach(() => {
+    enterScope(makeGraphTestScope());
+    stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+    stderrSpy = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+    workDir = mkdtempSync(join(tmpdir(), 'tool-branch-'));
+});
+afterEach(() => {
+    currentAdapterRegistry().clear();
+    stdoutSpy.mockRestore();
+    stderrSpy.mockRestore();
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe('--resolution declaration', () => {
+    it('declares choices exact|fast on every --resolution-bearing command', () => {
+        for (const name of ['graph', 'catalog-export', 'sarif-export']) {
+            const option = (specFor(name).options ?? []).find((o) => o.flag === '--resolution');
+            expect(option?.choices).toEqual(['exact', 'fast']);
+            expect(option?.default).toBe('exact');
+        }
+    });
+    it('accepts --resolution fast on the sarif-export path', async () => {
+        currentAdapterRegistry().register(fakeAdapter(workDir));
+        const outPath = join(workDir, 'out.sarif');
+        const { cli, setExitCode } = makeMockCli(DataStoreFactory.open({ backend: 'memory' }));
+        await handlerFor('sarif-export')({
+            outputSarif: outPath,
+            tenantId: 't',
+            repoId: 'r',
+            cwd: workDir,
+            resolution: 'fast',
+            _args: [],
+        }, cli);
+        expect(setExitCode).toHaveBeenCalledWith(0);
+    });
+});
+describe('graph interactive --exact path honors graph config', () => {
+    it('loads opensip-cli.config.yml graph block and forwards it to renderLive (--exact, TTY)', async () => {
+        // Regression: the interactive live-view path used to call runGraph with no
+        // config, silently ignoring the project's `graph:` block — so
+        // `graph --verbose` disagreed with `graph --json`. ADR-0032: the Ink live
+        // view drives the EXACT engine, so it is eligible only under `--exact`
+        // (sharded is the default and routes to the static path).
+        currentAdapterRegistry().register(fakeAdapter(workDir));
+        writeFileSync(join(workDir, 'opensip-cli.config.yml'), 'graph:\n  minCrossPackageDuplicatePackages: 2\n', 'utf8');
+        const { cli, renderLive } = makeMockCli();
+        // The animated live view is taken only on a TTY, under --exact.
+        await withTTY(true, () => handlerFor('graph')({ cwd: workDir, exact: true, _args: [[]] }, cli));
+        expect(renderLive).toHaveBeenCalledTimes(1);
+        const [, args] = renderLive.mock.calls[0];
+        expect(args.config?.minCrossPackageDuplicatePackages).toBe(2);
+    });
+    it('falls back to the static render seam (not the live view) when stdout is not a TTY', async () => {
+        // Pipe / CI / redirect: the animated Ink live view is TTY-only, so a bare
+        // `graph` run must route through executeGraph and emit its result through
+        // the render seam (dual-rendered as plain text), never renderLive.
+        currentAdapterRegistry().register(fakeAdapter(workDir));
+        const { cli, renderLive, render } = makeMockCli(DataStoreFactory.open({ backend: 'memory' }));
+        await withTTY(false, () => handlerFor('graph')({ cwd: workDir, _args: [[]] }, cli));
+        expect(renderLive).not.toHaveBeenCalled();
+        expect(render).toHaveBeenCalledTimes(1);
+        const [result] = render.mock.calls[0];
+        expect(result.type).toBe('graph-done');
+    });
+    it('a bare default run takes the live view on a TTY (ADR-0032: the live renderer is engine-agnostic — drives the sharded default too)', async () => {
+        // Regression fix: the live runner is engine-agnostic — it drives WHICHEVER
+        // engine the `--exact` + shardability policy selects (sharded in-process /
+        // exact off-process). So a bare `graph` (sharded default) on a TTY MUST take
+        // the live view — same as `--exact` — restoring the staged "Code Graph"
+        // checklist that the earlier `opts.exact === true` gate had removed. This
+        // pins "TTY selects only the renderer; it never changes the engine" without
+        // tying the renderer to one engine.
+        currentAdapterRegistry().register(fakeAdapter(workDir));
+        const { cli, renderLive, render } = makeMockCli(DataStoreFactory.open({ backend: 'memory' }));
+        await withTTY(true, () => handlerFor('graph')({ cwd: workDir, _args: [[]] }, cli));
+        expect(renderLive).toHaveBeenCalledTimes(1);
+        expect(render).not.toHaveBeenCalled();
+        // The live args carry the engine selector: `exact` (false here) + the
+        // pre-resolved shard set the runner uses to pick its transport.
+        const [, args] = renderLive.mock.calls[0];
+        expect(args.exact).toBe(false);
+        expect(Array.isArray(args.shards)).toBe(true);
+    });
+});
+describe('graph-shard-worker handler', () => {
+    it('routes the specPath positional to executeShardWorker (exit 0 on a valid spec)', async () => {
+        currentAdapterRegistry().register(fakeAdapter(workDir));
+        const specPath = join(workDir, 'spec.json');
+        const spec = {
+            shard: { id: 'pkg:a', rootDir: workDir, files: [join(workDir, 'src', 'a.ts')] },
+            projectRoot: workDir,
+            resolutionMode: 'exact',
+        };
+        writeFileSync(specPath, JSON.stringify(spec), 'utf8');
+        const { cli, setExitCode } = makeMockCli();
+        await handlerFor('graph-shard-worker')({ _args: [specPath] }, cli);
+        expect(setExitCode).toHaveBeenCalledWith(0);
+        const out = stdoutSpy.mock.calls.map((c) => String(c[0])).join('');
+        const result = JSON.parse(out);
+        expect(result.shardId).toBe('pkg:a');
+    });
+});
+describe('catalog-export handler branches', () => {
+    it('logs the changed-file advisory on the incremental path and still writes the export', async () => {
+        currentAdapterRegistry().register(fakeAdapter(workDir));
+        const outPath = join(workDir, 'catalog.json');
+        const { cli, setExitCode } = makeMockCli(DataStoreFactory.open({ backend: 'memory' }));
+        await handlerFor('catalog-export')({
+            catalogOutput: outPath,
+            tenantId: 't',
+            repoId: 'r',
+            gitSha: 'sha1',
+            mode: 'incremental',
+            changedFile: ['src/a.ts', 'src/b.ts'],
+            cwd: workDir,
+            resolution: 'exact',
+            _args: [],
+        }, cli);
+        expect(setExitCode).toHaveBeenCalledWith(0);
+    });
+    it('routes a pipeline failure through handleGraphError (no adapter registered)', async () => {
+        // No adapter registered → runGraph throws a ConfigurationError, which
+        // the handler's catch hands to handleGraphError.
+        const outPath = join(workDir, 'catalog.json');
+        const { cli, setExitCode } = makeMockCli(DataStoreFactory.open({ backend: 'memory' }));
+        await handlerFor('catalog-export')({
+            catalogOutput: outPath,
+            tenantId: 't',
+            repoId: 'r',
+            gitSha: 'sha1',
+            cwd: workDir,
+            resolution: 'exact',
+            _args: [],
+        }, cli);
+        // handleGraphError sets a non-zero exit code.
+        const codes = setExitCode.mock.calls.map((c) => c[0]);
+        expect(codes.some((c) => c !== 0)).toBe(true);
+    });
+});
+describe('contributeScope + collectReportData hooks', () => {
+    it('contributeScope seeds a fresh graph subscope with adapter + rule + recipe registries', () => {
+        const contribution = graphTool.contributeScope?.() ?? {};
+        expect(contribution.graph).toBeDefined();
+        expect(contribution.graph?.adapters).toBeDefined();
+        expect(contribution.graph?.rules).toBeDefined();
+        expect(contribution.graph?.recipes).toBeDefined();
+    });
+    it('collectReportData returns empty rule/recipe catalogs when no datastore and no graph subscope', () => {
+        const scope = { datastore: () => undefined };
+        expect(graphTool.collectReportData?.(scope)).toEqual({
+            graphRuleCatalog: [],
+            graphRecipeCatalog: [],
+        });
+    });
+    it('collectReportData returns a graphCatalog key when a datastore is present', () => {
+        const datastore = DataStoreFactory.open({ backend: 'memory' });
+        try {
+            const scope = { datastore: () => datastore };
+            const data = graphTool.collectReportData?.(scope) ?? {};
+            expect('graphCatalog' in data).toBe(true);
+        }
+        finally {
+            datastore.close();
+        }
+    });
+});
+//# sourceMappingURL=tool-branches.test.js.map

package/dist/__tests__/tool-branches.test.js.map

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

package/dist/__tests__/tool-register.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tests for graph's command-spec handlers — verifies that each declarative
+ * `CommandSpec` handler does the right thing when the host invokes it after
+ * parsing.
+ *
+ * Since release 2.11.0 Phase 5 graph mounts via `commandSpecs`, not the
+ * deprecated `register()` hook. The host-owned mount path (Commander wiring,
+ * `_args` positional convention, output dispatch) is covered in
+ * `cli/src/__tests__/mount-command-spec.test.ts`; here we drive each spec's
+ * handler directly with a fake ToolCliContext (the handler is exactly what the
+ * host invokes post-parse). Positional arguments are threaded the way the host
+ * threads them: on the parsed-opts object under the `_args` key. For graph's
+ * sole variadic positional (`[paths...]`), `_args[0]` is the paths array.
+ */
+export {};
+//# sourceMappingURL=tool-register.test.d.ts.map

package/dist/__tests__/tool-register.test.d.ts.map

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