@opensip-cli/core 0.1.0

package/dist/recipes/registry.js

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Generic recipe registry — shared plumbing for fitness
+ * and simulation recipe registries.
+ *
+ * Both fitness and simulation expose a "recipe" concept (a named bundle
+ * of selectors + execution options). The registry data structure they
+ * need is identical: a Map by id, a Map by name, register/lookup
+ * helpers, and a guarded duplicate-id policy. Only the recipe service —
+ * how a recipe's selector is resolved against the corresponding tool's
+ * registry of checks/scenarios — legitimately differs between the two
+ * tools, so the service stays per-package.
+ *
+ * Implemented on top of the kernel's unified `Registry<T>` base.
+ * `RecipeRegistry<T>` exposes the historical `allowOverwrite +
+ * throwOnDuplicate` flag-pair surface and routes per-call to the
+ * appropriate `inner.register(...)` invocation.
+ *
+ * The temp `protected byId`/`byName` shim that Phase 2 introduced is
+ * gone — both subclasses (`FitnessRecipeRegistry`,
+ * `SimulationRecipeRegistry`) now seed built-ins via
+ * `registerAll(builtIns, { internal: true })` (LSP-clean).
+ */
+import { ValidationError } from '../lib/errors.js';
+import { Registry } from '../lib/registry.js';
+/**
+ * Process-wide policy: duplicate id/name with `allowOverwrite: false`
+ * keeps the first entry and emits a warning. Use `register(.., {
+ * throwOnDuplicate: true })` to opt into the historical fitness/sim
+ * "throw on duplicate" contract.
+ */
+export class RecipeRegistry {
+    inner;
+    module;
+    validationCode;
+    constructor(options = {}) {
+        this.module = options.module ?? 'core:recipes';
+        this.validationCode = options.validationCode ?? 'VALIDATION.RECIPE.DUPLICATE';
+        this.inner = new Registry({
+            module: this.module,
+            duplicatePolicy: 'warn-first-wins',
+            evtPrefix: 'recipe.registry',
+            validationCode: this.validationCode,
+            logger: options.logger,
+        });
+    }
+    /**
+     * Register a recipe.
+     *
+     * - Default: refuses on duplicate id/name; logs a `recipe.registry.duplicate` warning.
+     * - `{ allowOverwrite: true }`: replaces the existing entry.
+     * - `{ throwOnDuplicate: true }`: throws a `ValidationError` instead of warning.
+     *   Mutually exclusive with `allowOverwrite`.
+     * - `{ internal: true }`: bypasses the duplicate guard. Used for
+     *   built-in seeding in subclasses.
+     */
+    register(recipe, options = {}) {
+        const { allowOverwrite = false, throwOnDuplicate = false, internal = false } = options;
+        if (allowOverwrite && throwOnDuplicate) {
+            // The two flags advertise contradictory behaviours; honour the
+            // JSDoc claim of mutual exclusion at runtime so a defensive
+            // caller that sets both doesn't silently get the overwrite
+            // path with no diagnostic.
+            // @fitness-ignore-next-line result-pattern-consistency -- registration guard, throw is appropriate
+            throw new ValidationError(`RecipeRegistry.register: 'allowOverwrite' and 'throwOnDuplicate' are mutually exclusive`, { code: options.validationCode ?? this.validationCode });
+        }
+        if (internal) {
+            this.inner.register(recipe, { internal: true });
+            return;
+        }
+        if (allowOverwrite) {
+            // Overwrite path: clean up stale name/id mappings and re-insert.
+            const incumbentById = this.inner.getById(recipe.id);
+            const incumbentByName = this.inner.getByName(recipe.name);
+            if (incumbentById && incumbentById.name !== recipe.name) {
+                this.inner.remove(incumbentById.id);
+            }
+            if (incumbentByName && incumbentByName.id !== recipe.id) {
+                this.inner.remove(incumbentByName.id);
+            }
+            this.inner.register(recipe, { internal: true });
+            return;
+        }
+        if (throwOnDuplicate) {
+            const dup = this.inner.has(recipe.id) ||
+                (this.inner.has(recipe.name) && this.inner.getByName(recipe.name)?.id !== recipe.id);
+            if (dup) {
+                // @fitness-ignore-next-line result-pattern-consistency -- registration guard, throw is appropriate
+                throw new ValidationError(`Recipe '${recipe.name}' (${recipe.id}) already registered`, {
+                    code: options.validationCode ?? this.validationCode,
+                });
+            }
+            this.inner.register(recipe, { internal: true });
+            return;
+        }
+        // Default warn-first-wins via the inner base.
+        this.inner.register(recipe);
+    }
+    /** Register many recipes with shared options. */
+    registerAll(recipes, options = {}) {
+        for (const recipe of recipes) {
+            this.register(recipe, options);
+        }
+    }
+    /** Look up a recipe by name first, falling back to id. */
+    loadRecipe(nameOrId) {
+        return this.inner.getByName(nameOrId) ?? this.inner.getById(nameOrId);
+    }
+    getByName(name) {
+        return this.inner.getByName(name);
+    }
+    getById(id) {
+        return this.inner.getById(id);
+    }
+    has(nameOrId) {
+        return this.inner.has(nameOrId);
+    }
+    /** All registered recipes, in registration order. */
+    getAllRecipes() {
+        return this.inner.getAll();
+    }
+    /** All registered recipe names, in registration order. */
+    getNames() {
+        return this.inner.getAll().map((r) => r.name);
+    }
+    /** Recipes with a given tag. */
+    getByTag(tag) {
+        return this.inner.getByTag(tag);
+    }
+    get size() {
+        return this.inner.size;
+    }
+    /** Remove a recipe by id. Returns true if it existed. */
+    remove(id) {
+        return this.inner.remove(id);
+    }
+    /** Drop every entry. */
+    clear() {
+        this.inner.clear();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/recipes/registry.js.map

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

package/dist/recipes/selector.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @fileoverview Generic recipe selector union + resolver — the selection
+ * half of the recipe substrate (the registry half lives in `./registry.ts`).
+ *
+ * A recipe selects a named subset of registered units (checks today,
+ * scenarios, rules later). The four common selection shapes —
+ * `explicit` / `all` / `tags` / `pattern` — are structurally identical
+ * across tools; only unit-specific fields (e.g. fitness `config`, sim
+ * `kind`) diverge. This module owns the shared union and a resolver
+ * generic over the kernel `Registerable` surface (`id` / `name` / `tags`).
+ *
+ * **Layer-safe by construction.** Core never names a tool type or pulls a
+ * tool dependency. Everything tool-specific arrives injected:
+ *   - `keysOf(item)` — the match keys an item exposes (fitness: namespaced
+ *     slug + bare slug + tag/slug targets; sim: `[id, name]`).
+ *   - `match(target, pattern)` — the glob matcher for the `pattern` arm
+ *     (fitness injects `minimatch`; `minimatch` stays out of core).
+ *   - `resolveExplicit(id, items)` — a tool's fallback lookup for an
+ *     explicit id that is not itself a primary key (fitness's
+ *     bare-slug → namespaced-key resolution).
+ *   - `predicates` — a per-arm predicate map for arms core cannot name
+ *     (sim's `kind`) **or** arms whose semantics differ from core's
+ *     built-in (sim's `tags`, which excludes on id/name rather than tags).
+ *
+ * **Selection only, never execution.** The resolver returns the selected
+ * items; each tool's service consumes them with its own scheduler. This
+ * is the load-bearing seam the symmetric-tool architecture (ADR-0005)
+ * draws — execution stays tool-owned.
+ *
+ * **`tags` semantics.** Core's built-in `tags` arm intersects an item's
+ * tags with `include` and rejects on `exclude` (matching fitness's
+ * `resolveTagsSelector`). A tool whose `tags` arm means something else
+ * (sim excludes on id/name) supplies a `tags` predicate instead, which
+ * overrides the built-in arm — see `predicates` below.
+ */
+import type { RecipeUnitConfigMap } from './unit-config.js';
+import type { Registerable } from '../lib/registry.js';
+/** Select an explicit, ordered list of units by id. */
+export interface ExplicitSelector {
+    readonly type: 'explicit';
+    readonly ids: readonly string[];
+    readonly config?: RecipeUnitConfigMap;
+}
+/** Select every unit, with optional pattern-based exclusions. */
+export interface AllSelector {
+    readonly type: 'all';
+    readonly exclude?: readonly string[];
+    readonly config?: RecipeUnitConfigMap;
+}
+/** Select units whose tags intersect `include` and avoid `exclude`. */
+export interface TagsSelector {
+    readonly type: 'tags';
+    readonly include: readonly string[];
+    readonly exclude?: readonly string[];
+    readonly config?: RecipeUnitConfigMap;
+}
+/** Select units whose match keys glob-match `include` and avoid `exclude`. */
+export interface PatternSelector {
+    readonly type: 'pattern';
+    readonly include: readonly string[];
+    readonly exclude?: readonly string[];
+    readonly config?: RecipeUnitConfigMap;
+}
+/**
+ * The generic selector union. Tools alias the `explicit` arm's `ids` to
+ * their historical field name (fitness `checkIds`, sim `scenarioIds`) in
+ * their own `types.ts` so existing recipe literals are unchanged, and may
+ * extend the union with tool-only arms (sim `kind`).
+ */
+export type RecipeSelector = ExplicitSelector | AllSelector | TagsSelector | PatternSelector;
+/** Glob matcher injected by the tool for the `pattern` / `all` arms. */
+type Matcher = (target: string, pattern: string) => boolean;
+/**
+ * Injected, tool-supplied resolution hooks. Keeping these external is what
+ * lets core resolve selectors without naming any tool type.
+ */
+export interface ResolveSelectorOptions<T extends Registerable, S extends {
+    readonly type: string;
+}> {
+    /** Match keys for an item — used by the `all` and `pattern` arms. */
+    readonly keysOf: (item: T) => readonly string[];
+    /** Tags an item carries — used by the built-in `tags` arm. Defaults to `item.tags ?? []`. */
+    readonly tagsOf?: (item: T) => readonly string[];
+    /** Glob matcher for `pattern` / `all` exclude matching. Required only if such an arm reaches the resolver. */
+    readonly match?: Matcher;
+    /**
+     * Fallback lookup for an `explicit` id that is not itself a primary key
+     * — e.g. fitness's bare-slug → namespaced-key resolution. Returns the
+     * canonical primary key, or `undefined`. When omitted, explicit ids are
+     * matched as literal primary keys only.
+     */
+    readonly resolveExplicit?: (id: string, items: readonly T[]) => string | undefined;
+    /**
+     * Per-arm predicates for arms core cannot name (sim `kind`) or whose
+     * semantics differ from the built-in arm (sim `tags`). Keyed by arm
+     * `type`; when present for the active arm it overrides the built-in.
+     */
+    readonly predicates?: Readonly<Record<string, (item: T, selector: S) => boolean>>;
+}
+/**
+ * Resolve a selector against a caller-supplied item list, returning the
+ * selected items in the appropriate order. Pure — no logging, no I/O.
+ *
+ * A tool-supplied predicate for the active arm overrides the built-in
+ * resolution, so a tool whose arm semantics differ (or whose arm core
+ * cannot name) stays byte-exact without core knowing about it.
+ */
+export declare function resolveSelector<T extends Registerable, S extends {
+    readonly type: string;
+}>(selector: S, items: readonly T[], opts: ResolveSelectorOptions<T, S>): readonly T[];
+export {};
+//# sourceMappingURL=selector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/recipes/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,eAAe,CAAC;AAE7F,wEAAwE;AACxE,KAAK,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CACrC,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;IAEnC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC;IAChD,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,MAAM,EAAE,CAAC;IACjD,8GAA8G;IAC9G,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IACnF;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;CACnF;AAqFD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACzF,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,IAAI,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjC,SAAS,CAAC,EAAE,CAqCd"}

package/dist/recipes/selector.js

@@ -0,0 +1,134 @@
+/**
+ * @fileoverview Generic recipe selector union + resolver — the selection
+ * half of the recipe substrate (the registry half lives in `./registry.ts`).
+ *
+ * A recipe selects a named subset of registered units (checks today,
+ * scenarios, rules later). The four common selection shapes —
+ * `explicit` / `all` / `tags` / `pattern` — are structurally identical
+ * across tools; only unit-specific fields (e.g. fitness `config`, sim
+ * `kind`) diverge. This module owns the shared union and a resolver
+ * generic over the kernel `Registerable` surface (`id` / `name` / `tags`).
+ *
+ * **Layer-safe by construction.** Core never names a tool type or pulls a
+ * tool dependency. Everything tool-specific arrives injected:
+ *   - `keysOf(item)` — the match keys an item exposes (fitness: namespaced
+ *     slug + bare slug + tag/slug targets; sim: `[id, name]`).
+ *   - `match(target, pattern)` — the glob matcher for the `pattern` arm
+ *     (fitness injects `minimatch`; `minimatch` stays out of core).
+ *   - `resolveExplicit(id, items)` — a tool's fallback lookup for an
+ *     explicit id that is not itself a primary key (fitness's
+ *     bare-slug → namespaced-key resolution).
+ *   - `predicates` — a per-arm predicate map for arms core cannot name
+ *     (sim's `kind`) **or** arms whose semantics differ from core's
+ *     built-in (sim's `tags`, which excludes on id/name rather than tags).
+ *
+ * **Selection only, never execution.** The resolver returns the selected
+ * items; each tool's service consumes them with its own scheduler. This
+ * is the load-bearing seam the symmetric-tool architecture (ADR-0005)
+ * draws — execution stays tool-owned.
+ *
+ * **`tags` semantics.** Core's built-in `tags` arm intersects an item's
+ * tags with `include` and rejects on `exclude` (matching fitness's
+ * `resolveTagsSelector`). A tool whose `tags` arm means something else
+ * (sim excludes on id/name) supplies a `tags` predicate instead, which
+ * overrides the built-in arm — see `predicates` below.
+ */
+import { SystemError } from '../lib/errors.js';
+const NO_MATCHER_CODE = 'SYSTEM.CORE.SELECTOR_NO_MATCHER';
+const UNKNOWN_SELECTOR_CODE = 'SYSTEM.CORE.UNKNOWN_SELECTOR';
+function requireMatcher(match, arm) {
+    if (match === undefined) {
+        // @fitness-ignore-next-line result-pattern-consistency -- programmer error: a pattern/all-exclude arm reached the resolver without an injected matcher
+        throw new SystemError(`resolveSelector: '${arm}' selector needs a 'match' matcher but none was supplied`, {
+            code: NO_MATCHER_CODE,
+        });
+    }
+    return match;
+}
+/** `explicit`: exact primary-key match then injected fallback; request order; no de-dup. */
+function resolveExplicitArm(ids, items, resolveExplicit) {
+    const byId = new Map();
+    for (const item of items)
+        byId.set(item.id, item);
+    const result = [];
+    for (const id of ids) {
+        let item = byId.get(id);
+        if (item === undefined && resolveExplicit !== undefined) {
+            const key = resolveExplicit(id, items);
+            if (key !== undefined)
+                item = byId.get(key);
+        }
+        if (item !== undefined)
+            result.push(item);
+    }
+    return result;
+}
+/** `all`: every item, minus any whose match keys glob-match an exclude pattern. */
+function resolveAllArm(exclude, items, keysOf, match) {
+    if (exclude.length === 0)
+        return items;
+    const matcher = requireMatcher(match, 'all');
+    return items.filter((item) => {
+        const targets = keysOf(item);
+        return !exclude.some((pattern) => targets.some((target) => matcher(target, pattern)));
+    });
+}
+/** `tags`: items whose tags intersect `include` and avoid `exclude` (tag-based). */
+function resolveTagsArm(include, exclude, items, tagsOf) {
+    const includeSet = new Set(include);
+    const excludeSet = new Set(exclude);
+    return items.filter((item) => {
+        const tags = tagsOf(item);
+        return tags.some((tag) => includeSet.has(tag)) && !tags.some((tag) => excludeSet.has(tag));
+    });
+}
+/** `pattern`: items whose match keys glob-match some `include` and no `exclude`. */
+function resolvePatternArm(include, exclude, items, keysOf, match) {
+    const matcher = requireMatcher(match, 'pattern');
+    return items.filter((item) => {
+        const targets = keysOf(item);
+        const included = include.some((pattern) => targets.some((target) => matcher(target, pattern)));
+        if (!included)
+            return false;
+        return !exclude.some((pattern) => targets.some((target) => matcher(target, pattern)));
+    });
+}
+/**
+ * Resolve a selector against a caller-supplied item list, returning the
+ * selected items in the appropriate order. Pure — no logging, no I/O.
+ *
+ * A tool-supplied predicate for the active arm overrides the built-in
+ * resolution, so a tool whose arm semantics differ (or whose arm core
+ * cannot name) stays byte-exact without core knowing about it.
+ */
+export function resolveSelector(selector, items, opts) {
+    // Tool-supplied predicates override any arm (built-in or tool-only).
+    const predicate = opts.predicates?.[selector.type];
+    if (predicate)
+        return items.filter((item) => predicate(item, selector));
+    const arm = selector;
+    switch (arm.type) {
+        case 'explicit': {
+            return resolveExplicitArm(arm.ids, items, opts.resolveExplicit);
+        }
+        case 'all': {
+            return resolveAllArm(arm.exclude ?? [], items, opts.keysOf, opts.match);
+        }
+        case 'tags': {
+            return resolveTagsArm(arm.include, arm.exclude ?? [], items, opts.tagsOf ?? ((item) => item.tags ?? []));
+        }
+        case 'pattern': {
+            return resolvePatternArm(arm.include, arm.exclude ?? [], items, opts.keysOf, opts.match);
+        }
+        /* v8 ignore start -- exhaustive guard: a tool-only arm with no matching predicate lands here */
+        default: {
+            const _exhaustive = arm;
+            // @fitness-ignore-next-line result-pattern-consistency -- programmer error: unknown selector arm with no predicate
+            throw new SystemError(`resolveSelector: unknown selector type: ${JSON.stringify(_exhaustive)}`, {
+                code: UNKNOWN_SELECTOR_CODE,
+            });
+        }
+        /* v8 ignore stop */
+    }
+}
+//# sourceMappingURL=selector.js.map

package/dist/recipes/selector.js.map

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

package/dist/recipes/unit-config.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Per-unit recipe configuration accessors — the generic
+ * half of the recipe substrate's config-override surface.
+ *
+ * A recipe can carry a `config` map keyed by unit slug. Tool-specific recipe
+ * services project this map into the current `RunScope`'s `recipeUnitConfig`
+ * slot before any unit runs and clear it once the run completes. Each unit
+ * reads its slice via `getUnitConfig<T>(slug)` and merges it with its built-in
+ * defaults.
+ *
+ * Scope-bound (not module-bound) lookup is load-bearing — the runtime
+ * frequently has TWO copies of a tool package loaded:
+ *
+ *   1. The CLI's bundled copy (running the recipe service).
+ *   2. A plugin pack's resolved copy (running the unit, calling
+ *      `getUnitConfig(slug)`).
+ *
+ * Each copy has its own module-scope state. Routing through
+ * `currentScope()` binds the slot identity to core (a single resolved
+ * copy in every npm graph) rather than to whichever tool copy loaded
+ * first. (See `packages/fitness/engine/src/recipes/check-config.ts` for
+ * the original, fitness-named accessors that now re-export these.)
+ *
+ * Calling `getUnitConfig(...)` outside any `runWithScope` (e.g. unit
+ * tests that don't set up a scope) returns an empty object — the unit's
+ * own defaults handle the empty case.
+ *
+ * The slot name (`recipeUnitConfig`) and its `RecipeUnitConfigSlot`
+ * type are now unit-neutral, matching the generalized accessors and map type.
+ */
+import type { RunScope } from '../lib/run-scope.js';
+/**
+ * Per-unit configuration map. Keys are unit slugs; values are
+ * unit-specific config objects whose shape the consuming unit declares.
+ */
+export type RecipeUnitConfigMap = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+/**
+ * Read the per-unit config slice for the given slug.
+ *
+ * Returns an empty object when no recipe-config has been set or no entry
+ * exists for the slug — treat the result as "augmentation only" and merge
+ * with the unit's own defaults. The stored entry is returned cast to `T`
+ * without runtime validation; each unit owns its defaults and tolerates
+ * the empty case.
+ *
+ * @typeParam T - The shape the calling unit expects.
+ */
+export declare function getUnitConfig<T extends Record<string, unknown>>(slug: string): T;
+/**
+ * Replace the current scope's recipe config. Called by a recipe service at
+ * the start of a recipe run, before any unit executes.
+ *
+ * Takes a scope explicitly rather than reading `currentScope()` so callers
+ * make the scope boundary explicit and lifecycle errors surface as type
+ * errors rather than silently no-op'ing outside a scope.
+ */
+export declare function setCurrentRecipeUnitConfig(scope: RunScope, config: RecipeUnitConfigMap | undefined): void;
+/**
+ * Clear the current scope's recipe config. Called by a recipe service at
+ * the end of a recipe run (success or failure).
+ */
+export declare function clearCurrentRecipeUnitConfig(scope: RunScope): void;
+//# sourceMappingURL=unit-config.d.ts.map

package/dist/recipes/unit-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-config.d.ts","sourceRoot":"","sources":["../../src/recipes/unit-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9F;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAKhF;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACtC,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAElE"}

package/dist/recipes/unit-config.js

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Per-unit recipe configuration accessors — the generic
+ * half of the recipe substrate's config-override surface.
+ *
+ * A recipe can carry a `config` map keyed by unit slug. Tool-specific recipe
+ * services project this map into the current `RunScope`'s `recipeUnitConfig`
+ * slot before any unit runs and clear it once the run completes. Each unit
+ * reads its slice via `getUnitConfig<T>(slug)` and merges it with its built-in
+ * defaults.
+ *
+ * Scope-bound (not module-bound) lookup is load-bearing — the runtime
+ * frequently has TWO copies of a tool package loaded:
+ *
+ *   1. The CLI's bundled copy (running the recipe service).
+ *   2. A plugin pack's resolved copy (running the unit, calling
+ *      `getUnitConfig(slug)`).
+ *
+ * Each copy has its own module-scope state. Routing through
+ * `currentScope()` binds the slot identity to core (a single resolved
+ * copy in every npm graph) rather than to whichever tool copy loaded
+ * first. (See `packages/fitness/engine/src/recipes/check-config.ts` for
+ * the original, fitness-named accessors that now re-export these.)
+ *
+ * Calling `getUnitConfig(...)` outside any `runWithScope` (e.g. unit
+ * tests that don't set up a scope) returns an empty object — the unit's
+ * own defaults handle the empty case.
+ *
+ * The slot name (`recipeUnitConfig`) and its `RecipeUnitConfigSlot`
+ * type are now unit-neutral, matching the generalized accessors and map type.
+ */
+import { currentScope } from '../lib/run-scope.js';
+/**
+ * Read the per-unit config slice for the given slug.
+ *
+ * Returns an empty object when no recipe-config has been set or no entry
+ * exists for the slug — treat the result as "augmentation only" and merge
+ * with the unit's own defaults. The stored entry is returned cast to `T`
+ * without runtime validation; each unit owns its defaults and tolerates
+ * the empty case.
+ *
+ * @typeParam T - The shape the calling unit expects.
+ */
+export function getUnitConfig(slug) {
+    const scope = currentScope();
+    const entry = scope?.recipeUnitConfig.get(slug);
+    if (!entry)
+        return {};
+    return entry;
+}
+/**
+ * Replace the current scope's recipe config. Called by a recipe service at
+ * the start of a recipe run, before any unit executes.
+ *
+ * Takes a scope explicitly rather than reading `currentScope()` so callers
+ * make the scope boundary explicit and lifecycle errors surface as type
+ * errors rather than silently no-op'ing outside a scope.
+ */
+export function setCurrentRecipeUnitConfig(scope, config) {
+    scope.recipeUnitConfig.setAll(config ?? {});
+}
+/**
+ * Clear the current scope's recipe config. Called by a recipe service at
+ * the end of a recipe run (success or failure).
+ */
+export function clearCurrentRecipeUnitConfig(scope) {
+    scope.recipeUnitConfig.clear();
+}
+//# sourceMappingURL=unit-config.js.map

package/dist/recipes/unit-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-config.js","sourceRoot":"","sources":["../../src/recipes/unit-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAoC,IAAY;IAC3E,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAI,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAO,CAAC;IAC3B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAe,EACf,MAAuC;IAEvC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAAe;IAC1D,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/runtime/__tests__/in-process-transport.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * In-process ProgressTransport (ADR-0016): event fan-out, pre-subscribe
+ * buffering, and result resolution/rejection.
+ */
+export {};
+//# sourceMappingURL=in-process-transport.test.d.ts.map

package/dist/runtime/__tests__/in-process-transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-transport.test.d.ts","sourceRoot":"","sources":["../../../src/runtime/__tests__/in-process-transport.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/runtime/__tests__/in-process-transport.test.js

@@ -0,0 +1,73 @@
+/**
+ * In-process ProgressTransport (ADR-0016): event fan-out, pre-subscribe
+ * buffering, and result resolution/rejection.
+ */
+import { describe, it, expect } from 'vitest';
+import { createInProcessTransport } from '../in-process-transport.js';
+describe('createInProcessTransport', () => {
+    it('resolves the job result and delivers its events', async () => {
+        const transport = createInProcessTransport();
+        const events = [];
+        const run = transport.run((emit) => {
+            emit(1);
+            emit(2);
+            return Promise.resolve('done');
+        });
+        run.onProgress((e) => events.push(e));
+        const result = await run.result;
+        expect(result).toBe('done');
+        expect(events).toEqual([1, 2]);
+    });
+    it('buffers events emitted before subscription and flushes them in order', async () => {
+        const transport = createInProcessTransport();
+        const events = [];
+        // The job emits synchronously inside run(), BEFORE onProgress is called —
+        // these must be buffered and replayed on subscription, not dropped.
+        const run = transport.run((emit) => {
+            emit('a');
+            emit('b');
+            return Promise.resolve();
+        });
+        run.onProgress((e) => events.push(e));
+        await run.result;
+        expect(events).toEqual(['a', 'b']);
+    });
+    it('delivers events emitted after subscription live, in order', async () => {
+        const transport = createInProcessTransport();
+        const events = [];
+        let emitFn;
+        const run = transport.run((emit) => {
+            emitFn = emit;
+            return new Promise((resolve) => {
+                setTimeout(resolve, 5);
+            });
+        });
+        run.onProgress((e) => events.push(e));
+        emitFn?.('live1');
+        emitFn?.('live2');
+        await run.result;
+        expect(events).toEqual(['live1', 'live2']);
+    });
+    it('combines buffered + live events in one ordered stream', async () => {
+        const transport = createInProcessTransport();
+        const events = [];
+        let emitFn;
+        const run = transport.run((emit) => {
+            emit('buffered');
+            emitFn = emit;
+            return new Promise((resolve) => {
+                setTimeout(resolve, 5);
+            });
+        });
+        run.onProgress((e) => events.push(e));
+        emitFn?.('live');
+        await run.result;
+        expect(events).toEqual(['buffered', 'live']);
+    });
+    it('rejects result when the job rejects', async () => {
+        const transport = createInProcessTransport();
+        const run = transport.run(() => Promise.reject(new Error('boom')));
+        await expect(run.result).rejects.toThrow('boom');
+    });
+});
+//# sourceMappingURL=in-process-transport.test.js.map

package/dist/runtime/__tests__/in-process-transport.test.js.map

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

package/dist/runtime/__tests__/subprocess-transport.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Subprocess ProgressTransport (ADR-0028): forks the fixture worker over real
+ * IPC and asserts the relay contract — event fan-out, pre-subscribe buffering,
+ * result resolution, error propagation (message / throw / premature exit),
+ * advanced-serialization payloads, and the in-process fallback selector.
+ *
+ * These spawn a real child process, so the suite is slower than the in-process
+ * sibling; the fixture is a tiny `.mjs` run directly by node (no transform).
+ */
+export {};
+//# sourceMappingURL=subprocess-transport.test.d.ts.map