ai-project-manage-cli 6.0.58 → 6.0.60

package/dist/index.js

@@ -80,8 +80,8 @@ function buildAgentWsUrl(httpBase, apiKey) {
 }
 
 // src/commands/init.ts
-import { join as join4 } from "path";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync4 } from "fs";
+import { join as join5 } from "path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
 
 // src/command-utils.ts
 import {
@@ -149,13 +149,11 @@ var CLI_TEMPLATE_DIR = resolve2(__dirname, "../template");
 function workspaceApmDir(cwd = resolveWorkdirPath()) {
   return resolve2(resolve2(cwd), ".apm");
 }
-function assertWorkspaceApmDirExists(workdir) {
+function isWorkspaceApmInitialized(workdir) {
   const apmDir = workspaceApmDir(workdir);
   const fsApmDir = toFsPath(apmDir);
   if (!existsSync(fsApmDir)) {
-    throw new Error(
-      `\u5DE5\u4F5C\u76EE\u5F55 ${workdir} \u4E0B\u672A\u68C0\u6D4B\u5230 .apm \u76EE\u5F55\uFF0C\u8BF7\u5728\u8BE5\u4ED3\u5E93\u6839\u76EE\u5F55\u6267\u884C apm init \u5B8C\u6210\u63A5\u5165\u3002`
-    );
+    return false;
   }
   const st = statSync(fsApmDir);
   if (!st.isDirectory()) {
@@ -163,6 +161,7 @@ function assertWorkspaceApmDirExists(workdir) {
       `\u5DE5\u4F5C\u76EE\u5F55 ${workdir} \u4E0B\u7684 .apm \u4E0D\u662F\u76EE\u5F55\uFF0C\u8BF7\u68C0\u67E5\u672C\u5730\u63A5\u5165\u72B6\u6001\u3002`
     );
   }
+  return readdirSync(fsApmDir).length > 0;
 }
 var APM_GITIGNORE_PATTERNS = [
   /^\.apm\/?$/,
@@ -590,6 +589,218 @@ ${diagnostic ?? ""}
   return { synced: true, repositoryId, configName: config.name };
 }
 
+// src/repository-project-documents-sync.ts
+import {
+  existsSync as existsSync2,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync3,
+  rmSync,
+  writeFileSync as writeFileSync4
+} from "fs";
+import { createHash } from "crypto";
+import { dirname as dirname2, join as join4, relative, sep } from "path";
+var MANIFEST_FILE = "manifest.json";
+function projectDocumentsDir(apmRoot) {
+  return join4(apmRoot ?? workspaceApmDir(), "project");
+}
+function projectDocumentLocalPath(apmRoot, documentPath) {
+  const normalized = normalizeLocalDocumentPath(documentPath);
+  return join4(projectDocumentsDir(apmRoot), ...normalized.split("/"));
+}
+function normalizeLocalDocumentPath(path10) {
+  const trimmed = path10.trim().replace(/\\/g, "/");
+  if (!trimmed || trimmed.startsWith("/") || /^[a-zA-Z]:/.test(trimmed)) {
+    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path10}`);
+  }
+  const segments = trimmed.split("/").filter(Boolean);
+  if (segments.some((segment) => segment === ".." || segment === ".")) {
+    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path10}`);
+  }
+  return segments.join("/");
+}
+function hashLocalFileContent(content) {
+  return createHash("sha256").update(content, "utf8").digest("hex");
+}
+function readLocalManifest(apmRoot) {
+  const manifestPath2 = join4(projectDocumentsDir(apmRoot), MANIFEST_FILE);
+  if (!existsSync2(manifestPath2)) {
+    return null;
+  }
+  try {
+    return JSON.parse(
+      readFileSync3(manifestPath2, "utf8")
+    );
+  } catch {
+    return null;
+  }
+}
+function listLocalDocumentPaths(apmRoot) {
+  const root = projectDocumentsDir(apmRoot);
+  if (!existsSync2(root)) {
+    return [];
+  }
+  const paths = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync2(dir, { withFileTypes: true })) {
+      const abs = join4(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(abs);
+        continue;
+      }
+      if (entry.isFile() && entry.name === MANIFEST_FILE) {
+        continue;
+      }
+      const rel = relative(root, abs).split(sep).join("/");
+      paths.push(rel);
+    }
+  };
+  walk(root);
+  return paths.sort();
+}
+function diffManifestPaths(remote, local) {
+  const remoteMap = new Map(
+    (remote?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
+  );
+  const localMap = new Map(
+    (local?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
+  );
+  const download = [];
+  for (const [path10, hash] of remoteMap) {
+    if (localMap.get(path10) !== hash) {
+      download.push(path10);
+    }
+  }
+  const deleteLocal = [];
+  for (const path10 of localMap.keys()) {
+    if (!remoteMap.has(path10)) {
+      deleteLocal.push(path10);
+    }
+  }
+  return { download, deleteLocal };
+}
+async function syncRepositoryProjectDocumentsPull(workdirPath, apmDir) {
+  const empty = {
+    synced: false,
+    repositoryId: null,
+    downloaded: 0,
+    deleted: 0
+  };
+  const cfg = await tryReadApmConfig();
+  if (!cfg || !resolveApiKey(cfg)) {
+    console.log(
+      "[apm] \u672A\u68C0\u6D4B\u5230\u767B\u5F55\u4FE1\u606F\uFF0C\u8DF3\u8FC7\u4ED3\u5E93\u9879\u76EE\u6587\u6863\u540C\u6B65\u3002\n[apm] \u8BF7\u5148\u6267\u884C apm login\u3002"
+    );
+    return empty;
+  }
+  const api = createApmApiClient(cfg);
+  const { repositoryId, diagnostic } = await resolveRepositoryIdForSync(
+    api,
+    workdirPath
+  );
+  if (!repositoryId) {
+    console.log(
+      `[apm] \u672A\u80FD\u540C\u6B65\u4ED3\u5E93\u9879\u76EE\u6587\u6863\u3002
+${diagnostic ?? ""}`
+    );
+    return empty;
+  }
+  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
+  const projectDir = projectDocumentsDir(targetApmDir);
+  await ensureDirExists(projectDir);
+  const { manifest: remoteManifest } = await api.cli.getRepositoryProjectDocumentManifest({ repositoryId });
+  if (!remoteManifest) {
+    console.log(
+      `[apm] \u4ED3\u5E93 ${repositoryId} \u65E0\u9879\u76EE\u6587\u6863 manifest\uFF0C\u8DF3\u8FC7\u540C\u6B65\u3002`
+    );
+    return { ...empty, repositoryId };
+  }
+  const localManifest = readLocalManifest(targetApmDir);
+  const { download, deleteLocal } = diffManifestPaths(
+    remoteManifest,
+    localManifest
+  );
+  let downloaded = 0;
+  if (download.length > 0) {
+    const { list } = await api.cli.listRepositoryProjectDocuments({
+      repositoryId,
+      paths: download.join(",")
+    });
+    for (const doc of list) {
+      const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, doc.path));
+      await ensureDirExists(dirname2(absPath));
+      writeFileSync4(absPath, doc.content, "utf8");
+      downloaded += 1;
+    }
+  }
+  let deleted = 0;
+  for (const path10 of deleteLocal) {
+    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path10));
+    if (existsSync2(absPath)) {
+      rmSync(absPath, { force: true });
+      deleted += 1;
+    }
+  }
+  writeFileSync4(
+    toFsPath(join4(projectDir, MANIFEST_FILE)),
+    `${JSON.stringify(remoteManifest, null, 2)}
+`,
+    "utf8"
+  );
+  console.log(
+    `[apm] \u5DF2\u540C\u6B65\u4ED3\u5E93\u9879\u76EE\u6587\u6863: \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted}`
+  );
+  return {
+    synced: true,
+    repositoryId,
+    downloaded,
+    deleted
+  };
+}
+async function syncRepositoryProjectDocumentsPush(cfg, workdirPath, apmRoot) {
+  const api = createApmApiClient(cfg);
+  const { repositoryId } = await resolveRepositoryIdForSync(api, workdirPath);
+  if (!repositoryId) {
+    return 0;
+  }
+  const targetApmDir = apmRoot ?? workspaceApmDir(workdirPath);
+  const localPaths = listLocalDocumentPaths(targetApmDir);
+  if (localPaths.length === 0) {
+    console.log("[apm] \u4ED3\u5E93\u9879\u76EE\u6587\u6863\u65E0\u672C\u5730\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+    return 0;
+  }
+  const remoteManifest = (await api.cli.getRepositoryProjectDocumentManifest({ repositoryId })).manifest ?? null;
+  const remoteHashByPath = new Map(
+    (remoteManifest?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
+  );
+  const remoteDescriptionByPath = new Map(
+    (remoteManifest?.documents ?? []).map((doc) => [
+      doc.path,
+      doc.description
+    ])
+  );
+  let synced = 0;
+  for (const path10 of localPaths) {
+    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path10));
+    const content = readFileSync3(absPath, "utf8");
+    const contentHash = hashLocalFileContent(content);
+    if (remoteHashByPath.get(path10) === contentHash) {
+      continue;
+    }
+    await api.cli.upsertRepositoryProjectDocument({
+      repositoryId,
+      path: path10,
+      content,
+      description: remoteDescriptionByPath.get(path10) ?? void 0
+    });
+    synced += 1;
+    console.log(`[apm] \u5DF2\u540C\u6B65\u4ED3\u5E93\u9879\u76EE\u6587\u6863: ${path10}`);
+  }
+  if (synced === 0) {
+    console.log("[apm] \u4ED3\u5E93\u9879\u76EE\u6587\u6863\u65E0\u53D8\u5316\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+  }
+  return synced;
+}
+
 // src/git-utils.ts
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
@@ -652,8 +863,13 @@ async function commitAndPushGitignore(workdir) {
 }
 
 // src/commands/init.ts
-async function runInit(name) {
-  const workdir = resolveWorkdirPath();
+async function ensureWorkspaceInitialized(workdir, options) {
+  if (isWorkspaceApmInitialized(workdir)) {
+    return { didInit: false };
+  }
+  console.log(
+    `[apm] \u5DE5\u4F5C\u76EE\u5F55 ${workdir} \u672A\u68C0\u6D4B\u5230\u5DF2\u521D\u59CB\u5316\u7684 .apm\uFF0C\u6B63\u5728\u81EA\u52A8\u521D\u59CB\u5316\u2026`
+  );
   await ensureWorkspaceApmDirForInit(workdir);
   if (ensureApmGitignoredInRepo(workdir)) {
     console.log("[apm] \u5DF2\u5728 .gitignore \u4E2D\u6DFB\u52A0 **/.apm/**");
@@ -662,13 +878,14 @@ async function runInit(name) {
   const apmDir = workspaceApmDir(workdir);
   await copyTemplateFiles(apmDir, workdir);
   const syncResult = await syncRemoteDeploymentConfig(workdir, apmDir);
-  const trimmedName = name?.trim();
+  await syncRepositoryProjectDocumentsPull(workdir, apmDir);
+  const trimmedName = options?.name?.trim();
   if (trimmedName) {
-    const apmConfigPath = toFsPath(join4(apmDir, "apm.config.json"));
-    const config = readFileSync3(apmConfigPath, "utf8");
+    const apmConfigPath = toFsPath(join5(apmDir, "apm.config.json"));
+    const config = readFileSync4(apmConfigPath, "utf8");
     const configJson = JSON.parse(config);
     configJson.name = trimmedName;
-    writeFileSync4(
+    writeFileSync5(
       apmConfigPath,
       `${JSON.stringify(configJson, null, 2)}
 `,
@@ -676,8 +893,21 @@ async function runInit(name) {
     );
   }
   console.log(`[apm] \u5DF2\u521D\u59CB\u5316\u5DE5\u4F5C\u533A\uFF1A${apmDir}`);
+  return { didInit: true, syncResult };
+}
+async function runInit(name) {
+  const workdir = resolveWorkdirPath();
+  await ensureWorkspaceApmDirForInit(workdir);
+  const { didInit, syncResult } = await ensureWorkspaceInitialized(workdir, {
+    name
+  });
+  if (!didInit) {
+    throw new Error(
+      "[apm] .apm \u76EE\u5F55\u5DF2\u5B58\u5728\u4E14\u975E\u7A7A\uFF0C\u8BF7\u5148\u5907\u4EFD\u3001\u6E05\u7A7A\u6216\u5220\u9664\u540E\u518D\u6267\u884C init"
+    );
+  }
   console.log(`[apm] \u5DE5\u4F5C\u76EE\u5F55\u8DEF\u5F84\uFF1A${workdir}`);
-  if (!syncResult.synced) {
+  if (syncResult && !syncResult.synced) {
     console.log(
       "[apm] \u5F53\u524D .apm/apm.config.json \u4E0E .apm/deploy/README.md \u4E3A\u6A21\u677F\u9ED8\u8BA4\u503C\uFF1B\u5B8C\u6210\u5E73\u53F0\u767B\u8BB0\u540E\u6267\u884C apm sync-deploy-config"
     );
@@ -686,7 +916,7 @@ async function runInit(name) {
 }
 
 // src/commands/login.ts
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync3 } from "fs";
 import { ApiError } from "listpage-http";
 async function runLogin(opts) {
   const baseUrl = (opts.server?.trim() || process.env.AI_PM_SERVER?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
@@ -741,7 +971,7 @@ async function runLogin(opts) {
   );
   const workdir = resolveWorkdirPath();
   const apmDir = workspaceApmDir(workdir);
-  if (existsSync2(apmDir)) {
+  if (existsSync3(apmDir)) {
     await syncRemoteDeploymentConfig(workdir, apmDir);
   }
 }
@@ -1144,9 +1374,9 @@ function formatSessionMessagesXml(sessionId, messages) {
 }
 
 // src/commands/sync-session-attachments.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
-import { join as join5 } from "path";
-var MANIFEST_FILE = ".sync-manifest.json";
+import { existsSync as existsSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
+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 })}`;
@@ -1159,13 +1389,13 @@ async function downloadAttachment(cfg, attachmentId) {
   return Buffer.from(await res.arrayBuffer());
 }
 function loadManifest(dir) {
-  const path10 = join5(dir, MANIFEST_FILE);
-  if (!existsSync3(path10)) {
+  const path10 = join6(dir, MANIFEST_FILE2);
+  if (!existsSync4(path10)) {
     return { version: 1, attachments: {} };
   }
   try {
     const parsed = JSON.parse(
-      readFileSync4(path10, "utf8")
+      readFileSync5(path10, "utf8")
     );
     if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
       return parsed;
@@ -1175,21 +1405,21 @@ function loadManifest(dir) {
   return { version: 1, attachments: {} };
 }
 function saveManifest(dir, manifest) {
-  writeFileSync5(
-    join5(dir, MANIFEST_FILE),
+  writeFileSync6(
+    join6(dir, MANIFEST_FILE2),
     `${JSON.stringify(manifest, null, 2)}
 `,
     "utf8"
   );
 }
 function isAttachmentUpToDate(entry, item, dest) {
-  if (!entry || !existsSync3(dest)) return false;
+  if (!entry || !existsSync4(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) {
-  const dir = join5(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+  const dir = join6(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
   await ensureDirExists(dir);
   if (attachments.length === 0) {
     saveManifest(dir, { version: 1, attachments: {} });
@@ -1198,7 +1428,7 @@ async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
   const manifest = loadManifest(dir);
   const nextManifest = { version: 1, attachments: {} };
   for (const item of attachments) {
-    const dest = join5(dir, item.name);
+    const dest = join6(dir, item.name);
     const entry = manifest.attachments[item.id];
     const createdAt = item.createdAt ?? "";
     if (isAttachmentUpToDate(entry, item, dest)) {
@@ -1209,7 +1439,7 @@ async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
       continue;
     }
     const buffer = await downloadAttachment(cfg, item.id);
-    writeFileSync5(dest, buffer);
+    writeFileSync6(dest, buffer);
     nextManifest.attachments[item.id] = {
       name: item.name,
       createdAt
@@ -1220,46 +1450,46 @@ async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
 }
 
 // src/rules-sync.ts
-import { basename as basename2, extname as extname2, join as join7 } from "path";
-import { existsSync as existsSync5, readFileSync as readFileSync5, rmSync as rmSync2, writeFileSync as writeFileSync7 } from "fs";
+import { basename as basename2, extname as extname2, join as join8 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync6, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "fs";
 
 // src/skills-sync.ts
 import {
   copyFileSync as copyFileSync2,
   cpSync,
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   mkdirSync as mkdirSync3,
-  readdirSync as readdirSync2,
-  rmSync,
+  readdirSync as readdirSync3,
+  rmSync as rmSync2,
   statSync as statSync2,
-  writeFileSync as writeFileSync6
+  writeFileSync as writeFileSync7
 } from "fs";
-import { join as join6 } from "path";
-var AGENTS_TEMPLATE_PATH = join6(CLI_TEMPLATE_DIR, "AGENTS.md");
-var BASE_SKILLS_TEMPLATE_DIR = join6(CLI_TEMPLATE_DIR, "skills");
-var BASE_RULES_TEMPLATE_DIR = join6(CLI_TEMPLATE_DIR, "rules");
+import { join as join7 } from "path";
+var AGENTS_TEMPLATE_PATH = join7(CLI_TEMPLATE_DIR, "AGENTS.md");
+var BASE_SKILLS_TEMPLATE_DIR = join7(CLI_TEMPLATE_DIR, "skills");
+var BASE_RULES_TEMPLATE_DIR = join7(CLI_TEMPLATE_DIR, "rules");
 function sanitizeSkillDirName(name) {
   const trimmed = name.trim();
   if (!trimmed) return "skill";
   return trimmed.replace(/[/\\:*?"<>|]/g, "_");
 }
 function listBaseSkillDirNames() {
-  if (!existsSync4(BASE_SKILLS_TEMPLATE_DIR)) return [];
-  return readdirSync2(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
-    const path10 = join6(BASE_SKILLS_TEMPLATE_DIR, name);
+  if (!existsSync5(BASE_SKILLS_TEMPLATE_DIR)) return [];
+  return readdirSync3(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
+    const path10 = join7(BASE_SKILLS_TEMPLATE_DIR, name);
     return statSync2(path10).isDirectory();
   });
 }
 function syncAgentsGuide(apmDir) {
-  if (!existsSync4(AGENTS_TEMPLATE_PATH)) return false;
+  if (!existsSync5(AGENTS_TEMPLATE_PATH)) return false;
   mkdirSync3(apmDir, { recursive: true });
-  copyFileSync2(AGENTS_TEMPLATE_PATH, join6(apmDir, "AGENTS.md"));
+  copyFileSync2(AGENTS_TEMPLATE_PATH, join7(apmDir, "AGENTS.md"));
   return true;
 }
 function listBaseRuleFileNames() {
-  if (!existsSync4(BASE_RULES_TEMPLATE_DIR)) return [];
-  return readdirSync2(BASE_RULES_TEMPLATE_DIR).filter((name) => {
-    const path10 = join6(BASE_RULES_TEMPLATE_DIR, name);
+  if (!existsSync5(BASE_RULES_TEMPLATE_DIR)) return [];
+  return readdirSync3(BASE_RULES_TEMPLATE_DIR).filter((name) => {
+    const path10 = join7(BASE_RULES_TEMPLATE_DIR, name);
     return statSync2(path10).isFile();
   });
 }
@@ -1267,8 +1497,8 @@ function syncBaseRules(rulesDir) {
   mkdirSync3(rulesDir, { recursive: true });
   const names = listBaseRuleFileNames();
   for (const name of names) {
-    const src = join6(BASE_RULES_TEMPLATE_DIR, name);
-    const dest = join6(rulesDir, name);
+    const src = join7(BASE_RULES_TEMPLATE_DIR, name);
+    const dest = join7(rulesDir, name);
     copyFileSync2(src, dest);
   }
   return names;
@@ -1277,8 +1507,8 @@ function syncBaseSkills(skillsDir) {
   mkdirSync3(skillsDir, { recursive: true });
   const names = listBaseSkillDirNames();
   for (const name of names) {
-    const src = join6(BASE_SKILLS_TEMPLATE_DIR, name);
-    const dest = join6(skillsDir, name);
+    const src = join7(BASE_SKILLS_TEMPLATE_DIR, name);
+    const dest = join7(skillsDir, name);
     cpSync(src, dest, { recursive: true, force: true });
   }
   return names;
@@ -1295,26 +1525,26 @@ function syncSupplementarySkills(skillsDir, list) {
       skipped.push(dirName);
       continue;
     }
-    const skillDir = join6(skillsDir, dirName);
+    const skillDir = join7(skillsDir, dirName);
     mkdirSync3(skillDir, { recursive: true });
-    writeFileSync6(join6(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
+    writeFileSync7(join7(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
     written.push(dirName);
   }
   const removed = [];
-  if (!existsSync4(skillsDir)) return { written, skipped, removed };
-  for (const entry of readdirSync2(skillsDir)) {
-    const full = join6(skillsDir, entry);
+  if (!existsSync5(skillsDir)) return { written, skipped, removed };
+  for (const entry of readdirSync3(skillsDir)) {
+    const full = join7(skillsDir, entry);
     if (!statSync2(full).isDirectory()) continue;
     if (baseNames.has(entry)) continue;
     if (apiDirNames.has(entry)) continue;
-    rmSync(full, { recursive: true, force: true });
+    rmSync2(full, { recursive: true, force: true });
     removed.push(entry);
   }
   return { written, skipped, removed };
 }
 
 // src/rules-sync.ts
-var MANIFEST_FILE2 = ".rules-sync-manifest.json";
+var MANIFEST_FILE3 = ".rules-sync-manifest.json";
 function ruleLocalFileName(ruleName) {
   const trimmed = ruleName.trim();
   if (!trimmed) return "rule.md";
@@ -1323,13 +1553,13 @@ function ruleLocalFileName(ruleName) {
   return `${sanitized}.md`;
 }
 function loadManifest2(rulesDir) {
-  const path10 = join7(rulesDir, MANIFEST_FILE2);
-  if (!existsSync5(toFsPath(path10))) {
+  const path10 = join8(rulesDir, MANIFEST_FILE3);
+  if (!existsSync6(toFsPath(path10))) {
     return { version: 1, rules: {} };
   }
   try {
     const parsed = JSON.parse(
-      readFileSync5(toFsPath(path10), "utf8")
+      readFileSync6(toFsPath(path10), "utf8")
     );
     if (parsed?.version === 1 && parsed.rules && typeof parsed.rules === "object") {
       return parsed;
@@ -1339,8 +1569,8 @@ function loadManifest2(rulesDir) {
   return { version: 1, rules: {} };
 }
 function saveManifest2(rulesDir, manifest) {
-  writeFileSync7(
-    toFsPath(join7(rulesDir, MANIFEST_FILE2)),
+  writeFileSync8(
+    toFsPath(join8(rulesDir, MANIFEST_FILE3)),
     `${JSON.stringify(manifest, null, 2)}
 `,
     "utf8"
@@ -1350,18 +1580,18 @@ function isBaseRuleFileName(fileName) {
   return listBaseRuleFileNames().includes(basename2(fileName));
 }
 function isRuleUpToDate(entry, rule, dest) {
-  if (!entry || !existsSync5(toFsPath(dest))) return false;
+  if (!entry || !existsSync6(toFsPath(dest))) return false;
   if (entry.fileName !== ruleLocalFileName(rule.name)) return false;
   const updatedAt = rule.updatedAt ?? "";
   if (entry.updatedAt !== updatedAt) return false;
-  const localContent = readFileSync5(toFsPath(dest), "utf8");
+  const localContent = readFileSync6(toFsPath(dest), "utf8");
   return localContent === (rule.content ?? "");
 }
 async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   const api = createApmApiClient(cfg);
   const baseline = await api.cli.branchBaseline({ sessionId, workdirPath });
   const repositoryId = baseline.repositoryId;
-  const rulesDir = join7(apmRoot ?? workspaceApmDir(workdirPath), "rules");
+  const rulesDir = join8(apmRoot ?? workspaceApmDir(workdirPath), "rules");
   await ensureDirExists(rulesDir);
   if (!repositoryId) {
     console.log(
@@ -1378,7 +1608,7 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   for (const rule of list) {
     remoteIds.add(rule.id);
     const fileName = ruleLocalFileName(rule.name);
-    const dest = join7(rulesDir, fileName);
+    const dest = join8(rulesDir, fileName);
     const entry = manifest.rules[rule.id];
     const updatedAt = rule.updatedAt ?? "";
     if (isRuleUpToDate(entry, rule, dest)) {
@@ -1387,7 +1617,7 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
       console.log(`[apm] \u89C4\u5219\u65E0\u53D8\u5316\uFF0C\u5DF2\u8DF3\u8FC7: rules/${fileName}`);
       continue;
     }
-    writeFileSync7(toFsPath(dest), rule.content ?? "", "utf8");
+    writeFileSync8(toFsPath(dest), rule.content ?? "", "utf8");
     nextManifest.rules[rule.id] = { fileName, updatedAt };
     written.push(fileName);
     console.log(`[apm] \u5DF2\u540C\u6B65\u5E73\u53F0\u89C4\u5219: rules/${fileName}`);
@@ -1396,9 +1626,9 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   for (const [ruleId, entry] of Object.entries(manifest.rules)) {
     if (remoteIds.has(ruleId)) continue;
     if (isBaseRuleFileName(entry.fileName)) continue;
-    const dest = join7(rulesDir, entry.fileName);
-    if (existsSync5(toFsPath(dest))) {
-      rmSync2(toFsPath(dest), { force: true });
+    const dest = join8(rulesDir, entry.fileName);
+    if (existsSync6(toFsPath(dest))) {
+      rmSync3(toFsPath(dest), { force: true });
     }
     removed.push(entry.fileName);
     console.log(`[apm] \u5DF2\u79FB\u9664\u5DF2\u4E0B\u7EBF\u7684\u5E73\u53F0\u89C4\u5219: rules/${entry.fileName}`);
@@ -1407,218 +1637,6 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
   return { written, skipped, removed, repositoryId };
 }
 
-// src/repository-project-documents-sync.ts
-import {
-  existsSync as existsSync6,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync6,
-  rmSync as rmSync3,
-  writeFileSync as writeFileSync8
-} from "fs";
-import { createHash } from "crypto";
-import { dirname as dirname2, join as join8, relative, sep } from "path";
-var MANIFEST_FILE3 = "manifest.json";
-function projectDocumentsDir(apmRoot) {
-  return join8(apmRoot ?? workspaceApmDir(), "project");
-}
-function projectDocumentLocalPath(apmRoot, documentPath) {
-  const normalized = normalizeLocalDocumentPath(documentPath);
-  return join8(projectDocumentsDir(apmRoot), ...normalized.split("/"));
-}
-function normalizeLocalDocumentPath(path10) {
-  const trimmed = path10.trim().replace(/\\/g, "/");
-  if (!trimmed || trimmed.startsWith("/") || /^[a-zA-Z]:/.test(trimmed)) {
-    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path10}`);
-  }
-  const segments = trimmed.split("/").filter(Boolean);
-  if (segments.some((segment) => segment === ".." || segment === ".")) {
-    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path10}`);
-  }
-  return segments.join("/");
-}
-function hashLocalFileContent(content) {
-  return createHash("sha256").update(content, "utf8").digest("hex");
-}
-function readLocalManifest(apmRoot) {
-  const manifestPath2 = join8(projectDocumentsDir(apmRoot), MANIFEST_FILE3);
-  if (!existsSync6(manifestPath2)) {
-    return null;
-  }
-  try {
-    return JSON.parse(
-      readFileSync6(manifestPath2, "utf8")
-    );
-  } catch {
-    return null;
-  }
-}
-function listLocalDocumentPaths(apmRoot) {
-  const root = projectDocumentsDir(apmRoot);
-  if (!existsSync6(root)) {
-    return [];
-  }
-  const paths = [];
-  const walk = (dir) => {
-    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-      const abs = join8(dir, entry.name);
-      if (entry.isDirectory()) {
-        walk(abs);
-        continue;
-      }
-      if (entry.isFile() && entry.name === MANIFEST_FILE3) {
-        continue;
-      }
-      const rel = relative(root, abs).split(sep).join("/");
-      paths.push(rel);
-    }
-  };
-  walk(root);
-  return paths.sort();
-}
-function diffManifestPaths(remote, local) {
-  const remoteMap = new Map(
-    (remote?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
-  );
-  const localMap = new Map(
-    (local?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
-  );
-  const download = [];
-  for (const [path10, hash] of remoteMap) {
-    if (localMap.get(path10) !== hash) {
-      download.push(path10);
-    }
-  }
-  const deleteLocal = [];
-  for (const path10 of localMap.keys()) {
-    if (!remoteMap.has(path10)) {
-      deleteLocal.push(path10);
-    }
-  }
-  return { download, deleteLocal };
-}
-async function syncRepositoryProjectDocumentsPull(workdirPath, apmDir) {
-  const empty = {
-    synced: false,
-    repositoryId: null,
-    downloaded: 0,
-    deleted: 0
-  };
-  const cfg = await tryReadApmConfig();
-  if (!cfg || !resolveApiKey(cfg)) {
-    console.log(
-      "[apm] \u672A\u68C0\u6D4B\u5230\u767B\u5F55\u4FE1\u606F\uFF0C\u8DF3\u8FC7\u4ED3\u5E93\u9879\u76EE\u6587\u6863\u540C\u6B65\u3002\n[apm] \u8BF7\u5148\u6267\u884C apm login\u3002"
-    );
-    return empty;
-  }
-  const api = createApmApiClient(cfg);
-  const { repositoryId, diagnostic } = await resolveRepositoryIdForSync(
-    api,
-    workdirPath
-  );
-  if (!repositoryId) {
-    console.log(
-      `[apm] \u672A\u80FD\u540C\u6B65\u4ED3\u5E93\u9879\u76EE\u6587\u6863\u3002
-${diagnostic ?? ""}`
-    );
-    return empty;
-  }
-  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
-  const projectDir = projectDocumentsDir(targetApmDir);
-  await ensureDirExists(projectDir);
-  const { manifest: remoteManifest } = await api.cli.getRepositoryProjectDocumentManifest({ repositoryId });
-  if (!remoteManifest) {
-    console.log(
-      `[apm] \u4ED3\u5E93 ${repositoryId} \u65E0\u9879\u76EE\u6587\u6863 manifest\uFF0C\u8DF3\u8FC7\u540C\u6B65\u3002`
-    );
-    return { ...empty, repositoryId };
-  }
-  const localManifest = readLocalManifest(targetApmDir);
-  const { download, deleteLocal } = diffManifestPaths(
-    remoteManifest,
-    localManifest
-  );
-  let downloaded = 0;
-  if (download.length > 0) {
-    const { list } = await api.cli.listRepositoryProjectDocuments({
-      repositoryId,
-      paths: download.join(",")
-    });
-    for (const doc of list) {
-      const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, doc.path));
-      await ensureDirExists(dirname2(absPath));
-      writeFileSync8(absPath, doc.content, "utf8");
-      downloaded += 1;
-    }
-  }
-  let deleted = 0;
-  for (const path10 of deleteLocal) {
-    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path10));
-    if (existsSync6(absPath)) {
-      rmSync3(absPath, { force: true });
-      deleted += 1;
-    }
-  }
-  writeFileSync8(
-    toFsPath(join8(projectDir, MANIFEST_FILE3)),
-    `${JSON.stringify(remoteManifest, null, 2)}
-`,
-    "utf8"
-  );
-  console.log(
-    `[apm] \u5DF2\u540C\u6B65\u4ED3\u5E93\u9879\u76EE\u6587\u6863: \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted}`
-  );
-  return {
-    synced: true,
-    repositoryId,
-    downloaded,
-    deleted
-  };
-}
-async function syncRepositoryProjectDocumentsPush(cfg, workdirPath, apmRoot) {
-  const api = createApmApiClient(cfg);
-  const { repositoryId } = await resolveRepositoryIdForSync(api, workdirPath);
-  if (!repositoryId) {
-    return 0;
-  }
-  const targetApmDir = apmRoot ?? workspaceApmDir(workdirPath);
-  const localPaths = listLocalDocumentPaths(targetApmDir);
-  if (localPaths.length === 0) {
-    console.log("[apm] \u4ED3\u5E93\u9879\u76EE\u6587\u6863\u65E0\u672C\u5730\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u63A8\u9001");
-    return 0;
-  }
-  const remoteManifest = (await api.cli.getRepositoryProjectDocumentManifest({ repositoryId })).manifest ?? null;
-  const remoteHashByPath = new Map(
-    (remoteManifest?.documents ?? []).map((doc) => [doc.path, doc.contentHash])
-  );
-  const remoteDescriptionByPath = new Map(
-    (remoteManifest?.documents ?? []).map((doc) => [
-      doc.path,
-      doc.description
-    ])
-  );
-  let synced = 0;
-  for (const path10 of localPaths) {
-    const absPath = toFsPath(projectDocumentLocalPath(targetApmDir, path10));
-    const content = readFileSync6(absPath, "utf8");
-    const contentHash = hashLocalFileContent(content);
-    if (remoteHashByPath.get(path10) === contentHash) {
-      continue;
-    }
-    await api.cli.upsertRepositoryProjectDocument({
-      repositoryId,
-      path: path10,
-      content,
-      description: remoteDescriptionByPath.get(path10) ?? void 0
-    });
-    synced += 1;
-    console.log(`[apm] \u5DF2\u540C\u6B65\u4ED3\u5E93\u9879\u76EE\u6587\u6863: ${path10}`);
-  }
-  if (synced === 0) {
-    console.log("[apm] \u4ED3\u5E93\u9879\u76EE\u6587\u6863\u65E0\u53D8\u5316\uFF0C\u8DF3\u8FC7\u63A8\u9001");
-  }
-  return synced;
-}
-
 // src/commands/pull.ts
 async function runPull(sessionId, remoteWorkdir) {
   const trimmedId = sessionId.trim();
@@ -2961,8 +2979,13 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
   };
   try {
     if (signal.aborted) return;
-    assertWorkspaceApmDirExists(workdir);
-    assertApmGitignoredInRepo(workdir);
+    const { didInit } = await runStep(
+      "workspace-init",
+      () => ensureWorkspaceInitialized(workdir)
+    );
+    if (!didInit) {
+      assertApmGitignoredInRepo(workdir);
+    }
     await runStep(
       "status-typing",
       () => updateMessageStatus(cfg, messageId, "TYPING")
@@ -3006,6 +3029,12 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
       console.log(`[apm] step=update-skills skipped workdir=${workdir}`);
     }
     if (signal.aborted) return;
+    if (!pullRan) {
+      await runStep(
+        "sync-project-documents-pull",
+        () => syncRepositoryProjectDocumentsPull(workdir, apmRoot)
+      );
+    }
     await runStep(
       "cursor-agent",
       () => runCursorAgent(

package/package.json

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