@luckydraw/cumulus 1.0.38 → 1.0.40

package/dist/gateway/tasks-refresh.js

@@ -0,0 +1,224 @@
+/**
+ * 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 { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { TASKS_FORMAT_SECTION, hasTasksMarker, parseTasksFile } from '../lib/tasks-file.js';
+import { getCurrentVersion } from '../lib/version-check.js';
+import { readTasks, resolveRefreshTarget } from './tasks.js';
+import { runWorker } from './worker.js';
+/** A refusal with a reason the drawer shows verbatim. */
+export class TasksRefreshError extends Error {
+}
+const SNAPSHOT_MESSAGE = 'chore(tasks): snapshot before refresh';
+/** Task rows in either the schema format or the free-form one it replaced. */
+const ANY_TASK_ID_RE = /^\s*-\s*\[[^\]]*\]\s*(\d{1,4})\b/;
+/**
+ * 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 function taskIdsIn(content) {
+    const ids = [];
+    let inFormat = false;
+    for (const line of content.split('\n')) {
+        const heading = /^## +(.+?) *$/.exec(line);
+        if (heading)
+            inFormat = heading[1] === 'Format';
+        if (inFormat)
+            continue;
+        const m = ANY_TASK_ID_RE.exec(line);
+        if (m)
+            ids.push(m[1]);
+    }
+    return ids;
+}
+/** Strip a ```-fenced wrapper, which a chat-tuned model adds however firmly it is told not to. */
+export function unfence(answer) {
+    const trimmed = answer.trim();
+    if (!trimmed.startsWith('```'))
+        return trimmed;
+    const lines = trimmed.split('\n');
+    lines.shift();
+    if (lines[lines.length - 1]?.trim().startsWith('```'))
+        lines.pop();
+    return lines.join('\n').trim();
+}
+function git(cwd, args) {
+    return execFileSync('git', args, { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
+}
+/**
+ * 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 function snapshotBeforeRefresh(filePath) {
+    const dir = path.dirname(filePath);
+    let root;
+    try {
+        root = git(dir, ['rev-parse', '--show-toplevel']).trim();
+    }
+    catch {
+        throw new TasksRefreshError(`Refresh needs a git repository to snapshot into, and ${filePath} is not in one. ` +
+            `It rewrites the whole file, so without an undo point it will not run.`);
+    }
+    const rel = path.relative(root, filePath);
+    try {
+        git(root, ['add', '--', rel]);
+        git(root, ['commit', '-m', SNAPSHOT_MESSAGE, '--', rel]);
+        return true;
+    }
+    catch (err) {
+        // git says "nothing to commit" on STDOUT and exits non-zero, so the throw is
+        // the success path here as often as it is the failure one.
+        const e = err;
+        const output = `${String(e.stdout ?? '')}\n${String(e.stderr ?? '')}`;
+        if (/nothing to commit|no changes added|nothing added to commit/i.test(output))
+            return false;
+        throw new TasksRefreshError(`Could not commit a snapshot of ${rel} before refreshing: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/** Filenames under `docs/tasks/`, so the model can attach `doc` fields it can verify exist. */
+function taskDocListing(cwd) {
+    try {
+        return fs
+            .readdirSync(path.join(cwd, 'docs', 'tasks'))
+            .filter(name => name.endsWith('.md'))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 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 function buildRefreshPrompt(input) {
+    const docs = input.docs.length
+        ? input.docs.map(d => `- docs/tasks/${d}`).join('\n')
+        : '(no docs/tasks directory)';
+    return [
+        'You are rewriting a project task file into the exact format specified below.',
+        'Return ONLY the complete new file. No preamble, no explanation, no code fence.',
+        '',
+        '=== THE FORMAT (this section must appear verbatim in your output) ===',
+        TASKS_FORMAT_SECTION,
+        '',
+        '=== RULES ===',
+        '1. Output the whole file: a `# <name> Tasks` title, the marker line',
+        '   `<!-- cumulus:tasks v1 -->` alone on its own line within the first ten lines,',
+        '   then `## Format` (verbatim as given above), `## Queue`, and `## Done`.',
+        '2. EVERY task in the current file must appear in your output, with the SAME id.',
+        '   Losing an id fails the whole refresh and nothing is written. If a task has no',
+        '   id, mint one that does not collide with any other id in the file.',
+        '3. Prose belongs in `note` lines and nowhere else. A task row is one line.',
+        "4. Re-check each task's status against the evidence below. If you CANNOT ground a",
+        '   status change in that evidence, leave the status exactly as it is.',
+        '5. When you do change a status, add a `note` saying why, so the change is auditable.',
+        '6. Finished work belongs in `## Done` with a `done <YYYY-MM-DD>` field. Work still',
+        '   to do belongs in `## Queue`, in build order, most important first.',
+        '',
+        '=== EVIDENCE YOU CANNOT GET FROM THE FILE ===',
+        `The gateway is currently running version ${input.version}. Any note claiming a`,
+        'change is "published, needs reload" for a version at or below this one is stale —',
+        'the reload has happened. Say so rather than repeating the claim.',
+        '',
+        'Task documents that exist on disk (use these for `doc` fields; do not invent paths):',
+        docs,
+        '',
+        input.migrated
+            ? '=== THE CURRENT FILE (already in this format — re-check it) ==='
+            : '=== THE CURRENT FILE (free-form — convert it) ===',
+        input.content,
+    ].join('\n');
+}
+/**
+ * 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 async function refreshTasksFile(threadName, opts = {}) {
+    const target = await resolveRefreshTarget(threadName);
+    if (!target) {
+        throw new TasksRefreshError('This thread has no Tasks.md in its always-include list, so there is nothing to refresh.');
+    }
+    const committed = snapshotBeforeRefresh(target.filePath);
+    const prompt = buildRefreshPrompt({
+        content: target.content,
+        migrated: target.migrated,
+        docs: taskDocListing(target.cwd),
+        version: getCurrentVersion(),
+    });
+    const raw = opts.runModel
+        ? await opts.runModel(prompt)
+        : await runWorker(threadName, 'tasks-refresh', prompt, opts);
+    const next = unfence(raw);
+    // ── The guard rails. Each one refuses the WHOLE answer; none patches it up. ──
+    if (!next) {
+        throw new TasksRefreshError('The worker returned an empty file. Nothing was written.');
+    }
+    if (!hasTasksMarker(next)) {
+        throw new TasksRefreshError("The worker's answer has no `<!-- cumulus:tasks v1 -->` marker on its own line in the " +
+            'first ten lines, so it is not a tasks file. Nothing was written.');
+    }
+    const parsed = parseTasksFile(next);
+    if (parsed.errors.length > 0) {
+        const first = parsed.errors[0];
+        throw new TasksRefreshError(`The worker's answer does not parse (${parsed.errors.length} bad line${parsed.errors.length === 1 ? '' : 's'}, first at line ${first.line}: ${first.reason}). Nothing was written.`);
+    }
+    // The one check that catches the failure this whole task is built around: a
+    // wholesale rewrite that silently loses a row. Compared against the RAW ids of
+    // the file that went in, so it holds for un-migrated files too.
+    const before = new Set(taskIdsIn(target.content));
+    const after = new Set(parsed.queue.concat(parsed.done).map(row => row.id));
+    const droppedIds = [...before].filter(id => !after.has(id));
+    if (droppedIds.length > 0) {
+        throw new TasksRefreshError(`The worker dropped ${droppedIds.length} task${droppedIds.length === 1 ? '' : 's'} (${droppedIds.join(', ')}). Nothing was written — the file is exactly as it was.`);
+    }
+    if (after.size === 0 && before.size > 0) {
+        throw new TasksRefreshError('The worker returned a file with no tasks in it. Nothing was written.');
+    }
+    fs.writeFileSync(target.filePath, next.endsWith('\n') ? next : `${next}\n`, 'utf-8');
+    return { payload: await readTasks(threadName), committed, droppedIds: [] };
+}
+//# sourceMappingURL=tasks-refresh.js.map

package/dist/gateway/tasks-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-refresh.js","sourceRoot":"","sources":["../../src/gateway/tasks-refresh.ts"],"names":[],"mappings":"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"}

package/dist/gateway/tasks.d.ts

@@ -7,7 +7,7 @@
  * resolution rule, so the drawer and the prompt can never disagree about which
  * file is the queue (Rule #8).
  */
-import { TaskRow, TasksFile } from '../lib/tasks-file.js';
+import { TaskDisposition, TaskRow, TasksFile } from '../lib/tasks-file.js';
 export interface ResolvedTasksFile {
     filePath: string;
     file: TasksFile;
@@ -20,6 +20,24 @@ export interface ResolvedTasksFile {
  * under any other name is.
  */
 export declare function resolveTasksFile(threadName: string): Promise<ResolvedTasksFile | null>;
+/** What task 179's Refresh is pointed at, and whether it has been migrated yet. */
+export interface RefreshTarget {
+    filePath: string;
+    content: string;
+    cwd: string;
+    /** True when the file already carries the marker — Refresh re-checks rather than converts. */
+    migrated: boolean;
+}
+/**
+ * The file Refresh acts on (task 179).
+ *
+ * A superset of {@link resolveTasksFile}: a marked file wins wherever it sits,
+ * and failing that, an always-included file *named* `Tasks.md` — which is
+ * precisely the un-migrated case Refresh exists to convert. Filename is the
+ * fallback ONLY here; the prompt projection still keys on the marker alone, so
+ * conversion never happens by accident on a file nobody pointed at.
+ */
+export declare function resolveRefreshTarget(threadName: string): Promise<RefreshTarget | null>;
 /** Wire shape for the drawer — flat rows, depth carried explicitly. */
 export interface TasksPayload {
     filePath: string | null;
@@ -32,4 +50,6 @@ export interface TasksPayload {
 export declare function readTasks(threadName: string): Promise<TasksPayload>;
 export declare function moveTaskInThread(threadName: string, dragId: string, targetId: string, position: 'before' | 'after'): Promise<TasksPayload>;
 export declare function resolveDepInThread(threadName: string, id: string, accept: boolean): Promise<TasksPayload>;
+/** Task 178 — the drawer's Closed ✓ / Archive buttons. */
+export declare function dispositionTasksInThread(threadName: string, ids: string[], disposition: TaskDisposition): Promise<TasksPayload>;
 //# sourceMappingURL=tasks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/gateway/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,EACL,OAAO,EACP,SAAS,EAQV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkB5F;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAWzE;AA8BD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAC3B,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAEvB"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/gateway/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,EACL,eAAe,EACf,OAAO,EACP,SAAS,EASV,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;CACjB;AAmCD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAO5F;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAW5F;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5B,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAWzE;AAgDD,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAC3B,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,0DAA0D;AAC1D,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,EACb,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,YAAY,CAAC,CAEvB"}

package/dist/gateway/tasks.js

@@ -11,36 +11,71 @@ import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
 import { loadGlobalConfig, loadThreadConfig, mergeConfigs, resolveFilePath, } from '../lib/config.js';
-import { TasksFileError, assertWritable, hasTasksMarker, moveTask, parseTasksFile, resolveProposedDep, serializeTasksFile, } from '../lib/tasks-file.js';
+import { TasksFileError, assertWritable, dispositionTasks, hasTasksMarker, moveTask, parseTasksFile, resolveProposedDep, serializeTasksFile, } from '../lib/tasks-file.js';
 import { resolveThreadCwd } from '../lib/worktree.js';
 /**
- * Find the thread's schema tasks file, or null when it has none.
+ * The thread's always-include files, in configured order, with their contents.
  *
- * Detection is the marker inside the file, never the filename: a project whose
- * `Tasks.md` has not been migrated is not a tasks file, and a migrated file
- * under any other name is.
+ * The single place that answers "which files could be this thread's task list",
+ * so the marker rule below and task 179's refresh target cannot resolve against
+ * different sets (Rule #8).
  */
-export async function resolveTasksFile(threadName) {
+async function threadIncludeFiles(threadName) {
     const merged = mergeConfigs(await loadGlobalConfig(), await loadThreadConfig(threadName));
     const resolved = await resolveThreadCwd(threadName, merged.projectDir);
     const cwd = resolved.cwd || merged.projectDir || path.join(os.homedir(), 'projects', threadName);
+    const files = [];
     for (const entry of merged.alwaysInclude ?? []) {
         const filePath = resolveFilePath(entry, cwd);
-        let content;
         try {
             if (!fs.existsSync(filePath) || fs.statSync(filePath).isDirectory())
                 continue;
-            content = fs.readFileSync(filePath, 'utf-8');
+            files.push({ filePath, content: fs.readFileSync(filePath, 'utf-8') });
         }
         catch {
             continue;
         }
+    }
+    return { cwd, files };
+}
+/**
+ * Find the thread's schema tasks file, or null when it has none.
+ *
+ * Detection is the marker inside the file, never the filename: a project whose
+ * `Tasks.md` has not been migrated is not a tasks file, and a migrated file
+ * under any other name is.
+ */
+export async function resolveTasksFile(threadName) {
+    const { files } = await threadIncludeFiles(threadName);
+    for (const { filePath, content } of files) {
         if (!hasTasksMarker(content))
             continue;
         return { filePath, file: parseTasksFile(content) };
     }
     return null;
 }
+/**
+ * The file Refresh acts on (task 179).
+ *
+ * A superset of {@link resolveTasksFile}: a marked file wins wherever it sits,
+ * and failing that, an always-included file *named* `Tasks.md` — which is
+ * precisely the un-migrated case Refresh exists to convert. Filename is the
+ * fallback ONLY here; the prompt projection still keys on the marker alone, so
+ * conversion never happens by accident on a file nobody pointed at.
+ */
+export async function resolveRefreshTarget(threadName) {
+    const { cwd, files } = await threadIncludeFiles(threadName);
+    for (const { filePath, content } of files) {
+        if (hasTasksMarker(content))
+            return { filePath, content, cwd, migrated: true };
+    }
+    for (const { filePath, content } of files) {
+        if (path.basename(filePath).toLowerCase() === 'tasks.md') {
+            return { filePath, content, cwd, migrated: false };
+        }
+    }
+    return null;
+}
 export async function readTasks(threadName) {
     const resolved = await resolveTasksFile(threadName);
     if (!resolved) {
@@ -60,13 +95,13 @@ export async function readTasks(threadName) {
  * parser did not understand is refused whole rather than rewritten without them,
  * because serializing a partial parse is how a drag silently deletes a line.
  */
-async function mutateQueue(threadName, mutate) {
+async function mutateFile(threadName, mutate) {
     const resolved = await resolveTasksFile(threadName);
     if (!resolved) {
         throw new TasksFileError('This thread has no tasks file in its always-include list');
     }
     assertWritable(resolved.file);
-    const next = { ...resolved.file, queue: mutate(resolved.file.queue) };
+    const next = mutate(resolved.file);
     fs.writeFileSync(resolved.filePath, serializeTasksFile(next), 'utf-8');
     return {
         filePath: resolved.filePath,
@@ -75,10 +110,27 @@ async function mutateQueue(threadName, mutate) {
         errors: [],
     };
 }
+/** The common case: a mutation that only reorders or re-nests the queue. */
+function mutateQueue(threadName, mutate) {
+    return mutateFile(threadName, file => ({ ...file, queue: mutate(file.queue) }));
+}
+/**
+ * Local calendar date, not UTC. `done 2026-09-02` is read by a person against
+ * their own day; stamping a UTC date makes an evening's work land on tomorrow.
+ */
+function today() {
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+}
 export function moveTaskInThread(threadName, dragId, targetId, position) {
     return mutateQueue(threadName, queue => moveTask(queue, dragId, targetId, position));
 }
 export function resolveDepInThread(threadName, id, accept) {
     return mutateQueue(threadName, queue => resolveProposedDep(queue, id, accept));
 }
+/** Task 178 — the drawer's Closed ✓ / Archive buttons. */
+export function dispositionTasksInThread(threadName, ids, disposition) {
+    return mutateFile(threadName, file => dispositionTasks(file, ids, disposition, today()));
+}
 //# sourceMappingURL=tasks.js.map

package/dist/gateway/tasks.js.map

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

package/dist/gateway/worker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Task 179 — the invisible background worker.
+ *
+ * Karl asked whether every thread should have "some kind of system co-thread for
+ * doing this kind of work, but that it wouldn't necessarily be visible in the
+ * threads UI", and answered his own poll with "yes — build it as a general
+ * facility, Refresh is just the first user."
+ *
+ * A co-thread is the wrong engine for it, on four grounded counts: its writes
+ * land in its own git worktree on its own branch (task 143 P4), it is drawn in
+ * the sidebar under its master, it shares the master's stored content in BOTH
+ * directions — so a worker that reads a whole file pours it into the master's
+ * memory — and only a thread already mid-turn can create one, which a button
+ * click is not.
+ *
+ * So this is not a chat thread at all. It is a gateway-owned one-shot model call
+ * with no conversation, no history and no sidebar row — `runOneShotModel` plus
+ * the two things that make it a *facility* rather than a bare call:
+ *
+ *   1. **One job per `{thread, kind}` at a time.** A second request while one is
+ *      in flight is REFUSED, not queued. Two Refreshes racing on one `Tasks.md`
+ *      is the exact failure the whole task exists to prevent, and a queue would
+ *      merely delay it.
+ *   2. **A status push** (`running | done | failed`) to whoever is watching, so a
+ *      button can spin without the UI inventing a second notion of "busy".
+ *
+ * It deliberately never touches `threadBusy`. That flag drives the sidebar dots
+ * (task 146), the stall check (task 164) and the deferred-message drain (task
+ * 144); a worker that set it would make the sidebar claim a turn was running,
+ * suppress a real stall check, and drain a user's queued message into nothing.
+ */
+import { type OneShotModelContext } from './one-shot-model.js';
+/**
+ * What a worker run is for. A closed union, not a free string: the key is half of
+ * the in-flight identity, so a typo would silently buy a second concurrent slot
+ * on the same thread — the one thing this module exists to deny.
+ */
+export type WorkerKind = 'tasks-refresh';
+export type WorkerState = 'running' | 'done' | 'failed';
+export interface WorkerStatus {
+    threadName: string;
+    kind: WorkerKind;
+    state: WorkerState;
+    /** Present on `failed`, and on `done` when there is something worth saying. */
+    detail?: string;
+}
+/** Thrown by {@link runWorker} when this `{thread, kind}` is already working. */
+export declare class WorkerBusyError extends Error {
+    constructor(kind: WorkerKind);
+}
+/** Thrown when the model produced no answer at all (spawn failure, timeout, empty). */
+export declare class WorkerNoAnswerError extends Error {
+    constructor();
+}
+export declare function isWorkerRunning(threadName: string, kind: WorkerKind): boolean;
+/**
+ * Where worker progress goes. Registered by the webchat adapter at startup for
+ * the same reason `setThreadActivityListener` and `setUserQueueDelivery` are:
+ * only the adapter can reach the sockets, and this module must not know they
+ * exist.
+ */
+type WorkerStatusListener = (status: WorkerStatus) => void;
+export declare function setWorkerStatusListener(fn: WorkerStatusListener | undefined): void;
+export interface RunWorkerOptions {
+    /** Configured worker model id (`workerModel`), resolved against both catalogs. */
+    model?: string;
+    context?: OneShotModelContext;
+    timeoutMs?: number;
+    maxTokens?: number;
+}
+/**
+ * Run one prompt as this thread's `kind` worker and return the model's raw text.
+ *
+ * Throws {@link WorkerBusyError} if that slot is taken and
+ * {@link WorkerNoAnswerError} if the model produced nothing — both before any
+ * caller-visible side effect, so a refused run leaves no trace.
+ *
+ * The slot is released in a `finally`, so a caller that throws while INTERPRETING
+ * the answer (which is where task 179's guard rails live) still frees the button.
+ */
+export declare function runWorker(threadName: string, kind: WorkerKind, prompt: string, opts?: RunWorkerOptions): Promise<string>;
+/** Announce the end of a worker run. Separate from {@link runWorker} because the
+ * caller — not this module — knows whether interpreting the answer succeeded. */
+export declare function reportWorkerResult(threadName: string, kind: WorkerKind, state: 'done' | 'failed', detail?: string): void;
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/gateway/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/gateway/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,IAAI,EAAE,UAAU;CAI7B;AAED,uFAAuF;AACvF,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAQD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAE7E;AAED;;;;;GAKG;AACH,KAAK,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;AAG3D,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,oBAAoB,GAAG,SAAS,GAAG,IAAI,CAElF;AAmBD,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED;iFACiF;AACjF,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GAAG,QAAQ,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAEN"}

package/dist/gateway/worker.js.map

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

package/dist/lib/tasks-file.d.ts

@@ -29,6 +29,16 @@ export declare const TASKS_FILE_MARKER = "<!-- cumulus:tasks v1 -->";
 /** Field keys the parser accepts. Nothing else parses. */
 export declare const TASK_FIELD_KEYS: readonly ["doc", "phase", "note", "dep", "done"];
 export type TaskFieldKey = (typeof TASK_FIELD_KEYS)[number];
+/** Task 178 — a row that left the queue having worked. */
+export declare const TASK_STATUS_CLOSED = "\u2705";
+/**
+ * Task 178 — a row that left the queue WITHOUT working: dropped, superseded, or
+ * gone stale. Distinct from `❌` (implemented, then failed its test), which is a
+ * verdict on work that happened; this is the absence of a verdict.
+ */
+export declare const TASK_STATUS_ARCHIVED = "\u2298";
+/** What the drawer's two disposition buttons do to a row. */
+export type TaskDisposition = 'closed' | 'archived';
 export interface TaskRow {
     /** Digits, unique across the whole file. */
     id: string;
@@ -108,6 +118,19 @@ export declare function moveTask(rows: TaskRow[], dragId: string, targetId: stri
  * lands them after the cluster they just left.
  */
 export declare function resolveProposedDep(rows: TaskRow[], id: string, accept: boolean): TaskRow[];
+/**
+ * Task 178 — take rows out of the queue and put them at the top of `## Done`.
+ *
+ * `closed` stamps `[✅]`, `archived` stamps `[⊘]`; both stamp `done <date>`, which
+ * is exactly what the manual tells an agent to do by hand. Ordering is
+ * newest-first, matching how the file has been kept since 176.
+ *
+ * A dispositioned row's children are PROMOTED one level rather than removed: the
+ * thing that blocked them is finished, so they are now blocked by whatever blocked
+ * it — or by nothing. That keeps {@link assertValidQueue} true without a special
+ * case, and it is the only edit that does not silently drop work.
+ */
+export declare function dispositionTasks(file: TasksFile, ids: string[], disposition: TaskDisposition, today: string): TasksFile;
 /** Structural invariants every write must preserve. */
 export declare function assertValidQueue(rows: TaskRow[]): void;
 /** Refuses writes to a file the parser did not fully understand. */

package/dist/lib/tasks-file.d.ts.map

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

package/dist/lib/tasks-file.js

@@ -35,6 +35,14 @@ export const TASKS_FILE_MARKER = '<!-- cumulus:tasks v1 -->';
 const MARKER_MAX_LINE = 10;
 /** Field keys the parser accepts. Nothing else parses. */
 export const TASK_FIELD_KEYS = ['doc', 'phase', 'note', 'dep', 'done'];
+/** Task 178 — a row that left the queue having worked. */
+export const TASK_STATUS_CLOSED = '✅';
+/**
+ * Task 178 — a row that left the queue WITHOUT working: dropped, superseded, or
+ * gone stale. Distinct from `❌` (implemented, then failed its test), which is a
+ * verdict on work that happened; this is the absence of a verdict.
+ */
+export const TASK_STATUS_ARCHIVED = '⊘';
 /** Two spaces of indent per level of dependency nesting. */
 const INDENT_UNIT = 2;
 /** Fields sit one further indent unit past their row, for legibility only. */
@@ -382,6 +390,47 @@ export function resolveProposedDep(rows, id, accept) {
     assertValidQueue(next);
     return next;
 }
+/**
+ * Task 178 — take rows out of the queue and put them at the top of `## Done`.
+ *
+ * `closed` stamps `[✅]`, `archived` stamps `[⊘]`; both stamp `done <date>`, which
+ * is exactly what the manual tells an agent to do by hand. Ordering is
+ * newest-first, matching how the file has been kept since 176.
+ *
+ * A dispositioned row's children are PROMOTED one level rather than removed: the
+ * thing that blocked them is finished, so they are now blocked by whatever blocked
+ * it — or by nothing. That keeps {@link assertValidQueue} true without a special
+ * case, and it is the only edit that does not silently drop work.
+ */
+export function dispositionTasks(file, ids, disposition, today) {
+    if (ids.length === 0)
+        throw new TasksFileError('No tasks given to close');
+    let queue = file.queue.slice();
+    const finished = [];
+    for (const id of ids) {
+        if (file.done.some(r => r.id === id)) {
+            throw new TasksFileError(`Task ${id} is already in Done`);
+        }
+        const i = indexOfId(queue, id);
+        const row = at(queue, i);
+        const end = subtreeEnd(queue, i);
+        const promoted = queue
+            .slice(i + 1, end + 1)
+            .map(child => ({ ...child, depth: child.depth - 1, depProposed: false }));
+        queue = [...queue.slice(0, i), ...promoted, ...queue.slice(end + 1)];
+        finished.push({
+            ...row,
+            depth: 0,
+            depProposed: false,
+            status: disposition === 'closed' ? TASK_STATUS_CLOSED : TASK_STATUS_ARCHIVED,
+            done: today,
+        });
+    }
+    assertValidQueue(queue);
+    // Newest first. A batch lands together, in the order it was given, so several
+    // rows closed in one click read as one event rather than as a reversed list.
+    return { ...file, queue, done: [...finished, ...file.done] };
+}
 /** Structural invariants every write must preserve. */
 export function assertValidQueue(rows) {
     if (rows.length === 0)