@luckydraw/cumulus 1.0.38 → 1.0.40

package/dist/gateway/static/widget.js

@@ -144,6 +144,9 @@
       // "haiku" for an unmatched id anyway.
       stallClassifierModel:
         typeof config.stallClassifierModel === 'string' ? config.stallClassifierModel : '',
+      // Task 179. Same verbatim rule again; the gateway's resolveGatewayModel falls
+      // back to "haiku" for an unmatched id.
+      workerModel: typeof config.workerModel === 'string' ? config.workerModel : '',
     };
   }
 
@@ -208,6 +211,9 @@
       // Task 164: '' means "haiku" and must reach the server as an explicit null (clear),
       // not as absent — absent would leave a previously-set classifier model untouched.
       stallClassifierModel: state.stallClassifierModel ? state.stallClassifierModel : null,
+      // Task 179: same explicit-null rule — '' means "haiku", and absent would
+      // leave a previously-set worker model untouched.
+      workerModel: state.workerModel ? state.workerModel : null,
       // Registry travels without credentials — addCredentialPatch fills those
       // in, so an untouched key round-trips as absent and the server preserves it.
       customProviders: (Array.isArray(state.customProviders) ? state.customProviders : []).map(
@@ -1975,17 +1981,55 @@
     '}',
     '.cumulus-task-dep button:hover { border-color: #666; color: #eee; }',
 
-    /* Selection bar — same shape as the message selection bar */
+    /* Toolbar — task 178 put the selection actions above the list; task 179 gave
+       the bar something to show at zero selected, so it is now always present. */
     '.cumulus-tasks-selbar {',
-    '  display: flex; align-items: center; gap: 8px; flex-shrink: 0;',
-    '  padding: 0.5em 0.85em; background: #2d2d2d; border-top: 1px solid #3a3a3a;',
+    '  display: flex; align-items: center; gap: 6px; flex-shrink: 0;',
+    '  padding: 0.45em 0.6em 0.45em 0.85em; background: #2d2d2d;',
+    '  border-bottom: 1px solid #3a3a3a;',
+    '}',
+    '.cumulus-tasks-selcount { font-size: 11.5px; color: #aaa; margin-right: auto; }',
+    '.cumulus-tasks-refresh-note { font-size: 11.5px; color: #888; margin-right: auto; }',
+    '.cumulus-tasks-action--refresh:disabled { opacity: 0.55; cursor: default; }',
+    '.cumulus-tasks-action {',
+    '  background: #2a2a2a; border: 1px solid #3f3f3f; color: #ddd;',
+    '  border-radius: 4px; padding: 0.28em 0.6em; cursor: pointer; font-size: 11px;',
+    '  white-space: nowrap;',
+    '}',
+    '.cumulus-tasks-action:hover { border-color: #666; color: #fff; }',
+    '.cumulus-tasks-action--closed { background: #2f4a35; border-color: #3f5f45; }',
+    '.cumulus-tasks-action--archive { background: #3a3320; border-color: #55492c; }',
+    '.cumulus-tasks-selclear {',
+    '  background: none; border: none; color: #777; cursor: pointer;',
+    '  font-size: 15px; line-height: 1; padding: 2px 3px;',
+    '}',
+    '.cumulus-tasks-selclear:hover { color: #e0e0e0; }',
+
+    /* Inline comment editor — the drawer never opens the floating popover */
+    '.cumulus-tasks-comment {',
+    '  background: #232323; border: 1px solid #3a3a3a; border-radius: 5px;',
+    '  margin: 4px 6px; padding: 0.5em 0.6em; flex-shrink: 0;',
     '}',
-    '.cumulus-tasks-selcount { font-size: 11.5px; color: #aaa; }',
-    '.cumulus-tasks-comment-btn {',
-    '  margin-left: auto; background: #2f4a35; border: 1px solid #3f5f45; color: #ddd;',
-    '  border-radius: 4px; padding: 0.3em 0.8em; cursor: pointer; font-size: 11.5px;',
+    '.cumulus-tasks-comment-quote {',
+    '  font-size: 11px; color: #9a9a9a; white-space: pre-wrap; line-height: 1.4;',
+    '  border-left: 2px solid #4a4a4a; padding-left: 0.5em; margin-bottom: 0.45em;',
+    '  max-height: 5.6em; overflow-y: auto;',
     '}',
-    '.cumulus-tasks-comment-btn:disabled { background: #2a2a2a; border-color: #333; color: #666; cursor: not-allowed; }',
+    '.cumulus-tasks-comment-input {',
+    '  width: 100%; box-sizing: border-box; resize: vertical;',
+    '  background: #1a1a1a; border: 1px solid #3a3a3a; border-radius: 4px;',
+    '  color: #e0e0e0; font-size: 12px; font-family: inherit; padding: 0.4em 0.5em;',
+    '}',
+    '.cumulus-tasks-comment-actions {',
+    '  display: flex; justify-content: flex-end; gap: 6px; margin-top: 0.4em;',
+    '}',
+    '.cumulus-tasks-comment-actions button {',
+    '  border-radius: 4px; padding: 0.25em 0.7em; cursor: pointer; font-size: 11px;',
+    '  background: #2a2a2a; border: 1px solid #3f3f3f; color: #ccc;',
+    '}',
+    '.cumulus-tasks-comment-add { background: #2f4a35 !important; border-color: #3f5f45 !important; color: #ddd !important; }',
+    '.cumulus-task-title--clickable { cursor: pointer; }',
+    '.cumulus-task-title--clickable:hover { text-decoration: underline; text-decoration-color: #555; }',
     '.cumulus-include-add-btn {',
     '  background: #0066cc; border: none; color: white;',
     '  padding: 0.4em 0.8em; border-radius: 4px; cursor: pointer;',
@@ -6653,6 +6697,25 @@
       stallCard.appendChild(stallSelect);
       body.appendChild(stallCard);
 
+      // Task 179: background workers get their own dial rather than sharing the
+      // classifier's. The jobs differ in difficulty — that one is a yes/no read of
+      // three sentences, this one rewrites a whole task file and judges every
+      // task's state — so the cheap model that is plenty for the first may not be
+      // for the second.
+      var workerCard = document.createElement('div');
+      workerCard.className = 'cumulus-settings-default-card';
+      var workerCardLabel = document.createElement('label');
+      workerCardLabel.textContent = 'Background workers use';
+      var workerSelect = document.createElement('select');
+      workerSelect.className = 'cumulus-settings-select';
+      workerSelect.setAttribute('data-testid', 'webchat-gw-worker-select');
+      workerSelect.addEventListener('change', function () {
+        gwState.workerModel = workerSelect.value;
+      });
+      workerCard.appendChild(workerCardLabel);
+      workerCard.appendChild(workerSelect);
+      body.appendChild(workerCard);
+
       var modelsLabel = document.createElement('div');
       modelsLabel.className = 'cumulus-settings-section-label';
       modelsLabel.textContent = 'Model catalog';
@@ -7292,6 +7355,18 @@
         if (stallSelect.value !== (gwState.stallClassifierModel || '')) stallSelect.value = '';
       }
 
+      // Task 179 — same rule, same fallback, its own setting.
+      function renderWorkerSelect() {
+        workerSelect.innerHTML = '';
+        var workerHaiku = document.createElement('option');
+        workerHaiku.value = '';
+        workerHaiku.textContent = 'Haiku (default)';
+        workerSelect.appendChild(workerHaiku);
+        fillModelOptions(workerSelect);
+        workerSelect.value = gwState.workerModel || '';
+        if (workerSelect.value !== (gwState.workerModel || '')) workerSelect.value = '';
+      }
+
       // Rebuild the provider list from state before anything reads it, so a
       // provider added or removed this session reaches the cards, the default
       // dropdown and the add-model select in the same pass (task 147).
@@ -7316,6 +7391,7 @@
         renderDefaultSelect();
         renderVoiceSelect();
         renderStallSelect();
+        renderWorkerSelect();
         renderGwModels();
       }
 
@@ -9221,45 +9297,86 @@
       errorEl.style.display = 'none';
       drawer.appendChild(errorEl);
 
-      var body = document.createElement('div');
-      body.className = 'cumulus-tasks-body';
-      body.innerHTML = '<div class="cumulus-tasks-empty">Loading…</div>';
-      drawer.appendChild(body);
-
+      // Task 178: the selection bar sits ABOVE the list and exists only while
+      // something is ticked. At the bottom it anchored the comment editor below
+      // the panel's own floor, where the panel clipped it — the button worked and
+      // nothing appeared. Nothing here is positioned relative to the viewport now.
       var selbar = document.createElement('div');
       selbar.className = 'cumulus-tasks-selbar';
+      selbar.setAttribute('data-testid', 'webchat-tasks-selbar');
+
+      // Task 179 — Refresh occupies the toolbar whenever nothing is ticked. It is
+      // the only control here that acts on the WHOLE file rather than a selection,
+      // which is why it swaps out entirely the moment a row is ticked rather than
+      // sitting alongside actions that mean something narrower.
+      var refreshNote = document.createElement('span');
+      refreshNote.className = 'cumulus-tasks-refresh-note';
+      refreshNote.setAttribute('data-testid', 'webchat-tasks-refresh-note');
+      refreshNote.textContent = '';
+      selbar.appendChild(refreshNote);
+
+      var refreshBtn = taskActionButton('Refresh', 'refresh', function () {
+        requestTasksRefresh(drawer, threadName);
+      });
+      refreshBtn.setAttribute(
+        'title',
+        'Convert this file to the current format and re-check every task’s state. ' +
+          'Commits a snapshot to git first.'
+      );
+      selbar.appendChild(refreshBtn);
+
       var selcount = document.createElement('span');
       selcount.className = 'cumulus-tasks-selcount';
       selcount.setAttribute('data-testid', 'webchat-tasks-selcount');
       selcount.textContent = '0 selected';
       selbar.appendChild(selcount);
-      var commentBtn = document.createElement('button');
-      commentBtn.className = 'cumulus-tasks-comment-btn';
-      commentBtn.setAttribute('data-testid', 'webchat-tasks-comment-btn');
-      commentBtn.textContent = 'Comment';
-      commentBtn.disabled = true;
-      commentBtn.addEventListener('click', function () {
-        var labels = drawer._selectedLabels ? drawer._selectedLabels() : [];
-        if (labels.length === 0) return;
-        // The same popover the chat uses for a highlighted quote — the selected
-        // rows ARE the quote, so the chip that lands in the composer is
-        // indistinguishable from one made by highlighting text.
-        showAnnotationPopover(
+
+      var commentBtn = taskActionButton('Comment', 'comment', function () {
+        openTaskComment(
           panel,
-          labels.join('\n'),
-          commentBtn.getBoundingClientRect(),
-          false,
-          ''
+          drawer,
+          drawer._selectedLabels ? drawer._selectedLabels() : [],
+          selbar,
+          'selection'
         );
       });
       selbar.appendChild(commentBtn);
+
+      var closedBtn = taskActionButton('Closed ✓', 'closed', function () {
+        dispositionSelectedTasks(drawer, threadName, 'closed');
+      });
+      selbar.appendChild(closedBtn);
+      var archiveBtn = taskActionButton('Archive', 'archive', function () {
+        dispositionSelectedTasks(drawer, threadName, 'archived');
+      });
+      selbar.appendChild(archiveBtn);
+
+      var clearBtn = document.createElement('button');
+      clearBtn.className = 'cumulus-tasks-selclear';
+      clearBtn.setAttribute('data-testid', 'webchat-tasks-selclear');
+      clearBtn.setAttribute('title', 'Clear selection');
+      clearBtn.textContent = '\xD7';
+      clearBtn.addEventListener('click', function () {
+        clearTaskSelection(drawer);
+      });
+      selbar.appendChild(clearBtn);
       drawer.appendChild(selbar);
 
+      var body = document.createElement('div');
+      body.className = 'cumulus-tasks-body';
+      body.innerHTML = '<div class="cumulus-tasks-empty">Loading…</div>';
+      drawer.appendChild(body);
+
       drawer._body = body;
       drawer._errorEl = errorEl;
       drawer._countEl = count;
+      drawer._selbar = selbar;
       drawer._selcount = selcount;
-      drawer._commentBtn = commentBtn;
+      drawer._panel = panel;
+      drawer._refreshBtn = refreshBtn;
+      drawer._refreshNote = refreshNote;
+      // The selection half of the toolbar, hidden together at zero selected.
+      drawer._selGroup = [selcount, commentBtn, closedBtn, archiveBtn, clearBtn];
 
       panel.appendChild(drawer);
       if (connection) connection.send({ type: 'tasks_list', threadName: threadName });
@@ -9385,7 +9502,7 @@
         row.appendChild(now);
       }
 
-      return { row: row, check: check };
+      return { row: row, check: check, title: title };
     }
 
     function renderTasks(panel, threadName, data) {
@@ -9407,13 +9524,19 @@
       var done = data.done || [];
       drawer._countEl.textContent = data.missing ? '' : queue.length + ' open';
 
+      // A row-anchored editor lives inside the list being rebuilt; dropping it here
+      // is what stops it surviving as a detached node its Add button still writes to.
+      closeTaskComment(drawer, 'row');
       body.innerHTML = '';
 
       if (data.missing) {
+        // The un-migrated case is exactly what Refresh is for, so say so here
+        // rather than leaving the button above looking decorative (task 179).
         body.innerHTML =
-          '<div class="cumulus-tasks-empty">This thread has no tasks file.<br><br>' +
-          'Add a <code>Tasks.md</code> carrying the <code>cumulus:tasks</code> marker to the ' +
-          'thread’s always-include list, and it will appear here.</div>';
+          '<div class="cumulus-tasks-empty">This thread has no tasks file in the current ' +
+          'format.<br><br>If it already has a <code>Tasks.md</code> in its always-include ' +
+          'list, press <b>Refresh</b> to convert it — the file is committed to git first. ' +
+          'Otherwise add one, and it will appear here.</div>';
         drawer._selected = {};
         updateTaskSelection(drawer);
         return;
@@ -9434,6 +9557,7 @@
         var built = buildTaskRow(task, { isNow: i === 0, done: false });
         wireTaskDrag(built.row, drawer, threadName);
         wireTaskCheck(built, drawer);
+        wireTaskComment(built, drawer, task);
 
         if (task.depProposed) {
           var dep = document.createElement('span');
@@ -9459,6 +9583,7 @@
         done.forEach(function (task) {
           var built = buildTaskRow(task, { isNow: false, done: true });
           wireTaskCheck(built, drawer);
+          wireTaskComment(built, drawer, task);
           body.appendChild(built.row);
         });
       }
@@ -9505,6 +9630,23 @@
       return btn;
     }
 
+    // Clicking a row's title comments on THAT row, whatever is ticked — the
+    // one-task path Karl asked for, and the reason the editor anchors to the row
+    // rather than always to the bar.
+    function wireTaskComment(built, drawer, task) {
+      built.title.classList.add('cumulus-task-title--clickable');
+      built.title.setAttribute('title', 'Comment on this task');
+      built.title.addEventListener('click', function () {
+        var label = task.id + ' · ' + task.title;
+        if (drawer._commentEditor && drawer._commentEditor._taskId === task.id) {
+          closeTaskComment(drawer);
+          return;
+        }
+        openTaskComment(drawer._panel, drawer, [label], built.row, 'row');
+        if (drawer._commentEditor) drawer._commentEditor._taskId = task.id;
+      });
+    }
+
     function wireTaskCheck(built, drawer) {
       built.check.addEventListener('change', function () {
         var id = built.row.getAttribute('data-task-id');
@@ -9514,10 +9656,163 @@
       });
     }
 
+    // The toolbar shows exactly one of two things. At zero selected it is
+    // Refresh, which acts on the whole file; with rows ticked it is the count and
+    // the actions that act on those rows. Task 178 hid the bar entirely at zero
+    // because a permanent "0 selected" strip answered a question nobody asked —
+    // 179 gives that space a real use, so the bar stays and its contents swap.
     function updateTaskSelection(drawer) {
       var n = Object.keys(drawer._selected).length;
       drawer._selcount.textContent = n + ' selected';
-      drawer._commentBtn.disabled = n === 0;
+      var group = drawer._selGroup || [];
+      for (var i = 0; i < group.length; i++) group[i].style.display = n === 0 ? 'none' : '';
+      drawer._refreshBtn.style.display = n === 0 ? '' : 'none';
+      drawer._refreshNote.style.display = n === 0 ? '' : 'none';
+      if (n === 0) closeTaskComment(drawer, 'selection');
+    }
+
+    // Task 179. The button is disabled optimistically rather than on the server's
+    // `running` push: the round-trip is long enough to double-click through, and a
+    // second press is REFUSED by the server, not queued — so an un-disabled button
+    // would just produce an error message for a press the user meant.
+    function requestTasksRefresh(drawer, threadName) {
+      if (drawer._refreshBtn.disabled) return;
+      setTasksRefreshBusy(drawer, true, 'Refreshing…');
+      drawer._errorEl.textContent = '';
+      drawer._errorEl.style.display = 'none';
+      if (connection) connection.send({ type: 'tasks_refresh', threadName: threadName });
+    }
+
+    function setTasksRefreshBusy(drawer, busy, note) {
+      drawer._refreshBtn.disabled = !!busy;
+      drawer._refreshBtn.textContent = busy ? 'Refreshing…' : 'Refresh';
+      drawer._refreshNote.textContent = note || '';
+    }
+
+    // A worker's terminal status. `failed` lands in the same error strip a rejected
+    // drag uses — one place in the drawer where the file's own truth is reported,
+    // whatever refused the write.
+    function applyWorkerStatus(panel, threadName, data) {
+      var drawer = panel.querySelector('.cumulus-tasks-drawer');
+      if (!drawer || drawer._threadName !== threadName) return;
+      if (data.kind !== 'tasks-refresh') return;
+
+      if (data.state === 'running') {
+        setTasksRefreshBusy(drawer, true, 'Refreshing…');
+        return;
+      }
+      setTasksRefreshBusy(drawer, false, data.state === 'done' ? data.detail || '' : '');
+      if (data.state === 'failed') {
+        drawer._errorEl.textContent = data.detail || 'Refresh failed.';
+        drawer._errorEl.style.display = '';
+      }
+    }
+
+    function taskActionButton(label, name, onClick) {
+      var btn = document.createElement('button');
+      btn.className = 'cumulus-tasks-action cumulus-tasks-action--' + name;
+      btn.setAttribute('data-testid', 'webchat-tasks-' + name + '-btn');
+      btn.textContent = label;
+      btn.addEventListener('click', onClick);
+      return btn;
+    }
+
+    function clearTaskSelection(drawer) {
+      var boxes = drawer._body.querySelectorAll('.cumulus-task-check');
+      for (var i = 0; i < boxes.length; i++) boxes[i].checked = false;
+      drawer._selected = {};
+      updateTaskSelection(drawer);
+    }
+
+    // Closing and archiving are the same write with a different glyph, so they are
+    // the same message: the server decides what a disposition does to the file, and
+    // the answer comes back through the one renderer every other write uses.
+    function dispositionSelectedTasks(drawer, threadName, disposition) {
+      var ids = Object.keys(drawer._selected);
+      if (ids.length === 0) return;
+      closeTaskComment(drawer);
+      if (connection)
+        connection.send({
+          type: 'tasks_disposition',
+          threadName: threadName,
+          ids: ids,
+          disposition: disposition,
+        });
+      drawer._selected = {};
+      updateTaskSelection(drawer);
+    }
+
+    // Task 178: the comment editor is part of the drawer, inserted directly below
+    // whatever it is about — the selection bar for several rows, the row itself for
+    // one. It ends at `addAnnotationChip`, the same call the chat's floating
+    // popover makes, so the chip in the composer is identical either way.
+    function openTaskComment(panel, drawer, labels, anchorEl, origin) {
+      closeTaskComment(drawer);
+      if (!labels || labels.length === 0 || !anchorEl || !anchorEl.parentNode) return;
+
+      var editor = document.createElement('div');
+      editor.className = 'cumulus-tasks-comment';
+      editor.setAttribute('data-testid', 'webchat-tasks-comment');
+      editor._origin = origin || 'selection';
+
+      var quote = document.createElement('div');
+      quote.className = 'cumulus-tasks-comment-quote';
+      quote.textContent = labels.join('\n');
+      editor.appendChild(quote);
+
+      var textarea = document.createElement('textarea');
+      textarea.className = 'cumulus-tasks-comment-input';
+      textarea.setAttribute('data-testid', 'webchat-tasks-comment-input');
+      textarea.placeholder = 'Add a comment…';
+      textarea.rows = 3;
+      editor.appendChild(textarea);
+
+      var actions = document.createElement('div');
+      actions.className = 'cumulus-tasks-comment-actions';
+
+      var cancelBtn = document.createElement('button');
+      cancelBtn.className = 'cumulus-tasks-comment-cancel';
+      cancelBtn.setAttribute('data-testid', 'webchat-tasks-comment-cancel');
+      cancelBtn.textContent = 'Cancel';
+      cancelBtn.addEventListener('click', function () {
+        closeTaskComment(drawer);
+      });
+      actions.appendChild(cancelBtn);
+
+      var addBtn = document.createElement('button');
+      addBtn.className = 'cumulus-tasks-comment-add';
+      addBtn.setAttribute('data-testid', 'webchat-tasks-comment-add');
+      addBtn.textContent = 'Add';
+      addBtn.addEventListener('click', function () {
+        var comment = textarea.value.trim();
+        if (comment) addAnnotationChip(panel, labels.join('\n'), comment, false, '');
+        closeTaskComment(drawer);
+      });
+      actions.appendChild(addBtn);
+      editor.appendChild(actions);
+
+      textarea.addEventListener('keydown', function (e) {
+        if (e.key === 'Enter' && !e.shiftKey) {
+          e.preventDefault();
+          addBtn.click();
+        } else if (e.key === 'Escape') {
+          closeTaskComment(drawer);
+        }
+      });
+
+      anchorEl.parentNode.insertBefore(editor, anchorEl.nextSibling);
+      drawer._commentEditor = editor;
+      // Safe to focus here, unlike the chat popover: there is no text selection
+      // for the caret to destroy.
+      textarea.focus();
+    }
+
+    function closeTaskComment(drawer, onlyOrigin) {
+      var editor = drawer._commentEditor;
+      if (!editor) return;
+      if (onlyOrigin && editor._origin !== onlyOrigin) return;
+      if (editor.parentNode) editor.parentNode.removeChild(editor);
+      drawer._commentEditor = null;
     }
 
     function openIncludeOverlay(panel, threadName) {
@@ -10653,6 +10948,18 @@
           }
           break;
 
+        // A gateway-side background worker changed state (task 179). Deliberately
+        // NOT `thread_activity`: a worker is not a turn, so it must not light the
+        // sidebar dots or claim the thread is busy.
+        case 'worker_status':
+          if (data.threadName) {
+            var workerPanel = document.querySelector(
+              '[data-thread-panel="' + data.threadName + '"]'
+            );
+            if (workerPanel) applyWorkerStatus(workerPanel, data.threadName, data);
+          }
+          break;
+
         case 'include_added':
         case 'include_removed':
           // List already updated by the handler — no extra action needed

package/dist/gateway/tasks-refresh.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Task 179 — the Refresh button's actual work.
+ *
+ * Karl's three answers set the shape of this file:
+ *
+ *   1. *"Write it straight away, but commit to git first so I can undo."* — so a
+ *      snapshot commit is a PRECONDITION, and a file outside a git repo is
+ *      refused outright. The permission to write without asking was bought with
+ *      the undo; without a repo there is no undo, so the permission lapses.
+ *   2. *"Both — convert to the new format AND re-check every task's state."* — one
+ *      model call does both, because they are the same rewrite.
+ *   3. *"Build it as a general facility."* — which is `worker.ts`; this module is
+ *      only its first caller.
+ *
+ * The load-bearing part is not the prompt. A model handed a whole file and asked
+ * for a whole file back will, sooner or later, quietly drop a row — so the answer
+ * is checked before it is written, and a run that loses a task id, fails to
+ * parse, or comes back without the marker is refused WHOLE. The git snapshot is
+ * the belt; these checks are the braces.
+ */
+import { type TasksPayload } from './tasks.js';
+import { type RunWorkerOptions } from './worker.js';
+/** A refusal with a reason the drawer shows verbatim. */
+export declare class TasksRefreshError extends Error {
+}
+/**
+ * Every task id the file currently carries.
+ *
+ * Deliberately permissive, and matched against the RAW text rather than a parse:
+ * the un-migrated files this exists to convert do not parse at all, and they are
+ * the ones with the most to lose. Both shapes seen in the wild are covered —
+ * `- [ ] 179 · title` (schema) and `- [◕] 178: title` (what came before).
+ *
+ * The `## Format` section is skipped, and that is not a nicety: the manual
+ * carried inside every migrated file demonstrates the grammar with EXAMPLE rows
+ * (`- [ ] 073 · StorePool reaping`, `- [⊘] 084 · Creative-writing benchmark`).
+ * Counting those as tasks would demand the model preserve four ids that do not
+ * exist, so every already-migrated file would fail the drop check and Refresh
+ * would work only on un-migrated ones. Found by test, not by reading.
+ */
+export declare function taskIdsIn(content: string): string[];
+/** Strip a ```-fenced wrapper, which a chat-tuned model adds however firmly it is told not to. */
+export declare function unfence(answer: string): string;
+/**
+ * Commit the file as it stands, and return whether there was anything to commit.
+ *
+ * Scoped by pathspec on BOTH commands, so a refresh never sweeps up whatever else
+ * the user happened to have staged. "Nothing to commit" is success, not failure:
+ * the file is already identical to HEAD, so HEAD *is* the undo point.
+ *
+ * Not being in a git repo is the one hard refusal here — see the module comment.
+ */
+export declare function snapshotBeforeRefresh(filePath: string): boolean;
+export interface RefreshPromptInput {
+    content: string;
+    migrated: boolean;
+    docs: string[];
+    version: string;
+}
+/**
+ * The whole prompt, as one pure function so the instructions are testable
+ * without a model.
+ *
+ * The three facts at the end are the ones the model cannot get from the file and
+ * would otherwise invent: which task docs exist, and what the gateway is actually
+ * running. That last one is the thing Karl complained about — rows still saying
+ * "needs reload" long after the reload happened.
+ */
+export declare function buildRefreshPrompt(input: RefreshPromptInput): string;
+export interface RefreshResult {
+    payload: TasksPayload;
+    /** False when the file was already identical to HEAD — HEAD is then the undo point. */
+    committed: boolean;
+    /** Ids the model dropped. Non-empty only on the refusal path, for the message. */
+    droppedIds: string[];
+}
+export interface RefreshOptions extends RunWorkerOptions {
+    /** Test seam: run this instead of the model. Production leaves it unset. */
+    runModel?: (prompt: string) => Promise<string>;
+}
+/**
+ * Convert and re-check a thread's tasks file in place.
+ *
+ * Order matters and is the design: resolve → snapshot → ask → CHECK → write.
+ * Nothing between the snapshot and the write touches disk, so every refusal below
+ * leaves the file byte-identical to what was just committed.
+ */
+export declare function refreshTasksFile(threadName: string, opts?: RefreshOptions): Promise<RefreshResult>;
+//# sourceMappingURL=tasks-refresh.d.ts.map

package/dist/gateway/tasks-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-refresh.d.ts","sourceRoot":"","sources":["../../src/gateway/tasks-refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,yDAAyD;AACzD,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAO/C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWnD;AAED,kGAAkG;AAClG,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO9C;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6B/D;AAcD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAuCpE;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,CAkExB"}