@opensip-cli/fitness 0.1.0

package/dist/recipes/service.js

@@ -0,0 +1,438 @@
+// @fitness-ignore-file file-length-limit -- Complex module with tightly coupled logic; splitting would fragment cohesive functionality
+// @fitness-ignore-file eslint-backend -- Fitness framework orchestrator; ESLint rule variations between fitness runner and IDE are expected
+// @fitness-ignore-file detached-promises -- clearParseCache is explicitly voided; surrounding sync calls (fileCache.clear, abort) are flagged by heuristic
+/**
+ * @fileoverview Central orchestrator for fitness recipe execution
+ *
+ * FitnessRecipeService resolves checks, manages session lifecycle,
+ * coordinates parallel/sequential execution, and builds results.
+ */
+import { passRate } from '@opensip-cli/contracts';
+import { logger, ConfigurationError, NotFoundError, SystemError, generateId, initParseCache, clearParseCache, RunScope, currentScope, runWithScope, } from '@opensip-cli/core';
+import { FileCache, DEFAULT_PREWARM_PATTERNS } from '../framework/file-cache.js';
+import { currentCheckRegistry, currentRecipeRegistry } from '../framework/scope-registry.js';
+import { setCurrentRecipeCheckConfig, clearCurrentRecipeCheckConfig } from './check-config.js';
+import { resolveChecks, validateCheckReferences } from './check-resolution.js';
+import { executeParallel, } from './parallel-execution.js';
+import { executeSequential } from './sequential-execution.js';
+import { DEFAULT_MAX_PARALLEL, } from './types.js';
+const MODULE_FITNESS_RECIPES = 'fitness:recipes';
+/** Default success threshold percentage when none is configured. */
+const DEFAULT_SUCCESS_THRESHOLD_PERCENT = 85;
+/**
+ * Compute prewarm glob patterns from the resolved checks' fileTypes.
+ * If any check is universal (no fileTypes), falls back to DEFAULT_PREWARM_PATTERNS.
+ */
+function computePrewarmPatterns(checks) {
+    const extensions = new Set();
+    for (const check of checks) {
+        const ft = check.config.fileTypes;
+        if (!ft || ft.length === 0) {
+            // Universal check — need all file types
+            return DEFAULT_PREWARM_PATTERNS;
+        }
+        for (const ext of ft) {
+            extensions.add(ext);
+        }
+    }
+    return [...extensions].sort().map((ext) => `**/*.${ext}`);
+}
+/**
+ * Central orchestrator for fitness check execution.
+ */
+export class FitnessRecipeService {
+    config;
+    checkRegistry;
+    recipeRegistry;
+    fileCache;
+    activeSession = null;
+    abortController;
+    constructor(config) {
+        this.config = config ?? {};
+        // Default to the current scope's registries (the production path: a fit
+        // run executes inside the pre-action-hook's RunScope). An explicit
+        // `checkRegistry`/`recipeRegistry` in config overrides — tests and
+        // programmatic callers can inject their own without a scope.
+        this.checkRegistry = config?.checkRegistry ?? currentCheckRegistry();
+        this.recipeRegistry = config?.recipeRegistry ?? currentRecipeRegistry();
+        // Per-service FileCache instance for SaaS concurrent RunScope isolation.
+        // Global singleton is for tests / non-service paths; each service gets its
+        // own so prewarm/clear in one run does not affect another.
+        this.fileCache = config?.fileCache ?? new FileCache();
+    }
+    get session() {
+        if (!this.activeSession) {
+            throw new SystemError('No active session', {
+                code: 'SYSTEM.FITNESS.NO_SESSION',
+            });
+        }
+        return this.activeSession;
+    }
+    /**
+     * 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.
+     */
+    // @fitness-ignore-next-line result-pattern-consistency -- return type is FitnessRecipeResult (not Result<T,E>); throw is appropriate for precondition failures
+    async start(recipeOrName) {
+        if (this.activeSession) {
+            throw new SystemError('Recipe execution already in progress', {
+                code: 'SYSTEM.FITNESS.SESSION_IN_PROGRESS',
+            });
+        }
+        const recipe = typeof recipeOrName === 'string' ? this.getRecipe(recipeOrName) : recipeOrName;
+        if (!recipe) {
+            const identifier = typeof recipeOrName === 'string' ? recipeOrName : recipeOrName.name;
+            // @fitness-ignore-next-line result-pattern-consistency -- internal method, exceptions propagate to CLI boundary
+            throw new NotFoundError(`Recipe not found: ${identifier}`, {
+                code: 'RESOURCE.NOT_FOUND.RECIPE',
+                metadata: { entity: 'recipe', identifier },
+            });
+        }
+        return this.executeRecipe(recipe);
+    }
+    async executeRecipe(recipe) {
+        // Two paths: if we're already inside a `runWithScope`, project the
+        // recipe-config slot onto the existing scope and run inline. Otherwise
+        // construct an ad-hoc scope and enter `runWithScope` so the dynamic
+        // extent of the recipe-execution body (including every check's
+        // `getCheckConfig(slug)` lookup) sees the recipe's per-check config.
+        const existing = currentScope();
+        if (existing) {
+            return this.executeRecipeInScope(recipe, existing);
+        }
+        // No ambient scope (programmatic / ad-hoc API use): construct one, but own
+        // its lifecycle — dispose() frees the per-run parseCache + recipe config so
+        // an ad-hoc execution does not leak per-run state (esp. in long-lived hosts).
+        const adhoc = new RunScope();
+        try {
+            return await runWithScope(adhoc, () => this.executeRecipeInScope(recipe, adhoc));
+        }
+        finally {
+            adhoc.dispose();
+        }
+    }
+    async executeRecipeInScope(recipe, recipeScope) {
+        const sessionId = this.generateSessionId();
+        this.activeSession = this.createSession(sessionId, recipe);
+        this.abortController = new AbortController();
+        logger.info('Starting recipe session', {
+            evt: 'fitness.recipe.session.start',
+            module: MODULE_FITNESS_RECIPES,
+            sessionId,
+            recipeName: recipe.name,
+        });
+        // Run-level lifecycle event on the per-run DiagnosticsBus (north-star §5.10).
+        // The host emits COMMAND-level lifecycle; only the recipe engine knows its
+        // INTERNAL lifecycle (which recipe ran, how many checks passed/failed), so the
+        // fit run contributes `start`/`complete` events here. Emitted before any early
+        // return (e.g. an empty recipe) so every run surfaces at least one event on
+        // the `--json` CommandOutcome via `scope.diagnostics.snapshot()`.
+        recipeScope.diagnostics.event('execute', 'debug', 'recipe session started', {
+            recipe: recipe.name,
+        });
+        // Project the recipe's per-check config into the current scope's
+        // recipe-config slot so individual checks can read their slice via
+        // getCheckConfig<T>(slug). Cleared in the `finally` below.
+        setCurrentRecipeCheckConfig(recipeScope, recipe.checks.config);
+        try {
+            const cwd = this.config.cwd ?? process.cwd();
+            const checks = this.resolveAndFilterChecks(recipe);
+            this.activeSession.totalChecks = checks.length;
+            if (checks.length === 0) {
+                return this.buildResult();
+            }
+            await this.prepareExecution(checks, cwd);
+            // Execute
+            const execOpts = {
+                checks,
+                cwd,
+                recipe,
+                checkTargetFiles: this.config.checkTargetFiles,
+                ...(this.config.globalExcludes ? { globalExcludes: this.config.globalExcludes } : {}),
+                fileCache: this.fileCache,
+            };
+            const execCtx = {
+                session: this.activeSession,
+                callbacks: this.callbacks,
+                abortController: this.abortController,
+                includeViolations: this.config.includeViolations ?? false,
+            };
+            // Deliberate two-mode dispatch (see audit 2026-05-23 F5): when a
+            // 3rd mode lands, tabularize. Both executors share the exact
+            // `(ctx, opts) =>
+            // Promise<void>` shape, so the moment a third mode (e.g.
+            // 'staged' for incremental fit, 'isolated' for sandbox-per-check)
+            // is added, swap this ternary for a `Map<ExecutionMode, Executor>`
+            // lookup and let the compiler enforce exhaustiveness. The
+            // two-mode ternary is small enough that the table is premature
+            // today (audit 2026-05-23 F5).
+            await (recipe.execution.mode === 'parallel'
+                ? executeParallel(execCtx, execOpts)
+                : executeSequential(execCtx, execOpts));
+            this.activeSession.directives = this.collectAppliedDirectives();
+            this.activeSession.status = 'completed';
+            const result = this.buildResult();
+            logger.info('Recipe session completed', {
+                evt: 'fitness.recipe.session.complete',
+                module: MODULE_FITNESS_RECIPES,
+                sessionId,
+                recipeName: recipe.name,
+                passed: result.summary.passedChecks,
+                failed: result.summary.failedChecks,
+                durationMs: result.durationMs,
+            });
+            recipeScope.diagnostics.event('execute', 'debug', 'recipe session completed', {
+                recipe: recipe.name,
+                passed: result.summary.passedChecks,
+                failed: result.summary.failedChecks,
+            });
+            void this.callbacks.onComplete?.(result);
+            return result;
+        }
+        catch (error) {
+            logger.error('Recipe session failed', {
+                evt: 'fitness.recipe.session.error',
+                module: MODULE_FITNESS_RECIPES,
+                sessionId,
+                recipeName: recipe.name,
+                err: error instanceof Error ? error : undefined,
+            });
+            if (this.activeSession) {
+                this.activeSession.status = 'failed';
+            }
+            throw error;
+        }
+        finally {
+            clearCurrentRecipeCheckConfig(recipeScope);
+            void clearParseCache();
+            this.fileCache.clear();
+            this.abortController?.abort();
+            delete this.abortController;
+            this.activeSession = null;
+        }
+    }
+    collectAppliedDirectives() {
+        const result = [];
+        const session = this.activeSession;
+        if (!session)
+            return result;
+        for (const cr of session.checkResults) {
+            if (cr.appliedDirectives) {
+                for (const directive of cr.appliedDirectives) {
+                    result.push(directive);
+                }
+            }
+        }
+        return result;
+    }
+    createSession(sessionId, recipe) {
+        return {
+            sessionId,
+            recipe,
+            startedAt: new Date(),
+            status: 'running',
+            totalChecks: 0,
+            completedChecks: 0,
+            passedChecks: 0,
+            failedChecks: 0,
+            totalErrors: 0,
+            totalWarnings: 0,
+            totalIgnored: 0,
+            ignoresByTag: new Map(),
+            checkResults: [],
+            directives: [],
+        };
+    }
+    resolveAndFilterChecks(recipe) {
+        const checkSlugs = resolveChecks(recipe.checks, this.checkRegistry);
+        let missingExplicitChecks = [];
+        // Validate explicit references
+        if (recipe.checks.type === 'explicit') {
+            const allSlugs = this.checkRegistry.listSlugs();
+            const { missing } = validateCheckReferences(recipe.checks.checkIds, [...allSlugs]);
+            missingExplicitChecks = missing;
+            if (missing.length > 0) {
+                logger.warn(`Recipe references ${missing.length} unknown check(s)`, {
+                    evt: 'fitness.recipe.checks.missing',
+                    module: MODULE_FITNESS_RECIPES,
+                    missing,
+                    recipeName: recipe.name,
+                });
+            }
+        }
+        const configDisabled = new Set(this.config.disabledChecks);
+        const includeDisabledSet = new Set(recipe.includeDisabled);
+        const checks = [];
+        // Warn about unknown slugs in disabledChecks config
+        if (configDisabled.size > 0) {
+            const allSlugs = new Set(this.checkRegistry.listSlugs());
+            const unknownDisabled = [...configDisabled].filter((s) => !allSlugs.has(s));
+            if (unknownDisabled.length > 0) {
+                logger.warn(`disabledChecks references ${unknownDisabled.length} unknown slug(s)`, {
+                    evt: 'fitness.recipe.disabled.unknown',
+                    module: MODULE_FITNESS_RECIPES,
+                    unknownDisabled,
+                });
+            }
+        }
+        for (const slug of checkSlugs) {
+            const check = this.checkRegistry.getBySlug(slug);
+            if (!check)
+                continue;
+            const bareSlug = slug.includes(':') ? slug.split(':').pop() : slug;
+            const isDisabled = (check.config.disabled ?? false) ||
+                configDisabled.has(slug) ||
+                configDisabled.has(bareSlug);
+            const isForceIncluded = includeDisabledSet.has(slug) || includeDisabledSet.has(bareSlug);
+            if (!isDisabled || isForceIncluded) {
+                checks.push(check);
+            }
+        }
+        if (recipe.name === 'cli-adhoc' && recipe.checks.type === 'explicit' && checks.length === 0) {
+            const requested = missingExplicitChecks[0] ?? recipe.checks.checkIds[0] ?? '(unknown)';
+            throw new ConfigurationError(`Unknown check '${requested}'.`, {
+                code: 'CONFIG.UNKNOWN_CHECK',
+                metadata: { check: requested },
+            });
+        }
+        return checks;
+    }
+    async prepareExecution(checks, cwd) {
+        // Sync check catalog for dashboard visibility
+        if (this.callbacks.onCatalogSync) {
+            const entries = this.checkRegistry.list().map((c) => ({
+                id: c.config.id,
+                slug: c.config.slug,
+                tags: c.config.tags,
+                description: c.config.description,
+            }));
+            void this.callbacks.onCatalogSync(entries);
+        }
+        // Prewarm file cache with only the extensions needed by resolved checks
+        if (this.config.prewarmCache !== false) {
+            const patterns = this.config.prewarmPatterns ?? computePrewarmPatterns(checks);
+            await this.fileCache.prewarm(cwd, patterns);
+        }
+        // Initialize shared AST parse cache for cross-check deduplication
+        void initParseCache();
+    }
+    buildResult() {
+        const session = this.session;
+        const completedAt = new Date();
+        const summary = {
+            totalChecks: session.totalChecks,
+            passedChecks: session.passedChecks,
+            failedChecks: session.failedChecks,
+            skippedChecks: session.totalChecks - session.completedChecks,
+            erroredChecks: session.checkResults.filter((r) => r.error !== undefined).length,
+            totalViolations: session.checkResults.reduce((sum, r) => sum + r.violationCount, 0),
+            totalErrors: session.totalErrors,
+            totalWarnings: session.totalWarnings,
+            totalIgnored: session.totalIgnored,
+        };
+        const score = passRate({
+            total: session.totalChecks,
+            passed: session.passedChecks,
+        });
+        const result = {
+            recipeId: session.recipe.id,
+            recipeName: session.recipe.name,
+            sessionId: session.sessionId,
+            success: score >= (session.recipe.execution.successThreshold ?? DEFAULT_SUCCESS_THRESHOLD_PERCENT) &&
+                session.status === 'completed',
+            startedAt: session.startedAt,
+            completedAt,
+            durationMs: completedAt.getTime() - session.startedAt.getTime(),
+            checkResults: session.checkResults,
+            summary,
+        };
+        return {
+            ...result,
+            ...(session.ignoreCounts ? { ignoreCounts: session.ignoreCounts } : {}),
+            ...(session.directives.length > 0 ? { directives: session.directives } : {}),
+        };
+    }
+    /**
+     * Convert CLI arguments to an ad-hoc FitnessRecipe.
+     */
+    static createAdHocRecipe(args) {
+        let checks;
+        let includeDisabled;
+        if (args.check) {
+            if (args.check.includes('*') || args.check.includes('?')) {
+                checks = { type: 'pattern', include: [args.check] };
+            }
+            else {
+                checks = { type: 'explicit', checkIds: [args.check] };
+                includeDisabled = [args.check];
+            }
+        }
+        else if (args.tagFilters?.length) {
+            checks = { type: 'tags', include: args.tagFilters };
+        }
+        else {
+            checks = { type: 'all', exclude: [] };
+        }
+        return {
+            id: 'RCP_cli-adhoc',
+            name: 'cli-adhoc',
+            displayName: 'CLI Ad-Hoc',
+            description: 'Dynamically created recipe from CLI arguments',
+            checks,
+            execution: {
+                mode: args.parallel === false ? 'sequential' : 'parallel',
+                stopOnFirstFailure: false,
+                timeout: args.timeout ?? 30_000,
+                maxParallel: args.maxParallel ?? DEFAULT_MAX_PARALLEL,
+                retryOnFailure: args.retry,
+                maxRetries: args.maxRetries ?? 2,
+                successThreshold: args.successThreshold,
+            },
+            reporting: {
+                format: (() => {
+                    if (!args.json)
+                        return 'table';
+                    return args.unified ? 'unified' : 'json';
+                })(),
+                verbose: args.verbose ?? false,
+            },
+            ...(includeDisabled ? { includeDisabled } : {}),
+            ...(args.file ? { fileFilter: args.file } : {}),
+        };
+    }
+    /** Get the currently active session, or null if no recipe is running. */
+    getActiveSession() {
+        return this.activeSession;
+    }
+    /** Abort the currently running recipe execution. No-op if no session is active. */
+    abort() {
+        this.abortController?.abort();
+    }
+    /** List all available recipes from the recipe registry. */
+    listRecipes() {
+        return this.recipeRegistry.getAllRecipes();
+    }
+    /**
+     * 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) {
+        return this.recipeRegistry.loadRecipe(nameOrId);
+    }
+    generateSessionId() {
+        return generateId('SES');
+    }
+    get callbacks() {
+        return this.config.callbacks ?? {};
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/recipes/service.js.map

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

package/dist/recipes/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview Core types for fitness recipes
+ *
+ * Defines FitnessRecipe, CheckSelector, RecipeCheckResult, and related
+ * types used throughout the recipe execution system.
+ */
+import type { DirectiveEntry } from '../framework/directive-inventory.js';
+import type { RecipeUnitConfigMap } from '@opensip-cli/core';
+/**
+ * Per-check configuration map.
+ *
+ * Keys are check slugs; values are check-specific config objects whose shape
+ * is declared by the consuming check. The recipe service projects this map
+ * into module-level state before execution so each check can read its slice
+ * via `getCheckConfig<T>(slug)`. See `check-config.ts`.
+ */
+export type RecipeCheckConfigMap = RecipeUnitConfigMap;
+/** Selector that specifies checks by explicit slug list */
+interface ExplicitCheckSelector {
+    readonly type: 'explicit';
+    readonly checkIds: readonly string[];
+    readonly config?: RecipeCheckConfigMap;
+}
+/** Selector that matches checks via glob patterns */
+interface PatternCheckSelector {
+    readonly type: 'pattern';
+    readonly include: readonly string[];
+    readonly exclude?: readonly string[];
+    readonly config?: RecipeCheckConfigMap;
+}
+/** Selector that includes all checks with specified tags */
+interface TagsCheckSelector {
+    readonly type: 'tags';
+    readonly include: readonly string[];
+    readonly exclude?: readonly string[];
+    readonly config?: RecipeCheckConfigMap;
+}
+/** Selector that includes all checks with optional exclusions */
+interface AllCheckSelector {
+    readonly type: 'all';
+    readonly exclude?: readonly string[];
+    readonly config?: RecipeCheckConfigMap;
+}
+/** Union of all check selector types used by recipes */
+export type CheckSelector = ExplicitCheckSelector | PatternCheckSelector | TagsCheckSelector | AllCheckSelector;
+/** Execution configuration for a fitness recipe */
+interface FitnessExecutionOptions {
+    readonly mode: 'parallel' | 'sequential';
+    readonly stopOnFirstFailure: boolean;
+    readonly timeout?: number;
+    readonly maxParallel?: number;
+    readonly retryOnFailure?: boolean;
+    readonly maxRetries?: number;
+    readonly successThreshold?: number;
+}
+/** Reporting output configuration for a fitness recipe */
+interface FitnessReportingOptions {
+    readonly format: 'table' | 'json' | 'unified';
+    readonly verbose: boolean;
+    readonly outputPath?: string;
+}
+/** Complete recipe definition: checks, execution, and reporting */
+export interface FitnessRecipe {
+    readonly id: string;
+    readonly name: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly checks: CheckSelector;
+    readonly execution: FitnessExecutionOptions;
+    readonly reporting: FitnessReportingOptions;
+    readonly tags?: readonly string[];
+    readonly includeDisabled?: readonly string[];
+    readonly fileFilter?: string;
+}
+/** A single violation detail from a fitness check. */
+interface RecipeViolation {
+    readonly file: string;
+    readonly line: number;
+    readonly column?: number;
+    readonly message: string;
+    readonly severity: 'error' | 'warning';
+    readonly suggestion?: string;
+}
+/** Result of a single check within a recipe execution */
+export interface RecipeCheckResult {
+    readonly checkId: string;
+    readonly checkSlug: string;
+    readonly passed: boolean;
+    readonly violationCount: number;
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly ignoredCount: number;
+    readonly durationMs: number;
+    readonly totalItems?: number | undefined;
+    readonly itemType?: string | undefined;
+    readonly skipped: boolean;
+    readonly skipReason?: string;
+    readonly error?: string;
+    readonly timedOut?: boolean;
+    appliedDirectives?: readonly DirectiveEntry[] | undefined;
+    /** Violation details. Populated when includeViolations is true. */
+    readonly violations?: readonly RecipeViolation[];
+}
+/** Aggregated summary of a complete recipe run */
+export interface RecipeRunSummary {
+    readonly totalChecks: number;
+    readonly passedChecks: number;
+    readonly failedChecks: number;
+    readonly skippedChecks: number;
+    readonly erroredChecks: number;
+    readonly totalViolations: number;
+    readonly totalErrors: number;
+    readonly totalWarnings: number;
+    readonly totalIgnored: number;
+}
+/** Ignore directive counts by type. */
+export interface IgnoresByType {
+    file: number;
+    line: number;
+    block: number;
+    total: number;
+}
+/** Complete result of a recipe execution including all check results and summary */
+export interface FitnessRecipeResult {
+    readonly recipeId: string;
+    readonly recipeName: string;
+    readonly sessionId: string;
+    readonly success: boolean;
+    readonly startedAt: Date;
+    readonly completedAt: Date;
+    readonly durationMs: number;
+    readonly checkResults: readonly RecipeCheckResult[];
+    readonly summary: RecipeRunSummary;
+    readonly ignoreCounts?: IgnoresByType | undefined;
+    readonly directives?: readonly DirectiveEntry[] | undefined;
+}
+/** Input definition used by defineRecipe() to create a FitnessRecipe */
+export interface FitnessRecipeDefinition {
+    readonly name: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly checks: CheckSelector;
+    readonly execution?: Partial<FitnessExecutionOptions>;
+    readonly reporting?: Partial<FitnessReportingOptions>;
+    readonly tags?: readonly string[];
+    readonly includeDisabled?: readonly string[];
+}
+/** Default maximum parallelism based on available CPU cores */
+export declare const DEFAULT_MAX_PARALLEL: number;
+/** Return the effective max parallelism for a recipe, falling back to the system default */
+export declare function getEffectiveMaxParallel(recipe: FitnessRecipe): number;
+/** Create a frozen FitnessRecipe from a definition, applying defaults for missing options */
+export declare function defineRecipe(definition: FitnessRecipeDefinition): FitnessRecipe;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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