@wrongstack/webui-server 0.302.2 → 0.303.0

package/dist/index.js

@@ -1464,7 +1464,13 @@ function indexDbVersion(projectRoot, indexDir) {
   try {
     const dir = resolveIndexDir(projectRoot, indexDir);
     const st = fs.statSync(path.join(dir, DB_FILE));
-    return `${st.mtimeMs}:${st.size}`;
+    let wal = "";
+    try {
+      const walSt = fs.statSync(path.join(dir, `${DB_FILE}-wal`));
+      wal = `:${walSt.mtimeMs}:${walSt.size}`;
+    } catch {
+    }
+    return `${st.mtimeMs}:${st.size}${wal}`;
   } catch {
     return "missing";
   }
@@ -7689,12 +7695,34 @@ function handleTodosGet(ctx, ws) {
     payload: sessionPayload(ctx, { todos: [...ctx.context.todos] })
   });
 }
-function handleTodosClear(ctx, ws) {
-  ctx.replaceTodos?.([]);
-  sendResult3(ctx, ws, true, "Todos cleared");
-  ctx.broadcast({ type: "todos.updated", payload: sessionPayload(ctx, { todos: [] }) });
+async function commitTodos(ctx, todos) {
+  if (ctx.mutateTodos) {
+    const result = await ctx.mutateTodos(todos);
+    return { todos: result.todos, warnings: result.warnings ?? [] };
+  }
+  ctx.replaceTodos?.(todos);
+  return { todos: [...todos], warnings: [] };
 }
-function handleTodosRemove(ctx, ws, payload) {
+function managedProjectionMessage() {
+  return "Kanban-bound todos are task projections. Change or remove the task from Kanban.";
+}
+async function handleTodosClear(ctx, ws) {
+  if (ctx.context.todos.some((todo) => todo.kanbanBoardId && todo.kanbanTaskId)) {
+    sendResult3(ctx, ws, false, managedProjectionMessage());
+    return;
+  }
+  try {
+    const result = await commitTodos(ctx, []);
+    sendResult3(ctx, ws, true, "Todos cleared");
+    ctx.broadcast({
+      type: "todos.updated",
+      payload: sessionPayload(ctx, { todos: result.todos })
+    });
+  } catch (error2) {
+    sendResult3(ctx, ws, false, error2 instanceof Error ? error2.message : String(error2));
+  }
+}
+async function handleTodosRemove(ctx, ws, payload) {
   if (!payload) {
     sendResult3(ctx, ws, false, "Missing id or index");
     return;
@@ -7711,12 +7739,27 @@ function handleTodosRemove(ctx, ws, payload) {
     sendResult3(ctx, ws, false, "Todo not found");
     return;
   }
+  if (removed.kanbanBoardId && removed.kanbanTaskId) {
+    sendResult3(ctx, ws, false, managedProjectionMessage());
+    return;
+  }
   const next = [...todos.slice(0, targetIndex), ...todos.slice(targetIndex + 1)];
-  ctx.replaceTodos?.(next);
-  sendResult3(ctx, ws, true, `Removed: ${removed.content}`);
-  ctx.broadcast({ type: "todos.updated", payload: sessionPayload(ctx, { todos: next }) });
+  try {
+    const result = await commitTodos(ctx, next);
+    sendResult3(ctx, ws, true, `Removed: ${removed.content}`);
+    ctx.broadcast({
+      type: "todos.updated",
+      payload: sessionPayload(ctx, { todos: result.todos })
+    });
+  } catch (error2) {
+    sendResult3(ctx, ws, false, error2 instanceof Error ? error2.message : String(error2));
+  }
 }
-function handleTodoUpdate(ctx, ws, payload) {
+async function handleTodoUpdate(ctx, ws, payload) {
+  if (!payload || typeof payload.id !== "string" || payload.status !== void 0 && payload.status !== "pending" && payload.status !== "in_progress" && payload.status !== "completed" || payload.activeForm !== void 0 && typeof payload.activeForm !== "string") {
+    sendResult3(ctx, ws, false, "Invalid todo update payload");
+    return;
+  }
   const index = ctx.context.todos.findIndex((todo) => todo.id === payload.id);
   const existing = ctx.context.todos[index];
   if (index === -1 || !existing) {
@@ -7729,9 +7772,25 @@ function handleTodoUpdate(ctx, ws, payload) {
     status: payload.status ?? existing.status,
     activeForm: payload.activeForm !== void 0 ? payload.activeForm : existing.activeForm
   };
-  ctx.replaceTodos?.(next);
-  sendResult3(ctx, ws, true, `Todo "${existing.content}" updated`);
-  ctx.broadcast({ type: "todos.updated", payload: sessionPayload(ctx, { todos: next }) });
+  try {
+    const result = await commitTodos(ctx, next);
+    const projected = result.todos.find((todo) => todo.id === existing.id);
+    const requestedStatus = payload.status ?? existing.status;
+    const projectionRejected = Boolean(existing.kanbanBoardId && existing.kanbanTaskId) && projected?.status !== requestedStatus;
+    const warning = result.warnings[0];
+    sendResult3(
+      ctx,
+      ws,
+      !projectionRejected,
+      projectionRejected ? warning ?? `Kanban kept "${existing.content}" at ${projected?.status ?? "its current state"}.` : warning ? `Todo "${existing.content}" updated. ${warning}` : `Todo "${existing.content}" updated`
+    );
+    ctx.broadcast({
+      type: "todos.updated",
+      payload: sessionPayload(ctx, { todos: result.todos })
+    });
+  } catch (error2) {
+    sendResult3(ctx, ws, false, error2 instanceof Error ? error2.message : String(error2));
+  }
 }
 async function handleTasksGet(ctx, ws) {
   const taskPath = taskPathOf(ctx);
@@ -7759,14 +7818,32 @@ async function handleTaskUpdate(ctx, ws, payload) {
     return;
   }
   try {
-    const file = await mutateTasks(taskPath, currentSessionId(ctx), async (tasks) => {
-      const task = tasks.tasks.find((candidate) => candidate.id === payload.id);
-      if (!task) return tasks;
-      task.status = payload.status;
-      task.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      return tasks;
-    });
-    sendResult3(ctx, ws, true, `Task status updated to "${payload.status}".`);
+    let file;
+    if (ctx.mutateTaskStatus) {
+      const result = await ctx.mutateTaskStatus(payload.id, payload.status);
+      if (!result.ok) {
+        sendResult3(ctx, ws, false, result.message);
+        return;
+      }
+      file = await loadTasks(taskPath);
+      if (!file) throw new Error("Task mutation succeeded but its persisted snapshot is missing.");
+      sendResult3(ctx, ws, true, result.message);
+    } else {
+      let matched = false;
+      file = await mutateTasks(taskPath, currentSessionId(ctx), async (tasks) => {
+        const task = tasks.tasks.find((candidate) => candidate.id === payload.id);
+        if (!task) return tasks;
+        matched = true;
+        task.status = payload.status;
+        task.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        return tasks;
+      });
+      if (!matched) {
+        sendResult3(ctx, ws, false, `Task "${payload.id}" not found.`);
+        return;
+      }
+      sendResult3(ctx, ws, true, `Task status updated to "${payload.status}".`);
+    }
     ctx.broadcast({
       type: "tasks.updated",
       payload: sessionPayload(ctx, { tasks: file.tasks })
@@ -7813,6 +7890,18 @@ async function handlePlanTemplateUse(ctx, ws, template) {
     return;
   }
   try {
+    if (ctx.mutatePlan) {
+      const result = await ctx.mutatePlan({ action: "template_use", template });
+      if (!result.ok) {
+        sendResult3(ctx, ws, false, result.message);
+        return;
+      }
+      const plan2 = await loadPlan(planPath);
+      if (!plan2) throw new Error("Plan mutation succeeded but its persisted snapshot is missing.");
+      sendResult3(ctx, ws, true, result.message);
+      ctx.broadcast({ type: "plan.updated", payload: sessionPayload(ctx, { plan: plan2 }) });
+      return;
+    }
     const templateDefinition = getPlanTemplate(template);
     if (!templateDefinition) {
       sendResult3(ctx, ws, false, `Unknown template "${template}".`);
@@ -7841,6 +7930,22 @@ async function handlePlanItemUpdate(ctx, ws, payload) {
     return;
   }
   try {
+    if (ctx.mutatePlan) {
+      const result = await ctx.mutatePlan({
+        action: "status",
+        target: payload.target,
+        status: payload.status
+      });
+      if (!result.ok) {
+        sendResult3(ctx, ws, false, result.message);
+        return;
+      }
+      const plan2 = await loadPlan(planPath);
+      if (!plan2) throw new Error("Plan mutation succeeded but its persisted snapshot is missing.");
+      sendResult3(ctx, ws, true, result.message);
+      ctx.broadcast({ type: "plan.updated", payload: sessionPayload(ctx, { plan: plan2 }) });
+      return;
+    }
     let changed = false;
     const plan = await mutatePlan(planPath, currentSessionId(ctx), async (currentPlan) => {
       const before = currentPlan.updatedAt;
@@ -7864,13 +7969,17 @@ async function handleWorklistMessage(ctx, ws, message) {
       handleTodosGet(ctx, ws);
       return;
     case "todos.clear":
-      handleTodosClear(ctx, ws);
+      await handleTodosClear(ctx, ws);
       return;
     case "todos.remove":
-      handleTodosRemove(ctx, ws, message.payload);
+      await handleTodosRemove(
+        ctx,
+        ws,
+        message.payload
+      );
       return;
     case "todo.update":
-      handleTodoUpdate(
+      await handleTodoUpdate(
         ctx,
         ws,
         message.payload
@@ -10928,9 +11037,9 @@ import {
   claimReadyTask,
   copyTaskToBoard,
   createBoard,
+  createBoardFromText,
   duplicateBoard,
   exportBoardToTaskGraph,
-  createBoardFromText,
   getBoard,
   getKanbanOrchestrationSnapshot,
   getKanbanQueueHealth,
@@ -11118,8 +11227,35 @@ async function handleTaskVerification(ws, type, payload, ctx) {
   }
 }
 
+// src/server/kanban-route-pagination.ts
+function paginateKanbanBoards(boards, input) {
+  const pageSize = Math.min(100, Math.max(1, Math.floor(input.pageSize)));
+  const activeSessionIds = new Set(input.activeSessionIds ?? []);
+  const isActive = (board) => board.presence?.some((entry) => entry.active) === true || board.tags?.some((tag) => tag.startsWith("session:") && activeSessionIds.has(tag.slice(8))) === true;
+  const sorted = [...boards].sort((left, right) => {
+    const activityOrder = Number(isActive(right)) - Number(isActive(left));
+    return activityOrder || right.updatedAt.localeCompare(left.updatedAt);
+  });
+  const activeTotal = sorted.filter(isActive).length;
+  const total = sorted.length;
+  const totalPages = Math.max(1, Math.ceil(total / pageSize));
+  const requestedPage = Number.isFinite(input.page) ? Math.floor(input.page) : 1;
+  const page = Math.min(totalPages, Math.max(1, requestedPage));
+  const start = (page - 1) * pageSize;
+  return {
+    items: sorted.slice(start, start + pageSize),
+    total,
+    page,
+    pageSize,
+    totalPages,
+    activeTotal,
+    orphanedTotal: total - activeTotal
+  };
+}
+
 // src/server/kanban-task-routes.ts
 import {
+  getKanbanWorkbench,
   getTask,
   listTaskActivity,
   recordTaskActivity,
@@ -11127,6 +11263,16 @@ import {
 } from "@wrongstack/kanban";
 async function handleKanbanTaskRoute(ws, type, payload, ctx) {
   switch (type) {
+    case "kanban.workbench":
+      ok(
+        ws,
+        type,
+        await getKanbanWorkbench(ctx.projectRoot, {
+          ...typeof payload?.limitPerLane === "number" ? { limitPerLane: payload.limitPerLane } : {},
+          ...typeof payload?.alertLimit === "number" ? { alertLimit: payload.alertLimit } : {}
+        })
+      );
+      return true;
     case "kanban.task.remove":
       await handleTaskRemove(ws, type, payload, ctx);
       return true;
@@ -11219,40 +11365,11 @@ async function handleTaskActivityAdd(ws, type, payload, ctx) {
       outcome,
       ...typeof payload?.details === "string" && payload.details.trim() ? { details: payload.details.trim() } : {}
     },
-    activityContext(
-      ctx,
-      payload?.actor ?? ctx.context?.agentId ?? "webui"
-    )
+    activityContext(ctx, payload?.actor ?? ctx.context?.agentId ?? "webui")
   );
   board ? ok(ws, type, board) : fail(ws, type, "Board or task not found");
 }
 
-// src/server/kanban-route-pagination.ts
-function paginateKanbanBoards(boards, input) {
-  const pageSize = Math.min(100, Math.max(1, Math.floor(input.pageSize)));
-  const activeSessionIds = new Set(input.activeSessionIds ?? []);
-  const isActive = (board) => board.presence?.some((entry) => entry.active) === true || board.tags?.some((tag) => tag.startsWith("session:") && activeSessionIds.has(tag.slice(8))) === true;
-  const sorted = [...boards].sort((left, right) => {
-    const activityOrder = Number(isActive(right)) - Number(isActive(left));
-    return activityOrder || right.updatedAt.localeCompare(left.updatedAt);
-  });
-  const activeTotal = sorted.filter(isActive).length;
-  const total = sorted.length;
-  const totalPages = Math.max(1, Math.ceil(total / pageSize));
-  const requestedPage = Number.isFinite(input.page) ? Math.floor(input.page) : 1;
-  const page = Math.min(totalPages, Math.max(1, requestedPage));
-  const start = (page - 1) * pageSize;
-  return {
-    items: sorted.slice(start, start + pageSize),
-    total,
-    page,
-    pageSize,
-    totalPages,
-    activeTotal,
-    orphanedTotal: total - activeTotal
-  };
-}
-
 // src/server/kanban-route-protocol.ts
 var KANBAN_CLIENT_MESSAGE_TYPES = [
   "kanban.capabilities",
@@ -11297,7 +11414,8 @@ var KANBAN_CLIENT_MESSAGE_TYPES = [
   "kanban.task.verify",
   "kanban.taskgraph.export",
   "kanban.taskgraph.sync",
-  "kanban.update"
+  "kanban.update",
+  "kanban.workbench"
 ];
 
 // src/server/kanban-routes.ts
@@ -12078,7 +12196,9 @@ function subscribeKanbanDaemonEvents(projectRoot, broadcastMessage) {
     projectRoot,
     async (event) => {
       const family = event.event?.split(".")[0];
-      if (family !== "board" && family !== "task" && family !== "column") return;
+      if (family !== "board" && family !== "task" && family !== "column" && family !== "contract") {
+        return;
+      }
       const evData = event.data;
       const boardId = evData?.boardId;
       if (!boardId) return;
@@ -13395,14 +13515,17 @@ async function handleSageForFile(ws, msg, memoryStore) {
     send(ws, { type: "memory.sage.forFile", payload: { error: "filePath is required" } });
     return;
   }
+  const includeSuperseded = typeof payload["showSuperseded"] === "boolean" ? payload["showSuperseded"] : typeof payload["includeSuperseded"] === "boolean" ? payload["includeSuperseded"] : void 0;
+  const includeDeleted = payload["showDeleted"] === true || payload["includeDeleted"] === true;
   try {
     const response = await Sage.findMemoriesForFile(filePath, {
       ...typeof payload["lineStart"] === "number" ? { lineStart: payload["lineStart"] } : {},
       ...typeof payload["lineEnd"] === "number" ? { lineEnd: payload["lineEnd"] } : {},
       ...typeof payload["limit"] === "number" ? { limit: payload["limit"] } : {},
-      ...payload["includeDeleted"] === true ? { includeDeleted: true } : {}
+      ...includeSuperseded !== void 0 ? { includeSuperseded } : {},
+      ...includeDeleted ? { includeDeleted: true } : {}
     });
-    send(ws, { type: "memory.sage.forFile", payload: response });
+    send(ws, { type: "memory.sage.forFile", payload: { response } });
   } catch (err) {
     send(ws, { type: "memory.sage.forFile", payload: { error: errMessage(err) } });
   }
@@ -15104,7 +15227,8 @@ function createKanbanSupervisor(deps2) {
       mode: config.recoveryMode ?? "auto",
       reason: "Kanban supervisor found an expired worker lease."
     }) : null;
-    if (recovered) health = await getKanbanQueueHealth2(resolveProjectRoot(deps2), { boardId: board.id });
+    if (recovered)
+      health = await getKanbanQueueHealth2(resolveProjectRoot(deps2), { boardId: board.id });
     const anomalyCount = countAnomalies(health);
     const snapshot = {
       boardId: board.id,
@@ -15199,7 +15323,9 @@ function createKanbanSupervisor(deps2) {
     } else {
       const summaries = await listBoards4(resolveProjectRoot(deps2));
       pruneAbsentBoards(new Set(summaries.map((summary) => summary.id)));
-      boards = (await Promise.all(summaries.map((summary) => getBoard3(resolveProjectRoot(deps2), summary.id)))).filter((board) => Boolean(board));
+      boards = (await Promise.all(
+        summaries.map((summary) => getBoard3(resolveProjectRoot(deps2), summary.id))
+      )).filter((board) => Boolean(board));
     }
     const results = [];
     for (const board of boards) results.push(await auditBoard(board));
@@ -19071,89 +19197,56 @@ function createEmbeddedProjectRoutes(ctx) {
 
 // src/server/embedded-message-router.ts
 import { makeProviderFromConfig as makeProviderFromConfig2 } from "@wrongstack/providers";
+import { planTool, taskTool, todoTool } from "@wrongstack/tools";
 
 // src/server/agent-roster-handlers.ts
 import {
   applyProjectAgentConfig,
-  buildConsolidationInstruction,
   captureLearnedFromAgentOutputDetailed,
   clearProjectAgentConsolidated,
+  clearProjectSkillAugmentation,
   createProjectAgent,
   detectLearnedConflicts,
+  evaluateAutoOptimize,
   FLEET_ROSTER,
   getProjectAgentLearnStats,
   isConsolidated,
   listProjectAgentLearnedEntries,
   listProjectAgentRoles,
+  listProjectSkillAugmentations,
   loadConsolidationMetadata,
   loadProjectAgentConfig,
   loadProjectAgentConsolidated,
   loadProjectAgentIdentity,
   loadProjectAgentLearned,
   loadProjectAgentProfile,
+  loadProjectSkillAugmentation,
+  loadSkillAffinity,
+  optimizeProjectAgentLearning,
+  readRawLearnedEntries,
   resetProjectAgentIdentity,
+  resolveAutoOptimizePolicy,
+  resolveRoleSkillCandidates,
   saveProjectAgentConsolidated,
+  saveProjectSkillAugmentation,
+  setSkillPinned,
   slugifyProjectAgentRole,
   updateProjectAgentConfig,
   updateProjectAgentIdentity,
   updateProjectAgentLearned,
   updateProjectAgentLearningPolicy
 } from "@wrongstack/core/coordination";
-import { isTextBlock } from "@wrongstack/core/types";
-var CONSOLIDATION_MAX_TOKENS = 8e3;
-var CONSOLIDATION_TIMEOUT_MS = 12e4;
 var AgentRosterWSHandler = class {
   getProjectRoot;
   getLlm;
   broadcast;
+  getAutoOptimizeSettings;
   constructor(opts) {
     this.getProjectRoot = typeof opts.projectRoot === "function" ? opts.projectRoot : () => opts.projectRoot;
     this.getLlm = opts.getLlm ?? (() => void 0);
     this.broadcast = opts.broadcast ?? (() => {
     });
-  }
-  /**
-   * Run the consolidation LLM synthesis headlessly and return the cleaned
-   * document text. Returns undefined when no LLM is available so the caller
-   * can fall back to the instruction-only path.
-   */
-  async synthesizeConsolidation(instruction) {
-    const llm = this.getLlm();
-    if (!llm) return void 0;
-    const req = {
-      model: llm.model,
-      system: [
-        {
-          type: "text",
-          text: "You are a precise technical editor. You consolidate an AI agent role's captured learning entries into a single, durable, role-scoped instruction document. Output ONLY the consolidated markdown document \u2014 no preamble, no code fences, no commentary about the consolidation process."
-        }
-      ],
-      messages: [{ role: "user", content: instruction }],
-      maxTokens: CONSOLIDATION_MAX_TOKENS
-    };
-    const timer = new AbortController();
-    let timedOut = false;
-    const to = setTimeout(() => {
-      timedOut = true;
-      timer.abort(new Error("consolidation timeout"));
-    }, CONSOLIDATION_TIMEOUT_MS);
-    to.unref();
-    try {
-      const res = await llm.provider.complete(req, { signal: timer.signal });
-      const text2 = res.content.filter(isTextBlock).map((block) => block.text).join("\n").trim();
-      const wholeDocFence = /^```(?:markdown|md)?[^\n]*\n([\s\S]*?)\n?```\s*$/i;
-      const wrapped = wholeDocFence.exec(text2);
-      const inner = wrapped?.[1];
-      const unfenced = inner !== void 0 ? inner.trim() : text2;
-      return { content: unfenced, model: llm.model };
-    } catch (err) {
-      if (timedOut) {
-        throw new Error(`consolidation timed out after ${CONSOLIDATION_TIMEOUT_MS}ms`);
-      }
-      throw err;
-    } finally {
-      clearTimeout(to);
-    }
+    this.getAutoOptimizeSettings = opts.getAutoOptimizeSettings;
   }
   /** Handle an incoming client message. Returns a response payload. */
   async handleMessage(_ws, type, payload) {
@@ -19358,70 +19451,47 @@ ${String(p.content ?? "")}`;
         const conflicts = detectLearnedConflicts(projectRoot);
         return { type, payload: { conflicts } };
       }
-      // ── Consolidate learned entries (headless LLM synthesis) ──────────
-      // Runs the whole optimization on the server: read raw entries →
-      // synthesize with the active model → write consolidated.md +
-      // consolidation.json. No chat round-trip. When no LLM is available the
-      // handler degrades to returning the instruction so a caller (e.g. the
-      // chat agent) can still perform the consolidation manually.
-      case "agent-roster.consolidate": {
+      // ── Optimize: distil captures into skill addenda + a consolidated doc,
+      // then archive and reset the raw buffer. Shared implementation with the
+      // CLI (`optimizeProjectAgentLearning`) so both surfaces persist the same
+      // artifacts instead of the CLI producing markdown nobody saved.
+      case "agent-roster.consolidate":
+      case "agent-roster.optimize": {
         if (!role) return { type, payload: { error: "role required" } };
-        const { instruction, rawEntries, hasExistingConsolidation } = buildConsolidationInstruction(role, projectRoot);
-        if (rawEntries.length === 0) {
+        const hasExistingConsolidation = isConsolidated(role, projectRoot);
+        const pending = readRawLearnedEntries(role, projectRoot);
+        if (pending.length === 0) {
           return {
             type: "agent-roster.consolidate",
             payload: {
               role,
               consolidated: false,
               rawEntryCount: 0,
+              skills: [],
               hasExistingConsolidation,
               currentStats: getProjectAgentLearnStats(role, projectRoot)
             }
           };
         }
-        let synth;
-        try {
-          synth = await this.synthesizeConsolidation(instruction);
-        } catch (err) {
-          return {
-            type: "agent-roster.consolidate",
-            payload: {
-              role,
-              consolidated: false,
-              rawEntryCount: rawEntries.length,
-              hasExistingConsolidation,
-              currentStats: getProjectAgentLearnStats(role, projectRoot),
-              error: err instanceof Error ? err.message : "consolidation failed"
-            }
-          };
-        }
-        if (synth && synth.content.length > 0) {
-          let stats;
-          let metadata;
-          try {
-            saveProjectAgentConsolidated(role, synth.content, projectRoot, {
-              trigger: "manual",
-              model: synth.model
-            });
-            stats = getProjectAgentLearnStats(role, projectRoot);
-            metadata = loadConsolidationMetadata(role, projectRoot);
-          } catch (err) {
-            return {
-              type: "agent-roster.consolidate",
-              payload: {
-                role,
-                consolidated: false,
-                rawEntryCount: rawEntries.length,
-                hasExistingConsolidation,
-                currentStats: getProjectAgentLearnStats(role, projectRoot),
-                error: err instanceof Error ? err.message : "failed to persist consolidation"
-              }
-            };
-          }
+        const llm = this.getLlm();
+        const result = await optimizeProjectAgentLearning(role, projectRoot, {
+          ...llm ? { llm } : {},
+          trigger: "manual"
+        });
+        const currentStats = getProjectAgentLearnStats(role, projectRoot);
+        const metadata = loadConsolidationMetadata(role, projectRoot);
+        const basePayload = {
+          role,
+          rawEntryCount: result.rawEntryCount,
+          skills: result.skills,
+          hasExistingConsolidation,
+          currentStats
+        };
+        if (result.status === "optimized") {
           try {
             this.broadcast({
               type: "agent-roster.updated",
-              payload: { role, reason: "consolidated", currentStats: stats, metadata }
+              payload: { role, reason: "consolidated", currentStats, metadata }
             });
           } catch (e) {
             console.warn(
@@ -19437,44 +19507,101 @@ ${String(p.content ?? "")}`;
           return {
             type: "agent-roster.consolidate",
             payload: {
-              role,
+              ...basePayload,
               consolidated: true,
-              rawEntryCount: rawEntries.length,
-              content: synth.content,
-              model: synth.model,
-              currentStats: stats,
+              content: result.content,
+              model: result.model,
+              pruned: result.pruned,
               metadata
             }
           };
         }
-        if (synth) {
-          return {
-            type: "agent-roster.consolidate",
-            payload: {
-              role,
-              consolidated: false,
-              emptySynthesis: true,
-              model: synth.model,
-              rawEntryCount: rawEntries.length,
-              hasExistingConsolidation,
-              currentStats: getProjectAgentLearnStats(role, projectRoot)
-            }
-          };
-        }
         return {
           type: "agent-roster.consolidate",
           payload: {
-            role,
+            ...basePayload,
             consolidated: false,
-            instruction,
-            rawEntryCount: rawEntries.length,
-            hasExistingConsolidation,
-            currentStats: getProjectAgentLearnStats(role, projectRoot),
-            // Instruction for the leader agent to execute the consolidation
-            leaderInstruction: `Optimize what the "${role}" agent has learned. Read its raw learned entries, synthesize them into a single narrowly-scoped document preserving every fact, and save the result. The instruction text contains the full details and raw entries.`
+            ...result.status === "empty-synthesis" ? { emptySynthesis: true, model: result.model } : {},
+            ...result.status === "failed" ? { error: result.error } : {},
+            ...result.status === "no-llm" ? {
+              instruction: result.instruction,
+              leaderInstruction: `Optimize what the "${role}" agent has learned. Read its raw learned entries, synthesize them into a single narrowly-scoped document preserving every fact, and save the result. The instruction text contains the full details and raw entries.`
+            } : {}
           }
         };
       }
+      // ── Automatic-optimization status ─────────────────────────────────
+      // Read-only: says whether the background scheduler considers each role
+      // eligible right now, and why not when it does not. Surfacing the reason
+      // is what keeps "nothing happened" from looking like a broken feature.
+      case "agent-roster.auto-optimize-status": {
+        const policy = resolveAutoOptimizePolicy(
+          this.getAutoOptimizeSettings?.() ?? void 0
+        );
+        const roles = role ? [role] : listProjectAgentRoles(projectRoot);
+        return {
+          type,
+          payload: {
+            policy,
+            roles: roles.map((current2) => {
+              try {
+                const decision = evaluateAutoOptimize(current2, projectRoot, policy);
+                return { role: current2, ...decision };
+              } catch {
+                return { role: current2, eligible: false, reason: "disabled" };
+              }
+            })
+          }
+        };
+      }
+      // ── Skill layer: what this project has developed for each role skill ──
+      case "agent-roster.skills": {
+        if (!role) return { type, payload: { error: "role required" } };
+        const candidates = resolveRoleSkillCandidates(role, projectRoot);
+        const developed = listProjectSkillAugmentations(role, projectRoot);
+        const affinity = loadSkillAffinity(role, projectRoot);
+        return {
+          type,
+          payload: {
+            role,
+            skills: candidates.map((skill) => ({
+              skill,
+              developed: developed.includes(skill),
+              affinity: affinity.entries[skill] ?? null
+            }))
+          }
+        };
+      }
+      case "agent-roster.read-skill": {
+        const skill = typeof p.skill === "string" ? p.skill : "";
+        if (!role || !skill) return { type, payload: { error: "role and skill required" } };
+        return {
+          type,
+          payload: { role, skill, content: loadProjectSkillAugmentation(role, skill, projectRoot) }
+        };
+      }
+      case "agent-roster.save-skill": {
+        const skill = typeof p.skill === "string" ? p.skill : "";
+        if (!role || !skill || typeof p.content !== "string") {
+          return { type, payload: { error: "role, skill and content required" } };
+        }
+        const savedPath = saveProjectSkillAugmentation(role, skill, p.content, projectRoot);
+        return { type, payload: { role, skill, path: savedPath, success: true } };
+      }
+      case "agent-roster.clear-skill": {
+        const skill = typeof p.skill === "string" ? p.skill : "";
+        if (!role) return { type, payload: { error: "role required" } };
+        clearProjectSkillAugmentation(role, skill || void 0, projectRoot);
+        return { type, payload: { role, skill: skill || null, success: true } };
+      }
+      case "agent-roster.pin-skill": {
+        const skill = typeof p.skill === "string" ? p.skill : "";
+        if (!role || !skill || typeof p.pinned !== "boolean") {
+          return { type, payload: { error: "role, skill and boolean pinned required" } };
+        }
+        const affinity = setSkillPinned(role, skill, p.pinned, projectRoot);
+        return { type, payload: { role, skill, pinned: p.pinned, affinity, success: true } };
+      }
       // ── Save consolidated document ────────────────────────────────────
       case "agent-roster.save-consolidated": {
         if (!role || typeof p.content !== "string") {
@@ -20447,7 +20574,20 @@ function createEmbeddedMessageRouter(deps2) {
       },
       send: send2,
       broadcast: deps2.providerCtx.broadcast,
-      replaceTodos: (todos) => opts.agent.ctx.state.replaceTodos(todos)
+      replaceTodos: (todos) => opts.agent.ctx.state.replaceTodos(todos),
+      mutateTodos: async (todos) => {
+        const result = await todoTool.execute({ todos }, opts.agent.ctx, {
+          signal: AbortSignal.timeout(3e4)
+        });
+        return {
+          todos: [...opts.agent.ctx.todos],
+          ...result.kanban_warnings ? { warnings: result.kanban_warnings } : {}
+        };
+      },
+      mutateTaskStatus: async (id, status) => taskTool.execute({ action: "status", id, status }, opts.agent.ctx, {
+        signal: AbortSignal.timeout(3e4)
+      }),
+      mutatePlan: async (operation) => planTool.execute(operation, opts.agent.ctx, { signal: AbortSignal.timeout(3e4) })
     })
   });
   const processRoutes = {
@@ -20531,6 +20671,7 @@ function createEmbeddedMessageRouter(deps2) {
       agentRoster: {
         rosterHandler: new AgentRosterWSHandler({
           projectRoot,
+          getAutoOptimizeSettings: () => deps2.agentConfigCtx.getConfig?.()?.fleet?.learning?.autoOptimize,
           getLlm: () => {
             const ctx = opts.agent.ctx;
             return ctx.provider && ctx.model ? { provider: ctx.provider, model: ctx.model } : void 0;
@@ -24526,6 +24667,7 @@ async function setupWebUiGovernance(input, dependencies = DEFAULT_DEPENDENCIES)
 
 // src/server/message-dispatcher.ts
 import path28 from "node:path";
+import { planTool as planTool2, taskTool as taskTool2, todoTool as todoTool2 } from "@wrongstack/tools";
 function createMessageDispatcher(opts) {
   const { state, deps: deps2, routes, promptsCtx, codebaseIndexing, runLock, pendingConfirms } = opts;
   function makeWorklistContext() {
@@ -24537,7 +24679,20 @@ function createMessageDispatcher(opts) {
       },
       send: (w, m) => send(w, m),
       broadcast: (m) => broadcast(state.getClients(), m),
-      replaceTodos: (todos) => deps2.context.state.replaceTodos(todos)
+      replaceTodos: (todos) => deps2.context.state.replaceTodos(todos),
+      mutateTodos: async (todos) => {
+        const result = await todoTool2.execute({ todos }, deps2.context, {
+          signal: AbortSignal.timeout(3e4)
+        });
+        return {
+          todos: [...deps2.context.todos],
+          ...result.kanban_warnings ? { warnings: result.kanban_warnings } : {}
+        };
+      },
+      mutateTaskStatus: async (id, status) => taskTool2.execute({ action: "status", id, status }, deps2.context, {
+        signal: AbortSignal.timeout(3e4)
+      }),
+      mutatePlan: async (operation) => planTool2.execute(operation, deps2.context, { signal: AbortSignal.timeout(3e4) })
     };
   }
   function makeSkillsContext() {
@@ -24749,6 +24904,7 @@ function createMessageDispatcher(opts) {
       agentRoster: {
         rosterHandler: new AgentRosterWSHandler({
           projectRoot: state.getProjectRoot,
+          getAutoOptimizeSettings: () => state.getConfig().fleet?.learning?.autoOptimize,
           getLlm: () => {
             const ctx = deps2.agent.ctx;
             return ctx.provider && ctx.model ? { provider: ctx.provider, model: ctx.model } : void 0;
@@ -25959,11 +26115,11 @@ function buildRoutes(state, deps2, cb) {
 }
 
 // src/server/server-runtime.ts
-import * as path33 from "node:path";
 import { createRequire as createRequire4 } from "node:module";
+import * as path33 from "node:path";
 import { fileURLToPath } from "node:url";
-import { WebSocketServer } from "ws";
 import { toErrorMessage as toErrorMessage13 } from "@wrongstack/core/utils";
+import { WebSocketServer } from "ws";
 async function resolvePorts(opts) {
   const surface = opts.surface ?? "webui";
   const surfaceDefaults = surface === "simpleui" ? { http: 3466 } : { http: 3456 };