hunter-harness 0.1.3 → 0.2.1

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/bin.ts
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { pathToFileURL } from "node:url";
 import { createInterface } from "node:readline/promises";
 import { Command, CommanderError } from "commander";
 
@@ -133,8 +133,14 @@ var baselineManifestSchema = z2.object({
   project_id: z2.string().regex(/^prj_/).nullable(),
   complete_project_version: z2.string().regex(/^pv_/).nullable(),
   artifact_manifest_hash: sha256Schema.nullable(),
+  latest_artifact_id: z2.string().regex(/^art_/).nullable().optional(),
   files: z2.record(z2.string(), baselineFileSchema)
 }).strict();
+var finalizeProposalSchema = z2.object({
+  schema_version: z2.literal(1),
+  manifest_sha256: sha256Schema,
+  base_artifact_id: z2.string().regex(/^art_/).nullable()
+}).strict();
 var requestMetadataSchema = z2.object({
   request_id: z2.uuid(),
   idempotency_key: z2.uuid(),
@@ -286,7 +292,21 @@ var registrySkillSummarySchema = z3.object({
   agents: z3.array(agentSkillConfigSchema),
   revision: z3.number().int().positive(),
   created_at: z3.iso.datetime(),
-  updated_at: z3.iso.datetime()
+  updated_at: z3.iso.datetime(),
+  // npm 发布记录（registry snapshot 可选字段，旧快照缺省为 []）
+  npmReleases: z3.array(z3.lazy(() => npmReleaseRecordSchema)).optional().default([])
+}).strict();
+var npmReleaseStatusSchema = z3.enum(["published", "failed", "conflict"]);
+var npmReleaseRecordSchema = z3.object({
+  version: registrySemverSchema,
+  packageName: z3.string().min(1),
+  status: npmReleaseStatusSchema,
+  publishedAt: z3.iso.datetime(),
+  error: z3.string().nullable().optional().default(null)
+}).strict();
+var npmReleaseResponseSchema = z3.object({
+  slug: registrySlugSchema,
+  release: npmReleaseRecordSchema
 }).strict();
 var registrySkillDetailSchema = registrySkillSummarySchema.extend({
   ir: z3.unknown().optional(),
@@ -313,34 +333,6 @@ var registryTagSchema = z3.object({
   created_at: z3.iso.datetime(),
   updated_at: z3.iso.datetime()
 }).strict();
-var registryWorkflowSchema = z3.object({
-  workflow_id: z3.string().regex(/^wf_/),
-  key: registrySlugSchema,
-  name: z3.string().min(1).max(120),
-  description: z3.string().min(1).max(1e3),
-  profile: registrySlugSchema,
-  default_agent: registryAgentSchema,
-  enabled: z3.boolean(),
-  skill_slugs: z3.array(registrySlugSchema),
-  revision: z3.number().int().positive(),
-  created_at: z3.iso.datetime(),
-  updated_at: z3.iso.datetime()
-}).strict();
-var registryWorkflowMutationSchema = z3.object({
-  key: registrySlugSchema,
-  name: z3.string().min(1).max(120),
-  description: z3.string().min(1).max(1e3),
-  profile: registrySlugSchema,
-  default_agent: registryAgentSchema,
-  enabled: z3.boolean(),
-  skill_slugs: z3.array(registrySlugSchema)
-}).strict();
-var registryProjectWorkflowBindingSchema = z3.object({
-  project_id: z3.string().regex(/^prj_/),
-  workflow_id: z3.string().regex(/^wf_/),
-  revision: z3.number().int().positive(),
-  updated_at: z3.iso.datetime()
-}).strict();
 
 // ../contracts/dist/ai-config.js
 var aiProviderApiFormatSchema = z4.enum(["openai", "anthropic", "custom"]);
@@ -458,7 +450,10 @@ var apiErrorCodeSchema = z5.enum([
   "DRAFT_NOT_FOUND",
   "REVISION_CONFLICT",
   "ADAPTER_NOT_INSTALLABLE",
-  "WORKFLOW_PACKAGE_REDIRECT"
+  "WORKFLOW_PACKAGE_REDIRECT",
+  "NPM_PUBLISH_NOT_CONFIGURED",
+  "NPM_PUBLISH_NOT_PUBLISHED",
+  "NPM_PUBLISH_CONFLICT"
 ]);
 var apiErrorEnvelopeSchema = z5.object({
   error: z5.object({
@@ -480,46 +475,90 @@ var cliExitCodeSchema = z5.union([
   z5.literal(8)
 ]);
 
-// ../contracts/dist/fix.js
+// ../contracts/dist/external-skill.js
 import { z as z6 } from "zod";
-var fixActionSchema = z6.enum(["auto", "confirm", "suggest"]);
-var fixPlanItemSchema = z6.object({
-  checkId: z6.string(),
+var externalSkillSourceTypeSchema = z6.enum(["npm", "github"]);
+var externalSkillSourceSchema = z6.object({
+  type: externalSkillSourceTypeSchema,
+  /** npm 包名，或规范化后的 `owner/repo` */
+  ref: z6.string().min(1)
+}).strict();
+var externalSkillSnapshotSchema = z6.object({
+  name: z6.string(),
+  description: z6.string(),
+  version: z6.string().nullable(),
+  readme: z6.string().nullable(),
+  installCommand: z6.string(),
+  license: z6.string().nullable(),
+  homepage: z6.string().nullable(),
+  releaseUrl: z6.string().nullable(),
+  fetchedAt: z6.string()
+}).strict();
+var externalSkillSchema = z6.object({
+  id: z6.string().regex(/^ext_/),
+  source: externalSkillSourceSchema,
+  snapshot: externalSkillSnapshotSchema,
+  curationNote: z6.string(),
+  tags: z6.array(z6.string()),
+  updateAvailable: z6.boolean(),
+  lastCheckedAt: z6.string(),
+  revision: z6.number().int().positive(),
+  created_at: z6.string(),
+  updated_at: z6.string()
+}).strict();
+var createExternalSkillRequestSchema = z6.object({
+  source: externalSkillSourceSchema,
+  curationNote: z6.string().default(""),
+  tags: z6.array(z6.string()).default([])
+}).strict();
+var patchExternalSkillRequestSchema = z6.object({
+  curationNote: z6.string().optional(),
+  tags: z6.array(z6.string()).optional(),
+  /** 清除「有更新」徽章（不改变 curationNote / snapshot） */
+  acknowledgeUpdate: z6.boolean().optional(),
+  revision: z6.number().int().positive()
+}).strict();
+
+// ../contracts/dist/fix.js
+import { z as z7 } from "zod";
+var fixActionSchema = z7.enum(["auto", "confirm", "suggest"]);
+var fixPlanItemSchema = z7.object({
+  checkId: z7.string(),
   action: fixActionSchema,
-  label: z6.string(),
-  affectedPaths: z6.array(z6.string()),
-  riskDelta: z6.string().nullable(),
-  message: z6.string(),
+  label: z7.string(),
+  affectedPaths: z7.array(z7.string()),
+  riskDelta: z7.string().nullable(),
+  message: z7.string(),
   // AI 内容生成切片：fix-suggestions 端点填充（fixer.buildFixPatch 填的 item 不带，向后兼容）
-  suggestedContent: z6.string().nullable().optional(),
-  explanation: z6.string().nullable().optional(),
-  appliesTo: z6.enum(["examples", "allowed_capabilities", "instructions", "description", "tags"]).nullable().optional(),
-  generatedAt: z6.string().nullable().optional()
+  suggestedContent: z7.string().nullable().optional(),
+  explanation: z7.string().nullable().optional(),
+  appliesTo: z7.enum(["examples", "allowed_capabilities", "instructions", "description", "tags"]).nullable().optional(),
+  generatedAt: z7.string().nullable().optional()
 }).strict();
-var fixPlanSchema = z6.object({
-  items: z6.array(fixPlanItemSchema),
-  mergedFiles: z6.array(skillDiffFileSchema),
-  summary: z6.object({
-    autoCount: z6.number().int(),
-    confirmCount: z6.number().int(),
-    suggestCount: z6.number().int(),
-    changedFiles: z6.number().int(),
-    changedLines: z6.number().int()
+var fixPlanSchema = z7.object({
+  items: z7.array(fixPlanItemSchema),
+  mergedFiles: z7.array(skillDiffFileSchema),
+  summary: z7.object({
+    autoCount: z7.number().int(),
+    confirmCount: z7.number().int(),
+    suggestCount: z7.number().int(),
+    changedFiles: z7.number().int(),
+    changedLines: z7.number().int()
   })
 }).strict();
 
 // ../contracts/dist/knowledge.js
-import { z as z7 } from "zod";
-var knowledgeStatusSchema = z7.enum([
+import { z as z8 } from "zod";
+var knowledgeStatusSchema = z8.enum([
   "candidate",
   "active",
   "stale",
   "deprecated",
   "superseded"
 ]);
-var knowledgeFrontmatterSchema = z7.object({
-  id: z7.string().regex(/^knowledge\.[a-z0-9.-]+$/),
-  type: z7.enum([
+var knowledgeFrontmatterSchema = z8.object({
+  id: z8.string().regex(/^knowledge\.[a-z0-9.-]+$/),
+  type: z8.enum([
     "business",
     "architecture",
     "decision",
@@ -528,7 +567,7 @@ var knowledgeFrontmatterSchema = z7.object({
     "glossary",
     "project-local"
   ]),
-  scope: z7.enum([
+  scope: z8.enum([
     "global",
     "project",
     "module",
@@ -537,207 +576,435 @@ var knowledgeFrontmatterSchema = z7.object({
     "business-domain",
     "local"
   ]),
-  confidence: z7.enum(["verified", "inferred", "unverified", "low"]),
+  confidence: z8.enum(["verified", "inferred", "unverified", "low"]),
   status: knowledgeStatusSchema,
-  domains: z7.array(z7.string()),
-  modules: z7.array(z7.string()),
-  related_paths: z7.array(z7.string()),
-  source: z7.object({
-    kind: z7.enum(["manual", "archive", "review", "imported", "test", "design"]),
-    ref: z7.string().min(1)
+  domains: z8.array(z8.string()),
+  modules: z8.array(z8.string()),
+  related_paths: z8.array(z8.string()),
+  source: z8.object({
+    kind: z8.enum(["manual", "archive", "review", "imported", "test", "design"]),
+    ref: z8.string().min(1)
+  }).strict(),
+  created_at: z8.iso.datetime(),
+  updated_at: z8.iso.datetime(),
+  last_verified_at: z8.iso.datetime().nullable(),
+  expires_at: z8.iso.datetime().nullable(),
+  supersedes: z8.array(z8.string()),
+  superseded_by: z8.array(z8.string())
+}).strict();
+var knowledgeMarkdownIndexSchema = z8.object({
+  schema_version: z8.literal(1),
+  generated_at: z8.iso.datetime(),
+  entries: z8.array(z8.object({
+    id: z8.string(),
+    type: z8.string(),
+    scope: z8.string(),
+    confidence: z8.string(),
+    status: knowledgeStatusSchema,
+    domains: z8.array(z8.string()),
+    modules: z8.array(z8.string()),
+    related_paths: z8.array(z8.string()),
+    source: knowledgeFrontmatterSchema.shape.source,
+    created_at: z8.iso.datetime(),
+    updated_at: z8.iso.datetime(),
+    last_verified_at: z8.iso.datetime().nullable(),
+    expires_at: z8.iso.datetime().nullable(),
+    supersedes: z8.array(z8.string()),
+    superseded_by: z8.array(z8.string()),
+    path: z8.string(),
+    content_sha256: z8.string(),
+    summary: z8.string(),
+    local: z8.boolean()
+  }).strict())
+}).strict();
+var knowledgeIngestTimestampSchema = z8.string().min(1);
+var knowledgeIngestEntryTypeSchema = z8.enum([
+  "requirement",
+  "decision",
+  "implementation",
+  "risk",
+  "test-evidence",
+  "pitfall",
+  "api-contract"
+]);
+var knowledgeIngestEntryStatusSchema = z8.enum([
+  "candidate",
+  "active",
+  "stale",
+  "superseded",
+  "deprecated",
+  "conflicted"
+]);
+var knowledgeConfidenceScoreSchema = z8.object({
+  score: z8.number(),
+  level: z8.string(),
+  signals: z8.array(z8.string()),
+  lastCalculatedAt: knowledgeIngestTimestampSchema
+}).strict();
+var knowledgeIngestEntryLifecycleSchema = z8.object({
+  createdAt: knowledgeIngestTimestampSchema,
+  verifiedAt: knowledgeIngestTimestampSchema,
+  lastCheckedAt: knowledgeIngestTimestampSchema,
+  confidence: z8.string(),
+  supersedes: z8.array(z8.string()),
+  supersededBy: z8.string().nullable(),
+  conflictsWith: z8.array(z8.string()),
+  staleReasons: z8.array(z8.string()),
+  promotedAt: knowledgeIngestTimestampSchema.optional(),
+  promotionNote: z8.string().optional(),
+  demotedAt: knowledgeIngestTimestampSchema.optional(),
+  validation: z8.object({
+    validatedAt: knowledgeIngestTimestampSchema,
+    status: z8.enum(["passed", "failed", "skipped"]),
+    results: z8.array(z8.record(z8.string(), z8.unknown()))
+  }).strict().optional()
+}).strict();
+var knowledgeIngestEntrySourceSchema = z8.object({
+  archive: z8.string(),
+  summaryData: z8.string(),
+  summarySha256: z8.string(),
+  sourceCommit: z8.string(),
+  baseCommit: z8.string(),
+  changeName: z8.string(),
+  finalStatus: z8.string()
+}).strict();
+var knowledgeIngestEntrySchema = z8.object({
+  schemaVersion: z8.literal(1),
+  id: z8.string().min(1),
+  projectId: z8.string().min(1),
+  type: knowledgeIngestEntryTypeSchema,
+  status: knowledgeIngestEntryStatusSchema,
+  title: z8.string(),
+  summary: z8.string(),
+  body: z8.string(),
+  keywords: z8.array(z8.string()),
+  source: knowledgeIngestEntrySourceSchema,
+  scope: z8.object({
+    sourceFiles: z8.array(z8.string()),
+    staleIfPathsChanged: z8.array(z8.string()).optional()
   }).strict(),
-  created_at: z7.iso.datetime(),
-  updated_at: z7.iso.datetime(),
-  last_verified_at: z7.iso.datetime().nullable(),
-  expires_at: z7.iso.datetime().nullable(),
-  supersedes: z7.array(z7.string()),
-  superseded_by: z7.array(z7.string())
+  lifecycle: knowledgeIngestEntryLifecycleSchema,
+  confidence: knowledgeConfidenceScoreSchema.optional(),
+  validators: z8.array(z8.record(z8.string(), z8.unknown())).optional(),
+  reviewReasons: z8.array(z8.string()).optional()
+}).strict();
+var knowledgeIngestIndexEntryRefSchema = z8.object({
+  id: z8.string(),
+  type: knowledgeIngestEntryTypeSchema,
+  status: knowledgeIngestEntryStatusSchema,
+  title: z8.string(),
+  sourceArchive: z8.string(),
+  sourceCommit: z8.string(),
+  sourceFiles: z8.array(z8.string()),
+  confidence: z8.union([knowledgeConfidenceScoreSchema, z8.object({}).strict()])
+}).strict();
+var knowledgeIngestIndexSchema = z8.object({
+  schemaVersion: z8.literal(1),
+  generatedAt: knowledgeIngestTimestampSchema,
+  projectId: z8.string(),
+  projectRoot: z8.string(),
+  headCommit: z8.string().nullable().optional(),
+  archives: z8.object({
+    scanned: z8.number().int().nonnegative(),
+    indexed: z8.number().int().nonnegative(),
+    failed: z8.number().int().nonnegative(),
+    items: z8.array(z8.object({
+      archive: z8.string(),
+      summaryData: z8.string(),
+      summarySha256: z8.string(),
+      mtime: knowledgeIngestTimestampSchema
+    }).strict())
+  }).strict(),
+  stats: z8.record(z8.string(), z8.number().int().nonnegative()),
+  byType: z8.record(z8.string(), z8.number().int().nonnegative()),
+  duplicatesSkipped: z8.number().int().nonnegative(),
+  ingestMode: z8.record(z8.string(), z8.unknown()),
+  failures: z8.array(z8.record(z8.string(), z8.string())),
+  entries: z8.array(knowledgeIngestIndexEntryRefSchema)
 }).strict();
 
 // ../contracts/dist/mcp-contract.js
-import { z as z8 } from "zod";
-var mcpToolContractSchema = z8.object({
-  tool_name: z8.string(),
-  description: z8.string(),
-  input_schema: z8.record(z8.string(), z8.unknown())
+import { z as z9 } from "zod";
+var mcpToolContractSchema = z9.object({
+  tool_name: z9.string(),
+  description: z9.string(),
+  input_schema: z9.record(z9.string(), z9.unknown())
 }).strict();
 
 // ../contracts/dist/project.js
-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 adapterNameSchema = z9.enum([
+import { z as z10 } from "zod";
+var projectIdSchema = z10.string().regex(/^prj_[A-Za-z0-9_-]+$/);
+var tokenEnvSchema = z10.string().regex(/^[A-Z_][A-Z0-9_]*$/);
+var httpsUrlSchema = z10.url().refine((value) => new URL(value).protocol === "https:", "server URL must use HTTPS");
+var HARNESS_AGENT_ORDER = [
   "claude-code",
   "codex",
   "cursor",
+  "codebuddy"
+];
+var harnessAgentSchema = z10.enum(HARNESS_AGENT_ORDER);
+var codebuddySurfaceSchema = z10.enum(["both", "ide", "cli"]);
+function sortHarnessAgents(agents) {
+  return HARNESS_AGENT_ORDER.filter((agent) => agents.includes(agent));
+}
+var adapterNameSchema = z10.enum([
+  "claude-code",
+  "codex",
+  "cursor",
+  "codebuddy",
   "generic",
   "mcp"
 ]);
-var initConfigSchema = z9.object({
-  adapter: adapterNameSchema,
-  profile: z9.enum(["general", "java"]),
+var initConfigSchema = z10.object({
+  agents: z10.array(harnessAgentSchema).min(1),
+  profile: z10.enum(["general", "java"]),
+  codebuddy_surface: codebuddySurfaceSchema.default("both"),
   server_url: httpsUrlSchema.nullable().optional(),
   token_env: tokenEnvSchema.nullable().optional(),
   project_id: projectIdSchema.nullable().optional(),
-  features: z9.object({
-    codegraph_check: z9.boolean().default(true),
-    superpowers_check: z9.boolean().default(true)
+  features: z10.object({
+    codegraph_check: z10.boolean().default(true),
+    superpowers_check: z10.boolean().default(true)
   }).strict().optional()
 }).strict();
-var projectConfigSchema = z9.object({
-  harness: z9.object({
-    name: z9.literal("hunter-harness"),
-    schema_version: z9.literal(1)
+var projectConfigSchema = z10.object({
+  harness: z10.object({
+    name: z10.literal("hunter-harness"),
+    schema_version: z10.literal(1)
   }).strict(),
-  project: z9.object({
-    name: z9.string().min(1),
-    root: z9.literal("."),
-    local_project_key: z9.uuid(),
+  project: z10.object({
+    name: z10.string().min(1),
+    root: z10.literal("."),
+    local_project_key: z10.uuid(),
     project_id: projectIdSchema.nullable(),
-    profiles: z9.array(z9.string().min(1)).min(1)
+    profiles: z10.array(z10.string().min(1)).min(1)
   }).strict(),
-  server: z9.object({
+  server: z10.object({
     url: httpsUrlSchema.nullable(),
     token_env: tokenEnvSchema
   }).strict(),
-  adapters: z9.object({
-    enabled: z9.array(adapterNameSchema).min(1)
-  }).strict()
+  adapters: z10.object({
+    enabled: z10.array(adapterNameSchema).min(1)
+  }).strict(),
+  adapter_options: z10.object({
+    codebuddy: z10.object({
+      surface: codebuddySurfaceSchema
+    }).strict()
+  }).strict().optional()
 }).strict();
 
 // ../contracts/dist/dashboard.js
-import { z as z10 } from "zod";
-var dashboardHealthStatusSchema = z10.enum(["healthy", "attention", "unavailable"]);
-var dashboardServiceStatusSchema = z10.enum(["operational", "degraded", "unavailable"]);
-var dashboardTrendPointSchema = z10.object({
-  date: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/),
-  submitted: z10.number().int().nonnegative(),
-  approved: z10.number().int().nonnegative(),
-  rejected: z10.number().int().nonnegative(),
-  pending: z10.number().int().nonnegative()
+import { z as z11 } from "zod";
+var dashboardHealthStatusSchema = z11.enum(["healthy", "attention", "unavailable"]);
+var dashboardServiceStatusSchema = z11.enum(["operational", "degraded", "unavailable"]);
+var dashboardTrendPointSchema = z11.object({
+  date: z11.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  submitted: z11.number().int().nonnegative(),
+  approved: z11.number().int().nonnegative(),
+  rejected: z11.number().int().nonnegative(),
+  pending: z11.number().int().nonnegative()
 }).strict();
-var dashboardDistributionItemSchema = z10.object({
-  key: z10.string().min(1),
-  count: z10.number().int().nonnegative()
+var dashboardDistributionItemSchema = z11.object({
+  key: z11.string().min(1),
+  count: z11.number().int().nonnegative()
 }).strict();
-var dashboardHealthItemSchema = z10.object({
-  key: z10.string().min(1),
-  label: z10.string().min(1),
+var dashboardHealthItemSchema = z11.object({
+  key: z11.string().min(1),
+  label: z11.string().min(1),
   status: dashboardHealthStatusSchema,
-  value: z10.string().min(1),
-  detail: z10.string().min(1)
+  value: z11.string().min(1),
+  detail: z11.string().min(1)
 }).strict();
-var dashboardServiceItemSchema = z10.object({
-  key: z10.string().min(1),
-  label: z10.string().min(1),
+var dashboardServiceItemSchema = z11.object({
+  key: z11.string().min(1),
+  label: z11.string().min(1),
   status: dashboardServiceStatusSchema,
-  detail: z10.string().min(1),
-  checked_at: z10.iso.datetime()
+  detail: z11.string().min(1),
+  checked_at: z11.iso.datetime()
 }).strict();
-var dashboardActivitySchema = z10.object({
-  event_id: z10.string().min(1),
-  action: z10.string().min(1),
-  target_id: z10.string().min(1),
-  project_id: z10.string().nullable(),
-  actor_id: z10.string().min(1),
-  created_at: z10.iso.datetime()
+var dashboardActivitySchema = z11.object({
+  event_id: z11.string().min(1),
+  action: z11.string().min(1),
+  target_id: z11.string().min(1),
+  project_id: z11.string().nullable(),
+  actor_id: z11.string().min(1),
+  created_at: z11.iso.datetime()
 }).strict();
-var dashboardOverviewSchema = z10.object({
-  generated_at: z10.iso.datetime(),
-  window: z10.object({
-    days: z10.number().int().min(7).max(30),
-    starts_at: z10.iso.datetime(),
-    ends_at: z10.iso.datetime()
+var dashboardOverviewSchema = z11.object({
+  generated_at: z11.iso.datetime(),
+  window: z11.object({
+    days: z11.number().int().min(7).max(30),
+    starts_at: z11.iso.datetime(),
+    ends_at: z11.iso.datetime()
   }).strict(),
-  metrics: z10.object({
-    projects: z10.number().int().nonnegative(),
-    workflows: z10.number().int().nonnegative(),
-    skills: z10.number().int().nonnegative(),
-    published_skills: z10.number().int().nonnegative(),
-    pending_reviews: z10.number().int().nonnegative(),
-    approved_proposals: z10.number().int().nonnegative(),
-    rejected_proposals: z10.number().int().nonnegative(),
-    artifacts: z10.number().int().nonnegative(),
-    project_artifacts: z10.number().int().nonnegative(),
-    skill_artifacts: z10.number().int().nonnegative()
+  metrics: z11.object({
+    projects: z11.number().int().nonnegative(),
+    workflows: z11.number().int().nonnegative(),
+    skills: z11.number().int().nonnegative(),
+    published_skills: z11.number().int().nonnegative(),
+    pending_reviews: z11.number().int().nonnegative(),
+    approved_proposals: z11.number().int().nonnegative(),
+    rejected_proposals: z11.number().int().nonnegative(),
+    artifacts: z11.number().int().nonnegative(),
+    project_artifacts: z11.number().int().nonnegative(),
+    skill_artifacts: z11.number().int().nonnegative()
   }).strict(),
-  trend: z10.array(dashboardTrendPointSchema),
-  distributions: z10.object({
-    skill_categories: z10.array(dashboardDistributionItemSchema),
-    workflow_profiles: z10.array(dashboardDistributionItemSchema)
+  trend: z11.array(dashboardTrendPointSchema),
+  distributions: z11.object({
+    skill_categories: z11.array(dashboardDistributionItemSchema),
+    workflow_profiles: z11.array(dashboardDistributionItemSchema)
   }).strict(),
-  health: z10.array(dashboardHealthItemSchema),
-  services: z10.array(dashboardServiceItemSchema),
-  activity: z10.array(dashboardActivitySchema)
+  health: z11.array(dashboardHealthItemSchema),
+  services: z11.array(dashboardServiceItemSchema),
+  activity: z11.array(dashboardActivitySchema)
 }).strict();
 
-// ../contracts/dist/workflow-package.js
-import { z as z11 } from "zod";
-var workflowPackageManifestSchema = z11.object({
-  key: registrySlugSchema,
-  name: z11.string().min(1).max(120),
-  description: z11.string().min(1).max(1e3),
+// ../contracts/dist/semantic.js
+import { z as z12 } from "zod";
+var semanticDocumentKindSchema = z12.enum([
+  "knowledge_entry",
+  "knowledge_markdown",
+  "rule",
+  "archive_record",
+  "agent_instruction"
+]);
+var semanticEdgeKindSchema = z12.enum([
+  "references_path",
+  "supersedes",
+  "related_archive",
+  "tag_cooccurrence"
+]);
+var semanticDocumentSchema = z12.object({
+  document_id: z12.string(),
+  project_id: z12.string(),
+  artifact_id: z12.string(),
+  kind: semanticDocumentKindSchema,
+  source_path: z12.string(),
+  title: z12.string(),
+  body: z12.string(),
+  metadata: z12.record(z12.string(), z12.unknown()),
+  content_sha256: z12.string()
+}).strict();
+var semanticEdgeSchema = z12.object({
+  edge_id: z12.string(),
+  project_id: z12.string(),
+  artifact_id: z12.string(),
+  from_document_id: z12.string(),
+  to_document_id: z12.string(),
+  kind: semanticEdgeKindSchema,
+  metadata: z12.record(z12.string(), z12.unknown())
+}).strict();
+var semanticIndexBuildSchema = z12.object({
+  project_id: z12.string(),
+  artifact_id: z12.string(),
+  documents: z12.array(semanticDocumentSchema),
+  edges: z12.array(semanticEdgeSchema)
+}).strict();
+var semanticOverviewSchema = z12.object({
+  project_id: z12.string(),
+  artifact_id: z12.string().nullable(),
+  counts: z12.object({
+    documents: z12.number().int().nonnegative(),
+    knowledge: z12.number().int().nonnegative(),
+    rules: z12.number().int().nonnegative(),
+    changes: z12.number().int().nonnegative(),
+    agent_instructions: z12.number().int().nonnegative(),
+    edges: z12.number().int().nonnegative()
+  }).strict()
+}).strict();
+var semanticSearchHitSchema = z12.object({
+  document: semanticDocumentSchema,
+  project_id: z12.string()
+}).strict();
+
+// ../contracts/dist/workflow-family.js
+import { z as z13 } from "zod";
+var workflowBundleManifestSchema = z13.object({
+  schema_version: z13.literal(1),
   profile: registrySlugSchema,
-  skills: z11.array(z11.object({
-    slug: registrySlugSchema,
-    ref: z11.string()
-  }).strict()),
-  agents: z11.array(z11.object({
-    path: z11.string(),
-    ref: z11.string()
-  }).strict()),
-  protocols: z11.array(z11.object({
-    path: z11.string(),
-    ref: z11.string()
-  }).strict()),
-  templates: z11.array(z11.object({
-    path: z11.string(),
-    ref: z11.string()
-  }).strict()),
-  execution_order: z11.array(z11.string()),
-  strategy: z11.enum(["sequential", "parallel", "manual"])
+  files: z13.array(z13.object({
+    path: z13.string().min(1),
+    sha256: sha256Schema
+  }).strict()).min(1)
 }).strict();
-var workflowPackageArtifactSchema = z11.object({
-  artifact_id: z11.string().regex(/^wfa_/),
-  package_key: registrySlugSchema,
+var workflowFamilyBundleArtifactSchema = z13.object({
+  artifact_id: z13.string().regex(/^wfb_/),
+  family_slug: registrySlugSchema,
+  profile: registrySlugSchema,
   version: registrySemverSchema,
   content_sha256: sha256Schema,
-  size_bytes: z11.number().int().nonnegative(),
-  created_at: z11.iso.datetime()
+  size_bytes: z13.number().int().nonnegative(),
+  bundle_manifest: workflowBundleManifestSchema,
+  created_at: z13.iso.datetime()
+}).strict();
+var workflowFamilyVersionProfileSchema = z13.object({
+  profile: registrySlugSchema,
+  bundle_manifest: workflowBundleManifestSchema,
+  artifact_id: z13.string().regex(/^wfb_/),
+  sourceFiles: z13.array(sourceFileSchema).default([])
 }).strict();
-var workflowPackageVersionSchema = z11.object({
-  package_key: registrySlugSchema,
+var workflowFamilyVersionSchema = z13.object({
+  family_slug: registrySlugSchema,
   version: registrySemverSchema,
-  manifest: workflowPackageManifestSchema,
-  artifacts: z11.array(workflowPackageArtifactSchema),
-  sourceFiles: z11.array(sourceFileSchema).default([]),
-  changeNote: z11.string().nullable(),
-  created_at: z11.iso.datetime()
+  profiles: z13.array(workflowFamilyVersionProfileSchema).min(1),
+  artifacts: z13.array(workflowFamilyBundleArtifactSchema),
+  changeNote: z13.string().nullable(),
+  created_at: z13.iso.datetime()
+}).strict();
+var workflowFamilyDraftProfileSchema = z13.object({
+  profile: registrySlugSchema,
+  sourceFiles: z13.array(sourceFileSchema),
+  bundle_manifest: workflowBundleManifestSchema
 }).strict();
-var workflowPackageDraftStateSchema = z11.object({
-  key: registrySlugSchema,
-  manifest: workflowPackageManifestSchema,
-  sourceFiles: z11.array(sourceFileSchema),
+var workflowFamilyDraftStateSchema = z13.object({
+  family_slug: registrySlugSchema,
+  profiles: z13.array(workflowFamilyDraftProfileSchema),
+  required_profiles: z13.array(registrySlugSchema),
   draftVersion: registrySemverSchema.nullable(),
   checks: skillCheckResultSchema.nullable(),
-  releaseNote: z11.string().nullable(),
-  revision: z11.number().int(),
-  created_at: z11.string(),
-  updated_at: z11.string()
+  releaseNote: z13.string().nullable(),
+  revision: z13.number().int(),
+  created_at: z13.string(),
+  updated_at: z13.string()
 }).strict();
-var workflowPackageSchema = z11.object({
-  package_id: z11.string().regex(/^wfp_/),
-  key: registrySlugSchema,
-  manifest: workflowPackageManifestSchema,
-  latestVersion: registrySemverSchema.nullable(),
-  revision: z11.number().int().positive(),
-  created_at: z11.iso.datetime(),
-  updated_at: z11.iso.datetime()
+var workflowFamilySchema = z13.object({
+  family_id: z13.string().regex(/^wff_/),
+  slug: registrySlugSchema,
+  displayName: z13.string().min(1).max(120),
+  description: z13.string().min(1).max(1e3),
+  tags: z13.array(registrySlugSchema).default([]),
+  latest_version: registrySemverSchema.nullable(),
+  required_profiles: z13.array(registrySlugSchema).min(1),
+  revision: z13.number().int().positive(),
+  npmReleases: z13.array(npmReleaseRecordSchema).optional().default([]),
+  created_at: z13.iso.datetime(),
+  updated_at: z13.iso.datetime()
 }).strict();
-var publishWorkflowPackageRequestSchema = z11.object({
+var workflowFamilyMutationSchema = z13.object({
+  slug: registrySlugSchema,
+  displayName: z13.string().min(1).max(120),
+  description: z13.string().min(1).max(1e3),
+  tags: z13.array(registrySlugSchema).default([]),
+  required_profiles: z13.array(registrySlugSchema).min(1)
+}).strict();
+var publishWorkflowFamilyRequestSchema = z13.object({
   version: registrySemverSchema,
-  releaseNote: z11.string().optional()
+  releaseNote: z13.string().optional()
+}).strict();
+var registryProjectWorkflowBindingSchema = z13.object({
+  project_id: z13.string().regex(/^prj_/),
+  family_slug: registrySlugSchema,
+  profile: registrySlugSchema,
+  version: registrySemverSchema.nullable().optional(),
+  revision: z13.number().int().positive(),
+  updated_at: z13.iso.datetime()
+}).strict();
+var bindProjectWorkflowFamilyRequestSchema = z13.object({
+  schema_version: z13.literal(1),
+  family_slug: registrySlugSchema,
+  profile: registrySlugSchema,
+  version: registrySemverSchema.nullable().optional(),
+  revision: z13.number().int().nullable()
 }).strict();
 
 // ../core/dist/fs/hash.js
@@ -1063,12 +1330,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 +1361,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 +1396,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 = {
@@ -1136,13 +1474,6 @@ var USER_DIFF = {
   update_policy: "skip-if-local-dirty",
   conflict_policy: "skip-and-report"
 };
-var USER_FULL = {
-  file_kind: "user_editable",
-  edit_policy: "allow",
-  push_policy: "full-diff-proposal",
-  update_policy: "skip-if-local-dirty",
-  conflict_policy: "skip-and-report"
-};
 var PROJECT_LOCAL = {
   file_kind: "user_editable",
   edit_policy: "allow",
@@ -1197,10 +1528,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/")) {
@@ -1209,8 +1540,14 @@ function classifyFile(input) {
   if (under(path, ".harness/knowledge/project-local/")) {
     return PROJECT_LOCAL;
   }
+  if (path === ".harness/knowledge/index.sqlite" || under(path, ".harness/knowledge/cache/") || under(path, ".harness/knowledge/views/") || under(path, ".harness/knowledge/context-packs/")) {
+    return GENERATED_CACHE;
+  }
+  if (under(path, ".harness/knowledge/reports/")) {
+    return REPORT_CACHE;
+  }
   if (under(path, ".harness/knowledge/")) {
-    return USER_FULL;
+    return USER_DIFF;
   }
   if (under(path, ".harness/codebase/map/") || path === ".harness/codebase/map-summary.md" || path === ".harness/codebase/map-manifest.json") {
     return GENERATED_REVIEWABLE;
@@ -1255,6 +1592,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 +1846,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 +1871,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 +1940,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 +2137,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 +2166,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 +2217,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 +2278,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,17 +2361,26 @@ 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,
     project_id: projectConfig.project.project_id,
     complete_project_version: null,
     artifact_manifest_hash: null,
+    latest_artifact_id: 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 +2393,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 +2461,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 +2496,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 +2517,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 +2533,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 +2577,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 +2727,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 +2749,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 +2762,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 +2777,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 +2789,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,
@@ -2350,11 +3058,11 @@ function rawFindings(content) {
   for (const rule of RULES) {
     for (const match of content.matchAll(rule.pattern)) {
       const value = match[rule.valueGroup ?? 0] ?? match[0];
-      const relative2 = match[0].indexOf(value);
+      const relative3 = match[0].indexOf(value);
       findings.push({
         ruleId: rule.id,
         severity: rule.severity,
-        offset: match.index + Math.max(0, relative2),
+        offset: match.index + Math.max(0, relative3),
         value
       });
     }
@@ -2519,18 +3227,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 +3248,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 +3263,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 +3426,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 +3467,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 +3485,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");
       }
@@ -2815,23 +3548,31 @@ async function pushProject(options) {
         });
       }
     }
-    const finalized = await client.finalizeProposal(session.session_id, { schema_version: 1, manifest_sha256: proposalManifestHash }, requestId, workflow.finalize_idempotency_key);
+    const finalized = await client.finalizeProposal(session.session_id, {
+      schema_version: 1,
+      manifest_sha256: proposalManifestHash,
+      base_artifact_id: baseline.latest_artifact_id ?? null
+    }, requestId, workflow.finalize_idempotency_key);
     await atomicWriteJson(join9(root, ".harness", "state", "local", "push-results", finalized.proposal_id + ".json"), {
       schema_version: 1,
       request_id: requestId,
       project_id: projectId,
       proposal_id: finalized.proposal_id,
       status: finalized.status,
+      artifact_id: finalized.artifact_id,
       operation_count: preview.operations.length,
       recorded_at: (/* @__PURE__ */ new Date()).toISOString()
     });
     await rm4(workflowPath, { force: true });
-    return { preview, proposalId: finalized.proposal_id, projectId };
+    return { preview, proposalId: finalized.proposal_id, projectId, artifactId: finalized.artifact_id };
   } catch (error) {
     if (error instanceof PushWorkflowError) {
       throw error;
     }
     if (error instanceof ApiError) {
+      if (error.code === "STALE_PUSH") {
+        throw new PushWorkflowError("\u670D\u52A1\u7AEF\u5DF2\u6709\u66F4\u65B0\u7684\u63A8\u9001\uFF0C\u8BF7\u5148 git pull \u540E\u6267\u884C npx hunter-harness update \u518D\u63A8", 5, "STALE_PUSH");
+      }
       const exitCode = error.status === 401 ? 8 : error.status === 409 ? 5 : 4;
       throw new PushWorkflowError(error.message, exitCode, error.code);
     }
@@ -2906,7 +3647,7 @@ async function cleanupProject(options) {
 
 // ../core/dist/skill/frontmatter.js
 import { parse as parseYaml5 } from "yaml";
-import { z as z12 } from "zod";
+import { z as z14 } from "zod";
 
 // ../core/dist/skill/fixer.js
 import { parse as parseYaml6, stringify as stringifyYaml4 } from "yaml";
@@ -2948,7 +3689,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 +3736,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 +3755,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 +3768,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 +4049,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;
         }
@@ -3351,6 +4093,7 @@ async function updateProject(options) {
       if (skipped.length === 0) {
         nextBaseline.complete_project_version = manifest.project_version;
         nextBaseline.artifact_manifest_hash = manifest.manifest_sha256;
+        nextBaseline.latest_artifact_id = manifest.artifact_id;
       }
       const transactionId = "tx_update_" + Date.now() + "_" + uuidV7();
       const reportPath = ".harness/reports/update-" + requestId + ".json";
@@ -3416,19 +4159,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("\u914D\u7F6E\u7C7B\u578B\u5FC5\u987B\u4E3A general \u6216 java");
 }
-async function resolveInitConfig(cwd, flags, promptMissing) {
+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);
+}
+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 +4244,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 +4308,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;
@@ -3503,6 +4348,16 @@ function parseProfile(value, current) {
   if (value === "2" || value === "java") return "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 = [
     ...result.applied.map((item2) => ({ ...item2, status: result.dry_run ? "planned" : "applied" })),
@@ -3570,20 +4425,25 @@ async function runRefresh(options, dependencies) {
   }
   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
       });
@@ -3618,6 +4478,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
     });
@@ -3635,8 +4497,11 @@ async function runRefresh(options, dependencies) {
     }
     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,
@@ -3644,15 +4509,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;
   }
 }
 
@@ -3663,13 +4528,23 @@ 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("\u975E\u4EA4\u4E92\u6A21\u5F0F\u6267\u884C\u5199\u5165\u64CD\u4F5C\u9700\u8981 --yes\n");
       return 2;
@@ -3696,9 +4571,11 @@ async function runFirstInstall(options, dependencies) {
     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,
@@ -3711,7 +4588,7 @@ async function runFirstInstall(options, dependencies) {
         summary: { planned: 0, applied: 0 },
         items: [],
         warnings: [],
-        errors: [{ message }]
+        errors: [{ ...code === void 0 ? {} : { code }, message }]
       }));
     }
     return exitCode;
@@ -3719,6 +4596,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;
@@ -3886,7 +4764,7 @@ async function runPush(options, dependencies) {
       warnings: result.preview.skipped,
       errors: []
     };
-    dependencies.stdout(options.json === true ? serializeCliResult(output) : options.dryRun === true ? "Push preview contains " + items.length + " operations.\n" : "Proposal " + result.proposalId + " created.\n");
+    dependencies.stdout(options.json === true ? serializeCliResult(output) : options.dryRun === true ? "Push preview contains " + items.length + " operations.\n" : "Pushed artifact " + result.artifactId + " (proposal " + result.proposalId + ").\n");
     return 0;
   } catch (error) {
     const exitCode = error instanceof PushWorkflowError ? error.exitCode : 1;
@@ -4006,18 +4884,18 @@ 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);
@@ -4067,7 +4945,7 @@ 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;
   }
@@ -4109,13 +4987,167 @@ async function runRecoveryMenuIfApplicable(options, dependencies) {
   }
 }
 
+// src/workflow-data/resolve.ts
+import { cp, mkdir as mkdir4, readdir as readdir7, readFile as readFile14, stat as stat5 } from "node:fs/promises";
+import { dirname as dirname4, join as join16, relative as relative2 } from "node:path";
+import { fileURLToPath } from "node:url";
+var WorkflowDataResolutionError = class extends Error {
+  code;
+  exitCode;
+  constructor(message, code = "WORKFLOW_DATA_UNAVAILABLE", exitCode = 4) {
+    super(message);
+    this.name = "WorkflowDataResolutionError";
+    this.code = code;
+    this.exitCode = exitCode;
+  }
+};
+async function pathExists3(path) {
+  try {
+    await stat5(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readOption(argv, name) {
+  const flag = `--${name}`;
+  const index = argv.indexOf(flag);
+  if (index >= 0) return argv[index + 1];
+  const prefixed = argv.find((value) => value.startsWith(`${flag}=`));
+  if (prefixed !== void 0) return prefixed.slice(flag.length + 1);
+  return void 0;
+}
+function workflowPackageName(family, env) {
+  const scope = (env.HUNTER_HARNESS_NPM_SCOPE ?? "@hunter-harness").replace(/\/$/, "");
+  if (family === "harness") return `${scope}/workflow-harness`;
+  return `${scope}/workflow-${family}`;
+}
+async function listFilesRecursive(root, base = root) {
+  const entries = await readdir7(root, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const absolute = join16(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await listFilesRecursive(absolute, base));
+      continue;
+    }
+    if (!entry.isFile()) continue;
+    const rel = relative2(base, absolute).replaceAll("\\", "/");
+    files.push({ path: rel, content: await readFile14(absolute, "utf8") });
+  }
+  return files;
+}
+function sha256Canonical(files) {
+  return sha256Bytes(canonicalJson(
+    [...files].sort((left, right) => left.path.localeCompare(right.path)).map((file) => ({ path: file.path, content: file.content }))
+  ));
+}
+async function verifyWorkflowPackageIntegrity(resourcesRoot) {
+  const manifest = await readWorkflowFamilyManifest(resourcesRoot);
+  const expected = manifest.content_sha256;
+  if (typeof expected !== "string" || expected.length === 0) return;
+  const harnessRoot = join16(resourcesRoot, "harness");
+  if (!await pathExists3(harnessRoot)) {
+    throw new WorkflowDataResolutionError(
+      "\u5DE5\u4F5C\u6D41\u6570\u636E\u5305\u7F3A\u5C11 harness/\uFF0C\u65E0\u6CD5\u6821\u9A8C SHA-256",
+      "WORKFLOW_DATA_INTEGRITY",
+      7
+    );
+  }
+  const files = await listFilesRecursive(harnessRoot, resourcesRoot);
+  const actual = sha256Canonical(files);
+  if (actual !== expected) {
+    throw new WorkflowDataResolutionError(
+      `\u5DE5\u4F5C\u6D41\u6570\u636E\u5305 SHA-256 \u6821\u9A8C\u5931\u8D25\uFF08\u671F\u671B ${expected}\uFF0C\u5B9E\u9645 ${actual}\uFF09`,
+      "WORKFLOW_DATA_INTEGRITY",
+      7
+    );
+  }
+}
+async function monorepoResourcesRoot() {
+  const candidates = [
+    fileURLToPath(new URL("../../../resources", import.meta.url)),
+    fileURLToPath(new URL("../../../workflow-data-harness", import.meta.url)),
+    fileURLToPath(new URL("../../../../resources", import.meta.url))
+  ];
+  for (const candidate of candidates) {
+    if (await pathExists3(join16(candidate, "harness", "manifests"))) return candidate;
+  }
+  return null;
+}
+async function siblingWorkflowPackage(cwd) {
+  const candidates = [
+    join16(cwd, "node_modules", "@hunter-harness", "workflow-harness"),
+    join16(dirname4(fileURLToPath(import.meta.url)), "..", "..", "workflow-data-harness")
+  ];
+  for (const candidate of candidates) {
+    if (await pathExists3(join16(candidate, "harness", "manifests"))) return candidate;
+  }
+  return null;
+}
+async function resolveWorkflowResourcesRoot(options, argv = []) {
+  if (options.override !== void 0) return options.override;
+  const envRoot = options.env.HUNTER_HARNESS_RESOURCES_ROOT?.trim();
+  if (envRoot !== void 0 && envRoot.length > 0) return envRoot;
+  const sibling = await siblingWorkflowPackage(options.cwd);
+  if (sibling !== null) {
+    await verifyWorkflowPackageIntegrity(sibling);
+    return sibling;
+  }
+  const monorepo = await monorepoResourcesRoot();
+  if (monorepo !== null) {
+    await verifyWorkflowPackageIntegrity(monorepo);
+    return monorepo;
+  }
+  const family = options.workflowFamily ?? readOption(argv, "workflow-family") ?? options.env.HUNTER_HARNESS_WORKFLOW_FAMILY ?? "harness";
+  const version = options.workflowVersion ?? readOption(argv, "workflow-version") ?? options.env.HUNTER_HARNESS_WORKFLOW_VERSION ?? "latest";
+  const packageName = workflowPackageName(family, options.env);
+  const packageSpec = version === "latest" ? packageName : `${packageName}@${version}`;
+  const cacheKey = packageSpec.replace("/", "+");
+  const cacheRoot = join16(options.cwd, ".harness", "cache", "workflow-packages", cacheKey);
+  if (await pathExists3(join16(cacheRoot, "harness", "manifests"))) {
+    await verifyWorkflowPackageIntegrity(cacheRoot);
+    return cacheRoot;
+  }
+  try {
+    await mkdir4(cacheRoot, { recursive: true });
+    const extract = options.pacoteExtract ?? (async (spec, destination) => {
+      const pacote = await import("pacote");
+      await pacote.default.extract(spec, destination);
+    });
+    const staging = join16(cacheRoot, ".extract");
+    await mkdir4(staging, { recursive: true });
+    await extract(packageSpec, staging);
+    const packageDir = await pathExists3(join16(staging, "harness", "manifests")) ? staging : join16(staging, "package");
+    if (!await pathExists3(join16(packageDir, "harness", "manifests"))) {
+      throw new WorkflowDataResolutionError(
+        "\u5DE5\u4F5C\u6D41\u6570\u636E\u5305\u5185\u5BB9\u65E0\u6548\uFF1A\u7F3A\u5C11 harness/manifests",
+        "WORKFLOW_DATA_INVALID",
+        7
+      );
+    }
+    await cp(packageDir, cacheRoot, { recursive: true });
+    await verifyWorkflowPackageIntegrity(cacheRoot);
+    return cacheRoot;
+  } catch (error) {
+    if (error instanceof WorkflowDataResolutionError) throw error;
+    throw new WorkflowDataResolutionError(
+      "\u65E0\u6CD5\u83B7\u53D6\u5DE5\u4F5C\u6D41\u6570\u636E\u5305\uFF1A\u65E0\u7F51\u7EDC\u4E14\u672C\u5730\u7F13\u5B58\u4E0D\u5B58\u5728\u3002\u8BF7\u5148\u5728\u6709\u7F51\u7EDC\u7684\u73AF\u5883\u8FD0\u884C hunter-harness\uFF0C\u6216\u8BBE\u7F6E HUNTER_HARNESS_RESOURCES_ROOT \u6307\u5411\u542B harness/ \u7684\u76EE\u5F55\u3002",
+      "WORKFLOW_DATA_UNAVAILABLE"
+    );
+  }
+}
+async function readWorkflowFamilyManifest(resourcesRoot) {
+  const manifestPath = join16(resourcesRoot, "hunter-workflow-family.json");
+  if (!await pathExists3(manifestPath)) return {};
+  return JSON.parse(await readFile14(manifestPath, "utf8"));
+}
+
 // src/bin.ts
 function defaultDependencies(overrides) {
   return {
     cwd: overrides.cwd ?? process.cwd(),
-    resourcesRoot: overrides.resourcesRoot ?? fileURLToPath(
-      new URL("../resources", import.meta.url)
-    ),
+    resourcesRoot: overrides.resourcesRoot ?? "",
     stdout: overrides.stdout ?? ((value) => process.stdout.write(value)),
     stderr: overrides.stderr ?? ((value) => process.stderr.write(value)),
     prompt: overrides.prompt ?? (async (question) => {
@@ -4131,10 +5163,27 @@ 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>").option("--workflow-family <slug>").option("--workflow-version <version>");
 }
 async function runCli(argv, overrides = {}) {
   const dependencies = defaultDependencies(overrides);
+  try {
+    const resolveOptions = {
+      cwd: dependencies.cwd,
+      env: dependencies.env,
+      override: overrides.resourcesRoot
+    };
+    if (overrides.pacoteExtract !== void 0) {
+      resolveOptions.pacoteExtract = overrides.pacoteExtract;
+    }
+    dependencies.resourcesRoot = await resolveWorkflowResourcesRoot(resolveOptions, argv);
+  } catch (error) {
+    if (error instanceof WorkflowDataResolutionError) {
+      dependencies.stderr(error.message + "\n");
+      return error.exitCode;
+    }
+    throw error;
+  }
   const program = addCommonOptions(new Command()).name("hunter-harness").description("Local-first, server-governed agent harness").option("--profile <name>").option("--config <file>").option("--force-managed").showHelpAfterError().exitOverride().configureOutput({
     writeOut: dependencies.stdout,
     writeErr: dependencies.stderr