@yeaft/webchat-agent 0.0.187 → 0.0.196

package/crew.js

@@ -324,10 +324,12 @@ async function saveSessionMeta(session) {
     userId: session.userId,
     username: session.username,
     agentId: session.agentId || null,
+    teamType: session.teamType || 'dev',
     costUsd: session.costUsd,
     totalInputTokens: session.totalInputTokens,
     totalOutputTokens: session.totalOutputTokens,
-    features: Array.from(session.features.values())
+    features: Array.from(session.features.values()),
+    _completedTaskIds: Array.from(session._completedTaskIds || [])
   };
   await fs.writeFile(join(session.sharedDir, 'session.json'), JSON.stringify(meta, null, 2));
   // 保存 UI 消息历史（用于恢复时重放）
@@ -548,9 +550,11 @@ export async function resumeCrewSession(msg) {
     waitingHumanContext: null,
     pendingRoutes: [],
     features: new Map((meta.features || []).map(f => [f.taskId, f])),
+    _completedTaskIds: new Set(meta._completedTaskIds || []),
     userId: userId || meta.userId,
     username: username || meta.username,
     agentId: meta.agentId || ctx.CONFIG?.agentName || null,
+    teamType: meta.teamType || 'dev',
     createdAt: meta.createdAt || Date.now()
   };
   crewSessions.set(sessionId, session);
@@ -635,6 +639,7 @@ export async function createCrewSession(msg) {
     sharedKnowledge,
     roles: rawRoles = [],     // [{ name, displayName, icon, description, claudeMd, model, budget, isDecisionMaker, count }]
     maxRounds = 20,
+    teamType = 'dev',
     userId,
     username
   } = msg;
@@ -655,23 +660,10 @@ export async function createCrewSession(msg) {
     ? sharedDirRel
     : join(projectDir, sharedDirRel || '.crew');
 
-  // 初始化共享区
-  await initSharedDir(sharedDir, goal, roles, projectDir, sharedKnowledge);
-
-  // 初始化 git worktrees（所有 EXPANDABLE_ROLES 都会获得独立 worktree）
-  const worktreeMap = await initWorktrees(projectDir, roles);
-  // 回填 workDir：同组的 dev/rev/test 共享同一个 worktree
-  for (const role of roles) {
-    if (role.groupIndex > 0 && worktreeMap.has(role.groupIndex)) {
-      role.workDir = worktreeMap.get(role.groupIndex);
-      // 重新写入 CLAUDE.md（加入工作目录信息）
-      await writeRoleClaudeMd(sharedDir, role);
-    }
-  }
-
   // 找到决策者
   const decisionMaker = roles.find(r => r.isDecisionMaker)?.name || roles[0]?.name || null;
 
+  // ★ 阶段1：立即构建 session 并通知前端，让 UI 先显示
   const session = {
     id: sessionId,
     projectDir,
@@ -682,7 +674,7 @@ export async function createCrewSession(msg) {
     roles: new Map(roles.map(r => [r.name, r])),
     roleStates: new Map(),
     decisionMaker,
-    status: 'running',       // running | paused | waiting_human | completed | stopped
+    status: 'initializing',  // ← 新增初始化状态
     round: 0,
     maxRounds,
     costUsd: 0,
@@ -694,15 +686,18 @@ export async function createCrewSession(msg) {
     waitingHumanContext: null, // { fromRole, reason, message }
     pendingRoutes: [],        // [{ fromRole, route }] — 暂停时未完成的路由
     features: new Map(),      // taskId → { taskId, taskTitle, createdAt } — 持久化 feature 列表
+    _completedTaskIds: new Set(), // 已完成的 taskId 集合（用于检测新完成的任务）
+    initProgress: null,       // 'roles' | 'worktrees' | null — 初始化阶段
     userId,
     username,
     agentId: ctx.CONFIG?.agentName || null,
+    teamType,
     createdAt: Date.now()
   };
 
   crewSessions.set(sessionId, session);
 
-  // 通知 server
+  // 立即通知前端：session 已创建，可以显示 UI
   sendCrewMessage({
     type: 'crew_session_created',
     sessionId,
@@ -727,20 +722,66 @@ export async function createCrewSession(msg) {
     username
   });
 
-  // 发送状态
   sendStatusUpdate(session);
 
-  // 持久化到索引和 session.json
-  await upsertCrewIndex(session);
-  await saveSessionMeta(session);
+  // ★ 阶段2：异步完成文件系统和 worktree 初始化
+  try {
+    // 初始化共享区（角色目录 + CLAUDE.md）
+    session.initProgress = 'roles';
+    sendStatusUpdate(session);
+    await initSharedDir(sharedDir, goal, roles, projectDir, sharedKnowledge);
+
+    // 初始化 git worktrees
+    const groupIndices = [...new Set(roles.filter(r => r.groupIndex > 0).map(r => r.groupIndex))];
+    if (groupIndices.length > 0) {
+      session.initProgress = 'worktrees';
+      sendStatusUpdate(session);
+    }
+    const worktreeMap = await initWorktrees(projectDir, roles);
+
+    // 回填 workDir
+    for (const role of roles) {
+      if (role.groupIndex > 0 && worktreeMap.has(role.groupIndex)) {
+        role.workDir = worktreeMap.get(role.groupIndex);
+        await writeRoleClaudeMd(sharedDir, role);
+      }
+    }
+
+    // 持久化
+    await upsertCrewIndex(session);
+    await saveSessionMeta(session);
+
+    // 初始化完成，仅在 initializing 状态下切换到 running（避免覆盖用户手动暂停/停止）
+    if (session.status === 'initializing') {
+      session.status = 'running';
+    }
+    session.initProgress = null;
+    sendStatusUpdate(session);
 
-  // 如果有目标，自动启动第一个角色；否则等待用户输入
-  if (goal && roles.length > 0) {
-    const firstRole = roles.find(r => r.name === 'pm') || roles[0];
-    if (firstRole) {
-      const initialPrompt = buildInitialTask(goal, firstRole, roles);
-      await dispatchToRole(session, firstRole.name, initialPrompt, 'system');
+    // 如果有目标且状态为 running，自动启动第一个角色
+    if (goal && roles.length > 0 && session.status === 'running') {
+      const firstRole = roles.find(r => r.name === 'pm') || roles[0];
+      if (firstRole) {
+        const initialPrompt = buildInitialTask(goal, firstRole, roles);
+        await dispatchToRole(session, firstRole.name, initialPrompt, 'system');
+      }
+    }
+  } catch (e) {
+    console.error('[Crew] Session initialization failed:', e);
+    if (session.status === 'initializing') {
+      session.status = 'running';
     }
+    session.initProgress = null;
+    sendStatusUpdate(session);
+    sendCrewMessage({
+      type: 'crew_output',
+      sessionId,
+      roleName: 'system',
+      roleIcon: 'S',
+      roleDisplayName: '系统',
+      content: `工作环境初始化失败: ${e.message}`,
+      isTurnEnd: true
+    });
   }
 
   return session;
@@ -1076,6 +1117,9 @@ ${summary}
   }
 
   console.log(`[Crew] Task file created: ${taskId} (${taskTitle})`);
+
+  // 更新 feature 索引
+  updateFeatureIndex(session).catch(e => console.warn('[Crew] Failed to update feature index:', e.message));
 }
 
 /**
@@ -1113,6 +1157,112 @@ async function readTaskFile(session, taskId) {
   }
 }
 
+/**
+ * 从 TASKS block 文本中提取已完成任务的 taskId 集合
+ */
+function parseCompletedTasks(text) {
+  const ids = new Set();
+  const match = text.match(/---TASKS---([\s\S]*?)---END_TASKS---/);
+  if (!match) return ids;
+  for (const line of match[1].split('\n')) {
+    const m = line.match(/^-\s*\[[xX]\]\s*.+#(\S+)/);
+    if (m) ids.add(m[1]);
+  }
+  return ids;
+}
+
+/**
+ * 更新 feature 索引文件 context/features/index.md
+ * 全量重建：根据 session.features 和 session._completedTaskIds 生成分类表格
+ */
+async function updateFeatureIndex(session) {
+  const featuresDir = join(session.sharedDir, 'context', 'features');
+  await fs.mkdir(featuresDir, { recursive: true });
+
+  const completed = session._completedTaskIds || new Set();
+  const allFeatures = Array.from(session.features.values());
+
+  // 按创建时间排序
+  allFeatures.sort((a, b) => (a.createdAt || 0) - (b.createdAt || 0));
+
+  const inProgress = allFeatures.filter(f => !completed.has(f.taskId));
+  const done = allFeatures.filter(f => completed.has(f.taskId));
+
+  const now = new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' });
+  let content = `# Feature Index\n> 最后更新: ${now}\n`;
+
+  content += `\n## 进行中 (${inProgress.length})\n`;
+  if (inProgress.length > 0) {
+    content += '| task-id | 标题 | 创建时间 |\n|---------|------|----------|\n';
+    for (const f of inProgress) {
+      const date = f.createdAt ? new Date(f.createdAt).toLocaleDateString('zh-CN') : '-';
+      content += `| ${f.taskId} | ${f.taskTitle} | ${date} |\n`;
+    }
+  }
+
+  content += `\n## 已完成 (${done.length})\n`;
+  if (done.length > 0) {
+    content += '| task-id | 标题 | 创建时间 |\n|---------|------|----------|\n';
+    for (const f of done) {
+      const date = f.createdAt ? new Date(f.createdAt).toLocaleDateString('zh-CN') : '-';
+      content += `| ${f.taskId} | ${f.taskTitle} | ${date} |\n`;
+    }
+  }
+
+  await fs.writeFile(join(featuresDir, 'index.md'), content);
+  console.log(`[Crew] Feature index updated: ${inProgress.length} in progress, ${done.length} completed`);
+}
+
+/**
+ * 追加完成汇总到 context/changelog.md
+ * 从 feature 文件的工作记录中提取最后一条记录作为摘要
+ */
+async function appendChangelog(session, taskId, taskTitle) {
+  const contextDir = join(session.sharedDir, 'context');
+  await fs.mkdir(contextDir, { recursive: true });
+  const changelogPath = join(contextDir, 'changelog.md');
+
+  // 读取 feature 文件提取最后一条工作记录作为摘要
+  const taskContent = await readTaskFile(session, taskId);
+  let summaryText = '';
+  if (taskContent) {
+    // 提取最后一个 ### 块作为摘要
+    const records = taskContent.split(/\n### /);
+    if (records.length > 1) {
+      const lastRecord = records[records.length - 1];
+      // 取第一行之后的内容作为摘要（第一行是角色名和时间）
+      const lines = lastRecord.split('\n');
+      summaryText = lines.slice(1).join('\n').trim();
+    }
+  }
+  if (!summaryText) {
+    summaryText = '（无详细摘要）';
+  }
+
+  // 限制摘要长度
+  if (summaryText.length > 500) {
+    summaryText = summaryText.substring(0, 497) + '...';
+  }
+
+  const now = new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' });
+  const entry = `\n## ${taskId}: ${taskTitle}\n- 完成时间: ${now}\n- 摘要: ${summaryText}\n`;
+
+  // 如果文件不存在，先写 header
+  let exists = false;
+  try {
+    await fs.access(changelogPath);
+    exists = true;
+  } catch {}
+
+  if (!exists) {
+    await fs.writeFile(changelogPath, `# Changelog\n${entry}`);
+  } else {
+    await fs.appendFile(changelogPath, entry);
+  }
+
+  console.log(`[Crew] Changelog appended: ${taskId} (${taskTitle})`);
+}
+
 // =====================================================================
 // Session Persistence
 // =====================================================================
@@ -1311,21 +1461,37 @@ ${routeTargets.map(r => `- ${r.name}: ${roleLabel(r)} — ${r.description}`).joi
 
   // 决策者额外 prompt
   if (role.isDecisionMaker) {
+    const isDevTeam = session.teamType === 'dev';
 
     prompt += `\n\n# 工具使用
-PM 可以使用所有工具，包括 Read、Grep、Glob、Bash、Edit、Write。代码文件的改动仍建议 ROUTE 给 developer 执行，但不做硬性限制。`;
+PM 可以使用所有工具，包括 Read、Grep、Glob、Bash、Edit、Write。${isDevTeam ? '代码文件的改动仍建议 ROUTE 给 developer 执行，但不做硬性限制。' : ''}`;
 
     prompt += `\n\n# 决策者职责
 你是团队的决策者。其他角色遇到不确定的情况会请求你的决策。
 - 如果你有足够的信息做出决策，直接决定并 @相关角色执行
 - 如果你需要更多信息，@具体角色请求补充
 - 如果问题超出你的能力范围或需要业务判断，@human 请人类决定
-- 你可以随时审查其他角色的工作并给出反馈
+- 你可以随时审查其他角色的工作并给出反馈`;
+
+    if (isDevTeam) {
+      prompt += `
 - PM 不做代码分析。收到需求后直接将原始需求 ROUTE 给空闲 dev 做技术分析，dev 分析完返回 PM，PM 再拆分任务并直接分配执行。
 - PM 拥有 commit + push + tag 的自主权。只要修改没有大的 regression 影响（测试全通过），PM 可以自行决定 commit、push 和 tag，无需等待人工确认。只有当改动会直接影响对话交互逻辑时，才需要人工介入审核。`;
+    }
+
+    // 非开发团队：注入讨论模式 prompt
+    if (!isDevTeam) {
+      prompt += `\n\n# 协作模式
+这是一个协作讨论团队，不走严格的 PM→执行→审查→测试 工作流。
+- 角色之间可以自由讨论、相互请教、提出不同意见
+- 不需要严格的"分配→执行→审查"流程，鼓励角色之间直接对话
+- 当一个角色需要另一个角色的输入时，直接 ROUTE 给对方并说明需要什么
+- 决策者负责把控整体方向和最终决策，但日常讨论不需要经过决策者中转
+- 每次 ROUTE 仍建议包含 task 和 taskTitle 字段，用于消息按 feature 分组显示`;
+    }
 
-    // 多实例模式：注入开发组状态和调度规则
-    if (hasMultiInstance) {
+    // 多实例模式（仅开发团队使用）：注入开发组状态和调度规则
+    if (isDevTeam && hasMultiInstance) {
       // 构建开发组实时状态
       const maxGroup = Math.max(...allRoles.map(r => r.groupIndex));
       const groupLines = [];
@@ -1375,9 +1541,8 @@ summary: 请实现注册页面，包括邮箱验证
     prompt += `\n
 # 工作流终结点
 团队的工作流有明确的结束条件。当以下任一条件满足时，你应该给出总结并结束当前工作流：
-1. **代码已提交** - 所有代码修改已经 commit（如需要，可让 developer 执行 git commit）
-2. **需要用户输入** - 遇到需要用户决定的问题时，@human 提出具体问题，等待用户回复
-3. **任务完成** - 所有任务已完成，给出完成总结（列出完成了什么、变更了哪些文件、还有什么后续建议）
+${isDevTeam ? '1. **代码已提交** - 所有代码修改已经 commit（如需要，可让 developer 执行 git commit）\n' : ''}${isDevTeam ? '2' : '1'}. **需要用户输入** - 遇到需要用户决定的问题时，@human 提出具体问题，等待用户回复
+${isDevTeam ? '3' : '2'}. **任务完成** - 所有任务已完成，给出完成总结（列出完成了什么${isDevTeam ? '、变更了哪些文件' : ''}、还有什么后续建议）
 
 重要：不要无限循环地在角色之间传递。当工作实质性完成时，主动给出总结并结束。
 
@@ -1405,6 +1570,10 @@ summary: 请实现注册页面，包括邮箱验证
 - PM 分配任务时自动创建文件（包含 task-id、标题、需求描述）
 - 每次 ROUTE 传递时自动追加工作记录（角色名、时间、summary）
 - 你收到的消息中会包含 <task-context> 标签，里面是该任务的完整工作记录
+
+系统还维护以下文件（自动更新，无需手动管理）：
+- \`context/features/index.md\`：所有 feature 的索引（进行中/已完成分类），快速查看项目状态
+- \`context/changelog.md\`：已完成任务的变更记录，每个任务完成时自动追加摘要
 你不需要手动创建或更新这些文件，专注于你的本职工作即可。`;
 
   // 执行者角色的组绑定 prompt（count > 1 时）
@@ -1651,6 +1820,33 @@ async function processRoleOutput(session, roleName, roleQuery, roleState) {
 
         // 解析路由（支持多 ROUTE 块）
         const routes = parseRoutes(roleState.accumulatedText);
+
+        // ★ 决策者 turn 完成：检测 TASKS block 中新完成的任务
+        const roleConfig = session.roles.get(roleName);
+        if (roleConfig?.isDecisionMaker) {
+          const nowCompleted = parseCompletedTasks(roleState.accumulatedText);
+          if (nowCompleted.size > 0) {
+            const prev = session._completedTaskIds || new Set();
+            const newlyDone = [];
+            for (const tid of nowCompleted) {
+              if (!prev.has(tid)) {
+                prev.add(tid);
+                newlyDone.push(tid);
+              }
+            }
+            session._completedTaskIds = prev;
+            if (newlyDone.length > 0) {
+              // 更新索引 + 追加 changelog（fire-and-forget）
+              updateFeatureIndex(session).catch(e => console.warn('[Crew] Failed to update feature index:', e.message));
+              for (const tid of newlyDone) {
+                const feature = session.features.get(tid);
+                const title = feature?.taskTitle || tid;
+                appendChangelog(session, tid, title).catch(e => console.warn(`[Crew] Failed to append changelog for ${tid}:`, e.message));
+              }
+            }
+          }
+        }
+
         roleState.accumulatedText = '';
         roleState.turnActive = false;
 
@@ -1988,7 +2184,7 @@ function buildRoutePrompt(fromRole, summary, session) {
  * 向角色发送消息
  */
 async function dispatchToRole(session, roleName, content, fromSource, taskId, taskTitle) {
-  if (session.status === 'paused' || session.status === 'stopped') {
+  if (session.status === 'paused' || session.status === 'stopped' || session.status === 'initializing') {
     console.log(`[Crew] Session ${session.status}, skipping dispatch to ${roleName}`);
     return;
   }
@@ -2769,7 +2965,8 @@ function sendStatusUpdate(session) {
         .filter(([, s]) => s.turnActive && s.currentTool)
         .map(([name, s]) => [name, s.currentTool])
     ),
-    features: Array.from(session.features.values())
+    features: Array.from(session.features.values()),
+    initProgress: session.initProgress || null
   });
 
   // 异步更新持久化

package/package.json

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