@opensip-cli/core 0.1.0

package/dist/recipes/__tests__/registry.test.js

@@ -0,0 +1,170 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { ValidationError } from '../../lib/errors.js';
+import { logger } from '../../lib/logger.js';
+import { RecipeRegistry } from '../registry.js';
+const stub = (id, name, opts = {}) => ({
+    id,
+    name,
+    displayName: opts.displayName ?? name,
+    description: opts.description ?? `${name} stub`,
+    tags: opts.tags,
+    extra: opts.extra,
+});
+describe('RecipeRegistry', () => {
+    let reg;
+    let warnSpy;
+    beforeEach(() => {
+        reg = new RecipeRegistry({ module: 'test:recipes' });
+        warnSpy = vi.spyOn(logger, 'warn').mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('registers and looks up by id and name', () => {
+        const r = stub('A', 'alpha');
+        reg.register(r);
+        expect(reg.getById('A')).toBe(r);
+        expect(reg.getByName('alpha')).toBe(r);
+        expect(reg.has('A')).toBe(true);
+        expect(reg.has('alpha')).toBe(true);
+    });
+    it('loadRecipe falls back from name to id', () => {
+        const r = stub('A', 'alpha');
+        reg.register(r);
+        expect(reg.loadRecipe('alpha')).toBe(r);
+        expect(reg.loadRecipe('A')).toBe(r);
+        expect(reg.loadRecipe('nope')).toBeUndefined();
+    });
+    it('getAllRecipes returns the registered set in registration order', () => {
+        reg.register(stub('A', 'alpha'));
+        reg.register(stub('B', 'beta'));
+        expect(reg.getAllRecipes().map((r) => r.id)).toEqual(['A', 'B']);
+    });
+    it('getNames returns all registered names', () => {
+        reg.register(stub('A', 'alpha'));
+        reg.register(stub('B', 'beta'));
+        expect(reg.getNames()).toEqual(['alpha', 'beta']);
+    });
+    it('getByTag filters by recipe tags', () => {
+        reg.register(stub('A', 'alpha', { tags: ['fast'] }));
+        reg.register(stub('B', 'beta', { tags: ['slow'] }));
+        reg.register(stub('C', 'gamma'));
+        expect(reg.getByTag('fast').map((r) => r.id)).toEqual(['A']);
+    });
+    it('size reflects the registered count', () => {
+        expect(reg.size).toBe(0);
+        reg.register(stub('A', 'alpha'));
+        expect(reg.size).toBe(1);
+        reg.register(stub('B', 'beta'));
+        expect(reg.size).toBe(2);
+    });
+    it('remove(id) drops both the byId and byName entries', () => {
+        reg.register(stub('A', 'alpha'));
+        expect(reg.remove('A')).toBe(true);
+        expect(reg.getById('A')).toBeUndefined();
+        expect(reg.getByName('alpha')).toBeUndefined();
+        expect(reg.remove('A')).toBe(false);
+    });
+    it('clear() drops every entry', () => {
+        reg.register(stub('A', 'alpha'));
+        reg.register(stub('B', 'beta'));
+        reg.clear();
+        expect(reg.size).toBe(0);
+        expect(reg.getAllRecipes()).toEqual([]);
+    });
+    it('registerAll registers a batch with shared options', () => {
+        reg.registerAll([stub('A', 'alpha'), stub('B', 'beta')]);
+        expect(reg.size).toBe(2);
+    });
+    describe('duplicate-id policy', () => {
+        it('default: keeps the first entry, emits a warning', () => {
+            const first = stub('A', 'alpha', { extra: 'first' });
+            const second = stub('A', 'alpha', { extra: 'second' });
+            reg.register(first);
+            reg.register(second);
+            expect(reg.getById('A')).toBe(first);
+            expect(warnSpy).toHaveBeenCalledWith(expect.objectContaining({
+                evt: 'recipe.registry.duplicate',
+                module: 'test:recipes',
+                id: 'A',
+                name: 'alpha',
+            }));
+        });
+        it('also rejects on duplicate name (different id)', () => {
+            reg.register(stub('A', 'alpha'));
+            reg.register(stub('B', 'alpha'));
+            expect(reg.size).toBe(1);
+            expect(reg.getById('B')).toBeUndefined();
+        });
+        it('{ allowOverwrite: true } replaces the entry and keeps mappings consistent', () => {
+            reg.register(stub('A', 'alpha', { extra: 'first' }));
+            const replacement = stub('A', 'alpha', { extra: 'second' });
+            reg.register(replacement, { allowOverwrite: true });
+            expect(reg.getById('A')).toBe(replacement);
+            expect(reg.getByName('alpha')).toBe(replacement);
+            expect(reg.size).toBe(1);
+        });
+        it('{ allowOverwrite: true } with a different id but same name cleans up the stale id', () => {
+            reg.register(stub('A', 'alpha'));
+            const replacement = stub('B', 'alpha');
+            reg.register(replacement, { allowOverwrite: true });
+            expect(reg.getById('A')).toBeUndefined();
+            expect(reg.getById('B')).toBe(replacement);
+            expect(reg.getByName('alpha')).toBe(replacement);
+            expect(reg.size).toBe(1);
+        });
+        it('{ throwOnDuplicate: true } throws ValidationError', () => {
+            reg.register(stub('A', 'alpha'));
+            expect(() => reg.register(stub('A', 'alpha'), { throwOnDuplicate: true })).toThrow(ValidationError);
+        });
+        it('{ throwOnDuplicate: true } honours the per-call validationCode override', () => {
+            reg.register(stub('A', 'alpha'));
+            try {
+                reg.register(stub('A', 'alpha'), {
+                    throwOnDuplicate: true,
+                    validationCode: 'VALIDATION.TEST.CUSTOM',
+                });
+                expect.fail('should have thrown');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(ValidationError);
+                expect(error.code).toBe('VALIDATION.TEST.CUSTOM');
+            }
+        });
+        it('{ throwOnDuplicate: true } registers normally when there is no duplicate', () => {
+            reg.register(stub('A', 'alpha'));
+            const fresh = stub('B', 'beta');
+            reg.register(fresh, { throwOnDuplicate: true });
+            expect(reg.getById('B')).toBe(fresh);
+            expect(reg.size).toBe(2);
+        });
+        it('{ internal: true } bypasses the duplicate guard and overwrites silently', () => {
+            const first = stub('A', 'alpha', { extra: 'first' });
+            const second = stub('A', 'alpha', { extra: 'second' });
+            reg.register(first, { internal: true });
+            reg.register(second, { internal: true });
+            expect(reg.getById('A')).toBe(second);
+            expect(warnSpy).not.toHaveBeenCalled();
+        });
+        it('{ allowOverwrite: true } with a same id but different name removes the stale name mapping', () => {
+            reg.register(stub('A', 'alpha'));
+            const replacement = stub('A', 'beta');
+            reg.register(replacement, { allowOverwrite: true });
+            expect(reg.getById('A')).toBe(replacement);
+            expect(reg.getByName('beta')).toBe(replacement);
+            // The stale 'alpha' name mapping is gone.
+            expect(reg.getByName('alpha')).toBeUndefined();
+            expect(reg.size).toBe(1);
+        });
+        it('rejects { allowOverwrite: true, throwOnDuplicate: true } as mutually exclusive', () => {
+            // The two flags advertise contradictory semantics; passing both
+            // is a programmer error and should throw rather than silently
+            // pick one (audit 2026-05-23 / N3).
+            expect(() => reg.register(stub('A', 'alpha'), {
+                allowOverwrite: true,
+                throwOnDuplicate: true,
+            })).toThrow(ValidationError);
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/recipes/__tests__/registry.test.js.map

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

package/dist/recipes/__tests__/selector.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Characterization + unit tests for the generic recipe
+ * resolver (`resolveSelector`).
+ *
+ * The resolver is the selection algorithm fitness (`resolveChecks`) and
+ * simulation (in-service resolver) now delegate to. These tests lock its
+ * output for each arm, the predicate-override path, and the two
+ * programmer-error guards — independent of any tool (core cannot import
+ * fitness/sim). The real no-behavior-change proof for the tools lives in
+ * their own suites, which pass unedited; this pins the substrate itself.
+ *
+ * Expected outputs are asserted with explicit `toEqual` (not auto-filled
+ * snapshots) so the locked values are hand-reviewed in the diff.
+ *
+ * `minimatch` is not a core dependency, so the `pattern`/`all` glob matcher
+ * is a tiny test-only `*`-glob — sufficient for these fixtures; fitness
+ * injects the real `minimatch` in production.
+ */
+export {};
+//# sourceMappingURL=selector.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selector.test.d.ts","sourceRoot":"","sources":["../../../src/recipes/__tests__/selector.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/recipes/__tests__/selector.test.js

@@ -0,0 +1,173 @@
+/**
+ * @fileoverview Characterization + unit tests for the generic recipe
+ * resolver (`resolveSelector`).
+ *
+ * The resolver is the selection algorithm fitness (`resolveChecks`) and
+ * simulation (in-service resolver) now delegate to. These tests lock its
+ * output for each arm, the predicate-override path, and the two
+ * programmer-error guards — independent of any tool (core cannot import
+ * fitness/sim). The real no-behavior-change proof for the tools lives in
+ * their own suites, which pass unedited; this pins the substrate itself.
+ *
+ * Expected outputs are asserted with explicit `toEqual` (not auto-filled
+ * snapshots) so the locked values are hand-reviewed in the diff.
+ *
+ * `minimatch` is not a core dependency, so the `pattern`/`all` glob matcher
+ * is a tiny test-only `*`-glob — sufficient for these fixtures; fitness
+ * injects the real `minimatch` in production.
+ */
+import { describe, expect, it } from 'vitest';
+import { SystemError } from '../../lib/errors.js';
+import { resolveSelector } from '../selector.js';
+/** Test-only `*`-glob matcher (exact match when the pattern has no `*`). */
+function glob(target, pattern) {
+    if (!pattern.includes('*'))
+        return target === pattern;
+    const escaped = pattern
+        .split('*')
+        .map((part) => part.replaceAll(/[.+?^${}()|[\]\\]/g, String.raw `\$&`));
+    return new RegExp(`^${escaped.join('.*')}$`).test(target);
+}
+const items = [
+    { id: 'security:no-eval', name: 'security:no-eval', tags: ['security', 'architecture'] },
+    { id: 'security:no-exec', name: 'security:no-exec', tags: ['security'] },
+    { id: 'backend:no-sync-fs', name: 'backend:no-sync-fs', tags: ['backend'] },
+    { id: 'frontend:no-inline-style', name: 'frontend:no-inline-style', tags: ['frontend'] },
+    { id: 'architecture:layering', name: 'architecture:layering', tags: ['architecture'] },
+    { id: 'no-todo', name: 'no-todo', tags: [] },
+    { id: 'backend:max-params', name: 'backend:max-params', tags: ['backend', 'architecture'] },
+    { id: 'load-test', name: 'load-test', tags: ['load'], kind: 'load' },
+];
+/** Fitness-style match targets: key + bare slug + `tag/bareSlug`. */
+function buildMatchTargets(slug, tags = []) {
+    const targets = [slug];
+    const bare = slug.includes(':') ? slug.split(':').pop() : slug;
+    if (bare !== slug)
+        targets.push(bare);
+    for (const tag of tags)
+        targets.push(`${tag}/${bare}`);
+    return targets;
+}
+/** Fitness-shaped options: glob match + bare-slug → namespaced-key reverse lookup. */
+const fitnessOpts = {
+    keysOf: (item) => buildMatchTargets(item.id, item.tags),
+    tagsOf: (item) => item.tags ?? [],
+    match: glob,
+    resolveExplicit: (id) => {
+        if (id.includes(':'))
+            return undefined;
+        const found = items.find((item) => item.id.endsWith(`:${id}`));
+        return found?.id;
+    },
+};
+const ids = (result) => result.map((item) => item.id);
+describe('resolveSelector — built-in arms', () => {
+    it('explicit: exact key, bare-slug reverse lookup, request order, no de-dup', () => {
+        const result = resolveSelector({ type: 'explicit', ids: ['security:no-eval', 'no-todo', 'no-exec'] }, items, fitnessOpts);
+        expect(ids(result)).toEqual(['security:no-eval', 'no-todo', 'security:no-exec']);
+    });
+    it('all: no exclude returns every item in registration order', () => {
+        const result = resolveSelector({ type: 'all' }, items, fitnessOpts);
+        expect(ids(result)).toEqual([
+            'security:no-eval',
+            'security:no-exec',
+            'backend:no-sync-fs',
+            'frontend:no-inline-style',
+            'architecture:layering',
+            'no-todo',
+            'backend:max-params',
+            'load-test',
+        ]);
+    });
+    it('all: glob exclude drops matched keys', () => {
+        const result = resolveSelector({ type: 'all', exclude: ['security:*'] }, items, fitnessOpts);
+        expect(ids(result)).toEqual([
+            'backend:no-sync-fs',
+            'frontend:no-inline-style',
+            'architecture:layering',
+            'no-todo',
+            'backend:max-params',
+            'load-test',
+        ]);
+    });
+    it('tags: include intersection (exclude is over tags)', () => {
+        const result = resolveSelector({ type: 'tags', include: ['architecture'] }, items, fitnessOpts);
+        expect(ids(result)).toEqual([
+            'security:no-eval',
+            'architecture:layering',
+            'backend:max-params',
+        ]);
+    });
+    it('tags: tag-based exclude removes matched items', () => {
+        const result = resolveSelector({ type: 'tags', include: ['architecture'], exclude: ['security'] }, items, fitnessOpts);
+        // security:no-eval carries the 'security' tag → excluded.
+        expect(ids(result)).toEqual(['architecture:layering', 'backend:max-params']);
+    });
+    it('pattern: include globs over match targets, minus exclude globs', () => {
+        const result = resolveSelector({ type: 'pattern', include: ['backend:*'] }, items, fitnessOpts);
+        expect(ids(result)).toEqual(['backend:no-sync-fs', 'backend:max-params']);
+    });
+});
+describe('resolveSelector — guards', () => {
+    it('throws SELECTOR_NO_MATCHER when an exclude arm has no injected matcher', () => {
+        const noMatch = {
+            keysOf: (item) => [item.id],
+        };
+        try {
+            resolveSelector({ type: 'all', exclude: ['x'] }, items, noMatch);
+            expect.unreachable('should have thrown');
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(SystemError);
+            expect(error.code).toBe('SYSTEM.CORE.SELECTOR_NO_MATCHER');
+        }
+    });
+    it('throws UNKNOWN_SELECTOR for a tool-only arm with no predicate', () => {
+        try {
+            resolveSelector({ type: 'kind', kinds: ['load'] }, items, fitnessOpts);
+            expect.unreachable('should have thrown');
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(SystemError);
+            expect(error.code).toBe('SYSTEM.CORE.UNKNOWN_SELECTOR');
+        }
+    });
+});
+describe('resolveSelector — predicate override (simulation-style)', () => {
+    const simOpts = {
+        keysOf: (item) => [item.id, item.name],
+        tagsOf: (item) => item.tags ?? [],
+        predicates: {
+            kind: (item, sel) => {
+                if (sel.type !== 'kind')
+                    return false;
+                const kinds = new Set(sel.kinds);
+                const exclude = new Set(sel.exclude);
+                return (item.kind !== undefined &&
+                    kinds.has(item.kind) &&
+                    !exclude.has(item.id) &&
+                    !exclude.has(item.name));
+            },
+            // sim's `tags` excludes on id/name (not tags) — overrides the built-in arm.
+            tags: (item, sel) => {
+                if (sel.type !== 'tags')
+                    return false;
+                const include = new Set(sel.include);
+                const exclude = new Set(sel.exclude);
+                return ((item.tags ?? []).some((t) => include.has(t)) &&
+                    !exclude.has(item.id) &&
+                    !exclude.has(item.name));
+            },
+        },
+    };
+    it('kind predicate filters by item.kind', () => {
+        const result = resolveSelector({ type: 'kind', kinds: ['load'] }, items, simOpts);
+        expect(ids(result)).toEqual(['load-test']);
+    });
+    it('tags predicate excludes on id/name, not tags', () => {
+        const result = resolveSelector({ type: 'tags', include: ['architecture'], exclude: ['security:no-eval'] }, items, simOpts);
+        // 'security:no-eval' is excluded by id even though it carries 'architecture'.
+        expect(ids(result)).toEqual(['architecture:layering', 'backend:max-params']);
+    });
+});
+//# sourceMappingURL=selector.test.js.map

package/dist/recipes/__tests__/selector.test.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * unit-config — scope-bound per-unit recipe config accessors. The lookup is
+ * bound to `currentScope()`, so reads outside any scope return `{}` and reads
+ * inside a scope return the slice stored by `setCurrentRecipeUnitConfig`.
+ */
+export {};
+//# sourceMappingURL=unit-config.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unit-config.test.d.ts","sourceRoot":"","sources":["../../../src/recipes/__tests__/unit-config.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/recipes/__tests__/unit-config.test.js

@@ -0,0 +1,52 @@
+/**
+ * unit-config — scope-bound per-unit recipe config accessors. The lookup is
+ * bound to `currentScope()`, so reads outside any scope return `{}` and reads
+ * inside a scope return the slice stored by `setCurrentRecipeUnitConfig`.
+ */
+import { describe, it, expect } from 'vitest';
+import { LanguageRegistry } from '../../languages/registry.js';
+import { RunScope, runWithScopeSync } from '../../lib/run-scope.js';
+import { ToolRegistry } from '../../tools/registry.js';
+import { getUnitConfig, setCurrentRecipeUnitConfig, clearCurrentRecipeUnitConfig, } from '../unit-config.js';
+/** Core-internal stand-ins for the retired `test-utils/with-scope` sugar
+ *  (ADR-0040 — see verdict-policy.test.ts for the cycle rationale). */
+const makeTestScope = () => new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry() });
+const withScopeSync = runWithScopeSync;
+describe('getUnitConfig', () => {
+    it('returns an empty object when called outside any scope', () => {
+        expect(getUnitConfig('any-slug')).toEqual({});
+    });
+    it('returns an empty object for a scope with no config set', () => {
+        const scope = makeTestScope();
+        const result = withScopeSync(scope, () => getUnitConfig('missing'));
+        expect(result).toEqual({});
+    });
+    it('returns the stored slice for a matching slug', () => {
+        const scope = makeTestScope();
+        setCurrentRecipeUnitConfig(scope, { 'my-unit': { threshold: 42 } });
+        const result = withScopeSync(scope, () => getUnitConfig('my-unit'));
+        expect(result.threshold).toBe(42);
+    });
+    it('returns an empty object for a slug absent from a populated config', () => {
+        const scope = makeTestScope();
+        setCurrentRecipeUnitConfig(scope, { 'other-unit': { threshold: 1 } });
+        const result = withScopeSync(scope, () => getUnitConfig('my-unit'));
+        expect(result).toEqual({});
+    });
+});
+describe('setCurrentRecipeUnitConfig / clearCurrentRecipeUnitConfig', () => {
+    it('treats an undefined config as an empty map', () => {
+        const scope = makeTestScope();
+        setCurrentRecipeUnitConfig(scope, undefined);
+        const result = withScopeSync(scope, () => getUnitConfig('my-unit'));
+        expect(result).toEqual({});
+    });
+    it('clear() removes a previously-set slice', () => {
+        const scope = makeTestScope();
+        setCurrentRecipeUnitConfig(scope, { 'my-unit': { threshold: 7 } });
+        expect(withScopeSync(scope, () => getUnitConfig('my-unit')).threshold).toBe(7);
+        clearCurrentRecipeUnitConfig(scope);
+        expect(withScopeSync(scope, () => getUnitConfig('my-unit'))).toEqual({});
+    });
+});
+//# sourceMappingURL=unit-config.test.js.map

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

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

package/dist/recipes/registry.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @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 { Registry, type Registerable } from '../lib/registry.js';
+import type { Logger } from '../lib/logger.js';
+/** Minimum shape any recipe must satisfy to live in a `RecipeRegistry`. */
+export interface RecipeBase extends Registerable {
+    readonly id: string;
+    readonly name: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly tags?: readonly string[];
+}
+/** Options for a single `register` call. */
+export interface RecipeRegisterOptions {
+    /** Allow replacing an existing entry with the same id or name. */
+    readonly allowOverwrite?: boolean;
+    /**
+     * Throw a `ValidationError` on duplicate id/name instead of the
+     * default "warn-and-skip" behaviour. Use this for registries where
+     * historical callers relied on a thrown error (e.g. user recipe
+     * loaders that signal config errors via exceptions).
+     */
+    readonly throwOnDuplicate?: boolean;
+    /**
+     * Validation-error code surfaced when `throwOnDuplicate` fires.
+     * Falls back to the registry's `validationCode` constructor option.
+     */
+    readonly validationCode?: string;
+    /**
+     * Bypass the duplicate guard for this call. Used by built-in
+     * seeding paths in `FitnessRecipeRegistry` / `SimulationRecipeRegistry`;
+     * not part of the public surface for user code.
+     */
+    readonly internal?: boolean;
+}
+/** Constructor options for a `RecipeRegistry<T>`. */
+export interface RecipeRegistryOptions {
+    /** Human label used in log/throw messages — e.g. `'fitness'`, `'simulation'`. */
+    readonly module?: string;
+    /** Default validation error code on duplicate when `throwOnDuplicate` is set. */
+    readonly validationCode?: string;
+    readonly logger?: Logger;
+}
+/**
+ * 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 declare class RecipeRegistry<T extends RecipeBase> {
+    protected readonly inner: Registry<T>;
+    private readonly module;
+    private readonly validationCode;
+    constructor(options?: RecipeRegistryOptions);
+    /**
+     * 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: T, options?: RecipeRegisterOptions): void;
+    /** Register many recipes with shared options. */
+    registerAll(recipes: readonly T[], options?: RecipeRegisterOptions): void;
+    /** Look up a recipe by name first, falling back to id. */
+    loadRecipe(nameOrId: string): T | undefined;
+    getByName(name: string): T | undefined;
+    getById(id: string): T | undefined;
+    has(nameOrId: string): boolean;
+    /** All registered recipes, in registration order. */
+    getAllRecipes(): readonly T[];
+    /** All registered recipe names, in registration order. */
+    getNames(): readonly string[];
+    /** Recipes with a given tag. */
+    getByTag(tag: string): readonly T[];
+    get size(): number;
+    /** Remove a recipe by id. Returns true if it existed. */
+    remove(id: string): boolean;
+    /** Drop every entry. */
+    clear(): void;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/recipes/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,2EAA2E;AAC3E,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,UAAU;IAC9C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,GAAE,qBAA0B;IAY/C;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,GAAE,qBAA0B,GAAG,IAAI;IA+C9D,iDAAiD;IACjD,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,OAAO,GAAE,qBAA0B,GAAG,IAAI;IAM7E,0DAA0D;IAC1D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI3C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAItC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,qDAAqD;IACrD,aAAa,IAAI,SAAS,CAAC,EAAE;IAI7B,0DAA0D;IAC1D,QAAQ,IAAI,SAAS,MAAM,EAAE;IAI7B,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE;IAInC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yDAAyD;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,wBAAwB;IACxB,KAAK,IAAI,IAAI;CAGd"}