ai-project-manage-cli 7.1.15 → 7.1.16

package/dist/index.js

@@ -184,6 +184,10 @@ var init_request_config = __esm({
           method: "GET",
           path: "/cli/webide/assumptions"
         }),
+        webideListAttachments: defineEndpoint({
+          method: "GET",
+          path: "/cli/webide/attachments"
+        }),
         webideRecommendPlan: defineEndpoint({
           method: "PUT",
           path: "/cli/webide/plan-recommendation"
@@ -220,10 +224,12 @@ var init_request_config = __esm({
           method: "GET",
           path: "/cli/tasks/branch-baseline"
         }),
-        projectBaseBranch: defineEndpoint({
-          method: "GET",
-          path: "/cli/tasks/project-base-branch"
-        }),
+        projectBaseBranch: defineEndpoint(
+          {
+            method: "GET",
+            path: "/cli/tasks/project-base-branch"
+          }
+        ),
         listSessionsForBranchCleanup: defineEndpoint({
           method: "GET",
           path: "/cli/sessions/branch-cleanup"
@@ -2498,7 +2504,9 @@ import { join as join6 } from "path";
 var MANIFEST_FILE2 = ".sync-manifest.json";
 async function downloadAttachment(cfg, attachmentId) {
   const base = cfg.baseUrl.trim().replace(/\/+$/, "");
-  const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({ attachmentId })}`;
+  const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({
+    attachmentId
+  })}`;
   const res = await fetch(url);
   if (!res.ok) {
     throw new Error(
@@ -2537,24 +2545,23 @@ function isAttachmentUpToDate(entry, item, dest) {
   const createdAt = item.createdAt ?? "";
   return entry.createdAt === createdAt;
 }
-async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
-  const dir = join6(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
   await ensureDirExists(dir);
   if (attachments.length === 0) {
     saveManifest(dir, { version: 1, attachments: {} });
-    return;
+    return [];
   }
   const manifest = loadManifest(dir);
   const nextManifest = { version: 1, attachments: {} };
+  const names = [];
   for (const item of attachments) {
     const dest = join6(dir, item.name);
     const entry = manifest.attachments[item.id];
     const createdAt = item.createdAt ?? "";
+    names.push(item.name);
     if (isAttachmentUpToDate(entry, item, dest)) {
       nextManifest.attachments[item.id] = entry;
-      console.log(
-        `[apm] \u9644\u4EF6\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: ${SESSION_ATTACHMENTS_SUBDIR}/${item.name}`
-      );
+      console.log(`[apm] \u9644\u4EF6\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: ${logLabel}/${item.name}`);
       continue;
     }
     const buffer = await downloadAttachment(cfg, item.id);
@@ -2563,9 +2570,19 @@ async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
       name: item.name,
       createdAt
     };
-    console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${SESSION_ATTACHMENTS_SUBDIR}/${item.name}`);
+    console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${logLabel}/${item.name}`);
   }
   saveManifest(dir, nextManifest);
+  return names;
+}
+async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
+  const dir = join6(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+  return syncAttachmentsToDirectory(
+    cfg,
+    attachments,
+    dir,
+    SESSION_ATTACHMENTS_SUBDIR
+  );
 }
 
 // src/rules-sync.ts

package/dist/webide-message-worker.js

@@ -88,6 +88,10 @@ var requestConfig = {
       method: "GET",
       path: "/cli/webide/assumptions"
     }),
+    webideListAttachments: defineEndpoint({
+      method: "GET",
+      path: "/cli/webide/attachments"
+    }),
     webideRecommendPlan: defineEndpoint({
       method: "PUT",
       path: "/cli/webide/plan-recommendation"
@@ -124,10 +128,12 @@ var requestConfig = {
       method: "GET",
       path: "/cli/tasks/branch-baseline"
     }),
-    projectBaseBranch: defineEndpoint({
-      method: "GET",
-      path: "/cli/tasks/project-base-branch"
-    }),
+    projectBaseBranch: defineEndpoint(
+      {
+        method: "GET",
+        path: "/cli/tasks/project-base-branch"
+      }
+    ),
     listSessionsForBranchCleanup: defineEndpoint({
       method: "GET",
       path: "/cli/sessions/branch-cleanup"
@@ -591,6 +597,14 @@ function assertApmGitignoredInRepo(workdir) {
     );
   }
 }
+var SESSION_ATTACHMENTS_SUBDIR = "attachments";
+var WEBIDE_SUBDIR = "webide";
+function webideTaskDir(taskId, workdir) {
+  return join2(workdir, ".apm", WEBIDE_SUBDIR, taskId);
+}
+function webideAttachmentsDir(taskId, workdir) {
+  return join2(webideTaskDir(taskId, workdir), SESSION_ATTACHMENTS_SUBDIR);
+}
 async function ensureLoggedConfig() {
   const cfg = await ensureApmConfig();
   if (!resolveApiKey(cfg)) {
@@ -3087,21 +3101,108 @@ async function syncWorkspaceSkills(cfg, workdir) {
   );
 }
 
-// src/commands/connect/cli-version-sync.ts
+// src/commands/sync-session-attachments.ts
 import { existsSync as existsSync8, readFileSync as readFileSync9, writeFileSync as writeFileSync10 } from "fs";
 import { join as join11 } from "path";
+var MANIFEST_FILE2 = ".sync-manifest.json";
+async function downloadAttachment(cfg, attachmentId) {
+  const base = cfg.baseUrl.trim().replace(/\/+$/, "");
+  const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({
+    attachmentId
+  })}`;
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(
+      `[apm] \u4E0B\u8F7D\u9644\u4EF6\u5931\u8D25 (${res.status}): attachmentId=${attachmentId}`
+    );
+  }
+  return Buffer.from(await res.arrayBuffer());
+}
+function loadManifest(dir) {
+  const path = join11(dir, MANIFEST_FILE2);
+  if (!existsSync8(path)) {
+    return { version: 1, attachments: {} };
+  }
+  try {
+    const parsed = JSON.parse(
+      readFileSync9(path, "utf8")
+    );
+    if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
+      return parsed;
+    }
+  } catch {
+  }
+  return { version: 1, attachments: {} };
+}
+function saveManifest(dir, manifest) {
+  writeFileSync10(
+    join11(dir, MANIFEST_FILE2),
+    `${JSON.stringify(manifest, null, 2)}
+`,
+    "utf8"
+  );
+}
+function isAttachmentUpToDate(entry, item, dest) {
+  if (!entry || !existsSync8(dest)) return false;
+  if (entry.name !== item.name) return false;
+  const createdAt = item.createdAt ?? "";
+  return entry.createdAt === createdAt;
+}
+async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
+  await ensureDirExists(dir);
+  if (attachments.length === 0) {
+    saveManifest(dir, { version: 1, attachments: {} });
+    return [];
+  }
+  const manifest = loadManifest(dir);
+  const nextManifest = { version: 1, attachments: {} };
+  const names = [];
+  for (const item of attachments) {
+    const dest = join11(dir, item.name);
+    const entry = manifest.attachments[item.id];
+    const createdAt = item.createdAt ?? "";
+    names.push(item.name);
+    if (isAttachmentUpToDate(entry, item, dest)) {
+      nextManifest.attachments[item.id] = entry;
+      console.log(`[apm] \u9644\u4EF6\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: ${logLabel}/${item.name}`);
+      continue;
+    }
+    const buffer = await downloadAttachment(cfg, item.id);
+    writeFileSync10(dest, buffer);
+    nextManifest.attachments[item.id] = {
+      name: item.name,
+      createdAt
+    };
+    console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${logLabel}/${item.name}`);
+  }
+  saveManifest(dir, nextManifest);
+  return names;
+}
+async function syncWebIdeAttachments(cfg, taskId, workdir, attachments) {
+  const dir = webideAttachmentsDir(taskId, workdir);
+  return syncAttachmentsToDirectory(
+    cfg,
+    attachments,
+    dir,
+    `.apm/webide/${taskId}/attachments`
+  );
+}
+
+// src/commands/connect/cli-version-sync.ts
+import { existsSync as existsSync9, readFileSync as readFileSync10, writeFileSync as writeFileSync11 } from "fs";
+import { join as join12 } from "path";
 var CLI_VERSION_FILE = ".cli-version.json";
 function manifestPath2(apmDir) {
-  return join11(apmDir, CLI_VERSION_FILE);
+  return join12(apmDir, CLI_VERSION_FILE);
 }
-function loadManifest(apmDir) {
+function loadManifest2(apmDir) {
   const path = toFsPath(manifestPath2(apmDir));
-  if (!existsSync8(path)) {
+  if (!existsSync9(path)) {
     return null;
   }
   try {
     const parsed = JSON.parse(
-      readFileSync9(path, "utf8")
+      readFileSync10(path, "utf8")
     );
     if (parsed?.version === 1 && typeof parsed.cliVersion === "string" && parsed.cliVersion.trim()) {
       return parsed;
@@ -3110,9 +3211,9 @@ function loadManifest(apmDir) {
   }
   return null;
 }
-function saveManifest(apmDir, cliVersion) {
+function saveManifest2(apmDir, cliVersion) {
   const manifest = { version: 1, cliVersion };
-  writeFileSync10(
+  writeFileSync11(
     toFsPath(manifestPath2(apmDir)),
     `${JSON.stringify(manifest, null, 2)}
 `,
@@ -3125,7 +3226,7 @@ function shouldSyncSkillsForCliVersion(workdir, currentVersion) {
   if (cached === currentVersion) {
     return false;
   }
-  const stored = loadManifest(workspaceApmDir(workdir));
+  const stored = loadManifest2(workspaceApmDir(workdir));
   if (stored?.cliVersion === currentVersion) {
     syncedInSession.set(workdir, currentVersion);
     return false;
@@ -3133,7 +3234,7 @@ function shouldSyncSkillsForCliVersion(workdir, currentVersion) {
   return true;
 }
 function markSkillsSyncedForCliVersion(workdir, cliVersion) {
-  saveManifest(workspaceApmDir(workdir), cliVersion);
+  saveManifest2(workspaceApmDir(workdir), cliVersion);
   syncedInSession.set(workdir, cliVersion);
 }
 
@@ -3206,6 +3307,27 @@ async function handleWebIdeInboundMessage(cfg, msg, signal, options) {
       if (signal.aborted) throw new Error("\u4EFB\u52A1\u5DF2\u53D6\u6D88");
       await ensureWebIdePullRequests(cfg, taskId, workdir);
     }
+    if (signal.aborted) throw new Error("\u4EFB\u52A1\u5DF2\u53D6\u6D88");
+    const api = createApmApiClient(cfg);
+    try {
+      const attachments = await api.cli.webideListAttachments({ taskId });
+      const names = await syncWebIdeAttachments(
+        cfg,
+        taskId,
+        workdir,
+        attachments ?? []
+      );
+      if (names.length > 0) {
+        console.log(
+          `[apm] webide \u9644\u4EF6\u5DF2\u5C31\u7EEA count=${names.length} dir=.apm/webide/${taskId}/attachments`
+        );
+      }
+    } catch (err) {
+      console.warn(
+        "[apm] WebIDE \u9644\u4EF6\u540C\u6B65\u5931\u8D25:",
+        err instanceof Error ? err.message : err
+      );
+    }
     const savedAgentId = loadWebIdeAgentId(workdir, taskId);
     const logSyncRef = { current: null };
     const outcome = await runCursorAgent(
@@ -3272,7 +3394,6 @@ async function handleWebIdeInboundMessage(cfg, msg, signal, options) {
       result: outcome.result,
       createPlan: outcome.createPlan
     });
-    const api = createApmApiClient(cfg);
     await api.cli.webideEnsureMessageContent({
       id: messageId,
       content: fallback

package/package.json

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

package/template/AGENTS.md

@@ -40,6 +40,7 @@
   - 任务涉及菜单名、路由、业务术语等时，**先 Read manifest 与相关文档**，禁止猜测路径
 
 - 本轮任务需要关注的文档指引（.apm/sessions/<会话 ID>/\*）:
+
   - 本轮会话状态: `session.yaml`，从这里可以看到每个成员的信息，找到可以协助你一起解决问题的人，可以结合 `RULE.md`一起看
   - 群文档: `docs/xxxx.md`，当需要相关上下文可以在这里查找，按需阅读
   - 附件列表: `attachments/*`，当有文档中提及附件时，从这里查找
@@ -47,3 +48,6 @@
   - 协作 TODO: `TODO.md`，跨轮次任务清单（待办与已完成项），按需阅读
   - 历史消息记录: `messages.xml`，历史消息列表，数据量很大，按需阅读
   - 初始目标: `TASK.md`，最初的目标，不一定具体，团队成员会有人负责让这个任务变得具体，仅供参考。如果你是相关的角色，则你需要先读取这个目标，然后规划接下来的动作。
+
+- WebIDE 任务附件（`.apm/webide/<taskId>/attachments/`）:
+  - `apm connect` 处理 webide-message 时会自动同步；prompt 中若出现「任务附件」指引，请按路径查看相关文件