@opensip-cli/core 0.1.0

package/dist/signals/suppress.test.js

@@ -0,0 +1,213 @@
+import { afterEach, describe, it, expect, vi } from 'vitest';
+import { logger } from '../lib/logger.js';
+import { createSignal } from '../types/signal.js';
+import { filterSignalsBySuppressions } from './suppress.js';
+const GRAPH_KEYWORDS = {
+    file: '@graph-ignore-file',
+    nextLine: '@graph-ignore-next-line',
+};
+const FITNESS_KEYWORDS = {
+    file: '@fitness-ignore-file',
+    nextLine: '@fitness-ignore-next-line',
+};
+function sig(ruleId, file, line) {
+    return createSignal({
+        source: 'test',
+        severity: 'medium',
+        category: 'quality',
+        ruleId,
+        message: `${ruleId} at ${file}:${String(line)}`,
+        code: { file, line },
+    });
+}
+/** An `ENOENT` rejection shaped like Node's `fs` errors. */
+function enoent(p) {
+    const error = new Error(`ENOENT: no such file or directory, open '${p}'`);
+    error.code = 'ENOENT';
+    return error;
+}
+/**
+ * A reader backed by an in-memory file map. Unknown files reject with an
+ * `ENOENT` (the genuinely-removed-file case) so the happy-path tests exercise
+ * the conservative degrade path rather than the fail-loud one.
+ */
+function readerFor(files) {
+    return (p) => (p in files ? Promise.resolve(files[p]) : Promise.reject(enoent(p)));
+}
+describe('filterSignalsBySuppressions', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('suppresses via a next-line directive on the preceding line', async () => {
+        const content = [
+            '// @graph-ignore-next-line graph:cycle -- intentional recursion',
+            'function visit() {}',
+        ].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'a.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.kept).toHaveLength(0);
+        expect(res.suppressed).toHaveLength(1);
+        expect(res.suppressed[0].line).toBe(2);
+    });
+    it('suppresses every matching signal via a file-level directive', async () => {
+        const content = ['// @graph-ignore-file graph:wide-function -- generated', 'code', 'more'].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:wide-function', 'a.ts', 2), sig('graph:wide-function', 'a.ts', 3)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.kept).toHaveLength(0);
+        expect(res.suppressed.every((s) => s.line === 'file')).toBe(true);
+    });
+    it('matches per ruleId — a directive for one rule does not suppress another', async () => {
+        const content = ['// @graph-ignore-next-line graph:cycle -- ok', 'function visit() {}'].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:large-function', 'a.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.kept).toHaveLength(1);
+        expect(res.suppressed).toHaveLength(0);
+    });
+    it('suppresses unconditionally — a directive with no reason still suppresses', async () => {
+        const content = ['// @graph-ignore-next-line graph:cycle', 'function visit() {}'].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'a.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.suppressed).toHaveLength(1);
+    });
+    it('skips stacked directive lines to find the real target', async () => {
+        const content = [
+            '// @graph-ignore-next-line graph:cycle -- ok',
+            '// eslint-disable-next-line no-shadow',
+            'function visit() {}',
+        ].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'a.ts', 3)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.suppressed).toHaveLength(1);
+    });
+    it('honors a directive above ANY candidate location (cycle any-member)', async () => {
+        // The signal anchors at member.ts:9 but a directive sits above a DIFFERENT member.
+        const anchor = sig('graph:cycle', 'anchor.ts', 9);
+        const res = await filterSignalsBySuppressions({
+            signals: [anchor],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({
+                'anchor.ts': 'function a() {}',
+                'member.ts': [
+                    '// @graph-ignore-next-line graph:cycle -- intentional',
+                    'function b() {}',
+                ].join('\n'),
+            }),
+            locate: () => [
+                { file: 'anchor.ts', line: 9 },
+                { file: 'member.ts', line: 2 },
+            ],
+        });
+        expect(res.suppressed).toHaveLength(1);
+    });
+    it('never suppresses a signal pointing AT a directive line (anti-recursion)', async () => {
+        // A directive-audit-style finding lands on the directive comment itself.
+        const content = ['// @graph-ignore-next-line graph:cycle -- ok', 'function visit() {}'].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'a.ts', 1)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.kept).toHaveLength(1);
+    });
+    it('throws (fails loud) when readFile rejects with a non-ENOENT error', async () => {
+        // An unexpected read failure (EACCES, EMFILE, decode, …) must abort the run
+        // rather than silently drop the file's waivers and leak the signal.
+        const eacces = new Error('EACCES: permission denied');
+        eacces.code = 'EACCES';
+        await expect(filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'locked.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: () => Promise.reject(eacces),
+        })).rejects.toThrow(/EACCES/);
+    });
+    it('also throws on a generic (non-ErrnoException) read rejection', async () => {
+        await expect(filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'weird.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: () => Promise.reject(new Error('decode boom')),
+        })).rejects.toThrow(/decode boom/);
+    });
+    it('on ENOENT: logs the missing-file evt and conservatively keeps the signal (not suppressed)', async () => {
+        const warnSpy = vi.spyOn(logger, 'warn').mockImplementation(() => undefined);
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'missing.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({}), // unknown file → ENOENT
+        });
+        // Conservative: a waiver that cannot be evaluated does NOT suppress.
+        expect(res.kept).toHaveLength(1);
+        expect(res.suppressed).toHaveLength(0);
+        // Attributed: the leaked-waiver risk is surfaced with { file, ruleId }.
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+        const [, data] = warnSpy.mock.calls[0];
+        expect(data).toMatchObject({
+            evt: 'signals.suppress.directive-file-missing',
+            file: 'missing.ts',
+            ruleId: 'graph:cycle',
+        });
+    });
+    it('on ENOENT under a ruleIdOf override: attributes the resolved ruleId', async () => {
+        const warnSpy = vi.spyOn(logger, 'warn').mockImplementation(() => undefined);
+        await filterSignalsBySuppressions({
+            signals: [sig('some-other-rule-id', 'gone.ts', 2)],
+            keywords: FITNESS_KEYWORDS,
+            readFile: readerFor({}),
+            ruleIdOf: () => 'my-check',
+        });
+        const [, data] = warnSpy.mock.calls[0];
+        expect(data).toMatchObject({
+            evt: 'signals.suppress.directive-file-missing',
+            file: 'gone.ts',
+            ruleId: 'my-check',
+        });
+    });
+    it('does NOT log the missing-file evt on the happy path (present files)', async () => {
+        const warnSpy = vi.spyOn(logger, 'warn').mockImplementation(() => undefined);
+        const content = ['// @graph-ignore-next-line graph:cycle -- ok', 'function visit() {}'].join('\n');
+        await filterSignalsBySuppressions({
+            signals: [sig('graph:cycle', 'a.ts', 2)],
+            keywords: GRAPH_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(warnSpy).not.toHaveBeenCalled();
+    });
+    it('is keyword-agnostic — same logic under fitness keywords', async () => {
+        const content = [
+            '// @fitness-ignore-next-line no-generic-error -- boundary',
+            'throw new Error()',
+        ].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('no-generic-error', 'a.ts', 2)],
+            keywords: FITNESS_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+        });
+        expect(res.suppressed).toHaveLength(1);
+    });
+    it('respects ruleIdOf override (fitness per-check slug semantics)', async () => {
+        // Signal carries a different ruleId, but fitness matches by the check slug.
+        const content = ['// @fitness-ignore-next-line my-check -- ok', 'code'].join('\n');
+        const res = await filterSignalsBySuppressions({
+            signals: [sig('some-other-rule-id', 'a.ts', 2)],
+            keywords: FITNESS_KEYWORDS,
+            readFile: readerFor({ 'a.ts': content }),
+            ruleIdOf: () => 'my-check',
+        });
+        expect(res.suppressed).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=suppress.test.js.map

package/dist/signals/suppress.test.js.map

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

package/dist/tools/__tests__/command-spec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-spec.test.d.ts.map

package/dist/tools/__tests__/command-spec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-spec.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/command-spec.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/command-spec.test.js

@@ -0,0 +1,191 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it, vi } from 'vitest';
+import { COMMON_FLAG_KEYS, defineCommand, } from '../command-spec.js';
+const noopHandler = () => undefined;
+function baseSpec(overrides = {}) {
+    return {
+        name: 'graph',
+        description: 'Build the static call graph',
+        commonFlags: ['cwd', 'json'],
+        scope: 'project',
+        output: 'signal-envelope',
+        handler: noopHandler,
+        ...overrides,
+    };
+}
+describe('defineCommand', () => {
+    it('returns the spec unchanged (identity) for a valid spec', () => {
+        const spec = baseSpec();
+        expect(defineCommand(spec)).toBe(spec);
+    });
+    it('accepts every CommonFlagKey', () => {
+        const spec = defineCommand(baseSpec({ commonFlags: [...COMMON_FLAG_KEYS] }));
+        expect(spec.commonFlags).toEqual(COMMON_FLAG_KEYS);
+    });
+    it('rejects an empty name', () => {
+        expect(() => defineCommand(baseSpec({ name: '   ' }))).toThrow(/non-empty string/);
+    });
+    it('rejects an empty description', () => {
+        expect(() => defineCommand(baseSpec({ description: '' }))).toThrow(/non-empty description/);
+    });
+    it('rejects a non-function handler', () => {
+        expect(() => 
+        // @ts-expect-error — deliberately wrong handler type for the runtime guard
+        defineCommand(baseSpec({ handler: 'nope' }))).toThrow(/function handler/);
+    });
+    it('rejects an unknown common-flag key', () => {
+        expect(() => defineCommand(baseSpec({ commonFlags: ['cwd', 'bogus'] }))).toThrow(/unknown common flag 'bogus'/);
+    });
+    it('rejects duplicate common-flag keys', () => {
+        expect(() => defineCommand(baseSpec({ commonFlags: ['cwd', 'cwd'] }))).toThrow(/duplicate common flag 'cwd'/);
+    });
+    it('does not invoke the handler at definition time', () => {
+        const handler = vi.fn();
+        defineCommand(baseSpec({ handler }));
+        expect(handler).not.toHaveBeenCalled();
+    });
+    it('requires raw-stream commands to declare why they bypass host rendering', () => {
+        expect(() => defineCommand(baseSpec({ output: 'raw-stream' }))).toThrow(/rawStreamReason/);
+    });
+    it('rejects rawStreamReason on non-raw-stream commands', () => {
+        expect(() => defineCommand(baseSpec({ output: 'command-result', rawStreamReason: 'file-export' }))).toThrow(/only valid for raw-stream/);
+    });
+    it('accepts documented raw-stream exceptions', () => {
+        const spec = defineCommand(baseSpec({ output: 'raw-stream', rawStreamReason: 'file-export' }));
+        expect(spec.rawStreamReason).toBe('file-export');
+    });
+});
+describe('OptionSpec corpus coverage', () => {
+    // Each case below is a real first-party flag shape from the Phase 0 corpus,
+    // asserting the type expresses it with zero raw-Commander escape.
+    it('expresses a boolean flag with default (--gate-save)', () => {
+        const opt = { flag: '--gate-save', description: 'Save baseline', default: false };
+        expect(opt.value).toBeUndefined();
+        expect(opt.default).toBe(false);
+    });
+    it('expresses a negatable flag (--no-cache)', () => {
+        const opt = { flag: '--no-cache', description: 'Skip cache', negatable: true };
+        expect(opt.negatable).toBe(true);
+    });
+    it('expresses a value flag (--recipe <name>)', () => {
+        const opt = { flag: '--recipe', value: '<name>', description: 'Run a recipe' };
+        expect(opt.value).toBe('<name>');
+    });
+    it('expresses value + default + choices (--resolution <mode>)', () => {
+        const opt = {
+            flag: '--resolution',
+            value: '<mode>',
+            description: 'Edge resolution tier',
+            default: 'exact',
+            choices: ['exact', 'fast'],
+        };
+        expect(opt.choices).toEqual(['exact', 'fast']);
+        expect(opt.default).toBe('exact');
+    });
+    it('expresses a custom scalar parser (--concurrency <n>)', () => {
+        const opt = {
+            flag: '--concurrency',
+            value: '<n>',
+            description: 'Concurrency cap',
+            parse: (raw) => Number.parseInt(raw, 10),
+        };
+        expect(opt.parse?.('4', undefined)).toBe(4);
+    });
+    it('expresses a repeatable reducer flag (--exclude <slug>)', () => {
+        const opt = {
+            flag: '--exclude',
+            value: '<slug>',
+            description: 'Exclude check (repeatable)',
+            arrayDefault: [],
+            parse: (raw, prev) => [...prev, raw],
+        };
+        expect(opt.parse?.('b', ['a'])).toEqual(['a', 'b']);
+        expect(opt.arrayDefault).toEqual([]);
+    });
+    it('expresses a required value flag (--out <path>)', () => {
+        const opt = {
+            flag: '--out',
+            value: '<path>',
+            description: 'Output file path',
+            required: true,
+        };
+        expect(opt.required).toBe(true);
+    });
+    it('expresses a short-aliased boolean (-y, --yes)', () => {
+        const opt = { flag: '-y, --yes', description: 'Skip confirmation', default: false };
+        expect(opt.flag).toContain('-y');
+    });
+    it('expresses an optional-value flag (--project [path])', () => {
+        const opt = {
+            flag: '--project',
+            value: '[path]',
+            description: 'Remove project-local runtime state',
+        };
+        expect(opt.value).toBe('[path]');
+    });
+});
+describe('ArgSpec corpus coverage', () => {
+    it('expresses a variadic optional positional ([paths...])', () => {
+        const arg = { name: 'paths', description: 'Subtrees', variadic: true, optional: true };
+        expect(arg.variadic).toBe(true);
+        expect(arg.optional).toBe(true);
+    });
+    it('expresses a required positional (<name>)', () => {
+        const arg = { name: 'name', description: 'Function name to look up' };
+        expect(arg.variadic).toBeUndefined();
+        expect(arg.optional).toBeUndefined();
+    });
+});
+describe('core stays Commander-free (Phase 0 layering invariant)', () => {
+    // The command-plane TYPES live in core, but the Commander-touching mounting
+    // runtime lives in cli and the `applyCommonFlags` runtime in contracts. core
+    // must NOT depend on or import `commander` — the kernel is a pure data layer.
+    // This asserts the invariant directly (the dependency-cruiser layer gate
+    // forbids the cross-package edge; this complements it at the kernel root).
+    const HERE = dirname(fileURLToPath(import.meta.url));
+    // __tests__ → tools → src → core
+    const CORE_ROOT = resolve(HERE, '../../..');
+    it('declares no `commander` dependency in package.json', () => {
+        const pkg = JSON.parse(readFileSync(join(CORE_ROOT, 'package.json'), 'utf8'));
+        expect(pkg.dependencies ?? {}).not.toHaveProperty('commander');
+        expect(pkg.peerDependencies ?? {}).not.toHaveProperty('commander');
+        expect(pkg.devDependencies ?? {}).not.toHaveProperty('commander');
+    });
+    it('no source file under packages/core/src imports commander', () => {
+        const offenders = [];
+        const COMMANDER_IMPORT = /from\s+['"]commander['"]|require\(\s*['"]commander['"]/;
+        const walk = (dir) => {
+            for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                const full = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(full);
+                }
+                else if (entry.name.endsWith('.ts') &&
+                    COMMANDER_IMPORT.test(readFileSync(full, 'utf8'))) {
+                    offenders.push(full);
+                }
+            }
+        };
+        walk(join(CORE_ROOT, 'src'));
+        expect(offenders).toEqual([]);
+    });
+});
+describe('CommandSpec shape', () => {
+    it('carries options, args, scope and output', () => {
+        const spec = defineCommand(baseSpec({
+            aliases: ['inspect'],
+            options: [{ flag: '--no-cache', description: 'Skip cache', negatable: true }],
+            args: [{ name: 'paths', description: 'Subtrees', variadic: true, optional: true }],
+            output: 'live-view',
+            scope: 'none',
+        }));
+        expect(spec.aliases).toEqual(['inspect']);
+        expect(spec.options).toHaveLength(1);
+        expect(spec.args).toHaveLength(1);
+        expect(spec.output).toBe('live-view');
+        expect(spec.scope).toBe('none');
+    });
+});
+//# sourceMappingURL=command-spec.test.js.map

package/dist/tools/__tests__/command-spec.test.js.map

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

package/dist/tools/__tests__/compatibility.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for the pure compatibility gate (release 2.8.0, Phase 0).
+ */
+export {};
+//# sourceMappingURL=compatibility.test.d.ts.map

package/dist/tools/__tests__/compatibility.test.d.ts.map

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

package/dist/tools/__tests__/compatibility.test.js

@@ -0,0 +1,41 @@
+/**
+ * Tests for the pure compatibility gate (release 2.8.0, Phase 0).
+ */
+import { describe, expect, it } from 'vitest';
+import { checkCompatibility } from '../compatibility.js';
+import { PLUGIN_API_VERSION } from '../manifest.js';
+describe('checkCompatibility', () => {
+    it('admits a tool declaring the current epoch', () => {
+        expect(checkCompatibility(PLUGIN_API_VERSION)).toEqual({ kind: 'compatible' });
+    });
+    it('rejects a tool with no declared apiVersion (3.0.0 — grace window ended)', () => {
+        const verdict = checkCompatibility(undefined);
+        expect(verdict.kind).toBe('incompatible');
+        if (verdict.kind === 'incompatible') {
+            expect(verdict.reason).toContain('no plugin apiVersion');
+        }
+    });
+    it('rejects a future epoch with the declared + engine integers and a reason', () => {
+        const verdict = checkCompatibility(PLUGIN_API_VERSION + 1);
+        expect(verdict.kind).toBe('incompatible');
+        if (verdict.kind === 'incompatible') {
+            expect(verdict.declared).toBe(PLUGIN_API_VERSION + 1);
+            expect(verdict.engine).toBe(PLUGIN_API_VERSION);
+            expect(verdict.reason).toMatch(/upgrade OpenSIP CLI/i);
+        }
+    });
+    it('rejects a past epoch with a tool-upgrade reason', () => {
+        const verdict = checkCompatibility(0, 1);
+        expect(verdict.kind).toBe('incompatible');
+        if (verdict.kind === 'incompatible') {
+            expect(verdict.declared).toBe(0);
+            expect(verdict.engine).toBe(1);
+            expect(verdict.reason).toMatch(/upgrade the tool/i);
+        }
+    });
+    it('honours an explicit engine override', () => {
+        expect(checkCompatibility(2, 2)).toEqual({ kind: 'compatible' });
+        expect(checkCompatibility(1, 2).kind).toBe('incompatible');
+    });
+});
+//# sourceMappingURL=compatibility.test.js.map

package/dist/tools/__tests__/compatibility.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/compatibility.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,OAAO,GAAG,kBAAkB,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAChD,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/__tests__/ids.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for the canonical tool-id registry (audit-round-3 Finding H).
+ */
+export {};
+//# sourceMappingURL=ids.test.d.ts.map

package/dist/tools/__tests__/ids.test.d.ts.map

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

package/dist/tools/__tests__/ids.test.js

@@ -0,0 +1,56 @@
+/**
+ * Tests for the canonical tool-id registry (audit-round-3 Finding H).
+ */
+import { describe, expect, it } from 'vitest';
+import { TOOL_LONG_IDS, TOOL_LONG_TO_SHORT, TOOL_SHORT_IDS, TOOL_SHORT_TO_LONG, isToolLongId, isToolShortId, } from '../ids.js';
+describe('tool-id registry', () => {
+    it('exposes both id lists', () => {
+        expect([...TOOL_SHORT_IDS]).toEqual(['fit', 'sim', 'graph']);
+        expect([...TOOL_LONG_IDS]).toEqual(['fitness', 'simulation', 'graph']);
+    });
+    it('long → short mapping is total and consistent', () => {
+        expect(TOOL_LONG_TO_SHORT).toEqual({
+            fitness: 'fit',
+            simulation: 'sim',
+            graph: 'graph',
+        });
+        for (const long of TOOL_LONG_IDS) {
+            expect(TOOL_SHORT_IDS).toContain(TOOL_LONG_TO_SHORT[long]);
+        }
+    });
+    it('short → long mapping is the inverse of long → short', () => {
+        for (const short of TOOL_SHORT_IDS) {
+            expect(TOOL_LONG_TO_SHORT[TOOL_SHORT_TO_LONG[short]]).toBe(short);
+        }
+        for (const long of TOOL_LONG_IDS) {
+            expect(TOOL_SHORT_TO_LONG[TOOL_LONG_TO_SHORT[long]]).toBe(long);
+        }
+    });
+    describe('isToolShortId', () => {
+        it.each(TOOL_SHORT_IDS)('accepts %s', (id) => {
+            expect(isToolShortId(id)).toBe(true);
+        });
+        it('rejects unknown short ids', () => {
+            expect(isToolShortId('fitness')).toBe(false); // long form
+            expect(isToolShortId('audit')).toBe(false);
+            expect(isToolShortId('')).toBe(false);
+        });
+        it('rejects non-strings', () => {
+            expect(isToolShortId(undefined)).toBe(false);
+            expect(isToolShortId(null)).toBe(false);
+            expect(isToolShortId(123)).toBe(false);
+            expect(isToolShortId({})).toBe(false);
+        });
+    });
+    describe('isToolLongId', () => {
+        it.each(TOOL_LONG_IDS)('accepts %s', (id) => {
+            expect(isToolLongId(id)).toBe(true);
+        });
+        it('rejects unknown long ids', () => {
+            expect(isToolLongId('fit')).toBe(false); // short form
+            expect(isToolLongId('audit')).toBe(false);
+            expect(isToolLongId('')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=ids.test.js.map

package/dist/tools/__tests__/ids.test.js.map

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

package/dist/tools/__tests__/manifest-assert.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for the load-time manifest⇔Tool drift guard (release 2.8.0, Phase 1).
+ */
+export {};
+//# sourceMappingURL=manifest-assert.test.d.ts.map

package/dist/tools/__tests__/manifest-assert.test.d.ts.map

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