@opensip-cli/fitness 0.1.0

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,140 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { LanguageRegistry, RunScope, ToolRegistry, runWithScopeSync } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { createExecutionContext } from '../execution-context.js';
+import { fileCache } from '../file-cache.js';
+import { PathMatcher } from '../path-matcher.js';
+/** Fresh scope with empty registries — local equivalent of the retired
+ *  `@opensip-cli/core/test-utils` helper. The fitness engine's own tests
+ *  cannot use `@opensip-cli/test-support` (it depends on this package —
+ *  the dev edge would make the package graph cyclic; ADR-0040). */
+const makeTestScope = (opts = {}) => new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry(), ...opts });
+const withScopeSync = runWithScopeSync;
+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);
+    });
+});
+describe('createExecutionContext > extractSnippet, log, checkAborted', () => {
+    it('extractSnippet delegates to result-builder.extractSnippet with a default of 2 context lines', () => {
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ctx = createExecutionContext({ id: 'test-id', slug: 'test-slug', itemType: 'files' }, testDir, matcher);
+        const out = ctx.extractSnippet('a\nb\nc\nd\ne', 3);
+        expect(out.snippet).toBeDefined();
+        expect(out.contextLines).toBeGreaterThan(0);
+    });
+    it('log routes verbose output through the scope logger only when verbose is true', () => {
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const infoSpy = vi.fn();
+        const stubLogger = {
+            debug: vi.fn(),
+            info: infoSpy,
+            warn: vi.fn(),
+            error: vi.fn(),
+        };
+        const scope = makeTestScope({ logger: stubLogger });
+        withScopeSync(scope, () => {
+            const verboseCtx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher, { verbose: true });
+            verboseCtx.log('hello');
+            const quietCtx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher);
+            quietCtx.log('silent');
+        });
+        expect(infoSpy).toHaveBeenCalledTimes(1);
+        expect(infoSpy).toHaveBeenCalledWith(expect.objectContaining({
+            evt: 'fitness.check.verbose',
+            checkSlug: 'slug',
+            message: 'hello',
+        }));
+    });
+    it('checkAborted throws CheckAbortedError when the signal is aborted', () => {
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ac = new AbortController();
+        const ctx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher, { signal: ac.signal });
+        expect(() => {
+            ctx.checkAborted();
+        }).not.toThrow();
+        ac.abort();
+        expect(() => {
+            ctx.checkAborted();
+        }).toThrow();
+    });
+    it('readFile rejects files that exceed the 10MB limit', async () => {
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ctx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher);
+        // Read a non-existent file — fs.stat will throw, which propagates.
+        await expect(ctx.readFile('/nonexistent/path/file.ts')).rejects.toThrow();
+    });
+    it('fileExists delegates to fileCache', async () => {
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ctx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher);
+        const result = await ctx.fileExists('/nonexistent.ts');
+        expect(typeof result).toBe('boolean');
+    });
+    it('getMatcher returns the same matcher passed in', () => {
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ctx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher);
+        expect(ctx.getMatcher()).toBe(matcher);
+    });
+    it('matchFiles with explicit patterns ignores the targetFiles override', async () => {
+        mkdirSync(join(testDir, 'src'), { recursive: true });
+        writeFileSync(join(testDir, 'src', 'a.ts'), 'x');
+        const matcher = PathMatcher.create({ cwd: testDir, include: [], exclude: [] });
+        const ctx = createExecutionContext({ id: 'id', slug: 'slug', itemType: 'files' }, testDir, matcher, { targetFiles: ['/some/preresolved/file.ts'] });
+        // Custom patterns path skips targetFiles fallback.
+        const out = await ctx.matchFiles(['src/**/*.ts']);
+        expect(out.length).toBeGreaterThan(0);
+        expect(out[0]).not.toBe('/some/preresolved/file.ts');
+    });
+});
+//# 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,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD;;;mEAGmE;AACnE,MAAM,aAAa,GAAG,CAAC,OAAwB,EAAE,EAAY,EAAE,CAC7D,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,IAAI,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAC1F,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,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,CAAC;QACrD,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAClE,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,UAAU,CAAC,CAAC;QAC9D,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,cAAkC;QAC7D,gBAAgB,EAAE,CAAC;QACnB,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAEtE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,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,CAAC;QACF,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,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,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,gEAAgE;QAChE,wDAAwD;QACxD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4DAA4D,EAAE,GAAG,EAAE;IAC1E,EAAE,CAAC,6FAA6F,EAAE,GAAG,EAAE;QACrG,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,EACvD,OAAO,EACP,OAAO,CACR,CAAC;QACF,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG;YACjB,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;YACd,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;YACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;SACE,CAAC;QACnB,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QAEpD,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE;YACxB,MAAM,UAAU,GAAG,sBAAsB,CACvC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,EACP,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;YACF,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAExB,MAAM,QAAQ,GAAG,sBAAsB,CACrC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,CACR,CAAC;YACF,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAClC,MAAM,CAAC,gBAAgB,CAAC;YACtB,GAAG,EAAE,uBAAuB;YAC5B,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,OAAO;SACjB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,EACP,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CACtB,CAAC;QACF,MAAM,CAAC,GAAG,EAAE;YACV,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,EAAE;YACV,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,CACR,CAAC;QACF,mEAAmE;QACnE,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,CACR,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACvD,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,CACR,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,sBAAsB,CAChC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAC7C,OAAO,EACP,OAAO,EACP,EAAE,WAAW,EAAE,CAAC,2BAA2B,CAAC,EAAE,CAC/C,CAAC;QACF,mDAAmD;QACnD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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-cli/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":"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"}

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-cli/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__/file-type-filter.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Tests for filterFilesByType.
+ *
+ * The filter is responsible for narrowing the list of matched files to
+ * the extensions a check declares — universal checks (no fileTypes) get
+ * everything, language-specific checks get only matching extensions.
+ */
+export {};
+//# sourceMappingURL=file-type-filter.test.d.ts.map

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

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

package/dist/framework/__tests__/file-type-filter.test.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Tests for filterFilesByType.
+ *
+ * The filter is responsible for narrowing the list of matched files to
+ * the extensions a check declares — universal checks (no fileTypes) get
+ * everything, language-specific checks get only matching extensions.
+ */
+import { describe, expect, it } from 'vitest';
+import { filterFilesByType } from '../file-type-filter.js';
+describe('filterFilesByType', () => {
+    const files = ['src/a.ts', 'src/b.tsx', 'src/c.js', 'src/d.py', 'src/e.rs', 'no-extension'];
+    it('returns every file when fileTypes is undefined (universal check)', () => {
+        const out = filterFilesByType(files, undefined);
+        expect(out).toEqual(files);
+    });
+    it('returns every file when fileTypes is an empty array', () => {
+        const out = filterFilesByType(files, []);
+        expect(out).toEqual(files);
+    });
+    it('returns only matching extensions when fileTypes is set', () => {
+        const out = filterFilesByType(files, ['ts', 'tsx']);
+        expect(out).toEqual(['src/a.ts', 'src/b.tsx']);
+    });
+    it('returns an empty list when no files match the declared extensions', () => {
+        const out = filterFilesByType(files, ['rb']);
+        expect(out).toEqual([]);
+    });
+    it('excludes files without an extension', () => {
+        const out = filterFilesByType(files, ['ts']);
+        expect(out).toEqual(['src/a.ts']);
+        expect(out).not.toContain('no-extension');
+    });
+    it('returns a new array (does not mutate input)', () => {
+        const out = filterFilesByType(files, undefined);
+        expect(out).not.toBe(files);
+        expect(out).toEqual(files);
+    });
+});
+//# sourceMappingURL=file-type-filter.test.js.map

package/dist/framework/__tests__/file-type-filter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-filter.test.js","sourceRoot":"","sources":["../../../src/framework/__tests__/file-type-filter.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAE5F,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/framework/__tests__/ignore-processing.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Tests for filterSignalsByDirectives and buildFilteredResult.
+ *
+ * Covers the two main entrypoints the engine uses to suppress signals
+ * via `@fitness-ignore-file` and `@fitness-ignore-next-line`. Also
+ * covers the anti-recursion guard (signals pointing AT a directive
+ * line are never suppressed, otherwise directive-auditing checks would
+ * silently hide their own findings).
+ */
+export {};
+//# sourceMappingURL=ignore-processing.test.d.ts.map

package/dist/framework/__tests__/ignore-processing.test.d.ts.map

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