@luckydraw/cumulus 1.0.39 → 1.0.41

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

@@ -0,0 +1,115 @@
+/**
+ * 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.
+ *
+ * Task 180, after the first live press: `## Done` is now split off before the
+ * prompt is built and re-attached after, and an empty queue is refused outright.
+ * See {@link splitOffDone} — the model was rewriting the one section the format
+ * says is never sent to a model, because it was the only thing left to touch.
+ */
+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[];
+export interface DoneSplit {
+    /** Everything above `## Done`. The only part a model ever sees of a migrated file. */
+    head: string;
+    /** The `## Done` heading and everything under it, or null if the file has no such section. */
+    done: string | null;
+}
+/**
+ * Split a tasks file at its `## Done` heading.
+ *
+ * Task 180: `## Done` is the record of work that has left the queue, and the
+ * format's own rule is that it is never sent to a model. The first live Refresh
+ * proved why that has to be enforced with scissors rather than with a sentence in
+ * the prompt: handed the whole file and an empty queue, the model spent its one
+ * call appending "the reload has happened" to twelve finished tasks.
+ *
+ * The LAST heading wins, because the manual carried inside every migrated file
+ * quotes `## Done` while describing the grammar.
+ */
+export declare function splitOffDone(content: string): DoneSplit;
+/**
+ * Re-attach the withheld record to the model's answer.
+ *
+ * The original section goes back byte-for-byte. If the model emitted a `## Done`
+ * of its own — it is told not to — those rows are spliced in ABOVE the preserved
+ * ones rather than discarded: dropping them would lose their ids, and the drop
+ * check would then refuse an answer whose only sin was disobedience.
+ */
+export declare function stitchDone(answer: string, originalDone: 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;
+    /** True when `## Done` was split off and will be re-attached unchanged (task 180). */
+    doneWithheld: boolean;
+}
+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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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;AAKD,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAMvD;AAOD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAOvE;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;IAChB,sFAAsF;IACtF,YAAY,EAAE,OAAO,CAAC;CACvB;AA4CD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAyCpE;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,CAiDxB"}

package/dist/gateway/tasks-refresh.js

@@ -0,0 +1,333 @@
+/**
+ * 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.
+ *
+ * Task 180, after the first live press: `## Done` is now split off before the
+ * prompt is built and re-attached after, and an empty queue is refused outright.
+ * See {@link splitOffDone} — the model was rewriting the one section the format
+ * says is never sent to a model, because it was the only thing left to touch.
+ */
+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;
+}
+/** The `## Done` heading, alone on its line — the same shape the parser accepts. */
+const DONE_HEADING_RE = /^## +Done *$/;
+/**
+ * Split a tasks file at its `## Done` heading.
+ *
+ * Task 180: `## Done` is the record of work that has left the queue, and the
+ * format's own rule is that it is never sent to a model. The first live Refresh
+ * proved why that has to be enforced with scissors rather than with a sentence in
+ * the prompt: handed the whole file and an empty queue, the model spent its one
+ * call appending "the reload has happened" to twelve finished tasks.
+ *
+ * The LAST heading wins, because the manual carried inside every migrated file
+ * quotes `## Done` while describing the grammar.
+ */
+export function splitOffDone(content) {
+    const lines = content.split('\n');
+    let at = -1;
+    for (let i = 0; i < lines.length; i++)
+        if (DONE_HEADING_RE.test(lines[i]))
+            at = i;
+    if (at < 0)
+        return { head: content, done: null };
+    return { head: lines.slice(0, at).join('\n'), done: lines.slice(at).join('\n') };
+}
+/** The rows under a `## Done` heading, with the heading and its blank padding gone. */
+function doneBody(section) {
+    return section.split('\n').slice(1).join('\n').trim();
+}
+/**
+ * Re-attach the withheld record to the model's answer.
+ *
+ * The original section goes back byte-for-byte. If the model emitted a `## Done`
+ * of its own — it is told not to — those rows are spliced in ABOVE the preserved
+ * ones rather than discarded: dropping them would lose their ids, and the drop
+ * check would then refuse an answer whose only sin was disobedience.
+ */
+export function stitchDone(answer, originalDone) {
+    const split = splitOffDone(answer);
+    const moved = split.done ? doneBody(split.done) : '';
+    const kept = doneBody(originalDone);
+    const heading = originalDone.split('\n', 1)[0];
+    const body = [moved, kept].filter(Boolean).join('\n');
+    return `${split.head.trimEnd()}\n\n${heading}\n\n${body}\n`;
+}
+/** 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.
+ */
+/**
+ * Rules 1 and 6 — the two that change when the record is withheld: what to
+ * output, and where a finished task goes.
+ */
+function promptShape(doneWithheld) {
+    if (doneWithheld) {
+        return {
+            rule1: [
+                '1. Output the file down to the END OF THE QUEUE and stop there: 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) and `## Queue`.',
+                '   Do NOT write a `## Done` section. The file has one; it is finished work, it was',
+                '   deliberately withheld from you, and it is re-attached unchanged after you answer.',
+            ].join('\n'),
+            rule6: [
+                '6. When a task is finished, mark its row `[✅]` and LEAVE IT IN THE QUEUE. Moving a',
+                "   task out of the queue is the user's decision, taken in the drawer, not yours.",
+            ].join('\n'),
+        };
+    }
+    return {
+        rule1: [
+            '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`.',
+        ].join('\n'),
+        rule6: [
+            '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.',
+        ].join('\n'),
+    };
+}
+export function buildRefreshPrompt(input) {
+    const docs = input.docs.length
+        ? input.docs.map(d => `- docs/tasks/${d}`).join('\n')
+        : '(no docs/tasks directory)';
+    const shape = promptShape(input.doneWithheld);
+    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 ===',
+        shape.rule1,
+        '2. EVERY task shown to you 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.',
+        shape.rule6,
+        '',
+        '=== EVIDENCE YOU CANNOT GET FROM THE FILE ===',
+        `The gateway is currently running version ${input.version}. A QUEUED task whose note`,
+        'claims its change is "published, needs reload" for a version at or below this one is',
+        'stale — the reload has happened, and that is grounds to re-check its status. Do not',
+        'rewrite a note merely to say so: an edit that changes no status is not worth making.',
+        '',
+        'Task documents that exist on disk (use these for `doc` fields; do not invent paths):',
+        docs,
+        '',
+        input.doneWithheld
+            ? '=== THE CURRENT FILE, DOWN TO THE END OF THE QUEUE (its `## Done` is withheld) ==='
+            : 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.');
+    }
+    // Task 180: nothing in the queue, nothing to refresh. Refused BEFORE the
+    // snapshot and the model call, because the alternative is what happened on the
+    // first live press — a model with no legal work finding some anyway. A file
+    // that fails to parse is exempt: a queue that reads as empty because the file
+    // is broken is precisely the case Refresh exists to fix.
+    if (target.migrated) {
+        const current = parseTasksFile(target.content);
+        if (current.queue.length === 0 && current.errors.length === 0) {
+            throw new TasksRefreshError('Nothing to refresh — the queue is empty. Finished work in `## Done` is the record ' +
+                'and is left alone.');
+        }
+    }
+    const committed = snapshotBeforeRefresh(target.filePath);
+    // The record is split off rather than trusted to the prompt — see splitOffDone.
+    const split = target.migrated
+        ? splitOffDone(target.content)
+        : { head: target.content, done: null };
+    const prompt = buildRefreshPrompt({
+        content: split.done ? split.head : target.content,
+        migrated: target.migrated,
+        docs: taskDocListing(target.cwd),
+        version: getCurrentVersion(),
+        doneWithheld: split.done !== null,
+    });
+    const raw = opts.runModel
+        ? await opts.runModel(prompt)
+        : await runWorker(threadName, 'tasks-refresh', prompt, opts);
+    const answer = unfence(raw);
+    const next = split.done ? stitchDone(answer, split.done) : answer;
+    assertUsable(answer, next, target.content);
+    fs.writeFileSync(target.filePath, next.endsWith('\n') ? next : `${next}\n`, 'utf-8');
+    return { payload: await readTasks(threadName), committed, droppedIds: [] };
+}
+/**
+ * The guard rails. Each one refuses the WHOLE answer; none patches it up, and
+ * every one throws before the single `writeFileSync` above runs, so a refusal
+ * leaves the file byte-identical to what the snapshot just committed.
+ */
+function assertUsable(answer, next, original) {
+    // Emptiness is judged on the ANSWER, not the stitched file: re-attaching the
+    // record to nothing would produce a plausible-looking file with no queue.
+    if (!answer) {
+        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(original));
+    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.');
+    }
+}
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAqB,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,SAAS,EAAyB,MAAM,aAAa,CAAC;AAE/D,yDAAyD;AACzD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;CAAG;AAE/C,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,OAAO;YAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC;QAChD,IAAI,QAAQ;YAAE,SAAS;QACvB,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oFAAoF;AACpF,MAAM,eAAe,GAAG,cAAc,CAAC;AASvC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAAE,EAAE,GAAG,CAAC,CAAC;IACnF,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,uFAAuF;AACvF,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,YAAoB;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,OAAO,OAAO,IAAI,IAAI,CAAC;AAC9D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACnE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACtC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,iBAAiB,CACzB,wDAAwD,QAAQ,kBAAkB;YAChF,uEAAuE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9B,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,6EAA6E;QAC7E,2DAA2D;QAC3D,MAAM,CAAC,GAAG,GAA6D,CAAC;QACxE,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,IAAI,6DAA6D,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7F,MAAM,IAAI,iBAAiB,CACzB,kCAAkC,GAAG,uBACnC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,EAAE;aACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;aAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aACpC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAWD;;;;;;;;GAQG;AACH;;;GAGG;AACH,SAAS,WAAW,CAAC,YAAqB;IACxC,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,EAAE;gBACL,oFAAoF;gBACpF,oFAAoF;gBACpF,oFAAoF;gBACpF,oFAAoF;gBACpF,sFAAsF;aACvF,CAAC,IAAI,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE;gBACL,oFAAoF;gBACpF,kFAAkF;aACnF,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE;YACL,qEAAqE;YACrE,kFAAkF;YAClF,2EAA2E;SAC5E,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE;YACL,oFAAoF;YACpF,uEAAuE;SACxE,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM;QAC5B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrD,CAAC,CAAC,2BAA2B,CAAC;IAEhC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAE9C,OAAO;QACL,8EAA8E;QAC9E,gFAAgF;QAChF,EAAE;QACF,uEAAuE;QACvE,oBAAoB;QACpB,EAAE;QACF,eAAe;QACf,KAAK,CAAC,KAAK;QACX,0EAA0E;QAC1E,kFAAkF;QAClF,sEAAsE;QACtE,4EAA4E;QAC5E,mFAAmF;QACnF,uEAAuE;QACvE,sFAAsF;QACtF,KAAK,CAAC,KAAK;QACX,EAAE;QACF,+CAA+C;QAC/C,4CAA4C,KAAK,CAAC,OAAO,4BAA4B;QACrF,sFAAsF;QACtF,qFAAqF;QACrF,sFAAsF;QACtF,EAAE;QACF,sFAAsF;QACtF,IAAI;QACJ,EAAE;QACF,KAAK,CAAC,YAAY;YAChB,CAAC,CAAC,oFAAoF;YACtF,CAAC,CAAC,KAAK,CAAC,QAAQ;gBACd,CAAC,CAAC,iEAAiE;gBACnE,CAAC,CAAC,mDAAmD;QACzD,KAAK,CAAC,OAAO;KACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB,EAClB,OAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,iBAAiB,CACzB,yFAAyF,CAC1F,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,+EAA+E;IAC/E,4EAA4E;IAC5E,8EAA8E;IAC9E,yDAAyD;IACzD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,iBAAiB,CACzB,oFAAoF;gBAClF,oBAAoB,CACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzD,gFAAgF;IAChF,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ;QAC3B,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAEzC,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO;QACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC;QAChC,OAAO,EAAE,iBAAiB,EAAE;QAC5B,YAAY,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI;KAClC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ;QACvB,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC7B,CAAC,CAAC,MAAM,SAAS,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAElE,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE3C,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,OAAO,CAAC,CAAC;IAErF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC7E,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,MAAc,EAAE,IAAY,EAAE,QAAgB;IAClE,6EAA6E;IAC7E,0EAA0E;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,iBAAiB,CAAC,yDAAyD,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,iBAAiB,CACzB,uFAAuF;YACrF,kEAAkE,CACrE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QAChC,MAAM,IAAI,iBAAiB,CACzB,uCAAuC,MAAM,CAAC,MAAM,CAAC,MAAM,YACzD,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GACpC,mBAAmB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,yBAAyB,CACxE,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,+EAA+E;IAC/E,gEAAgE;IAChE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,iBAAiB,CACzB,sBAAsB,UAAU,CAAC,MAAM,QAAQ,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC,IAAI,CACnG,IAAI,CACL,yDAAyD,CAC3D,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,iBAAiB,CACzB,sEAAsE,CACvE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/gateway/tasks.d.ts

@@ -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;

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,eAAe,EACf,OAAO,EACP,SAAS,EASV,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;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"}
+{"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

@@ -14,33 +14,68 @@ import { loadGlobalConfig, loadThreadConfig, mergeConfigs, resolveFilePath, } fr
 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) {

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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"}