@opensip-cli/fitness 0.1.0

package/dist/cli/fit/config-loader.js

@@ -0,0 +1,107 @@
+/**
+ * `opensip-cli.config.yml` parsing + validation for the `fit` command.
+ *
+ * Wraps `loadSignalersConfig` and `loadTargetsConfig` so that
+ * `executeFit` gets a single resolve-or-error step. A missing/invalid
+ * config is a HARD error — otherwise file-based checks silently produce
+ * zero findings, the exact failure mode the CLI exists to prevent.
+ */
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { logger } from '@opensip-cli/core';
+import { loadSignalersConfig } from '../../signalers/index.js';
+import { loadTargetsConfig } from '../../targets/index.js';
+/**
+ * Resolve `signalersConfig` + `targetsConfig` for this run. Scope-first
+ * (ADR-0023 one-reader): on CLI paths both loaders project from the
+ * host-validated `scope.configDocument`; the file read is the scope-less
+ * fallback (programmatic use, unit tests). Returns an `ErrorResult` instead
+ * of throwing so the caller maps it directly to the public failure shape — a
+ * missing/invalid config is a HARD error (otherwise file-based checks
+ * silently produce zero findings).
+ */
+export function loadFitConfig(args) {
+    try {
+        const signalersConfig = loadSignalersConfig(args.cwd, args.config);
+        const targetsResult = loadTargetsConfig(args.cwd, args.config);
+        return {
+            signalersConfig,
+            targetsConfig: targetsResult.config,
+            targetRegistry: targetsResult.registry,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn({ evt: 'cli.config.load_failed', module: 'cli:fit', message });
+        return {
+            error: {
+                type: 'error',
+                message,
+                suggestion: "Run 'opensip init' to scaffold a config, or pass --config <path> to point at an existing one.",
+                exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+            },
+        };
+    }
+}
+/**
+ * Warn loudly when the targets config declares a `languages:` tag that is
+ * neither backed by a content-filter adapter NOR a recognized non-code
+ * format — i.e. a likely typo. Silent acceptance would let users ship
+ * configs whose files match no check and skip filtering with no signal.
+ *
+ * `languages:` is a *matching dimension* (it routes files to checks via
+ * `findByScope`). A subset of those tags have a registered
+ * {@link LanguageAdapter} that strips strings/comments; another set are
+ * recognized non-code formats (JSON, YAML, Markdown, …) that are valid
+ * matching tags but intentionally have no adapter — files in those scan
+ * raw, which is correct, so they are NOT warned about. Only genuinely
+ * unrecognized tags (e.g. `pythonn`) warn.
+ *
+ * Returns warning strings (one per unknown-language batch) rather than
+ * writing to stderr — stderr writes during the Ink live view desync the
+ * renderer's frame tracking. `executeFit` collects these and threads
+ * them into `FitDoneResult.warnings`.
+ *
+ * Async only because `currentScope` is imported via dynamic import to
+ * keep the executeFit body free of fitness↔core import arrows beyond
+ * the kernel barrel. The scope is bound by the CLI pre-action-hook.
+ *
+ * @throws {Error} When called outside `runWithScope(...)` (no current scope).
+ */
+export async function validateLanguagesAgainstAdapters(targetRegistry) {
+    const { currentScope, isRecognizedNonCodeFormat } = await import('@opensip-cli/core');
+    const scope = currentScope();
+    if (!scope) {
+        throw new Error('validateLanguagesAgainstAdapters() called outside runWithScope. ' +
+            'fit pipeline must run inside a RunScope so language adapters resolve via cli.scope.languages.');
+    }
+    const langRegistry = scope.languages;
+    const knownLanguages = new Set(langRegistry.list().flatMap((a) => [a.id, ...(a.aliases ?? [])]));
+    const unknownLanguages = new Set();
+    for (const target of targetRegistry.getAll()) {
+        const langs = target.config.languages ?? [];
+        for (const lang of langs) {
+            // A tag is legitimate if it either has a content-filter adapter or
+            // is a recognized adapter-less format (JSON/YAML/Markdown/…). Only
+            // truly unrecognized tags fall through to the warning.
+            if (knownLanguages.has(lang) || isRecognizedNonCodeFormat(lang))
+                continue;
+            unknownLanguages.add(lang);
+        }
+    }
+    if (unknownLanguages.size === 0)
+        return [];
+    const list = [...unknownLanguages].sort().join(', ');
+    logger.warn({
+        evt: 'cli.config.unknown_languages',
+        module: 'cli:fit',
+        unknown: [...unknownLanguages],
+        known: [...knownLanguages],
+    });
+    return [
+        `target config declares unrecognized language tag(s): ${list}. ` +
+            `These match no content-filter adapter and are not a recognized non-code ` +
+            `format — likely a typo. Known code languages: ${[...knownLanguages].sort().join(', ')}. ` +
+            `Files under an unrecognized tag scan with no string/comment filtering.`,
+    ];
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/cli/fit/config-loader.js.map

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

package/dist/cli/fit/display-registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check display lookups — read from the scope-owned check registry.
+ *
+ * Display (icon + display name) travels WITH each check on `check.config`
+ * (§5.3 separate-domains fold); a pack's authoring map is folded onto its
+ * checks via `applyCheckDisplay` at the pack boundary. There is NO per-process
+ * merged-display singleton anymore (that was audit finding F3): `getDisplayName`
+ * / `getIcon` resolve a slug against the CURRENT run's check registry
+ * (`currentCheckRegistry()`), so two concurrent scopes read independent display
+ * with no shared mutable state.
+ *
+ * Slugs with no registered check (or a check that set no display) fall back to
+ * kebab-to-title-case for the name and a magnifying-glass emoji for the icon.
+ */
+/** Get the display name for a check slug, read from the current scope's check registry. */
+export declare function getDisplayName(slug: string): string;
+/** Get the icon for a check slug, read from the current scope's check registry. */
+export declare function getIcon(slug: string): string;
+//# sourceMappingURL=display-registry.d.ts.map

package/dist/cli/fit/display-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-registry.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/display-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/cli/fit/display-registry.js

@@ -0,0 +1,33 @@
+/**
+ * Check display lookups — read from the scope-owned check registry.
+ *
+ * Display (icon + display name) travels WITH each check on `check.config`
+ * (§5.3 separate-domains fold); a pack's authoring map is folded onto its
+ * checks via `applyCheckDisplay` at the pack boundary. There is NO per-process
+ * merged-display singleton anymore (that was audit finding F3): `getDisplayName`
+ * / `getIcon` resolve a slug against the CURRENT run's check registry
+ * (`currentCheckRegistry()`), so two concurrent scopes read independent display
+ * with no shared mutable state.
+ *
+ * Slugs with no registered check (or a check that set no display) fall back to
+ * kebab-to-title-case for the name and a magnifying-glass emoji for the icon.
+ */
+import { currentCheckRegistry } from '../../framework/scope-registry.js';
+/** Default icon when a check sets none. */
+const DEFAULT_ICON = '🔍';
+/** Kebab-to-title-case fallback display name for a slug. */
+function defaultDisplayName(slug) {
+    return slug
+        .split('-')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+/** Get the display name for a check slug, read from the current scope's check registry. */
+export function getDisplayName(slug) {
+    return currentCheckRegistry().find(slug)?.config.displayName ?? defaultDisplayName(slug);
+}
+/** Get the icon for a check slug, read from the current scope's check registry. */
+export function getIcon(slug) {
+    return currentCheckRegistry().find(slug)?.config.icon ?? DEFAULT_ICON;
+}
+//# sourceMappingURL=display-registry.js.map

package/dist/cli/fit/display-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-registry.js","sourceRoot":"","sources":["../../../src/cli/fit/display-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,2CAA2C;AAC3C,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,4DAA4D;AAC5D,SAAS,kBAAkB,CAAC,IAAY;IACtC,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,WAAW,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAC3F,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,IAAI,YAAY,CAAC;AACxE,CAAC"}

package/dist/cli/fit/envelope-view.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Fitness live-view derivation from the run's `SignalEnvelope`
+ * (ADR-0011, Phase 6).
+ *
+ * The shared `formatSignalTableRows` (`@opensip-cli/output`) is the canonical
+ * neutral table for the static/non-TTY render path — but fitness's PRODUCTION
+ * source must not import `@opensip-cli/output` (the root owns egress; output
+ * is the egress/format layer). So the TTY live view derives its richer,
+ * fitness-specific table (display names + the `Validated`/`Ignores` columns)
+ * straight from the envelope here, using only `@opensip-cli/contracts`
+ * (envelope/units) + `@opensip-cli/core` (signals). This is the
+ * decision-B fallback: ONE neutral formatter for the shared path, plus a
+ * tool-specific rich view for fitness's terminal UX — both fed by the same
+ * `UnitResult` facts (`filesValidated`/`itemType`/`ignoredCount`), so there is
+ * a single source of truth.
+ *
+ * Pure: no IO, no clock. `getDisplayName` is a registry lookup (display only).
+ */
+import type { SignalEnvelope, VerboseDetail } from '@opensip-cli/contracts';
+/** A live-view results-table row — one per check unit, with fitness columns. */
+export interface FitTableRow {
+    /** Display name (pretty, via the display registry), falling back to the slug. */
+    readonly check: string;
+    readonly status: 'PASS' | 'FAIL' | 'ERROR';
+    readonly errors: number;
+    readonly warnings: number;
+    /** Files/items scanned this run (raw count; rendered with the noun). */
+    readonly validated?: number;
+    readonly itemType?: string;
+    /** Findings suppressed by an inline ignore directive. */
+    readonly ignored: number;
+    readonly duration: string;
+    readonly durationMs: number;
+}
+/** Build the live-view results-table rows from the envelope (one row per unit). */
+export declare function envelopeToFitRows(envelope: SignalEnvelope): FitTableRow[];
+/** Render a row's "Validated" cell (e.g. `"450 files"`, `"—"`). */
+export declare function fitValidatedCell(row: FitTableRow): string;
+/**
+ * Build the run's verbose detail body (ADR-0021) — `undefined` unless the run
+ * asked for it (`--verbose`). Delegates the Signal[] → `FindingGroup[]` mapping
+ * to the shared contracts `buildFindingGroups` (one source for fit + sim),
+ * passing fit's display registry so each block is titled with the check's
+ * pretty name.
+ */
+export declare function buildFitVerboseDetail(envelope: SignalEnvelope, opts: {
+    readonly verbose?: boolean;
+}): VerboseDetail | undefined;
+//# sourceMappingURL=envelope-view.d.ts.map

package/dist/cli/fit/envelope-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-view.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/envelope-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAc,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGxF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAkBD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW,EAAE,CAsBzE;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,aAAa,GAAG,SAAS,CAM3B"}

package/dist/cli/fit/envelope-view.js

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Fitness live-view derivation from the run's `SignalEnvelope`
+ * (ADR-0011, Phase 6).
+ *
+ * The shared `formatSignalTableRows` (`@opensip-cli/output`) is the canonical
+ * neutral table for the static/non-TTY render path — but fitness's PRODUCTION
+ * source must not import `@opensip-cli/output` (the root owns egress; output
+ * is the egress/format layer). So the TTY live view derives its richer,
+ * fitness-specific table (display names + the `Validated`/`Ignores` columns)
+ * straight from the envelope here, using only `@opensip-cli/contracts`
+ * (envelope/units) + `@opensip-cli/core` (signals). This is the
+ * decision-B fallback: ONE neutral formatter for the shared path, plus a
+ * tool-specific rich view for fitness's terminal UX — both fed by the same
+ * `UnitResult` facts (`filesValidated`/`itemType`/`ignoredCount`), so there is
+ * a single source of truth.
+ *
+ * Pure: no IO, no clock. `getDisplayName` is a registry lookup (display only).
+ */
+import { formatValidatedColumn } from '@opensip-cli/cli-ui';
+import { buildFindingGroups } from '@opensip-cli/contracts';
+import { formatDuration, isErrorSignal } from '@opensip-cli/core';
+import { getDisplayName } from './display-registry.js';
+/** Group a run's signals by `signal.source` (the emitting check's slug). */
+function groupBySource(signals) {
+    const bySource = new Map();
+    for (const signal of signals) {
+        const bucket = bySource.get(signal.source);
+        if (bucket)
+            bucket.push(signal);
+        else
+            bySource.set(signal.source, [signal]);
+    }
+    return bySource;
+}
+function rowStatus(unit) {
+    if (unit.error !== undefined)
+        return 'ERROR';
+    return unit.passed ? 'PASS' : 'FAIL';
+}
+/** Build the live-view results-table rows from the envelope (one row per unit). */
+export function envelopeToFitRows(envelope) {
+    const bySource = groupBySource(envelope.signals);
+    return envelope.units.map((unit) => {
+        const unitSignals = bySource.get(unit.slug) ?? [];
+        let errors = 0;
+        let warnings = 0;
+        for (const s of unitSignals) {
+            if (isErrorSignal(s))
+                errors += 1;
+            else
+                warnings += 1;
+        }
+        return {
+            check: getDisplayName(unit.slug),
+            status: rowStatus(unit),
+            errors,
+            warnings,
+            validated: unit.filesValidated,
+            itemType: unit.itemType,
+            ignored: unit.ignoredCount ?? 0,
+            duration: formatDuration(unit.durationMs),
+            durationMs: unit.durationMs,
+        };
+    });
+}
+/** Render a row's "Validated" cell (e.g. `"450 files"`, `"—"`). */
+export function fitValidatedCell(row) {
+    return formatValidatedColumn(row.validated, row.itemType);
+}
+/**
+ * Build the run's verbose detail body (ADR-0021) — `undefined` unless the run
+ * asked for it (`--verbose`). Delegates the Signal[] → `FindingGroup[]` mapping
+ * to the shared contracts `buildFindingGroups` (one source for fit + sim),
+ * passing fit's display registry so each block is titled with the check's
+ * pretty name.
+ */
+export function buildFitVerboseDetail(envelope, opts) {
+    if (opts.verbose !== true)
+        return undefined;
+    return {
+        kind: 'findings',
+        groups: buildFindingGroups(envelope.units, envelope.signals, getDisplayName),
+    };
+}
+//# sourceMappingURL=envelope-view.js.map

package/dist/cli/fit/envelope-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope-view.js","sourceRoot":"","sources":["../../../src/cli/fit/envelope-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAqBvD,4EAA4E;AAC5E,SAAS,aAAa,CAAC,OAA0B;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;;YAC3B,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB;IACjC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACvC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YAC5B,IAAI,aAAa,CAAC,CAAC,CAAC;gBAAE,MAAM,IAAI,CAAC,CAAC;;gBAC7B,QAAQ,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,OAAO;YACL,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YAChC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC;YACvB,MAAM;YACN,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,cAAc;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC;YAC/B,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;YACzC,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,OAAO,qBAAqB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAwB,EACxB,IAAoC;IAEpC,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;KAC7E,CAAC;AACJ,CAAC"}

package/dist/cli/fit/fit-aux-command-specs.d.ts

@@ -0,0 +1,35 @@
+/**
+ * fit-aux-command-specs — the declarative `fit-list` / `fit-recipes` /
+ * `fit-baseline-export` commands (release 2.11.0 Phase 4 Task 4.2).
+ *
+ * Replaces fitness's hand-rolled `registerListCommand` / `registerRecipesCommand`
+ * / `registerBaselineExportCommand` bodies. The host mounts each spec via
+ * `mountCommandSpec`; the tool no longer touches Commander.
+ *
+ * Output modes:
+ *  - `fit-list` / `fit-recipes` → `command-result`: the handler returns the
+ *    list result; the host dispatches it through the shared seam
+ *    (`--json` → JSON.stringify, else render). Byte-identical to the former
+ *    `if (json) cli.emitJson(result) else cli.render(result)` body, because
+ *    `emitJson` and the seam's json arm both write `JSON.stringify(x, null, 2)
+ *    + '\n'`.
+ *  - `fit-baseline-export` → `raw-stream`: an explicit file-writing command. The
+ *    handler writes the SARIF baseline and prints a one-line confirmation (or an
+ *    error), owning its exit-code decision and the `--json` branch itself — the
+ *    documented non-Ink exception. The host renders nothing.
+ */
+import type { CommandSpec, ToolCliContext } from '@opensip-cli/core';
+/** `fit-list` — list available fitness checks. */
+export declare const fitListCommandSpec: CommandSpec<unknown, ToolCliContext>;
+/** `fit-recipes` — list available fitness recipes. */
+export declare const fitRecipesCommandSpec: CommandSpec<unknown, ToolCliContext>;
+/**
+ * `fit-baseline-export` — write the SQLite-backed fit baseline to a SARIF file.
+ *
+ * `output: 'raw-stream'`: the handler owns its full IO — it writes the file and
+ * prints a one-line confirmation, or sets the exit code + writes the error to
+ * the `--json`/stderr channel itself. Byte-identical to the former
+ * `registerBaselineExportCommand` action body.
+ */
+export declare const fitBaselineExportCommandSpec: CommandSpec<unknown, ToolCliContext>;
+//# sourceMappingURL=fit-aux-command-specs.d.ts.map

package/dist/cli/fit/fit-aux-command-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-aux-command-specs.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/fit-aux-command-specs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAErE,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,OAAO,EAAE,cAAc,CAalE,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,OAAO,EAAE,cAAc,CAarE,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,OAAO,EAAE,cAAc,CAqD5E,CAAC"}

package/dist/cli/fit/fit-aux-command-specs.js

@@ -0,0 +1,110 @@
+// @fitness-ignore-file no-direct-stdout-in-tool-engine -- auxiliary subcommand status line: `fit-baseline-export` writes the SARIF baseline to a file and prints a one-line "Exported fit baseline to <path>" confirmation (the --json path uses cli.emitJson). This is not the signal-envelope run output (ADR-0011), which routes through the composition root.
+// @fitness-ignore-file only-documented-toolcli-seams -- same rationale as above: the one-line "Exported fit baseline to <path>" status confirmation after a file write; the --json path uses cli.emitJson. Not run output through a ToolCliContext seam.
+/**
+ * fit-aux-command-specs — the declarative `fit-list` / `fit-recipes` /
+ * `fit-baseline-export` commands (release 2.11.0 Phase 4 Task 4.2).
+ *
+ * Replaces fitness's hand-rolled `registerListCommand` / `registerRecipesCommand`
+ * / `registerBaselineExportCommand` bodies. The host mounts each spec via
+ * `mountCommandSpec`; the tool no longer touches Commander.
+ *
+ * Output modes:
+ *  - `fit-list` / `fit-recipes` → `command-result`: the handler returns the
+ *    list result; the host dispatches it through the shared seam
+ *    (`--json` → JSON.stringify, else render). Byte-identical to the former
+ *    `if (json) cli.emitJson(result) else cli.render(result)` body, because
+ *    `emitJson` and the seam's json arm both write `JSON.stringify(x, null, 2)
+ *    + '\n'`.
+ *  - `fit-baseline-export` → `raw-stream`: an explicit file-writing command. The
+ *    handler writes the SARIF baseline and prints a one-line confirmation (or an
+ *    error), owning its exit-code decision and the `--json` branch itself — the
+ *    documented non-Ink exception. The host renders nothing.
+ */
+import { EXIT_CODES } from '@opensip-cli/contracts';
+import { ConfigurationError, defineCommand, logger } from '@opensip-cli/core';
+import { listChecks } from '../fit-list.js';
+import { listRecipes } from '../fit-recipes.js';
+/** `fit-list` — list available fitness checks. */
+export const fitListCommandSpec = defineCommand({
+    name: 'fit-list',
+    description: 'List available fitness checks',
+    commonFlags: ['cwd', 'json'],
+    scope: 'project',
+    output: 'command-result',
+    handler: async (rawOpts) => {
+        const opts = rawOpts;
+        return listChecks(opts.cwd);
+    },
+});
+/** `fit-recipes` — list available fitness recipes. */
+export const fitRecipesCommandSpec = defineCommand({
+    name: 'fit-recipes',
+    description: 'List available fitness recipes',
+    commonFlags: ['cwd', 'json'],
+    scope: 'project',
+    output: 'command-result',
+    handler: async (rawOpts) => {
+        const opts = rawOpts;
+        return listRecipes(opts.cwd);
+    },
+});
+/**
+ * `fit-baseline-export` — write the SQLite-backed fit baseline to a SARIF file.
+ *
+ * `output: 'raw-stream'`: the handler owns its full IO — it writes the file and
+ * prints a one-line confirmation, or sets the exit code + writes the error to
+ * the `--json`/stderr channel itself. Byte-identical to the former
+ * `registerBaselineExportCommand` action body.
+ */
+export const fitBaselineExportCommandSpec = defineCommand({
+    name: 'fit-baseline-export',
+    description: 'Export the fit gate baseline (SARIF) from the datastore to a file',
+    commonFlags: ['cwd', 'json'],
+    options: [
+        {
+            flag: '--out',
+            value: '<path>',
+            description: 'Output file path for the SARIF baseline',
+            required: true,
+        },
+    ],
+    scope: 'project',
+    output: 'raw-stream',
+    rawStreamReason: 'file-export',
+    handler: async (rawOpts, cli) => {
+        const opts = rawOpts;
+        // ADR-0036: the host owns the SARIF export — it reconstructs a synthetic
+        // envelope from the stored payloads (no stored envelope under the plane). The
+        // seam throws ConfigurationError (→ exit 2) when no baseline exists.
+        try {
+            await cli.exportBaselineSarif('fitness', opts.out);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const exitCode = error instanceof ConfigurationError
+                ? EXIT_CODES.CONFIGURATION_ERROR
+                : EXIT_CODES.RUNTIME_ERROR;
+            logger.warn({
+                evt: 'cli.fit.baseline_export.failed',
+                module: 'fit:cli',
+                message,
+                exitCode,
+            });
+            if (opts.json) {
+                // 2.12.0 (§5.5): structured error outcome (host wraps + sets exit code).
+                cli.emitError({ message, exitCode });
+                return;
+            }
+            cli.setExitCode(exitCode);
+            process.stderr.write(`Error: ${message}\n`);
+            return;
+        }
+        const result = { type: 'fit-baseline-export', outPath: opts.out };
+        if (opts.json) {
+            cli.emitJson(result);
+            return;
+        }
+        process.stdout.write(`Exported fit baseline to ${opts.out}\n`);
+    },
+});
+//# sourceMappingURL=fit-aux-command-specs.js.map

package/dist/cli/fit/fit-aux-command-specs.js.map

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

package/dist/cli/fit/fit-command-spec.d.ts

@@ -0,0 +1,24 @@
+/**
+ * fit-command-spec — the declarative `fit` command (release 2.11.0 Phase 4).
+ *
+ * Replaces fitness's hand-rolled `registerFitCommand()` body: the host mounts
+ * this spec via `mountCommandSpec`, applies the ADR-0021 common flags + fit's
+ * own options, and invokes {@link runFit}. The tool no longer touches Commander.
+ *
+ * `output: 'raw-stream'` because fit's handler owns its entire output surface —
+ * it dispatches at runtime between five mutually-exclusive modes (gate / list /
+ * recipes / json / live), each of which performs its OWN render/emit, exit-code
+ * decision, cloud egress (`deliverSignals` / `--report-to`), and dashboard
+ * auto-open. None of that is expressible through the `signal-envelope` dispatch
+ * arm (which only does `emitEnvelope`/`render`), so the host renders nothing and
+ * the handler stays authoritative — byte-identical to the former action body.
+ */
+import type { CommandSpec, ToolCliContext } from '@opensip-cli/core';
+export declare const FIT_LIVE_VIEW_KEY = "fit";
+/**
+ * Build the declarative `fit` command. The `setUpLiveView` callback is supplied
+ * by the tool (tool.ts) so the `cli.registerLiveView(renderFitLive)` wiring
+ * stays next to the renderer import; this module stays renderer-free.
+ */
+export declare function buildFitCommandSpec(setUpLiveView: (cli: ToolCliContext) => void): CommandSpec<unknown, ToolCliContext>;
+//# sourceMappingURL=fit-command-spec.d.ts.map

package/dist/cli/fit/fit-command-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fit-command-spec.d.ts","sourceRoot":"","sources":["../../../src/cli/fit/fit-command-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAMxF,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAoDvC;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAC3C,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,CA2DtC"}

package/dist/cli/fit/fit-command-spec.js

@@ -0,0 +1,131 @@
+/**
+ * fit-command-spec — the declarative `fit` command (release 2.11.0 Phase 4).
+ *
+ * Replaces fitness's hand-rolled `registerFitCommand()` body: the host mounts
+ * this spec via `mountCommandSpec`, applies the ADR-0021 common flags + fit's
+ * own options, and invokes {@link runFit}. The tool no longer touches Commander.
+ *
+ * `output: 'raw-stream'` because fit's handler owns its entire output surface —
+ * it dispatches at runtime between five mutually-exclusive modes (gate / list /
+ * recipes / json / live), each of which performs its OWN render/emit, exit-code
+ * decision, cloud egress (`deliverSignals` / `--report-to`), and dashboard
+ * auto-open. None of that is expressible through the `signal-envelope` dispatch
+ * arm (which only does `emitEnvelope`/`render`), so the host renders nothing and
+ * the handler stays authoritative — byte-identical to the former action body.
+ */
+import { defineCommand } from '@opensip-cli/core';
+import { runGateMode, runJsonMode, runListMode, runLiveMode, runRecipesMode, runShowMode, } from '../fit-modes.js';
+// Live-view key fitness contributes to the CLI's renderer registry. Owned by
+// this package — the CLI dispatcher does NOT key off this literal; each tool
+// decides its own live-view name. The renderer is registered lazily inside the
+// live branch of the handler via `setUpFitLiveView` (the tool wires that up).
+export const FIT_LIVE_VIEW_KEY = 'fit';
+/**
+ * The `fit` command handler — the former `registerFitCommand()` action body,
+ * lifted verbatim to a spec handler. Returns `void`: the host (`raw-stream`)
+ * renders nothing, so the five-mode dispatch keeps full ownership of its IO.
+ *
+ * The live-view registration that previously happened as a mount-time side
+ * effect in `register()` now happens lazily — the host calls `setUpFitLiveView`
+ * (passed in by the tool) the first time a live run needs it. We thread that
+ * setup callback in via the closure the tool builds, so this handler module
+ * stays free of the `cli.registerLiveView` wiring (which belongs next to the
+ * renderer import in tool.ts).
+ */
+async function runFit(rawOpts, cli, setUpLiveView) {
+    const opts = rawOpts;
+    // host-owned-run-timing Phases 3 + 5: the run-producing modes RETURN a
+    // `{ session, dashboard }` completion; runFit forwards it as a
+    // ToolRunCompletion and the host run plane persists the session row AND the
+    // per-run dashboard contribution after this handler resolves (the TTY live
+    // path already persisted via renderLive, so it returns undefined — no
+    // double-write).
+    if (opts.show !== undefined && opts.show.length > 0) {
+        await runShowMode(opts, cli);
+        return;
+    }
+    if (opts.gateSave === true || opts.gateCompare === true) {
+        return await runGateMode(opts, cli);
+    }
+    if (opts.list) {
+        await runListMode(opts, cli);
+        return;
+    }
+    if (opts.recipes) {
+        await runRecipesMode(opts, cli);
+        return;
+    }
+    if (opts.json) {
+        return await runJsonMode(opts, cli);
+    }
+    // Live mode is the only branch that needs fitness's Ink renderer. Register it
+    // lazily here (idempotent map write) — the spec-mounted world has no
+    // mount-time `register()` hook, so we set the renderer up on the host context
+    // before the `cli.renderLive` lookup inside runLiveMode.
+    setUpLiveView(cli);
+    return await runLiveMode(opts, cli, FIT_LIVE_VIEW_KEY, opts.open === true);
+}
+/**
+ * Build the declarative `fit` command. The `setUpLiveView` callback is supplied
+ * by the tool (tool.ts) so the `cli.registerLiveView(renderFitLive)` wiring
+ * stays next to the renderer import; this module stays renderer-free.
+ */
+export function buildFitCommandSpec(setUpLiveView) {
+    return defineCommand({
+        name: 'fit',
+        description: 'Run fitness checks',
+        // ADR-0021 cross-tool flags from the single registry: --cwd, --json,
+        // --quiet, --verbose, --debug, --report-to, --api-key, --open. `cwd` is
+        // seeded with process.cwd() by the mounter. fit-specific flags below.
+        commonFlags: ['cwd', 'json', 'quiet', 'verbose', 'debug', 'reportTo', 'apiKey', 'open'],
+        options: [
+            {
+                flag: '--recipe',
+                value: '<name>',
+                description: 'Use a named recipe (default, quick-smoke, backend, etc.)',
+            },
+            { flag: '--check', value: '<slug>', description: 'Run a single check by slug' },
+            {
+                flag: '--tags',
+                value: '<tags>',
+                description: 'Filter checks by tags (repeatable or comma-separated)',
+                arrayDefault: [],
+                parse: (val, prev) => [...prev, val],
+            },
+            { flag: '--list', description: 'List available checks', default: false },
+            { flag: '--recipes', description: 'List available recipes', default: false },
+            {
+                flag: '--exclude',
+                value: '<slug>',
+                description: 'Exclude check (repeatable)',
+                arrayDefault: [],
+                parse: (val, prev) => [...prev, val],
+            },
+            {
+                flag: '--config',
+                value: '<path>',
+                description: 'Path to opensip-cli.config.yml (overrides package.json pointer and default)',
+            },
+            {
+                flag: '--show',
+                value: '<session>',
+                description: 'Replay a stored fit session by id, or latest for the latest fit session',
+            },
+            {
+                flag: '--gate-save',
+                description: 'Architecture-gate: save current findings as baseline in the project SQLite store (mutually exclusive with --gate-compare)',
+                default: false,
+            },
+            {
+                flag: '--gate-compare',
+                description: 'Architecture-gate: compare current findings against the saved baseline; exit 1 on regression',
+                default: false,
+            },
+        ],
+        scope: 'project',
+        output: 'raw-stream',
+        rawStreamReason: 'runtime-render-dispatch',
+        handler: (opts, cli) => runFit(opts, cli, setUpLiveView),
+    });
+}
+//# sourceMappingURL=fit-command-spec.js.map

package/dist/cli/fit/fit-command-spec.js.map

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