@opensip-tools/fitness 1.0.4

package/dist/recipes/retry.js

@@ -0,0 +1,44 @@
+// @fitness-ignore-file error-handling-suite -- catch blocks delegate errors through established patterns
+/**
+ * @fileoverview Retry logic for fitness check execution
+ *
+ * Provides exponential backoff retry wrapper for transient check failures.
+ */
+import { CheckAbortedError } from '../framework/execution-context.js';
+const BACKOFF_DELAYS_MS = [1000, 2000];
+function backoff(attempt) {
+    const delay = BACKOFF_DELAYS_MS[attempt] ?? BACKOFF_DELAYS_MS.at(-1) ?? 2000;
+    return new Promise((resolve) => setTimeout(resolve, delay));
+}
+/**
+ * Execute a function with retry logic.
+ * Only retries when the function throws. CheckAbortedError is never retried.
+ */
+export async function executeWithRetry(fn, options) {
+    try {
+        const result = await fn();
+        return { result, lastError: undefined, retryCount: 0, wasRetried: false };
+    }
+    catch (firstError) {
+        if (firstError instanceof CheckAbortedError) {
+            return { result: undefined, lastError: firstError, retryCount: 0, wasRetried: false };
+        }
+        if (!options.enabled || options.maxRetries <= 0) {
+            return { result: undefined, lastError: firstError, retryCount: 0, wasRetried: false };
+        }
+        let lastError = firstError;
+        for (let attempt = 0; attempt < options.maxRetries; attempt++) {
+            // @fitness-ignore-next-line performance-anti-patterns -- sequential retry with backoff is inherently serial
+            await backoff(attempt);
+            try {
+                const result = await fn();
+                return { result, lastError: undefined, retryCount: attempt + 1, wasRetried: true };
+            }
+            catch (retryError) {
+                lastError = retryError;
+            }
+        }
+        return { result: undefined, lastError, retryCount: options.maxRetries, wasRetried: true };
+    }
+}
+//# 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,yGAAyG;AACzG;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAErE,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAA;AAkB/C,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAoB,EACpB,OAAqB;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAA;QACzB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IAC3E,CAAC;IAAC,OAAO,UAAU,EAAE,CAAC;QACpB,IAAI,UAAU,YAAY,iBAAiB,EAAE,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;QACvF,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;QACvF,CAAC;QAED,IAAI,SAAS,GAAY,UAAU,CAAA;QAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC9D,4GAA4G;YAC5G,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;YAEtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAA;gBACzB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;YACpF,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,SAAS,GAAG,UAAU,CAAA;YACxB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;IAC3F,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Sequential execution engine for fitness recipe checks
+ *
+ * Runs fitness checks one at a time with per-check timeouts,
+ * abort support, and retry logic.
+ */
+import type { ExecutionOptions, ExecutionServiceContext } from './parallel-execution.js';
+/** Execute fitness checks sequentially with per-check timeouts and retry support */
+export declare function executeSequential(ctx: ExecutionServiceContext, opts: ExecutionOptions): Promise<void>;
+//# sourceMappingURL=sequential-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-execution.d.ts","sourceRoot":"","sources":["../../src/recipes/sequential-execution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAMxF,oFAAoF;AAEpF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgH3G"}

package/dist/recipes/sequential-execution.js

@@ -0,0 +1,122 @@
+/**
+ * @fileoverview Sequential execution engine for fitness recipe checks
+ *
+ * Runs fitness checks one at a time with per-check timeouts,
+ * abort support, and retry logic.
+ */
+import { TimeoutError } from '@opensip-tools/core';
+import { memoryProfiler } from '../framework/memory-profiler.js';
+import { processSuccessResult, processErrorResult, } from './check-result-processor.js';
+import { executeWithRetry } from './retry.js';
+// =============================================================================
+// SEQUENTIAL EXECUTION
+// =============================================================================
+/** Execute fitness checks sequentially with per-check timeouts and retry support */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- Inherent complexity: sequential check execution with per-check timeouts, abort signal handling, file matching, error recovery, and progress callbacks
+export async function executeSequential(ctx, opts) {
+    const { checks, cwd, recipe, checkTargetFiles, globalExcludes } = opts;
+    const { session, callbacks, abortController } = ctx;
+    const recipeTimeout = recipe.execution.timeout ?? 30_000;
+    const totalChecks = checks.length;
+    const processorCtx = { session, callbacks, recipe, includeViolations: ctx.includeViolations ?? false };
+    // @fitness-ignore-next-line file-length-limits -- Sequential check execution loop: orchestrates check lifecycle (start, run, retry, complete) callbacks
+    for (const [i, check] of checks.entries()) {
+        if (abortController?.signal.aborted)
+            break;
+        if (!check)
+            continue;
+        const checkId = check.config.id;
+        const checkSlug = check.config.slug;
+        const timeout = check.config.timeout ?? recipeTimeout;
+        void callbacks.onCheckStart?.(checkSlug, i + 1, totalChecks);
+        const checkAbortController = new AbortController();
+        const memoryBeforeMB = memoryProfiler.recordCheckStart();
+        const startTime = Date.now();
+        let timedOut = false;
+        const timeoutId = setTimeout(() => {
+            timedOut = true;
+            checkAbortController.abort();
+        }, timeout);
+        try {
+            const retryResult = await executeWithRetry(() => {
+                const targetFiles = checkTargetFiles?.get(check.config.slug);
+                return check.run(cwd, {
+                    signal: checkAbortController.signal,
+                    ...(targetFiles ? { targetFiles } : {}),
+                    ...(globalExcludes ? { globalExcludes } : {}),
+                });
+            }, {
+                enabled: recipe.execution.retryOnFailure ?? false,
+                maxRetries: recipe.execution.maxRetries ?? 2,
+                checkId,
+                checkSlug,
+            });
+            clearTimeout(timeoutId);
+            if (checkAbortController.signal.aborted) {
+                const durationMs = Date.now() - startTime;
+                const output = processErrorResult(processorCtx, {
+                    checkId,
+                    checkSlug,
+                    checkIndex: i + 1,
+                    totalChecks,
+                    error: new TimeoutError(`Check ${checkId} timed out after ${timeout}ms`, timeout),
+                    durationMs,
+                    memoryBeforeMB,
+                    timedOut: true,
+                    timeoutMs: timeout,
+                });
+                if (output.shouldStop)
+                    break;
+                continue;
+            }
+            if (retryResult.result === undefined) {
+                const durationMs = Date.now() - startTime;
+                const output = processErrorResult(processorCtx, {
+                    checkId,
+                    checkSlug,
+                    checkIndex: i + 1,
+                    totalChecks,
+                    error: retryResult.lastError,
+                    durationMs,
+                    memoryBeforeMB,
+                    timedOut: false,
+                });
+                if (output.shouldStop)
+                    break;
+                continue;
+            }
+            const durationMs = Date.now() - startTime;
+            const output = processSuccessResult(processorCtx, {
+                checkId,
+                checkSlug,
+                tags: check.config.tags ?? [],
+                checkIndex: i + 1,
+                totalChecks,
+                result: retryResult.result,
+                durationMs,
+                memoryBeforeMB,
+            });
+            if (output.shouldStop)
+                break;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            const durationMs = Date.now() - startTime;
+            const isTimeout = timedOut || checkAbortController.signal.aborted;
+            const output = processErrorResult(processorCtx, {
+                checkId,
+                checkSlug,
+                checkIndex: i + 1,
+                totalChecks,
+                error,
+                durationMs,
+                memoryBeforeMB,
+                timedOut: isTimeout,
+                ...(isTimeout ? { timeoutMs: timeout } : {}),
+            });
+            if (output.shouldStop)
+                break;
+        }
+    }
+}
+//# sourceMappingURL=sequential-execution.js.map

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

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

package/dist/recipes/service-types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Service-layer type definitions for fitness recipe execution
+ *
+ * Defines the configuration, session state, and callback types
+ * used by FitnessRecipeService and its execution engines.
+ */
+import type { FitnessRecipeRegistry } from './registry.js';
+import type { FitnessRecipe, FitnessRecipeResult, RecipeCheckResult, IgnoresByType } from './types.js';
+import type { DirectiveEntry } from '../framework/directive-inventory.js';
+import type { CheckMemoryProfile } from '../framework/memory-profiler.js';
+import type { CheckRegistry } from '../framework/registry.js';
+/** Summary of a single check execution for callback reporting */
+export interface CheckSummary {
+    readonly checkId: string;
+    readonly checkSlug: string;
+    readonly passed: boolean;
+    readonly errors: number;
+    readonly warnings: number;
+    readonly durationMs: number;
+    readonly filesScanned: number;
+    readonly ignoredCount: number;
+    readonly memoryProfile: CheckMemoryProfile;
+    readonly timedOut?: boolean;
+    readonly errorMessage?: string;
+}
+/** Callbacks invoked during recipe execution for progress and errors */
+export interface FitnessRecipeServiceCallbacks {
+    onCheckStart?: (checkSlug: string, index: number, total: number) => void;
+    onCheckComplete?: (checkSlug: string, summary: CheckSummary, index: number, total: number) => void;
+    onError?: (checkSlug: string, error: Error) => void;
+    onMemoryWarning?: (checkId: string, profile: CheckMemoryProfile) => void;
+    onComplete?: (result: FitnessRecipeResult) => void;
+    /** Called before execution with all registered checks for catalog sync. */
+    onCatalogSync?: (entries: {
+        id: string;
+        slug: string;
+        tags: readonly string[];
+        description: string;
+    }[]) => void;
+}
+/** Configuration for the fitness recipe service */
+export interface FitnessRecipeServiceConfig {
+    cwd?: string;
+    prewarmCache?: boolean;
+    prewarmPatterns?: string[];
+    callbacks?: FitnessRecipeServiceCallbacks;
+    /** Per-check pre-resolved file paths from target overrides. Map of check slug → absolute file paths. */
+    checkTargetFiles?: ReadonlyMap<string, readonly string[]>;
+    /** Optional check registry (defaults to defaultRegistry). */
+    checkRegistry?: CheckRegistry;
+    /** Optional recipe registry (defaults to defaultRecipeRegistry). */
+    recipeRegistry?: FitnessRecipeRegistry;
+    /** Check slugs disabled via opensip.config.yml — these checks are skipped unless force-included by a recipe. */
+    disabledChecks?: readonly string[];
+    /** When true, carry violation details on RecipeCheckResult. */
+    includeViolations?: boolean;
+    /**
+     * Run-wide file exclusion patterns from `opensip-tools.config.yml`'s
+     * top-level `globalExcludes`. Threaded into each check's RunOptions
+     * so the matchFiles() fallback honors them — without this, scope-empty
+     * checks scan every prewarmed file. Should be the same array passed
+     * to `loadTargetsConfig`.
+     */
+    globalExcludes?: readonly string[];
+}
+/** Mutable session state tracking progress during a recipe execution */
+export interface FitnessRecipeSession {
+    readonly sessionId: string;
+    readonly recipe: FitnessRecipe;
+    readonly startedAt: Date;
+    status: 'running' | 'completed' | 'failed';
+    totalChecks: number;
+    completedChecks: number;
+    passedChecks: number;
+    failedChecks: number;
+    totalErrors: number;
+    totalWarnings: number;
+    totalIgnored: number;
+    ignoresByTag: Map<string, number>;
+    checkResults: RecipeCheckResult[];
+    ignoreCounts?: IgnoresByType | undefined;
+    directives: DirectiveEntry[];
+}
+//# sourceMappingURL=service-types.d.ts.map

package/dist/recipes/service-types.d.ts.map

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

package/dist/recipes/service-types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Service-layer type definitions for fitness recipe execution
+ *
+ * Defines the configuration, session state, and callback types
+ * used by FitnessRecipeService and its execution engines.
+ */
+export {};
+//# sourceMappingURL=service-types.js.map

package/dist/recipes/service-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-types.js","sourceRoot":"","sources":["../../src/recipes/service-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/recipes/service.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Central orchestrator for fitness recipe execution
+ *
+ * FitnessRecipeService resolves checks, manages session lifecycle,
+ * coordinates parallel/sequential execution, and builds results.
+ */
+import { type FitnessRecipe, type FitnessRecipeResult } from './types.js';
+import type { FitnessRecipeServiceCallbacks, FitnessRecipeServiceConfig, FitnessRecipeSession } from './service-types.js';
+/**
+ * Central orchestrator for fitness check execution.
+ */
+export declare class FitnessRecipeService {
+    private readonly config;
+    private readonly checkRegistry;
+    private readonly recipeRegistry;
+    private activeSession;
+    private abortController?;
+    constructor(config?: FitnessRecipeServiceConfig);
+    private get session();
+    /**
+     * Execute a fitness recipe by name or recipe object.
+     *
+     * Resolves checks, prewarms the file cache, runs checks in parallel or sequential mode,
+     * then builds and returns a {@link FitnessRecipeResult}. Only one session can be active
+     * at a time — call {@link abort} to cancel a running session.
+     *
+     * @param recipeOrName - A recipe name (looked up in the recipe registry) or a FitnessRecipe object.
+     * @returns The result of the recipe execution including per-check results and summary.
+     * @throws {SystemError} If a session is already in progress.
+     * @throws {NotFoundError} If the recipe name is not found in the registry.
+     */
+    start(recipeOrName: FitnessRecipe | string): Promise<FitnessRecipeResult>;
+    private executeRecipe;
+    private collectAppliedDirectives;
+    private createSession;
+    private resolveAndFilterChecks;
+    private prepareExecution;
+    private buildResult;
+    /**
+     * Convert CLI arguments to an ad-hoc FitnessRecipe.
+     */
+    static createAdHocRecipe(args: {
+        check?: string;
+        tagFilters?: string[];
+        file?: string;
+        parallel?: boolean;
+        json?: boolean;
+        unified?: boolean;
+        verbose?: boolean;
+        retry?: boolean;
+        maxRetries?: number;
+        maxParallel?: number;
+        timeout?: number;
+        successThreshold?: number;
+    }): FitnessRecipe;
+    /** Get the currently active session, or null if no recipe is running. */
+    getActiveSession(): FitnessRecipeSession | null;
+    /** Abort the currently running recipe execution. No-op if no session is active. */
+    abort(): void;
+    /** List all available recipes from the recipe registry. */
+    listRecipes(): readonly FitnessRecipe[];
+    /**
+     * Look up a recipe by name or ID.
+     * @param nameOrId - The recipe name or full recipe ID (e.g. "default" or "RCP_default").
+     * @returns The recipe if found, undefined otherwise.
+     */
+    getRecipe(nameOrId: string): FitnessRecipe | undefined;
+    protected generateSessionId(): string;
+    protected get callbacks(): FitnessRecipeServiceCallbacks;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/recipes/service.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAYH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,oBAAoB,CAAA;AA2B3B;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,eAAe,CAAC,CAAiB;gBAE7B,MAAM,CAAC,EAAE,0BAA0B;IAM/C,OAAO,KAAK,OAAO,GAKlB;IAED;;;;;;;;;;;OAWG;IAEG,KAAK,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAgBjE,aAAa;IAkE3B,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,sBAAsB;YAuChB,gBAAgB;IAsB9B,OAAO,CAAC,WAAW;IAqCnB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;QACrB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,GAAG,aAAa;IA4CjB,yEAAyE;IACzE,gBAAgB,IAAI,oBAAoB,GAAG,IAAI;IAI/C,mFAAmF;IACnF,KAAK,IAAI,IAAI;IAIb,2DAA2D;IAC3D,WAAW,IAAI,SAAS,aAAa,EAAE;IAIvC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,SAAS,KAAK,SAAS,IAAI,6BAA6B,CAEvD;CACF"}