@telora/daemon 0.24.42 → 0.24.55

package/dist/focus/stranded-review-reroute.d.ts

@@ -1,70 +0,0 @@
-import type { createEscalation } from '../supervision/escalation-filing.js';
-import type { CommitVerdict } from '../verify/gate-verdicts/commit-verdict-record.js';
-import { type FailedVerdictReworkDeps } from '../verify/outcome-routing/verification-rework-issue.js';
-/** Re-fires of one unchanged (window, HEAD, verdict) before the reroute. */
-export declare const STRANDED_REVIEW_REFIRE_BOUND = 3;
-/** escalation_kind of the observation a non-failed reroute files. */
-export declare const STRANDED_REVIEW_REROUTED_KIND = "stranded_review_rerouted";
-/** The focus slice the bound reads. */
-export interface StrandedReviewFocus {
-    focus_id: string;
-    focus_name: string;
-    review_requested_at: string | null;
-}
-/** The bound's own reads and writes (with the rework filing, the root's `strandedReviewReroute` binding). */
-export interface StrandedReviewRerouteOwnDeps {
-    resolveJudgedCommit: (focusId: string) => string | null;
-    readCommitVerdict: (productId: string, focusId: string, sha: string) => CommitVerdict | null;
-    clearPendingSpawnDirective: (focusId: string) => void;
-    clearReviewRequestedAt: (focusId: string) => Promise<void>;
-    createEscalation: typeof createEscalation;
-    hasOpenFocusEscalation: (focusId: string, escalationKind: string) => Promise<boolean>;
-}
-/** Everything the bound acts through: its own collaborators plus the rework filing. */
-export interface StrandedReviewRerouteDeps extends Omit<FailedVerdictReworkDeps, 'getFocusDeliveries'>, StrandedReviewRerouteOwnDeps {
-    /** The focus's deliveries with their gate_state: the rework filing's read, and the gate-verdict hold read. */
-    getFocusDeliveries: (focusId: string) => Promise<ReadonlyArray<{
-        id: string;
-        executionStatus?: string | null;
-        gateState?: unknown;
-    }>>;
-}
-/** Test seam: forget every count. */
-export declare function __resetStrandedReviewRefiresForTests(): void;
-/**
- * The gate-verdict hold read, tri-state: 'held' when some verify delivery carries
- * the commit-verdict hold marker the review exit wrote (delivery/commit-verdict-hold.ts,
- * the same read the review park uses), 'clear' when the deliveries read and none
- * does, 'unreadable' when the read failed.
- */
-export declare function readStrandedReviewGateHold(focus: StrandedReviewFocus, deps: Pick<StrandedReviewRerouteDeps, 'getFocusDeliveries'>): Promise<'held' | 'clear' | 'unreadable'>;
-/**
- * Whether the stranded-review re-fire must leave this window alone because it may
- * be held open for a gate verdict. Such a window is the release pass's to route,
- * not a strand to re-fire (directive/phase-sync.ts shouldRefireStrandedReview).
- * FAIL-CLOSED: an unreadable hold answers true -- re-firing on a guess queued the
- * review that re-judged the held commit -- so the re-fire waits a poll and re-reads;
- * a readable window with no hold is a genuine strand and answers false.
- */
-export declare function strandedReviewAwaitsGateVerdict(focus: StrandedReviewFocus, deps: Pick<StrandedReviewRerouteDeps, 'getFocusDeliveries'>): Promise<boolean>;
-/**
- * The stranded-review re-fire decision checkDirectives (focus/directive-executor.ts)
- * takes for a focus whose current stage was already processed: the pure
- * shouldRefireStrandedReview over the live team / operator-stop facts and the
- * fail-closed gate-verdict hold read above. True = re-fire the review directive.
- */
-export declare function strandedReviewMayRefire(focus: StrandedReviewFocus & {
-    operator_stopped_at?: string | null;
-}, stageName: string | undefined, hasActiveTeam: boolean, deps: Pick<StrandedReviewRerouteDeps, 'getFocusDeliveries'>): Promise<boolean>;
-/** What the bound decided for one re-fire. */
-export type StrandedReviewRefireDecision = 'refire' | 'rerouted';
-/**
- * Count a stranded-review re-fire the caller is about to make, or -- once the
- * same key has been re-fired STRANDED_REVIEW_REFIRE_BOUND times -- reroute instead
- * (module header). Never throws.
- */
-export declare function boundStrandedReviewRefire(focus: StrandedReviewFocus, ctx: {
-    productId: string;
-    organizationId: string;
-}, deps: StrandedReviewRerouteDeps): Promise<StrandedReviewRefireDecision>;
-//# sourceMappingURL=stranded-review-reroute.d.ts.map

package/dist/focus/stranded-review-reroute.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stranded-review-reroute.d.ts","sourceRoot":"","sources":["../../src/focus/stranded-review-reroute.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kDAAkD,CAAC;AACtF,OAAO,EAA2D,KAAK,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AAO/J,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,6BAA6B,CAAC;AAExE,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,6GAA6G;AAC7G,MAAM,WAAW,4BAA4B;IAC3C,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACxD,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;IAC7F,0BAA0B,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvF;AAED,uFAAuF;AACvF,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,uBAAuB,EAAE,oBAAoB,CAAC,EAAE,4BAA4B;IAClI,8GAA8G;IAC9G,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;CACvI;AAKD,qCAAqC;AACrC,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAgBD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,oBAAoB,CAAC,GAC1D,OAAO,CAAC,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC,CAO1C;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,mBAAmB,EAC1B,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,oBAAoB,CAAC,GAC1D,OAAO,CAAC,OAAO,CAAC,CAElB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,mBAAmB,GAAG;IAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACpE,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,oBAAoB,CAAC,GAC1D,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,8CAA8C;AAC9C,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjE;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAClD,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CAgBvC"}

package/dist/focus/stranded-review-reroute.js

@@ -1,193 +0,0 @@
-// PINNED-BY-BEGIN (generated by gen:pinned-by -- do not hand-edit; checked by lint:pinned-by)
-// Pinned by: packages/daemon/src/focus/held-review-window-not-stranded.test.ts,
-//   packages/daemon/src/focus/stranded-review-refire-bound.test.ts,
-//   packages/daemon/src/focus/stranded-review-reroute.test.ts,
-//   packages/daemon/src/integration/failed-verdict-review-exit-respawn-regression.test.ts,
-//   packages/daemon/src/integration/failed-verdict-review-loop-regression.test.ts
-// PINNED-BY-END
-/**
- * The stranded-review re-fire is bounded per unchanged (focus, review window, HEAD,
- * gate verdict), and at the bound it takes a different route instead of queuing
- * the same review again.
- *
- * shouldRefireStrandedReview (directive/phase-sync.ts) re-queues the review
- * directive for a focus stuck in review with a pending request and no team. That
- * recovers a review a crash or teardown dropped. It does not recover a review that
- * RAN and could route nothing -- an exit held on a failed gate verdict leaves the
- * window set on purpose, and every re-fire would spawn another review of the same
- * range that stamps the same result and exits held again.
- * The review spawn gate declines such a range when it can read it
- * (focus/unchanged-reviewed-head.ts); this bound is the backstop for when it
- * cannot (no census, no recorded verdict, an unreadable read that failed open).
- *
- * Counting: each re-fire of a focus is counted under the key of what a review
- * would see -- the review window (review_requested_at), the judged commit (focus
- * worktree HEAD) and that commit's recorded gate verdict. A new window, a new
- * commit or a new verdict is a new key and starts over, so a review that has
- * something new to judge is never held back. In memory: a restart re-arms the
- * bound, which costs at most STRANDED_REVIEW_REFIRE_BOUND more re-fires.
- *
- * At the bound (reroute): logged with the focus, HEAD, verdict and bound, then
- *   - a FAILED verdict: every verify delivery gets the rework Bug naming the
- *     failure (verify/outcome-routing/verification-rework-issue.ts; deduped per commit, skipped
- *     beside open work), so the live open-work pass routes it verify ->
- *     verify_failed and a coding pass fixes it;
- *   - otherwise (passed, or no verdict): one agent_resolvable observation
- *     (stranded_review_rerouted) names the stuck window for a routing decider --
- *     re-reviewing an unchanged range cannot answer it;
- *   - either way the queued directive is dropped and the review window closed, so
- *     the re-fire has nothing left to re-fire.
- * Best-effort throughout: a failed step is logged; the window stays set only when
- * its clear fails, and the next poll re-reaches the bound and retries.
- *
- * Not a strand at all: a window the review exit HELD for a gate verdict
- * (strandedReviewAwaitsGateVerdict -- an unreadable hold counts as held). The
- * release pass routes it when the verdict lands, so the re-fire
- * (strandedReviewMayRefire) leaves it alone and nothing is counted.
- *
- * Every read and write is a REQUIRED collaborator (StrandedReviewRerouteDeps),
- * handed in by the directive executor from the composition root's
- * `strandedReviewReroute` context (composition/runtime-contexts.ts): the
- * failed-verdict rework filing and this bound's own reads and writes.
- *
- * History: docs/daemon/history-platform.md (focus/stranded-review-reroute.ts).
- *
- * @module focus/stranded-review-reroute
- */
-import { ESCALATION_REASONS } from '@telora/daemon-core';
-import { DISPOSITION_AGENT_RESOLVABLE } from '../queries/escalations/escalation-dispositions.js';
-import { describeFailedVerdictRework, fileReworkForFailedVerdict } from '../verify/outcome-routing/verification-rework-issue.js';
-import { commitVerdictHeldDeliveryIds } from '../delivery/commit-verdict-hold.js';
-import { shouldRefireStrandedReview } from '../directive/phase-sync.js';
-import { createLogger } from '../log/daemon-log.js';
-const log = createLogger({ module: 'directive-executor' });
-/** Re-fires of one unchanged (window, HEAD, verdict) before the reroute. */
-export const STRANDED_REVIEW_REFIRE_BOUND = 3;
-/** escalation_kind of the observation a non-failed reroute files. */
-export const STRANDED_REVIEW_REROUTED_KIND = 'stranded_review_rerouted';
-/** focusId -> the key re-fires are being counted under, and how many. */
-const refires = new Map();
-/** Test seam: forget every count. */
-export function __resetStrandedReviewRefiresForTests() {
-    refires.clear();
-}
-function subjectOf(focus, productId, deps) {
-    const head = deps.resolveJudgedCommit(focus.focus_id);
-    const verdict = head && productId ? deps.readCommitVerdict(productId, focus.focus_id, head) : null;
-    const verdictKey = verdict ? `${verdict.outcome}@${verdict.recordedAt}` : 'none';
-    return { key: `${focus.review_requested_at ?? ''}|${head ?? '?'}|${verdictKey}`, head, verdict };
-}
-/**
- * The gate-verdict hold read, tri-state: 'held' when some verify delivery carries
- * the commit-verdict hold marker the review exit wrote (delivery/commit-verdict-hold.ts,
- * the same read the review park uses), 'clear' when the deliveries read and none
- * does, 'unreadable' when the read failed.
- */
-export async function readStrandedReviewGateHold(focus, deps) {
-    try {
-        return commitVerdictHeldDeliveryIds(await deps.getFocusDeliveries(focus.focus_id)).size > 0 ? 'held' : 'clear';
-    }
-    catch (err) {
-        log.debug(`[directive-executor] gate-verdict hold unreadable for "${focus.focus_name}": ${err.message}`);
-        return 'unreadable';
-    }
-}
-/**
- * Whether the stranded-review re-fire must leave this window alone because it may
- * be held open for a gate verdict. Such a window is the release pass's to route,
- * not a strand to re-fire (directive/phase-sync.ts shouldRefireStrandedReview).
- * FAIL-CLOSED: an unreadable hold answers true -- re-firing on a guess queued the
- * review that re-judged the held commit -- so the re-fire waits a poll and re-reads;
- * a readable window with no hold is a genuine strand and answers false.
- */
-export async function strandedReviewAwaitsGateVerdict(focus, deps) {
-    return (await readStrandedReviewGateHold(focus, deps)) !== 'clear';
-}
-/**
- * The stranded-review re-fire decision checkDirectives (focus/directive-executor.ts)
- * takes for a focus whose current stage was already processed: the pure
- * shouldRefireStrandedReview over the live team / operator-stop facts and the
- * fail-closed gate-verdict hold read above. True = re-fire the review directive.
- */
-export async function strandedReviewMayRefire(focus, stageName, hasActiveTeam, deps) {
-    return shouldRefireStrandedReview({
-        stageName,
-        reviewRequestedAt: focus.review_requested_at,
-        hasActiveTeam,
-        operatorStopped: !!focus.operator_stopped_at,
-        awaitingGateVerdict: await strandedReviewAwaitsGateVerdict(focus, deps),
-    });
-}
-/**
- * Count a stranded-review re-fire the caller is about to make, or -- once the
- * same key has been re-fired STRANDED_REVIEW_REFIRE_BOUND times -- reroute instead
- * (module header). Never throws.
- */
-export async function boundStrandedReviewRefire(focus, ctx, deps) {
-    let subject;
-    try {
-        subject = subjectOf(focus, ctx.productId, deps);
-    }
-    catch (err) {
-        log.warn(`[directive-executor] stranded-review bound unreadable for "${focus.focus_name}" -- re-firing: ${err.message}`);
-        return 'refire';
-    }
-    const prior = refires.get(focus.focus_id);
-    const count = prior?.key === subject.key ? prior.count : 0;
-    if (count < STRANDED_REVIEW_REFIRE_BOUND) {
-        refires.set(focus.focus_id, { key: subject.key, count: count + 1 });
-        return 'refire';
-    }
-    await reroute(focus, ctx, subject, deps);
-    return 'rerouted';
-}
-async function reroute(focus, ctx, { head, verdict }, deps) {
-    const at = head ? head.slice(0, 12) : '<unreadable HEAD>';
-    const failed = verdict?.outcome === 'failed' && head !== null;
-    log.warn(`[directive-executor] Stranded-review re-fire bound (${STRANDED_REVIEW_REFIRE_BOUND}) reached for "${focus.focus_name}" ` +
-        `at HEAD ${at} (gate verdict: ${verdict?.outcome ?? 'none recorded'}): the same review was re-fired ` +
-        `${STRANDED_REVIEW_REFIRE_BOUND} times with nothing changed -- not queuing another identical review; ` +
-        (failed
-            ? 'routing the failed verdict to rework (a Bug naming the failure on the verify delivery whose commits caused it) and closing the review window'
-            : `closing the review window and filing a ${STRANDED_REVIEW_REROUTED_KIND} observation`));
-    if (failed) {
-        const result = await fileReworkForFailedVerdict(focus.focus_id, verdict, deps);
-        log.info(`[directive-executor] "${focus.focus_name}": failed verdict at ${at} -- ${describeFailedVerdictRework(result)}`);
-    }
-    else
-        await reportStuckWindow(focus, ctx, head, verdict, deps);
-    deps.clearPendingSpawnDirective(focus.focus_id);
-    try {
-        await deps.clearReviewRequestedAt(focus.focus_id);
-        refires.delete(focus.focus_id);
-    }
-    catch (err) {
-        log.warn(`[directive-executor] "${focus.focus_name}": could not close the stranded review window (retried next poll): ${err.message}`);
-    }
-}
-async function reportStuckWindow(focus, ctx, head, verdict, deps) {
-    try {
-        if (await deps.hasOpenFocusEscalation(focus.focus_id, STRANDED_REVIEW_REROUTED_KIND))
-            return;
-        await deps.createEscalation({
-            organizationId: ctx.organizationId,
-            issueId: null,
-            reasonType: ESCALATION_REASONS.ERROR_ENCOUNTERED,
-            disposition: DISPOSITION_AGENT_RESOLVABLE,
-            escalationKind: STRANDED_REVIEW_REROUTED_KIND,
-            anchor: { focusId: focus.focus_id },
-            description: `Focus "${focus.focus_name}" re-fired the same stranded review ${STRANDED_REVIEW_REFIRE_BOUND} times at HEAD ` +
-                `${head ?? '<unreadable>'} (gate verdict: ${verdict?.outcome ?? 'none recorded'}) with no active team and nothing ` +
-                'changed, so its review window was closed instead of queuing the review again.',
-            whatWasTried: 'Each re-fire queued the review directive because review_requested_at stayed set; no review exit routed the ' +
-                'focus\'s verify deliveries at this commit.',
-            helpNeeded: 'Find why the review of this commit cannot route its verify deliveries (daemon log: [focus-executor] review exit ' +
-                'lines, [commit-verdict-release], gate_state on the verify deliveries) and fix that; a new commit re-arms review.',
-            metadata: { head, verdict: verdict?.outcome ?? null, bound: STRANDED_REVIEW_REFIRE_BOUND },
-        });
-    }
-    catch (err) {
-        log.warn(`[directive-executor] "${focus.focus_name}": failed to file the ${STRANDED_REVIEW_REROUTED_KIND} observation: ${err.message}`);
-    }
-}
-//# sourceMappingURL=stranded-review-reroute.js.map

package/dist/focus/stranded-review-reroute.js.map

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

package/dist/focus/uncommitted-work-backstop.d.ts

@@ -1,115 +0,0 @@
-import type { PipelineConfig } from '../types/index.js';
-import type { CreateEscalationParams } from '../supervision/escalation-filing.js';
-import type { DeliveryGateRowIo } from '../queries/deliveries/deliveries.js';
-/** How long the state must stand, teamless, before the pass acts (and again before it records). */
-export declare const UNCOMMITTED_WORK_GRACE_MS: number;
-/** How long a queued respawn may wait to spawn (cooldown, a parked guard) before the record is filed anyway. */
-export declare const UNCOMMITTED_WORK_RESPAWN_WAIT_MS: number;
-/** At most this many paths are named in the respawn prompt and the record; the count carries the rest. */
-export declare const UNCOMMITTED_WORK_PATH_CAP = 20;
-/** The focus slice the pass reads (queries/focuses/focus-discovery.ts ActiveFocusRow). */
-export interface UncommittedWorkFocusRow {
-    focus_id: string;
-    focus_name: string;
-    assigned_agent_role_id: string | null;
-    operator_stopped_at?: string | null;
-    read_only?: boolean | null;
-    pipeline_config?: PipelineConfig | null;
-}
-/** The coding respawn the pass queues (directive/directive-queue.ts queueDaemonCodingRespawn). */
-export interface CodingRespawnRequest {
-    focusId: string;
-    message: string;
-    contentHash: string;
-    focusOverrideModel: string | null;
-}
-/** What the record names. */
-export interface UncommittedWorkRecord {
-    organizationId: string;
-    focusId: string;
-    focusName: string;
-    worktreePath: string;
-    paths: readonly string[];
-}
-/** The pass's collaborators, every one REQUIRED (composition/runtime-poll-context.ts binds them). */
-export interface UncommittedWorkBackstopDeps {
-    getActiveFocuses: (organizationId: string, productId: string) => Promise<readonly UncommittedWorkFocusRow[]>;
-    /** Whether a team process is live for the focus on this host. */
-    hasLiveTeam: (focusId: string) => boolean;
-    /** The focus worktree, or null when the daemon holds none. */
-    resolveWorktreePath: (focusId: string) => string | null;
-    listUncommittedPaths: (worktreePath: string) => readonly string[];
-    /** Queue the respawn unless a spawn directive is already queued; true when this call queued it. */
-    queueCodingRespawn: (request: CodingRespawnRequest) => boolean;
-    /** Whether a spawn directive is still queued for the focus (the respawn has not spawned yet). */
-    hasQueuedSpawn: (focusId: string) => boolean;
-    /** Withdraw this pass's own queued respawn (and nothing else); true when one was withdrawn. */
-    withdrawCodingRespawn: (focusId: string) => boolean;
-    /** File the record (deduped per focus by the caller's binding); never throws past its own logging. */
-    recordUncommittedWork: (record: UncommittedWorkRecord) => Promise<void>;
-    /** Close the record once the worktree is clean; the count closed. */
-    resolveRecord: (focusId: string) => Promise<number>;
-    now: () => number;
-}
-/** Test seam: forget every episode. */
-export declare function __resetUncommittedWorkBackstopForTests(): void;
-/** What the pass did for one focus. */
-export type UncommittedWorkAction = {
-    kind: 'respawned';
-    paths: readonly string[];
-    queued: boolean;
-} | {
-    kind: 'recorded';
-    paths: readonly string[];
-} | {
-    kind: 'cleared';
-    resolved: number;
-};
-/** The respawned team's directive: what is uncommitted and what finishes it. Pure. */
-export declare function buildUncommittedWorkRespawnMessage(focusName: string, paths: readonly string[]): string;
-/** The pass for one focus (module header). Never throws. */
-export declare function checkUncommittedWork(focus: UncommittedWorkFocusRow, organizationId: string, deps: UncommittedWorkBackstopDeps): Promise<UncommittedWorkAction | null>;
-/** The seams the operator-visible record goes through. */
-export interface StrandedWorkRecordDeps {
-    getFocusDeliveries: (focusId: string) => Promise<ReadonlyArray<{
-        id: string;
-        executionStatus?: string | null;
-    }>>;
-    gateRowIo: DeliveryGateRowIo;
-    now: () => number;
-}
-/**
- * Write the OPERATOR-VISIBLE record (module header, step 2) on every cycling
- * delivery of the focus: gate_state.advanceHold, reason worktree_uncommitted_no_team,
- * naming the worktree and the paths. Returns how many rows carry it. Throws what a
- * read or write throws (the pass retries).
- */
-export declare function recordStrandedWorkOnFocus(record: UncommittedWorkRecord, deps: StrandedWorkRecordDeps): Promise<number>;
-/** Clear the record from every delivery of the focus that carries it. Throws what a read or write throws. */
-export declare function clearStrandedWorkOnFocus(focusId: string, deps: StrandedWorkRecordDeps): Promise<void>;
-/** The filing seams the record goes through. */
-export interface UncommittedWorkRecordDeps {
-    createEscalation: (params: CreateEscalationParams) => Promise<unknown>;
-    /** Whether a sibling worktree-dirty escalation is already open for the focus (one dirty tree, one row). */
-    hasOpenWorktreeDirtyEscalation: (focusId: string) => Promise<boolean>;
-}
-/**
- * File the record (module header, step 2): ONE agent-resolvable worktree-dirty
- * observation naming the uncommitted paths, unless a sibling worktree-dirty row
- * is already open for the focus. Committing or discarding the work is git work an
- * agent session can do, so it proposes no human act. A failed dedupe read files
- * (a genuine first record is not swallowed); a failed create throws to the caller.
- */
-export declare function fileUncommittedWorkRecord(record: UncommittedWorkRecord, deps: UncommittedWorkRecordDeps): Promise<void>;
-/**
- * The backstop pass over one product's active focuses (module header). Returns
- * what it did per focus it acted on. Never throws.
- */
-export declare function recoverUncommittedWork(config: {
-    organizationId: string;
-    productId: string;
-}, deps: UncommittedWorkBackstopDeps): Promise<Array<{
-    focusId: string;
-    action: UncommittedWorkAction;
-}>>;
-//# sourceMappingURL=uncommitted-work-backstop.d.ts.map

package/dist/focus/uncommitted-work-backstop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"uncommitted-work-backstop.d.ts","sourceRoot":"","sources":["../../src/focus/uncommitted-work-backstop.ts"],"names":[],"mappings":"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"}