@opensip-tools/fitness 1.0.4

package/dist/recipes/service.js

@@ -0,0 +1,331 @@
+// @fitness-ignore-file file-length-limits -- 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
+/**
+ * @fileoverview Central orchestrator for fitness recipe execution
+ *
+ * FitnessRecipeService resolves checks, manages session lifecycle,
+ * coordinates parallel/sequential execution, and builds results.
+ */
+import { logger, NotFoundError, SystemError, generateId, initParseCache, clearParseCache } from '@opensip-tools/core';
+import { fileCache, DEFAULT_PREWARM_PATTERNS } from '../framework/file-cache.js';
+import { defaultRegistry } from '../framework/registry.js';
+import { setCurrentRecipeCheckConfig, clearCurrentRecipeCheckConfig } from './check-config.js';
+import { resolveChecks, validateCheckReferences } from './check-resolution.js';
+import { executeParallel } from './parallel-execution.js';
+import { defaultRecipeRegistry } from './registry.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;
+    activeSession = null;
+    abortController;
+    constructor(config) {
+        this.config = config ?? {};
+        this.checkRegistry = config?.checkRegistry ?? defaultRegistry;
+        this.recipeRegistry = config?.recipeRegistry ?? defaultRecipeRegistry;
+    }
+    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) {
+        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 });
+        // Project the recipe's per-check config into module-level state so that
+        // individual checks can read their slice via getCheckConfig<T>(slug).
+        // Cleared in the `finally` below.
+        setCurrentRecipeCheckConfig(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 } : {}),
+            };
+            const execCtx = {
+                session: this.activeSession,
+                callbacks: this.callbacks,
+                abortController: this.abortController,
+                includeViolations: this.config.includeViolations ?? false,
+            };
+            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 });
+            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();
+            void clearParseCache();
+            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);
+        // Validate explicit references
+        if (recipe.checks.type === 'explicit') {
+            const allSlugs = this.checkRegistry.listSlugs();
+            const { missing } = validateCheckReferences(recipe.checks.checkIds, [...allSlugs]);
+            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);
+            }
+        }
+        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 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 = session.totalChecks > 0 ? Math.round((session.passedChecks / session.totalChecks) * 100) : 100;
+        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,154 @@
+/**
+ * @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';
+/**
+ * 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 = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+/** 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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"}

package/dist/recipes/types.js

@@ -0,0 +1,54 @@
+// @fitness-ignore-file module-coupling-metrics -- type definition module: exports are related interfaces/types for the recipe execution domain
+/**
+ * @fileoverview Core types for fitness recipes
+ *
+ * Defines FitnessRecipe, CheckSelector, RecipeCheckResult, and related
+ * types used throughout the recipe execution system.
+ */
+import os from 'node:os';
+/** Default maximum parallelism based on available CPU cores */
+export const DEFAULT_MAX_PARALLEL = os.availableParallelism?.() ?? os.cpus().length;
+/** Default execution options applied when not overridden by a recipe */
+const DEFAULT_EXECUTION_OPTIONS = {
+    mode: 'parallel',
+    stopOnFirstFailure: false,
+    timeout: 30_000,
+    maxParallel: DEFAULT_MAX_PARALLEL,
+};
+/** Return the effective max parallelism for a recipe, falling back to the system default */
+export function getEffectiveMaxParallel(recipe) {
+    return recipe.execution.maxParallel ?? DEFAULT_MAX_PARALLEL;
+}
+/** Default reporting options applied when not overridden by a recipe */
+const DEFAULT_REPORTING_OPTIONS = {
+    format: 'table',
+    verbose: false,
+};
+/** Create a frozen FitnessRecipe from a definition, applying defaults for missing options */
+export function defineRecipe(definition) {
+    const id = `RCP_${definition.name}`;
+    const recipe = {
+        id,
+        name: definition.name,
+        displayName: definition.displayName,
+        description: definition.description,
+        checks: definition.checks,
+        execution: {
+            ...DEFAULT_EXECUTION_OPTIONS,
+            ...definition.execution,
+        },
+        reporting: {
+            ...DEFAULT_REPORTING_OPTIONS,
+            ...definition.reporting,
+        },
+    };
+    if (definition.tags || definition.includeDisabled) {
+        return Object.freeze({
+            ...recipe,
+            ...(definition.tags ? { tags: definition.tags } : {}),
+            ...(definition.includeDisabled ? { includeDisabled: definition.includeDisabled } : {}),
+        });
+    }
+    return Object.freeze(recipe);
+}
+//# sourceMappingURL=types.js.map

package/dist/recipes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recipes/types.ts"],"names":[],"mappings":"AAAA,+IAA+I;AAC/I;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAA;AA0LxB,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAA;AAEnF,wEAAwE;AACxE,MAAM,yBAAyB,GAA4B;IACzD,IAAI,EAAE,UAAU;IAChB,kBAAkB,EAAE,KAAK;IACzB,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,oBAAoB;CACzB,CAAA;AAEV,4FAA4F;AAC5F,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,IAAI,oBAAoB,CAAA;AAC7D,CAAC;AAED,wEAAwE;AACxE,MAAM,yBAAyB,GAA4B;IACzD,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,KAAK;CACN,CAAA;AAEV,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,UAAmC;IAC9D,MAAM,EAAE,GAAG,OAAO,UAAU,CAAC,IAAI,EAAE,CAAA;IAEnC,MAAM,MAAM,GAAkB;QAC5B,EAAE;QACF,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,SAAS,EAAE;YACT,GAAG,yBAAyB;YAC5B,GAAG,UAAU,CAAC,SAAS;SACxB;QACD,SAAS,EAAE;YACT,GAAG,yBAAyB;YAC5B,GAAG,UAAU,CAAC,SAAS;SACxB;KACF,CAAA;IAED,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,MAAM;YACT,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC"}

package/dist/sarif.d.ts

@@ -0,0 +1,34 @@
+import type { CliOutput } from '@opensip-tools/contracts';
+/** Result of a cloud report upload */
+export interface ReportResult {
+    readonly url: string;
+    readonly findingCount: number;
+    readonly runCount: number;
+    readonly success: boolean;
+    readonly error?: string;
+    readonly chunksTotal?: number;
+    readonly chunksSucceeded?: number;
+}
+interface SarifRun {
+    tool: {
+        driver: {
+            name: string;
+            version: string;
+            rules: {
+                id: string;
+            }[];
+        };
+    };
+    results: Record<string, unknown>[];
+}
+/** Build a SARIF 2.1.0 log from CLI output — one run per check slug */
+export declare function buildSarifLog(output: CliOutput): Record<string, unknown>;
+/**
+ * Split SARIF runs into chunks of at most `maxFindings` findings each.
+ * Keeps whole runs together when possible; splits a single run across
+ * chunks only when it exceeds the limit on its own.
+ */
+export declare function chunkSarifRuns(runs: SarifRun[], maxFindings?: number): SarifRun[][];
+export declare function reportToCloud(output: CliOutput, url: string, apiKey?: string): Promise<ReportResult>;
+export {};
+//# sourceMappingURL=sarif.d.ts.map

package/dist/sarif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../src/sarif.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAQ1D,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE;QAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAA;KAAE,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACpC;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAExE;AA8DD;;;;GAIG;AAEH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,WAAW,SAAyB,GAAG,QAAQ,EAAE,EAAE,CAyCnG;AAQD,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqF1G"}