@telora/daemon 0.20.4 → 0.20.19

package/dist/shortfall-disposition-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortfall-disposition-config.d.ts","sourceRoot":"","sources":["../src/shortfall-disposition-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH;;;;;;;;;;GAUG;AACH,wBAAgB,qCAAqC,CACnD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAUR"}

package/dist/shortfall-disposition-config.js

@@ -0,0 +1,46 @@
+/**
+ * Threshold for the shortfall-disposition attempt bound.
+ *
+ * The CANONICAL declaration (Zod schema, ENV_VAR_METADATA entry, default,
+ * description) lives in packages/daemon-core/src/env-config.ts, exactly like the
+ * stall-detector thresholds in stall-detector-config.ts.
+ *
+ * It is read RAW here rather than through loadEnvConfig() for one reason:
+ * @telora/daemon-core is REGISTRY-INSTALLED, not a workspace symlink, so
+ * packages/daemon compiles and runs against the PUBLISHED dist. A field added to
+ * daemon-core's source is invisible to loadEnvConfig() here until a publish
+ * lands and the pin moves. This is the same registry-lag workaround
+ * stall-detectors.ts documents for escalation kinds.
+ *
+ * The raw read is allowlisted in scripts/lint-config.json under "env-reads"
+ * with that reason. WHEN daemon-core >0.2.69 IS PUBLISHED AND PINNED: delete the
+ * allowlist entry and change this to
+ * `loadEnvConfig().TELORA_SHORTFALL_DISPOSITION_ATTEMPT_CAP`.
+ *
+ * @module shortfall-disposition-config
+ */
+/** Must match the daemon-core default so the two cannot silently disagree. */
+const DEFAULT_SHORTFALL_DISPOSITION_ATTEMPT_CAP = 3;
+/**
+ * Max scoped disposition passes armed per focus before the daemon stops arming
+ * and escalates instead.
+ *
+ * Invalid values (non-numeric, <= 0) fall back to the default rather than
+ * disabling the bound: a zero or negative cap would escalate immediately on
+ * every held focus, and a NaN would compare false forever and never escalate --
+ * the permanent silent wait this bound exists to prevent. Once daemon-core is
+ * republished, Zod's positiveInt does this validation at startup and fails loud,
+ * which is strictly better; this is the interim.
+ */
+export function resolveShortfallDispositionAttemptCap(env = process.env) {
+    const raw = env.TELORA_SHORTFALL_DISPOSITION_ATTEMPT_CAP;
+    if (raw === undefined || raw.trim() === '') {
+        return DEFAULT_SHORTFALL_DISPOSITION_ATTEMPT_CAP;
+    }
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed <= 0) {
+        return DEFAULT_SHORTFALL_DISPOSITION_ATTEMPT_CAP;
+    }
+    return parsed;
+}
+//# sourceMappingURL=shortfall-disposition-config.js.map

package/dist/shortfall-disposition-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortfall-disposition-config.js","sourceRoot":"","sources":["../src/shortfall-disposition-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,8EAA8E;AAC9E,MAAM,yCAAyC,GAAG,CAAC,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qCAAqC,CACnD,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,GAAG,CAAC,wCAAwC,CAAC;IACzD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,OAAO,yCAAyC,CAAC;IACnD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACzE,OAAO,yCAAyC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shortfall-disposition-loop.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Scoped shortfall-disposition pass.
+ *
+ * A focus carrying an undisposed shortfall cannot converge: the completion gate
+ * (review-exit-phase) withholds done until every shortfall is ratified or
+ * dismissed. A hold with no self-heal is just a wedge, so this tick finds held
+ * focuses and arms a one-shot pass whose ONLY mandate is disposing them.
+ *
+ * WHY A TICK AND NOT THE REVIEW-EXIT PATH. The mandate covers shortfalls a
+ * review missed AND ones that arrived after the review window closed. A late
+ * arrival coincides with no review exit at all -- no handler runs to notice it --
+ * so arming from the exit path could only ever cover half the job. A tick sees a
+ * held focus whenever it becomes held, regardless of what held it.
+ *
+ * WHAT THIS PASS CAN AND CANNOT DO. It runs as a CODING session (a 'review'
+ * sessionType would re-enter the review-exit handler on exit and re-trigger the
+ * whole auto-approve evaluation -- a spawn loop). product-api refuses an agent
+ * shortfall-RATIFY unless it carries a review session, so this pass structurally
+ * cannot ratify. That is deliberate, not a limitation to work around: a pass
+ * that cannot lower a bar is a safe pass. It disposes the common case (the work
+ * fell short -> file defects + dismiss) and deliberately LEAVES a
+ * genuinely-wrong claim undisposed for a real review or an operator. The stall
+ * detector bounds that tail.
+ *
+ * Activation: opt-out via TELORA_SHORTFALL_DISPOSITION_LOOP=0. See
+ * `shouldRunLoop()` in focus-engine.ts.
+ *
+ * @module shortfall-disposition-loop
+ */
+import type { DaemonConfig, StageDirective } from './types.js';
+import { getActiveFocuses } from './queries/deliveries.js';
+import { listOpenShortfallProposalIds } from './queries/reality-tree.js';
+import { setShortfallDispositionAttempts } from './queries/focuses.js';
+import { createEscalation, hasOpenFocusEscalation } from './queries/issues.js';
+import { hasPendingSpawnDirective } from './directive/directive-queue.js';
+import { assembleDirectiveContent } from './directive/directive-assembly.js';
+/**
+ * The one-shot mandate. Pure + unit-testable.
+ *
+ * States the RULE only; the drift.shortfall_proposals resolver carries the DATA
+ * (ids, claims, both dispositions, the exact params). Duplicating the detail
+ * here would drift from the resolver.
+ */
+export declare function buildShortfallDispositionDirective(): StageDirective;
+export interface ShortfallDispositionTickResult {
+    productsScanned: number;
+    focusesScanned: number;
+    /** Focuses carrying at least one undisposed shortfall. */
+    focusesHeld: number;
+    /** Disposition directives armed this tick. */
+    armed: number;
+    /** Held focuses skipped: a team is already running or a directive is pending. */
+    skippedBusy: number;
+    /** Focuses that exhausted the attempt bound and were escalated to an operator. */
+    escalated: number;
+    /** Focuses whose attempt counter was reset because their shortfalls cleared. */
+    countersReset: number;
+    errors: number;
+}
+export interface ShortfallDispositionDeps {
+    getActiveFocuses: typeof getActiveFocuses;
+    listOpenShortfallProposalIds: typeof listOpenShortfallProposalIds;
+    /** True when a team is already running for the focus. */
+    hasActiveTeam: (focusId: string) => boolean;
+    hasPendingSpawnDirective: typeof hasPendingSpawnDirective;
+    assembleDirectiveContent: typeof assembleDirectiveContent;
+    /** Stash the directive for the spawner to consume. */
+    armDirective: (focusId: string, message: string, directive: StageDirective) => void;
+    /** Persist the durable attempt counter. */
+    setShortfallDispositionAttempts: typeof setShortfallDispositionAttempts;
+    /** Per-focus dedup so the cap files exactly one open escalation. */
+    hasOpenFocusEscalation: typeof hasOpenFocusEscalation;
+    createEscalation: typeof createEscalation;
+    /** Injectable so the pure decision unit-tests without env or Supabase. */
+    cap?: number;
+}
+/**
+ * Run one disposition-pass tick across every product in the daemon config.
+ *
+ * Arms at most one directive per held focus per tick, and never while a team is
+ * running or a directive is already pending -- so a focus that stays held across
+ * ticks does not accumulate spawns. Per-focus failures are counted and skipped;
+ * one unresolvable focus must not stop the others.
+ */
+export declare function runShortfallDispositionTick(config: DaemonConfig, depOverrides?: Partial<ShortfallDispositionDeps>): Promise<ShortfallDispositionTickResult>;
+//# sourceMappingURL=shortfall-disposition-loop.d.ts.map

package/dist/shortfall-disposition-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortfall-disposition-loop.d.ts","sourceRoot":"","sources":["../src/shortfall-disposition-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EACL,wBAAwB,EAGzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AA0B7E;;;;;;GAMG;AACH,wBAAgB,kCAAkC,IAAI,cAAc,CA0CnE;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,4BAA4B,EAAE,OAAO,4BAA4B,CAAC;IAClE,yDAAyD;IACzD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;IAC1D,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;IAC1D,sDAAsD;IACtD,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,KAAK,IAAI,CAAC;IACpF,2CAA2C;IAC3C,+BAA+B,EAAE,OAAO,+BAA+B,CAAC;IACxE,oEAAoE;IACpE,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgGD;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,YAAY,EACpB,YAAY,GAAE,OAAO,CAAC,wBAAwB,CAAM,GACnD,OAAO,CAAC,8BAA8B,CAAC,CAuIzC"}

package/dist/shortfall-disposition-loop.js

@@ -0,0 +1,309 @@
+/**
+ * Scoped shortfall-disposition pass.
+ *
+ * A focus carrying an undisposed shortfall cannot converge: the completion gate
+ * (review-exit-phase) withholds done until every shortfall is ratified or
+ * dismissed. A hold with no self-heal is just a wedge, so this tick finds held
+ * focuses and arms a one-shot pass whose ONLY mandate is disposing them.
+ *
+ * WHY A TICK AND NOT THE REVIEW-EXIT PATH. The mandate covers shortfalls a
+ * review missed AND ones that arrived after the review window closed. A late
+ * arrival coincides with no review exit at all -- no handler runs to notice it --
+ * so arming from the exit path could only ever cover half the job. A tick sees a
+ * held focus whenever it becomes held, regardless of what held it.
+ *
+ * WHAT THIS PASS CAN AND CANNOT DO. It runs as a CODING session (a 'review'
+ * sessionType would re-enter the review-exit handler on exit and re-trigger the
+ * whole auto-approve evaluation -- a spawn loop). product-api refuses an agent
+ * shortfall-RATIFY unless it carries a review session, so this pass structurally
+ * cannot ratify. That is deliberate, not a limitation to work around: a pass
+ * that cannot lower a bar is a safe pass. It disposes the common case (the work
+ * fell short -> file defects + dismiss) and deliberately LEAVES a
+ * genuinely-wrong claim undisposed for a real review or an operator. The stall
+ * detector bounds that tail.
+ *
+ * Activation: opt-out via TELORA_SHORTFALL_DISPOSITION_LOOP=0. See
+ * `shouldRunLoop()` in focus-engine.ts.
+ *
+ * @module shortfall-disposition-loop
+ */
+import { withRetry, ESCALATION_REASONS, ESCALATION_DISPOSITIONS } from '@telora/daemon-core';
+import { configForProduct } from './config.js';
+import { getActiveFocuses } from './queries/deliveries.js';
+import { listOpenShortfallProposalIds } from './queries/reality-tree.js';
+import { setShortfallDispositionAttempts } from './queries/focuses.js';
+import { createEscalation, hasOpenFocusEscalation } from './queries/issues.js';
+import { getActiveTeams } from './focus-team-state.js';
+import { hasPendingSpawnDirective, pendingSpawnDirectives, computeDirectiveHash, } from './directive/directive-queue.js';
+import { assembleDirectiveContent } from './directive/directive-assembly.js';
+import { resolveShortfallDispositionAttemptCap } from './shortfall-disposition-config.js';
+import { createLogger } from './log.js';
+const log = createLogger({ module: 'shortfall-disposition-loop' });
+/**
+ * Declared daemon-locally, not imported from @telora/daemon-core's EscalationKind
+ * union. That union is registry-published and lags the DB CHECK by several
+ * values, so it cannot name this kind until a publish lands. The DB CHECK
+ * (20260715231941) is the real constraint. Same workaround stall-detectors.ts
+ * documents.
+ */
+const SHORTFALL_UNDISPOSED_KIND = 'shortfall_undisposed';
+/**
+ * Deliberately narrow. The pass needs the shortfalls (with their ids, claims,
+ * and what reality showed -- all rendered by the resolver) and the diff that
+ * produced them. Nothing else: a wider recipe invites the pass to re-adjudicate
+ * work that is not its mandate.
+ */
+const SHORTFALL_DISPOSITION_ASSEMBLY = [
+    'drift.shortfall_proposals',
+    'git.diff_against_base',
+];
+/**
+ * The one-shot mandate. Pure + unit-testable.
+ *
+ * States the RULE only; the drift.shortfall_proposals resolver carries the DATA
+ * (ids, claims, both dispositions, the exact params). Duplicating the detail
+ * here would drift from the resolver.
+ */
+export function buildShortfallDispositionDirective() {
+    return {
+        execution: 'spawn',
+        compact: null,
+        assembly: [...SHORTFALL_DISPOSITION_ASSEMBLY],
+        tools: null,
+        prompt: [
+            'You are a scoped disposition pass. This focus cannot finish because it',
+            'carries shortfall drift proposals nobody has disposed. Disposing them is',
+            'your ONLY mandate -- do not review the code, do not refactor, do not pick',
+            'up other work.',
+            '',
+            'A shortfall says: the reality tree claimed something, and the work',
+            'delivered less than that claim. One of the two was wrong, and until',
+            'someone says which, no delivery on this focus can converge to done.',
+            '',
+            'The proposals awaiting you are listed in your context, each with its id,',
+            'the claim, and what reality showed. For EACH one:',
+            '',
+            '- **The WORK fell short** (the common case) -- file a defect issue on the',
+            '  delivery that owns the gap (`telora_product_issue` action=create, type',
+            '  Bug or Task, with a concrete title/description the coding team can act',
+            '  on), THEN dismiss the proposal via `telora_reality_drift`',
+            '  action=dismiss with a non-empty `reason` naming the issues you filed.',
+            '  Dismissing REJECTS the proposed correction: the claim stands, and the',
+            '  work is what changes. Filing the defect ALONE is not a disposition --',
+            '  it leaves the proposal open and the focus stays wedged.',
+            '',
+            '- **The CLAIM was wrong** -- the tree asserted something it should never',
+            '  have asserted. You CANNOT dispose this case: amending a claim requires',
+            '  an independent review session, and you are not one. Do NOT dismiss it',
+            '  to clear the queue -- dismissing asserts the claim stands, which would',
+            '  be a false statement about reality. LEAVE IT UNDISPOSED and say so',
+            '  plainly in your final message, naming the proposal id and why you',
+            '  believe the claim is wrong. An operator will be escalated to.',
+            '',
+            'Never dismiss a proposal you have not actually understood. An unexplained',
+            'dismissal discards the signal the loop exists to carry, and the dismiss',
+            'rate is measured.',
+        ].join('\n'),
+        model: null,
+    };
+}
+function defaultArmDirective(focusId, message, directive) {
+    pendingSpawnDirectives.set(focusId, {
+        message,
+        model: directive.model ?? null,
+        // Fixed-purpose one-shot: the focus's model selector must not override it.
+        focusOverrideModel: null,
+        // MUST be 'coding'. A 'review' sessionType re-enters runReviewExitHandler on
+        // exit and re-triggers the auto-approve evaluation -- a spawn loop. The
+        // close_loop bookkeeper sets 'coding' for exactly this reason.
+        sessionType: 'coding',
+        // Its own lineage slot: cannot resume or clobber the coder's or reviewer's
+        // context (session-lineage.ts:53-70).
+        lineage: 'shortfall_disposition',
+        continuity: 'fresh',
+        contentHash: computeDirectiveHash(directive),
+    });
+}
+function defaultDeps() {
+    return {
+        getActiveFocuses,
+        listOpenShortfallProposalIds,
+        hasActiveTeam: (focusId) => getActiveTeams().has(focusId),
+        hasPendingSpawnDirective,
+        assembleDirectiveContent,
+        armDirective: defaultArmDirective,
+        setShortfallDispositionAttempts,
+        hasOpenFocusEscalation,
+        createEscalation,
+    };
+}
+/**
+ * File the one escalation that lets a human into this loop.
+ *
+ * Deduped per focus against the DB (not memory), so the bound holds across a
+ * daemon restart and a held focus accrues exactly one open escalation.
+ */
+async function escalateUndisposed(deps, params) {
+    if (await deps.hasOpenFocusEscalation(params.focusId, SHORTFALL_UNDISPOSED_KIND)) {
+        return false;
+    }
+    await withRetry(() => deps.createEscalation({
+        organizationId: params.organizationId,
+        sessionId: '',
+        issueId: null,
+        reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+        disposition: ESCALATION_DISPOSITIONS.NEEDS_OPERATOR,
+        anchor: { focusId: params.focusId },
+        escalationKind: SHORTFALL_UNDISPOSED_KIND,
+        description: `Focus "${params.focusName}" cannot finish: ${params.shortfallIds.length} shortfall ` +
+            `drift proposal(s) are still undisposed after ${params.attempts} disposition pass(es) ` +
+            `(cap ${params.cap}). Its deliveries are held in verify and the loop will not ` +
+            `converge on its own.\n\n` +
+            `**Focus:** ${params.focusName}\n` +
+            `**Focus ID:** ${params.focusId}\n` +
+            `**Undisposed proposals:** ${params.shortfallIds.join(', ')}\n\n` +
+            `A shortfall means the reality tree claimed something and the work delivered less ` +
+            `than that claim. One of the two is wrong, and the machine could not decide which.\n\n` +
+            `The likeliest cause is that the CLAIM is wrong: the disposition pass runs as a ` +
+            `coding session and CANNOT ratify (amending a claim requires an independent review ` +
+            `session), so it correctly left these alone rather than dismissing them falsely.`,
+        whatWasTried: `${params.attempts} scoped disposition pass(es) were armed. Each could file defects ` +
+            `and dismiss a proposal whose CLAIM stands, but none disposed these.`,
+        helpNeeded: `Decide, per proposal: if the CLAIM was wrong, ratify it (with a rationale) so the ` +
+            `tree amends; if the WORK fell short, dismiss it (with a reason) and ensure defect ` +
+            `issues exist so the delivery re-codes. Either disposition clears the hold.`,
+        metadata: {
+            cause: SHORTFALL_UNDISPOSED_KIND,
+            focusName: params.focusName,
+            shortfallProposalIds: params.shortfallIds,
+            attempts: params.attempts,
+            cap: params.cap,
+        },
+    }), { maxAttempts: 3, label: `escalation-shortfall-undisposed-${params.focusId}` });
+    return true;
+}
+/**
+ * Run one disposition-pass tick across every product in the daemon config.
+ *
+ * Arms at most one directive per held focus per tick, and never while a team is
+ * running or a directive is already pending -- so a focus that stays held across
+ * ticks does not accumulate spawns. Per-focus failures are counted and skipped;
+ * one unresolvable focus must not stop the others.
+ */
+export async function runShortfallDispositionTick(config, depOverrides = {}) {
+    const deps = { ...defaultDeps(), ...depOverrides };
+    const cap = deps.cap ?? resolveShortfallDispositionAttemptCap();
+    const counts = {
+        productsScanned: 0,
+        focusesScanned: 0,
+        focusesHeld: 0,
+        armed: 0,
+        skippedBusy: 0,
+        escalated: 0,
+        countersReset: 0,
+        errors: 0,
+    };
+    for (const product of config.products) {
+        counts.productsScanned += 1;
+        const pc = configForProduct(config, product);
+        let focuses;
+        try {
+            focuses = await deps.getActiveFocuses(config.organizationId, product.id);
+        }
+        catch (err) {
+            counts.errors += 1;
+            log.warn(`[shortfall-disposition] getActiveFocuses failed for product ${product.id}: ${err.message}`);
+            continue;
+        }
+        for (const focus of focuses) {
+            counts.focusesScanned += 1;
+            let shortfallIds;
+            try {
+                shortfallIds = await deps.listOpenShortfallProposalIds(focus.focus_id);
+            }
+            catch (err) {
+                counts.errors += 1;
+                log.warn(`[shortfall-disposition] shortfall lookup failed for "${focus.focus_name}": ${err.message}`);
+                continue;
+            }
+            const attempts = focus.shortfall_disposition_attempts ?? 0;
+            if (shortfallIds.length === 0) {
+                // Cleared. Reset the budget so a later, unrelated shortfall gets a full
+                // set of attempts rather than inheriting an exhausted counter.
+                if (attempts > 0) {
+                    try {
+                        await deps.setShortfallDispositionAttempts(focus.focus_id, 0);
+                        counts.countersReset += 1;
+                    }
+                    catch (err) {
+                        counts.errors += 1;
+                        log.warn(`[shortfall-disposition] failed to reset attempts for "${focus.focus_name}": ${err.message}`);
+                    }
+                }
+                continue;
+            }
+            counts.focusesHeld += 1;
+            // The bound. Past the cap the machine has demonstrably failed to dispose
+            // these on its own, so stop arming (each pass costs a team) and hand it to
+            // an operator instead. The counter is DURABLE, so this survives restarts:
+            // an in-process counter would reset and re-arm forever, never escalating.
+            if (attempts >= cap) {
+                try {
+                    if (await escalateUndisposed(deps, {
+                        organizationId: config.organizationId,
+                        focusId: focus.focus_id,
+                        focusName: focus.focus_name,
+                        shortfallIds,
+                        attempts,
+                        cap,
+                    })) {
+                        counts.escalated += 1;
+                        log.info(`[shortfall-disposition] filed ${SHORTFALL_UNDISPOSED_KIND} for "${focus.focus_name}" ` +
+                            `(${shortfallIds.length} undisposed after ${attempts} pass(es), cap ${cap})`);
+                    }
+                }
+                catch (err) {
+                    counts.errors += 1;
+                    log.warn(`[shortfall-disposition] failed to escalate for "${focus.focus_name}": ${err.message}`);
+                }
+                continue;
+            }
+            // A running team already has (or will get) the context; a pending
+            // directive is already queued for the spawner. Arming over either would
+            // duplicate work or clobber a queued handoff.
+            if (deps.hasActiveTeam(focus.focus_id) || deps.hasPendingSpawnDirective(focus.focus_id)) {
+                counts.skippedBusy += 1;
+                continue;
+            }
+            try {
+                const directive = buildShortfallDispositionDirective();
+                // No worktree path: the pass is armed between teams, so there is no live
+                // team to read one from. git.diff_against_base degrades to nothing
+                // rather than throwing (assembly sources fail soft), and the shortfall
+                // section -- the part that matters -- resolves regardless.
+                const message = await deps.assembleDirectiveContent(pc, focus.focus_id, directive, null);
+                deps.armDirective(focus.focus_id, message, directive);
+                counts.armed += 1;
+                // Count the attempt AFTER the arm succeeds -- an assembly failure is not
+                // an attempt, and charging for it would burn the budget without the pass
+                // ever running. Persisted before the next tick can read it, so the bound
+                // advances even if this process dies immediately after.
+                await deps.setShortfallDispositionAttempts(focus.focus_id, attempts + 1);
+                log.info(`[shortfall-disposition] armed a disposition pass for "${focus.focus_name}" ` +
+                    `(attempt ${attempts + 1}/${cap}, ${shortfallIds.length} undisposed shortfall(s): ` +
+                    `${shortfallIds.join(', ')})`);
+            }
+            catch (err) {
+                counts.errors += 1;
+                log.warn(`[shortfall-disposition] failed to arm for "${focus.focus_name}": ${err.message}`);
+            }
+        }
+    }
+    if (counts.focusesHeld > 0 || counts.errors > 0) {
+        log.info(`[shortfall-disposition] tick: products=${counts.productsScanned} focuses=${counts.focusesScanned} ` +
+            `held=${counts.focusesHeld} armed=${counts.armed} skippedBusy=${counts.skippedBusy} ` +
+            `escalated=${counts.escalated} reset=${counts.countersReset} errors=${counts.errors}`);
+    }
+    return counts;
+}
+//# sourceMappingURL=shortfall-disposition-loop.js.map

package/dist/shortfall-disposition-loop.js.map

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

package/dist/spawn/model-routing.d.ts.map

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

package/dist/spawn/model-routing.js

@@ -18,6 +18,8 @@ import { codexSafeModelAlias, writeLocalModelCodexHome, TELORA_LOCAL_API_KEY_ENV
 import { startCodexMcpProxy, shouldRouteLocalModelThroughProxy, } from '../backends/codex/codex-mcp-proxy.js';
 import { detectHostCapability, ensureLoaded, resolveSafeLoadOptions, getStatus, decideSwap, hostRootFromBaseUrl, observeHostSwap, claimResidentHost, detectSingleHostModelConflict, shouldSurfaceHostConflictOnce, } from '../host-control/index.js';
 import { hasActiveTeam } from '../focus-team-state.js';
+import { createLogger } from '../log.js';
+const log = createLogger({ module: 'focus-executor' });
 /**
  * Resolve the isolated CODEX_HOME to set on a spawn, or undefined when none
  * applies. Pure + testable: only a codex-engine spawn against a product that
@@ -270,7 +272,7 @@ export async function surfaceSingleHostModelConflict(args, deps = {}) {
         `review="${reviewCoords.name}" (${reviewCoords.model}). On a single GPU these force an ` +
         `evict+load swap on every pass alternation and fight over the card. Pin both passes to the ` +
         `same local model, or move one pass to a different host / a cloud engine.`;
-    console.warn(`[focus-executor] Host-control: ${detail}`);
+    log.warn(`Host-control: ${detail}`);
     try {
         await makeEscalation({
             organizationId: args.organizationId,
@@ -290,7 +292,7 @@ export async function surfaceSingleHostModelConflict(args, deps = {}) {
         });
     }
     catch (err) {
-        console.warn(`[focus-executor] Failed to file single_host_model_conflict escalation for "${args.focusName}":`, err.message);
+        log.warn(`[focus-executor] Failed to file single_host_model_conflict escalation for "${args.focusName}":`, err.message);
     }
     return { surfaced: true };
 }
@@ -326,7 +328,7 @@ export async function resolveSpawnModel(args) {
     // TELORA_LOCAL_API_KEY name) for a routed local-model pass; null otherwise.
     let spawnLocalModelKey = null;
     if (localModelConfig.kind === 'fallback') {
-        console.warn(`[focus-executor] Focus "${focusName}" ${enginePass} pass selected local model ` +
+        log.warn(`[focus-executor] Focus "${focusName}" ${enginePass} pass selected local model ` +
             `${(localModelConfig.ref ?? '').slice(0, 8)} but it is not in the registry; falling back to the ` +
             `per-product default model.`);
     }
@@ -336,7 +338,7 @@ export async function resolveSpawnModel(args) {
         spawnCodexModel = codexModel;
         spawnLocalModelKey = apiKey;
         isLocalModelPass = true;
-        console.log(`[focus-executor] Routing "${focusName}" ${enginePass} pass to local model ` +
+        log.info(`[focus-executor] Routing "${focusName}" ${enginePass} pass to local model ` +
             `"${coords.name}" (${coords.model} @ ${coords.baseUrl}); CODEX_HOME=${codexHome}, ` +
             (apiKey
                 ? `key from Telora (env ${TELORA_LOCAL_API_KEY_ENV}).`
@@ -362,9 +364,10 @@ export async function resolveSpawnModel(args) {
                         target: coords.model,
                     }).action === 'noop';
             }
-            catch {
+            catch (err) {
                 // Transient status-read failure -> fall through to the managed async
                 // swap, which retries the load + readiness off the poll-critical path.
+                log.debug('Transient status-read failure -> fall through to the managed async', { error: String(err?.message ?? err) });
             }
             if (alreadyResident) {
                 // Claim the per-host residency lock (#4) so a second focus on this host
@@ -376,11 +379,11 @@ export async function resolveSpawnModel(args) {
                     isFocusActive: (id) => hasActiveTeam(id),
                 });
                 if (claim.status === 'busy_other') {
-                    console.log(`[focus-executor] Host-control: host for "${coords.name}" is held by another ` +
+                    log.info(`[focus-executor] Host-control: host for "${coords.name}" is held by another ` +
                         `focus's running pass; deferring "${focusName}" ${enginePass} pass to avoid eviction.`);
                     return { kind: 'still_loading', coords, reason: 'host_busy_other_focus' };
                 }
-                console.log(`[focus-executor] Host-control: model "${coords.name}" (${coords.model}) already ` +
+                log.info(`[focus-executor] Host-control: model "${coords.name}" (${coords.model}) already ` +
                     `resident + ready for "${focusName}" ${enginePass} pass.`);
             }
             else {
@@ -404,12 +407,12 @@ export async function resolveSpawnModel(args) {
                         // fixed DEFAULT_MAX_SEQ_LENGTH when host hardware data is unavailable.
                         const sizing = await resolveSafeLoadOptions(coords.baseUrl, coords.model, { modelSizeMb: coords.modelSizeMb, nativeContext: coords.nativeContext }, apiKey);
                         if (sizing.source === 'fallback') {
-                            console.warn(`[focus-executor] Host-control sizing unavailable for "${coords.name}" ` +
+                            log.warn(`[focus-executor] Host-control sizing unavailable for "${coords.name}" ` +
                                 `(${coords.model}); falling back to the fixed default context ` +
                                 `${sizing.maxSeqLength}. Check the host's /api/system/hardware endpoint.`);
                         }
                         else {
-                            console.log(`[focus-executor] Host-control sizing for "${coords.name}" (${coords.model}): ` +
+                            log.info(`[focus-executor] Host-control sizing for "${coords.name}" (${coords.model}): ` +
                                 `max_seq_length=${sizing.maxSeqLength}` +
                                 (sizing.cacheTypeKv ? `, cache_type_kv=${sizing.cacheTypeKv}` : '') +
                                 (sizing.quantRequired ? ' (quant-required, marginal headroom)' : '') +
@@ -422,29 +425,29 @@ export async function resolveSpawnModel(args) {
                             loadTimeoutMs,
                             ...(sizing.cacheTypeKv !== undefined ? { cacheTypeKv: sizing.cacheTypeKv } : {}),
                         }, apiKey);
-                        console.log(`[focus-executor] Host-control: local model "${coords.name}" (${coords.model}) ` +
+                        log.info(`[focus-executor] Host-control: local model "${coords.name}" (${coords.model}) ` +
                             `loaded + ready (off-loop swap complete).`);
                     },
                 });
                 if (observation.status === 'loading') {
-                    console.log(`[focus-executor] Host-control: model "${coords.name}" (${coords.model}) is loading ` +
+                    log.info(`[focus-executor] Host-control: model "${coords.name}" (${coords.model}) is loading ` +
                         `for "${focusName}" ${enginePass} pass; deferring spawn (load runs off the poll loop).`);
                     return { kind: 'still_loading', coords, reason: 'model_loading' };
                 }
                 if (observation.status === 'busy_other') {
-                    console.log(`[focus-executor] Host-control: host for "${coords.name}" is held by another ` +
+                    log.info(`[focus-executor] Host-control: host for "${coords.name}" is held by another ` +
                         `focus's running pass; deferring "${focusName}" ${enginePass} pass to avoid eviction.`);
                     return { kind: 'still_loading', coords, reason: 'host_busy_other_focus' };
                 }
                 if (observation.status === 'failed') {
-                    console.error(`[focus-executor] Host-control swap to load "${coords.name}" (${coords.model}) for ` +
+                    log.error(`[focus-executor] Host-control swap to load "${coords.name}" (${coords.model}) for ` +
                         `"${focusName}" ${enginePass} pass FAILED: ${observation.error}. Not spawning against ` +
                         `an unloaded model; will re-attempt next poll.`);
                     return { kind: 'skip_load', coords, dbMessage: observation.error };
                 }
                 // observation.status === 'ready' -- the detached load completed on a
                 // prior tick; the model is resident and residency is held. Proceed.
-                console.log(`[focus-executor] Host-control: model "${coords.name}" (${coords.model}) ready for ` +
+                log.info(`[focus-executor] Host-control: model "${coords.name}" (${coords.model}) ready for ` +
                     `"${focusName}" ${enginePass} pass (off-loop swap complete).`);
             }
         }
@@ -480,14 +483,14 @@ export async function resolveSpawnModel(args) {
                 wireApi: coords.wireApi ?? undefined,
                 requiresApiKey: apiKey !== null,
             });
-            console.log(`[focus-executor] Local-model MCP proxy engaged for "${coords.name}": ` +
+            log.info(`[focus-executor] Local-model MCP proxy engaged for "${coords.name}": ` +
                 `Codex base_url -> ${mcpProxy.url} -> upstream ${coords.baseUrl}.`);
         }
         catch (err) {
             // Best-effort: a proxy that cannot start must not block the spawn; fall
             // back to the direct (namespace-dropping) path. The fail-loud reception
             // check only applies when a proxy is present.
-            console.warn(`[focus-executor] Local-model MCP proxy failed to start; spawning direct: ${err.message}`);
+            log.warn(`Local-model MCP proxy failed to start; spawning direct: ${err.message}`);
             mcpProxy = null;
         }
     }