@cat-factory/orchestration 0.298.1 → 0.300.0

package/dist/modules/execution/bugFishing.logic.d.ts

@@ -0,0 +1,129 @@
+import { type BugFishingAgentOutput, type BugFishingFinding, type BugFishingPhase, type BugFishingSpawn, type BugFishingStepState } from '@cat-factory/kernel';
+export { BUG_FISHING_SPAWN_CLAIM_TTL_MS, bugFishingSpawnIsClaimable } from '@cat-factory/kernel';
+/**
+ * Plan the angles an expedition will fish.
+ *
+ * `selected` is the creator's pick, held as bare strings (a task authored against a later
+ * build's angle list must still parse here). An id this build does not ship is DROPPED and
+ * returned in `unknown`, so the caller can say so in the plan rather than silently fishing
+ * fewer angles than the person asked for. An empty or entirely-unrecognised selection falls
+ * back to the whole catalog, which is the intended default: an expedition exists to cover
+ * ground nobody thought to look at, so narrowing it is the deliberate act.
+ *
+ * Order follows the CATALOG rather than the selection, so two expeditions on the same board
+ * fish their shared angles in the same order and their phase lists read alike.
+ */
+export declare function planBugFishingPhases(selected: readonly string[] | undefined): {
+    phases: BugFishingPhase[];
+    unknown: string[];
+};
+/**
+ * Turn ONE pass's raw output into stamped, severity-ordered findings.
+ *
+ * A finding with neither a title nor a detail is dropped: the lenient agent schema fills both
+ * with `''` rather than failing the parse, so an entry carrying neither is an artefact of that
+ * leniency and not something a human could triage. Everything else is kept, including a finding
+ * with no path — an expedition can legitimately report a gap that spans files, and blanking the
+ * row would be the platform deciding it did not happen.
+ */
+export declare function coerceBugFishingFindings(output: BugFishingAgentOutput | undefined, phaseId: string, mintId: () => string): {
+    findings: BugFishingFinding[];
+    dropped: number;
+};
+/**
+ * Record a COMPLETED pass: settle its phase with the summary it gave, append its findings, and
+ * move the cursor to the next angle.
+ *
+ * The returned status is `fishing` while an angle is still pending and `awaiting_triage` once
+ * the last one settles — the state's own answer to "is there more coming", which the window
+ * renders and the controller uses to decide between re-arming the step and parking the run.
+ */
+export declare function recordBugFishingPhase(state: BugFishingStepState, phaseIndex: number, outcome: {
+    summary: string | null;
+    findings: BugFishingFinding[];
+    dropped: number;
+    at: number;
+}): BugFishingStepState;
+/**
+ * Record a pass that FAILED (its container job crashed, or produced nothing usable). The phase
+ * is settled as `failed` carrying the reason and the expedition moves on to the next angle.
+ *
+ * One angle failing must never cost the expedition the angles that already landed, nor the ones
+ * still to come: the passes are independent by construction, which is the point of running them
+ * as separate dispatches. The failure is NAMED on the phase rather than dropped, because a phase
+ * that silently reported nothing reads exactly like a phase that found nothing.
+ */
+export declare function failBugFishingPhase(state: BugFishingStepState, phaseIndex: number, reason: string | null, at: number): BugFishingStepState;
+/** Mark the phase at `phaseIndex` as being fished right now (the dispatch just went out). */
+export declare function startBugFishingPhase(state: BugFishingStepState, phaseIndex: number): BugFishingStepState;
+/**
+ * CLAIM a finding for a spawn, BEFORE the task it names is created.
+ *
+ * The claim is what makes marking safe against two callers at once: it is written under the
+ * run's compare-and-swap, so exactly one of them lands and the loser's transform is a no-op on
+ * a finding that is no longer claimable. The claimer recognises its own by the `taskId` it minted
+ * and put in the claim, exactly as the initiative loop recognises its own spawn by block id —
+ * which is what lets {@link settleBugFishingSpawn} refuse to overwrite a claim it does not own.
+ *
+ * A no-op on an unknown, dismissed or already-claimed finding. The caller re-reads the finding
+ * afterwards and compares the `taskId`: that comparison, not this function, is how it learns
+ * whether it won.
+ */
+export declare function claimBugFishingSpawn(state: BugFishingStepState, findingId: string, claim: BugFishingSpawn, now: number): BugFishingStepState;
+/**
+ * SETTLE a claim this caller owns: `spawned` once the task and its run exist, or `failed` with
+ * the cause when they do not.
+ *
+ * Matched on `taskId`, so a claim that expired and was re-taken by somebody else is left alone.
+ * Overwriting it would report the loser's outcome against the winner's task.
+ */
+export declare function settleBugFishingSpawn(state: BugFishingStepState, findingId: string, taskId: string, outcome: {
+    status: 'spawned';
+    executionId: string | null;
+} | {
+    status: 'failed';
+    failureReason: string;
+}): BugFishingStepState;
+/**
+ * Dismiss a finding: it stays on the record, struck through, and can no longer be marked.
+ *
+ * Kept rather than removed because the expedition's record is what a human reads to decide
+ * whether the hunt was worth running: a finding that was looked at and rejected is evidence
+ * about the agent's precision, and deleting it would make every expedition look flawless.
+ * Idempotent, and a no-op on a finding whose fix task exists or is being created (that decision
+ * is made). A finding whose last mark FAILED is dismissable: nothing was created for it.
+ */
+export declare function dismissBugFishingFinding(state: BugFishingStepState, findingId: string, now: number): BugFishingStepState;
+/**
+ * Findings with no decision yet: neither dismissed nor carrying a mark that landed.
+ *
+ * A `failed` spawn counts as UNTRIAGED, because it is: the human made a decision, the platform
+ * did not carry it out, and nothing was created. Counting it as done is how "N findings to
+ * triage" would come to under-report the work left, on exactly the runs where something went
+ * wrong.
+ */
+export declare function untriagedBugFishingFindings(state: BugFishingStepState, now: number): readonly BugFishingFinding[];
+/**
+ * The finding titles to brief the NEXT pass with, so it does not re-report what earlier angles
+ * already caught. Dismissed findings are included deliberately: a human rejecting a finding says
+ * they do not want it fixed, not that the next pass should raise it again.
+ */
+export declare function priorBugFishingFindingTitles(state: BugFishingStepState): string[];
+/**
+ * The angle a phase index names, described from the CATALOG but falling back to what the run
+ * itself recorded.
+ *
+ * Two different absences, and they need different answers. A phase whose id this build retired
+ * is described by {@link describeBugFishingPhase} as retired, but the run still knows the title
+ * and goal it was planned under, so those win over the placeholder — the expedition genuinely
+ * fished that angle and its own record is the better witness. Only an id with no recorded phase
+ * at all falls through to the placeholder.
+ */
+export declare function describeRecordedPhase(phase: BugFishingPhase): {
+    id: string;
+    focus: string;
+    retired?: boolean;
+    title: string;
+    goal: string;
+};
+//# sourceMappingURL=bugFishing.logic.d.ts.map

package/dist/modules/execution/bugFishing.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bugFishing.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/bugFishing.logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAIzB,MAAM,qBAAqB,CAAA;AAK5B,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAgDhG;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG;IAC7E,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,CAiBA;AAQD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,MAAM,GACnB;IAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA0BpD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9F,mBAAmB,CAoBrB;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,EAAE,EAAE,MAAM,GACT,mBAAmB,CAkBrB;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAQrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,MAAM,GACV,mBAAmB,CASrB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EACH;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAC9C,mBAAmB,CASrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,mBAAmB,CASrB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,MAAM,GACV,SAAS,iBAAiB,EAAE,CAI9B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAEjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe;;;;;;EAO3D"}

package/dist/modules/execution/bugFishing.logic.js

@@ -0,0 +1,284 @@
+import { BUG_FISHING_PHASES, BUG_FISHING_SEVERITY_ORDER, bugFishingSpawnIsClaimable, describeBugFishingPhase, redactSecrets, } from '@cat-factory/kernel';
+// The one rule both this engine and the triage window judge a finding by ("is anything being
+// done about it") lives in contracts, so the window cannot come to offer a mark this refuses.
+// Re-exported so a caller in this module's own layer keeps one import.
+export { BUG_FISHING_SPAWN_CLAIM_TTL_MS, bugFishingSpawnIsClaimable } from '@cat-factory/kernel';
+// ---------------------------------------------------------------------------
+// Pure reductions over a bug-fishing expedition's step state. Everything here is a
+// total function of (state, input) → state so the controller's CAS bodies stay pure
+// and every rule is unit-testable without a run: which angles an expedition plans,
+// how one pass's raw output becomes stamped findings, and what marking or dismissing
+// a finding does to the record.
+//
+// The mirror of `prReview.logic.ts` for the expedition flow.
+// ---------------------------------------------------------------------------
+/** Cap on a single finding's free-text field, so one runaway reply cannot bloat the run blob. */
+const MAX_FINDING_TEXT = 4000;
+/** Cap on a phase summary. */
+const MAX_SUMMARY = 4000;
+/**
+ * Most findings one pass may contribute.
+ *
+ * The state rides the run's persisted `detail` blob, re-serialized on every progress write, and
+ * an expedition runs eight passes over it. The cap is generous enough that hitting it means the
+ * pass stopped applying the finding bar, which is why the overflow is REPORTED in the phase
+ * summary rather than silently trimmed: a reader who assumed a prefix would conclude the tail
+ * was never found.
+ */
+const MAX_FINDINGS_PER_PHASE = 40;
+/**
+ * Trim, SCRUB and cap one field of a finding, in that order.
+ *
+ * Scrubbing at the mint site rather than at each reader, and BEFORE the cap, for the reason the
+ * PR-report composer states: a finding's `evidence` is code the agent quoted out of the
+ * repository, so a checked-in credential reaches it the same way it reaches any captured output.
+ * From here it lands in the expedition record, in the triage window, in an inbox card, and in the
+ * DESCRIPTION of every spawned fix task — four surfaces, only one of which would be an obvious
+ * place to remember. Scrubbing before the cap keeps a redacted span from being split in half by
+ * it, which would put the tail of a secret back in the text.
+ */
+function clamp(text, max) {
+    const t = redactSecrets((text ?? '').trim()) ?? '';
+    return t.length > max ? `${t.slice(0, max)}…` : t;
+}
+function optionalClamped(text, max) {
+    const t = clamp(text, max);
+    return t.length > 0 ? t : undefined;
+}
+/**
+ * Plan the angles an expedition will fish.
+ *
+ * `selected` is the creator's pick, held as bare strings (a task authored against a later
+ * build's angle list must still parse here). An id this build does not ship is DROPPED and
+ * returned in `unknown`, so the caller can say so in the plan rather than silently fishing
+ * fewer angles than the person asked for. An empty or entirely-unrecognised selection falls
+ * back to the whole catalog, which is the intended default: an expedition exists to cover
+ * ground nobody thought to look at, so narrowing it is the deliberate act.
+ *
+ * Order follows the CATALOG rather than the selection, so two expeditions on the same board
+ * fish their shared angles in the same order and their phase lists read alike.
+ */
+export function planBugFishingPhases(selected) {
+    const picked = new Set((selected ?? []).map((id) => id.trim()).filter((id) => id.length > 0));
+    const unknown = [...picked].filter((id) => !BUG_FISHING_PHASES.some((p) => p.id === id));
+    const chosen = BUG_FISHING_PHASES.filter((p) => picked.size === 0 || picked.has(p.id));
+    const catalog = chosen.length > 0 ? chosen : BUG_FISHING_PHASES;
+    return {
+        phases: catalog.map((p) => ({
+            id: p.id,
+            title: p.title,
+            goal: p.goal,
+            status: 'pending',
+            summary: null,
+            settledAt: null,
+            failureReason: null,
+        })),
+        unknown,
+    };
+}
+/** Severity rank, most severe first; an unrecognised severity sorts last rather than first. */
+function severityRank(severity) {
+    const index = BUG_FISHING_SEVERITY_ORDER.indexOf(severity);
+    return index === -1 ? BUG_FISHING_SEVERITY_ORDER.length : index;
+}
+/**
+ * Turn ONE pass's raw output into stamped, severity-ordered findings.
+ *
+ * A finding with neither a title nor a detail is dropped: the lenient agent schema fills both
+ * with `''` rather than failing the parse, so an entry carrying neither is an artefact of that
+ * leniency and not something a human could triage. Everything else is kept, including a finding
+ * with no path — an expedition can legitimately report a gap that spans files, and blanking the
+ * row would be the platform deciding it did not happen.
+ */
+export function coerceBugFishingFindings(output, phaseId, mintId) {
+    const raw = (output?.findings ?? []).filter((f) => clamp(f.title, MAX_FINDING_TEXT).length > 0 || clamp(f.detail, MAX_FINDING_TEXT).length > 0);
+    const kept = [...raw].sort((a, b) => severityRank(a.severity) - severityRank(b.severity));
+    const dropped = Math.max(0, kept.length - MAX_FINDINGS_PER_PHASE);
+    return {
+        findings: kept.slice(0, MAX_FINDINGS_PER_PHASE).map((f) => ({
+            id: mintId(),
+            phaseId,
+            path: clamp(f.path, 400),
+            line: typeof f.line === 'number' && Number.isFinite(f.line) ? f.line : null,
+            severity: f.severity,
+            kind: f.kind,
+            confidence: f.confidence,
+            title: clamp(f.title, 300) || clamp(f.detail, 300),
+            detail: clamp(f.detail, MAX_FINDING_TEXT),
+            failureScenario: optionalClamped(f.failureScenario, MAX_FINDING_TEXT) ?? null,
+            evidence: optionalClamped(f.evidence, MAX_FINDING_TEXT) ?? null,
+            suggestedFix: optionalClamped(f.suggestedFix, MAX_FINDING_TEXT) ?? null,
+            spawn: null,
+            dismissed: false,
+        })),
+        dropped,
+    };
+}
+/**
+ * Record a COMPLETED pass: settle its phase with the summary it gave, append its findings, and
+ * move the cursor to the next angle.
+ *
+ * The returned status is `fishing` while an angle is still pending and `awaiting_triage` once
+ * the last one settles — the state's own answer to "is there more coming", which the window
+ * renders and the controller uses to decide between re-arming the step and parking the run.
+ */
+export function recordBugFishingPhase(state, phaseIndex, outcome) {
+    const phases = (state.phases ?? []).map((phase, i) => i === phaseIndex
+        ? {
+            ...phase,
+            status: 'completed',
+            summary: phaseSummary(outcome.summary, outcome.findings.length, outcome.dropped),
+            settledAt: outcome.at,
+            failureReason: null,
+        }
+        : phase);
+    const next = phaseIndex + 1;
+    return {
+        ...state,
+        phases,
+        currentPhaseIndex: next,
+        findings: [...(state.findings ?? []), ...outcome.findings],
+        status: next < phases.length ? 'fishing' : 'awaiting_triage',
+    };
+}
+/**
+ * The phase summary as recorded: the agent's own account, plus a sentence naming any findings
+ * the per-phase cap dropped.
+ *
+ * A cap that is not a plain prefix has to say so — a reader who assumed one would conclude the
+ * tail was never found, when in fact it was found and discarded.
+ */
+function phaseSummary(summary, kept, dropped) {
+    const base = clamp(summary, MAX_SUMMARY);
+    if (dropped <= 0)
+        return base;
+    const note = `This pass reported more findings than one phase may record: the ${kept} most severe were ` +
+        `kept and ${dropped} lower-severity ones were dropped. Re-run this angle with a narrower ` +
+        'focus to see them.';
+    return base ? `${base}\n\n${note}` : note;
+}
+/**
+ * Record a pass that FAILED (its container job crashed, or produced nothing usable). The phase
+ * is settled as `failed` carrying the reason and the expedition moves on to the next angle.
+ *
+ * One angle failing must never cost the expedition the angles that already landed, nor the ones
+ * still to come: the passes are independent by construction, which is the point of running them
+ * as separate dispatches. The failure is NAMED on the phase rather than dropped, because a phase
+ * that silently reported nothing reads exactly like a phase that found nothing.
+ */
+export function failBugFishingPhase(state, phaseIndex, reason, at) {
+    const phases = (state.phases ?? []).map((phase, i) => i === phaseIndex
+        ? {
+            ...phase,
+            status: 'failed',
+            settledAt: at,
+            failureReason: clamp(reason, 2000) || 'The pass did not complete.',
+        }
+        : phase);
+    const next = phaseIndex + 1;
+    return {
+        ...state,
+        phases,
+        currentPhaseIndex: next,
+        status: next < phases.length ? 'fishing' : 'awaiting_triage',
+    };
+}
+/** Mark the phase at `phaseIndex` as being fished right now (the dispatch just went out). */
+export function startBugFishingPhase(state, phaseIndex) {
+    return {
+        ...state,
+        currentPhaseIndex: phaseIndex,
+        phases: (state.phases ?? []).map((phase, i) => i === phaseIndex ? { ...phase, status: 'fishing' } : phase),
+    };
+}
+/**
+ * CLAIM a finding for a spawn, BEFORE the task it names is created.
+ *
+ * The claim is what makes marking safe against two callers at once: it is written under the
+ * run's compare-and-swap, so exactly one of them lands and the loser's transform is a no-op on
+ * a finding that is no longer claimable. The claimer recognises its own by the `taskId` it minted
+ * and put in the claim, exactly as the initiative loop recognises its own spawn by block id —
+ * which is what lets {@link settleBugFishingSpawn} refuse to overwrite a claim it does not own.
+ *
+ * A no-op on an unknown, dismissed or already-claimed finding. The caller re-reads the finding
+ * afterwards and compares the `taskId`: that comparison, not this function, is how it learns
+ * whether it won.
+ */
+export function claimBugFishingSpawn(state, findingId, claim, now) {
+    return {
+        ...state,
+        findings: (state.findings ?? []).map((f) => f.id === findingId && !f.dismissed && bugFishingSpawnIsClaimable(f.spawn, now)
+            ? { ...f, spawn: claim }
+            : f),
+    };
+}
+/**
+ * SETTLE a claim this caller owns: `spawned` once the task and its run exist, or `failed` with
+ * the cause when they do not.
+ *
+ * Matched on `taskId`, so a claim that expired and was re-taken by somebody else is left alone.
+ * Overwriting it would report the loser's outcome against the winner's task.
+ */
+export function settleBugFishingSpawn(state, findingId, taskId, outcome) {
+    return {
+        ...state,
+        findings: (state.findings ?? []).map((f) => f.id === findingId && f.spawn?.taskId === taskId
+            ? { ...f, spawn: { ...f.spawn, ...outcome } }
+            : f),
+    };
+}
+/**
+ * Dismiss a finding: it stays on the record, struck through, and can no longer be marked.
+ *
+ * Kept rather than removed because the expedition's record is what a human reads to decide
+ * whether the hunt was worth running: a finding that was looked at and rejected is evidence
+ * about the agent's precision, and deleting it would make every expedition look flawless.
+ * Idempotent, and a no-op on a finding whose fix task exists or is being created (that decision
+ * is made). A finding whose last mark FAILED is dismissable: nothing was created for it.
+ */
+export function dismissBugFishingFinding(state, findingId, now) {
+    return {
+        ...state,
+        findings: (state.findings ?? []).map((f) => f.id === findingId && bugFishingSpawnIsClaimable(f.spawn, now)
+            ? { ...f, dismissed: true }
+            : f),
+    };
+}
+/**
+ * Findings with no decision yet: neither dismissed nor carrying a mark that landed.
+ *
+ * A `failed` spawn counts as UNTRIAGED, because it is: the human made a decision, the platform
+ * did not carry it out, and nothing was created. Counting it as done is how "N findings to
+ * triage" would come to under-report the work left, on exactly the runs where something went
+ * wrong.
+ */
+export function untriagedBugFishingFindings(state, now) {
+    return (state.findings ?? []).filter((f) => !f.dismissed && bugFishingSpawnIsClaimable(f.spawn, now));
+}
+/**
+ * The finding titles to brief the NEXT pass with, so it does not re-report what earlier angles
+ * already caught. Dismissed findings are included deliberately: a human rejecting a finding says
+ * they do not want it fixed, not that the next pass should raise it again.
+ */
+export function priorBugFishingFindingTitles(state) {
+    return (state.findings ?? []).map((f) => f.title).filter((t) => t.trim().length > 0);
+}
+/**
+ * The angle a phase index names, described from the CATALOG but falling back to what the run
+ * itself recorded.
+ *
+ * Two different absences, and they need different answers. A phase whose id this build retired
+ * is described by {@link describeBugFishingPhase} as retired, but the run still knows the title
+ * and goal it was planned under, so those win over the placeholder — the expedition genuinely
+ * fished that angle and its own record is the better witness. Only an id with no recorded phase
+ * at all falls through to the placeholder.
+ */
+export function describeRecordedPhase(phase) {
+    const described = describeBugFishingPhase(phase.id);
+    return {
+        ...described,
+        title: phase.title || described.title,
+        goal: phase.goal || described.goal,
+    };
+}
+//# sourceMappingURL=bugFishing.logic.js.map

package/dist/modules/execution/bugFishing.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bugFishing.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/bugFishing.logic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAM1B,0BAA0B,EAC1B,uBAAuB,EACvB,aAAa,GACd,MAAM,qBAAqB,CAAA;AAE5B,6FAA6F;AAC7F,8FAA8F;AAC9F,uEAAuE;AACvE,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAA;AAEhG,8EAA8E;AAC9E,mFAAmF;AACnF,oFAAoF;AACpF,mFAAmF;AACnF,qFAAqF;AACrF,gCAAgC;AAChC,EAAE;AACF,6DAA6D;AAC7D,8EAA8E;AAE9E,iGAAiG;AACjG,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAC7B,8BAA8B;AAC9B,MAAM,WAAW,GAAG,IAAI,CAAA;AACxB;;;;;;;;GAQG;AACH,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAEjC;;;;;;;;;;GAUG;AACH,SAAS,KAAK,CAAC,IAA+B,EAAE,GAAW;IACzD,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;IAClD,OAAO,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,SAAS,eAAe,CAAC,IAA+B,EAAE,GAAW;IACnE,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC1B,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAuC;IAI1E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;IAC7F,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IACxF,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACtF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAA;IAC/D,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,SAAkB;YAC1B,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,OAAO;KACR,CAAA;AACH,CAAC;AAED,+FAA+F;AAC/F,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,CAAC,QAAiB,CAAC,CAAA;IACnE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;AACjE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAyC,EACzC,OAAe,EACf,MAAoB;IAEpB,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAC9F,CAAA;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAA;IACjE,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,EAAE,EAAE,MAAM,EAAE;YACZ,OAAO;YACP,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;YACxB,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YAC3E,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC;YAClD,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC;YACzC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,eAAe,EAAE,gBAAgB,CAAC,IAAI,IAAI;YAC7E,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,IAAI;YAC/D,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,YAAY,EAAE,gBAAgB,CAAC,IAAI,IAAI;YACvE,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,OAAO;KACR,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA0B,EAC1B,UAAkB,EAClB,OAA+F;IAE/F,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CACnD,CAAC,KAAK,UAAU;QACd,CAAC,CAAC;YACE,GAAG,KAAK;YACR,MAAM,EAAE,WAAoB;YAC5B,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;YAChF,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,aAAa,EAAE,IAAI;SACpB;QACH,CAAC,CAAC,KAAK,CACV,CAAA;IACD,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC,CAAA;IAC3B,OAAO;QACL,GAAG,KAAK;QACR,MAAM;QACN,iBAAiB,EAAE,IAAI;QACvB,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1D,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB;KAC7D,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,OAAsB,EAAE,IAAY,EAAE,OAAe;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IACxC,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC7B,MAAM,IAAI,GACR,mEAAmE,IAAI,oBAAoB;QAC3F,YAAY,OAAO,uEAAuE;QAC1F,oBAAoB,CAAA;IACtB,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA0B,EAC1B,UAAkB,EAClB,MAAqB,EACrB,EAAU;IAEV,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CACnD,CAAC,KAAK,UAAU;QACd,CAAC,CAAC;YACE,GAAG,KAAK;YACR,MAAM,EAAE,QAAiB;YACzB,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,4BAA4B;SACnE;QACH,CAAC,CAAC,KAAK,CACV,CAAA;IACD,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC,CAAA;IAC3B,OAAO;QACL,GAAG,KAAK;QACR,MAAM;QACN,iBAAiB,EAAE,IAAI;QACvB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB;KAC7D,CAAA;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,UAAkB;IAElB,OAAO;QACL,GAAG,KAAK;QACR,iBAAiB,EAAE,UAAU;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAC5C,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,CACpE;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,SAAiB,EACjB,KAAsB,EACtB,GAAW;IAEX,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzC,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,0BAA0B,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC;YAC5E,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;YACxB,CAAC,CAAC,CAAC,CACN;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA0B,EAC1B,SAAiB,EACjB,MAAc,EACd,OAE+C;IAE/C,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzC,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;YAC9C,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,OAAO,EAAE,EAAE;YAC7C,CAAC,CAAC,CAAC,CACN;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAA0B,EAC1B,SAAiB,EACjB,GAAW;IAEX,OAAO;QACL,GAAG,KAAK;QACR,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzC,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,0BAA0B,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC;YAC5D,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;YAC3B,CAAC,CAAC,CAAC,CACN;KACF,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA0B,EAC1B,GAAW;IAEX,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,0BAA0B,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAChE,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAA0B;IACrE,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AACtF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAsB;IAC1D,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACnD,OAAO;QACL,GAAG,SAAS;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC,KAAK;QACrC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI;KACnC,CAAA;AACH,CAAC"}

package/dist/modules/execution/deployer.logic.d.ts

@@ -44,6 +44,47 @@ export declare function orderProvisionTargets(targets: ReadonlyArray<{
  * replay of the dispatch still reproduces the same id.
  */
 export declare function deployDispatchEpoch(step: PipelineStep): number;
+/**
+ * Re-arm a `deployer` step's `deploy-fixer` budget for another provisioning cycle, keeping the
+ * rounds already on the record.
+ *
+ * `phase` is reset to `retrying` because a stale `fixing` routes the re-run's container-backed
+ * deploy job to the agent poller that never dispatched it. The two members are both live-loop
+ * phases and the poll router asks only whether the phase IS `fixing`, so `retrying` is the one
+ * that means "no fixer job is in flight, and the deployer is about to provision".
+ */
+export declare function restartDeployFixState(fix: PipelineStep['deployFix']): PipelineStep['deployFix'] | undefined;
+/**
+ * Re-arm a `deployer` step's environment-investigation budget for another provisioning cycle,
+ * keeping the rounds already on the record.
+ *
+ * `environmentId` goes, because it names the environment this cycle supersedes and a round run
+ * against it would restart, re-probe or tear down infrastructure the re-provision has replaced.
+ *
+ * `waitExtensions` deliberately does NOT go, unlike the round counter beside it. It is both the
+ * bound on `wait` verdicts and the run's only record that one was granted (the bring-up simply
+ * runs past the configured ceiling), and a cycle is not always started by a person or a gate:
+ * `StepGraph.rerunProducerThrough` resets every step from a producer through its companion and
+ * judge, and the judge and below-threshold companion loops both drive it with no human involved.
+ * Re-arming it would hand the model a fresh ceiling extension per automatic rework round, and
+ * would erase the granted one from the record the verification report reduces.
+ */
+export declare function restartEnvironmentInvestigationState(state: PipelineStep['environmentInvestigation']): PipelineStep['environmentInvestigation'] | undefined;
+/**
+ * Append one round to a remediation loop's run-long attempt log, dropping the oldest rows past
+ * `max` and counting what went.
+ *
+ * Shared by both loops because both logs have the same shape of problem: they survive the run
+ * (the verification report reduces them) while living inside the `ExecutionInstance` JSON blob,
+ * which is re-serialized on every step write and compare-and-swapped on every persist, so an
+ * uncapped log grows with every loop-back for the rest of the run. The drop is COUNTED rather
+ * than silent: the report reduces the surviving rows, so a dropped round would otherwise read as
+ * one that never ran. The model is `appendRalphAttempt`, which caps the same kind of log.
+ */
+export declare function appendAttemptLog<T>(log: readonly T[] | null | undefined, entry: T, max: number, dropped: number | null | undefined): {
+    attemptLog: T[];
+    droppedAttempts: number;
+};
 /**
  * Whether the ENABLED chain contains a `deployer` step. The Deployer-config gate fires only then:
  * a pipeline with no enabled deployer stands no environment up, so its provisioning config is

package/dist/modules/execution/deployer.logic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployer.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/deployer.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAG3F;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,EAC/D,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GACpD,MAAM,EAAE,CAuBV;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAG9D;AAgBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GACtC,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,mBAAmB,GAAG,SAAS,GAC5C,MAAM,EAAE,CAcV;AAED,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,sHAAsH;IACtH,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC;;;;OAIG;IACH,iBAAiB,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,GAAG,eAAe,CAAA;KAAE,CAAA;IAC3E;;;;OAIG;IACH,cAAc,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACnD;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,2BAA2B,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC9E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,YAAY,GAAG,eAAe,CAAA;CAAE,GAC3F;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,sBAAsB,CAqBvF"}
+{"version":3,"file":"deployer.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/execution/deployer.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAG3F;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,EAC/D,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GACpD,MAAM,EAAE,CAuBV;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAG9D;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,YAAY,CAAC,WAAW,CAAC,GAC7B,YAAY,CAAC,WAAW,CAAC,GAAG,SAAS,CASvC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,YAAY,CAAC,0BAA0B,CAAC,GAC9C,YAAY,CAAC,0BAA0B,CAAC,GAAG,SAAS,CAStD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,EACpC,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACjC;IAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAO9C;AAgBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GACtC,OAAO,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,mBAAmB,GAAG,SAAS,GAC5C,MAAM,EAAE,CAcV;AAED,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,aAAa,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,sHAAsH;IACtH,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC;;;;OAIG;IACH,iBAAiB,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,GAAG,eAAe,CAAA;KAAE,CAAA;IAC3E;;;;OAIG;IACH,cAAc,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACnD;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,2BAA2B,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC9E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,YAAY,GAAG,eAAe,CAAA;CAAE,GAC3F;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,sBAAsB,CAqBvF"}

package/dist/modules/execution/deployer.logic.js

@@ -76,6 +76,92 @@ export function deployDispatchEpoch(step) {
     return evictions + Math.max(0, (step.attempts ?? 1) - 1);
 }
 // ---------------------------------------------------------------------------
+// Re-arming the two remediation loops for a fresh provisioning cycle.
+//
+// A `deployer` step is re-run WITHIN one run whenever something loops back to it (the `human-test`
+// gate rebuilding the environment a person is testing, a producer re-run through it), and each of
+// these keeps the two halves the loops need kept apart:
+//
+//  - The COUNTERS are per provisioning CYCLE. A re-run provisions from scratch, so it is a fresh
+//    failure if it fails, and carrying the spent `attempts` across sends its FIRST failure
+//    straight to the give-up: a `deploy_blocked` card raised with zero repair rounds actually
+//    run, or a terminal failure explained by the PREVIOUS environment's verdict.
+//  - The ATTEMPT LOG is per RUN, because it is what the run's verification report reduces. A
+//    frame repaired by one cycle and re-deployed cleanly by the next was still machine-edited,
+//    and dropping the log makes the report say nothing was ever attempted. Each row carries the
+//    CYCLE it ran in, which is what lets a reader of the run-long log tell the rounds the live
+//    budget was spent on from the ones a superseded environment's cycle spent.
+//
+// Both return undefined for a step that carries no such state, so a caller can spread them
+// unconditionally. The retry path (`retry.logic.resetStep`) deliberately drops both by omission:
+// a retry is a NEW run with a report of its own, so nothing there is history worth keeping.
+// ---------------------------------------------------------------------------
+/**
+ * Re-arm a `deployer` step's `deploy-fixer` budget for another provisioning cycle, keeping the
+ * rounds already on the record.
+ *
+ * `phase` is reset to `retrying` because a stale `fixing` routes the re-run's container-backed
+ * deploy job to the agent poller that never dispatched it. The two members are both live-loop
+ * phases and the poll router asks only whether the phase IS `fixing`, so `retrying` is the one
+ * that means "no fixer job is in flight, and the deployer is about to provision".
+ */
+export function restartDeployFixState(fix) {
+    if (!fix)
+        return undefined;
+    return {
+        ...fix,
+        phase: 'retrying',
+        attempts: 0,
+        cycle: (fix.cycle ?? 0) + 1,
+        attemptLog: fix.attemptLog ?? [],
+    };
+}
+/**
+ * Re-arm a `deployer` step's environment-investigation budget for another provisioning cycle,
+ * keeping the rounds already on the record.
+ *
+ * `environmentId` goes, because it names the environment this cycle supersedes and a round run
+ * against it would restart, re-probe or tear down infrastructure the re-provision has replaced.
+ *
+ * `waitExtensions` deliberately does NOT go, unlike the round counter beside it. It is both the
+ * bound on `wait` verdicts and the run's only record that one was granted (the bring-up simply
+ * runs past the configured ceiling), and a cycle is not always started by a person or a gate:
+ * `StepGraph.rerunProducerThrough` resets every step from a producer through its companion and
+ * judge, and the judge and below-threshold companion loops both drive it with no human involved.
+ * Re-arming it would hand the model a fresh ceiling extension per automatic rework round, and
+ * would erase the granted one from the record the verification report reduces.
+ */
+export function restartEnvironmentInvestigationState(state) {
+    if (!state)
+        return undefined;
+    return {
+        ...state,
+        attempts: 0,
+        environmentId: null,
+        cycle: (state.cycle ?? 0) + 1,
+        attemptLog: state.attemptLog ?? [],
+    };
+}
+/**
+ * Append one round to a remediation loop's run-long attempt log, dropping the oldest rows past
+ * `max` and counting what went.
+ *
+ * Shared by both loops because both logs have the same shape of problem: they survive the run
+ * (the verification report reduces them) while living inside the `ExecutionInstance` JSON blob,
+ * which is re-serialized on every step write and compare-and-swapped on every persist, so an
+ * uncapped log grows with every loop-back for the rest of the run. The drop is COUNTED rather
+ * than silent: the report reduces the surviving rows, so a dropped round would otherwise read as
+ * one that never ran. The model is `appendRalphAttempt`, which caps the same kind of log.
+ */
+export function appendAttemptLog(log, entry, max, dropped) {
+    const appended = [...(log ?? []), entry];
+    const overflow = Math.max(appended.length - max, 0);
+    return {
+        attemptLog: overflow > 0 ? appended.slice(overflow) : appended,
+        droppedAttempts: (dropped ?? 0) + overflow,
+    };
+}
+// ---------------------------------------------------------------------------
 // Run-start Deployer-config gate (pure half).
 //
 // When a pipeline INCLUDES an enabled `deployer` step, the environment it will stand up must be

package/dist/modules/execution/deployer.logic.js.map

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

package/dist/modules/execution/dispatcher-registries.d.ts

@@ -1,4 +1,4 @@
-import type { AgentRunResult, Block, BlockRepository, BrainstormSession, ClarityReview, Clock, ExecutionInstance, GateDefinition, JudgeDefinition, PipelineStep, RequirementReview, RunInitiatorScope, StepCompletionResolver, StepResolverRegistry } from '@cat-factory/kernel';
+import type { AgentRunContext, AgentRunResult, Block, BlockRepository, BrainstormSession, ClarityReview, Clock, ExecutionInstance, GateDefinition, JudgeDefinition, PipelineStep, RequirementReview, RunInitiatorScope, StepCompletionResolver, StepResolverRegistry } from '@cat-factory/kernel';
 import type { AgentKindRegistry } from '@cat-factory/agents';
 import type { EnvironmentProvisioningService } from '@cat-factory/integrations';
 import type { DeployerStepController } from './DeployerStepController.js';
@@ -10,6 +10,7 @@ import type { ReviewGateController, ReviewKind } from './ReviewGateController.js
 import type { BinaryCandidateController } from './BinaryCandidateController.js';
 import type { ForkDecisionController } from './ForkDecisionController.js';
 import { PrReviewController } from './PrReviewController.js';
+import { BugFishingController } from './BugFishingController.js';
 import type { InterviewGateController } from './InterviewGateController.js';
 import type { TesterController } from './TesterController.js';
 import type { RalphController } from './RalphController.js';
@@ -43,6 +44,7 @@ export interface DispatcherRegistryDeps {
     forkDecisionController: ForkDecisionController;
     binaryCandidateController: BinaryCandidateController;
     prReviewController: PrReviewController;
+    bugFishingController: BugFishingController;
     mergeResolver: MergeResolver;
     requirementsKind: ReviewKind<RequirementReview>;
     clarityKind: ReviewKind<ClarityReview>;
@@ -65,7 +67,7 @@ export interface DispatcherRegistryDeps {
     judgeFor: (agentKind: string) => JudgeDefinition | undefined;
     handleForkDecisionPhase: (ctx: StepHandlerContext) => Promise<AdvanceResult>;
     handlePrReviewResolution: (ctx: StepHandlerContext) => Promise<AdvanceResult>;
-    handleAgentStep: (ctx: StepHandlerContext) => Promise<AdvanceResult>;
+    handleAgentStep: (ctx: StepHandlerContext, dispatchKind?: string, augmentContext?: (context: AgentRunContext) => void) => Promise<AdvanceResult>;
     ingestBlueprint: (workspaceId: string, blockId: string, rawService: unknown) => Promise<void>;
     ingestSpec: (workspaceId: string, rawDoc: unknown) => Promise<void>;
 }