ai-project-manage-cli 6.0.89 → 6.0.91

package/dist/index.js

@@ -244,6 +244,9 @@ function sessionYamlPath(sessionId, apmRoot) {
 function sessionMessagesXmlPath(sessionId, apmRoot) {
   return join2(sessionDir(sessionId, apmRoot), "messages.xml");
 }
+function sessionAssumptionsJsonPath(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), "assumptions.json");
+}
 function documentLocalFileName(platformName) {
   const trimmed = platformName.trim();
   if (!trimmed) return "document.md";
@@ -399,6 +402,14 @@ var requestConfig = {
       method: "GET",
       path: "/cli/documents"
     }),
+    listAssumptions: defineEndpoint({
+      method: "GET",
+      path: "/cli/assumptions"
+    }),
+    markAssumptionsBackfilled: defineEndpoint({
+      method: "POST",
+      path: "/cli/assumptions/mark-backfilled"
+    }),
     listAttachments: defineEndpoint(
       {
         method: "GET",
@@ -481,12 +492,10 @@ var requestConfig = {
       method: "PUT",
       path: "/cli/task-deployments/status"
     }),
-    syncTaskDeploymentLog: defineEndpoint(
-      {
-        method: "PUT",
-        path: "/cli/task-deployments/log"
-      }
-    ),
+    syncTaskDeploymentLog: defineEndpoint({
+      method: "PUT",
+      path: "/cli/task-deployments/log"
+    }),
     completeTaskDeployment: defineEndpoint({
       method: "PUT",
       path: "/cli/task-deployments/complete"
@@ -1706,15 +1715,14 @@ async function runPull(sessionId, remoteWorkdir) {
   const api = createApmApiClient(cfg);
   const workdir = remoteWorkdir === void 0 ? resolveWorkdirPath() : requireRemoteWorkdir(remoteWorkdir);
   const apmRoot = workspaceApmDir(workdir);
-  const [detail, members, documents, attachments, messages] = await Promise.all(
-    [
-      api.cli.sessionDetail({ sessionId: trimmedId }),
-      api.cli.sessionMembers({ sessionId: trimmedId }),
-      api.cli.listDocuments({ sessionId: trimmedId }),
-      api.cli.listAttachments({ sessionId: trimmedId }),
-      api.cli.listSessionMessages({ sessionId: trimmedId })
-    ]
-  );
+  const [detail, members, documents, attachments, messages, assumptions] = await Promise.all([
+    api.cli.sessionDetail({ sessionId: trimmedId }),
+    api.cli.sessionMembers({ sessionId: trimmedId }),
+    api.cli.listDocuments({ sessionId: trimmedId }),
+    api.cli.listAttachments({ sessionId: trimmedId }),
+    api.cli.listSessionMessages({ sessionId: trimmedId }),
+    api.cli.listAssumptions({ sessionId: trimmedId }).catch(() => null)
+  ]);
   const dir = sessionDir(trimmedId, apmRoot);
   const docsDir = sessionDocsDir(trimmedId, apmRoot);
   await ensureDirExists(docsDir);
@@ -1759,6 +1767,20 @@ async function runPull(sessionId, remoteWorkdir) {
     formatSessionMessagesXml(trimmedId, messages),
     "utf8"
   );
+  writeFileSync9(
+    sessionAssumptionsJsonPath(trimmedId, apmRoot),
+    JSON.stringify(
+      assumptions ?? {
+        sessionId: trimmedId,
+        clearedAt: null,
+        backfilledAt: null,
+        assumptions: []
+      },
+      null,
+      2
+    ),
+    "utf8"
+  );
   await syncSessionAttachments(cfg, trimmedId, attachments, apmRoot);
   await syncPlatformRules(cfg, trimmedId, workdir, apmRoot);
   await syncRemoteDeploymentConfig(workdir, apmRoot);
@@ -2128,6 +2150,30 @@ async function runSyncDocument(sessionId, options) {
   console.log(`[apm] \u5DF2\u540C\u6B65\u6587\u6863: ${doc.name} (id=${doc.id})`);
 }
 
+// src/commands/assumptions.ts
+async function runAssumptionsList(sessionId) {
+  const trimmedId = sessionId.trim();
+  if (!trimmedId) {
+    console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
+    process.exit(1);
+  }
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const data = await api.cli.listAssumptions({ sessionId: trimmedId });
+  console.log(JSON.stringify(data, null, 2));
+}
+async function runAssumptionsMarkBackfilled(sessionId) {
+  const trimmedId = sessionId.trim();
+  if (!trimmedId) {
+    console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
+    process.exit(1);
+  }
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  await api.cli.markAssumptionsBackfilled({ sessionId: trimmedId });
+  console.log(`[apm] \u5DF2\u6807\u8BB0\u5047\u8BBE\u56DE\u586B\u5B8C\u6210: sessionId=${trimmedId}`);
+}
+
 // src/commands/append-message.ts
 async function appendMessageContent(cfg, messageId, content) {
   const trimmedId = messageId.trim();
@@ -2623,9 +2669,14 @@ function createDeployLogSyncer(api, deploymentRunId) {
     if (!latestLog || latestLog === lastSyncedLog) {
       return;
     }
+    const delta = latestLog.startsWith(lastSyncedLog) && lastSyncedLog.length > 0 ? latestLog.slice(lastSyncedLog.length) : latestLog;
+    if (!delta) {
+      return;
+    }
     await api.cli.syncTaskDeploymentLog({
       id: deploymentRunId,
-      log: latestLog
+      log: delta,
+      append: lastSyncedLog.length > 0
     });
     lastSyncedLog = latestLog;
   };
@@ -2678,8 +2729,7 @@ async function handleInboundDeploy(cfg, msg, signal) {
     await logSyncer.flush();
     await api.cli.completeTaskDeployment({
       id: deploymentRunId,
-      status: "SUCCESS",
-      log: log2
+      status: "SUCCESS"
     });
     console.log(`[apm] deploy success id=${deploymentRunId}`);
   } catch (error) {
@@ -2690,7 +2740,6 @@ async function handleInboundDeploy(cfg, msg, signal) {
     await api.cli.completeTaskDeployment({
       id: deploymentRunId,
       status: "FAILED",
-      log: log2,
       error: detail
     });
     console.error(`[apm] deploy failed id=${deploymentRunId}: ${detail}`);
@@ -5946,7 +5995,6 @@ async function completeTrackedDeploy(api, deploymentRunId, logSyncer, input) {
   await api.cli.completeTaskDeployment({
     id: deploymentRunId,
     status: input.status,
-    log: input.log,
     error: input.error
   });
 }
@@ -6973,6 +7021,13 @@ function buildProgram() {
   ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async (sessionId) => {
     await runPull(sessionId);
   });
+  program.command("assumptions").description("\u5047\u8BBE\u786E\u8BA4\uFF1A\u5217\u51FA\u6216\u6807\u8BB0\u56DE\u586B\u5B8C\u6210").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").option("--mark-backfilled", "\u6807\u8BB0\u5047\u8BBE\u5DF2\u5199\u56DE\u8BA1\u5212").action(async (sessionId, opts) => {
+    if (opts.markBackfilled) {
+      await runAssumptionsMarkBackfilled(sessionId);
+      return;
+    }
+    await runAssumptionsList(sessionId);
+  });
   program.command("sync-document").description("\u5C06\u672C\u5730 Markdown \u8986\u76D6\u5F0F upsert \u5230\u5E73\u53F0\u4EFB\u52A1\u6587\u6863").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").requiredOption(
     "--file <name>",
     "\u6587\u6863\u540D\u79F0\uFF08\u5982 PRD \u6216 PRD.md\uFF09\uFF0C\u8BFB\u53D6 .apm/sessions/<sessionId>/docs/ \u4E0B\u5BF9\u5E94\u6587\u4EF6"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "6.0.89",
+  "version": "6.0.91",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,

package/template/skills/apm-confirm-assumptions/SKILL.md

@@ -0,0 +1,21 @@
+# apm-confirm-assumptions：按 PM 确认结果回填计划
+
+## 何时使用
+
+收到项目经理会话消息「已回复所有假设，可以继续后面的流程」后；或 `assumptions.json` 中 `clearedAt` 有值且 `backfilledAt` 为空。
+
+## 工作流程
+
+1. **Read** `.apm/sessions/<会话ID>/assumptions.json`；不存在或 `backfilledAt` 已有 → 退出。
+2. **Read** 本 Skill；过滤 **本端** 条目（后端只看 `BACKEND_PLAN`，前端只看 `FRONTEND_PLAN`）。
+3. **Read** 本端计划：`docs/BACKEND-PLAN.md` 或 `docs/FRONTEND-PLAN.md`。
+4. 逐条按 `resolution` 更新计划：
+   - 移入「依据」表，来源写「项目经理确认」；
+   - 从「假设」章节删除该题；
+   - `customAnswer` 或影响实现范围时 → 修订「实现步骤 / 改动文件白名单」；后端涉及接口则同步 `docs/API.md`。
+5. **`apm sync-document`** 同步计划（及 API 文档）。
+6. **Read/Update** `TODO.md`：勾选「等待项目经理确认假设」等相关项。
+7. **`append_message`**：摘要回填结果；声明「假设已清零，可进入测试要点编写」。
+8. 执行 **`apm assumptions <会话ID> --mark-backfilled`**。
+
+**禁止**从 `messages.xml` 解析 PM 对假设的回复——只认 `assumptions.json`。

package/template/skills/apm-rewrite-assumptions/SKILL.md

@@ -0,0 +1,12 @@
+# apm-rewrite-assumptions：重写 PM 不友好的假设问法
+
+## 何时使用
+
+`apm sync-document` 后平台标记假设 `quality=NEEDS_REWRITE`，或计划被退回需重写「问 / 场景 / 选项」。
+
+## 工作流程
+
+1. **Read** 本端计划文档的「假设」章节与 `qualityIssues`（若有 assumptions.json 中的 technicalNote）。
+2. 将研发术语移入 **研发备注**；**问** 改为 PM 可理解的业务句子；补全 **场景** 与 **≥2 个选项**（含 id + label）。
+3. **禁止多选**；复合口径说明写在 Other 指引中。
+4. 重新 **`apm sync-document`** 同步计划。

package/template/skills/apm-write-checklist/SKILL.md

@@ -20,7 +20,7 @@
 逐条对照需求原文与计划：
 
 - **计划与需求矛盾、或需求关键点在计划中没有覆盖**：不要写清单，先用 `append_message` 指出问题并 `@` 对应工程师打回，等计划修订后再写。
-- **计划中的「假设」尚未被项目经理确认**：在回复中提醒，但可以先写清单（清单按需求原文出）。
+- **计划中的「假设」尚未确认或尚未回填计划**（查 `assumptions.json`：`PENDING` 或 `clearedAt && !backfilledAt`）：**不要写清单**，先提醒 PM / 执行 `apm-confirm-assumptions`。
 - 计划覆盖完整：进入步骤 3。
 
 ### 步骤 3：按模板写清单

package/template/skills/apm-write-plan/SKILL.md

@@ -4,14 +4,10 @@
 
 前端 / 后端工程师在任务启动后**直接读原始需求写实现计划**，不经过 PRD。
 
-本技能合并了原 `apm-write-prd`、`apm-review`、`apm-write-frontend-plan`、`apm-write-backend-api` 四个技能的职能：评审（判断是否参与、发现口径缺口）和方案（怎么改、改哪些文件）一步完成。
-
-| 角色 | 产出文档                                                      | 路径                                  |
-| ---- | ------------------------------------------------------------- | ------------------------------------- |
-| 后端 | `BACKEND-PLAN.md`（实现计划）+ `API.md`（联调契约，单独产出） | `docs/BACKEND-PLAN.md`、`docs/API.md` |
-| 前端 | `FRONTEND-PLAN.md`                                            | `docs/FRONTEND-PLAN.md`               |
-
-**两份后端文档禁止合并**：`BACKEND-PLAN.md` 不写完整参数表 / JSON 示例；`API.md` 不写 Service / SQL 等实现细节。
+| 角色 | 产出文档 | 路径 |
+| ---- | -------- | ---- |
+| 后端 | `BACKEND-PLAN.md` + `API.md` | `docs/BACKEND-PLAN.md`、`docs/API.md` |
+| 前端 | `FRONTEND-PLAN.md` | `docs/FRONTEND-PLAN.md` |
 
 ---
 
@@ -19,61 +15,42 @@
 
 ### 步骤 1：判断本端是否需要参与
 
-**Read** `.apm/sessions/<会话ID>/TASK.md`（必要时结合群消息中项目经理的补充说明）。
+**Read** `.apm/sessions/<会话ID>/TASK.md`。
 
-- **不涉及本端改动**：立即用 `append_message` 回复「本需求与前端/后端无关，理由：xxx」（一句话说明理由），**流程到此结束，禁止写任何文档、禁止改任何代码**。
+- **不涉及本端改动**：`append_message` 回复理由后结束。
 - **涉及本端改动**：进入步骤 2。
 
-### 步骤 2：有限调研（必须遵守预算）
-
-1. **优先读现成结论**：先读 `docs/` 下已有的模块档案、历史工作日志、其他成员已同步的文档，能复用就不要重新调研。
-2. **再调研代码**：只看与需求直接相关的页面 / 接口 / 表。**调研预算：最多读 15 个代码文件**，禁止全库考古、禁止顺藤摸瓜阅读无关模块。
-3. **口径不清不要自己拍板**：调研中发现需求没写清的业务口径（例如字段含义、互斥规则、历史数据兼容），一律记入计划的「依据与假设」章节，禁止编造业务规则。
+### 步骤 2：有限调研
 
-**前端额外要求**：若本次涉及接口对接，**Read** `docs/API.md`；不存在则先 `@后端` 产出 `API.md`，**禁止在计划中自行编写或抄写接口定义**。
+1. 优先读 `docs/` 现成结论。
+2. 代码调研预算：**最多 15 个文件**。
+3. 口径不清 → 记入「假设」章节，禁止编造。
 
 ### 步骤 3：按模板写计划
 
-**Read** `.apm/skills/apm-write-plan/plan-template.md`，按模板 **Write** 对应的计划文档。硬性要求，缺一不可：
+**Read** `.apm/skills/apm-write-plan/plan-template.md`，**Write** 计划文档。
 
-1. **依据与假设**：每条关键口径标注来源（需求原文第几条 / 现有代码行为 / 已有文档）；标不出来源的就是「假设」，单独列出。
-2. **改动文件白名单**：本次允许改动的文件完整列表。后续开发与 diff 评审都以此为准，**开发时改了白名单之外的文件会被打回**。
-3. **后端专属——同步产出 API.md**（涉及接口变更时）：**Read** `.apm/skills/apm-write-plan/api-template.md`，按模板 **Write** `docs/API.md`。这是前端联调的唯一契约来源，前端直接阅读本文档，禁止各写一份。
-4. **后端专属——SQL 变更声明**（仅当涉及表结构/数据变更时）：在「实现步骤」中注明开发须产出 `docs/SQL.md`；计划本身不写大段 SQL，完整语句由后端开发阶段写入该文档。
-5. **前端专属——接口对接要点**：只写「何时调、关键点」，引用 `API.md` 章节，**禁止复制参数表 / JSON 示例**。
+### 步骤 3.5：假设 PM 友好自检（sync 前必做）
 
-### 步骤 4：回复
+每条假设必须含 **问 / 场景 / 选项（≥2 项，id + label）**：
 
-回复消息（遵守 `reply.md`）：
+- **问** 禁止：`status=`、字段名、表名、类路径、SQL。
+- **禁止多选**；复合口径由 PM 在 Web「其他」中填写。
+- 能自己查清的代码含义 → 移入「依据」，删除假设。
+- 技术发现 → 写进 **研发备注**，问句用业务语言。
 
-- **「假设」章节非空**：把假设逐条列进回复内容，`@项目经理` 请其确认；明确说「以上假设确认前不开始开发」。
-- **无假设**：回复计划已就绪，可进入测试要点编写。
-- **后端**：涉及接口变更时，回复中 `@前端` 阅读 `API.md` 并编写 `FRONTEND-PLAN.md`。
-- **前端**：`API.md` 尚未就绪时，回复 `@后端` 先产出 `API.md`，**禁止自行编写接口契约**。
+### 步骤 4：同步与回复
 
-### 步骤 5：假设回填（项目经理确认后必须执行）
+1. `apm sync-document` 同步计划（及 API 文档）。
+2. **有假设**：`@项目经理` 请其在 Web **「待您确认」** Panel 点选；说明「以上假设确认前不开始开发」。**禁止**在聊天里粘贴研发术语。
+3. **无假设**：回复计划已就绪，可进入测试要点编写。
 
-当你被安排「根据项目经理的确认更新计划」，或发现项目经理已回复假设确认时：
+### 假设回填
 
-1. **Read** `.apm/sessions/<会话ID>/messages.xml`，找到项目经理针对假设的最新回复，**逐条对照你列出的假设**，不要只看 speakContext 的转述。
-2. 更新计划文档：
-   - 被确认的假设 → **移入「依据」表格**，来源写「项目经理确认（第 N 轮）」；
-   - 被否定或修正的假设 → 按项目经理给出的口径**修订「实现步骤」与「改动文件白名单」**；
-   - 项目经理没有回应的假设 → 保留在「假设」中，再次 `@项目经理` 追问。
-3. **后端**：假设修订涉及接口口径时，同步更新 `docs/API.md`。
-4. 重新执行 `apm sync-document` 同步计划与 API 文档。
-5. 回复消息：逐条说明每个假设的处理结果（确认采纳 / 按口径修订了什么），全部解决则声明「假设已清零，可进入测试要点编写」。
-
-**禁止**跳过回填直接开发：澄清结论必须落进计划文档（接口口径落进 `API.md`），后续开发与 diff 评审都只认文档，不认聊天记录。
+项目经理确认后由 **`apm-confirm-assumptions`** 技能执行（读 `assumptions.json`，**禁止**读 messages.xml 猜 PM 回复）。
 
 ---
 
-## 写作要求
-
-- 篇幅 **40 ～ 100 行**，宁可少写；不要伪代码、不要大段 SQL（完整语句写入 `docs/SQL.md`，由后端开发阶段产出）。
-- 用产品语言描述行为，文件路径只出现在「改动文件白名单」。
-- 前后端可同轮并行编写计划；前端接口部分依赖 `API.md`，后端须先或同步产出。
-
 ## 何时使用
 
-协作流程阶段 1（实现计划）；或用户要求写 `BACKEND-PLAN.md` / `FRONTEND-PLAN.md` / `API.md`。
+协作流程阶段 1（实现计划）。

package/template/skills/apm-write-plan/plan-template.md

@@ -24,10 +24,15 @@
 
 ### 假设（待项目经理确认，确认前不开发）
 
-- [ ] A1：xxx（为什么需要确认）
-- [ ] A2：xxx
+#### A1
+- **问**（prompt）：审批被驳回后，申请人能否修改并重新提交？
+- **场景**：需求写了审批流程，未说明驳回后的操作
+- **选项**：
+  - opt_resubmit：允许修改后重新提交
+  - opt_new：不允许，需新建申请
+- **研发备注**：代码 `inspection_flow.status=5` 表示 REJECTED（仅研发可见）
 
-> 无假设时写「无，口径均有依据」。
+> PM 若需表达复合口径，在 Web Panel 选 **「其他」** 并文字说明。
 
 ## 3. 实现步骤
 
@@ -70,7 +75,12 @@
 
 ### 假设（待项目经理确认，确认前不开发）
 
-- [ ] A1：xxx（为什么需要确认）
+#### A1
+- **问**（prompt）：…
+- **场景**：…
+- **选项**：
+  - opt_a：…
+  - opt_b：…
 
 > 无假设时写「无，口径均有依据」。