@opensip-cli/fitness 0.1.0

package/dist/framework/__tests__/abortable-exec.test.js

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Tests for execAbortable.
+ *
+ * Covers the array and shell modes, abort signal handling (pre-spawn
+ * and during execution), timeout, and error paths (empty array,
+ * spawn failure).
+ */
+import { SystemError } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { execAbortable } from '../abortable-exec.js';
+describe('execAbortable — array mode', () => {
+    it('runs a command and returns stdout / exit code', async () => {
+        const result = await execAbortable(['echo', 'hello']);
+        expect(result.stdout.trim()).toBe('hello');
+        expect(result.exitCode).toBe(0);
+        expect(result.aborted).toBe(false);
+    });
+    it('captures stderr separately from stdout', async () => {
+        const result = await execAbortable(['sh', '-c', 'echo to-stderr 1>&2']);
+        expect(result.stderr.trim()).toBe('to-stderr');
+        expect(result.exitCode).toBe(0);
+    });
+    it('preserves multi-byte UTF-8 output split across stream chunks', async () => {
+        // A large payload is delivered by the OS pipe in multiple ~64 KiB
+        // 'data' chunks. A 3-byte char (中, U+4E2D) is used deliberately:
+        // 65536 is not a multiple of 3, so the chunk boundary lands
+        // mid-character. Without setEncoding, per-chunk decoding emits U+FFFD
+        // replacement chars there. (A 4-byte char would falsely pass — 65536
+        // is divisible by 4, so its boundaries align.)
+        const count = 300_000;
+        const result = await execAbortable([
+            process.execPath,
+            '-e',
+            `process.stdout.write('中'.repeat(${count}))`,
+        ]);
+        expect(result.exitCode).toBe(0);
+        expect(result.stdout).not.toContain('�');
+        expect(result.stdout).toBe('中'.repeat(count));
+    });
+    it('returns a non-zero exit code without throwing', async () => {
+        const result = await execAbortable(['sh', '-c', 'exit 3']);
+        expect(result.exitCode).toBe(3);
+        expect(result.aborted).toBe(false);
+    });
+    it('rejects with SystemError when the command array is empty', async () => {
+        await expect(execAbortable([])).rejects.toThrow(SystemError);
+    });
+    it('rejects with ExecError when the binary cannot be spawned', async () => {
+        await expect(execAbortable(['definitely-not-a-real-binary-zzz'])).rejects.toMatchObject({
+            name: 'ExecError',
+        });
+    });
+});
+describe('execAbortable — shell (string) mode', () => {
+    it('runs a string command via the shell and returns stdout', async () => {
+        const result = await execAbortable('echo shell-mode');
+        expect(result.stdout.trim()).toBe('shell-mode');
+        expect(result.exitCode).toBe(0);
+    });
+    it('returns shell exit code 127 for an unknown command', async () => {
+        // sh -c emits 127 when the command name isn't found; the wrapper
+        // doesn't classify this as an error — it surfaces the exit code.
+        const result = await execAbortable('definitely-not-a-real-binary-zzz');
+        expect(result.exitCode).toBe(127);
+    });
+});
+describe('execAbortable — abort signal', () => {
+    it('returns aborted=true immediately when signal is already aborted', async () => {
+        const ctrl = new AbortController();
+        ctrl.abort();
+        const result = await execAbortable(['echo', 'never-runs'], { signal: ctrl.signal });
+        expect(result.aborted).toBe(true);
+        expect(result.stdout).toBe('');
+    });
+    it('aborts a running process when the signal fires mid-execution', async () => {
+        const ctrl = new AbortController();
+        setTimeout(() => ctrl.abort(), 30);
+        const result = await execAbortable(['sh', '-c', 'sleep 5'], { signal: ctrl.signal });
+        expect(result.aborted).toBe(true);
+    });
+});
+describe('execAbortable — timeout', () => {
+    it('aborts a running process when timeout elapses', async () => {
+        const result = await execAbortable(['sh', '-c', 'sleep 5'], { timeout: 50 });
+        expect(result.aborted).toBe(true);
+    });
+    it('does not abort fast commands', async () => {
+        const result = await execAbortable(['echo', 'quick'], { timeout: 5000 });
+        expect(result.aborted).toBe(false);
+        expect(result.stdout.trim()).toBe('quick');
+    });
+});
+describe('execAbortable — buffering', () => {
+    it('caps stdout buffer at maxBuffer', async () => {
+        // Generate 200 KB of stdout and cap buffer at 1 KB. The spawned
+        // process succeeds; buffer cap just truncates what we capture.
+        const result = await execAbortable(['sh', '-c', 'yes x | head -c 200000'], { maxBuffer: 1024 });
+        expect(result.stdout.length).toBeLessThanOrEqual(1024);
+        expect(result.exitCode).toBeDefined();
+    });
+});
+//# sourceMappingURL=abortable-exec.test.js.map

package/dist/framework/__tests__/abortable-exec.test.js.map

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

package/dist/framework/__tests__/check-config.test.d.ts

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

package/dist/framework/__tests__/check-config.test.d.ts.map

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

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

@@ -0,0 +1,56 @@
+import { describe, it, expect } from 'vitest';
+import { validateCheckConfig } from '../check-config.js';
+const BASE_CONFIG = {
+    id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+    slug: 'test-check',
+    description: 'A test check',
+    tags: ['quality'],
+    analyze: () => [],
+};
+describe('validateCheckConfig', () => {
+    it('accepts a check with tags array', () => {
+        expect(() => validateCheckConfig(BASE_CONFIG)).not.toThrow();
+    });
+    it('rejects a check without tags', () => {
+        const config = { ...BASE_CONFIG, tags: undefined };
+        expect(() => validateCheckConfig(config)).toThrow();
+    });
+    it('rejects a check with empty tags array', () => {
+        const config = { ...BASE_CONFIG, tags: [] };
+        expect(() => validateCheckConfig(config)).toThrow();
+    });
+    it('accepts arbitrary tag strings', () => {
+        const config = { ...BASE_CONFIG, tags: ['custom-tag', 'another-one', 'cwe-89'] };
+        expect(() => validateCheckConfig(config)).not.toThrow();
+    });
+    it('validates all three analysis modes with tags', () => {
+        // analyze mode
+        expect(() => validateCheckConfig({
+            ...BASE_CONFIG,
+            analyze: (_content) => [],
+        })).not.toThrow();
+        // analyzeAll mode
+        // eslint-disable-next-line sonarjs/no-unused-vars -- destructure-omit pattern: drop `analyze` from spread copy
+        const { analyze: _, ...noAnalyze } = BASE_CONFIG;
+        expect(() => validateCheckConfig({
+            ...noAnalyze,
+            // eslint-disable-next-line @typescript-eslint/require-await -- arrow must match `(files: FileAccessor) => Promise<CheckViolation[]>`
+            analyzeAll: async () => [],
+        })).not.toThrow();
+        // command mode
+        expect(() => validateCheckConfig({
+            ...noAnalyze,
+            command: {
+                bin: 'echo',
+                args: [],
+                parseOutput: () => [],
+            },
+        })).not.toThrow();
+    });
+    it('rejects config without any analysis mode', () => {
+        // eslint-disable-next-line sonarjs/no-unused-vars -- destructure-omit pattern: drop `analyze` from spread copy
+        const { analyze: _, ...noMode } = BASE_CONFIG;
+        expect(() => validateCheckConfig(noMode)).toThrow();
+    });
+});
+//# sourceMappingURL=check-config.test.js.map

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

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

package/dist/framework/__tests__/check-types.test.d.ts

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

package/dist/framework/__tests__/check-types.test.d.ts.map

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

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

@@ -0,0 +1,76 @@
+import { describe, expect, it } from 'vitest';
+import { collectCheckObjects, isCheck } from '../check-types.js';
+import { defineCheck } from '../define-check.js';
+const noopRun = () => null;
+const checkA = defineCheck({
+    id: '11111111-1111-4111-8111-111111111111',
+    slug: 'check-a',
+    description: 'a',
+    tags: ['quality'],
+    analyze: () => [],
+});
+const checkB = defineCheck({
+    id: '22222222-2222-4222-8222-222222222222',
+    slug: 'check-b',
+    description: 'b',
+    tags: ['quality'],
+    analyze: () => [],
+});
+describe('isCheck', () => {
+    it('returns true for a Check produced by defineCheck', () => {
+        expect(isCheck(checkA)).toBe(true);
+    });
+    it('returns false for null / undefined / primitives', () => {
+        expect(isCheck(null)).toBe(false);
+        expect(isCheck(undefined)).toBe(false);
+        expect(isCheck(42)).toBe(false);
+        expect(isCheck('check')).toBe(false);
+    });
+    it('returns false for an object missing config.execute', () => {
+        expect(isCheck({ config: { id: 'x', slug: 'y' }, run: noopRun })).toBe(false);
+    });
+});
+describe('collectCheckObjects', () => {
+    it('returns a flat list of Check instances from a flat barrel', () => {
+        const out = collectCheckObjects({ checkA, checkB });
+        expect(out).toHaveLength(2);
+        expect(new Set(out.map((c) => c.config.slug))).toEqual(new Set(['check-a', 'check-b']));
+    });
+    it('recurses into nested object exports', () => {
+        const out = collectCheckObjects({
+            quality: { checkA },
+            security: { nested: { checkB } },
+        });
+        expect(out).toHaveLength(2);
+    });
+    it('deduplicates by config.id when the same check appears multiple times', () => {
+        const out = collectCheckObjects({
+            direct: checkA,
+            reExport: checkA,
+            nested: { checkA },
+        });
+        expect(out).toHaveLength(1);
+        expect(out[0]?.config.slug).toBe('check-a');
+    });
+    it('skips non-Check values (numbers, arrays, primitives)', () => {
+        const out = collectCheckObjects({
+            checkA,
+            meta: 'description',
+            version: 1,
+            // Arrays must NOT be traversed — they are typically the `checks`
+            // re-export the loader handles separately.
+            checksArray: [checkB],
+        });
+        expect(out).toHaveLength(1);
+        expect(out[0]?.config.slug).toBe('check-a');
+    });
+    it('threads a shared seen set across multiple calls', () => {
+        const seen = new Set();
+        const first = collectCheckObjects({ checkA }, seen);
+        const second = collectCheckObjects({ checkA, checkB }, seen);
+        expect(first).toHaveLength(1);
+        expect(second).toHaveLength(1);
+        expect(second[0]?.config.slug).toBe('check-b');
+    });
+});
+//# sourceMappingURL=check-types.test.js.map

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

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

package/dist/framework/__tests__/command-executor.test.d.ts

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

package/dist/framework/__tests__/command-executor.test.d.ts.map

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

package/dist/framework/__tests__/command-executor.test.js

@@ -0,0 +1,110 @@
+import { describe, expect, it } from 'vitest';
+import { executeCommand } from '../command-executor.js';
+const cwd = process.cwd();
+describe('executeCommand', () => {
+    it('runs a command with array args and parses stdout', async () => {
+        const config = {
+            bin: 'echo',
+            args: ['hello'],
+            parseOutput: (stdout) => [
+                {
+                    line: 1,
+                    message: stdout.trim(),
+                    severity: 'warning',
+                },
+            ],
+        };
+        const result = await executeCommand(config, [], { cwd });
+        expect(result.aborted).toBe(false);
+        expect(result.exitCode).toBe(0);
+        expect(result.violations).toHaveLength(1);
+        expect(result.violations[0]?.message).toBe('hello');
+    });
+    it('runs a command with function args derived from files', async () => {
+        const config = {
+            bin: 'echo',
+            args: (files) => [`got-${files.length}`],
+            parseOutput: (stdout) => [
+                {
+                    line: 1,
+                    message: stdout.trim(),
+                    severity: 'warning',
+                },
+            ],
+        };
+        const result = await executeCommand(config, ['a', 'b', 'c'], { cwd });
+        expect(result.violations[0]?.message).toBe('got-3');
+    });
+    it('returns an error when the bin is not installed (ENOENT)', async () => {
+        const config = {
+            bin: 'definitely-not-a-real-binary-xyz123',
+            args: [],
+            parseOutput: () => [],
+        };
+        const result = await executeCommand(config, [], { cwd });
+        expect(result.error).toContain('not installed');
+        expect(result.violations).toEqual([]);
+    });
+    it('returns an error when exit code is unexpected', async () => {
+        const config = {
+            bin: 'sh',
+            args: ['-c', 'exit 5'],
+            parseOutput: () => [],
+            expectedExitCodes: [0],
+        };
+        const result = await executeCommand(config, [], { cwd });
+        expect(result.error).toContain('unexpected code 5');
+        expect(result.violations).toEqual([]);
+    });
+    it('honors expectedExitCodes when set', async () => {
+        const config = {
+            bin: 'sh',
+            args: ['-c', 'echo done; exit 1'],
+            parseOutput: (stdout) => [
+                {
+                    line: 1,
+                    message: stdout.trim(),
+                    severity: 'warning',
+                },
+            ],
+            expectedExitCodes: [0, 1],
+        };
+        const result = await executeCommand(config, [], { cwd });
+        expect(result.violations).toHaveLength(1);
+        expect(result.exitCode).toBe(1);
+    });
+    it('returns aborted=true when the abort signal fires mid-run', async () => {
+        const ctrl = new AbortController();
+        const config = {
+            bin: 'sh',
+            args: ['-c', 'sleep 5'],
+            parseOutput: () => [],
+        };
+        setTimeout(() => ctrl.abort(), 30);
+        const result = await executeCommand(config, [], { cwd, signal: ctrl.signal });
+        expect(result.aborted).toBe(true);
+        expect(result.violations).toEqual([]);
+    });
+    it('reports "not installed" via shell-mode 127 when the bin exits 127', async () => {
+        const config = {
+            bin: 'sh',
+            args: ['-c', 'exit 127'],
+            parseOutput: () => [],
+        };
+        const result = await executeCommand(config, [], { cwd });
+        expect(result.exitCode).toBe(127);
+        expect(result.error).toContain('not installed');
+    });
+    it('truncates very long stderr in error messages', async () => {
+        const config = {
+            bin: 'sh',
+            args: ['-c', 'yes x | head -c 1000 1>&2; exit 5'],
+            parseOutput: () => [],
+            expectedExitCodes: [0],
+        };
+        const result = await executeCommand(config, [], { cwd });
+        expect(result.error).toContain('unexpected code 5');
+        expect(result.error).toContain('truncated');
+    });
+});
+//# sourceMappingURL=command-executor.test.js.map

package/dist/framework/__tests__/command-executor.test.js.map

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

package/dist/framework/__tests__/content-filter-dispatch.test.d.ts

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

package/dist/framework/__tests__/content-filter-dispatch.test.d.ts.map

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

package/dist/framework/__tests__/content-filter-dispatch.test.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Pin the contentFilter dispatch in define-check.ts and
+ * file-accessor.ts. Two modes are intentional and distinct:
+ *
+ *   - `strip-strings`             → strings blanked, COMMENTS PRESERVED.
+ *                                   Use when a rule reads comment markers
+ *                                   (e.g. `// @swallow-ok`).
+ *   - `strip-strings-and-comments` → both blanked. Use when the same
+ *                                    forbidden phrase could appear in a
+ *                                    comment and would false-fire.
+ *
+ * Mixing them was the bug behind a 2026-05-05 mis-fix that mapped both
+ * modes to codeNoComments, breaking every rule that scans comments for
+ * directives. This test pins the contract.
+ *
+ * The legacy `'code-only'` / `'no-strings-no-comments'` aliases were
+ * removed in 0.5.0; this file used to assert the alias mapping and now
+ * just asserts the canonical names.
+ */
+import { mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { LanguageRegistry, RunScope, runWithScope } from '@opensip-cli/core';
+import { filterContent } from '@opensip-cli/lang-typescript';
+import { beforeAll, describe, expect, it } from 'vitest';
+import { createFileAccessor } from '../file-accessor.js';
+// FileAccessor.read dispatches strip via the registered LanguageAdapter
+// for the file's extension. Register a minimal TS adapter for the test
+// scope so the dispatch resolves and the existing core filterContent
+// implementation produces the expected output. Lang packages live in
+// their own workspaces and core can't depend on @opensip-cli/lang-typescript
+// directly without creating a cycle.
+const inProcessTypescriptAdapter = {
+    id: 'typescript-test-shim',
+    fileExtensions: ['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'],
+    parse: () => null,
+    stripStrings: (s) => filterContent(s).code,
+    stripComments: (s) => filterContent(s).codeNoComments,
+};
+let scope;
+beforeAll(() => {
+    const reg = new LanguageRegistry();
+    reg.register(inProcessTypescriptAdapter);
+    scope = new RunScope({ languages: reg });
+});
+function inScope(fn) {
+    return runWithScope(scope, fn);
+}
+async function writeTempFile(content) {
+    const dir = await mkdtemp(join(tmpdir(), 'cf-dispatch-'));
+    const filePath = join(dir, 'sample.ts');
+    await writeFile(filePath, content, 'utf8');
+    return filePath;
+}
+describe('FileAccessor contentFilter dispatch', () => {
+    describe('strip-strings — strings blanked, comments preserved', () => {
+        it('preserves line-comment text so rules can scan markers', async () => {
+            await inScope(async () => {
+                const filePath = await writeTempFile(`const a = 1\n// @swallow-ok intentional fallthrough\nconst b = 2`);
+                const accessor = createFileAccessor([filePath], { contentFilter: 'strip-strings' });
+                const content = await accessor.read(filePath);
+                expect(content).toContain('@swallow-ok');
+                expect(content).toContain('const a = 1');
+                expect(content).toContain('const b = 2');
+            });
+        });
+        it('preserves block-comment text including JSDoc directives', async () => {
+            await inScope(async () => {
+                const filePath = await writeTempFile(`/** @deprecated use Y instead */\nexport function legacy() {}`);
+                const accessor = createFileAccessor([filePath], { contentFilter: 'strip-strings' });
+                const content = await accessor.read(filePath);
+                expect(content).toContain('@deprecated');
+                expect(content).toContain('export function legacy');
+            });
+        });
+        it('blanks string-literal contents', async () => {
+            await inScope(async () => {
+                const filePath = await writeTempFile(`const url = 'phrase_in_string'`);
+                const accessor = createFileAccessor([filePath], { contentFilter: 'strip-strings' });
+                const content = await accessor.read(filePath);
+                expect(content).not.toContain('phrase_in_string');
+                expect(content).toContain('const url = ');
+            });
+        });
+    });
+    describe('strip-strings-and-comments — both blanked', () => {
+        it("blanks comment text so rules don't false-fire on prose", async () => {
+            await inScope(async () => {
+                const filePath = await writeTempFile(`const a = 1\n// forbidden_phrase_in_comment\nconst b = 2`);
+                const accessor = createFileAccessor([filePath], {
+                    contentFilter: 'strip-strings-and-comments',
+                });
+                const content = await accessor.read(filePath);
+                expect(content).not.toContain('forbidden_phrase_in_comment');
+                expect(content).toContain('const a = 1');
+                expect(content).toContain('const b = 2');
+            });
+        });
+        it('blanks both strings and comments in the same content', async () => {
+            await inScope(async () => {
+                const filePath = await writeTempFile(`const url = 'phrase_in_string' // phrase_in_comment`);
+                const accessor = createFileAccessor([filePath], {
+                    contentFilter: 'strip-strings-and-comments',
+                });
+                const content = await accessor.read(filePath);
+                expect(content).not.toContain('phrase_in_string');
+                expect(content).not.toContain('phrase_in_comment');
+            });
+        });
+    });
+    describe('default (raw) — no filter applied', () => {
+        it('preserves both strings and comments verbatim', async () => {
+            // raw passthrough doesn't need a scope; applyContentFilter short-circuits.
+            const src = `const url = 'phrase'\n// also phrase`;
+            const filePath = await writeTempFile(src);
+            const accessor = createFileAccessor([filePath]); // no contentFilter → raw passthrough
+            const content = await accessor.read(filePath);
+            expect(content).toBe(src);
+        });
+    });
+});
+//# sourceMappingURL=content-filter-dispatch.test.js.map

package/dist/framework/__tests__/content-filter-dispatch.test.js.map

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

package/dist/framework/__tests__/define-check.test.d.ts

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

package/dist/framework/__tests__/define-check.test.d.ts.map

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