@opensip-tools/fitness 1.0.4

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

@@ -0,0 +1,158 @@
+/**
+ * @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, SystemError } from '@opensip-tools/core';
+import { memoryProfiler } from '../framework/memory-profiler.js';
+import { countErrors, countWarnings } from '../types/severity.js';
+// =============================================================================
+// CHECK SUMMARY BUILDERS
+// =============================================================================
+/** Build a CheckSummary from a successful check execution */
+function createCheckSummary(checkId, checkSlug, passed, errorCount, warningCount, durationMs, memoryProfile, ignoredCount = 0, filesScanned = 0) {
+    return {
+        checkId,
+        checkSlug,
+        passed,
+        errors: errorCount,
+        warnings: warningCount,
+        durationMs,
+        filesScanned,
+        ignoredCount,
+        memoryProfile,
+    };
+}
+/** Build a CheckSummary from a failed or errored check execution */
+function createErrorSummary(checkId, checkSlug, durationMs, memoryProfile, timedOut, errorMessage) {
+    return {
+        checkId,
+        checkSlug,
+        passed: false,
+        errors: 1,
+        warnings: 0,
+        durationMs,
+        filesScanned: 0,
+        ignoredCount: 0,
+        memoryProfile,
+        timedOut,
+        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);
+    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);
+    }
+    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: s.severity === 'high' ? 'error' : 'warning',
+                suggestion: s.suggestion,
+            })),
+        } : {}),
+    };
+    updateSessionForSuccess(session, checkResult, tags);
+    const summary = createCheckSummary(checkId, checkSlug, passed, errorCount, warningCount, durationMs, memoryProfile, ignoredCount, result.metadata.filesScanned ?? 0);
+    callbacks.onCheckComplete?.(checkSlug, summary, checkIndex, totalChecks);
+    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 {
+        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, 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,33 @@
+/**
+ * @fileoverview Parallel execution engine for fitness recipe checks
+ *
+ * Runs fitness checks concurrently with configurable parallelism,
+ * per-check timeouts, abort support, and retry logic.
+ */
+import type { FitnessRecipeServiceCallbacks, FitnessRecipeSession } from './service-types.js';
+import type { FitnessRecipe } from './types.js';
+import type { Check } from '../framework/check-types.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[];
+}
+/** 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;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAA;AAUxD,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,aAAa,CAAA;IACrB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;IACzD;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAA;IAC7B,SAAS,EAAE,6BAA6B,CAAA;IACxC,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAMD,+FAA+F;AAC/F,wBAAsB,eAAe,CAAC,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmKzG"}

package/dist/recipes/parallel-execution.js

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview Parallel execution engine for fitness recipe checks
+ *
+ * Runs fitness checks concurrently with configurable parallelism,
+ * per-check timeouts, abort support, and retry logic.
+ */
+import { TimeoutError, logger } from '@opensip-tools/core';
+import { memoryProfiler } from '../framework/memory-profiler.js';
+import { processSuccessResult, processErrorResult } from './check-result-processor.js';
+import { executeWithRetry } from './retry.js';
+import { getEffectiveMaxParallel } from './types.js';
+/** Logger module tag used by every event emitted from the parallel execution engine. */
+const MODULE_TAG = 'fitness:execution';
+// =============================================================================
+// PARALLEL EXECUTION
+// =============================================================================
+/** Execute fitness checks concurrently with configurable parallelism and per-check timeouts */
+export async function executeParallel(ctx, opts) {
+    // in-memory: single-threaded Node.js access pattern
+    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;
+    const memoryBeforeMap = new Map();
+    let nextCheckIndex = 0;
+    let activeCount = 0;
+    let shouldStopExecution = false;
+    const processorCtx = { session, callbacks, recipe, includeViolations: ctx.includeViolations ?? false };
+    // @fitness-ignore-next-line concurrency-safety -- async arrow provides Promise<void> return type for consistency; single-threaded Node.js access pattern
+    /* eslint-disable @typescript-eslint/require-await -- callers `await` this; preserving async signature in case future processors become async */
+    const processCheckResult = async (checkIndex, checkId, checkSlug, checkTags, result, durationMs) => {
+        // in-memory: single-threaded Node.js access pattern
+        const memoryBeforeMB = memoryBeforeMap.get(checkId) ?? 0;
+        const output = processSuccessResult(processorCtx, {
+            checkId,
+            checkSlug,
+            tags: checkTags,
+            checkIndex,
+            totalChecks,
+            result,
+            durationMs,
+            memoryBeforeMB,
+        });
+        if (output.shouldStop)
+            shouldStopExecution = true;
+    };
+    /* eslint-enable @typescript-eslint/require-await */
+    const processCheckError = (checkIndex, checkId, checkSlug, error, durationMs, timedOut = false, timeoutMs) => {
+        const memoryBeforeMB = memoryBeforeMap.get(checkId) ?? 0;
+        const errorInput = {
+            checkId,
+            checkSlug,
+            checkIndex,
+            totalChecks,
+            error,
+            durationMs,
+            memoryBeforeMB,
+            timedOut,
+            ...(timeoutMs === undefined ? {} : { timeoutMs }),
+        };
+        const output = processErrorResult(processorCtx, errorInput);
+        if (output.shouldStop)
+            shouldStopExecution = true;
+    };
+    await new Promise((resolve) => {
+        const advanceWindow = () => {
+            activeCount--;
+            if (!shouldStopExecution && nextCheckIndex < checks.length && !abortController?.signal.aborted) {
+                const nextCheck = checks[nextCheckIndex];
+                if (nextCheck) {
+                    nextCheckIndex++;
+                    startCheck(nextCheck, nextCheckIndex);
+                }
+            }
+            if (activeCount === 0 && (nextCheckIndex >= checks.length || shouldStopExecution)) {
+                resolve();
+            }
+        };
+        // @fitness-ignore-next-line file-length-limits -- Parallel check launcher: orchestrates timeout, retry, result processing, and window advancement in a single cohesive unit
+        const startCheck = (check, displayIndex) => {
+            // in-memory: single-threaded Node.js access pattern
+            const checkId = check.config.id;
+            activeCount++;
+            const checkTimeout = check.config.timeout ?? recipeTimeout;
+            memoryBeforeMap.set(checkId, memoryProfiler.recordCheckStart());
+            callbacks.onCheckStart?.(check.config.slug, displayIndex, totalChecks);
+            logger.info({ evt: 'fitness.check.start', module: MODULE_TAG, checkSlug: check.config.slug, index: displayIndex, total: totalChecks, timeoutMs: checkTimeout });
+            const startTime = Date.now();
+            const checkAbortController = new AbortController();
+            const timeoutId = setTimeout(() => checkAbortController.abort(), checkTimeout);
+            const targetFiles = checkTargetFiles?.get(check.config.slug);
+            void executeWithRetry(() => check.run(cwd, {
+                signal: checkAbortController.signal,
+                ...(targetFiles ? { targetFiles } : {}),
+                ...(globalExcludes ? { globalExcludes } : {}),
+            }), {
+                enabled: recipe.execution.retryOnFailure ?? false,
+                maxRetries: recipe.execution.maxRetries ?? 2,
+                checkId,
+                checkSlug: check.config.slug,
+            })
+                .then(async (retryResult) => {
+                const durationMs = Date.now() - startTime;
+                if (retryResult.result === undefined) {
+                    clearTimeout(timeoutId);
+                    const isTimeout = checkAbortController.signal.aborted;
+                    logger.info({ evt: 'fitness.check.error', module: MODULE_TAG, checkSlug: check.config.slug, durationMs, timedOut: isTimeout, error: retryResult.lastError instanceof Error ? retryResult.lastError.message : String(retryResult.lastError) });
+                    void processCheckError(displayIndex, checkId, check.config.slug, retryResult.lastError, durationMs, isTimeout, isTimeout ? checkTimeout : undefined);
+                }
+                else if (checkAbortController.signal.aborted) {
+                    clearTimeout(timeoutId);
+                    logger.info({ evt: 'fitness.check.timeout', module: MODULE_TAG, checkSlug: check.config.slug, durationMs, timeoutMs: checkTimeout });
+                    void processCheckError(displayIndex, checkId, check.config.slug, new TimeoutError(`Check ${checkId} timed out after ${checkTimeout}ms`, checkTimeout), durationMs, true, checkTimeout);
+                }
+                else {
+                    clearTimeout(timeoutId);
+                    logger.info({ evt: 'fitness.check.done', module: MODULE_TAG, checkSlug: check.config.slug, durationMs, signals: retryResult.result.signals.length });
+                    await processCheckResult(displayIndex, checkId, check.config.slug, check.config.tags ?? [], retryResult.result, durationMs);
+                }
+            })
+                .catch((error) => {
+                clearTimeout(timeoutId);
+                const durationMs = Date.now() - startTime;
+                logger.info({ evt: 'fitness.check.error', module: MODULE_TAG, checkSlug: check.config.slug, durationMs, error: error instanceof Error ? error.message : String(error) });
+                void processCheckError(displayIndex, checkId, check.config.slug, error, durationMs);
+            })
+                .finally(() => advanceWindow());
+        };
+        const initialBatchSize = Math.min(maxParallel, checks.length);
+        for (let i = 0; i < initialBatchSize; i++) {
+            const check = checks[i];
+            if (check) {
+                nextCheckIndex = i + 1;
+                startCheck(check, i + 1);
+            }
+        }
+        if (checks.length === 0)
+            resolve();
+    });
+}
+//# 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;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAG,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAGhE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAyB,MAAM,6BAA6B,CAAA;AAC7G,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAOpD,wFAAwF;AACxF,MAAM,UAAU,GAAG,mBAAmB,CAAA;AA6BtC,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAA4B,EAAE,IAAsB;IACxF,oDAAoD;IACpD,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,IAAI,CAAA;IACtE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,GAAG,CAAA;IACnD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,MAAM,CAAA;IACxD,MAAM,WAAW,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAA;IAEjC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAA;IACjD,IAAI,cAAc,GAAG,CAAC,CAAA;IACtB,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,IAAI,mBAAmB,GAAG,KAAK,CAAA;IAE/B,MAAM,YAAY,GAAqB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,KAAK,EAAE,CAAA;IAExH,yJAAyJ;IACzJ,gJAAgJ;IAChJ,MAAM,kBAAkB,GAAG,KAAK,EAC9B,UAAkB,EAClB,OAAe,EACf,SAAiB,EACjB,SAA4B,EAC5B,MAAmB,EACnB,UAAkB,EACH,EAAE;QACjB,oDAAoD;QACpD,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,MAAM,GAAG,oBAAoB,CAAC,YAAY,EAAE;YAChD,OAAO;YACP,SAAS;YACT,IAAI,EAAE,SAAS;YACf,UAAU;YACV,WAAW;YACX,MAAM;YACN,UAAU;YACV,cAAc;SACf,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,UAAU;YAAE,mBAAmB,GAAG,IAAI,CAAA;IACnD,CAAC,CAAA;IACD,oDAAoD;IAEpD,MAAM,iBAAiB,GAAG,CACxB,UAAkB,EAClB,OAAe,EACf,SAAiB,EACjB,KAAc,EACd,UAAkB,EAClB,QAAQ,GAAG,KAAK,EAChB,SAAkB,EACZ,EAAE;QACR,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,UAAU,GAAG;YACjB,OAAO;YACP,SAAS;YACT,UAAU;YACV,WAAW;YACX,KAAK;YACL,UAAU;YACV,cAAc;YACd,QAAQ;YACR,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;SAClD,CAAA;QACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;QAC3D,IAAI,MAAM,CAAC,UAAU;YAAE,mBAAmB,GAAG,IAAI,CAAA;IACnD,CAAC,CAAA;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,aAAa,GAAG,GAAG,EAAE;YACzB,WAAW,EAAE,CAAA;YAEb,IAAI,CAAC,mBAAmB,IAAI,cAAc,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/F,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;gBACxC,IAAI,SAAS,EAAE,CAAC;oBACd,cAAc,EAAE,CAAA;oBAChB,UAAU,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;gBACvC,CAAC;YACH,CAAC;YAED,IAAI,WAAW,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,MAAM,IAAI,mBAAmB,CAAC,EAAE,CAAC;gBAClF,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC,CAAA;QAED,4KAA4K;QAC5K,MAAM,UAAU,GAAG,CAAC,KAAY,EAAE,YAAoB,EAAE,EAAE;YACxD,oDAAoD;YACpD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAA;YAC/B,WAAW,EAAE,CAAA;YAEb,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,aAAa,CAAA;YAC1D,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAA;YAC/D,SAAS,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;YACtE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAA;YAE/J,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5B,MAAM,oBAAoB,GAAG,IAAI,eAAe,EAAE,CAAA;YAClD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,EAAE,YAAY,CAAC,CAAA;YAE9E,MAAM,WAAW,GAAG,gBAAgB,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC5D,KAAK,gBAAgB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACzC,MAAM,EAAE,oBAAoB,CAAC,MAAM;gBACnC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9C,CAAC,EAAE;gBACF,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc,IAAI,KAAK;gBACjD,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC;gBAC5C,OAAO;gBACP,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;aAC7B,CAAC;iBACC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;gBAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;gBAEzC,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACrC,YAAY,CAAC,SAAS,CAAC,CAAA;oBACvB,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAA;oBACrD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;oBAC7O,KAAK,iBAAiB,CACpB,YAAY,EACZ,OAAO,EACP,KAAK,CAAC,MAAM,CAAC,IAAI,EACjB,WAAW,CAAC,SAAS,EACrB,UAAU,EACV,SAAS,EACT,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CACrC,CAAA;gBACH,CAAC;qBAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/C,YAAY,CAAC,SAAS,CAAC,CAAA;oBACvB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,uBAAuB,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAA;oBACpI,KAAK,iBAAiB,CACpB,YAAY,EACZ,OAAO,EACP,KAAK,CAAC,MAAM,CAAC,IAAI,EACjB,IAAI,YAAY,CAAC,SAAS,OAAO,oBAAoB,YAAY,IAAI,EAAE,YAAY,CAAC,EACpF,UAAU,EACV,IAAI,EACJ,YAAY,CACb,CAAA;gBACH,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,SAAS,CAAC,CAAA;oBACvB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;oBACpJ,MAAM,kBAAkB,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;gBAC7H,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,YAAY,CAAC,SAAS,CAAC,CAAA;gBACvB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;gBACzC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBACxK,KAAK,iBAAiB,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAA;YACrF,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;QACnC,CAAC,CAAA;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YACvB,IAAI,KAAK,EAAE,CAAC;gBACV,cAAc,GAAG,CAAC,GAAG,CAAC,CAAA;gBACtB,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/recipes/registry.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Fitness recipe registry
+ *
+ * Manages registration and lookup of fitness recipes (built-in and user-defined).
+ */
+import type { FitnessRecipe } from './types.js';
+/** Stub for user recipe loading (not ported to opensip-tools) */
+interface UserFitnessRecipesResult {
+    recipes: FitnessRecipe[];
+    warnings: string[];
+    loadedFrom?: string;
+}
+/** Options for constructing a FitnessRecipeRegistry */
+export interface FitnessRecipeRegistryOptions {
+    readonly basePath?: string;
+    readonly loadUserRecipes?: boolean;
+    readonly logWarnings?: boolean;
+    readonly logSummary?: boolean;
+}
+/** 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 {
+    private readonly byId;
+    private readonly byName;
+    private _userRecipesLoadResult;
+    private readonly _overriddenBuiltIns;
+    constructor(options?: FitnessRecipeRegistryOptions);
+    private registerBuiltInRecipes;
+    private loadAndRegisterUserRecipes;
+    /** Return the result of loading user-defined recipes, if attempted */
+    getUserRecipesLoadResult(): UserFitnessRecipesResult | undefined;
+    /** 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[];
+    /** Look up a recipe by name or ID */
+    loadRecipe(nameOrId: string): FitnessRecipe | undefined;
+    /** Retrieve a recipe by its name */
+    getByName(name: string): FitnessRecipe | undefined;
+    /** Retrieve a recipe by its ID */
+    getById(id: string): FitnessRecipe | undefined;
+    /** Check whether a recipe exists by name or ID */
+    has(nameOrId: string): boolean;
+    /** Return all registered recipes */
+    getAllRecipes(): readonly FitnessRecipe[];
+    /** Return all registered recipe names */
+    getNames(): readonly string[];
+    /** Return all recipes matching a given tag */
+    getByTag(tag: string): readonly FitnessRecipe[];
+    /** Number of registered recipes */
+    get size(): number;
+    /** Register a recipe. Throws if already registered unless allowOverwrite is true. */
+    register(recipe: FitnessRecipe, options?: {
+        allowOverwrite?: boolean;
+    }): void;
+    /** Register multiple recipes at once */
+    registerAll(recipes: readonly FitnessRecipe[], options?: {
+        allowOverwrite?: boolean;
+    }): void;
+    /** Remove a recipe by ID. Returns true if the recipe was found and removed. */
+    remove(id: string): boolean;
+    /** Remove all registered recipes */
+    clear(): void;
+    /** Clear all recipes and re-register built-in recipes */
+    reset(): void;
+    /** Return display-friendly info for all registered recipes */
+    listForDisplay(): readonly RecipeDisplayInfo[];
+}
+/** Shared singleton recipe registry with built-in recipes pre-loaded */
+export declare const defaultRecipeRegistry: FitnessRecipeRegistry;
+export {};
+//# 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":"AAGA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,iEAAiE;AACjE,UAAU,wBAAwB;IAChC,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC;AAED,8EAA8E;AAC9E,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,sBAAsB,CAAsC;IACpE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAoB;gBAE5C,OAAO,GAAE,4BAAiC;IAetD,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,0BAA0B;IASlC,sEAAsE;IACtE,wBAAwB,IAAI,wBAAwB,GAAG,SAAS;IAIhE,2EAA2E;IAC3E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,0EAA0E;IAC1E,qBAAqB,IAAI,SAAS,MAAM,EAAE;IAI1C,qCAAqC;IACrC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIvD,oCAAoC;IACpC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD,kCAAkC;IAClC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C,kDAAkD;IAClD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,oCAAoC;IACpC,aAAa,IAAI,SAAS,aAAa,EAAE;IAIzC,yCAAyC;IACzC,QAAQ,IAAI,SAAS,MAAM,EAAE;IAI7B,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE;IAI/C,mCAAmC;IACnC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAU7E,wCAAwC;IACxC,WAAW,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAM5F,+EAA+E;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ3B,oCAAoC;IACpC,KAAK,IAAI,IAAI;IAKb,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAKb,8DAA8D;IAC9D,cAAc,IAAI,SAAS,iBAAiB,EAAE;CAc/C;AAED,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,uBAAoD,CAAA"}

package/dist/recipes/registry.js

@@ -0,0 +1,131 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+// @fitness-ignore-file no-console-log -- User recipe warnings/summary output before CLI framework is initialized
+// @fitness-ignore-file logging-standards -- User recipe warnings/summary output before structured logger is available
+/**
+ * @fileoverview Fitness recipe registry
+ *
+ * Manages registration and lookup of fitness recipes (built-in and user-defined).
+ */
+import { ValidationError } from '@opensip-tools/core';
+import { builtInRecipes, isBuiltInRecipe } from './built-in-recipes.js';
+/** Registry for fitness recipes, loading built-in and user-defined recipes */
+export class FitnessRecipeRegistry {
+    byId = new Map();
+    byName = new Map();
+    _userRecipesLoadResult;
+    _overriddenBuiltIns = new Set();
+    constructor(options = {}) {
+        const { basePath, loadUserRecipes: shouldLoadUserRecipes = true, logWarnings = true, logSummary = false, } = options;
+        this.registerBuiltInRecipes();
+        if (shouldLoadUserRecipes) {
+            this.loadAndRegisterUserRecipes(basePath, logWarnings, logSummary);
+        }
+    }
+    registerBuiltInRecipes() {
+        for (const recipe of builtInRecipes) {
+            this.byId.set(recipe.id, recipe);
+            this.byName.set(recipe.name, recipe);
+        }
+    }
+    loadAndRegisterUserRecipes(_basePath, _logWarnings, _logSummary) {
+        // User recipe loading not ported to opensip-tools — stub
+        this._userRecipesLoadResult = { recipes: [], warnings: [] };
+    }
+    /** Return the result of loading user-defined recipes, if attempted */
+    getUserRecipesLoadResult() {
+        return this._userRecipesLoadResult;
+    }
+    /** 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];
+    }
+    /** Look up a recipe by name or ID */
+    loadRecipe(nameOrId) {
+        return this.byName.get(nameOrId) ?? this.byId.get(nameOrId);
+    }
+    /** Retrieve a recipe by its name */
+    getByName(name) {
+        return this.byName.get(name);
+    }
+    /** Retrieve a recipe by its ID */
+    getById(id) {
+        return this.byId.get(id);
+    }
+    /** Check whether a recipe exists by name or ID */
+    has(nameOrId) {
+        return this.byName.has(nameOrId) || this.byId.has(nameOrId);
+    }
+    /** Return all registered recipes */
+    getAllRecipes() {
+        return [...this.byId.values()];
+    }
+    /** Return all registered recipe names */
+    getNames() {
+        return [...this.byName.keys()];
+    }
+    /** Return all recipes matching a given tag */
+    getByTag(tag) {
+        return [...this.byId.values()].filter((r) => r.tags?.includes(tag));
+    }
+    /** Number of registered recipes */
+    get size() {
+        return this.byId.size;
+    }
+    /** Register a recipe. Throws if already registered unless allowOverwrite is true. */
+    register(recipe, options) {
+        const allowOverwrite = options?.allowOverwrite ?? false;
+        if (!allowOverwrite && (this.byId.has(recipe.id) || this.byName.has(recipe.name))) {
+            // @fitness-ignore-next-line result-pattern-consistency -- internal registration guard, throw is appropriate
+            throw new ValidationError(`Recipe '${recipe.name}' (${recipe.id}) already registered`, { code: 'VALIDATION.FITNESS.DUPLICATE_RECIPE' });
+        }
+        this.byId.set(recipe.id, recipe);
+        this.byName.set(recipe.name, recipe);
+    }
+    /** Register multiple recipes at once */
+    registerAll(recipes, options) {
+        for (const recipe of recipes) {
+            this.register(recipe, options);
+        }
+    }
+    /** Remove a recipe by ID. Returns true if the recipe was found and removed. */
+    remove(id) {
+        const recipe = this.byId.get(id);
+        if (!recipe)
+            return false;
+        this.byId.delete(id);
+        this.byName.delete(recipe.name);
+        return true;
+    }
+    /** Remove all registered recipes */
+    clear() {
+        this.byId.clear();
+        this.byName.clear();
+    }
+    /** 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.byId.values()].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),
+            };
+        });
+    }
+}
+/** Shared singleton recipe registry with built-in recipes pre-loaded */
+export const defaultRecipeRegistry = new FitnessRecipeRegistry({ logWarnings: false });
+//# 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":"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"}

package/dist/recipes/retry.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Retry logic for fitness check execution
+ *
+ * Provides exponential backoff retry wrapper for transient check failures.
+ */
+/** 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.
+ * 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":"AACA;;;;GAIG;AAMH,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAC7B;AAOD;;;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,CA6BzB"}