ai-project-manage-cli 5.0.12 → 5.0.14

package/dist/index.js

@@ -499,8 +499,9 @@ function formatSessionMessagesXml(sessionId, messages) {
 }
 
 // src/commands/sync-session-attachments.ts
-import { writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join4 } from "path";
+var MANIFEST_FILE = ".sync-manifest.json";
 async function downloadAttachment(cfg, sessionId, attachmentId) {
   const base = cfg.baseUrl.trim().replace(/\/+$/, "");
   const q = new URLSearchParams({ sessionId, attachmentId });
@@ -515,16 +516,65 @@ async function downloadAttachment(cfg, sessionId, attachmentId) {
   }
   return Buffer.from(await res.arrayBuffer());
 }
+function loadManifest(dir) {
+  const path8 = join4(dir, MANIFEST_FILE);
+  if (!existsSync2(path8)) {
+    return { version: 1, attachments: {} };
+  }
+  try {
+    const parsed = JSON.parse(
+      readFileSync3(path8, "utf8")
+    );
+    if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
+      return parsed;
+    }
+  } catch {
+  }
+  return { version: 1, attachments: {} };
+}
+function saveManifest(dir, manifest) {
+  writeFileSync3(
+    join4(dir, MANIFEST_FILE),
+    `${JSON.stringify(manifest, null, 2)}
+`,
+    "utf8"
+  );
+}
+function isAttachmentUpToDate(entry, item, dest) {
+  if (!entry || !existsSync2(dest)) return false;
+  if (entry.name !== item.name) return false;
+  const createdAt = item.createdAt ?? "";
+  return entry.createdAt === createdAt;
+}
 async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
-  if (attachments.length === 0) return;
   const dir = join4(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
   await ensureDirExists(dir);
+  if (attachments.length === 0) {
+    saveManifest(dir, { version: 1, attachments: {} });
+    return;
+  }
+  const manifest = loadManifest(dir);
+  const nextManifest = { version: 1, attachments: {} };
   for (const item of attachments) {
     const dest = join4(dir, item.name);
+    const entry = manifest.attachments[item.id];
+    const createdAt = item.createdAt ?? "";
+    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}`
+      );
+      continue;
+    }
     const buffer = await downloadAttachment(cfg, sessionId, item.id);
     writeFileSync3(dest, buffer);
+    nextManifest.attachments[item.id] = {
+      name: item.name,
+      createdAt
+    };
     console.log(`[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${SESSION_ATTACHMENTS_SUBDIR}/${item.name}`);
   }
+  saveManifest(dir, nextManifest);
 }
 
 // src/commands/pull.ts
@@ -592,7 +642,7 @@ async function runPull(sessionId, apmRoot) {
 import { spawnSync } from "child_process";
 
 // src/version.ts
-import { readFileSync as readFileSync3 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import { dirname as dirname2, join as join6 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var CLI_PACKAGE_NAME = "ai-project-manage-cli";
@@ -600,7 +650,7 @@ function readCliVersion() {
   try {
     const dir = dirname2(fileURLToPath2(import.meta.url));
     const pkgPath = join6(dir, "..", "package.json");
-    const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
+    const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -667,14 +717,14 @@ async function runUpdate() {
 }
 
 // src/commands/update-skills.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync4, statSync as statSync3 } from "fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync4, statSync as statSync3 } from "fs";
 import { join as join8 } from "path";
 
 // src/skills-sync.ts
 import {
   copyFileSync,
   cpSync as cpSync2,
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   mkdirSync as mkdirSync3,
   readdirSync as readdirSync2,
   rmSync,
@@ -690,14 +740,14 @@ function sanitizeSkillDirName(name) {
   return trimmed.replace(/[/\\:*?"<>|]/g, "_");
 }
 function listBaseSkillDirNames() {
-  if (!existsSync2(BASE_SKILLS_TEMPLATE_DIR)) return [];
+  if (!existsSync3(BASE_SKILLS_TEMPLATE_DIR)) return [];
   return readdirSync2(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
     const path8 = join7(BASE_SKILLS_TEMPLATE_DIR, name);
     return statSync2(path8).isDirectory();
   });
 }
 function syncAgentsGuide(apmDir) {
-  if (!existsSync2(AGENTS_TEMPLATE_PATH)) return false;
+  if (!existsSync3(AGENTS_TEMPLATE_PATH)) return false;
   mkdirSync3(apmDir, { recursive: true });
   copyFileSync(AGENTS_TEMPLATE_PATH, join7(apmDir, "AGENTS.md"));
   return true;
@@ -730,7 +780,7 @@ function syncSupplementarySkills(skillsDir, list) {
     written.push(dirName);
   }
   const removed = [];
-  if (!existsSync2(skillsDir)) return { written, skipped, removed };
+  if (!existsSync3(skillsDir)) return { written, skipped, removed };
   for (const entry of readdirSync2(skillsDir)) {
     const full = join7(skillsDir, entry);
     if (!statSync2(full).isDirectory()) continue;
@@ -745,7 +795,7 @@ function syncSupplementarySkills(skillsDir, list) {
 // src/commands/update-skills.ts
 async function runUpdateSkills() {
   const apmDir = workspaceApmDir();
-  if (!existsSync3(apmDir)) {
+  if (!existsSync4(apmDir)) {
     console.error("[apm] \u672A\u627E\u5230 .apm \u76EE\u5F55\uFF0C\u8BF7\u5148\u6267\u884C apm init");
     process.exit(1);
   }
@@ -786,7 +836,7 @@ async function runUpdateSkills() {
 }
 
 // src/commands/sync-document.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
 async function runSyncDocument(sessionId, options) {
   const trimmedSessionId = sessionId.trim();
   if (!trimmedSessionId) {
@@ -799,7 +849,7 @@ async function runSyncDocument(sessionId, options) {
     process.exit(1);
   }
   const absPath = resolveSessionDocumentPath(trimmedSessionId, fileArg);
-  if (!existsSync4(absPath)) {
+  if (!existsSync5(absPath)) {
     const docsDir = sessionDocsDir(trimmedSessionId);
     console.error(
       `[apm] \u6587\u6863\u4E0D\u5B58\u5728: ${absPath}
@@ -807,7 +857,7 @@ async function runSyncDocument(sessionId, options) {
     );
     process.exit(1);
   }
-  const content = readFileSync4(absPath, "utf8");
+  const content = readFileSync5(absPath, "utf8");
   const name = documentPlatformName(absPath);
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
@@ -1156,19 +1206,19 @@ async function runConnect(options) {
 import path5 from "node:path";
 
 // src/commands/deploy/internal/apm-config.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
 function loadApmConfig(options) {
   const p = resolve4(
     process.cwd(),
     options?.configPath ?? resolve4(workspaceApmDir(), "apm.config.json")
   );
-  if (!existsSync5(p)) {
+  if (!existsSync6(p)) {
     console.error(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\uFF1A${p}`);
     process.exit(1);
   }
   try {
-    const raw = readFileSync5(p, "utf8");
+    const raw = readFileSync6(p, "utf8");
     return JSON.parse(raw);
   } catch (e) {
     console.error(`\u65E0\u6CD5\u89E3\u6790 apm.config.json\uFF1A${p}`, e);
@@ -1265,7 +1315,7 @@ import path4 from "node:path";
 import Docker from "dockerode";
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/connection-options.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "node:fs";
 import path from "node:path";
 function asOptionalTlsBuffer(value) {
   if (typeof value !== "string") {
@@ -1277,8 +1327,8 @@ function asOptionalTlsBuffer(value) {
   if (normalized === "") {
     return void 0;
   }
-  if (existsSync6(normalized)) {
-    return readFileSync6(normalized);
+  if (existsSync7(normalized)) {
+    return readFileSync7(normalized);
   }
   const looksLikePath = /[\\/]/.test(normalized) || normalized.endsWith(".pem");
   if (looksLikePath) {
@@ -1488,7 +1538,7 @@ var DockerodeClient = class {
 var createDockerodeClient = (config) => new DockerodeClient(config);
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/env.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync8, readFileSync as readFileSync8, statSync as statSync4 } from "node:fs";
 import path2 from "node:path";
 function stripSurroundingQuotes(value) {
   const t = value.trim();
@@ -1505,10 +1555,10 @@ function loadEnvFromFile(envFilePath) {
     return {};
   }
   const targetPath = path2.resolve(envFilePath);
-  if (!existsSync7(targetPath) || !statSync4(targetPath).isFile()) {
+  if (!existsSync8(targetPath) || !statSync4(targetPath).isFile()) {
     return {};
   }
-  const raw = readFileSync7(targetPath, "utf-8");
+  const raw = readFileSync8(targetPath, "utf-8");
   const result = {};
   for (const line of raw.split(/\r?\n/)) {
     const normalized = line.trim();
@@ -1679,12 +1729,12 @@ function dockerPushImage(params, cwd) {
 }
 
 // src/commands/deploy/internal/backend-deploy/resolve-dockerfile.ts
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } 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 (!existsSync8(dockerfilePath)) {
+  if (!existsSync9(dockerfilePath)) {
     throw new Error(`Dockerfile \u4E0D\u5B58\u5728\uFF1A${dockerfilePath}`);
   }
   Logger.info("\u2713 Dockerfile \u5B58\u5728");
@@ -1813,16 +1863,16 @@ 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 existsSync9, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
 import { join as join9 } from "node:path";
 function loadApmDotEnvIfPresent() {
   const p = join9(workspaceApmDir(), ".env");
-  if (!existsSync9(p)) {
+  if (!existsSync10(p)) {
     return;
   }
   let text;
   try {
-    text = readFileSync8(p, "utf8");
+    text = readFileSync9(p, "utf8");
   } catch {
     return;
   }

package/package.json

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

package/template/AGENTS.md

@@ -17,7 +17,8 @@
 1. 读取 `.apm/sessions/<会话ID>/session.yaml`，必要时读取`messages.xml` 了解当前会话状态与历史消息
 2. 根据你的名字从 session.yaml 中找到你对应的人设(system_persona)
 3. 根据人设完成用户指定的任务
-4. 任务有阶段行进展或者任务完成后必须使用 `apm append-message` 回复消息
+4. 任务有阶段行进展或者任务完成后必须使用 `apm append-message` 回复消息，回复要求简洁不用对本轮工作进行总结
+5. 工作日志放到 `.apm/sessions/<会话ID>/docs/<position>.md` 中，并执行`apm sync-document <会话ID> --file=<position>`同步到远程
 
 ## 目录声明
 

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

@@ -1,28 +1,27 @@
 ## 工作流程
+
 1. 选择开发模式：**Quick/Spec**
 
-**Quick 开发**（满足越多越适用）: 
-    - 影响范围局部：少量文件或单一层次（例如仅前端组件、或仅一个后端模块小改）。
-    - 无新表结构/大规模迁移/权限模型变更。
-    - PRD 验收点清晰且数量少（经验上 **≤3** 条独立验收维度）。
-    - 不需要跨多服务的架构裁定即可开工。
-**Spec 开发**：（命中任一条即可）：
-    - 前后端联动、多包改造或新公共抽象。
-    - 新数据模型、迁移、或安全/审计/权限相关。
-    - PRD 范围大、条款多，或存在明显「待确认/多方案」需先规划。
-    - 评估认为不先产出 **proposal / design / specs / 
+**Quick 开发**（满足越多越适用）: - 影响范围局部：少量文件或单一层次（例如仅前端组件、或仅一个后端模块小改）。 - 无新表结构/大规模迁移/权限模型变更。 - PRD 验收点清晰且数量少（经验上 **≤3** 条独立验收维度）。 - 不需要跨多服务的架构裁定即可开工。
+**Spec 开发**：（命中任一条即可）： - 前后端联动、多包改造或新公共抽象。 - 新数据模型、迁移、或安全/审计/权限相关。 - PRD 范围大、条款多，或存在明显「待确认/多方案」需先规划。 - 评估认为不先产出 **proposal / design / specs / tasks** 不宜直接编码。
 
-2. 如果为 **Quick 开发**（子Agent中）执行：
+2. 如果为 **Quick 开发**（子 Agent 中）执行：
 
-+ 父 Agent 已通过 **Read** 掌握 `PRD.md`；若启动新子 Agent，在委派提示中写明会话ID、消息ID、工作项路径、以及「实现须严格对照 PRD，改动范围最小化」。
-+ 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
-    - 按需 **Read** `.apm/sessions/<会话ID>/docs/PRD.md`
-    - 按 PRD 直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
-    - 完成后在返回中说明：改了哪些路径、如何对照验收、是否通过本地可执行的检查（若子 Agent 跑了 `rushx build` / 测试等则写明结果）。
+- 父 Agent 已通过 **Read** 掌握 `PRD.md`；若启动新子 Agent，在委派提示中写明会话 ID、消息 ID、工作项路径、以及「实现须严格对照 PRD，改动范围最小化；完成后若有代码改动须单独 `git commit`」。
+- 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
+  - 按需 **Read** `.apm/sessions/<会话ID>/docs/PRD.md`
+  - 按 PRD 直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
+  - **Git**：实现与自洽验收通过后，若有代码改动，**立即 `git add` + `git commit` 一次**（Quick 通常为单次交付，**一次实现 = 一个 commit**；勿拆成无意义碎 commit）。提交信息建议包含 `seesionId`（可从 `session.yaml` 或 PRD 获取）与 PRD 摘要或验收点简述。
+  - 完成后在返回中说明：改了哪些路径、如何对照验收、是否通过本地可执行的检查（若子 Agent 跑了 `rushx build` / 测试等则写明结果）；若有 commit，写明 **short-sha** 与 **subject**，无代码改动则注明跳过 commit。
 
-3. 如果为  **Spec 开发** （子Agent中）执行：
+3. 如果为 **Spec 开发** （子 Agent 中）执行：
 
 - 父 Agent **Read** **apm-propose**、**apm-apply-change** 的 `SKILL.md`（**仅** `.apm/skills/` 下路径，见上节）。
 - **子 Agent A（规划）**：Task `generalPurpose`，提示其自行 **Read** `.apm/skills/apm-propose/SKILL.md` 并完整遵循：在 `.apm/sessions/<sessionId>/` 生成 **proposal、design、specs、tasks** 等工件（顺序与依赖以 SKILL 为准）。
 - **子 Agent B（实现）**：待 A 成功落盘后，再 Task `generalPurpose`，提示其自行 **Read** `.apm/skills/apm-apply-change/SKILL.md` 并完整遵循：按 **`tasks.md`** 驱动实现与勾选；遵守该技能中的停止条件与 commit 约定。
 - 若 **apm-propose** 未产出可用 **`tasks.md`**，不得强行进入 **apm-apply-change**；表格中标记阻塞原因。
+
+4. 提交并 push 代码
+
+- Quick / Spec 子 Agent 完成且本地已有 commit 时，父 Agent **立即 `git push`**（当前分支首次 push 用 `git push -u origin HEAD`）。
+- 无本地 commit、无远程或未配置 upstream 时说明原因，勿强行 push。