@opensip-cli/fitness 0.1.0

package/dist/recipes/check-result-processor.js

@@ -0,0 +1,197 @@
+// @fitness-ignore-file toctou-race-condition -- updateSessionForSuccess mutates a session object owned by the calling recipe runner; recipe execution is serial and synchronous within a single Node.js process, no concurrent writers
+/**
+ * @fileoverview Check result processor for fitness recipe execution
+ *
+ * Processes individual check results (success or error), updates session state,
+ * builds check summaries, and determines whether execution should stop.
+ */
+import { logger, SeverityPolicy, SystemError } from '@opensip-cli/core';
+import { memoryProfiler } from '../framework/memory-profiler.js';
+import { countErrors, countWarnings } from '../types/severity.js';
+/** Build a CheckSummary from a successful check execution */
+function createCheckSummary(input) {
+    return {
+        checkId: input.checkId,
+        checkSlug: input.checkSlug,
+        passed: input.passed,
+        errors: input.errorCount,
+        warnings: input.warningCount,
+        durationMs: input.durationMs,
+        filesScanned: input.filesScanned ?? 0,
+        ignoredCount: input.ignoredCount ?? 0,
+        memoryProfile: input.memoryProfile,
+    };
+}
+/** Build a CheckSummary from a failed or errored check execution */
+function createErrorSummary(input) {
+    return {
+        checkId: input.checkId,
+        checkSlug: input.checkSlug,
+        passed: false,
+        errors: 1,
+        warnings: 0,
+        durationMs: input.durationMs,
+        filesScanned: 0,
+        ignoredCount: 0,
+        memoryProfile: input.memoryProfile,
+        timedOut: input.timedOut,
+        errorMessage: input.errorMessage,
+    };
+}
+// =============================================================================
+// SESSION UPDATES
+// =============================================================================
+function updateSessionForSuccess(session, checkResult, tags) {
+    session.checkResults.push(checkResult);
+    session.completedChecks++;
+    if (checkResult.passed) {
+        session.passedChecks++;
+    }
+    else {
+        session.failedChecks++;
+    }
+    session.totalErrors += checkResult.errorCount;
+    session.totalWarnings += checkResult.warningCount;
+    session.totalIgnored += checkResult.ignoredCount;
+    for (const tag of tags) {
+        session.ignoresByTag.set(tag, (session.ignoresByTag.get(tag) ?? 0) + checkResult.ignoredCount);
+    }
+}
+function updateSessionForError(session, checkResult) {
+    session.checkResults.push(checkResult);
+    session.completedChecks++;
+    session.failedChecks++;
+    session.totalErrors++;
+}
+// =============================================================================
+// MAIN PROCESSORS
+// =============================================================================
+/** Process a successful check result: update session, invoke callbacks, and determine stop condition */
+export function processSuccessResult(ctx, input) {
+    const { checkId, checkSlug, tags, checkIndex, totalChecks, result, durationMs, memoryBeforeMB } = input;
+    const { session, callbacks, recipe } = ctx;
+    // Apply file filter if set
+    let effectiveSignals = result.signals;
+    if (recipe.fileFilter) {
+        effectiveSignals = result.signals.filter((s) => s.code?.file === recipe.fileFilter);
+    }
+    const signalCount = effectiveSignals.length;
+    const errorCount = recipe.fileFilter ? countErrors(effectiveSignals) : result.errors;
+    const warningCount = recipe.fileFilter ? countWarnings(effectiveSignals) : result.warnings;
+    const ignoredCount = result.ignoredCount ?? 0;
+    const passed = recipe.fileFilter ? errorCount === 0 : result.passed;
+    const memoryProfile = memoryProfiler.recordCheckComplete(checkId, memoryBeforeMB, signalCount, durationMs);
+    /* v8 ignore start -- memory threshold is sized for production-scale (100MB+); not exercised by unit tests that operate on tiny fixture inputs */
+    if (memoryProfiler.exceedsThreshold(memoryProfile.memoryDeltaMB)) {
+        logger.warn('Check exceeded memory threshold', {
+            evt: 'fitness.check.memory.exceeded',
+            module: 'fitness:recipes',
+            checkId,
+            checkSlug,
+            memoryDeltaMB: memoryProfile.memoryDeltaMB,
+        });
+        callbacks.onMemoryWarning?.(checkId, memoryProfile);
+    }
+    /* v8 ignore stop */
+    const checkResult = {
+        checkId,
+        checkSlug,
+        passed,
+        violationCount: signalCount,
+        errorCount,
+        warningCount,
+        ignoredCount,
+        durationMs,
+        totalItems: result.metadata.totalItems,
+        itemType: result.metadata.itemType,
+        skipped: false,
+        ...(result.appliedDirectives && result.appliedDirectives.length > 0
+            ? { appliedDirectives: result.appliedDirectives }
+            : {}),
+        ...(ctx.includeViolations
+            ? {
+                violations: effectiveSignals.map((s) => ({
+                    file: s.code?.file ?? 'unknown',
+                    line: s.code?.line ?? 0,
+                    column: s.code?.column,
+                    message: s.message,
+                    severity: SeverityPolicy.isError(s.severity)
+                        ? 'error'
+                        : 'warning',
+                    suggestion: s.suggestion,
+                })),
+            }
+            : {}),
+    };
+    updateSessionForSuccess(session, checkResult, tags);
+    const summary = createCheckSummary({
+        checkId,
+        checkSlug,
+        passed,
+        errorCount,
+        warningCount,
+        durationMs,
+        memoryProfile,
+        ignoredCount,
+        filesScanned: result.metadata.filesScanned ?? 0,
+    });
+    try {
+        callbacks.onCheckComplete?.(checkSlug, summary, checkIndex, totalChecks);
+    }
+    catch (cbError) {
+        // Callback (e.g. progress renderer) threw after the check itself succeeded.
+        // Log but do not turn this into an error result or double-count the session
+        // (success path already updated counts). The check run is still a success.
+        logger.warn({
+            evt: 'fitness.check.callback_error',
+            module: 'fitness:check-result-processor',
+            checkSlug,
+            error: cbError instanceof Error ? cbError.message : String(cbError),
+        });
+    }
+    const shouldStop = recipe.execution.stopOnFirstFailure && !passed;
+    return { checkResult, memoryProfile, shouldStop };
+}
+/** Process a failed check result: update session, invoke callbacks, and determine stop condition */
+export function processErrorResult(ctx, input) {
+    const { checkId, checkSlug, checkIndex, totalChecks, error, durationMs, memoryBeforeMB, timedOut, timeoutMs, } = input;
+    const { session, callbacks, recipe } = ctx;
+    let errMsg;
+    if (timedOut && timeoutMs) {
+        errMsg = `Check ${checkSlug} timed out after ${timeoutMs}ms`;
+    }
+    else {
+        /* v8 ignore next -- callers always pass Error subclasses; the String(error) fallback is defensive */
+        errMsg = error instanceof Error ? error.message : String(error);
+    }
+    const memoryProfile = memoryProfiler.recordCheckComplete(checkId, memoryBeforeMB, 0, durationMs);
+    const checkResult = {
+        checkId,
+        checkSlug,
+        passed: false,
+        violationCount: 0,
+        errorCount: 1,
+        warningCount: 0,
+        ignoredCount: 0,
+        durationMs,
+        skipped: false,
+        error: errMsg,
+        timedOut,
+    };
+    updateSessionForError(session, checkResult);
+    const summary = createErrorSummary({
+        checkId,
+        checkSlug,
+        durationMs,
+        memoryProfile,
+        timedOut,
+        errorMessage: errMsg,
+    });
+    callbacks.onError?.(checkSlug, error instanceof Error
+        ? error
+        : new SystemError(errMsg, { code: 'SYSTEM.FITNESS.CHECK_ERROR' }));
+    callbacks.onCheckComplete?.(checkSlug, summary, checkIndex, totalChecks);
+    const shouldStop = recipe.execution.stopOnFirstFailure;
+    return { checkResult, memoryProfile, shouldStop };
+}
+//# sourceMappingURL=check-result-processor.js.map

package/dist/recipes/check-result-processor.js.map

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

package/dist/recipes/parallel-execution.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Parallel execution scheduler for fitness recipe checks
+ *
+ * Maintains a sliding window of `maxParallel` in-flight `runOneCheck`
+ * calls. Per-check semantics (timeout, abort, retry, success/error
+ * dispatch) live in `runOneCheck`; this file owns only the scheduling
+ * shape.
+ */
+import type { FitnessRecipeServiceCallbacks, FitnessRecipeSession } from './service-types.js';
+import type { FitnessRecipe } from './types.js';
+import type { Check } from '../framework/check-types.js';
+import type { FileCache } from '../framework/file-cache.js';
+/** Options for executing a set of fitness checks */
+export interface ExecutionOptions {
+    checks: Check[];
+    cwd: string;
+    recipe: FitnessRecipe;
+    /** Per-check pre-resolved file paths from target overrides */
+    checkTargetFiles?: ReadonlyMap<string, readonly string[]>;
+    /**
+     * Run-wide globalExcludes from project config. Forwarded into each
+     * check's RunOptions so scope-empty checks honor exclusions instead
+     * of scanning every file in the prewarmed cache.
+     */
+    globalExcludes?: readonly string[];
+    /** Per-service FileCache (for concurrent SaaS RunScope isolation). */
+    fileCache?: FileCache;
+}
+/** Service context providing session state, callbacks, and abort control */
+export interface ExecutionServiceContext {
+    session: FitnessRecipeSession;
+    callbacks: FitnessRecipeServiceCallbacks;
+    abortController?: AbortController;
+    includeViolations?: boolean;
+}
+/** Execute fitness checks concurrently with configurable parallelism and per-check timeouts */
+export declare function executeParallel(ctx: ExecutionServiceContext, opts: ExecutionOptions): Promise<void>;
+//# sourceMappingURL=parallel-execution.d.ts.map

package/dist/recipes/parallel-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-execution.d.ts","sourceRoot":"","sources":["../../src/recipes/parallel-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAM5D,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC1D;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,sEAAsE;IACtE,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,6BAA6B,CAAC;IACzC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAMD,+FAA+F;AAC/F,wBAAsB,eAAe,CACnC,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/recipes/parallel-execution.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Parallel execution scheduler for fitness recipe checks
+ *
+ * Maintains a sliding window of `maxParallel` in-flight `runOneCheck`
+ * calls. Per-check semantics (timeout, abort, retry, success/error
+ * dispatch) live in `runOneCheck`; this file owns only the scheduling
+ * shape.
+ */
+import { scheduleUnits } from '@opensip-cli/core';
+import { runOneCheck } from './run-one-check.js';
+import { getEffectiveMaxParallel } from './types.js';
+// =============================================================================
+// PARALLEL EXECUTION
+// =============================================================================
+/** Execute fitness checks concurrently with configurable parallelism and per-check timeouts */
+export async function executeParallel(ctx, opts) {
+    const { checks, cwd, recipe, checkTargetFiles, globalExcludes } = opts;
+    const { session, callbacks, abortController } = ctx;
+    const recipeTimeout = recipe.execution.timeout ?? 30_000;
+    const maxParallel = getEffectiveMaxParallel(recipe);
+    const totalChecks = checks.length;
+    if (totalChecks === 0)
+        return;
+    const processorCtx = {
+        session,
+        callbacks,
+        recipe,
+        includeViolations: ctx.includeViolations ?? false,
+    };
+    // Release 2.13.0 (§5.8): the sliding-window scheduling shape now lives in the
+    // shared substrate (`scheduleUnits`). This file keeps only the fitness setup +
+    // the per-check `runOneCheck` body; the loop/concurrency/stop/abort policy is
+    // host-owned. Byte-identical: scheduleUnits launches units in array order
+    // (1-based `index + 1` = the former `displayIndex`), refills up to `maxParallel`
+    // unless stopping/aborted, and resolves when drained.
+    await scheduleUnits({
+        units: checks,
+        mode: 'parallel',
+        maxParallel,
+        // Interim live-view smoothing (ADR-0028): a macrotask boundary between checks
+        // lets the in-process live spinner + 80ms clock paint. Superseded for the
+        // live run by off-main-thread execution; harmless on the --json path.
+        yieldBetweenUnits: true,
+        shouldAbort: () => abortController?.signal.aborted === true,
+        runUnit: async (check, index) => {
+            const outcome = await runOneCheck(check, {
+                cwd,
+                checkIndex: index + 1,
+                totalChecks,
+                recipeTimeoutMs: recipeTimeout,
+                retryEnabled: recipe.execution.retryOnFailure ?? false,
+                maxRetries: recipe.execution.maxRetries ?? 2,
+                ...(checkTargetFiles ? { checkTargetFiles } : {}),
+                ...(globalExcludes ? { globalExcludes } : {}),
+                ...(opts.fileCache ? { fileCache: opts.fileCache } : {}),
+            }, processorCtx);
+            return { shouldStop: outcome.shouldStop };
+        },
+    });
+}
+//# sourceMappingURL=parallel-execution.js.map

package/dist/recipes/parallel-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-execution.js","sourceRoot":"","sources":["../../src/recipes/parallel-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAqCrD,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAA4B,EAC5B,IAAsB;IAEtB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IACvE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC;IACzD,MAAM,WAAW,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAElC,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO;IAE9B,MAAM,YAAY,GAAqB;QACrC,OAAO;QACP,SAAS;QACT,MAAM;QACN,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,KAAK;KAClD,CAAC;IAEF,8EAA8E;IAC9E,+EAA+E;IAC/E,8EAA8E;IAC9E,0EAA0E;IAC1E,iFAAiF;IACjF,sDAAsD;IACtD,MAAM,aAAa,CAAQ;QACzB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,UAAU;QAChB,WAAW;QACX,8EAA8E;QAC9E,0EAA0E;QAC1E,sEAAsE;QACtE,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;QAC3D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,KAAK,EACL;gBACE,GAAG;gBACH,UAAU,EAAE,KAAK,GAAG,CAAC;gBACrB,WAAW;gBACX,eAAe,EAAE,aAAa;gBAC9B,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc,IAAI,KAAK;gBACtD,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC;gBAC5C,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,EACD,YAAY,CACb,CAAC;YACF,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/recipes/registry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Fitness recipe registry
+ *
+ * Thin wrapper around the kernel's `RecipeRegistry<T>` (Layer 1 / core)
+ * that adds fitness-specific concerns: built-in recipe pre-registration
+ * with throw-on-duplicate semantics, override tracking, and display
+ * info enriched with `isBuiltIn` / `overridesBuiltIn` flags.
+ *
+ * Built-in seeding goes through `registerAll(builtIns, { internal: true })`
+ * — the LSP-clean replacement for the prior direct-map-write pattern
+ * (the canonical T2 violation the runscope+registry plan resolves).
+ */
+import { RecipeRegistry } from '@opensip-cli/core';
+import type { FitnessRecipe } from './types.js';
+/** Display-friendly info about a registered recipe */
+export interface RecipeDisplayInfo {
+    readonly name: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly tags: readonly string[];
+    readonly isBuiltIn: boolean;
+    readonly isUserDefined: boolean;
+    readonly overridesBuiltIn: boolean;
+}
+/** Registry for fitness recipes, loading built-in and user-defined recipes */
+export declare class FitnessRecipeRegistry extends RecipeRegistry<FitnessRecipe> {
+    private readonly _overriddenBuiltIns;
+    constructor();
+    private registerBuiltInRecipes;
+    /**
+     * Register a fitness recipe. Throws on duplicate id/name unless
+     * `allowOverwrite: true` is passed — historical contract preserved
+     * by routing through the kernel registry's `throwOnDuplicate` flag.
+     */
+    register(recipe: FitnessRecipe, options?: {
+        allowOverwrite?: boolean;
+    }): void;
+    /** Check whether a built-in recipe has been overridden by a user recipe */
+    isOverridden(name: string): boolean;
+    /** Return the names of all built-in recipes overridden by user recipes */
+    getOverriddenBuiltIns(): readonly string[];
+    /** Clear all recipes and re-register built-in recipes */
+    reset(): void;
+    /** Return display-friendly info for all registered recipes */
+    listForDisplay(): readonly RecipeDisplayInfo[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/recipes/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/recipes/registry.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,8EAA8E;AAC9E,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACtE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;;IAOzD,OAAO,CAAC,sBAAsB;IAQ9B;;;;OAIG;IACM,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAOtF,2EAA2E;IAC3E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,0EAA0E;IAC1E,qBAAqB,IAAI,SAAS,MAAM,EAAE;IAI1C,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAKb,8DAA8D;IAC9D,cAAc,IAAI,SAAS,iBAAiB,EAAE;CAc/C"}

package/dist/recipes/registry.js

@@ -0,0 +1,70 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+/**
+ * @fileoverview Fitness recipe registry
+ *
+ * Thin wrapper around the kernel's `RecipeRegistry<T>` (Layer 1 / core)
+ * that adds fitness-specific concerns: built-in recipe pre-registration
+ * with throw-on-duplicate semantics, override tracking, and display
+ * info enriched with `isBuiltIn` / `overridesBuiltIn` flags.
+ *
+ * Built-in seeding goes through `registerAll(builtIns, { internal: true })`
+ * — the LSP-clean replacement for the prior direct-map-write pattern
+ * (the canonical T2 violation the runscope+registry plan resolves).
+ */
+import { RecipeRegistry } from '@opensip-cli/core';
+import { builtInRecipes, isBuiltInRecipe } from './built-in-recipes.js';
+/** Registry for fitness recipes, loading built-in and user-defined recipes */
+export class FitnessRecipeRegistry extends RecipeRegistry {
+    _overriddenBuiltIns = new Set();
+    constructor() {
+        super({ module: 'fitness:recipes', validationCode: 'VALIDATION.FITNESS.DUPLICATE_RECIPE' });
+        this.registerBuiltInRecipes();
+    }
+    registerBuiltInRecipes() {
+        // Built-in recipes ship valid; `{ internal: true }` bypasses the
+        // duplicate guard at the seed site so successive registrations
+        // (or a reset()/re-seed) don't trip the warn-first-wins policy.
+        // Replaces the prior direct-map-write LSP violation.
+        this.registerAll(builtInRecipes, { internal: true });
+    }
+    /**
+     * Register a fitness recipe. Throws on duplicate id/name unless
+     * `allowOverwrite: true` is passed — historical contract preserved
+     * by routing through the kernel registry's `throwOnDuplicate` flag.
+     */
+    register(recipe, options) {
+        super.register(recipe, {
+            allowOverwrite: options?.allowOverwrite ?? false,
+            throwOnDuplicate: !(options?.allowOverwrite ?? false),
+        });
+    }
+    /** Check whether a built-in recipe has been overridden by a user recipe */
+    isOverridden(name) {
+        return this._overriddenBuiltIns.has(name);
+    }
+    /** Return the names of all built-in recipes overridden by user recipes */
+    getOverriddenBuiltIns() {
+        return [...this._overriddenBuiltIns];
+    }
+    /** Clear all recipes and re-register built-in recipes */
+    reset() {
+        this.clear();
+        this.registerBuiltInRecipes();
+    }
+    /** Return display-friendly info for all registered recipes */
+    listForDisplay() {
+        return this.getAllRecipes().map((recipe) => {
+            const isUserRecipe = recipe.id.startsWith('URCP_');
+            return {
+                name: recipe.name,
+                displayName: recipe.displayName,
+                description: recipe.description,
+                tags: recipe.tags ?? [],
+                isBuiltIn: !isUserRecipe && isBuiltInRecipe(recipe.name),
+                isUserDefined: isUserRecipe,
+                overridesBuiltIn: this._overriddenBuiltIns.has(recipe.name),
+            };
+        });
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/recipes/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/recipes/registry.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAC1I;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAexE,8EAA8E;AAC9E,MAAM,OAAO,qBAAsB,SAAQ,cAA6B;IACrD,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzD;QACE,KAAK,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,qCAAqC,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAEO,sBAAsB;QAC5B,iEAAiE;QACjE,+DAA+D;QAC/D,gEAAgE;QAChE,qDAAqD;QACrD,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACM,QAAQ,CAAC,MAAqB,EAAE,OAAsC;QAC7E,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE;YACrB,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK;YAChD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,0EAA0E;IAC1E,qBAAqB;QACnB,OAAO,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,yDAAyD;IACzD,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAED,8DAA8D;IAC9D,cAAc;QACZ,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACzC,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBACvB,SAAS,EAAE,CAAC,YAAY,IAAI,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;gBACxD,aAAa,EAAE,YAAY;gBAC3B,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;aAC5D,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/recipes/retry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Retry logic for fitness check execution.
+ *
+ * Release 2.13.0: the retry implementation was hoisted into the shared execution
+ * substrate (`runWithRetry`, `@opensip-cli/core`). This module is now a thin
+ * fitness-flavoured wrapper that pins the abort-aware predicate (a
+ * `CheckAbortedError` is never retried) and preserves the historical return shape,
+ * so call sites and tests are unchanged.
+ */
+/** Configuration for retry behavior */
+export interface RetryOptions {
+    readonly enabled: boolean;
+    readonly maxRetries: number;
+    readonly checkId: string;
+    readonly checkSlug: string;
+}
+/** Result of a retry-wrapped function execution */
+export interface RetryResult<T> {
+    readonly result: T | undefined;
+    readonly lastError: unknown;
+    readonly retryCount: number;
+    readonly wasRetried: boolean;
+}
+/**
+ * Execute a function with retry logic via the shared substrate.
+ * Only retries when the function throws. CheckAbortedError is never retried.
+ */
+export declare function executeWithRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<RetryResult<T>>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/recipes/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/recipes/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAMzB"}

package/dist/recipes/retry.js

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Retry logic for fitness check execution.
+ *
+ * Release 2.13.0: the retry implementation was hoisted into the shared execution
+ * substrate (`runWithRetry`, `@opensip-cli/core`). This module is now a thin
+ * fitness-flavoured wrapper that pins the abort-aware predicate (a
+ * `CheckAbortedError` is never retried) and preserves the historical return shape,
+ * so call sites and tests are unchanged.
+ */
+import { runWithRetry } from '@opensip-cli/core';
+import { CheckAbortedError } from '../framework/execution-context.js';
+/**
+ * Execute a function with retry logic via the shared substrate.
+ * Only retries when the function throws. CheckAbortedError is never retried.
+ */
+export async function executeWithRetry(fn, options) {
+    return runWithRetry(fn, {
+        enabled: options.enabled,
+        maxRetries: options.maxRetries,
+        shouldNotRetry: (error) => error instanceof CheckAbortedError,
+    });
+}
+//# sourceMappingURL=retry.js.map

package/dist/recipes/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/recipes/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAkBtE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAoB,EACpB,OAAqB;IAErB,OAAO,YAAY,CAAC,EAAE,EAAE;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,iBAAiB;KAC9D,CAAC,CAAC;AACL,CAAC"}

package/dist/recipes/run-one-check.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Per-check execution lifecycle
+ *
+ * `runOneCheck` is the single entry point for "run this Check, with its
+ * timeout, retry, and abort behavior, and tell me how it ended." Both
+ * the parallel and sequential schedulers delegate to it; they keep only
+ * the scheduling shape (sliding window vs `for-of` loop).
+ *
+ * Reconciled abort semantics:
+ *
+ * The earlier parallel/sequential implementations diverged on how they
+ * detected a timeout — parallel inspected `signal.aborted` after the
+ * retry resolved; sequential maintained a separate `timedOut` flag
+ * mutated by the setTimeout callback. Either signal source is sufficient
+ * because the per-check `AbortController` is only aborted by the
+ * setTimeout we install here. We keep `signal.aborted` as the canonical
+ * shape (it is the controller's own state and survives the retry chain
+ * without a closure-scoped flag), and treat any post-retry `aborted`
+ * signal as a timeout.
+ */
+import { type ProcessorContext, type ProcessResultOutput } from './check-result-processor.js';
+import type { Check } from '../framework/check-types.js';
+import type { FileCache } from '../framework/file-cache.js';
+/** Per-call options for `runOneCheck`. */
+export interface RunOneCheckOptions {
+    readonly cwd: string;
+    readonly checkIndex: number;
+    readonly totalChecks: number;
+    readonly recipeTimeoutMs: number;
+    readonly retryEnabled: boolean;
+    readonly maxRetries: number;
+    readonly checkTargetFiles?: ReadonlyMap<string, readonly string[]>;
+    readonly globalExcludes?: readonly string[];
+    /** Per-service FileCache (for SaaS isolation; forwarded from ExecutionOptions). */
+    readonly fileCache?: FileCache;
+}
+/** Outcome of running a single check. */
+export interface RunOneCheckOutcome {
+    /**
+     * Whether the scheduling layer should stop dispatching further
+     * checks. Mirrors the `shouldStop` field on
+     * `ProcessResultOutput`; `false` when no result was processed
+     * (e.g. nothing to record because the call short-circuited).
+     */
+    readonly shouldStop: boolean;
+    /** Defined when a result was successfully processed (may be a pass or a fail). */
+    readonly processOutput?: ProcessResultOutput;
+}
+/**
+ * Execute one check end-to-end: build the abort controller, install the
+ * timeout, run with retry, then dispatch the result to
+ * `processSuccessResult` / `processErrorResult` based on the outcome.
+ *
+ * Schedulers should call this once per check. The returned
+ * `shouldStop` field tells the scheduler whether to break out of its
+ * loop (e.g. `recipe.execution.stopOnFirstFailure`).
+ */
+export declare function runOneCheck(check: Check, opts: RunOneCheckOptions, ctx: ProcessorContext): Promise<RunOneCheckOutcome>;
+//# sourceMappingURL=run-one-check.d.ts.map

package/dist/recipes/run-one-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-one-check.d.ts","sourceRoot":"","sources":["../../src/recipes/run-one-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAS5D,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CAC9C;AAMD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAiJ7B"}