@opensip-tools/fitness 1.0.4

package/dist/framework/__tests__/define-check.test.js

@@ -0,0 +1,155 @@
+import { describe, expect, it } from 'vitest';
+import { defineCheck } from '../define-check.js';
+describe('defineCheck', () => {
+    describe('analyze mode', () => {
+        const noFooCheck = defineCheck({
+            id: '11111111-1111-4111-8111-111111111111',
+            slug: 'no-foo',
+            description: 'flag any line containing FOO',
+            tags: ['quality'],
+            analyze: (content, filePath) => {
+                const out = [];
+                const lines = content.split('\n');
+                for (const [i, line] of lines.entries()) {
+                    if (line?.includes('FOO')) {
+                        out.push({ line: i + 1, message: 'FOO not allowed', severity: 'error', filePath });
+                    }
+                }
+                return out;
+            },
+        });
+        it('returns a Check with the configured slug and id', () => {
+            expect(noFooCheck.config.slug).toBe('no-foo');
+            expect(noFooCheck.config.id).toBe('11111111-1111-4111-8111-111111111111');
+        });
+        it('defaults itemType to "files"', () => {
+            expect(noFooCheck.config.itemType).toBe('files');
+        });
+        it('marks scansFiles=true for analyze mode', () => {
+            expect(noFooCheck.config.scansFiles).toBe(true);
+        });
+        it('records analysisMode "analyze"', () => {
+            expect(noFooCheck.config.analysisMode).toBe('analyze');
+        });
+        it('preserves user-supplied tags', () => {
+            expect(noFooCheck.config.tags).toEqual(['quality']);
+        });
+        it('exposes a getScope() and getMatcher() pair', () => {
+            const scope = noFooCheck.getScope();
+            expect(scope.include).toEqual([]);
+            expect(noFooCheck.getMatcher('/tmp')).toBeDefined();
+        });
+    });
+    describe('analyzeAll mode', () => {
+        const allCheck = defineCheck({
+            id: '22222222-2222-4222-8222-222222222222',
+            slug: 'all-mode-check',
+            description: 'returns no violations',
+            tags: ['demo'],
+            // eslint-disable-next-line @typescript-eslint/require-await -- stub for shape verification
+            analyzeAll: async () => [],
+        });
+        it('records analysisMode "analyzeAll"', () => {
+            expect(allCheck.config.analysisMode).toBe('analyzeAll');
+        });
+        it('marks scansFiles=true for analyzeAll mode', () => {
+            expect(allCheck.config.scansFiles).toBe(true);
+        });
+    });
+    describe('command mode', () => {
+        const cmd = defineCheck({
+            id: '33333333-3333-4333-8333-333333333333',
+            slug: 'cmd-check',
+            description: 'shells out',
+            tags: ['demo'],
+            command: { bin: 'echo', args: ['hello'], parseOutput: () => [] },
+        });
+        it('records analysisMode "command"', () => {
+            expect(cmd.config.analysisMode).toBe('command');
+        });
+        it('marks scansFiles=false for command mode', () => {
+            expect(cmd.config.scansFiles).toBe(false);
+        });
+    });
+    describe('scope handling', () => {
+        it('passes through scope.languages and scope.concerns', () => {
+            const c = defineCheck({
+                id: '44444444-4444-4444-8444-444444444444',
+                slug: 'scoped',
+                description: 's',
+                tags: ['demo'],
+                scope: { languages: ['typescript', 'rust'], concerns: ['backend'] },
+                analyze: () => [],
+            });
+            expect(c.config.checkScope?.languages).toEqual(['typescript', 'rust']);
+            expect(c.config.checkScope?.concerns).toEqual(['backend']);
+        });
+        it('leaves checkScope undefined when scope is omitted', () => {
+            const c = defineCheck({
+                id: '55555555-5555-4555-8555-555555555555',
+                slug: 'unscoped',
+                description: 's',
+                tags: ['demo'],
+                analyze: () => [],
+            });
+            expect(c.config.checkScope).toBeUndefined();
+        });
+    });
+    describe('runtime metadata passthrough', () => {
+        it('preserves docs, disabled, confidence, and timeout', () => {
+            const c = defineCheck({
+                id: '66666666-6666-4666-8666-666666666666',
+                slug: 'with-meta',
+                description: 'meta',
+                tags: ['demo'],
+                docs: 'https://example.com/x',
+                disabled: true,
+                confidence: 'high',
+                timeout: 1234,
+                analyze: () => [],
+            });
+            expect(c.config.docs).toBe('https://example.com/x');
+            expect(c.config.disabled).toBe(true);
+            expect(c.config.confidence).toBe('high');
+            expect(c.config.timeout).toBe(1234);
+        });
+        it('copies fileTypes when provided', () => {
+            const c = defineCheck({
+                id: '77777777-7777-4777-8777-777777777777',
+                slug: 'typed',
+                description: 'd',
+                tags: ['demo'],
+                fileTypes: ['ts', 'tsx'],
+                analyze: () => [],
+            });
+            expect(c.config.fileTypes).toEqual(['ts', 'tsx']);
+        });
+    });
+    describe('validation', () => {
+        it('throws when id is missing', () => {
+            expect(() => 
+            // @ts-expect-error — testing the runtime guard
+            defineCheck({ slug: 'no-id', description: 'd', tags: [], analyze: () => [] })).toThrow();
+        });
+        it('throws when id is not a UUID', () => {
+            expect(() => defineCheck({
+                id: 'not-a-uuid',
+                slug: 'bad-id',
+                description: 'd',
+                tags: ['demo'],
+                analyze: () => [],
+            })).toThrow();
+        });
+        it('throws when slug is missing', () => {
+            expect(() => defineCheck({
+                id: '88888888-8888-4888-8888-888888888888',
+                // @ts-expect-error — testing the runtime guard
+                slug: undefined,
+                description: 'd',
+                tags: ['demo'],
+                analyze: () => [],
+            })).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=define-check.test.js.map

package/dist/framework/__tests__/define-check.test.js.map

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

package/dist/framework/__tests__/directive-inventory.test.d.ts

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

package/dist/framework/__tests__/directive-inventory.test.d.ts.map

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

package/dist/framework/__tests__/directive-inventory.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { parseDirectiveLine } from '../directive-inventory.js';
+describe('parseDirectiveLine', () => {
+    describe('line comments (// form)', () => {
+        it('parses @fitness-ignore-file with reason', () => {
+            const result = parseDirectiveLine('// @fitness-ignore-file no-console-log -- debug scaffold for this module');
+            expect(result).toEqual({ type: 'file', checkId: 'no-console-log', reason: 'debug scaffold for this module' });
+        });
+        it('parses @fitness-ignore-next-line without reason', () => {
+            const result = parseDirectiveLine('// @fitness-ignore-next-line no-any-types');
+            expect(result).toEqual({ type: 'next-line', checkId: 'no-any-types', reason: null });
+        });
+        it('rejects lines without the directive prefix', () => {
+            expect(parseDirectiveLine('// just a comment')).toBeNull();
+            expect(parseDirectiveLine('const x = 1;')).toBeNull();
+        });
+    });
+    describe('block comments (/* form) — parity with suppression parser', () => {
+        it('parses single-line block directive with reason', () => {
+            const result = parseDirectiveLine('/* @fitness-ignore-file no-console-log -- legacy file */');
+            expect(result).toEqual({ type: 'file', checkId: 'no-console-log', reason: 'legacy file' });
+        });
+        it('parses single-line block directive without reason', () => {
+            const result = parseDirectiveLine('/* @fitness-ignore-next-line no-any-types */');
+            expect(result).toEqual({ type: 'next-line', checkId: 'no-any-types', reason: null });
+        });
+        it('strips trailing whitespace before */', () => {
+            const result = parseDirectiveLine('/* @fitness-ignore-file some-check   */');
+            expect(result).toEqual({ type: 'file', checkId: 'some-check', reason: null });
+        });
+    });
+    describe('rejection cases', () => {
+        it('rejects directive without comment marker', () => {
+            expect(parseDirectiveLine('@fitness-ignore-file foo')).toBeNull();
+        });
+        it('rejects checkId with spaces', () => {
+            expect(parseDirectiveLine('// @fitness-ignore-file foo bar baz')).toBeNull();
+        });
+        it('rejects empty checkId', () => {
+            expect(parseDirectiveLine('// @fitness-ignore-file ')).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=directive-inventory.test.js.map

package/dist/framework/__tests__/directive-inventory.test.js.map

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

package/dist/framework/__tests__/execution-context.test.d.ts

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

package/dist/framework/__tests__/execution-context.test.d.ts.map

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

package/dist/framework/__tests__/execution-context.test.js

@@ -0,0 +1,62 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createExecutionContext } from '../execution-context.js';
+import { fileCache } from '../file-cache.js';
+import { PathMatcher } from '../path-matcher.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-exec-ctx-'));
+});
+afterEach(() => {
+    fileCache.clear();
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('createExecutionContext > matchFiles fileCache fallback', () => {
+    // Regression test for the scope-resolver bug surfaced during the
+    // checks-builtin split: scope-empty checks (e.g. file-length-limit)
+    // were scanning every prewarmed file, including paths the user had
+    // explicitly listed in `globalExcludes`. The fix threads the run's
+    // globalExcludes through RunOptions into the matchFiles fallback.
+    // eslint-disable-next-line unicorn/consistent-function-scoping -- closes over describe-scoped `testDir`
+    function setupCachedFiles() {
+        mkdirSync(join(testDir, 'src'), { recursive: true });
+        mkdirSync(join(testDir, 'docs'), { recursive: true });
+        mkdirSync(join(testDir, 'tests', 'fixtures'), { recursive: true });
+        writeFileSync(join(testDir, 'src', 'a.ts'), 'export const a = 1');
+        writeFileSync(join(testDir, 'docs', 'design.md'), '# Design');
+        writeFileSync(join(testDir, 'tests', 'fixtures', 'sample.json'), '{}');
+    }
+    async function runMatchFiles(globalExcludes) {
+        setupCachedFiles();
+        await fileCache.prewarm(testDir, ['**/*.ts', '**/*.md', '**/*.json']);
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ctx = createExecutionContext({ id: 'test-id', slug: 'test-slug', itemType: 'files' }, testDir, matcher, globalExcludes ? { globalExcludes } : undefined);
+        return ctx.matchFiles();
+    }
+    it('returns every cached path when no globalExcludes are provided', async () => {
+        const files = await runMatchFiles();
+        expect(files.length).toBe(3);
+        // Sanity: includes the docs and fixtures files that we'll exclude below
+        expect(files.some((f) => f.endsWith('docs/design.md'))).toBe(true);
+        expect(files.some((f) => f.endsWith('tests/fixtures/sample.json'))).toBe(true);
+    });
+    it('filters paths matching globalExcludes patterns out of the fallback', async () => {
+        const files = await runMatchFiles(['docs/**', 'tests/fixtures/**']);
+        expect(files.length).toBe(1);
+        expect(files[0]).toMatch(/src\/a\.ts$/);
+    });
+    it('honors extension-style globalExcludes (*.md, *.json)', async () => {
+        const files = await runMatchFiles(['**/*.md', '**/*.json']);
+        expect(files.length).toBe(1);
+        expect(files[0]).toMatch(/src\/a\.ts$/);
+    });
+    it('returns the unfiltered list when globalExcludes is an empty array', async () => {
+        // Empty array must not engage the matcher at all — otherwise we
+        // pay relative-path computation per file for no reason.
+        const files = await runMatchFiles([]);
+        expect(files.length).toBe(3);
+    });
+});
+//# sourceMappingURL=execution-context.test.js.map

package/dist/framework/__tests__/execution-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.test.js","sourceRoot":"","sources":["../../../src/framework/__tests__/execution-context.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,IAAI,OAAe,CAAA;AAEnB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAC,CAAA;AAEF,SAAS,CAAC,GAAG,EAAE;IACb,SAAS,CAAC,KAAK,EAAE,CAAA;IACjB,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACnD,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,wDAAwD,EAAE,GAAG,EAAE;IACtE,iEAAiE;IACjE,oEAAoE;IACpE,mEAAmE;IACnE,mEAAmE;IACnE,kEAAkE;IAElE,wGAAwG;IACxG,SAAS,gBAAgB;QACvB,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACpD,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACrD,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAElE,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAA;QACjE,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,CAAA;QAC7D,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,cAAkC;QAC7D,gBAAgB,EAAE,CAAA;QAClB,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAA;QAErE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9E,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,EACvD,OAAO,EACP,OAAO,EACP,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAChD,CAAA;QACD,OAAO,GAAG,CAAC,UAAU,EAAE,CAAA;IACzB,CAAC;IAED,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAA;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,wEAAwE;QACxE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAA;QACnE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAA;QAC3D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,gEAAgE;QAChE,wDAAwD;QACxD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,EAAE,CAAC,CAAA;QACrC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/framework/__tests__/file-accessor.test.d.ts

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

package/dist/framework/__tests__/file-accessor.test.d.ts.map

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

package/dist/framework/__tests__/file-accessor.test.js

@@ -0,0 +1,106 @@
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ValidationError } from '@opensip-tools/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { createFileAccessor } from '../file-accessor.js';
+import { fileCache } from '../file-cache.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-fa-'));
+    fileCache.clear();
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+    fileCache.clear();
+});
+describe('createFileAccessor', () => {
+    it('exposes the configured paths via the readonly paths property', () => {
+        const acc = createFileAccessor(['/a.ts', '/b.ts']);
+        expect(acc.paths).toEqual(['/a.ts', '/b.ts']);
+    });
+    it('reads file content from disk via fileCache when not preloaded', async () => {
+        const path = join(testDir, 'x.ts');
+        writeFileSync(path, 'hi');
+        const acc = createFileAccessor([path]);
+        expect(await acc.read(path)).toBe('hi');
+    });
+    it('rejects reads of paths not in the configured set', async () => {
+        const acc = createFileAccessor(['/allowed.ts']);
+        await expect(acc.read('/disallowed.ts')).rejects.toThrow(ValidationError);
+    });
+    it('caches reads — second call returns the same content even if disk changed', async () => {
+        const path = join(testDir, 'cache.ts');
+        writeFileSync(path, 'first');
+        const acc = createFileAccessor([path]);
+        expect(await acc.read(path)).toBe('first');
+        writeFileSync(path, 'second');
+        // Cached
+        expect(await acc.read(path)).toBe('first');
+    });
+    it('throws ValidationError when a file exceeds 10 MB', async () => {
+        const path = join(testDir, 'big.txt');
+        // Use Buffer-write to avoid loading 11 MB of string into memory unnecessarily
+        writeFileSync(path, Buffer.alloc(11 * 1024 * 1024, 'a'));
+        const acc = createFileAccessor([path]);
+        await expect(acc.read(path)).rejects.toThrow(/File too large/);
+    });
+    it('readMany reads multiple files and returns a Map', async () => {
+        const a = join(testDir, 'a.ts');
+        const b = join(testDir, 'b.ts');
+        writeFileSync(a, 'A');
+        writeFileSync(b, 'B');
+        const acc = createFileAccessor([a, b]);
+        const map = await acc.readMany([a, b]);
+        expect(map.get(a)).toBe('A');
+        expect(map.get(b)).toBe('B');
+    });
+    it('readAll returns every configured path', async () => {
+        const a = join(testDir, 'a.ts');
+        writeFileSync(a, 'AA');
+        const acc = createFileAccessor([a]);
+        const map = await acc.readAll();
+        expect(map.size).toBe(1);
+        expect(map.get(a)).toBe('AA');
+    });
+    it('throws when an aborted signal is passed', async () => {
+        const ac = new AbortController();
+        ac.abort();
+        const path = join(testDir, 'z.ts');
+        writeFileSync(path, 'z');
+        const acc = createFileAccessor([path], { signal: ac.signal });
+        await expect(acc.read(path)).rejects.toThrow();
+    });
+    it('cachedCount reflects internal LRU size', async () => {
+        const path = join(testDir, 'cnt.ts');
+        writeFileSync(path, 'cnt');
+        const acc = createFileAccessor([path]);
+        expect(acc.cachedCount).toBe(0);
+        await acc.read(path);
+        expect(acc.cachedCount).toBe(1);
+        acc.clearCache();
+        expect(acc.cachedCount).toBe(0);
+    });
+    it('preferentially returns content from the global fileCache when prewarmed', async () => {
+        const path = join(testDir, 'p.ts');
+        writeFileSync(path, 'on-disk');
+        await fileCache.prewarm(testDir, ['p.ts']);
+        // Mutate disk; accessor should still return prewarmed content
+        writeFileSync(path, 'changed');
+        const acc = createFileAccessor([path]);
+        expect(await acc.read(path)).toBe('on-disk');
+    });
+    it('LRU eviction kicks in beyond the configured capacity', async () => {
+        const paths = [];
+        for (let i = 0; i < 5; i++) {
+            const p = join(testDir, `${i}.ts`);
+            writeFileSync(p, String(i));
+            paths.push(p);
+        }
+        const acc = createFileAccessor(paths, { cacheCapacity: 2 });
+        for (const p of paths)
+            await acc.read(p);
+        expect(acc.cachedCount).toBe(2);
+    });
+});
+//# sourceMappingURL=file-accessor.test.js.map

package/dist/framework/__tests__/file-accessor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-accessor.test.js","sourceRoot":"","sources":["../../../src/framework/__tests__/file-accessor.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,GAAG,EAAE;IAEd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACvC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9B,SAAS;QACT,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACtC,8EAA8E;QAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtB,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAqG,CAAC;QAC3I,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,GAAG,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/B,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,8DAA8D;QAC9D,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACnC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAA6E,CAAC;QACxI,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/framework/__tests__/file-cache.test.d.ts

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

package/dist/framework/__tests__/file-cache.test.d.ts.map

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

package/dist/framework/__tests__/file-cache.test.js

@@ -0,0 +1,122 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ValidationError } from '@opensip-tools/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { DEFAULT_PREWARM_PATTERNS, fileCache } from '../file-cache.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-fc-'));
+    fileCache.clear();
+});
+afterEach(() => {
+    fileCache.clear();
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('fileCache.prewarm', () => {
+    it('loads matching files into the cache', async () => {
+        writeFileSync(join(testDir, 'a.ts'), 'export const a = 1;');
+        writeFileSync(join(testDir, 'b.ts'), 'export const b = 2;');
+        const stats = await fileCache.prewarm(testDir, ['*.ts']);
+        expect(stats.filesLoaded).toBe(2);
+        expect(stats.totalBytes).toBeGreaterThan(0);
+        expect(stats.durationMs).toBeGreaterThanOrEqual(0);
+        expect(fileCache.stats.prewarmed).toBe(true);
+    });
+    it('respects default ignore patterns (skips node_modules)', async () => {
+        mkdirSync(join(testDir, 'node_modules', 'foo'), { recursive: true });
+        writeFileSync(join(testDir, 'node_modules', 'foo', 'x.ts'), 'export {};');
+        writeFileSync(join(testDir, 'app.ts'), 'export const app = 1;');
+        await fileCache.prewarm(testDir, ['**/*.ts']);
+        expect(fileCache.paths().some((p) => p.includes('node_modules'))).toBe(false);
+        expect(fileCache.paths().some((p) => p.endsWith('app.ts'))).toBe(true);
+    });
+    it('handles multiple patterns and deduplicates', async () => {
+        writeFileSync(join(testDir, 'x.ts'), '1');
+        const stats = await fileCache.prewarm(testDir, ['*.ts', '**/*.ts']);
+        expect(stats.filesLoaded).toBe(1);
+    });
+});
+describe('fileCache.get', () => {
+    it('returns content from disk on cache miss and caches it', async () => {
+        const path = join(testDir, 'fresh.ts');
+        writeFileSync(path, 'fresh content');
+        const content = await fileCache.get(path);
+        expect(content).toBe('fresh content');
+        expect(fileCache.getCached(path)).toBe('fresh content');
+    });
+    it('returns cached content on hit', async () => {
+        const path = join(testDir, 'a.ts');
+        writeFileSync(path, 'first');
+        await fileCache.prewarm(testDir, ['*.ts']);
+        // Mutate the file on disk; cached read still returns first
+        writeFileSync(path, 'second');
+        expect(await fileCache.get(path)).toBe('first');
+    });
+    it('throws ValidationError when path is a directory', async () => {
+        const dirPath = join(testDir, 'dir');
+        mkdirSync(dirPath);
+        await expect(fileCache.get(dirPath)).rejects.toThrow(ValidationError);
+    });
+    it('resolves relative paths against cwd', async () => {
+        const abs = join(testDir, 'foo.ts');
+        writeFileSync(abs, 'rel');
+        process.chdir(testDir);
+        const content = await fileCache.get('foo.ts');
+        expect(content).toBe('rel');
+    });
+});
+describe('fileCache.getCached', () => {
+    it('returns undefined when file is not in cache', () => {
+        expect(fileCache.getCached('/nope/nope.ts')).toBeUndefined();
+    });
+    it('returns cached content after prewarm', async () => {
+        writeFileSync(join(testDir, 'q.ts'), 'q');
+        await fileCache.prewarm(testDir, ['*.ts']);
+        expect(fileCache.getCached(join(testDir, 'q.ts'))).toBe('q');
+    });
+});
+describe('fileCache.exists', () => {
+    it('returns true for cached files', async () => {
+        writeFileSync(join(testDir, 'e.ts'), 'e');
+        await fileCache.prewarm(testDir, ['*.ts']);
+        expect(await fileCache.exists(join(testDir, 'e.ts'))).toBe(true);
+    });
+    it('returns true for files on disk but not yet cached', async () => {
+        writeFileSync(join(testDir, 'd.ts'), 'd');
+        expect(await fileCache.exists(join(testDir, 'd.ts'))).toBe(true);
+    });
+    it('returns false when file does not exist', async () => {
+        expect(await fileCache.exists(join(testDir, 'missing.ts'))).toBe(false);
+    });
+});
+describe('fileCache.clear', () => {
+    it('empties the cache and resets prewarmed flag', async () => {
+        writeFileSync(join(testDir, 'x.ts'), 'x');
+        await fileCache.prewarm(testDir, ['*.ts']);
+        expect(fileCache.stats.size).toBeGreaterThan(0);
+        fileCache.clear();
+        expect(fileCache.stats.size).toBe(0);
+        expect(fileCache.stats.prewarmed).toBe(false);
+        expect(fileCache.stats.cleared).toBe(true);
+    });
+});
+describe('fileCache.paths', () => {
+    it('returns sorted absolute paths', async () => {
+        writeFileSync(join(testDir, 'b.ts'), '');
+        writeFileSync(join(testDir, 'a.ts'), '');
+        await fileCache.prewarm(testDir, ['*.ts']);
+        const paths = fileCache.paths();
+        expect(paths.length).toBe(2);
+        expect([...paths].sort()).toEqual(paths);
+    });
+});
+describe('DEFAULT_PREWARM_PATTERNS', () => {
+    it('includes the major source extensions', () => {
+        expect(DEFAULT_PREWARM_PATTERNS).toContain('**/*.ts');
+        expect(DEFAULT_PREWARM_PATTERNS).toContain('**/*.tsx');
+        expect(DEFAULT_PREWARM_PATTERNS).toContain('**/*.js');
+        expect(DEFAULT_PREWARM_PATTERNS).toContain('**/*.json');
+    });
+});
+//# sourceMappingURL=file-cache.test.js.map

package/dist/framework/__tests__/file-cache.test.js.map

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

package/dist/framework/__tests__/import-graph.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Unit tests for the import-graph builder + Tarjan's SCC.
+ *
+ * Covers:
+ *   - Basic relative-import resolution (./foo, ../bar, with/without ext)
+ *   - Index resolution (./foo/index.ts)
+ *   - ESM extension swap (.js → .ts)
+ *   - Bare specifiers dropped (npm packages don't appear as edges)
+ *   - export-from declarations contribute edges
+ *   - Files that fail to parse still appear as nodes
+ *   - SCC detection: simple 2-cycle, larger cycle, multiple disjoint cycles,
+ *     no-cycle case, self-loop
+ */
+export {};
+//# sourceMappingURL=import-graph.test.d.ts.map

package/dist/framework/__tests__/import-graph.test.d.ts.map

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