ai-project-manage-cli 4.0.5 → 4.0.7

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { readFileSync as readFileSync10 } from "fs";
-import { dirname as dirname2, join as join9 } from "path";
+import { dirname as dirname2, join as join10 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { Command } from "commander";
 
@@ -116,6 +116,17 @@ var requestConfig = {
       path: "/cli/requirements/update-dev-status"
     })
   },
+  requirementAttachment: {
+    list: defineEndpoint({
+      method: "GET",
+      path: "/requirement-attachments/list"
+    }),
+    download: defineEndpoint({
+      method: "GET",
+      path: "/requirement-attachments/download",
+      mode: "download"
+    })
+  },
   requirementArtifact: {
     list: defineEndpoint({
       method: "GET",
@@ -246,7 +257,7 @@ async function runComment(requirementId, file, model) {
 import { randomUUID } from "crypto";
 import WebSocket from "ws";
 import { Agent } from "@cursor/sdk";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 
 // src/session-utils.ts
 import { appendFileSync } from "fs";
@@ -381,8 +392,33 @@ ${JSON.stringify(event, null, 2)}
 };
 
 // src/commands/upload-artifact.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join3, relative, sep } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { join as join4, relative, sep } from "path";
+
+// src/commands/sync-requirement-attachments.ts
+import { existsSync as existsSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
+var REQUIREMENT_ATTACHMENTS_SUBDIR = "attachments";
+async function syncRequirementAttachments(api, requirementId, workitemsDir) {
+  const dir = join3(workitemsDir, REQUIREMENT_ATTACHMENTS_SUBDIR);
+  await ensureDirExists(dir);
+  const { items } = await api.requirementAttachment.list({ requirementId });
+  if (items.length === 0) return;
+  for (const item of items) {
+    const dest = join3(dir, item.fileName);
+    if (existsSync2(dest)) continue;
+    const { blob } = await api.requirementAttachment.download({
+      attachmentId: item.id
+    });
+    const buffer = Buffer.from(await blob.arrayBuffer());
+    writeFileSync2(dest, buffer);
+    console.log(
+      `[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${REQUIREMENT_ATTACHMENTS_SUBDIR}/${item.fileName}`
+    );
+  }
+}
+
+// src/commands/upload-artifact.ts
 var EXCLUDED_RELATIVE_PATHS = /* @__PURE__ */ new Set([
   "defect.xml",
   "prd.md",
@@ -406,7 +442,8 @@ function* walkMarkdownFiles(dir) {
   const names = readdirSync2(dir);
   for (const name of names) {
     if (name.startsWith(".")) continue;
-    const full = join3(dir, name);
+    if (name === REQUIREMENT_ATTACHMENTS_SUBDIR) continue;
+    const full = join4(dir, name);
     const st = statSync2(full);
     if (st.isDirectory()) {
       yield* walkMarkdownFiles(full);
@@ -421,7 +458,7 @@ async function runUploadArtifact(requirementId, workspaceDir) {
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
   const root = requirementWorkitemsDir(requirementId, workspaceDir);
-  if (!existsSync2(root)) {
+  if (!existsSync3(root)) {
     console.error(
       `[apm] \u76EE\u5F55\u4E0D\u5B58\u5728: ${root}
 \u8BF7\u5148\u6267\u884C: apm pull ${requirementId}`
@@ -444,8 +481,8 @@ async function runUploadArtifact(requirementId, workspaceDir) {
 }
 
 // src/commands/pull.ts
-import { writeFileSync as writeFileSync2 } from "fs";
-import { join as join4 } from "path";
+import { writeFileSync as writeFileSync3 } from "fs";
+import { join as join5 } from "path";
 import { stringify as yamlStringify } from "yaml";
 var PULL_ARTIFACT_FILE_NAMES = ["api.md", "backend.md"];
 function normalizeArtifactPath(fileName) {
@@ -555,13 +592,13 @@ async function runPull(requirementId, workspaceDir) {
     },
     { lineWidth: 0 }
   );
-  writeFileSync2(
-    join4(WORKITEMS_DIR, "requirement-status.yaml"),
+  writeFileSync3(
+    join5(WORKITEMS_DIR, "requirement-status.yaml"),
     statusYaml.endsWith("\n") ? statusYaml : `${statusYaml}
 `,
     "utf8"
   );
-  writeFileSync2(join4(WORKITEMS_DIR, "prd.md"), req2.content || "", "utf8");
+  writeFileSync3(join5(WORKITEMS_DIR, "prd.md"), req2.content || "", "utf8");
   const reviews = data.reviews ?? [];
   const reviewsXml = [
     "<reviews>",
@@ -581,15 +618,15 @@ async function runPull(requirementId, workspaceDir) {
     "</reviews>",
     ""
   ].join("\n");
-  writeFileSync2(join4(WORKITEMS_DIR, "reviews.xml"), reviewsXml, "utf8");
+  writeFileSync3(join5(WORKITEMS_DIR, "reviews.xml"), reviewsXml, "utf8");
   const defectsXml = defectsToXml(data.defects ?? []);
-  writeFileSync2(join4(WORKITEMS_DIR, "defect.xml"), defectsXml, "utf8");
+  writeFileSync3(join5(WORKITEMS_DIR, "defect.xml"), defectsXml, "utf8");
   const testCasesXml = unknownArrayToXml(
     "testcases",
     "case",
     data.testCases ?? []
   );
-  writeFileSync2(join4(WORKITEMS_DIR, "testcase.xml"), testCasesXml, "utf8");
+  writeFileSync3(join5(WORKITEMS_DIR, "testcase.xml"), testCasesXml, "utf8");
   for (const fileName of PULL_ARTIFACT_FILE_NAMES) {
     const content = await fetchArtifactContentByFileName(
       api,
@@ -597,9 +634,10 @@ async function runPull(requirementId, workspaceDir) {
       fileName
     );
     if (content !== null) {
-      writeFileSync2(join4(WORKITEMS_DIR, fileName), content, "utf8");
+      writeFileSync3(join5(WORKITEMS_DIR, fileName), content, "utf8");
     }
   }
+  await syncRequirementAttachments(api, requirementId, WORKITEMS_DIR);
   return WORKITEMS_DIR;
 }
 
@@ -646,7 +684,7 @@ function runConnect(opts) {
           return;
         }
         const payload = msg.payload;
-        const apmRoot = join5(payload.cwd, ".apm");
+        const apmRoot = join6(payload.cwd, ".apm");
         console.log("[apm] ROOT:", apmRoot);
         console.log("[apm] workflow node:", payload.nodeId);
         try {
@@ -734,8 +772,12 @@ function runConnect(opts) {
           nodeId: payload.nodeId
         });
         console.log("[apm] \u5DE5\u4F5C\u6D41\u8282\u70B9\u72B6\u6001:", confirmResult.nodeStatus);
-      } catch {
-        console.error("[apm] \u65E0\u6CD5\u89E3\u6790 WebSocket \u6D88\u606F:", text);
+      } catch (err) {
+        console.error(
+          "[apm] \u65E0\u6CD5\u89E3\u6790 WebSocket \u6D88\u606F:",
+          text,
+          err.message
+        );
       }
     });
     ws.on("error", (err) => {
@@ -749,17 +791,17 @@ function runConnect(opts) {
 }
 
 // src/commands/init.ts
-import { join as join6 } from "path";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { join as join7 } from "path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
 async function runInit(name) {
   await ensureWorkspaceApmDirForInit();
   await copyTemplateFiles(WORKSPACE_APM_DIR);
   if (name) {
-    const apmConfigPath = join6(WORKSPACE_APM_DIR, "apm.config.json");
+    const apmConfigPath = join7(WORKSPACE_APM_DIR, "apm.config.json");
     const config = readFileSync4(apmConfigPath, "utf8");
     const configJson = JSON.parse(config);
     configJson.name = name;
-    writeFileSync3(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
+    writeFileSync4(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
   }
 }
 
@@ -954,10 +996,10 @@ async function runBranch(requirementId, options = {}) {
 
 // src/commands/refine.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 async function runRefine(requirementId) {
   const cfg = await ensureLoggedConfig();
-  const filePath = join7(WORKSPACE_APM_DIR, "workitems", requirementId, "prd.md");
+  const filePath = join8(WORKSPACE_APM_DIR, "workitems", requirementId, "prd.md");
   const content = readFileSync5(filePath, "utf8");
   const api = createApmApiClient(cfg);
   const data = await api.cliRequirements.refine({ requirementId, content });
@@ -990,14 +1032,14 @@ async function runUpdateStatus(requirementId, status) {
 import path5 from "node:path";
 
 // src/commands/deploy/internal/apm-config.ts
-import { existsSync as existsSync3, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync6 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
 function loadApmConfig(options) {
   const p = resolve4(
     process.cwd(),
     options?.configPath ?? resolve4(WORKSPACE_APM_DIR, "apm.config.json")
   );
-  if (!existsSync3(p)) {
+  if (!existsSync4(p)) {
     console.error(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\uFF1A${p}`);
     process.exit(1);
   }
@@ -1101,7 +1143,7 @@ import path4 from "node:path";
 import Docker from "dockerode";
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/connection-options.ts
-import { existsSync as existsSync4, readFileSync as readFileSync7 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync7 } from "node:fs";
 import path from "node:path";
 function asOptionalTlsBuffer(value) {
   if (typeof value !== "string") {
@@ -1113,7 +1155,7 @@ function asOptionalTlsBuffer(value) {
   if (normalized === "") {
     return void 0;
   }
-  if (existsSync4(normalized)) {
+  if (existsSync5(normalized)) {
     return readFileSync7(normalized);
   }
   const looksLikePath = /[\\/]/.test(normalized) || normalized.endsWith(".pem");
@@ -1324,7 +1366,7 @@ var DockerodeClient = class {
 var createDockerodeClient = (config) => new DockerodeClient(config);
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/env.ts
-import { existsSync as existsSync5, readFileSync as readFileSync8, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync8, statSync as statSync3 } from "node:fs";
 import path2 from "node:path";
 function stripSurroundingQuotes(value) {
   const t = value.trim();
@@ -1341,7 +1383,7 @@ function loadEnvFromFile(envFilePath) {
     return {};
   }
   const targetPath = path2.resolve(envFilePath);
-  if (!existsSync5(targetPath) || !statSync3(targetPath).isFile()) {
+  if (!existsSync6(targetPath) || !statSync3(targetPath).isFile()) {
     return {};
   }
   const raw = readFileSync8(targetPath, "utf-8");
@@ -1515,12 +1557,12 @@ function dockerPushImage(params, cwd) {
 }
 
 // src/commands/deploy/internal/backend-deploy/resolve-dockerfile.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 import path3 from "node:path";
 function resolveDockerBuildPaths(cwd) {
   const dockerfilePath = path3.join(cwd, "Dockerfile");
   Logger.info(`\u67E5\u627EDockerfile\u6587\u4EF6\uFF0C\u8DEF\u5F84: ${dockerfilePath}`);
-  if (!existsSync6(dockerfilePath)) {
+  if (!existsSync7(dockerfilePath)) {
     throw new Error(`Dockerfile \u4E0D\u5B58\u5728\uFF1A${dockerfilePath}`);
   }
   Logger.info("\u2713 Dockerfile \u5B58\u5728");
@@ -1649,11 +1691,11 @@ import { copyFile, readdir as readdir2, stat } from "node:fs/promises";
 import path7 from "node:path";
 
 // src/commands/deploy/internal/load-apm-dotenv.ts
-import { existsSync as existsSync7, readFileSync as readFileSync9 } from "node:fs";
-import { join as join8 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
+import { join as join9 } from "node:path";
 function loadApmDotEnvIfPresent() {
-  const p = join8(WORKSPACE_APM_DIR, ".env");
-  if (!existsSync7(p)) {
+  const p = join9(WORKSPACE_APM_DIR, ".env");
+  if (!existsSync8(p)) {
     return;
   }
   let text;
@@ -2017,7 +2059,7 @@ function registerDeployCommands(program) {
 function readCliVersion() {
   try {
     const dir = dirname2(fileURLToPath2(import.meta.url));
-    const pkgPath = join9(dir, "..", "package.json");
+    const pkgPath = join10(dir, "..", "package.json");
     const pkg = JSON.parse(readFileSync10(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
@@ -2032,22 +2074,24 @@ function buildProgram() {
   ).version(readCliVersion(), "-V, --version", "\u663E\u793A\u7248\u672C\u53F7").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9").showHelpAfterError(true);
   program.command("login").description(
     "\u8C03\u7528 POST /api/auth/login\uFF0C\u5C06 token \u5199\u5165 ~/.config/apm/config.json"
-  ).requiredOption("--email <\u90AE\u7BB1>", "\u767B\u5F55\u90AE\u7BB1").requiredOption("--password <\u5BC6\u7801>", "\u767B\u5F55\u5BC6\u7801").option("--server <url>", "API \u6839\u5730\u5740\uFF0C\u4F8B\u5982 http://127.0.0.1:3000").action(async (opts) => {
-    await runLogin(opts);
-  });
+  ).requiredOption("--email <\u90AE\u7BB1>", "\u767B\u5F55\u90AE\u7BB1").requiredOption("--password <\u5BC6\u7801>", "\u767B\u5F55\u5BC6\u7801").option("--server <url>", "API \u6839\u5730\u5740\uFF0C\u4F8B\u5982 http://127.0.0.1:3000").action(
+    async (opts) => {
+      await runLogin(opts);
+    }
+  );
   program.command("connect").description("\u8FDE\u63A5 WebSocket /ws/agent\uFF0C\u5E76\u6309\u56FA\u5B9A\u95F4\u9694\u53D1\u9001 HEARTBEAT").option("--server <url>", "API \u6839\u5730\u5740\uFF08\u5199\u5165\u672C\u5730\u914D\u7F6E\uFF09").action((opts) => {
     runConnect(opts);
   });
-  program.command("init").description(
-    "\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u521D\u59CB\u5316 .apm \u6A21\u677F\uFF08\u82E5 .apm \u5DF2\u5B58\u5728\u4E14\u975E\u7A7A\u5219\u62A5\u9519\uFF09"
-  ).option("--name <name>", "\u5DE5\u4F5C\u76EE\u5F55\u540D\u79F0").action(async (opts) => {
+  program.command("init").description("\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u521D\u59CB\u5316 .apm \u6A21\u677F\uFF08\u82E5 .apm \u5DF2\u5B58\u5728\u4E14\u975E\u7A7A\u5219\u62A5\u9519\uFF09").option("--name <name>", "\u5DE5\u4F5C\u76EE\u5F55\u540D\u79F0").action(async (opts) => {
     await runInit(opts.name);
   });
-  program.command("pull").description("GET /api/cli/requirements/pull\uFF0C\u540C\u6B65\u6570\u636E\u5230 .apm \u76EE\u5F55").argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
+  program.command("pull").description(
+    "GET /api/cli/requirements/pull\uFF0C\u540C\u6B65\u6570\u636E\u4E0E\u9644\u4EF6\u5230 .apm/workitems/<\u9700\u6C42ID>"
+  ).argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
     await runPull(requirementId);
   });
   program.command("upload-artifact").description(
-    "\u5148\u6E05\u7A7A\u8BE5\u9700\u6C42\u5728\u5E73\u53F0\u4E0A\u7684\u4EA7\u7269\u6587\u6863\uFF0C\u518D\u5C06 .apm/workitems/<\u9700\u6C42ID> \u4E0B Markdown \u540C\u6B65\u4E0A\u53BB\uFF08\u6392\u9664 pull \u7CFB\u7EDF\u6587\u4EF6\uFF09"
+    "\u5148\u6E05\u7A7A\u8BE5\u9700\u6C42\u5728\u5E73\u53F0\u4E0A\u7684\u4EA7\u7269\u6587\u6863\uFF0C\u518D\u5C06 .apm/workitems/<\u9700\u6C42ID> \u4E0B Markdown \u540C\u6B65\u4E0A\u53BB\uFF08\u6392\u9664 pull \u7CFB\u7EDF\u6587\u4EF6\u4E0E attachments \u76EE\u5F55\uFF09"
   ).argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
     await runUploadArtifact(requirementId);
   });
@@ -2056,11 +2100,9 @@ function buildProgram() {
   ).argument("<requirementId>", "\u9700\u6C42 ID").option(
     "-m, --message <text>",
     "\u5DF2\u5728\u76EE\u6807\u5206\u652F\u4E14\u9700\u63D0\u4EA4\u672C\u5730\u6539\u52A8\u65F6\u4F7F\u7528\u7684\u63D0\u4EA4\u8BF4\u660E\uFF08\u9ED8\u8BA4\u81EA\u52A8\u751F\u6210\uFF09"
-  ).action(
-    async (requirementId, opts) => {
-      await runBranch(requirementId, { message: opts.message });
-    }
-  );
+  ).action(async (requirementId, opts) => {
+    await runBranch(requirementId, { message: opts.message });
+  });
   program.command("comment").description("POST /api/cli/requirements/comment\uFF08\u6B63\u6587\u6765\u81EA\u6587\u4EF6\uFF09").argument("<requirementId>", "\u9700\u6C42 ID").requiredOption("--file <path>", "\u8BC4\u8BBA\u6B63\u6587\u6587\u4EF6\u8DEF\u5F84").option("--model <model>", "\u8BC4\u8BBA\u6A21\u578B").action(
     async (requirementId, options) => {
       await runComment(requirementId, options.file, options.model);

package/package.json

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

package/template/workitems/README.md

@@ -10,10 +10,11 @@ workitems/<需求 ID>
 
 - `status.yaml`: 需求的状态（包含当前的分支名称，需求状态，缺陷列表及状态）
 - `prd.md`: pull 后写入的需求聚合正文
+- `attachments/`: pull 后从平台同步的需求附件（本地已存在则跳过下载）
 - `reviews.xml`: pull 后写入的评论与回复
 - `defect.xml`: 缺陷信息
 - `testcase.xml`: 测试用例占位数据
 - `change.md`: 代码变更信息
 - `specs/proposal.md`: 提议
 - `specs/tasks.md`: 任务
-- `specs/`
+- `specs/`