@telora/daemon 0.15.1 → 0.15.3

package/dist/review-defect-detector.js

@@ -0,0 +1,289 @@
+/**
+ * Review-defect re-engagement loop.
+ *
+ * The review subsystem (review_requested_at + review session_type) audits
+ * completed work and files defects. Without this module, defects sit
+ * indefinitely in `in_review` because nothing drives them to resolution.
+ *
+ * This module closes that quality loop:
+ *   * Detector -- finds strategies in `in_review` with open issues filed
+ *     during the most recent review pass, and transitions them back to
+ *     `building` so the executor spawns a remediation team.
+ *   * Re-entry -- when all review-filed issues for a focus are Done
+ *     (and the focus is back in `building`), transitions the focus
+ *     to `verify` so the existing review subsystem can pass it through to
+ *     `in_review` for a fresh review pass.
+ *   * Bound -- tracks per-focus remediation cycle count. After N
+ *     consecutive cycles, escalates to humans via `agent_escalations`.
+ *
+ * Identifying review-filed issues:
+ *   We use `created_by_role_id` (filters out human/UI-filed issues, which
+ *   leave the column NULL) AND timing -- the issue was created after the
+ *   focus's most recent `review_requested_at` while in `in_review`. A
+ *   single role is often shared across team and review sessions, so role
+ *   alone is insufficient; the timing-plus-focus-status combination is
+ *   what reliably identifies "filed during a review pass".
+ */
+import { withRetry, ESCALATION_REASONS } from '@telora/daemon-core';
+import { getActiveFocuses } from './supabase.js';
+import { getFocusDeliveries, getFocusIssues, updateFocusStatus, fetchFocusWorkflowWithTransitions, } from './queries/focuses.js';
+import { createEscalation as defaultCreateEscalation } from './queries/issues.js';
+import { OPEN_ISSUE_STATUSES } from './constants.js';
+// ── Configuration ────────────────────────────────────────────────────────
+/** Reason string emitted when remediation cycles exceed the bound. */
+export const REVIEW_REMEDIATION_ESCALATION_REASON = 'review-defect remediation exceeded N cycles';
+/** Default cap on remediation cycles before escalation. Configurable via env. */
+export const REVIEW_REMEDIATION_LIMIT = (() => {
+    const raw = process.env.TELORA_REVIEW_REMEDIATION_LIMIT;
+    if (!raw)
+        return 3;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 3;
+})();
+// ── Per-focus cycle counter ──────────────────────────────────────────
+/**
+ * In-memory map of focus ID -> consecutive remediation cycles. Cycle
+ * counts are not persisted to the database -- a daemon restart resets the
+ * counter, which is acceptable because the bound exists to prevent runaway
+ * loops within a single daemon lifetime, not across restarts.
+ *
+ * Exported for testability.
+ */
+const remediationCycles = new Map();
+export function getRemediationCycles(focusId) {
+    return remediationCycles.get(focusId) ?? 0;
+}
+export function incrementRemediationCycles(focusId) {
+    const next = (remediationCycles.get(focusId) ?? 0) + 1;
+    remediationCycles.set(focusId, next);
+    return next;
+}
+export function resetRemediationCycles(focusId) {
+    remediationCycles.delete(focusId);
+}
+/** Test-only: clear all cycle state. */
+export function _resetAllRemediationCyclesForTest() {
+    remediationCycles.clear();
+}
+// ── Issue classification ────────────────────────────────────────────────
+/**
+ * Returns true when an issue was filed during the most recent review pass
+ * on the given focus.
+ *
+ * An issue is "review-filed" when ALL of:
+ *   - It has a non-null created_by_role_id (excludes human/UI creates).
+ *   - Its created_at is later than the focus's review_requested_at
+ *     (or the focus is in `in_review` with no recorded request time --
+ *     covers manual review trigger).
+ *   - Its status is open (To Do / In Progress / Blocked).
+ */
+export function isReviewFiledIssue(issue, reviewRequestedAt) {
+    if (!issue.createdByRoleId)
+        return false;
+    if (!OPEN_ISSUE_STATUSES.has(issue.status))
+        return false;
+    if (!reviewRequestedAt) {
+        // No review timestamp -- conservative: do not treat as review-filed.
+        return false;
+    }
+    if (!issue.createdAt)
+        return false;
+    return new Date(issue.createdAt).getTime() >= new Date(reviewRequestedAt).getTime();
+}
+/**
+ * Filter a focus's issues to only those that were filed during the most
+ * recent review pass and are still open. Used to drive both the detector
+ * (transition to building) and the re-entry check (return to in_review when
+ * all are Done).
+ */
+export function filterReviewFiledIssues(issues, reviewRequestedAt) {
+    return issues.filter(i => isReviewFiledIssue(i, reviewRequestedAt));
+}
+/**
+ * Returns true when there are any review-filed issues (open or closed)
+ * since the most recent review pass. Used by the re-entry check: if there
+ * were review-filed issues AND all of them are Done, the focus is
+ * eligible to return to in_review.
+ */
+export function reviewFiledIssueExists(issues, reviewRequestedAt) {
+    if (!reviewRequestedAt)
+        return false;
+    for (const i of issues) {
+        if (!i.createdByRoleId)
+            continue;
+        if (!i.createdAt)
+            continue;
+        if (new Date(i.createdAt).getTime() >= new Date(reviewRequestedAt).getTime()) {
+            return true;
+        }
+    }
+    return false;
+}
+const defaultDeps = {
+    getActiveFocuses,
+    getFocusDeliveries,
+    getFocusIssues,
+    updateFocusStatus,
+    fetchFocusWorkflowWithTransitions,
+    createEscalation: defaultCreateEscalation,
+};
+// ── Detector and re-entry ───────────────────────────────────────────────
+/**
+ * For each active focus in `in_review` status, check whether any
+ * review-filed issues remain open. If so, transition the focus back to
+ * `building` and bump the remediation counter. When the counter exceeds
+ * the bound, escalate instead of transitioning -- the team has been
+ * stuck in a remediation loop and a human needs to intervene.
+ *
+ * Designed to be called from the daemon poll loop on every tick; it is
+ * a no-op for strategies that don't satisfy the trigger conditions.
+ */
+export async function detectAndHandleReviewDefects(config, deps = defaultDeps) {
+    let strategies;
+    try {
+        strategies = await deps.getActiveFocuses(config.organizationId, config.productId);
+    }
+    catch (err) {
+        console.warn('[review-defect-detector] Failed to fetch active strategies:', err.message);
+        return;
+    }
+    for (const s of strategies) {
+        if (s.status !== 'in_review')
+            continue;
+        try {
+            const issues = await deps.getFocusIssues(s.focus_id);
+            const reviewOpen = filterReviewFiledIssues(issues, s.review_requested_at ?? null);
+            if (reviewOpen.length === 0)
+                continue;
+            const cycles = incrementRemediationCycles(s.focus_id);
+            if (cycles > REVIEW_REMEDIATION_LIMIT) {
+                console.warn(`[review-defect-detector] Remediation bound exceeded for "${s.focus_name}" ` +
+                    `(cycle ${cycles}/${REVIEW_REMEDIATION_LIMIT}); escalating`);
+                await escalateReviewRemediation({
+                    organizationId: config.organizationId,
+                    focusId: s.focus_id,
+                    focusName: s.focus_name,
+                    cycles,
+                    openIssues: reviewOpen,
+                }, deps);
+                // Reset so a future review pass starts fresh after human intervention.
+                resetRemediationCycles(s.focus_id);
+                continue;
+            }
+            // Transition the focus from in_review back to building so the
+            // focus executor's poll loop spawns a remediation team.
+            const workflow = await deps.fetchFocusWorkflowWithTransitions(s.focus_id);
+            const buildingStage = workflow.stages.find(st => st.name === 'building');
+            try {
+                await deps.updateFocusStatus(s.focus_id, 'building', buildingStage?.id ?? null);
+                console.log(`[review-defect-detector] Focus "${s.focus_name}" -> building ` +
+                    `(${reviewOpen.length} review-filed issue(s) open, remediation cycle ${cycles}/${REVIEW_REMEDIATION_LIMIT})`);
+            }
+            catch (err) {
+                console.warn(`[review-defect-detector] Failed to move "${s.focus_name}" to building: ${err.message}`);
+            }
+        }
+        catch (err) {
+            console.warn(`[review-defect-detector] Error checking focus "${s.focus_name}":`, err.message);
+        }
+    }
+}
+/**
+ * For each active focus in `building` status that has had a review pass
+ * (review_requested_at set) and review-filed issues since, check whether
+ * all of those issues are now Done. If so, transition the focus back to
+ * `verify` so the existing review pipeline can re-run and either close it
+ * out or file new defects.
+ *
+ * Called alongside the detector; safe to invoke on every poll tick.
+ */
+export async function detectAndHandleRemediationComplete(config, deps = defaultDeps) {
+    let strategies;
+    try {
+        strategies = await deps.getActiveFocuses(config.organizationId, config.productId);
+    }
+    catch (err) {
+        console.warn('[review-defect-detector] Failed to fetch active strategies:', err.message);
+        return;
+    }
+    for (const s of strategies) {
+        // Only act on strategies that were just remediating: status='building'
+        // with a recorded review request.
+        if (s.status !== 'building')
+            continue;
+        if (!s.review_requested_at)
+            continue;
+        try {
+            const issues = await deps.getFocusIssues(s.focus_id);
+            const allReviewFiled = issues.filter(i => i.createdByRoleId && i.createdAt &&
+                new Date(i.createdAt).getTime() >= new Date(s.review_requested_at).getTime());
+            if (allReviewFiled.length === 0)
+                continue; // no remediation in progress
+            const stillOpen = allReviewFiled.filter(i => OPEN_ISSUE_STATUSES.has(i.status));
+            if (stillOpen.length > 0)
+                continue; // still remediating
+            // All review-filed issues are Done -- transition to verify so the
+            // review pipeline re-runs.
+            const workflow = await deps.fetchFocusWorkflowWithTransitions(s.focus_id);
+            const verifyStage = workflow.stages.find(st => st.name === 'verify');
+            await deps.updateFocusStatus(s.focus_id, 'verify', verifyStage?.id ?? null);
+            console.log(`[review-defect-detector] Focus "${s.focus_name}" -> verify ` +
+                `(${allReviewFiled.length} review-filed issue(s) all Done, remediation cycle complete)`);
+        }
+        catch (err) {
+            console.warn(`[review-defect-detector] Error checking remediation completion for "${s.focus_name}":`, err.message);
+        }
+    }
+}
+/**
+ * Escalate when remediation cycles exceed the configured bound. Surfaces
+ * the issue list and a clear call to action so the human reviewer can
+ * unblock the loop.
+ */
+export async function escalateReviewRemediation(params, deps = defaultDeps) {
+    const issueList = params.openIssues
+        .slice(0, 25)
+        .map(i => `- [${i.status}] ${i.key}: ${i.title}`)
+        .join('\n');
+    const overflow = params.openIssues.length > 25
+        ? `\n(... and ${params.openIssues.length - 25} more)`
+        : '';
+    try {
+        await withRetry(() => deps.createEscalation({
+            organizationId: params.organizationId,
+            sessionId: '',
+            issueId: null,
+            reasonType: ESCALATION_REASONS.BLOCKED_BY_EXTERNAL,
+            description: `Focus "${params.focusName}" has cycled through review-defect remediation ` +
+                `${params.cycles} time(s). Reason: ${REVIEW_REMEDIATION_ESCALATION_REASON}.\n\n` +
+                `**Focus:** ${params.focusName}\n` +
+                `**Focus ID:** ${params.focusId}\n` +
+                `**Cycles:** ${params.cycles} (limit: ${REVIEW_REMEDIATION_LIMIT})\n\n` +
+                `**Open review-filed issues (${params.openIssues.length}):**\n${issueList}${overflow}`,
+            whatWasTried: `The daemon respawned remediation teams ${params.cycles} time(s) and the team ` +
+                `was unable to close all review-filed defects between review passes.`,
+            helpNeeded: `Review the open issues above. Either close out genuinely-blocked items, ` +
+                `clarify acceptance criteria so the next remediation cycle can succeed, or ` +
+                `cancel the focus if it is no longer viable.`,
+        }), { maxAttempts: 3, label: `escalation-review-remediation-${params.focusId}` });
+        console.log(`[review-defect-detector] Created remediation escalation for "${params.focusName}" ` +
+            `(reason: ${REVIEW_REMEDIATION_ESCALATION_REASON})`);
+    }
+    catch (err) {
+        console.error(`[review-defect-detector] Failed to create remediation escalation for "${params.focusName}": ${err.message}`);
+    }
+}
+/**
+ * Combined entry point: call both halves of the loop on each poll tick.
+ *
+ * Order matters slightly: handle remediation completion first (returns
+ * Done strategies to verify) before the defect detector (kicks fresh
+ * defects to building). Doing it in this order means a focus can flow
+ * verify -> in_review -> building -> verify in a single cycle when work
+ * is fast.
+ */
+export async function tickReviewDefectLoop(config, deps = defaultDeps) {
+    await detectAndHandleRemediationComplete(config, deps);
+    await detectAndHandleReviewDefects(config, deps);
+}
+//# sourceMappingURL=review-defect-detector.js.map

package/dist/review-defect-detector.js.map

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

package/dist/session-lifecycle.d.ts

@@ -1,23 +1,23 @@
 /**
- * Session lifecycle management for strategy teams.
+ * Session lifecycle management for focus teams.
  *
- * Extracted from strategy-executor.ts. Contains functions for session
+ * Extracted from focus-executor.ts. Contains functions for session
  * start/end, cleanup, error handling, team completion detection,
  * termination, and deactivation checks.
  */
 import type { ChildProcess } from 'node:child_process';
-import type { DaemonConfig, StrategyTeamState } from './types.js';
+import type { DaemonConfig, FocusTeamState } from './types.js';
 import type { CompletionDetector } from './completion-detector.js';
 import type { ActivityTracker } from './activity-tracker.js';
-import type { SpawnStrategyTeamParams } from './team-spawner.js';
+import type { SpawnFocusTeamParams } from './team-spawner.js';
 import type { LogStreams } from './types.js';
 export interface SessionLifecycleContext {
     proc: ChildProcess;
-    params: SpawnStrategyTeamParams;
-    teamState: StrategyTeamState;
+    params: SpawnFocusTeamParams;
+    teamState: FocusTeamState;
     sessionId: string;
-    strategyId: string;
-    strategyName: string;
+    focusId: string;
+    focusName: string;
     completionDetector: CompletionDetector;
     activityTracker: ActivityTracker;
     logStreams: LogStreams;
@@ -34,36 +34,36 @@ export interface SessionLifecycleContext {
  */
 export declare function attachSessionLifecycle(ctx: SessionLifecycleContext): void;
 /**
- * Terminate a strategy team.
+ * Terminate a focus team.
  *
  * Sends a deactivation message via stdin (if open) before SIGTERM
  * to allow the team lead to process the shutdown gracefully.
  */
-export declare function terminateTeam(strategyId: string): boolean;
+export declare function terminateTeam(focusId: string): boolean;
 /**
  * Wait for a team's process to exit (leave activeTeams).
  *
- * Polls activeTeams until the strategy is no longer present,
+ * Polls activeTeams until the focus is no longer present,
  * which happens when handleTeamCompletion runs on the 'close' event.
  * If the timeout expires, sends SIGKILL and waits briefly.
  *
- * @param strategyId - Strategy to wait for
+ * @param focusId - Focus to wait for
  * @param timeoutMs - Max wait time in ms (default 30s)
  * @returns true if team exited within timeout, false if forced
  */
-export declare function waitForTeamExit(strategyId: string, timeoutMs?: number): Promise<boolean>;
+export declare function waitForTeamExit(focusId: string, timeoutMs?: number): Promise<boolean>;
 /**
  * Terminate all active teams.
  */
 export declare function terminateAllTeams(): void;
 /**
- * Detect strategies that have been deactivated (agent role removed)
+ * Detect focuses that have been deactivated (agent role removed)
  * and shut down their active teams.
  */
-export declare function detectDeactivatedStrategies(config: DaemonConfig): Promise<void>;
+export declare function detectDeactivatedFocuses(config: DaemonConfig): Promise<void>;
 /**
  * Check active teams for newly completed deliveries and merge
- * the strategy branch to integration incrementally.
+ * the focus branch to integration incrementally.
  *
  * Called from the poll loop. For each active team, queries delivery
  * statuses and triggers a merge when any delivery reaches verify/done
@@ -71,7 +71,7 @@ export declare function detectDeactivatedStrategies(config: DaemonConfig): Promi
  *
  * After processing merges, checks if ALL active deliveries are terminal
  * and merged. If so, terminates the team proactively since no more work
- * remains. The strategy stays active in the DB -- if new deliveries
+ * remains. The focus stays active in the DB -- if new deliveries
  * arrive later, the next poll cycle spawns a fresh team.
  */
 export declare function checkAndMergeCompletedDeliveries(config: DaemonConfig): Promise<void>;

package/dist/session-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../src/session-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMlE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAc7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0F7C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,uBAAuB,CAAC;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA2HzE;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA2CzD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA0Ff"}
+{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../src/session-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAc7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0F7C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA2HzE;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA2CtD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CA0Ff"}