@lovek4d/kickflip 0.4.0 → 0.5.0

package/board/public/view-questions.js

@@ -7,8 +7,11 @@
 // whose options are prototype takes frames each take with ?take= (docs/adr/2026-10-29-1639-a-questions-takes-show-inline.md).
 // Each question's eye sends `prototype-request {key?, question, note, choice}` for that question instead of an answer,
 // with its note box as the note and its pick so far as the choice (docs/adr/2026-11-02-1822-each-question-has-its-own-prototype-eye.md).
-// The board server resolves the question with it, and once it is recorded the page moves on as a Send does
-// (docs/adr/2026-11-03-1803-a-question-asked-for-a-prototype-is-resolved.md).
+// The question then reads prototype requested, locked, until its prototype round arrives, and once the request is
+// recorded the page moves on as a Send does (docs/adr/2026-11-03-1803-a-question-asked-for-a-prototype-is-resolved.md,
+// docs/adr/2026-11-04-2130-a-prototype-request-waits-for-its-prototype.md).
+// A topic's resolved questions fold under "resolved (N)", read-only; a resolved question's badge, once confirmed, sends
+// `reask-request {key?, question}` (docs/adr/2026-11-04-2001-a-resolved-question-is-read-only-and-can-be-asked-again.md).
 // fits: each framed take's measured size, kept across repaints and visits so a take redraws at its size at once.
 (globalThis.AppViews ||= {}).questions = ((fits) => ({
   className: 'view-questions',
@@ -20,7 +23,7 @@
 
   create: (root, siteRoot, ctx) => BoardView.page(root, siteRoot, (B) => {
     const { $, site } = B;
-    const { esc, choiceLabel, questionCard, roundChip, takes, linkContext, badge, topicName, cardTopics, topicRow, nextQuestion, sentNotice, fetchJSON, restartNotice } = BoardUI;
+    const { esc, choiceLabel, choiceOf, questionCard, roundChip, takes, linkContext, badge, topicName, cardTopics, topicRow, nextQuestion, sentNotice, fetchJSON, restartNotice } = BoardUI;
     // prototype-switcher.js reads a draft's note and clears the draft once it sends that question's answer.
     const draftKey = (id) => 'qdraft:' + id;
     const getDraft = (id) => { try { return JSON.parse(localStorage.getItem(draftKey(id)) || '{}'); } catch { return {}; } };
@@ -42,6 +45,8 @@
     let sentLine = '';
     // The footer after a prototype request: the blue spinner, then these words.
     const PROTOTYPE_REQUESTED = 'prototype requested';
+    // The bar's line while a suggested option is still pre-checked.
+    const SUGGESTED = 'suggested options are selected';
     const statusHtml = (line) => (line.startsWith(PROTOTYPE_REQUESTED) ? '<span class="try-spin" aria-hidden="true"></span>' : '') + esc(line);
     let scrollTake = null;
     const takeResources = new Map();
@@ -68,15 +73,17 @@
     }
     const topicHead = (t) => t ? `<div class="topichead muted small"><span>${esc(t.title)}${t.summary ? ` · ${esc(t.summary)}` : ''}</span>${roundChip(t.round)}</div>` : '';
 
-    // Only questions changed here since their last answer, or with files attached, are sent.
+    // Only open questions changed here since their last answer, with files attached, or with a suggested option
+    // pre-checked and never answered, are sent; a resolved one is read-only.
     const filesOf = (q) => BoardAttach.files('q:' + q.id, site.root);
     const uploading = (qs) => qs.some((q) => BoardAttach.busy('q:' + q.id, site.root));
     function pending(qs) {
-      return qs.filter((q) => {
+      return qs.filter((q) => q.state !== 'resolved' && q.state !== 'requested').filter((q) => {
         const d = getDraft(q.id);
         if (filesOf(q).length) return true;
-        if (!('choice' in d) && !d.note) return false;
         const last = q.answers[q.answers.length - 1];
+        if (!last && q.suggested) return true;
+        if (!('choice' in d) && !d.note) return false;
         return !last || (d.choice ?? last.choice) !== last.choice || (d.note || '') !== (last.note || '');
       });
     }
@@ -117,7 +124,7 @@
         : `${topicBar()}${topicHead(t)}`;
       el.innerHTML = `${head}<form id="qform">
         ${live.map((q, i) => questionCard(q, { n: soloId ? 0 : i + 1, draft: getDraft(q.id), links: links(q), fit: fitOf(q) })).join('')}
-        ${done.length ? `<details class="done"><summary>Resolved · ${done.length}</summary>${done.map((q) => questionCard(q, { draft: getDraft(q.id), links: links(q), fit: fitOf(q) })).join('')}</details>` : ''}
+        ${done.length ? `<details class="done resolved-group"><summary><span class="caret" aria-hidden="true">›</span><span>resolved (${done.length})</span><span class="names">${done.map((q) => esc(q.id)).join(', ')}</span></summary>${done.map((q) => questionCard(q, { links: links(q) })).join('')}</details>` : ''}
         <div class="bar"><span class="muted small${sentLine ? ' sent' : ''}" id="qstatus" role="status">${statusHtml(sentLine)}</span><span class="send-hint" aria-hidden="true">${/Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent) ? '⌘↵' : 'Ctrl+↵'}</span><button class="primary" type="submit" id="send">Send</button></div>
       </form>${soloId ? '' : waitingTopics() + resolvedTopics()}`;
       BoardAttach.paintAll();
@@ -138,11 +145,9 @@
     function repaintTakes(sec) {
       if (!sec.querySelector('.takes')) return;
       const q = byId(sec.dataset.q);
-      const d = getDraft(q.id);
-      const chosen = d.choice ?? q.answers[q.answers.length - 1]?.choice;
       const old = sec.querySelector('.takes');
       clearTakeResources(old);
-      old.outerHTML = takes(q, chosen, links(q), fitOf(q));
+      old.outerHTML = takes(q, choiceOf(q, getDraft(q.id)), links(q), fitOf(q));
       sec.querySelectorAll('.take-shot').forEach(fitTake);
     }
 
@@ -257,14 +262,28 @@
       const at = leaving();
       st.textContent = '';
       const d = getDraft(q.id);
-      const last = q.answers[q.answers.length - 1];
       let out;
-      try { out = await BoardUI.waitOn(button, send('prototype-request', { ...(key ? { key } : {}), question: q.id, note: (d.note || '').trim(), choice: d.choice ?? (last ? last.choice : null) })); }
+      try { out = await BoardUI.waitOn(button, send('prototype-request', { ...(key ? { key } : {}), question: q.id, note: (d.note || '').trim(), choice: choiceOf(q, d) })); }
       catch (e) { st.textContent = e.reason ? `Nothing was sent: ${e.reason}` : 'Could not send. Is the host awake?'; return; }
       setDraft(q.id, {});
       await moveOnOnceLoaded(at, `Prototype requested${at.name ? ` for ${at.name}` : ''}.`, out, PROTOTYPE_REQUESTED);
     }
 
+    // A resolved question's badge asks Claude to ask it again from the card's current notes, once the owner confirms.
+    // The topic's resolved questions load again, so the question shows its re-ask under way.
+    async function askAgain(q, button) {
+      if (!(await BoardDialogs.confirm('Ask this again from today’s context?')) || !B.alive()) return;
+      const st = $('#qstatus');
+      const key = q.topic?.startsWith('item:') ? q.topic.slice(5) : null;
+      let out;
+      try { out = await BoardUI.waitOn(button, send('reask-request', { ...(key ? { key } : {}), question: q.id })); }
+      catch (e) { st.textContent = e.reason ? `Nothing was sent: ${e.reason}` : 'Could not send. Is the host awake?'; return; }
+      if (!B.alive()) return;
+      resolved = { topic: null, n: 0, questions: [] };
+      if (!land(out.board, false)) await load(false);
+      repaint(false);
+    }
+
     function updateBar() {
       const qs = visible();
       const n = pending(qs).length;
@@ -272,6 +291,10 @@
       if (b) { b.disabled = !n || uploading(qs); b.textContent = uploading(qs) ? 'Uploading…' : 'Send'; }
       const live = qs.filter((q) => q.state !== 'resolved');
       const answered = live.filter((q) => q.state !== 'open').length;
+      // docs/adr/2026-11-04-2200-overnight-triage-suggests-your-earlier-answers.md
+      const prechecked = live.some((q) => q.suggested && !q.answers.length && choiceOf(q, getDraft(q.id)) === q.suggested.option);
+      const st = $('#qstatus');
+      if (st && !sentLine && (prechecked || st.textContent === SUGGESTED)) st.textContent = prechecked ? SUGGESTED : '';
       $('#progress').textContent = live.length > 1 ? `${answered}/${live.length} answered` : '';
     }
 
@@ -283,7 +306,7 @@
       topicId = t ? t.id : null;
     }
 
-    const sigNow = () => JSON.stringify([soloId, topicId, topics.map((t) => [t.id, t.state, t.open, t.answered, t.round]), visible().map((q) => [q.id, q.state, q.answers.length, q.answers.map((a) => Boolean(a.reply))])]);
+    const sigNow = () => JSON.stringify([soloId, topicId, topics.map((t) => [t.id, t.state, t.open, t.answered, t.round]), visible().map((q) => [q.id, q.state, q.answers.length, q.answers.map((a) => Boolean(a.reply)), Boolean(q.reask)])]);
     // One load at a time: a load waiting out a board restart would otherwise overlap the next poll's. A load asked for
     // while one runs shares it. → true when the board's answer landed in this view.
     let loading = null;
@@ -362,8 +385,15 @@
       if (ev.target.id === 'showAll') { soloId = null; sentLine = ''; shown = ''; render(); return; }
       const eye = ev.target.closest && ev.target.closest('[data-proto]');
       if (eye) { askPrototype(byId(eye.closest('section.q').dataset.q), eye); return; }
+      const reask = ev.target.closest && ev.target.closest('[data-reask]');
+      if (reask) { if (!reask.disabled) askAgain(byId(reask.dataset.reask), reask); return; }
       const b = ev.target.closest && ev.target.closest('[data-topic]');
-      if (b) { soloId = null; topicId = b.dataset.topic; sentLine = ''; shown = ''; render(); scrollTo(0, 0); }
+      if (b) {
+        soloId = null; topicId = b.dataset.topic; sentLine = ''; shown = '';
+        const first = topics.find((t) => t.id === topicId)?.questions[0];
+        if (first) history.replaceState(history.state, '', '#' + encodeURIComponent(first));
+        render(); scrollTo(0, 0);
+      }
     });
     // The full-width frame shows another take without reloading, where its page's switcher can
     // (prototype-switcher.js current.go), so the page keeps its place. → false when it can't.
@@ -417,8 +447,7 @@
       // docs/adr/2026-11-03-1519-send-records-every-ready-answer-in-one-request.md: one request, recorded all or none. Send waits meanwhile.
       const answers = list.map((q) => {
         const d = getDraft(q.id);
-        const last = q.answers[q.answers.length - 1];
-        const choice = d.choice ?? (last ? last.choice : null);
+        const choice = choiceOf(q, d);
         const files = filesOf(q);
         return { id: q.id, question: q.question, choice, label: choiceLabel(q, choice), note: (d.note || '').trim(), ...(files.length ? { files } : {}) };
       });

package/board/public/view-settings.js

@@ -26,11 +26,7 @@
     <span class="muted small sub">Cards building or waiting in Orchestrator review count. Grills and cards waiting on you don’t.</span></span>
     <input type="number" class="count" id="maxImplementers" min="1" max="99" step="1" inputmode="numeric" disabled></label>
   <p class="muted small" id="maxImplementersStatus" role="status"></p>
-  <label class="who" for="headlessBuilders"><span><span>Builders launch headless</span>
-    <span class="muted small sub">The board launches each ready card’s builder from its notes, and the builder lands its own work. Ready needs a size and notes.</span></span>
-    <input type="checkbox" class="toggle" id="headlessBuilders" disabled></label>
-  <p class="muted small" id="headlessBuildersStatus" role="status"></p>
-  <label class="who" for="autoBuild"><span><span>Auto-build cards</span>
+  <label class="who" for="autoBuild"><span><span>Auto serve</span>
     <span class="muted small sub" id="autoBuildSub">${BoardUI.esc(BoardUI.tryWords('web').autoSub)}</span></span>
     <input type="checkbox" class="toggle" id="autoBuild" disabled></label>
   <p class="muted small" id="autoBuildStatus" role="status"></p>
@@ -38,8 +34,12 @@
     <span class="muted small sub">Claude reviews teammates’ PRs that touch this board’s work. May use a lot of usage.</span></span>
     <input type="checkbox" class="toggle" id="autoReview" disabled></label>
   <p class="muted small" id="autoReviewStatus" role="status"></p>
+  <div id="prsRow" hidden><label class="who" for="prs"><span><span>PRs</span>
+    <span class="muted small sub">Each card opens a PR. Off, no PR opens: each card lands on main and main is pushed.</span></span>
+    <input type="checkbox" class="toggle" id="prs" disabled></label>
+  <p class="muted small" id="prsStatus" role="status"></p></div>
   <label class="who" for="autoMerge"><span><span>Auto-merge</span>
-    <span class="muted small sub">Claude merges a PR once it is approved, green and merges cleanly.</span></span>
+    <span class="muted small sub" id="autoMergeSub">Claude merges a PR once it is approved, green and merges cleanly.</span></span>
     <input type="checkbox" class="toggle" id="autoMerge" disabled></label>
   <p class="muted small" id="autoMergeStatus" role="status"></p>
   <div id="skipDraftRow" hidden><label class="who" for="skipDraft"><span><span>Skip the draft</span>
@@ -58,6 +58,7 @@
   <p class="muted small">The hub runs <code>.kickflip/build</code> from each card’s branch and from main. Claude wrote it when it set up this board; if builds break, file a card.</p>
   <h2>Permissions</h2>
   <div id="permissions"><p class="muted small">Loading…</p></div>
+  <div id="reviewersSection" hidden>
   <h2>Reviewers</h2>
   <p class="muted small">Everyone here gets each PR link on this board once it's ready, and the weekday digest. Someone you add also gets the links of PRs already in review.</p>
   <div id="list"><p class="muted small">Loading…</p></div>
@@ -67,6 +68,7 @@
   </form>
   <div class="row" style="margin-top:12px"><span class="muted small" id="saveStatus"></span><button class="primary" id="save" disabled>Save</button></div>
   <div class="replies" id="replies"></div>
+  </div>
   <h2>Rules</h2>
   <p class="muted small">Standing instructions for this board's Claude session. It sees them each time it wakes, and says what changes when you save.</p>
   <div id="rules"><p class="muted small">Loading…</p></div>
@@ -184,10 +186,19 @@
     const repoURL = `/_hub/board-repo/${encodeURIComponent(B.route)}`;
     let repo = {}, closeRepo = () => {};
     let tickets, savedTickets, savingTickets = null, ticketsTouched = false;
-    // Skip the draft is only for a board with pull requests, on GitHub (docs/adr/2026-11-04-1913-a-board-can-skip-the-draft.md).
+    // PRs shows on a board on GitHub that builds from its shared clone; a local board never opens PRs. Skip the draft and
+    // Reviewers show only while cards open PRs, and Auto-merge says what it merges
+    // (docs/adr/2026-11-04-1913-a-board-can-skip-the-draft.md, docs/adr/2026-11-04-2100-a-land-waits-for-your-merge.md).
+    let prsSetting = true;
+    const opensPRs = () => Boolean(repo.github) && !repo.local && prsSetting;
+    const syncPRs = () => {
+      $('#prsRow').hidden = !repo.github || Boolean(repo.local);
+      $('#skipDraftRow').hidden = $('#reviewersSection').hidden = !opensPRs();
+      $('#autoMergeSub').textContent = opensPRs() ? 'Claude merges a PR once it is approved, green and merges cleanly.' : 'Lands each verified card on main without waiting for your Merge.';
+    };
     const showRepo = () => {
       $('#boardRepoValue').textContent = repo.github || repo.remote ? `${repo.github || repo.remote} · ${repo.branch || 'Branch not recorded'}` : 'No GitHub repo';
-      $('#skipDraftRow').hidden = !repo.github;
+      syncPRs();
     };
     get(repoURL).then(({ body }) => {
       if (!B.alive()) return;
@@ -348,12 +359,13 @@
       $('#autoTriage').disabled = false;
       $('#autoReview').checked = d.settings?.auto_review === true;
       $('#autoReview').disabled = false;
-      $('#headlessBuilders').checked = d.settings?.headless_builders === true;
-      $('#headlessBuilders').disabled = false;
       $('#idleNotification').checked = d.settings?.idle_notification === true;
       $('#idleNotification').disabled = false;
       $('#skipDraft').checked = d.settings?.skip_draft === true;
       $('#skipDraft').disabled = false;
+      $('#prs').checked = prsSetting = d.settings?.prs !== false;
+      $('#prs').disabled = false;
+      syncPRs();
     }).catch(() => { autoMergeStatus.textContent = ticketsStatus.textContent = 'Offline. Is the host awake?'; });
     // An Auto toggle keeps its face, disabled with a spinner beside it (ui.js waitOn), while POST api/settings saves it.
     // → the saved settings
@@ -365,14 +377,17 @@
     })());
     B.on(autoMerge, 'change', async () => {
       const want = autoMerge.checked;
-      if (want && !(await BoardDialogs.confirm('Turn on auto-merge? Claude merges each approved PR on this board once CI is green and it merges cleanly, without asking you.'))) {
+      const ask = opensPRs() ? 'Turn on auto-merge? Claude merges each approved PR on this board once CI is green and it merges cleanly, without asking you.'
+        : 'Turn on auto-merge? Each verified card lands on main without asking you.';
+      if (want && !(await BoardDialogs.confirm(ask))) {
         autoMerge.checked = false;
         return;
       }
       if (!B.alive()) return;
       try {
         autoMerge.checked = (await saveToggle(autoMerge, { auto_merge: want })).auto_merge === true;
-        autoMergeStatus.textContent = autoMerge.checked ? 'Saved. Claude merges approved, green PRs itself.' : 'Saved. Approved, green PRs wait for your Merge.';
+        autoMergeStatus.textContent = opensPRs() ? (autoMerge.checked ? 'Saved. Claude merges approved, green PRs itself.' : 'Saved. Approved, green PRs wait for your Merge.')
+          : autoMerge.checked ? 'Saved. Each verified card lands on main by itself.' : 'Saved. Each verified card waits for your Merge.';
       } catch (e) {
         autoMerge.checked = !want;
         autoMergeStatus.textContent = e.message || 'Could not save. Is the host awake?';
@@ -433,28 +448,32 @@
       }
     });
     autoToggle('autoReview', 'auto_review', (on) => (on ? 'Saved. When idle, Claude reviews incoming PRs that touch this board’s work.' : 'Saved. Claude leaves incoming PRs alone.'));
-    autoToggle('headlessBuilders', 'headless_builders', (on) => (on ? 'Saved. The board launches each ready card’s builder itself, and the builder lands its own work.' : 'Saved. Claude briefs and launches each builder.'));
     autoToggle('idleNotification', 'idle_notification', (on) => (on ? 'Saved. One push once the board has been idle for 15 minutes.' : 'Saved. No push when the board goes idle.'));
     autoToggle('autoTriage', 'auto_triage', (on) => (on ? 'Saved. Once a night, when cards wait on your answers, Claude triages them.' : 'Saved. Questions and Todo are left as they are.'));
     autoToggle('skipDraft', 'skip_draft', (on) => (on ? 'Saved. A builder’s draft PR is marked ready for review once CI passes.' : 'Saved. A builder’s draft PR waits for your review.'));
+    // PRs off needs Push main after a land, which the server checks; its refusal shows in the status line.
+    autoToggle('prs', 'prs', (on) => {
+      prsSetting = on;
+      syncPRs();
+      return on ? 'Saved. Each card opens a PR.' : 'Saved. Each card lands on main with no PR, and main is pushed.';
+    });
 
     // Each switch writes or removes one allow rule in the board folder's .claude/settings.local.json through POST
-    // api/permissions, which only the host's own browser may send; elsewhere the switches are read-only
-    // (docs/adr/2026-11-03-1921-board-settings-grant-a-boards-session-permissions.md). A tap waits on the server with the
+    // api/permissions (docs/adr/2026-11-03-1921-board-settings-grant-a-boards-session-permissions.md); the hub lets only
+    // the owner reach the board (docs/adr/2026-11-04-2156-the-whole-hub-answers-only-the-owner.md). A tap waits on the server with the
     // switch as it was and a spinner beside it, then draws the server's answer.
     const permissions = $('#permissions');
     const REFUSED = {
       denied: (command) => `Auto mode still refused this once: ${command}. Approve it under /permissions, Recently blocked.`,
       asked: (command) => `The session still asked before running ${command}, so it hasn’t picked the rule up yet. It applies once the session restarts.`,
     };
-    const permRow = (p, owner) => `<label class="who" for="perm-${esc(p.id)}"><span><span>${esc(p.name)}</span>
+    const permRow = (p) => `<label class="who" for="perm-${esc(p.id)}"><span><span>${esc(p.name)}</span>
       <span class="muted small sub">${esc(p.allows)} Writes <code>${esc(p.rule)}</code></span></span>
-      <span class="toggle-slot"><span class="try-spin toggle-spin" aria-hidden="true"></span><input type="checkbox" class="toggle" data-perm="${esc(p.id)}" id="perm-${esc(p.id)}"${p.on ? ' checked' : ''}${owner ? '' : ' disabled'}></span></label>
+      <span class="toggle-slot"><span class="try-spin toggle-spin" aria-hidden="true"></span><input type="checkbox" class="toggle" data-perm="${esc(p.id)}" id="perm-${esc(p.id)}"${p.on ? ' checked' : ''}></span></label>
       <p class="muted small" id="perm-${esc(p.id)}Status" role="status"></p>
       ${p.refused ? `<p class="muted small refused-note">${esc(REFUSED[p.refused.how](p.refused.command))}</p>` : ''}`;
     const drawPermissions = (d) => {
-      permissions.innerHTML = d.permissions.map((p) => permRow(p, d.owner)).join('')
-        + (d.owner ? '' : '<p class="muted small" id="permissionsNotOwner">Only the signed-in owner can change these.</p>');
+      permissions.innerHTML = d.permissions.map(permRow).join('');
     };
     get(site.url('api/permissions'), waitIn('#permissions')).then(({ ok, body }) => {
       if (!B.alive()) return;