yg-team-cli 2.5.8 → 2.6.0

package/README.md

@@ -69,6 +69,16 @@
 - **新增**: `team-cli dev` 选择里程碑时，现在会直观显示已完成、进行中和未开始的状态图标及进度 (如 `[4/7]`)
 - **改进**: 增强了 Spec 文件的解析逻辑，能够更准确地识别已标记为 `[x]` 的任务项
 
+**v2.5.9** - Spec 状态同步与动态检测
+- **改进**: `dev` 模式列表现在基于 Milestone 实际完成百分比动态显示 Spec 状态（即使文件头部状态未及时手动更新）
+- **修复**: 在通过 `dev` 命令完成任务时，系统现在会自动同步并更新 Spec 文件头部的“状态”标识，确保文档与进度一致
+
+**v2.6.0** - 统一状态解析逻辑与多维同步
+- **重构**: 将核心 Spec 解析逻辑沉淀至 `SpecUtils` 共享工具类，实现全系统逻辑收口
+- **改进**: `status` 命令与 `sync-memory` 命令现在统一接入动态进度推导引擎，解决状态显示落后的问题
+- **优化**: 全面统一了各命令中状态图标（✓, ⟳, ◉, ○）的定义，提供一致的视觉交互体验
+- **增强**: `sync-memory` 现在能更准确地根据任务勾选情况自动更新 `AI_MEMORY.md` 中的完成日期及状态列
+
 **v2.4.10** - 修复 Claude 返回权限确认而非实际内容问题
 - **修复**: 添加 `--dangerously-skip-permissions` 参数跳过权限确认
 - **问题**: v2.4.9 中 Claude CLI 在新目录首次运行时返回权限确认提示而非 spec 内容

package/dist/cli.js

@@ -422,7 +422,89 @@ var init_utils = __esm({
         return spec;
       }
       /**
-       * 获取 spec 状态
+       * 解析里程碑信息
+       */
+      static parseMilestones(content) {
+        const milestones = [];
+        const lines = content.split("\n");
+        let currentMilestone = null;
+        let inMilestone = false;
+        for (const line of lines) {
+          if (line.match(/^###\s+Milestone\s+\d+:/)) {
+            if (currentMilestone) {
+              milestones.push(currentMilestone);
+            }
+            const title = line.replace(/^###\s+/, "").trim();
+            currentMilestone = { title, todos: [], completedCount: 0 };
+            inMilestone = true;
+            continue;
+          }
+          if (inMilestone && currentMilestone) {
+            if (line.match(/^###\s+Milestone/)) {
+              milestones.push(currentMilestone);
+              currentMilestone = null;
+              continue;
+            }
+            const todoMatch = line.match(/^-\s+\[([ xX])\]\s*(.+)/);
+            if (todoMatch) {
+              const isCompleted = todoMatch[1].toLowerCase() === "x";
+              if (isCompleted) {
+                currentMilestone.completedCount++;
+              }
+              currentMilestone.todos.push(todoMatch[2].trim());
+            }
+          }
+        }
+        if (currentMilestone) {
+          milestones.push(currentMilestone);
+        }
+        return milestones;
+      }
+      /**
+       * 解析 spec 状态（基于进度动态推导）
+       */
+      static parseSpecStatus(content) {
+        const milestones = this.parseMilestones(content);
+        if (milestones.length > 0) {
+          const totalTodos = milestones.reduce((sum, m) => sum + m.todos.length, 0);
+          const completedTodos = milestones.reduce((sum, m) => sum + m.completedCount, 0);
+          if (totalTodos > 0) {
+            if (completedTodos === totalTodos) return "\u5DF2\u5B8C\u6210";
+            if (completedTodos > 0) return "\u8FDB\u884C\u4E2D";
+          }
+          return "\u5DF2\u62C6\u5206";
+        }
+        const statusMatch = content.match(/状态.*[:：]\s*(.+)/);
+        if (statusMatch) {
+          const status = statusMatch[1].replace(/\*\*/g, "").trim();
+          if (status.includes("\u5DF2\u5B8C\u6210")) return "\u5DF2\u5B8C\u6210";
+          if (status.includes("\u8FDB\u884C\u4E2D")) return "\u8FDB\u884C\u4E2D";
+          if (status.includes("\u5DF2\u62C6\u5206")) return "\u5DF2\u62C6\u5206";
+        }
+        return "\u672A\u5F00\u59CB";
+      }
+      /**
+       * 获取进度字符串
+       */
+      static getProgress(content) {
+        const milestones = this.parseMilestones(content);
+        if (milestones.length === 0) return "-";
+        const totalTodos = milestones.reduce((sum, m) => sum + m.todos.length, 0);
+        const completedTodos = milestones.reduce((sum, m) => sum + m.completedCount, 0);
+        if (totalTodos === 0) return "-";
+        return `${completedTodos}/${totalTodos}`;
+      }
+      /**
+       * 获取带图标的状态
+       */
+      static getStatusWithIcon(status) {
+        if (status.includes("\u5DF2\u5B8C\u6210")) return "\u2713 \u5DF2\u5B8C\u6210";
+        if (status.includes("\u8FDB\u884C\u4E2D")) return "\u27F3 \u8FDB\u884C\u4E2D";
+        if (status.includes("\u5DF2\u62C6\u5206")) return "\u25C9 \u5DF2\u62C6\u5206";
+        return "\u25CB \u672A\u5F00\u59CB";
+      }
+      /**
+       * 获取 spec 状态 (原始版本兼容)
        */
       static async getSpecStatus(file) {
         try {
@@ -2775,7 +2857,7 @@ async function selectSpec() {
   for (let i = 0; i < specFiles.length; i++) {
     const file = path9.join(specDir, specFiles[i]);
     const spec = await FileUtils.read(file);
-    const status = parseSpecStatus(spec);
+    const status = SpecUtils.parseSpecStatus(spec);
     const dependencies = parseDependencies(spec);
     specs.push({
       file,
@@ -2817,7 +2899,7 @@ async function selectMilestone(specFile) {
   logger.step("\u6B65\u9AA4 2/3: \u89E3\u6790 milestones...");
   logger.newLine();
   const specContent = await FileUtils.read(specFile);
-  const milestones = parseMilestones(specContent);
+  const milestones = SpecUtils.parseMilestones(specContent);
   if (milestones.length === 0) {
     logger.info("\u8BE5 spec \u5C1A\u672A\u62C6\u5206 milestones");
     const { breakdownNow } = await inquirer3.prompt([
@@ -2870,7 +2952,9 @@ async function selectTodo(specFile, milestone) {
   logger.step("\u6B65\u9AA4 3/3: \u9009\u62E9 todo \u4EFB\u52A1...");
   logger.newLine();
   const specContent = await FileUtils.read(specFile);
-  const todos = parseTodos(specContent, milestone);
+  const milestones = SpecUtils.parseMilestones(specContent);
+  const targetMilestone = milestones.find((m) => m.title === milestone);
+  const todos = targetMilestone ? targetMilestone.todos : [];
   if (todos.length === 0) {
     logger.warn("\u8BE5 milestone \u6CA1\u6709 todo \u4EFB\u52A1");
     const { implementAll } = await inquirer3.prompt([
@@ -2944,16 +3028,6 @@ async function executeDevelopment(specFile, milestone, todo) {
   logger.step("2. \u8FD0\u884C 'team-cli dev' \u7EE7\u7EED\u4E0B\u4E00\u4E2A\u4EFB\u52A1");
   logger.newLine();
 }
-function parseSpecStatus(spec) {
-  const statusMatch = spec.match(/状态.*[:：]\s*(.+)/);
-  if (statusMatch) {
-    const status = statusMatch[1].replace(/\*\*/g, "").trim();
-    if (status.includes("\u5DF2\u5B8C\u6210")) return "\u5DF2\u5B8C\u6210";
-    if (status.includes("\u8FDB\u884C\u4E2D")) return "\u8FDB\u884C\u4E2D";
-    if (status.includes("\u5DF2\u62C6\u5206")) return "\u5DF2\u62C6\u5206";
-  }
-  return "\u672A\u5F00\u59CB";
-}
 function parseDependencies(spec) {
   const deps = [];
   let inDepsSection = false;
@@ -2976,63 +3050,6 @@ function parseDependencies(spec) {
   }
   return deps;
 }
-function parseMilestones(spec) {
-  const milestones = [];
-  const lines = spec.split("\n");
-  let currentMilestone = null;
-  let inMilestone = false;
-  for (const line of lines) {
-    if (line.match(/^###\s+Milestone\s+\d+:/)) {
-      if (currentMilestone) {
-        milestones.push(currentMilestone);
-      }
-      const title = line.replace(/^###\s+/, "").trim();
-      currentMilestone = { title, todos: [], completedCount: 0 };
-      inMilestone = true;
-      continue;
-    }
-    if (inMilestone && currentMilestone) {
-      if (line.match(/^###\s+Milestone/)) {
-        milestones.push(currentMilestone);
-        currentMilestone = null;
-        continue;
-      }
-      const todoMatch = line.match(/^-\s+\[([ xX])\]\s*(.+)/);
-      if (todoMatch) {
-        const isCompleted = todoMatch[1].toLowerCase() === "x";
-        if (isCompleted) {
-          currentMilestone.completedCount++;
-        }
-        currentMilestone.todos.push(todoMatch[2].trim());
-      }
-    }
-  }
-  if (currentMilestone) {
-    milestones.push(currentMilestone);
-  }
-  return milestones;
-}
-function parseTodos(spec, milestoneTitle) {
-  const lines = spec.split("\n");
-  const todos = [];
-  let inTargetMilestone = false;
-  for (const line of lines) {
-    if (line.includes(milestoneTitle)) {
-      inTargetMilestone = true;
-      continue;
-    }
-    if (inTargetMilestone) {
-      if (line.match(/^###\s+Milestone/)) {
-        break;
-      }
-      const todoMatch = line.match(/^-\s+\[[ x ]\]\s*(.+)/);
-      if (todoMatch) {
-        todos.push(todoMatch[1].trim());
-      }
-    }
-  }
-  return todos;
-}
 function topologicalSort(specs) {
   const sorted = [];
   const visited = /* @__PURE__ */ new Set();
@@ -3190,7 +3207,19 @@ async function askAndUpdateSpecStatus(specFile, milestone, todo) {
       logger.warn("\u672A\u627E\u5230\u5BF9\u5E94\u7684 todo \u9879");
       return;
     }
-    await FileUtils.write(specFile, lines.join("\n"));
+    const newContent = lines.join("\n");
+    const computedStatus = SpecUtils.parseSpecStatus(newContent);
+    let finalLines = lines;
+    const statusLineIndex = finalLines.findIndex((l) => l.match(/状态.*[:：]/));
+    if (statusLineIndex !== -1) {
+      const oldLine = finalLines[statusLineIndex];
+      const newLine = oldLine.replace(/([:：]\s*)(.+)/, `$1**${computedStatus}**`);
+      if (oldLine !== newLine) {
+        finalLines[statusLineIndex] = newLine;
+        logger.info(`\u81EA\u52A8\u540C\u6B65 Spec \u5934\u90E8\u72B6\u6001\u4E3A: ${computedStatus}`);
+      }
+    }
+    await FileUtils.write(specFile, finalLines.join("\n"));
     logger.success("Spec \u6587\u4EF6\u5DF2\u66F4\u65B0");
   } catch (error) {
     logger.warn(`\u66F4\u65B0 spec \u6587\u4EF6\u5931\u8D25: ${error}`);
@@ -4610,11 +4639,12 @@ async function displayFeatureInventory() {
   for (const file of specs) {
     const filePath = path13.join(specDir, file);
     const content = await FileUtils.read(filePath);
-    const status = parseSpecStatus2(content);
+    const status = SpecUtils.parseSpecStatus(content);
+    const statusWithIcon = SpecUtils.getStatusWithIcon(status);
     inventory.push({
       name: file.replace(".md", ""),
-      status,
-      progress: getProgress(content)
+      status: statusWithIcon,
+      progress: SpecUtils.getProgress(content)
     });
   }
   const tableData = inventory.map((item) => [
@@ -4681,28 +4711,6 @@ async function displayRecentActivity() {
     logger.newLine();
   }
 }
-function parseSpecStatus2(spec) {
-  const statusMatch = spec.match(/状态.*[:：]\s*(.+)/);
-  if (statusMatch) {
-    const status = statusMatch[1].replace(/\*\*/g, "").trim();
-    if (status.includes("\u5DF2\u5B8C\u6210")) return "\u2713 \u5DF2\u5B8C\u6210";
-    if (status.includes("\u8FDB\u884C\u4E2D")) return "\u27F3 \u8FDB\u884C\u4E2D";
-    if (status.includes("\u5DF2\u62C6\u5206")) return "\u25C9 \u5DF2\u62C6\u5206";
-  }
-  return "\u25CB \u672A\u5F00\u59CB";
-}
-function getProgress(spec) {
-  const milestoneMatches = spec.match(/###\s+Milestone\s+\d+:/g);
-  const milestones = milestoneMatches ? milestoneMatches.length : 0;
-  const todoMatches = spec.match(/-\s+\[[ x ]\]/g);
-  const totalTodos = todoMatches ? todoMatches.length : 0;
-  const completedMatches = spec.match(/-\s+\[x\]/g);
-  const completedTodos = completedMatches ? completedMatches.length : 0;
-  if (totalTodos === 0) {
-    return "-";
-  }
-  return `${completedTodos}/${totalTodos}`;
-}
 var statusCommand;
 var init_status = __esm({
   "src/commands/status.ts"() {
@@ -5024,16 +5032,17 @@ async function syncFeatureInventory(aiMemoryFile, projectDir) {
     const displayName = name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
     const specPath = path15.join(specsDir, specFile);
     const content = await FileUtils.read(specPath);
-    const status = parseSpecStatus3(content);
-    const progress = getSpecProgress(content);
+    const status = SpecUtils.parseSpecStatus(content);
+    const statusWithIcon = SpecUtils.getStatusWithIcon(status);
+    const progress = SpecUtils.getProgress(content);
     let completionDate = "-";
-    if (status === "\u2705 \u5DF2\u5B8C\u6210") {
+    if (status === "\u5DF2\u5B8C\u6210") {
       const dateMatch = content.match(/完成日期.*[:：]\s*(.+)/);
       if (dateMatch) {
         completionDate = dateMatch[1].trim();
       }
     }
-    lines.push(`| ${displayName} | ${name}.md | ${status} | ${progress} | ${completionDate} | |`);
+    lines.push(`| ${displayName} | ${name}.md | ${statusWithIcon} | ${progress} | ${completionDate} | |`);
   }
   const newContent = lines.join("\n") + "\n";
   await replaceOrInsertSection(aiMemoryFile, "## \u529F\u80FD\u6E05\u5355", newContent);
@@ -5220,26 +5229,6 @@ async function replaceOrInsertSection(aiMemoryFile, sectionTitle, newContent) {
     await FileUtils.write(aiMemoryFile, content.trimEnd() + "\n\n" + newContent + "\n");
   }
 }
-function parseSpecStatus3(spec) {
-  const statusMatch = spec.match(/状态.*[:：]\s*(.+)/);
-  if (statusMatch) {
-    const status = statusMatch[1].replace(/\*\*/g, "").trim();
-    if (status.includes("\u5DF2\u5B8C\u6210")) return "\u2705 \u5DF2\u5B8C\u6210";
-    if (status.includes("\u8FDB\u884C\u4E2D")) return "\u27F3 \u8FDB\u884C\u4E2D";
-    if (status.includes("\u5DF2\u62C6\u5206")) return "\u25C9 \u5DF2\u62C6\u5206";
-  }
-  return "\u25CB \u672A\u5F00\u59CB";
-}
-function getSpecProgress(spec) {
-  const todoMatches = spec.match(/-\s+\[[ x ]\]/g);
-  const totalTodos = todoMatches ? todoMatches.length : 0;
-  const completedMatches = spec.match(/-\s+\[x\]/g);
-  const completedTodos = completedMatches ? completedMatches.length : 0;
-  if (totalTodos === 0) {
-    return "-";
-  }
-  return `${completedTodos}/${totalTodos}`;
-}
 async function syncTemplateVersions(aiMemoryFile, projectDir) {
   logger.step("\u540C\u6B65\u6A21\u677F\u7248\u672C\u4FE1\u606F...");
   const config = await readTemplateConfig(projectDir);