create-principles-disciple 1.120.6 → 1.121.0

package/console/dist/ui/pages/failed-tasks/FailedTasksPage.js

@@ -11,6 +11,13 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  * Each row exposes a "Create Feedback Draft" button that deep-links into the
  * Report Problem page with the task/pain context pre-filled.
  *
+ * Governance Recovery Actions v1: when the `failed_task_recovery_console`
+ * feature flag is enabled, each row also exposes a "Resume Evolution" button.
+ * Recovery is an Owner governance action (never auto-triggered on load): it
+ * always goes through an explicit confirmation dialog before POSTing
+ * /api/v1/failed-tasks/:id/recover. The success state means "Recovery
+ * Accepted" — the task is pending again; execution is asynchronous.
+ *
  * Runtime Contract (rc-*):
  * - rc-1: API response is treated as `unknown` and validated before use
  * - rc-2: no `as` type assertions — runtime type guards only
@@ -20,13 +27,16 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useState, useEffect, useCallback } from "react";
 import { useNavigate } from "react-router-dom";
 import { useTranslation } from "react-i18next";
+import { toast } from "sonner";
 import { PageShell } from "../../components/layout/page-shell.js";
 import { PageLoading } from "../../components/layout/page-loading.js";
 import { Badge } from "../../components/ui/badge.js";
 import { Card, CardContent, CardHeader, CardTitle } from "../../components/ui/card.js";
 import { Button } from "../../components/ui/button.js";
+import { AlertDialog, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, } from "../../components/ui/alert-dialog.js";
 import { ShinyText } from "../../components/ui/shiny-text.js";
 import { formatDate } from "../../utils/format.js";
+import { recoverFailedTask, fetchConfigSummary } from "../../api.js";
 // ── Runtime validators (rc-1, rc-2, rc-5) ───────────────────────────────────
 //
 // The API response is `unknown` until these guards run. No `as` casts.
@@ -133,6 +143,30 @@ export function FailedTasksPage() {
     const { t } = useTranslation();
     const navigate = useNavigate();
     const [state, setState] = useState({ status: "loading" });
+    // Governance Recovery Actions v1 — flag-gated recovery UI (fail-closed:
+    // absent/false → no recovery entry, Console stays read-only).
+    const [recoveryEnabled, setRecoveryEnabled] = useState(false);
+    const [recoverTarget, setRecoverTarget] = useState(null);
+    const [recoverLoading, setRecoverLoading] = useState(false);
+    useEffect(() => {
+        let cancelled = false;
+        fetchConfigSummary()
+            .then((result) => {
+            if (cancelled)
+                return;
+            // Fail-closed: only an explicitly enabled flag shows the action
+            if (result.success && result.data) {
+                const flag = result.data.features.find((f) => f.id === "failed_task_recovery_console");
+                setRecoveryEnabled(flag?.enabled === true);
+            }
+        })
+            .catch(() => {
+            // rc-9: flag probe failure keeps recovery hidden (fail-closed)
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, []);
     const loadData = useCallback(async () => {
         setState({ status: "loading" });
         try {
@@ -205,9 +239,48 @@ export function FailedTasksPage() {
         }
         navigate(`/report-problem?${params.toString()}`);
     };
-    return (_jsxs(PageShell, { children: [_jsxs("div", { className: "mb-8", children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.14em] text-ink-3", children: t("pages.failedTasks.title") }), _jsx(ShinyText, { as: "h1", className: "text-[29px] font-semibold tracking-tight text-ink mt-3 mb-2", duration: 4.5, brightness: 0.5, disabled: state.status !== "loaded" || state.data.tasks.length === 0, children: t("pages.failedTasks.title") }), _jsx("p", { className: "text-ink-3 text-sm leading-relaxed max-w-[712px]", children: t("pages.failedTasks.subtitle") })] }), state.status === "loading" && (_jsx(PageLoading, { cardCount: 3, label: t("common.loading") })), state.status === "disabled" && (_jsxs("div", { className: "py-8", children: [_jsx("div", { className: "p-5 bg-panel border border-amber/20 rounded-[var(--radius-md)] text-amber text-[13px] leading-relaxed", children: t("pages.failedTasks.disabled") }), _jsx("div", { className: "mt-4", children: _jsx(Button, { variant: "outline", size: "sm", onClick: loadData, children: t("common.refresh") }) })] })), state.status === "error" && (_jsxs("div", { className: "py-8", children: [_jsxs("div", { className: "text-danger text-sm mb-2", children: [t("pages.failedTasks.error"), ": ", state.message] }), state.nextAction && (_jsx("div", { className: "text-ink-3 text-[13px] mb-3", children: state.nextAction })), _jsx(Button, { variant: "outline", size: "sm", onClick: loadData, children: t("common.refresh") })] })), state.status === "loaded" && (_jsx("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: _jsx(LoadedContent, { data: state.data, onCreateDraft: handleCreateDraft, t: t }) }))] }));
+    // Owner-confirmed recovery (SPEC §6.3: explicit confirmation only — this
+    // handler runs exclusively from the dialog's action button, never on load).
+    const handleRecoverConfirmed = async () => {
+        if (!recoverTarget || recoverLoading)
+            return;
+        setRecoverLoading(true);
+        try {
+            const result = await recoverFailedTask(recoverTarget.taskId);
+            if (result.success) {
+                toast.success(t("pages.failedTasks.recoverSuccess"));
+                setRecoverTarget(null);
+                await loadData();
+            }
+            else {
+                // rc-9: server-provided reason + next action accompany the failure
+                const detail = result.nextAction
+                    ? `${result.error} — ${result.nextAction}`
+                    : result.error;
+                toast.error(`${t("pages.failedTasks.recoverFailed")}: ${detail}`);
+            }
+        }
+        catch (err) {
+            toast.error(`${t("pages.failedTasks.recoverFailed")}: ${err instanceof Error ? err.message : "Network error"}`);
+        }
+        finally {
+            setRecoverLoading(false);
+        }
+    };
+    return (_jsxs(PageShell, { children: [_jsxs("div", { className: "mb-8", children: [_jsx("div", { className: "font-mono text-[11px] uppercase tracking-[0.14em] text-ink-3", children: t("pages.failedTasks.title") }), _jsx(ShinyText, { as: "h1", className: "text-[29px] font-semibold tracking-tight text-ink mt-3 mb-2", duration: 4.5, brightness: 0.5, disabled: state.status !== "loaded" || state.data.tasks.length === 0, children: t("pages.failedTasks.title") }), _jsx("p", { className: "text-ink-3 text-sm leading-relaxed max-w-[712px]", children: t("pages.failedTasks.subtitle") })] }), state.status === "loading" && (_jsx(PageLoading, { cardCount: 3, label: t("common.loading") })), state.status === "disabled" && (_jsxs("div", { className: "py-8", children: [_jsx("div", { className: "p-5 bg-panel border border-amber/20 rounded-[var(--radius-md)] text-amber text-[13px] leading-relaxed", children: t("pages.failedTasks.disabled") }), _jsx("div", { className: "mt-4", children: _jsx(Button, { variant: "outline", size: "sm", onClick: loadData, children: t("common.refresh") }) })] })), state.status === "error" && (_jsxs("div", { className: "py-8", children: [_jsxs("div", { className: "text-danger text-sm mb-2", children: [t("pages.failedTasks.error"), ": ", state.message] }), state.nextAction && (_jsx("div", { className: "text-ink-3 text-[13px] mb-3", children: state.nextAction })), _jsx(Button, { variant: "outline", size: "sm", onClick: loadData, children: t("common.refresh") })] })), state.status === "loaded" && (_jsx("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: _jsx(LoadedContent, { data: state.data, onCreateDraft: handleCreateDraft, onRecover: recoveryEnabled ? (task) => setRecoverTarget(task) : undefined, t: t }) })), _jsx(AlertDialog, { open: recoverTarget !== null, onOpenChange: (open) => {
+                    if (!open && !recoverLoading) {
+                        setRecoverTarget(null);
+                    }
+                }, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t("pages.failedTasks.recoverConfirmTitle") }), _jsx(AlertDialogDescription, { asChild: true, children: _jsxs("div", { className: "space-y-2 text-[13px] leading-relaxed", children: [_jsxs("div", { children: [_jsxs("span", { className: "font-medium", children: [t("pages.failedTasks.recoverConfirmStatus"), ":"] }), " ", _jsx("span", { className: "font-mono", children: recoverTarget?.status ?? "—" })] }), _jsxs("div", { children: [_jsxs("span", { className: "font-medium", children: [t("pages.failedTasks.recoverConfirmActionLabel"), ":"] }), " ", t("pages.failedTasks.recoverConfirmActionDesc")] }), _jsxs("div", { children: [_jsxs("span", { className: "font-medium", children: [t("pages.failedTasks.recoverConfirmImpactLabel"), ":"] }), " ", t("pages.failedTasks.recoverConfirmImpactDesc")] })] }) })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: recoverLoading, children: t("common.cancel") }), _jsx(AlertDialogAction, { disabled: recoverLoading, onClick: (event) => {
+                                        // Prevent Radix from auto-closing before the async POST
+                                        // resolves; handleRecoverConfirmed closes on success.
+                                        event.preventDefault();
+                                        void handleRecoverConfirmed();
+                                    }, children: recoverLoading
+                                        ? t("common.loading")
+                                        : t("pages.failedTasks.recoverConfirmButton") })] })] }) })] }));
 }
-function LoadedContent({ data, onCreateDraft, t }) {
+function LoadedContent({ data, onCreateDraft, onRecover, t }) {
     const hasTasks = data.tasks.length > 0;
     // Empty state — surface nextAction from the API (rc-9: no silent fallback)
     if (!hasTasks) {
@@ -219,11 +292,11 @@ function LoadedContent({ data, onCreateDraft, t }) {
                     const tasks = grouped.get(kind);
                     if (!tasks || tasks.length === 0)
                         return null;
-                    return (_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Badge, { variant: "outline", children: t("pages.failedTasks.kind") }), _jsxs(CardTitle, { className: "text-[15px] font-mono", children: [kind, " (", tasks.length, ")"] })] }) }), _jsx(CardContent, { children: _jsx(TaskTable, { tasks: tasks, onCreateDraft: onCreateDraft, t: t }) })] }, kind));
+                    return (_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Badge, { variant: "outline", children: t("pages.failedTasks.kind") }), _jsxs(CardTitle, { className: "text-[15px] font-mono", children: [kind, " (", tasks.length, ")"] })] }) }), _jsx(CardContent, { children: _jsx(TaskTable, { tasks: tasks, onCreateDraft: onCreateDraft, onRecover: onRecover, t: t }) })] }, kind));
                 }) }), _jsxs("div", { className: "mt-8 font-mono text-[11px] text-ink-4 space-y-1", children: [_jsxs("div", { children: [t("common.total"), ": ", data.total] }), data.total > data.tasks.length && (_jsx("div", { className: "text-amber/80 leading-relaxed", children: t("pages.failedTasks.partialResults")
                             .replace("{shown}", String(data.tasks.length))
                             .replace("{total}", String(data.total)) }))] })] }));
 }
-function TaskTable({ tasks, onCreateDraft, t }) {
-    return (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "grid grid-cols-[minmax(0,1fr)_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto] gap-3 pb-2 border-b border-line font-mono text-[10px] uppercase tracking-[0.08em] text-ink-4", children: [_jsx("span", { children: t("pages.failedTasks.taskId") }), _jsx("span", { children: t("pages.failedTasks.painId") }), _jsx("span", { children: t("pages.failedTasks.status") }), _jsx("span", { children: t("pages.failedTasks.lastError") }), _jsx("span", { children: t("pages.failedTasks.attempts") }), _jsx("span", { children: t("pages.failedTasks.lastAttempt") }), _jsx("span", { "aria-hidden": "true" })] }), tasks.map((task) => (_jsxs("div", { className: "grid grid-cols-[minmax(0,1fr)_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto] gap-3 py-2 items-center text-[13px] border-b border-line/50 last:border-b-0", children: [_jsx("span", { className: "font-mono text-ink-2 truncate", title: task.taskId, children: truncateId(task.taskId) }), _jsx("span", { className: "font-mono text-ink-3 truncate", title: task.painId ?? "", children: task.painId ? truncateId(task.painId) : t("pages.failedTasks.noPainId") }), _jsx(Badge, { variant: statusToVariant(task.status), children: task.status }), _jsx("span", { className: "text-ink-3 truncate", title: task.lastError ?? "", children: task.lastError ?? "—" }), _jsx("span", { className: "font-mono text-ink-2 text-center", children: task.attemptCount }), _jsx("span", { className: "font-mono text-ink-3 text-[12px]", children: task.lastAttemptAt ? formatDate(task.lastAttemptAt) : "—" }), _jsx(Button, { variant: "outline", size: "sm", onClick: () => onCreateDraft(task), className: "whitespace-nowrap", children: t("pages.failedTasks.createDraft") })] }, task.taskId)))] }));
+function TaskTable({ tasks, onCreateDraft, onRecover, t }) {
+    return (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "grid grid-cols-[minmax(0,1fr)_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto] gap-3 pb-2 border-b border-line font-mono text-[10px] uppercase tracking-[0.08em] text-ink-4", children: [_jsx("span", { children: t("pages.failedTasks.taskId") }), _jsx("span", { children: t("pages.failedTasks.painId") }), _jsx("span", { children: t("pages.failedTasks.status") }), _jsx("span", { children: t("pages.failedTasks.lastError") }), _jsx("span", { children: t("pages.failedTasks.attempts") }), _jsx("span", { children: t("pages.failedTasks.lastAttempt") }), _jsx("span", { "aria-hidden": "true" })] }), tasks.map((task) => (_jsxs("div", { className: "grid grid-cols-[minmax(0,1fr)_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto] gap-3 py-2 items-center text-[13px] border-b border-line/50 last:border-b-0", children: [_jsx("span", { className: "font-mono text-ink-2 truncate", title: task.taskId, children: truncateId(task.taskId) }), _jsx("span", { className: "font-mono text-ink-3 truncate", title: task.painId ?? "", children: task.painId ? truncateId(task.painId) : t("pages.failedTasks.noPainId") }), _jsx(Badge, { variant: statusToVariant(task.status), children: task.status }), _jsx("span", { className: "text-ink-3 truncate", title: task.lastError ?? "", children: task.lastError ?? "—" }), _jsx("span", { className: "font-mono text-ink-2 text-center", children: task.attemptCount }), _jsx("span", { className: "font-mono text-ink-3 text-[12px]", children: task.lastAttemptAt ? formatDate(task.lastAttemptAt) : "—" }), onRecover && (_jsx(Button, { variant: "default", size: "sm", onClick: () => onRecover(task), className: "whitespace-nowrap", children: t("pages.failedTasks.recover") })), _jsx(Button, { variant: "outline", size: "sm", onClick: () => onCreateDraft(task), className: "whitespace-nowrap", children: t("pages.failedTasks.createDraft") })] }, task.taskId)))] }));
 }

package/console/dist/ui/pages/focus/FocusPage.js

@@ -426,7 +426,11 @@ export function FocusPage() {
     const ruleCodePending = ruleCodeItems.filter(item => item.action === 'code_tool_hook_shadow_activate' && item.enforcement !== 'safety_isolated');
     const ruleCodeAlerts = ruleCodeItems.filter(item => item.enforcement === 'safety_isolated');
     // Map codes to i18n text
-    const stateReason = getStateReasonText(stateReasonCode, t, pendingCount);
+    // Governance Recovery Actions v1: tasks_need_human_review interpolates the
+    // needs_human_review task count, not the approvals count.
+    const humanReviewCount = queueData?.pendingHumanReviewCount ?? 0;
+    const stateReasonCount = stateReasonCode === "tasks_need_human_review" ? humanReviewCount : pendingCount;
+    const stateReason = getStateReasonText(stateReasonCode, t, stateReasonCount);
     const nextAction = getNextActionText(nextActionCode, t);
     return (_jsx(PageShell, { children: _jsxs("div", { className: "animate-[pdFadeIn_400ms_ease-out]", children: [_jsx("div", { className: "font-mono text-[12px] tracking-[0.14em] text-ink-3 uppercase mb-3", children: t("pages.focus.eyebrow") }), _jsx(ShinyText, { as: "h1", className: "text-[29px] font-semibold tracking-tight text-ink mb-2", duration: 4.5, brightness: 0.5, disabled: pendingCount === 0, children: t("pages.focus.title") }), _jsx("p", { className: "text-ink-3 text-[14px] max-w-[760px] leading-relaxed mb-7", children: t("pages.focus.subtitle") }), _jsxs("div", { className: "mb-7 px-[18px] py-[14px] bg-panel border border-line rounded-[6px]", children: [_jsx("div", { className: "flex items-center gap-2 mb-1", children: _jsx("span", { className: `inline-flex items-center rounded-[2px] px-[7px] py-1 font-mono text-[11px] uppercase ${governanceState === "owner_review_ready"
                                     ? "bg-gov/10 text-gov border border-gov/20"

package/console/dist/ui/utils/validators.d.ts

@@ -219,6 +219,8 @@ export interface DegradedSignalData {
 export interface GovernanceQueueData {
     pendingReviewCount: number;
     behaviorDeviationCount: number;
+    /** Governance Recovery Actions v1: needs_human_review internalization tasks (owner-attention items) */
+    pendingHumanReviewCount?: number;
     stagnationSignals: StagnationSignalData[];
     governanceState: 'none' | 'in_progress' | 'owner_review_ready' | 'degraded';
     stateReasonCode: string;
@@ -232,6 +234,15 @@ export interface GovernanceQueueData {
     note?: string;
     generatedAt?: string;
 }
+export interface RecoveryResultData {
+    taskId: string;
+    previousStatus: string;
+    newStatus: string;
+    /** 'recovered' (failed→pending) | 'requeued' (needs_human_review→pending) */
+    result: string;
+    nextAction?: string;
+}
+export declare function validateRecoveryResult(v: unknown): RecoveryResultData | null;
 export declare function validateGovernanceQueue(v: unknown): GovernanceQueueData | null;
 export interface ActivationRecordData {
     activationId: string;

package/console/dist/ui/utils/validators.js

@@ -596,10 +596,12 @@ function validateStagnationSignal(v) {
 const VALID_GOVERNANCE_STATES = new Set(['none', 'in_progress', 'owner_review_ready', 'degraded']);
 const VALID_STATE_REASON_CODES = new Set([
     'state_db_missing', 'no_pipeline_activity', 'pending_approvals',
+    'tasks_need_human_review',
     'pipeline_active', 'consumed_candidates', 'degraded_state',
 ]);
 const VALID_NEXT_ACTION_CODES = new Set([
     'run_config_doctor', 'wait_for_pipeline', 'review_approvals',
+    'review_failed_tasks',
     'check_degraded_signals', 'check_pipeline_status',
 ]);
 const VALID_DEGRADED_REASON_CODES = new Set(['task_retry_wait', 'task_failed', 'approval_table_missing', 'trajectory_db_unavailable']);
@@ -629,6 +631,30 @@ function validateDegradedSignal(v) {
         source: v.source,
     };
 }
+export function validateRecoveryResult(v) {
+    if (!isObject(v))
+        return null;
+    if (!Object.hasOwn(v, 'taskId') || !isString(v.taskId))
+        return null;
+    if (!Object.hasOwn(v, 'previousStatus') || !isString(v.previousStatus))
+        return null;
+    if (!Object.hasOwn(v, 'newStatus') || !isString(v.newStatus))
+        return null;
+    if (!Object.hasOwn(v, 'result') || !isString(v.result))
+        return null;
+    const result = {
+        taskId: v.taskId,
+        previousStatus: v.previousStatus,
+        newStatus: v.newStatus,
+        result: v.result,
+    };
+    if (Object.hasOwn(v, 'nextAction')) {
+        if (!isString(v.nextAction))
+            return null;
+        result.nextAction = v.nextAction;
+    }
+    return result;
+}
 export function validateGovernanceQueue(v) {
     if (!isObject(v))
         return null;
@@ -699,6 +725,12 @@ export function validateGovernanceQueue(v) {
             return null;
         result.evidenceInProgressCount = v.evidenceInProgressCount;
     }
+    // Governance Recovery Actions v1: needs_human_review task count
+    if (Object.hasOwn(v, 'pendingHumanReviewCount')) {
+        if (!isNumber(v.pendingHumanReviewCount))
+            return null;
+        result.pendingHumanReviewCount = v.pendingHumanReviewCount;
+    }
     // Wave 4: gate blocks today (seconds-level auto-blocks)
     if (Object.hasOwn(v, 'gateBlocksToday')) {
         if (!isNumber(v.gateBlocksToday))