@opensip-tools/fitness 1.0.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/targets/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED,oDAAoD;AACpD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC9B;AAED;;;GAGG;AACH,KAAK,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;AAE1E;;;;;;;;;;GAUG;AACH,UAAU,aAAa;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CACjC"}

package/dist/targets/types.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Target type definitions for shared targeting
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/targets/types.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * fitnessTool — fitness as a Tool plugin.
+ *
+ * Owns its full Commander wiring for the `fit`, `dashboard`, `fit-list`,
+ * and `fit-recipes` subcommands. The CLI calls register() once at
+ * startup and the rest is local: every option-parsing rule, gate-mode
+ * dispatch, JSON-vs-Ink rendering decision, and dashboard auto-open
+ * lives here, in the package that owns the fitness command surface.
+ *
+ * The CLI no longer imports `executeFit`, `openDashboard`, etc.
+ * directly — it just calls `fitnessTool.register(cli)`. Adding a new
+ * subcommand to fitness is a local change; no CLI edit required.
+ */
+import type { Tool } from '@opensip-tools/core';
+export declare const fitnessTool: Tool;
+export { setPreLoadHook } from './cli/fit.js';
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,OAAO,KAAK,EAAE,IAAI,EAAyC,MAAM,qBAAqB,CAAC;AAyPvF,eAAO,MAAM,WAAW,EAAE,IAezB,CAAC;AAKF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/tool.js

@@ -0,0 +1,282 @@
+/**
+ * fitnessTool — fitness as a Tool plugin.
+ *
+ * Owns its full Commander wiring for the `fit`, `dashboard`, `fit-list`,
+ * and `fit-recipes` subcommands. The CLI calls register() once at
+ * startup and the rest is local: every option-parsing rule, gate-mode
+ * dispatch, JSON-vs-Ink rendering decision, and dashboard auto-open
+ * lives here, in the package that owns the fitness command surface.
+ *
+ * The CLI no longer imports `executeFit`, `openDashboard`, etc.
+ * directly — it just calls `fitnessTool.register(cli)`. Adding a new
+ * subcommand to fitness is a local change; no CLI edit required.
+ */
+import { EXIT_CODES } from '@opensip-tools/contracts';
+import { openDashboard } from './cli/dashboard.js';
+import { executeFit } from './cli/fit.js';
+import { listChecks } from './cli/list-checks.js';
+import { listRecipes } from './cli/list-recipes.js';
+import { saveBaseline, compareToBaseline, renderGateCompareOutput, GateBaselineMissingError, GateBaselineInvalidError, DEFAULT_BASELINE_PATH, } from './gate.js';
+// =============================================================================
+// COMMAND DESCRIPTORS — used by --help listings and conflict detection.
+// =============================================================================
+const FIT = {
+    name: 'fit',
+    description: 'Run fitness checks',
+};
+const DASHBOARD = {
+    name: 'dashboard',
+    description: 'Generate the HTML dashboard and open it in your browser',
+};
+const FIT_LIST = {
+    name: 'fit-list',
+    description: 'List available fitness checks',
+    aliases: ['list-checks'],
+};
+const FIT_RECIPES = {
+    name: 'fit-recipes',
+    description: 'List available fitness recipes',
+    aliases: ['list-recipes'],
+};
+// =============================================================================
+// REGISTER — wires Commander subcommands onto the CLI's program.
+// =============================================================================
+function fitOptsToCliArgs(opts) {
+    return {
+        command: 'fit',
+        json: opts.json,
+        check: opts.check,
+        recipe: opts.recipe,
+        cwd: opts.cwd,
+        help: false,
+        list: opts.list,
+        listRecipes: opts.recipes,
+        verbose: opts.verbose,
+        reportTo: opts.reportTo,
+        apiKey: opts.apiKey,
+        exclude: opts.exclude,
+        findings: opts.findings,
+        tags: opts.tags,
+        quiet: opts.quiet === true,
+        open: opts.open === true,
+        config: opts.config,
+        gateSave: opts.gateSave === true,
+        gateCompare: opts.gateCompare === true,
+        baseline: opts.baseline,
+    };
+}
+function register(cli) {
+    // Cast once — the contract intentionally types `program` loosely so
+    // tools aren't pinned to a specific Commander major.
+    const program = cli.program;
+    // -- fit ------------------------------------------------------------------
+    program
+        .command(FIT.name)
+        .description(FIT.description)
+        .option('--recipe <name>', 'Use a named recipe (default, quick-smoke, backend, etc.)')
+        .option('--check <slug>', 'Run a single check by slug')
+        .option('--tags <tags>', 'Filter checks by tags (comma-separated)')
+        .option('--list', 'List available checks', false)
+        .option('--recipes', 'List available recipes', false)
+        .option('--json', 'Output structured JSON', false)
+        .option('-v, --verbose', 'Show finding details inline + findings summary', false)
+        .option('--findings', 'Show all findings grouped by check after the run', false)
+        .option('--report-to <url>', 'POST findings to a URL (OpenSIP Cloud or compatible)')
+        .option('--api-key <key>', 'API key for --report-to authentication')
+        .option('--exclude <slug>', 'Exclude check (repeatable)', (val, prev) => [...prev, val], [])
+        .option('--cwd <path>', 'Target directory', process.cwd())
+        .option('--config <path>', 'Path to opensip-tools.config.yml (overrides package.json pointer and default)')
+        .option('-q, --quiet', 'Suppress banner / boxes; print only the pass-fail summary', false)
+        .option('--open', 'Launch the HTML dashboard in your browser after the run completes', false)
+        .option('--debug', 'Enable debug mode for structured log output', false)
+        .option('--gate-save', 'Architecture-gate: save current findings as baseline (mutually exclusive with --gate-compare)', false)
+        .option('--gate-compare', 'Architecture-gate: compare current findings against baseline; exit 1 on regression', false)
+        .option('--baseline <path>', 'Path to baseline file for --gate-save / --gate-compare (default: opensip-tools/.runtime/baseline.sarif)')
+        .action(async (opts) => {
+        const args = fitOptsToCliArgs(opts);
+        // Architecture gate: --gate-save / --gate-compare. Headless,
+        // stdout-only, exit code is the gate decision.
+        if (args.gateSave === true || args.gateCompare === true) {
+            await runGateMode(args, cli);
+            return;
+        }
+        // --list
+        if (args.list) {
+            const result = await listChecks(args.cwd);
+            if (args.json) {
+                process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+                return;
+            }
+            await cli.render(result);
+            return;
+        }
+        // --recipes
+        if (args.listRecipes) {
+            const result = await listRecipes(args.cwd);
+            if (args.json) {
+                process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+                return;
+            }
+            await cli.render(result);
+            return;
+        }
+        // Main fit execution.
+        if (args.json) {
+            const fitResult = await executeFit(args);
+            if (fitResult.result.type === 'error') {
+                cli.setExitCode(fitResult.result.exitCode);
+                process.stdout.write(JSON.stringify({ error: fitResult.result.message }, null, 2) + '\n');
+            }
+            else {
+                if (fitResult.result.type === 'fit-done' && fitResult.result.shouldFail) {
+                    cli.setExitCode(EXIT_CODES.RUNTIME_ERROR);
+                }
+                process.stdout.write(JSON.stringify(fitResult.output, null, 2) + '\n');
+            }
+            return;
+        }
+        // Visual mode — Ink-rendered live results. The CLI supplies the
+        // renderer via cli.renderLive() so this file doesn't depend on
+        // the CLI package directly.
+        await cli.renderLive('fit', args);
+        // --open: launch dashboard after the run when conditions allow.
+        await cli.maybeOpenDashboard({
+            openRequested: Boolean(opts.open),
+            jsonOutput: Boolean(args.json),
+            cwd: args.cwd,
+        });
+    });
+    // -- dashboard ------------------------------------------------------------
+    program
+        .command(DASHBOARD.name)
+        .description(DASHBOARD.description)
+        .option('--cwd <path>', 'Target directory', process.cwd())
+        .option('--json', 'Output structured JSON', false)
+        .option('--debug', 'Enable debug mode for structured log output', false)
+        .action(async (opts) => {
+        const result = await openDashboard(opts.cwd);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            return;
+        }
+        await cli.render(result);
+    });
+    // -- fit-list (alias: list-checks) ----------------------------------------
+    const fitListCmd = program
+        .command(FIT_LIST.name)
+        .description(FIT_LIST.description);
+    for (const alias of FIT_LIST.aliases ?? [])
+        fitListCmd.alias(alias);
+    fitListCmd
+        .option('--cwd <path>', 'Target directory', process.cwd())
+        .option('--json', 'Output structured JSON', false)
+        .action(async (opts) => {
+        const result = await listChecks(opts.cwd);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            return;
+        }
+        await cli.render(result);
+    });
+    // -- fit-recipes (alias: list-recipes) ------------------------------------
+    const fitRecipesCmd = program
+        .command(FIT_RECIPES.name)
+        .description(FIT_RECIPES.description);
+    for (const alias of FIT_RECIPES.aliases ?? [])
+        fitRecipesCmd.alias(alias);
+    fitRecipesCmd
+        .option('--cwd <path>', 'Target directory', process.cwd())
+        .option('--json', 'Output structured JSON', false)
+        .action(async (opts) => {
+        const result = await listRecipes(opts.cwd);
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            return;
+        }
+        await cli.render(result);
+    });
+}
+// =============================================================================
+// GATE MODE — extracted helper used by `fit --gate-save` / `--gate-compare`.
+// =============================================================================
+async function runGateMode(args, cli) {
+    if (args.gateSave === true && args.gateCompare === true) {
+        cli.logger.warn({
+            evt: 'cli.gate.config_error',
+            module: 'cli:gate',
+            reason: 'mutually-exclusive flags',
+            msg: '--gate-save and --gate-compare specified together',
+        });
+        cli.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
+        process.stderr.write('Error: --gate-save and --gate-compare are mutually exclusive.\n');
+        return;
+    }
+    const baselinePath = args.baseline ?? DEFAULT_BASELINE_PATH;
+    const fitResult = await executeFit(args);
+    if (fitResult.result.type !== 'fit-done') {
+        cli.logger.warn({
+            evt: 'cli.gate.fit_failed',
+            module: 'cli:gate',
+            mode: args.gateSave === true ? 'save' : 'compare',
+            baselinePath,
+            reason: fitResult.result.message,
+        });
+        cli.setExitCode(fitResult.result.exitCode);
+        process.stderr.write(`Error: ${fitResult.result.message}\n`);
+        return;
+    }
+    const output = fitResult.output;
+    try {
+        if (args.gateSave === true) {
+            saveBaseline(output, baselinePath);
+            const findingCount = output.checks.reduce((n, c) => n + c.findings.length, 0);
+            process.stdout.write(`Baseline saved to ${baselinePath}\n`);
+            process.stdout.write(`  ${output.checks.length} check(s), ${findingCount} finding(s)\n`);
+            return;
+        }
+        const result = compareToBaseline(output, baselinePath);
+        process.stdout.write(renderGateCompareOutput(result) + '\n');
+        cli.setExitCode(result.degraded ? 1 : 0);
+        return;
+    }
+    catch (error) {
+        if (error instanceof GateBaselineMissingError || error instanceof GateBaselineInvalidError) {
+            cli.logger.warn({
+                evt: 'cli.gate.baseline_error',
+                module: 'cli:gate',
+                mode: args.gateSave === true ? 'save' : 'compare',
+                baselinePath,
+                errorType: error.name,
+                reason: error.message,
+            });
+            cli.setExitCode(EXIT_CODES.CONFIGURATION_ERROR);
+            process.stderr.write(`Error: ${error.message}\n`);
+            return;
+        }
+        throw error;
+    }
+}
+// =============================================================================
+// EXPORT
+// =============================================================================
+export const fitnessTool = {
+    metadata: {
+        id: 'fitness',
+        version: '1.0.0',
+        description: 'Run fitness checks against a codebase',
+    },
+    commands: [FIT, DASHBOARD, FIT_LIST, FIT_RECIPES],
+    register,
+    initialize: async () => {
+        // ensureChecksLoaded() is called inside the executeFit / listChecks
+        // / listRecipes paths, so a separate initialize() pass is not
+        // strictly needed today. Left as a no-op so fitness has somewhere
+        // to hang future tool-startup work (eager check-pack discovery,
+        // catalog warming, etc.) without requiring a contract change.
+    },
+};
+// Pre-load hook setter — used by the CLI to wire project-plugin
+// auto-sync into ensureChecksLoaded's startup path. Re-exported here
+// so the CLI's bootstrap doesn't need to deep-import.
+export { setPreLoadHook } from './cli/fit.js';
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAKnB,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;AAEhF,MAAM,GAAG,GAA0B;IACjC,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,oBAAoB;CAClC,CAAC;AAEF,MAAM,SAAS,GAA0B;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,yDAAyD;CACvE,CAAC;AAEF,MAAM,QAAQ,GAA0B;IACtC,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,+BAA+B;IAC5C,OAAO,EAAE,CAAC,aAAa,CAAC;CACzB,CAAC;AAEF,MAAM,WAAW,GAA0B;IACzC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,gCAAgC;IAC7C,OAAO,EAAE,CAAC,cAAc,CAAC;CAC1B,CAAC;AAEF,gFAAgF;AAChF,iEAAiE;AACjE,gFAAgF;AAEhF,SAAS,gBAAgB,CAAC,IAAsD;IAC9E,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;QACxB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI;QAChC,WAAW,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI;QACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,GAAmB;IACnC,oEAAoE;IACpE,qDAAqD;IACrD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAkB,CAAC;IAEvC,4EAA4E;IAC5E,OAAO;SACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;SACjB,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC;SAC5B,MAAM,CAAC,iBAAiB,EAAE,0DAA0D,CAAC;SACrF,MAAM,CAAC,gBAAgB,EAAE,4BAA4B,CAAC;SACtD,MAAM,CAAC,eAAe,EAAE,yCAAyC,CAAC;SAClE,MAAM,CAAC,QAAQ,EAAE,uBAAuB,EAAE,KAAK,CAAC;SAChD,MAAM,CAAC,WAAW,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACjD,MAAM,CAAC,eAAe,EAAE,gDAAgD,EAAE,KAAK,CAAC;SAChF,MAAM,CAAC,YAAY,EAAE,kDAAkD,EAAE,KAAK,CAAC;SAC/E,MAAM,CAAC,mBAAmB,EAAE,sDAAsD,CAAC;SACnF,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,CAAC;SACnE,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,EAAE,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,EAAc,CAAC;SACzH,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,+EAA+E,CAAC;SAC1G,MAAM,CAAC,aAAa,EAAE,2DAA2D,EAAE,KAAK,CAAC;SACzF,MAAM,CAAC,QAAQ,EAAE,mEAAmE,EAAE,KAAK,CAAC;SAC5F,MAAM,CAAC,SAAS,EAAE,6CAA6C,EAAE,KAAK,CAAC;SACvE,MAAM,CAAC,aAAa,EAAE,+FAA+F,EAAE,KAAK,CAAC;SAC7H,MAAM,CAAC,gBAAgB,EAAE,oFAAoF,EAAE,KAAK,CAAC;SACrH,MAAM,CAAC,mBAAmB,EAAE,yGAAyG,CAAC;SACtI,MAAM,CAAC,KAAK,EAAE,IAAsD,EAAE,EAAE;QACvE,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEpC,6DAA6D;QAC7D,+CAA+C;QAC/C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,SAAS;QACT,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACxF,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QAED,YAAY;QACZ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACxF,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACtC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC5F,CAAC;iBAAM,CAAC;gBACN,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;oBACxE,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;gBAC5C,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACzE,CAAC;YACD,OAAO;QACT,CAAC;QAED,gEAAgE;QAChE,+DAA+D;QAC/D,4BAA4B;QAC5B,MAAM,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAElC,gEAAgE;QAChE,MAAM,GAAG,CAAC,kBAAkB,CAAC;YAC3B,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACjC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,4EAA4E;IAC5E,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;SACvB,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC;SAClC,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACjD,MAAM,CAAC,SAAS,EAAE,6CAA6C,EAAE,KAAK,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,4EAA4E;IAC5E,MAAM,UAAU,GAAG,OAAO;SACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;SACtB,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE;QAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpE,UAAU;SACP,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACxF,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,4EAA4E;IAC5E,MAAM,aAAa,GAAG,OAAO;SAC1B,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC;SACzB,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,IAAI,EAAE;QAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1E,aAAa;SACV,MAAM,CAAC,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACxF,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC;AAED,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAEhF,KAAK,UAAU,WAAW,CAAC,IAAa,EAAE,GAAmB;IAC3D,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YACd,GAAG,EAAE,uBAAuB;YAC5B,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,0BAA0B;YAClC,GAAG,EAAE,mDAAmD;SACzD,CAAC,CAAC;QACH,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACxF,OAAO;IACT,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,IAAI,qBAAqB,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YACd,GAAG,EAAE,qBAAqB;YAC1B,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACjD,YAAY;YACZ,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO;SACjC,CAAC,CAAC;QACH,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAO,CAAC;IACjC,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACnC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,YAAY,IAAI,CAAC,CAAC;YAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,cAAc,YAAY,eAAe,CAAC,CAAC;YACzF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAwB,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;YAC3F,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;gBACd,GAAG,EAAE,yBAAyB;gBAC9B,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACjD,YAAY;gBACZ,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,MAAM,EAAE,KAAK,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,QAAQ,EAAE;QACR,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,uCAAuC;KACrD;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC;IACjD,QAAQ;IACR,UAAU,EAAE,KAAK,IAAmB,EAAE;QACpC,oEAAoE;QACpE,8DAA8D;QAC9D,kEAAkE;QAClE,gEAAgE;QAChE,8DAA8D;IAChE,CAAC;CACF,CAAC;AAEF,gEAAgE;AAChE,qEAAqE;AACrE,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/findings.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Core finding and result types for fitness checks
+ *
+ * CheckResult carries Signal[]. Factory functions
+ * (createResultWithSignals, createErrorResult, createPassingResult) provide
+ * the standard way to construct check results.
+ */
+import type { DirectiveEntry } from '../framework/directive-inventory.js';
+import type { Signal } from '@opensip-tools/core';
+/**
+ * Severity level for findings and violations.
+ */
+export type FindingSeverity = 'error' | 'warning';
+/**
+ * Alias for FindingSeverity — used by simplified check.ts types.
+ */
+export type Severity = FindingSeverity;
+/**
+ * A single finding from a fitness check (output format).
+ */
+export interface Finding {
+    readonly message: string;
+    readonly severity: Severity;
+    readonly filePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly suggestion?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Output from a tool-based check.
+ */
+export interface ToolOutput {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number;
+}
+/**
+ * Check info for display.
+ */
+export interface CheckInfo {
+    /** Summary label (e.g., "142/150 files compliant") */
+    readonly label: string;
+}
+/**
+ * Metadata about a check run.
+ */
+export interface CheckResultMetadata {
+    /** Total items scanned */
+    readonly totalItems: number;
+    /** Signals (same reference as top-level) */
+    readonly signals: readonly Signal[];
+    /** Duration in milliseconds */
+    readonly durationMs?: number;
+    /** Number of files scanned from filesystem */
+    readonly filesScanned?: number;
+    /** Item type (e.g., 'files', 'modules') */
+    readonly itemType?: string;
+    /** Extra metadata */
+    readonly extra?: Record<string, unknown>;
+}
+/**
+ * Result of running a fitness check.
+ * Now carries universal Signal[] instead of domain-specific violations.
+ */
+export interface CheckResult {
+    /** Whether the check passed (no errors) */
+    readonly passed: boolean;
+    /** Number of error-level signals */
+    readonly errors: number;
+    /** Number of warning-level signals */
+    readonly warnings: number;
+    /** All signals */
+    readonly signals: readonly Signal[];
+    /** Display info */
+    readonly info: CheckInfo;
+    /** Run metadata */
+    readonly metadata: CheckResultMetadata;
+    /** Count of violations ignored via directives */
+    readonly ignoredCount?: number;
+    /** Directives that actually suppressed signals during this check's execution */
+    readonly appliedDirectives?: readonly DirectiveEntry[];
+}
+/**
+ * Item types for check info display.
+ */
+export type ItemType = 'files' | 'modules' | 'packages' | 'functions' | 'classes' | 'components' | 'tests' | 'endpoints' | 'dependencies' | 'issues' | 'violations' | 'rules' | 'recipes' | 'checks';
+/**
+ * Get a human-readable label for an item type.
+ */
+export declare function getItemTypeLabel(type: ItemType, count: number): string;
+/**
+ * Factory for creating CheckInfo objects.
+ */
+export declare const CheckInfoFactory: Readonly<{
+    compliance(compliantItems: number, totalItems: number, unit: string): CheckInfo;
+    violations(count: number, unit: string): CheckInfo;
+}>;
+/**
+ * Create a result with signals.
+ */
+export declare function createResultWithSignals(info: CheckInfo, signals: readonly Signal[], totalItems: number, options?: {
+    ignoredCount?: number;
+    durationMs?: number;
+    filesScanned?: number;
+    itemType?: string;
+    extra?: Record<string, unknown>;
+}): CheckResult;
+/**
+ * Create an error result (for check failures).
+ */
+export declare function createErrorResult(message: string, error?: Error): CheckResult;
+/**
+ * Create a passing result with no signals.
+ */
+export declare function createPassingResult(totalItems: number, unit: string): CheckResult;
+//# sourceMappingURL=findings.d.ts.map

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

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

package/dist/types/findings.js

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Core finding and result types for fitness checks
+ *
+ * CheckResult carries Signal[]. Factory functions
+ * (createResultWithSignals, createErrorResult, createPassingResult) provide
+ * the standard way to construct check results.
+ */
+import { countErrors, countWarnings } from './severity.js';
+const ITEM_TYPE_SINGULAR = {
+    files: 'file',
+    modules: 'module',
+    packages: 'package',
+    functions: 'function',
+    classes: 'class',
+    components: 'component',
+    tests: 'test',
+    endpoints: 'endpoint',
+    dependencies: 'dependency',
+    issues: 'issue',
+    violations: 'violation',
+    rules: 'rule',
+    recipes: 'recipe',
+    checks: 'check',
+};
+/**
+ * Get a human-readable label for an item type.
+ */
+export function getItemTypeLabel(type, count) {
+    return count === 1 ? ITEM_TYPE_SINGULAR[type] : type;
+}
+// =============================================================================
+// FACTORY FUNCTIONS
+// =============================================================================
+/**
+ * Factory for creating CheckInfo objects.
+ */
+export const CheckInfoFactory = Object.freeze({
+    compliance(compliantItems, totalItems, unit) {
+        return { label: `${compliantItems}/${totalItems} ${unit} compliant` };
+    },
+    violations(count, unit) {
+        return { label: count === 0 ? `No ${unit}` : `${count} ${unit}` };
+    },
+});
+/**
+ * Create a result with signals.
+ */
+export function createResultWithSignals(info, signals, totalItems, options) {
+    const errors = countErrors(signals);
+    const warnings = countWarnings(signals);
+    return {
+        passed: errors === 0,
+        errors,
+        warnings,
+        signals,
+        info,
+        metadata: {
+            totalItems,
+            signals,
+            durationMs: options?.durationMs,
+            filesScanned: options?.filesScanned,
+            itemType: options?.itemType,
+            extra: options?.extra,
+        },
+        ...(options?.ignoredCount !== undefined && options.ignoredCount > 0
+            ? { ignoredCount: options.ignoredCount }
+            : {}),
+    };
+}
+/**
+ * Create an error result (for check failures).
+ */
+export function createErrorResult(message, error) {
+    return {
+        passed: false,
+        errors: 1,
+        warnings: 0,
+        signals: [],
+        info: { label: `Error: ${message}` },
+        metadata: {
+            totalItems: 0,
+            signals: [],
+            extra: error ? { originalError: error.message, ...(error.stack ? { stack: error.stack } : {}) } : undefined,
+        },
+    };
+}
+/**
+ * Create a passing result with no signals.
+ */
+export function createPassingResult(totalItems, unit) {
+    return createResultWithSignals(CheckInfoFactory.compliance(totalItems, totalItems, unit), [], totalItems);
+}
+//# sourceMappingURL=findings.js.map

package/dist/types/findings.js.map

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

package/dist/types/severity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Shared severity classification helpers
+ *
+ * Centralizes severity-based signal filtering and counting logic
+ * used across types, framework, and recipes modules.
+ */
+/** Count error-level signals in an array */
+export declare function countErrors(signals: readonly {
+    severity: string;
+}[]): number;
+/** Count warning-level signals in an array */
+export declare function countWarnings(signals: readonly {
+    severity: string;
+}[]): number;
+//# sourceMappingURL=severity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../../src/types/severity.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAcH,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAM5E;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAM9E"}

package/dist/types/severity.js

@@ -0,0 +1,36 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+// @fitness-ignore-file clean-code-naming-quality -- short names used in severity mapping utilities
+// @fitness-ignore-file project-readme-existence -- internal module, not a package root
+/**
+ * @fileoverview Shared severity classification helpers
+ *
+ * Centralizes severity-based signal filtering and counting logic
+ * used across types, framework, and recipes modules.
+ */
+/** Returns true for 'high' or 'critical' severity signals (error-level) */
+function isErrorSeverity(severity) {
+    return severity === 'high' || severity === 'critical';
+}
+/** Returns true for 'medium' severity signals (warning-level) */
+function isWarningSeverity(severity) {
+    return severity === 'medium';
+}
+/** Count error-level signals in an array */
+export function countErrors(signals) {
+    let count = 0;
+    for (const s of signals) {
+        if (isErrorSeverity(s.severity))
+            count++;
+    }
+    return count;
+}
+/** Count warning-level signals in an array */
+export function countWarnings(signals) {
+    let count = 0;
+    for (const s of signals) {
+        if (isWarningSeverity(s.severity))
+            count++;
+    }
+    return count;
+}
+//# sourceMappingURL=severity.js.map

package/dist/types/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../src/types/severity.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAC1I,mGAAmG;AACnG,uFAAuF;AACvF;;;;;GAKG;AAIH,2EAA2E;AAC3E,SAAS,eAAe,CAAC,QAAwB;IAC/C,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,UAAU,CAAA;AACvD,CAAC;AAED,iEAAiE;AACjE,SAAS,iBAAiB,CAAC,QAAwB;IACjD,OAAO,QAAQ,KAAK,QAAQ,CAAA;AAC9B,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,WAAW,CAAC,OAAwC;IAClE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,eAAe,CAAC,CAAC,CAAC,QAA0B,CAAC;YAAE,KAAK,EAAE,CAAA;IAC5D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,aAAa,CAAC,OAAwC;IACpE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,iBAAiB,CAAC,CAAC,CAAC,QAA0B,CAAC;YAAE,KAAK,EAAE,CAAA;IAC9D,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}