@telora/daemon 0.20.9 → 0.20.21

package/dist/resolvers/drift-shortfall-proposals.js

@@ -0,0 +1,90 @@
+import { registerSourceResolver } from '../assembly-engine.js';
+import { callApi } from '../queries/shared.js';
+import { requiresReviewDisposition } from '../drift-ratify-policy.js';
+import { createLogger } from '../log.js';
+const log = createLogger({ module: 'assembly-engine' });
+/**
+ * drift.shortfall_proposals
+ *
+ * Puts the focus's pending inward-SHORTFALL drift proposals into the review
+ * team's assembled context, so disposition is possible at all.
+ *
+ * A shortfall says: the tree claimed X, and the work delivered less than X.
+ * Someone must decide which one was wrong. Ratifying amends the CLAIM (only
+ * honest when the claim was mis-stated); filing defects says the WORK fell
+ * short and must re-enter coding. That decision is the review team's, because
+ * it did not write the code -- separation of duties standing in for the human
+ * gate that used to sit here.
+ *
+ * The classification is NOT re-derived here: `requiresReviewDisposition` from
+ * drift-ratify-policy.ts is the one place that decides what a shortfall is, and
+ * the daemon's auto-ratify tick reads the same predicate. Client-side filtering
+ * is required because crt_drift_proposal_list cannot filter on
+ * proposed_metadata (it supports focusId/productId/realityTreeId/status only).
+ *
+ * Fails soft -- returns empty string when there are none, or when the API call
+ * fails. An assembly section that throws would take the whole review prompt
+ * down with it; a review that runs without this section is degraded but the
+ * completion gate still refuses to let undisposed shortfalls through.
+ */
+/** Register this module's resolver(s). Called from initResolvers() -- not an import side effect. */
+export function registerDriftShortfallProposalsResolver() {
+    registerSourceResolver('drift.shortfall_proposals', async (context) => {
+        try {
+            const list = await callApi('crt_drift_proposal_list', {
+                focusId: context.focusId,
+                status: 'proposed',
+            });
+            const shortfalls = (list.items ?? []).filter((p) => requiresReviewDisposition({
+                proposalKind: p.proposalKind,
+                proposedMetadata: p.proposedMetadata,
+            }));
+            if (shortfalls.length === 0)
+                return '';
+            const lines = [
+                '## Shortfall Drift Proposals Awaiting Your Disposition',
+                '',
+                `${shortfalls.length} proposal(s) report that reality fell short of what this focus's`,
+                'reality tree claimed. Each one is a contradiction between a tree claim and what',
+                'the work actually delivered, and each REQUIRES a disposition from you before this',
+                'review can close.',
+                '',
+                '**You must choose, per proposal:**',
+                '',
+                '1. **The WORK fell short** (the common case) -- file defect issues describing',
+                '   the gap, THEN dismiss the proposal via `telora_reality_drift`',
+                '   action=dismiss, passing:',
+                '     - `proposalId`: the id below',
+                '     - `reason`: a non-empty explanation naming the defect issues you filed.',
+                '       Required -- the call is refused without it.',
+                '   Dismissing REJECTS the proposed correction: the claim stands and the work',
+                '   is what changes. Filing the defects ALONE is not enough -- it leaves the',
+                '   proposal open and the delivery can never converge. Do NOT ratify.',
+                '2. **The CLAIM was wrong** -- the tree asserted something it should never have',
+                '   asserted (mis-scoped, double-counted, or superseded). Ratify it via',
+                '   `telora_reality_drift` action=ratify, passing:',
+                '     - `proposalId`: the id below',
+                '     - `rationale`: a non-empty explanation of why the CLAIM (not the work) was',
+                '       wrong. Required -- the call is refused without it.',
+                '     - `ratifiedBySessionId`: your review session id (given elsewhere in this',
+                '       prompt). Required -- an agent cannot ratify a shortfall without it.',
+                '',
+                'Ratifying LOWERS A BAR. It is correct only when the claim was genuinely wrong,',
+                'never as a convenience when the work fell short. A ratified-shortfall rate is',
+                'measured; systematic ratification in place of filing defects is visible.',
+                '',
+            ];
+            for (const p of shortfalls) {
+                const meta = p.proposedMetadata ?? {};
+                const nodeId = p.nodeId ?? meta.sourceNodeId ?? 'unknown';
+                lines.push(`### Proposal \`${p.id}\``, '', `- **Tree node:** \`${nodeId}\``, `- **Kind:** ${p.proposalKind}`, `- **Raised:** ${p.createdAt}`, '', `**The tree claimed:** ${p.observedState}`, '', `**What reality showed:** ${p.proposedCorrection}`, '');
+            }
+            return lines.join('\n');
+        }
+        catch (err) {
+            log.warn(`drift.shortfall_proposals: failed: ${err.message}`);
+            return '';
+        }
+    });
+}
+//# sourceMappingURL=drift-shortfall-proposals.js.map

package/dist/resolvers/drift-shortfall-proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-shortfall-proposals.js","sourceRoot":"","sources":["../../src/resolvers/drift-shortfall-proposals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAkBxD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,oGAAoG;AACpG,MAAM,UAAU,uCAAuC;IACrD,sBAAsB,CACpB,2BAA2B,EAC3B,KAAK,EAAE,OAAwB,EAAmB,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAe,yBAAyB,EAAE;gBAClE,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACjD,yBAAyB,CAAC;gBACxB,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;aACrC,CAAC,CACH,CAAC;YACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAEvC,MAAM,KAAK,GAAa;gBACtB,wDAAwD;gBACxD,EAAE;gBACF,GAAG,UAAU,CAAC,MAAM,kEAAkE;gBACtF,iFAAiF;gBACjF,mFAAmF;gBACnF,mBAAmB;gBACnB,EAAE;gBACF,oCAAoC;gBACpC,EAAE;gBACF,+EAA+E;gBAC/E,kEAAkE;gBAClE,6BAA6B;gBAC7B,mCAAmC;gBACnC,8EAA8E;gBAC9E,oDAAoD;gBACpD,8EAA8E;gBAC9E,6EAA6E;gBAC7E,sEAAsE;gBACtE,gFAAgF;gBAChF,wEAAwE;gBACxE,mDAAmD;gBACnD,mCAAmC;gBACnC,iFAAiF;gBACjF,2DAA2D;gBAC3D,+EAA+E;gBAC/E,4EAA4E;gBAC5E,EAAE;gBACF,gFAAgF;gBAChF,+EAA+E;gBAC/E,0EAA0E;gBAC1E,EAAE;aACH,CAAC;YAEF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAK,IAAI,CAAC,YAAmC,IAAI,SAAS,CAAC;gBAClF,KAAK,CAAC,IAAI,CACR,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAC1B,EAAE,EACF,sBAAsB,MAAM,IAAI,EAChC,eAAe,CAAC,CAAC,YAAY,EAAE,EAC/B,iBAAiB,CAAC,CAAC,SAAS,EAAE,EAC9B,EAAE,EACF,yBAAyB,CAAC,CAAC,aAAa,EAAE,EAC1C,EAAE,EACF,4BAA4B,CAAC,CAAC,kBAAkB,EAAE,EAClD,EAAE,CACH,CAAC;YACJ,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,sCAAuC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resolvers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAuFH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAgBxC;AAGD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resolvers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAyFH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAgBxC;AAGD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC"}

package/dist/resolvers/index.js

@@ -33,6 +33,7 @@ import { registerDeploymentProfileResolver } from './deployment-profile.js';
 import { registerDeliveryListingResolver } from './delivery-listing.js';
 import { registerFocusInjectionsResolver } from './focus-injections.js';
 import { registerReviewOutcomesResolver } from './review-outcomes.js';
+import { registerDriftShortfallProposalsResolver } from './drift-shortfall-proposals.js';
 import { registerFocusAnchoringInjectionsResolver } from './focus-anchoring-injections.js';
 import { registerRealityMetricsResolver } from './reality-metrics.js';
 import { registerRealityProjectionsResolver } from './reality-projections.js';
@@ -73,6 +74,7 @@ const REGISTER_FUNCTIONS = [
     registerDeliveryListingResolver,
     registerFocusInjectionsResolver,
     registerReviewOutcomesResolver,
+    registerDriftShortfallProposalsResolver,
     registerFocusAnchoringInjectionsResolver,
     registerRealityMetricsResolver,
     registerRealityProjectionsResolver,

package/dist/resolvers/index.js.map

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

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

@@ -0,0 +1,34 @@
+/**
+ * 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
+ */
+/**
+ * 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 declare function resolveShortfallDispositionAttemptCap(env?: NodeJS.ProcessEnv): number;
+//# sourceMappingURL=shortfall-disposition-config.d.ts.map

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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"}