@opensip-cli/fitness 0.1.0

package/dist/__tests__/fit-execute-opts.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * executeFit boundary test (ADR-0028 — worker-safe, persistence-free engine).
+ *
+ * `executeFit` does NOT touch the datastore: it returns the envelope + the run's
+ * (host timing removed). The CALLER (modes / live runner with ToolCliContext) persists
+ * via the `cli.runSession.record` seam (or legacy persistFitSession for some tests).
+ * thread (the datastore handle cannot cross the worker boundary). These tests
+ * lock both halves: the engine is pure-compute, and the explicit persist writes
+ * exactly one session. `onProgress` wiring is also covered.
+ *
+ * Implementation note: the fixture is a minimal tmp project with just
+ * `opensip-cli.config.yml`.
+ */
+export {};
+//# sourceMappingURL=fit-execute-opts.test.d.ts.map

package/dist/__tests__/fit-execute-opts.test.d.ts.map

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

package/dist/__tests__/fit-execute-opts.test.js

@@ -0,0 +1,124 @@
+/**
+ * executeFit boundary test (ADR-0028 — worker-safe, persistence-free engine).
+ *
+ * `executeFit` does NOT touch the datastore: it returns the envelope + the run's
+ * (host timing removed). The CALLER (modes / live runner with ToolCliContext) persists
+ * via the `cli.runSession.record` seam (or legacy persistFitSession for some tests).
+ * thread (the datastore handle cannot cross the worker boundary). These tests
+ * lock both halves: the engine is pure-compute, and the explicit persist writes
+ * exactly one session. `onProgress` wiring is also covered.
+ *
+ * Implementation note: the fixture is a minimal tmp project with just
+ * `opensip-cli.config.yml`.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { LanguageRegistry, RunScope, generatePrefixedId, runWithScope } from '@opensip-cli/core';
+import { DataStoreFactory } from '@opensip-cli/datastore';
+import { SessionRepo } from '@opensip-cli/session-store';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { buildFitnessSessionPayload } from '../cli/fit/result-builders.js';
+import { executeFit } from '../cli/fit.js';
+import { fitnessTool } from '../tool.js';
+let projectDir;
+let datastore;
+beforeEach(() => {
+    projectDir = mkdtempSync(join(tmpdir(), 'opensip-fit-opts-'));
+    // Minimal config — at least one target so executeFit doesn't short
+    // out on a missing config error.
+    writeFileSync(join(projectDir, 'opensip-cli.config.yml'), `targets:
+  source:
+    description: minimal
+    languages: [typescript]
+    concerns: [backend]
+    include:
+      - "src/**/*.ts"
+`);
+    mkdirSync(join(projectDir, 'src'));
+    writeFileSync(join(projectDir, 'src', 'index.ts'), 'export const x = 1;\n');
+    datastore = DataStoreFactory.open({ backend: 'memory' });
+});
+afterEach(() => {
+    datastore.close();
+    rmSync(projectDir, { recursive: true, force: true });
+});
+function makeArgs(cwd) {
+    return {
+        json: false,
+        list: false,
+        recipes: false,
+        verbose: false,
+        debug: false,
+        quiet: true,
+        open: false,
+        cwd,
+        exclude: [],
+        gateSave: false,
+        gateCompare: false,
+    };
+}
+function withFitScope(fn) {
+    // executeFit reads `currentScope()?.languages` and the fitness subscope
+    // (`scope.fitness.{checks,recipes,load}`) — wrap each call in a fresh scope
+    // carrying both an (empty) language registry and fitness's contributed
+    // registries so check loading + recipe selection resolve.
+    const scope = new RunScope({ languages: new LanguageRegistry() });
+    Object.assign(scope, fitnessTool.contributeScope?.() ?? {});
+    return runWithScope(scope, fn);
+}
+describe('executeFit — persistence-free boundary (ADR-0028)', () => {
+    it('returns an envelope + durationMs and does NOT persist on its own', async () => {
+        const fitResult = await withFitScope(() => executeFit(makeArgs(projectDir)));
+        // Sanity — executeFit shouldn't error on a minimal project.
+        expect(fitResult.result.type).not.toBe('error');
+        expect(fitResult.envelope).toBeDefined();
+        // timing removed from executeFit return (Phase 3.1 host-owned); the top-level
+        // result no longer carries duration/startedAt. (Test updated in Task 3.4.)
+        expect(fitResult.durationMs).toBeUndefined();
+        expect(fitResult.startedAt).toBeUndefined();
+        // The engine is pure-compute now: nothing was written.
+        const sessions = new SessionRepo(datastore).list({ tool: 'fit' });
+        expect(sessions.length).toBe(0);
+    });
+    it('a fit session contribution persisted via SessionRepo writes exactly one row', async () => {
+        const args = makeArgs(projectDir);
+        const fitResult = await withFitScope(() => executeFit(args));
+        expect(fitResult.envelope).toBeDefined();
+        const envelope = fitResult.envelope;
+        // host-owned-run-timing Phase 3 removed the production `persistFitSession`
+        // helper — the host run plane owns persistence. This test-only write mirrors
+        // the row the host writes from the tool's returned ToolSessionContribution.
+        new SessionRepo(datastore).save({
+            id: generatePrefixedId('fit'),
+            tool: 'fit',
+            startedAt: '1970-01-01T00:00:00.000Z',
+            completedAt: '1970-01-01T00:00:00.000Z',
+            cwd: args.cwd,
+            recipe: envelope.recipe,
+            score: envelope.verdict.score,
+            passed: envelope.verdict.passed,
+            durationMs: 0,
+            payload: buildFitnessSessionPayload(envelope),
+        });
+        const sessions = new SessionRepo(datastore).list({ tool: 'fit' });
+        expect(sessions.length).toBe(1);
+        expect(sessions[0]?.tool).toBe('fit');
+        expect(sessions[0]?.cwd).toBe(projectDir);
+    });
+    it('invokes onProgress when supplied', async () => {
+        const calls = [];
+        const fitResult = await withFitScope(() => executeFit(makeArgs(projectDir), {
+            onProgress: (completed, total) => {
+                calls.push({ completed, total });
+            },
+        }));
+        expect(fitResult.result.type).not.toBe('error');
+        // Even with zero registered checks the recipe service may yield no
+        // tick, so the contract is "accepts the callback without throwing".
+        // Stronger assertions are exercised by the FitView integration in
+        // the CLI package; here we only need to prove the opt is wired.
+        expect(Array.isArray(calls)).toBe(true);
+    });
+});
+//# sourceMappingURL=fit-execute-opts.test.js.map

package/dist/__tests__/fit-execute-opts.test.js.map

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

package/dist/__tests__/public-api.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Export-surface lock for `@opensip-cli/fitness`.
+ *
+ * The public barrel is the marketplace contract surface documented in
+ * `docs/public/10-concepts/04-contract-surfaces.md`: the check / recipe /
+ * plugin authoring API plus `fitnessTool`. This test pins the exact set of
+ * **runtime (value) exports** so the barrel cannot silently re-grow to leak
+ * engine internals (registries, recipe service, gate primitives,
+ * `FitBaselineRepo`, CLI handlers, …) — the regression the round-4 boundary
+ * audit found and ADR-0013 curated away.
+ *
+ * Scope note: type-only exports are erased at runtime and cannot be asserted
+ * here. They are governed by the barrel source plus the dependency-cruiser
+ * `no-cross-package-internal` rule. Adding a *value* export to the barrel is a
+ * deliberate minor-version act and must be reflected in EXPECTED below (and in
+ * the contract-surfaces doc); removing one is a major change.
+ */
+export {};
+//# sourceMappingURL=public-api.test.d.ts.map

package/dist/__tests__/public-api.test.d.ts.map

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

package/dist/__tests__/public-api.test.js

@@ -0,0 +1,85 @@
+/**
+ * Export-surface lock for `@opensip-cli/fitness`.
+ *
+ * The public barrel is the marketplace contract surface documented in
+ * `docs/public/10-concepts/04-contract-surfaces.md`: the check / recipe /
+ * plugin authoring API plus `fitnessTool`. This test pins the exact set of
+ * **runtime (value) exports** so the barrel cannot silently re-grow to leak
+ * engine internals (registries, recipe service, gate primitives,
+ * `FitBaselineRepo`, CLI handlers, …) — the regression the round-4 boundary
+ * audit found and ADR-0013 curated away.
+ *
+ * Scope note: type-only exports are erased at runtime and cannot be asserted
+ * here. They are governed by the barrel source plus the dependency-cruiser
+ * `no-cross-package-internal` rule. Adding a *value* export to the barrel is a
+ * deliberate minor-version act and must be reflected in EXPECTED below (and in
+ * the contract-surfaces doc); removing one is a major change.
+ */
+import { describe, expect, it } from 'vitest';
+import * as barrel from '../index.js';
+/** The complete, intended set of runtime value exports. Keep alphabetised. */
+const EXPECTED_VALUE_EXPORTS = [
+    'applyCheckDisplay',
+    'buildImportGraph',
+    'clearCurrentRecipeCheckConfig',
+    'collectCheckObjects',
+    'createPathMatcher',
+    'defineCheck',
+    'defineRecipe',
+    'defineRegexListCheck',
+    'execAbortable',
+    'extractSnippet',
+    'fileCache',
+    'findStronglyConnectedComponents',
+    'fitnessTool',
+    'getCheckConfig',
+    'getCheckDisplayName',
+    'getCheckIcon',
+    'getLineNumber',
+    'isAPIFile',
+    'isCheck',
+    'isCommentLine',
+    'isInsideStringLiteral',
+    'isTestFile',
+    'makeDisplayHelpers',
+    'readPackageVersion',
+    'setCurrentRecipeCheckConfig',
+    'stripStringLiterals',
+    'stripStringsAndComments',
+    'stripStringsAndCommentsPreservingPositions',
+    'tool',
+    'FITNESS_CONTRACT_VERSION',
+].sort();
+describe('@opensip-cli/fitness public barrel', () => {
+    it('exposes exactly the curated value-export surface', () => {
+        const actual = Object.keys(barrel)
+            .filter((k) => barrel[k] !== undefined)
+            .sort();
+        expect(actual).toEqual(EXPECTED_VALUE_EXPORTS);
+    });
+    it('exposes `fitnessTool` (and its `tool` alias) as the Tool descriptor', () => {
+        expect(barrel.fitnessTool).toBeDefined();
+        expect(barrel.fitnessTool.metadata.name).toBe('fitness');
+        expect(barrel.fitnessTool.metadata.id).toBe('afd68bd3-ff3c-4935-a5b6-76d8fc7a5224');
+        expect(barrel.tool).toBe(barrel.fitnessTool);
+    });
+    it('does NOT leak engine internals through the barrel', () => {
+        // Spot-check the worst former offenders: a persistence repo, the recipe
+        // service, the registries, and a CLI handler must not be reachable here.
+        for (const leak of [
+            'FitBaselineRepo',
+            'FitnessRecipeService',
+            'FitnessRecipeRegistry',
+            'defaultRegistry',
+            'CheckRegistry',
+            'TargetRegistry',
+            'listChecks',
+            'saveBaseline',
+            'compareToBaseline',
+            'ensureChecksLoaded',
+        ]) {
+            expect(barrel).not.toHaveProperty(leak);
+        }
+    });
+});
+//# sourceMappingURL=public-api.test.js.map

package/dist/__tests__/public-api.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.test.js","sourceRoot":"","sources":["../../src/__tests__/public-api.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,sBAAsB,GAAG;IAC7B,mBAAmB;IACnB,kBAAkB;IAClB,+BAA+B;IAC/B,qBAAqB;IACrB,mBAAmB;IACnB,aAAa;IACb,cAAc;IACd,sBAAsB;IACtB,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,iCAAiC;IACjC,aAAa;IACb,gBAAgB;IAChB,qBAAqB;IACrB,cAAc;IACd,eAAe;IACf,WAAW;IACX,SAAS;IACT,eAAe;IACf,uBAAuB;IACvB,YAAY;IACZ,oBAAoB;IACpB,oBAAoB;IACpB,6BAA6B;IAC7B,qBAAqB;IACrB,yBAAyB;IACzB,4CAA4C;IAC5C,MAAM;IACN,0BAA0B;CAC3B,CAAC,IAAI,EAAE,CAAC;AAET,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAwB,CAAC,KAAK,SAAS,CAAC;aAC7D,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACpF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,wEAAwE;QACxE,yEAAyE;QACzE,KAAK,MAAM,IAAI,IAAI;YACjB,iBAAiB;YACjB,sBAAsB;YACtB,uBAAuB;YACvB,iBAAiB;YACjB,eAAe;YACf,gBAAgB;YAChB,YAAY;YACZ,cAAc;YACd,mBAAmB;YACnB,oBAAoB;SACrB,EAAE,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/tool.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tool contract conformance test for fitnessTool.
+ *
+ * Mirrors the graph + simulation tests: catches version-drift between
+ * `metadata.version` and package.json. Before tools/lib/package-version
+ * existed, both fields were hardcoded literals that drifted silently
+ * across releases.
+ */
+export {};
+//# sourceMappingURL=tool.test.d.ts.map

package/dist/__tests__/tool.test.d.ts.map

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

package/dist/__tests__/tool.test.js

@@ -0,0 +1,57 @@
+/**
+ * Tool contract conformance test for fitnessTool.
+ *
+ * Mirrors the graph + simulation tests: catches version-drift between
+ * `metadata.version` and package.json. Before tools/lib/package-version
+ * existed, both fields were hardcoded literals that drifted silently
+ * across releases.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+import { fitnessTool } from '../tool.js';
+const HERE = dirname(fileURLToPath(import.meta.url));
+const PKG = JSON.parse(readFileSync(resolve(HERE, '../../package.json'), 'utf8'));
+describe('fitnessTool contract conformance', () => {
+    it("metadata.name is the human key 'fitness'; id is the stable UUID", () => {
+        expect(fitnessTool.metadata.name).toBe('fitness');
+        expect(fitnessTool.metadata.id).toBe('afd68bd3-ff3c-4935-a5b6-76d8fc7a5224');
+    });
+    it('metadata.version matches package.json', () => {
+        expect(fitnessTool.metadata.version).toBe(PKG.version);
+    });
+    it('metadata.description is non-empty', () => {
+        expect(fitnessTool.metadata.description.length).toBeGreaterThan(0);
+    });
+    it('commands list includes fit, fit-list, fit-recipes', () => {
+        const names = fitnessTool.commands.map((c) => c.name);
+        expect(names).toEqual(expect.arrayContaining(['fit', 'fit-list', 'fit-recipes']));
+    });
+    it("does not own the cross-tool 'report' command", () => {
+        const names = fitnessTool.commands.map((c) => c.name);
+        expect(names).not.toContain('report');
+        expect(names).not.toContain('dashboard');
+    });
+    it('contributes report data via the Tool.collectReportData seam', () => {
+        expect(typeof fitnessTool.collectReportData).toBe('function');
+    });
+    it('declares its command surface via commandSpecs (Phase 4), not register()', () => {
+        expect(Array.isArray(fitnessTool.commandSpecs)).toBe(true);
+        const specNames = (fitnessTool.commandSpecs ?? []).map((s) => s.name);
+        expect(specNames).toEqual([
+            'fit',
+            'fit-list',
+            'fit-recipes',
+            'fit-baseline-export',
+            // [internal] headless run forked by the live view (ADR-0028).
+            'fit-run-worker',
+        ]);
+    });
+    it('fit-list / fit-recipes do not expose pre-GA legacy aliases', () => {
+        const byName = new Map((fitnessTool.commandSpecs ?? []).map((s) => [s.name, s]));
+        expect(byName.get('fit-list')?.aliases ?? []).toEqual([]);
+        expect(byName.get('fit-recipes')?.aliases ?? []).toEqual([]);
+    });
+});
+//# sourceMappingURL=tool.test.js.map

package/dist/__tests__/tool.test.js.map

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

package/dist/baseline-strategy.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview fitness's fingerprint strategy for the host baseline/ratchet
+ * plane (ADR-0036).
+ *
+ * fitness's identity is `sha256(filePath\nruleId\nmessage)` — it INCLUDES the
+ * message but EXCLUDES line/column, so an unrelated line-shift (code added above
+ * a finding) does not re-key the baseline and flap the ratchet. This is the
+ * opposite policy from graph's location-based key (which excludes message because
+ * several graph rules embed run-varying counts in their message), and both are
+ * correct for their domain (ADR-0036: per-tool strategy, not a global algorithm).
+ *
+ * Byte-preserved from the pre-ADR-0036 `DEFAULT_VIOLATION_IDENTITY`
+ * (`gate.ts`), now keyed off the `Signal` (the plane's currency) instead of a
+ * `GateViolation` — the same three fields `extractViolationsFromEnvelope` read.
+ * A `fingerprint-parity.test.ts` pins byte-equality against that oracle before
+ * the old gate is deleted.
+ */
+import type { FingerprintStrategy } from '@opensip-cli/core';
+/** fitness's message-hash baseline identity: `sha256(filePath\nruleId\nmessage)`. */
+export declare const fitnessFingerprintStrategy: FingerprintStrategy;
+//# sourceMappingURL=baseline-strategy.d.ts.map

package/dist/baseline-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-strategy.d.ts","sourceRoot":"","sources":["../src/baseline-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,EAAE,mBAC8C,CAAC"}

package/dist/baseline-strategy.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview fitness's fingerprint strategy for the host baseline/ratchet
+ * plane (ADR-0036).
+ *
+ * fitness's identity is `sha256(filePath\nruleId\nmessage)` — it INCLUDES the
+ * message but EXCLUDES line/column, so an unrelated line-shift (code added above
+ * a finding) does not re-key the baseline and flap the ratchet. This is the
+ * opposite policy from graph's location-based key (which excludes message because
+ * several graph rules embed run-varying counts in their message), and both are
+ * correct for their domain (ADR-0036: per-tool strategy, not a global algorithm).
+ *
+ * Byte-preserved from the pre-ADR-0036 `DEFAULT_VIOLATION_IDENTITY`
+ * (`gate.ts`), now keyed off the `Signal` (the plane's currency) instead of a
+ * `GateViolation` — the same three fields `extractViolationsFromEnvelope` read.
+ * A `fingerprint-parity.test.ts` pins byte-equality against that oracle before
+ * the old gate is deleted.
+ */
+import { createHash } from 'node:crypto';
+/** fitness's message-hash baseline identity: `sha256(filePath\nruleId\nmessage)`. */
+export const fitnessFingerprintStrategy = (s) => createHash('sha256').update(`${s.filePath}\n${s.ruleId}\n${s.message}`).digest('hex');
+//# sourceMappingURL=baseline-strategy.js.map

package/dist/baseline-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-strategy.js","sourceRoot":"","sources":["../src/baseline-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,qFAAqF;AACrF,MAAM,CAAC,MAAM,0BAA0B,GAAwB,CAAC,CAAC,EAAE,EAAE,CACnE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC"}

package/dist/check-utils/display.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview Shared display-lookup helpers for fitness check packs.
+ *
+ * Each check pack contributes its own slug -> [icon, displayName] map; these
+ * helpers do the lookup against that map with a sensible fallback. Previously
+ * each pack carried a byte-identical copy of this lookup logic — surfaced by
+ * the graph tool's duplicated-function-body rule.
+ */
+import type { Check } from '../framework/check-types.js';
+import type { CheckDisplayEntry } from '../plugins/types.js';
+/**
+ * Fold a pack's `slug -> [icon, displayName]` map ONTO its checks (§5.3 fold):
+ * each check whose slug has an entry gets `icon`/`displayName` set on its
+ * `config`, so display travels WITH the check and there is no separate
+ * per-process display sidecar/singleton. Checks with no entry pass through
+ * unchanged (consumers fall back to a default icon + kebab-to-title-case).
+ *
+ * `check.config` is pure metadata — the check's `run`/`getScope`/`getMatcher`
+ * closures capture the original author config, not `check.config` — so adding
+ * display to `check.config` is execution-safe.
+ */
+export declare function applyCheckDisplay(checks: readonly Check[], displayMap: Readonly<Record<string, CheckDisplayEntry>>): Check[];
+/**
+ * Get the icon for a check by slug. Falls back to the magnifying-glass emoji
+ * when the slug isn't present in the supplied display map.
+ */
+export declare function getCheckIcon(displayMap: Readonly<Record<string, CheckDisplayEntry>>, checkSlug: string): string;
+/**
+ * Get the display name for a check by slug. Falls back to kebab-to-title-case
+ * conversion of the slug itself when no entry exists in the display map.
+ */
+export declare function getCheckDisplayName(displayMap: Readonly<Record<string, CheckDisplayEntry>>, checkSlug: string): string;
+/**
+ * Display helpers bound to a single check pack's display map.
+ */
+export interface DisplayHelpers {
+    /** Get the icon for a check by slug. Falls back to the magnifying-glass emoji. */
+    getCheckIcon: (checkSlug: string) => string;
+    /** Get the display name for a check by slug. Falls back to kebab-to-title-case. */
+    getCheckDisplayName: (checkSlug: string) => string;
+}
+/**
+ * Binds the shared display-lookup logic to a per-pack `CHECK_DISPLAY` map,
+ * returning slug-only `getCheckIcon` / `getCheckDisplayName` closures.
+ *
+ * Each check pack owns its own display data but the binding wrapper was
+ * previously byte-identical across packs (flagged by the graph tool's
+ * duplicated-function-body rule); this factory keeps the data/logic split
+ * intact while erasing the wrapper twin.
+ */
+export declare function makeDisplayHelpers(displayMap: Readonly<Record<string, CheckDisplayEntry>>): DisplayHelpers;
+//# sourceMappingURL=display.d.ts.map

package/dist/check-utils/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/check-utils/display.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,GACtD,KAAK,EAAE,CAMT;AAKD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,EACvD,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,EACvD,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,mFAAmF;IACnF,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,GACtD,cAAc,CAKhB"}

package/dist/check-utils/display.js

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Shared display-lookup helpers for fitness check packs.
+ *
+ * Each check pack contributes its own slug -> [icon, displayName] map; these
+ * helpers do the lookup against that map with a sensible fallback. Previously
+ * each pack carried a byte-identical copy of this lookup logic — surfaced by
+ * the graph tool's duplicated-function-body rule.
+ */
+/**
+ * Fold a pack's `slug -> [icon, displayName]` map ONTO its checks (§5.3 fold):
+ * each check whose slug has an entry gets `icon`/`displayName` set on its
+ * `config`, so display travels WITH the check and there is no separate
+ * per-process display sidecar/singleton. Checks with no entry pass through
+ * unchanged (consumers fall back to a default icon + kebab-to-title-case).
+ *
+ * `check.config` is pure metadata — the check's `run`/`getScope`/`getMatcher`
+ * closures capture the original author config, not `check.config` — so adding
+ * display to `check.config` is execution-safe.
+ */
+export function applyCheckDisplay(checks, displayMap) {
+    return checks.map((check) => {
+        const entry = displayMap[check.config.slug];
+        if (!entry)
+            return check;
+        return { ...check, config: { ...check.config, icon: entry[0], displayName: entry[1] } };
+    });
+}
+/** Default fallback icon when a slug isn't in the display map. */
+const DEFAULT_ICON = '🔍';
+/**
+ * Get the icon for a check by slug. Falls back to the magnifying-glass emoji
+ * when the slug isn't present in the supplied display map.
+ */
+export function getCheckIcon(displayMap, checkSlug) {
+    const display = displayMap[checkSlug];
+    return display ? display[0] : DEFAULT_ICON;
+}
+/**
+ * Get the display name for a check by slug. Falls back to kebab-to-title-case
+ * conversion of the slug itself when no entry exists in the display map.
+ */
+export function getCheckDisplayName(displayMap, checkSlug) {
+    const display = displayMap[checkSlug];
+    if (display)
+        return display[1];
+    return checkSlug
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Binds the shared display-lookup logic to a per-pack `CHECK_DISPLAY` map,
+ * returning slug-only `getCheckIcon` / `getCheckDisplayName` closures.
+ *
+ * Each check pack owns its own display data but the binding wrapper was
+ * previously byte-identical across packs (flagged by the graph tool's
+ * duplicated-function-body rule); this factory keeps the data/logic split
+ * intact while erasing the wrapper twin.
+ */
+export function makeDisplayHelpers(displayMap) {
+    return {
+        getCheckIcon: (checkSlug) => getCheckIcon(displayMap, checkSlug),
+        getCheckDisplayName: (checkSlug) => getCheckDisplayName(displayMap, checkSlug),
+    };
+}
+//# sourceMappingURL=display.js.map

package/dist/check-utils/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/check-utils/display.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,UAAuD;IAEvD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAuD,EACvD,SAAiB;IAEjB,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAuD,EACvD,SAAiB;IAEjB,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,SAAS;SACb,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAYD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAuD;IAEvD,OAAO;QACL,YAAY,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,SAAS,CAAC;QAChE,mBAAmB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,SAAS,CAAC;KAC/E,CAAC;AACJ,CAAC"}

package/dist/check-utils/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Shared utilities for check authors.
+ *
+ * These helpers were previously copy-pasted between check packs
+ * (@opensip-cli/checks-typescript and @opensip-cli/checks-universal).
+ * Both packs depend on @opensip-cli/fitness, so the engine is the
+ * natural shared home.
+ */
+export { isCommentLine } from './source-analysis.js';
+export type { IsCommentLineOptions } from './source-analysis.js';
+export { isTestFile } from './test-helpers.js';
+export type { IsTestFileOptions } from './test-helpers.js';
+export { applyCheckDisplay, getCheckDisplayName, getCheckIcon, makeDisplayHelpers, } from './display.js';
+export type { DisplayHelpers } from './display.js';
+export { createPathMatcher } from './path-matching.js';
+export type { PathPattern } from './path-matching.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/check-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/check-utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/check-utils/index.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Shared utilities for check authors.
+ *
+ * These helpers were previously copy-pasted between check packs
+ * (@opensip-cli/checks-typescript and @opensip-cli/checks-universal).
+ * Both packs depend on @opensip-cli/fitness, so the engine is the
+ * natural shared home.
+ */
+export { isCommentLine } from './source-analysis.js';
+export { isTestFile } from './test-helpers.js';
+export { applyCheckDisplay, getCheckDisplayName, getCheckIcon, makeDisplayHelpers, } from './display.js';
+export { createPathMatcher } from './path-matching.js';
+//# sourceMappingURL=index.js.map

package/dist/check-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/check-utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/check-utils/path-matching.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Path matching utilities for fitness checks.
+ *
+ * Factory function for creating path matchers that work with both string
+ * patterns (using `includes`) and RegExp patterns (using `test`). Previously
+ * each check pack carried a byte-identical copy of this helper — surfaced by
+ * the graph tool's duplicated-function-body rule. Both packs depend on
+ * @opensip-cli/fitness, so the engine is the natural shared home.
+ */
+/**
+ * A path pattern can be a string (for includes matching) or a RegExp (for test matching).
+ */
+export type PathPattern = string | RegExp;
+/**
+ * Creates a path matcher function from an array of patterns.
+ *
+ * String patterns match using `path.includes(pattern)`.
+ * RegExp patterns match using `pattern.test(path)`.
+ *
+ * @param patterns - Array of string or RegExp patterns to match against
+ * @returns A function that returns true if the path matches any pattern
+ *
+ * @example
+ * ```typescript
+ * // String patterns (includes matching)
+ * const isExcluded = createPathMatcher(['/__tests__/', '/node_modules/']);
+ * isExcluded('/src/__tests__/foo.ts'); // true
+ *
+ * // RegExp patterns (test matching)
+ * const isTestFile = createPathMatcher([/\.test\.ts$/, /\.spec\.ts$/]);
+ * isTestFile('foo.test.ts'); // true
+ *
+ * // Mixed patterns
+ * const isIgnored = createPathMatcher(['/dist/', /node_modules/]);
+ * isIgnored('/project/dist/bundle.js'); // true
+ * isIgnored('/project/node_modules/lodash/index.js'); // true
+ * ```
+ */
+export declare function createPathMatcher(patterns: readonly PathPattern[]): (path: string) => boolean;
+//# sourceMappingURL=path-matching.d.ts.map

package/dist/check-utils/path-matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-matching.d.ts","sourceRoot":"","sources":["../../src/check-utils/path-matching.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAE7F"}