hunter-harness 0.1.2 → 0.2.0

package/dist/bin.js

@@ -567,16 +567,29 @@ import { z as z9 } from "zod";
 var projectIdSchema = z9.string().regex(/^prj_[A-Za-z0-9_-]+$/);
 var tokenEnvSchema = z9.string().regex(/^[A-Z_][A-Z0-9_]*$/);
 var httpsUrlSchema = z9.url().refine((value) => new URL(value).protocol === "https:", "server URL must use HTTPS");
+var HARNESS_AGENT_ORDER = [
+  "claude-code",
+  "codex",
+  "cursor",
+  "codebuddy"
+];
+var harnessAgentSchema = z9.enum(HARNESS_AGENT_ORDER);
+var codebuddySurfaceSchema = z9.enum(["both", "ide", "cli"]);
+function sortHarnessAgents(agents) {
+  return HARNESS_AGENT_ORDER.filter((agent) => agents.includes(agent));
+}
 var adapterNameSchema = z9.enum([
   "claude-code",
   "codex",
   "cursor",
+  "codebuddy",
   "generic",
   "mcp"
 ]);
 var initConfigSchema = z9.object({
-  adapter: adapterNameSchema,
+  agents: z9.array(harnessAgentSchema).min(1),
   profile: z9.enum(["general", "java"]),
+  codebuddy_surface: codebuddySurfaceSchema.default("both"),
   server_url: httpsUrlSchema.nullable().optional(),
   token_env: tokenEnvSchema.nullable().optional(),
   project_id: projectIdSchema.nullable().optional(),
@@ -603,7 +616,12 @@ var projectConfigSchema = z9.object({
   }).strict(),
   adapters: z9.object({
     enabled: z9.array(adapterNameSchema).min(1)
-  }).strict()
+  }).strict(),
+  adapter_options: z9.object({
+    codebuddy: z9.object({
+      surface: codebuddySurfaceSchema
+    }).strict()
+  }).strict().optional()
 }).strict();
 
 // ../contracts/dist/dashboard.js
@@ -817,8 +835,8 @@ async function assertNoSymlinks(root, relativePath) {
   for (const segment of normalized.split("/")) {
     current = join(current, segment);
     try {
-      const stat6 = await lstat(current);
-      if (stat6.isSymbolicLink()) {
+      const stat5 = await lstat(current);
+      if (stat5.isSymbolicLink()) {
         throw new UnsafePathError("symbolic links are not managed");
       }
     } catch (error) {
@@ -1063,12 +1081,12 @@ function renderBlock(content, newline) {
   return MANAGED_BLOCK_START + newline + normalized + newline + MANAGED_BLOCK_END;
 }
 function extractManagedBlock(content) {
-  if (validateMarkers(content) === "absent") {
-    return null;
+  if (validateMarkers(content) === "present") {
+    const start = content.indexOf(MANAGED_BLOCK_START) + MANAGED_BLOCK_START.length;
+    const end = content.indexOf(MANAGED_BLOCK_END);
+    return content.slice(start, end).replace(/^\r?\n/, "").replace(/\r?\n$/, "");
   }
-  const start = content.indexOf(MANAGED_BLOCK_START) + MANAGED_BLOCK_START.length;
-  const end = content.indexOf(MANAGED_BLOCK_END);
-  return content.slice(start, end).replace(/^\r?\n/, "").replace(/\r?\n$/, "");
+  return extractSingleManagedBlockById(content)?.content ?? null;
 }
 function upsertManagedBlock(original, content) {
   const newline = original.includes("\r\n") ? "\r\n" : "\n";
@@ -1094,25 +1112,34 @@ function removeManagedBlock(original) {
   const after = original.slice(end).replace(/^(?:\r?\n){1,2}/, "");
   return before + after;
 }
-function refreshManagedBlock(original, blockContent) {
-  const starts = markerCount(original, MANAGED_BLOCK_START);
-  const ends = markerCount(original, MANAGED_BLOCK_END);
-  const absent = starts === 0 && ends === 0;
-  const malformed = !absent && (starts !== 1 || ends !== 1 || original.indexOf(MANAGED_BLOCK_START) > original.indexOf(MANAGED_BLOCK_END));
-  if (malformed) {
-    return { content: original, action: "preserved_conflict", conflict: true };
-  }
-  const action = absent ? "appended" : "refreshed";
-  return { content: upsertManagedBlock(original, blockContent), action, conflict: false };
-}
 function escapeRe(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 var startById = (id) => `<!-- hunter-harness:start id=${id} -->`;
 var endById = (id) => `<!-- hunter-harness:end id=${id} -->`;
+function extractSingleManagedBlockById(content) {
+  const matches = [...content.matchAll(/<!-- hunter-harness:start id=([A-Za-z0-9_-]+) -->/g)];
+  if (matches.length !== 1)
+    return null;
+  const id = matches[0]?.[1];
+  if (id === void 0)
+    return null;
+  const start = startById(id);
+  const end = endById(id);
+  if (markerCount(content, start) !== 1 || markerCount(content, end) !== 1 || content.indexOf(start) > content.indexOf(end)) {
+    throw new Error("managed block markers are malformed or duplicated");
+  }
+  const bodyStart = content.indexOf(start) + start.length;
+  const bodyEnd = content.indexOf(end);
+  return {
+    id,
+    content: content.slice(bodyStart, bodyEnd).replace(/^\r?\n/, "").replace(/\r?\n$/, "")
+  };
+}
 function upsertManagedBlockById(original, id, content) {
   const newline = original.includes("\r\n") ? "\r\n" : "\n";
-  const block = startById(id) + newline + content + newline + endById(id);
+  const normalized = content.replace(/\r\n/g, "\n").replace(/\n/g, newline);
+  const block = startById(id) + newline + normalized + newline + endById(id);
   const re = new RegExp(escapeRe(startById(id)) + "[\\s\\S]*?" + escapeRe(endById(id)));
   if (re.test(original)) {
     return original.replace(re, block);
@@ -1120,6 +1147,68 @@ function upsertManagedBlockById(original, id, content) {
   const separator = original.length === 0 ? "" : original.endsWith(newline) ? newline : newline + newline;
   return original + separator + block + newline;
 }
+function refreshManagedBlockById(original, id, blockContent, options = {}) {
+  const idStart = startById(id);
+  const idEnd = endById(id);
+  const idStarts = markerCount(original, idStart);
+  const idEnds = markerCount(original, idEnd);
+  if (idStarts > 0 || idEnds > 0) {
+    if (idStarts !== 1 || idEnds !== 1 || original.indexOf(idStart) > original.indexOf(idEnd)) {
+      return { content: original, action: "preserved_conflict", conflict: true };
+    }
+    return {
+      content: upsertManagedBlockById(original, id, blockContent),
+      action: "refreshed",
+      conflict: false
+    };
+  }
+  const legacyStarts = markerCount(original, MANAGED_BLOCK_START);
+  const legacyEnds = markerCount(original, MANAGED_BLOCK_END);
+  const legacyAbsent = legacyStarts === 0 && legacyEnds === 0;
+  const legacyMalformed = !legacyAbsent && (legacyStarts !== 1 || legacyEnds !== 1 || original.indexOf(MANAGED_BLOCK_START) > original.indexOf(MANAGED_BLOCK_END));
+  if (legacyMalformed) {
+    return { content: original, action: "preserved_conflict", conflict: true };
+  }
+  if (!legacyAbsent && options.upgradeLegacy === true) {
+    const newline = original.includes("\r\n") ? "\r\n" : "\n";
+    const normalized = blockContent.replace(/\r\n/g, "\n").replace(/\n/g, newline);
+    const block = idStart + newline + normalized + newline + idEnd;
+    const start = original.indexOf(MANAGED_BLOCK_START);
+    const end = original.indexOf(MANAGED_BLOCK_END) + MANAGED_BLOCK_END.length;
+    return {
+      content: original.slice(0, start) + block + original.slice(end),
+      action: "refreshed",
+      conflict: false
+    };
+  }
+  if (!legacyAbsent) {
+    return {
+      content: upsertManagedBlockById(original, id, blockContent),
+      action: "appended",
+      conflict: false
+    };
+  }
+  return {
+    content: upsertManagedBlockById(original, id, blockContent),
+    action: "appended",
+    conflict: false
+  };
+}
+function removeManagedBlockById(original, id) {
+  const idStart = startById(id);
+  const idEnd = endById(id);
+  if (markerCount(original, idStart) === 0 && markerCount(original, idEnd) === 0) {
+    return original;
+  }
+  if (markerCount(original, idStart) !== 1 || markerCount(original, idEnd) !== 1 || original.indexOf(idStart) > original.indexOf(idEnd)) {
+    throw new Error("managed block markers are malformed or duplicated");
+  }
+  const start = original.indexOf(idStart);
+  const end = original.indexOf(idEnd) + idEnd.length;
+  const before = original.slice(0, start).replace(/(?:\r?\n){2}$/, "\n");
+  const after = original.slice(end).replace(/^(?:\r?\n){1,2}/, "");
+  return before + after;
+}
 
 // ../core/dist/policy/file-policy.js
 var USER_MANAGED_BLOCK = {
@@ -1197,10 +1286,10 @@ function under(path, prefix) {
 }
 function classifyFile(input) {
   const path = normalizeManagedPath(input);
-  if (path === "CLAUDE.md" || path === "AGENTS.md") {
+  if (path === "CLAUDE.md" || path === "AGENTS.md" || path === "CODEBUDDY.md") {
     return USER_MANAGED_BLOCK;
   }
-  if (under(path, ".claude/rules/") || under(path, ".claude/skills/harness-")) {
+  if (under(path, ".claude/rules/") || under(path, ".claude/skills/harness-") || under(path, ".agents/skills/harness-") || under(path, ".cursor/skills/harness-") || under(path, ".codebuddy/skills/harness-") || under(path, ".codebuddy/agents/harness-")) {
     return USER_DIFF;
   }
   if (under(path, ".cursor/rules/") || under(path, ".agent-skills/")) {
@@ -1255,6 +1344,7 @@ function decideUpdate(policy, dirty) {
 }
 
 // ../core/dist/project/initialize.js
+import { createHash as createHash4 } from "node:crypto";
 import { readFile as readFile4, stat as stat2 } from "node:fs/promises";
 import { basename, join as join5, resolve as resolve3 } from "node:path";
 import { parse as parseYaml2, stringify as stringifyYaml } from "yaml";
@@ -1508,13 +1598,20 @@ async function runTransaction(projectRoot, rawOperations, options = {}) {
   return { transactionId, status: "committed" };
 }
 
+// ../core/dist/project/agent-adapters.js
+import { createHash as createHash2 } from "node:crypto";
+
 // ../core/dist/project/managed-content.js
+var AGENTS_CORE_BLOCK_ID = "hunter-harness-core";
+var CLAUDE_BLOCK_ID = "hunter-harness-claude-code";
+var CODEBUDDY_BLOCK_ID = "hunter-harness-codebuddy";
 var AGENTS_MANAGED_BLOCK_CONTENT = [
   "# Hunter Harness",
   "",
-  "Use .harness/context-index.json to route rules, Knowledge, and codebase maps.",
-  "Treat .claude/skills/harness-* as editable adapter working copies.",
-  "Do not modify .harness/state or .harness/cache directly."
+  "Use `.harness/context-index.json` to locate the instructions, skills, knowledge,",
+  "and codebase map for the active agent.",
+  "Treat installed `harness-*` skills as editable adapter working copies.",
+  "Do not modify `.harness/state` or `.harness/cache` directly."
 ].join("\n");
 var CLAUDE_MANAGED_BLOCK_CONTENT = [
   "@AGENTS.md",
@@ -1526,54 +1623,61 @@ var CLAUDE_MANAGED_BLOCK_CONTENT = [
   "- Knowledge: .harness/knowledge/",
   "- Codebase map: .harness/codebase/map/"
 ].join("\n");
+var CODEBUDDY_MANAGED_BLOCK_CONTENT = [
+  "# Hunter Harness",
+  "",
+  "Use `.harness/context-index.json` to locate the instructions, skills, knowledge,",
+  "and codebase map for the active agent.",
+  "Treat installed `harness-*` skills as editable adapter working copies.",
+  "Do not modify `.harness/state` or `.harness/cache` directly.",
+  "",
+  "- Skills: .codebuddy/skills/harness-*/",
+  "- Agents: .codebuddy/agents/harness-*.md",
+  "- Knowledge: .harness/knowledge/",
+  "- Codebase map: .harness/codebase/map/"
+].join("\n");
 var HARNESS_GENERAL_RULES_CONTENT = "# Hunter Harness Rules\n\n- Report evidence honestly.\n- Do not execute destructive actions without confirmation.\n";
 var HARNESS_JAVA_RULES_CONTENT = "# Java Profile\n\n- Verify builds and tests with the project build tool.\n";
+var CURSOR_GENERAL_RULES_CONTENT = "---\ndescription: Hunter Harness project-wide safety and evidence rules\nglobs:\nalwaysApply: true\n---\n\n# Hunter Harness Rules\n\n- Report evidence honestly.\n- Do not execute destructive actions without confirmation.\n";
+var CURSOR_JAVA_RULES_CONTENT = "---\ndescription: Hunter Harness Java profile rules\nglobs:\nalwaysApply: true\n---\n\n# Java Profile\n\n- Verify builds and tests with the project build tool.\n";
 
-// ../core/dist/project/profile-bundle.js
-import { createHash as createHash2 } from "node:crypto";
-import { readFile as readFile3, readdir as readdir2 } from "node:fs/promises";
-import { join as join4 } from "node:path";
-function isProfile(value) {
-  return value === "general" || value === "java";
-}
+// ../core/dist/project/agent-adapters.js
+var AGENT_SOURCE_PATH = /^agents\/([^/]+\.md)$/;
 function validateRelativeBundlePath(path) {
   if (typeof path !== "string" || path.length === 0 || path.includes("\0") || path.startsWith("/") || path.startsWith("\\") || /^[A-Za-z]:/.test(path) || path.split("/").some((part) => part === "" || part === "." || part === "..")) {
     throw new Error("invalid Harness Bundle path");
   }
 }
-async function loadProfileBundle(resourcesRoot, profile) {
-  const raw = JSON.parse(await readFile3(join4(resourcesRoot, "harness", "manifests", `${profile}.json`), "utf8"));
-  if (raw.schema_version !== 1 || raw.profile !== profile || typeof raw.bundle_version !== "string" || raw.generator !== "harness_deploy.py" || !Array.isArray(raw.files)) {
-    throw new Error(`invalid ${profile} Harness Bundle manifest`);
-  }
-  const files = /* @__PURE__ */ new Map();
-  for (const item2 of raw.files) {
-    validateRelativeBundlePath(item2.path);
-    if (typeof item2.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(item2.sha256) || files.has(item2.path)) {
-      throw new Error(`invalid ${profile} Harness Bundle manifest entry`);
-    }
-    const bytes = await readFile3(join4(resourcesRoot, "harness", profile, item2.path));
-    if (createHash2("sha256").update(bytes).digest("hex") !== item2.sha256) {
-      throw new Error(`Harness Bundle hash mismatch: ${item2.path}`);
-    }
-    files.set(item2.path, bytes);
-  }
-  return { manifest: raw, files };
-}
-async function managedBundleTargets(resourcesRoot, profile) {
-  const bundle = await loadProfileBundle(resourcesRoot, profile);
-  const targets = new Set(bundleTargetContents(bundle).keys());
-  if (profile === "java")
-    targets.add(".claude/rules/harness-profile-java.md");
-  return targets;
+function ruleTarget(sourcePath, targetPath, content) {
+  return {
+    source_path: sourcePath,
+    target_path: normalizeManagedPath(targetPath),
+    sha256: createHash2("sha256").update(content).digest("hex"),
+    bytes: new TextEncoder().encode(content)
+  };
 }
-var AGENT_SOURCE_PATH = /^agents\/([^/]+\.md)$/;
-function projectBundle(bundle) {
+function projectBundleFiles(bundle, skillsRoot, agentsRoot) {
   const records = [];
   for (const [sourcePath, bytes] of bundle.files) {
     validateRelativeBundlePath(sourcePath);
     const agent = AGENT_SOURCE_PATH.exec(sourcePath);
-    const projectedTarget = agent?.[1] !== void 0 ? `.claude/agents/${agent[1]}` : `.claude/skills/${sourcePath}`;
+    if (agent?.[1] !== void 0) {
+      if (agentsRoot === null)
+        continue;
+      const projectedTarget2 = `${agentsRoot}/${agent[1]}`;
+      const manifestEntry2 = bundle.manifest.files.find((entry) => entry.path === sourcePath);
+      if (manifestEntry2 === void 0) {
+        throw new Error(`Harness Bundle missing manifest entry: ${sourcePath}`);
+      }
+      records.push({
+        source_path: sourcePath,
+        target_path: normalizeManagedPath(projectedTarget2),
+        sha256: manifestEntry2.sha256,
+        bytes
+      });
+      continue;
+    }
+    const projectedTarget = `${skillsRoot}/${sourcePath}`;
     const manifestEntry = bundle.manifest.files.find((entry) => entry.path === sourcePath);
     if (manifestEntry === void 0) {
       throw new Error(`Harness Bundle missing manifest entry: ${sourcePath}`);
@@ -1588,32 +1692,195 @@ function projectBundle(bundle) {
   assertNoCaseCollisions(records.map((record) => record.target_path));
   return records.sort((left, right) => left.target_path.localeCompare(right.target_path));
 }
-function bundleTargetContents(bundle) {
-  return new Map(projectBundle(bundle).map((record) => [record.target_path, record.bytes]));
-}
-function ruleTarget(sourcePath, targetPath, content) {
+function makeAdapter(spec) {
   return {
-    source_path: sourcePath,
-    target_path: targetPath,
-    sha256: createHash2("sha256").update(content).digest("hex"),
-    bytes: new TextEncoder().encode(content)
+    name: spec.name,
+    skillsRoot: spec.skillsRoot,
+    rulesRoot: spec.rulesRoot,
+    agentsRoot: spec.agentsRoot,
+    commandsRoot: spec.commandsRoot,
+    supportsExecutableHooks: false,
+    projectInstructionTargets() {
+      return ["AGENTS.md", ...spec.extraInstructionFiles];
+    },
+    projectBundle(bundle) {
+      return projectBundleFiles(bundle, spec.skillsRoot, spec.agentsRoot);
+    },
+    contextIndex(context) {
+      const rules = [];
+      if (spec.rulesRoot !== null && spec.ruleExt !== null) {
+        rules.push(`${spec.rulesRoot}/harness-general${spec.ruleExt}`);
+        if (context.profile === "java") {
+          rules.push(`${spec.rulesRoot}/harness-profile-java${spec.ruleExt}`);
+        }
+      }
+      return {
+        instructions: spec.instructions,
+        skills_root: spec.skillsRoot,
+        rules
+      };
+    },
+    pruneBoundaries() {
+      const boundaries = [spec.skillsRoot];
+      if (spec.agentsRoot !== null)
+        boundaries.push(spec.agentsRoot);
+      if (spec.rulesRoot !== null)
+        boundaries.push(spec.rulesRoot);
+      const top = spec.skillsRoot.split("/")[0];
+      if (top !== void 0)
+        boundaries.push(top);
+      return boundaries;
+    }
   };
 }
-async function managedTargets(resourcesRoot, profile) {
-  const bundle = await loadProfileBundle(resourcesRoot, profile);
-  const records = projectBundle(bundle).map((record) => ({
-    source_path: record.source_path,
-    target_path: record.target_path,
-    sha256: record.sha256,
-    bytes: record.bytes
-  }));
-  records.push(ruleTarget("rules/harness-general.md", ".claude/rules/harness-general.md", HARNESS_GENERAL_RULES_CONTENT));
-  if (profile === "java") {
-    records.push(ruleTarget("rules/harness-profile-java.md", ".claude/rules/harness-profile-java.md", HARNESS_JAVA_RULES_CONTENT));
+var ADAPTERS = {
+  "claude-code": makeAdapter({
+    name: "claude-code",
+    skillsRoot: ".claude/skills",
+    rulesRoot: ".claude/rules",
+    agentsRoot: ".claude/agents",
+    commandsRoot: null,
+    instructions: "CLAUDE.md",
+    extraInstructionFiles: ["CLAUDE.md"],
+    ruleExt: ".md"
+  }),
+  codex: makeAdapter({
+    name: "codex",
+    skillsRoot: ".agents/skills",
+    rulesRoot: null,
+    agentsRoot: null,
+    commandsRoot: null,
+    instructions: "AGENTS.md",
+    extraInstructionFiles: [],
+    ruleExt: null
+  }),
+  cursor: makeAdapter({
+    name: "cursor",
+    skillsRoot: ".cursor/skills",
+    rulesRoot: ".cursor/rules",
+    agentsRoot: null,
+    commandsRoot: ".cursor/commands",
+    instructions: "AGENTS.md",
+    extraInstructionFiles: [],
+    ruleExt: ".mdc"
+  }),
+  codebuddy: makeAdapter({
+    name: "codebuddy",
+    skillsRoot: ".codebuddy/skills",
+    rulesRoot: null,
+    agentsRoot: ".codebuddy/agents",
+    commandsRoot: ".codebuddy/commands",
+    instructions: "CODEBUDDY.md",
+    extraInstructionFiles: ["CODEBUDDY.md"],
+    ruleExt: null
+  })
+};
+function getAdapter(name) {
+  return ADAPTERS[name];
+}
+function getAdapters(names) {
+  return HARNESS_AGENT_ORDER.filter((n) => names.includes(n)).map(getAdapter);
+}
+function managedTargetsFor(adapter, bundle, context) {
+  const records = [...adapter.projectBundle(bundle, context)];
+  if (adapter.name === "claude-code") {
+    records.push(ruleTarget("rules/harness-general.md", ".claude/rules/harness-general.md", HARNESS_GENERAL_RULES_CONTENT));
+    if (context.profile === "java") {
+      records.push(ruleTarget("rules/harness-profile-java.md", ".claude/rules/harness-profile-java.md", HARNESS_JAVA_RULES_CONTENT));
+    }
+  } else if (adapter.name === "cursor") {
+    records.push(ruleTarget("rules/harness-general.mdc", ".cursor/rules/harness-general.mdc", CURSOR_GENERAL_RULES_CONTENT));
+    if (context.profile === "java") {
+      records.push(ruleTarget("rules/harness-profile-java.mdc", ".cursor/rules/harness-profile-java.mdc", CURSOR_JAVA_RULES_CONTENT));
+    }
   }
   assertNoCaseCollisions(records.map((record) => record.target_path));
   return records.sort((left, right) => left.target_path.localeCompare(right.target_path));
 }
+
+// ../core/dist/project/profile-bundle.js
+import { createHash as createHash3 } from "node:crypto";
+import { readFile as readFile3, readdir as readdir2 } from "node:fs/promises";
+import { join as join4 } from "node:path";
+var AdapterBundleError = class extends Error {
+  code;
+  exitCode = 7;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "AdapterBundleError";
+  }
+};
+function isEnoent(error) {
+  return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
+}
+function isProfile(value) {
+  return value === "general" || value === "java";
+}
+function isAgent(value) {
+  return value === "claude-code" || value === "codex" || value === "cursor" || value === "codebuddy";
+}
+function validateRelativeBundlePath2(path) {
+  if (typeof path !== "string" || path.length === 0 || path.includes("\0") || path.startsWith("/") || path.startsWith("\\") || /^[A-Za-z]:/.test(path) || path.split("/").some((part) => part === "" || part === "." || part === "..")) {
+    throw new Error("invalid Harness Bundle path");
+  }
+}
+async function loadAgentBundle(resourcesRoot, profile, agent) {
+  const manifestPath = join4(resourcesRoot, "harness", "manifests", profile, `${agent}.json`);
+  let manifestText;
+  try {
+    manifestText = await readFile3(manifestPath, "utf8");
+  } catch (error) {
+    if (isEnoent(error)) {
+      throw new AdapterBundleError("ADAPTER_BUNDLE_MISSING", `offline Harness Bundle manifest missing: ${profile}/${agent}`);
+    }
+    throw error;
+  }
+  let raw;
+  try {
+    raw = JSON.parse(manifestText);
+  } catch {
+    throw new AdapterBundleError("ADAPTER_BUNDLE_INVALID", `unparseable ${profile}/${agent} Harness Bundle manifest`);
+  }
+  if (raw.schema_version !== 2 || raw.profile !== profile || raw.adapter !== agent || typeof raw.bundle_version !== "string" || raw.generator !== "harness_deploy.py" || !Array.isArray(raw.files)) {
+    throw new AdapterBundleError("ADAPTER_BUNDLE_INVALID", `invalid ${profile}/${agent} Harness Bundle manifest`);
+  }
+  const files = /* @__PURE__ */ new Map();
+  for (const item2 of raw.files) {
+    try {
+      validateRelativeBundlePath2(item2.path);
+    } catch {
+      throw new AdapterBundleError("ADAPTER_BUNDLE_INVALID", `invalid ${profile}/${agent} Harness Bundle path`);
+    }
+    if (typeof item2.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(item2.sha256) || files.has(item2.path)) {
+      throw new AdapterBundleError("ADAPTER_BUNDLE_INVALID", `invalid ${profile}/${agent} Harness Bundle manifest entry`);
+    }
+    let bytes;
+    try {
+      bytes = await readFile3(join4(resourcesRoot, "harness", "bundles", profile, agent, item2.path));
+    } catch (error) {
+      if (isEnoent(error)) {
+        throw new AdapterBundleError("ADAPTER_BUNDLE_MISSING", `offline Harness Bundle file missing: ${profile}/${agent}/${item2.path}`);
+      }
+      throw error;
+    }
+    if (createHash3("sha256").update(bytes).digest("hex") !== item2.sha256) {
+      throw new AdapterBundleError("ADAPTER_BUNDLE_INVALID", `Harness Bundle hash mismatch: ${profile}/${agent}/${item2.path}`);
+    }
+    files.set(item2.path, bytes);
+  }
+  return { manifest: raw, files };
+}
+async function managedBundleTargets(resourcesRoot, profile, agent = "claude-code") {
+  const bundle = await loadAgentBundle(resourcesRoot, profile, agent);
+  const adapter = getAdapter(agent);
+  const context = { profile, codebuddySurface: "both" };
+  const targets = new Set(adapter.projectBundle(bundle, context).map((t) => t.target_path));
+  if (profile === "java" && agent === "claude-code") {
+    targets.add(".claude/rules/harness-profile-java.md");
+  }
+  return targets;
+}
 function parseHarnessProfile(value) {
   return isProfile(value) ? value : null;
 }
@@ -1622,21 +1889,25 @@ function parseMigrationManifest(raw) {
     throw new Error("invalid Harness migration manifest");
   }
   const record = raw;
-  if (record.schema_version !== 1 || !isProfile(record.profile) || typeof record.bundle_version !== "string" || !/^sha256:[a-f0-9]{64}$/.test(String(record.bundle_manifest_hash)) || !Array.isArray(record.projection)) {
+  const schemaVersion = record.schema_version;
+  if (schemaVersion !== 1 && schemaVersion !== 2 || !isProfile(record.profile) || typeof record.bundle_version !== "string" || !/^sha256:[a-f0-9]{64}$/.test(String(record.bundle_manifest_hash)) || !Array.isArray(record.projection)) {
     throw new Error("invalid Harness migration manifest");
   }
+  const adapter = schemaVersion === 1 ? "claude-code" : isAgent(record.adapter) ? record.adapter : (() => {
+    throw new Error("invalid Harness migration manifest adapter");
+  })();
   const projection = [];
   for (const entry of record.projection) {
     if (entry === null || typeof entry !== "object") {
       throw new Error("invalid Harness migration manifest entry");
     }
     const item2 = entry;
-    validateRelativeBundlePath(item2.source_path);
+    validateRelativeBundlePath2(item2.source_path);
     if (typeof item2.target_path !== "string" || typeof item2.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(item2.sha256)) {
       throw new Error("invalid Harness migration manifest entry");
     }
     const targetPath = normalizeManagedPath(item2.target_path);
-    if (!targetPath.startsWith(".claude/")) {
+    if (schemaVersion === 1 && !targetPath.startsWith(".claude/")) {
       throw new Error("invalid Harness migration manifest target");
     }
     projection.push({
@@ -1647,8 +1918,9 @@ function parseMigrationManifest(raw) {
   }
   assertNoCaseCollisions(projection.map((item2) => item2.target_path));
   return {
-    schema_version: 1,
+    schema_version: schemaVersion,
     profile: record.profile,
+    adapter,
     bundle_version: record.bundle_version,
     bundle_manifest_hash: record.bundle_manifest_hash,
     projection
@@ -1697,17 +1969,37 @@ function uuidV7(now = Date.now()) {
   const byte8 = bytes[8] ?? 0;
   bytes[6] = byte6 & 15 | 112;
   bytes[8] = byte8 & 63 | 128;
-  const hex = bytes.toString("hex");
+  const hex2 = bytes.toString("hex");
   return [
-    hex.slice(0, 8),
-    hex.slice(8, 12),
-    hex.slice(12, 16),
-    hex.slice(16, 20),
-    hex.slice(20)
+    hex2.slice(0, 8),
+    hex2.slice(8, 12),
+    hex2.slice(12, 16),
+    hex2.slice(16, 20),
+    hex2.slice(20)
   ].join("-");
 }
 
 // ../core/dist/project/initialize.js
+var TargetCollisionError = class extends Error {
+  code = "TARGET_COLLISION";
+  exitCode = 7;
+  constructor(targetPath) {
+    super(`TARGET_COLLISION: conflicting bytes for ${targetPath}`);
+    this.name = "TargetCollisionError";
+  }
+};
+function hex(bytes) {
+  return createHash4("sha256").update(bytes).digest("hex");
+}
+function bytesEqual(left, right) {
+  if (left.byteLength !== right.byteLength)
+    return false;
+  for (let i = 0; i < left.byteLength; i += 1) {
+    if (left[i] !== right[i])
+      return false;
+  }
+  return true;
+}
 async function readOptional(path) {
   try {
     return await readFile4(path, "utf8");
@@ -1738,14 +2030,76 @@ async function operationFor(root, path, content) {
   return await exists2(join5(root, path)) ? { operation: "modify", path, content } : { operation: "add", path, content };
 }
 var INSTALLED_BUNDLE_PATH = ".harness/state/local/installed-harness-bundle.json";
+function mergeOwnedTargets(owned) {
+  const byTarget = /* @__PURE__ */ new Map();
+  for (const item2 of owned) {
+    const list = byTarget.get(item2.target_path) ?? [];
+    list.push(item2);
+    byTarget.set(item2.target_path, list);
+  }
+  const merged = [];
+  for (const [targetPath, items] of [...byTarget.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+    const first = items[0];
+    if (first === void 0) {
+      throw new Error(`missing projected targets for ${targetPath}`);
+    }
+    for (const item2 of items.slice(1)) {
+      if (!bytesEqual(first.bytes, item2.bytes) || first.sha256 !== item2.sha256) {
+        throw new TargetCollisionError(targetPath);
+      }
+    }
+    const owners = new Set(items.map((item2) => item2.owner));
+    merged.push({
+      owner: owners.size === 1 ? first.owner : "shared",
+      source_path: first.source_path,
+      target_path: targetPath,
+      sha256: first.sha256,
+      bytes: first.bytes
+    });
+  }
+  return merged.sort((left, right) => {
+    const byTarget2 = left.target_path.localeCompare(right.target_path);
+    return byTarget2 !== 0 ? byTarget2 : left.source_path.localeCompare(right.source_path);
+  });
+}
 async function initializeProject(options) {
   const root = resolve3(options.projectRoot);
   const config = initConfigSchema.parse(options.config);
   const existing = await existingProjectConfig(root);
   const profile = config.profile;
-  const bundle = await loadProfileBundle(options.resourcesRoot, profile);
-  const managed = await managedTargets(options.resourcesRoot, profile);
-  const bundleHash = sha256Bytes(canonicalJson(bundle.manifest.files));
+  const enabledAgents = sortHarnessAgents(config.agents);
+  const surface = config.codebuddy_surface;
+  const adapterContext = { profile, codebuddySurface: surface };
+  const owned = [];
+  const manifests = [];
+  const adaptersIndex = {};
+  const skillBundles = {};
+  let primaryBundleHash = "";
+  let primaryRegistryVersion = "";
+  for (const agent of enabledAgents) {
+    const bundle = await loadAgentBundle(options.resourcesRoot, profile, agent);
+    const adapter = getAdapter(agent);
+    const targets = managedTargetsFor(adapter, bundle, adapterContext);
+    const bundleHash = sha256Bytes(canonicalJson(bundle.manifest.files));
+    if (primaryBundleHash === "") {
+      primaryBundleHash = bundleHash;
+      primaryRegistryVersion = bundle.manifest.bundle_version;
+    }
+    manifests.push({
+      adapter: agent,
+      bundle_version: bundle.manifest.bundle_version,
+      bundle_manifest_hash: bundleHash
+    });
+    skillBundles[agent] = {
+      registry_version: bundle.manifest.bundle_version,
+      bundle_hash: bundleHash
+    };
+    adaptersIndex[agent] = adapter.contextIndex(adapterContext);
+    for (const target of targets) {
+      owned.push({ ...target, owner: agent });
+    }
+  }
+  const mergedTargets = mergeOwnedTargets(owned);
   const projectConfig = projectConfigSchema.parse({
     harness: { name: "hunter-harness", schema_version: 1 },
     project: {
@@ -1759,7 +2113,8 @@ async function initializeProject(options) {
       url: config.server_url ?? existing?.server.url ?? null,
       token_env: config.token_env ?? existing?.server.token_env ?? "HUNTER_HARNESS_TOKEN"
     },
-    adapters: { enabled: [config.adapter] }
+    adapters: { enabled: enabledAgents },
+    ...enabledAgents.includes("codebuddy") ? { adapter_options: { codebuddy: { surface: config.codebuddy_surface } } } : {}
   });
   const baseline = baselineManifestSchema.parse({
     schema_version: 1,
@@ -1768,8 +2123,15 @@ async function initializeProject(options) {
     artifact_manifest_hash: null,
     files: {}
   });
-  const agentsContent = upsertManagedBlock(await readOptional(join5(root, "AGENTS.md")), AGENTS_MANAGED_BLOCK_CONTENT);
-  const claudeContent = upsertManagedBlock(await readOptional(join5(root, "CLAUDE.md")), CLAUDE_MANAGED_BLOCK_CONTENT);
+  const managedBlocks = [];
+  let agentsContent = await readOptional(join5(root, "AGENTS.md"));
+  agentsContent = upsertManagedBlockById(agentsContent, AGENTS_CORE_BLOCK_ID, AGENTS_MANAGED_BLOCK_CONTENT);
+  managedBlocks.push({
+    owner: "shared",
+    target_path: "AGENTS.md",
+    block_id: AGENTS_CORE_BLOCK_ID,
+    content_sha256: hex(AGENTS_MANAGED_BLOCK_CONTENT)
+  });
   const files = /* @__PURE__ */ new Map([
     [
       ".harness/project.yaml",
@@ -1782,38 +2144,64 @@ async function initializeProject(options) {
     [
       ".harness/context-index.json",
       JSON.stringify({
-        schema_version: 1,
-        project: { claude_md: "CLAUDE.md", agents_md: "AGENTS.md" },
-        rules: [".claude/rules/harness-general.md"],
+        schema_version: 2,
+        project: {
+          shared_instructions: "AGENTS.md",
+          adapters: adaptersIndex
+        },
         knowledge: { index: ".harness/knowledge/index.json" },
         codebase: { map: ".harness/codebase/map", status: "missing" },
-        skill_bundle: {
-          registry_version: bundle.manifest.bundle_version,
-          bundle_hash: bundleHash
-        }
+        skill_bundles: skillBundles
       }, null, 2) + "\n"
     ],
     [
       ".harness/knowledge/index.json",
       JSON.stringify({ schema_version: 1, generated_at: null, entries: [] }, null, 2) + "\n"
     ],
-    ["AGENTS.md", agentsContent],
-    ["CLAUDE.md", claudeContent]
+    ["AGENTS.md", agentsContent]
   ]);
-  for (const target of managed) {
+  if (enabledAgents.includes("claude-code")) {
+    let claudeContent = await readOptional(join5(root, "CLAUDE.md"));
+    claudeContent = upsertManagedBlockById(claudeContent, CLAUDE_BLOCK_ID, CLAUDE_MANAGED_BLOCK_CONTENT);
+    files.set("CLAUDE.md", claudeContent);
+    managedBlocks.push({
+      owner: "claude-code",
+      target_path: "CLAUDE.md",
+      block_id: CLAUDE_BLOCK_ID,
+      content_sha256: hex(CLAUDE_MANAGED_BLOCK_CONTENT)
+    });
+  }
+  if (enabledAgents.includes("codebuddy")) {
+    let codebuddyContent = await readOptional(join5(root, "CODEBUDDY.md"));
+    codebuddyContent = upsertManagedBlockById(codebuddyContent, CODEBUDDY_BLOCK_ID, CODEBUDDY_MANAGED_BLOCK_CONTENT);
+    files.set("CODEBUDDY.md", codebuddyContent);
+    managedBlocks.push({
+      owner: "codebuddy",
+      target_path: "CODEBUDDY.md",
+      block_id: CODEBUDDY_BLOCK_ID,
+      content_sha256: hex(CODEBUDDY_MANAGED_BLOCK_CONTENT)
+    });
+  }
+  for (const target of mergedTargets) {
     files.set(target.target_path, target.bytes);
   }
+  managedBlocks.sort((left, right) => {
+    const byTarget = left.target_path.localeCompare(right.target_path);
+    return byTarget !== 0 ? byTarget : left.block_id.localeCompare(right.block_id);
+  });
   const installedState = {
-    schema_version: 2,
+    schema_version: 3,
     profile,
-    bundle_version: bundle.manifest.bundle_version,
-    bundle_manifest_hash: bundleHash,
+    adapters: enabledAgents,
     installed_at: (/* @__PURE__ */ new Date()).toISOString(),
-    files: managed.map((target) => ({
+    manifests,
+    files: mergedTargets.map((target) => ({
+      owner: target.owner,
       source_path: target.source_path,
       target_path: target.target_path,
       sha256: target.sha256
-    })).sort((left, right) => left.target_path.localeCompare(right.target_path))
+    })),
+    managed_blocks: managedBlocks
   };
   files.set(INSTALLED_BUNDLE_PATH, JSON.stringify(installedState, null, 2) + "\n");
   const paths = [...files.keys()].sort((left, right) => left.localeCompare(right));
@@ -1824,32 +2212,21 @@ async function initializeProject(options) {
   return {
     projectConfig,
     paths,
-    bundleHash,
-    registryVersion: bundle.manifest.bundle_version
+    bundleHash: primaryBundleHash,
+    registryVersion: primaryRegistryVersion
   };
 }
 
 // ../core/dist/project/refresh.js
-import { createHash as createHash3 } from "node:crypto";
-import { readFile as readFile5, readdir as readdir3, rmdir, stat as stat3 } from "node:fs/promises";
+import { createHash as createHash5 } from "node:crypto";
+import { readFile as readFile5, readdir as readdir3, rmdir } from "node:fs/promises";
 import { dirname as dirname3, join as join6, resolve as resolve4 } from "node:path";
 import { parse as parseYaml3, stringify as stringifyYaml2 } from "yaml";
 var INSTALLED_STATE_PATH = ".harness/state/local/installed-harness-bundle.json";
 var CONTEXT_INDEX_PATH = ".harness/context-index.json";
-async function exists3(path) {
-  try {
-    await stat3(path);
-    return true;
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return false;
-    }
-    throw error;
-  }
-}
 async function fileHex(path) {
   try {
-    return createHash3("sha256").update(await readFile5(path)).digest("hex");
+    return createHash5("sha256").update(await readFile5(path)).digest("hex");
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       return null;
@@ -1870,17 +2247,17 @@ async function readOptionalText(path) {
 async function readInstalledState(root) {
   const content = await readOptionalText(join6(root, INSTALLED_STATE_PATH));
   if (content === "") {
-    return { profile: null, schemaVersion: null, trusted: /* @__PURE__ */ new Map() };
+    return { profile: null, schemaVersion: null, adapters: [], trusted: /* @__PURE__ */ new Map() };
   }
   let parsed;
   try {
     parsed = JSON.parse(content);
   } catch {
-    return { profile: null, schemaVersion: null, trusted: /* @__PURE__ */ new Map() };
+    return { profile: null, schemaVersion: null, adapters: [], trusted: /* @__PURE__ */ new Map() };
   }
   const profile = parseHarnessProfile(parsed.profile);
   const trusted = /* @__PURE__ */ new Map();
-  if (parsed.schema_version === 2 && Array.isArray(parsed.files)) {
+  if ((parsed.schema_version === 2 || parsed.schema_version === 3) && Array.isArray(parsed.files)) {
     for (const entry of parsed.files) {
       if (entry !== null && typeof entry === "object" && "target_path" in entry && "sha256" in entry) {
         const target = entry.target_path;
@@ -1891,7 +2268,9 @@ async function readInstalledState(root) {
       }
     }
   }
-  return { profile, schemaVersion: typeof parsed.schema_version === "number" ? parsed.schema_version : null, trusted };
+  const schemaVersion = typeof parsed.schema_version === "number" ? parsed.schema_version : null;
+  const adapters = schemaVersion === 3 && Array.isArray(parsed.adapters) ? sortHarnessAgents(parsed.adapters.filter((value) => value === "claude-code" || value === "codex" || value === "cursor" || value === "codebuddy")) : schemaVersion === 1 || schemaVersion === 2 ? ["claude-code"] : [];
+  return { profile, schemaVersion, adapters, trusted };
 }
 async function readContextIndexBundleHash(root) {
   const content = await readOptionalText(join6(root, CONTEXT_INDEX_PATH));
@@ -1905,16 +2284,11 @@ async function readContextIndexBundleHash(root) {
     return null;
   }
 }
-async function pruneEmptyParentDirs(root, deletedPaths) {
-  const claudeRoot = join6(root, ".claude");
-  const boundaries = /* @__PURE__ */ new Set([
-    claudeRoot,
-    join6(claudeRoot, "skills"),
-    join6(claudeRoot, "agents")
-  ]);
+async function pruneEmptyParentDirs(root, deletedPaths, boundaryPaths) {
+  const boundaries = new Set(boundaryPaths.map((path) => join6(root, path)));
   for (const deleted of deletedPaths) {
     let dir = dirname3(join6(root, deleted));
-    while (dir.startsWith(claudeRoot) && !boundaries.has(dir)) {
+    while (dir.startsWith(root) && !boundaries.has(dir)) {
       let entries;
       try {
         entries = await readdir3(dir);
@@ -1954,82 +2328,130 @@ function conflict(target, reason, oldSha, incomingSha) {
 function sortByTarget(items) {
   return [...items].sort((left, right) => left.target_path.localeCompare(right.target_path));
 }
-async function refreshMarkdownBlock(root, fileName, blockContent, ops, conflicts, preserved) {
-  const original = await readOptionalText(join6(root, fileName));
-  const current = original === "" ? null : createHash3("sha256").update(original).digest("hex");
-  const refresh = refreshManagedBlock(original, blockContent);
-  const synthetic = {
-    source_path: fileName,
-    target_path: fileName,
-    sha256: createHash3("sha256").update(blockContent).digest("hex"),
-    bytes: new TextEncoder().encode(blockContent)
-  };
-  if (refresh.conflict) {
-    preserved.push(item(synthetic, "preserve", "MALFORMED_MANAGED_BLOCK", current, synthetic.sha256));
-    conflicts.push(conflict(synthetic, "MALFORMED_MANAGED_BLOCK", current, synthetic.sha256));
-    return;
-  }
-  if (refresh.content === original) {
-    return;
-  }
-  ops.push({
-    operation: original === "" ? "add" : "modify",
-    path: fileName,
-    content: refresh.content
-  });
-}
-async function reconcileContextIndex(root, bundleVersion, bundleManifestHash) {
+async function reconcileContextIndex(root, profile, agents, manifests, codebuddySurface2) {
   const existing = await readOptionalText(join6(root, CONTEXT_INDEX_PATH));
-  let record = {};
-  if (existing !== "") {
-    try {
-      record = JSON.parse(existing);
-    } catch {
-      record = {};
-    }
-  }
-  if (Object.keys(record).length === 0) {
-    record = {
-      schema_version: 1,
-      project: { claude_md: "CLAUDE.md", agents_md: "AGENTS.md" },
-      rules: [".claude/rules/harness-general.md"],
-      knowledge: { index: ".harness/knowledge/index.json" },
-      codebase: { map: ".harness/codebase/map", status: "missing" }
-    };
-  }
-  record.skill_bundle = {
-    registry_version: bundleVersion,
-    bundle_hash: bundleManifestHash
+  const context = { profile, codebuddySurface: codebuddySurface2 };
+  const record = {
+    schema_version: 2,
+    project: {
+      shared_instructions: "AGENTS.md",
+      adapters: Object.fromEntries(agents.map((agent) => [
+        agent,
+        getAdapter(agent).contextIndex(context)
+      ]))
+    },
+    knowledge: { index: ".harness/knowledge/index.json" },
+    codebase: { map: ".harness/codebase/map", status: "missing" },
+    skill_bundles: Object.fromEntries(manifests.map((manifest) => [
+      manifest.adapter,
+      { registry_version: manifest.bundle_version, bundle_hash: manifest.bundle_manifest_hash }
+    ]))
   };
+  const next = JSON.stringify(record, null, 2) + "\n";
+  if (existing === next)
+    return null;
   return {
     operation: existing === "" ? "add" : "modify",
     path: CONTEXT_INDEX_PATH,
-    content: JSON.stringify(record, null, 2) + "\n"
+    content: next
   };
 }
-async function profileTransitionOperation(root, previousProfile, profile) {
-  if (previousProfile === null || previousProfile === profile)
+async function projectTransitionOperation(root, previousProfile, profile, oldAgents, agents, codebuddySurface2) {
+  if (previousProfile === profile && oldAgents.length === agents.length && oldAgents.every((agent, index) => agent === agents[index]))
     return null;
   const path = ".harness/project.yaml";
   const content = await readOptionalText(join6(root, path));
-  const project = projectConfigSchema.parse(parseYaml3(content));
+  if (content === "")
+    return null;
+  const project = parseYaml3(content);
   return {
     operation: "modify",
     path,
     content: stringifyYaml2({
       ...project,
-      project: { ...project.project, profiles: [profile] }
+      project: { ...project.project, profiles: [profile] },
+      adapters: { enabled: agents },
+      ...agents.includes("codebuddy") ? { adapter_options: { codebuddy: { surface: codebuddySurface2 } } } : { adapter_options: void 0 }
     }, { sortMapEntries: true })
   };
 }
+function mergeTargets(targets) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const target of targets) {
+    grouped.set(target.target_path, [...grouped.get(target.target_path) ?? [], target]);
+  }
+  return [...grouped.entries()].map(([path, values]) => {
+    const first = values[0];
+    if (first === void 0)
+      throw new TargetCollisionError(path);
+    if (values.some((value) => value.sha256 !== first.sha256))
+      throw new TargetCollisionError(path);
+    const owner = new Set(values.map((value) => value.owner)).size === 1 ? first.owner : "shared";
+    return { ...first, owner };
+  }).sort((left, right) => left.target_path.localeCompare(right.target_path));
+}
+async function reconcileMarkdownBlock(root, fileName, blockId, content, remove, ops, conflicts, preserved) {
+  const original = await readOptionalText(join6(root, fileName));
+  const synthetic = {
+    source_path: fileName,
+    target_path: fileName,
+    sha256: createHash5("sha256").update(content).digest("hex"),
+    bytes: new TextEncoder().encode(content)
+  };
+  let next;
+  try {
+    if (remove) {
+      const hasId = original.includes(`<!-- hunter-harness:start id=${blockId} -->`);
+      next = hasId ? removeManagedBlockById(original, blockId) : removeManagedBlock(original);
+    } else {
+      const refreshed = refreshManagedBlockById(original, blockId, content, { upgradeLegacy: true });
+      if (refreshed.conflict)
+        throw new Error("managed block conflict");
+      next = refreshed.content;
+    }
+  } catch {
+    const current = original === "" ? null : createHash5("sha256").update(original).digest("hex");
+    preserved.push(item(synthetic, "preserve", "MALFORMED_MANAGED_BLOCK", current, synthetic.sha256));
+    conflicts.push(conflict(synthetic, "MALFORMED_MANAGED_BLOCK", current, synthetic.sha256));
+    return;
+  }
+  if (next !== original)
+    ops.push({
+      operation: original === "" ? "add" : "modify",
+      path: fileName,
+      content: next
+    });
+}
+function stateWithoutInstalledAt(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value))
+    return value;
+  const copy = { ...value };
+  delete copy.installed_at;
+  return copy;
+}
 async function refreshProject(options) {
   const root = resolve4(options.projectRoot);
   const profile = options.profile;
-  const newManaged = await managedTargets(options.resourcesRoot, profile);
-  const newBundle = await loadProfileBundle(options.resourcesRoot, profile);
-  const bundleManifestHash = sha256Bytes(canonicalJson(newBundle.manifest.files));
   const installed = await readInstalledState(root);
   const previousProfile = installed.profile;
+  const agents = sortHarnessAgents(options.agents);
+  const oldAgents = installed.adapters.length > 0 ? installed.adapters : ["claude-code"];
+  const codebuddySurface2 = options.codebuddySurface ?? "both";
+  const context = { profile, codebuddySurface: codebuddySurface2 };
+  const owned = [];
+  const manifests = [];
+  for (const agent of agents) {
+    const bundle = await loadAgentBundle(options.resourcesRoot, profile, agent);
+    manifests.push({
+      adapter: agent,
+      bundle_version: bundle.manifest.bundle_version,
+      bundle_manifest_hash: sha256Bytes(canonicalJson(bundle.manifest.files))
+    });
+    for (const target of managedTargetsFor(getAdapter(agent), bundle, context)) {
+      owned.push({ ...target, owner: agent });
+    }
+  }
+  const newManaged = mergeTargets(owned);
   let trusted = installed.trusted;
   let migrationOldPaths = null;
   if (installed.schemaVersion === 1) {
@@ -2056,9 +2478,14 @@ async function refreshProject(options) {
         });
       }
     }
-  } else if (previousProfile !== null && previousProfile !== profile) {
-    const oldManaged = await managedTargets(options.resourcesRoot, previousProfile);
-    oldOnly = oldManaged.filter((target) => !newTargetSet.has(target.target_path));
+  } else if (previousProfile !== null) {
+    const oldContext = { profile: previousProfile, codebuddySurface: codebuddySurface2 };
+    const oldTargets = [];
+    for (const agent of oldAgents) {
+      const bundle = await loadAgentBundle(options.resourcesRoot, previousProfile, agent);
+      oldTargets.push(...managedTargetsFor(getAdapter(agent), bundle, oldContext));
+    }
+    oldOnly = oldTargets.filter((target) => !newTargetSet.has(target.target_path));
   }
   const applied = [];
   const removed = [];
@@ -2073,12 +2500,12 @@ async function refreshProject(options) {
     if (current === null) {
       applied.push(item(target, "add", "MISSING_TARGET", null, incoming));
       ops.push({ operation: "add", path: target.target_path, content: target.bytes });
-      newStateFiles.push({ source_path: target.source_path, target_path: target.target_path, sha256: incoming });
+      newStateFiles.push({ owner: target.owner, source_path: target.source_path, target_path: target.target_path, sha256: incoming });
       continue;
     }
     if (current === incoming) {
       unchanged.push(item(target, "unchanged", "ALREADY_CURRENT", current, incoming));
-      newStateFiles.push({ source_path: target.source_path, target_path: target.target_path, sha256: incoming });
+      newStateFiles.push({ owner: target.owner, source_path: target.source_path, target_path: target.target_path, sha256: incoming });
       continue;
     }
     const trustedHash = trusted.get(target.target_path);
@@ -2086,13 +2513,13 @@ async function refreshProject(options) {
       const reason = options.forceManaged ? "FORCE_MANAGED" : "BASELINE_CLEAN";
       applied.push(item(target, "replace", reason, current, incoming));
       ops.push({ operation: "modify", path: target.target_path, content: target.bytes });
-      newStateFiles.push({ source_path: target.source_path, target_path: target.target_path, sha256: incoming });
+      newStateFiles.push({ owner: target.owner, source_path: target.source_path, target_path: target.target_path, sha256: incoming });
     } else {
       const reason = trustedHash === void 0 ? "LEGACY_BASELINE_UNKNOWN" : "LOCAL_MODIFICATION";
       preserved.push(item(target, "preserve", reason, current, incoming));
       conflicts.push(conflict(target, reason, current, incoming));
       if (trustedHash !== void 0) {
-        newStateFiles.push({ source_path: target.source_path, target_path: target.target_path, sha256: trustedHash });
+        newStateFiles.push({ owner: target.owner, source_path: target.source_path, target_path: target.target_path, sha256: trustedHash });
       }
     }
   }
@@ -2101,7 +2528,7 @@ async function refreshProject(options) {
     if (current === null) {
       continue;
     }
-    const trustedHash = trusted.get(target.target_path);
+    const trustedHash = target.sha256 !== "" ? target.sha256 : void 0;
     const clean = trustedHash !== void 0 && current === trustedHash;
     if (clean || options.forceManaged) {
       const reason = clean ? "BASELINE_CLEAN" : "FORCE_MANAGED";
@@ -2113,28 +2540,60 @@ async function refreshProject(options) {
       conflicts.push(conflict(target, reason, current, null));
     }
   }
-  await refreshMarkdownBlock(root, "AGENTS.md", AGENTS_MANAGED_BLOCK_CONTENT, ops, conflicts, preserved);
-  await refreshMarkdownBlock(root, "CLAUDE.md", CLAUDE_MANAGED_BLOCK_CONTENT, ops, conflicts, preserved);
-  const profileOperation = await profileTransitionOperation(root, previousProfile, profile);
-  if (profileOperation !== null)
-    ops.push(profileOperation);
-  ops.push(await reconcileContextIndex(root, newBundle.manifest.bundle_version, bundleManifestHash));
+  await reconcileMarkdownBlock(root, "AGENTS.md", AGENTS_CORE_BLOCK_ID, AGENTS_MANAGED_BLOCK_CONTENT, false, ops, conflicts, preserved);
+  await reconcileMarkdownBlock(root, "CLAUDE.md", CLAUDE_BLOCK_ID, CLAUDE_MANAGED_BLOCK_CONTENT, !agents.includes("claude-code"), ops, conflicts, preserved);
+  await reconcileMarkdownBlock(root, "CODEBUDDY.md", CODEBUDDY_BLOCK_ID, CODEBUDDY_MANAGED_BLOCK_CONTENT, !agents.includes("codebuddy"), ops, conflicts, preserved);
+  const projectOperation = await projectTransitionOperation(root, previousProfile, profile, oldAgents, agents, codebuddySurface2);
+  if (projectOperation !== null)
+    ops.push(projectOperation);
+  const contextOperation = await reconcileContextIndex(root, profile, agents, manifests, codebuddySurface2);
+  if (contextOperation !== null)
+    ops.push(contextOperation);
+  const managedBlocks = [
+    {
+      owner: "shared",
+      target_path: "AGENTS.md",
+      block_id: AGENTS_CORE_BLOCK_ID,
+      content_sha256: createHash5("sha256").update(AGENTS_MANAGED_BLOCK_CONTENT).digest("hex")
+    },
+    ...agents.includes("claude-code") ? [{
+      owner: "claude-code",
+      target_path: "CLAUDE.md",
+      block_id: CLAUDE_BLOCK_ID,
+      content_sha256: createHash5("sha256").update(CLAUDE_MANAGED_BLOCK_CONTENT).digest("hex")
+    }] : [],
+    ...agents.includes("codebuddy") ? [{
+      owner: "codebuddy",
+      target_path: "CODEBUDDY.md",
+      block_id: CODEBUDDY_BLOCK_ID,
+      content_sha256: createHash5("sha256").update(CODEBUDDY_MANAGED_BLOCK_CONTENT).digest("hex")
+    }] : []
+  ].sort((left, right) => left.target_path.localeCompare(right.target_path) || left.block_id.localeCompare(right.block_id));
   const installedState = {
-    schema_version: 2,
+    schema_version: 3,
     profile,
-    bundle_version: newBundle.manifest.bundle_version,
-    bundle_manifest_hash: bundleManifestHash,
+    adapters: agents,
     installed_at: (/* @__PURE__ */ new Date()).toISOString(),
-    files: newStateFiles.sort((left, right) => left.target_path.localeCompare(right.target_path))
+    manifests,
+    files: newStateFiles.sort((left, right) => left.target_path.localeCompare(right.target_path) || left.source_path.localeCompare(right.source_path)),
+    managed_blocks: managedBlocks
   };
-  ops.push({
-    operation: await exists3(join6(root, INSTALLED_STATE_PATH)) ? "modify" : "add",
-    path: INSTALLED_STATE_PATH,
-    content: JSON.stringify(installedState, null, 2) + "\n"
-  });
+  const existingState = await readOptionalText(join6(root, INSTALLED_STATE_PATH));
+  let existingParsed = null;
+  try {
+    existingParsed = existingState === "" ? null : JSON.parse(existingState);
+  } catch {
+  }
+  if (JSON.stringify(stateWithoutInstalledAt(existingParsed)) !== JSON.stringify(stateWithoutInstalledAt(installedState))) {
+    ops.push({
+      operation: existingState === "" ? "add" : "modify",
+      path: INSTALLED_STATE_PATH,
+      content: JSON.stringify(installedState, null, 2) + "\n"
+    });
+  }
   if (!options.dryRun) {
     await runTransaction(root, ops, { kind: "refresh" });
-    await pruneEmptyParentDirs(root, removed.map((item2) => item2.target_path));
+    await pruneEmptyParentDirs(root, removed.map((item2) => item2.target_path), getAdapters([.../* @__PURE__ */ new Set([...agents, ...oldAgents])]).flatMap((adapter) => adapter.pruneBoundaries(context)));
   }
   return {
     profile,
@@ -2519,18 +2978,16 @@ var PushWorkflowError = class extends Error {
     this.code = code;
   }
 };
-var MANAGED_ROOTS = [
-  ".claude/rules",
+var SHARED_MANAGED_ROOTS = [
   ".harness/knowledge",
   ".harness/codebase"
 ];
-var MANAGED_FILES = [
-  "CLAUDE.md",
+var SHARED_MANAGED_FILES = [
   "AGENTS.md",
   ".harness/project.yaml",
   ".harness/context-index.json"
 ];
-async function exists4(path) {
+async function exists3(path) {
   try {
     await lstat2(path);
     return true;
@@ -2542,7 +2999,7 @@ async function exists4(path) {
   }
 }
 async function walkFiles(root, current, output) {
-  if (!await exists4(current)) {
+  if (!await exists3(current)) {
     return;
   }
   for (const item2 of await readdir4(current, { withFileTypes: true })) {
@@ -2557,23 +3014,50 @@ async function walkFiles(root, current, output) {
     }
   }
 }
-async function managedFiles(projectRoot) {
+function enabledHarnessAgents(project) {
+  return project.adapters.enabled.flatMap((agent) => {
+    const parsed = harnessAgentSchema.safeParse(agent);
+    return parsed.success ? [parsed.data] : [];
+  });
+}
+async function walkHarnessEntries(root, directory, output) {
+  if (!await exists3(directory))
+    return;
+  for (const item2 of await readdir4(directory, { withFileTypes: true })) {
+    if (item2.name.startsWith("harness-")) {
+      const path = join9(directory, item2.name);
+      if (item2.isDirectory()) {
+        await walkFiles(root, path, output);
+      } else if (item2.isFile()) {
+        output.push(normalizeManagedPath(relative(root, path).replaceAll("\\", "/")));
+      }
+    }
+  }
+}
+async function managedFiles(projectRoot, project) {
   const root = resolve5(projectRoot);
   const paths = [];
-  for (const path of MANAGED_FILES) {
-    if (await exists4(join9(root, path))) {
+  const adapters = getAdapters(enabledHarnessAgents(project));
+  const managedFiles2 = [
+    ...SHARED_MANAGED_FILES,
+    ...adapters.some((adapter) => adapter.name === "claude-code") ? ["CLAUDE.md"] : [],
+    ...adapters.some((adapter) => adapter.name === "codebuddy") ? ["CODEBUDDY.md"] : []
+  ];
+  for (const path of managedFiles2) {
+    if (await exists3(join9(root, path))) {
       paths.push(path);
     }
   }
-  for (const path of MANAGED_ROOTS) {
+  for (const path of SHARED_MANAGED_ROOTS) {
     await walkFiles(root, join9(root, path), paths);
   }
-  const skillsRoot = join9(root, ".claude", "skills");
-  if (await exists4(skillsRoot)) {
-    for (const item2 of await readdir4(skillsRoot, { withFileTypes: true })) {
-      if (item2.isDirectory() && item2.name.startsWith("harness-")) {
-        await walkFiles(root, join9(skillsRoot, item2.name), paths);
-      }
+  for (const adapter of adapters) {
+    if (adapter.rulesRoot !== null) {
+      await walkFiles(root, join9(root, adapter.rulesRoot), paths);
+    }
+    await walkHarnessEntries(root, join9(root, adapter.skillsRoot), paths);
+    if (adapter.agentsRoot !== null) {
+      await walkHarnessEntries(root, join9(root, adapter.agentsRoot), paths);
     }
   }
   const result = {};
@@ -2693,8 +3177,8 @@ async function pushProject(options) {
   let project = await readProject(root);
   let baseline = await readBaseline(root);
   const profile = parseHarnessProfile(project.project.profiles[0]);
-  const installedPaths = profile === null ? /* @__PURE__ */ new Set() : await managedBundleTargets(options.resourcesRoot, profile);
-  let preview = makePreview(baseline, await managedFiles(root), options.confirmedProjectLocal ?? [], installedPaths);
+  const installedPaths = profile === null ? /* @__PURE__ */ new Set() : new Set(await Promise.all(enabledHarnessAgents(project).map((agent) => managedBundleTargets(options.resourcesRoot, profile, agent))).then((targets) => targets.flatMap((target) => [...target])));
+  let preview = makePreview(baseline, await managedFiles(root, project), options.confirmedProjectLocal ?? [], installedPaths);
   if (preview.blocked) {
     throw new PushWorkflowError("sensitive information scan blocked the proposal", 6, "SENSITIVE_CONTENT_BLOCKED");
   }
@@ -2734,7 +3218,7 @@ async function pushProject(options) {
     let workflow = priorWorkflow?.local_project_key === project.project.local_project_key ? priorWorkflow : newWorkflowState(project, clientId);
     workflow.client_id = clientId;
     await atomicWriteJson(workflowPath, workflow);
-    preview = makePreview(baseline, await managedFiles(root), options.confirmedProjectLocal ?? [], installedPaths, workflow.created_at);
+    preview = makePreview(baseline, await managedFiles(root, project), options.confirmedProjectLocal ?? [], installedPaths, workflow.created_at);
     const requestId = workflow.request_id;
     const client = new HunterHarnessApiClient({
       serverUrl: parsedServerUrl.toString(),
@@ -2752,7 +3236,7 @@ async function pushProject(options) {
       ({ project, baseline } = await bindProject(root, project, baseline, resolved.project_id));
       workflow.project_id = resolved.project_id;
       await atomicWriteJson(workflowPath, workflow);
-      preview = makePreview(baseline, await managedFiles(root), options.confirmedProjectLocal ?? [], installedPaths, workflow.created_at);
+      preview = makePreview(baseline, await managedFiles(root, project), options.confirmedProjectLocal ?? [], installedPaths, workflow.created_at);
       if (preview.blocked) {
         throw new PushWorkflowError("sensitive information scan blocked the proposal", 6, "SENSITIVE_CONTENT_BLOCKED");
       }
@@ -2948,7 +3432,7 @@ var AGENT_DESCRIPTORS = {
 var INSTALLABLE_AGENTS = Object.keys(AGENT_DESCRIPTORS).filter((agent) => AGENT_DESCRIPTORS[agent]?.installable === true);
 
 // ../core/dist/transaction/recovery.js
-import { readFile as readFile10, readdir as readdir6, rm as rm6, stat as stat4 } from "node:fs/promises";
+import { readFile as readFile10, readdir as readdir6, rm as rm6, stat as stat3 } from "node:fs/promises";
 import { join as join11 } from "node:path";
 async function recoverTransaction(projectRoot, transactionId) {
   const journal = JSON.parse(await readFile10(join11(stateLayout(projectRoot).transactions, transactionId, "journal.json"), "utf8"));
@@ -2995,7 +3479,7 @@ async function pendingTransactions(projectRoot) {
 }
 async function pathExists(path) {
   try {
-    await stat4(path);
+    await stat3(path);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -3014,8 +3498,8 @@ async function rollbackLatestCommittedUpdate(projectRoot) {
   const after = JSON.parse(await readFile10(join11(transactionRoot, "after", "manifest.json"), "utf8"));
   for (const entry of after) {
     const target = join11(projectRoot, entry.path);
-    const exists6 = await pathExists(target);
-    if (exists6 !== entry.exists || exists6 && await sha256File(target) !== entry.hash) {
+    const exists5 = await pathExists(target);
+    if (exists5 !== entry.exists || exists5 && await sha256File(target) !== entry.hash) {
       throw new Error("cannot rollback dirty path: " + entry.path);
     }
   }
@@ -3027,15 +3511,15 @@ async function rollbackLatestCommittedUpdate(projectRoot) {
     }
     seen.add(snapshot.path);
     const target = join11(projectRoot, snapshot.path);
-    const exists6 = await pathExists(target);
+    const exists5 = await pathExists(target);
     if (snapshot.existed && snapshot.snapshot_name !== null) {
       const content = await readFile10(join11(transactionRoot, "before", snapshot.snapshot_name));
       operations.push({
-        operation: exists6 ? "modify" : "add",
+        operation: exists5 ? "modify" : "add",
         path: snapshot.path,
         content
       });
-    } else if (exists6) {
+    } else if (exists5) {
       operations.push({ operation: "delete", path: snapshot.path });
     }
   }
@@ -3308,7 +3792,8 @@ async function updateProject(options) {
           equivalent = finalContent === sourceContent;
         } else if (incoming !== null) {
           const incomingBlock = extractManagedBlock(incoming) ?? incoming.trim();
-          const blockId = operation.operation === "add" || operation.operation === "modify" ? operation.block_id : void 0;
+          const incomingId = extractSingleManagedBlockById(incoming)?.id;
+          const blockId = operation.operation === "add" || operation.operation === "modify" ? operation.block_id ?? incomingId : void 0;
           finalContent = blockId !== void 0 ? upsertManagedBlockById(targetContent ?? "", blockId, incomingBlock) : upsertManagedBlock(targetContent ?? "", incomingBlock);
           equivalent = finalContent === targetContent;
         }
@@ -3416,19 +3901,82 @@ import { isAbsolute as isAbsolute2, join as join13 } from "node:path";
 import { readFile as readFile12 } from "node:fs/promises";
 var InitConfigurationError = class extends Error {
   exitCode;
-  constructor(message, exitCode = 3, options) {
+  code;
+  constructor(message, exitCode = 3, code = "INIT_CONFIG_INVALID", options) {
     super(message, options);
     this.name = "InitConfigurationError";
     this.exitCode = exitCode;
+    this.code = code;
   }
 };
+function harnessErrorInfo(error) {
+  const info = {};
+  if (error === null || typeof error !== "object") return info;
+  const record = error;
+  if (typeof record.code === "string") info.code = record.code;
+  if (typeof record.exitCode === "number") {
+    info.exitCode = record.exitCode;
+  }
+  return info;
+}
+var AGENT_BY_INDEX = {
+  "1": "claude-code",
+  "2": "codex",
+  "3": "cursor",
+  "4": "codebuddy"
+};
 function normalizeProfile(value) {
   if (value === void 0) return void 0;
   if (value === "" || value === "1" || value === "general") return "general";
   if (value === "2" || value === "java") return "java";
-  throw new InitConfigurationError("profile must be general or java");
+  throw new InitConfigurationError("\u914D\u7F6E\u7C7B\u578B\u5FC5\u987B\u4E3A general \u6216 java");
+}
+function parseAgentsInput(raw) {
+  const trimmed = raw.trim();
+  if (trimmed === "") return ["claude-code"];
+  if (trimmed === "all") return [...HARNESS_AGENT_ORDER];
+  const agents = [];
+  for (const token of trimmed.split(",")) {
+    const value = token.trim();
+    const byIndex = AGENT_BY_INDEX[value];
+    if (byIndex !== void 0) {
+      agents.push(byIndex);
+      continue;
+    }
+    const byName = harnessAgentSchema.safeParse(value);
+    if (byName.success) {
+      agents.push(byName.data);
+      continue;
+    }
+    throw new InitConfigurationError(`\u672A\u77E5 Agent\uFF1A${value}`, 3, "AGENT_UNSUPPORTED");
+  }
+  if (agents.length === 0) {
+    throw new InitConfigurationError("Agent \u5217\u8868\u4E3A\u7A7A", 3, "AGENTS_REQUIRED");
+  }
+  return sortHarnessAgents(agents);
 }
-async function resolveInitConfig(cwd, flags, promptMissing) {
+function parseAgentsFromConfig(value) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new InitConfigurationError("Agent \u5217\u8868\u4E3A\u7A7A", 3, "AGENTS_REQUIRED");
+  }
+  const agents = [];
+  for (const item2 of value) {
+    const parsed = harnessAgentSchema.safeParse(item2);
+    if (!parsed.success) {
+      throw new InitConfigurationError(
+        `\u672A\u77E5 Agent\uFF1A${String(item2)}`,
+        3,
+        "AGENT_UNSUPPORTED"
+      );
+    }
+    agents.push(parsed.data);
+  }
+  return sortHarnessAgents(agents);
+}
+function hasOwn(record, key) {
+  return Object.prototype.hasOwnProperty.call(record, key);
+}
+async function resolveInitConfig(cwd, flags, prompts = {}, warnings = []) {
   let fileConfig = {};
   if (flags.config !== void 0) {
     const path = isAbsolute2(flags.config) ? flags.config : join13(cwd, flags.config);
@@ -3438,20 +3986,58 @@ async function resolveInitConfig(cwd, flags, promptMissing) {
       throw new InitConfigurationError(
         "unable to read init config: " + (error instanceof Error ? error.message : String(error)),
         3,
+        "INIT_CONFIG_INVALID",
         { cause: error }
       );
     }
   }
-  const configuredAdapter = fileConfig.adapter ?? flags.adapter ?? "claude-code";
-  if (configuredAdapter !== "claude-code") {
-    throw new InitConfigurationError("only claude-code is supported");
+  const hasConfigAgents = hasOwn(fileConfig, "agents");
+  const hasConfigAdapter = hasOwn(fileConfig, "adapter");
+  if (hasConfigAgents && hasConfigAdapter) {
+    throw new InitConfigurationError(
+      "\u914D\u7F6E\u4E0D\u80FD\u540C\u65F6\u5305\u542B agents \u4E0E adapter",
+      3,
+      "AGENT_OPTIONS_CONFLICT"
+    );
+  }
+  let agents;
+  if (hasConfigAgents) {
+    agents = parseAgentsFromConfig(fileConfig.agents);
+  } else if (hasConfigAdapter) {
+    if (fileConfig.adapter !== "claude-code") {
+      throw new InitConfigurationError(
+        `\u672A\u77E5 Agent\uFF1A${String(fileConfig.adapter)}`,
+        3,
+        "AGENT_UNSUPPORTED"
+      );
+    }
+    agents = ["claude-code"];
+    warnings.push(
+      'DEPRECATION: init config field "adapter" is deprecated; use "agents" instead'
+    );
+  } else if (flags.agents !== void 0) {
+    agents = parseAgentsInput(flags.agents);
+  } else if (prompts.agents !== void 0) {
+    agents = parseAgentsInput(await prompts.agents());
+  } else {
+    agents = ["claude-code"];
+  }
+  const surfaceFromConfig = hasOwn(fileConfig, "codebuddy_surface");
+  const surfaceFromFlags = flags.codebuddySurface !== void 0;
+  if ((surfaceFromConfig || surfaceFromFlags) && !agents.includes("codebuddy")) {
+    throw new InitConfigurationError(
+      "\u672A\u9009\u62E9 CodeBuddy \u65F6\u4E0D\u80FD\u6307\u5B9A codebuddy_surface",
+      3,
+      "CODEBUDDY_SURFACE_UNUSED"
+    );
   }
   const profile = normalizeProfile(
-    fileConfig.profile ?? flags.profile ?? (promptMissing === void 0 ? void 0 : await promptMissing())
+    fileConfig.profile ?? flags.profile ?? (prompts.profile === void 0 ? void 0 : await prompts.profile())
   );
   const candidate = {
-    adapter: "claude-code",
+    agents,
     profile,
+    codebuddy_surface: fileConfig.codebuddy_surface ?? flags.codebuddySurface ?? "both",
     server_url: fileConfig.server_url ?? flags.serverUrl ?? null,
     token_env: fileConfig.token_env ?? flags.tokenEnv ?? "HUNTER_HARNESS_TOKEN",
     project_id: fileConfig.project_id ?? null,
@@ -3464,7 +4050,8 @@ async function resolveInitConfig(cwd, flags, promptMissing) {
   if (!parsed.success) {
     throw new InitConfigurationError(
       "init config schema validation failed: " + parsed.error.message,
-      7
+      7,
+      "INIT_CONFIG_INVALID"
     );
   }
   return parsed.data;
@@ -3501,7 +4088,17 @@ function parseProfile(value, current) {
   }
   if (value === "1" || value === "general") return "general";
   if (value === "2" || value === "java") return "java";
-  throw new Error("profile must be general or java");
+  throw new Error("\u914D\u7F6E\u7C7B\u578B\u5FC5\u987B\u4E3A general \u6216 java");
+}
+function refreshAgents(config) {
+  const agents = sortHarnessAgents(config.adapters.enabled.flatMap((agent) => {
+    const parsed = harnessAgentSchema.safeParse(agent);
+    return parsed.success ? [parsed.data] : [];
+  }));
+  return agents.length > 0 ? agents : ["claude-code"];
+}
+function codebuddySurface(config) {
+  return config.adapter_options?.codebuddy?.surface ?? "both";
 }
 function summarize(result) {
   const items = [
@@ -3538,35 +4135,57 @@ function renderProfileTransitionPreview(result) {
     ...result.preserved,
     ...result.unchanged
   ];
-  return "Preview profile transition:\n" + items.map((item2) => `- ${item2.action}: ${item2.target_path} (${item2.reason})`).join("\n") + "\n";
+  const actionLabel = {
+    add: "\u65B0\u589E",
+    replace: "\u66FF\u6362",
+    delete: "\u5220\u9664",
+    preserve: "\u4FDD\u7559",
+    unchanged: "\u65E0\u9700\u53D8\u66F4"
+  };
+  const reasonLabel = {
+    MISSING_TARGET: "\u76EE\u6807\u7F3A\u5931",
+    BASELINE_CLEAN: "\u57FA\u7EBF\u672A\u4FEE\u6539",
+    ALREADY_CURRENT: "\u5DF2\u662F\u6700\u65B0",
+    LOCAL_MODIFICATION: "\u68C0\u6D4B\u5230\u672C\u5730\u4FEE\u6539",
+    MALFORMED_MANAGED_BLOCK: "\u53D7\u7BA1\u533A\u5757\u683C\u5F0F\u5F02\u5E38",
+    LEGACY_PROFILE_FILE_MODIFIED: "\u65E7\u914D\u7F6E\u6587\u4EF6\u5DF2\u4FEE\u6539",
+    LEGACY_BASELINE_UNKNOWN: "\u65E7\u7248\u57FA\u7EBF\u672A\u77E5",
+    FORCE_MANAGED: "\u5F3A\u5236\u66F4\u65B0"
+  };
+  return "\u914D\u7F6E\u5207\u6362\u9884\u89C8\uFF1A\n" + items.map((item2) => `- ${actionLabel[item2.action]}\uFF1A${item2.target_path}\uFF08${reasonLabel[item2.reason]}\uFF09`).join("\n") + "\n";
 }
 async function runRefresh(options, dependencies) {
   const requestId = uuidV7();
   const detection = await detectProject(dependencies.cwd);
   if (detection.status === "absent") {
-    dependencies.stderr("Hunter Harness is not initialized; run `hunter-harness` first.\n");
+    dependencies.stderr("\u5C1A\u672A\u521D\u59CB\u5316 Hunter Harness\uFF1B\u8BF7\u5148\u8FD0\u884C `hunter-harness`\u3002\n");
     return 3;
   }
   if (detection.status === "invalid") {
-    dependencies.stderr("PROJECT_CONFIG_INVALID: .harness/project.yaml is invalid\n");
+    dependencies.stderr("PROJECT_CONFIG_INVALID\uFF1A.harness/project.yaml \u65E0\u6548\n");
     return 3;
   }
   const currentProfile = detection.config.project.profiles[0] ?? "general";
   let targetProfile;
+  let targetAgents;
   try {
     targetProfile = parseProfile(options.profile, currentProfile);
+    targetAgents = options.agents === void 0 ? refreshAgents(detection.config) : parseAgentsInput(options.agents);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    dependencies.stderr(message + "\n");
-    return 3;
+    const code = error instanceof InitConfigurationError ? error.code : void 0;
+    dependencies.stderr((code === void 0 ? "" : code + ": ") + message + "\n");
+    return error instanceof InitConfigurationError ? error.exitCode : 3;
   }
   const dryRun = options.dryRun === true;
-  if (targetProfile !== currentProfile && !dryRun) {
+  if ((targetProfile !== currentProfile || targetAgents.some((agent, index) => agent !== refreshAgents(detection.config)[index]) || targetAgents.length !== refreshAgents(detection.config).length) && !dryRun) {
     try {
       const preview = await refreshProject({
         projectRoot: dependencies.cwd,
         resourcesRoot: dependencies.resourcesRoot,
         profile: targetProfile,
+        agents: targetAgents,
+        codebuddySurface: codebuddySurface(detection.config),
         dryRun: true,
         forceManaged: options.forceManaged === true
       });
@@ -3585,12 +4204,12 @@ async function runRefresh(options, dependencies) {
   if (options.confirmed !== true) {
     if (options.nonInteractive === true) {
       if (!options.yes && !dryRun) {
-        dependencies.stderr("non-interactive refresh requires --yes\n");
+        dependencies.stderr("\u975E\u4EA4\u4E92\u6A21\u5F0F\u5237\u65B0\u9700\u8981 --yes\n");
         return 2;
       }
     } else if (!options.yes && !dryRun) {
-      const label = targetProfile === currentProfile ? `Refresh current profile (${currentProfile})` : `Switch profile ${currentProfile} -> ${targetProfile}`;
-      const answer = await dependencies.prompt(`${label}? [y/N]: `);
+      const label = targetProfile === currentProfile ? `\u5237\u65B0\u5F53\u524D\u914D\u7F6E\uFF08${currentProfile}\uFF09` : `\u5207\u6362\u914D\u7F6E\uFF1A${currentProfile} \u2192 ${targetProfile}`;
+      const answer = await dependencies.prompt(`${label}\uFF1F[y/N]\uFF1A`);
       if (!/^(?:y|yes)$/i.test(answer.trim())) {
         return 2;
       }
@@ -3601,6 +4220,8 @@ async function runRefresh(options, dependencies) {
       projectRoot: dependencies.cwd,
       resourcesRoot: dependencies.resourcesRoot,
       profile: targetProfile,
+      agents: targetAgents,
+      codebuddySurface: codebuddySurface(detection.config),
       dryRun,
       forceManaged: options.forceManaged === true
     });
@@ -3609,17 +4230,20 @@ async function runRefresh(options, dependencies) {
       dependencies.stdout(serializeCliResult({ ...output, request_id: requestId }));
     } else {
       const parts = [];
-      if (result.applied.length > 0) parts.push(`applied ${result.applied.length}`);
-      if (result.removed.length > 0) parts.push(`removed ${result.removed.length}`);
-      if (result.preserved.length > 0) parts.push(`preserved ${result.preserved.length}`);
-      if (result.unchanged.length > 0) parts.push(`unchanged ${result.unchanged.length}`);
-      dependencies.stdout(`Harness refresh (${targetProfile}): ${parts.join(", ") || "no changes"}.
+      if (result.applied.length > 0) parts.push(`\u5DF2\u66F4\u65B0 ${result.applied.length} \u4E2A`);
+      if (result.removed.length > 0) parts.push(`\u5DF2\u5220\u9664 ${result.removed.length} \u4E2A`);
+      if (result.preserved.length > 0) parts.push(`\u5DF2\u4FDD\u7559 ${result.preserved.length} \u4E2A`);
+      if (result.unchanged.length > 0) parts.push(`\u65E0\u9700\u53D8\u66F4 ${result.unchanged.length} \u4E2A`);
+      dependencies.stdout(`Harness \u5237\u65B0\uFF08${targetProfile}\uFF09\uFF1A${parts.join("\uFF0C") || "\u6CA1\u6709\u53D8\u66F4"}\u3002
 `);
     }
     return output.exit_code;
   } catch (error) {
+    const info = harnessErrorInfo(error);
+    const exitCode = info.exitCode ?? 1;
+    const code = info.code;
     const message = error instanceof Error ? error.message : String(error);
-    dependencies.stderr(message + "\n");
+    dependencies.stderr((code !== void 0 ? code + ": " : "") + message + "\n");
     if (options.json === true) {
       dependencies.stdout(serializeCliResult({
         schema_version: 1,
@@ -3627,15 +4251,15 @@ async function runRefresh(options, dependencies) {
         request_id: requestId,
         dry_run: dryRun,
         ok: false,
-        exit_code: 1,
+        exit_code: exitCode,
         project_id: null,
         summary: { applied: 0, removed: 0, preserved: 0, unchanged: 0, conflicts: 0 },
         items: [],
         warnings: [],
-        errors: [{ message }]
+        errors: [{ ...code === void 0 ? {} : { code }, message }]
       }));
     }
-    return 1;
+    return exitCode;
   }
 }
 
@@ -3646,15 +4270,25 @@ function otherProfile(current) {
 async function runFirstInstall(options, dependencies) {
   const requestId = uuidV7();
   try {
+    const warnings = [];
     const config = await resolveInitConfig(
       dependencies.cwd,
       options,
-      options.nonInteractive === true ? void 0 : () => dependencies.prompt(
-        "\u8BF7\u9009\u62E9 Harness \u7C7B\u578B\uFF1A\n1. \u901A\u7528\uFF08\u9ED8\u8BA4\uFF09\n2. Java\n\u8BF7\u8F93\u5165 1 \u6216 2 [1]: "
-      ).then((answer) => answer.trim())
+      options.nonInteractive === true ? {} : {
+        agents: () => dependencies.prompt(
+          "\u8BF7\u9009\u62E9\u76EE\u6807 Agent\uFF08\u53EF\u591A\u9009\uFF0C\u4F7F\u7528\u9017\u53F7\u5206\u9694\uFF09\n  1. Claude Code\n  2. Codex\n  3. Cursor\n  4. CodeBuddy\n\u8BF7\u8F93\u5165\u7F16\u53F7 [1]: "
+        ).then((answer) => answer.trim()),
+        profile: () => dependencies.prompt(
+          "\u8BF7\u9009\u62E9 Harness \u7C7B\u578B\uFF1A\n1. \u901A\u7528\uFF08\u9ED8\u8BA4\uFF09\n2. Java\n\u8BF7\u8F93\u5165 1 \u6216 2 [1]: "
+        ).then((answer) => answer.trim())
+      },
+      warnings
     );
+    for (const warning of warnings) {
+      dependencies.stderr(warning + "\n");
+    }
     if (options.nonInteractive === true && options.yes !== true && options.dryRun !== true) {
-      dependencies.stderr("non-interactive writes require --yes\n");
+      dependencies.stderr("\u975E\u4EA4\u4E92\u6A21\u5F0F\u6267\u884C\u5199\u5165\u64CD\u4F5C\u9700\u8981 --yes\n");
       return 2;
     }
     const result = await initializeProject({
@@ -3676,12 +4310,14 @@ async function runFirstInstall(options, dependencies) {
       warnings: [],
       errors: []
     };
-    dependencies.stdout(options.json === true ? serializeCliResult(output) : "Hunter Harness initialized " + result.paths.length + " files.\n");
+    dependencies.stdout(options.json === true ? serializeCliResult(output) : "Hunter Harness \u521D\u59CB\u5316\u5B8C\u6210\uFF0C\u5171\u5904\u7406 " + result.paths.length + " \u4E2A\u6587\u4EF6\u3002\n");
     return 0;
   } catch (error) {
-    const exitCode = error instanceof InitConfigurationError ? error.exitCode : 1;
+    const info = harnessErrorInfo(error);
+    const exitCode = info.exitCode ?? 1;
+    const code = info.code;
     const message = error instanceof Error ? error.message : String(error);
-    dependencies.stderr(message + "\n");
+    dependencies.stderr((code !== void 0 ? code + ": " : "") + message + "\n");
     if (options.json === true) {
       dependencies.stdout(serializeCliResult({
         schema_version: 1,
@@ -3694,7 +4330,7 @@ async function runFirstInstall(options, dependencies) {
         summary: { planned: 0, applied: 0 },
         items: [],
         warnings: [],
-        errors: [{ message }]
+        errors: [{ ...code === void 0 ? {} : { code }, message }]
       }));
     }
     return exitCode;
@@ -3702,6 +4338,7 @@ async function runFirstInstall(options, dependencies) {
 }
 async function runExistingProject(options, dependencies, currentProfile) {
   const refreshOptions = {};
+  if (options.agents !== void 0) refreshOptions.agents = options.agents;
   if (options.profile !== void 0) refreshOptions.profile = options.profile;
   if (options.nonInteractive !== void 0) refreshOptions.nonInteractive = options.nonInteractive;
   if (options.yes !== void 0) refreshOptions.yes = options.yes;
@@ -3713,9 +4350,9 @@ async function runExistingProject(options, dependencies, currentProfile) {
   }
   const menu = await dependencies.prompt(
     `Hunter Harness \u5DF2\u521D\u59CB\u5316\uFF08profile: ${currentProfile}\uFF09\u3002
-1. Refresh current profile\uFF08\u9ED8\u8BA4\u4E14\u63A8\u8350\uFF09
-2. Switch to the other profile
-3. Cancel
+1. \u5237\u65B0\u5F53\u524D\u914D\u7F6E\uFF08\u9ED8\u8BA4\u4E14\u63A8\u8350\uFF09
+2. \u5207\u6362\u5230\u53E6\u4E00\u79CD\u914D\u7F6E
+3. \u53D6\u6D88
 \u8BF7\u9009\u62E9 [1]: `
   );
   const choice = menu.trim();
@@ -3763,7 +4400,7 @@ async function runCleanup(options, dependencies) {
   const requestId = uuidV7();
   const dryRun = options.dryRun === true;
   if (options.nonInteractive === true && options.yes !== true && !dryRun) {
-    dependencies.stderr("non-interactive cleanup requires --yes\n");
+    dependencies.stderr("\u975E\u4EA4\u4E92\u6A21\u5F0F\u6E05\u7406\u9700\u8981 --yes\n");
     return 2;
   }
   try {
@@ -3791,7 +4428,7 @@ async function runCleanup(options, dependencies) {
       dependencies.stdout(serializeCliResult(output));
     } else {
       dependencies.stdout(
-        `Harness cleanup: pruned ${result.pruned_transactions.length} transaction(s), removed ${result.removed_cache.length} cache entr(ies).
+        `Harness \u6E05\u7406\u5B8C\u6210\uFF1A\u5DF2\u88C1\u526A ${result.pruned_transactions.length} \u4E2A\u4E8B\u52A1\uFF0C\u5DF2\u5220\u9664 ${result.removed_cache.length} \u4E2A\u7F13\u5B58\u6761\u76EE\u3002
 `
       );
     }
@@ -3822,7 +4459,7 @@ async function runCleanup(options, dependencies) {
 async function runPush(options, dependencies) {
   const requestId = uuidV7();
   if (options.nonInteractive === true && options.yes !== true && options.dryRun !== true) {
-    dependencies.stderr("non-interactive push requires --yes\n");
+    dependencies.stderr("\u975E\u4EA4\u4E92\u6A21\u5F0F\u63A8\u9001\u9700\u8981 --yes\n");
     return 2;
   }
   try {
@@ -3901,7 +4538,7 @@ async function runPush(options, dependencies) {
 async function runUpdate(options, dependencies) {
   const requestId = uuidV7();
   if (options.nonInteractive === true && options.yes !== true && options.dryRun !== true) {
-    dependencies.stderr("non-interactive update requires --yes\n");
+    dependencies.stderr("\u975E\u4EA4\u4E92\u6A21\u5F0F\u66F4\u65B0\u9700\u8981 --yes\n");
     return 2;
   }
   const execute = async (dryRun) => updateProject({
@@ -3917,7 +4554,7 @@ async function runUpdate(options, dependencies) {
     if (options.dryRun !== true && options.yes !== true && options.nonInteractive !== true) {
       const preview = await execute(true);
       const answer = await dependencies.prompt(
-        "Apply " + preview.applied.length + " eligible update items? [y/N]: "
+        "\u5E94\u7528 " + preview.applied.length + " \u4E2A\u53EF\u66F4\u65B0\u6761\u76EE\uFF1F[y/N]\uFF1A"
       );
       if (!/^(?:y|yes)$/i.test(answer.trim())) {
         return 2;
@@ -3960,7 +4597,7 @@ async function runUpdate(options, dependencies) {
       warnings: result.skipped,
       errors: []
     };
-    dependencies.stdout(options.json === true ? serializeCliResult(output) : result.artifactId === null ? "No approved updates are available.\n" : "Update applied " + result.applied.length + " items; skipped " + result.skipped.length + ".\n");
+    dependencies.stdout(options.json === true ? serializeCliResult(output) : result.artifactId === null ? "\u6CA1\u6709\u53EF\u5E94\u7528\u7684\u5DF2\u6279\u51C6\u66F4\u65B0\u3002\n" : "\u66F4\u65B0\u5B8C\u6210\uFF1A\u5DF2\u5E94\u7528 " + result.applied.length + " \u4E2A\u6761\u76EE\uFF0C\u8DF3\u8FC7 " + result.skipped.length + " \u4E2A\u3002\n");
     return exitCode;
   } catch (error) {
     const exitCode = error instanceof UpdateWorkflowError ? error.exitCode : 1;
@@ -3989,33 +4626,33 @@ async function runUpdate(options, dependencies) {
 }
 
 // src/commands/recovery.ts
-import { stat as stat5 } from "node:fs/promises";
+import { stat as stat4 } from "node:fs/promises";
 import { join as join15 } from "node:path";
-async function exists5(path) {
+async function exists4(path) {
   try {
-    await stat5(path);
+    await stat4(path);
     return true;
   } catch {
     return false;
   }
 }
 function explicitConfigure(options) {
-  return options.adapter !== void 0 || options.profile !== void 0 || options.config !== void 0 || options.serverUrl !== void 0 || options.tokenEnv !== void 0;
+  return options.agents !== void 0 || options.adapter !== void 0 || options.profile !== void 0 || options.config !== void 0 || options.serverUrl !== void 0 || options.tokenEnv !== void 0;
 }
 async function runRecoveryMenuIfApplicable(options, dependencies) {
   const pending = await pendingTransactions(dependencies.cwd);
   if (pending.length > 0) {
     if (options.nonInteractive === true) {
-      dependencies.stderr("unfinished transaction requires interactive recovery\n");
+      dependencies.stderr("\u5B58\u5728\u672A\u5B8C\u6210\u4E8B\u52A1\uFF0C\u9700\u8981\u4EE5\u4EA4\u4E92\u6A21\u5F0F\u6062\u590D\u3002\n");
       return 5;
     }
     const answer2 = await dependencies.prompt([
-      "Unfinished Hunter Harness transaction detected.",
-      "1. Recover last failed update",
-      "2. Roll back last committed update",
-      "3. View transaction status",
-      "4. Clean old transactions",
-      "Choose [1-4]: "
+      "\u68C0\u6D4B\u5230\u672A\u5B8C\u6210\u7684 Hunter Harness \u4E8B\u52A1\u3002",
+      "1. \u6062\u590D\u6700\u8FD1\u4E00\u6B21\u5931\u8D25\u7684\u66F4\u65B0",
+      "2. \u56DE\u6EDA\u6700\u8FD1\u4E00\u6B21\u5DF2\u63D0\u4EA4\u7684\u66F4\u65B0",
+      "3. \u67E5\u770B\u4E8B\u52A1\u72B6\u6001",
+      "4. \u6E05\u7406\u65E7\u4E8B\u52A1",
+      "\u8BF7\u9009\u62E9 [1-4]\uFF1A"
     ].join("\n"));
     try {
       if (answer2.trim() === "1") {
@@ -4023,12 +4660,12 @@ async function runRecoveryMenuIfApplicable(options, dependencies) {
           dependencies.cwd,
           pending[0]?.transactionId ?? ""
         );
-        dependencies.stdout("Recovery completed: " + result.status + ".\n");
+        dependencies.stdout("\u6062\u590D\u5B8C\u6210\uFF1A" + result.status + "\u3002\n");
         return 0;
       }
       if (answer2.trim() === "2") {
         const result = await rollbackLatestCommittedUpdate(dependencies.cwd);
-        dependencies.stdout("Rollback completed: " + result.status + ".\n");
+        dependencies.stdout("\u56DE\u6EDA\u5B8C\u6210\uFF1A" + result.status + "\u3002\n");
         return 0;
       }
       if (answer2.trim() === "3") {
@@ -4041,7 +4678,7 @@ async function runRecoveryMenuIfApplicable(options, dependencies) {
       }
       if (answer2.trim() === "4") {
         const removed = await cleanupOldTransactions(dependencies.cwd);
-        dependencies.stdout("Cleaned " + removed.length + " old transactions.\n");
+        dependencies.stdout("\u5DF2\u6E05\u7406 " + removed.length + " \u4E2A\u65E7\u4E8B\u52A1\u3002\n");
         return 0;
       }
       return 2;
@@ -4050,18 +4687,18 @@ async function runRecoveryMenuIfApplicable(options, dependencies) {
       return 5;
     }
   }
-  const initialized = await exists5(join15(dependencies.cwd, ".harness", "project.yaml"));
+  const initialized = await exists4(join15(dependencies.cwd, ".harness", "project.yaml"));
   if (!initialized || options.nonInteractive === true || explicitConfigure(options)) {
     return null;
   }
   const answer = await dependencies.prompt([
-    "Hunter Harness project menu.",
-    "1. Configure project",
-    "2. Roll back last update",
-    "3. Clean old transactions",
-    "4. View transaction status",
-    "5. Exit",
-    "Choose [1-5]: "
+    "Hunter Harness \u9879\u76EE\u83DC\u5355\u3002",
+    "1. \u914D\u7F6E\u9879\u76EE",
+    "2. \u56DE\u6EDA\u6700\u8FD1\u4E00\u6B21\u66F4\u65B0",
+    "3. \u6E05\u7406\u65E7\u4E8B\u52A1",
+    "4. \u67E5\u770B\u4E8B\u52A1\u72B6\u6001",
+    "5. \u9000\u51FA",
+    "\u8BF7\u9009\u62E9 [1-5]\uFF1A"
   ].join("\n"));
   try {
     if (answer.trim() === "1") {
@@ -4069,12 +4706,12 @@ async function runRecoveryMenuIfApplicable(options, dependencies) {
     }
     if (answer.trim() === "2") {
       const result = await rollbackLatestCommittedUpdate(dependencies.cwd);
-      dependencies.stdout("Rollback completed: " + result.status + ".\n");
+      dependencies.stdout("\u56DE\u6EDA\u5B8C\u6210\uFF1A" + result.status + "\u3002\n");
       return 0;
     }
     if (answer.trim() === "3") {
       const removed = await cleanupOldTransactions(dependencies.cwd);
-      dependencies.stdout("Cleaned " + removed.length + " old transactions.\n");
+      dependencies.stdout("\u5DF2\u6E05\u7406 " + removed.length + " \u4E2A\u65E7\u4E8B\u52A1\u3002\n");
       return 0;
     }
     if (answer.trim() === "4") {
@@ -4114,7 +4751,7 @@ function defaultDependencies(overrides) {
   };
 }
 function addCommonOptions(command) {
-  return command.option("--dry-run").option("--yes").option("--json").option("--server-url <url>").option("--token-env <ENV_NAME>").option("--non-interactive");
+  return command.option("--dry-run").option("--yes").option("--json").option("--server-url <url>").option("--token-env <ENV_NAME>").option("--non-interactive").option("--agents <csv>").option("--codebuddy-surface <surface>");
 }
 async function runCli(argv, overrides = {}) {
   const dependencies = defaultDependencies(overrides);
@@ -4131,22 +4768,22 @@ async function runCli(argv, overrides = {}) {
     }
     exitCode = await runConfigure(options, dependencies);
   });
-  addCommonOptions(program.command("refresh")).description("Local Conservative Refresh of an installed Harness project").option("--profile <name>").option("--force-managed").action(async (options) => {
+  addCommonOptions(program.command("refresh")).description("\u672C\u5730\u4FDD\u5B88\u5237\u65B0\u5DF2\u5B89\u88C5\u7684 Harness \u9879\u76EE").option("--profile <name>").option("--force-managed").action(async (options) => {
     exitCode = await runRefresh(
       { ...program.opts(), ...options },
       dependencies
     );
   });
-  addCommonOptions(program.command("update")).description("Apply approved server artifacts").action(async (options) => {
+  addCommonOptions(program.command("update")).description("\u5E94\u7528\u5DF2\u6279\u51C6\u7684\u670D\u52A1\u7AEF\u4EA7\u7269").action(async (options) => {
     exitCode = await runUpdate(
       { ...program.opts(), ...options },
       dependencies
     );
   });
-  addCommonOptions(program.command("push")).description("Create a governed proposal").action(async (options) => {
+  addCommonOptions(program.command("push")).description("\u521B\u5EFA\u53D7\u6CBB\u7406\u7684\u53D8\u66F4\u63D0\u6848").action(async (options) => {
     exitCode = await runPush({ ...program.opts(), ...options }, dependencies);
   });
-  addCommonOptions(program.command("cleanup")).description("Prune completed transactions and obsolete server cache").action(async (options) => {
+  addCommonOptions(program.command("cleanup")).description("\u6E05\u7406\u5DF2\u5B8C\u6210\u4E8B\u52A1\u548C\u8FC7\u671F\u670D\u52A1\u7AEF\u7F13\u5B58").action(async (options) => {
     exitCode = await runCleanup(
       { ...program.opts(), ...options },
       dependencies