@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/workflows/run/run-recovery.js

@@ -0,0 +1,422 @@
+import { logPrefix } from '../../home/display.js';
+import { WAIT_KINDS } from './wait-kinds.js';
+import { atContinue } from './launch-read-resolver.js';
+import { isUsageLimitHold } from '../../contract/index.js';
+import { hasLiveInboxClaim } from '../../delegation/input.js';
+import { holdsOwedResults, isCezarHumanWait, openWaits } from '../waits.js';
+import { hasPendingHumanAsk, pendingHumanAskSeq } from './pending-ask-facts.js';
+import { ciWorkflowResumeStepIndex } from './workflow-position.js';
+import { familyOf, rootFinishRequested } from './run-guards.js';
+export class RunRecovery {
+    context;
+    familyReconciler;
+    workerQuestions;
+    autoResumeScheduler;
+    host;
+    restartContinuationPrompt;
+    /** What the recovery in progress covers: every run at boot (`family` undefined), or the one
+     *  family an adoption hands it (#779, plan step 3). Undefined: no recovery in progress. */
+    recoveryScope;
+    /** Settles when the recovery in progress (if any) has finished. */
+    recoveryInFlight;
+    /** Adoptions of dead processes' runs, one at a time (`adoptOrphanedRun`). */
+    adoptionTail = Promise.resolve();
+    constructor(context, familyReconciler, workerQuestions, autoResumeScheduler, host, restartContinuationPrompt) {
+        this.context = context;
+        this.familyReconciler = familyReconciler;
+        this.workerQuestions = workerQuestions;
+        this.autoResumeScheduler = autoResumeScheduler;
+        this.host = host;
+        this.restartContinuationPrompt = restartContinuationPrompt;
+    }
+    /** Whether any recovery is in progress: one at a time (`recover`), and `pump` waits for it. */
+    get recovering() {
+        return this.recoveryScope !== undefined;
+    }
+    /**
+     * Whether a recovery in progress holds this run, so its wakes, input flushes and delegation
+     * reconciles wait for that recovery's own passes: every run during boot recovery, and only the
+     * adopted family's during a recovery scoped to one. The rest of a running project stays live: a
+     * wake held back for an unrelated family would be lost, since the scoped passes never revisit it.
+     */
+    recoveringRun(run) {
+        const scope = this.recoveryScope;
+        if (!scope)
+            return false;
+        if (scope.family === undefined)
+            return true;
+        const record = typeof run === 'string' ? this.context.store.getRun(run) : run;
+        return record !== undefined && familyOf(record) === scope.family;
+    }
+    async recover(familyRootId) {
+        // A store that could not open (#779) knows none of its runs: recovering it would read "none".
+        if (this.context.disposed() || this.recovering || this.context.store.unavailable)
+            return;
+        this.recoveryScope = { ...(familyRootId === undefined ? {} : { family: familyRootId }) };
+        let settled;
+        this.recoveryInFlight = new Promise((resolve) => { settled = resolve; });
+        const inScope = (run) => familyRootId === undefined || familyOf(run) === familyRootId;
+        try {
+            this.familyReconciler.setRecoveryFactsPending(true);
+            await this.context.store.prepareRecoveryFacts(familyRootId);
+            if (this.context.disposed())
+                return;
+            // Public terminal state can precede the private completion checkpoint. Such a family
+            // has no live/deferred anchor, but orphan settlement still appends its lifecycle event.
+            // Prepare only eligible starting generations' families before any repair mutation;
+            // retain IDs, never an ownership or execution snapshot, across readiness.
+            const { orphanWorkerIds, orphanFactIds } = this.collectOrphanWorkerGenerations(familyRootId, inScope);
+            await this.context.store.prepareTranscriptFacts(orphanFactIds);
+            if (this.context.disposed())
+                return;
+            this.familyReconciler.setRecoveryFactsPending(false);
+            // Recovery reads the live set (#779): `listRuns()` is the runs `open` loaded by the `live`
+            // column, and finished runs have nothing to recover. The worker passes below go through
+            // indexed queries instead.
+            this.recoverUnreadInputs(inScope);
+            // #469: a generation whose processes died with the old controller is finalized first, so it
+            // re-launches through the ordinary Continue path; live task scratch is retained.
+            // Any worker, finished or not, may hold a generation a dead controller left `starting`. Its
+            // private proof is read first, so only those workers' records are decoded: settling and
+            // re-probing are no-ops for every other proof phase.
+            // Another process's workers are its own to settle.
+            this.settleOrphanWorkerGenerations(orphanWorkerIds, inScope);
+            this.host.reconcileWorkerWaits(familyRootId);
+            const live = this.context.store
+                .listRuns()
+                .filter((r) => inScope(r) && ['queued', 'waiting', 'running'].includes(r.status))
+                .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+            // Scratch cleanup discovers private evidence independently of the salvageable run index.
+            // Terminal worker cleanup/retries and the generic orphan sweep share this boundary. An
+            // adopted family only schedules its own members: the sweep belongs to restart.
+            this.recoverWorkerScratch(familyRootId);
+            for (const run of live) {
+                // Await only what the run hands back, so a run that settles nothing recovers without
+                // yielding to the work an earlier run started.
+                const settling = this.recoverLiveRun(run);
+                if (settling)
+                    await settling;
+            }
+            if (familyRootId === undefined)
+                await this.familyReconciler.reconcileRecoveryWorkerFamilies();
+            if (this.context.disposed())
+                return;
+        }
+        finally {
+            this.familyReconciler.setRecoveryFactsPending(false);
+            this.recoveryScope = undefined;
+            this.recoveryInFlight = undefined;
+            settled();
+        }
+        // Only a family with a live member has anyone left to route to or fall back from.
+        this.workerQuestions.recoverWorkerMessages(familyRootId === undefined ? this.familyReconciler.liveFamilyMembers() : this.familyReconciler.familyMembers(familyRootId), familyRootId);
+        // A parent reply accepted just before the crash still answers its worker (#505), and only a
+        // live worker takes one.
+        this.answerRecoveredRoutedQuestions(inScope);
+        // The rest re-arms wakes from durable state and is idempotent, so it runs for every live run
+        // even after one adopted family: anything the recovery window held back goes out now.
+        this.rearmRecoveredWakes();
+        // Re-arm usage-limit resumes (spec 2026-08-03-auto-resume-after-usage-limit): the wait is
+        // routinely longer than a cezar session, so the deadline is durable and the timer is rebuilt
+        // from it. `pump()` reconciles again on every sweep, so this is the fast path, not the only
+        // one — see `reconcileAutoResumes`.
+        this.autoResumeScheduler.reconcileAutoResumes();
+        void this.host.pump();
+    }
+    adoptOrphanedRun(runId, opts = {}) {
+        const adoption = this.adoptionTail.then(async () => {
+            while (this.recovering && this.recoveryInFlight)
+                await this.recoveryInFlight;
+            if (this.context.disposed())
+                return false;
+            const family = this.context.store.adoptFamily(runId, opts);
+            if (family === undefined)
+                return false;
+            await this.host.recover(family);
+            return true;
+        });
+        this.adoptionTail = adoption.catch(() => undefined);
+        return adoption;
+    }
+    /** The workers in scope whose generation a dead controller left `starting`, and the members of
+     *  their families, whose transcript facts recovery prepares before it settles them. */
+    collectOrphanWorkerGenerations(familyRootId, inScope) {
+        const workerIds = familyRootId === undefined ? this.context.store.listWorkerIds() : this.context.store.listWorkersOf(familyRootId).map((run) => run.id);
+        const orphanWorkerIds = [];
+        const orphanFactIds = new Set();
+        for (const id of workerIds) {
+            if (this.context.store.readWorkerExecution(id)?.phase !== 'starting' || this.context.store.writeRefusal(id))
+                continue;
+            const run = this.context.store.getRun(id);
+            if (run?.delegation?.role !== 'worker' || !inScope(run))
+                continue;
+            orphanWorkerIds.push(id);
+            for (const member of this.context.store.listFamilyRunIds(run.delegation.parentRunId))
+                orphanFactIds.add(member);
+        }
+        return { orphanWorkerIds, orphanFactIds };
+    }
+    /** Recovery's first pass over the live set: the input state a dead controller left behind. */
+    recoverUnreadInputs(inScope) {
+        for (const run of this.context.store.listRuns().filter(inScope)) {
+            // A restarted controller cannot answer an old transport's permission RPC.
+            if (!this.host.isActive(run.id) && run.hasPendingPermission) {
+                // A permission wait interrupted an unfinished native turn. Route it
+                // through interrupted-turn recovery, never the settled-worker fallback.
+                if (run.status === 'waiting' && !run.stopping && !this.host.workerExecutionStopped(run.id))
+                    this.context.store.move(run.id, 'resume', { hasPendingPermission: false });
+                else
+                    this.context.store.updateRun(run.id, { hasPendingPermission: false });
+            }
+            this.context.store.clearExpiredInboxClaims(run.id, new Date().toISOString());
+            this.host.inboxClaims.armInboxClaimExpiry(run.id);
+            // #505: the session that accepted this input died before the model read it.
+            // Delivery is at-least-once: the replay keeps the input's ID in its text.
+            if (['queued', 'running', 'waiting'].includes(run.status) && !this.host.isActive(run.id)) {
+                const replayed = this.context.store.requeueAwaitingReadInputs(run.id);
+                if (replayed.length)
+                    this.context.store.appendEvent(run.id, { type: 'note', message: `replaying ${replayed.length} message${replayed.length === 1 ? '' : 's'} accepted before the restart but not read` });
+            }
+        }
+    }
+    /** Settles each orphaned `starting` generation, or re-probes it when its proof does not settle. */
+    settleOrphanWorkerGenerations(orphanWorkerIds, inScope) {
+        for (const id of orphanWorkerIds) {
+            const run = this.context.store.getRun(id);
+            if (!run || !inScope(run))
+                continue;
+            if (this.context.store.readWorkerExecution(id)?.phase === 'starting' && !this.context.store.writeRefusal(id) &&
+                !this.host.settleOrphanedWorkerExecution(id))
+                this.host.orphans.armOrphanReprobe(id);
+        }
+    }
+    /** Restart sweeps every worker's scratch; an adopted family schedules only its own members. */
+    recoverWorkerScratch(familyRootId) {
+        if (familyRootId === undefined)
+            this.host.workerScratchCleanup.recover();
+        else
+            for (const run of this.familyReconciler.familyMembers(familyRootId))
+                this.host.workerScratchCleanup.schedule(run.id);
+    }
+    /**
+     * One live run of the restart loop. Returns the promise the loop must await (a root finish, a
+     * re-queue or a settlement), else `undefined`.
+     */
+    recoverLiveRun(found) {
+        if (this.host.isActive(found.id))
+            return undefined;
+        if (this.host.workerExecutionStopped(found.id))
+            return undefined;
+        if (this.recoveryLeavesWorkerToRoot(found))
+            return undefined;
+        if (rootFinishRequested(this.context.store, found.id))
+            return this.host.settleRequestedRootFinish(found.id);
+        // A usage-limit hold ran no process, so nothing was interrupted: its waits re-arm and resolve,
+        // and `reconcileAutoResumes` re-arms the resume that delivers them (hearsay-tools/cezarion#1236).
+        if (isUsageLimitHold(found)) {
+            this.host.waitEngine.rearm(found);
+            return undefined;
+        }
+        const run = this.reconcileRecoveredAsk(found);
+        if (this.parkRecoveredRun(run))
+            return undefined;
+        // A pending question or a queued message leaves the waits open: they re-arm, and a result
+        // still wakes the run.
+        this.host.waitEngine.rearm(run);
+        if (run.status === 'queued')
+            return this.host.reviveQueuedRun(run, 'cezar restarted');
+        this.host.deliverConversationInput(run.id);
+        if (run.status === 'waiting')
+            return this.recoverClosedWaitingRun(run);
+        this.recoverInterruptedRun(run);
+        return undefined;
+    }
+    /** True when a worker's root takes no more work from it: a settled root cancels the worker
+     *  (hearsay-tools/cezarion#2410), and a finishing root leaves it as it is. */
+    recoveryLeavesWorkerToRoot(run) {
+        if (run.delegation?.role !== 'worker')
+            return false;
+        const parent = this.context.store.getRun(run.delegation.parentRunId);
+        if (parent?.delegation?.role !== 'root')
+            return false;
+        if (['done', 'review', 'failed', 'cancelled'].includes(parent.status)) {
+            // The family pass skips a parent while recovery holds it: its workers' questions close here,
+            // before the cancel, an accepted reply still waiting included (hearsay-tools/cezarion#2410).
+            this.workerQuestions.closeRoutedQuestions(parent.id);
+            this.host.cancel(run.id);
+            return true;
+        }
+        return Boolean(parent.delegation.finishRequestedAt);
+    }
+    /** An unanswered `ask.requested` with no open human wait (a row written before every ask opened
+     *  one) gets an open agent wait shown as that ask. Answer delivery still reads the transcript.
+     *  Cezar's own wait not shown as that ask is replaced, as the live ask does: a crash between
+     *  saving the ask and replacing it leaves that wait open (review of #1437). */
+    adoptTranscriptAsk(runId) {
+        const askSeq = pendingHumanAskSeq(this.context.store, runId);
+        const human = WAIT_KINDS.human.select(openWaits(this.context.store.getRun(runId) ?? {}));
+        if (askSeq === undefined || !this.context.store.getRun(runId) || human.some(wait => !isCezarHumanWait(wait) || wait.askSeq === askSeq))
+            return false;
+        this.host.humanWaits.withdrawCezarHumanWaits(runId);
+        if (WAIT_KINDS.human.select(openWaits(this.context.store.getRun(runId) ?? {})).length)
+            return false;
+        return this.host.waitEngine.open(runId, undefined, WAIT_KINDS.human.recoveredEntry(askSeq), {
+            withdraw: false, onCommitFailure: { log: `${logPrefix()} human wait checkpoint failed` }, park: false,
+        }).status === 'opened';
+    }
+    /** The human wait upgraded from a stored `hasPendingHumanAsk` (`turnId: 'legacy'`, never shown)
+     *  is settled as answered when the transcript's facts are known and hold no unanswered ask: that
+     *  flag was read from the transcript, so its ask was answered after the row was last saved.
+     *  Unknown facts are no evidence, and the wait stays open. */
+    settleAnsweredLegacyAsk(runId) {
+        const legacy = WAIT_KINDS.human.selectOpen(this.context.store.getRun(runId)?.waits ?? []).filter(wait => wait.turnId === 'legacy' && wait.askSeq === undefined);
+        // Only facts read from a non-empty transcript are evidence of the answer (review of #1437).
+        const facts = this.context.store.knownTranscriptFacts(runId);
+        if (!legacy.length || !facts || facts.bytes === 0 || facts.pendingGateSeq !== undefined)
+            return false;
+        try {
+            return this.context.store.commitOutcome(runId, { kind: 'answered', waitIds: legacy.map(wait => wait.id) }).answered.length > 0;
+        }
+        catch (error) {
+            console.warn(`${logPrefix()} human wait checkpoint failed: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    /** The run as recovery reads it after it reconciles the run's question state. */
+    reconcileRecoveredAsk(found) {
+        let run = found;
+        // A worker no process survived for is a closed session: Cezar's fallback question goes as at an
+        // idle close, and the worker recovers as its plain park did (hearsay-tools/cezarion#1301).
+        if (run.delegation?.role === 'worker' && run.status === 'waiting' && this.workerQuestions.supersedeWorkerFallback(run.id))
+            run = this.context.store.getRun(run.id);
+        // Phase 4b (hearsay-tools/cezarion#1236): attention reads the human wait, so an unanswered ask
+        // an older cezar left without one gets one now, attached to that ask.
+        if (this.adoptTranscriptAsk(run.id))
+            run = this.context.store.getRun(run.id);
+        // A stored pending-question flag can be stale: the answer's receipt reached the transcript and
+        // the row's save did not. The wait read from it is answered (review of #1437).
+        if (this.settleAnsweredLegacyAsk(run.id))
+            run = this.context.store.getRun(run.id);
+        return run;
+    }
+    /** True when the recovered run stays parked: on a human wait, a pending question or its waits. */
+    parkRecoveredRun(run) {
+        // hearsay-tools/cezarion#1234: a crash after a human wait's registration and before its turn
+        // end shows the question now. The run waits on the user, its other waits re-armed.
+        if (this.host.humanWaits.unsurfacedHumanWait(run.id)) {
+            this.host.humanWaits.surfaceHumanWait(run.id, undefined);
+            this.parkOnOpenWaits(run);
+            return true;
+        }
+        if (run.delegation && run.delegation.role !== 'invalid' && hasPendingHumanAsk(run.id, id => pendingHumanAskSeq(this.context.store, id))) {
+            // A pending question leaves its waits open: they re-arm, and a result still wakes the run.
+            this.parkOnOpenWaits(run);
+            // Only the durable, explicitly human payload may resume an unanswered
+            // question. A refused recovery leaves attention, not terminal failure.
+            if (run.continuationMessage?.origin === 'human') {
+                const restarted = this.host.checkpointRestartContext(run);
+                this.host.continueRun(restarted.id, {}, true);
+            }
+            return true;
+        }
+        // No process survived. Open waits re-arm from their stored deadlines (an overdue timer
+        // resolves now); resolved ones wake through a scheduler-owned continuation after recovery.
+        // A human message no longer withdraws a wait, so an interrupted or queued run with queued
+        // messages still owes their delivery: it recovers as below, with its waits armed
+        // (hearsay-tools/cezarion#1233). A parked one stays parked; its wake folds them in.
+        if (run.waits?.length && !hasPendingHumanAsk(run.id, id => pendingHumanAskSeq(this.context.store, id)) && (run.status === 'waiting' || !run.queuedMessages?.length)) {
+            this.parkOnOpenWaits(run);
+            return true;
+        }
+        return false;
+    }
+    /** Parks a recovered run: `waiting`, with each of its open waits re-armed. */
+    parkOnOpenWaits(run) {
+        this.host.move(run.id, 'park');
+        this.host.waitEngine.rearm(run);
+    }
+    /**
+     * A `waiting` run that did not park. Returns the settlement the loop must await, else
+     * `undefined`.
+     */
+    recoverClosedWaitingRun(run) {
+        // Waiting is durable human attention for roots and ordinary top-level
+        // runs. A worker reaches here only when it has neither a recoverable ask
+        // nor a worker wait; preserving that record would strand both it and its
+        // parent because workers cannot accept an ordinary inactive Continue.
+        if (run.delegation?.role !== 'worker' ||
+            run.agentInputs?.some(input => !input.deliveredAt && hasLiveInboxClaim(input)))
+            return undefined;
+        if (run.invalidAsk) {
+            this.failRecoveredInvalidAsk(run);
+            return undefined;
+        }
+        if (ciWorkflowResumeStepIndex(run) >= 0) {
+            // CI ACK retires the wait, but not the failed workflow source. A closed
+            // worker at this boundary must resume before its remaining checks run.
+            const resumed = this.host.continueRun(run.id, { text: this.restartContinuationPrompt }, true);
+            this.context.store.appendEvent(run.id, { type: 'lifecycle', message: resumed.ok
+                    ? 'cezar restarted — resuming the worker CI recovery from its last session'
+                    : `cezar restarted — could not resume worker CI recovery (${resumed.error ?? 'unknown'})` });
+            return undefined;
+        }
+        const finishedAt = new Date().toISOString();
+        for (const step of run.steps) {
+            if (step.status === 'waiting' || step.status === 'running') {
+                this.context.store.updateStep(run.id, step.id, { status: 'done', finishedAt });
+            }
+        }
+        this.context.store.appendEvent(run.id, {
+            type: 'lifecycle',
+            message: 'cezar restarted — the open worker session was settled',
+        });
+        return this.host.settleSuccess(run.id);
+    }
+    /** A recovered run whose structured question cannot be answered fails with its open steps. */
+    failRecoveredInvalidAsk(run) {
+        this.host.move(run.id, 'fail', { error: 'invalid structured question' });
+    }
+    /** A `running` run whose process died mid-turn. */
+    recoverInterruptedRun(found) {
+        // `running`: the process died mid-turn. Mark it interrupted (the state
+        // continueRun expects), then pick the work back up from the last session.
+        const run = this.host.checkpointRestartContext(found);
+        const interruptedStepId = run.currentStepId;
+        // The exit fails its running steps with the interrupted error and keeps a waiting one (B11).
+        this.host.move(run.id, 'fail-interrupted');
+        if (this.host.requeueInterruptedRun(run, interruptedStepId))
+            return;
+        const resumed = this.host.continueRun(run.id, {
+            text: atContinue.prompt(run, this.restartContinuationPrompt),
+        }, true);
+        this.context.store.appendEvent(run.id, {
+            type: 'lifecycle',
+            message: resumed.ok
+                ? 'cezar restarted — resuming the interrupted task from its last session'
+                : `cezar restarted — could not resume the interrupted task (${resumed.error ?? 'unknown'})`,
+        });
+    }
+    /** Delivers the parent replies routed to each worker in scope. */
+    answerRecoveredRoutedQuestions(inScope) {
+        for (const run of this.context.store.listRuns().filter(inScope))
+            if (run.delegation?.role === 'worker')
+                this.host.answerRoutedQuestion(run.id);
+    }
+    /** Re-arms each live run's waits, or queues the wake it owes. */
+    rearmRecoveredWakes() {
+        for (const run of this.context.store.listRuns()) {
+            // A terminal row keeps its waits (and stays live) until something cancels them. A failed run
+            // that owes results keeps them for a human, and its open waits still resolve without a wake.
+            if (run.waits?.length && holdsOwedResults(run))
+                this.host.waitEngine.rearm(run);
+            else if (run.waits?.length && !['running', 'waiting', 'queued'].includes(run.status))
+                this.host.waitEngine.cancelAll(run.id);
+            else if (run.waits?.length)
+                this.host.queueWaitWake(run.id);
+            // A message the recovery window held back is a wake of its own (hearsay-tools/cezarion#1235).
+            else if (['running', 'waiting', 'queued'].includes(run.status) && this.host.owesWake(run))
+                this.host.queueWaitWake(run.id);
+        }
+    }
+}
+//# sourceMappingURL=run-recovery.js.map

package/dist/workflows/run/run-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-recovery.js","sourceRoot":"","sources":["../../../src/workflows/run/run-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM5E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAuBhE,MAAM,OAAO,WAAW;IASO,OAAO;IAAqC,gBAAgB;IACtE,eAAe;IAAoC,mBAAmB;IACtE,IAAI;IAAoC,yBAAyB;IAVpF;+FAC2F;IACnF,aAAa,CAAkC;IACvD,mEAAmE;IAC3D,gBAAgB,CAA4B;IACpD,6EAA6E;IACrE,YAAY,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAE3D,YAA6B,OAAyB,EAAmB,gBAAkC,EACxF,eAAgC,EAAmB,mBAAwC,EAC3F,IAAqB,EAAmB,yBAAiC;uBAF/D,OAAO;gCAAqC,gBAAgB;+BACtE,eAAe;mCAAoC,mBAAmB;oBACtE,IAAI;yCAAoC,yBAAyB;IAAW,CAAC;IAEhG,+FAA+F;IAC/F,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,GAAmC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC9E,OAAO,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,YAAqB;QACjC,8FAA8F;QAC9F,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW;YAAE,OAAO;QACzF,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACzF,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,CAAC,GAAc,EAAE,EAAE,CAAC,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,YAAY,CAAC;QACjG,IAAI,CAAC;YACL,IAAI,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAAE,OAAO;YACpC,qFAAqF;YACrF,wFAAwF;YACxF,mFAAmF;YACnF,0EAA0E;YAC1E,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,8BAA8B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAAE,OAAO;YACpC,IAAI,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACrD,2FAA2F;YAC3F,wFAAwF;YACxF,2BAA2B;YAC3B,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAClC,4FAA4F;YAC5F,iFAAiF;YACjF,4FAA4F;YAC5F,wFAAwF;YACxF,qDAAqD;YACrD,mDAAmD;YACnD,IAAI,CAAC,6BAA6B,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK;iBAC5B,QAAQ,EAAE;iBACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;iBAChF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAC1D,yFAAyF;YACzF,uFAAuF;YACvF,+EAA+E;YAC/E,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,qFAAqF;gBACrF,+CAA+C;gBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,QAAQ;oBAAE,MAAM,QAAQ,CAAC;YAC/B,CAAC;YACD,IAAI,YAAY,KAAK,SAAS;gBAAE,MAAM,IAAI,CAAC,gBAAgB,CAAC,+BAA+B,EAAE,CAAC;YAC9F,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAAE,OAAO;QACpC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,kFAAkF;QAClF,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC;QACrL,4FAA4F;QAC5F,yBAAyB;QACzB,IAAI,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC;QAC7C,6FAA6F;QAC7F,sFAAsF;QACtF,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,0FAA0F;QAC1F,6FAA6F;QAC7F,4FAA4F;QAC5F,oCAAoC;QACpC,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,CAAC;QAChD,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,KAAa,EAAE,IAAI,GAAuB,EAAE;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACjD,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,gBAAgB;gBAAE,MAAM,IAAI,CAAC,gBAAgB,CAAC;YAC7E,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAAE,OAAO,KAAK,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC3D,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACvC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;2FACuF;IAC/E,8BAA8B,CACpC,YAAgC,EAChC,OAAoC;QAEpC,MAAM,SAAS,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxJ,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBAAE,SAAS;YACtH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,GAAG,EAAE,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,SAAS;YAClE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;gBAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClH,CAAC;QACD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED,8FAA8F;IACtF,mBAAmB,CAAC,OAAoC;QAC9D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,0EAA0E;YAC1E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;gBAC5D,oEAAoE;gBACpE,wEAAwE;gBACxE,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;;oBAClK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClD,4EAA4E;YAC5E,0EAA0E;YAC1E,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACtE,IAAI,QAAQ,CAAC,MAAM;oBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,2CAA2C,EAAE,CAAC,CAAC;YAC7M,CAAC;QACH,CAAC;IACH,CAAC;IAED,mGAAmG;IAC3F,6BAA6B,CAAC,eAAyB,EAAE,OAAoC;QACnG,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC1G,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,+FAA+F;IACvF,oBAAoB,CAAC,YAAgC;QAC3D,IAAI,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,CAAC;;YACpE,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,YAAY,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5H,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,KAAgB;QACrC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QACnD,IAAI,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QACjE,IAAI,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC7D,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5G,+FAA+F;QAC/F,kGAAkG;QAClG,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACjD,0FAA0F;QAC1F,uBAAuB;QACvB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACvE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;kFAC8E;IACtE,0BAA0B,CAAC,GAAc;QAC/C,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACrE,IAAI,MAAM,EAAE,UAAU,EAAE,IAAI,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACtE,6FAA6F;YAC7F,6FAA6F;YAC7F,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACtD,CAAC;IAED;;;mFAG+E;IACvE,kBAAkB,CAAC,KAAa;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzF,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACrJ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QACpG,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE;YAC1F,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,+BAA+B,EAAE,EAAE,IAAI,EAAE,KAAK;SACtG,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;IACzB,CAAC;IAED;;;kEAG8D;IACtD,uBAAuB,CAAC,KAAa;QAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAChK,4FAA4F;QAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtG,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACjI,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvH,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,iFAAiF;IACzE,qBAAqB,CAAC,KAAgB;QAC5C,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,gGAAgG;QAChG,2FAA2F;QAC3F,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QACpK,+FAA+F;QAC/F,sEAAsE;QACtE,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QAC9E,+FAA+F;QAC/F,+EAA+E;QAC/E,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QACnF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kGAAkG;IAC1F,gBAAgB,CAAC,GAAc;QACrC,6FAA6F;QAC7F,mFAAmF;QACnF,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;YACzD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;YACxI,2FAA2F;YAC3F,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAC1B,sEAAsE;YACtE,uEAAuE;YACvE,IAAI,GAAG,CAAC,mBAAmB,EAAE,MAAM,KAAK,OAAO,EAAE,CAAC;gBAChD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;gBAC1D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,uFAAuF;QACvF,2FAA2F;QAC3F,0FAA0F;QAC1F,iFAAiF;QACjF,oFAAoF;QACpF,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;YACpK,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IACtE,eAAe,CAAC,GAAc;QACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACK,uBAAuB,CAAC,GAAc;QAC5C,sEAAsE;QACtE,yEAAyE;QACzE,yEAAyE;QACzE,sEAAsE;QACtE,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,QAAQ;YACnC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACnG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,wEAAwE;YACxE,uEAAuE;YACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,EAAE,IAAI,CAAC,CAAC;YAC9F,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;oBAC7E,CAAC,CAAC,yEAAyE;oBAC3E,CAAC,CAAC,0DAA0D,OAAO,CAAC,KAAK,IAAI,SAAS,GAAG,EAAE,CAAC,CAAC;YAC/F,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE;YACrC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,uDAAuD;SACjE,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,8FAA8F;IACtF,uBAAuB,CAAC,GAAc;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,mDAAmD;IAC3C,qBAAqB,CAAC,KAAgB;QAC5C,uEAAuE;QACvE,0EAA0E;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,iBAAiB,GAAG,GAAG,CAAC,aAAa,CAAC;QAC5C,6FAA6F;QAC7F,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,CAAC;YAAE,OAAO;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CACnC,GAAG,CAAC,EAAE,EACN;YACE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,yBAAyB,CAAC;SAC7D,EACD,IAAI,CACL,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE;YACrC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,OAAO,CAAC,EAAE;gBACjB,CAAC,CAAC,uEAAuE;gBACzE,CAAC,CAAC,4DAA4D,OAAO,CAAC,KAAK,IAAI,SAAS,GAAG;SAC9F,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAC1D,8BAA8B,CAAC,OAAoC;QACzE,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;YAAE,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjJ,CAAC;IAED,iEAAiE;IACzD,mBAAmB;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YAChD,6FAA6F;YAC7F,6FAA6F;YAC7F,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;iBAC3E,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;iBACxH,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,8FAA8F;iBACzF,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7H,CAAC;IACH,CAAC;CACF"}

package/dist/workflows/run/run-settlement.d.ts

@@ -0,0 +1,177 @@
+import type { PreviewHostLike } from '../../preview/registration.ts';
+import type { WorkerScratchCleanup } from '../../delegation/scratch-cleanup.ts';
+import type { RunRecord, RunStore, StepState } from '../../runs/store.ts';
+import type { UiEventSink } from '../../runs/ui-event-sink.ts';
+import type { ActiveRun } from '../active-run.ts';
+import type { WorkflowDef, WorkflowStepDef } from '../types.ts';
+import type { ContinuationClose, SessionTurn, StepLoop, RunModuleContext } from './types.ts';
+import type { RunExitId } from '../../runs/run-exits.ts';
+import { type AutosaveReason } from '../../git-worktree.ts';
+import * as completionGateReads from './completion-gate.ts';
+import type { HumanWaits } from './human-waits.ts';
+import type { WorkerQuestions } from './worker-questions.ts';
+import type { WorktreeAutosave } from './worktree-autosave.ts';
+import type { RunLine } from './run-line.ts';
+import type { TurnBookkeeper } from './turn-bookkeeping.ts';
+import type { AutoResumeScheduler } from './auto-resume.ts';
+import type { WorkerExecutions } from './worker-executions.ts';
+interface RunSettlementHost {
+    active: Map<string, ActiveRun>;
+    isSyntheticContinuation(run: RunRecord, step: StepState): boolean;
+    generation(id: string): symbol | undefined;
+    isActive(id: string): boolean;
+    move(id: string, exit: RunExitId, patch?: Omit<Parameters<RunStore['updateRun']>[1], 'status'>): RunRecord | undefined;
+    dropActive(id: string): void;
+    saveWorktree(id: string, state: ActiveRun, reason: AutosaveReason): Promise<void>;
+    settleSuccess(id: string, durableRootFinish?: boolean, keepStepId?: string): Promise<void>;
+    deferParentCompletion(id: string): boolean;
+    closingWakeDecision(id: string, holds: boolean, cancelled: boolean, error: string | undefined): 'park' | 'settle' | 'capped';
+    owesDelivery(id: string): boolean;
+    preserveRunAfterDisposal(id: string, state: ActiveRun): boolean;
+    isDisposedDelegatedRun(id: string): boolean;
+    queueWaitWake(id: string): void;
+    reconcileWorkerWaits(id?: string): void;
+    releaseSlot(): void;
+    workerScratchCleanup: WorkerScratchCleanup;
+    hasClaim(id: string): boolean;
+    autosaveCleanupBlocker(id: string): string | undefined;
+    claimWorktreeReclaim(id: string): (() => void) | null;
+    preview: PreviewHostLike | undefined;
+    forgetMemoryPause(id: string): void;
+}
+export declare class RunSettlement {
+    private readonly context;
+    private readonly humanWaits;
+    private readonly workerQuestions;
+    private readonly worktreeAutosave;
+    private readonly turnBookkeeper;
+    private readonly line;
+    private readonly autoResumeScheduler;
+    private readonly workerExecutions;
+    private readonly completionGateHost;
+    private readonly host;
+    private readonly wakeSessionClosedError;
+    private readonly wakeDeliveryCapNote;
+    constructor(context: RunModuleContext, humanWaits: HumanWaits, workerQuestions: WorkerQuestions, worktreeAutosave: WorktreeAutosave, turnBookkeeper: TurnBookkeeper, line: RunLine, autoResumeScheduler: AutoResumeScheduler, workerExecutions: WorkerExecutions, completionGateHost: completionGateReads.CompletionGateHost, host: RunSettlementHost, wakeSessionClosedError: string, wakeDeliveryCapNote: string);
+    /** Scratch belongs to the task, not its current agent process (#515).
+     * Terminal status alone is not process-exit proof: an active session or an
+     * unfinished private worker generation must retain its files until exit. */
+    reapTerminalScratch(runId: string): void;
+    /** Reclaim finished worktrees beyond the keep-limit (#483) — directory only,
+     *  `cez/<id8>` branch kept — then sweep the branches whose work landed
+     *  (hearsay-tools/cezarion#2268). Best-effort; a failure never affects run
+     *  lifecycle. `review`/live runs are excluded by the selector. */
+    enforceRetention(): Promise<void>;
+    private enforceRetentionWork;
+    private waitingWorkflowStepIndex;
+    /** A detail's finish verdict reads the live registries, and a session leaves them after its
+     *  last write (the final autosave), so the cockpit's refetch on that write still saw "no open
+     *  session" and hid Accept. Publish a resting run again once it is out of them
+     *  (hearsay-tools/cezarion#1301). */
+    republishFinishVerdict(runId: string): void;
+    /** A clean process exit cannot complete a workflow still blocked on a question.
+     * Keep its existing durable waiting step so Continue can resume the tail. Cezar's fallback
+     * question on a worker is not one: the clean exit supersedes it, so the workflow goes on as the
+     * plain park it replaced did (hearsay-tools/cezarion#1301). */
+    supersedeFallbackThenWorkflowAsk(runId: string, state: ActiveRun): boolean;
+    /**
+     * Whether a step session closed without its done while a later step waits (hearsay-tools/cezarion#1620).
+     * It reads the done `closeAsDone` recorded; callers clear the consumed mark. Finish is an explicit stop, settled as before.
+     */
+    stepLeftOpen(state: ActiveRun, stepId: string, next: WorkflowStepDef | undefined): boolean;
+    /** Consume the completion mark only when Continue reaches its completion check. */
+    private continuationLeftOpen;
+    /** A resumed earlier step that closed without a done stays open: its workflow step, not the Continue's own. */
+    settleIncompleteContinuation(runId: string, stepId: string): Promise<void>;
+    /** Settle a Continue whose session closed without a fault: undelivered wakes, a Stop, a step left
+     *  open, a done, or an idle close. Returns the settlement to wait for, or undefined when it
+     *  completed without yielding. */
+    settleClosedContinuation(runId: string, state: ActiveRun, stepId: string, sink: UiEventSink, resumedNext: WorkflowStepDef | undefined, close: ContinuationClose): Promise<void> | undefined;
+    /** The session closed with wakes it still holds: park the run, or fail it when their delivery
+     *  failed. */
+    settleClosingWakes(runId: string, state: ActiveRun, stepId: string, sink: UiEventSink): void;
+    /** A Stop ended the Continue's session: cancel its step and the run. */
+    settleCancelledContinuation(runId: string, stepId: string): void;
+    /** The Continue's step is done: settle the run, or the workflow step it resumed. Returns the
+     *  settlement to wait for, or undefined when it queued the workflow remainder. */
+    settleDoneContinuation(runId: string, state: ActiveRun, stepId: string, close: ContinuationClose): Promise<void> | undefined;
+    /** The Continue finished the workflow step it resumed: queue the workflow remainder, or settle
+     *  the run when none is left or Finish was requested. */
+    settleResumedWorkflowStep(runId: string, state: ActiveRun, stepId: string, completed: RunRecord, workflow: WorkflowDef, waitingIndex: number, close: ContinuationClose): Promise<void> | undefined;
+    /** Settle the run after a successful Continue. */
+    succeedContinuation(runId: string): Promise<void>;
+    /** The Continue's session failed, or its settlement threw: fail its step, then park the run
+     *  when it still holds wakes, else fail it. */
+    settleFailedContinuation(runId: string, state: ActiveRun, stepId: string, sink: UiEventSink, turn: SessionTurn, err: unknown): void;
+    /**
+     * Settles the run once the step loop of `execute` ended: the final autosave, then the
+     * cancelled, failed, incomplete-step, idle-closed or success settlement.
+     */
+    settleExecution(runId: string, state: ActiveRun, loop: StepLoop): Promise<void>;
+    /** The cancelled settlement: the run and its running and waiting steps become cancelled. */
+    settleCancelledRun(runId: string): void;
+    /** The failed settlement. A capped wake delivery adds the cap's note. */
+    settleFailedRun(runId: string, runError: string, deliveryCapped: boolean): void;
+    /**
+     * Diff-first review gate (spec 009), shared by `execute` and
+     * `runContinuation`: a *successful* run whose worktree holds changes rests
+     * at `review` instead of `done` — the user inspects the diff first, then
+     * sends feedback back, opens a draft PR, or just finishes. Failed/cancelled
+     * runs never enter review; no worktree or an empty diff means plain `done`.
+     *
+     * The gate is opt-in (open-mercato/cezar#489): the review park happens only when it is enabled
+     * (`reviewGateEnabled` — config toggle over the `CEZ_REVIEW_GATE` env, default
+     * OFF) AND the run is not autonomous. Autonomous runs — and runs with the gate
+     * off — settle straight to `done`, leaving the diff in the worktree untouched.
+     */
+    settleSuccess(runId: string, durableRootFinish?: boolean, keepStepId?: string): Promise<void>;
+    private settleSuccessWork;
+    /**
+     * Whether a successful run rests at `review`: its worktree holds a diff, the review gate is
+     * on, and the run is not autonomous. A root finish cannot settle without a diff, so a failed
+     * diff throws for it.
+     */
+    successNeedsReview(run: RunRecord, worktreePath: string, durableRootFinish: boolean): Promise<boolean>;
+    /** True when the success settlement must not write: the run is no longer live, a newer
+     *  continuation started, or another execution replaced the one that began settling. */
+    successSuperseded(runId: string, status: RunRecord['status'], state: ActiveRun | undefined, continuationGeneration: symbol | undefined): boolean;
+    /** A Stop accepted while the success settlement read the diff: the run and its running and
+     *  waiting steps become cancelled, and a step keeps a finish time it already has. */
+    settleCancelledSuccess(runId: string): void;
+    /** The ordinary success path (not a root finish): the run as `review` or `done`. The exit
+     *  settles an idle-closed Continue's intermediate steps with it (B5); a worker's incomplete
+     *  earlier step stays `waiting`, since a parent resume re-enters it (hearsay-tools/cezarion#1620). */
+    commitOrdinarySuccess(runId: string, review: boolean, keepStepId: string | undefined): void;
+    /** Called only after session/process settlement. A refused nudge retained its
+     * slot and running status until idle close; ordinary roots must now become
+     * resumable. Previously parked roots and delegated lifecycle policy stay intact. */
+    settleIdleClosedRun(runId: string, state: ActiveRun): Promise<void>;
+    /** An ordinary owned worker cannot accept an inactive Continue. Once its
+     * idle-closed process has ended, publish the same terminal outcome recovery
+     * would produce so its parent can collect it. Explicit asks and worker waits
+     * remain durable attention states. */
+    settleIdleClosedWorker(runId: string, keepStepId?: string): Promise<boolean>;
+    /**
+     * An earlier workflow step whose session closed without a done: a clean exit, an idle close, or
+     * a Continue that resumed it and closed the same way (hearsay-tools/cezarion#1620). The step stays
+     * `waiting` and the tail never starts. A root waits for Continue, which resumes the step. An owned
+     * worker settles as a single-step task's close does, so its parent can collect it; the step stays
+     * `waiting`, and a parent resume re-enters it. A question still pending keeps either one waiting.
+     */
+    settleIncompleteStep(runId: string, stepId: string): Promise<void>;
+    afterDropActive(runId: string): void;
+}
+export declare function sessionCloseKeepsWaiting(input: {
+    readonly cancelled: boolean;
+    readonly incomplete: boolean;
+    readonly idleClosed: boolean | undefined;
+}, workflowAsk: () => boolean): boolean;
+export declare function terminalScratchDisposition(runId: string, run: RunRecord | undefined, reads: {
+    active(): boolean;
+    starting(): boolean;
+    queued(): boolean;
+    claimed(): boolean;
+    autosaveBlocker(): string | undefined;
+    privateWorkers(): string[] | undefined;
+}): 'keep' | 'schedule' | 'remove';
+export {};