ai-project-manage-cli 7.1.37 → 7.1.38

package/dist/webide-message-worker.js

@@ -601,57 +601,6 @@ async function pushCurrentBranch(cwd) {
   return true;
 }
 
-// src/baseline-resolve.ts
-function formatBaselineDiagnostic(workdirPath, baselineWorkdirPath, diagnostic) {
-  return diagnostic?.message ?? `\u672A\u5728\u5E73\u53F0\u627E\u5230\u4E0E\u5F53\u524D\u76EE\u5F55\u5339\u914D\u7684\u5DE5\u4F5C\u76EE\u5F55\u767B\u8BB0\uFF1A${workdirPath}\uFF08\u89C4\u8303\u5316\uFF1A${baselineWorkdirPath}\uFF09
-\u8BF7\u5148\u5728\u5E73\u53F0\u767B\u8BB0\u8BE5\u8DEF\u5F84\u5BF9\u5E94\u7684\u5DE5\u4F5C\u76EE\u5F55\u4E0E\u4ED3\u5E93\u3002`;
-}
-async function matchRepositoryByGitRemote(api, workdirPath) {
-  const gitRoot = await resolveGitRepoRoot(workdirPath);
-  const gitUrl = await tryReadGitOriginUrl(gitRoot);
-  if (!gitUrl) {
-    return null;
-  }
-  const matched = await api.cli.matchRepository({ url: gitUrl });
-  const repositoryId = matched.repositoryId?.trim();
-  const defaultBranch = matched.defaultBranch?.trim();
-  if (!repositoryId || !defaultBranch) {
-    return null;
-  }
-  console.log(
-    `[apm] \u5DE5\u4F5C\u7A7A\u95F4\u8DEF\u5F84\u672A\u5339\u914D\uFF0C\u5DF2\u901A\u8FC7 git remote \u5173\u8054\u4ED3\u5E93: ${gitUrl}`
-  );
-  return { repositoryId, defaultBranch };
-}
-async function resolveWorkspaceBaseline(api, workdirPath) {
-  const baseline = await api.cli.workspaceBaseline({ workdirPath });
-  const repositoryId = baseline.repositoryId?.trim();
-  const defaultBranch = baseline.defaultBranch?.trim();
-  if (repositoryId && defaultBranch) {
-    return {
-      repositoryId,
-      defaultBranch,
-      workdirPath: baseline.workdirPath,
-      matchedViaGitRemote: false
-    };
-  }
-  const viaGit = await matchRepositoryByGitRemote(api, workdirPath);
-  if (viaGit) {
-    return {
-      ...viaGit,
-      workdirPath: baseline.workdirPath,
-      matchedViaGitRemote: true
-    };
-  }
-  throw new Error(
-    `[apm] ${formatBaselineDiagnostic(
-      workdirPath,
-      baseline.workdirPath,
-      baseline.diagnostic
-    )}`
-  );
-}
-
 // src/command-utils.ts
 import { copyFileSync, existsSync, mkdirSync as mkdirSync2, readdirSync, statSync } from "fs";
 import { basename, dirname, extname, join as join2, resolve as resolve2 } from "path";
@@ -2923,493 +2872,142 @@ function resolveMessageReplyFallback(fallback) {
 }
 
 // src/commands/init.ts
-import { join as join6 } from "path";
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync7 } from "fs";
-
-// src/deployment-config-sync.ts
 import { join as join4 } from "path";
-import { writeFileSync as writeFileSync5 } from "fs";
-var TEMPLATE_HINT = "\u4FDD\u7559\u6A21\u677F .apm/apm.config.json";
-var SYNC_HINT = "\u767B\u8BB0\u5DE5\u4F5C\u7A7A\u95F4\u8DEF\u5F84\u3001\u7ED1\u5B9A\u4ED3\u5E93\u540E\uFF0C\u53EF\u6267\u884C: apm sync-deploy-config";
-async function resolveRepositoryIdForSync(api, workdirPath) {
-  try {
-    const baseline = await resolveWorkspaceBaseline(api, workdirPath);
-    return { repositoryId: baseline.repositoryId, diagnostic: null };
-  } catch (err) {
-    const detail = err instanceof Error ? err.message : String(err);
-    return {
-      repositoryId: null,
-      diagnostic: detail.replace(/^\[apm\]\s*/, "")
-    };
-  }
-}
-async function writeDeploymentConfigContent(apmDir, content, configName) {
-  let parsed;
-  try {
-    parsed = JSON.parse(content);
-  } catch {
-    console.warn(
-      `[apm] \u8FDC\u7A0B\u90E8\u7F72\u914D\u7F6E\u300C${configName}\u300DJSON \u65E0\u6548\uFF08${TEMPLATE_HINT}\uFF09`
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "fs";
+async function initializeWorkspace(workdir, options) {
+  await ensureWorkspaceApmDirForInit(workdir);
+  const apmDir = workspaceApmDir(workdir);
+  await copyTemplateFiles(apmDir, workdir);
+  const trimmedName = options?.name?.trim();
+  if (trimmedName) {
+    const apmConfigPath = toFsPath(join4(apmDir, "apm.config.json"));
+    const config = readFileSync5(apmConfigPath, "utf8");
+    const configJson = JSON.parse(config);
+    configJson.name = trimmedName;
+    writeFileSync5(
+      apmConfigPath,
+      `${JSON.stringify(configJson, null, 2)}
+`,
+      "utf8"
     );
-    return false;
   }
-  const apmConfigPath = toFsPath(join4(apmDir, "apm.config.json"));
-  writeFileSync5(apmConfigPath, `${JSON.stringify(parsed, null, 2)}
-`, "utf8");
-  console.log(`[apm] \u5DF2\u540C\u6B65\u5E73\u53F0\u90E8\u7F72\u914D\u7F6E: ${configName}`);
-  console.log("[apm] \u5DF2\u5199\u5165 .apm/apm.config.json");
-  return true;
+  console.log(`[apm] \u5DF2\u521D\u59CB\u5316\u5DE5\u4F5C\u533A\uFF1A${apmDir}`);
+  return { didInit: true };
 }
-async function syncRemoteDeploymentConfig(workdirPath, apmDir, options) {
-  const cfg = await tryReadApmConfig();
-  if (!cfg || !resolveApiKey(cfg)) {
-    console.log(
-      `[apm] \u672A\u68C0\u6D4B\u5230\u767B\u5F55\u4FE1\u606F\uFF0C\u8DF3\u8FC7\u5E73\u53F0\u90E8\u7F72\u914D\u7F6E\u540C\u6B65\uFF08${TEMPLATE_HINT}\uFF09\u3002
-[apm] \u8BF7\u5148\u6267\u884C apm login\uFF0C\u518D\u6267\u884C apm sync-deploy-config \u62C9\u53D6\u6700\u65B0\u914D\u7F6E\u3002`
-    );
-    return { synced: false, repositoryId: null };
-  }
-  const api = createApmApiClient(cfg);
-  const preferredId = options?.repositoryId?.trim() || "";
-  let repositoryId = preferredId || null;
-  let diagnostic = null;
-  if (!repositoryId) {
-    const resolved = await resolveRepositoryIdForSync(api, workdirPath);
-    repositoryId = resolved.repositoryId;
-    diagnostic = resolved.diagnostic;
-  }
-  if (!repositoryId) {
-    console.log(
-      `[apm] \u672A\u80FD\u540C\u6B65\u5E73\u53F0\u90E8\u7F72\u914D\u7F6E\uFF08${TEMPLATE_HINT}\uFF09\u3002
-${diagnostic ?? ""}
-[apm] ${SYNC_HINT}`
-    );
-    return { synced: false, repositoryId: null };
-  }
-  const { config } = await api.cli.getDeploymentConfiguration({ repositoryId });
-  if (!config) {
-    console.log(
-      `[apm] \u672A\u627E\u5230\u5173\u8054\u4ED3\u5E93\u7684\u90E8\u7F72\u914D\u7F6E\uFF08${TEMPLATE_HINT}\uFF0CrepositoryId\uFF1A${repositoryId}\uFF09\u3002
-[apm] \u8BF7\u5728\u5E73\u53F0\u300C\u90E8\u7F72\u914D\u7F6E\u300D\u4E2D\u521B\u5EFA\u914D\u7F6E\u5E76\u5173\u8054\u8BE5\u4ED3\u5E93\uFF0C\u7136\u540E\u6267\u884C: apm sync-deploy-config`
-    );
-    return { synced: false, repositoryId };
+async function ensureWorkspaceInitialized(workdir, options) {
+  if (isWorkspaceApmInitialized(workdir)) {
+    return { didInit: false };
   }
-  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
-  const wrote = await writeDeploymentConfigContent(
-    targetApmDir,
-    config.content,
-    config.name
+  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`
   );
-  if (!wrote) {
-    return { synced: false, repositoryId };
-  }
-  return { synced: true, repositoryId, configName: config.name };
+  return initializeWorkspace(workdir, options);
 }
 
-// src/project-documents-sync.ts
-import {
-  existsSync as existsSync6,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync5,
-  rmSync as rmSync2,
-  writeFileSync as writeFileSync6
-} from "fs";
-import { createHash } from "crypto";
-import { dirname as dirname5, join as join5, relative as relative2, sep } from "path";
-var MANIFEST_FILE = "manifest.json";
-function normalizeProjectIdForPath(projectId) {
-  const id = projectId.trim();
-  if (!id) {
-    throw new Error("projectId \u4E0D\u80FD\u4E3A\u7A7A");
-  }
-  if (id.includes("..") || id.includes("/") || id.includes("\\") || id.includes("\0")) {
-    throw new Error(`\u975E\u6CD5 projectId: ${projectId}`);
-  }
-  return id;
+// src/commands/connect/pre-step-cache.ts
+function sessionWorkdirKey(sessionId, workdir) {
+  return `${sessionId}\0${workdir}`;
 }
-function projectDocumentsDir(apmRoot, projectId) {
-  const id = normalizeProjectIdForPath(projectId);
-  return join5(apmRoot ?? workspaceApmDir(), "project", id);
+var lastBranchKey = null;
+function shouldRunBranch(sessionId, workdir) {
+  return lastBranchKey !== sessionWorkdirKey(sessionId, workdir);
 }
-function projectDocumentLocalPath(apmRoot, projectId, documentPath) {
-  const normalized = normalizeLocalDocumentPath(documentPath);
-  return join5(
-    projectDocumentsDir(apmRoot, projectId),
-    ...normalized.split("/")
-  );
+function markBranchDone(sessionId, workdir) {
+  lastBranchKey = sessionWorkdirKey(sessionId, workdir);
 }
-function normalizeLocalDocumentPath(path) {
-  const trimmed = path.trim().replace(/\\/g, "/");
-  if (!trimmed || trimmed.startsWith("/") || /^[a-zA-Z]:/.test(trimmed)) {
-    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path}`);
-  }
-  const segments = trimmed.split("/").filter(Boolean);
-  if (segments.some((segment) => segment === ".." || segment === ".")) {
-    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path}`);
-  }
-  return segments.join("/");
+
+// src/commands/connect/webide-pull-requests.ts
+var PRE_AGENT_PR_ACTIONS = /* @__PURE__ */ new Set([
+  "generate-cases",
+  "run-auto-test",
+  // 验收合并前兜底确保 PR 存在
+  "accept"
+]);
+var POST_AGENT_PR_ACTIONS = /* @__PURE__ */ new Set(["create-pr", "finish-manual-test"]);
+function shouldEnsureWebIdePullRequests(action) {
+  return PRE_AGENT_PR_ACTIONS.has(action);
 }
-function hashLocalFileContent(content) {
-  return createHash("sha256").update(content, "utf8").digest("hex");
+function shouldEnsureWebIdePullRequestsAfterAgent(action) {
+  return POST_AGENT_PR_ACTIONS.has(action);
 }
-function readLocalManifest(apmRoot, projectId) {
-  const manifestPath3 = join5(
-    projectDocumentsDir(apmRoot, projectId),
-    MANIFEST_FILE
+function formatWebIdePullRequestSummary(result) {
+  const lines = [];
+  lines.push("## PR \u521B\u5EFA\u7ED3\u679C");
+  lines.push(
+    `\u5408\u8BA1\uFF1A\u6210\u529F ${result.ensured} \u6761\uFF0C\u65E0\u53D8\u66F4\u8DF3\u8FC7 ${result.skippedNoChanges} \u6761\uFF0C\u5176\u4ED6\u8DF3\u8FC7 ${result.skipped} \u6761\uFF0C\u5931\u8D25 ${result.failed} \u6761\u3002`
   );
-  if (!existsSync6(manifestPath3)) {
-    return null;
-  }
-  try {
-    return JSON.parse(
-      readFileSync5(manifestPath3, "utf8")
-    );
-  } catch {
-    return null;
-  }
-}
-function listLocalDocumentPaths(apmRoot, projectId) {
-  const root = projectDocumentsDir(apmRoot, projectId);
-  if (!existsSync6(root)) {
-    return [];
+  if (result.items.length === 0) {
+    lines.push("\u672A\u5904\u7406\u4EFB\u4F55\u4ED3\u5E93\u3002");
+    return lines.join("\n");
   }
-  const paths = [];
-  const walk = (dir) => {
-    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-      const abs = join5(dir, entry.name);
-      if (entry.isDirectory()) {
-        walk(abs);
-        continue;
-      }
-      if (entry.isFile() && entry.name === MANIFEST_FILE) {
-        continue;
-      }
-      const rel = relative2(root, abs).split(sep).join("/");
-      paths.push(rel);
+  lines.push("");
+  for (const item of result.items) {
+    if (item.outcome === "created") {
+      const num = item.number != null && item.number > 0 ? `#${item.number}` : "\uFF08\u65E0\u7F16\u53F7\uFF09";
+      const branch = item.headBranch && item.baseBranch ? `${item.headBranch} \u2192 ${item.baseBranch}` : item.baseBranch ? `\u76EE\u6807\u5206\u652F ${item.baseBranch}` : "";
+      const state = item.state ? `\u72B6\u6001 ${item.state}` : "";
+      const url = item.url?.trim() ? item.url.trim() : "";
+      lines.push(
+        `- **${item.label}**\uFF1A\u5DF2\u521B\u5EFA ${num}${branch ? `\uFF0C${branch}` : ""}${state ? `\uFF0C${state}` : ""}${url ? `\uFF0C${url}` : ""}`
+      );
+      continue;
     }
-  };
-  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 [path, hash] of remoteMap) {
-    if (localMap.get(path) !== hash) {
-      download.push(path);
+    if (item.outcome === "skipped_no_changes") {
+      lines.push(
+        `- **${item.label}**\uFF1A\u76F8\u5BF9\u57FA\u7EBF ${item.baseBranch || "\uFF08\u672A\u77E5\uFF09"} \u65E0\u4EE3\u7801\u53D8\u66F4\uFF0C\u672A\u521B\u5EFA PR`
+      );
+      continue;
     }
-  }
-  const deleteLocal = [];
-  for (const path of localMap.keys()) {
-    if (!remoteMap.has(path)) {
-      deleteLocal.push(path);
+    if (item.outcome === "skipped") {
+      lines.push(`- **${item.label}**\uFF1A\u5DF2\u8DF3\u8FC7 \u2014 ${item.detail}`);
+      continue;
     }
+    lines.push(`- **${item.label}**\uFF1A\u521B\u5EFA\u5931\u8D25 \u2014 ${item.detail}`);
   }
-  return { download, deleteLocal };
+  return lines.join("\n");
 }
-async function resolveProjectIdForSync(api, workdirPath, options) {
-  const explicit = options?.projectId?.trim();
-  if (explicit) {
-    return { projectId: explicit, diagnostic: null };
-  }
+async function ensureWebIdePullRequests(cfg, taskId, workdir) {
+  const api = createApmApiClient(cfg);
+  const empty = () => ({
+    ensured: 0,
+    skipped: 0,
+    skippedNoChanges: 0,
+    failed: 0,
+    items: [],
+    tips: []
+  });
+  let repoRoots;
   try {
-    const baseline = await api.cli.workspaceBaseline({ workdirPath });
-    const projectId = baseline.projectId?.trim() || null;
-    if (projectId) {
-      return { projectId, diagnostic: null };
-    }
-    const projectIds = baseline.projectIds ?? [];
-    if (projectIds.length === 0) {
-      return {
-        projectId: null,
-        diagnostic: baseline.diagnostic?.message ?? `\u5DE5\u4F5C\u7A7A\u95F4\u672A\u5173\u8054\u9879\u76EE\uFF0C\u65E0\u6CD5\u540C\u6B65\u9879\u76EE\u6587\u6863\uFF08\u76EE\u5F55\uFF1A${workdirPath}\uFF09\u3002
-\u8BF7\u5728\u5E73\u53F0\u5C06\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u5230\u552F\u4E00\u9879\u76EE\u3002`
-      };
-    }
+    const manifest = loadWorkspaceReposCache(workdir);
+    repoRoots = resolveWorkspaceRepoAbsolutePaths(manifest);
+  } catch (err) {
+    const tip = `\u8BFB\u53D6\u4ED3\u5E93\u6E05\u5355\u5931\u8D25: ${err instanceof Error ? err.message : err}`;
+    console.warn(`[apm] WebIDE PR\uFF1A${tip}`);
     return {
-      projectId: null,
-      diagnostic: `\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u4E86 ${projectIds.length} \u4E2A\u9879\u76EE\uFF0C\u65E0\u6CD5\u786E\u5B9A\u540C\u6B65\u76EE\u6807\u3002
-\u8BF7\u786E\u4FDD\u8BE5\u5DE5\u4F5C\u7A7A\u95F4\u53EA\u5173\u8054\u4E00\u4E2A\u9879\u76EE\u540E\u518D\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002`
+      ...empty(),
+      failed: 1,
+      tips: [tip],
+      items: [
+        {
+          label: "\u5DE5\u4F5C\u533A",
+          outcome: "failed",
+          detail: tip
+        }
+      ]
     };
+  }
+  let projectBaseBranch = "";
+  try {
+    const baseline = await api.cli.projectBaseBranch({ taskId });
+    projectBaseBranch = baseline.baseBranch?.trim() ?? "";
   } catch (err) {
-    const detail = err instanceof Error ? err.message : String(err);
+    const tip = `\u8BFB\u53D6\u9879\u76EE\u57FA\u7EBF\u5206\u652F\u5931\u8D25: ${err instanceof Error ? err.message : err}`;
+    console.warn(`[apm] WebIDE PR\uFF1A${tip}`);
     return {
-      projectId: null,
-      diagnostic: detail.replace(/^\[apm\]\s*/, "")
-    };
-  }
-}
-async function syncProjectDocumentsPull(workdirPath, apmDir, options) {
-  const empty = {
-    synced: false,
-    projectId: 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\u9879\u76EE\u6587\u6863\u540C\u6B65\u3002\n[apm] \u8BF7\u5148\u6267\u884C apm login\u3002"
-    );
-    return empty;
-  }
-  const api = createApmApiClient(cfg);
-  const { projectId, diagnostic } = await resolveProjectIdForSync(
-    api,
-    workdirPath,
-    options
-  );
-  if (!projectId) {
-    console.log(`[apm] \u672A\u80FD\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002
-${diagnostic ?? ""}`);
-    return empty;
-  }
-  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
-  const docsDir = projectDocumentsDir(targetApmDir, projectId);
-  await ensureDirExists(docsDir);
-  const { manifest: remoteManifest } = await api.cli.getProjectDocumentManifest(
-    { projectId }
-  );
-  if (!remoteManifest) {
-    console.log(`[apm] \u9879\u76EE ${projectId} \u65E0\u9879\u76EE\u6587\u6863 manifest\uFF0C\u8DF3\u8FC7\u540C\u6B65\u3002`);
-    return { ...empty, projectId };
-  }
-  const localManifest = readLocalManifest(targetApmDir, projectId);
-  const { download, deleteLocal } = diffManifestPaths(
-    remoteManifest,
-    localManifest
-  );
-  let downloaded = 0;
-  if (download.length > 0) {
-    const { list } = await api.cli.listProjectDocuments({
-      projectId,
-      paths: download.join(",")
-    });
-    for (const doc of list) {
-      const absPath = toFsPath(
-        projectDocumentLocalPath(targetApmDir, projectId, doc.path)
-      );
-      await ensureDirExists(dirname5(absPath));
-      writeFileSync6(absPath, doc.content, "utf8");
-      downloaded += 1;
-    }
-  }
-  let deleted = 0;
-  for (const path of deleteLocal) {
-    const absPath = toFsPath(
-      projectDocumentLocalPath(targetApmDir, projectId, path)
-    );
-    if (existsSync6(absPath)) {
-      rmSync2(absPath, { force: true });
-      deleted += 1;
-    }
-  }
-  writeFileSync6(
-    toFsPath(join5(docsDir, MANIFEST_FILE)),
-    `${JSON.stringify(remoteManifest, null, 2)}
-`,
-    "utf8"
-  );
-  console.log(
-    `[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: projectId=${projectId} \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted} \u2192 .apm/project/${projectId}/`
-  );
-  return {
-    synced: true,
-    projectId,
-    downloaded,
-    deleted
-  };
-}
-async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot, options) {
-  const api = createApmApiClient(cfg);
-  const { projectId } = await resolveProjectIdForSync(
-    api,
-    workdirPath,
-    options
-  );
-  if (!projectId) {
-    return 0;
-  }
-  const targetApmDir = apmRoot ?? workspaceApmDir(workdirPath);
-  const localPaths = listLocalDocumentPaths(targetApmDir, projectId);
-  if (localPaths.length === 0) {
-    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u672C\u5730\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u63A8\u9001");
-    return 0;
-  }
-  const remoteManifest = (await api.cli.getProjectDocumentManifest({ projectId })).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 path of localPaths) {
-    const absPath = toFsPath(
-      projectDocumentLocalPath(targetApmDir, projectId, path)
-    );
-    const content = readFileSync5(absPath, "utf8");
-    const contentHash = hashLocalFileContent(content);
-    if (remoteHashByPath.get(path) === contentHash) {
-      continue;
-    }
-    await api.cli.upsertProjectDocument({
-      projectId,
-      path,
-      content,
-      description: remoteDescriptionByPath.get(path) ?? void 0
-    });
-    synced += 1;
-    console.log(`[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: ${path}`);
-  }
-  if (synced === 0) {
-    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u53D8\u5316\uFF0C\u8DF3\u8FC7\u63A8\u9001");
-  }
-  return synced;
-}
-
-// src/commands/init.ts
-async function initializeWorkspace(workdir, options) {
-  await ensureWorkspaceApmDirForInit(workdir);
-  const apmDir = workspaceApmDir(workdir);
-  await copyTemplateFiles(apmDir, workdir);
-  const syncResult = await syncRemoteDeploymentConfig(workdir, apmDir);
-  await syncProjectDocumentsPull(workdir, apmDir);
-  const trimmedName = options?.name?.trim();
-  if (trimmedName) {
-    const apmConfigPath = toFsPath(join6(apmDir, "apm.config.json"));
-    const config = readFileSync6(apmConfigPath, "utf8");
-    const configJson = JSON.parse(config);
-    configJson.name = trimmedName;
-    writeFileSync7(
-      apmConfigPath,
-      `${JSON.stringify(configJson, null, 2)}
-`,
-      "utf8"
-    );
-  }
-  console.log(`[apm] \u5DF2\u521D\u59CB\u5316\u5DE5\u4F5C\u533A\uFF1A${apmDir}`);
-  return { didInit: true, syncResult };
-}
-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`
-  );
-  return initializeWorkspace(workdir, options);
-}
-
-// src/commands/connect/pre-step-cache.ts
-function sessionWorkdirKey(sessionId, workdir) {
-  return `${sessionId}\0${workdir}`;
-}
-var lastBranchKey = null;
-function shouldRunBranch(sessionId, workdir) {
-  return lastBranchKey !== sessionWorkdirKey(sessionId, workdir);
-}
-function markBranchDone(sessionId, workdir) {
-  lastBranchKey = sessionWorkdirKey(sessionId, workdir);
-}
-
-// src/commands/connect/webide-pull-requests.ts
-var PRE_AGENT_PR_ACTIONS = /* @__PURE__ */ new Set([
-  "generate-cases",
-  "run-auto-test",
-  // 验收合并前兜底确保 PR 存在
-  "accept"
-]);
-var POST_AGENT_PR_ACTIONS = /* @__PURE__ */ new Set(["create-pr", "finish-manual-test"]);
-function shouldEnsureWebIdePullRequests(action) {
-  return PRE_AGENT_PR_ACTIONS.has(action);
-}
-function shouldEnsureWebIdePullRequestsAfterAgent(action) {
-  return POST_AGENT_PR_ACTIONS.has(action);
-}
-function formatWebIdePullRequestSummary(result) {
-  const lines = [];
-  lines.push("## PR \u521B\u5EFA\u7ED3\u679C");
-  lines.push(
-    `\u5408\u8BA1\uFF1A\u6210\u529F ${result.ensured} \u6761\uFF0C\u65E0\u53D8\u66F4\u8DF3\u8FC7 ${result.skippedNoChanges} \u6761\uFF0C\u5176\u4ED6\u8DF3\u8FC7 ${result.skipped} \u6761\uFF0C\u5931\u8D25 ${result.failed} \u6761\u3002`
-  );
-  if (result.items.length === 0) {
-    lines.push("\u672A\u5904\u7406\u4EFB\u4F55\u4ED3\u5E93\u3002");
-    return lines.join("\n");
-  }
-  lines.push("");
-  for (const item of result.items) {
-    if (item.outcome === "created") {
-      const num = item.number != null && item.number > 0 ? `#${item.number}` : "\uFF08\u65E0\u7F16\u53F7\uFF09";
-      const branch = item.headBranch && item.baseBranch ? `${item.headBranch} \u2192 ${item.baseBranch}` : item.baseBranch ? `\u76EE\u6807\u5206\u652F ${item.baseBranch}` : "";
-      const state = item.state ? `\u72B6\u6001 ${item.state}` : "";
-      const url = item.url?.trim() ? item.url.trim() : "";
-      lines.push(
-        `- **${item.label}**\uFF1A\u5DF2\u521B\u5EFA ${num}${branch ? `\uFF0C${branch}` : ""}${state ? `\uFF0C${state}` : ""}${url ? `\uFF0C${url}` : ""}`
-      );
-      continue;
-    }
-    if (item.outcome === "skipped_no_changes") {
-      lines.push(
-        `- **${item.label}**\uFF1A\u76F8\u5BF9\u57FA\u7EBF ${item.baseBranch || "\uFF08\u672A\u77E5\uFF09"} \u65E0\u4EE3\u7801\u53D8\u66F4\uFF0C\u672A\u521B\u5EFA PR`
-      );
-      continue;
-    }
-    if (item.outcome === "skipped") {
-      lines.push(`- **${item.label}**\uFF1A\u5DF2\u8DF3\u8FC7 \u2014 ${item.detail}`);
-      continue;
-    }
-    lines.push(`- **${item.label}**\uFF1A\u521B\u5EFA\u5931\u8D25 \u2014 ${item.detail}`);
-  }
-  return lines.join("\n");
-}
-async function ensureWebIdePullRequests(cfg, taskId, workdir) {
-  const api = createApmApiClient(cfg);
-  const empty = () => ({
-    ensured: 0,
-    skipped: 0,
-    skippedNoChanges: 0,
-    failed: 0,
-    items: [],
-    tips: []
-  });
-  let repoRoots;
-  try {
-    const manifest = loadWorkspaceReposCache(workdir);
-    repoRoots = resolveWorkspaceRepoAbsolutePaths(manifest);
-  } catch (err) {
-    const tip = `\u8BFB\u53D6\u4ED3\u5E93\u6E05\u5355\u5931\u8D25: ${err instanceof Error ? err.message : err}`;
-    console.warn(`[apm] WebIDE PR\uFF1A${tip}`);
-    return {
-      ...empty(),
-      failed: 1,
-      tips: [tip],
-      items: [
-        {
-          label: "\u5DE5\u4F5C\u533A",
-          outcome: "failed",
-          detail: tip
-        }
-      ]
-    };
-  }
-  let projectBaseBranch = "";
-  try {
-    const baseline = await api.cli.projectBaseBranch({ taskId });
-    projectBaseBranch = baseline.baseBranch?.trim() ?? "";
-  } catch (err) {
-    const tip = `\u8BFB\u53D6\u9879\u76EE\u57FA\u7EBF\u5206\u652F\u5931\u8D25: ${err instanceof Error ? err.message : err}`;
-    console.warn(`[apm] WebIDE PR\uFF1A${tip}`);
-    return {
-      ...empty(),
-      failed: 1,
-      tips: [tip],
-      items: [{ label: "\u5DE5\u4F5C\u533A", outcome: "failed", detail: tip }]
+      ...empty(),
+      failed: 1,
+      tips: [tip],
+      items: [{ label: "\u5DE5\u4F5C\u533A", outcome: "failed", detail: tip }]
     };
   }
   if (!projectBaseBranch) {
@@ -3555,14 +3153,14 @@ async function ensureWebIdePullRequests(cfg, taskId, workdir) {
 }
 
 // src/version.ts
-import { readFileSync as readFileSync7 } from "fs";
-import { dirname as dirname6, join as join7 } from "path";
+import { readFileSync as readFileSync6 } from "fs";
+import { dirname as dirname5, join as join5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function readCliVersion() {
   try {
-    const dir = dirname6(fileURLToPath2(import.meta.url));
-    const pkgPath = join7(dir, "..", "package.json");
-    const pkg = JSON.parse(readFileSync7(pkgPath, "utf8"));
+    const dir = dirname5(fileURLToPath2(import.meta.url));
+    const pkgPath = join5(dir, "..", "package.json");
+    const pkg = JSON.parse(readFileSync6(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -3570,46 +3168,46 @@ function readCliVersion() {
 }
 
 // src/commands/update-skills.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync7, statSync as statSync4 } from "fs";
-import { join as join9 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync7, statSync as statSync4 } from "fs";
+import { join as join7 } from "path";
 
 // src/skills-sync.ts
 import {
   copyFileSync as copyFileSync2,
   cpSync,
-  existsSync as existsSync7,
+  existsSync as existsSync6,
   mkdirSync as mkdirSync6,
-  readdirSync as readdirSync4,
-  rmSync as rmSync3,
+  readdirSync as readdirSync3,
+  rmSync as rmSync2,
   statSync as statSync3,
-  writeFileSync as writeFileSync8
+  writeFileSync as writeFileSync6
 } from "fs";
-import { join as join8 } from "path";
-var AGENTS_TEMPLATE_PATH = join8(CLI_TEMPLATE_DIR, "AGENTS.md");
-var BASE_SKILLS_TEMPLATE_DIR = join8(CLI_TEMPLATE_DIR, "skills");
-var BASE_RULES_TEMPLATE_DIR = join8(CLI_TEMPLATE_DIR, "rules");
+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");
 function sanitizeSkillDirName(name) {
   const trimmed = name.trim();
   if (!trimmed) return "skill";
   return trimmed.replace(/[/\\:*?"<>|]/g, "_");
 }
 function listBaseSkillDirNames() {
-  if (!existsSync7(BASE_SKILLS_TEMPLATE_DIR)) return [];
-  return readdirSync4(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
-    const path = join8(BASE_SKILLS_TEMPLATE_DIR, name);
+  if (!existsSync6(BASE_SKILLS_TEMPLATE_DIR)) return [];
+  return readdirSync3(BASE_SKILLS_TEMPLATE_DIR).filter((name) => {
+    const path = join6(BASE_SKILLS_TEMPLATE_DIR, name);
     return statSync3(path).isDirectory();
   });
 }
 function syncAgentsGuide(apmDir) {
-  if (!existsSync7(AGENTS_TEMPLATE_PATH)) return false;
+  if (!existsSync6(AGENTS_TEMPLATE_PATH)) return false;
   mkdirSync6(apmDir, { recursive: true });
-  copyFileSync2(AGENTS_TEMPLATE_PATH, join8(apmDir, "AGENTS.md"));
+  copyFileSync2(AGENTS_TEMPLATE_PATH, join6(apmDir, "AGENTS.md"));
   return true;
 }
 function listBaseRuleFileNames() {
-  if (!existsSync7(BASE_RULES_TEMPLATE_DIR)) return [];
-  return readdirSync4(BASE_RULES_TEMPLATE_DIR).filter((name) => {
-    const path = join8(BASE_RULES_TEMPLATE_DIR, name);
+  if (!existsSync6(BASE_RULES_TEMPLATE_DIR)) return [];
+  return readdirSync3(BASE_RULES_TEMPLATE_DIR).filter((name) => {
+    const path = join6(BASE_RULES_TEMPLATE_DIR, name);
     return statSync3(path).isFile();
   });
 }
@@ -3617,8 +3215,8 @@ function syncBaseRules(rulesDir) {
   mkdirSync6(rulesDir, { recursive: true });
   const names = listBaseRuleFileNames();
   for (const name of names) {
-    const src = join8(BASE_RULES_TEMPLATE_DIR, name);
-    const dest = join8(rulesDir, name);
+    const src = join6(BASE_RULES_TEMPLATE_DIR, name);
+    const dest = join6(rulesDir, name);
     copyFileSync2(src, dest);
   }
   return names;
@@ -3627,8 +3225,8 @@ function syncBaseSkills(skillsDir) {
   mkdirSync6(skillsDir, { recursive: true });
   const names = listBaseSkillDirNames();
   for (const name of names) {
-    const src = join8(BASE_SKILLS_TEMPLATE_DIR, name);
-    const dest = join8(skillsDir, name);
+    const src = join6(BASE_SKILLS_TEMPLATE_DIR, name);
+    const dest = join6(skillsDir, name);
     cpSync(src, dest, { recursive: true, force: true });
   }
   return names;
@@ -3645,19 +3243,19 @@ function syncSupplementarySkills(skillsDir, list) {
       skipped.push(dirName);
       continue;
     }
-    const skillDir = join8(skillsDir, dirName);
+    const skillDir = join6(skillsDir, dirName);
     mkdirSync6(skillDir, { recursive: true });
-    writeFileSync8(join8(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
+    writeFileSync6(join6(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
     written.push(dirName);
   }
   const removed = [];
-  if (!existsSync7(skillsDir)) return { written, skipped, removed };
-  for (const entry of readdirSync4(skillsDir)) {
-    const full = join8(skillsDir, entry);
+  if (!existsSync6(skillsDir)) return { written, skipped, removed };
+  for (const entry of readdirSync3(skillsDir)) {
+    const full = join6(skillsDir, entry);
     if (!statSync3(full).isDirectory()) continue;
     if (baseNames.has(entry)) continue;
     if (apiDirNames.has(entry)) continue;
-    rmSync3(full, { recursive: true, force: true });
+    rmSync2(full, { recursive: true, force: true });
     removed.push(entry);
   }
   return { written, skipped, removed };
@@ -3667,7 +3265,7 @@ function syncSupplementarySkills(skillsDir, list) {
 async function syncWorkspaceSkills(cfg, workdir) {
   const apmDir = workspaceApmDir(workdir);
   const fsApmDir = toFsPath(apmDir);
-  if (!existsSync8(fsApmDir)) {
+  if (!existsSync7(fsApmDir)) {
     throw new Error("[apm] \u672A\u627E\u5230 .apm \u76EE\u5F55\uFF0C\u8BF7\u5148\u6267\u884C apm init");
   }
   const apmStat = statSync4(fsApmDir);
@@ -3679,12 +3277,12 @@ async function syncWorkspaceSkills(cfg, workdir) {
   if (syncAgentsGuide(apmDir)) {
     console.log("[apm] \u5DF2\u540C\u6B65 APM \u6307\u5357: .apm/AGENTS.md");
   }
-  const rulesDir = join9(apmDir, "rules");
+  const rulesDir = join7(apmDir, "rules");
   const ruleNames = syncBaseRules(rulesDir);
   for (const name of ruleNames) {
     console.log(`[apm] \u5DF2\u540C\u6B65\u57FA\u7840\u89C4\u5219: rules/${name}`);
   }
-  const skillsDir = join9(apmDir, "skills");
+  const skillsDir = join7(apmDir, "skills");
   mkdirSync7(toFsPath(skillsDir), { recursive: true });
   const baseNames = syncBaseSkills(skillsDir);
   for (const name of baseNames) {
@@ -3711,9 +3309,9 @@ async function syncWorkspaceSkills(cfg, workdir) {
 }
 
 // src/commands/sync-session-attachments.ts
-import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync9 } from "fs";
-import { join as join10 } from "path";
-var MANIFEST_FILE2 = ".sync-manifest.json";
+import { existsSync as existsSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync7 } from "fs";
+import { join as join8 } from "path";
+var MANIFEST_FILE = ".sync-manifest.json";
 async function downloadAttachment(cfg, attachmentId) {
   const base = cfg.baseUrl.trim().replace(/\/+$/, "");
   const url = `${base}/api/v1/tasks/attachments/file?${new URLSearchParams({
@@ -3728,13 +3326,13 @@ async function downloadAttachment(cfg, attachmentId) {
   return Buffer.from(await res.arrayBuffer());
 }
 function loadManifest(dir) {
-  const path = join10(dir, MANIFEST_FILE2);
-  if (!existsSync9(path)) {
+  const path = join8(dir, MANIFEST_FILE);
+  if (!existsSync8(path)) {
     return { version: 1, attachments: {} };
   }
   try {
     const parsed = JSON.parse(
-      readFileSync8(path, "utf8")
+      readFileSync7(path, "utf8")
     );
     if (parsed?.version === 1 && parsed.attachments && typeof parsed.attachments === "object") {
       return parsed;
@@ -3744,15 +3342,15 @@ function loadManifest(dir) {
   return { version: 1, attachments: {} };
 }
 function saveManifest(dir, manifest) {
-  writeFileSync9(
-    join10(dir, MANIFEST_FILE2),
+  writeFileSync7(
+    join8(dir, MANIFEST_FILE),
     `${JSON.stringify(manifest, null, 2)}
 `,
     "utf8"
   );
 }
 function isAttachmentUpToDate(entry, item, dest) {
-  if (!entry || !existsSync9(dest)) return false;
+  if (!entry || !existsSync8(dest)) return false;
   if (entry.name !== item.name) return false;
   const createdAt = item.createdAt ?? "";
   return entry.createdAt === createdAt;
@@ -3767,7 +3365,7 @@ async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
   const nextManifest = { version: 1, attachments: {} };
   const names = [];
   for (const item of attachments) {
-    const dest = join10(dir, item.name);
+    const dest = join8(dir, item.name);
     const entry = manifest.attachments[item.id];
     const createdAt = item.createdAt ?? "";
     names.push(item.name);
@@ -3777,7 +3375,7 @@ async function syncAttachmentsToDirectory(cfg, attachments, dir, logLabel) {
       continue;
     }
     const buffer = await downloadAttachment(cfg, item.id);
-    writeFileSync9(dest, buffer);
+    writeFileSync7(dest, buffer);
     nextManifest.attachments[item.id] = {
       name: item.name,
       createdAt
@@ -3797,12 +3395,279 @@ async function syncWebIdeAttachments(cfg, taskId, workdir, attachments) {
   );
 }
 
+// src/project-documents-sync.ts
+import {
+  existsSync as existsSync9,
+  readdirSync as readdirSync4,
+  readFileSync as readFileSync8,
+  rmSync as rmSync3,
+  writeFileSync as writeFileSync8
+} from "fs";
+import { createHash } from "crypto";
+import { dirname as dirname6, join as join9, relative as relative2, sep } from "path";
+var MANIFEST_FILE2 = "manifest.json";
+function normalizeProjectIdForPath(projectId) {
+  const id = projectId.trim();
+  if (!id) {
+    throw new Error("projectId \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  if (id.includes("..") || id.includes("/") || id.includes("\\") || id.includes("\0")) {
+    throw new Error(`\u975E\u6CD5 projectId: ${projectId}`);
+  }
+  return id;
+}
+function projectDocumentsDir(apmRoot, projectId) {
+  const id = normalizeProjectIdForPath(projectId);
+  return join9(apmRoot ?? workspaceApmDir(), "project", id);
+}
+function projectDocumentLocalPath(apmRoot, projectId, documentPath) {
+  const normalized = normalizeLocalDocumentPath(documentPath);
+  return join9(
+    projectDocumentsDir(apmRoot, projectId),
+    ...normalized.split("/")
+  );
+}
+function normalizeLocalDocumentPath(path) {
+  const trimmed = path.trim().replace(/\\/g, "/");
+  if (!trimmed || trimmed.startsWith("/") || /^[a-zA-Z]:/.test(trimmed)) {
+    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path}`);
+  }
+  const segments = trimmed.split("/").filter(Boolean);
+  if (segments.some((segment) => segment === ".." || segment === ".")) {
+    throw new Error(`\u975E\u6CD5\u6587\u6863\u8DEF\u5F84: ${path}`);
+  }
+  return segments.join("/");
+}
+function hashLocalFileContent(content) {
+  return createHash("sha256").update(content, "utf8").digest("hex");
+}
+function readLocalManifest(apmRoot, projectId) {
+  const manifestPath3 = join9(
+    projectDocumentsDir(apmRoot, projectId),
+    MANIFEST_FILE2
+  );
+  if (!existsSync9(manifestPath3)) {
+    return null;
+  }
+  try {
+    return JSON.parse(
+      readFileSync8(manifestPath3, "utf8")
+    );
+  } catch {
+    return null;
+  }
+}
+function listLocalDocumentPaths(apmRoot, projectId) {
+  const root = projectDocumentsDir(apmRoot, projectId);
+  if (!existsSync9(root)) {
+    return [];
+  }
+  const paths = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync4(dir, { withFileTypes: true })) {
+      const abs = join9(dir, entry.name);
+      if (entry.isDirectory()) {
+        walk(abs);
+        continue;
+      }
+      if (entry.isFile() && entry.name === MANIFEST_FILE2) {
+        continue;
+      }
+      const rel = relative2(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 [path, hash] of remoteMap) {
+    if (localMap.get(path) !== hash) {
+      download.push(path);
+    }
+  }
+  const deleteLocal = [];
+  for (const path of localMap.keys()) {
+    if (!remoteMap.has(path)) {
+      deleteLocal.push(path);
+    }
+  }
+  return { download, deleteLocal };
+}
+async function resolveProjectIdForSync(api, workdirPath, options) {
+  const explicit = options?.projectId?.trim();
+  if (explicit) {
+    return { projectId: explicit, diagnostic: null };
+  }
+  try {
+    const baseline = await api.cli.workspaceBaseline({ workdirPath });
+    const projectId = baseline.projectId?.trim() || null;
+    if (projectId) {
+      return { projectId, diagnostic: null };
+    }
+    const projectIds = baseline.projectIds ?? [];
+    if (projectIds.length === 0) {
+      return {
+        projectId: null,
+        diagnostic: baseline.diagnostic?.message ?? `\u5DE5\u4F5C\u7A7A\u95F4\u672A\u5173\u8054\u9879\u76EE\uFF0C\u65E0\u6CD5\u540C\u6B65\u9879\u76EE\u6587\u6863\uFF08\u76EE\u5F55\uFF1A${workdirPath}\uFF09\u3002
+\u8BF7\u5728\u5E73\u53F0\u5C06\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u5230\u552F\u4E00\u9879\u76EE\u3002`
+      };
+    }
+    return {
+      projectId: null,
+      diagnostic: `\u5DE5\u4F5C\u7A7A\u95F4\u5173\u8054\u4E86 ${projectIds.length} \u4E2A\u9879\u76EE\uFF0C\u65E0\u6CD5\u786E\u5B9A\u540C\u6B65\u76EE\u6807\u3002
+\u8BF7\u786E\u4FDD\u8BE5\u5DE5\u4F5C\u7A7A\u95F4\u53EA\u5173\u8054\u4E00\u4E2A\u9879\u76EE\u540E\u518D\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002`
+    };
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return {
+      projectId: null,
+      diagnostic: detail.replace(/^\[apm\]\s*/, "")
+    };
+  }
+}
+async function syncProjectDocumentsPull(workdirPath, apmDir, options) {
+  const empty = {
+    synced: false,
+    projectId: 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\u9879\u76EE\u6587\u6863\u540C\u6B65\u3002\n[apm] \u8BF7\u5148\u6267\u884C apm login\u3002"
+    );
+    return empty;
+  }
+  const api = createApmApiClient(cfg);
+  const { projectId, diagnostic } = await resolveProjectIdForSync(
+    api,
+    workdirPath,
+    options
+  );
+  if (!projectId) {
+    console.log(`[apm] \u672A\u80FD\u540C\u6B65\u9879\u76EE\u6587\u6863\u3002
+${diagnostic ?? ""}`);
+    return empty;
+  }
+  const targetApmDir = apmDir ?? workspaceApmDir(workdirPath);
+  const docsDir = projectDocumentsDir(targetApmDir, projectId);
+  await ensureDirExists(docsDir);
+  const { manifest: remoteManifest } = await api.cli.getProjectDocumentManifest(
+    { projectId }
+  );
+  if (!remoteManifest) {
+    console.log(`[apm] \u9879\u76EE ${projectId} \u65E0\u9879\u76EE\u6587\u6863 manifest\uFF0C\u8DF3\u8FC7\u540C\u6B65\u3002`);
+    return { ...empty, projectId };
+  }
+  const localManifest = readLocalManifest(targetApmDir, projectId);
+  const { download, deleteLocal } = diffManifestPaths(
+    remoteManifest,
+    localManifest
+  );
+  let downloaded = 0;
+  if (download.length > 0) {
+    const { list } = await api.cli.listProjectDocuments({
+      projectId,
+      paths: download.join(",")
+    });
+    for (const doc of list) {
+      const absPath = toFsPath(
+        projectDocumentLocalPath(targetApmDir, projectId, doc.path)
+      );
+      await ensureDirExists(dirname6(absPath));
+      writeFileSync8(absPath, doc.content, "utf8");
+      downloaded += 1;
+    }
+  }
+  let deleted = 0;
+  for (const path of deleteLocal) {
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path)
+    );
+    if (existsSync9(absPath)) {
+      rmSync3(absPath, { force: true });
+      deleted += 1;
+    }
+  }
+  writeFileSync8(
+    toFsPath(join9(docsDir, MANIFEST_FILE2)),
+    `${JSON.stringify(remoteManifest, null, 2)}
+`,
+    "utf8"
+  );
+  console.log(
+    `[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: projectId=${projectId} \u4E0B\u8F7D ${downloaded}\uFF0C\u5220\u9664\u672C\u5730 ${deleted} \u2192 .apm/project/${projectId}/`
+  );
+  return {
+    synced: true,
+    projectId,
+    downloaded,
+    deleted
+  };
+}
+async function syncProjectDocumentsPush(cfg, workdirPath, apmRoot, options) {
+  const api = createApmApiClient(cfg);
+  const { projectId } = await resolveProjectIdForSync(
+    api,
+    workdirPath,
+    options
+  );
+  if (!projectId) {
+    return 0;
+  }
+  const targetApmDir = apmRoot ?? workspaceApmDir(workdirPath);
+  const localPaths = listLocalDocumentPaths(targetApmDir, projectId);
+  if (localPaths.length === 0) {
+    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u672C\u5730\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+    return 0;
+  }
+  const remoteManifest = (await api.cli.getProjectDocumentManifest({ projectId })).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 path of localPaths) {
+    const absPath = toFsPath(
+      projectDocumentLocalPath(targetApmDir, projectId, path)
+    );
+    const content = readFileSync8(absPath, "utf8");
+    const contentHash = hashLocalFileContent(content);
+    if (remoteHashByPath.get(path) === contentHash) {
+      continue;
+    }
+    await api.cli.upsertProjectDocument({
+      projectId,
+      path,
+      content,
+      description: remoteDescriptionByPath.get(path) ?? void 0
+    });
+    synced += 1;
+    console.log(`[apm] \u5DF2\u540C\u6B65\u9879\u76EE\u6587\u6863: ${path}`);
+  }
+  if (synced === 0) {
+    console.log("[apm] \u9879\u76EE\u6587\u6863\u65E0\u53D8\u5316\uFF0C\u8DF3\u8FC7\u63A8\u9001");
+  }
+  return synced;
+}
+
 // src/commands/connect/cli-version-sync.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync10 } from "fs";
-import { join as join11 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync9 } from "fs";
+import { join as join10 } from "path";
 var CLI_VERSION_FILE = ".cli-version.json";
 function manifestPath2(apmDir) {
-  return join11(apmDir, CLI_VERSION_FILE);
+  return join10(apmDir, CLI_VERSION_FILE);
 }
 function loadManifest2(apmDir) {
   const path = toFsPath(manifestPath2(apmDir));
@@ -3822,7 +3687,7 @@ function loadManifest2(apmDir) {
 }
 function saveManifest2(apmDir, cliVersion) {
   const manifest = { version: 1, cliVersion };
-  writeFileSync10(
+  writeFileSync9(
     toFsPath(manifestPath2(apmDir)),
     `${JSON.stringify(manifest, null, 2)}
 `,