@luckydraw/cumulus 1.0.43 → 1.0.45

package/dist/gateway/static/widget.js

@@ -139,13 +139,12 @@
       // and re-adding it does not quietly clear the voice setting. The gateway's
       // resolveVoiceModel treats an unmatched id as "no override" anyway.
       voiceModel: typeof config.voiceModel === 'string' ? config.voiceModel : '',
-      // Task 164. Same verbatim rule as voiceModel: an id naming nothing in claudeModels[]
-      // is preserved on round-trip; the gateway's resolveStallClassifierModel falls back to
-      // "haiku" for an unmatched id anyway.
+      // Task 164. Same verbatim rule as voiceModel: an id naming nothing in the catalog is
+      // preserved on round-trip; the gateway reads an unmatched id as NOT CONFIGURED
+      // (task 184), which is what the dropdown shows for it too.
       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.
+      // Task 179. Same verbatim rule again, same not-configured reading.
       workerModel: typeof config.workerModel === 'string' ? config.workerModel : '',
     };
   }
@@ -208,11 +207,11 @@
       // Task 152: '' means "same as thread" and must reach the server as an explicit
       // null (clear), not as absent — absent would leave the stored value untouched.
       voiceModel: state.voiceModel ? state.voiceModel : null,
-      // 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.
+      // Task 164: '' means "not configured" 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.
+      // Task 179: same explicit-null rule — '' means "not configured", 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.
@@ -5653,6 +5652,16 @@
         menu.appendChild(coItem);
       }
 
+      var renameItem = document.createElement('button');
+      renameItem.className = 'cumulus-context-menu-item';
+      renameItem.textContent = 'Rename thread…';
+      renameItem.setAttribute('data-testid', 'webchat-thread-rename');
+      renameItem.addEventListener('click', function () {
+        dismissContextMenu();
+        showThreadRenameDialog(threadName, master);
+      });
+      menu.appendChild(renameItem);
+
       var deleteItem = document.createElement('button');
       deleteItem.className = 'cumulus-context-menu-item danger';
       deleteItem.textContent = 'Delete thread';
@@ -5836,6 +5845,190 @@
       xhr.send(JSON.stringify({ label: label }));
     }
 
+    // ── Thread rename (task 186) ──
+
+    /**
+     * Re-key every piece of client state that names a thread. One function so
+     * a `thread_renamed` from the server and a rename this tab just made take
+     * the same path; a list missed here is a sidebar row that 404s on click.
+     */
+    function applyThreadRename(from, to) {
+      for (var i = 0; i < allThreads.length; i++) {
+        if (allThreads[i].name === from) allThreads[i].name = to;
+        if (allThreads[i].master === from) allThreads[i].master = to;
+      }
+      if (threadStates[from]) {
+        threadStates[to] = threadStates[from];
+        delete threadStates[from];
+      }
+      var vi = visibleThreads.indexOf(from);
+      if (vi !== -1) visibleThreads[vi] = to;
+      if (busyThreads[from]) {
+        busyThreads[to] = true;
+        delete busyThreads[from];
+      }
+      if (unreadThreads[from]) {
+        unreadThreads[to] = unreadThreads[from];
+        delete unreadThreads[from];
+      }
+      if (collapsedMasters[from]) {
+        collapsedMasters[to] = true;
+        delete collapsedMasters[from];
+        try {
+          localStorage.setItem('cumulus-collapsed-masters', JSON.stringify(collapsedMasters));
+        } catch {
+          /* storage unavailable — the collapse state is cosmetic */
+        }
+      }
+    }
+
+    function renameThread(from, to, cb) {
+      var xhr = new XMLHttpRequest();
+      xhr.open('POST', '/api/thread/' + encodeURIComponent(from) + '/rename');
+      xhr.setRequestHeader('Content-Type', 'application/json');
+      xhr.setRequestHeader('X-API-Key', activeApiKey);
+      xhr.onload = function () {
+        var body = {};
+        try {
+          body = JSON.parse(xhr.responseText || '{}');
+        } catch {
+          /* fall through to the status-based message below */
+        }
+        if (xhr.status === 200) {
+          cb(null, body);
+          return;
+        }
+        cb(body.error || 'Could not rename the thread (' + xhr.status + ').');
+      };
+      xhr.onerror = function () {
+        cb('Could not reach the gateway.');
+      };
+      xhr.send(JSON.stringify({ name: to }));
+    }
+
+    function showThreadRenameDialog(threadName, master) {
+      var existing = document.querySelector('.cumulus-confirm-dialog[data-context="rename"]');
+      if (existing) existing.remove();
+
+      // A co-thread keeps its master's prefix (the server enforces it); the
+      // dialog shows the prefix as fixed text and edits only the label.
+      var prefix = master ? master + '-' : '';
+      var current = threadName.slice(prefix.length);
+
+      var dialog = document.createElement('div');
+      dialog.className = 'cumulus-confirm-dialog';
+      dialog.setAttribute('data-context', 'rename');
+      dialog.style.cssText =
+        'position: fixed; top: 0; left: 0; right: 0; bottom: 0; background: rgba(0,0,0,0.6); z-index: 200; display: flex; align-items: center; justify-content: center;';
+
+      var box = document.createElement('div');
+      box.className = 'cumulus-confirm-dialog-box';
+
+      var title = document.createElement('div');
+      title.className = 'cumulus-confirm-dialog-title';
+      title.textContent = master ? 'Rename co-thread' : 'Rename thread';
+      box.appendChild(title);
+
+      var text = document.createElement('div');
+      text.className = 'cumulus-confirm-dialog-text';
+      text.textContent = master
+        ? 'Keeps "' + master + '-" so it stays a co-thread of ' + master + '.'
+        : 'Everything the thread has — history, memory, settings, jobs, schedules — moves with it.';
+      box.appendChild(text);
+
+      var input = document.createElement('input');
+      input.type = 'text';
+      input.className = 'cumulus-co-thread-input';
+      input.value = current;
+      input.setAttribute('data-testid', 'webchat-thread-rename-input');
+      box.appendChild(input);
+
+      var preview = document.createElement('div');
+      preview.className = 'cumulus-confirm-dialog-warn';
+      preview.setAttribute('data-testid', 'webchat-thread-rename-preview');
+      box.appendChild(preview);
+
+      // Mirrors THREAD_NAME_RE / CO_THREAD_LABEL_RE in thread-rename.ts. The
+      // server is authoritative; this only turns a 400 into a message written
+      // before the request is sent.
+      var NAME_OK = master ? /^[a-zA-Z0-9_]+$/ : /^[a-zA-Z0-9_-]+$/;
+      function refreshPreview() {
+        var value = input.value.trim();
+        if (!value) {
+          preview.textContent = master
+            ? 'Letters, numbers and underscores.'
+            : 'Letters, numbers, hyphens and underscores.';
+          return false;
+        }
+        if (!NAME_OK.test(value)) {
+          preview.textContent = master
+            ? 'Letters, numbers and underscores only — no spaces or hyphens.'
+            : 'Letters, numbers, hyphens and underscores only — no spaces.';
+          return false;
+        }
+        if (prefix + value === threadName) {
+          preview.textContent = 'That is the current name.';
+          return false;
+        }
+        preview.textContent = 'Renames to: ' + prefix + value;
+        return true;
+      }
+      refreshPreview();
+      input.addEventListener('input', refreshPreview);
+
+      var actions = document.createElement('div');
+      actions.className = 'cumulus-confirm-dialog-actions';
+
+      var cancelBtn = document.createElement('button');
+      cancelBtn.className = 'cumulus-confirm-dialog-cancel';
+      cancelBtn.textContent = 'Cancel';
+      cancelBtn.addEventListener('click', function () {
+        dialog.remove();
+      });
+      actions.appendChild(cancelBtn);
+
+      var renameBtn = document.createElement('button');
+      renameBtn.className = 'cumulus-confirm-dialog-confirm';
+      renameBtn.setAttribute('data-testid', 'webchat-thread-rename-confirm');
+      renameBtn.textContent = 'Rename';
+      function submit() {
+        if (!refreshPreview()) return;
+        renameBtn.disabled = true;
+        renameBtn.textContent = 'Renaming…';
+        var to = prefix + input.value.trim();
+        renameThread(threadName, to, function (err) {
+          if (err) {
+            renameBtn.disabled = false;
+            renameBtn.textContent = 'Rename';
+            preview.textContent = err;
+            return;
+          }
+          dialog.remove();
+          // The server also broadcasts thread_renamed to every tab, this one
+          // included; applying it here too means no flash of the old name.
+          applyThreadRename(threadName, to);
+          renderSidebar();
+          renderContentArea();
+          if (connection) connection.send({ type: 'threads' });
+        });
+      }
+      renameBtn.addEventListener('click', submit);
+      input.addEventListener('keydown', function (e) {
+        if (e.key === 'Enter') submit();
+        if (e.key === 'Escape') dialog.remove();
+      });
+      actions.appendChild(renameBtn);
+
+      box.appendChild(actions);
+      dialog.appendChild(box);
+      dialog.addEventListener('click', function (e) {
+        if (e.target === dialog) dialog.remove();
+      });
+      document.body.appendChild(dialog);
+      input.focus();
+      input.select();
+    }
+
     // ── Thread delete confirmation ──
     function showThreadDeleteConfirm(threadName) {
       // Remove any existing confirm dialogs
@@ -6679,10 +6872,10 @@
       voiceCard.appendChild(voiceSelect);
       body.appendChild(voiceCard);
 
-      // Task 164: the stall-detection classifier is a one-off `claude --print --model <id>`
-      // call, so it can only run on a Claude CLI sub-model — this dropdown lists ONLY the
-      // Anthropic sub-models (not the full catalog), with "Haiku (default)" clearing the
-      // setting. Same card shape as the voice model above.
+      // Task 164/165: the stall-detection classifier runs on any catalog model, so this
+      // dropdown lists the full catalog with a leading "Not configured" option that clears
+      // the setting — and clearing it really does turn the feature off (task 184). Same
+      // card shape as the voice model above.
       var stallCard = document.createElement('div');
       stallCard.className = 'cumulus-settings-default-card';
       var stallCardLabel = document.createElement('label');
@@ -7341,27 +7534,31 @@
 
       // Task 165: the classifier runs on ANY catalog model (a Claude CLI sub-model or a
       // direct-provider model), so this lists the FULL catalog grouped by provider — same
-      // shape as the voice selector — plus a leading "Haiku (default)" clear option. A
-      // stored id naming nothing in either catalog falls back to "Haiku (default)" in the
-      // UI — which is what the gateway does with it too (resolveStallClassifierModel → "haiku").
+      // shape as the voice selector — plus a leading "Not configured" clear option.
+      //
+      // Task 184: that option used to read "Haiku (default)", which was a claim about a
+      // model in no catalog that the operator never chose and that a fresh install has no
+      // way to run. Empty now means empty, on the screen and in the gateway alike, so the
+      // label says what the feature actually does when nothing is picked. A stored id
+      // naming nothing in either catalog lands here too — the gateway reads it the same way.
       function renderStallSelect() {
         stallSelect.innerHTML = '';
-        var haiku = document.createElement('option');
-        haiku.value = '';
-        haiku.textContent = 'Haiku (default)';
-        stallSelect.appendChild(haiku);
+        var unset = document.createElement('option');
+        unset.value = '';
+        unset.textContent = 'Not configured — no stall detection';
+        stallSelect.appendChild(unset);
         fillModelOptions(stallSelect);
         stallSelect.value = gwState.stallClassifierModel || '';
         if (stallSelect.value !== (gwState.stallClassifierModel || '')) stallSelect.value = '';
       }
 
-      // Task 179 — same rule, same fallback, its own setting.
+      // Task 179 — same rule, same not-configured reading, its own setting.
       function renderWorkerSelect() {
         workerSelect.innerHTML = '';
-        var workerHaiku = document.createElement('option');
-        workerHaiku.value = '';
-        workerHaiku.textContent = 'Haiku (default)';
-        workerSelect.appendChild(workerHaiku);
+        var workerUnset = document.createElement('option');
+        workerUnset.value = '';
+        workerUnset.textContent = 'Not configured — Refresh unavailable';
+        workerSelect.appendChild(workerUnset);
         fillModelOptions(workerSelect);
         workerSelect.value = gwState.workerModel || '';
         if (workerSelect.value !== (gwState.workerModel || '')) workerSelect.value = '';
@@ -10592,6 +10789,17 @@
           }
           break;
 
+        case 'thread_renamed':
+          // Task 186 — re-key this tab's state, then ask for the listing, which
+          // is what carries `master` and the per-thread counts.
+          if (data.from && data.to) {
+            applyThreadRename(data.from, data.to);
+            renderSidebar();
+            renderContentArea();
+            if (connection) connection.send({ type: 'threads' });
+          }
+          break;
+
         case 'thread_deleted':
           // Server confirms thread deleted; remove from sidebar and panels
           if (data.threadName) {

package/dist/gateway/thread-rename.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Task 186 — rename a thread or a co-thread.
+ *
+ * The thread's NAME is the key of every artefact the gateway keeps about it
+ * (task 185 lists them; the task doc for 186 repeats the list). So a rename is
+ * not a field update: it is one migration that moves every name-keyed row at
+ * once, and this module is the only place that migration is written. A second
+ * caller — an MCP tool, the CLI — calls `executeThreadRename`; there is no
+ * other path, because a path that moved most of the rows would leave a thread
+ * that half-exists under two names (Rule #8).
+ *
+ * Two phases, deliberately separate:
+ *
+ *   1. `planThreadRename` — validates and computes every move, including the
+ *      cascade when a master is renamed. Pure apart from the context callbacks,
+ *      so the six rules it enforces are testable without a filesystem, and so
+ *      nothing moves until the WHOLE plan is legal.
+ *   2. `executeThreadRename` — moves files, rewrites the master's `coThreads`,
+ *      moves worktrees, appends corrected attribution lines. The caller (server)
+ *      then re-keys its own in-memory maps and tells the sockets.
+ */
+import type { NamespaceConfig } from './config.js';
+/** The alphabet `create_thread` sanitises to. A rename refuses instead of sanitising. */
+export declare const THREAD_NAME_RE: RegExp;
+/** Mirrors CO_THREAD_LABEL in server.ts: the part of a co-thread's name after `<master>-`. */
+export declare const CO_THREAD_LABEL_RE: RegExp;
+/**
+ * Every per-thread file or directory under the threads dir, by extension. The
+ * same list `handleDeleteThread` walks, plus the streaming scratch file. A
+ * rename that missed one would leave an orphan that reattaches to nothing.
+ */
+export declare const THREAD_FILE_EXTENSIONS: readonly [".jsonl", ".embeddings.json", ".embeddings.bin", ".segments.json", ".adaptive.json", ".config.json", ".sessions", ".content", ".prompts", ".streaming.tmp"];
+/** A refused plan. `status` is the HTTP status the endpoint answers with. */
+export declare class ThreadRenameError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface RenameMove {
+    from: string;
+    to: string;
+}
+export interface ThreadRenamePlan {
+    from: string;
+    to: string;
+    /** Set when the renamed thread is a co-thread: whose list to rewrite. */
+    coThreadMaster?: string;
+    /** Cascaded co-thread renames when a master is renamed (empty otherwise). */
+    coThreads: RenameMove[];
+    /** Every move, the thread itself first. */
+    moves: RenameMove[];
+}
+export interface PlanContext {
+    namespaces: NamespaceConfig[];
+    /** Any artefact under any extension exists for this name. */
+    threadExists(name: string): boolean;
+    /** The thread is mid-turn right now. */
+    threadBusy(name: string): boolean;
+    /** Master of a registered co-thread, else undefined. */
+    coThreadMasterOf(name: string): string | undefined;
+    /** The master's registered co-thread list (its EXACT config). */
+    coThreadsOf(master: string): Promise<string[]>;
+}
+/**
+ * Validate a rename and compute every move it implies.
+ *
+ * Rules, in the order they are checked (each one's failure names it):
+ *  1. `from` exists.
+ *  2. `to` has the thread-name shape and differs from `from`.
+ *  3. Neither name is a namespace base, and both fall in the same namespace.
+ *  4. A co-thread keeps `<master>-` and its new label has the label shape.
+ *  5. A master's co-threads cascade: `<from>-x` → `<to>-x`.
+ *  6. No target name exists; no source is mid-turn. Checked for the WHOLE
+ *     cascade before anything is reported legal.
+ */
+export declare function planThreadRename(from: string, to: string, ctx: PlanContext): Promise<ThreadRenamePlan>;
+export interface ExecuteContext {
+    threadsDir: string;
+    /** The project directory a master's worktrees hang off. */
+    projectDirFor(master: string): Promise<string | undefined>;
+}
+export interface ThreadRenameResult {
+    from: string;
+    to: string;
+    coThreads: RenameMove[];
+    /** Extensions actually moved, per thread. */
+    moved: Record<string, string[]>;
+    /** Attribution entries rewritten in the affected content store. */
+    attributionUpdated: number;
+    /** Worktree outcomes for every co-thread move. */
+    worktrees: Array<RenameMove & {
+        moved: boolean;
+        detail?: string;
+    }>;
+}
+/** Move every existing artefact of `from` to `to`. Returns the extensions moved. */
+export declare function renameThreadFiles(threadsDir: string, from: string, to: string): string[];
+/**
+ * Carry out a legal plan. Order matters:
+ *
+ *  - The project dir is read BEFORE the files move: for a master it lives in
+ *    the config file that is about to change name.
+ *  - Files move before the `coThreads` rewrite, because for a master the list
+ *    is written into the config under its NEW name.
+ *  - Worktrees move from the master's checkout, which does not move.
+ *  - Attribution is appended last, into the store under its new path.
+ */
+export declare function executeThreadRename(plan: ThreadRenamePlan, ctx: ExecuteContext): Promise<ThreadRenameResult>;
+//# sourceMappingURL=thread-rename.d.ts.map

package/dist/gateway/thread-rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-rename.d.ts","sourceRoot":"","sources":["../../src/gateway/thread-rename.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,yFAAyF;AACzF,eAAO,MAAM,cAAc,QAAqB,CAAC;AACjD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,QAAoB,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,uKAWzB,CAAC;AAEX,6EAA6E;AAC7E,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM;CAKlB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,2CAA2C;IAC3C,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,6DAA6D;IAC7D,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,wCAAwC;IACxC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,wDAAwD;IACxD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,iEAAiE;IACjE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AA4ED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,SAAS,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CASxF;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA4C7B"}

package/dist/gateway/thread-rename.js

@@ -0,0 +1,208 @@
+/**
+ * Task 186 — rename a thread or a co-thread.
+ *
+ * The thread's NAME is the key of every artefact the gateway keeps about it
+ * (task 185 lists them; the task doc for 186 repeats the list). So a rename is
+ * not a field update: it is one migration that moves every name-keyed row at
+ * once, and this module is the only place that migration is written. A second
+ * caller — an MCP tool, the CLI — calls `executeThreadRename`; there is no
+ * other path, because a path that moved most of the rows would leave a thread
+ * that half-exists under two names (Rule #8).
+ *
+ * Two phases, deliberately separate:
+ *
+ *   1. `planThreadRename` — validates and computes every move, including the
+ *      cascade when a master is renamed. Pure apart from the context callbacks,
+ *      so the six rules it enforces are testable without a filesystem, and so
+ *      nothing moves until the WHOLE plan is legal.
+ *   2. `executeThreadRename` — moves files, rewrites the master's `coThreads`,
+ *      moves worktrees, appends corrected attribution lines. The caller (server)
+ *      then re-keys its own in-memory maps and tells the sockets.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { loadThreadConfigExact, saveThreadConfig } from '../lib/config.js';
+import { ContentStore } from '../lib/content-store.js';
+import { moveCoThreadWorktree } from '../lib/worktree.js';
+import { namespaceForThread } from './namespaces.js';
+/** The alphabet `create_thread` sanitises to. A rename refuses instead of sanitising. */
+export const THREAD_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+/** Mirrors CO_THREAD_LABEL in server.ts: the part of a co-thread's name after `<master>-`. */
+export const CO_THREAD_LABEL_RE = /^[a-zA-Z0-9_]+$/;
+/**
+ * Every per-thread file or directory under the threads dir, by extension. The
+ * same list `handleDeleteThread` walks, plus the streaming scratch file. A
+ * rename that missed one would leave an orphan that reattaches to nothing.
+ */
+export const THREAD_FILE_EXTENSIONS = [
+    '.jsonl',
+    '.embeddings.json',
+    '.embeddings.bin',
+    '.segments.json',
+    '.adaptive.json',
+    '.config.json',
+    '.sessions',
+    '.content',
+    '.prompts',
+    '.streaming.tmp',
+];
+/** A refused plan. `status` is the HTTP status the endpoint answers with. */
+export class ThreadRenameError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'ThreadRenameError';
+    }
+}
+/**
+ * Validate a rename and compute every move it implies.
+ *
+ * Rules, in the order they are checked (each one's failure names it):
+ *  1. `from` exists.
+ *  2. `to` has the thread-name shape and differs from `from`.
+ *  3. Neither name is a namespace base, and both fall in the same namespace.
+ *  4. A co-thread keeps `<master>-` and its new label has the label shape.
+ *  5. A master's co-threads cascade: `<from>-x` → `<to>-x`.
+ *  6. No target name exists; no source is mid-turn. Checked for the WHOLE
+ *     cascade before anything is reported legal.
+ */
+export async function planThreadRename(from, to, ctx) {
+    if (!ctx.threadExists(from)) {
+        throw new ThreadRenameError(404, `Thread "${from}" does not exist.`);
+    }
+    if (!THREAD_NAME_RE.test(to)) {
+        throw new ThreadRenameError(400, 'A thread name is letters, numbers, hyphens and underscores only (no spaces or slashes).');
+    }
+    if (to === from) {
+        throw new ThreadRenameError(400, `"${from}" is already this thread's name.`);
+    }
+    assertNamespacePreserved(from, to, ctx.namespaces);
+    const coThreadMaster = ctx.coThreadMasterOf(from);
+    if (coThreadMaster)
+        assertCoThreadShape(from, to, coThreadMaster);
+    const coThreads = coThreadMaster ? [] : cascadeMoves(from, to, await ctx.coThreadsOf(from));
+    const moves = [{ from, to }, ...coThreads];
+    assertMovesLegal(from, moves, ctx);
+    return { from, to, ...(coThreadMaster ? { coThreadMaster } : {}), coThreads, moves };
+}
+/**
+ * Rule 3 — a namespace is a thread-name prefix and a capability boundary
+ * (task 097): a rename must not move a thread across one, and the base
+ * thread's name IS the namespace.
+ */
+function assertNamespacePreserved(from, to, namespaces) {
+    const nsBases = new Set(namespaces.map(ns => ns.name));
+    if (nsBases.has(from)) {
+        throw new ThreadRenameError(400, `"${from}" is the base thread of a namespace; its name is the namespace and cannot change.`);
+    }
+    if (nsBases.has(to)) {
+        throw new ThreadRenameError(400, `"${to}" is the name of a namespace.`);
+    }
+    const nsFrom = namespaceForThread(from, namespaces);
+    const nsTo = namespaceForThread(to, namespaces);
+    if (nsFrom !== nsTo) {
+        throw new ThreadRenameError(400, nsFrom
+            ? `"${from}" belongs to the "${nsFrom}" namespace, so its new name must keep the "${nsFrom}-" prefix.`
+            : `"${to}" would move the thread into the "${nsTo}" namespace.`);
+    }
+}
+/**
+ * Rule 4 — a co-thread resolves to its master by prefix chain plus
+ * registration. A name that stops starting with `<master>-` loses the shared
+ * store and the worktree in one stroke.
+ */
+function assertCoThreadShape(from, to, master) {
+    const prefix = `${master}-`;
+    const label = to.startsWith(prefix) ? to.slice(prefix.length) : '';
+    if (!label || !CO_THREAD_LABEL_RE.test(label)) {
+        throw new ThreadRenameError(400, `"${from}" is a co-thread of "${master}", so its new name must be "${prefix}<label>" with a label of letters, numbers or underscores.`);
+    }
+}
+/** Rule 5 — a master's registered co-threads follow it: `<from>-x` → `<to>-x`. */
+function cascadeMoves(from, to, registered) {
+    return registered.map(name => {
+        if (!name.startsWith(`${from}-`)) {
+            throw new ThreadRenameError(409, `Registered co-thread "${name}" does not carry the "${from}-" prefix; fix the registration before renaming.`);
+        }
+        return { from: name, to: `${to}${name.slice(from.length)}` };
+    });
+}
+/** Rule 6 — over the WHOLE plan, before anything is reported legal. */
+function assertMovesLegal(from, moves, ctx) {
+    for (const move of moves) {
+        if (ctx.threadExists(move.to)) {
+            throw new ThreadRenameError(409, `A thread named "${move.to}" already exists.`);
+        }
+        if (ctx.threadBusy(move.from)) {
+            throw new ThreadRenameError(409, move.from === from
+                ? `"${from}" is running a turn; rename it once it is idle.`
+                : `Co-thread "${move.from}" is running a turn; rename once it is idle.`);
+        }
+    }
+}
+/** Move every existing artefact of `from` to `to`. Returns the extensions moved. */
+export function renameThreadFiles(threadsDir, from, to) {
+    const moved = [];
+    for (const ext of THREAD_FILE_EXTENSIONS) {
+        const source = path.join(threadsDir, `${from}${ext}`);
+        if (!fs.existsSync(source))
+            continue;
+        fs.renameSync(source, path.join(threadsDir, `${to}${ext}`));
+        moved.push(ext);
+    }
+    return moved;
+}
+/**
+ * Carry out a legal plan. Order matters:
+ *
+ *  - The project dir is read BEFORE the files move: for a master it lives in
+ *    the config file that is about to change name.
+ *  - Files move before the `coThreads` rewrite, because for a master the list
+ *    is written into the config under its NEW name.
+ *  - Worktrees move from the master's checkout, which does not move.
+ *  - Attribution is appended last, into the store under its new path.
+ */
+export async function executeThreadRename(plan, ctx) {
+    const master = plan.coThreadMaster ?? plan.from;
+    const masterDir = await ctx.projectDirFor(master);
+    const moved = {};
+    for (const move of plan.moves) {
+        moved[move.from] = renameThreadFiles(ctx.threadsDir, move.from, move.to);
+    }
+    if (plan.coThreadMaster) {
+        const config = await loadThreadConfigExact(plan.coThreadMaster);
+        await saveThreadConfig(plan.coThreadMaster, {
+            coThreads: (config.coThreads ?? []).map(n => (n === plan.from ? plan.to : n)),
+        });
+    }
+    else if (plan.coThreads.length > 0) {
+        await saveThreadConfig(plan.to, { coThreads: plan.coThreads.map(m => m.to) });
+    }
+    const worktrees = [];
+    const coMoves = plan.coThreadMaster ? [{ from: plan.from, to: plan.to }] : plan.coThreads;
+    for (const move of coMoves) {
+        const outcome = await moveCoThreadWorktree(move.from, move.to, masterDir);
+        worktrees.push({ ...move, ...outcome });
+    }
+    // The store that carries this thread's tags: its own for a plain thread or a
+    // master (now under the new name), the master's for a co-thread.
+    const storeOwner = plan.coThreadMaster ?? plan.to;
+    const storePath = path.join(ctx.threadsDir, `${storeOwner}.content`);
+    let attributionUpdated = 0;
+    if (fs.existsSync(storePath)) {
+        const mapping = {};
+        for (const move of plan.moves)
+            mapping[move.from] = move.to;
+        attributionUpdated = await new ContentStore(storePath).renameThreads(mapping);
+    }
+    return {
+        from: plan.from,
+        to: plan.to,
+        coThreads: plan.coThreads,
+        moved,
+        attributionUpdated,
+        worktrees,
+    };
+}
+//# sourceMappingURL=thread-rename.js.map

package/dist/gateway/thread-rename.js.map

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