@telora/daemon 0.17.36 → 0.17.42

package/dist/completion/event-escalations.js

@@ -0,0 +1,213 @@
+/**
+ * Escalation builders for the completion event handler.
+ *
+ * The three human-signal paths handleCompletionEvent (event.ts) can take
+ * when a team cannot make progress: a planning team that scoped nothing, a
+ * team re-engaged past the no-progress limit, and a structurally
+ * non-advanceable delivery (the respawn-thrash guard). Extracted from
+ * completion/event.ts; bodies verbatim; event.ts re-exports the surface.
+ */
+import { withRetry, ESCALATION_REASONS } from '@telora/daemon-core';
+import { createEscalation as defaultCreateEscalation } from '../queries/issues.js';
+/** Reason string emitted when a planning team produces no deliveries. */
+export const PLANNING_NO_DELIVERIES_REASON = 'planning produced no deliveries';
+/** Reason string emitted when re-engagement is bounded by no-progress limit. */
+export const NO_PROGRESS_ESCALATION_REASON = 'team unable to make progress on remaining deliveries';
+/**
+ * Reason string emitted when the team has no actionable work AND a remaining
+ * non-terminal delivery cannot be advanced by the daemon either -- a structural
+ * dead end (missing workflow stage / no automatic transition out). Filed once,
+ * never re-fired, so the focus stops thrashing spawn->idle-exit->respawn.
+ */
+export const NON_ADVANCEABLE_ESCALATION_REASON = 'delivery cannot be advanced and the team has no actionable work';
+/**
+ * Cause discriminator stamped on the escalation metadata. The escalation_kind
+ * stays 'team_failure' (a value the agent_escalations CHECK constraint already
+ * accepts AND that the existing respawn guard -- hasOpenTeamFailureEscalation /
+ * applyRespawnGuard -- already suppresses), so no migration is required and
+ * respawn suppression composes for free. metadata.cause distinguishes this
+ * structural dead-end from a genuine effort-based no-progress failure during
+ * triage.
+ */
+export const NON_ADVANCEABLE_CAUSE = 'non_advanceable_delivery';
+const defaultEscalationDeps = {
+    createEscalation: defaultCreateEscalation,
+};
+/**
+ * Escalate when a planning team finishes its initial turn without writing
+ * any deliveries via MCP. The team is then terminated -- no respawn.
+ *
+ * Exported so tests and sister deliveries can verify the contract.
+ */
+export async function escalatePlanningFailure(params, deps = defaultEscalationDeps) {
+    const { sessionId, focusName, agentRoleId } = params;
+    try {
+        await withRetry(() => deps.createEscalation({
+            organizationId: params.organizationId,
+            sessionId,
+            issueId: null,
+            reasonType: ESCALATION_REASONS.NEEDS_CLARIFICATION,
+            description: `Planning team for focus "${focusName}" finished its initial turn without ` +
+                `creating any deliveries. Reason: ${PLANNING_NO_DELIVERIES_REASON}.\n\n` +
+                `**Focus:** ${focusName}\n` +
+                `**Focus ID:** ${params.focusId}\n` +
+                `**Agent role:** ${agentRoleId}\n\n` +
+                `The team has been terminated. A human must either scope the focus ` +
+                `manually or re-queue it after clarifying intent.`,
+            whatWasTried: `Spawned a planning team to scope deliveries for "${focusName}".`,
+            helpNeeded: `Review the focus intent and either scope deliveries manually or update the focus description so the next planning attempt can succeed.`,
+        }), { maxAttempts: 3, label: `escalation-planning-no-deliveries-${params.focusId}` });
+        console.log(`[focus-executor] Created planning-failure escalation for "${focusName}" ` +
+            `(reason: ${PLANNING_NO_DELIVERIES_REASON})`);
+    }
+    catch (err) {
+        console.error(`[focus-executor] Failed to create planning-failure escalation for "${focusName}": ${err.message}`);
+    }
+}
+/**
+ * Escalate when the team has been re-engaged repeatedly without making
+ * any measurable progress on the remaining non-terminal deliveries.
+ *
+ * Exported so tests can verify the contract.
+ */
+export async function escalateNoProgress(params, deps = defaultEscalationDeps) {
+    const remainingList = params.remaining
+        .slice()
+        .sort((a, b) => a.priorityRank - b.priorityRank)
+        .map(d => `- "${d.name}" [${d.executionStatus ?? 'draft'}] (rank ${d.priorityRank})`)
+        .join('\n');
+    // Cause classification: if every remaining non-terminal delivery is
+    // sitting on a populated gate_state, the team didn't fail -- the daemon's
+    // gate refused to advance them. Route as daemon_gate_stuck so substantive
+    // team-failure signals don't drown in daemon-gap noise. Otherwise fall
+    // back to the explicit team_failure kind.
+    const gateStuckDeliveries = params.remaining.filter(d => d.gateState != null);
+    const allDaemonGateStuck = params.remaining.length > 0 && gateStuckDeliveries.length === params.remaining.length;
+    const escalationKind = allDaemonGateStuck ? 'daemon_gate_stuck' : 'team_failure';
+    const metadata = {
+        focusId: params.focusId,
+        focusName: params.focusName,
+        cycles: params.cycles,
+        cause: escalationKind,
+    };
+    if (allDaemonGateStuck) {
+        metadata.gateStates = gateStuckDeliveries.map(d => ({
+            deliveryId: d.id,
+            deliveryName: d.name,
+            executionStatus: d.executionStatus,
+            gateState: d.gateState,
+        }));
+    }
+    const description = allDaemonGateStuck
+        ? `Team for focus "${params.focusName}" terminated because the daemon's verify gate ` +
+            `has not advanced any of the ${params.remaining.length} remaining delivery(ies) ` +
+            `across ${params.cycles} re-engagement cycles. This is a daemon-side gap, not a team failure.\n\n` +
+            `**Focus:** ${params.focusName}\n` +
+            `**Focus ID:** ${params.focusId}\n` +
+            `**Agent role:** ${params.agentRoleId}\n` +
+            `**Remaining (all gate-stuck):**\n${remainingList}\n\n` +
+            `Inspect each delivery's gate_state to determine the specific blocking condition. ` +
+            `See docs/runbook-verify-gate.md.`
+        : `Team for focus "${params.focusName}" has been re-engaged ${params.cycles} ` +
+            `consecutive cycles without measurable progress. Reason: ${NO_PROGRESS_ESCALATION_REASON}.\n\n` +
+            `**Focus:** ${params.focusName}\n` +
+            `**Focus ID:** ${params.focusId}\n` +
+            `**Agent role:** ${params.agentRoleId}\n` +
+            `**Remaining non-terminal deliveries:**\n${remainingList}\n\n` +
+            `The team has been terminated. A human must intervene to unblock the focus.`;
+    try {
+        await withRetry(() => deps.createEscalation({
+            organizationId: params.organizationId,
+            sessionId: params.sessionId,
+            issueId: null,
+            reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+            escalationKind,
+            metadata,
+            description,
+            whatWasTried: `Re-engaged the team via the daemon-push channel (${params.cycles} cycles). ` +
+                `No delivery status transitions and no new issues were observed between cycles.`,
+            helpNeeded: allDaemonGateStuck
+                ? `Inspect the gate_state on each delivery to identify the specific blocking ` +
+                    `condition. The condition is documented in docs/runbook-verify-gate.md.`
+                : `Inspect the remaining deliveries above. Either scope missing issues, cancel ` +
+                    `the deliveries that should not proceed, or update the focus intent so the ` +
+                    `next team can complete the work.`,
+        }), { maxAttempts: 3, label: `escalation-no-progress-${params.focusId}` });
+        console.log(`[focus-executor] Created ${escalationKind} escalation for "${params.focusName}" ` +
+            `(reason: ${NO_PROGRESS_ESCALATION_REASON})`);
+    }
+    catch (err) {
+        console.error(`[focus-executor] Failed to create no-progress escalation for "${params.focusName}": ${err.message}`);
+    }
+}
+/**
+ * Escalate when the team has no actionable work AND a remaining non-terminal
+ * delivery is structurally non-advanceable (NULL workflow stage, or no
+ * automatic transition out of its current stage). This is the thrash-guard:
+ * without it the focus respawns a team every poll that immediately idle-exits,
+ * burning budget unbounded.
+ *
+ * Filed as escalation_kind 'team_failure' so the existing respawn guard
+ * (hasOpenTeamFailureEscalation / applyRespawnGuard) suppresses respawn until a
+ * human resolves it. metadata.cause = NON_ADVANCEABLE_CAUSE distinguishes it
+ * from an effort-based no-progress failure during triage.
+ *
+ * Exported so tests and sister deliveries can verify the contract.
+ */
+export async function escalateNonAdvanceable(params, deps = defaultEscalationDeps) {
+    const { stuck } = params;
+    const remainingList = params.remaining
+        .slice()
+        .sort((a, b) => a.priorityRank - b.priorityRank)
+        .map(d => `- "${d.name}" [${d.executionStatus ?? 'draft'}] (rank ${d.priorityRank}, stage ${d.currentWorkflowStageId ?? 'NULL'})`)
+        .join('\n');
+    const stageDesc = stuck.currentWorkflowStageId
+        ? `its current workflow stage (${stuck.currentWorkflowStageId}) has no automatic transition out`
+        : 'it has no resolved workflow stage (current_workflow_stage_id is NULL)';
+    const metadata = {
+        focusId: params.focusId,
+        focusName: params.focusName,
+        cause: NON_ADVANCEABLE_CAUSE,
+        stuckDeliveryId: stuck.id,
+        stuckDeliveryName: stuck.name,
+        stuckDeliveryStatus: stuck.executionStatus,
+        stuckDeliveryStageId: stuck.currentWorkflowStageId,
+    };
+    const description = `Team for focus "${params.focusName}" terminated because delivery "${stuck.name}" ` +
+        `[${stuck.executionStatus ?? 'draft'}] cannot be advanced: ${stageDesc}, and the team ` +
+        `has no actionable work. Reason: ${NON_ADVANCEABLE_ESCALATION_REASON}.\n\n` +
+        `Left unhandled this loops: the listener re-spawns a team every poll, the team ` +
+        `immediately idle-exits with nothing to do, and the delivery never moves -- burning ` +
+        `budget with no progress.\n\n` +
+        `**Focus:** ${params.focusName}\n` +
+        `**Focus ID:** ${params.focusId}\n` +
+        `**Agent role:** ${params.agentRoleId}\n` +
+        `**Stuck delivery:** "${stuck.name}" (${stuck.id})\n` +
+        `**Remaining non-terminal deliveries:**\n${remainingList}\n\n` +
+        `The team has been terminated and the focus will not be respawned while this ` +
+        `escalation stays open. A human must either give the delivery a workflow stage with ` +
+        `an automatic transition, cancel it, or otherwise unblock the focus.`;
+    try {
+        await withRetry(() => deps.createEscalation({
+            organizationId: params.organizationId,
+            sessionId: params.sessionId,
+            issueId: null,
+            reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+            escalationKind: 'team_failure',
+            metadata,
+            description,
+            whatWasTried: `Spawned a team for "${params.focusName}"; it found no actionable work, and the ` +
+                `daemon could not advance the remaining non-terminal delivery "${stuck.name}" ` +
+                `(${stageDesc}).`,
+            helpNeeded: `Give delivery "${stuck.name}" a workflow stage with an automatic transition out ` +
+                `(or re-anchor it to the correct workflow), cancel it if it should not proceed, or ` +
+                `update the focus so the next team can complete the work.`,
+        }), { maxAttempts: 3, label: `escalation-non-advanceable-${params.focusId}` });
+        console.log(`[focus-executor] Created non-advanceable (team_failure) escalation for "${params.focusName}" ` +
+            `(cause: ${NON_ADVANCEABLE_CAUSE}, delivery: "${stuck.name}")`);
+    }
+    catch (err) {
+        console.error(`[focus-executor] Failed to create non-advanceable escalation for "${params.focusName}": ${err.message}`);
+    }
+}
+//# sourceMappingURL=event-escalations.js.map

package/dist/completion/event-escalations.js.map

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

package/dist/completion/event.d.ts

@@ -8,27 +8,7 @@
 import type { ChildProcess } from 'node:child_process';
 import type { DaemonConfig, FocusTeamState, FocusDeliveryInfo, FocusIssueInfo, ProgressSnapshot, Workflow } from '../types.js';
 import { CompletionDetector, type CompletionInfo } from './detector.js';
-/** Reason string emitted when a planning team produces no deliveries. */
-export declare const PLANNING_NO_DELIVERIES_REASON = "planning produced no deliveries";
-/** Reason string emitted when re-engagement is bounded by no-progress limit. */
-export declare const NO_PROGRESS_ESCALATION_REASON = "team unable to make progress on remaining deliveries";
-/**
- * Reason string emitted when the team has no actionable work AND a remaining
- * non-terminal delivery cannot be advanced by the daemon either -- a structural
- * dead end (missing workflow stage / no automatic transition out). Filed once,
- * never re-fired, so the focus stops thrashing spawn->idle-exit->respawn.
- */
-export declare const NON_ADVANCEABLE_ESCALATION_REASON = "delivery cannot be advanced and the team has no actionable work";
-/**
- * Cause discriminator stamped on the escalation metadata. The escalation_kind
- * stays 'team_failure' (a value the agent_escalations CHECK constraint already
- * accepts AND that the existing respawn guard -- hasOpenTeamFailureEscalation /
- * applyRespawnGuard -- already suppresses), so no migration is required and
- * respawn suppression composes for free. metadata.cause distinguishes this
- * structural dead-end from a genuine effort-based no-progress failure during
- * triage.
- */
-export declare const NON_ADVANCEABLE_CAUSE = "non_advanceable_delivery";
+export { PLANNING_NO_DELIVERIES_REASON, NO_PROGRESS_ESCALATION_REASON, NON_ADVANCEABLE_ESCALATION_REASON, NON_ADVANCEABLE_CAUSE, type EscalationDeps, escalatePlanningFailure, escalateNoProgress, escalateNonAdvanceable, } from './event-escalations.js';
 /**
  * Maximum consecutive re-engagement cycles with no measurable progress before
  * the scope-coverage guard escalates. Configurable via env so operators can
@@ -113,19 +93,6 @@ export interface CompletionEventDeps {
  * exported for direct unit testing.
  */
 export declare function isInReviewWindow(reviewRequestedAt: string | null, deliveries: FocusDeliveryInfo[]): boolean;
-/**
- * Escalate when a planning team finishes its initial turn without writing
- * any deliveries via MCP. The team is then terminated -- no respawn.
- *
- * Exported so tests and sister deliveries can verify the contract.
- */
-export declare function escalatePlanningFailure(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-}, deps?: Pick<CompletionEventDeps, 'createEscalation'>): Promise<void>;
 /**
  * A delivery is *non-advanceable* when neither the team nor the daemon can move
  * it forward. The check must mirror how the daemon ACTUALLY advances deliveries,
@@ -190,42 +157,4 @@ export declare function takeProgressSnapshot(deliveries: Pick<FocusDeliveryInfo,
 }[]): ProgressSnapshot;
 /** True when two snapshots have identical delivery statuses and issue count. */
 export declare function snapshotsEqual(a: ProgressSnapshot, b: ProgressSnapshot): boolean;
-/**
- * Escalate when the team has been re-engaged repeatedly without making
- * any measurable progress on the remaining non-terminal deliveries.
- *
- * Exported so tests can verify the contract.
- */
-export declare function escalateNoProgress(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-    cycles: number;
-    remaining: FocusDeliveryInfo[];
-}, deps?: Pick<CompletionEventDeps, 'createEscalation'>): Promise<void>;
-/**
- * Escalate when the team has no actionable work AND a remaining non-terminal
- * delivery is structurally non-advanceable (NULL workflow stage, or no
- * automatic transition out of its current stage). This is the thrash-guard:
- * without it the focus respawns a team every poll that immediately idle-exits,
- * burning budget unbounded.
- *
- * Filed as escalation_kind 'team_failure' so the existing respawn guard
- * (hasOpenTeamFailureEscalation / applyRespawnGuard) suppresses respawn until a
- * human resolves it. metadata.cause = NON_ADVANCEABLE_CAUSE distinguishes it
- * from an effort-based no-progress failure during triage.
- *
- * Exported so tests and sister deliveries can verify the contract.
- */
-export declare function escalateNonAdvanceable(params: {
-    organizationId: string;
-    sessionId: string;
-    focusId: string;
-    focusName: string;
-    agentRoleId: string;
-    stuck: FocusDeliveryInfo;
-    remaining: FocusDeliveryInfo[];
-}, deps?: Pick<CompletionEventDeps, 'createEscalation'>): Promise<void>;
 //# sourceMappingURL=event.d.ts.map

package/dist/completion/event.d.ts.map

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