@opensip-cli/fitness 0.1.0

package/dist/cli/fit/gate-compare-render.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview fit's gate-compare human renderer (ADR-0036).
+ *
+ * Renders the generic host `GateCompareResult` (full-`Signal` added/resolved/
+ * unchanged buckets) to fit's plain-text gate-compare report. Byte-preserved from
+ * the pre-ADR-0036 `gate.ts` `renderGateCompareOutput` — only the bucket element
+ * type changed (`GateViolation` → `Signal`), and `Signal` carries the same
+ * `ruleId`/`filePath`/`line`/`message` fields the old renderer read.
+ */
+import type { GateCompareResult } from '@opensip-cli/core';
+/** Render fit's gate-compare report. Byte-preserved from the old gate.ts renderer. */
+export declare function renderGateCompareOutput(result: GateCompareResult): string;
+//# sourceMappingURL=gate-compare-render.d.ts.map

package/dist/cli/fit/gate-compare-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-compare-render.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/gate-compare-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAU,MAAM,mBAAmB,CAAC;AAkEnE,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CASzE"}

package/dist/cli/fit/gate-compare-render.js

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview fit's gate-compare human renderer (ADR-0036).
+ *
+ * Renders the generic host `GateCompareResult` (full-`Signal` added/resolved/
+ * unchanged buckets) to fit's plain-text gate-compare report. Byte-preserved from
+ * the pre-ADR-0036 `gate.ts` `renderGateCompareOutput` — only the bucket element
+ * type changed (`GateViolation` → `Signal`), and `Signal` carries the same
+ * `ruleId`/`filePath`/`line`/`message` fields the old renderer read.
+ */
+function formatLocation(s) {
+    if (!s.filePath)
+        return '(no location)';
+    return s.line == null ? s.filePath : `${s.filePath}:${s.line}`;
+}
+function sortSignals(signals) {
+    return [...signals].sort((a, b) => {
+        if (a.ruleId !== b.ruleId)
+            return a.ruleId.localeCompare(b.ruleId);
+        if (a.filePath !== b.filePath)
+            return a.filePath.localeCompare(b.filePath);
+        return (a.line ?? 0) - (b.line ?? 0);
+    });
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 1) + '…';
+}
+/** `Added (n):` block — each entry plus its (truncated) message line. */
+function renderAdded(added) {
+    if (added.length === 0)
+        return [];
+    const lines = [`Added (${added.length}):`];
+    for (const v of sortSignals(added)) {
+        lines.push(`  ✗ ${v.ruleId.padEnd(40)} ${formatLocation(v)}`);
+        if (v.message && v.message !== v.ruleId)
+            lines.push(`      ${truncate(v.message, 120)}`);
+    }
+    lines.push('');
+    return lines;
+}
+/** `Resolved (n):` block. */
+function renderResolved(resolved) {
+    if (resolved.length === 0)
+        return [];
+    const lines = [`Resolved (${resolved.length}):`];
+    for (const v of sortSignals(resolved))
+        lines.push(`  ✓ ${v.ruleId.padEnd(40)} ${formatLocation(v)}`);
+    lines.push('');
+    return lines;
+}
+/** `Unchanged (n):` block — truncated to the first 5 (usually long, not actionable). */
+function renderUnchanged(unchanged) {
+    if (unchanged.length === 0)
+        return [];
+    const lines = [`Unchanged (${unchanged.length}):`];
+    const sample = sortSignals(unchanged).slice(0, 5);
+    for (const v of sample)
+        lines.push(`  · ${v.ruleId.padEnd(40)} ${formatLocation(v)}`);
+    if (unchanged.length > sample.length) {
+        lines.push(`  · ... and ${unchanged.length - sample.length} more`);
+    }
+    lines.push('');
+    return lines;
+}
+/** The verdict footer (`DEGRADED` / `IMPROVED` / `STABLE`). */
+function renderVerdict(result) {
+    if (result.degraded) {
+        return `✗ DEGRADED — ${result.added.length} new violation${result.added.length === 1 ? '' : 's'}`;
+    }
+    if (result.resolved.length > 0) {
+        return `✓ IMPROVED — ${result.resolved.length} violation${result.resolved.length === 1 ? '' : 's'} resolved, none added`;
+    }
+    return `✓ STABLE — no change`;
+}
+/** Render fit's gate-compare report. Byte-preserved from the old gate.ts renderer. */
+export function renderGateCompareOutput(result) {
+    return [
+        'opensip gate compare',
+        '',
+        ...renderAdded(result.added),
+        ...renderResolved(result.resolved),
+        ...renderUnchanged(result.unchanged),
+        renderVerdict(result),
+    ].join('\n');
+}
+//# sourceMappingURL=gate-compare-render.js.map

package/dist/cli/fit/gate-compare-render.js.map

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

package/dist/cli/fit/recipe-selector.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Recipe-pick + recipe-run helpers for the `fit` command.
+ *
+ * `selectRecipe()` decides between a named recipe (looked up in the
+ * current scope's recipe registry) and an ad-hoc recipe constructed from
+ * `--check` / `--tags`. `runRecipeOrAdHoc()` then executes the chosen
+ * shape via `FitnessRecipeService`.
+ */
+import { FitnessRecipeService } from '../../recipes/service.js';
+import type { FitnessRecipeResult } from '../../recipes/types.js';
+import type { ErrorResult, FitOptions } from '@opensip-cli/contracts';
+/**
+ * Tool-scoped recipe defaults for `fit` (ADR-0022), read from the project
+ * config by the caller: `toolRecipe` is `fitness.recipe`.
+ */
+export interface FitRecipeDefaults {
+    readonly toolRecipe?: string;
+}
+/**
+ * Flatten the (repeatable, possibly comma-separated) `--tags` values into a
+ * trimmed, non-empty tag-filter list. `--tags a,b --tags c` → `['a','b','c']`.
+ */
+export declare function tagFiltersFrom(tags: readonly string[] | undefined): string[];
+/**
+ * Decide which recipe to execute. `--check` and `--tags` each create an
+ * ad-hoc recipe (recipeName=undefined); otherwise resolve a named recipe with
+ * tool-scoped precedence (ADR-0022): `--recipe` flag > `fitness.recipe` >
+ * built-in `default`. A config-sourced unknown name tolerantly falls back to
+ * `default` with a warning (the default may belong to another tool); an explicit
+ * `--recipe` typo returns an `ErrorResult`.
+ *
+ * **Precondition:** must run *after* `ensureChecksLoaded` so that any
+ * user-defined recipes (loaded as `.mjs` plugins under
+ * `<cwd>/opensip-cli/fit/recipes/`) are present in the scope's recipe
+ * registry by the time the lookup runs. Inverting the two
+ * lines silently breaks recipe lookup for plugin-provided recipes.
+ */
+export declare function selectRecipe(args: FitOptions, defaults?: FitRecipeDefaults): {
+    recipeName: string | undefined;
+} | {
+    error: ErrorResult;
+};
+/**
+ * Run the recipe (or ad-hoc selector built from `--check` / `--tags`).
+ *
+ * @throws {Error} When neither `args.check` nor `args.tags` is set but
+ *   `recipeName` is `undefined` — an invariant violation in the caller
+ *   (`selectRecipe` returns `recipeName` non-`undefined` in that branch).
+ */
+export declare function runRecipeOrAdHoc(service: FitnessRecipeService, args: FitOptions, recipeName: string | undefined): Promise<FitnessRecipeResult | {
+    error: ErrorResult;
+}>;
+//# sourceMappingURL=recipe-selector.d.ts.map

package/dist/cli/fit/recipe-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-selector.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/recipe-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAK5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,QAAQ,GAAE,iBAAsB,GAC/B;IAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAiC7D;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC,CA6BvD"}

package/dist/cli/fit/recipe-selector.js

@@ -0,0 +1,106 @@
+/**
+ * Recipe-pick + recipe-run helpers for the `fit` command.
+ *
+ * `selectRecipe()` decides between a named recipe (looked up in the
+ * current scope's recipe registry) and an ad-hoc recipe constructed from
+ * `--check` / `--tags`. `runRecipeOrAdHoc()` then executes the chosen
+ * shape via `FitnessRecipeService`.
+ */
+import { BUILTIN_DEFAULT_RECIPE, EXIT_CODES, resolveToolRecipeName } from '@opensip-cli/contracts';
+import { ConfigurationError, logger } from '@opensip-cli/core';
+import { currentRecipeRegistry } from '../../framework/scope-registry.js';
+import { FitnessRecipeService } from '../../recipes/service.js';
+/**
+ * Flatten the (repeatable, possibly comma-separated) `--tags` values into a
+ * trimmed, non-empty tag-filter list. `--tags a,b --tags c` → `['a','b','c']`.
+ */
+export function tagFiltersFrom(tags) {
+    return (tags ?? [])
+        .flatMap((t) => t.split(','))
+        .map((t) => t.trim())
+        .filter(Boolean);
+}
+/**
+ * Decide which recipe to execute. `--check` and `--tags` each create an
+ * ad-hoc recipe (recipeName=undefined); otherwise resolve a named recipe with
+ * tool-scoped precedence (ADR-0022): `--recipe` flag > `fitness.recipe` >
+ * built-in `default`. A config-sourced unknown name tolerantly falls back to
+ * `default` with a warning (the default may belong to another tool); an explicit
+ * `--recipe` typo returns an `ErrorResult`.
+ *
+ * **Precondition:** must run *after* `ensureChecksLoaded` so that any
+ * user-defined recipes (loaded as `.mjs` plugins under
+ * `<cwd>/opensip-cli/fit/recipes/`) are present in the scope's recipe
+ * registry by the time the lookup runs. Inverting the two
+ * lines silently breaks recipe lookup for plugin-provided recipes.
+ */
+export function selectRecipe(args, defaults = {}) {
+    const useAdHoc = args.check != null || tagFiltersFrom(args.tags).length > 0;
+    if (useAdHoc)
+        return { recipeName: undefined };
+    const resolved = resolveToolRecipeName({
+        explicit: args.recipe,
+        toolRecipe: defaults.toolRecipe,
+    });
+    if (!currentRecipeRegistry().has(resolved.name)) {
+        // Config-sourced unknown name → fall back to the built-in default rather
+        // than abort (it may be a shared/cross-tool default targeting another tool).
+        if (resolved.tolerant && resolved.name !== BUILTIN_DEFAULT_RECIPE) {
+            logger.warn({
+                evt: 'fit.recipe.unknown_config_default',
+                module: 'cli:fit',
+                requested: resolved.name,
+                fallback: BUILTIN_DEFAULT_RECIPE,
+                msg: `Configured fit recipe '${resolved.name}' not found; using '${BUILTIN_DEFAULT_RECIPE}'. If '${resolved.name}' is a recipe for another tool, move it under that tool's <tool>.recipe key (ADR-0022).`,
+            });
+            return { recipeName: BUILTIN_DEFAULT_RECIPE };
+        }
+        // Explicit --recipe typo → hard error (unchanged typo protection).
+        return {
+            error: {
+                type: 'error',
+                message: `Unknown recipe '${resolved.name}'.`,
+                suggestion: 'Run opensip fit --recipes to see available recipes.',
+                exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+            },
+        };
+    }
+    return { recipeName: resolved.name };
+}
+/**
+ * Run the recipe (or ad-hoc selector built from `--check` / `--tags`).
+ *
+ * @throws {Error} When neither `args.check` nor `args.tags` is set but
+ *   `recipeName` is `undefined` — an invariant violation in the caller
+ *   (`selectRecipe` returns `recipeName` non-`undefined` in that branch).
+ */
+export async function runRecipeOrAdHoc(service, args, recipeName) {
+    try {
+        if (args.check) {
+            return await service.start(FitnessRecipeService.createAdHocRecipe({ check: args.check }));
+        }
+        const tagFilters = tagFiltersFrom(args.tags);
+        if (tagFilters.length > 0) {
+            return await service.start(FitnessRecipeService.createAdHocRecipe({ tagFilters }));
+        }
+        // selectRecipe sets recipeName to undefined only when args.check or
+        // args.tags are present — both of which return earlier in this function.
+        // Guard explicitly so the type system tracks the narrowing without `!`.
+        if (recipeName == null) {
+            throw new Error('runRecipeOrAdHoc: recipeName must be defined when args.check/args.tags are absent');
+        }
+        return await service.start(recipeName);
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        const isConfigurationError = error instanceof ConfigurationError;
+        return {
+            error: {
+                type: 'error',
+                message: isConfigurationError ? msg : `Fitness run failed: ${msg}`,
+                exitCode: isConfigurationError ? EXIT_CODES.CONFIGURATION_ERROR : EXIT_CODES.RUNTIME_ERROR,
+            },
+        };
+    }
+}
+//# sourceMappingURL=recipe-selector.js.map

package/dist/cli/fit/recipe-selector.js.map

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

package/dist/cli/fit/recipe-selector.test.d.ts

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

package/dist/cli/fit/recipe-selector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-selector.test.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/recipe-selector.test.ts"],"names":[],"mappings":""}

package/dist/cli/fit/recipe-selector.test.js

@@ -0,0 +1,69 @@
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { enterScope, RunScope } from '@opensip-cli/core';
+import { beforeEach, describe, expect, it } from 'vitest';
+import { CheckRegistry } from '../../framework/registry.js';
+import { FitnessRecipeRegistry } from '../../recipes/registry.js';
+import { FitnessRecipeService } from '../../recipes/service.js';
+import { fitnessTool } from '../../tool.js';
+import { runRecipeOrAdHoc, selectRecipe } from './recipe-selector.js';
+/**
+ * `selectRecipe` resolves the fit recipe with tool-scoped precedence (ADR-0022)
+ * against the current scope's recipe registry, whose built-ins include
+ * `default` and `backend` but NOT `opensip` (a project-private fit recipe in the
+ * parent repo). These tests exercise the precedence + tolerance contract; each
+ * enters a fresh RunScope carrying fitness's contributed recipe registry.
+ */
+const base = { cwd: '/tmp' };
+beforeEach(() => {
+    const scope = new RunScope();
+    Object.assign(scope, fitnessTool.contributeScope?.() ?? {});
+    enterScope(scope);
+});
+describe('selectRecipe (ADR-0022 tool-scoped + tolerant)', () => {
+    it('explicit --recipe wins and resolves a real recipe', () => {
+        expect(selectRecipe({ ...base, recipe: 'backend' }, { toolRecipe: 'default' })).toEqual({
+            recipeName: 'backend',
+        });
+    });
+    it('explicit unknown --recipe hard-fails (typo protection)', () => {
+        const r = selectRecipe({ ...base, recipe: 'bogus-typo' });
+        expect('error' in r && r.error.message).toContain("Unknown recipe 'bogus-typo'");
+    });
+    it('uses fitness.recipe when no flag', () => {
+        expect(selectRecipe(base, { toolRecipe: 'backend' })).toEqual({
+            recipeName: 'backend',
+        });
+    });
+    it('a config-sourced UNKNOWN recipe tolerantly falls back to default (the leak fix)', () => {
+        // A copied tool-scoped recipe name that is absent from this registry must not
+        // abort — it falls back to default.
+        expect(selectRecipe(base, { toolRecipe: 'also-missing' })).toEqual({
+            recipeName: 'default',
+        });
+    });
+    it('--check / --tags force an ad-hoc recipe (recipeName undefined), ignoring config', () => {
+        expect(selectRecipe({ ...base, check: 'some-check' }, { toolRecipe: 'backend' })).toEqual({
+            recipeName: undefined,
+        });
+        expect(selectRecipe({ ...base, tags: ['quality'] }, { toolRecipe: 'backend' })).toEqual({
+            recipeName: undefined,
+        });
+    });
+    it('no flag and no config → built-in default', () => {
+        expect(selectRecipe(base)).toEqual({ recipeName: 'default' });
+    });
+    it('unknown explicit --check returns a configuration error result', async () => {
+        const service = new FitnessRecipeService({
+            cwd: '/tmp',
+            checkRegistry: new CheckRegistry(),
+            recipeRegistry: new FitnessRecipeRegistry(),
+            prewarmCache: false,
+        });
+        const result = await runRecipeOrAdHoc(service, { ...base, check: 'ghost-check' }, undefined);
+        expect('error' in result && result.error).toMatchObject({
+            message: "Unknown check 'ghost-check'.",
+            exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+        });
+    });
+});
+//# sourceMappingURL=recipe-selector.test.js.map

package/dist/cli/fit/recipe-selector.test.js.map

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

package/dist/cli/fit/resolved-fitness-config.d.ts

@@ -0,0 +1,48 @@
+/**
+ * resolved-fitness-config — read the fitness tool's RESOLVED config block off
+ * the per-run scope (ADR-0023, Phase 4).
+ *
+ * The CLI's pre-action hook composes every tool's namespaced
+ * `ToolConfigDeclaration` into ONE strict whole-document schema, validates the
+ * document, and resolves precedence (flag > env > file > defaults). The
+ * precedence-resolved result rides on `currentScope().toolConfig` — keyed by
+ * namespace (`fitness`/`graph`/`simulation`).
+ *
+ * Before this module, fitness re-read `opensip-cli.config.yml` through
+ * `loadSignalersConfig` and projected `signalersConfig.fitness.*`. That path
+ * NEVER saw the declared env bindings (`OPENSIP_FIT_FAIL_ON_ERRORS` /
+ * `OPENSIP_FIT_FAIL_ON_WARNINGS`) — they resolved into `scope.toolConfig` but
+ * were no-ops at the gate. Reading the resolved block here makes env (and any
+ * future flag) precedence the runtime source of truth for the fitness knobs.
+ *
+ * The shape mirrors `FitnessNamespaceSchema` (`config/fitness-config-schema.ts`)
+ * — kept as a plain readonly interface here rather than importing the Zod
+ * inferred type, because the kernel hands fitness a Zod-free
+ * `Record<string, unknown>` on `scope.toolConfig` (the kernel carries no
+ * config-layer dependency). The values were already strict-validated by the
+ * composer before they landed on the scope, so a structural narrowing is sound.
+ */
+/** The fitness namespace's resolved knobs (mirror of `FitnessNamespaceSchema`). */
+export interface ResolvedFitnessConfig {
+    readonly defaultTarget?: string;
+    readonly maxParallel?: number;
+    readonly timeout?: number;
+    readonly failOnErrors?: number;
+    readonly failOnWarnings?: number;
+    readonly disabledChecks?: readonly string[];
+    readonly recipe?: string;
+}
+/**
+ * Read the resolved `fitness:` block off the current scope's `toolConfig`.
+ *
+ * Returns `undefined` when there is no scope (a unit test that did not wrap in
+ * `runWithScope`) or no `toolConfig` (a config-less project, or a
+ * project-agnostic command). Callers fall back to their established
+ * file-sourced defaults in that case, so the gate stays defined even off the
+ * CLI dispatch path.
+ *
+ * The block is already strict-validated + precedence-resolved by the host
+ * (flag > env > file > defaults); this is a pure read, no validation.
+ */
+export declare function resolvedFitnessConfig(): ResolvedFitnessConfig | undefined;
+//# sourceMappingURL=resolved-fitness-config.d.ts.map

package/dist/cli/fit/resolved-fitness-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-fitness-config.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/resolved-fitness-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,qBAAqB,GAAG,SAAS,CAGzE"}

package/dist/cli/fit/resolved-fitness-config.js

@@ -0,0 +1,46 @@
+/**
+ * resolved-fitness-config — read the fitness tool's RESOLVED config block off
+ * the per-run scope (ADR-0023, Phase 4).
+ *
+ * The CLI's pre-action hook composes every tool's namespaced
+ * `ToolConfigDeclaration` into ONE strict whole-document schema, validates the
+ * document, and resolves precedence (flag > env > file > defaults). The
+ * precedence-resolved result rides on `currentScope().toolConfig` — keyed by
+ * namespace (`fitness`/`graph`/`simulation`).
+ *
+ * Before this module, fitness re-read `opensip-cli.config.yml` through
+ * `loadSignalersConfig` and projected `signalersConfig.fitness.*`. That path
+ * NEVER saw the declared env bindings (`OPENSIP_FIT_FAIL_ON_ERRORS` /
+ * `OPENSIP_FIT_FAIL_ON_WARNINGS`) — they resolved into `scope.toolConfig` but
+ * were no-ops at the gate. Reading the resolved block here makes env (and any
+ * future flag) precedence the runtime source of truth for the fitness knobs.
+ *
+ * The shape mirrors `FitnessNamespaceSchema` (`config/fitness-config-schema.ts`)
+ * — kept as a plain readonly interface here rather than importing the Zod
+ * inferred type, because the kernel hands fitness a Zod-free
+ * `Record<string, unknown>` on `scope.toolConfig` (the kernel carries no
+ * config-layer dependency). The values were already strict-validated by the
+ * composer before they landed on the scope, so a structural narrowing is sound.
+ */
+import { currentScope } from '@opensip-cli/core';
+/** A plain-object guard that treats arrays and null as non-objects. */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Read the resolved `fitness:` block off the current scope's `toolConfig`.
+ *
+ * Returns `undefined` when there is no scope (a unit test that did not wrap in
+ * `runWithScope`) or no `toolConfig` (a config-less project, or a
+ * project-agnostic command). Callers fall back to their established
+ * file-sourced defaults in that case, so the gate stays defined even off the
+ * CLI dispatch path.
+ *
+ * The block is already strict-validated + precedence-resolved by the host
+ * (flag > env > file > defaults); this is a pure read, no validation.
+ */
+export function resolvedFitnessConfig() {
+    const block = currentScope()?.toolConfig?.fitness;
+    return isPlainObject(block) ? block : undefined;
+}
+//# sourceMappingURL=resolved-fitness-config.js.map

package/dist/cli/fit/resolved-fitness-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-fitness-config.js","sourceRoot":"","sources":["../../../src/cli/fit/resolved-fitness-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAajD,uEAAuE;AACvE,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAG,YAAY,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC;IAClD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/cli/fit/result-builders.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Pure builders that transform fitness recipe results into the run's
+ * `SignalEnvelope` (the universal output currency, ADR-0011) and the
+ * `FitDoneResult` that carries it — plus the formatting helpers they rely on
+ * and the best-effort session persistence side effect invoked at the
+ * `executeFit` boundary.
+ *
+ * Keeping these together (rather than per-output-shape) makes the
+ * signal-shape mapping visible in one place: `buildFitEnvelope` maps check
+ * violations to `Signal`s and `buildFitDoneResult` wraps the envelope.
+ */
+import { type FitOptions, type SignalEnvelope, type FitDoneResult } from '@opensip-cli/contracts';
+import { type VerdictPolicy } from '@opensip-cli/core';
+import type { FitnessRecipeServiceCallbacks } from '../../recipes/service-types.js';
+import type { FitnessRecipeResult } from '../../recipes/types.js';
+import type { SignalersConfig } from '../../signalers/types.js';
+/**
+ * Resolve fit's findings policy (ADR-0035). Reserved keys
+ * `failOnErrors`/`failOnWarnings` come from the host-RESOLVED
+ * `scope.toolConfig.fitness` (flag>env>file>defaults, ADR-0023), falling back to
+ * the file-sourced `signalersConfig.fitness` when no scope/toolConfig is present
+ * (a config-less project, or `executeFit` invoked off the CLI dispatch path),
+ * then to the host default `{1, 0}`. This is fit's historical gate resolution,
+ * now expressed as a VerdictPolicy the host verdict consumes — so
+ * `envelope.verdict.passed` is the single exit driver.
+ */
+export declare function resolveFitVerdictPolicy(signalersConfig: SignalersConfig): VerdictPolicy;
+/**
+ * Assemble the fit run's {@link SignalEnvelope} — the universal output
+ * currency the composition root renders (table), emits (`--json`), and
+ * delivers (cloud + `--report-to`).
+ *
+ * Each check violation becomes one {@link Signal} (`source === ruleId ===
+ * checkSlug`) via {@link violationToSignal}; every check that ran produces one
+ * {@link UnitResult} row (so a clean check still appears in the table). The
+ * fitness-only `Validated`/`Ignores` columns ride on the unit as
+ * `filesValidated`/`itemType`/`ignoredCount` (per-unit facts a flat signal
+ * list cannot express). The verdict/summary are computed centrally by
+ * {@link buildSignalEnvelope} so all three tools agree on "passed ⇔ no
+ * critical/high".
+ *
+ * Pure: the only clock read (`createdAt`) and the run id come from the caller's
+ * scope, matching graph/sim's envelope builders.
+ */
+export declare function buildFitEnvelope(fitnessResult: FitnessRecipeResult, recipeName: string | undefined, signalersConfig: SignalersConfig): SignalEnvelope;
+/** Input bundle for {@link buildFitDoneResult}: CLI args, recipe result, the run envelope, and signaler config. */
+export interface BuildFitDoneArgs {
+    args: FitOptions;
+    fitnessResult: FitnessRecipeResult;
+    envelope: SignalEnvelope;
+    signalersConfig: SignalersConfig;
+    recipeName: string | undefined;
+    warnings?: readonly string[];
+}
+/**
+ * Build the {@link FitDoneResult} the live renderer / non-TTY render path
+ * consume. Carries the run's {@link SignalEnvelope} (the composition root
+ * derives the terminal table + summary AND the findings exit code FROM it — one
+ * row per check unit, `envelope.verdict.passed` the single verdict) plus the run
+ * label and non-fatal warnings.
+ *
+ * ADR-0035: the exit code is no longer carried on the result. `verdict.passed`
+ * (computed with fit's resolved failOnErrors/failOnWarnings policy + plugin-load
+ * `runFaulted`) is the single exit driver; the host derives it in `deliverSignals`.
+ *
+ * Pure builder: session persistence (SessionRepo.save) lives at the
+ * `executeFit` call site (post-call), not here. The envelope is assembled once
+ * in `executeFit` and threaded in so the gate, render, and session-payload
+ * paths all consume the same envelope.
+ */
+export declare function buildFitDoneResult({ args, envelope, recipeName, warnings, }: BuildFitDoneArgs): FitDoneResult;
+/**
+ * Wire up CLI-side progress callbacks for the recipe service.
+ *
+ * Monotonic completed-count: the service fires `onCheckStart(slug,
+ * displayIndex, total)` when a check STARTS and
+ * `onCheckComplete(slug, summary, displayIndex, total)` when it
+ * FINISHES. Under parallel execution `displayIndex` is the check's
+ * position in the queue (1..total), not "how many have completed" — so
+ * the last-started check's index hops above the current completion
+ * tally and then "resets" down when an earlier check finishes (the UI
+ * showed `147/148 → 121/148 → 78/148`).
+ *
+ * The progress bar wants a monotonic counter. We track completed
+ * locally, increment only on `onCheckComplete`, and ignore
+ * `onCheckStart`'s index. The counter is strictly non-decreasing and
+ * always reflects "N of M checks done."
+ */
+export declare function buildFitCallbacks(onProgress?: (completed: number, total: number) => void): FitnessRecipeServiceCallbacks;
+export { buildFitnessSessionPayload } from '../../persistence/session-payload.js';
+//# sourceMappingURL=result-builders.d.ts.map

package/dist/cli/fit/result-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builders.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/result-builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,cAAc,EAEnB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAS1F,OAAO,KAAK,EAAE,6BAA6B,EAAgB,MAAM,gCAAgC,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,wBAAwB,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,eAAe,GAAG,aAAa,CA0BvF;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,mBAAmB,EAClC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,eAAe,EAAE,eAAe,GAC/B,cAAc,CAuChB;AAED,mHAAmH;AACnH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,aAAa,EAAE,mBAAmB,CAAC;IACnC,QAAQ,EAAE,cAAc,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,gBAAgB,GAAG,aAAa,CAoBlC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACtD,6BAA6B,CA2B/B;AAOD,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC"}