@opensip-cli/fitness 0.1.0

package/dist/recipes/run-one-check.js

@@ -0,0 +1,174 @@
+/**
+ * @fileoverview Per-check execution lifecycle
+ *
+ * `runOneCheck` is the single entry point for "run this Check, with its
+ * timeout, retry, and abort behavior, and tell me how it ended." Both
+ * the parallel and sequential schedulers delegate to it; they keep only
+ * the scheduling shape (sliding window vs `for-of` loop).
+ *
+ * Reconciled abort semantics:
+ *
+ * The earlier parallel/sequential implementations diverged on how they
+ * detected a timeout — parallel inspected `signal.aborted` after the
+ * retry resolved; sequential maintained a separate `timedOut` flag
+ * mutated by the setTimeout callback. Either signal source is sufficient
+ * because the per-check `AbortController` is only aborted by the
+ * setTimeout we install here. We keep `signal.aborted` as the canonical
+ * shape (it is the controller's own state and survives the retry chain
+ * without a closure-scoped flag), and treat any post-retry `aborted`
+ * signal as a timeout.
+ */
+import { TimeoutError, logger, runWithTimeout, withSpanAsync } from '@opensip-cli/core';
+import { CheckAbortedError } from '../framework/execution-context.js';
+import { memoryProfiler } from '../framework/memory-profiler.js';
+import { processSuccessResult, processErrorResult, } from './check-result-processor.js';
+/** Logger module tag used by every event emitted from per-check execution. */
+const MODULE_TAG = 'fitness:execution';
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+/**
+ * Execute one check end-to-end: build the abort controller, install the
+ * timeout, run with retry, then dispatch the result to
+ * `processSuccessResult` / `processErrorResult` based on the outcome.
+ *
+ * Schedulers should call this once per check. The returned
+ * `shouldStop` field tells the scheduler whether to break out of its
+ * loop (e.g. `recipe.execution.stopOnFirstFailure`).
+ */
+export async function runOneCheck(check, opts, ctx) {
+    const checkId = check.config.id;
+    const checkSlug = check.config.slug;
+    const checkTimeout = check.config.timeout ?? opts.recipeTimeoutMs;
+    const memoryBeforeMB = memoryProfiler.recordCheckStart();
+    ctx.callbacks.onCheckStart?.(checkSlug, opts.checkIndex, opts.totalChecks);
+    logger.info({
+        evt: 'fitness.check.start',
+        module: MODULE_TAG,
+        checkSlug,
+        index: opts.checkIndex,
+        total: opts.totalChecks,
+        timeoutMs: checkTimeout,
+    });
+    const targetFiles = opts.checkTargetFiles?.get(checkSlug);
+    // Run on the shared execution substrate (release 2.13.0, §5.8): per-check
+    // timeout/abort + retry. The single-source abort invariant is preserved by
+    // `runWithTimeout` — the controller is aborted ONLY by the timeout — so a
+    // `timeout` outcome IS a real timeout, exactly as the former inline
+    // AbortController+setTimeout body computed it. `CheckAbortedError` is never
+    // retried (the timeout abort surfaces as a `timeout` outcome, not a retry).
+    const outcome = await withSpanAsync('opensip-cli-fitness', 'fitness.check.execute', async () => {
+        return await runWithTimeout({
+            run: (signal) => check.run(opts.cwd, {
+                signal,
+                ...(targetFiles ? { targetFiles } : {}),
+                ...(opts.globalExcludes ? { globalExcludes: opts.globalExcludes } : {}),
+                ...(opts.fileCache ? { fileCache: opts.fileCache } : {}),
+            }),
+            timeoutMs: checkTimeout,
+            retry: {
+                enabled: opts.retryEnabled,
+                maxRetries: opts.maxRetries,
+                shouldNotRetry: (error) => error instanceof CheckAbortedError,
+            },
+        });
+    }, {
+        'fitness.check.slug': checkSlug,
+        'fitness.check.id': checkId,
+        'fitness.check.timeout_ms': checkTimeout,
+    });
+    const { durationMs } = outcome;
+    // The result PROCESSING (which fires user callbacks like onCheckComplete) is
+    // wrapped so a throw from a callback is recovered into a non-timeout error
+    // result — the same recovery the former inline try/catch provided (pinned by
+    // run-one-check.test.ts). The unit RUN itself is already classified by
+    // `runWithTimeout` above and never throws here.
+    try {
+        if (outcome.status === 'timeout') {
+            logger.info({
+                evt: 'fitness.check.timeout',
+                module: MODULE_TAG,
+                checkSlug,
+                durationMs,
+                timeoutMs: checkTimeout,
+            });
+            const processOutput = processErrorResult(ctx, {
+                checkId,
+                checkSlug,
+                checkIndex: opts.checkIndex,
+                totalChecks: opts.totalChecks,
+                error: new TimeoutError(`Check ${checkId} timed out after ${checkTimeout}ms`, checkTimeout),
+                durationMs,
+                memoryBeforeMB,
+                timedOut: true,
+                timeoutMs: checkTimeout,
+            });
+            return { shouldStop: processOutput.shouldStop, processOutput };
+        }
+        if (outcome.status === 'error') {
+            logger.info({
+                evt: 'fitness.check.error',
+                module: MODULE_TAG,
+                checkSlug,
+                durationMs,
+                timedOut: false,
+                error: outcome.error instanceof Error ? outcome.error.message : String(outcome.error),
+            });
+            const processOutput = processErrorResult(ctx, {
+                checkId,
+                checkSlug,
+                checkIndex: opts.checkIndex,
+                totalChecks: opts.totalChecks,
+                error: outcome.error,
+                durationMs,
+                memoryBeforeMB,
+                timedOut: false,
+            });
+            return { shouldStop: processOutput.shouldStop, processOutput };
+        }
+        logger.info({
+            evt: 'fitness.check.done',
+            module: MODULE_TAG,
+            checkSlug,
+            durationMs,
+            signals: outcome.result.signals.length,
+        });
+        const processOutput = processSuccessResult(ctx, {
+            checkId,
+            checkSlug,
+            tags: check.config.tags ?? [],
+            checkIndex: opts.checkIndex,
+            totalChecks: opts.totalChecks,
+            result: outcome.result,
+            durationMs,
+            memoryBeforeMB,
+        });
+        return { shouldStop: processOutput.shouldStop, processOutput };
+    }
+    catch (error) {
+        // A user callback inside the result processing threw. Recover it into an
+        // error result — non-timeout unless the unit itself timed out.
+        const isTimeout = outcome.status === 'timeout';
+        logger.info({
+            evt: 'fitness.check.error',
+            module: MODULE_TAG,
+            checkSlug,
+            durationMs,
+            timedOut: isTimeout,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        const processOutput = processErrorResult(ctx, {
+            checkId,
+            checkSlug,
+            checkIndex: opts.checkIndex,
+            totalChecks: opts.totalChecks,
+            error,
+            durationMs,
+            memoryBeforeMB,
+            timedOut: isTimeout,
+            ...(isTimeout ? { timeoutMs: checkTimeout } : {}),
+        });
+        return { shouldStop: processOutput.shouldStop, processOutput };
+    }
+}
+//# sourceMappingURL=run-one-check.js.map

package/dist/recipes/run-one-check.js.map

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

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

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Sequential execution scheduler for fitness recipe checks
+ *
+ * Runs fitness checks one at a time. Release 2.13.0 (§5.8): the loop + the
+ * between-iteration abort check now live in the shared execution substrate
+ * (`scheduleUnits`); this file keeps only the fitness setup + the per-check
+ * `runOneCheck` body.
+ */
+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;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAOzF,oFAAoF;AACpF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,uBAAuB,EAC5B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/recipes/sequential-execution.js

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Sequential execution scheduler for fitness recipe checks
+ *
+ * Runs fitness checks one at a time. Release 2.13.0 (§5.8): the loop + the
+ * between-iteration abort check now live in the shared execution substrate
+ * (`scheduleUnits`); this file keeps only the fitness setup + the per-check
+ * `runOneCheck` body.
+ */
+import { scheduleUnits } from '@opensip-cli/core';
+import { runOneCheck } from './run-one-check.js';
+// =============================================================================
+// SEQUENTIAL EXECUTION
+// =============================================================================
+/** Execute fitness checks sequentially with per-check timeouts and retry support */
+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,
+    };
+    await scheduleUnits({
+        units: checks,
+        mode: 'sequential',
+        // Interim live-view smoothing (ADR-0028) — see parallel-execution.ts.
+        yieldBetweenUnits: true,
+        shouldAbort: () => abortController?.signal.aborted === true,
+        runUnit: async (check, index) => {
+            const outcome = await runOneCheck(check, {
+                cwd,
+                checkIndex: index + 1,
+                totalChecks,
+                recipeTimeoutMs: recipeTimeout,
+                retryEnabled: recipe.execution.retryOnFailure ?? false,
+                maxRetries: recipe.execution.maxRetries ?? 2,
+                ...(checkTargetFiles ? { checkTargetFiles } : {}),
+                ...(globalExcludes ? { globalExcludes } : {}),
+                ...(opts.fileCache ? { fileCache: opts.fileCache } : {}),
+            }, processorCtx);
+            return { shouldStop: outcome.shouldStop };
+        },
+    });
+}
+//# sourceMappingURL=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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAA4B,EAC5B,IAAsB;IAEtB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IACvE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAElC,MAAM,YAAY,GAAqB;QACrC,OAAO;QACP,SAAS;QACT,MAAM;QACN,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,KAAK;KAClD,CAAC;IAEF,MAAM,aAAa,CAAQ;QACzB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,YAAY;QAClB,sEAAsE;QACtE,iBAAiB,EAAE,IAAI;QACvB,WAAW,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;QAC3D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,WAAW,CAC/B,KAAK,EACL;gBACE,GAAG;gBACH,UAAU,EAAE,KAAK,GAAG,CAAC;gBACrB,WAAW;gBACX,eAAe,EAAE,aAAa;gBAC9B,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc,IAAI,KAAK;gBACtD,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC;gBAC5C,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,EACD,YAAY,CACb,CAAC;YACF,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,87 @@
+/**
+ * @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 { FileCache } from '../framework/file-cache.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 the current scope's check registry). */
+    checkRegistry?: CheckRegistry;
+    /** Optional recipe registry (defaults to the current scope's recipe registry). */
+    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-cli.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[];
+    /** Optional file cache instance (defaults to a fresh per-service one for SaaS isolation). */
+    fileCache?: FileCache;
+}
+/** 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,73 @@
+/**
+ * @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 readonly fileCache;
+    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 executeRecipeInScope;
+    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":"AAGA;;;;;GAKG;AA6BH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AA2B5B;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAE9B,MAAM,CAAC,EAAE,0BAA0B;IAc/C,OAAO,KAAK,OAAO,GAOlB;IAED;;;;;;;;;;;OAWG;IAEG,KAAK,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAqBjE,aAAa;YAqBb,oBAAoB;IAkHlC,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,sBAAsB;YA6DhB,gBAAgB;IAsB9B,OAAO,CAAC,WAAW;IA0CnB;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,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"}