crewly 1.20.153 → 1.20.155

package/dist/backend/backend/src/services/task-pool/give-up/give-up-recovery.service.js

@@ -0,0 +1,395 @@
+/**
+ * Give-up recovery (#841).
+ *
+ * The worker-facing stop endpoints (complete, block, fail) go through here.
+ * Each stop is classified ({@link classifyStop}):
+ *
+ * - `retry` (a feasibility give-up, no human needed): a NEW WorkItem goes back
+ *   to the same worker, carrying the attempt log and an instruction to pick a
+ *   materially different approach. Bounded per ROOT WorkItem: a retry inherits
+ *   the root, so it never starts its own count. After `giveUpMaxRetries`
+ *   (team policy, default 2) the next stop, even another "impossible",
+ *   produces ONE review WorkItem for the team lead with the full history.
+ * - `escalate` / `none`: today's behaviour is unchanged; the stop is only
+ *   recorded on the WorkItem (`metadata.stop`) for the metrics.
+ *
+ * Nothing verified or terminal is reopened. The stopped item is closed with
+ * edges the transition table already permits: a failed item gets a
+ * `succeeded_by` disposition (so the reconciler does not also requeue it in
+ * place), and a blocked item is cancelled as superseded. A completion that is
+ * a give-up is recorded as `failed` instead of `done_by_worker`, so the lead
+ * gets no verify ping per attempt.
+ *
+ * @module services/task-pool/give-up/give-up-recovery.service
+ */
+import { GIVE_UP_RECOVERY_CONSTANTS, ORCHESTRATOR_SESSION_NAME } from '../../../constants.js';
+import { pickTeamLead } from '../../../utils/team.utils.js';
+import { LoggerService } from '../../core/logger.service.js';
+import { classifyStop } from './stop-classifier.js';
+const C = GIVE_UP_RECOVERY_CONSTANTS;
+/**
+ * The text a completion carries (its summary), for classification.
+ *
+ * @param result - Completion payload from the worker
+ * @returns The summary text, or '' when there is none
+ */
+export function completionText(result) {
+    if (!result)
+        return '';
+    const s = result['summary'] ?? result['result'] ?? result['message'];
+    return typeof s === 'string' ? s : '';
+}
+/**
+ * Handles worker stops and turns feasibility give-ups into bounded retries.
+ */
+export class GiveUpRecoveryService {
+    pool;
+    loadTeams;
+    now;
+    logger;
+    /**
+     * @param deps - Pool, team loader, clock and logger
+     */
+    constructor(deps) {
+        this.pool = deps.pool;
+        this.loadTeams = deps.loadTeams;
+        this.now = deps.now ?? (() => new Date());
+        this.logger = deps.logger ?? LoggerService.getInstance().createComponentLogger('GiveUpRecovery');
+    }
+    /**
+     * A worker completes an item. A completion whose outcome is a give-up (and
+     * that shows no delivery) is recorded as failed and retried; any other
+     * completion goes through exactly as before.
+     *
+     * @param workItemId - The running item
+     * @param result - The worker's completion payload
+     * @param actor - Who is completing it (#813: required by pool.completeItem;
+     *   forwarded on the non-give-up path exactly as the caller resolved it)
+     * @returns What was done
+     */
+    async complete(workItemId, result, actor) {
+        const text = completionText(result);
+        const verdict = classifyStop(text, 'complete');
+        const before = await this.pool.findWorkItem(workItemId);
+        // Convert only when retries are on for this worker's team: with the
+        // feature off (giveUpMaxRetries 0) a completion stays exactly as today.
+        // Also off for the orchestrator (isExcludedFromGiveUp): it is a
+        // singleton control-plane process, not a bounded-retry worker, and has
+        // no team lead of its own to escalate a review to.
+        const enabled = verdict.decision === 'retry' && before !== null && !isExcludedFromGiveUp(before) &&
+            maxRetriesFor(teamOf(await this.loadTeams().catch(() => []), before.target)) > 0;
+        if (!enabled) {
+            await this.pool.completeItem(workItemId, result, actor);
+            if (verdict.decision !== 'none')
+                await this.record(workItemId, 'complete', verdict, text);
+            return { verdict, action: verdict.decision === 'none' ? 'none' : 'recorded' };
+        }
+        await this.pool.failItem(workItemId, text);
+        return this.afterStop(before, workItemId, 'complete', verdict, text);
+    }
+    /**
+     * A worker blocks an item.
+     *
+     * @param workItemId - The running item
+     * @param options - Who blocked it and why
+     * @returns What was done
+     */
+    async block(workItemId, options) {
+        const before = await this.pool.findWorkItem(workItemId);
+        await this.pool.blockItem(workItemId, options);
+        const text = options.reason ?? '';
+        return this.afterStop(before, workItemId, 'block', classifyStop(text, 'block'), text);
+    }
+    /**
+     * A worker fails an item.
+     *
+     * @param workItemId - The running item
+     * @param error - The failure text
+     * @returns What was done
+     */
+    async fail(workItemId, error) {
+        const before = await this.pool.findWorkItem(workItemId);
+        await this.pool.failItem(workItemId, error);
+        return this.afterStop(before, workItemId, 'fail', classifyStop(error, 'fail'), error);
+    }
+    /**
+     * Record the stop, then retry or escalate when the verdict says so.
+     *
+     * @param before - The item as it was before the stop (for its brief and log)
+     * @param workItemId - The stopped item
+     * @param source - Stop path
+     * @param verdict - Classification
+     * @param text - Stop text
+     * @returns What was done
+     */
+    async afterStop(before, workItemId, source, verdict, text) {
+        await this.record(workItemId, source, verdict, text);
+        if (verdict.decision !== 'retry' || !before)
+            return { verdict, action: 'recorded' };
+        // The escalation review this service itself creates (buildReview) carries
+        // the give-up meta and an id derived from `rootWorkItemId`. If the lead
+        // blocks or fails THAT review with give-up wording, re-running this same
+        // logic on it would rebuild a review with the identical id (addToPool
+        // then silently skips it as a duplicate) and closeStopped(id, id) would
+        // try to cancel the escalation as superseded by itself. A give-up review
+        // has done its job once it reaches a human; it is never itself retried
+        // or re-escalated. The orchestrator is excluded for the same reason
+        // `complete()` excludes it above (see isExcludedFromGiveUp).
+        if (isExcludedFromGiveUp(before)) {
+            this.logger.debug('Give-up handling skipped: item is excluded (a give-up escalation, or targets the orchestrator)', {
+                workItemId, type: before.type, target: before.target, reviewReason: before.metadata?.['reviewReason'],
+            });
+            return { verdict, action: 'recorded' };
+        }
+        try {
+            const teams = await this.loadTeams().catch(() => []);
+            const team = teamOf(teams, before.target);
+            const maxRetries = maxRetriesFor(team);
+            if (maxRetries <= 0)
+                return { verdict, action: 'recorded', maxRetries };
+            const prior = giveUpMetaOf(before);
+            const attempts = [
+                ...(prior?.attempts ?? []),
+                { workItemId, source, category: verdict.category, reason: clip(text), at: this.now().toISOString() },
+            ];
+            const meta = {
+                rootWorkItemId: prior?.rootWorkItemId ?? before.id,
+                rootParentWorkItemId: prior ? prior.rootParentWorkItemId : before.parentWorkItemId,
+                rootTitle: prior?.rootTitle ?? before.title,
+                rootDescription: prior ? prior.rootDescription : before.description,
+                maxRetries,
+                attempts,
+            };
+            if (attempts.length <= maxRetries) {
+                const retry = this.buildRetry(before, meta, attempts.length);
+                await this.pool.addToPool(retry);
+                await this.closeStopped(workItemId, retry.id, `give-up retry ${attempts.length}/${maxRetries}`);
+                this.logger.info('Give-up: retry with a different approach queued', {
+                    workItemId, retryWorkItemId: retry.id, attempt: attempts.length, maxRetries, rootWorkItemId: meta.rootWorkItemId,
+                });
+                return { verdict, action: 'retry_queued', retryWorkItemId: retry.id, attempt: attempts.length, maxRetries };
+            }
+            const review = this.buildReview(before, meta, team);
+            await this.pool.addToPool(review);
+            await this.closeStopped(workItemId, review.id, `gave up after ${maxRetries} retries — escalated to the lead`);
+            this.logger.info('Give-up: retries exhausted, one escalation to the lead', {
+                workItemId, reviewWorkItemId: review.id, target: review.target, attempts: attempts.length,
+            });
+            return { verdict, action: 'escalated_to_lead', reviewWorkItemId: review.id, attempt: attempts.length, maxRetries };
+        }
+        catch (err) {
+            // The stop itself already happened; a recovery glitch must not undo it.
+            this.logger.error('Give-up recovery failed after the stop was recorded', {
+                workItemId, error: err instanceof Error ? err.message : String(err),
+            });
+            return { verdict, action: 'recorded' };
+        }
+    }
+    /**
+     * Write `metadata.stop` on the stopped item. Best-effort: never throws.
+     *
+     * @param workItemId - Item
+     * @param source - Stop path
+     * @param verdict - Classification
+     * @param text - Stop text
+     */
+    async record(workItemId, source, verdict, text) {
+        const stop = {
+            source, decision: verdict.decision, category: verdict.category, rules: verdict.rules,
+            reason: clip(text), at: this.now().toISOString(),
+        };
+        try {
+            await this.pool.mergeItemMetadata(workItemId, { [C.STOP_METADATA_KEY]: stop });
+        }
+        catch (err) {
+            // Best-effort: the stop already happened; failing to annotate it must
+            // not turn a successful block/fail/complete into an API error.
+            this.logger.warn('Could not record the stop classification (non-fatal)', {
+                workItemId, error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    /**
+     * Hand the stopped item's work to its successor with edges the table permits.
+     *
+     * @param workItemId - Stopped item (now failed or blocked)
+     * @param successorId - Retry or review item
+     * @param reason - Audit text
+     */
+    async closeStopped(workItemId, successorId, reason) {
+        const current = await this.pool.findWorkItem(workItemId);
+        if (!current)
+            return;
+        if (current.status === 'failed') {
+            await this.pool.disposeFailedWorkItem(workItemId, { reason, actor: 'system', successorWorkItemId: successorId });
+        }
+        else if (current.status === 'blocked') {
+            await this.pool.transitionStatus(workItemId, 'cancelled', 'system', undefined, `superseded by ${successorId}: ${reason}`);
+        }
+    }
+    /**
+     * The retry WorkItem.
+     *
+     * DELIBERATE CHOICE (#843): its id's `:giveup:N` infix is NOT added to
+     * `FRESH_TASK_CONVERSATION_CONSTANTS.ROOT_SUFFIX_MARKERS`, so dispatching
+     * it starts a fresh conversation rather than continuing the one that just
+     * gave up. Reasoning: the whole point of a retry is a materially
+     * DIFFERENT approach (see the instruction below), and the full attempt
+     * log is already written into this WorkItem's own description — nothing
+     * is lost by a clean slate, and a warm conversation risks anchoring the
+     * agent on the reasoning that just failed.
+     *
+     * @param stopped - The item that gave up
+     * @param meta - Attempt log so far
+     * @param attempt - This retry's number
+     * @returns A queued WorkItem for the same worker
+     */
+    buildRetry(stopped, meta, attempt) {
+        const id = `${meta.rootWorkItemId}${C.RETRY_ID_INFIX}${attempt}`;
+        const instruction = [
+            `## Retry ${attempt}/${meta.maxRetries}: try a materially different approach`,
+            '',
+            'A previous attempt stopped, saying the task could not be done. Before you start:',
+            '1. List every approach already tried (below, and any you know of) and why each failed.',
+            '2. Pick one that is materially different, not a variation of those.',
+            '3. If what blocks you needs a human (permissions or credentials, copyright or legal, money, an owner decision or scope change, safety, a destructive or external action, personal data, or a broken environment), block the task and say which. Do not work around it.',
+            '',
+            '### Attempts so far',
+            ...meta.attempts.map((a, i) => `${i + 1}. \`${a.workItemId}\` (${a.source}, ${a.at}): ${a.reason}`),
+        ].join('\n');
+        return {
+            id,
+            type: stopped.type,
+            owner: stopped.owner,
+            target: stopped.target,
+            title: `Retry ${attempt}/${meta.maxRetries} (different approach): ${meta.rootTitle}`,
+            description: `${meta.rootDescription ?? ''}\n\n${instruction}`.trim(),
+            status: 'queued',
+            createdAt: this.now().toISOString(),
+            retryCount: 0,
+            maxRetries: stopped.maxRetries,
+            requestId: stopped.requestId,
+            missionId: stopped.missionId,
+            parentWorkItemId: meta.rootParentWorkItemId,
+            inputTokens: 0,
+            outputTokens: 0,
+            cost: 0,
+            metadata: {
+                ...(stopped.metadata?.['teamId'] ? { teamId: stopped.metadata['teamId'] } : {}),
+                idempotencyKey: id,
+                [C.GIVE_UP_METADATA_KEY]: { ...meta, attempt },
+            },
+        };
+    }
+    /**
+     * The single escalation to the team lead.
+     *
+     * @param stopped - The last item that gave up
+     * @param meta - Full attempt log
+     * @param team - The worker's team, if known
+     * @returns A queued review WorkItem for the lead
+     */
+    buildReview(stopped, meta, team) {
+        const id = `${meta.rootWorkItemId}${C.REVIEW_ID_SUFFIX}`;
+        const lead = team ? pickTeamLead(team) : null;
+        const target = lead?.sessionName && lead.sessionName !== stopped.target ? lead.sessionName : ORCHESTRATOR_SESSION_NAME;
+        const history = meta.attempts.map((a, i) => `${i + 1}. \`${a.workItemId}\` (${a.source}, ${a.at}): ${a.reason}`).join('\n');
+        return {
+            id,
+            type: 'review',
+            owner: 'team_lead',
+            target,
+            title: `Gave up after ${meta.maxRetries} retries: ${meta.rootTitle}`,
+            description: [
+                `\`${stopped.target ?? 'the worker'}\` stopped on this task ${meta.attempts.length} times, each time saying it could not be done, including ${meta.maxRetries} retries with a different approach.`,
+                'Decide: re-scope, reassign, give more context, or cancel.',
+                '',
+                '### Attempts',
+                history,
+                '',
+                '### Original brief',
+                meta.rootDescription ?? '(none)',
+            ].join('\n'),
+            status: 'queued',
+            createdAt: this.now().toISOString(),
+            retryCount: 0,
+            maxRetries: stopped.maxRetries,
+            requestId: stopped.requestId,
+            missionId: stopped.missionId,
+            parentWorkItemId: meta.rootParentWorkItemId,
+            inputTokens: 0,
+            outputTokens: 0,
+            cost: 0,
+            metadata: {
+                ...(stopped.metadata?.['teamId'] ? { teamId: stopped.metadata['teamId'] } : {}),
+                idempotencyKey: id,
+                reviewReason: 'gave_up',
+                sourceWorkItemId: meta.rootWorkItemId,
+                [C.GIVE_UP_METADATA_KEY]: meta,
+            },
+        };
+    }
+}
+/**
+ * The attempt log on a WorkItem, if it is a give-up retry.
+ *
+ * @param wi - WorkItem
+ * @returns Its `metadata.giveUp`, or null
+ */
+export function giveUpMetaOf(wi) {
+    const m = wi.metadata?.[C.GIVE_UP_METADATA_KEY];
+    return m && typeof m.rootWorkItemId === 'string' && Array.isArray(m.attempts) ? m : null;
+}
+/**
+ * Whether a stopped WorkItem is excluded from give-up handling entirely: it
+ * is never retried, never escalated — only recorded, exactly like feature-off.
+ *
+ * Two cases:
+ * - It targets the orchestrator: a singleton control-plane process, not a
+ *   bounded-retry worker. `teamOf()` finds no team for it (the orchestrator
+ *   is not a team member), so `maxRetriesFor(null)` would otherwise fall
+ *   through to the team-less default (2) and give it retries and a review
+ *   escalation it has no team lead to receive.
+ * - It IS a give-up escalation review (buildReview's own output, `type:
+ *   'review'` with `metadata.reviewReason === 'gave_up'`): if the lead
+ *   blocks or fails THAT review with give-up wording, this service must not
+ *   process it again (see the comment at the call site in `afterStop`).
+ *
+ * @param wi - The stopped WorkItem
+ * @returns True when give-up handling must not apply
+ */
+export function isExcludedFromGiveUp(wi) {
+    return wi.target === ORCHESTRATOR_SESSION_NAME || wi.type === 'review' || wi.metadata?.['reviewReason'] === 'gave_up';
+}
+/**
+ * The team a worker session belongs to.
+ *
+ * @param teams - All teams
+ * @param session - Worker session
+ * @returns The team, or null
+ */
+export function teamOf(teams, session) {
+    if (!session)
+        return null;
+    return teams.find((t) => (t.members ?? []).some((m) => m.sessionName === session)) ?? null;
+}
+/**
+ * Give-up retries allowed for a team.
+ *
+ * @param team - The worker's team, or null
+ * @returns `recoveryPolicy.giveUpMaxRetries` when set to a non-negative integer, else the default
+ */
+export function maxRetriesFor(team) {
+    const n = team?.recoveryPolicy?.giveUpMaxRetries;
+    return typeof n === 'number' && Number.isInteger(n) && n >= 0 ? n : C.DEFAULT_MAX_RETRIES;
+}
+/**
+ * Clip stop text for storage.
+ *
+ * @param text - Stop text
+ * @returns At most MAX_REASON_CHARS characters
+ */
+function clip(text) {
+    return text.length > C.MAX_REASON_CHARS ? `${text.slice(0, C.MAX_REASON_CHARS)}…` : text;
+}
+//# sourceMappingURL=give-up-recovery.service.js.map

package/dist/backend/backend/src/services/task-pool/give-up/give-up-recovery.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"give-up-recovery.service.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/task-pool/give-up/give-up-recovery.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/task-pool/give-up/give-up-stats.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Give-up metrics per team (#841): how often workers give up, how many
+ * retries were queued, and how many of those retries succeeded.
+ *
+ * Computed on demand from the pool (`metadata.stop` on stopped items,
+ * `metadata.giveUp` on retries and escalations). Nothing extra is stored.
+ *
+ * @module services/task-pool/give-up/give-up-stats
+ */
+import type { Team } from '../../../types/index.js';
+import type { WorkItem } from '../../../types/v2/work-item.types.js';
+/** Counts for one team (or `unassigned`). */
+export interface TeamGiveUpStats {
+    teamId: string;
+    teamName: string;
+    /** Stops classified as a feasibility give-up (retry verdict). */
+    giveUps: number;
+    /** Retry WorkItems created. */
+    retries: number;
+    /** Retries that reached done or verified. */
+    retriesSucceeded: number;
+    /** Retries that ended any other terminal way (failed, rejected, cancelled). */
+    retriesFailed: number;
+    /** Retries not finished yet. */
+    retriesPending: number;
+    /** retriesSucceeded / (retriesSucceeded + retriesFailed); null when none finished. */
+    retrySuccessRate: number | null;
+    /** One-per-root escalations to the lead after the retries ran out. */
+    escalations: number;
+    /** Stops sent to a human (never retried), by category. */
+    escalatedByCategory: Record<string, number>;
+}
+/** Whole-pool result. */
+export interface GiveUpStats {
+    /** WorkItems examined (so an empty result is distinguishable from an empty pool). */
+    examined: number;
+    teams: TeamGiveUpStats[];
+}
+/**
+ * Compute give-up metrics.
+ *
+ * @param items - Pool WorkItems
+ * @param teams - Teams (to map a worker session to its team)
+ * @param teamId - Only this team, when given
+ * @returns Counts per team and how many items were examined
+ *
+ * @example
+ * ```typescript
+ * computeGiveUpStats(await pool.getAllItems(), await storage.getTeams(), 'team-a');
+ * ```
+ */
+export declare function computeGiveUpStats(items: WorkItem[], teams: Team[], teamId?: string): GiveUpStats;
+//# sourceMappingURL=give-up-stats.d.ts.map

package/dist/backend/backend/src/services/task-pool/give-up/give-up-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"give-up-stats.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/task-pool/give-up/give-up-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAMrE,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAgDjG"}

package/dist/backend/backend/src/services/task-pool/give-up/give-up-stats.js

@@ -0,0 +1,83 @@
+/**
+ * Give-up metrics per team (#841): how often workers give up, how many
+ * retries were queued, and how many of those retries succeeded.
+ *
+ * Computed on demand from the pool (`metadata.stop` on stopped items,
+ * `metadata.giveUp` on retries and escalations). Nothing extra is stored.
+ *
+ * @module services/task-pool/give-up/give-up-stats
+ */
+import { GIVE_UP_RECOVERY_CONSTANTS } from '../../../constants.js';
+import { giveUpMetaOf, teamOf } from './give-up-recovery.service.js';
+const C = GIVE_UP_RECOVERY_CONSTANTS;
+const SUCCESS = new Set(['done', 'verified']);
+const FAILURE = new Set(['failed', 'rejected', 'cancelled']);
+const UNASSIGNED = { id: 'unassigned', name: '(no team)' };
+/**
+ * Compute give-up metrics.
+ *
+ * @param items - Pool WorkItems
+ * @param teams - Teams (to map a worker session to its team)
+ * @param teamId - Only this team, when given
+ * @returns Counts per team and how many items were examined
+ *
+ * @example
+ * ```typescript
+ * computeGiveUpStats(await pool.getAllItems(), await storage.getTeams(), 'team-a');
+ * ```
+ */
+export function computeGiveUpStats(items, teams, teamId) {
+    const byTeam = new Map();
+    const bucket = (wi, sessionOverride) => {
+        const metaTeam = typeof wi.metadata?.['teamId'] === 'string' ? wi.metadata['teamId'] : undefined;
+        const team = (metaTeam ? teams.find((t) => t.id === metaTeam) : undefined) ?? teamOf(teams, sessionOverride ?? wi.target);
+        const key = team?.id ?? UNASSIGNED.id;
+        let s = byTeam.get(key);
+        if (!s) {
+            s = {
+                teamId: key, teamName: team?.name ?? UNASSIGNED.name,
+                giveUps: 0, retries: 0, retriesSucceeded: 0, retriesFailed: 0, retriesPending: 0,
+                retrySuccessRate: null, escalations: 0, escalatedByCategory: {},
+            };
+            byTeam.set(key, s);
+        }
+        return s;
+    };
+    for (const wi of items) {
+        const stop = wi.metadata?.[C.STOP_METADATA_KEY];
+        if (stop && typeof stop.decision === 'string') {
+            const s = bucket(wi);
+            if (stop.decision === 'retry')
+                s.giveUps += 1;
+            else if (stop.decision === 'escalate')
+                s.escalatedByCategory[stop.category] = (s.escalatedByCategory[stop.category] ?? 0) + 1;
+        }
+        const meta = giveUpMetaOf(wi);
+        if (!meta)
+            continue;
+        if (wi.id.includes(C.RETRY_ID_INFIX)) {
+            const s = bucket(wi);
+            s.retries += 1;
+            if (SUCCESS.has(wi.status))
+                s.retriesSucceeded += 1;
+            else if (FAILURE.has(wi.status))
+                s.retriesFailed += 1;
+            else
+                s.retriesPending += 1;
+        }
+        else if (wi.id.endsWith(C.REVIEW_ID_SUFFIX)) {
+            // The review targets the lead; count it on the worker's team.
+            const worker = items.find((x) => x.id === meta.rootWorkItemId)?.target;
+            bucket(wi, worker).escalations += 1;
+        }
+    }
+    const teamsOut = [...byTeam.values()]
+        .map((s) => {
+        const finished = s.retriesSucceeded + s.retriesFailed;
+        return { ...s, retrySuccessRate: finished > 0 ? s.retriesSucceeded / finished : null };
+    })
+        .filter((s) => !teamId || s.teamId === teamId)
+        .sort((a, b) => a.teamId.localeCompare(b.teamId));
+    return { examined: items.length, teams: teamsOut };
+}
+//# sourceMappingURL=give-up-stats.js.map

package/dist/backend/backend/src/services/task-pool/give-up/give-up-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"give-up-stats.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/task-pool/give-up/give-up-stats.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/task-pool/give-up/stop-classifier.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Stop classifier (#841): decide whether a worker that stopped should be
+ * pushed to retry with a different approach, or handed to a human.
+ *
+ * Deterministic pattern rules, English and Chinese, no LLM. The dangerous
+ * mistake is a false RETRY: auto-retrying a copyright, spending or
+ * owner-decision stop pushes an agent past a human decision. So:
+ *
+ * 1. EXCLUSIONS are checked first and always win. Any hit escalates, even if
+ *    the same message also says "can't" ("I can't, it needs your card").
+ * 2. A dependency wait escalates (it is not a give-up).
+ * 3. A feasibility give-up ("can't / impossible / 做不到") with no exclusion
+ *    retries.
+ * 4. Anything else escalates ("unknown"): when unsure, never retry.
+ *
+ * Completions are stricter (a finished task must never be turned into a
+ * failure): a completion is a give-up only when the give-up is the OUTCOME,
+ * i.e. there is a feasibility cue AND no delivery evidence (a PR/issue URL, a
+ * commit SHA, a findings/specs path, or success words such as done / fixed /
+ * merged / 完成). Otherwise the completion is left alone (`none`).
+ *
+ * Pinned by real, scrubbed stop messages in `__fixtures__/stop-messages.json`.
+ *
+ * @module services/task-pool/give-up/stop-classifier
+ */
+/** Where the stop text came from. */
+export type StopSource = 'complete' | 'block' | 'fail';
+/** What to do with the stop. */
+export type StopDecision = 'retry' | 'escalate' | 'none';
+/** Why. The first nine are the exclusion list (never retried). */
+export type StopCategory = 'permission' | 'legal' | 'money' | 'owner_decision' | 'safety' | 'quota' | 'destructive' | 'external_action' | 'privacy' | 'environment' | 'dependency' | 'feasibility' | 'unknown' | 'delivered';
+/** The classifier's verdict. */
+export interface StopVerdict {
+    decision: StopDecision;
+    category: StopCategory;
+    /** Names of the rules that matched, for the audit trail. */
+    rules: string[];
+}
+/** One named pattern. */
+interface Rule {
+    name: string;
+    re: RegExp;
+}
+/**
+ * Exclusion rules, in the order categories are reported (most specific
+ * concern first: legal/safety/privacy before credentials). Deliberately broad:
+ * an over-match here costs a human a look (false escalate), never a skipped
+ * human decision (false retry).
+ */
+export declare const EXCLUSION_RULES: ReadonlyArray<{
+    category: Exclude<StopCategory, 'dependency' | 'feasibility' | 'unknown' | 'delivered'>;
+    rules: Rule[];
+}>;
+/** Waiting on other work: not a give-up, and not for this classifier to retry. */
+export declare const DEPENDENCY_RULES: Rule[];
+/**
+ * Feasibility give-up cues. Written to swallow the verb that follows
+ * ("can't be done", "无法完成") so the delivery check below never mistakes
+ * the give-up phrase itself for a success word.
+ */
+export declare const FEASIBILITY_RULES: Rule[];
+/** Evidence that a completion delivered something. */
+export declare const DELIVERY_RULES: Rule[];
+/** Cap on how much text is classified (and later stored). */
+export declare const MAX_STOP_TEXT = 4000;
+/**
+ * First exclusion category the text hits, with its rule names.
+ *
+ * @param text - Stop text
+ * @returns The category and rules, or null
+ */
+export declare function findExclusion(text: string): {
+    category: StopCategory;
+    rules: string[];
+} | null;
+/**
+ * Classify why a worker stopped.
+ *
+ * @param text - The stop text: completion summary, block reason or failure error
+ * @param source - Which path the stop came through
+ * @returns retry | escalate | none, with the category and matched rules
+ *
+ * @example
+ * ```typescript
+ * classifyStop("The record can't be beaten with this model.", 'block');
+ * // { decision: 'retry', category: 'feasibility', rules: ['feasibility:cannot'] }
+ * classifyStop("I can't, it needs your card.", 'block');
+ * // { decision: 'escalate', category: 'money', ... }
+ * ```
+ */
+export declare function classifyStop(text: string | null | undefined, source: StopSource): StopVerdict;
+export {};
+//# sourceMappingURL=stop-classifier.d.ts.map