feat: recover interrupted Human Gate decisions (Closes #1446)

frontend/dashboard.css

@@ -1626,5 +1626,6 @@ textarea { resize: vertical; min-height: 120px; }
 .human-gates{position:fixed;inset:0;z-index:72;background:var(--bg);overflow:auto;padding:18px max(16px,env(safe-area-inset-right)) max(24px,env(safe-area-inset-bottom)) max(16px,env(safe-area-inset-left))}
 .human-gates[hidden]{display:none}.human-gates-header{display:flex;align-items:flex-start;justify-content:space-between;gap:12px;max-width:760px;margin:0 auto 14px}.human-gates-header h3{margin:0}.human-gates-list,.human-gate-detail-host{display:grid;gap:10px;max-width:760px;margin:0 auto 14px}.human-gate-card{display:grid;grid-template-columns:1fr auto;text-align:left;gap:6px 12px;min-height:58px;padding:12px;border:1px solid var(--border);border-radius:14px;background:var(--panel)}.human-gate-card span{grid-column:1/-1;color:var(--muted)}.human-gate-detail{display:grid;gap:12px;padding:16px;border:1px solid var(--border);border-radius:16px;background:var(--panel)}.human-gate-detail h3,.human-gate-detail h4,.human-gate-detail p{margin:0}.human-gate-detail label{display:grid;gap:6px}.human-gate-detail label:has(input[type=checkbox]){grid-template-columns:auto 1fr;align-items:center}.human-gate-detail textarea{min-height:78px}.human-gate-decision-tray{display:grid;gap:10px}.human-gate-decision-state{display:grid;gap:4px}.human-gate-decision-state [data-gate-error]{color:var(--danger,#fb7185)}.human-gate-decision-actions{display:grid;grid-template-columns:1fr 1fr;gap:10px}.human-gate-decision-actions button{min-height:44px}.human-gates-zero{display:grid;gap:6px;text-align:center;padding:32px 16px;border:1px dashed var(--border);border-radius:16px}.human-gates-launcher span{display:inline-grid;place-items:center;min-width:22px;border-radius:999px;background:var(--accent);color:#06101f}
 .human-gate-views{display:grid;grid-template-columns:1fr 1fr;gap:8px;max-width:760px;margin:0 auto 14px}.human-gate-views button{min-height:44px}.human-gate-views button[aria-pressed="true"]{border-color:var(--accent);background:rgba(96,165,250,.14)}.human-gate-history-card time{font-size:.78rem;color:var(--muted)}.human-gate-history-more{min-height:44px;width:100%;padding:max(10px,env(safe-area-inset-bottom)) 12px}.human-gate-state{font-weight:700}.human-gate-state-released{color:#86efac}.human-gate-state-held{color:#fbbf24}.human-gate-state-superseded{color:#cbd5e1}.human-gate-receipt{padding-bottom:16px}
+.human-gate-decision-recovery{border-color:#f59e0b}.human-gate-decision-recovery .human-gate-decision-state span{color:var(--muted)}.human-gate-decision-recovery button{min-height:44px;min-width:140px}
 @media(max-width:600px){.human-gate-detail{padding-bottom:calc(124px + env(safe-area-inset-bottom))}.human-gate-decision-tray{position:sticky;bottom:calc(-1 * max(24px,env(safe-area-inset-bottom)));z-index:4;margin:0 -16px calc(-124px - env(safe-area-inset-bottom));padding:12px 16px;padding-bottom:max(16px,env(safe-area-inset-bottom));border-top:1px solid var(--border);background:rgba(11,21,38,.97);box-shadow:0 -12px 24px rgba(0,0,0,.32);backdrop-filter:blur(10px)}}
 @media(min-width:761px){.human-gates{inset:8% max(8%,80px);border:1px solid var(--border);border-radius:20px;box-shadow:0 24px 80px rgba(0,0,0,.4)}}

frontend/dashboard.js

@@ -704,6 +704,15 @@
       qs('#human-gates-status').textContent = error.message;
     }));
     qs('#human-gate-detail').addEventListener('click', event => {
+      const recovery = event.target.closest('[data-gate-recover]');
+      if (recovery) {
+        recovery.disabled = true;
+        humanGates.recoverDecision().catch(error => {
+          qs('#human-gates-status').textContent = error.message || 'The decision outcome could not be verified.';
+          recovery.disabled = false;
+        });
+        return;
+      }
       const decision = event.target.closest('[data-gate-decision]')?.dataset.gateDecision;
       if (!decision) return;
       humanGates.submitDecision(decision).catch(error => {

frontend/human-gates.js

@@ -26,6 +26,8 @@ function createHumanGates(options = {}) {
   const cacheKey = () => 'stackchain.human-gates.v1:' + String(getAccountKey() || '').trim().toLowerCase();
   const progressKey = item => 'stackchain.human-gate-review.v1:' +
     String(getAccountKey() || '').trim().toLowerCase() + ':' + item.id + ':' + item.revision;
+  const decisionStorageKey = () => 'stackchain.human-gate-decision.v1:' +
+    String(getAccountKey() || '').trim().toLowerCase();
   const setText = (node, value) => { if (node) node.textContent = value; };
   const setHtml = (node, value) => { if (node) node.innerHTML = value; };
   const publish = state => onChange?.(JSON.parse(JSON.stringify(queue)), state);
@@ -65,6 +67,26 @@ function createHumanGates(options = {}) {
     try { storage.setItem(progressKey(item), JSON.stringify(progress)); return true; } catch (_) { return false; }
   }
 
+  function restorePendingDecision(item = null) {
+    if (!getLogin()) return null;
+    try {
+      const value = JSON.parse(storage.getItem(decisionStorageKey()) || 'null');
+      if (!value || typeof value !== 'object' || !value.idempotency_key || !value.operation ||
+          !value.payload || !value.gate_id || !Number.isInteger(value.revision)) return null;
+      if (item && (value.gate_id !== item.id || value.revision !== item.revision)) return null;
+      return value;
+    } catch (_) { return null; }
+  }
+
+  function savePendingDecision(value) {
+    storage.setItem(decisionStorageKey(), JSON.stringify(value));
+  }
+
+  function clearPendingDecision(item) {
+    if (!restorePendingDecision(item)) return;
+    try { storage.removeItem?.(decisionStorageKey()); } catch (_) {}
+  }
+
   function valuesFromDetail() {
     const checklist = Object.fromEntries(Array.from(nodes.detail?.querySelectorAll?.('[data-gate-checklist]') || []).map(input => [input.dataset.gateChecklist, input.checked]));
     return {
@@ -215,6 +237,7 @@ function createHumanGates(options = {}) {
       return;
     }
     const progress = restoreProgress(item) || {checklist:{}, reason:'', override_reason:''};
+    const pendingDecision = restorePendingDecision(item);
     const checked = key => progress.checklist?.[key] === true ? ' checked' : '';
     const checks = (item.checks || []).map(check =>
       '<li class="gate-check gate-check-' + escape(check.state) + '"><strong>' + escape(check.name) + '</strong> · ' + escape(check.state) + (check.required ? ' · required' : '') + '</li>'
@@ -236,11 +259,14 @@ function createHumanGates(options = {}) {
       '<label><input type="checkbox" data-gate-checklist="provenance_reviewed"' + checked('provenance_reviewed') + '> Provenance reviewed</label>' +
       '<label>Hold reason<textarea data-gate-reason>' + escape(progress.reason) + '</textarea></label>' +
       '<label>Override reason<textarea data-gate-override>' + escape(progress.override_reason) + '</textarea></label>' +
-      '<div class="human-gate-decision-tray"><div class="human-gate-decision-state">' +
-      '<strong data-gate-readiness>0 of 3 confirmations complete</strong>' +
-      '<span data-gate-error role="alert" hidden></span></div>' +
-      '<div class="human-gate-decision-actions"><button type="button" data-gate-decision="hold">Hold &amp; next</button>' +
-      '<button type="button" data-gate-decision="release">Release &amp; next</button></div></div></article>'
+      '<div class="human-gate-decision-tray' + (pendingDecision ? ' human-gate-decision-recovery' : '') + '"><div class="human-gate-decision-state">' +
+      (pendingDecision ? '<strong>Decision outcome unknown</strong><span role="status">The previous ' + escape(pendingDecision.decision) +
+        ' response was interrupted. Verify it before making another decision.</span>' :
+        '<strong data-gate-readiness>0 of 3 confirmations complete</strong><span data-gate-error role="alert" hidden></span>') + '</div>' +
+      '<div class="human-gate-decision-actions">' + (pendingDecision ?
+        '<button type="button" data-gate-recover>Verify decision</button>' :
+        '<button type="button" data-gate-decision="hold">Hold &amp; next</button><button type="button" data-gate-decision="release">Release &amp; next</button>') +
+      '</div></div></article>'
     );
     updateReadiness();
   }
@@ -266,6 +292,16 @@ function createHumanGates(options = {}) {
       if (epoch !== loadEpoch || accountKey !== loadedAccountKey) return queue;
       if (!live) throw new Error('Human Gates response is invalid.');
       queue = { pending_count: live.pending_count, items: live.items.slice() };
+      const interrupted = restorePendingDecision();
+      if (interrupted && interrupted.item?.id === interrupted.gate_id && interrupted.item.revision === interrupted.revision) {
+        const recoveryItem = {...interrupted.item, decision_recovery:true};
+        const existingIndex = queue.items.findIndex(candidate => candidate.id === interrupted.gate_id);
+        if (existingIndex >= 0) queue.items[existingIndex] = recoveryItem;
+        else {
+          queue.items.unshift(recoveryItem);
+          queue.pending_count += 1;
+        }
+      }
       save(queue);
       render();
       publish({available:true, authoritative:true});
@@ -311,6 +347,8 @@ function createHumanGates(options = {}) {
   function current() { return reviewIndex < 0 ? null : (reviewSnapshot[reviewIndex] || null); }
   function idempotencyKey(item, decision, payload) {
     const operation = item.id + ':' + item.revision + ':' + decision + ':' + JSON.stringify(payload);
+    const pending = restorePendingDecision(item);
+    if (pending?.operation === operation) return { operation, key: pending.idempotency_key };
     if (decisionKeys.has(operation)) return { operation, key: decisionKeys.get(operation) };
     const nonce = globalThis.crypto?.randomUUID?.() || (Date.now().toString(36) + '-' + Math.random().toString(36).slice(2));
     const key = 'human-gate:' + item.id + ':' + item.revision + ':' + decision + ':' + nonce;
@@ -318,6 +356,30 @@ function createHumanGates(options = {}) {
     return { operation, key };
   }
 
+  function completeDecision(item, decision, operation, receipt) {
+    decisionKeys.delete(operation);
+    clearPendingDecision(item);
+    try { storage.removeItem?.(progressKey(item)); } catch (_) {}
+    queue.items = queue.items.filter(candidate => candidate.id !== item.id);
+    queue.pending_count = Math.max(0, queue.pending_count - 1);
+    save(queue); render();
+    publish({available:true, authoritative:true, decision:true});
+    reviewIndex += 1;
+    const next = current();
+    if (next) reviewNext(); else renderDetail(null);
+    setText(nodes.status, next ? (decision === 'release' ? 'Released. Reviewing next gate.' : 'Held. Reviewing next gate.') : 'Decision saved. Human Gates review snapshot complete.');
+    return { receipt, next };
+  }
+
+  async function postDecision(item, pending) {
+    const receipt = await fetchJson('api/v1/human-gates/' + encodeURIComponent(item.id) + '/decision', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'Idempotency-Key': pending.idempotency_key },
+      body: JSON.stringify(pending.payload),
+    });
+    return completeDecision(item, pending.decision, pending.operation, receipt);
+  }
+
   function decisionError(message, selector) {
     const error = new Error(message);
     error.targetSelector = selector;
@@ -351,22 +413,19 @@ function createHumanGates(options = {}) {
     if (decisionFlight) return decisionFlight;
     const operation = (async () => {
       const decisionKey = idempotencyKey(item, decision, payload);
-      const receipt = await fetchJson('api/v1/human-gates/' + encodeURIComponent(item.id) + '/decision', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json', 'Idempotency-Key': decisionKey.key },
-        body: JSON.stringify(payload),
-      });
-      decisionKeys.delete(decisionKey.operation);
-      try { storage.removeItem?.(progressKey(item)); } catch (_) {}
-      queue.items = queue.items.filter(candidate => candidate.id !== item.id);
-      queue.pending_count = Math.max(0, queue.pending_count - 1);
-      save(queue); render();
-      publish({available:true, authoritative:true, decision:true});
-      reviewIndex += 1;
-      const next = current();
-      if (next) reviewNext(); else renderDetail(null);
-      setText(nodes.status, next ? (decision === 'release' ? 'Released. Reviewing next gate.' : 'Held. Reviewing next gate.') : 'Decision saved. Human Gates review snapshot complete.');
-      return { receipt, next };
+      const pending = {
+        gate_id:item.id, revision:item.revision, decision, payload,
+        operation:decisionKey.operation, idempotency_key:decisionKey.key,
+        item:JSON.parse(JSON.stringify(item)),
+      };
+      savePendingDecision(pending);
+      try {
+        return await postDecision(item, pending);
+      } catch (error) {
+        renderDetail(item);
+        setText(nodes.status, 'Decision outcome unknown. Verify the interrupted decision while online.');
+        throw error;
+      }
     })();
     decisionFlight = operation;
     try {
@@ -376,6 +435,20 @@ function createHumanGates(options = {}) {
     }
   }
 
+  async function recoverDecision() {
+    const item = current();
+    if (!item) throw new Error('No gate is selected.');
+    if (!isOnline()) throw new Error('Decision verification requires an online connection.');
+    if (!String(getLogin() || '').trim()) throw new Error('Authenticated account identity is required.');
+    const pending = restorePendingDecision(item);
+    if (!pending) throw new Error('No interrupted decision exists for this gate revision.');
+    if (decisionFlight) return decisionFlight;
+    const operation = postDecision(item, pending);
+    decisionFlight = operation;
+    try { return await operation; }
+    finally { if (decisionFlight === operation) decisionFlight = null; }
+  }
+
   async function submitDecision(decision) {
     const values = valuesFromDetail();
     updateReadiness(values);
@@ -425,7 +498,7 @@ function createHumanGates(options = {}) {
 
   return {
     load, open, reviewNext, select, showHistory, loadMoreHistory, selectHistory, showPending,
-    decideAndNext, submitDecision, current, saveProgress,
+    decideAndNext, recoverDecision, submitDecision, current, saveProgress,
     setOnChange(callback) { onChange = callback; },
     restoreCached: restore,
     snapshot: () => JSON.parse(JSON.stringify(queue)),

frontend/progressive-human-gates.js

@@ -49,6 +49,15 @@ function createProgressiveHumanGates(options = {}) {
     if (card) controller.select(card.dataset.humanGateId);
   });
   nodes.detail?.addEventListener?.('click', event => {
+    const recovery = event.target?.closest?.('[data-gate-recover]');
+    if (recovery) {
+      recovery.disabled = true;
+      controller.recoverDecision().catch(error => {
+        showError(error);
+        recovery.disabled = false;
+      });
+      return;
+    }
     const decision = event.target?.closest?.('[data-gate-decision]')?.dataset.gateDecision;
     if (!decision) return;
     controller.submitDecision(decision).catch(error => {

frontend/service-worker.js

@@ -1,7 +1,7 @@
 const BASE = new URL('./', self.location.href).pathname;
 importScripts(BASE + 'static/private-data-registry.js');
 importScripts(BASE + 'static/background-issue-sync.js');
-const CACHE = 'stackchain-dashboard-shell-v149';
+const CACHE = 'stackchain-dashboard-shell-v150';
 const OFFLINE_LEASE_URL = new URL(BASE + '__offline-session-lease', self.location.origin).href;
 const OUTAGE_STATUSES = new Set([500, 502, 503, 504]);
 const NAVIGATION_TIMEOUT_MS = self.__STACKCHAIN_NAVIGATION_TIMEOUT_MS || 4000;