@opensip-cli/fitness 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @opensip-cli/fitness — public barrel.
+ *
+ * This barrel is the **marketplace contract surface** for the fitness tool:
+ * the check / recipe / plugin authoring API plus the `fitnessTool` plugin
+ * descriptor. It is deliberately curated to match
+ * `docs/public/10-concepts/04-contract-surfaces.md` — a check pack depends
+ * only on what is exported here.
+ *
+ * Engine internals — registries, the recipe service, `ExecutionContext`,
+ * targets/signalers config, the plugin loader, check-package discovery, the
+ * `fit`/`dashboard`/`list-*` CLI handlers, the architecture-gate primitives,
+ * and the persistence repos (`FitBaselineRepo`) — are NOT public. The CLI
+ * drives fitness through the Tool contract (`fitnessTool`), never by importing
+ * those symbols; fitness's own `tool.ts` wires them via relative imports. The
+ * handful that cross-package test suites need are exposed via
+ * `@opensip-cli/fitness/internal` (see `./internal.ts`), which production
+ * code is forbidden from importing (dependency-cruiser `no-cross-package-internal`,
+ * ADR-0009 / ADR-0013).
+ *
+ * The exact value-export set is locked by `__tests__/public-api.test.ts`:
+ * adding or removing a runtime export here fails that test on purpose. Adding
+ * a symbol to this barrel is a minor change; removing one is a major change.
+ */
+export { defineCheck } from './framework/define-check.js';
+export { defineRegexListCheck } from './framework/define-regex-list-check.js';
+export { FITNESS_CONTRACT_VERSION } from './tool.js';
+export type { RegexListCheckPattern, RegexListCheckOptions, DefineRegexListCheckConfig, } from './framework/define-regex-list-check.js';
+export { defineRecipe } from './recipes/types.js';
+export type { FitnessRecipeDefinition } from './recipes/types.js';
+export { readPackageVersion } from '@opensip-cli/core';
+export type { CheckViolation, CheckScope, FileAccessor, CheckConcern, CheckLanguage, } from './framework/check-config.js';
+export type { Check } from './framework/check-types.js';
+export { isCheck, collectCheckObjects } from './framework/check-types.js';
+export type { Finding, Severity, FindingSeverity, ToolOutput, CheckResult, CheckInfo, CheckResultMetadata, ItemType, } from './types/findings.js';
+export { getLineNumber, extractSnippet, isAPIFile } from './framework/result-builder.js';
+export { execAbortable } from './framework/abortable-exec.js';
+export { fileCache } from './framework/file-cache.js';
+export { buildImportGraph, findStronglyConnectedComponents } from './framework/import-graph.js';
+export type { ImportGraph } from './framework/import-graph.js';
+export { isInsideStringLiteral, stripStringLiterals, stripStringsAndComments, stripStringsAndCommentsPreservingPositions, } from './framework/strip-literals.js';
+export { getCheckConfig, setCurrentRecipeCheckConfig, clearCurrentRecipeCheckConfig, } from './recipes/check-config.js';
+export { isCommentLine, isTestFile, applyCheckDisplay, getCheckDisplayName, getCheckIcon, makeDisplayHelpers, createPathMatcher, } from './check-utils/index.js';
+export type { IsCommentLineOptions, IsTestFileOptions, DisplayHelpers, PathPattern, } from './check-utils/index.js';
+export type { CheckDisplayEntry, FitPluginExports } from './plugins/types.js';
+export { fitnessTool, fitnessTool as tool } from './tool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAI9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wCAAwC,CAAC;AAQhD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAKlE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,YAAY,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG1E,YAAY,EACV,OAAO,EACP,QAAQ,EACR,eAAe,EACf,UAAU,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAChG,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAK/D,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,0CAA0C,GAC3C,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAKhC,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAM9E,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,64 @@
+/**
+ * @opensip-cli/fitness — public barrel.
+ *
+ * This barrel is the **marketplace contract surface** for the fitness tool:
+ * the check / recipe / plugin authoring API plus the `fitnessTool` plugin
+ * descriptor. It is deliberately curated to match
+ * `docs/public/10-concepts/04-contract-surfaces.md` — a check pack depends
+ * only on what is exported here.
+ *
+ * Engine internals — registries, the recipe service, `ExecutionContext`,
+ * targets/signalers config, the plugin loader, check-package discovery, the
+ * `fit`/`dashboard`/`list-*` CLI handlers, the architecture-gate primitives,
+ * and the persistence repos (`FitBaselineRepo`) — are NOT public. The CLI
+ * drives fitness through the Tool contract (`fitnessTool`), never by importing
+ * those symbols; fitness's own `tool.ts` wires them via relative imports. The
+ * handful that cross-package test suites need are exposed via
+ * `@opensip-cli/fitness/internal` (see `./internal.ts`), which production
+ * code is forbidden from importing (dependency-cruiser `no-cross-package-internal`,
+ * ADR-0009 / ADR-0013).
+ *
+ * The exact value-export set is locked by `__tests__/public-api.test.ts`:
+ * adding or removing a runtime export here fails that test on purpose. Adding
+ * a symbol to this barrel is a minor change; removing one is a major change.
+ */
+// ── Check authoring API ────────────────────────────────────────────
+export { defineCheck } from './framework/define-check.js';
+export { defineRegexListCheck } from './framework/define-regex-list-check.js';
+// Per-tool contract version (ADR-0047). Re-exported from the tool module
+// (the single source of truth) so check packs and authors can import it.
+export { FITNESS_CONTRACT_VERSION } from './tool.js';
+// ── Recipe authoring API ───────────────────────────────────────────
+// `defineRecipe` is the stable authoring entry point; `FitnessRecipeDefinition`
+// is the object an author writes. The produced `FitnessRecipe`, the recipe
+// service, registries, and `RecipeCheckResult` are engine internals (the doc
+// names `FitnessRecipe` / `RecipeCheckResult` as non-contract) and stay
+// unexported — `defineRecipe`'s inferred return type carries them where needed.
+export { defineRecipe } from './recipes/types.js';
+// ── Re-exported kernel convenience ─────────────────────────────────
+// Lets a pack barrel set `metadata.version` from its own package.json without
+// duplicating the literal or adding a direct @opensip-cli/core dep.
+export { readPackageVersion } from '@opensip-cli/core';
+export { isCheck, collectCheckObjects } from './framework/check-types.js';
+// ── Authoring helpers — snippet/line extraction, file access ────────
+export { getLineNumber, extractSnippet, isAPIFile } from './framework/result-builder.js';
+export { execAbortable } from './framework/abortable-exec.js';
+// File cache (checks read content through it; pack tests may seed/clear it).
+export { fileCache } from './framework/file-cache.js';
+export { buildImportGraph, findStronglyConnectedComponents } from './framework/import-graph.js';
+// Regex-based string/comment strippers — language-agnostic, good enough for
+// universal/text checks. (The TS-AST-aware, position-preserving `filterContent`
+// lives in @opensip-cli/lang-typescript; TS checks import it from there.)
+export { isInsideStringLiteral, stripStringLiterals, stripStringsAndComments, stripStringsAndCommentsPreservingPositions, } from './framework/strip-literals.js';
+// ── Recipe-aware check config accessors ────────────────────────────
+// A check reads its recipe-provided config via `getCheckConfig`; the set/clear
+// pair is used by pack test suites to drive a check under a given config.
+export { getCheckConfig, setCurrentRecipeCheckConfig, clearCurrentRecipeCheckConfig, } from './recipes/check-config.js';
+// ── Check-author display / util helpers (extracted from per-pack copies) ──
+export { isCommentLine, isTestFile, applyCheckDisplay, getCheckDisplayName, getCheckIcon, makeDisplayHelpers, createPathMatcher, } from './check-utils/index.js';
+// ── Tool plugin export ─────────────────────────────────────────────
+// Re-exported as `tool` so the third-party plugin-discovery walker (which keys
+// on `mod.tool`) treats first-party and third-party Tool packages uniformly;
+// dedup at register-tools.ts handles the duplicate-id case.
+export { fitnessTool, fitnessTool as tool } from './tool.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,sEAAsE;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,yEAAyE;AACzE,yEAAyE;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAOrD,sEAAsE;AACtE,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,wEAAwE;AACxE,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,sEAAsE;AACtE,8EAA8E;AAC9E,oEAAoE;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAWvD,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAc1E,uEAAuE;AACvE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,6EAA6E;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAGhG,4EAA4E;AAC5E,gFAAgF;AAChF,0EAA0E;AAC1E,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,0CAA0C,GAC3C,MAAM,+BAA+B,CAAC;AAEvC,sEAAsE;AACtE,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AAEnC,6EAA6E;AAC7E,OAAO,EACL,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAahC,sEAAsE;AACtE,+EAA+E;AAC/E,6EAA6E;AAC7E,4DAA4D;AAC5D,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/internal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview `@opensip-cli/fitness/internal` — engine internals exposed
+ * ONLY for cross-package test suites.
+ *
+ * This is NOT public API. Production code in other packages must not import
+ * from `@opensip-cli/fitness/internal` (enforced by dependency-cruiser per
+ * ADR-0009), and the subpath is excluded from the published exports map.
+ * `executeFit` lives here because the CLI drives fitness through the Tool
+ * contract (`fitnessTool`), not by calling `executeFit` directly; the only
+ * external consumer is the SaaS-mode concurrency smoke test.
+ *
+ * The per-check fixture-coverage harness that used to live here moved to the
+ * unpublished `@opensip-cli/test-support` package (ADR-0040) — test
+ * scaffolding no longer ships inside production package source.
+ */
+export { executeFit } from './cli/fit.js';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/internal.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview `@opensip-cli/fitness/internal` — engine internals exposed
+ * ONLY for cross-package test suites.
+ *
+ * This is NOT public API. Production code in other packages must not import
+ * from `@opensip-cli/fitness/internal` (enforced by dependency-cruiser per
+ * ADR-0009), and the subpath is excluded from the published exports map.
+ * `executeFit` lives here because the CLI drives fitness through the Tool
+ * contract (`fitnessTool`), not by calling `executeFit` directly; the only
+ * external consumer is the SaaS-mode concurrency smoke test.
+ *
+ * The per-check fixture-coverage harness that used to live here moved to the
+ * unpublished `@opensip-cli/test-support` package (ADR-0040) — test
+ * scaffolding no longer ships inside production package source.
+ */
+export { executeFit } from './cli/fit.js';
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/persistence/session-payload.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Fitness-owned session payload (audit 2026-05-29, session split;
+ * rebuilt from the run's {@link SignalEnvelope} in ADR-0011 Phase 6 — no
+ * `CliOutput`).
+ *
+ * `contracts` stores per-session detail as an opaque JSON blob in
+ * `session_tool_payload.payload` and holds zero check/finding/summary
+ * vocabulary. Fitness owns the shape of its own payload here and ships the
+ * dashboard renderer that reads it back. The dashboard's shared session-detail
+ * renderer reads `{ summary, checks[] }` where each check has `checkSlug`,
+ * `passed`, `violationCount`, `durationMs`, and `findings[].severity ∈
+ * error|warning` (2-LEVEL) — so this payload derives FROM the envelope's
+ * 4-level signals, collapsing `critical|high → error`, else `warning`. The
+ * 4-level severity stays in `--json`; the 2-level lives only here (two
+ * consumers, two shapes).
+ */
+import type { SignalEnvelope } from '@opensip-cli/contracts';
+/** Two-level severity the dashboard buckets on (`critical|high → error`). */
+export type FitnessFindingSeverity = 'error' | 'warning';
+/** Per-check finding inside a {@link FitnessSessionPayload}. */
+interface FitnessSessionFinding {
+    readonly ruleId: string;
+    readonly message: string;
+    readonly severity: FitnessFindingSeverity;
+    readonly filePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly suggestion?: string;
+}
+/** Per-check result inside a {@link FitnessSessionPayload}. */
+interface FitnessSessionCheck {
+    readonly checkSlug: string;
+    readonly passed: boolean;
+    readonly violationCount?: number;
+    readonly findings: readonly FitnessSessionFinding[];
+    readonly durationMs: number;
+}
+/** Opaque-to-contracts detail blob written for every `fit` session. */
+export interface FitnessSessionPayload {
+    /** Inner version per the payload schema evolution convention (v1 shape). */
+    readonly __version: 1;
+    readonly summary: {
+        readonly total: number;
+        readonly passed: number;
+        readonly failed: number;
+        readonly errors: number;
+        readonly warnings: number;
+    };
+    readonly checks: readonly FitnessSessionCheck[];
+}
+/**
+ * Build the fitness session payload directly from the run's
+ * {@link SignalEnvelope}.
+ *
+ * One `checks[]` entry per `units[]` row (every check that ran — a clean check
+ * still appears, matching the dashboard's per-check catalog stats), with its
+ * findings recovered by grouping `signals` on `signal.source === unit.slug`.
+ * The 4-level signal severity is collapsed to the dashboard's `error|warning`.
+ * `summary` is taken from the envelope's verdict, which already counts
+ * `critical|high → errors`, else `warnings`.
+ *
+ * The returned payload includes `__version: 1` (the current v1 shape per the
+ * tool-owned payload evolution convention). Additive changes stay on v1;
+ * breaking changes will bump the number (with deprecation per the rules).
+ */
+export declare function buildFitnessSessionPayload(envelope: SignalEnvelope): FitnessSessionPayload;
+export {};
+//# sourceMappingURL=session-payload.d.ts.map

package/dist/persistence/session-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-payload.d.ts","sourceRoot":"","sources":["../../src/persistence/session-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,wBAAwB,CAAC;AAGzE,6EAA6E;AAC7E,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzD,gEAAgE;AAChE,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,+DAA+D;AAC/D,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,uEAAuE;AACvE,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAoBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,GAAG,qBAAqB,CA4B1F"}

package/dist/persistence/session-payload.js

@@ -0,0 +1,78 @@
+/**
+ * Fitness-owned session payload (audit 2026-05-29, session split;
+ * rebuilt from the run's {@link SignalEnvelope} in ADR-0011 Phase 6 — no
+ * `CliOutput`).
+ *
+ * `contracts` stores per-session detail as an opaque JSON blob in
+ * `session_tool_payload.payload` and holds zero check/finding/summary
+ * vocabulary. Fitness owns the shape of its own payload here and ships the
+ * dashboard renderer that reads it back. The dashboard's shared session-detail
+ * renderer reads `{ summary, checks[] }` where each check has `checkSlug`,
+ * `passed`, `violationCount`, `durationMs`, and `findings[].severity ∈
+ * error|warning` (2-LEVEL) — so this payload derives FROM the envelope's
+ * 4-level signals, collapsing `critical|high → error`, else `warning`. The
+ * 4-level severity stays in `--json`; the 2-level lives only here (two
+ * consumers, two shapes).
+ */
+import { isErrorSignal } from '@opensip-cli/core';
+/** Map a signal to the dashboard's 2-level bucket (`critical|high → error`). */
+function toDashboardSeverity(signal) {
+    return isErrorSignal(signal) ? 'error' : 'warning';
+}
+/** Map a check's signals into the dashboard-shaped finding rows. */
+function findingsFor(signals) {
+    return signals.map((s) => ({
+        ruleId: s.ruleId,
+        message: s.message,
+        severity: toDashboardSeverity(s),
+        filePath: s.filePath,
+        line: s.line,
+        column: s.column,
+        suggestion: s.suggestion,
+    }));
+}
+/**
+ * Build the fitness session payload directly from the run's
+ * {@link SignalEnvelope}.
+ *
+ * One `checks[]` entry per `units[]` row (every check that ran — a clean check
+ * still appears, matching the dashboard's per-check catalog stats), with its
+ * findings recovered by grouping `signals` on `signal.source === unit.slug`.
+ * The 4-level signal severity is collapsed to the dashboard's `error|warning`.
+ * `summary` is taken from the envelope's verdict, which already counts
+ * `critical|high → errors`, else `warnings`.
+ *
+ * The returned payload includes `__version: 1` (the current v1 shape per the
+ * tool-owned payload evolution convention). Additive changes stay on v1;
+ * breaking changes will bump the number (with deprecation per the rules).
+ */
+export function buildFitnessSessionPayload(envelope) {
+    const bySource = new Map();
+    for (const s of envelope.signals) {
+        const bucket = bySource.get(s.source);
+        if (bucket)
+            bucket.push(s);
+        else
+            bySource.set(s.source, [s]);
+    }
+    const checks = envelope.units.map((unit) => ({
+        checkSlug: unit.slug,
+        passed: unit.passed,
+        violationCount: unit.violationCount,
+        findings: findingsFor(bySource.get(unit.slug) ?? []),
+        durationMs: unit.durationMs,
+    }));
+    const { summary } = envelope.verdict;
+    return {
+        __version: 1,
+        summary: {
+            total: summary.total,
+            passed: summary.passed,
+            failed: summary.failed,
+            errors: summary.errors,
+            warnings: summary.warnings,
+        },
+        checks,
+    };
+}
+//# sourceMappingURL=session-payload.js.map

package/dist/persistence/session-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-payload.js","sourceRoot":"","sources":["../../src/persistence/session-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA0ClD,gFAAgF;AAChF,SAAS,mBAAmB,CAAC,MAAc;IACzC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,oEAAoE;AACpE,SAAS,WAAW,CAAC,OAA0B;IAC7C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;QAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAwB;IACjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YACtB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAA0B,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE,CAAC,CAAC;QAC9E,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpD,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC,CAAC;IAEJ,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;IACrC,OAAO;QACL,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B;QACD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/persistence/session-payload.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for {@link buildFitnessSessionPayload} (coverage gap).
+ *
+ * Drives the payload builder off a real {@link SignalEnvelope}: signals are
+ * grouped by `source` onto their unit, the 4-level severity is collapsed to the
+ * dashboard's `error|warning` (critical|high → error, else warning), a unit
+ * with no matching signals gets an empty `findings[]`, and the `summary` is
+ * carried through from the envelope verdict.
+ */
+export {};
+//# sourceMappingURL=session-payload.test.d.ts.map

package/dist/persistence/session-payload.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-payload.test.d.ts","sourceRoot":"","sources":["../../src/persistence/session-payload.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/persistence/session-payload.test.js

@@ -0,0 +1,80 @@
+/**
+ * Unit tests for {@link buildFitnessSessionPayload} (coverage gap).
+ *
+ * Drives the payload builder off a real {@link SignalEnvelope}: signals are
+ * grouped by `source` onto their unit, the 4-level severity is collapsed to the
+ * dashboard's `error|warning` (critical|high → error, else warning), a unit
+ * with no matching signals gets an empty `findings[]`, and the `summary` is
+ * carried through from the envelope verdict.
+ */
+import { buildSignalEnvelope } from '@opensip-cli/contracts';
+import { createSignal, HOST_VERDICT_POLICY_FALLBACK } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { buildFitnessSessionPayload } from './session-payload.js';
+function sig(source, severity, ruleId = `fit:${source}`) {
+    return createSignal({
+        source,
+        severity,
+        ruleId,
+        message: `${severity} from ${source}`,
+        code: { file: 'src/x.ts', line: 3, column: 5 },
+        suggestion: 'fix it',
+    });
+}
+function envelope(units, signals) {
+    return buildSignalEnvelope({
+        tool: 'fit',
+        runId: 'RUN_test',
+        createdAt: '2026-06-05T00:00:00.000Z',
+        units: units.map((u) => ({
+            slug: u.slug,
+            passed: u.passed,
+            violationCount: u.violationCount,
+            durationMs: u.durationMs ?? 10,
+        })),
+        signals,
+        policy: HOST_VERDICT_POLICY_FALLBACK,
+        runFaulted: false,
+    });
+}
+describe('buildFitnessSessionPayload', () => {
+    it('groups multiple signals from the same source onto one check (push branch)', () => {
+        const env = envelope([{ slug: 'a', passed: false, violationCount: 2 }], [sig('a', 'critical'), sig('a', 'low')]);
+        const payload = buildFitnessSessionPayload(env);
+        expect(payload.checks).toHaveLength(1);
+        expect(payload.checks[0]?.findings).toHaveLength(2);
+        expect(payload.checks[0]?.checkSlug).toBe('a');
+        expect(payload.checks[0]?.violationCount).toBe(2);
+    });
+    it('collapses 4-level severity to 2-level (critical|high → error, else warning)', () => {
+        const env = envelope([
+            { slug: 'a', passed: false },
+            { slug: 'b', passed: false },
+        ], [sig('a', 'high'), sig('b', 'medium')]);
+        const payload = buildFitnessSessionPayload(env);
+        const a = payload.checks.find((c) => c.checkSlug === 'a');
+        const b = payload.checks.find((c) => c.checkSlug === 'b');
+        expect(a?.findings[0]?.severity).toBe('error');
+        expect(b?.findings[0]?.severity).toBe('warning');
+    });
+    it('a unit with no matching signals gets an empty findings list (?? [] branch)', () => {
+        const env = envelope([{ slug: 'clean', passed: true }], []);
+        const payload = buildFitnessSessionPayload(env);
+        expect(payload.checks[0]?.findings).toEqual([]);
+        expect(payload.checks[0]?.passed).toBe(true);
+    });
+    it('carries the envelope verdict summary through and preserves finding location fields', () => {
+        const env = envelope([
+            { slug: 'a', passed: false },
+            { slug: 'ok', passed: true },
+        ], [sig('a', 'critical')]);
+        const payload = buildFitnessSessionPayload(env);
+        expect(payload.summary).toEqual({ total: 2, passed: 1, failed: 1, errors: 1, warnings: 0 });
+        const finding = payload.checks.find((c) => c.checkSlug === 'a')?.findings[0];
+        expect(finding?.filePath).toBe('src/x.ts');
+        expect(finding?.line).toBe(3);
+        expect(finding?.column).toBe(5);
+        expect(finding?.suggestion).toBe('fix it');
+    });
+});
+//# sourceMappingURL=session-payload.test.js.map

package/dist/persistence/session-payload.test.js.map

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

package/dist/persistence/session-replay.d.ts

@@ -0,0 +1,14 @@
+import type { FitDoneResult, StoredSession, ToolSessionReplay } from '@opensip-cli/contracts';
+/**
+ * Project a stored fit session back into a {@link SignalEnvelope}/{@link FitDoneResult}.
+ *
+ * The structural decode of the opaque payload is shared across tools
+ * (`decodeSessionPayload`); this function owns only fit's projection — the
+ * envelope vocabulary (`tool: 'fit'`, recipe label) and the per-finding signal
+ * shape (`category: 'quality'`, severity mapping, id prefix).
+ *
+ * @throws {Error | TypeError} when the stored payload is not the expected shape
+ *   (propagated from `decodeSessionPayload`).
+ */
+export declare function fitReplayFromSession(stored: StoredSession): ToolSessionReplay<FitDoneResult>;
+//# sourceMappingURL=session-replay.d.ts.map

package/dist/persistence/session-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/persistence/session-replay.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACb,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAwD5F"}

package/dist/persistence/session-replay.js

@@ -0,0 +1,85 @@
+import { currentScope, extractPayloadVersion } from '@opensip-cli/core';
+import { decodeSessionPayload } from '@opensip-cli/session-store';
+/**
+ * Project a stored fit session back into a {@link SignalEnvelope}/{@link FitDoneResult}.
+ *
+ * The structural decode of the opaque payload is shared across tools
+ * (`decodeSessionPayload`); this function owns only fit's projection — the
+ * envelope vocabulary (`tool: 'fit'`, recipe label) and the per-finding signal
+ * shape (`category: 'quality'`, severity mapping, id prefix).
+ *
+ * @throws {Error | TypeError} when the stored payload is not the expected shape
+ *   (propagated from `decodeSessionPayload`).
+ */
+export function fitReplayFromSession(stored) {
+    const decoded = decodeSessionPayload(stored.payload, { tool: 'fit' });
+    // Version-aware handling per payload evolution plan.
+    // Prefer the version surfaced by the structural decoder (from Phase 0); fall back via the pure helper.
+    const version = decoded.payloadVersion ?? extractPayloadVersion(stored.payload) ?? 1;
+    if (version > 1) {
+        // Future version: warn via diagnostics (observable in --json outcomes) + logger.
+        // Still attempt best-effort projection using whatever the structural decoder produced.
+        const scope = currentScope();
+        scope?.diagnostics?.event('load', 'warn', `fit session payload future version (v=${version}); using projection`, { sessionId: stored.id, version });
+        // (logger is available via scope or module; diagnostics is the cross-cutting seam)
+    }
+    const units = decoded.checks.map((check) => ({
+        slug: check.checkSlug,
+        passed: check.passed,
+        ...(check.violationCount === undefined ? {} : { violationCount: check.violationCount }),
+        durationMs: check.durationMs,
+    }));
+    const signals = decoded.checks.flatMap((check, checkIndex) => check.findings.map((finding, findingIndex) => replaySignal(stored, check.checkSlug, finding, checkIndex, findingIndex)));
+    const envelope = {
+        schemaVersion: 2,
+        tool: 'fit',
+        runId: stored.id,
+        createdAt: stored.startedAt,
+        ...(stored.recipe === undefined ? {} : { recipe: stored.recipe }),
+        verdict: {
+            score: stored.score,
+            passed: stored.passed,
+            summary: decoded.summary,
+        },
+        units,
+        signals,
+    };
+    return {
+        fidelity: 'projection',
+        envelope,
+        result: {
+            type: 'fit-done',
+            label: stored.recipe ? `recipe ${stored.recipe}` : `session ${stored.id}`,
+            cwd: stored.cwd,
+            envelope,
+            configFound: true,
+        },
+    };
+}
+function replaySignal(stored, source, finding, checkIndex, findingIndex) {
+    return {
+        id: `${stored.id}:fit:${checkIndex}:${findingIndex}`,
+        source,
+        provider: 'opensip-cli',
+        severity: finding.severity === 'error' ? 'high' : 'medium',
+        category: 'quality',
+        ruleId: finding.ruleId,
+        message: finding.message,
+        filePath: finding.filePath ?? '',
+        ...(finding.suggestion === undefined ? {} : { suggestion: finding.suggestion }),
+        ...(finding.line === undefined ? {} : { line: finding.line }),
+        ...(finding.column === undefined ? {} : { column: finding.column }),
+        ...(finding.filePath === undefined
+            ? {}
+            : {
+                code: {
+                    file: finding.filePath,
+                    ...(finding.line === undefined ? {} : { line: finding.line }),
+                    ...(finding.column === undefined ? {} : { column: finding.column }),
+                },
+            }),
+        metadata: {},
+        createdAt: stored.startedAt,
+    };
+}
+//# sourceMappingURL=session-replay.js.map

package/dist/persistence/session-replay.js.map

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

package/dist/persistence/session-replay.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for {@link fitReplayFromSession} (coverage gap).
+ *
+ * `session-payload.ts` (encode) and `session-replay.ts` (decode) are inverses,
+ * so the happy path is driven as a round-trip: a real {@link SignalEnvelope} →
+ * `buildFitnessSessionPayload` → stored payload → `fitReplayFromSession`. The
+ * remaining tests drive each validation branch directly with malformed payloads.
+ */
+export {};
+//# sourceMappingURL=session-replay.test.d.ts.map

package/dist/persistence/session-replay.test.d.ts.map

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