ai-project-manage-cli 6.0.42 → 6.0.44-alpha.1

package/dist/index.js

@@ -127,6 +127,13 @@ function resolveWorkdirPath(cwd = process.cwd()) {
     return normalizeWorkdirPath(absolute);
   }
 }
+function requireRemoteWorkdir(workdir) {
+  const trimmed = typeof workdir === "string" ? workdir.trim() : "";
+  if (!trimmed) {
+    throw new Error("[apm] \u8FDC\u7A0B\u6D88\u606F\u7F3A\u5C11\u5DE5\u4F5C\u76EE\u5F55 workdir");
+  }
+  return resolveWorkdirPath(trimmed);
+}
 
 // src/command-utils.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
@@ -611,7 +618,7 @@ async function runBranch(sessionId, options = {}) {
 
 // src/commands/pull.ts
 import { writeFileSync as writeFileSync6 } from "fs";
-import { dirname as dirname2, join as join7 } from "path";
+import { join as join7 } from "path";
 import { stringify as yamlStringify } from "yaml";
 
 // src/session-messages-xml.ts
@@ -908,13 +915,7 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
 }
 
 // src/commands/pull.ts
-function resolvePullWorkdir(apmRoot) {
-  if (apmRoot) {
-    return resolveWorkdirPath(dirname2(apmRoot));
-  }
-  return resolveWorkdirPath();
-}
-async function runPull(sessionId, apmRoot) {
+async function runPull(sessionId, remoteWorkdir) {
   const trimmedId = sessionId.trim();
   if (!trimmedId) {
     console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
@@ -922,6 +923,8 @@ async function runPull(sessionId, apmRoot) {
   }
   const cfg = await ensureLoggedConfig();
   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 }),
@@ -976,8 +979,7 @@ async function runPull(sessionId, apmRoot) {
     "utf8"
   );
   await syncSessionAttachments(cfg, trimmedId, attachments, apmRoot);
-  const workdirPath = resolvePullWorkdir(apmRoot);
-  await syncPlatformRules(cfg, trimmedId, workdirPath, apmRoot);
+  await syncPlatformRules(cfg, trimmedId, workdir, apmRoot);
   console.log(`[apm] \u5DF2\u540C\u6B65\u4F1A\u8BDD\u5DE5\u4F5C\u533A: ${dir}`);
   return dir;
 }
@@ -987,12 +989,12 @@ import { spawnSync } from "child_process";
 
 // src/version.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { dirname as dirname3, join as join8 } from "path";
+import { dirname as dirname2, join as join8 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var CLI_PACKAGE_NAME = "ai-project-manage-cli";
 function readCliVersion() {
   try {
-    const dir = dirname3(fileURLToPath2(import.meta.url));
+    const dir = dirname2(fileURLToPath2(import.meta.url));
     const pkgPath = join8(dir, "..", "package.json");
     const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
@@ -1430,7 +1432,6 @@ import {
   CursorAgentError
 } from "@cursor/sdk";
 import { setMaxListeners as setMaxListeners2 } from "node:events";
-import { resolve as resolve4 } from "path";
 
 // src/session-utils.ts
 var EventSession = class {
@@ -1592,7 +1593,7 @@ ${JSON.stringify(event, null, 2)}
 
 // src/commands/connect/agent-session-registry.ts
 import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync7 } from "node:fs";
-import { dirname as dirname4, resolve as resolve3 } from "node:path";
+import { dirname as dirname3, resolve as resolve3 } from "node:path";
 function registryPath(workdir, sessionId) {
   return resolve3(workdir, ".apm", "sessions", sessionId, "cursor-agents.json");
 }
@@ -1618,7 +1619,7 @@ function readRegistry(path10) {
   return {};
 }
 function writeRegistry(path10, registry) {
-  mkdirSync5(dirname4(path10), { recursive: true });
+  mkdirSync5(dirname3(path10), { recursive: true });
   writeFileSync7(path10, `${JSON.stringify(registry, null, 2)}
 `, "utf8");
 }
@@ -1755,6 +1756,16 @@ function createAppendMessageCustomTools(cfg, messageId) {
   };
 }
 
+// src/commands/connect/playwright-mcp.ts
+function createPlaywrightMcpServers() {
+  return {
+    playwright: {
+      command: "npx",
+      args: ["@playwright/mcp@latest", "--browser", "chrome", "--vision"]
+    }
+  };
+}
+
 // src/commands/connect/cursor-agent.ts
 setMaxListeners2(50);
 installAbortSignalDebug();
@@ -1782,7 +1793,8 @@ async function obtainAgent(ctx) {
     model: { id: ctx.model || "default" },
     local: {
       cwd: ctx.cwd
-    }
+    },
+    mcpServers: createPlaywrightMcpServers()
   };
   const savedAgentId = ctx.user ? loadSessionAgentId(ctx.workdir, ctx.sessionId, ctx.user) : void 0;
   if (savedAgentId) {
@@ -1816,16 +1828,16 @@ async function runCursorAgent(cfg, ctx, options) {
   if (!apiKey) {
     throw new Error("\u7F3A\u5C11 apiKey\uFF0C\u65E0\u6CD5\u8C03\u7528 Cursor SDK");
   }
-  const cwd = resolve4(ctx.workdir);
+  const workdir = resolveWorkdirPath(ctx.workdir);
   const prompt = ctx.prompt;
   console.log(
-    `[apm] Cursor Agent \u5F00\u59CB messageId=${ctx.messageId} sessionId=${ctx.sessionId} cwd=${cwd}`
+    `[apm] Cursor Agent \u5F00\u59CB messageId=${ctx.messageId} sessionId=${ctx.sessionId} cwd=${workdir}`
   );
   const { agent, resumed } = await obtainAgent({
     apiKey,
     model: ctx.model,
-    cwd,
-    workdir: ctx.workdir,
+    cwd: workdir,
+    workdir,
     sessionId: ctx.sessionId,
     user: ctx.user
   });
@@ -1850,6 +1862,7 @@ async function runCursorAgent(cfg, ctx, options) {
   logAbortSignalStats(signal, "runCursorAgent:after-addListener");
   try {
     const run = await agent.send(prompt, {
+      mcpServers: createPlaywrightMcpServers(),
       local: {
         customTools: createAppendMessageCustomTools(cfg, ctx.messageId)
       }
@@ -1884,7 +1897,7 @@ async function runCursorAgent(cfg, ctx, options) {
       });
       console.error(`[apm] ${failureMessage}`);
       if (resumed) {
-        clearSessionAgentId(ctx.workdir, ctx.sessionId, ctx.user);
+        clearSessionAgentId(workdir, ctx.sessionId, ctx.user);
       }
       throw new Error(failureMessage);
     }
@@ -1895,7 +1908,7 @@ async function runCursorAgent(cfg, ctx, options) {
   } catch (err) {
     if (err instanceof CursorAgentError) {
       if (resumed) {
-        clearSessionAgentId(ctx.workdir, ctx.sessionId, ctx.user);
+        clearSessionAgentId(workdir, ctx.sessionId, ctx.user);
       }
       throw new Error(
         `Cursor \u542F\u52A8\u5931\u8D25: ${err.message}${err.isRetryable ? "\uFF08\u53EF\u91CD\u8BD5\uFF09" : ""}`
@@ -1912,23 +1925,27 @@ async function runCursorAgent(cfg, ctx, options) {
 
 // src/commands/connect/pre-step-cache.ts
 var PULL_TTL_MS = 3e4;
-var lastBranchSessionId = null;
-var lastPullAtBySession = /* @__PURE__ */ new Map();
-function shouldRunBranch(sessionId) {
-  return lastBranchSessionId !== sessionId;
+function sessionWorkdirKey(sessionId, workdir) {
+  return `${sessionId}\0${workdir}`;
+}
+var lastBranchKey = null;
+var lastPullAtByKey = /* @__PURE__ */ new Map();
+function shouldRunBranch(sessionId, workdir) {
+  return lastBranchKey !== sessionWorkdirKey(sessionId, workdir);
 }
-function markBranchDone(sessionId) {
-  lastBranchSessionId = sessionId;
+function markBranchDone(sessionId, workdir) {
+  lastBranchKey = sessionWorkdirKey(sessionId, workdir);
 }
-function shouldRunPull(sessionId) {
-  const last = lastPullAtBySession.get(sessionId);
+function shouldRunPull(sessionId, workdir) {
+  const key = sessionWorkdirKey(sessionId, workdir);
+  const last = lastPullAtByKey.get(key);
   if (last == null) {
     return true;
   }
   return Date.now() - last >= PULL_TTL_MS;
 }
-function markPullDone(sessionId) {
-  lastPullAtBySession.set(sessionId, Date.now());
+function markPullDone(sessionId, workdir) {
+  lastPullAtByKey.set(sessionWorkdirKey(sessionId, workdir), Date.now());
 }
 
 // src/commands/connect/run-slot-pool.ts
@@ -1941,10 +1958,10 @@ function createRunSlotPool(maxConcurrent = DEFAULT_MAX_CONCURRENT) {
       active += 1;
       return Promise.resolve();
     }
-    return new Promise((resolve6) => {
+    return new Promise((resolve5) => {
       waiters.push(() => {
         active += 1;
-        resolve6();
+        resolve5();
       });
     });
   };
@@ -1978,6 +1995,8 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
   if (isUserCancelled(ctx)) return;
   if (signal.aborted) return;
   const messageId = msg.messageId;
+  const workdir = requireRemoteWorkdir(msg.workdir);
+  const apmRoot = workspaceApmDir(workdir);
   const runStep = async (step, fn) => {
     const startedAt = Date.now();
     try {
@@ -1995,24 +2014,18 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
       "status-typing",
       () => updateMessageStatus(cfg, messageId, "TYPING")
     );
-    if (shouldRunBranch(msg.sessionId)) {
+    if (shouldRunBranch(msg.sessionId, workdir)) {
       if (signal.aborted) return;
-      await runStep(
-        "branch",
-        () => runBranch(msg.sessionId, { cwd: msg.workdir })
-      );
-      markBranchDone(msg.sessionId);
+      await runStep("branch", () => runBranch(msg.sessionId, { cwd: workdir }));
+      markBranchDone(msg.sessionId, workdir);
     } else {
       console.log(`[apm] step=branch skipped sessionId=${msg.sessionId}`);
     }
     let pullRan = false;
-    if (shouldRunPull(msg.sessionId)) {
+    if (shouldRunPull(msg.sessionId, workdir)) {
       if (signal.aborted) return;
-      await runStep(
-        "pull",
-        () => runPull(msg.sessionId, workspaceApmDir(msg.workdir))
-      );
-      markPullDone(msg.sessionId);
+      await runStep("pull", () => runPull(msg.sessionId, workdir));
+      markPullDone(msg.sessionId, workdir);
       pullRan = true;
     } else {
       console.log(`[apm] step=pull skipped sessionId=${msg.sessionId}`);
@@ -2021,7 +2034,7 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
       if (signal.aborted) return;
       await runStep(
         "commit-pull",
-        () => commitWorkingTreeIfDirty(msg.workdir, "fix: apm pull")
+        () => commitWorkingTreeIfDirty(workdir, "fix: apm pull")
       );
     } else {
       console.log(`[apm] step=commit-pull skipped sessionId=${msg.sessionId}`);
@@ -2037,7 +2050,7 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
           prompt: msg.content,
           model: msg.model,
           apiKey: msg.apiKey,
-          workdir: msg.workdir,
+          workdir,
           user: msg.user
         },
         { signal }
@@ -2045,11 +2058,11 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
     );
     await runStep(
       "sync-documents",
-      () => syncSessionDocuments(cfg, msg.sessionId, workspaceApmDir(msg.workdir))
+      () => syncSessionDocuments(cfg, msg.sessionId, apmRoot)
     );
     await runStep(
       "commit-files",
-      () => commitWorkingTreeIfDirty(msg.workdir, "chore(apm): commit working tree")
+      () => commitWorkingTreeIfDirty(workdir, "chore(apm): commit working tree")
     );
     await runStep(
       "status-success",
@@ -2109,7 +2122,7 @@ async function runConnect(options) {
   }
   const url = buildAgentWsUrl(cfg.baseUrl, resolveApiKey(cfg));
   console.log(`[apm] \u8FDE\u63A5 ${cfg.baseUrl} \u2026`);
-  await new Promise((resolve6, reject) => {
+  await new Promise((resolve5, reject) => {
     const ws = new WebSocket(url);
     let stopHeartbeat;
     let shuttingDown = false;
@@ -2138,7 +2151,7 @@ async function runConnect(options) {
         ]);
       } catch {
       }
-      resolve6();
+      resolve5();
       process.exit(code);
     };
     ws.on("open", () => {
@@ -2226,11 +2239,11 @@ import path5 from "node:path";
 
 // src/commands/deploy/internal/apm-config.ts
 import { existsSync as existsSync9, readFileSync as readFileSync8 } from "node:fs";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 function loadApmConfig(options) {
-  const p = resolve5(
+  const p = resolve4(
     process.cwd(),
-    options?.configPath ?? resolve5(workspaceApmDir(), "apm.config.json")
+    options?.configPath ?? resolve4(workspaceApmDir(), "apm.config.json")
   );
   if (!existsSync9(p)) {
     console.error(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\uFF1A${p}`);
@@ -2497,17 +2510,17 @@ var DockerodeClient = class {
     await this.client.getImage(image).remove({ force: true });
   }
   async pullImage(image, auth) {
-    const stream = await new Promise((resolve6, reject) => {
+    const stream = await new Promise((resolve5, reject) => {
       const pullOptions = auth ? { authconfig: auth } : void 0;
       this.client.pull(image, pullOptions, (err, output) => {
         if (err || !output) {
           reject(err ?? new Error("docker pull \u8FD4\u56DE\u7A7A\u8F93\u51FA"));
           return;
         }
-        resolve6(output);
+        resolve5(output);
       });
     });
-    await new Promise((resolve6, reject) => {
+    await new Promise((resolve5, reject) => {
       this.client.modem.followProgress(
         stream,
         (err) => {
@@ -2515,7 +2528,7 @@ var DockerodeClient = class {
             reject(err);
             return;
           }
-          resolve6();
+          resolve5();
         },
         () => void 0
       );
@@ -3006,14 +3019,14 @@ var MinioClient = class {
   async deleteObjectsByPrefix(bucket, prefix) {
     const objectsStream = this.inner.listObjectsV2(bucket, prefix, true);
     const keys = [];
-    await new Promise((resolve6, reject) => {
+    await new Promise((resolve5, reject) => {
       objectsStream.on("data", (obj) => {
         if (obj.name) {
           keys.push(obj.name);
         }
       });
       objectsStream.on("error", reject);
-      objectsStream.on("end", resolve6);
+      objectsStream.on("end", resolve5);
     });
     const chunkSize = 500;
     for (let i = 0; i < keys.length; i += chunkSize) {
@@ -3251,7 +3264,7 @@ async function ensureRemoteDir(sftp, dir) {
   }
 }
 function execCommand(client, command) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve5, reject) => {
     client.exec(command, (err, stream) => {
       if (err) return reject(err);
       let stdout = "";
@@ -3261,7 +3274,7 @@ function execCommand(client, command) {
           reject(new Error(`\u8FDC\u7A0B\u547D\u4EE4\u5931\u8D25 (${code}): ${stderr || stdout}`));
           return;
         }
-        resolve6(stdout);
+        resolve5(stdout);
       }).on("data", (data) => {
         stdout += data.toString();
       });

package/package.json

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

package/template/skills/apm-dev/SKILL.md

@@ -6,7 +6,11 @@
 
 1. 用 **Read** 工具阅读本端计划：前端读 `.apm/sessions/<会话ID>/docs/FRONTEND-PLAN.md`，后端读 `docs/BACKEND-PLAN.md`；计划不存在则退出流程并回复说明（兼容旧流程：若存在 `PRD.md` + `FRONTEND.md` / `BACKEND.md` + `API.md`，按旧文档执行）。
 2. 前端涉及接口对接时，以后端计划中的「API 契约」章节为准，**不等后端部署完成**；契约没写清的字段 `@后端` 确认，禁止自行猜测。
-3. 计划「假设」章节存在未确认项时，先 `@项目经理` 确认，确认前不开始开发。
+3. **假设门禁（开发前必须检查）**：查看计划「依据与假设」章节——
+   - 「假设」仍有未确认项：**Read** `.apm/sessions/<会话ID>/messages.xml`，查找项目经理是否已回复确认；
+   - 项目经理已回复：先按 `.apm/skills/apm-write-plan/SKILL.md` 步骤 5 把确认结果**回填进计划文档并同步**（确认的假设移入「依据」，否定的修订实现步骤与白名单），然后再开发；
+   - 项目经理未回复：`@项目经理` 列出待确认假设，**停止本次开发**。
+   严禁带着未回填的澄清直接开发——项目经理在聊天里给过的口径若没落进计划，开发与 diff 评审都不会认。
 
 ### 步骤 2: 明确开发模式
 

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

@@ -44,6 +44,20 @@
 - **无假设**：回复计划已就绪，可进入测试要点编写。
 - 前端计划依赖的接口后端契约还没出：在计划「期望接口」小节写出前端期望的接口形态，回复时 `@后端` 对齐，不要空等。
 
+### 步骤 5：假设回填（项目经理确认后必须执行）
+
+当你被安排「根据项目经理的确认更新计划」，或发现项目经理已回复假设确认时：
+
+1. **Read** `.apm/sessions/<会话ID>/messages.xml`，找到项目经理针对假设的最新回复，**逐条对照你列出的假设**，不要只看 speakContext 的转述。
+2. 更新计划文档：
+   - 被确认的假设 → **移入「依据」表格**，来源写「项目经理确认（第 N 轮）」；
+   - 被否定或修正的假设 → 按项目经理给出的口径**修订「实现步骤」与「改动文件白名单」**；
+   - 项目经理没有回应的假设 → 保留在「假设」中，再次 `@项目经理` 追问。
+3. 重新执行 `apm sync-document` 同步计划。
+4. 回复消息：逐条说明每个假设的处理结果（确认采纳 / 按口径修订了什么），全部解决则声明「假设已清零，可进入测试要点编写」。
+
+**禁止**跳过回填直接开发：澄清结论必须落进计划文档，后续开发与 diff 评审都只认计划文档，不认聊天记录。
+
 ---
 
 ## 写作要求