@yeaft/webchat-agent 0.1.314 → 0.1.316

package/crew/control.js

@@ -187,6 +187,8 @@ async function resumeSession(session) {
     message: { role: 'assistant', content: [{ type: 'text', text: 'Session 已恢复' }] }
   });
   sendStatusUpdate(session);
+  // Status changed to running — persist
+  saveSessionMeta(session).catch(e => console.warn('[Crew] Failed to save after resume:', e.message));
 
   if (session.pendingRoutes.length > 0) {
     const pending = session.pendingRoutes.slice();

package/crew/human-interaction.js

@@ -4,6 +4,7 @@
  */
 import { dispatchToRole } from './routing.js';
 import { sendStatusUpdate } from './ui-messages.js';
+import { debouncedSaveSessionMeta } from './persistence.js';
 
 /**
  * 处理人的输入
@@ -50,6 +51,8 @@ export async function handleCrewHumanInput(msg) {
     session.status = 'running';
     session.waitingHumanContext = null;
     sendStatusUpdate(session);
+    // Status changed + new human message — persist (debounced, dispatch will follow)
+    debouncedSaveSessionMeta(session);
 
     const target = targetRole || waitingContext?.fromRole || session.decisionMaker;
     await dispatchToRole(session, target, buildHumanContent('人工回复:', content), 'human');

package/crew/persistence.js

@@ -119,6 +119,24 @@ export async function unhideCrewSession(sessionId) {
 // =====================================================================
 
 const MESSAGE_SHARD_SIZE = 256 * 1024; // 256KB per shard
+const SAVE_DEBOUNCE_MS = 10_000; // 10 seconds
+
+/**
+ * Debounced version of saveSessionMeta.
+ * Coalesces rapid-fire calls (e.g. multiple role turn-ends) into a single
+ * disk write per session, at most once every SAVE_DEBOUNCE_MS.
+ */
+export function debouncedSaveSessionMeta(session) {
+  if (session._saveDebounceTimer) {
+    clearTimeout(session._saveDebounceTimer);
+  }
+  session._saveDebounceTimer = setTimeout(() => {
+    session._saveDebounceTimer = null;
+    saveSessionMeta(session).catch(e =>
+      console.warn('[Crew] Debounced save failed:', e.message)
+    );
+  }, SAVE_DEBOUNCE_MS);
+}
 
 export async function saveSessionMeta(session) {
   const meta = {
@@ -127,9 +145,11 @@ export async function saveSessionMeta(session) {
     sharedDir: session.sharedDir,
     name: session.name || '',
     status: session.status,
+    // claudeMd is intentionally excluded — it's large and already persisted
+    // in per-role CLAUDE.md files under .crew/roles/<name>/CLAUDE.md
     roles: Array.from(session.roles.values()).map(r => ({
       name: r.name, displayName: r.displayName, icon: r.icon,
-      description: r.description, claudeMd: r.claudeMd || '',
+      description: r.description,
       isDecisionMaker: r.isDecisionMaker || false,
       groupIndex: r.groupIndex, roleType: r.roleType, model: r.model
     })),

package/crew/role-management.js

@@ -5,6 +5,7 @@
 import { initRoleDir, updateSharedClaudeMd } from './shared-dir.js';
 import { saveRoleSessionId } from './role-query.js';
 import { sendCrewMessage, sendCrewOutput, sendStatusUpdate } from './ui-messages.js';
+import { saveSessionMeta, upsertCrewIndex } from './persistence.js';
 
 /** Format role label */
 function roleLabel(r) {
@@ -94,6 +95,9 @@ export async function addRoleToSession(msg) {
   }
 
   sendStatusUpdate(session);
+  // Roles changed — persist
+  saveSessionMeta(session).catch(e => console.warn('[Crew] Failed to save after addRole:', e.message));
+  upsertCrewIndex(session).catch(e => console.warn('[Crew] Failed to update index after addRole:', e.message));
 }
 
 /**
@@ -152,4 +156,7 @@ export async function removeRoleFromSession(msg) {
   });
 
   sendStatusUpdate(session);
+  // Roles changed — persist
+  saveSessionMeta(session).catch(e => console.warn('[Crew] Failed to save after removeRole:', e.message));
+  upsertCrewIndex(session).catch(e => console.warn('[Crew] Failed to update index after removeRole:', e.message));
 }

package/crew/role-output.js

@@ -6,6 +6,7 @@ import { sendCrewMessage, sendCrewOutput, sendStatusUpdate, endRoleStreaming } f
 import { saveRoleSessionId, clearRoleSessionId, classifyRoleError, createRoleQuery } from './role-query.js';
 import { parseRoutes, executeRoute, dispatchToRole } from './routing.js';
 import { parseCompletedTasks, updateFeatureIndex, appendChangelog, saveRoleWorkSummary, updateKanban } from './task-files.js';
+import { debouncedSaveSessionMeta, saveSessionMeta } from './persistence.js';
 import ctx from '../context.js';
 
 // Context 使用率常量（运行时从 ctx.CONFIG 读取）
@@ -170,6 +171,8 @@ export async function processRoleOutput(session, roleName, roleQuery, roleState)
         });
 
         sendStatusUpdate(session);
+        // Cost/tokens/messages updated — debounced persist (coalesces rapid turn-ends)
+        debouncedSaveSessionMeta(session);
 
         // 执行路由
         if (routes.length > 0) {
@@ -267,6 +270,8 @@ export async function processRoleOutput(session, roleName, roleQuery, roleState)
             message: errDetail
           });
           sendStatusUpdate(session);
+          // Status changed to waiting_human — persist
+          saveSessionMeta(session).catch(e => console.warn('[Crew] Failed to save after error→human:', e.message));
         }
         return;
       }

package/crew/routing.js

@@ -6,6 +6,7 @@ import { join } from 'path';
 import { sendCrewMessage, sendCrewOutput, sendStatusUpdate } from './ui-messages.js';
 import { ensureTaskFile, appendTaskRecord, readTaskFile, updateKanban, readKanban, saveRoleWorkSummary } from './task-files.js';
 import { createRoleQuery, clearRoleSessionId } from './role-query.js';
+import { saveSessionMeta } from './persistence.js';
 import ctx from '../context.js';
 
 /** Format role label */
@@ -19,7 +20,8 @@ function roleLabel(r) {
  */
 export function parseRoutes(text) {
   const routes = [];
-  const regex = /---ROUTE---\s*\n([\s\S]*?)---END_ROUTE---/g;
+  // ★ Tolerate both underscore and space variants: ---END_ROUTE--- or ---END ROUTE---
+  const regex = /---ROUTE---\s*\n([\s\S]*?)---END[_ ]ROUTE---/g;
   let match;
 
   while ((match = regex.exec(text)) !== null) {
@@ -168,6 +170,8 @@ export async function executeRoute(session, fromRole, route) {
       message: summary
     });
     sendStatusUpdate(session);
+    // Status changed to waiting_human — persist
+    saveSessionMeta(session).catch(e => console.warn('[Crew] Failed to save after →human:', e.message));
     return;
   }
 

package/crew/session.js

@@ -488,6 +488,8 @@ export async function resumeCrewSession(msg) {
   }
 
   const roles = meta.roles || [];
+  // Migration: strip claudeMd from legacy session.json (now persisted in per-role CLAUDE.md files)
+  for (const r of roles) delete r.claudeMd;
   if (roles.length === 0) {
     console.warn(`[Crew] resumeCrewSession: session ${sessionId} has empty roles in session.json`);
   }
@@ -594,11 +596,11 @@ export async function handleUpdateCrewSession(msg) {
         console.log(`[Crew] Role added during update: ${r.name} (${r.displayName})`);
       } else {
         // Existing role — update metadata (displayName, icon, etc.) but preserve roleState
+        // claudeMd is NOT updated here — it's managed via CLAUDE.md files, not through edit session
         const existing = session.roles.get(r.name);
         existing.displayName = r.displayName;
         existing.icon = r.icon;
         existing.description = r.description;
-        existing.claudeMd = r.claudeMd;
         existing.isDecisionMaker = r.isDecisionMaker;
         existing.roleType = r.roleType;
         existing.groupIndex = r.groupIndex;

package/crew/ui-messages.js

@@ -3,7 +3,6 @@
  * sendCrewMessage, sendCrewOutput, sendStatusUpdate, endRoleStreaming, findActiveRole
  */
 import ctx from '../context.js';
-import { upsertCrewIndex, saveSessionMeta } from './persistence.js';
 
 /**
  * 发送 crew 消息到 server（透传到 Web）
@@ -257,8 +256,6 @@ export function sendStatusUpdate(session) {
     features: getActiveFeatures(session),
     initProgress: session.initProgress || null
   });
-
-  // 异步更新持久化
-  upsertCrewIndex(session).catch(e => console.warn('[Crew] Failed to update index:', e.message));
-  saveSessionMeta(session).catch(e => console.warn('[Crew] Failed to save session meta:', e.message));
+  // Persist is NOT called here — callers that change persistent state
+  // (status, roles, cost, messages) must call saveSessionMeta explicitly.
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.314",
+  "version": "0.1.316",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",