@generacy-ai/orchestrator 0.7.0 → 0.9.0

package/dist/worker/config.d.ts

@@ -1,6 +1,12 @@
 import { z } from 'zod';
 import type { OrchestratorSettings } from '@generacy-ai/config';
 import type { WorkflowPhase } from './types.js';
+/**
+ * Built-in provider fallback used by `resolveAgentForPhase` when no tier of
+ * the precedence chain (config, repo `defaults.agent`, or env) supplies a
+ * provider name.
+ */
+export declare const DEFAULT_PROVIDER = "claude-code";
 /**
  * Gate definition schema for pausing workflow at review checkpoints
  */
@@ -94,6 +100,289 @@ export declare const WorkerConfigSchema: z.ZodObject<{
     maxImplementRetries: z.ZodDefault<z.ZodNumber>;
     /** Credential role from .generacy/config.yaml defaults.role — when set, credentials are populated on launch requests */
     credentialRole: z.ZodOptional<z.ZodString>;
+    /**
+     * Per-workflow-phase `{ provider, model }` selection. See `AgentsConfigSchema`
+     * for the shape. Repo-level overrides from `.generacy/config.yaml` are merged
+     * onto this via `applyRepoAgentOverrides`.
+     */
+    agents: z.ZodOptional<z.ZodObject<{
+        default: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            provider?: string | undefined;
+            model?: string | undefined;
+        }, {
+            provider?: string | undefined;
+            model?: string | undefined;
+        }>>;
+        workflows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            default: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                provider?: string | undefined;
+                model?: string | undefined;
+            }, {
+                provider?: string | undefined;
+                model?: string | undefined;
+            }>>;
+            phases: z.ZodOptional<z.ZodObject<{
+                specify: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }>>;
+                clarify: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }>>;
+                plan: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }>>;
+                tasks: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }>>;
+                implement: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }>>;
+                validate: z.ZodOptional<z.ZodObject<{
+                    provider: z.ZodOptional<z.ZodString>;
+                    model: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }, {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            }, {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            default?: {
+                provider?: string | undefined;
+                model?: string | undefined;
+            } | undefined;
+            phases?: {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }, {
+            default?: {
+                provider?: string | undefined;
+                model?: string | undefined;
+            } | undefined;
+            phases?: {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        default?: {
+            provider?: string | undefined;
+            model?: string | undefined;
+        } | undefined;
+        workflows?: Record<string, {
+            default?: {
+                provider?: string | undefined;
+                model?: string | undefined;
+            } | undefined;
+            phases?: {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }> | undefined;
+    }, {
+        default?: {
+            provider?: string | undefined;
+            model?: string | undefined;
+        } | undefined;
+        workflows?: Record<string, {
+            default?: {
+                provider?: string | undefined;
+                model?: string | undefined;
+            } | undefined;
+            phases?: {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }> | undefined;
+    }>>;
+    /**
+     * Repo-level default provider from `.generacy/config.yaml` `defaults.agent`.
+     * Provider-only — `defaults.agent` is a single string, not an `AgentEntry`.
+     * Consumed by `resolveAgentForPhase` as the tier below `agents.default`.
+     */
+    defaultsAgent: z.ZodOptional<z.ZodString>;
     /** Gate definitions keyed by issue label */
     gates: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
         /** Phase that triggers gate check */
@@ -130,8 +419,85 @@ export declare const WorkerConfigSchema: z.ZodObject<{
         gateLabel: string;
         condition: "always" | "on-request" | "on-questions" | "on-failure" | "on-sibling-review" | "on-merge-conflict";
     }[]>;
+    agents?: {
+        default?: {
+            provider?: string | undefined;
+            model?: string | undefined;
+        } | undefined;
+        workflows?: Record<string, {
+            default?: {
+                provider?: string | undefined;
+                model?: string | undefined;
+            } | undefined;
+            phases?: {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }> | undefined;
+    } | undefined;
     credentialRole?: string | undefined;
+    defaultsAgent?: string | undefined;
 }, {
+    agents?: {
+        default?: {
+            provider?: string | undefined;
+            model?: string | undefined;
+        } | undefined;
+        workflows?: Record<string, {
+            default?: {
+                provider?: string | undefined;
+                model?: string | undefined;
+            } | undefined;
+            phases?: {
+                specify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                clarify?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                plan?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                tasks?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                implement?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+                validate?: {
+                    provider?: string | undefined;
+                    model?: string | undefined;
+                } | undefined;
+            } | undefined;
+        }> | undefined;
+    } | undefined;
     phaseTimeoutMs?: number | undefined;
     phaseTimeoutOverrides?: {
         specify?: number | undefined;
@@ -146,6 +512,7 @@ export declare const WorkerConfigSchema: z.ZodObject<{
     preValidateCommand?: string | undefined;
     maxImplementRetries?: number | undefined;
     credentialRole?: string | undefined;
+    defaultsAgent?: string | undefined;
     gates?: Record<string, {
         phase: "specify" | "clarify" | "plan" | "tasks" | "implement" | "validate";
         gateLabel: string;
@@ -173,4 +540,33 @@ export declare function applyRepoValidateOverrides(config: WorkerConfig, setting
  * if one is configured, otherwise the flat `phaseTimeoutMs` fallback.
  */
 export declare function resolvePhaseTimeoutMs(config: WorkerConfig, phase: Exclude<WorkflowPhase, 'validate'>): number;
+/**
+ * Sibling of `applyRepoValidateOverrides` — merges the target repo's
+ * `orchestrator.agents` block onto the cluster-default `agents` block on
+ * `WorkerConfig`. Field-by-field so partial `{ provider }`-only or
+ * `{ model }`-only overrides preserve missing sibling fields from the base.
+ *
+ * Returns the original config unchanged when `settings.agents` is absent so
+ * callers can cheaply detect "no override" via reference equality.
+ */
+export declare function applyRepoAgentOverrides(config: WorkerConfig, settings: OrchestratorSettings | null | undefined): WorkerConfig;
+/**
+ * Resolve `{ provider, model }` for a phase within a workflow. Provider and
+ * model resolve INDEPENDENTLY over the same tier list — a phase override may
+ * set only `model` while `provider` falls through from a lower tier.
+ *
+ * Precedence:
+ *   1. `config.agents.workflows[workflowName].phases[phase]`
+ *   2. `config.agents.workflows[workflowName].default`
+ *   3. `config.agents.default`  (cluster env folds into this tier via loader)
+ *   4. `config.defaultsAgent`   (**provider only** — `defaults.agent` is a bare string)
+ *   5. Built-in `DEFAULT_PROVIDER = 'claude-code'` (**provider only**)
+ *
+ * The `model` walk terminates at tier 3 returning `undefined` (no built-in
+ * model default). The `provider` walk always returns a value.
+ */
+export declare function resolveAgentForPhase(config: WorkerConfig, workflowName: string, phase: WorkflowPhase): {
+    provider: string;
+    model?: string;
+};
 //# sourceMappingURL=config.d.ts.map

package/dist/worker/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/worker/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B,qCAAqC;;IAErC,uCAAuC;;IAEvC,gCAAgC;;;;;;;;;;EAEhC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;GAQ1B,CAAC;AACf,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B,2FAA2F;;IAE3F,sDAAsD;;;;;;;;;;;;;;;;;;;;IAEtD,wCAAwC;;IAExC,gDAAgD;;IAEhD,+CAA+C;;IAE/C,sFAAsF;;IAMtF,4EAA4E;;IAE5E,wHAAwH;;IAExH,4CAA4C;;QA3D5C,qCAAqC;;QAErC,uCAAuC;;QAEvC,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2EhC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAChD,YAAY,CAgBd;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,GACxC,MAAM,CAIR"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/worker/config.ts"],"names":[],"mappings":"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"}

package/dist/worker/config.js

@@ -1,4 +1,11 @@
 import { z } from 'zod';
+import { AgentsConfigSchema } from '@generacy-ai/config';
+/**
+ * Built-in provider fallback used by `resolveAgentForPhase` when no tier of
+ * the precedence chain (config, repo `defaults.agent`, or env) supplies a
+ * provider name.
+ */
+export const DEFAULT_PROVIDER = 'claude-code';
 /**
  * Gate definition schema for pausing workflow at review checkpoints
  */
@@ -57,6 +64,18 @@ export const WorkerConfigSchema = z.object({
     maxImplementRetries: z.number().int().min(0).max(5).default(2),
     /** Credential role from .generacy/config.yaml defaults.role — when set, credentials are populated on launch requests */
     credentialRole: z.string().optional(),
+    /**
+     * Per-workflow-phase `{ provider, model }` selection. See `AgentsConfigSchema`
+     * for the shape. Repo-level overrides from `.generacy/config.yaml` are merged
+     * onto this via `applyRepoAgentOverrides`.
+     */
+    agents: AgentsConfigSchema.optional(),
+    /**
+     * Repo-level default provider from `.generacy/config.yaml` `defaults.agent`.
+     * Provider-only — `defaults.agent` is a single string, not an `AgentEntry`.
+     * Consumed by `resolveAgentForPhase` as the tier below `agents.default`.
+     */
+    defaultsAgent: z.string().min(1).optional(),
     /** Gate definitions keyed by issue label */
     gates: z.record(z.string(), z.array(GateDefinitionSchema)).default({
         'speckit-feature': [
@@ -116,4 +135,127 @@ export function resolvePhaseTimeoutMs(config, phase) {
     // Zod and may omit phaseTimeoutOverrides entirely.
     return config.phaseTimeoutOverrides?.[phase] ?? config.phaseTimeoutMs;
 }
+/**
+ * Field-by-field merge of two `AgentEntry` objects. Target-repo values overlay
+ * cluster-default values; missing fields on the target preserve the cluster
+ * default (`{ provider: 'X' }` on target keeps cluster's `model`).
+ */
+function mergeAgentEntry(base, override) {
+    if (base === undefined)
+        return override;
+    if (override === undefined)
+        return base;
+    return {
+        ...(base.provider !== undefined || override.provider !== undefined
+            ? { provider: override.provider ?? base.provider }
+            : {}),
+        ...(base.model !== undefined || override.model !== undefined
+            ? { model: override.model ?? base.model }
+            : {}),
+    };
+}
+/**
+ * Deep merge two `AgentsConfig` values. Merge semantics:
+ * - `agents.default`: field-by-field on `{ provider, model }`.
+ * - `agents.workflows.<name>.default`: same field-by-field merge.
+ * - `agents.workflows.<name>.phases.<phase>`: same field-by-field merge.
+ * - Workflow names present only on the target pass through untouched; workflow
+ *   names present only on the base survive when the target adds new ones.
+ */
+function mergeAgentsConfig(base, override) {
+    if (base === undefined)
+        return override;
+    if (override === undefined)
+        return base;
+    const merged = {};
+    const mergedDefault = mergeAgentEntry(base.default, override.default);
+    if (mergedDefault !== undefined)
+        merged.default = mergedDefault;
+    const baseWorkflows = base.workflows ?? {};
+    const overrideWorkflows = override.workflows ?? {};
+    const workflowNames = new Set([
+        ...Object.keys(baseWorkflows),
+        ...Object.keys(overrideWorkflows),
+    ]);
+    if (workflowNames.size > 0) {
+        const workflows = {};
+        for (const name of workflowNames) {
+            const b = baseWorkflows[name];
+            const o = overrideWorkflows[name];
+            if (b === undefined && o !== undefined) {
+                workflows[name] = o;
+                continue;
+            }
+            if (o === undefined && b !== undefined) {
+                workflows[name] = b;
+                continue;
+            }
+            // Both defined — merge default + phases field-by-field
+            const mergedWorkflowDefault = mergeAgentEntry(b?.default, o?.default);
+            const phaseKeys = ['specify', 'clarify', 'plan', 'tasks', 'implement', 'validate'];
+            const mergedPhases = {};
+            let anyPhase = false;
+            for (const phase of phaseKeys) {
+                const bp = b?.phases?.[phase];
+                const op = o?.phases?.[phase];
+                const mp = mergeAgentEntry(bp, op);
+                if (mp !== undefined) {
+                    mergedPhases[phase] = mp;
+                    anyPhase = true;
+                }
+            }
+            const entry = {};
+            if (mergedWorkflowDefault !== undefined)
+                entry.default = mergedWorkflowDefault;
+            if (anyPhase)
+                entry.phases = mergedPhases;
+            workflows[name] = entry;
+        }
+        merged.workflows = workflows;
+    }
+    return merged;
+}
+/**
+ * Sibling of `applyRepoValidateOverrides` — merges the target repo's
+ * `orchestrator.agents` block onto the cluster-default `agents` block on
+ * `WorkerConfig`. Field-by-field so partial `{ provider }`-only or
+ * `{ model }`-only overrides preserve missing sibling fields from the base.
+ *
+ * Returns the original config unchanged when `settings.agents` is absent so
+ * callers can cheaply detect "no override" via reference equality.
+ */
+export function applyRepoAgentOverrides(config, settings) {
+    if (settings == null || settings.agents === undefined) {
+        return config;
+    }
+    const merged = mergeAgentsConfig(config.agents, settings.agents);
+    return { ...config, agents: merged };
+}
+/**
+ * Resolve `{ provider, model }` for a phase within a workflow. Provider and
+ * model resolve INDEPENDENTLY over the same tier list — a phase override may
+ * set only `model` while `provider` falls through from a lower tier.
+ *
+ * Precedence:
+ *   1. `config.agents.workflows[workflowName].phases[phase]`
+ *   2. `config.agents.workflows[workflowName].default`
+ *   3. `config.agents.default`  (cluster env folds into this tier via loader)
+ *   4. `config.defaultsAgent`   (**provider only** — `defaults.agent` is a bare string)
+ *   5. Built-in `DEFAULT_PROVIDER = 'claude-code'` (**provider only**)
+ *
+ * The `model` walk terminates at tier 3 returning `undefined` (no built-in
+ * model default). The `provider` walk always returns a value.
+ */
+export function resolveAgentForPhase(config, workflowName, phase) {
+    const workflowEntry = config.agents?.workflows?.[workflowName];
+    const tiers = [
+        workflowEntry?.phases?.[phase],
+        workflowEntry?.default,
+        config.agents?.default,
+    ];
+    const providerFromTiers = tiers.find((t) => t?.provider !== undefined)?.provider;
+    const provider = providerFromTiers ?? config.defaultsAgent ?? DEFAULT_PROVIDER;
+    const model = tiers.find((t) => t?.model !== undefined)?.model;
+    return model !== undefined ? { provider, model } : { provider };
+}
 //# sourceMappingURL=config.js.map

package/dist/worker/config.js.map

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

package/dist/worker/failure-fingerprint.d.ts

@@ -0,0 +1,41 @@
+/**
+ * #942: Failure fingerprint primitive.
+ *
+ * `computeFailureFingerprint({ phase, evidence })` returns a stable
+ * 16-char lowercase hex sha256 prefix that is byte-identical across worker
+ * invocations for the same underlying defect (same phase + classifier +
+ * reason text). It is the load-bearing invariant for repeat-failure detection.
+ *
+ * `parseFailureAlertMarker(commentBody)` reads line 1 of a previously-posted
+ * failure-alert comment and returns the fingerprint + occurrence when the v2
+ * sibling marker (`<!-- fp:HEX:N -->`) is present, or `null` when it's absent
+ * (v1 / pre-#942 comments). Never throws.
+ */
+import type { CommandExitEvidence, FailureFingerprint, WorkflowPhase } from './types.js';
+/** Q3→A: escalate on the 2nd same-fingerprint failure. */
+export declare const REPEAT_FAILURE_THRESHOLD = 2;
+/** Q1→B: hex prefix length. 16 chars = 64 bits — sufficient for per-issue scan. */
+export declare const FINGERPRINT_HEX_LENGTH = 16;
+export interface FailureFingerprintInput {
+    phase: WorkflowPhase | string;
+    evidence: CommandExitEvidence;
+}
+/**
+ * Compute the fingerprint per contract §Semantics.
+ *
+ * `sha256(phase + '\x00' + classifier + '\x00' + reasonText).slice(0, 16)`
+ * — hex, lowercase. Null-byte joiner prevents field-boundary collisions.
+ */
+export declare function computeFailureFingerprint(input: FailureFingerprintInput): FailureFingerprint;
+export interface ParsedFailureAlertMarker {
+    fingerprint: FailureFingerprint;
+    occurrence: number;
+}
+/**
+ * Parse the v2 marker on line 1 of a failure-alert comment body.
+ *
+ * Returns `null` for v1 (pre-#942) comments, malformed markers, or bodies
+ * where line 1 does not contain the v2 sibling marker. Never throws.
+ */
+export declare function parseFailureAlertMarker(commentBody: string): ParsedFailureAlertMarker | null;
+//# sourceMappingURL=failure-fingerprint.d.ts.map

package/dist/worker/failure-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-fingerprint.d.ts","sourceRoot":"","sources":["../../src/worker/failure-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGzF,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAwBzC,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CAQpB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,GAClB,wBAAwB,GAAG,IAAI,CAOjC"}