@dzhechkov/harness-core 0.3.88 → 0.3.90

package/dist/feature-adr-routing.d.ts

@@ -0,0 +1,125 @@
+/**
+ * feature-adr per-stage model routing — the pure resolution core.
+ *
+ * This is the TESTABLE mirror of the routing block inlined into the
+ * `.claude/workflows/feature-adr.js` workflow (and its byte-identical
+ * skills-feature-adr template copy). The workflow is a top-level-`await`
+ * SCRIPT, not an importable module — the pipeline runs on import — so the
+ * pure helpers cannot be `import`-ed from it directly. Instead the workflow
+ * INLINES a byte-equivalent copy of the function bodies below, and
+ * `feature-adr-model-routing.test.ts` asserts the inline copy is
+ * string-equivalent to this module (a drift guard tying the tested code to
+ * the shipped code), then exercises these exports for the load-bearing
+ * behavioral assertions (LB-A/B/C, AC-1…AC-6).
+ *
+ * The load-bearing property: a model that WRITES code must not also SELF-QE.
+ * When `args.models.qe` is unset, the QE stage is auto-routed to the OTHER
+ * family than the resolved coder (codex-coder → Claude `opus`; Claude-coder →
+ * `codex:<top>:high`, or `opus` if codex is unavailable — never a block).
+ *
+ * DESIGN CONSTRAINT — the Workflow parser is STRICTER than `node --check`
+ * (no nested template literals, no inline `cond ? agent() : null` in arrays).
+ * The function BODIES here are written parser-safe (string `+` concat, explicit
+ * `if`/return, object-literal data tables) so the same source can be inlined
+ * verbatim into the workflow. Keep this module and the workflow's inline block
+ * in lock-step.
+ *
+ * @packageDocumentation
+ */
+/** A resolved `agent()` opts fragment: either a Claude `{model}` or a codex spec. */
+export interface StageOpts {
+    readonly model?: string;
+    readonly agentType?: string;
+    readonly codexModel?: string;
+    readonly _reasoning?: string;
+}
+/** The knobs `resolveStageModel` closes over — passed in from the workflow. */
+export interface RoutingEnv {
+    /** `args.models` — the per-stage override map (may be empty). */
+    readonly MODELS: Record<string, string | null | undefined>;
+    /** `args.codexModel` default id (default `'auto'`). */
+    readonly CODEX_MODEL: string;
+    /** Resolved legacy coder knob: `'claude' | 'codex' | 'codex-fallback'`. */
+    readonly CODER: string;
+    /** Resolved legacy qeReviewer knob: `'claude' | 'codex' | 'codex-fallback'`. */
+    readonly QE_REVIEWER: string;
+    /** `args.planner` shortcut (only `'codex'` is meaningful). */
+    readonly PLANNER?: string;
+    /**
+     * Whether codex is available at qe-resolution time. Defaults true; the caller
+     * passes `false` (from a pre-flight probe / `A.codexAvailable===false`) to force
+     * the cross-model QE default to fall back to a Claude reviewer instead of codex.
+     */
+    readonly codexAvailable?: boolean;
+    /** Optional log sink (the workflow passes its `log`); defaults to a no-op. */
+    readonly log?: (msg: string) => void;
+}
+/** Known codex ids. Adding a new id (e.g. `'gpt-5.7'`) is a DATA-ONLY change. */
+export declare const KNOWN_CODEX: Record<string, number>;
+/** The Claude model names the Workflow runtime accepts as `agent()` `model`. */
+export declare const CLAUDE_NAMES: Record<string, number>;
+/**
+ * The proven DEFAULT TABLE, applied only when the user opts into routing.
+ * `code`/`qe` are `null` SENTINELS: their defaults are DERIVED (the coder knob /
+ * the cross-model rule), not fixed model names.
+ */
+export declare const DEFAULT_MODELS: Record<string, string | null>;
+/**
+ * Turn a compact model SPEC into `agent()` opts.
+ *   - falsy               → `{}`               (session-inherited — the BC path)
+ *   - `'codex[:id[:r]]'`  → `{agentType:'codex:codex-rescue', codexModel, _reasoning}`
+ *   - `'fable'|'opus'|…`  → `{model}`
+ *   - unknown             → warn + `{}` (Claude) / `CODEX_MODEL` (codex id)
+ */
+export declare function specToOpts(spec: string | null | undefined, env: RoutingEnv): StageOpts;
+/**
+ * Fold the legacy `coder` knob into a spec:
+ *   `codex`/`codex-fallback` → `'codex:' + CODEX_MODEL + ':high'`; else `'opus'`.
+ * NOTE: a DIRECT `MODELS.code` spec bypasses this (handled in `resolveStageModel`);
+ * this only maps the KNOB, which is why `coderIsCodex` (below) also inspects `MODELS.code`.
+ */
+export declare function resolveCoderSpec(env: RoutingEnv): string;
+/**
+ * Whether the RESOLVED coder is the codex family — true when the coder knob is
+ * codex/codex-fallback OR a direct `MODELS.code` spec is a codex spec. The
+ * cross-model QE default derives from THIS (not the knob alone), so a direct
+ * `MODELS.code='codex'` still routes QE to Claude (never codex-self-QE).
+ */
+export declare function coderIsCodex(env: RoutingEnv): boolean;
+/**
+ * The CROSS-MODEL QE default (load-bearing). Called only when `MODELS.qe` is
+ * unset. Resolves to the OTHER family than the coder:
+ *   - coder is codex  → `'opus'`                       (Claude reviews codex's code)
+ *   - coder is Claude → codex-available ? `'codex:<top>:high'` : `'opus'` (never block)
+ * `<top>` = `CODEX_MODEL` when pinned (≠'auto'), else the top `KNOWN_CODEX` id.
+ */
+export declare function resolveQeSpec(env: RoutingEnv): string;
+/**
+ * Whether the caller opted into routing at all. When FALSE (no `args.models`,
+ * no codex knobs), every Claude stage resolves to `{}` → byte-identical to today.
+ */
+export declare function routingRequested(env: RoutingEnv): boolean;
+/**
+ * Whether the Step-8 QE reviewer should be CODEX. This is the load-bearing cross-model gate — it must
+ * NEVER let the model that wrote the code also self-QE. Order:
+ *   1. an explicit `MODELS.qe` spec wins outright (user opt-in — even a codex qe against a codex coder).
+ *   2. else the legacy `QE_REVIEWER==='codex'` knob asks for codex, but is HONORED ONLY when the coder is
+ *      NOT codex — a codex coder + `qeReviewer:'codex'` would be codex-self-QE (the anti-pattern this whole
+ *      feature exists to prevent), so cross-model wins and QE stays Claude.
+ *   3. else fall to the cross-model DEFAULT (`resolveQeSpec`): codex iff the coder is Claude & codex is
+ *      available & routing was opted into. No routing → false → today's Claude QE (byte-identical BC).
+ * NOTE: the previous inline gate re-added `QE_REVIEWER==='codex'` AFTER the safe resolver, so a codex
+ * coder with the legacy knob silently self-QE'd. This function is the single tested source of that truth.
+ */
+export declare function qeShouldUseCodex(env: RoutingEnv): boolean;
+/**
+ * Resolve a stage to its `agent()` opts fragment.
+ *   1. explicit `MODELS[stage]` wins
+ *   2. else if the user did NOT opt into routing → `{}` (byte-identical BC path)
+ *   3. else the DEFAULT TABLE fills the gap
+ *   4. `code`/`qe` `null` sentinels resolve via the coder / cross-model rules
+ */
+export declare function resolveStageModel(stage: string, env: RoutingEnv): StageOpts;
+/** Spread-merge a resolved opts fragment onto a call's base opts (extra wins). */
+export declare function mergeOpts<B extends object, E extends object>(base: B, extra: E): B & E;
+//# sourceMappingURL=feature-adr-routing.d.ts.map

package/dist/feature-adr-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-adr-routing.d.ts","sourceRoot":"","sources":["../src/feature-adr-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAID,iFAAiF;AACjF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA2C,CAAC;AAE3F,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA8C,CAAC;AAE/F;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYxD,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,SAAS,CAiBtF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAYrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CASzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,SAAS,CAS3E;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAKtF"}

package/dist/feature-adr-routing.js

@@ -0,0 +1,190 @@
+/**
+ * feature-adr per-stage model routing — the pure resolution core.
+ *
+ * This is the TESTABLE mirror of the routing block inlined into the
+ * `.claude/workflows/feature-adr.js` workflow (and its byte-identical
+ * skills-feature-adr template copy). The workflow is a top-level-`await`
+ * SCRIPT, not an importable module — the pipeline runs on import — so the
+ * pure helpers cannot be `import`-ed from it directly. Instead the workflow
+ * INLINES a byte-equivalent copy of the function bodies below, and
+ * `feature-adr-model-routing.test.ts` asserts the inline copy is
+ * string-equivalent to this module (a drift guard tying the tested code to
+ * the shipped code), then exercises these exports for the load-bearing
+ * behavioral assertions (LB-A/B/C, AC-1…AC-6).
+ *
+ * The load-bearing property: a model that WRITES code must not also SELF-QE.
+ * When `args.models.qe` is unset, the QE stage is auto-routed to the OTHER
+ * family than the resolved coder (codex-coder → Claude `opus`; Claude-coder →
+ * `codex:<top>:high`, or `opus` if codex is unavailable — never a block).
+ *
+ * DESIGN CONSTRAINT — the Workflow parser is STRICTER than `node --check`
+ * (no nested template literals, no inline `cond ? agent() : null` in arrays).
+ * The function BODIES here are written parser-safe (string `+` concat, explicit
+ * `if`/return, object-literal data tables) so the same source can be inlined
+ * verbatim into the workflow. Keep this module and the workflow's inline block
+ * in lock-step.
+ *
+ * @packageDocumentation
+ */
+// ── Data tables (data-only extensibility — gpt-5.6-ready) ───────────────────
+/** Known codex ids. Adding a new id (e.g. `'gpt-5.7'`) is a DATA-ONLY change. */
+export const KNOWN_CODEX = { auto: 1, 'gpt-5.5': 1, 'gpt-5.6': 1 };
+/** The Claude model names the Workflow runtime accepts as `agent()` `model`. */
+export const CLAUDE_NAMES = { fable: 1, opus: 1, sonnet: 1, haiku: 1 };
+/**
+ * The proven DEFAULT TABLE, applied only when the user opts into routing.
+ * `code`/`qe` are `null` SENTINELS: their defaults are DERIVED (the coder knob /
+ * the cross-model rule), not fixed model names.
+ */
+export const DEFAULT_MODELS = {
+    router: 'fable',
+    requirements: 'sonnet',
+    research: 'sonnet',
+    adr: 'opus',
+    ideation: 'sonnet',
+    ddd: 'opus',
+    architecture: 'opus',
+    plan: 'sonnet',
+    code: null,
+    qe: null,
+    fleet: 'sonnet',
+};
+// ── Pure resolvers (byte-equivalent to the workflow's inline block) ──────────
+/**
+ * Turn a compact model SPEC into `agent()` opts.
+ *   - falsy               → `{}`               (session-inherited — the BC path)
+ *   - `'codex[:id[:r]]'`  → `{agentType:'codex:codex-rescue', codexModel, _reasoning}`
+ *   - `'fable'|'opus'|…`  → `{model}`
+ *   - unknown             → warn + `{}` (Claude) / `CODEX_MODEL` (codex id)
+ */
+export function specToOpts(spec, env) {
+    const log = env.log || function () { };
+    if (!spec)
+        return {};
+    const parts = String(spec).split(':');
+    const head = parts[0] || '';
+    if (head === 'codex') {
+        let id = parts[1] || env.CODEX_MODEL;
+        if (id !== 'auto' && !KNOWN_CODEX[id]) {
+            log('models: unknown codex id ' + id + ' — using ' + env.CODEX_MODEL);
+            id = env.CODEX_MODEL;
+        }
+        const reasoning = parts[2] || 'high';
+        return { agentType: 'codex:codex-rescue', codexModel: id, _reasoning: reasoning };
+    }
+    if (CLAUDE_NAMES[head])
+        return { model: head };
+    log('models: unknown spec ' + spec + ' — session-inherited');
+    return {};
+}
+/**
+ * Fold the legacy `coder` knob into a spec:
+ *   `codex`/`codex-fallback` → `'codex:' + CODEX_MODEL + ':high'`; else `'opus'`.
+ * NOTE: a DIRECT `MODELS.code` spec bypasses this (handled in `resolveStageModel`);
+ * this only maps the KNOB, which is why `coderIsCodex` (below) also inspects `MODELS.code`.
+ */
+export function resolveCoderSpec(env) {
+    if (env.CODER === 'codex' || env.CODER === 'codex-fallback')
+        return 'codex:' + env.CODEX_MODEL + ':high';
+    return 'opus';
+}
+/**
+ * Whether the RESOLVED coder is the codex family — true when the coder knob is
+ * codex/codex-fallback OR a direct `MODELS.code` spec is a codex spec. The
+ * cross-model QE default derives from THIS (not the knob alone), so a direct
+ * `MODELS.code='codex'` still routes QE to Claude (never codex-self-QE).
+ */
+export function coderIsCodex(env) {
+    if (env.CODER === 'codex' || env.CODER === 'codex-fallback')
+        return true;
+    const codeSpec = env.MODELS.code;
+    if (codeSpec && String(codeSpec).split(':')[0] === 'codex')
+        return true;
+    return false;
+}
+/**
+ * The CROSS-MODEL QE default (load-bearing). Called only when `MODELS.qe` is
+ * unset. Resolves to the OTHER family than the coder:
+ *   - coder is codex  → `'opus'`                       (Claude reviews codex's code)
+ *   - coder is Claude → codex-available ? `'codex:<top>:high'` : `'opus'` (never block)
+ * `<top>` = `CODEX_MODEL` when pinned (≠'auto'), else the top `KNOWN_CODEX` id.
+ */
+export function resolveQeSpec(env) {
+    if (coderIsCodex(env))
+        return 'opus';
+    const CODEX_AVAILABLE = env.codexAvailable !== false;
+    if (!CODEX_AVAILABLE)
+        return 'opus';
+    let top = env.CODEX_MODEL;
+    if (top === 'auto') {
+        const ids = Object.keys(KNOWN_CODEX);
+        for (let i = 0; i < ids.length; i++) {
+            if (ids[i] !== 'auto')
+                top = ids[i] || top;
+        }
+    }
+    return 'codex:' + top + ':high';
+}
+/**
+ * Whether the caller opted into routing at all. When FALSE (no `args.models`,
+ * no codex knobs), every Claude stage resolves to `{}` → byte-identical to today.
+ */
+export function routingRequested(env) {
+    return (Object.keys(env.MODELS).length > 0 ||
+        env.PLANNER === 'codex' ||
+        env.CODER === 'codex' ||
+        env.CODER === 'codex-fallback' ||
+        env.QE_REVIEWER === 'codex' ||
+        env.QE_REVIEWER === 'codex-fallback');
+}
+/**
+ * Whether the Step-8 QE reviewer should be CODEX. This is the load-bearing cross-model gate — it must
+ * NEVER let the model that wrote the code also self-QE. Order:
+ *   1. an explicit `MODELS.qe` spec wins outright (user opt-in — even a codex qe against a codex coder).
+ *   2. else the legacy `QE_REVIEWER==='codex'` knob asks for codex, but is HONORED ONLY when the coder is
+ *      NOT codex — a codex coder + `qeReviewer:'codex'` would be codex-self-QE (the anti-pattern this whole
+ *      feature exists to prevent), so cross-model wins and QE stays Claude.
+ *   3. else fall to the cross-model DEFAULT (`resolveQeSpec`): codex iff the coder is Claude & codex is
+ *      available & routing was opted into. No routing → false → today's Claude QE (byte-identical BC).
+ * NOTE: the previous inline gate re-added `QE_REVIEWER==='codex'` AFTER the safe resolver, so a codex
+ * coder with the legacy knob silently self-QE'd. This function is the single tested source of that truth.
+ */
+export function qeShouldUseCodex(env) {
+    const explicit = env.MODELS.qe;
+    if (explicit !== undefined && explicit !== null) {
+        return String(explicit).split(':')[0] === 'codex';
+    }
+    if (env.QE_REVIEWER === 'codex')
+        return !coderIsCodex(env);
+    return routingRequested(env) && resolveQeSpec(env).split(':')[0] === 'codex';
+}
+/**
+ * Resolve a stage to its `agent()` opts fragment.
+ *   1. explicit `MODELS[stage]` wins
+ *   2. else if the user did NOT opt into routing → `{}` (byte-identical BC path)
+ *   3. else the DEFAULT TABLE fills the gap
+ *   4. `code`/`qe` `null` sentinels resolve via the coder / cross-model rules
+ */
+export function resolveStageModel(stage, env) {
+    let spec = env.MODELS[stage];
+    if (spec === undefined) {
+        if (!routingRequested(env))
+            return {};
+        spec = DEFAULT_MODELS[stage];
+    }
+    if (stage === 'code' && (spec === null || spec === undefined))
+        return specToOpts(resolveCoderSpec(env), env);
+    if (stage === 'qe' && (spec === null || spec === undefined))
+        return specToOpts(resolveQeSpec(env), env);
+    return specToOpts(spec, env);
+}
+/** Spread-merge a resolved opts fragment onto a call's base opts (extra wins). */
+export function mergeOpts(base, extra) {
+    const out = {};
+    for (const k in base)
+        out[k] = base[k];
+    for (const k in extra)
+        out[k] = extra[k];
+    return out;
+}
+//# sourceMappingURL=feature-adr-routing.js.map

package/dist/feature-adr-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-adr-routing.js","sourceRoot":"","sources":["../src/feature-adr-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAgCH,+EAA+E;AAE/E,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAA2B,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAE3F,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAA2B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAE/F;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,MAAM,EAAE,OAAO;IACf,YAAY,EAAE,QAAQ;IACtB,QAAQ,EAAE,QAAQ;IAClB,GAAG,EAAE,MAAM;IACX,QAAQ,EAAE,QAAQ;IAClB,GAAG,EAAE,MAAM;IACX,YAAY,EAAE,MAAM;IACpB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,IAAI;IACV,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,QAAQ;CAChB,CAAC;AAEF,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAA+B,EAAE,GAAe;IACzE,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,cAAa,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC;QACrC,IAAI,EAAE,KAAK,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,2BAA2B,GAAG,EAAE,GAAG,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;YACtE,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC;QACvB,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;QACrC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/C,GAAG,CAAC,uBAAuB,GAAG,IAAI,GAAG,sBAAsB,CAAC,CAAC;IAC7D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe;IAC9C,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,KAAK,KAAK,gBAAgB;QAAE,OAAO,QAAQ,GAAG,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC;IACzG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,KAAK,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IACjC,IAAI,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAe;IAC3C,IAAI,YAAY,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACrC,MAAM,eAAe,GAAG,GAAG,CAAC,cAAc,KAAK,KAAK,CAAC;IACrD,IAAI,CAAC,eAAe;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;IAC1B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,MAAM;gBAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,GAAG,GAAG,GAAG,OAAO,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe;IAC9C,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;QAClC,GAAG,CAAC,OAAO,KAAK,OAAO;QACvB,GAAG,CAAC,KAAK,KAAK,OAAO;QACrB,GAAG,CAAC,KAAK,KAAK,gBAAgB;QAC9B,GAAG,CAAC,WAAW,KAAK,OAAO;QAC3B,GAAG,CAAC,WAAW,KAAK,gBAAgB,CACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,KAAK,OAAO;QAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3D,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AAC/E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,GAAe;IAC9D,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7G,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxG,OAAO,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAqC,IAAO,EAAE,KAAQ;IAC7E,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,CAAC,CAAC,CAAC,GAAI,IAAgC,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,GAAG,CAAC,CAAC,CAAC,GAAI,KAAiC,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,GAAY,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -63,4 +63,6 @@ export type { ReconcileReport, ReconcileFinding, ReconcileAxis, AxisState, Limit
 export type { McpFinding, McpScanReport, McpVerdict, McpSeverity, McpCapability, } from './mcp-scan.js';
 export type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';
+export { specToOpts, resolveStageModel, resolveCoderSpec, coderIsCodex, resolveQeSpec, routingRequested, mergeOpts, DEFAULT_MODELS, KNOWN_CODEX, CLAUDE_NAMES, } from './feature-adr-routing.js';
+export type { StageOpts, RoutingEnv } from './feature-adr-routing.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,MACiD,CAAC;AAErF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/W,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjP,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjH,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/M,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACvN,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3J,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzE,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrG,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -37,4 +37,5 @@ export { importEcc } from './import-ecc.js';
 export { scanMcp, parseGrant } from './mcp-scan.js';
 export { detectScriptCapabilities, parseDeclaredCapabilities, parseDeclaredLimits, stripCodeNoise, toolKind, } from './capability-vocab.js';
 export { reconcileCapabilities, RECONCILE_BANNER } from './reconcile.js';
+export { specToOpts, resolveStageModel, resolveCoderSpec, coderIsCodex, resolveQeSpec, routingRequested, mergeOpts, DEFAULT_MODELS, KNOWN_CODEX, CLAUDE_NAMES, } from './feature-adr-routing.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAC9B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAErF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/W,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAwB1B,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE/M,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEvN,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3J,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAC9B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAErF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/W,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAwB1B,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEjH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE/M,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEvN,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3J,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAkBzE,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.3.88",
+  "version": "0.3.90",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -30,13 +30,13 @@
     "@dzhechkov/adapter-openclaude": "^0.1.0",
     "@dzhechkov/adapter-opencode": "^0.2.0",
     "yaml": "^2.0.0",
+    "@dzhechkov/adapter-gemini": "0.1.1",
+    "@dzhechkov/core": "0.2.14",
     "@dzhechkov/adapter-copilot": "0.1.1",
     "@dzhechkov/adapter-cursor": "0.1.1",
     "@dzhechkov/adapter-windsurf": "0.1.1",
-    "@dzhechkov/adapter-gemini": "0.1.1",
-    "@dzhechkov/adapter-agents-md": "0.1.1",
     "@dzhechkov/memory": "0.2.9",
-    "@dzhechkov/core": "0.2.14"
+    "@dzhechkov/adapter-agents-md": "0.1.1"
   },
   "peerDependenciesMeta": {
     "@ruvector/rvf": {

package/src/feature-adr-routing.ts

@@ -0,0 +1,220 @@
+/**
+ * feature-adr per-stage model routing — the pure resolution core.
+ *
+ * This is the TESTABLE mirror of the routing block inlined into the
+ * `.claude/workflows/feature-adr.js` workflow (and its byte-identical
+ * skills-feature-adr template copy). The workflow is a top-level-`await`
+ * SCRIPT, not an importable module — the pipeline runs on import — so the
+ * pure helpers cannot be `import`-ed from it directly. Instead the workflow
+ * INLINES a byte-equivalent copy of the function bodies below, and
+ * `feature-adr-model-routing.test.ts` asserts the inline copy is
+ * string-equivalent to this module (a drift guard tying the tested code to
+ * the shipped code), then exercises these exports for the load-bearing
+ * behavioral assertions (LB-A/B/C, AC-1…AC-6).
+ *
+ * The load-bearing property: a model that WRITES code must not also SELF-QE.
+ * When `args.models.qe` is unset, the QE stage is auto-routed to the OTHER
+ * family than the resolved coder (codex-coder → Claude `opus`; Claude-coder →
+ * `codex:<top>:high`, or `opus` if codex is unavailable — never a block).
+ *
+ * DESIGN CONSTRAINT — the Workflow parser is STRICTER than `node --check`
+ * (no nested template literals, no inline `cond ? agent() : null` in arrays).
+ * The function BODIES here are written parser-safe (string `+` concat, explicit
+ * `if`/return, object-literal data tables) so the same source can be inlined
+ * verbatim into the workflow. Keep this module and the workflow's inline block
+ * in lock-step.
+ *
+ * @packageDocumentation
+ */
+
+/** A resolved `agent()` opts fragment: either a Claude `{model}` or a codex spec. */
+export interface StageOpts {
+  readonly model?: string;
+  readonly agentType?: string;
+  readonly codexModel?: string;
+  readonly _reasoning?: string;
+}
+
+/** The knobs `resolveStageModel` closes over — passed in from the workflow. */
+export interface RoutingEnv {
+  /** `args.models` — the per-stage override map (may be empty). */
+  readonly MODELS: Record<string, string | null | undefined>;
+  /** `args.codexModel` default id (default `'auto'`). */
+  readonly CODEX_MODEL: string;
+  /** Resolved legacy coder knob: `'claude' | 'codex' | 'codex-fallback'`. */
+  readonly CODER: string;
+  /** Resolved legacy qeReviewer knob: `'claude' | 'codex' | 'codex-fallback'`. */
+  readonly QE_REVIEWER: string;
+  /** `args.planner` shortcut (only `'codex'` is meaningful). */
+  readonly PLANNER?: string;
+  /**
+   * Whether codex is available at qe-resolution time. Defaults true; the caller
+   * passes `false` (from a pre-flight probe / `A.codexAvailable===false`) to force
+   * the cross-model QE default to fall back to a Claude reviewer instead of codex.
+   */
+  readonly codexAvailable?: boolean;
+  /** Optional log sink (the workflow passes its `log`); defaults to a no-op. */
+  readonly log?: (msg: string) => void;
+}
+
+// ── Data tables (data-only extensibility — gpt-5.6-ready) ───────────────────
+
+/** Known codex ids. Adding a new id (e.g. `'gpt-5.7'`) is a DATA-ONLY change. */
+export const KNOWN_CODEX: Record<string, number> = { auto: 1, 'gpt-5.5': 1, 'gpt-5.6': 1 };
+
+/** The Claude model names the Workflow runtime accepts as `agent()` `model`. */
+export const CLAUDE_NAMES: Record<string, number> = { fable: 1, opus: 1, sonnet: 1, haiku: 1 };
+
+/**
+ * The proven DEFAULT TABLE, applied only when the user opts into routing.
+ * `code`/`qe` are `null` SENTINELS: their defaults are DERIVED (the coder knob /
+ * the cross-model rule), not fixed model names.
+ */
+export const DEFAULT_MODELS: Record<string, string | null> = {
+  router: 'fable',
+  requirements: 'sonnet',
+  research: 'sonnet',
+  adr: 'opus',
+  ideation: 'sonnet',
+  ddd: 'opus',
+  architecture: 'opus',
+  plan: 'sonnet',
+  code: null,
+  qe: null,
+  fleet: 'sonnet',
+};
+
+// ── Pure resolvers (byte-equivalent to the workflow's inline block) ──────────
+
+/**
+ * Turn a compact model SPEC into `agent()` opts.
+ *   - falsy               → `{}`               (session-inherited — the BC path)
+ *   - `'codex[:id[:r]]'`  → `{agentType:'codex:codex-rescue', codexModel, _reasoning}`
+ *   - `'fable'|'opus'|…`  → `{model}`
+ *   - unknown             → warn + `{}` (Claude) / `CODEX_MODEL` (codex id)
+ */
+export function specToOpts(spec: string | null | undefined, env: RoutingEnv): StageOpts {
+  const log = env.log || function () {};
+  if (!spec) return {};
+  const parts = String(spec).split(':');
+  const head = parts[0] || '';
+  if (head === 'codex') {
+    let id = parts[1] || env.CODEX_MODEL;
+    if (id !== 'auto' && !KNOWN_CODEX[id]) {
+      log('models: unknown codex id ' + id + ' — using ' + env.CODEX_MODEL);
+      id = env.CODEX_MODEL;
+    }
+    const reasoning = parts[2] || 'high';
+    return { agentType: 'codex:codex-rescue', codexModel: id, _reasoning: reasoning };
+  }
+  if (CLAUDE_NAMES[head]) return { model: head };
+  log('models: unknown spec ' + spec + ' — session-inherited');
+  return {};
+}
+
+/**
+ * Fold the legacy `coder` knob into a spec:
+ *   `codex`/`codex-fallback` → `'codex:' + CODEX_MODEL + ':high'`; else `'opus'`.
+ * NOTE: a DIRECT `MODELS.code` spec bypasses this (handled in `resolveStageModel`);
+ * this only maps the KNOB, which is why `coderIsCodex` (below) also inspects `MODELS.code`.
+ */
+export function resolveCoderSpec(env: RoutingEnv): string {
+  if (env.CODER === 'codex' || env.CODER === 'codex-fallback') return 'codex:' + env.CODEX_MODEL + ':high';
+  return 'opus';
+}
+
+/**
+ * Whether the RESOLVED coder is the codex family — true when the coder knob is
+ * codex/codex-fallback OR a direct `MODELS.code` spec is a codex spec. The
+ * cross-model QE default derives from THIS (not the knob alone), so a direct
+ * `MODELS.code='codex'` still routes QE to Claude (never codex-self-QE).
+ */
+export function coderIsCodex(env: RoutingEnv): boolean {
+  if (env.CODER === 'codex' || env.CODER === 'codex-fallback') return true;
+  const codeSpec = env.MODELS.code;
+  if (codeSpec && String(codeSpec).split(':')[0] === 'codex') return true;
+  return false;
+}
+
+/**
+ * The CROSS-MODEL QE default (load-bearing). Called only when `MODELS.qe` is
+ * unset. Resolves to the OTHER family than the coder:
+ *   - coder is codex  → `'opus'`                       (Claude reviews codex's code)
+ *   - coder is Claude → codex-available ? `'codex:<top>:high'` : `'opus'` (never block)
+ * `<top>` = `CODEX_MODEL` when pinned (≠'auto'), else the top `KNOWN_CODEX` id.
+ */
+export function resolveQeSpec(env: RoutingEnv): string {
+  if (coderIsCodex(env)) return 'opus';
+  const CODEX_AVAILABLE = env.codexAvailable !== false;
+  if (!CODEX_AVAILABLE) return 'opus';
+  let top = env.CODEX_MODEL;
+  if (top === 'auto') {
+    const ids = Object.keys(KNOWN_CODEX);
+    for (let i = 0; i < ids.length; i++) {
+      if (ids[i] !== 'auto') top = ids[i] || top;
+    }
+  }
+  return 'codex:' + top + ':high';
+}
+
+/**
+ * Whether the caller opted into routing at all. When FALSE (no `args.models`,
+ * no codex knobs), every Claude stage resolves to `{}` → byte-identical to today.
+ */
+export function routingRequested(env: RoutingEnv): boolean {
+  return (
+    Object.keys(env.MODELS).length > 0 ||
+    env.PLANNER === 'codex' ||
+    env.CODER === 'codex' ||
+    env.CODER === 'codex-fallback' ||
+    env.QE_REVIEWER === 'codex' ||
+    env.QE_REVIEWER === 'codex-fallback'
+  );
+}
+
+/**
+ * Whether the Step-8 QE reviewer should be CODEX. This is the load-bearing cross-model gate — it must
+ * NEVER let the model that wrote the code also self-QE. Order:
+ *   1. an explicit `MODELS.qe` spec wins outright (user opt-in — even a codex qe against a codex coder).
+ *   2. else the legacy `QE_REVIEWER==='codex'` knob asks for codex, but is HONORED ONLY when the coder is
+ *      NOT codex — a codex coder + `qeReviewer:'codex'` would be codex-self-QE (the anti-pattern this whole
+ *      feature exists to prevent), so cross-model wins and QE stays Claude.
+ *   3. else fall to the cross-model DEFAULT (`resolveQeSpec`): codex iff the coder is Claude & codex is
+ *      available & routing was opted into. No routing → false → today's Claude QE (byte-identical BC).
+ * NOTE: the previous inline gate re-added `QE_REVIEWER==='codex'` AFTER the safe resolver, so a codex
+ * coder with the legacy knob silently self-QE'd. This function is the single tested source of that truth.
+ */
+export function qeShouldUseCodex(env: RoutingEnv): boolean {
+  const explicit = env.MODELS.qe;
+  if (explicit !== undefined && explicit !== null) {
+    return String(explicit).split(':')[0] === 'codex';
+  }
+  if (env.QE_REVIEWER === 'codex') return !coderIsCodex(env);
+  return routingRequested(env) && resolveQeSpec(env).split(':')[0] === 'codex';
+}
+
+/**
+ * Resolve a stage to its `agent()` opts fragment.
+ *   1. explicit `MODELS[stage]` wins
+ *   2. else if the user did NOT opt into routing → `{}` (byte-identical BC path)
+ *   3. else the DEFAULT TABLE fills the gap
+ *   4. `code`/`qe` `null` sentinels resolve via the coder / cross-model rules
+ */
+export function resolveStageModel(stage: string, env: RoutingEnv): StageOpts {
+  let spec = env.MODELS[stage];
+  if (spec === undefined) {
+    if (!routingRequested(env)) return {};
+    spec = DEFAULT_MODELS[stage];
+  }
+  if (stage === 'code' && (spec === null || spec === undefined)) return specToOpts(resolveCoderSpec(env), env);
+  if (stage === 'qe' && (spec === null || spec === undefined)) return specToOpts(resolveQeSpec(env), env);
+  return specToOpts(spec, env);
+}
+
+/** Spread-merge a resolved opts fragment onto a call's base opts (extra wins). */
+export function mergeOpts<B extends object, E extends object>(base: B, extra: E): B & E {
+  const out: Record<string, unknown> = {};
+  for (const k in base) out[k] = (base as Record<string, unknown>)[k];
+  for (const k in extra) out[k] = (extra as Record<string, unknown>)[k];
+  return out as B & E;
+}

package/src/index.ts

@@ -167,3 +167,16 @@ export type {
 } from './mcp-scan.js';
 export type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';
+export {
+  specToOpts,
+  resolveStageModel,
+  resolveCoderSpec,
+  coderIsCodex,
+  resolveQeSpec,
+  routingRequested,
+  mergeOpts,
+  DEFAULT_MODELS,
+  KNOWN_CODEX,
+  CLAUDE_NAMES,
+} from './feature-adr-routing.js';
+export type { StageOpts, RoutingEnv } from './feature-adr-routing.js';