hungry-ghost-hive 0.43.0 → 0.43.2

package/dist/cli/commands/manager/qa-review-handler.js

@@ -0,0 +1,290 @@
+// Licensed under the Hungry Ghost Hive License. See LICENSE.
+import chalk from 'chalk';
+import { syncStatusForStory } from '../../../connectors/project-management/operations.js';
+import { withTransaction } from '../../../db/client.js';
+import { createLog } from '../../../db/queries/logs.js';
+import { getMergeQueue, getPullRequestsByStatus, updatePullRequest, } from '../../../db/queries/pull-requests.js';
+import { updateStory } from '../../../db/queries/stories.js';
+import { getPullRequestComments, getPullRequestReviews } from '../../../git/github.js';
+import { AgentState } from '../../../state-detectors/types.js';
+import { agentStates } from './agent-monitoring.js';
+import { sendManagerNudge, verboseLogCtx } from './manager-utils.js';
+export async function notifyQAOfQueuedPRs(ctx) {
+    // Phase 1: Read PR queue and assign reviews (brief lock)
+    const { queuedPRs, dispatched } = await ctx.withDb(async (db) => {
+        const openPRs = getMergeQueue(db.db);
+        verboseLogCtx(ctx, `notifyQAOfQueuedPRs: open=${openPRs.length}`);
+        const queued = openPRs.filter(pr => pr.status === 'queued');
+        const reviewing = openPRs.filter(pr => pr.status === 'reviewing');
+        ctx.counters.queuedPRCount = queued.length;
+        ctx.counters.reviewingPRCount = reviewing.length;
+        verboseLogCtx(ctx, `notifyQAOfQueuedPRs: queued=${queued.length}`);
+        if (queued.length === 0) {
+            return {
+                queuedPRs: [],
+                dispatched: [],
+            };
+        }
+        const reviewingSessions = new Set(openPRs
+            .filter(pr => pr.status === 'reviewing' && pr.reviewed_by)
+            .map(pr => pr.reviewed_by));
+        const idleQASessions = ctx.hiveSessions.filter(session => {
+            if (!session.name.includes('-qa-'))
+                return false;
+            if (reviewingSessions.has(session.name))
+                return false;
+            const agent = ctx.agentsBySessionName.get(session.name);
+            return Boolean(agent && agent.status === 'idle');
+        });
+        verboseLogCtx(ctx, `notifyQAOfQueuedPRs: idleQA=${idleQASessions.length}`);
+        const dispatchedList = [];
+        let dispatchCount = 0;
+        for (const qa of idleQASessions) {
+            const nextPR = queued[dispatchCount];
+            if (!nextPR)
+                break;
+            await withTransaction(db.db, () => {
+                updatePullRequest(db.db, nextPR.id, {
+                    status: 'reviewing',
+                    reviewedBy: qa.name,
+                });
+                createLog(db.db, {
+                    agentId: qa.name,
+                    storyId: nextPR.story_id || undefined,
+                    eventType: 'PR_REVIEW_STARTED',
+                    message: `Manager assigned PR review: ${nextPR.id}`,
+                    metadata: { pr_id: nextPR.id, branch: nextPR.branch_name },
+                });
+            }, () => db.save());
+            dispatchedList.push({
+                prId: nextPR.id,
+                qaName: qa.name,
+                storyId: nextPR.story_id,
+                githubPrUrl: nextPR.github_pr_url,
+            });
+            dispatchCount++;
+            verboseLogCtx(ctx, `notifyQAOfQueuedPRs: assigned pr=${nextPR.id} -> ${qa.name}`);
+        }
+        return { queuedPRs: queued, dispatched: dispatchedList };
+    });
+    if (queuedPRs.length === 0)
+        return;
+    // Phase 2: Send tmux nudges (no lock needed)
+    for (const d of dispatched) {
+        const githubLine = d.githubPrUrl ? `\n# GitHub: ${d.githubPrUrl}` : '';
+        await sendManagerNudge(ctx, d.qaName, `# You are assigned PR review ${d.prId} (${d.storyId || 'no-story'}).${githubLine}
+# Execute now:
+#   hive pr show ${d.prId}
+#   hive pr approve ${d.prId}
+# (If manual merge is required in this repo, use --no-merge.)
+# or reject:
+#   hive pr reject ${d.prId} -r "reason"`);
+    }
+    // Fallback nudge if PRs are still queued but all QA sessions are busy/unavailable.
+    if (dispatched.length === 0) {
+        verboseLogCtx(ctx, 'notifyQAOfQueuedPRs: no idle QA, sent queue nudge fallback');
+        const qaSessions = ctx.hiveSessions.filter(s => s.name.includes('-qa-'));
+        for (const qa of qaSessions) {
+            await sendManagerNudge(ctx, qa.name, `# ${queuedPRs.length} PR(s) waiting in queue. Run: hive pr queue`);
+        }
+    }
+}
+/**
+ * Auto-reject PRs where the QA agent posted review comments/feedback on GitHub
+ * but never formally approved or rejected via `hive pr approve/reject`.
+ *
+ * Detection: PR is in 'reviewing' status, the assigned QA agent is idle,
+ * and there are GitHub comments or CHANGES_REQUESTED reviews on the PR.
+ *
+ * Action: Auto-reject the PR with the QA's feedback as the rejection reason,
+ * which triggers the standard qa_failed flow back to the developer agent.
+ */
+export async function autoRejectCommentOnlyReviews(ctx) {
+    // Phase 1: Identify reviewing PRs with idle QA agents (brief lock)
+    const candidates = await ctx.withDb(async (db) => {
+        const reviewingPRs = getPullRequestsByStatus(db.db, 'reviewing').filter(pr => pr.github_pr_number && pr.team_id && pr.reviewed_by);
+        verboseLogCtx(ctx, `autoRejectCommentOnlyReviews: reviewingWithQA=${reviewingPRs.length}`);
+        if (reviewingPRs.length === 0)
+            return [];
+        // Only consider PRs whose QA agent is idle (finished reviewing but didn't approve/reject)
+        const idlePRs = reviewingPRs.filter(pr => {
+            const qaAgent = ctx.agentsBySessionName.get(pr.reviewed_by);
+            if (!qaAgent)
+                return false;
+            // Check if the QA agent is idle or if their session shows idle state
+            const qaState = agentStates.get(pr.reviewed_by);
+            return qaAgent.status === 'idle' || qaState?.lastState === AgentState.IDLE_AT_PROMPT;
+        });
+        verboseLogCtx(ctx, `autoRejectCommentOnlyReviews: idleQACandidates=${idlePRs.length}`);
+        if (idlePRs.length === 0)
+            return [];
+        const { getAllTeams } = await import('../../../db/queries/teams.js');
+        const teams = getAllTeams(db.db);
+        const teamsById = new Map(teams.map(team => [team.id, team]));
+        return idlePRs
+            .map(pr => {
+            const team = teamsById.get(pr.team_id);
+            if (!team?.repo_path)
+                return null;
+            return {
+                id: pr.id,
+                storyId: pr.story_id,
+                teamId: pr.team_id,
+                branchName: pr.branch_name,
+                githubPrNumber: pr.github_pr_number,
+                reviewedBy: pr.reviewed_by,
+                submittedBy: pr.submitted_by,
+                repoDir: `${ctx.root}/${team.repo_path}`,
+            };
+        })
+            .filter(Boolean);
+    });
+    if (candidates.length === 0)
+        return;
+    // Phase 2: Check GitHub for comments/reviews on each candidate (no lock)
+    const toReject = [];
+    for (const candidate of candidates) {
+        try {
+            // Fetch both reviews and comments from GitHub
+            const [reviews, comments] = await Promise.all([
+                getPullRequestReviews(candidate.repoDir, candidate.githubPrNumber).catch(() => []),
+                getPullRequestComments(candidate.repoDir, candidate.githubPrNumber).catch(() => []),
+            ]);
+            // If there's a formal APPROVED review, skip (QA approved via GitHub directly)
+            const hasApproval = reviews.some(r => r.state === 'APPROVED');
+            if (hasApproval) {
+                verboseLogCtx(ctx, `autoRejectCommentOnlyReviews: pr=${candidate.id} has GitHub approval, skipping`);
+                continue;
+            }
+            // Check for CHANGES_REQUESTED reviews
+            const changesRequested = reviews.filter(r => r.state === 'CHANGES_REQUESTED');
+            // Check for substantive issue comments (filter out bot noise and very short comments)
+            const substantiveComments = comments.filter(c => {
+                if (c.body.length < 20)
+                    return false;
+                // Skip known bot comments (Ellipsis, etc.)
+                if (c.body.includes('Looks good to me') && c.body.length < 100)
+                    return false;
+                return true;
+            });
+            // If there are review feedback items, auto-reject
+            if (changesRequested.length > 0 || substantiveComments.length > 0) {
+                // Build rejection reason from the feedback
+                const feedbackParts = [];
+                for (const review of changesRequested) {
+                    if (review.body)
+                        feedbackParts.push(review.body);
+                }
+                for (const comment of substantiveComments) {
+                    feedbackParts.push(comment.body);
+                }
+                const reason = feedbackParts.length > 0
+                    ? feedbackParts.join('\n---\n').slice(0, 2000)
+                    : 'QA posted review feedback on GitHub without formal approval. See PR comments.';
+                toReject.push({ candidate, reason });
+                verboseLogCtx(ctx, `autoRejectCommentOnlyReviews: pr=${candidate.id} has ${changesRequested.length} changes_requested + ${substantiveComments.length} comments, will auto-reject`);
+            }
+        }
+        catch (err) {
+            verboseLogCtx(ctx, `autoRejectCommentOnlyReviews: skip pr=${candidate.id} github_check_failed=${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    if (toReject.length === 0)
+        return;
+    // Phase 3: Reject PRs in DB (brief lock)
+    await ctx.withDb(async (db) => {
+        for (const { candidate, reason } of toReject) {
+            await withTransaction(db.db, () => {
+                updatePullRequest(db.db, candidate.id, {
+                    status: 'rejected',
+                    reviewNotes: reason,
+                });
+                if (candidate.storyId) {
+                    updateStory(db.db, candidate.storyId, { status: 'qa_failed' });
+                }
+                createLog(db.db, {
+                    agentId: 'manager',
+                    eventType: 'PR_REJECTED',
+                    message: `Auto-rejected PR ${candidate.id}: QA posted review comments without formal approve/reject`,
+                    storyId: candidate.storyId || undefined,
+                    metadata: { pr_id: candidate.id, auto_rejected: true },
+                });
+            }, () => db.save());
+            console.log(chalk.yellow(`  Auto-rejected PR ${candidate.id} (story: ${candidate.storyId || '-'}): QA left review comments without approving`));
+        }
+    });
+    // Phase 4: Notify developer agents via tmux (no lock)
+    for (const { candidate, reason } of toReject) {
+        if (candidate.submittedBy) {
+            const devSession = ctx.hiveSessions.find(s => s.name === candidate.submittedBy);
+            if (devSession) {
+                await sendManagerNudge(ctx, devSession.name, `# ⚠️ PR AUTO-REJECTED - QA REVIEW FEEDBACK ⚠️
+# Story: ${candidate.storyId || 'Unknown'}
+# QA agent (${candidate.reviewedBy}) posted review feedback without formally approving.
+# Feedback:
+# ${reason.split('\n').slice(0, 10).join('\n# ')}
+#
+# Fix the issues and resubmit: hive pr submit -b ${candidate.branchName} -s ${candidate.storyId || 'STORY-ID'} --from ${devSession.name}`);
+            }
+        }
+    }
+}
+export async function handleRejectedPRs(ctx) {
+    // Phase 1: Read rejected PRs and update DB (brief lock)
+    const rejectedPRData = await ctx.withDb(async (db) => {
+        const rejectedPRs = getPullRequestsByStatus(db.db, 'rejected');
+        verboseLogCtx(ctx, `handleRejectedPRs: rejected=${rejectedPRs.length}`);
+        if (rejectedPRs.length === 0)
+            return [];
+        const prData = [];
+        for (const pr of rejectedPRs) {
+            if (pr.story_id) {
+                const storyId = pr.story_id;
+                await withTransaction(db.db, () => {
+                    updateStory(db.db, storyId, { status: 'qa_failed' });
+                    createLog(db.db, {
+                        agentId: 'manager',
+                        eventType: 'STORY_QA_FAILED',
+                        message: `Story ${storyId} QA failed: ${pr.review_notes || 'See review comments'}`,
+                        storyId: storyId,
+                    });
+                }, () => db.save());
+                // Sync status change to Jira
+                await syncStatusForStory(ctx.root, db.db, storyId, 'qa_failed');
+            }
+            // Mark as closed to prevent re-notification spam
+            await withTransaction(db.db, () => {
+                updatePullRequest(db.db, pr.id, { status: 'closed' });
+            }, () => db.save());
+            prData.push({
+                id: pr.id,
+                storyId: pr.story_id,
+                branchName: pr.branch_name,
+                reviewNotes: pr.review_notes,
+                submittedBy: pr.submitted_by,
+            });
+        }
+        return prData;
+    });
+    if (rejectedPRData.length === 0)
+        return;
+    // Phase 2: Send tmux notifications (no lock needed)
+    let rejectionNotified = 0;
+    for (const pr of rejectedPRData) {
+        if (pr.submittedBy) {
+            const devSession = ctx.hiveSessions.find(s => s.name === pr.submittedBy);
+            if (devSession) {
+                verboseLogCtx(ctx, `handleRejectedPRs: notifying ${devSession.name} for pr=${pr.id}, story=${pr.storyId || '-'}`);
+                await sendManagerNudge(ctx, devSession.name, `# ⚠️ PR REJECTED - ACTION REQUIRED ⚠️
+# Story: ${pr.storyId || 'Unknown'}
+# Reason: ${pr.reviewNotes || 'See review comments'}
+#
+# You MUST fix this issue before doing anything else.
+# Fix the issues and resubmit: hive pr submit -b ${pr.branchName} -s ${pr.storyId || 'STORY-ID'} --from ${devSession.name}`);
+                rejectionNotified++;
+            }
+        }
+    }
+    console.log(chalk.yellow(`  Notified ${rejectionNotified} developer(s) of PR rejection(s)`));
+}
+//# sourceMappingURL=qa-review-handler.js.map

package/dist/cli/commands/manager/qa-review-handler.js.map

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

package/dist/cli/commands/manager/stuck-story-helpers.d.ts

@@ -0,0 +1,32 @@
+import type { HiveConfig } from '../../../config/schema.js';
+import { AgentState } from '../../../state-detectors/types.js';
+import { detectAgentState } from './agent-monitoring.js';
+import type { ManagerCheckContext } from './types.js';
+export interface ScreenStaticTracking {
+    fingerprint: string;
+    unchangedSinceMs: number;
+    lastAiAssessmentMs: number;
+}
+interface UnknownStateStuckHeuristicSnapshot {
+    state: AgentState;
+    isWaiting: boolean;
+    sessionUnchangedForMs: number;
+    staticInactivityThresholdMs: number;
+}
+interface StuckReminderDeferralSnapshot {
+    state: AgentState;
+    sessionUnchangedForMs: number;
+    staticInactivityThresholdMs: number;
+}
+export declare const screenStaticBySession: Map<string, ScreenStaticTracking>;
+export declare function shouldTreatUnknownAsStuckWaiting(snapshot: UnknownStateStuckHeuristicSnapshot): boolean;
+export declare function shouldDeferStuckReminderUntilStaticWindow(snapshot: StuckReminderDeferralSnapshot): boolean;
+export declare function shouldIncludeProgressUpdates(config: HiveConfig): boolean;
+export declare function isClassifierTimeoutReason(reason: string): boolean;
+export declare function applyHumanInterventionStateOverride(ctx: ManagerCheckContext, sessionName: string, storyId: string | null, stateResult: ReturnType<typeof detectAgentState>, agentId?: string | null): Promise<ReturnType<typeof detectAgentState>>;
+export declare function clearHumanIntervention(sessionName: string): void;
+export declare function markClassifierTimeoutForHumanIntervention(ctx: ManagerCheckContext, sessionName: string, storyId: string, reason: string, agentId?: string | null): Promise<void>;
+export declare function markDoneFalseForHumanIntervention(ctx: ManagerCheckContext, sessionName: string, storyId: string, reason: string, agentId?: string | null): Promise<void>;
+export declare function getSessionStaticUnchangedForMs(sessionName: string, nowMs: number): number;
+export {};
+//# sourceMappingURL=stuck-story-helpers.d.ts.map

package/dist/cli/commands/manager/stuck-story-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-story-helpers.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/manager/stuck-story-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAO5D,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAe,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAWtD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,kCAAkC;IAC1C,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,UAAU,6BAA6B;IACrC,KAAK,EAAE,UAAU,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,eAAO,MAAM,qBAAqB,mCAA0C,CAAC;AAI7E,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,kCAAkC,GAC3C,OAAO,CAOT;AAED,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,6BAA6B,GACtC,OAAO,CAMT;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAExE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAQD,wBAAsB,mCAAmC,CACvD,GAAG,EAAE,mBAAmB,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,WAAW,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAChD,OAAO,GAAE,MAAM,GAAG,IAAW,GAC5B,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAmD9C;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAGhE;AAED,wBAAsB,yCAAyC,CAC7D,GAAG,EAAE,mBAAmB,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAM,GAAG,IAAW,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAQD,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,mBAAmB,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAM,GAAG,IAAW,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzF"}

package/dist/cli/commands/manager/stuck-story-helpers.js

@@ -0,0 +1,163 @@
+// Licensed under the Hungry Ghost Hive License. See LICENSE.
+import { createEscalation, getActiveEscalationsForAgent, getPendingEscalations, } from '../../../db/queries/escalations.js';
+import { createLog } from '../../../db/queries/logs.js';
+import { AgentState } from '../../../state-detectors/types.js';
+import { agentStates } from './agent-monitoring.js';
+const CLASSIFIER_TIMEOUT_REASON_PREFIX = 'Classifier timeout';
+const AI_DONE_FALSE_REASON_PREFIX = 'AI done=false escalation';
+export const screenStaticBySession = new Map();
+const classifierTimeoutInterventionsBySession = new Map();
+const aiDoneFalseInterventionsBySession = new Map();
+export function shouldTreatUnknownAsStuckWaiting(snapshot) {
+    const thresholdMs = Math.max(1, snapshot.staticInactivityThresholdMs);
+    return (snapshot.state === AgentState.UNKNOWN &&
+        !snapshot.isWaiting &&
+        snapshot.sessionUnchangedForMs >= thresholdMs);
+}
+export function shouldDeferStuckReminderUntilStaticWindow(snapshot) {
+    const thresholdMs = Math.max(1, snapshot.staticInactivityThresholdMs);
+    if (snapshot.state === AgentState.WORK_COMPLETE) {
+        return false;
+    }
+    return snapshot.sessionUnchangedForMs < thresholdMs;
+}
+export function shouldIncludeProgressUpdates(config) {
+    return config.integrations?.project_management?.provider !== 'none';
+}
+export function isClassifierTimeoutReason(reason) {
+    return /local classifier unavailable:.*timed out|command timed out/i.test(reason);
+}
+function formatClassifierTimeoutEscalationReason(storyId, reason) {
+    const singleLine = reason.replace(/\s+/g, ' ').trim();
+    const shortReason = singleLine.length > 240 ? `${singleLine.slice(0, 237)}...` : singleLine;
+    return `${CLASSIFIER_TIMEOUT_REASON_PREFIX}: manager completion classifier timed out for ${storyId}. Manual human intervention required. Detail: ${shortReason}`;
+}
+export async function applyHumanInterventionStateOverride(ctx, sessionName, storyId, stateResult, agentId = null) {
+    const timeoutIntervention = classifierTimeoutInterventionsBySession.get(sessionName);
+    if (timeoutIntervention && (!storyId || storyId !== timeoutIntervention.storyId)) {
+        classifierTimeoutInterventionsBySession.delete(sessionName);
+    }
+    const doneFalseIntervention = aiDoneFalseInterventionsBySession.get(sessionName);
+    if (doneFalseIntervention && (!storyId || storyId !== doneFalseIntervention.storyId)) {
+        aiDoneFalseInterventionsBySession.delete(sessionName);
+    }
+    const transientIntervention = [timeoutIntervention, doneFalseIntervention]
+        .filter((candidate) => Boolean(candidate && storyId && candidate.storyId === storyId))
+        .sort((a, b) => b.createdAtMs - a.createdAtMs)[0] ?? null;
+    const persistedIntervention = storyId === null
+        ? null
+        : await ctx.withDb(async (db) => {
+            return ((agentId ? getActiveEscalationsForAgent(db.db, agentId) : []).find(escalation => escalation.story_id === storyId &&
+                (escalation.reason.startsWith(CLASSIFIER_TIMEOUT_REASON_PREFIX) ||
+                    escalation.reason.startsWith(AI_DONE_FALSE_REASON_PREFIX))) ??
+                getPendingEscalations(db.db).find(escalation => escalation.story_id === storyId &&
+                    (escalation.reason.startsWith(CLASSIFIER_TIMEOUT_REASON_PREFIX) ||
+                        escalation.reason.startsWith(AI_DONE_FALSE_REASON_PREFIX))) ??
+                null);
+        });
+    const interventionReason = transientIntervention?.reason || persistedIntervention?.reason || null;
+    if (!interventionReason) {
+        return stateResult;
+    }
+    return {
+        ...stateResult,
+        state: AgentState.ASKING_QUESTION,
+        needsHuman: true,
+        isWaiting: true,
+        reason: `Manual intervention required: ${interventionReason}`,
+    };
+}
+export function clearHumanIntervention(sessionName) {
+    classifierTimeoutInterventionsBySession.delete(sessionName);
+    aiDoneFalseInterventionsBySession.delete(sessionName);
+}
+export async function markClassifierTimeoutForHumanIntervention(ctx, sessionName, storyId, reason, agentId = null) {
+    const escalationReason = formatClassifierTimeoutEscalationReason(storyId, reason);
+    classifierTimeoutInterventionsBySession.set(sessionName, {
+        storyId,
+        reason: escalationReason,
+        createdAtMs: Date.now(),
+    });
+    await ctx.withDb(async (db) => {
+        const activeTimeoutEscalation = (agentId ? getActiveEscalationsForAgent(db.db, agentId) : []).some(escalation => escalation.reason.startsWith(CLASSIFIER_TIMEOUT_REASON_PREFIX));
+        if (!activeTimeoutEscalation) {
+            const escalation = createEscalation(db.db, {
+                storyId,
+                fromAgentId: agentId,
+                toAgentId: null,
+                reason: escalationReason,
+            });
+            createLog(db.db, {
+                agentId: 'manager',
+                storyId,
+                eventType: 'ESCALATION_CREATED',
+                status: 'error',
+                message: `${sessionName} requires human intervention: completion classifier timed out`,
+                metadata: {
+                    escalation_id: escalation.id,
+                    session_name: sessionName,
+                    escalation_type: 'classifier_timeout',
+                },
+            });
+            db.save();
+            ctx.counters.escalationsCreated++;
+            ctx.escalatedSessions.add(sessionName);
+        }
+    });
+    const tracked = agentStates.get(sessionName);
+    if (tracked) {
+        tracked.lastState = AgentState.ASKING_QUESTION;
+        tracked.lastStateChangeTime = Date.now();
+    }
+}
+function formatDoneFalseEscalationReason(storyId, reason) {
+    const singleLine = reason.replace(/\s+/g, ' ').trim();
+    const shortReason = singleLine.length > 240 ? `${singleLine.slice(0, 237)}...` : singleLine;
+    return `${AI_DONE_FALSE_REASON_PREFIX}: manager AI assessment returned done=false for ${storyId} after nudge limit reached. Manual human intervention required. Detail: ${shortReason}`;
+}
+export async function markDoneFalseForHumanIntervention(ctx, sessionName, storyId, reason, agentId = null) {
+    const escalationReason = formatDoneFalseEscalationReason(storyId, reason);
+    aiDoneFalseInterventionsBySession.set(sessionName, {
+        storyId,
+        reason: escalationReason,
+        createdAtMs: Date.now(),
+    });
+    await ctx.withDb(async (db) => {
+        const hasActiveEscalation = (agentId ? getActiveEscalationsForAgent(db.db, agentId) : []).some(escalation => escalation.reason.startsWith(AI_DONE_FALSE_REASON_PREFIX));
+        if (!hasActiveEscalation) {
+            const escalation = createEscalation(db.db, {
+                storyId,
+                fromAgentId: agentId,
+                toAgentId: null,
+                reason: escalationReason,
+            });
+            createLog(db.db, {
+                agentId: 'manager',
+                storyId,
+                eventType: 'ESCALATION_CREATED',
+                status: 'error',
+                message: `${sessionName} requires human intervention: AI assessment reports blocked/incomplete after nudge limit`,
+                metadata: {
+                    escalation_id: escalation.id,
+                    session_name: sessionName,
+                    escalation_type: 'ai_done_false',
+                },
+            });
+            db.save();
+            ctx.counters.escalationsCreated++;
+            ctx.escalatedSessions.add(sessionName);
+        }
+    });
+    const tracked = agentStates.get(sessionName);
+    if (tracked) {
+        tracked.lastState = AgentState.ASKING_QUESTION;
+        tracked.lastStateChangeTime = Date.now();
+    }
+}
+export function getSessionStaticUnchangedForMs(sessionName, nowMs) {
+    const tracking = screenStaticBySession.get(sessionName);
+    if (!tracking)
+        return 0;
+    return Math.max(0, nowMs - tracking.unchangedSinceMs);
+}
+//# sourceMappingURL=stuck-story-helpers.js.map

package/dist/cli/commands/manager/stuck-story-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-story-helpers.js","sourceRoot":"","sources":["../../../../src/cli/commands/manager/stuck-story-helpers.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/manager/stuck-story-processor.d.ts

@@ -0,0 +1,8 @@
+import type { StoryRow } from '../../../db/client.js';
+import { type getAllAgents } from '../../../db/queries/agents.js';
+import type { ManagerCheckContext } from './types.js';
+export declare function nudgeStuckStories(ctx: ManagerCheckContext): Promise<void>;
+export declare function autoProgressDoneStory(ctx: ManagerCheckContext, story: StoryRow, agent: ReturnType<typeof getAllAgents>[number], sessionName: string, reason: string, confidence: number): Promise<boolean>;
+export declare function nudgeQAFailedStories(ctx: ManagerCheckContext): Promise<void>;
+export declare function recoverUnassignedQAFailedStories(ctx: ManagerCheckContext): Promise<void>;
+//# sourceMappingURL=stuck-story-processor.d.ts.map

package/dist/cli/commands/manager/stuck-story-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-story-processor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/manager/stuck-story-processor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA6BhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKtD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8R/E;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,EAC9C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAoGlB;AAkCD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiElF;AAED,wBAAsB,gCAAgC,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE9F"}