ai-project-manage-cli 4.0.22 → 5.0.1

package/dist/index.js

@@ -40,12 +40,6 @@ function defaultApmConfig() {
     email: ""
   };
 }
-function httpBaseToWsOrigin(httpBase) {
-  const u = httpBase.trim().replace(/\/+$/, "");
-  if (u.startsWith("https://")) return "wss://" + u.slice("https://".length);
-  if (u.startsWith("http://")) return "ws://" + u.slice("http://".length);
-  throw new Error("baseUrl \u5FC5\u987B\u4EE5 http:// \u6216 https:// \u5F00\u5934");
-}
 async function ensureApmConfig() {
   const existing = await readApmConfig();
   if (existing) return existing;
@@ -65,172 +59,47 @@ async function writeApmConfig(cfg) {
     mode: 384
   });
 }
-function buildAgentWsUrl(httpBase, token) {
-  const origin = httpBaseToWsOrigin(httpBase);
-  const q = new URLSearchParams({ token });
-  return `${origin}/ws/agent?${q.toString()}`;
-}
-
-// src/commands/comment.ts
-import { readFileSync as readFileSync2 } from "fs";
-
-// src/api/client.ts
-import { createApiClient } from "listpage-http";
 
-// src/api/request-config.ts
-import { defineEndpoint } from "listpage-http";
-var requestConfig = {
-  auth: {
-    login: defineEndpoint({
-      method: "POST",
-      path: "/auth/login",
-      authRequired: false
-    })
-  },
-  cliRequirements: {
-    pull: defineEndpoint({
-      method: "GET",
-      path: "/cli/requirements/pull"
-    }),
-    branchBaseline: defineEndpoint({
-      method: "GET",
-      path: "/cli/requirements/branch-baseline"
-    }),
-    comment: defineEndpoint({
-      method: "POST",
-      path: "/cli/requirements/comment"
-    }),
-    commentStructured: defineEndpoint({
-      method: "POST",
-      path: "/cli/requirements/comment-structured"
-    }),
-    refine: defineEndpoint({
-      method: "POST",
-      path: "/cli/requirements/refine"
-    }),
-    updateStatus: defineEndpoint({
-      method: "POST",
-      path: "/cli/requirements/update-status"
-    }),
-    updateDevStatus: defineEndpoint({
-      method: "POST",
-      path: "/cli/requirements/update-dev-status"
-    })
-  },
-  requirementAttachment: {
-    list: defineEndpoint({
-      method: "GET",
-      path: "/requirement-attachments/list"
-    }),
-    download: defineEndpoint({
-      method: "GET",
-      path: "/requirement-attachments/download",
-      mode: "download"
-    })
-  },
-  requirementArtifact: {
-    list: defineEndpoint({
-      method: "GET",
-      path: "/requirement-artifacts/list"
-    }),
-    get: defineEndpoint({
-      method: "GET",
-      path: "/requirement-artifacts/get"
-    }),
-    create: defineEndpoint({
-      method: "POST",
-      path: "/requirement-artifacts/create"
-    }),
-    upsert: defineEndpoint({
-      method: "POST",
-      path: "/requirement-artifacts/upsert"
-    }),
-    update: defineEndpoint({
-      method: "POST",
-      path: "/requirement-artifacts/update"
-    }),
-    delete: defineEndpoint({
-      method: "POST",
-      path: "/requirement-artifacts/delete"
-    })
-  },
-  theaterSessionArtifact: {
-    upsert: defineEndpoint({
-      method: "POST",
-      path: "/theater-session-artifacts/upsert"
-    }),
-    create: defineEndpoint({
-      method: "POST",
-      path: "/theater-session-artifacts/create"
-    }),
-    update: defineEndpoint({
-      method: "POST",
-      path: "/theater-session-artifacts/update"
-    }),
-    list: defineEndpoint({
-      method: "GET",
-      path: "/theater-session-artifacts/list"
-    }),
-    get: defineEndpoint({
-      method: "GET",
-      path: "/theater-session-artifacts/get"
-    })
-  },
-  theater: {
-    reportMemberAgentProgress: defineEndpoint({
-      method: "POST",
-      path: "/theater/sessions/report-member-agent-progress"
-    }),
-    submitMemberResponse: defineEndpoint({
-      method: "POST",
-      path: "/theater/sessions/submit-member-response"
-    })
-  },
-  spaceWorkflow: {
-    aiStartNode: defineEndpoint({
-      method: "POST",
-      path: "/space-workflows/ai-start-node"
-    }),
-    aiConfirmNode: defineEndpoint(
-      {
-        method: "POST",
-        path: "/space-workflows/ai-confirm-node"
-      }
-    ),
-    aiFailNode: defineEndpoint({
-      method: "POST",
-      path: "/space-workflows/ai-fail-node"
-    })
-  }
-};
-
-// src/api/client.ts
-function createApmApiClient(cfg) {
-  const baseURL = `${cfg.baseUrl.trim().replace(/\/+$/, "")}/api/v1`;
-  return createApiClient(requestConfig, {
-    baseURL,
-    getToken: () => cfg.token || void 0,
-    successCodes: [200, 201],
-    unauthorizedCodes: [401]
-  });
-}
+// src/commands/init.ts
+import { join as join3 } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 
 // src/command-utils.ts
 import { cpSync, existsSync, mkdirSync as mkdirSync2, readdirSync, statSync } from "fs";
-import { dirname, join as join2, resolve } from "path";
+import { basename, dirname, extname, join as join2, resolve } from "path";
 import { fileURLToPath } from "url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var CLI_TEMPLATE_DIR = resolve(__dirname, "../template");
-var WORKSPACE_APM_DIR = resolve(process.cwd(), ".apm");
-function requirementWorkitemsDir(requirementId, workspaceDir = WORKSPACE_APM_DIR) {
-  return join2(workspaceDir, "workitems", requirementId);
+function workspaceApmDir(cwd = process.cwd()) {
+  return resolve(cwd, ".apm");
+}
+var SESSIONS_SUBDIR = "sessions";
+var SESSION_DOCS_SUBDIR = "docs";
+var SESSION_ATTACHMENTS_SUBDIR = "attachments";
+function sessionDir(sessionId, apmRoot) {
+  return join2(apmRoot ?? workspaceApmDir(), SESSIONS_SUBDIR, sessionId);
+}
+function sessionDocsDir(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), SESSION_DOCS_SUBDIR);
+}
+function sessionRulePath(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), "RULE.md");
 }
-function theaterSessionDir(sessionId, apmRoot = WORKSPACE_APM_DIR) {
-  return join2(apmRoot, "theater-sessions", sessionId);
+function sessionYamlPath(sessionId, apmRoot) {
+  return join2(sessionDir(sessionId, apmRoot), "session.yaml");
 }
-function theaterSessionDocumentPath(sessionId, relativePath = "docs/prd.md", apmRoot = WORKSPACE_APM_DIR) {
-  const normalized = relativePath.replace(/\\/g, "/").replace(/^\/+/, "");
-  return join2(theaterSessionDir(sessionId, apmRoot), normalized);
+function documentLocalFileName(platformName) {
+  const trimmed = platformName.trim();
+  if (!trimmed) return "document.md";
+  if (extname(trimmed).toLowerCase() === ".md") return trimmed;
+  return `${trimmed}.md`;
+}
+function documentPlatformName(filePath) {
+  const base = basename(filePath.trim().replace(/\\/g, "/"));
+  if (base.toLowerCase().endsWith(".md")) {
+    return base.slice(0, -3);
+  }
+  return base;
 }
 async function ensureLoggedConfig() {
   const cfg = await ensureApmConfig();
@@ -246,7 +115,7 @@ async function ensureDirExists(dir) {
   mkdirSync2(dir, { recursive: true });
 }
 async function ensureWorkspaceApmDirForInit() {
-  const dir = WORKSPACE_APM_DIR;
+  const dir = workspaceApmDir();
   if (!existsSync(dir)) {
     mkdirSync2(dir, { recursive: true });
     return;
@@ -277,994 +146,92 @@ async function copyTemplateFiles(targetDir) {
     })
   );
 }
-function xmlEscape(v) {
-  return v.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
-}
 function resolveCwdPath(file) {
   return resolve(process.cwd(), file);
 }
 
-// src/structured-review-yaml.ts
-import { parse } from "yaml";
-var KIND_MAP = {
-  clarify: "CLARIFY",
-  difficulty: "DIFFICULTY",
-  business: "BUSINESS",
-  CLARIFY: "CLARIFY",
-  DIFFICULTY: "DIFFICULTY",
-  BUSINESS: "BUSINESS"
-};
-var STANCE_VALUES = /* @__PURE__ */ new Set(["frontend", "backend", "fullstack"]);
-function asRecord(value) {
-  if (value && typeof value === "object" && !Array.isArray(value)) {
-    return value;
-  }
-  throw new Error("YAML \u7ED3\u6784\u65E0\u6548\uFF1A\u9700\u8981\u5BF9\u8C61\u6839\u8282\u70B9");
-}
-function parseAnchor(anchor, index) {
-  const rec = asRecord(anchor);
-  const start = Number(rec.start ?? rec.startLine);
-  const end = Number(rec.end ?? rec.endLine);
-  if (!Number.isInteger(start) || !Number.isInteger(end) || start < 1 || end < start) {
-    throw new Error(`items[${index}].anchor \u884C\u53F7\u65E0\u6548\uFF08\u9700 1 \u2264 start \u2264 end\uFF09`);
-  }
-  return { start, end };
-}
-function parseKind(raw, index) {
-  const key = String(raw ?? "").trim();
-  const kind = KIND_MAP[key] ?? KIND_MAP[key.toLowerCase()];
-  if (!kind) {
-    if (key.toLowerCase() === "coordination" || key === "COORDINATION") {
-      throw new Error(
-        `items[${index}].kind \u4E0D\u518D\u652F\u6301 coordination\uFF08\u8054\u8C03\u4F9D\u8D56\uFF09\uFF1B\u8BF7\u52FF\u8F93\u51FA\u63A5\u53E3/\u8054\u8C03\u7C7B\u8BC4\u5BA1\u6761\u76EE`
-      );
-    }
-    throw new Error(
-      `items[${index}].kind \u65E0\u6548\uFF0C\u5E94\u4E3A clarify | difficulty | business`
-    );
-  }
-  return kind;
-}
-function parseStructuredReviewYaml(raw, cliModel) {
-  let doc;
-  try {
-    doc = parse(raw);
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
-    throw new Error(`YAML \u89E3\u6790\u5931\u8D25\uFF1A${msg}`);
-  }
-  const root = asRecord(doc);
-  const reviewer = asRecord(root.reviewer ?? {});
-  const stance = String(reviewer.stance ?? root.stance ?? "").trim();
-  if (!STANCE_VALUES.has(stance)) {
-    throw new Error("reviewer.stance \u5FC5\u987B\u4E3A frontend\u3001backend \u6216 fullstack");
-  }
-  const modelFromYaml = reviewer.model != null ? String(reviewer.model).trim() : "";
-  const model = cliModel?.trim() || modelFromYaml || null;
-  const itemsRaw = root.items;
-  if (!Array.isArray(itemsRaw) || itemsRaw.length === 0) {
-    throw new Error("items \u4E0D\u80FD\u4E3A\u7A7A");
-  }
-  const items = itemsRaw.map((entry, index) => {
-    const item = asRecord(entry);
-    const anchor = parseAnchor(item.anchor ?? item, index);
-    const kind = parseKind(item.kind, index);
-    const body = typeof item.body === "string" ? item.body.trim() : String(item.body ?? "").trim();
-    if (!body) {
-      throw new Error(`items[${index}].body \u4E0D\u80FD\u4E3A\u7A7A`);
-    }
-    return {
-      startLine: anchor.start,
-      endLine: anchor.end,
-      kind,
-      body
-    };
-  });
-  return { stance, model, items };
-}
-function inferCommentFormat(filePath, explicit) {
-  if (explicit === "structured" || explicit === "legacy") {
-    return explicit;
-  }
-  const lower = filePath.toLowerCase();
-  if (lower.endsWith(".yaml") || lower.endsWith(".yml")) {
-    return "structured";
-  }
-  return "legacy";
-}
-
-// src/commands/comment.ts
-async function runComment(requirementId, file, options) {
-  const cfg = await ensureLoggedConfig();
-  const resolvedPath = resolveCwdPath(file);
-  const raw = readFileSync2(resolvedPath, "utf8");
-  const format = inferCommentFormat(resolvedPath, options?.format);
-  const api = createApmApiClient(cfg);
-  if (format === "structured") {
-    const parsed = parseStructuredReviewYaml(raw, options?.model);
-    const data2 = await api.cliRequirements.commentStructured({
-      requirementId,
-      stance: parsed.stance,
-      model: parsed.model,
-      items: parsed.items
-    });
-    console.log(JSON.stringify(data2, null, 2));
-    return;
-  }
-  if (!raw.trim()) {
-    throw new Error("\u8BC4\u8BBA\u6B63\u6587\u4E0D\u80FD\u4E3A\u7A7A");
+// src/commands/init.ts
+async function runInit(name) {
+  await ensureWorkspaceApmDirForInit();
+  const apmDir = workspaceApmDir();
+  await copyTemplateFiles(apmDir);
+  if (name) {
+    const apmConfigPath = join3(apmDir, "apm.config.json");
+    const config = readFileSync2(apmConfigPath, "utf8");
+    const configJson = JSON.parse(config);
+    configJson.name = name;
+    writeFileSync2(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
   }
-  const data = await api.cliRequirements.comment({
-    requirementId,
-    content: raw,
-    model: options?.model
-  });
-  console.log(JSON.stringify(data, null, 2));
 }
 
-// src/commands/connect.ts
-import { randomUUID as randomUUID2 } from "crypto";
-import WebSocket from "ws";
-import { Agent } from "@cursor/sdk";
-import { join as join7 } from "path";
-
-// src/session-utils.ts
-import { appendFileSync } from "fs";
-import { resolve as resolve2 } from "path";
-var EventSession = class {
-  events = [];
-  constructor(prompt) {
-    this.events.push({
-      type: "input",
-      content: prompt
-    });
-  }
-  addEvent(event) {
-    const latestEvent = this.events[this.events.length - 1];
-    const formatedEvent = this.formatEvent(event);
-    if (!formatedEvent) {
-      return;
-    }
-    if (formatedEvent.type === "tool_call") {
-      const existingToolCall = this.events.find(
-        (e) => e.type === "tool_call" && e.call_id === formatedEvent.call_id
-      );
-      if (existingToolCall) {
-        existingToolCall.args = formatedEvent.args;
-        existingToolCall.result = formatedEvent.result;
-        existingToolCall.status = formatedEvent.status;
-        return;
-      }
-      this.events.push(formatedEvent);
-      return;
-    }
-    if (formatedEvent.type === "status") {
-      return;
-    }
-    if (formatedEvent.type === "request") {
-      this.events.push(formatedEvent);
-      return;
-    }
-    if (latestEvent?.type === formatedEvent.type) {
-      switch (formatedEvent.type) {
-        case "assistant":
-          latestEvent.content += formatedEvent.content;
-          break;
-        case "thinking":
-          latestEvent.content += formatedEvent.content;
-          break;
-        case "task":
-          latestEvent.status = formatedEvent.status;
-          latestEvent.text = formatedEvent.text;
-          break;
-      }
-      return;
-    }
-    this.events.push(formatedEvent);
-  }
-  formatEvent(event) {
-    switch (event.type) {
-      case "assistant":
-        return {
-          type: "assistant",
-          content: event.message.content[0].text || event.content || ""
-        };
-      case "thinking":
-        return {
-          type: "thinking",
-          content: event.text || event.content || ""
-        };
-      case "tool_call":
-        return {
-          type: "tool_call",
-          args: event.args,
-          result: event.result,
-          status: event.status,
-          call_id: event.call_id,
-          name: event.name
-        };
-      case "task":
-        return {
-          type: "task",
-          status: event.status,
-          text: event.text
-        };
-      case "request":
-        return {
-          ...event,
-          type: "request"
-        };
-      case "status":
-        return { type: "status", status: event.status, message: event.message };
-    }
-  }
-  /** 合并所有 assistant 片段，供剧场成员回传等场景使用 */
-  getAssistantText() {
-    return this.events.filter((e) => e.type === "assistant").map((e) => String(e.content ?? "")).join("\n").trim();
-  }
-  writeToFile(cwd, requirementId, agentId) {
-    const sessionsDir = resolve2(
-      cwd,
-      `.apm/workitems/${requirementId}/sessions`
-    );
-    ensureDirExists(sessionsDir);
-    const sessionFile = resolve2(sessionsDir, `${agentId}.md`);
-    this.events.forEach((event) => {
-      const type = event.type;
-      const content = (function(type2) {
-        if (type2 === "input") {
-          return `## \u7528\u6237\u8F93\u5165
-
-${event.content}
-`;
-        }
-        if (type2 === "assistant") {
-          return `## \u6A21\u578B\u8F93\u51FA
-
-${event.content}
-`;
-        }
-        if (type2 === "thinking") {
-          return `## \u6A21\u578B\u601D\u8003
+// src/commands/login.ts
+import { ApiError } from "listpage-http";
 
-${event.content}
-`;
-        }
-        if (type2 === "tool_call") {
-          return "````toolcall\n" + JSON.stringify(event, null, 2) + "\n````\n";
-        }
-        return `## \u672A\u77E5\u4E8B\u4EF6\uFF1A${type2}
+// src/api/client.ts
+import { createApiClient } from "listpage-http";
 
-\`\`\`json
-${JSON.stringify(event, null, 2)}
-\`\`\``;
-      })(type);
-      appendFileSync(sessionFile, content + "\n");
-    });
+// src/api/request-config.ts
+import { defineEndpoint } from "listpage-http";
+var requestConfig = {
+  auth: {
+    login: defineEndpoint({
+      method: "POST",
+      path: "/auth/login",
+      authRequired: false
+    })
+  },
+  cli: {
+    sessionDetail: defineEndpoint({
+      method: "GET",
+      path: "/cli/sessions/detail"
+    }),
+    sessionMembers: defineEndpoint({
+      method: "GET",
+      path: "/cli/sessions/members"
+    }),
+    listDocuments: defineEndpoint({
+      method: "GET",
+      path: "/cli/documents"
+    }),
+    listAttachments: defineEndpoint({
+      method: "GET",
+      path: "/cli/attachments"
+    }),
+    upsertDocument: defineEndpoint({
+      method: "PUT",
+      path: "/cli/documents/upsert"
+    }),
+    appendMessageContent: defineEndpoint({
+      method: "PUT",
+      path: "/cli/messages/content"
+    }),
+    updateMessageStatus: defineEndpoint({
+      method: "PUT",
+      path: "/cli/messages/status"
+    }),
+    branchBaseline: defineEndpoint({
+      method: "GET",
+      path: "/cli/requirements/branch-baseline"
+    }),
+    listSkills: defineEndpoint({
+      method: "GET",
+      path: "/cli/skills"
+    })
   }
 };
 
-// src/commands/upload-artifact.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join4, relative, sep } from "path";
-
-// src/commands/sync-requirement-attachments.ts
-import { existsSync as existsSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join3 } from "path";
-var REQUIREMENT_ATTACHMENTS_SUBDIR = "attachments";
-async function syncRequirementAttachments(api, requirementId, workitemsDir) {
-  const dir = join3(workitemsDir, REQUIREMENT_ATTACHMENTS_SUBDIR);
-  await ensureDirExists(dir);
-  const { items } = await api.requirementAttachment.list({ requirementId });
-  if (items.length === 0) return;
-  for (const item of items) {
-    const dest = join3(dir, item.fileName);
-    if (existsSync2(dest)) continue;
-    const { blob } = await api.requirementAttachment.download({
-      attachmentId: item.id
-    });
-    const buffer = Buffer.from(await blob.arrayBuffer());
-    writeFileSync2(dest, buffer);
-    console.log(
-      `[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${REQUIREMENT_ATTACHMENTS_SUBDIR}/${item.fileName}`
-    );
-  }
-}
-
-// src/commands/upload-artifact.ts
-var EXCLUDED_RELATIVE_PATHS = /* @__PURE__ */ new Set([
-  "defect.xml",
-  "prd.md",
-  "requirement-status.yaml",
-  "reviews.xml",
-  "testcase.xml"
-]);
-function toPosixRelative(root, absoluteFile) {
-  return relative(root, absoluteFile).split(sep).join("/");
-}
-function artifactTagFromRelPath(relPosix) {
-  const parts = relPosix.split("/");
-  const fileName = parts[parts.length - 1] ?? relPosix;
-  if (parts.length > 1) {
-    return parts[0] ?? fileName;
-  }
-  const dot = fileName.lastIndexOf(".");
-  return dot > 0 ? fileName.slice(0, dot) : fileName;
-}
-function* walkMarkdownFiles(dir) {
-  const names = readdirSync2(dir);
-  for (const name of names) {
-    if (name.startsWith(".")) continue;
-    if (name === REQUIREMENT_ATTACHMENTS_SUBDIR) continue;
-    const full = join4(dir, name);
-    const st = statSync2(full);
-    if (st.isDirectory()) {
-      yield* walkMarkdownFiles(full);
-      continue;
-    }
-    if (!st.isFile()) continue;
-    if (!name.toLowerCase().endsWith(".md")) continue;
-    yield full;
-  }
-}
-async function runUploadArtifact(requirementId, workspaceDir) {
-  const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  const root = requirementWorkitemsDir(requirementId, workspaceDir);
-  if (!existsSync3(root)) {
-    console.error(
-      `[apm] \u76EE\u5F55\u4E0D\u5B58\u5728: ${root}
-\u8BF7\u5148\u6267\u884C: apm pull ${requirementId}`
-    );
-    process.exit(1);
-  }
-  for (const abs of walkMarkdownFiles(root)) {
-    const relPosix = toPosixRelative(root, abs);
-    if (EXCLUDED_RELATIVE_PATHS.has(relPosix)) continue;
-    const content = readFileSync3(abs, "utf8");
-    const tag = artifactTagFromRelPath(relPosix);
-    await api.requirementArtifact.upsert({
-      requirementId,
-      tag,
-      fileName: relPosix,
-      content
-    });
-    console.log(`[apm] \u5DF2\u540C\u6B65\u4EA7\u7269: ${relPosix}`);
-  }
-}
-
-// src/commands/pull.ts
-import { writeFileSync as writeFileSync3 } from "fs";
-import { join as join5 } from "path";
-import { stringify as yamlStringify } from "yaml";
-
-// src/pull-reviews-xml.ts
-function escapeForCdata(text) {
-  return text.replace(/\]\]>/g, "]]]]><![CDATA[>");
-}
-function buildReviewsXml(reviews) {
-  const lines = ["<reviews>"];
-  for (const review of reviews) {
-    lines.push(
-      `  <review id="${xmlEscape(review.id)}" model="${xmlEscape(
-        review.model ?? ""
-      )}" stance="${xmlEscape(review.stance ?? "")}" memberRole="${xmlEscape(
-        review.memberRole
-      )}">`
-    );
-    for (const item of review.items) {
-      const kind = item.kind.toLowerCase();
-      lines.push(
-        `    <item id="${xmlEscape(item.id)}" start="${item.startLine}" end="${item.endLine}" kind="${xmlEscape(kind)}" status="open">`
-      );
-      lines.push(
-        `      <body><![CDATA[${escapeForCdata(item.body ?? "")}]]></body>`
-      );
-      const reply = item.reply?.trim() ?? "";
-      lines.push(`      <reply><![CDATA[${escapeForCdata(reply)}]]></reply>`);
-      lines.push("    </item>");
-    }
-    lines.push("  </review>");
-  }
-  lines.push("</reviews>", "");
-  return lines.join("\n");
-}
-
-// src/commands/pull.ts
-var PULL_ARTIFACT_FILE_NAMES = ["api.md", "backend.md"];
-function normalizeArtifactPath(fileName) {
-  return fileName.trim().replace(/\\/g, "/").replace(/^\/+/, "");
-}
-function artifactFileNameMatches(itemFileName, targetFileName) {
-  const norm = normalizeArtifactPath(itemFileName);
-  const target = normalizeArtifactPath(targetFileName);
-  if (norm === target) return true;
-  const base = norm.split("/").filter(Boolean).pop() ?? norm;
-  return base === target;
-}
-async function fetchArtifactContentByFileName(api, requirementId, fileName) {
-  const pageSize = 500;
-  let page = 1;
-  const items = [];
-  while (true) {
-    const batch = await api.requirementArtifact.list({
-      requirementId,
-      page,
-      pageSize
-    });
-    items.push(...batch.items);
-    if (batch.total === 0 || items.length >= batch.total) break;
-    page += 1;
-  }
-  const hit = items.find(
-    (item) => artifactFileNameMatches(item.fileName, fileName)
-  );
-  if (!hit) return null;
-  const art = await api.requirementArtifact.get({ artifactId: hit.id });
-  return art.content;
-}
-function valueToXmlContent(value) {
-  if (value === null || value === void 0) return "";
-  if (typeof value === "string") return xmlEscape(value);
-  if (typeof value === "number" || typeof value === "boolean") {
-    return xmlEscape(String(value));
-  }
-  return `<![CDATA[${JSON.stringify(value)}]]>`;
-}
-function recordToXmlLines(record, indent) {
-  const lines = [];
-  for (const [rawKey, val] of Object.entries(record)) {
-    const key = /^[a-zA-Z_][\w.-]*$/.test(rawKey) ? rawKey : "field";
-    lines.push(`${indent}<${key}>${valueToXmlContent(val)}</${key}>`);
-  }
-  return lines;
-}
-function unknownArrayToXml(rootName, itemName, items) {
-  const lines = [`<${rootName}>`];
-  items.forEach((item, index) => {
-    if (item !== null && typeof item === "object" && !Array.isArray(item)) {
-      lines.push(`  <${itemName} index="${index}">`);
-      lines.push(...recordToXmlLines(item, "    "));
-      lines.push(`  </${itemName}>`);
-    } else {
-      lines.push(
-        `  <${itemName} index="${index}">${valueToXmlContent(
-          item
-        )}</${itemName}>`
-      );
-    }
-  });
-  lines.push(`</${rootName}>`, "");
-  return lines.join("\n");
-}
-function escapeForCdata2(text) {
-  return text.replace(/\]\]>/g, "]]]]><![CDATA[>");
-}
-function defectsToXml(defects) {
-  const sorted = [...defects].sort(
-    (a, b) => new Date(a.createdAt ?? 0).getTime() - new Date(b.createdAt ?? 0).getTime()
-  );
-  const lines = ["<defects>"];
-  for (const d of sorted) {
-    lines.push(`  <defect id="${xmlEscape(d.id)}">`);
-    lines.push(`    <status>${xmlEscape(d.status)}</status>`);
-    lines.push(
-      `    <current><![CDATA[${escapeForCdata2(
-        d.currentState ?? ""
-      )}]]></current>`
-    );
-    lines.push(
-      `    <expected><![CDATA[${escapeForCdata2(
-        d.expectedEffect ?? ""
-      )}]]></expected>`
-    );
-    lines.push(`  </defect>`);
-  }
-  lines.push("</defects>", "");
-  return lines.join("\n");
-}
-async function runPull(requirementId, workspaceDir) {
-  const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  const data = await api.cliRequirements.pull({ requirementId });
-  const WORKITEMS_DIR = requirementWorkitemsDir(requirementId, workspaceDir);
-  await ensureDirExists(WORKITEMS_DIR);
-  const req2 = data.requirement;
-  const statusYaml = yamlStringify(
-    {
-      id: req2.id,
-      status: req2.status,
-      title: req2.title
-    },
-    { lineWidth: 0 }
-  );
-  writeFileSync3(
-    join5(WORKITEMS_DIR, "requirement-status.yaml"),
-    statusYaml.endsWith("\n") ? statusYaml : `${statusYaml}
-`,
-    "utf8"
-  );
-  writeFileSync3(join5(WORKITEMS_DIR, "prd.md"), req2.content || "", "utf8");
-  const reviewsXml = buildReviewsXml(data.reviews ?? []);
-  writeFileSync3(join5(WORKITEMS_DIR, "reviews.xml"), reviewsXml, "utf8");
-  const defectsXml = defectsToXml(data.defects ?? []);
-  writeFileSync3(join5(WORKITEMS_DIR, "defect.xml"), defectsXml, "utf8");
-  const testCasesXml = unknownArrayToXml(
-    "testcases",
-    "case",
-    data.testCases ?? []
-  );
-  writeFileSync3(join5(WORKITEMS_DIR, "testcase.xml"), testCasesXml, "utf8");
-  for (const fileName of PULL_ARTIFACT_FILE_NAMES) {
-    const content = await fetchArtifactContentByFileName(
-      api,
-      requirementId,
-      fileName
-    );
-    if (content !== null) {
-      writeFileSync3(join5(WORKITEMS_DIR, fileName), content, "utf8");
-    }
-  }
-  await syncRequirementAttachments(api, requirementId, WORKITEMS_DIR);
-  return WORKITEMS_DIR;
-}
-
-// src/commands/pull-theater-session.ts
-import { writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname2, join as join6 } from "path";
-function normalizeRelativePath(fileName) {
-  return fileName.trim().replace(/\\/g, "/").replace(/^\/+/, "");
-}
-async function runPullTheaterSession(sessionId, apmRoot = WORKSPACE_APM_DIR) {
-  const trimmedSessionId = sessionId.trim();
-  if (!trimmedSessionId) {
-    throw new Error("sessionId \u4E0D\u80FD\u4E3A\u7A7A");
-  }
-  const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  const sessionDir = theaterSessionDir(trimmedSessionId, apmRoot);
-  await ensureDirExists(sessionDir);
-  const pageSize = 500;
-  let page = 1;
-  const items = [];
-  while (true) {
-    const batch = await api.theaterSessionArtifact.list({
-      sessionId: trimmedSessionId,
-      page,
-      pageSize
-    });
-    items.push(...batch.items);
-    if (batch.total === 0 || items.length >= batch.total) break;
-    page += 1;
-  }
-  for (const item of items) {
-    const art = await api.theaterSessionArtifact.get({
-      sessionId: trimmedSessionId,
-      artifactId: item.id
-    });
-    const relativePath = normalizeRelativePath(art.fileName);
-    const destPath = join6(sessionDir, relativePath);
-    await ensureDirExists(dirname2(destPath));
-    writeFileSync4(destPath, art.content, "utf8");
-    console.log(`[apm] \u5DF2\u8986\u76D6\u4F1A\u8BDD\u6587\u6863: ${relativePath}`);
-  }
-  return sessionDir;
-}
-
-// src/theater-job-report.ts
-import { randomUUID } from "crypto";
-function extractErrorMessage(err) {
-  if (err instanceof Error && err.message.trim()) {
-    return err.message.trim();
-  }
-  if (typeof err === "string" && err.trim()) {
-    return err.trim();
-  }
-  if (typeof err === "object" && err && "message" in err) {
-    const msg = err.message;
-    if (typeof msg === "string" && msg.trim()) return msg.trim();
-    if (Array.isArray(msg)) return msg.map(String).join("\uFF1B");
-  }
-  return "\u672A\u77E5\u9519\u8BEF";
-}
-function isUnauthorizedMessage(msg) {
-  return msg.includes("\u672A\u767B\u5F55") || /401/.test(msg);
-}
-function sendTheaterReportWs(ws, payload) {
-  return new Promise((resolve5, reject) => {
-    const msg_id = randomUUID();
-    const timer = setTimeout(() => {
-      ws.off("message", onMessage);
-      reject(new Error("WebSocket \u4E0A\u62A5\u8D85\u65F6"));
-    }, 3e4);
-    const onMessage = (data) => {
-      const text = typeof data === "string" ? data : data.toString();
-      let frame;
-      try {
-        frame = JSON.parse(text);
-      } catch {
-        return;
-      }
-      if (frame.msg_id !== msg_id) return;
-      clearTimeout(timer);
-      ws.off("message", onMessage);
-      if (frame.type === "ERROR") {
-        reject(
-          new Error(frame.payload?.message?.trim() || "WebSocket \u4E0A\u62A5\u5931\u8D25")
-        );
-        return;
-      }
-      if (frame.type === "ACK") {
-        resolve5();
-        return;
-      }
-    };
-    ws.on("message", onMessage);
-    ws.send(
-      JSON.stringify({
-        type: "THEATER_REPORT",
-        msg_id,
-        ts: (/* @__PURE__ */ new Date()).toISOString(),
-        payload
-      })
-    );
-  });
-}
-async function reportTheaterProgress(api, ws, params) {
-  const body = {
-    sessionId: params.sessionId,
-    memberKey: params.memberKey,
-    status: "IN_PROGRESS",
-    logId: params.logId
-  };
-  try {
-    await api.theater.reportMemberAgentProgress(body);
-  } catch (err) {
-    const msg = extractErrorMessage(err);
-    if (!isUnauthorizedMessage(msg)) throw err;
-    await sendTheaterReportWs(ws, { action: "progress", ...body });
-  }
-}
-async function submitTheaterResult(api, ws, params) {
-  const body = {
-    sessionId: params.sessionId,
-    memberKey: params.memberKey,
-    content: params.content,
-    agentId: params.agentId ?? "",
-    agentStatus: params.agentStatus,
-    logId: params.logId
-  };
-  try {
-    await api.theater.submitMemberResponse(body);
-  } catch (err) {
-    const msg = extractErrorMessage(err);
-    if (!isUnauthorizedMessage(msg)) throw err;
-    await sendTheaterReportWs(ws, {
-      action: "submit",
-      sessionId: params.sessionId,
-      memberKey: params.memberKey,
-      content: params.content,
-      agentId: params.agentId,
-      agentStatus: params.agentStatus,
-      logId: params.logId
-    });
-  }
-}
-async function submitTheaterFailure(api, ws, params) {
-  const content = `[${params.stage}] ${params.error}`;
-  try {
-    await submitTheaterResult(api, ws, {
-      sessionId: params.sessionId,
-      memberKey: params.memberKey,
-      content,
-      agentId: params.agentId,
-      agentStatus: "FAILED",
-      logId: params.logId
-    });
-    return true;
-  } catch (submitErr) {
-    console.error(
-      "[apm] \u65E0\u6CD5\u5C06\u5931\u8D25\u72B6\u6001\u5199\u5165\u5267\u573A\u4F1A\u8BDD:",
-      extractErrorMessage(submitErr)
-    );
-    return false;
-  }
-}
-function logTheaterJobError(stage, err, meta) {
-  const msg = extractErrorMessage(err);
-  const ctx = [
-    meta?.sessionId ? `session=${meta.sessionId}` : "",
-    meta?.memberKey ? `member=${meta.memberKey}` : ""
-  ].filter(Boolean).join(" ");
-  console.error(
-    `[apm] \u5267\u573A THEATER_JOB \u5931\u8D25 \xB7 \u9636\u6BB5=${stage}${ctx ? ` \xB7 ${ctx}` : ""} \xB7 ${msg}`
-  );
-  if (isUnauthorizedMessage(msg)) {
-    console.error("[apm] \u63D0\u793A: \u8BF7\u6267\u884C apm login \u91CD\u65B0\u767B\u5F55\u540E\u518D\u8BD5");
-  }
-}
-
-// src/commands/connect.ts
-var DEFAULT_AGENT_MODEL_ID = "default";
-function resolveAgentModelId(model) {
-  const id = model?.trim();
-  return id || DEFAULT_AGENT_MODEL_ID;
-}
-async function createAgentForJob(payload) {
-  const options = {
-    apiKey: payload.apiKey,
-    model: { id: resolveAgentModelId(payload.model) },
-    local: { cwd: payload.cwd }
-  };
-  if (payload.agentId) {
-    return Agent.resume(payload.agentId, options);
-  }
-  return Agent.create(options);
-}
-async function runAgentStream(payload, session, agent) {
-  const run = await agent.send(payload.prompt);
-  let failed = false;
-  let failReason = "";
-  for await (const event of run.stream()) {
-    if (event.type === "status") {
-      console.log(`[Status]`, event.message || event.status);
-      if (event.status === "ERROR") {
-        failed = true;
-        failReason = event.message?.trim() ?? "";
-        console.error("[apm] Agent \u6267\u884C\u5931\u8D25:", failReason || "(\u65E0\u5931\u8D25\u539F\u56E0)");
-        break;
-      }
-      continue;
-    }
-    if (event.type === "assistant") {
-      const output = event.message.content[0].text;
-      console.log(`[Output]`, output);
-      session.addEvent(event);
-      continue;
-    }
-    if (event.type === "thinking") {
-      console.log(`[Thinking]`, event.text);
-      continue;
-    }
-    if (event.type === "tool_call") {
-      if (event.status === "completed" || event.status === "error") {
-        console.log(`[ToolCall(${event.call_id}) Result]`);
-      }
-      session.addEvent(event);
-      continue;
-    }
-    if (event.type === "task") {
-      console.log(`[Task:${event.status}]`);
-      session.addEvent(event);
-      continue;
-    }
-    if (event.type === "request") {
-      console.log(JSON.stringify(event, null, 2));
-      session.addEvent(event);
-      continue;
-    }
-    console.log("\u672A\u77E5\u4E8B\u4EF6:", JSON.stringify(event, null, 2));
-  }
-  return { agentId: run.agentId, failed, failReason };
-}
-async function handleTheaterJob(api, ws, payload) {
-  const sessionId = payload.theaterSessionId.trim();
-  const memberKey = payload.memberKey.trim();
-  const logId = payload.logId?.trim() || void 0;
-  if (!sessionId) {
-    throw new Error("THEATER_JOB \u7F3A\u5C11 theaterSessionId");
-  }
-  if (!memberKey) {
-    throw new Error("THEATER_JOB \u7F3A\u5C11 memberKey");
-  }
-  console.log("[apm] \u5267\u573A\u4F1A\u8BDD:", sessionId, "\u6210\u5458:", memberKey);
-  const apmRoot = join7(payload.cwd, ".apm");
-  let agentId = payload.agentId?.trim() || void 0;
-  try {
-    await reportTheaterProgress(api, ws, { sessionId, memberKey, logId });
-  } catch (err) {
-    logTheaterJobError("\u4E0A\u62A5\u6267\u884C\u8FDB\u5EA6", err, { sessionId, memberKey });
-    await submitTheaterFailure(api, ws, {
-      sessionId,
-      memberKey,
-      logId,
-      agentId,
-      stage: "\u4E0A\u62A5\u8FDB\u5EA6",
-      error: extractErrorMessage(err)
-    });
-    return;
-  }
-  try {
-    await runPullTheaterSession(sessionId, apmRoot);
-  } catch (pullErr) {
-    logTheaterJobError("\u62C9\u53D6\u4F1A\u8BDD\u6587\u6863", pullErr, { sessionId, memberKey });
-    await submitTheaterFailure(api, ws, {
-      sessionId,
-      memberKey,
-      logId,
-      agentId,
-      stage: "\u62C9\u53D6\u4F1A\u8BDD\u6587\u6863",
-      error: extractErrorMessage(pullErr)
-    });
-    return;
-  }
-  try {
-    const eventSession = new EventSession(payload.prompt);
-    const agent = await createAgentForJob(payload);
-    const runResult = await runAgentStream(payload, eventSession, agent);
-    agentId = runResult.agentId;
-    const assistantText = eventSession.getAssistantText();
-    const content = runResult.failed ? runResult.failReason || assistantText || "\u672A\u77E5\u9519\u8BEF" : assistantText || "[Agent \u672A\u4EA7\u751F\u6587\u672C\u8F93\u51FA]";
-    await submitTheaterResult(api, ws, {
-      sessionId,
-      memberKey,
-      content,
-      agentId,
-      agentStatus: runResult.failed ? "FAILED" : "SUCCESS",
-      logId
-    });
-    console.log(
-      "[apm] \u5267\u573A\u6210\u5458\u56DE\u590D\u5DF2\u63D0\u4EA4",
-      runResult.failed ? "(\u6267\u884C\u5931\u8D25)" : ""
-    );
-  } catch (err) {
-    logTheaterJobError("\u6267\u884C\u6216\u63D0\u4EA4\u56DE\u590D", err, { sessionId, memberKey });
-    const reported = await submitTheaterFailure(api, ws, {
-      sessionId,
-      memberKey,
-      logId,
-      agentId,
-      stage: "\u6267\u884C\u4EFB\u52A1",
-      error: extractErrorMessage(err)
-    });
-    if (reported) {
-      console.error("[apm] \u5DF2\u5C06\u5931\u8D25\u539F\u56E0\u5199\u5165\u5267\u573A\u4F1A\u8BDD\uFF0C\u53EF\u5728\u7F51\u9875\u67E5\u770B");
-    }
-  }
-}
-async function handleWorkflowJob(api, payload) {
-  const apmRoot = join7(payload.cwd, ".apm");
-  console.log("[apm] ROOT:", apmRoot);
-  console.log("[apm] workflow node:", payload.nodeId);
-  try {
-    await runPull(payload.requirementId, apmRoot);
-  } catch (pullErr) {
-    console.error("[apm] apm pull \u5931\u8D25:", pullErr);
-    throw pullErr;
-  }
-  const agent = await createAgentForJob(payload);
-  await api.cliRequirements.updateDevStatus({
-    requirementId: payload.requirementId,
-    status: "WORKING"
-  });
-  await api.spaceWorkflow.aiStartNode({
-    requirementId: payload.requirementId,
-    nodeId: payload.nodeId,
-    agentId: agent.agentId
-  });
-  const session = new EventSession(payload.prompt);
-  const { agentId, failed, failReason } = await runAgentStream(
-    payload,
-    session,
-    agent
-  );
-  await api.cliRequirements.updateDevStatus({
-    requirementId: payload.requirementId,
-    status: "IDLE"
-  });
-  session.writeToFile(payload.cwd, payload.requirementId, agentId);
-  if (failed) {
-    const failResult = await api.spaceWorkflow.aiFailNode({
-      requirementId: payload.requirementId,
-      nodeId: payload.nodeId,
-      error: failReason
-    });
-    console.log("[apm] \u5DE5\u4F5C\u6D41\u8282\u70B9\u72B6\u6001:", failResult.nodeStatus);
-    return;
-  }
-  console.log("[Done]");
-  try {
-    await runUploadArtifact(payload.requirementId, apmRoot);
-  } catch (pullErr) {
-    console.error("[apm] apm upload-artifact \u5931\u8D25:", pullErr);
-    throw pullErr;
-  }
-  const confirmResult = await api.spaceWorkflow.aiConfirmNode({
-    requirementId: payload.requirementId,
-    nodeId: payload.nodeId
+// src/api/client.ts
+function createApmApiClient(cfg) {
+  const baseURL = `${cfg.baseUrl.trim().replace(/\/+$/, "")}/api`;
+  return createApiClient(requestConfig, {
+    baseURL,
+    getToken: () => cfg.token || void 0,
+    successCodes: [0],
+    unauthorizedCodes: [401]
   });
-  console.log("[apm] \u5DE5\u4F5C\u6D41\u8282\u70B9\u72B6\u6001:", confirmResult.nodeStatus);
-}
-function runConnect(opts) {
-  void (async () => {
-    const cfg = await ensureApmConfig();
-    const server = opts.server?.trim();
-    if (server) {
-      cfg.baseUrl = server.replace(/\/+$/, "");
-      await writeApmConfig(cfg);
-    }
-    if (!cfg.token) {
-      console.error(
-        "[apm] \u672A\u68C0\u6D4B\u5230 token\uFF0C\u8BF7\u5148\u6267\u884C: apm login --email ... --password ..."
-      );
-      console.error(`[apm] \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84: ${APM_CONFIG_PATH}`);
-      process.exit(1);
-    }
-    const api = createApmApiClient(cfg);
-    const url = buildAgentWsUrl(cfg.baseUrl, cfg.token);
-    console.error(`[apm] \u8FDE\u63A5 ${url.replace(cfg.token, "<token>")} \u2026`);
-    const ws = new WebSocket(url);
-    ws.on("open", () => {
-      console.error("[apm] \u5DF2\u8FDE\u63A5");
-      const sendHeartbeat = () => {
-        const frame = {
-          type: "HEARTBEAT",
-          msg_id: randomUUID2(),
-          ts: (/* @__PURE__ */ new Date()).toISOString(),
-          payload: {}
-        };
-        ws.send(JSON.stringify(frame));
-      };
-      sendHeartbeat();
-      const interval = setInterval(sendHeartbeat, 15e3);
-      ws.on("close", () => clearInterval(interval));
-    });
-    ws.on("message", async (data) => {
-      const text = typeof data === "string" ? data : data.toString();
-      let msg;
-      try {
-        msg = JSON.parse(text);
-      } catch (err) {
-        console.error(
-          "[apm] \u65E0\u6CD5\u89E3\u6790 WebSocket \u6D88\u606F:",
-          text,
-          err.message
-        );
-        return;
-      }
-      try {
-        const jobType = msg.type;
-        if (jobType === "THEATER_JOB") {
-          await handleTheaterJob(api, ws, msg.payload);
-          return;
-        }
-        if (jobType === "JOB") {
-          await handleWorkflowJob(api, msg.payload);
-          return;
-        }
-      } catch (err) {
-        const jobType = msg.type;
-        const label = jobType === "THEATER_JOB" ? "\u5267\u573A THEATER_JOB" : jobType === "JOB" ? "\u5DE5\u4F5C\u6D41 JOB" : String(jobType);
-        console.error(`[apm] ${label} \u5904\u7406\u5931\u8D25:`, extractErrorMessage(err));
-      }
-    });
-    ws.on("error", (err) => {
-      console.error("[apm] WebSocket \u9519\u8BEF:", err.message);
-    });
-    ws.on("close", (code, reason) => {
-      console.error(`[apm] \u8FDE\u63A5\u5173\u95ED code=${code} reason=${reason.toString()}`);
-      process.exit(code === 1e3 ? 0 : 1);
-    });
-  })();
-}
-
-// src/commands/init.ts
-import { join as join8 } from "path";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
-async function runInit(name) {
-  await ensureWorkspaceApmDirForInit();
-  await copyTemplateFiles(WORKSPACE_APM_DIR);
-  if (name) {
-    const apmConfigPath = join8(WORKSPACE_APM_DIR, "apm.config.json");
-    const config = readFileSync4(apmConfigPath, "utf8");
-    const configJson = JSON.parse(config);
-    configJson.name = name;
-    writeFileSync5(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
-  }
 }
 
 // src/commands/login.ts
-import { ApiError } from "listpage-http";
 async function runLogin(opts) {
   const baseUrl = (opts.server?.trim() || process.env.AI_PM_SERVER?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
   const api = createApmApiClient({
@@ -1310,15 +277,15 @@ async function runLogin(opts) {
 
 // src/commands/branch.ts
 import { execFile } from "child_process";
-import { resolve as resolve3 } from "path";
+import { resolve as resolve2 } from "path";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
-async function fetchBaselineBranchFromApi(requirementId, cwd) {
+async function fetchBaselineBranchFromApi(sessionId, cwd) {
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
-  const workdirPath = resolve3(cwd);
-  const res = await api.cliRequirements.branchBaseline({
-    requirementId,
+  const workdirPath = resolve2(cwd);
+  const res = await api.cli.branchBaseline({
+    sessionId,
     workdirPath
   });
   if (!res.repositoryId) {
@@ -1395,17 +362,26 @@ async function localBranchExists(cwd, branch) {
     return false;
   }
 }
-async function runBranch(requirementId, options = {}) {
+async function commitWorkingTreeIfDirty(cwd, message) {
+  await ensureGitRepo(cwd);
+  if (!await isWorkingTreeDirty(cwd)) {
+    return false;
+  }
+  const commitMessage = message?.trim() || `chore(apm): \u540C\u6B65\u5DE5\u4F5C\u533A (${await getCurrentBranch(cwd)})`;
+  await execGit(cwd, ["add", "-A"]);
+  await execGit(cwd, ["commit", "-m", commitMessage]);
+  console.log(`[apm] \u5DF2\u63D0\u4EA4\u5DE5\u4F5C\u533A\u53D8\u66F4: ${commitMessage}`);
+  return true;
+}
+async function ensureFeatureBranch(branch, options, fetchBaseline) {
   const cwd = options.cwd ?? process.cwd();
-  const branch = branchNameForRequirement(requirementId);
   const commitMessage = options.message?.trim() || `chore(apm): \u540C\u6B65\u5DE5\u4F5C\u533A (${branch})`;
   await ensureGitRepo(cwd);
   const current = await getCurrentBranch(cwd);
   const dirty = await isWorkingTreeDirty(cwd);
   if (dirty) {
     if (current === branch) {
-      await execGit(cwd, ["add", "-A"]);
-      await execGit(cwd, ["commit", "-m", commitMessage]);
+      await commitWorkingTreeIfDirty(cwd, commitMessage);
     } else {
       await execGit(cwd, [
         "stash",
@@ -1433,10 +409,7 @@ async function runBranch(requirementId, options = {}) {
       if (hasLocal) {
         await execGit(cwd, ["checkout", branch]);
       } else {
-        const baselineBranch = await fetchBaselineBranchFromApi(
-          requirementId,
-          cwd
-        );
+        const baselineBranch = await fetchBaseline();
         await execGit(cwd, ["fetch", "origin", baselineBranch]);
         await execGit(cwd, [
           "checkout",
@@ -1451,32 +424,129 @@ async function runBranch(requirementId, options = {}) {
   console.log(`[apm] \u5DF2\u5C31\u7EEA\u5206\u652F ${branch}`);
   return branch;
 }
+async function runBranch(sessionId, options = {}) {
+  const trimmedSessionId = sessionId.trim();
+  if (!trimmedSessionId) {
+    console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
+    process.exit(1);
+  }
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const cwd = options.cwd ?? process.cwd();
+  const baseline = await api.cli.branchBaseline({
+    sessionId: trimmedSessionId,
+    workdirPath: resolve2(cwd)
+  });
+  const branch = branchNameForRequirement(baseline.requirementId);
+  return ensureFeatureBranch(
+    branch,
+    options,
+    () => fetchBaselineBranchFromApi(trimmedSessionId, cwd)
+  );
+}
+
+// src/commands/pull.ts
+import { writeFileSync as writeFileSync4 } from "fs";
+import { join as join5 } from "path";
+import { stringify as yamlStringify } from "yaml";
+
+// src/commands/sync-session-attachments.ts
+import { writeFileSync as writeFileSync3 } from "fs";
+import { join as join4 } from "path";
+async function downloadAttachment(cfg, sessionId, attachmentId) {
+  const base = cfg.baseUrl.trim().replace(/\/+$/, "");
+  const q = new URLSearchParams({ sessionId, attachmentId });
+  const url = `${base}/api/cli/attachments/file?${q.toString()}`;
+  const res = await fetch(url, {
+    headers: { Authorization: `Bearer ${cfg.token}` }
+  });
+  if (!res.ok) {
+    throw new Error(
+      `[apm] \u4E0B\u8F7D\u9644\u4EF6\u5931\u8D25 (${res.status}): attachmentId=${attachmentId}`
+    );
+  }
+  return Buffer.from(await res.arrayBuffer());
+}
+async function syncSessionAttachments(cfg, sessionId, attachments, apmRoot) {
+  if (attachments.length === 0) return;
+  const dir = join4(sessionDir(sessionId, apmRoot), SESSION_ATTACHMENTS_SUBDIR);
+  await ensureDirExists(dir);
+  for (const item of attachments) {
+    const dest = join4(dir, item.name);
+    const buffer = await downloadAttachment(cfg, sessionId, item.id);
+    writeFileSync3(dest, buffer);
+    console.log(
+      `[apm] \u5DF2\u4E0B\u8F7D\u9644\u4EF6: ${SESSION_ATTACHMENTS_SUBDIR}/${item.name}`
+    );
+  }
+}
 
-// src/commands/refine.ts
-import { readFileSync as readFileSync5 } from "fs";
-import { join as join9 } from "path";
-async function runRefine(requirementId) {
+// src/commands/pull.ts
+async function runPull(sessionId, apmRoot) {
+  const trimmedId = sessionId.trim();
+  if (!trimmedId) {
+    console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
+    process.exit(1);
+  }
   const cfg = await ensureLoggedConfig();
-  const filePath = join9(WORKSPACE_APM_DIR, "workitems", requirementId, "prd.md");
-  const content = readFileSync5(filePath, "utf8");
   const api = createApmApiClient(cfg);
-  const data = await api.cliRequirements.refine({ requirementId, content });
-  console.log(JSON.stringify(data, null, 2));
+  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 dir = sessionDir(trimmedId, apmRoot);
+  const docsDir = sessionDocsDir(trimmedId, apmRoot);
+  await ensureDirExists(docsDir);
+  writeFileSync4(
+    sessionRulePath(trimmedId, apmRoot),
+    detail.description ?? "",
+    "utf8"
+  );
+  for (const doc of documents) {
+    const fileName = documentLocalFileName(doc.name);
+    writeFileSync4(join5(docsDir, fileName), doc.content ?? "", "utf8");
+  }
+  const sessionYaml = yamlStringify(
+    {
+      name: detail.title,
+      description: "./RULE.md",
+      members: members.map((m) => ({
+        name: m.displayName,
+        position: m.position,
+        system_persona: m.systemPersona,
+        skills: []
+      })),
+      skills: [],
+      attachments: attachments.map((a) => ({ name: a.name }))
+    },
+    { lineWidth: 0 }
+  );
+  writeFileSync4(
+    sessionYamlPath(trimmedId, apmRoot),
+    sessionYaml.endsWith("\n") ? sessionYaml : `${sessionYaml}
+`,
+    "utf8"
+  );
+  await syncSessionAttachments(cfg, trimmedId, attachments, apmRoot);
+  console.log(`[apm] \u5DF2\u540C\u6B65\u4F1A\u8BDD\u5DE5\u4F5C\u533A: ${dir}`);
+  return dir;
 }
 
 // src/commands/update.ts
 import { spawnSync } from "child_process";
 
 // src/version.ts
-import { readFileSync as readFileSync6 } from "fs";
-import { dirname as dirname3, join as join10 } from "path";
+import { readFileSync as readFileSync3 } 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";
 function readCliVersion() {
   try {
-    const dir = dirname3(fileURLToPath2(import.meta.url));
-    const pkgPath = join10(dir, "..", "package.json");
-    const pkg = JSON.parse(readFileSync6(pkgPath, "utf8"));
+    const dir = dirname2(fileURLToPath2(import.meta.url));
+    const pkgPath = join6(dir, "..", "package.json");
+    const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -1543,147 +613,139 @@ async function runUpdate() {
 }
 
 // src/commands/update-skills.ts
-import { cpSync as cpSync2, existsSync as existsSync4, rmSync, statSync as statSync3 } from "fs";
-import { join as join11 } from "path";
-var TEMPLATE_SKILLS_DIR = join11(CLI_TEMPLATE_DIR, "skills");
+import { existsSync as existsSync2, mkdirSync as mkdirSync3, rmSync, statSync as statSync2, writeFileSync as writeFileSync5 } from "fs";
+import { join as join7 } from "path";
+function sanitizeDirName(name) {
+  const trimmed = name.trim();
+  if (!trimmed) return "skill";
+  return trimmed.replace(/[/\\:*?"<>|]/g, "_");
+}
 async function runUpdateSkills() {
-  const apmDir = WORKSPACE_APM_DIR;
-  if (!existsSync4(apmDir)) {
+  const apmDir = workspaceApmDir();
+  if (!existsSync2(apmDir)) {
     console.error("[apm] \u672A\u627E\u5230 .apm \u76EE\u5F55\uFF0C\u8BF7\u5148\u6267\u884C apm init");
     process.exit(1);
   }
-  const apmStat = statSync3(apmDir);
+  const apmStat = statSync2(apmDir);
   if (!apmStat.isDirectory()) {
     throw new Error(`[apm] \u8DEF\u5F84\u5DF2\u5B58\u5728\u4F46\u4E0D\u662F\u76EE\u5F55: ${apmDir}`);
   }
-  let templateStat;
-  try {
-    templateStat = statSync3(TEMPLATE_SKILLS_DIR);
-  } catch {
-    throw new Error(`[apm] \u5185\u7F6E\u6280\u80FD\u6A21\u677F\u4E0D\u5B58\u5728: ${TEMPLATE_SKILLS_DIR}`);
-  }
-  if (!templateStat.isDirectory()) {
-    throw new Error(`[apm] \u5185\u7F6E\u6280\u80FD\u6A21\u677F\u4E0D\u662F\u76EE\u5F55: ${TEMPLATE_SKILLS_DIR}`);
-  }
-  const skillsDir = join11(apmDir, "skills");
-  if (existsSync4(skillsDir)) {
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const { list } = await api.cli.listSkills({});
+  const skillsDir = join7(apmDir, "skills");
+  if (existsSync2(skillsDir)) {
     rmSync(skillsDir, { recursive: true, force: true });
   }
-  await ensureDirExists(apmDir);
-  cpSync2(TEMPLATE_SKILLS_DIR, skillsDir, { recursive: true });
-  console.log("[apm] \u5DF2\u66F4\u65B0 .apm/skills");
-}
-
-// src/commands/update-theater-skills.ts
-import { cpSync as cpSync3, existsSync as existsSync5, rmSync as rmSync2, statSync as statSync4 } from "fs";
-import { join as join12 } from "path";
-var TEMPLATE_THEATER_SKILLS_DIR = join12(CLI_TEMPLATE_DIR, "theater-skills");
-async function runUpdateTheaterSkills() {
-  const apmDir = WORKSPACE_APM_DIR;
-  if (!existsSync5(apmDir)) {
-    console.error("[apm] \u672A\u627E\u5230 .apm \u76EE\u5F55\uFF0C\u8BF7\u5148\u6267\u884C apm init");
-    process.exit(1);
-  }
-  const apmStat = statSync4(apmDir);
-  if (!apmStat.isDirectory()) {
-    throw new Error(`[apm] \u8DEF\u5F84\u5DF2\u5B58\u5728\u4F46\u4E0D\u662F\u76EE\u5F55: ${apmDir}`);
-  }
-  let templateStat;
-  try {
-    templateStat = statSync4(TEMPLATE_THEATER_SKILLS_DIR);
-  } catch {
-    throw new Error(
-      `[apm] \u5185\u7F6E\u5267\u573A\u6280\u80FD\u6A21\u677F\u4E0D\u5B58\u5728: ${TEMPLATE_THEATER_SKILLS_DIR}`
-    );
+  mkdirSync3(skillsDir, { recursive: true });
+  for (const skill of list) {
+    const dirName = sanitizeDirName(skill.name);
+    const skillDir = join7(skillsDir, dirName);
+    mkdirSync3(skillDir, { recursive: true });
+    writeFileSync5(join7(skillDir, "SKILL.md"), skill.content ?? "", "utf8");
+    console.log(`[apm] \u5DF2\u5199\u5165\u6280\u80FD: skills/${dirName}/SKILL.md`);
   }
-  if (!templateStat.isDirectory()) {
-    throw new Error(
-      `[apm] \u5185\u7F6E\u5267\u573A\u6280\u80FD\u6A21\u677F\u4E0D\u662F\u76EE\u5F55: ${TEMPLATE_THEATER_SKILLS_DIR}`
-    );
-  }
-  const theaterSkillsDir = join12(apmDir, "theater-skills");
-  if (existsSync5(theaterSkillsDir)) {
-    rmSync2(theaterSkillsDir, { recursive: true, force: true });
-  }
-  await ensureDirExists(apmDir);
-  cpSync3(TEMPLATE_THEATER_SKILLS_DIR, theaterSkillsDir, { recursive: true });
-  console.log("[apm] \u5DF2\u66F4\u65B0 .apm/theater-skills");
+  console.log(`[apm] \u5DF2\u66F4\u65B0 ${list.length} \u4E2A\u6280\u80FD\u5230 .apm/skills`);
 }
 
-// src/commands/sync-session-document.ts
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
-var DEFAULT_RELATIVE_PATH = "docs/prd.md";
-async function runSyncSessionDocument(sessionId, options) {
+// src/commands/sync-document.ts
+import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
+async function runSyncDocument(sessionId, options) {
   const trimmedSessionId = sessionId.trim();
   if (!trimmedSessionId) {
     console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
     process.exit(1);
   }
-  const relativePath = (options?.file?.trim() || DEFAULT_RELATIVE_PATH).replace(
-    /\\/g,
-    "/"
-  );
-  const apmRoot = options?.apmRoot ?? WORKSPACE_APM_DIR;
-  const absPath = theaterSessionDocumentPath(
-    trimmedSessionId,
-    relativePath,
-    apmRoot
-  );
-  if (!existsSync6(absPath)) {
-    console.error(`[apm] \u6587\u6863\u4E0D\u5B58\u5728: ${absPath}
-\u8BF7\u5148\u521B\u5EFA\u8BE5\u6587\u4EF6\u540E\u518D\u540C\u6B65`);
+  const fileArg = options.file?.trim();
+  if (!fileArg) {
+    console.error("[apm] \u8BF7\u6307\u5B9A --file <\u672C\u5730\u8DEF\u5F84>");
     process.exit(1);
   }
-  const content = readFileSync7(absPath, "utf8");
+  const absPath = resolveCwdPath(fileArg);
+  if (!existsSync3(absPath)) {
+    console.error(`[apm] \u6587\u6863\u4E0D\u5B58\u5728: ${absPath}`);
+    process.exit(1);
+  }
+  const content = readFileSync4(absPath, "utf8");
+  const name = documentPlatformName(absPath);
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
-  const data = await api.theaterSessionArtifact.upsert({
+  const doc = await api.cli.upsertDocument({
     sessionId: trimmedSessionId,
-    fileName: relativePath,
+    name,
     content
   });
-  console.log(`[apm] \u5DF2\u540C\u6B65\u4F1A\u8BDD\u6587\u6863: ${relativePath} (artifactId=${data.id})`);
+  console.log(`[apm] \u5DF2\u540C\u6B65\u6587\u6863: ${name} (id=${doc.id})`);
 }
 
-// src/commands/update-dev-status.ts
-async function runUpdateDevStatus(requirementId, status) {
+// src/commands/append-message.ts
+import { existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
+async function runAppendMessage(options) {
+  const messageId = options.id?.trim();
+  if (!messageId) {
+    console.error("[apm] \u8BF7\u6307\u5B9A --id <messageId>");
+    process.exit(1);
+  }
+  const fileArg = options.file?.trim();
+  if (!fileArg) {
+    console.error("[apm] \u8BF7\u6307\u5B9A --file <\u672C\u5730\u8DEF\u5F84>");
+    process.exit(1);
+  }
+  const absPath = resolveCwdPath(fileArg);
+  if (!existsSync4(absPath)) {
+    console.error(`[apm] \u6587\u4EF6\u4E0D\u5B58\u5728: ${absPath}`);
+    process.exit(1);
+  }
+  const content = readFileSync5(absPath, "utf8");
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
-  const data = await api.cliRequirements.updateDevStatus({
-    requirementId,
-    status
-  });
-  console.log(JSON.stringify(data, null, 2));
+  await api.cli.appendMessageContent({ id: messageId, content });
+  console.log(`[apm] \u5DF2\u8FFD\u52A0\u6D88\u606F\u5185\u5BB9: ${messageId}`);
 }
 
-// src/commands/update-status.ts
-async function runUpdateStatus(requirementId, status) {
+// src/commands/update-message-status.ts
+var VALID_STATUSES = [
+  "CREATED",
+  "TYPING",
+  "SUCCESS",
+  "FAILED"
+];
+async function runUpdateMessageStatus(options) {
+  const messageId = options.id?.trim();
+  const status = options.status?.trim().toUpperCase();
+  if (!messageId) {
+    console.error("[apm] \u8BF7\u6307\u5B9A --id <messageId>");
+    process.exit(1);
+  }
+  if (!VALID_STATUSES.includes(status)) {
+    console.error(
+      `[apm] \u65E0\u6548\u72B6\u6001: ${options.status}\uFF0C\u53EF\u9009: ${VALID_STATUSES.join(", ")}`
+    );
+    process.exit(1);
+  }
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
-  const data = await api.cliRequirements.updateStatus({
-    requirementId,
-    status
-  });
-  console.log(JSON.stringify(data, null, 2));
+  await api.cli.updateMessageStatus({ id: messageId, status });
+  console.log(`[apm] \u5DF2\u66F4\u65B0\u6D88\u606F\u72B6\u6001: ${messageId} \u2192 ${status}`);
 }
 
 // src/commands/deploy/backend.ts
 import path5 from "node:path";
 
 // src/commands/deploy/internal/apm-config.ts
-import { existsSync as existsSync7, readFileSync as readFileSync8 } from "node:fs";
-import { resolve as resolve4 } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync6 } from "node:fs";
+import { resolve as resolve3 } from "node:path";
 function loadApmConfig(options) {
-  const p = resolve4(
+  const p = resolve3(
     process.cwd(),
-    options?.configPath ?? resolve4(WORKSPACE_APM_DIR, "apm.config.json")
+    options?.configPath ?? resolve3(workspaceApmDir(), "apm.config.json")
   );
-  if (!existsSync7(p)) {
+  if (!existsSync5(p)) {
     console.error(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\uFF1A${p}`);
     process.exit(1);
   }
   try {
-    const raw = readFileSync8(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);
@@ -1710,9 +772,7 @@ function reqTopLevelName(cfg) {
 function reqBackendPositiveInt(v, field) {
   const n = Number(v);
   if (!Number.isFinite(n) || !Number.isInteger(n) || n < 1) {
-    console.error(
-      `apm.config.json \u4E2D backendDeploy.${field} \u987B\u4E3A\u6B63\u6574\u6570`
-    );
+    console.error(`apm.config.json \u4E2D backendDeploy.${field} \u987B\u4E3A\u6B63\u6574\u6570`);
     process.exit(1);
   }
   return n;
@@ -1782,7 +842,7 @@ import path4 from "node:path";
 import Docker from "dockerode";
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/connection-options.ts
-import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync7 } from "node:fs";
 import path from "node:path";
 function asOptionalTlsBuffer(value) {
   if (typeof value !== "string") {
@@ -1794,8 +854,8 @@ function asOptionalTlsBuffer(value) {
   if (normalized === "") {
     return void 0;
   }
-  if (existsSync8(normalized)) {
-    return readFileSync9(normalized);
+  if (existsSync6(normalized)) {
+    return readFileSync7(normalized);
   }
   const looksLikePath = /[\\/]/.test(normalized) || normalized.endsWith(".pem");
   if (looksLikePath) {
@@ -1920,17 +980,17 @@ var DockerodeClient = class {
     await this.client.getImage(image).remove({ force: true });
   }
   async pullImage(image, auth) {
-    const stream = await new Promise((resolve5, reject) => {
+    const stream = await new Promise((resolve4, reject) => {
       const pullOptions = auth ? { authconfig: auth } : void 0;
       this.client.pull(image, pullOptions, (err, output) => {
         if (err || !output) {
           reject(err ?? new Error("docker pull \u8FD4\u56DE\u7A7A\u8F93\u51FA"));
           return;
         }
-        resolve5(output);
+        resolve4(output);
       });
     });
-    await new Promise((resolve5, reject) => {
+    await new Promise((resolve4, reject) => {
       this.client.modem.followProgress(
         stream,
         (err) => {
@@ -1938,7 +998,7 @@ var DockerodeClient = class {
             reject(err);
             return;
           }
-          resolve5();
+          resolve4();
         },
         () => void 0
       );
@@ -2005,7 +1065,7 @@ var DockerodeClient = class {
 var createDockerodeClient = (config) => new DockerodeClient(config);
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/env.ts
-import { existsSync as existsSync9, readFileSync as readFileSync10, statSync as statSync5 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync8, statSync as statSync3 } from "node:fs";
 import path2 from "node:path";
 function stripSurroundingQuotes(value) {
   const t = value.trim();
@@ -2022,10 +1082,10 @@ function loadEnvFromFile(envFilePath) {
     return {};
   }
   const targetPath = path2.resolve(envFilePath);
-  if (!existsSync9(targetPath) || !statSync5(targetPath).isFile()) {
+  if (!existsSync7(targetPath) || !statSync3(targetPath).isFile()) {
     return {};
   }
-  const raw = readFileSync10(targetPath, "utf-8");
+  const raw = readFileSync8(targetPath, "utf-8");
   const result = {};
   for (const line of raw.split(/\r?\n/)) {
     const normalized = line.trim();
@@ -2196,12 +1256,12 @@ function dockerPushImage(params, cwd) {
 }
 
 // src/commands/deploy/internal/backend-deploy/resolve-dockerfile.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync8 } 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 (!existsSync10(dockerfilePath)) {
+  if (!existsSync8(dockerfilePath)) {
     throw new Error(`Dockerfile \u4E0D\u5B58\u5728\uFF1A${dockerfilePath}`);
   }
   Logger.info("\u2713 Dockerfile \u5B58\u5728");
@@ -2330,16 +1390,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 existsSync11, readFileSync as readFileSync11 } from "node:fs";
-import { join as join13 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync9 } from "node:fs";
+import { join as join8 } from "node:path";
 function loadApmDotEnvIfPresent() {
-  const p = join13(WORKSPACE_APM_DIR, ".env");
-  if (!existsSync11(p)) {
+  const p = join8(workspaceApmDir(), ".env");
+  if (!existsSync9(p)) {
     return;
   }
   let text;
   try {
-    text = readFileSync11(p, "utf8");
+    text = readFileSync9(p, "utf8");
   } catch {
     return;
   }
@@ -2364,14 +1424,14 @@ function loadApmDotEnvIfPresent() {
 }
 
 // src/commands/deploy/internal/minio.ts
-import { statSync as statSync6 } from "node:fs";
+import { statSync as statSync4 } from "node:fs";
 import { readdir, readFile } from "node:fs/promises";
 import path6 from "node:path";
 import * as Minio from "minio";
 var DEFAULT_MAX_FILE_SIZE_MB = 50;
 async function isDirectoryPath(dir) {
   try {
-    const st = statSync6(dir);
+    const st = statSync4(dir);
     return st.isDirectory();
   } catch {
     return false;
@@ -2401,7 +1461,7 @@ async function collectFiles(root) {
       if (e.isDirectory()) {
         await walk(abs, rel);
       } else if (e.isFile()) {
-        const st = statSync6(abs);
+        const st = statSync4(abs);
         out.push({
           absPath: abs,
           relativePath: rel.replace(/\\/g, "/"),
@@ -2463,14 +1523,14 @@ var MinioClient = class {
   async deleteObjectsByPrefix(bucket, prefix) {
     const objectsStream = this.inner.listObjectsV2(bucket, prefix, true);
     const keys = [];
-    await new Promise((resolve5, reject) => {
+    await new Promise((resolve4, reject) => {
       objectsStream.on("data", (obj) => {
         if (obj.name) {
           keys.push(obj.name);
         }
       });
       objectsStream.on("error", reject);
-      objectsStream.on("end", resolve5);
+      objectsStream.on("end", resolve4);
     });
     const chunkSize = 500;
     for (let i = 0; i < keys.length; i += chunkSize) {
@@ -2697,7 +1757,7 @@ function registerDeployCommands(program) {
 function buildProgram() {
   const program = new Command();
   program.name("apm").description(
-    `\u5E73\u53F0\u547D\u4EE4\u884C\uFF08Agent \u901A\u9053\u4E0E\u9700\u6C42 CLI\uFF09\u3002
+    `OPC \u5E73\u53F0\u547D\u4EE4\u884C\uFF08\u4F1A\u8BDD\u5DE5\u4F5C\u533A\u4E0E\u7814\u53D1\u81EA\u52A8\u5316\uFF09\u3002
 \u672A\u4F20 --server \u65F6\u4F18\u5148\u4F7F\u7528\u73AF\u5883\u53D8\u91CF AI_PM_SERVER\uFF0C\u5426\u5219\u9ED8\u8BA4 ${DEFAULT_BASE_URL}\u3002`
   ).version(readCliVersion(), "-V, --version", "\u663E\u793A\u7248\u672C\u53F7").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9").showHelpAfterError(true);
   program.command("login").description(
@@ -2707,9 +1767,6 @@ function buildProgram() {
       await runLogin(opts);
     }
   );
-  program.command("connect").description("\u8FDE\u63A5 WebSocket /ws/agent\uFF0C\u5E76\u6309\u56FA\u5B9A\u95F4\u9694\u53D1\u9001 HEARTBEAT").option("--server <url>", "API \u6839\u5730\u5740\uFF08\u5199\u5165\u672C\u5730\u914D\u7F6E\uFF09").action((opts) => {
-    runConnect(opts);
-  });
   program.command("init").description("\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u521D\u59CB\u5316 .apm \u6A21\u677F\uFF08\u82E5 .apm \u5DF2\u5B58\u5728\u4E14\u975E\u7A7A\u5219\u62A5\u9519\uFF09").option("--name <name>", "\u5DE5\u4F5C\u76EE\u5F55\u540D\u79F0").action(async (opts) => {
     await runInit(opts.name);
   });
@@ -2718,72 +1775,30 @@ function buildProgram() {
   ).action(async () => {
     await runUpdate();
   });
-  program.command("update-skills").description(
-    "\u5220\u9664\u5DE5\u4F5C\u533A .apm/skills \u540E\uFF0C\u4ECE\u5F53\u524D CLI \u5185\u7F6E\u6A21\u677F\u91CD\u65B0\u590D\u5236\u6280\u80FD\u76EE\u5F55"
-  ).action(async () => {
+  program.command("update-skills").description("\u4ECE\u5E73\u53F0\u62C9\u53D6\u5F53\u524D\u7528\u6237\u53EF\u8BBF\u95EE\u6280\u80FD\u5230 .apm/skills/").action(async () => {
     await runUpdateSkills();
   });
-  program.command("update-theater-skills").description(
-    "\u5220\u9664\u5DE5\u4F5C\u533A .apm/theater-skills \u540E\uFF0C\u4ECE\u5F53\u524D CLI \u5185\u7F6E\u6A21\u677F\u91CD\u65B0\u590D\u5236\u5267\u573A\u6280\u80FD\u76EE\u5F55"
-  ).action(async () => {
-    await runUpdateTheaterSkills();
-  });
-  program.command("pull-session").description(
-    "\u5C06\u5E73\u53F0\u5267\u573A\u4F1A\u8BDD\u4EA7\u7269\u6587\u6863\u4E0B\u8F7D\u5230 .apm/theater-sessions/<sessionId>/\uFF08\u5982 docs/prd.md\uFF09\uFF1B\u672C\u5730\u5DF2\u6709\u540C\u540D\u6587\u4EF6\u65F6\u8986\u76D6"
-  ).argument("<sessionId>", "\u5267\u573A\u4F1A\u8BDD ID").action(async (sessionId) => {
-    const dir = await runPullTheaterSession(sessionId);
-    console.log(`[apm] \u4F1A\u8BDD\u6587\u6863\u76EE\u5F55: ${dir}`);
+  program.command("pull").description(
+    "\u62C9\u53D6\u6C9F\u901A\u7FA4\u6570\u636E\u5230 .apm/sessions/<sessionId>/\uFF08session.yaml\u3001RULE.md\u3001docs\u3001attachments\uFF09"
+  ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").action(async (sessionId) => {
+    await runPull(sessionId);
   });
-  program.command("sync-session-document").description(
-    "\u5C06 .apm/theater-sessions/<sessionId>/docs/ \u4E0B Markdown \u6587\u6863 upsert \u5230\u5E73\u53F0\u4F1A\u8BDD\u4EA7\u7269\uFF08\u4E0D\u542B\u5BF9\u8BDD\u65E5\u5FD7\uFF09"
-  ).argument("<sessionId>", "\u5267\u573A\u4F1A\u8BDD ID").option(
-    "--file <path>",
-    "\u76F8\u5BF9\u4F1A\u8BDD\u76EE\u5F55\u7684\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 docs/prd.md\uFF1B\u540E\u7AEF\u5E38\u7528 docs/backend.md\u3001docs/api.md\uFF09"
-  ).action(async (sessionId, opts) => {
-    await runSyncSessionDocument(sessionId, { file: opts.file });
+  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) => {
+    await runSyncDocument(sessionId, { file: opts.file });
   });
-  program.command("pull").description(
-    "GET /api/cli/requirements/pull\uFF0C\u540C\u6B65\u6570\u636E\u4E0E\u9644\u4EF6\u5230 .apm/workitems/<\u9700\u6C42ID>"
-  ).argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
-    await runPull(requirementId);
+  program.command("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("--file <path>", "\u672C\u5730\u6587\u4EF6\u8DEF\u5F84").action(async (opts) => {
+    await runAppendMessage(opts);
   });
-  program.command("upload-artifact").description(
-    "\u5148\u6E05\u7A7A\u8BE5\u9700\u6C42\u5728\u5E73\u53F0\u4E0A\u7684\u4EA7\u7269\u6587\u6863\uFF0C\u518D\u5C06 .apm/workitems/<\u9700\u6C42ID> \u4E0B Markdown \u540C\u6B65\u4E0A\u53BB\uFF08\u6392\u9664 pull \u7CFB\u7EDF\u6587\u4EF6\u4E0E attachments \u76EE\u5F55\uFF09"
-  ).argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
-    await runUploadArtifact(requirementId);
+  program.command("update-message-status").description("\u66F4\u65B0\u5E73\u53F0\u4F1A\u8BDD\u6D88\u606F\u72B6\u6001").requiredOption("--id <messageId>", "\u6D88\u606F ID").requiredOption("--status <status>", "CREATED | TYPING | SUCCESS | FAILED").action(async (opts) => {
+    await runUpdateMessageStatus(opts);
   });
   program.command("branch").description(
-    "\u5207\u6362\u6216\u521B\u5EFA\u9700\u6C42\u5206\u652F feat/req-<ID>\uFF1A\u8FDC\u7AEF\u5B58\u5728\u5219\u62C9\u53D6\u6700\u65B0\uFF1B\u8FDC\u7AEF\u5C1A\u65E0\u8BE5\u5206\u652F\u4E14\u672C\u5730\u4E5F\u65E0\u540C\u540D\u5206\u652F\u65F6\uFF0C\u9700\u5DF2 login\uFF0C\u5E76\u7531\u5E73\u53F0\u6839\u636E\u5F53\u524D\u76EE\u5F55\u8DEF\u5F84\u89E3\u6790\u4ED3\u5E93\u57FA\u7EBF\u5206\u652F\u540E\u4ECE origin \u68C0\u51FA\u518D\u63A8\u9001\uFF1B\u6709\u672C\u5730\u672A\u63D0\u4EA4\u6539\u52A8\u65F6\u5728\u975E\u76EE\u6807\u5206\u652F\u5148 stash\uFF08\u4E0D\u81EA\u52A8\u6062\u590D\uFF09\uFF0C\u5728\u76EE\u6807\u5206\u652F\u5219\u5148 commit"
-  ).argument("<requirementId>", "\u9700\u6C42 ID").option(
+    "\u5207\u6362\u6216\u521B\u5EFA\u9700\u6C42\u5206\u652F feat/req-<requirementId>\uFF08\u7531 sessionId \u89E3\u6790\u9700\u6C42\uFF09"
+  ).argument("<sessionId>", "\u6C9F\u901A\u7FA4 ID").option(
     "-m, --message <text>",
-    "\u5DF2\u5728\u76EE\u6807\u5206\u652F\u4E14\u9700\u63D0\u4EA4\u672C\u5730\u6539\u52A8\u65F6\u4F7F\u7528\u7684\u63D0\u4EA4\u8BF4\u660E\uFF08\u9ED8\u8BA4\u81EA\u52A8\u751F\u6210\uFF09"
-  ).action(async (requirementId, opts) => {
-    await runBranch(requirementId, { message: opts.message });
-  });
-  program.command("comment").description(
-    "\u63D0\u4EA4\u9700\u6C42\u8BC4\u5BA1\uFF1Alegacy \u4E3A\u6574\u7BC7 Markdown\uFF08POST \u2026/comment\uFF09\uFF1Bstructured \u4E3A\u884C\u7EA7 YAML\uFF08POST \u2026/comment-structured\uFF09"
-  ).argument("<requirementId>", "\u9700\u6C42 ID").requiredOption(
-    "--file <path>",
-    "\u8BC4\u8BBA\u6587\u4EF6\u8DEF\u5F84\uFF08.yaml/.yml \u9ED8\u8BA4 structured\uFF09"
-  ).option(
-    "--format <format>",
-    "structured | legacy\uFF08\u9ED8\u8BA4 legacy\uFF1B.yaml/.yml \u672A\u6307\u5B9A\u65F6\u89C6\u4E3A structured\uFF09"
-  ).option("--model <model>", "\u8BC4\u8BBA\u6A21\u578B\uFF08\u8986\u76D6 YAML reviewer.model\uFF09").action(
-    async (requirementId, options) => {
-      await runComment(requirementId, options.file, {
-        model: options.model,
-        format: options.format
-      });
-    }
-  );
-  program.command("refine").description("POST /api/cli/requirements/refine\uFF08\u6B63\u6587\u6765\u81EA\u6587\u4EF6\uFF09").argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
-    await runRefine(requirementId);
-  });
-  program.command("update-status").description("POST /api/cli/requirements/update-status").argument("<requirementId>", "\u9700\u6C42 ID").requiredOption("--status <RequirementStatus>", "\u9700\u6C42\u72B6\u6001\u679A\u4E3E\u503C").action(async (requirementId, options) => {
-    await runUpdateStatus(requirementId, options.status);
-  });
-  program.command("update-dev-status").description("POST /api/cli/requirements/update-dev-status").argument("<requirementId>", "\u9700\u6C42 ID").requiredOption("--status <status>", "\u6210\u5458\u5F00\u53D1\u72B6\u6001\uFF08\u81EA\u7531\u6587\u672C\uFF09").action(async (requirementId, options) => {
-    await runUpdateDevStatus(requirementId, options.status);
+    "\u5DF2\u5728\u76EE\u6807\u5206\u652F\u4E14\u9700\u63D0\u4EA4\u672C\u5730\u6539\u52A8\u65F6\u4F7F\u7528\u7684\u63D0\u4EA4\u8BF4\u660E"
+  ).action(async (sessionId, opts) => {
+    await runBranch(sessionId, { message: opts.message });
   });
   registerDeployCommands(program);
   return program;