@opensip-cli/fitness 0.1.0

package/dist/recipes/types.js

@@ -0,0 +1,56 @@
+// @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';
+import { deriveRecipeId } from '@opensip-cli/core';
+/** 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) {
+    // Release 2.13.0 (§5.8): one shared `<prefix>_<name>` derivation (id unchanged).
+    const id = deriveRecipeId('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,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA2LnD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC;AAEpF,wEAAwE;AACxE,MAAM,yBAAyB,GAA4B;IACzD,IAAI,EAAE,UAAU;IAChB,kBAAkB,EAAE,KAAK;IACzB,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,oBAAoB;CACzB,CAAC;AAEX,4FAA4F;AAC5F,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,IAAI,oBAAoB,CAAC;AAC9D,CAAC;AAED,wEAAwE;AACxE,MAAM,yBAAyB,GAA4B;IACzD,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,KAAK;CACN,CAAC;AAEX,6FAA6F;AAC7F,MAAM,UAAU,YAAY,CAAC,UAAmC;IAC9D,iFAAiF;IACjF,MAAM,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAElD,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,CAAC;IAEF,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,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/scaffold/config-block.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The `fitness:` block fitness contributes to the scaffolded
+ * `opensip-cli.config.yml` (ADR-0038, Tool.scaffoldConfigBlock).
+ *
+ * Relocated verbatim from the CLI's `config-templates.ts` (the legacy
+ * `fitnessBlock` literal). The CLI's `generateConfig` keeps rendering the
+ * document header + `targets:` (host-owned, ADR-0023 §schema), and appends
+ * each tool's `scaffoldConfigBlock()` — fitness owns its own block bytes.
+ *
+ * Why a string literal rather than rendering from `fitnessConfigDeclaration.defaults`:
+ * the block carries inline guidance comments (`# fail if total errors >= this …`)
+ * that the bare defaults object cannot express. ADR-0038 Decision 2 reserved the
+ * `scaffoldConfigBlock` escape hatch for exactly this; the byte-exact init golden
+ * forces it.
+ */
+export declare function fitScaffoldConfigBlock(): string;
+//# sourceMappingURL=config-block.d.ts.map

package/dist/scaffold/config-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-block.d.ts","sourceRoot":"","sources":["../../src/scaffold/config-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAa/C"}

package/dist/scaffold/config-block.js

@@ -0,0 +1,30 @@
+/**
+ * The `fitness:` block fitness contributes to the scaffolded
+ * `opensip-cli.config.yml` (ADR-0038, Tool.scaffoldConfigBlock).
+ *
+ * Relocated verbatim from the CLI's `config-templates.ts` (the legacy
+ * `fitnessBlock` literal). The CLI's `generateConfig` keeps rendering the
+ * document header + `targets:` (host-owned, ADR-0023 §schema), and appends
+ * each tool's `scaffoldConfigBlock()` — fitness owns its own block bytes.
+ *
+ * Why a string literal rather than rendering from `fitnessConfigDeclaration.defaults`:
+ * the block carries inline guidance comments (`# fail if total errors >= this …`)
+ * that the bare defaults object cannot express. ADR-0038 Decision 2 reserved the
+ * `scaffoldConfigBlock` escape hatch for exactly this; the byte-exact init golden
+ * forces it.
+ */
+export function fitScaffoldConfigBlock() {
+    return [
+        '',
+        '# =============================================================================',
+        '# Fitness configuration',
+        '# =============================================================================',
+        '',
+        'fitness:',
+        '  failOnErrors: 1     # fail if total errors >= this (0 = never fail on errors)',
+        '  failOnWarnings: 0   # fail if total warnings >= this (0 = warnings are informational)',
+        '  disabledChecks: []',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=config-block.js.map

package/dist/scaffold/config-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-block.js","sourceRoot":"","sources":["../../src/scaffold/config-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,EAAE;QACF,iFAAiF;QACjF,yBAAyB;QACzB,iFAAiF;QACjF,EAAE;QACF,UAAU;QACV,iFAAiF;QACjF,yFAAyF;QACzF,sBAAsB;QACtB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/scaffold/examples.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview fitness's `init` example contribution (ADR-0038).
+ *
+ * fitness OWNS the example check/recipe bytes + the pinned check ids that `init`
+ * scaffolds — relocated here from the CLI's `config-templates.ts` so a tool's
+ * scaffold content lives with the tool (the host just writes the bytes under
+ * `userPluginDir('fit', kind)`). The byte content is verbatim; a Phase-0 golden +
+ * a Phase-1 parity test pin byte-identity with the legacy CLI builders.
+ */
+import type { ScaffoldContext, ScaffoldFile } from '@opensip-cli/core';
+/**
+ * Pinned example-check ids per language — the COMPLETE id universe (drives
+ * stale-scaffolded detection regardless of the project's detected languages).
+ * Verbatim from the legacy `config-templates.ts`.
+ */
+export declare const EXAMPLE_CHECK_IDS: Record<string, string>;
+/** Example fitness check source (verbatim). `language` is tool-local `string`. */
+export declare function exampleCheckSource(language: string, polyglotSuffix?: string): string;
+/** Example fitness recipe source (verbatim). */
+export declare function exampleRecipeSource(slugs: readonly string[]): string;
+/**
+ * fitness's scaffold contribution — reproduces `scaffold-writer.ts`'s fit logic:
+ * single language ⇒ one `example-check.mjs` + a recipe over `['example-check']`;
+ * polyglot ⇒ one `example-check-<lang>.mjs` per language + a recipe over the
+ * per-language slugs.
+ */
+export declare function fitScaffoldExamples(ctx: ScaffoldContext): ScaffoldFile[];
+/** fitness's COMPLETE stable example-id universe (every language's check id). */
+export declare function fitStableExampleIds(): string[];
+//# sourceMappingURL=examples.d.ts.map

package/dist/scaffold/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../src/scaffold/examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOpD,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,SAAK,GAAG,MAAM,CAuChF;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAqBpE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY,EAAE,CAkCxE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/scaffold/examples.js

@@ -0,0 +1,129 @@
+/**
+ * @fileoverview fitness's `init` example contribution (ADR-0038).
+ *
+ * fitness OWNS the example check/recipe bytes + the pinned check ids that `init`
+ * scaffolds — relocated here from the CLI's `config-templates.ts` so a tool's
+ * scaffold content lives with the tool (the host just writes the bytes under
+ * `userPluginDir('fit', kind)`). The byte content is verbatim; a Phase-0 golden +
+ * a Phase-1 parity test pin byte-identity with the legacy CLI builders.
+ */
+/**
+ * Pinned example-check ids per language — the COMPLETE id universe (drives
+ * stale-scaffolded detection regardless of the project's detected languages).
+ * Verbatim from the legacy `config-templates.ts`.
+ */
+export const EXAMPLE_CHECK_IDS = {
+    typescript: 'a3e1f8c4-9b2d-4f5a-8e6c-7d1a2b3c4d5e',
+    rust: 'b4f2e9d5-8c3e-4a6b-9f7d-8e2b3c4d5e6f',
+    python: 'c5a3f0e6-7d4f-4b7c-a08e-9f3c4d5e6f70',
+    go: 'd6b4a1f7-6e5a-4c8d-b19f-a04d5e6f7081',
+    java: 'e7c5b2a8-5f6b-4d9e-c2af-b15e6f708192',
+    cpp: 'f8d6c3b9-4a7c-4ea0-d3b0-c26f708192a3',
+};
+/** Example fitness check source (verbatim). `language` is tool-local `string`. */
+export function exampleCheckSource(language, polyglotSuffix = '') {
+    // The example check flags any file containing the literal
+    // `EXAMPLE_TODO`. Default behavior on a fresh repo is to pass with
+    // 0 violations — it scans real files but finds nothing.
+    const slug = polyglotSuffix ? `example-check-${polyglotSuffix}` : 'example-check';
+    return `// Example fitness check.
+//
+// Edit this file or add new .mjs files to opensip-cli/fit/checks/.
+// Files in this directory are auto-loaded on the next \`opensip fit\` run.
+//
+// This demo flags any file containing the literal \`EXAMPLE_TODO\`. After
+// you confirm the wiring works, delete or replace it with a real check.
+//
+// Docs: https://github.com/opensip-ai/opensip-cli#authoring-a-check-package
+import { defineCheck } from '@opensip-cli/fitness';
+
+export const checks = [
+  defineCheck({
+    id: '${EXAMPLE_CHECK_IDS[language] ?? ''}',
+    slug: '${slug}',
+    description: 'Demo check — flags any file containing the literal EXAMPLE_TODO',
+    scope: { languages: ['${language}'], concerns: ['backend'] },
+    tags: ['example'],
+    analyze: (content, filePath) => {
+      const i = content.indexOf('EXAMPLE_TODO');
+      if (i < 0) return [];
+      return [{
+        line: content.slice(0, i).split('\\n').length,
+        message: 'Found the example trigger string.',
+        severity: 'warning',
+        suggestion:
+          'This is just a demo. Delete opensip-cli/fit/checks/example-check.mjs ' +
+          'once you have your own checks.',
+        filePath,
+      }];
+    },
+  }),
+];
+`;
+}
+/** Example fitness recipe source (verbatim). */
+export function exampleRecipeSource(slugs) {
+    const slugList = slugs.map((s) => `'${s}'`).join(', ');
+    return `// Example fitness recipe — runs only the example check(s).
+//
+// Edit this file or add new .mjs files to opensip-cli/fit/recipes/.
+// Files in this directory are auto-loaded on the next run.
+//
+// Run this recipe explicitly:  opensip fit --recipe example
+//
+// To run all enabled checks (built-in + your custom ones), omit
+// --recipe and the built-in \`default\` recipe applies.
+export const recipes = [{
+  id: 'URCP_example',
+  name: 'example',
+  displayName: 'Example',
+  description: 'Demo recipe — runs only the example check(s)',
+  checks: { type: 'explicit', checkIds: [${slugList}] },
+  execution: { mode: 'parallel', stopOnFirstFailure: false, timeout: 30_000 },
+  reporting: { format: 'table', verbose: false },
+}];
+`;
+}
+/**
+ * fitness's scaffold contribution — reproduces `scaffold-writer.ts`'s fit logic:
+ * single language ⇒ one `example-check.mjs` + a recipe over `['example-check']`;
+ * polyglot ⇒ one `example-check-<lang>.mjs` per language + a recipe over the
+ * per-language slugs.
+ */
+export function fitScaffoldExamples(ctx) {
+    const languages = ctx.languages.length > 0 ? ctx.languages : ['typescript'];
+    const single = languages.length === 1;
+    // Single language ⇒ one un-suffixed `example-check.mjs`. Polyglot ⇒ one
+    // `example-check-<lang>.mjs` per language. A declarative `.map` (not a
+    // push-in-loop) keeps the check files' contents the single source.
+    const checkFiles = single
+        ? [
+            {
+                kind: 'checks',
+                filename: 'example-check.mjs',
+                content: exampleCheckSource(languages[0] ?? 'typescript'),
+                stableId: EXAMPLE_CHECK_IDS[languages[0] ?? 'typescript'] ?? '',
+            },
+        ]
+        : languages.map((lang) => ({
+            kind: 'checks',
+            filename: `example-check-${lang}.mjs`,
+            content: exampleCheckSource(lang, lang),
+            stableId: EXAMPLE_CHECK_IDS[lang] ?? '',
+        }));
+    const slugs = single ? ['example-check'] : languages.map((lang) => `example-check-${lang}`);
+    return [
+        ...checkFiles,
+        {
+            kind: 'recipes',
+            filename: 'example-recipe.mjs',
+            content: exampleRecipeSource(slugs),
+            stableId: 'URCP_example',
+        },
+    ];
+}
+/** fitness's COMPLETE stable example-id universe (every language's check id). */
+export function fitStableExampleIds() {
+    return Object.values(EXAMPLE_CHECK_IDS);
+}
+//# sourceMappingURL=examples.js.map

package/dist/scaffold/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../src/scaffold/examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,UAAU,EAAE,sCAAsC;IAClD,IAAI,EAAE,sCAAsC;IAC5C,MAAM,EAAE,sCAAsC;IAC9C,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,sCAAsC;IAC5C,GAAG,EAAE,sCAAsC;CAC5C,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,cAAc,GAAG,EAAE;IACtE,0DAA0D;IAC1D,mEAAmE;IACnE,wDAAwD;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,iBAAiB,cAAc,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;IAClF,OAAO;;;;;;;;;;;;;WAaE,iBAAiB,CAAC,QAAQ,CAAC,IAAI,EAAE;aAC/B,IAAI;;4BAEW,QAAQ;;;;;;;;;;;;;;;;;CAiBnC,CAAC;AACF,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO;;;;;;;;;;;;;;2CAckC,QAAQ;;;;CAIlD,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACtD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;IAEtC,wEAAwE;IACxE,uEAAuE;IACvE,mEAAmE;IACnE,MAAM,UAAU,GAAmB,MAAM;QACvC,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,mBAAmB;gBAC7B,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;gBACzD,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,IAAI,EAAE;aAChE;SACF;QACH,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,iBAAiB,IAAI,MAAM;YACrC,OAAO,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC;YACvC,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE;SACxC,CAAC,CAAC,CAAC;IAER,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAE5F,OAAO;QACL,GAAG,UAAU;QACb;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,oBAAoB;YAC9B,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC;YACnC,QAAQ,EAAE,cAAc;SACzB;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAC1C,CAAC"}

package/dist/scope-augmentation.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview RunScope augmentation for fitness.
+ *
+ * D7 (tool subscopes via module augmentation, per the RunScope/
+ * Registry architecture): tool-specific concerns nest under the tool's
+ * name on `RunScope` and are added via TypeScript module augmentation
+ * from the tool's own package. Core never imports fitness-shaped types —
+ * the layer rule stays intact (`core ← contracts ← {fitness, ...}`).
+ *
+ * Two singletons used to hang off this package as module-level state:
+ *
+ *   - `defaultRegistry`       — per-process check registry.
+ *   - `defaultRecipeRegistry` — per-process recipe registry.
+ *
+ * plus the per-process `ensureChecksLoaded` lifecycle state (the
+ * `checksLoadedFor` / `pluginLoadErrors` / `loadWarnings` triple).
+ *
+ * All of it is now per-RunScope. The fitness tool's `contributeScope`
+ * hook (in `tool.ts`) instantiates fresh registries + a fresh `load`
+ * marker and attaches them to `scope.fitness` once per CLI invocation.
+ * Tools and library code read via
+ * `currentScope()?.fitness?.{checks,recipes,load}`.
+ *
+ * The `fitness` slot is intentionally optional and mutable (no
+ * `readonly`) on the augmented interface: the kernel doesn't construct
+ * it, and only the fitness tool's `contributeScope` writes to it during
+ * scope construction. A run that doesn't load the fitness tool carries
+ * no `scope.fitness`, and reads return `undefined`.
+ */
+import type { CheckRegistry } from './framework/registry.js';
+import type { FitnessRecipeRegistry } from './recipes/registry.js';
+/**
+ * Per-RunScope `ensureChecksLoaded` lifecycle state — moved off the
+ * `check-loader.ts` module singletons so two concurrent scopes carry
+ * independent load state. Mutable: `ensureChecksLoaded` writes it once
+ * per run; the phase helpers (`buildFitEnvelope`, `buildFitDoneResult`)
+ * and the public accessors read it back.
+ */
+export interface FitnessLoadState {
+    /** Project directory for which `ensureChecksLoaded` has run to
+     *  completion in THIS scope. `null` before the first load; `''` is the
+     *  "loaded" sentinel for the no-project case. */
+    loadedFor: string | null;
+    /** Plugin load failures from the most recent `ensureChecksLoaded` call. */
+    pluginLoadErrors: readonly string[];
+    /** Non-fatal user-facing warnings collected during the most recent
+     *  `ensureChecksLoaded` call. */
+    loadWarnings: string[];
+}
+/**
+ * Per-RunScope fitness state. Constructed by the fitness tool's
+ * `contributeScope()` hook and attached to `scope.fitness`.
+ */
+export interface FitnessSubscope {
+    /** Check registry — populated by `loadAllPlugins` /
+     *  `loadDiscoveredCheckPackages` during `ensureChecksLoaded`. */
+    readonly checks: CheckRegistry;
+    /** Recipe registry — seeded with built-in recipes at construction;
+     *  plugin loader registers user recipes. */
+    readonly recipes: FitnessRecipeRegistry;
+    /** `ensureChecksLoaded` lifecycle state for this run. */
+    readonly load: FitnessLoadState;
+}
+declare module '@opensip-cli/core' {
+    interface ScopeContribution {
+        /**
+         * Fitness tool's per-run state. Returned by the fitness tool's
+         * `contributeScope` hook and installed by the kernel; absent in runs
+         * where the fitness tool is not registered. Consumers MUST null-check
+         * before reading. Augments `ScopeContribution`, which
+         * `ToolScope`/`RunScope` extend — so `cli.scope.fitness` /
+         * `currentScope()?.fitness` stay readable.
+         */
+        fitness?: FitnessSubscope;
+    }
+}
+//# sourceMappingURL=scope-augmentation.d.ts.map

package/dist/scope-augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-augmentation.d.ts","sourceRoot":"","sources":["../src/scope-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;qDAEiD;IACjD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;qCACiC;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;qEACiE;IACjE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B;gDAC4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,iBAAiB;QACzB;;;;;;;WAOG;QACH,OAAO,CAAC,EAAE,eAAe,CAAC;KAC3B;CACF"}

package/dist/scope-augmentation.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview RunScope augmentation for fitness.
+ *
+ * D7 (tool subscopes via module augmentation, per the RunScope/
+ * Registry architecture): tool-specific concerns nest under the tool's
+ * name on `RunScope` and are added via TypeScript module augmentation
+ * from the tool's own package. Core never imports fitness-shaped types —
+ * the layer rule stays intact (`core ← contracts ← {fitness, ...}`).
+ *
+ * Two singletons used to hang off this package as module-level state:
+ *
+ *   - `defaultRegistry`       — per-process check registry.
+ *   - `defaultRecipeRegistry` — per-process recipe registry.
+ *
+ * plus the per-process `ensureChecksLoaded` lifecycle state (the
+ * `checksLoadedFor` / `pluginLoadErrors` / `loadWarnings` triple).
+ *
+ * All of it is now per-RunScope. The fitness tool's `contributeScope`
+ * hook (in `tool.ts`) instantiates fresh registries + a fresh `load`
+ * marker and attaches them to `scope.fitness` once per CLI invocation.
+ * Tools and library code read via
+ * `currentScope()?.fitness?.{checks,recipes,load}`.
+ *
+ * The `fitness` slot is intentionally optional and mutable (no
+ * `readonly`) on the augmented interface: the kernel doesn't construct
+ * it, and only the fitness tool's `contributeScope` writes to it during
+ * scope construction. A run that doesn't load the fitness tool carries
+ * no `scope.fitness`, and reads return `undefined`.
+ */
+export {};
+//# sourceMappingURL=scope-augmentation.js.map

package/dist/scope-augmentation.js.map

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

package/dist/signalers/__tests__/loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader.test.d.ts.map

package/dist/signalers/__tests__/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../../src/signalers/__tests__/loader.test.ts"],"names":[],"mappings":""}

package/dist/signalers/__tests__/loader.test.js

@@ -0,0 +1,141 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { LanguageRegistry, RunScope, SystemError, ToolRegistry, ValidationError, runWithScopeSync, } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { loadSignalersConfig } from '../loader.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-signalers-loader-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('loadSignalersConfig', () => {
+    it('loads a minimal valid config', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), 'targets: {}\n');
+        const cfg = loadSignalersConfig(testDir);
+        expect(cfg.targets).toEqual({});
+        expect(cfg.fitness.failOnErrors).toBe(1);
+        expect(cfg.fitness.failOnWarnings).toBe(0);
+    });
+    it('parses targets with description, include, exclude', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), `targets:
+  src:
+    description: TS source
+    include:
+      - "src/**/*.ts"
+    exclude:
+      - "**/*.test.ts"
+    languages: [typescript]
+    concerns: [backend]
+`);
+        const cfg = loadSignalersConfig(testDir);
+        expect(cfg.targets.src?.description).toBe('TS source');
+        expect(cfg.targets.src?.include).toEqual(['src/**/*.ts']);
+    });
+    it('caches by resolved file path within the TTL', () => {
+        const path = join(testDir, 'opensip-cli.config.yml');
+        writeFileSync(path, 'targets: {}\n');
+        const a = loadSignalersConfig(testDir);
+        // Re-write the file content; cached load should not re-read.
+        writeFileSync(path, 'targets: {alt: {description: x, include: ["y"]}}\n');
+        const b = loadSignalersConfig(testDir);
+        expect(b).toBe(a); // same frozen reference
+    });
+    it('throws ValidationError when target name violates kebab-case', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), `targets:
+  Invalid_Name:
+    description: x
+    include: ["y"]
+`);
+        expect(() => loadSignalersConfig(testDir)).toThrow(ValidationError);
+    });
+    it('throws ValidationError when YAML is malformed', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), 'targets: [unbalanced\n');
+        expect(() => loadSignalersConfig(testDir)).toThrow(ValidationError);
+    });
+    it('throws SystemError when the file is too large', () => {
+        const huge = 'x'.repeat(11 * 1024 * 1024); // 11 MB > 10 MB limit
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), huge);
+        expect(() => loadSignalersConfig(testDir)).toThrow(SystemError);
+    });
+    it('respects an explicit --config path', () => {
+        writeFileSync(join(testDir, 'custom.yml'), 'targets: {}\n');
+        const cfg = loadSignalersConfig(testDir, join(testDir, 'custom.yml'));
+        expect(cfg.targets).toEqual({});
+    });
+    it('treats null YAML as an empty object', () => {
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), '');
+        const cfg = loadSignalersConfig(testDir);
+        expect(cfg.targets).toEqual({});
+    });
+    it('throws ValidationError when an explicit path points to a non-existent file', () => {
+        // resolveProjectConfigPath throws when --config points at a missing
+        // file. This validates that error path propagates cleanly.
+        expect(() => loadSignalersConfig(testDir, join(testDir, 'does-not-exist.yml'))).toThrow();
+    });
+    it('throws ValidationError when the resolved path is a directory (readFileSync EISDIR)', () => {
+        const dirAsConfig = join(testDir, 'opensip-cli.config.yml');
+        mkdirSync(dirAsConfig, { recursive: true });
+        expect(() => loadSignalersConfig(testDir)).toThrow();
+    });
+    it('treats explicit null section values as default empty objects', () => {
+        // Exercises the section() preprocess branch: v != null is preserved
+        // verbatim. Counterpart to "treats null YAML as empty object" — that
+        // test handles the nullish branch; this one covers the truthy branch.
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), `targets: {}
+fitness:
+  failOnErrors: 5
+`);
+        const cfg = loadSignalersConfig(testDir);
+        expect(cfg.fitness.failOnErrors).toBe(5);
+    });
+});
+/** Scope carrying a host-validated config document on its structural slot —
+ *  installed via Object.assign exactly like the CLI pre-action hook does
+ *  (scope-types.ts declares it readonly for readers). */
+const makeScopeWithDocument = (configDocument) => {
+    const scope = new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry() });
+    Object.assign(scope, { configDocument });
+    return scope;
+};
+describe('loadSignalersConfig — scope-first (ADR-0023 one-reader)', () => {
+    it('projects from scope.configDocument without touching the filesystem', () => {
+        // No config file exists in testDir — a file read would throw. The scope
+        // document alone must satisfy the load.
+        const scope = makeScopeWithDocument({
+            targets: { src: { description: 'TS source', include: ['src/**/*.ts'] } },
+            fitness: { failOnErrors: 3 },
+        });
+        const cfg = runWithScopeSync(scope, () => loadSignalersConfig(testDir));
+        expect(cfg.targets.src?.description).toBe('TS source');
+        expect(cfg.fitness.failOnErrors).toBe(3);
+    });
+    it('ignores a stale on-disk file when the scope carries the document', () => {
+        // The host read + validated the document at bootstrap; a file edited
+        // after bootstrap (or a different file the tool would have resolved)
+        // must NOT win over the scope-carried document.
+        writeFileSync(join(testDir, 'opensip-cli.config.yml'), 'targets: {}\nfitness:\n  failOnErrors: 99\n');
+        const scope = makeScopeWithDocument({ targets: {}, fitness: { failOnErrors: 2 } });
+        const cfg = runWithScopeSync(scope, () => loadSignalersConfig(testDir));
+        expect(cfg.fitness.failOnErrors).toBe(2);
+    });
+    it('memoizes the projection per document object (one parse per run)', () => {
+        const scope = makeScopeWithDocument({ targets: {} });
+        const a = runWithScopeSync(scope, () => loadSignalersConfig(testDir));
+        const b = runWithScopeSync(scope, () => loadSignalersConfig(testDir));
+        expect(b).toBe(a); // same frozen reference
+    });
+    it('falls back to the file read when the scope carries no document', () => {
+        // A scope WITHOUT configDocument (config-less/agnostic run) must keep the
+        // loud missing-config error — never silently validate an empty document.
+        const scope = new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry() });
+        expect(() => runWithScopeSync(scope, () => loadSignalersConfig(testDir))).toThrow(ValidationError);
+    });
+    it('still rejects an invalid scope document with the fitness error shape', () => {
+        const scope = makeScopeWithDocument({ targets: { 'Bad Name': { include: [] } } });
+        expect(() => runWithScopeSync(scope, () => loadSignalersConfig(testDir))).toThrow(ValidationError);
+    });
+});
+//# sourceMappingURL=loader.test.js.map

package/dist/signalers/__tests__/loader.test.js.map

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

package/dist/signalers/__tests__/violation-to-signal.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=violation-to-signal.test.d.ts.map

package/dist/signalers/__tests__/violation-to-signal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-to-signal.test.d.ts","sourceRoot":"","sources":["../../../src/signalers/__tests__/violation-to-signal.test.ts"],"names":[],"mappings":""}

package/dist/signalers/__tests__/violation-to-signal.test.js

@@ -0,0 +1,59 @@
+/**
+ * Unit tests for `violationToSignal` (ADR-0011, Phase 6) — the fitness
+ * violation → core `Signal` mapping. Guards the contract that the migration
+ * preserves: `source === ruleId === checkSlug`, the legacy 2-level severity is
+ * lifted UP into the 4-level `SignalSeverity` (never collapsed), and the
+ * file/line/column ride on `code` (and are mirrored to the flat fields).
+ *
+ * Pure mapping — no framework, no IO, no mocks. `createSignal` generates a
+ * non-deterministic `id`/`createdAt`, so those fields are asserted by shape,
+ * not value.
+ */
+import { describe, expect, it } from 'vitest';
+import { violationToSignal } from '../violation-to-signal.js';
+function violation(over = {}) {
+    return {
+        file: 'src/foo.ts',
+        line: 10,
+        column: 3,
+        message: 'Something is wrong',
+        severity: 'error',
+        ...over,
+    };
+}
+describe('violationToSignal', () => {
+    it('carries the check slug on both source and ruleId', () => {
+        const signal = violationToSignal('my-check-slug', violation());
+        expect(signal.source).toBe('my-check-slug');
+        expect(signal.ruleId).toBe('my-check-slug');
+    });
+    it('lifts legacy error → high (never collapses)', () => {
+        expect(violationToSignal('s', violation({ severity: 'error' })).severity).toBe('high');
+    });
+    it('lifts legacy warning → medium (never collapses)', () => {
+        expect(violationToSignal('s', violation({ severity: 'warning' })).severity).toBe('medium');
+    });
+    it('maps the code location and mirrors it to the flat fields', () => {
+        const signal = violationToSignal('s', violation({ file: 'src/bar.ts', line: 42, column: 7 }));
+        expect(signal.code).toEqual({ file: 'src/bar.ts', line: 42, column: 7 });
+        expect(signal.filePath).toBe('src/bar.ts');
+        expect(signal.line).toBe(42);
+        expect(signal.column).toBe(7);
+    });
+    it('preserves the message and the optional suggestion', () => {
+        const signal = violationToSignal('s', violation({ message: 'Bad import', suggestion: 'Use the barrel' }));
+        expect(signal.message).toBe('Bad import');
+        expect(signal.suggestion).toBe('Use the barrel');
+    });
+    it('defaults category to quality and provider to opensip-cli', () => {
+        const signal = violationToSignal('s', violation());
+        expect(signal.category).toBe('quality');
+        expect(signal.provider).toBe('opensip-cli');
+    });
+    it('produces a well-formed Signal id and ISO createdAt', () => {
+        const signal = violationToSignal('s', violation());
+        expect(signal.id).toMatch(/^sig_/);
+        expect(() => new Date(signal.createdAt).toISOString()).not.toThrow();
+    });
+});
+//# sourceMappingURL=violation-to-signal.test.js.map

package/dist/signalers/__tests__/violation-to-signal.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation-to-signal.test.js","sourceRoot":"","sources":["../../../src/signalers/__tests__/violation-to-signal.test.ts"],"names":[],"mappings":"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"}