instar 1.3.1305 → 1.3.1307

package/dashboard/feedback-readiness-authority.js

@@ -0,0 +1,155 @@
+/**
+ * Feedback Drain tab — the operator's approve/revoke card for the readiness authority
+ * (docs/specs/feedback-factory-operating-drain.md §2, "operator-rooted").
+ *
+ * The drain refuses every tick until an operator registers which model may decide
+ * which feedback reports become work items. That registration was PIN-only with no
+ * screen. This card is the screen: the server computes every technical field
+ * (GET /feedback-factory/readiness-authorities/proposal); the operator sees one plain
+ * sentence, may adjust the batch size and daily cap, and approves with the PIN.
+ * The POST sends `useProposal: true`, so the server — not this page — fills in the
+ * binding fields. Every dynamic value is written with textContent, never innerHTML.
+ */
+
+function el(doc, tag, cls, text) {
+  const n = doc.createElement(tag);
+  if (cls) n.className = cls;
+  if (text !== undefined && text !== null) n.textContent = String(text);
+  return n;
+}
+
+/** One line on where the authority stands, in the operator's words. */
+export function statusLine(p) {
+  const s = (p && p.status) || 'none';
+  const cur = (p && p.current) || null;
+  if (s === 'none') return 'Not set up yet — the feedback drain is waiting for your approval before it sorts anything.';
+  if (s === 'revoked') return `Revoked (version ${cur ? cur.generation : '?'}). The drain is not sorting feedback.`;
+  if (s === 'proposal-only') {
+    return `Paused by a safety brake (version ${cur ? cur.generation : '?'}) — for example the daily cap was reached or the model answer did not check out. Approve again to resume.`;
+  }
+  if (cur && cur.matchesProposal === false) {
+    return `Active (version ${cur.generation}), but out of date for this machine — approve to update it.`;
+  }
+  return `Active (version ${cur ? cur.generation : '?'}): up to ${cur ? cur.maxBatch : '?'} reports per batch, at most $${cur ? cur.maxDailySpendUsd : '?'} per day.`;
+}
+
+/** A unique, bounded reference recorded in the authority's audit chain. */
+export function newDecisionRef(now = new Date(), rand = Math.random) {
+  const suffix = Math.floor(rand() * 0xffffffff).toString(16).padStart(8, '0');
+  return `dashboard:${now.toISOString().replace(/[^0-9A-Za-z]/g, '')}:${suffix}`;
+}
+
+/** The POST body for an approve (create/replace/restore) or revoke. */
+export function authorityRequest(action, envelope, pin, operatorDecisionRef) {
+  const body = { action, pin, operatorDecisionRef };
+  if (action === 'create' || action === 'replace') {
+    body.useProposal = true;
+    // An emptied field means "use the default", never 0.
+    for (const k of ['maxBatch', 'maxTokens', 'maxDailySpendUsd']) {
+      const v = String(envelope[k] ?? '').trim();
+      if (v !== '') body[k] = Number(v);
+    }
+  }
+  return body;
+}
+
+/** What to show after the server answers a mutation. */
+export function resultNote(ok, data) {
+  if (ok) {
+    return data && data.revoked
+      ? `Revoked. The drain stops sorting feedback from its next run (version ${data.generation}).`
+      : `Approved (version ${data ? data.generation : '?'}). The next drain run will start sorting feedback.`;
+  }
+  const m = String((data && data.error) || '');
+  if (/incorrect pin|pin required/i.test(m)) return 'That PIN was not accepted. Nothing has changed.';
+  if (/too many/i.test(m)) return 'Too many PIN attempts — wait a few minutes. Nothing has changed.';
+  return `Not applied: ${m || 'the server refused'}. Nothing has changed.`;
+}
+
+function numberField(doc, label, id, value, hint) {
+  const wrap = el(doc, 'label', 'spend-arm-field');
+  wrap.appendChild(el(doc, 'span', null, label));
+  const input = el(doc, 'input', 'spend-arm-input');
+  input.type = 'number';
+  input.inputMode = 'decimal';
+  input.id = id;
+  input.value = String(value);
+  wrap.appendChild(input);
+  if (hint) wrap.appendChild(el(doc, 'span', 'spend-arm-hint', hint));
+  return { wrap, input };
+}
+
+/**
+ * Render the card into `target`. `handlers.submit(action, envelope, pin)` performs the
+ * POST and resolves to a note string; `handlers.preview(envelope)` re-reads the proposal
+ * so the plain sentence follows the operator's edits.
+ */
+export function renderAuthorityCard(doc, target, p, handlers = {}) {
+  if (!target) return;
+  target.replaceChildren();
+  target.appendChild(el(doc, 'h3', 'ph-h', 'Who decides which feedback becomes work'));
+  target.appendChild(el(doc, 'div', 'ph-detail-body', statusLine(p)));
+  if (!p) return;
+
+  const env = (p.proposal) || { maxBatch: 50, maxTokens: 1200, maxDailySpendUsd: 5 };
+  const summary = el(doc, 'div', 'spend-arm-plan-text', p.summary || '');
+  target.appendChild(summary);
+  for (const b of p.blockers || []) target.appendChild(el(doc, 'div', 'spend-arm-note', b));
+
+  const batch = numberField(doc, 'Reports per batch', 'fraMaxBatch', env.maxBatch, '1 to 50');
+  const spend = numberField(doc, 'Daily spend cap (USD)', 'fraMaxDailySpendUsd', env.maxDailySpendUsd, 'The drain stops for the day at this amount.');
+  const tokens = numberField(doc, 'Answer length limit (tokens)', 'fraMaxTokens', env.maxTokens, 'Leave as is unless asked.');
+  const details = el(doc, 'details', 'ph-detail');
+  details.appendChild(el(doc, 'summary', 'ph-detail-summary', 'Adjust limits'));
+  for (const f of [batch, spend, tokens]) details.appendChild(f.wrap);
+  if (p.proposal) {
+    details.appendChild(el(doc, 'div', 'spend-arm-hint',
+      `Bound to: agent ${p.proposal.agentId}; machine ${p.proposal.ownerMachineId} (epoch ${p.proposal.ownerEpoch}); ` +
+      `model ${p.proposal.modelFamily} via ${p.proposal.provider}.`));
+  }
+  target.appendChild(details);
+  const envelope = () => ({ maxBatch: batch.input.value, maxTokens: tokens.input.value, maxDailySpendUsd: spend.input.value });
+  if (typeof handlers.preview === 'function') {
+    for (const f of [batch, spend, tokens]) {
+      f.input.addEventListener('change', async () => {
+        const next = await handlers.preview(envelope());
+        if (next) {
+          summary.textContent = next.summary || '';
+        }
+      });
+    }
+  }
+
+  const pin = el(doc, 'input', 'spend-arm-pin');
+  pin.type = 'password';
+  pin.inputMode = 'numeric';
+  pin.id = 'fraPin';
+  pin.placeholder = 'Dashboard PIN';
+  pin.autocomplete = 'off';
+  target.appendChild(pin);
+
+  const note = el(doc, 'div', 'spend-arm-status');
+  note.id = 'fraNote';
+  note.setAttribute('aria-live', 'polite');
+  const btns = el(doc, 'div', 'spend-arm-btns');
+  const add = (label, action, cls) => {
+    const b = el(doc, 'button', `spend-arm-btn ${cls || ''}`.trim(), label);
+    b.setAttribute('data-fra-action', action);
+    b.addEventListener('click', async () => {
+      if (typeof handlers.submit !== 'function') return;
+      note.textContent = 'Working…';
+      note.textContent = await handlers.submit(action, envelope(), (pin.value || '').trim());
+    });
+    btns.appendChild(b);
+  };
+  if (p.approveAction === 'restore') {
+    target.appendChild(el(doc, 'div', 'spend-arm-note', 'Restore brings back the last approved limits. To change them, restore first, then save new limits.'));
+    add('Approve (restore)', 'restore', 'spend-arm-btn-commit');
+  }
+  else if (p.approveAction) add('Approve', p.approveAction, 'spend-arm-btn-commit');
+  // Already active and current: the only thing left to approve is a change of limits.
+  else if (p.status === 'active' && (p.blockers || []).length === 0) add('Save new limits', 'replace', 'spend-arm-btn-commit');
+  if (p.status === 'active' || p.status === 'proposal-only') add('Revoke', 'revoke');
+  target.appendChild(btns);
+  target.appendChild(note);
+}

package/dashboard/index.html

@@ -3670,6 +3670,7 @@
       <section class="ph-section"><h3 class="ph-h">Backlog</h3><div id="fdBacklog" class="ph-detail-body"></div></section>
       <section class="ph-section"><h3 class="ph-h">Progress</h3><div id="fdProgress" class="ph-detail-body"></div></section>
       <section class="ph-section"><h3 class="ph-h">Source integrity</h3><div id="fdSource" class="ph-detail-body"></div></section>
+      <section id="fdAuthority" class="ph-section spend-arm-root"></section>
     </div>
 
     <!-- subscriptions tab (Subscription & Auth Standard P2.2 — live quota + pending logins) -->
@@ -9985,8 +9986,41 @@
         fdText('fdStamp', '');
       }
     }
+    // Readiness authority approve/revoke card. Rendered on tab open and after each
+    // action — NOT on the 15s poll, which would wipe a PIN mid-entry.
+    let __fraModule = null;
+    async function loadFeedbackAuthority() {
+      const root = document.getElementById('fdAuthority');
+      if (!root) return;
+      if (!__fraModule) {
+        try { __fraModule = await import('/dashboard/feedback-readiness-authority.js'); }
+        catch (e) { console.error('[feedback-readiness-authority] module load failed', e); root.textContent = 'Loading the approval card failed — refresh to retry.'; return; }
+      }
+      const M = __fraModule;
+      const readProposal = async (envelope) => {
+        const qs = envelope ? '?' + new URLSearchParams(envelope).toString() : '';
+        try { return await apiFetch('/feedback-factory/readiness-authorities/proposal' + qs); } catch { return null; }
+      };
+      const proposal = await readProposal();
+      if (!proposal) { root.textContent = 'The readiness approval is unavailable while the drain is not live on this machine.'; return; }
+      M.renderAuthorityCard(document, root, proposal, {
+        preview: readProposal,
+        submit: async (action, envelope, pin) => {
+          const response = await fetch('/feedback-factory/readiness-authorities', {
+            method: 'POST',
+            headers: { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json', 'X-Instar-Request': '1' },
+            body: JSON.stringify(M.authorityRequest(action, envelope, pin, M.newDecisionRef())),
+          });
+          const data = await response.json().catch(() => ({}));
+          const note = M.resultNote(response.ok, data);
+          if (response.ok) { await loadFeedbackAuthority(); const n = document.getElementById('fraNote'); if (n) n.textContent = note; }
+          return note;
+        },
+      });
+    }
     function startFeedbackDrain() {
       stopFeedbackDrain();
+      void loadFeedbackAuthority();
       void loadFeedbackDrain();
       __fdTimer = setInterval(() => { void loadFeedbackDrain(); }, 15000);
     }

package/dist/commands/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/commands/server.ts"],"names":[],"mappings":"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"}

package/dist/commands/server.js

@@ -10288,6 +10288,7 @@ export async function startServer(options) {
                         disposition: e.disposition ?? 'terminal',
                         origin: e.origin ?? 'autonomous',
                         workEvidence: candidateWorkEvidence,
+                        ...(e.seenWorkingPastAgeLimit ? { seenWorkingPastAgeLimit: true } : {}),
                     });
                 }
             }