@telora/daemon 0.15.2 → 0.15.4

package/dist/focus-completion-event.js

@@ -0,0 +1,257 @@
+/**
+ * Focus completion event handler - reacts to CompletionDetector events.
+ *
+ * Extracted from focus-executor.ts. Handles the decision logic when a
+ * team lead completes a work cycle: terminate if done, send more work, or
+ * (for planning teams) refresh from MCP-written deliveries / escalate.
+ */
+import { sendMessage, withRetry, ESCALATION_REASONS } from '@telora/daemon-core';
+import { isStatusCascadable, isStatusAgentActionable } from './stage-classifier.js';
+import { getFocusDeliveries, getFocusIssues } from './queries/focuses.js';
+import { buildWakeMessage, buildReEngagementMessage } from './focus-prompt-builder.js';
+import { OPEN_ISSUE_STATUSES } from './constants.js';
+import { terminateTeam as defaultTerminateTeam } from './focus-team-lifecycle.js';
+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';
+/**
+ * Maximum consecutive re-engagement cycles with no measurable progress before
+ * the scope-coverage guard escalates. Configurable via env so operators can
+ * relax or tighten the bound without a code change.
+ */
+export const SCOPE_COVERAGE_NO_PROGRESS_LIMIT = (() => {
+    const raw = process.env.TELORA_SCOPE_COVERAGE_NO_PROGRESS_LIMIT;
+    if (!raw)
+        return 3;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 3;
+})();
+const defaultDeps = {
+    getFocusDeliveries,
+    getFocusIssues,
+    createEscalation: defaultCreateEscalation,
+    terminateTeam: defaultTerminateTeam,
+};
+/**
+ * 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 = defaultDeps) {
+    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}`);
+    }
+}
+// ── Handler ─────────────────────────────────────────────────────────────
+/**
+ * Handle a 'complete' event from the CompletionDetector.
+ *
+ * Queries current delivery and issue state to decide whether to:
+ * - Terminate the team (all deliveries terminal or no open issues remain), or
+ * - Send a mid-focus handoff message with remaining work.
+ *
+ * Extracted from the inline event callback in spawnFocusTeam to eliminate
+ * deep nesting inside an async Promise chain inside an event listener.
+ */
+export async function handleCompletionEvent(ctx, deps = defaultDeps) {
+    const { focusId, focusName, teamState, completionDetector, proc } = ctx;
+    const [currentDeliveries, currentIssues] = await Promise.all([
+        deps.getFocusDeliveries(focusId),
+        deps.getFocusIssues(focusId),
+    ]);
+    // Wake-cycle refresh (Option A): planning teams spawn with knownDeliveryIds
+    // empty. The MCP-driven planning turn writes deliveries to the DB, so we
+    // re-snapshot them here before any downstream merge/completion logic looks
+    // at the set. WHY Option A: keeps the refresh on the existing wake path
+    // instead of polling, so it runs exactly when new deliveries become visible.
+    if (teamState.planningPhase) {
+        if (currentDeliveries.length === 0) {
+            console.warn(`[focus-executor] Planning team for "${focusName}" produced no deliveries ` +
+                `-- escalating and terminating`);
+            await escalatePlanningFailure({
+                organizationId: teamState.organizationId,
+                sessionId: teamState.leadSessionId ?? '',
+                focusId,
+                focusName,
+                agentRoleId: teamState.roleId,
+            }, deps);
+            teamState.shutdownReason = 'work_complete';
+            deps.terminateTeam(focusId);
+            return;
+        }
+        for (const d of currentDeliveries) {
+            teamState.knownDeliveryIds.add(d.id);
+            teamState.deliveryStageIds.set(d.id, d.currentWorkflowStageId);
+        }
+        teamState.planningPhase = false;
+        console.log(`[focus-executor] Planning refresh for "${focusName}": ` +
+            `${currentDeliveries.length} delivery(ies) discovered`);
+    }
+    // Scope-coverage guard: only terminate when EVERY delivery is in a
+    // terminal-for-the-team state (verify, in_review, done, cancelled). The
+    // existing isStatusCascadable() classifier matches that set; non-terminal
+    // states (planning, queued, iterating, coding, paused) block termination
+    // so the team is re-engaged on remaining work instead of idle-quitting
+    // while unfinished deliveries are still in flight.
+    const nonTerminal = currentDeliveries.filter(d => !isStatusCascadable(d.executionStatus ?? ''));
+    if (nonTerminal.length === 0) {
+        console.log(`[focus-executor] All deliveries terminal for "${focusName}" -- terminating team`);
+        teamState.shutdownReason = 'work_complete';
+        deps.terminateTeam(focusId);
+        return;
+    }
+    // Capture the current snapshot for progress detection. Treat both null
+    // and undefined as "no prior snapshot" -- legacy test fixtures may not set
+    // the field, and a fresh team has lastProgressSnapshot=null.
+    const snapshot = takeProgressSnapshot(currentDeliveries, currentIssues);
+    const priorSnapshot = teamState.lastProgressSnapshot ?? null;
+    const madeProgress = priorSnapshot === null
+        ? true
+        : !snapshotsEqual(priorSnapshot, snapshot);
+    if (madeProgress) {
+        teamState.noProgressCycles = 0;
+    }
+    else {
+        teamState.noProgressCycles = (teamState.noProgressCycles ?? 0) + 1;
+    }
+    teamState.lastProgressSnapshot = snapshot;
+    // If we have crossed the no-progress threshold, escalate and shut the
+    // team down so a human can intervene. This prevents an infinite loop of
+    // "re-engage -> no-op -> re-engage" while the team is stuck.
+    if (teamState.noProgressCycles >= SCOPE_COVERAGE_NO_PROGRESS_LIMIT) {
+        console.warn(`[focus-executor] Scope-coverage guard tripped for "${focusName}" -- ` +
+            `${teamState.noProgressCycles} consecutive cycles with no progress on ${nonTerminal.length} ` +
+            `non-terminal delivery(ies); escalating and terminating`);
+        await escalateNoProgress({
+            organizationId: teamState.organizationId,
+            sessionId: teamState.leadSessionId ?? '',
+            focusId,
+            focusName,
+            agentRoleId: teamState.roleId,
+            cycles: teamState.noProgressCycles,
+            remaining: nonTerminal,
+        }, deps);
+        teamState.shutdownReason = 'work_complete';
+        deps.terminateTeam(focusId);
+        return;
+    }
+    // If actionable deliveries with open issues remain, the existing wake
+    // message handles them. Otherwise the team needs a re-engagement nudge
+    // for non-actionable but still non-terminal deliveries (planning,
+    // iterating).
+    const actionableDeliveryIds = new Set(currentDeliveries
+        .filter(d => isStatusAgentActionable(d.executionStatus ?? ''))
+        .map(d => d.id));
+    const hasActionableWithOpenIssues = currentIssues.some(i => actionableDeliveryIds.has(i.deliveryId) && OPEN_ISSUE_STATUSES.has(i.status));
+    let message;
+    if (actionableDeliveryIds.size > 0 && hasActionableWithOpenIssues) {
+        console.log(`[focus-executor] Mid-focus handoff for "${focusName}" -- sending new work`);
+        message = buildWakeMessage(currentDeliveries, currentIssues, teamState.knownDeliveryIds);
+    }
+    else {
+        console.log(`[focus-executor] Re-engaging "${focusName}" -- ${nonTerminal.length} non-terminal ` +
+            `delivery(ies) remain (cycle ${teamState.noProgressCycles}/${SCOPE_COVERAGE_NO_PROGRESS_LIMIT})`);
+        message = buildReEngagementMessage(nonTerminal, currentIssues);
+    }
+    // Update tracking state
+    for (const d of currentDeliveries) {
+        teamState.knownDeliveryIds.add(d.id);
+        teamState.deliveryStageIds.set(d.id, d.currentWorkflowStageId);
+    }
+    completionDetector.reset();
+    sendMessage(proc.stdin, message);
+}
+// ── Progress snapshot helpers ───────────────────────────────────────────
+/**
+ * Build a progress snapshot from the current focus state.
+ *
+ * Captures the two values that must change for the team to be making
+ * progress: each delivery's execution_status and the total issue count.
+ */
+export function takeProgressSnapshot(deliveries, issues) {
+    const deliveryStatuses = {};
+    for (const d of deliveries) {
+        deliveryStatuses[d.id] = d.executionStatus ?? '';
+    }
+    return {
+        deliveryStatuses,
+        totalIssueCount: issues.length,
+    };
+}
+/** True when two snapshots have identical delivery statuses and issue count. */
+export function snapshotsEqual(a, b) {
+    if (a.totalIssueCount !== b.totalIssueCount)
+        return false;
+    const aKeys = Object.keys(a.deliveryStatuses);
+    const bKeys = Object.keys(b.deliveryStatuses);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const key of aKeys) {
+        if (a.deliveryStatuses[key] !== b.deliveryStatuses[key])
+            return false;
+    }
+    return true;
+}
+// ── Escalation ──────────────────────────────────────────────────────────
+/**
+ * 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 = defaultDeps) {
+    const remainingList = params.remaining
+        .slice()
+        .sort((a, b) => a.priorityRank - b.priorityRank)
+        .map(d => `- "${d.name}" [${d.executionStatus ?? 'draft'}] (rank ${d.priorityRank})`)
+        .join('\n');
+    try {
+        await withRetry(() => deps.createEscalation({
+            organizationId: params.organizationId,
+            sessionId: params.sessionId,
+            issueId: null,
+            reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+            description: `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.`,
+            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: `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 no-progress 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}`);
+    }
+}
+//# sourceMappingURL=focus-completion-event.js.map

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

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

package/dist/{strategy-completion.d.ts → focus-completion.d.ts}

@@ -1,15 +1,15 @@
 /**
- * Strategy team completion handling.
+ * Focus team completion handling.
  *
  * Manages the post-execution lifecycle: advancing delivery statuses
- * based on issue completion, merging the strategy branch, cleaning up
+ * based on issue completion, merging the focus branch, cleaning up
  * worktrees, and updating session records.
  */
-import type { DaemonConfig, StrategyTeamState, StrategyDeliveryInfo, Workflow, PolicyFailureMode } from './types.js';
+import type { DaemonConfig, FocusTeamState, FocusDeliveryInfo, Workflow, PolicyFailureMode } from './types.js';
 import type { StageAdvanceResult } from './delivery-lifecycle.js';
 export { isStatusTerminal, isStatusAgentActionable } from './stage-classifier.js';
 /**
- * Decide whether to attempt mergeStrategyBranch on team exit.
+ * Decide whether to attempt mergeFocusBranch on team exit.
  *
  * Skip merge when:
  * - The team did not succeed (failed exit or unclean shutdown), OR
@@ -18,10 +18,10 @@ export { isStatusTerminal, isStatusAgentActionable } from './stage-classifier.js
  *
  * Exported for unit testing the gate logic in isolation.
  */
-export declare function shouldAttemptMerge(succeeded: boolean, teamState: Pick<StrategyTeamState, 'planningPhase'>): boolean;
+export declare function shouldAttemptMerge(succeeded: boolean, teamState: Pick<FocusTeamState, 'planningPhase'>): boolean;
 export interface TeamCompletionParams {
     config: DaemonConfig;
-    teamState: StrategyTeamState;
+    teamState: FocusTeamState;
     sessionId: string;
     code: number | null;
     signal: string | null;
@@ -32,7 +32,7 @@ export interface TeamCompletionParams {
  * Responsibilities:
  * - Report git state for all known deliveries
  * - Advance delivery statuses based on issue completion
- * - Merge strategy branch to integration (if successful)
+ * - Merge focus branch to integration (if successful)
  * - Clean up worktree
  * - Update session record
  * - Record heartbeat counters
@@ -44,7 +44,7 @@ export declare function handleTeamCompletion(params: TeamCompletionParams): Prom
  * Defaults to real implementations; overridable in tests.
  */
 export interface AdvanceDeliveryDeps {
-    getStrategyDeliveries: (strategyId: string) => Promise<StrategyDeliveryInfo[]>;
+    getFocusDeliveries: (focusId: string) => Promise<FocusDeliveryInfo[]>;
     getDeliveryIssues: (deliveryId: string) => Promise<Array<{
         id: string;
         title: string;
@@ -71,7 +71,7 @@ export interface AdvanceDeliveryDeps {
 /**
  * Advance delivery statuses after team completion.
  *
- * Re-queries all deliveries for the strategy from the database rather
+ * Re-queries all deliveries for the focus from the database rather
  * than relying on the spawn-time snapshot in teamState.knownDeliveryIds.
  * This ensures deliveries added mid-flight (after the team was spawned)
  * are discovered and advanced, and that stale deliveryStageIds don't
@@ -81,5 +81,5 @@ export interface AdvanceDeliveryDeps {
  * - All issues Done (or no issues): advance via workflow (coding -> verify -> done)
  * - Open issues remain: re-queue to 'queued' so the next team session picks it up
  */
-export declare function advanceDeliveryStatuses(config: DaemonConfig, teamState: StrategyTeamState, sessionId: string, deps?: AdvanceDeliveryDeps): Promise<void>;
-//# sourceMappingURL=strategy-completion.d.ts.map
+export declare function advanceDeliveryStatuses(config: DaemonConfig, teamState: FocusTeamState, sessionId: string, deps?: AdvanceDeliveryDeps): Promise<void>;
+//# sourceMappingURL=focus-completion.d.ts.map

package/dist/focus-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-completion.d.ts","sourceRoot":"","sources":["../src/focus-completion.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAcpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAelE,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIlF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAC/C,OAAO,CAET;AAID,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2TtF;AAID;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACtE,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC5H,uBAAuB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,sBAAsB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7H,oBAAoB,EAAE,CAAC,MAAM,EAAE;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,QAAQ,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACnC;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,mBAAiC,GACtC,OAAO,CAAC,IAAI,CAAC,CAkHf"}