ai-project-manage-cli 5.0.5 → 5.0.7

package/README.md

@@ -26,7 +26,7 @@ apm init [--name=我的项目]
 
 ```bash
 apm pull <sessionId>
-apm sync-document <sessionId> --file docs/PRD.md
+apm sync-document <sessionId> --file PRD
 apm update-skills
 apm branch <sessionId>
 ```

package/dist/index.js

@@ -88,6 +88,9 @@ function sessionRulePath(sessionId, apmRoot) {
 function sessionYamlPath(sessionId, apmRoot) {
   return join2(sessionDir(sessionId, apmRoot), "session.yaml");
 }
+function sessionMessagesXmlPath(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), "messages.xml");
+}
 function documentLocalFileName(platformName) {
   const trimmed = platformName.trim();
   if (!trimmed) return "document.md";
@@ -101,6 +104,11 @@ function documentPlatformName(filePath) {
   }
   return base;
 }
+function resolveSessionDocumentPath(sessionId, documentName, apmRoot) {
+  const base = basename(documentName.trim().replace(/\\/g, "/"));
+  const fileName = documentLocalFileName(base);
+  return join2(sessionDocsDir(sessionId, apmRoot), fileName);
+}
 async function ensureLoggedConfig() {
   const cfg = await ensureApmConfig();
   if (!cfg.token) {
@@ -146,9 +154,6 @@ async function copyTemplateFiles(targetDir) {
     })
   );
 }
-function resolveCwdPath(file) {
-  return resolve(process.cwd(), file);
-}
 
 // src/commands/init.ts
 async function runInit(name) {
@@ -189,6 +194,10 @@ var requestConfig = {
       method: "GET",
       path: "/cli/sessions/members"
     }),
+    listSessionMessages: defineEndpoint({
+      method: "GET",
+      path: "/cli/messages"
+    }),
     listDocuments: defineEndpoint({
       method: "GET",
       path: "/cli/documents"
@@ -440,6 +449,48 @@ import { writeFileSync as writeFileSync4 } from "fs";
 import { join as join5 } from "path";
 import { stringify as yamlStringify } from "yaml";
 
+// src/session-messages-xml.ts
+function escapeXmlAttr(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function wrapCdata(value) {
+  return `<![CDATA[${value.replace(/]]>/g, "]]]]><![CDATA[>")}]]>`;
+}
+function optionalAttr(name, value) {
+  if (value == null || value === "") {
+    return "";
+  }
+  return ` ${name}="${escapeXmlAttr(value)}"`;
+}
+function formatSessionMessagesXml(sessionId, messages) {
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<messages sessionId="${escapeXmlAttr(sessionId)}">`
+  ];
+  for (const message of messages) {
+    const attrs = [
+      `id="${escapeXmlAttr(message.id)}"`,
+      `senderId="${escapeXmlAttr(message.senderId)}"`,
+      message.sender ? `senderName="${escapeXmlAttr(message.sender.displayName)}"` : "",
+      message.sender ? `senderPosition="${escapeXmlAttr(message.sender.position)}"` : "",
+      message.sender ? `proxyMode="${escapeXmlAttr(message.sender.proxyMode)}"` : "",
+      `status="${escapeXmlAttr(message.status)}"`,
+      `createdAt="${escapeXmlAttr(message.createdAt)}"`,
+      `contentUpdatedAt="${escapeXmlAttr(message.contentUpdatedAt)}"`
+    ].filter(Boolean).join(" ");
+    lines.push(
+      `  <message ${attrs}${optionalAttr(
+        "roundId",
+        message.roundId
+      )}${optionalAttr("sentAt", message.sentAt)}>`,
+      `    <content>${wrapCdata(message.content)}</content>`,
+      "  </message>"
+    );
+  }
+  lines.push("</messages>", "");
+  return lines.join("\n");
+}
+
 // src/commands/sync-session-attachments.ts
 import { writeFileSync as writeFileSync3 } from "fs";
 import { join as join4 } from "path";
@@ -480,12 +531,15 @@ async function runPull(sessionId, apmRoot) {
   }
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
-  const [detail, members, documents, attachments] = await Promise.all([
-    api.cli.sessionDetail({ sessionId: trimmedId }),
-    api.cli.sessionMembers({ sessionId: trimmedId }),
-    api.cli.listDocuments({ sessionId: trimmedId }),
-    api.cli.listAttachments({ sessionId: trimmedId })
-  ]);
+  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 dir = sessionDir(trimmedId, apmRoot);
   const docsDir = sessionDocsDir(trimmedId, apmRoot);
   await ensureDirExists(docsDir);
@@ -519,6 +573,11 @@ async function runPull(sessionId, apmRoot) {
 `,
     "utf8"
   );
+  writeFileSync4(
+    sessionMessagesXmlPath(trimmedId, apmRoot),
+    formatSessionMessagesXml(trimmedId, messages),
+    "utf8"
+  );
   await syncSessionAttachments(cfg, trimmedId, attachments, apmRoot);
   console.log(`[apm] \u5DF2\u540C\u6B65\u4F1A\u8BDD\u5DE5\u4F5C\u533A: ${dir}`);
   return dir;
@@ -648,12 +707,16 @@ async function runSyncDocument(sessionId, options) {
   }
   const fileArg = options.file?.trim();
   if (!fileArg) {
-    console.error("[apm] \u8BF7\u6307\u5B9A --file <\u672C\u5730\u8DEF\u5F84>");
+    console.error("[apm] \u8BF7\u6307\u5B9A --file <\u6587\u6863\u540D\u79F0>");
     process.exit(1);
   }
-  const absPath = resolveCwdPath(fileArg);
+  const absPath = resolveSessionDocumentPath(trimmedSessionId, fileArg);
   if (!existsSync3(absPath)) {
-    console.error(`[apm] \u6587\u6863\u4E0D\u5B58\u5728: ${absPath}`);
+    const docsDir = sessionDocsDir(trimmedSessionId);
+    console.error(
+      `[apm] \u6587\u6863\u4E0D\u5B58\u5728: ${absPath}
+[apm] \u8BF7\u786E\u8BA4\u5DF2 pull\uFF0C\u4E14 ${docsDir} \u4E0B\u5B58\u5728\u5BF9\u5E94\u6587\u4EF6`
+    );
     process.exit(1);
   }
   const content = readFileSync4(absPath, "utf8");
@@ -1766,7 +1829,10 @@ function buildProgram() {
   ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async (sessionId) => {
     await runPull(sessionId);
   });
-  program.command("sync-document").description("\u5C06\u672C\u5730 Markdown \u8986\u76D6\u5F0F upsert \u5230\u5E73\u53F0\u9700\u6C42\u6587\u6863").argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").requiredOption("--file <path>", "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84").action(async (sessionId, opts) => {
+  program.command("sync-document").description("\u5C06\u672C\u5730 Markdown \u8986\u76D6\u5F0F upsert \u5230\u5E73\u53F0\u9700\u6C42\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"
+  ).action(async (sessionId, opts) => {
     await runSyncDocument(sessionId, { file: opts.file });
   });
   program.command("append-message").description("\u5411\u5E73\u53F0\u4F1A\u8BDD\u6D88\u606F\u8FFD\u52A0\u5185\u5BB9\uFF08PUT /api/cli/messages/content\uFF09").requiredOption("--id <messageId>", "\u6D88\u606F ID").requiredOption("--content <content>", "\u8981\u8FFD\u52A0\u7684\u6D88\u606F\u5185\u5BB9").action(async (opts) => {

package/package.json

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

package/template/AGENTS.md

@@ -0,0 +1,22 @@
+## APM 指南
+
+### 回复消息命令
+
+- 命令: `apm append-message --id=<消息ID> --content=<消息内容>`
+- 注意事项：如果消息内容中包含文档地址，不要把前缀也写出来，直接用文档名称即可，并且文档名称要用倒引号包裹
+
+### 创建/更新群文档命令
+
+- 命令: `apm sync-document <会话ID> --file <文档名称>`
+- 注意事项：文档名称是指`.apm/sessions/<会话ID>/` 这个目录下的某个文档，参数直接文档名称，比如 PRD.md。
+
+## 工作流程
+
+- 读取 `.apm/sessions/<会话ID>/session.yaml`，必要时读取`messages.xml` 了解当前会话状态与历史消息
+- 根据用户提示找到你对应的人设(system_persona)
+- 根据人设完成用户指定的任务
+
+## 目录声明
+
+- 技能目录: ./skills
+- 群文档目录: ./sessions/<会话 ID>/docs