@opensip-cli/fitness 0.1.0

package/dist/framework/__tests__/ignore-processing.test.js

@@ -0,0 +1,175 @@
+/**
+ * @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).
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { createSignal } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { fileCache } from '../file-cache.js';
+import { buildFilteredResult, filterSignalsByDirectives } from '../ignore-processing.js';
+let testDir;
+function fixture(rel, content) {
+    const abs = join(testDir, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    return abs;
+}
+function mkSignal(file, line, message = 'finding') {
+    return createSignal({
+        source: 'fitness',
+        provider: 'opensip',
+        severity: 'high',
+        category: 'quality',
+        ruleId: 'fit:no-foo',
+        message,
+        code: { file, line, column: 1 },
+    });
+}
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-ignore-proc-'));
+});
+afterEach(() => {
+    fileCache.clear();
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('filterSignalsByDirectives — file-level ignore', () => {
+    it('suppresses every signal in a file marked `@fitness-ignore-file <slug>`', async () => {
+        const file = fixture('src/a.ts', '// @fitness-ignore-file no-foo -- justified\nconst x = "FOO";\nconst y = "FOO";');
+        await fileCache.prewarm(testDir, ['**/*.ts']);
+        const signals = [mkSignal(file, 2), mkSignal(file, 3)];
+        const out = await filterSignalsByDirectives(signals, 'no-foo', 0);
+        expect(out.filteredSignals).toEqual([]);
+        expect(out.ignoredCount).toBe(2);
+        expect(out.appliedDirectives).toHaveLength(1);
+        expect(out.appliedDirectives[0]?.type).toBe('file');
+        expect(out.appliedDirectives[0]?.checkId).toBe('no-foo');
+    });
+    it('does not suppress signals when the file ignore targets a different check', async () => {
+        const file = fixture('src/a.ts', '// @fitness-ignore-file other-check\nconst x = "FOO";');
+        await fileCache.prewarm(testDir, ['**/*.ts']);
+        const signals = [mkSignal(file, 2)];
+        const out = await filterSignalsByDirectives(signals, 'no-foo', 0);
+        expect(out.filteredSignals).toHaveLength(1);
+        expect(out.ignoredCount).toBe(0);
+    });
+});
+describe('filterSignalsByDirectives — line-level ignore', () => {
+    it('suppresses a signal on the line immediately following a `@fitness-ignore-next-line` directive', async () => {
+        const file = fixture('src/a.ts', [
+            'const a = 1',
+            '// @fitness-ignore-next-line no-foo -- justified',
+            'const x = "FOO"', // line 3 — suppressed
+            'const y = "FOO"', // line 4 — not suppressed
+        ].join('\n'));
+        await fileCache.prewarm(testDir, ['**/*.ts']);
+        const signals = [mkSignal(file, 3), mkSignal(file, 4)];
+        const out = await filterSignalsByDirectives(signals, 'no-foo', 0);
+        expect(out.filteredSignals).toHaveLength(1);
+        expect(out.filteredSignals[0]?.code?.line).toBe(4);
+        expect(out.ignoredCount).toBe(1);
+        expect(out.appliedDirectives).toHaveLength(1);
+        expect(out.appliedDirectives[0]?.type).toBe('next-line');
+    });
+    it('never suppresses a signal pointing at a directive line itself (anti-recursion)', async () => {
+        const file = fixture('src/a.ts', ['// @fitness-ignore-next-line no-foo -- bad', 'const x = "FOO"'].join('\n'));
+        await fileCache.prewarm(testDir, ['**/*.ts']);
+        // A directive-auditing check pointing at the directive line (1) MUST
+        // pass through, otherwise its own findings would silently disappear.
+        const signals = [mkSignal(file, 1, 'directive findings')];
+        const out = await filterSignalsByDirectives(signals, 'no-foo', 0);
+        expect(out.filteredSignals).toHaveLength(1);
+        expect(out.ignoredCount).toBe(0);
+    });
+});
+describe('filterSignalsByDirectives — edge cases', () => {
+    it('ignores signals without a filePath', async () => {
+        const signals = [
+            createSignal({
+                source: 'fitness',
+                provider: 'opensip',
+                severity: 'high',
+                category: 'quality',
+                ruleId: 'fit:no-foo',
+                message: 'no-file',
+                code: { line: 1, column: 1, file: '' },
+            }),
+        ];
+        const out = await filterSignalsByDirectives(signals, 'no-foo', 0);
+        // Empty file path makes uniqueFiles set skip it; signal is kept as-is
+        expect(out.filteredSignals).toHaveLength(1);
+    });
+    it('preserves the initialIgnoredCount when no signals are filtered', async () => {
+        const out = await filterSignalsByDirectives([], 'no-foo', 5);
+        expect(out.ignoredCount).toBe(5);
+        expect(out.filteredSignals).toEqual([]);
+    });
+    it('handles a signal pointing at a non-existent file gracefully', async () => {
+        const signals = [mkSignal('/does/not/exist.ts', 1)];
+        const out = await filterSignalsByDirectives(signals, 'no-foo', 0);
+        expect(out.filteredSignals).toHaveLength(1);
+        expect(out.ignoredCount).toBe(0);
+    });
+});
+function mkResult(signals) {
+    return {
+        passed: signals.every((s) => s.severity !== 'high'),
+        errors: signals.filter((s) => s.severity === 'high').length,
+        warnings: signals.filter((s) => s.severity !== 'high').length,
+        signals: [...signals],
+        info: { label: 'test result' },
+        metadata: {
+            durationMs: 100,
+            totalItems: 0,
+            filesScanned: 0,
+            itemType: 'files',
+            signals: [...signals],
+        },
+    };
+}
+describe('buildFilteredResult', () => {
+    it('returns the original result when filteredSignals is not an array', () => {
+        const result = mkResult([]);
+        // @ts-expect-error — exercising the runtime guard
+        const out = buildFilteredResult(result, undefined, 0, Date.now());
+        expect(out).toBe(result);
+    });
+    it('recomputes errors / warnings / passed from filtered signals', () => {
+        const file = '/virtual/a.ts';
+        const errSig = mkSignal(file, 1);
+        const warnSig = createSignal({
+            source: 'fitness',
+            provider: 'opensip',
+            severity: 'medium',
+            category: 'quality',
+            ruleId: 'fit:warn',
+            message: 'w',
+            code: { file, line: 2, column: 1 },
+        });
+        const original = mkResult([errSig, warnSig]);
+        const out = buildFilteredResult(original, [warnSig], 1, Date.now() - 10);
+        expect(out.errors).toBe(0);
+        expect(out.warnings).toBe(1);
+        expect(out.passed).toBe(true);
+        expect(out.signals).toHaveLength(1);
+        expect(out.ignoredCount).toBe(1);
+    });
+    it('omits ignoredCount when zero', () => {
+        const file = '/virtual/a.ts';
+        const sig = mkSignal(file, 1);
+        const out = buildFilteredResult(mkResult([sig]), [sig], 0, Date.now());
+        expect(out.ignoredCount).toBeUndefined();
+    });
+    it('uses metadata.durationMs when available', () => {
+        const result = mkResult([]);
+        const out = buildFilteredResult(result, [], 0, Date.now());
+        expect(out.metadata.durationMs).toBe(100);
+    });
+});
+//# sourceMappingURL=ignore-processing.test.js.map

package/dist/framework/__tests__/ignore-processing.test.js.map

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

package/dist/framework/__tests__/import-graph.test.js

@@ -0,0 +1,164 @@
+/**
+ * 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
+ */
+import { describe, expect, it } from 'vitest';
+import { buildImportGraph, findStronglyConnectedComponents, } from '../import-graph.js';
+// ---------------------------------------------------------------------------
+// Helpers — synthetic file maps
+// ---------------------------------------------------------------------------
+function map(...entries) {
+    return new Map(entries);
+}
+// ---------------------------------------------------------------------------
+// buildImportGraph — resolution
+// ---------------------------------------------------------------------------
+describe('buildImportGraph — resolution', () => {
+    it('resolves relative ./foo imports', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { x } from './b'`], ['/p/src/b.ts', `export const x = 1`]));
+        expect(g.outbound.get('/p/src/a.ts').has('/p/src/b.ts')).toBe(true);
+        expect(g.inbound.get('/p/src/b.ts').has('/p/src/a.ts')).toBe(true);
+    });
+    it('resolves ../foo imports', () => {
+        const g = buildImportGraph(map(['/p/src/sub/a.ts', `import { x } from '../b'`], ['/p/src/b.ts', `export const x = 1`]));
+        expect(g.outbound.get('/p/src/sub/a.ts').has('/p/src/b.ts')).toBe(true);
+    });
+    it('resolves index files (./foo → ./foo/index.ts)', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { x } from './lib'`], ['/p/src/lib/index.ts', `export const x = 1`]));
+        expect(g.outbound.get('/p/src/a.ts').has('/p/src/lib/index.ts')).toBe(true);
+    });
+    it('resolves .tsx files', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { B } from './b'`], ['/p/src/b.tsx', `export const B = () => null`]));
+        expect(g.outbound.get('/p/src/a.ts').has('/p/src/b.tsx')).toBe(true);
+    });
+    it('resolves ESM extension swap (.js → .ts)', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { x } from './b.js'`], ['/p/src/b.ts', `export const x = 1`]));
+        expect(g.outbound.get('/p/src/a.ts').has('/p/src/b.ts')).toBe(true);
+    });
+    it('resolves literal .ts paths', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { x } from './b.ts'`], ['/p/src/b.ts', `export const x = 1`]));
+        expect(g.outbound.get('/p/src/a.ts').has('/p/src/b.ts')).toBe(true);
+    });
+    it('drops bare specifiers (npm packages have no intra-project edge)', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { useState } from 'react'\nimport lodash from 'lodash'`]));
+        expect(g.outbound.get('/p/src/a.ts').size).toBe(0);
+    });
+    it('drops unresolved relative paths (target file not in project)', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { x } from './does-not-exist'`]));
+        expect(g.outbound.get('/p/src/a.ts').size).toBe(0);
+    });
+    it('counts export-from declarations as edges', () => {
+        const g = buildImportGraph(map(['/p/src/index.ts', `export * from './a'\nexport { x } from './b'`], ['/p/src/a.ts', `export const a = 1`], ['/p/src/b.ts', `export const x = 1`]));
+        expect(g.outbound.get('/p/src/index.ts').size).toBe(2);
+        expect(g.outbound.get('/p/src/index.ts').has('/p/src/a.ts')).toBe(true);
+        expect(g.outbound.get('/p/src/index.ts').has('/p/src/b.ts')).toBe(true);
+    });
+    it('handles side-effect imports (import "./foo")', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import './side-effect'`], ['/p/src/side-effect.ts', `console.log('loaded')`]));
+        expect(g.outbound.get('/p/src/a.ts').has('/p/src/side-effect.ts')).toBe(true);
+    });
+    it('keeps files that fail to parse as nodes (with no edges)', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `import { x } from './b'`], ['/p/src/b.ts', `export const x = 1`], 
+        // Intentionally truncated/garbled content. ts.createSourceFile is
+        // forgiving so this may parse to empty statements; either way the file
+        // should be a node.
+        ['/p/src/garbled.ts', `import { incomplete\nexport //`]));
+        expect(g.nodes.has('/p/src/garbled.ts')).toBe(true);
+        expect(g.outbound.has('/p/src/garbled.ts')).toBe(true);
+    });
+    it('initializes empty edge sets for every node', () => {
+        const g = buildImportGraph(map(['/p/src/a.ts', `// no imports`], ['/p/src/b.ts', `// no imports`]));
+        expect(g.outbound.get('/p/src/a.ts')).toBeDefined();
+        expect(g.outbound.get('/p/src/a.ts').size).toBe(0);
+        expect(g.inbound.get('/p/src/b.ts')).toBeDefined();
+        expect(g.inbound.get('/p/src/b.ts').size).toBe(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// findStronglyConnectedComponents — cycle detection
+// ---------------------------------------------------------------------------
+describe('findStronglyConnectedComponents', () => {
+    it('returns one SCC per node when there are no cycles', () => {
+        const g = buildImportGraph(map(['/p/a.ts', `import {} from './b'`], ['/p/b.ts', `import {} from './c'`], ['/p/c.ts', `// leaf`]));
+        const sccs = findStronglyConnectedComponents(g);
+        expect(sccs.length).toBe(3); // every node is its own trivial SCC
+        for (const scc of sccs)
+            expect(scc.length).toBe(1);
+    });
+    it('detects a simple 2-file cycle (a ↔ b)', () => {
+        const g = buildImportGraph(map(['/p/a.ts', `import type {} from './b'`], ['/p/b.ts', `import type {} from './a'`]));
+        const sccs = findStronglyConnectedComponents(g);
+        const cycles = sccs.filter((s) => s.length > 1);
+        expect(cycles.length).toBe(1);
+        expect(new Set(cycles[0])).toEqual(new Set(['/p/a.ts', '/p/b.ts']));
+    });
+    it('detects a 4-file cycle (a → b → c → d → a)', () => {
+        const g = buildImportGraph(map(['/p/a.ts', `import {} from './b'`], ['/p/b.ts', `import {} from './c'`], ['/p/c.ts', `import {} from './d'`], ['/p/d.ts', `import {} from './a'`]));
+        const sccs = findStronglyConnectedComponents(g);
+        const cycles = sccs.filter((s) => s.length > 1);
+        expect(cycles.length).toBe(1);
+        expect(cycles[0].length).toBe(4);
+    });
+    it('detects two disjoint cycles', () => {
+        const g = buildImportGraph(map(['/p/a.ts', `import {} from './b'`], ['/p/b.ts', `import {} from './a'`], ['/p/c.ts', `import {} from './d'`], ['/p/d.ts', `import {} from './c'`]));
+        const sccs = findStronglyConnectedComponents(g);
+        const cycles = sccs.filter((s) => s.length > 1);
+        expect(cycles.length).toBe(2);
+        for (const cycle of cycles)
+            expect(cycle.length).toBe(2);
+    });
+    it('does NOT report self-loops as multi-file cycles', () => {
+        // A file that imports itself is structurally weird but not a multi-file
+        // cycle. This mostly can't happen in practice with TS (the resolver would
+        // need an aliased path), but the SCC algorithm shouldn't conflate it.
+        const g = buildImportGraph(map(['/p/a.ts', `// self`]));
+        const sccs = findStronglyConnectedComponents(g);
+        const cycles = sccs.filter((s) => s.length > 1);
+        expect(cycles.length).toBe(0);
+    });
+    it('handles a graph where one cycle is reachable from non-cycle nodes', () => {
+        // entry → a ↔ b
+        const g = buildImportGraph(map(['/p/entry.ts', `import {} from './a'`], ['/p/a.ts', `import {} from './b'`], ['/p/b.ts', `import {} from './a'`]));
+        const sccs = findStronglyConnectedComponents(g);
+        const cycles = sccs.filter((s) => s.length > 1);
+        expect(cycles.length).toBe(1);
+        expect(new Set(cycles[0])).toEqual(new Set(['/p/a.ts', '/p/b.ts']));
+    });
+    it('handles a deep graph without recursion blowing the stack', () => {
+        // 1000-node linear chain: a0 → a1 → ... → a999. Iterative Tarjan's
+        // should handle this without stack overflow (recursive form would die
+        // around ~10k depending on the runtime).
+        const entries = [];
+        const N = 1000;
+        for (let i = 0; i < N; i++) {
+            const next = i + 1 < N ? `import {} from './a${i + 1}'` : '';
+            entries.push([`/p/a${i}.ts`, next]);
+        }
+        const g = buildImportGraph(map(...entries));
+        const sccs = findStronglyConnectedComponents(g);
+        expect(sccs.length).toBe(N); // each node is its own trivial SCC
+    });
+});
+// ---------------------------------------------------------------------------
+// Inbound vs outbound symmetry
+// ---------------------------------------------------------------------------
+describe('buildImportGraph — inbound/outbound symmetry', () => {
+    it('every outbound edge has a matching inbound edge', () => {
+        const g = buildImportGraph(map(['/p/a.ts', `import {} from './b'\nimport {} from './c'`], ['/p/b.ts', `import {} from './c'`], ['/p/c.ts', `// leaf`]));
+        for (const [from, tos] of g.outbound) {
+            for (const to of tos) {
+                expect(g.inbound.get(to).has(from)).toBe(true);
+            }
+        }
+    });
+});
+//# sourceMappingURL=import-graph.test.js.map

package/dist/framework/__tests__/import-graph.test.js.map

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

package/dist/framework/__tests__/memory-profiler.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Tests for the per-check memory profiler.
+ *
+ * Covers the public surface used by the recipe execution engine:
+ * recordPrewarmComplete / recordCheckStart / recordCheckComplete plus
+ * the threshold-tracking, summary, and reset paths.
+ */
+export {};
+//# sourceMappingURL=memory-profiler.test.d.ts.map

package/dist/framework/__tests__/memory-profiler.test.d.ts.map

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

package/dist/framework/__tests__/memory-profiler.test.js

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Tests for the per-check memory profiler.
+ *
+ * Covers the public surface used by the recipe execution engine:
+ * recordPrewarmComplete / recordCheckStart / recordCheckComplete plus
+ * the threshold-tracking, summary, and reset paths.
+ */
+import { afterEach, describe, expect, it } from 'vitest';
+import { memoryProfiler } from '../memory-profiler.js';
+afterEach(() => {
+    memoryProfiler.reset();
+});
+describe('memoryProfiler — basics', () => {
+    it('returns a non-negative current memory reading in MB', () => {
+        const mb = memoryProfiler.getCurrentMemoryMB();
+        expect(typeof mb).toBe('number');
+        expect(mb).toBeGreaterThan(0);
+    });
+    it('recordCheckStart returns the current heap snapshot in MB', () => {
+        const before = memoryProfiler.recordCheckStart();
+        expect(before).toBeGreaterThan(0);
+    });
+    it('exposes the configured warning threshold', () => {
+        expect(memoryProfiler.getWarningThresholdMB()).toBeGreaterThan(0);
+    });
+});
+describe('memoryProfiler — recordCheckComplete', () => {
+    it('returns a profile with rounded numbers and recorded violation count', () => {
+        const before = memoryProfiler.recordCheckStart();
+        const profile = memoryProfiler.recordCheckComplete('check-A', before, 7, 123);
+        expect(profile.checkId).toBe('check-A');
+        expect(profile.violationCount).toBe(7);
+        expect(profile.durationMs).toBe(123);
+        // memoryDeltaMB rounded to 2 decimals — i.e., last fractional digit can be 0 or up to 99
+        expect(Number.isFinite(profile.memoryDeltaMB)).toBe(true);
+        expect(profile.memoryAfterMB).toBeGreaterThan(0);
+    });
+    it('records the profile in the summary', () => {
+        const before = memoryProfiler.recordCheckStart();
+        memoryProfiler.recordCheckComplete('first', before, 1, 10);
+        memoryProfiler.recordCheckComplete('second', before, 2, 20);
+        const summary = memoryProfiler.getSummary();
+        expect(summary.allProfiles).toHaveLength(2);
+    });
+});
+describe('memoryProfiler — exceedsThreshold', () => {
+    it('returns false for deltas below the threshold', () => {
+        expect(memoryProfiler.exceedsThreshold(0)).toBe(false);
+        expect(memoryProfiler.exceedsThreshold(50)).toBe(false);
+    });
+    it('returns true for deltas above the threshold', () => {
+        const threshold = memoryProfiler.getWarningThresholdMB();
+        expect(memoryProfiler.exceedsThreshold(threshold + 1)).toBe(true);
+    });
+});
+describe('memoryProfiler — getSummary', () => {
+    it('returns an empty summary after reset', () => {
+        memoryProfiler.reset();
+        const summary = memoryProfiler.getSummary();
+        expect(summary.allProfiles).toEqual([]);
+        expect(summary.topConsumers).toEqual([]);
+        expect(summary.checksExceedingThreshold).toBe(0);
+        expect(summary.peakMemoryMB).toBe(0);
+        expect(summary.prewarmMemoryMB).toBe(0);
+    });
+    it('records prewarm baseline when recordPrewarmComplete is called', () => {
+        memoryProfiler.recordPrewarmComplete();
+        const summary = memoryProfiler.getSummary();
+        expect(summary.prewarmMemoryMB).toBeGreaterThan(0);
+        expect(summary.peakMemoryMB).toBeGreaterThan(0);
+    });
+    it('returns at most 10 top consumers, sorted by delta descending', () => {
+        const before = memoryProfiler.recordCheckStart();
+        for (let i = 0; i < 12; i++) {
+            memoryProfiler.recordCheckComplete(`c${i}`, before, i, 5);
+        }
+        const summary = memoryProfiler.getSummary();
+        expect(summary.allProfiles).toHaveLength(12);
+        expect(summary.topConsumers.length).toBeLessThanOrEqual(10);
+        // Sorted by memoryDeltaMB descending
+        for (let i = 1; i < summary.topConsumers.length; i++) {
+            const prev = summary.topConsumers[i - 1]?.memoryDeltaMB ?? 0;
+            const curr = summary.topConsumers[i]?.memoryDeltaMB ?? 0;
+            expect(prev).toBeGreaterThanOrEqual(curr);
+        }
+    });
+    it('counts profiles above the threshold', () => {
+        const threshold = memoryProfiler.getWarningThresholdMB();
+        // Forge profiles by passing a very low memoryBefore to inflate the delta
+        memoryProfiler.recordCheckComplete('hot-1', -threshold * 2, 0, 10);
+        memoryProfiler.recordCheckComplete('hot-2', -threshold * 2, 0, 10);
+        memoryProfiler.recordCheckComplete('cool', memoryProfiler.getCurrentMemoryMB(), 0, 10);
+        const summary = memoryProfiler.getSummary();
+        expect(summary.checksExceedingThreshold).toBeGreaterThanOrEqual(2);
+    });
+});
+describe('memoryProfiler — reset', () => {
+    it('clears profiles and prewarm/peak baselines', () => {
+        memoryProfiler.recordPrewarmComplete();
+        memoryProfiler.recordCheckComplete('x', 0, 0, 1);
+        memoryProfiler.reset();
+        const summary = memoryProfiler.getSummary();
+        expect(summary.allProfiles).toEqual([]);
+        expect(summary.prewarmMemoryMB).toBe(0);
+        expect(summary.peakMemoryMB).toBe(0);
+    });
+});
+//# sourceMappingURL=memory-profiler.test.js.map

package/dist/framework/__tests__/memory-profiler.test.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Tests for the parse-cache shim.
+ *
+ * The shim forwards to the language-aware parse cache when a TypeScript
+ * adapter is registered, and falls back to a direct `ts.createSourceFile`
+ * parse otherwise. Both branches are exercised here.
+ */
+export {};
+//# sourceMappingURL=parse-cache.test.d.ts.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Tests for the parse-cache shim.
+ *
+ * The shim forwards to the language-aware parse cache when a TypeScript
+ * adapter is registered, and falls back to a direct `ts.createSourceFile`
+ * parse otherwise. Both branches are exercised here.
+ */
+import { LanguageRegistry, RunScope, runWithScopeSync } from '@opensip-cli/core';
+import ts from 'typescript';
+import { describe, expect, it } from 'vitest';
+import { getSharedSourceFile } from '../parse-cache.js';
+describe('getSharedSourceFile — fallback (no adapter registered)', () => {
+    it('returns a TypeScript SourceFile for valid TS content', () => {
+        const sf = getSharedSourceFile('virt.ts', 'const x: number = 1');
+        expect(sf).not.toBeNull();
+        expect(sf?.fileName).toBe('virt.ts');
+    });
+    it('returns a SourceFile for valid TSX content', () => {
+        const sf = getSharedSourceFile('virt.tsx', 'const E = () => <div/>');
+        expect(sf).not.toBeNull();
+    });
+    it('returns a SourceFile even when TS reports syntax errors (TS recovers)', () => {
+        // ts.createSourceFile is permissive — it returns a partial AST rather
+        // than throwing on syntax errors. The fallback should pass it through.
+        const sf = getSharedSourceFile('virt.ts', 'const x = ');
+        expect(sf).not.toBeNull();
+    });
+});
+describe('getSharedSourceFile — adapter-backed cache hit', () => {
+    it('routes through getParseTree when a TypeScript adapter is registered in the scope', () => {
+        let parseCount = 0;
+        const tsAdapter = {
+            id: 'typescript',
+            fileExtensions: ['.ts', '.tsx'],
+            parse: (content, filePath) => {
+                parseCount++;
+                return ts.createSourceFile(filePath, content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+            },
+            stripStrings: (s) => s,
+            stripComments: (s) => s,
+        };
+        const reg = new LanguageRegistry();
+        reg.register(tsAdapter);
+        const scope = new RunScope({ languages: reg });
+        const sf = runWithScopeSync(scope, () => getSharedSourceFile('virt.ts', 'const x = 1'));
+        expect(sf).not.toBeNull();
+        expect(sf?.fileName).toBe('virt.ts');
+        expect(parseCount).toBeGreaterThanOrEqual(1);
+    });
+});
+//# sourceMappingURL=parse-cache.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cache.test.js","sourceRoot":"","sources":["../../../src/framework/__tests__/parse-cache.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,QAAQ,CAAC,wDAAwD,EAAE,GAAG,EAAE;IACtE,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,GAAG,mBAAmB,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;QACjE,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,EAAE,GAAG,mBAAmB,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;QACrE,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,sEAAsE;QACtE,uEAAuE;QACvE,MAAM,EAAE,GAAG,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,SAAS,GAAmC;YAChD,EAAE,EAAE,YAAY;YAChB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;gBAC3B,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC,gBAAgB,CACxB,QAAQ,EACR,OAAO,EACP,EAAE,CAAC,YAAY,CAAC,MAAM,EACtB,IAAI,EACJ,EAAE,CAAC,UAAU,CAAC,GAAG,CAClB,CAAC;YACJ,CAAC;YACD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SACxB,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAE/C,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;QACxF,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/framework/__tests__/path-matcher.test.d.ts

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

package/dist/framework/__tests__/path-matcher.test.d.ts.map

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