' + escape(item.title) + '
' +
+ 'Project ' + escape(item.project) + '
' +
+ 'Exact candidate ' + escape(item.candidate_hash) + '
' +
+ 'Score ' + escape(item.score?.value ?? 'not supplied') + ' · ' + escape(item.score?.provenance || '') + '
' +
+ 'Artifacts
Links
' +
+ 'Checks
Provenance
' +
+ 'History
' +
+ '' +
+ '' +
+ '' +
+ '' +
+ '' +
+ '' +
+ '
'
+ );
+ }
+
+ async function load() {
+ const epoch = ++loadEpoch;
+ const accountKey = String(getAccountKey() || '').trim().toLowerCase();
+ if (accountKey !== loadedAccountKey) {
+ loadedAccountKey = accountKey;
+ queue = { pending_count: 0, items: [] };
+ reviewSnapshot = [];
+ reviewIndex = -1;
+ render();
+ }
+ const cached = restore();
+ if (cached) { queue = cached; render(); }
+ try {
+ const live = validSnapshot(await fetchJson('api/v1/human-gates'));
+ 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() };
+ save(queue);
+ render();
+ return queue;
+ } catch (error) {
+ if (epoch !== loadEpoch || accountKey !== loadedAccountKey) return queue;
+ if (!cached) throw error;
+ setText(nodes.status, 'Offline cached gate list · reconnect before deciding.');
+ return queue;
+ }
+ }
+
+ function reviewNext() {
+ if (reviewIndex < 0) {
+ reviewSnapshot = queue.items.slice();
+ reviewIndex = 0;
+ }
+ const item = reviewSnapshot[reviewIndex] || null;
+ renderDetail(item);
+ if (item) {
+ const index = reviewIndex;
+ fetchJson('api/v1/human-gates/' + encodeURIComponent(item.id)).then(detail => {
+ if (!detail || detail.id !== item.id) throw new Error('Gate detail is invalid.');
+ if (reviewIndex !== index || reviewSnapshot[index]?.id !== item.id) return;
+ reviewSnapshot[index] = detail;
+ renderDetail(detail);
+ }).catch(() => { setText(nodes.status, 'Gate detail is unavailable. Retry while online.'); });
+ }
+ return item;
+ }
+
+ function select(gateId) {
+ if (reviewIndex < 0) reviewSnapshot = queue.items.slice();
+ const index = reviewSnapshot.findIndex(item => item.id === gateId);
+ if (index < 0) throw new Error('Gate is not in the current review snapshot.');
+ reviewIndex = index;
+ return reviewNext();
+ }
+
+ function current() { return reviewIndex < 0 ? null : (reviewSnapshot[reviewIndex] || null); }
+ function idempotencyKey(item, decision, payload) {
+ const operation = item.id + ':' + item.revision + ':' + decision + ':' + JSON.stringify(payload);
+ 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;
+ decisionKeys.set(operation, key);
+ return { operation, key };
+ }
+
+ async function decideAndNext(decision, values = {}) {
+ const item = current();
+ if (!item) throw new Error('No gate is selected.');
+ if (!isOnline()) throw new Error('Human Gate decisions require an online connection.');
+ if (!String(getLogin() || '').trim()) throw new Error('Authenticated account identity is required.');
+ const checklist = values.checklist || {};
+ const complete = ['exact_hash', 'artifacts_reviewed', 'provenance_reviewed'].every(key => checklist[key] === true);
+ if (decision === 'release' && !complete) throw new Error('Complete the release checklist before deciding.');
+ const unmet = (item.checks || []).filter(check => check.required && check.state !== 'success');
+ if (decision === 'release' && unmet.length && !String(values.override_reason || '').trim()) {
+ throw new Error('An explicit override reason is required for unmet required checks.');
+ }
+ if (decision === 'hold' && !String(values.reason || '').trim()) throw new Error('A hold reason is required.');
+ const payload = {
+ expected_revision: item.revision, decision,
+ reason: String(values.reason || '').trim(),
+ override_reason: String(values.override_reason || '').trim(), checklist,
+ };
+ 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);
+ queue.items = queue.items.filter(candidate => candidate.id !== item.id);
+ queue.pending_count = Math.max(0, queue.pending_count - 1);
+ save(queue); render();
+ 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 };
+ })();
+ decisionFlight = operation;
+ try {
+ return await operation;
+ } finally {
+ if (decisionFlight === operation) decisionFlight = null;
+ }
+ }
+
+ function open() {
+ location.hash = '#/my-work/human-gates';
+ if (nodes.panel) nodes.panel.hidden = false;
+ return load().then(() => reviewNext());
+ }
+
+ return {
+ load, open, reviewNext, select, decideAndNext, current,
+ restoreCached: restore,
+ snapshot: () => JSON.parse(JSON.stringify(queue)),
+ route: () => location.hash,
+ };
+}
+
+if (typeof module !== 'undefined') module.exports = createHumanGates;
+if (typeof window !== 'undefined') window.createHumanGates = createHumanGates;
diff --git a/frontend/index.html b/frontend/index.html
index 1ad952b..ee574a3 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -187,7 +187,16 @@