@xiechimon/cairn-cli 0.2.0 → 0.2.1

package/dist/cli.mjs

@@ -51650,20 +51650,13 @@ function isImageAttachmentExt(ext) {
 var BRAND = {
   cliCommandName: "cairn",
   envPrefix: "CAIRN_",
-  /** 用户主目录名（挂 $HOME 下）。 */
   homeDirName: ".cairn",
-  /** 工作区目录 = <home>/workspaces/<conversationId>（02 §5.8 同槽改名）。 */
   workspacesDirName: "workspaces",
   branchPrefix: "cairn/conv-",
   apiKeyPrefix: "cairn_",
-  /** 非品牌槽保持项：远程 MCP 路径（02 §5.8）。 */
   remoteMcpPath: "/api/mcp",
-  /** 自有包名（02 §5.8 复刻处置「自发包名」；06 册 W2-D1 npm 公发 → @xiechimon/cairn-cli）。 */
   cliPackageName: "@xiechimon/cairn-cli",
-  /** manifest/界面品牌词（素材替换计划 D2：产品名 Cairn；D3 已触发，
-   * 界面词槽 Todos→Cairn 同批切换，#109）。 */
   manifestName: "Cairn",
-  /** 会话 cookie 名（01 §4.2 自设 [设计]；品牌前缀同槽延伸，#109 补登记）。 */
   sessionCookieName: "cairn_session"
 };
 var ENV_VARS = {
@@ -51672,41 +51665,16 @@ var ENV_VARS = {
   team: "CAIRN_TEAM",
   workspacesDir: "CAIRN_WORKSPACES_DIR",
   home: "CAIRN_HOME",
-  /** server SPA 静态同源托管根覆写（02/A1，M5；缺省 = monorepo 布局
-   * apps/web/dist 存在即托管，apps/server config.ts）。 */
   webDir: "CAIRN_WEB_DIR",
-  /** OAuth 握手面 client 凭证对（#231：self-host 无中心 App，用户自注
-   * GitHub OAuth App 后以 env 注入；缺 = authorize 400 未配置）。 */
   githubOauthClientId: "CAIRN_GITHUB_OAUTH_CLIENT_ID",
   githubOauthClientSecret: "CAIRN_GITHUB_OAUTH_CLIENT_SECRET",
-  /** server 可选 token 鉴权（#251，06 册 D8）：设 = 开（Bearer 头主干道；
-   * 两条 SSE stream 端点另收 ?token=——EventSource 无法设 header）；
-   * 未设/空串 = 关（默认，行为与现状一致）。 */
   token: "CAIRN_TOKEN",
-  /** 技能根目录覆写（spec 13 #367：skills = 本地目录现扫只读投影；
-   * 缺省 = SKILLS_DIR_DEFAULT `~/.agents/skills`，records/skill.ts 单源）。
-   * spec 14/#371：daemon 侧同键读扫描根（缺省同上；指向不存在目录 =
-   * 空 skills 集，非致命）。 */
+  requireToken: "CAIRN_REQUIRE_TOKEN",
   skillsDir: "CAIRN_SKILLS_DIR",
-  /** 本地 MCP config 文件（spec 13/#368）：server 投影 UI 面、daemon 解析
-   * 执行端点，各读各机；默认 ~/.claude.json 的 mcpServers 段。 */
   mcpConfig: "CAIRN_MCP_CONFIG",
-  /** 自定义端点是否声明推理能力（=1 时开）：开了 pi 才下发 reasoning_effort，
-   * 思考深度才受 thinkingLevel 控制。opt-in——不同后端对该字段容忍度不同
-   * （实测某 relay 只认 low/high/max，传 medium 直接 400），默认打开会让一部分
-   * 自定义端点整条挂掉。 */
   customModelReasoning: "CAIRN_CUSTOM_MODEL_REASONING",
-  /** pi 提示缓存保留档（#927，spec 26）：`long` = 长保留档（anthropic
-   * cache_control ttl 1h / openai prompt_cache_retention 24h，由 pi 适配器
-   * 落请求面）；未设/其它值 = `short`（pi 缺省档，请求面与既往零漂移）。
-   * long 会向网关发送新字段——部分通道拒未知字段（#654 同族），故 opt-in。 */
   piCacheRetention: "CAIRN_PI_CACHE_RETENTION",
-  /** #1149 环境钩子超时毫秒覆写（缺省 20min，WORKSPACE_HOOK_TIMEOUT_MS）。
-   * 非 20min 缺省即 opt-in：数值非法（非正整数）= 忽略 env，用缺省。 */
   hookTimeoutMs: "CAIRN_HOOK_TIMEOUT_MS",
-  /** #1406 server 的 GitHub issue 进料轮询开关（opt-in，默认关）：1 / true /
-   * yes 才开——开了每 5 分钟把已连接 GitHub 的项目里带 ready-for-agent 的
-   * open issue（D5 核打标人）导入并派发，存量按最旧先；升级不自动开工。 */
   issueIntake: "CAIRN_ISSUE_INTAKE"
 };
 var MACHINE_TOKEN_PATTERN = /^[0-9a-f]{64}$/;
@@ -51717,51 +51685,31 @@ function conversationBranch(conversationId) {
 
 // ../../packages/shared/src/records/machine-capabilities.ts
 var machineHardwareSchema = external_exports.object({
-  /** os.cpus().length。 */
   cpuCores: external_exports.number().int().positive(),
-  /** os.totalmem()，MiB。可选：升级前落库的指纹没有此字段，读侧不得因此整行
-   *  解析失败；推荐公式对缺席者回落估算。 */
   memoryTotalMb: external_exports.number().int().nonnegative().optional(),
-  /** os.freemem()，MiB。 */
   memoryAvailableMb: external_exports.number().int().nonnegative(),
-  /** os.loadavg()[0]，1 分钟负载。 */
   loadAvg1: external_exports.number().nonnegative(),
-  /** 技能根所在卷的可用空间，MiB（statfs；根不可读则回落 `/`）。 */
   diskFreeMb: external_exports.number().int().nonnegative()
 });
 var machineCapabilitiesSchema = external_exports.object({
-  /** 已装 MCP server slug 集（小写归一，parseClaudeMcpEntries 单源；与
-   *  agent.mcpServers 勾选值 / claim 载荷 slug 同值域）。 */
   mcpServers: external_exports.array(external_exports.string()),
-  /** 本机技能目录名集（machine-owned skills，CAIRN_SKILLS_DIR 扫描根）。
-   *  team skills 维持 server 单源按步下发（票面界限），不进本清单。 */
   skills: external_exports.array(external_exports.string()),
   hardware: machineHardwareSchema.optional()
 });
 var requiredCapabilitiesSchema = external_exports.object({
-  /** 机器必须已装的 MCP server slug 集（⊆ 机器上报 capabilities.mcpServers；
-   *  比对前小写归一——与 parseClaudeMcpEntries slug 律同源）。 */
   mcpServers: external_exports.array(external_exports.string()).optional(),
-  /** 机器 claude-code 必须已配置的模型 id 集（⊆ claudeCodeReport.models[].id；
-   *  pi 侧模型由 server 按步物化下发、无本机清单，本维只对 claude-code 机器
-   *  事实判定——机器无 claudeCodeReport 快照 = 未知，放行）。 */
   models: external_exports.array(external_exports.string()).optional()
 });
 var stepQueueBlockedSchema = external_exports.object({
   kind: external_exports.enum(["machine-offline", "capability-missing"]),
-  /** capability-missing：缺项可读名（capabilityMissingLabels 值域）；
-   *  machine-offline：空集。 */
   missing: external_exports.array(external_exports.string())
 });
 var agentMachineFitRowSchema = external_exports.object({
   machineId: recordId,
   name: external_exports.string(),
   online: external_exports.boolean(),
-  /** 机器 enabledRuntimes 是否含该 agent 步所需 runtime（#682 闸同判据）。 */
   runtimeOk: external_exports.boolean(),
-  /** 能力闸缺项（capabilityMissingLabels 值域）；null = 未上报快照（未知）。 */
   missing: external_exports.array(external_exports.string()).nullable(),
-  /** agent.mcpServers 声明中该机未装的 slug；null = 未上报快照（未知）。 */
   mcpGaps: external_exports.array(external_exports.string()).nullable(),
   canRun: external_exports.boolean()
 });
@@ -51773,8 +51721,6 @@ var agentMachineFitResponseSchema = external_exports.object({
 var secretRecordSchema = external_exports.object({
   id: recordId,
   teamId: recordId,
-  /** 密钥名（表单 ph `STRIPE_API_KEY`，r2 §6.3；名形 = 环境变量风格的标识符，
-   * 取用通道按此名寻址）。 */
   name: external_exports.string(),
   description: external_exports.string().nullable()
 });
@@ -51811,54 +51757,21 @@ var fallbackModelsSchema = external_exports.array(external_exports.object({ prov
 var agentRecordSchema = external_exports.object({
   id: recordId,
   displayName: external_exports.string(),
-  /** 职责；未设置时 UI 显「未设置职责」（r3 §4），null 形状 [推断]。 */
   description: external_exports.string().nullable(),
   status: agentStatusSchema,
   avatarUrl: external_exports.string().nullable(),
-  /** provider id（r3 §4 样本 provider:"r3-gw" = BYOK 自定义服务商）。 */
   provider: external_exports.string().nullable(),
   modelId: external_exports.string().nullable(),
-  /** persona 角色位（#1250 / ADR 0018 决策 0）：seeded 角色 agent 的身份键
-   *  （团队内唯一——unique index on (teamId, persona)）；非角色 agent = null。
-   *  消费面 = persona seeding 幂等键 + review fan-out 三视角解析 + web 指派
-   *  面默认槽位。缺省 = 加法契约（老 server 响应/存量行无该键照常解析）。 */
   persona: external_exports.enum(PERSONA_ROLES).nullish(),
-  /** 思考强度（r3 样本 null = UI「默认」；wire 值词表未采 [推断]）。 */
   thinkingLevel: external_exports.string().nullable(),
-  /** 权限 6 开关的已开集 + 授予工具；wire 项形 [推断]。读侧宽（string[]，
-   * 存量行残值可读）；写侧严 = filterAgentTools（XMON-77）——machines
-   * enabledRuntimes 同一读写分工。 */
   tools: external_exports.array(external_exports.string()),
-  /** 团队密钥授权集（关联 secret id [推断]；值只写不读，02 §8）。 */
   secrets: external_exports.array(external_exports.string()),
-  /** 默认携带技能（#1169）：单值，关联 skill id，null = 不携带。旧 agent.skills
-   * 字段「skills[0] 单值」消费面（详情页概览 Select）的正本。与 skillsAllowlist
-   * 互不影响：携带不必授权，授权不必携带。 */
   defaultSkill: external_exports.string().nullable(),
-  /** 授权白名单（#1169）：关联 skill id 集；**null = 不限制**（全量可读，创建
-   * 缺省）；数组 = 白名单（名单外目录 Read 被 #917 deny 硬挡，bypassPermissions
-   * 下仍挡）。「谁都不许读」须显式写 []——闸从意外默认变回有意选择。 */
   skillsAllowlist: external_exports.array(external_exports.string()).nullable(),
-  /** MCP 逐个勾选（关联 mcp_server id [推断]，02 §7.1）。 */
   mcpServers: external_exports.array(external_exports.string()),
-  /** agent 级并发上限（#1138）：该 Agent 名下同时执行的 worker 步数上限；
-   * null = 不限（缺省——单用户低并发不强制默认值，只对显式设置的 Agent
-   * 生效）。claim 候选级闸消费（machines.ts tryClaim，与机器 maxConcurrent
-   * 双层各自 gate）。optional 形 = 加法契约（machine maxConcurrent 同律）：
-   * 老 server 响应缺字段可解析（消费面回退不渲染）；server 恒发全块。 */
   maxConcurrentTasks: external_exports.number().int().nullable().optional(),
-  /** 归属机（#1259）：agent 绑定的机器 id，其步只投给该机。null = 未设
-   * 归属机（存量回填漏网）——不可领步，UI 可补。optional 形 = 加法契约
-   * （maxConcurrentTasks 同律）：老 server 响应缺字段可解析。 */
   machineId: recordId.nullable().optional(),
-  /** 能力要求声明（#1251 / ADR 0018 决策 4.2）：该 Agent 的步对执行机的
-   *  能力要求（MCP slug 集 / claude-code 模型 id 集）。null = 无要求（缺省/
-   *  存量行）。消费面 = dispatch-eligibility 能力闸（机器上报快照不满足 →
-   *  不领该 Agent 的步）+ agent 面「哪些机器可跑它」。nullish 加法契约
-   *  （maxConcurrentTasks 同律）：老 server 响应缺字段照常解析。 */
   requiredCapabilities: requiredCapabilitiesSchema.nullish(),
-  /** 降级链（#1493）：null = 不降级。nullish 加法契约（requiredCapabilities
-   *  同律）：老 server 响应缺字段照常解析。 */
   fallbackModels: fallbackModelsSchema.nullish()
 });
 var createAgentBodySchema = external_exports.object({
@@ -51867,40 +51780,21 @@ var createAgentBodySchema = external_exports.object({
   provider: external_exports.string().nullish(),
   modelId: external_exports.string().nullish(),
   thinkingLevel: external_exports.string().nullish(),
-  /** persona 角色位（#1250）：nullish——显式 null = 不挂角色（普通 agent）；
-   * 正常创建缺省不带位。值域 PERSONA_ROLES（词表外值 400）。 */
   persona: external_exports.enum(PERSONA_ROLES).nullish(),
   tools: external_exports.array(external_exports.string()).optional(),
   secrets: external_exports.array(external_exports.string()).optional(),
-  /** 单值槽（#1169）：数组（含单元素）拒——携带语义不得再经数组位表达。 */
   defaultSkill: external_exports.string().nullish(),
-  /** nullish（#1169）：显式 null = 不限制（与缺省同值）；[] = 显式全拒。 */
   skillsAllowlist: external_exports.array(external_exports.string()).nullish(),
   mcpServers: external_exports.array(external_exports.string()).optional(),
-  /** agent 级并发上限（#1138）：值域 1..50（Multica agent 层闸同区间，
-   * r10 §5.4）；nullish——显式 null = 不限（与缺省同值）。 */
   maxConcurrentTasks: external_exports.number().int().min(1).max(50).nullish(),
-  /** 归属机（#1259）：创建必填——机器归属单源在 agent 层（任务层钉选已
-   * 退役）。server 校验该机在本团队、启用了对应 runtime、且（claude-code
-   * 时）已配 modelId。 */
   machineId: recordId,
-  /** 能力要求声明（#1251）：nullish——显式 null = 清空回无要求（与缺省
-   * 同值）；对象形状由 requiredCapabilitiesSchema 收严（类型错 400）。 */
   requiredCapabilities: requiredCapabilitiesSchema.nullish(),
-  /** 降级链（#1493）：nullish——显式 null = 清空（不降级）；超过 5 个 400。 */
   fallbackModels: fallbackModelsSchema.nullish()
 });
 var agentTaskSchema = external_exports.object({
-  /** 行种类。观测到的字面量只有 'build'（墓碑行的字面量未采 [推断]）。 */
   kind: external_exports.literal("build"),
-  /** build 自身状态。'waiting' = 已建、尚无机器领取，消费面落 PhasePill 时
-   *  映射为 `queued`。非等待态的 token 未采 [推断]——本仓发 null，消费面按
-   *  `todo.phase` 渲染，渲染结果与原件同（跑起来的 build，其 todo.phase 本身
-   *  就是 planning/building）。 */
   state: external_exports.literal("waiting").nullable(),
-  /** 行的 key（原件 `key={r.buildId}`）；= todo.latestBuildId。 */
   buildId: recordId,
-  /** 行内被渲染的字段（含点击落点 id）。 */
   todo: external_exports.object({
     id: recordId,
     seqNum: external_exports.number().int(),
@@ -51917,17 +51811,10 @@ var chiefRecordSchema = external_exports.object({
   id: external_exports.string(),
   userId: recordId,
   teamId: recordId,
-  /** 绑定 Agent（走 PATCH teams/{id}/chief + 二次确认，记忆不迁移告示，
-   * r5 §2）；未绑定 null。#1260：chief 的模型/思考强度/归属机全部读这
-   * 个 Agent 的自身配置，chief 记录不持覆盖槽。 */
   agent: external_exports.object({ agentId: recordId }).nullable(),
-  /** 章程 = 常设指示（r5 §2 章程 tab；空态「尚无章程。点击编辑，为总管添加
-   * 常设指示。」）；raw 观测默认空串（chief-record-testA.json 一手）。 */
   charter: external_exports.string().nullable(),
   lastTurnAt: epochMs.nullable(),
   createdAt: epochMs,
-  /** 用户时区（raw chief-record-testA.json 一手 `tz:"Asia/Shanghai"`；
-   * r5 §3.6 正文枚举漏记，M4a 补录）。 */
   tz: external_exports.string().nullable().optional()
 });
 var chiefWatchSchema = external_exports.object({
@@ -51937,7 +51824,6 @@ var chiefWatchSchema = external_exports.object({
   title: external_exports.string(),
   projectName: external_exports.string(),
   phase: phaseSchema,
-  /** 派工 watch 的 reason canon（02 §4.3/r5 §3.5 原文）。 */
   reason: external_exports.string(),
   createdAt: epochMs,
   threadId: recordId,
@@ -51954,22 +51840,13 @@ var chiefOrchestrationActivitySchema = external_exports.object({
 });
 var chiefGetResponseSchema = external_exports.object({
   chief: chiefRecordSchema,
-  /** 绑定 Agent 全记录（records/agent.ts 形状）；未绑定 null。 */
   agentActor: agentRecordSchema.nullable(),
-  /** context.tokens 随回合增长（r5 §3.6 两次 API 实测 27065→29866）。 */
   context: external_exports.object({
     tokens: external_exports.number().int(),
     contextWindow: external_exports.number().int()
   }).nullable(),
   watches: external_exports.array(chiefWatchSchema),
-  /** wakes[] 非空形态未实测（r5 §10：set_wake 实走遗留）[推断]，开放条目。 */
   wakes: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())),
-  /** 编排状态块（#895 spec 21 A5 [设计]，加法契约——optional：老封套/老
-   *  web 不带它仍可 parse，忽略即退化现状）：homeMachineId = 绑定 Agent
-   *  的归属机（#1260：chief 步去处的唯一答案；未绑定/未设 = null）；
-   *  activity = per 机 running/waiting 计数（team 域 chief 步计数——
-   *  machines 页是团队面）。消费方 = machines 页三态读标注（A8：join
-   *  useMachines，行内零控件）。server 恒发全块（getChiefEnvelope）。 */
   orchestration: external_exports.object({
     homeMachineId: recordId.nullable(),
     activity: external_exports.array(chiefOrchestrationActivitySchema)
@@ -51977,11 +51854,9 @@ var chiefGetResponseSchema = external_exports.object({
 });
 var chiefThreadSchema = external_exports.object({
   id: external_exports.string(),
-  // chief-<uuid>
   chiefId: recordId,
   userId: recordId,
   teamId: recordId,
-  /** 首句截断 + …（r5 §3.6）。 */
   title: external_exports.string(),
   createdAt: epochMs,
   updatedAt: epochMs,
@@ -51992,17 +51867,10 @@ var chiefThreadSchema = external_exports.object({
     openedAt: epochMs
   }),
   pendingSessionResumeAt: epochMs.nullable(),
-  /** 工具定义/结果哈希表（51 词表的哈希键面，r5 §3.1；词表本体归 M4）。 */
   toolDefHashes: external_exports.record(external_exports.string(), external_exports.string()),
   toolResultHashes: external_exports.record(external_exports.string(), external_exports.string()),
   activeRun: activeRunSchema,
   lastTurnError: external_exports.string().nullable().optional(),
-  /** 回合排队投影（#1108 [设计]，加法契约 optional）：活动回合的步还在
-   *  pending（未被任何机器认领）时由 server 派生——抽屉在飞存在行据此从
-   *  `处理中...` 切到 `排队中...` + 位次 + 等待对象。缺席 = 回合不在飞或
-   *  已被认领（老 server / fixture 面同形退化，呈现回落既有标签）。形 =
-   *  stepJournalRowSchema.queue 同源（records/step.ts StepQueueInfo——
-   *  位次与等待对象只有一套口径）。 */
   turnQueue: external_exports.object({
     position: external_exports.number().int().min(1),
     waitingFor: external_exports.object({
@@ -52011,7 +51879,6 @@ var chiefThreadSchema = external_exports.object({
       running: external_exports.number().int(),
       capacity: external_exports.number().int()
     }).nullable(),
-    /** pending 成因（#1251，StepQueueInfo.blocked 同源同形）。 */
     blocked: stepQueueBlockedSchema.optional()
   }).nullable().optional()
 });
@@ -52049,7 +51916,6 @@ var chiefTurnErrorContentSchema = external_exports.object({
 });
 var ASK_USER_QUESTION_KIND = "ask_user_question";
 var askUserQuestionSchema = external_exports.object({
-  /** 短标题（卡上按块头渲染）。 */
   header: external_exports.string().min(1),
   question: external_exports.string().min(1),
   options: external_exports.array(
@@ -52058,7 +51924,6 @@ var askUserQuestionSchema = external_exports.object({
       description: external_exports.string().optional()
     })
   ).max(8),
-  /** 多选（选项题；自由文本题恒单答，位被忽略）。 */
   multiSelect: external_exports.boolean().optional()
 });
 var askUserAnswerSchema = external_exports.object({
@@ -52092,9 +51957,6 @@ var machineAskResponseSchema = external_exports.object({
 });
 var conversationMessagesResponseSchema = external_exports.object({
   messages: external_exports.array(transcriptRowSchema),
-  /** chips/steerPending/nextCursor 细形未逐一采集 [推断]（steerPending[] 为
-   * 数组形观测；steer 语义 = 回合中补充说明即送，r5 §3.6）。W3 #278 起
-   * build 会话分支透出单槽 pending 内容（[pending.content]）。 */
   chips: external_exports.unknown(),
   historyEpoch: external_exports.number().int(),
   steerPending: external_exports.array(external_exports.unknown()),
@@ -52128,30 +51990,19 @@ var providerModelSchema = external_exports.object({
   maxTokens: external_exports.number().int().positive().optional()
 });
 var providerCompatSchema = external_exports.object({
-  /** 系统提示词走 developer 角色的支持位（r3 §2 表单实测；false = 用
-   * system 角色发）。 */
   supportsDeveloperRole: external_exports.boolean().optional(),
-  /** token 上限字段名：现代 `max_completion_tokens` / 旧式 `max_tokens`。
-   * 部分网关通道拒现代字段（#654 实测：relay 确定性 400「Model does not
-   * support this protocol」，同形重试恒败）。 */
   maxTokensField: external_exports.enum(["max_completion_tokens", "max_tokens"]).optional(),
-  /** 是否发送 OpenAI `store` 字段（pi 探测默认对未知端点发 `store:false`）。
-   * 部分网关通道拒该字段（#654 同上）。 */
   supportsStore: external_exports.boolean().optional()
 });
 var providerRecordSchema = external_exports.object({
   kind: external_exports.literal("custom"),
   providerId: external_exports.string(),
-  // 服务商 ID（表单 ph `例如 my-relay`，r3 §2）
   label: external_exports.string(),
   baseUrl: external_exports.string(),
-  // 表单 ph `https://api.example.com/v1`（r3 §2）
   api: providerApiSchema,
-  /** 「以 Authorization: Bearer 请求头发送 API 密钥」复选（r3 §2/§6.2）。 */
   authHeader: external_exports.boolean(),
   compat: providerCompatSchema,
   models: external_exports.array(providerModelSchema),
-  // `探测模型` 对 /v1/models 拉列表（r3 §2）
   id: recordId,
   createdBy: recordId,
   createdAt: epochMs,
@@ -52182,8 +52033,6 @@ var toolCallRecordSchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
   arguments: external_exports.unknown(),
-  /** 执行结果（toolcall 块完成时可能尚未有结果——live 回传时缺省，
-   * transcript 终稿必含 [设计]）。 */
   result: external_exports.unknown().optional(),
   isError: external_exports.boolean().optional(),
   startedAt: epochMs.optional(),
@@ -52208,16 +52057,10 @@ var modelUsageSchema = external_exports.object({
 var agentTokenUsageSchema = external_exports.array(modelUsageSchema);
 var providerConfigSchema = external_exports.object({
   kind: external_exports.enum(["api_key", "oauth", "http"]),
-  /** preset provider id（38 目录，records/provider.ts）或 custom providerId。 */
   providerId: external_exports.string(),
   label: external_exports.string().optional(),
-  /** custom 端点 baseUrl（preset 走 pi 内建目录时可缺省）。 */
   baseUrl: external_exports.string().optional(),
-  /** custom 端点三协议（records/provider.ts providerApiSchema）。 */
   api: providerApiSchema.optional(),
-  /** 兼容旋钮（#654：records/provider.ts providerCompatSchema——maxTokensField
-   * / supportsStore / supportsDeveloperRole；daemon 物化进 pi models.json，
-   * 缺省位 = pi 端点探测默认）。 */
   compat: providerCompatSchema.optional(),
   authHeader: external_exports.boolean().optional(),
   models: external_exports.array(providerModelSchema).optional(),
@@ -52236,7 +52079,6 @@ var mcpEndpointSchema = external_exports.object({
   command: external_exports.string().optional(),
   args: external_exports.array(external_exports.string()).optional(),
   headers: external_exports.record(external_exports.string(), external_exports.string()).optional(),
-  /** stdio 子进程环境（config env 段；SDK 与默认继承环境合并后 spawn）。 */
   env: external_exports.record(external_exports.string(), external_exports.string()).optional()
 });
 var stepEventSchema = external_exports.discriminatedUnion("type", [
@@ -52275,7 +52117,7 @@ var sessionRefSchema = external_exports.object({
 
 // ../../packages/shared/src/ansi.ts
 var ANSI_ESCAPE_RE = (
-  // biome-ignore lint/suspicious/noControlCharactersInRegex: 剥离器的本体就是控制字符——ESC/BEL 是 CSI/OSC 序列的定义字符，无可替代写法。
+  // biome-ignore lint/suspicious/noControlCharactersInRegex: ESC/BEL are the literal bytes of CSI/OSC sequences; there is no alternative spelling.
   /\x1b\[[0-?]*[ -/]*[@-~]|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g
 );
 function stripAnsiEscapes(text) {
@@ -52285,11 +52127,8 @@ function stripAnsiEscapes(text) {
 // ../../packages/shared/src/records/plan.ts
 var PLAN_FILE_NAME = "plan.md";
 var planRecordSchema = external_exports.object({
-  /** = build.planDocId（documents/{id}/diff 的 {id} 同值）。 */
   id: recordId,
   buildId: recordId,
-  // ≡ conversationId
-  /** 文档版本（v1、v2…，r5 §4 版本机制）。 */
   version: external_exports.number().int().min(1),
   createdAt: epochMs
 });
@@ -52310,34 +52149,22 @@ var infoReportMessageSchema = external_exports.object({
 // ../../packages/shared/src/records/review.ts
 var reviewSeveritySchema = external_exports.enum(["blocking", "suggestion", "info"]);
 var reviewFindingSchema = external_exports.object({
-  /** 稳定 id（呈现层编号排序键；服务端写库时建议 1..N 自然序生成）。 */
   id: external_exports.string(),
   severity: reviewSeveritySchema,
-  /** finding 标题（r8 60/65：finding 段第一行；与 description 段区分）。 */
   summary: external_exports.string(),
-  /** finding 解释段（r8 60：finding 段第二行；多行按 \n 拆段渲染）。 */
   description: external_exports.string().optional(),
-  /** 引用文件路径（r8 60/65：file 字段；缺省 = 无引用）。 */
   file: external_exports.string().optional(),
-  /** 文件内行号（r8 60/65：file:line 形式；缺省 = 仅文件）。#808：模型常把
-   * 行号写成字符串（如 "line": "1"）——coerce 容错，保持 int/positive 语义。 */
   line: external_exports.coerce.number().int().positive().optional(),
-  /** 建议修复段（r8 60/65：建议段；缺省 = 无建议）。 */
   suggestion: external_exports.string().optional()
 });
 var reviewVerdictSchema = external_exports.object({
-  /** 一段总结（r8 60：审核消息首段；方案是否通过 + 概览）。 */
   conclusion: external_exports.string(),
-  /** 编号 findings（按 id 升序；缺省 = 仅结论无 findings，含义 = 方案
-   * 通过）。blocking 项触发 server 端自动修订回路。 */
   findings: external_exports.array(reviewFindingSchema).default([])
 });
 var reviewGateSchema = external_exports.enum(["confirm", "review"]);
 var reviewPromptMetaSchema = external_exports.object({
   kind: external_exports.literal("review"),
   agentId: external_exports.string(),
-  /** 缺省 = 无该字段的存量 prompt（#511 之前入队）：按 `confirm` 语义处理
-   * （不开检出、材料不含变更），与旧 server 行为逐字节一致。 */
   gate: reviewGateSchema.optional()
 });
 function parseReviewPromptMeta(prompt) {
@@ -52361,10 +52188,7 @@ var CHECKOUT_SECTION = [
 
 // ../../packages/shared/src/records/document-diff.ts
 var diffHunkSchema = external_exports.object({
-  /** `@@ -1,17 +1,14 @@`（r5 §4 实测 hunk 头）。 */
   header: external_exports.string(),
-  /** ±行与上下文行（双侧行号由渲染层展开，01 §4.1 diff 视图 = npm diff 数据
-   * + 自建渲染）。 */
   lines: external_exports.array(external_exports.string())
 });
 var diffFileSchema = external_exports.object({
@@ -52374,24 +52198,301 @@ var diffFileSchema = external_exports.object({
   hunks: external_exports.array(diffHunkSchema)
 });
 var documentDiffSchema = external_exports.object({
-  /** chip `v1 → v2`（r5 §4）。 */
   fromVersion: external_exports.number().int(),
   toVersion: external_exports.number().int(),
   files: external_exports.array(diffFileSchema)
 });
 var diffFileContentSchema = external_exports.object({
-  /** conv 分支名（brand.ts conversationBranch(buildId)）。 */
   ref: external_exports.string(),
-  /** 解析后的 conv 分支头 commit sha。 */
   commit: external_exports.string(),
   path: external_exports.string(),
   size: external_exports.number().int(),
-  /** 二进制（首 8KB 含 NUL，git 同款启发式）→ base64；超 1 MiB 闸门 = 413
-   * 不落本封套（server 侧 DIFF_FILE_MAX_BYTES）。 */
   encoding: external_exports.enum(["utf-8", "base64"]),
   content: external_exports.string()
 });
 
+// ../../packages/shared/src/records/merge-gate.ts
+var MERGE_POLICIES = ["human", "shadow", "autonomous"];
+var mergePolicySchema = external_exports.enum(MERGE_POLICIES);
+var GATE_LIMITS = {
+  maxLines: 800,
+  maxFiles: 40,
+  compareFileCap: 300,
+  fixRoundsMax: 2,
+  roundsMax: 4,
+  perspectiveDeadlineMs: 36e5,
+  perspectiveRetries: 1
+};
+var EVIDENCE_EXECUTABLE_EXTENSIONS = [
+  ".mjs",
+  ".cjs",
+  ".js",
+  ".mts",
+  ".cts",
+  ".ts",
+  ".jsx",
+  ".tsx",
+  ".sh",
+  ".py",
+  ".bash",
+  ".zsh",
+  ".fish",
+  ".ps1",
+  ".psm1",
+  ".bat",
+  ".cmd",
+  ".html",
+  ".htm"
+];
+var AUTO_MERGE_PATH_GLOBS = [
+  "apps/*/src/**",
+  "apps/*/test/**",
+  "apps/*/e2e/**",
+  "packages/*/src/**",
+  "packages/*/test/**",
+  "integration/test/**",
+  "docs/verify/**"
+];
+var PROTECTED_PATH_GLOBS = [
+  ".github/**",
+  "**/.husky/**",
+  "**/.claude/**",
+  "**/.pi/**",
+  "**/.cursor/**",
+  "**/.mcp.json",
+  "**/.ckignore",
+  "**/CLAUDE*.md",
+  "**/AGENTS*.md",
+  "docs/pr-review.md",
+  "docs/adr/**",
+  "**/scripts/**",
+  "**/*.config.*",
+  "**/biome.json",
+  "**/biome.jsonc",
+  "**/tsconfig*.json",
+  "**/.gitignore",
+  "**/.gitattributes",
+  "**/drizzle/**",
+  "**/package.json",
+  "pnpm-lock.yaml",
+  "pnpm-workspace.yaml",
+  "**/.npmrc",
+  "apps/server/src/lib/secret-box.ts",
+  "apps/server/src/lib/keys.ts",
+  "apps/server/src/lib/token-auth.ts",
+  "apps/server/src/lib/attachments-token.ts",
+  "apps/server/src/services/secrets.ts",
+  "apps/server/src/services/credentials.ts",
+  "apps/server/src/services/api-keys.ts",
+  "apps/server/src/services/webhook-tokens.ts",
+  "apps/server/src/services/oauth.ts",
+  "apps/server/src/routes-machine.ts",
+  "apps/server/src/services/machine*.ts",
+  "apps/daemon/src/credentials.ts",
+  "apps/daemon/src/secret-channel.ts",
+  "apps/daemon/src/shell-channel.ts",
+  "apps/daemon/src/machine-client.ts",
+  "apps/daemon/src/backend/command-gate.ts",
+  "apps/server/src/services/mcp-face.ts",
+  "apps/server/src/services/mcp-servers.ts",
+  "apps/server/src/routes-webhook.ts",
+  "apps/server/src/db/client.ts"
+];
+var MERGE_GATE_SOURCE_GLOBS = [
+  "apps/server/src/services/merge-gate/**",
+  "packages/shared/src/records/merge-gate.ts",
+  "apps/daemon/src/merge-decision.ts"
+];
+var CHIEF_DISPATCH_DIR = "integration/eval/chief-dispatch";
+var CHIEF_DISPATCH_HARNESS_PATHS = [
+  `${CHIEF_DISPATCH_DIR}/stack.mts`,
+  "apps/daemon/src/backend/pi.ts",
+  "apps/server/src/services/chief-tools.ts",
+  "packages/shared/src/protocol/chief-tools.ts",
+  `${CHIEF_DISPATCH_DIR}/grade.mts`,
+  ".claude/hillclimb/chief-dispatch/cases.json",
+  "apps/server/src/services/chief.ts",
+  `${CHIEF_DISPATCH_DIR}/repo-seed/.github/workflows/ci.yml`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/CHANGELOG.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/Dockerfile`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/README.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/daemon/package.json`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/README.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/package.json`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/src/auth.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/src/export.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/src/routes.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/src/search.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/src/tasks.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/server/src/todos.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/web/README.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/web/package.json`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/web/src/board.tsx`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/web/src/export-button.tsx`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/web/src/login.tsx`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/apps/web/src/theme.ts`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/docs/api.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/docs/deploy.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/docs/index.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/docs/usage.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/package.json`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/packages/shared/README.md`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/packages/shared/package.json`,
+  `${CHIEF_DISPATCH_DIR}/repo-seed/packages/shared/src/protocol.ts`
+];
+var harnessRegressionResultSchema = external_exports.object({
+  patchDigest: external_exports.string().min(1),
+  harness_sha: external_exports.string().regex(/^[0-9a-f]{64}$/),
+  decision_ok: external_exports.number().finite().min(0).max(1),
+  trace_digest: external_exports.string().regex(/^[0-9a-f]{64}$/)
+});
+var COMPARE_FILE_STATUSES = [
+  "added",
+  "removed",
+  "modified",
+  "renamed",
+  "copied",
+  "changed",
+  "unchanged"
+];
+var compareFileSchema = external_exports.object({
+  status: external_exports.enum(COMPARE_FILE_STATUSES),
+  filename: external_exports.string().min(1),
+  previousFilename: external_exports.string().min(1).nullable(),
+  sha: external_exports.string().nullable(),
+  additions: external_exports.number().int().nonnegative(),
+  deletions: external_exports.number().int().nonnegative(),
+  patchSha: external_exports.string().regex(/^[0-9a-f]{64}$/).nullable()
+});
+var BLOCKER_CLASSES = ["policy", "transient", "human"];
+var MERGE_BLOCKERS = [
+  { code: "policy-human", class: "policy", label: "\u9879\u76EE\u7B56\u7565\u4E3A\u4EBA\u5DE5\u5408\u5E76" },
+  { code: "autonomy-paused", class: "policy", label: "\u81EA\u6CBB\u5408\u5E76\u5DF2\u6682\u505C" },
+  { code: "daily-cap", class: "policy", label: "\u5F53\u65E5\u81EA\u6CBB\u5408\u5E76\u6570\u5DF2\u8FBE\u4E0A\u9650" },
+  { code: "not-applicable", class: "policy", label: "\u4E0D\u662F GitHub PR \u5F62\u6001\u7684\u6784\u5EFA" },
+  { code: "not-current-build", class: "transient", label: "\u4E0D\u662F\u4EFB\u52A1\u7684\u5F53\u524D\u6784\u5EFA" },
+  { code: "phase-not-review", class: "transient", label: "\u4EFB\u52A1\u4E0D\u5728\u5BA1\u6838\u5173\u53E3" },
+  { code: "work-in-flight", class: "transient", label: "\u8FD8\u6709\u6B65\u9AA4\u5728\u8DD1" },
+  {
+    code: "pr-unreadable",
+    class: "transient",
+    label: "\u8BFB\u4E0D\u5230 PR \u6216\u4ED3\u5E93\u9ED8\u8BA4\u5206\u652F\uFF0C\u6216 PR \u7684 head \u4E0D\u662F\u53EF\u7528\u7684 SHA"
+  },
+  { code: "pr-not-open", class: "human", label: "PR \u5DF2\u5408\u5E76\u6216\u5DF2\u5173\u95ED" },
+  { code: "pr-draft", class: "transient", label: "PR \u662F\u8349\u7A3F" },
+  { code: "pr-behind-base", class: "transient", label: "PR \u843D\u540E\u4E8E\u76EE\u6807\u5206\u652F\u6216\u843D\u540E\u6570\u672A\u77E5" },
+  { code: "pr-from-fork", class: "human", label: "PR \u6765\u81EA fork" },
+  { code: "base-not-default", class: "human", label: "PR \u7684\u76EE\u6807\u5206\u652F\u4E0D\u662F\u9ED8\u8BA4\u5206\u652F" },
+  { code: "mergeable-state", class: "transient", label: "GitHub \u5224\u5B9A\u6682\u4E0D\u53EF\u5408\u5E76" },
+  { code: "self-required", class: "human", label: "cairn/merge-gate \u88AB\u8BBE\u6210\u4E86\u5FC5\u9700\u68C0\u67E5" },
+  {
+    code: "required-checks-unreadable",
+    class: "transient",
+    label: "\u8BFB\u4E0D\u5230\u5F53\u524D head \u7684\u68C0\u67E5\u6216\u5FC5\u9700\u68C0\u67E5\u6E05\u5355"
+  },
+  { code: "required-checks-none", class: "human", label: "\u9ED8\u8BA4\u5206\u652F\u6CA1\u6709\u5FC5\u9700\u68C0\u67E5" },
+  { code: "required-check-missing", class: "transient", label: "\u5FC5\u9700\u68C0\u67E5\u5728\u5F53\u524D head \u4E0A\u7F3A\u5E2D" },
+  { code: "required-check-pending", class: "transient", label: "\u5FC5\u9700\u68C0\u67E5\u8FD8\u5728\u8DD1" },
+  { code: "required-check-failed", class: "transient", label: "\u5FC5\u9700\u68C0\u67E5\u672A\u901A\u8FC7" },
+  { code: "pr-evidence-not-green", class: "transient", label: "pr-evidence \u672A\u901A\u8FC7" },
+  {
+    code: "patch-unavailable",
+    class: "transient",
+    label: "\u8BFB\u4E0D\u5230\u5F53\u524D head \u7684 compare\uFF0C\u8865\u4E01\u6458\u8981\u6682\u4E0D\u53EF\u5F97"
+  },
+  {
+    code: "compare-malformed",
+    class: "human",
+    label: "compare \u7684\u54CD\u5E94\u5F62\u72B6\u4E0D\u5BF9\uFF0C\u6216\u5B83\u7684 SHA\uFF08\u8BF7\u6C42\u7684 head\u3001\u63D0\u4EA4\u3001\u7236\u63D0\u4EA4\uFF09\u5199\u9519"
+  },
+  { code: "compare-truncated", class: "human", label: "compare \u6587\u4EF6\u5217\u8868\u88AB\u622A\u65AD" },
+  {
+    code: "patch-unbindable",
+    class: "human",
+    label: "\u8865\u4E01\u65E0\u6CD5\u53D6\u6458\u8981\uFF08\u8BC1\u636E\u4E4B\u5916\u6CA1\u6709\u6587\u4EF6\uFF0C\u6216\u6709\u6587\u4EF6\u7F3A blob sha\uFF09"
+  },
+  { code: "size-cap", class: "human", label: "\u8865\u4E01\u8D85\u8FC7 800 \u884C\u6216 40 \u4E2A\u6587\u4EF6" },
+  { code: "protected-path", class: "human", label: "\u6539\u52A8\u547D\u4E2D D4 \u4FDD\u62A4\u8DEF\u5F84" },
+  { code: "outside-auto-merge", class: "human", label: "\u6539\u52A8\u5728\u53EF\u81EA\u52A8\u5408\u5E76\u96C6\u4E4B\u5916" },
+  { code: "test-deleted", class: "human", label: "\u5220\u9664\u4E86\u6D4B\u8BD5" },
+  {
+    code: "opaque-file",
+    class: "human",
+    label: "\u8BC1\u636E\u76EE\u5F55\u5916\u6709\u770B\u4E0D\u5230 diff \u7684\u6587\u4EF6\uFF08\u4E8C\u8FDB\u5236\u3001diff \u8FC7\u5927\u6216\u7EAF\u6539\u540D\uFF09"
+  },
+  { code: "evidence-outside-ticket", class: "human", label: "\u6539\u52A8\u4E86\u522B\u7684\u7968\u7684\u8BC1\u636E\u76EE\u5F55" },
+  { code: "evidence-executable", class: "human", label: "\u8BC1\u636E\u76EE\u5F55\u91CC\u65B0\u589E\u6216\u6539\u52A8\u4E86\u53EF\u6267\u884C\u6587\u4EF6" },
+  {
+    code: "harness-regression-missing",
+    class: "human",
+    label: "\u6539\u4E86 harness \u4F46\u7F3A\u5C11\u7ED1\u5B9A\u5F53\u524D\u8865\u4E01\u7684\u56DE\u5F52\u8BC4\u6D4B\u7ED3\u679C"
+  },
+  {
+    code: "harness-regression-stale",
+    class: "human",
+    label: "\u56DE\u5F52\u8BC4\u6D4B\u7ED3\u679C\u7ED1\u5B9A\u7684\u8865\u4E01\u6458\u8981\u4E0D\u662F\u5F53\u524D\u8865\u4E01"
+  },
+  {
+    code: "harness-regression-below-threshold",
+    class: "human",
+    label: "\u56DE\u5F52\u8BC4\u6D4B decision_ok \u4F4E\u4E8E\u57FA\u7EBF\u7F6E\u4FE1\u533A\u95F4\u4E0B\u9650"
+  },
+  { code: "issue-ref-missing", class: "human", label: "\u4EFB\u52A1\u6765\u6E90\u89E3\u4E0D\u51FA issue \u53F7" },
+  {
+    code: "evidence-link-missing",
+    class: "transient",
+    label: "PR body \u7F3A\u9489\u5728\u672C PR \u63D0\u4EA4\u4E0A\u3001\u6307\u5411\u672C PR \u8BC1\u636E\u7684 raw \u6C38\u4E45\u94FE"
+  },
+  { code: "verify-missing", class: "transient", label: "\u5F53\u524D\u8865\u4E01\u6CA1\u6709\u9A8C\u8BC1\u5224\u5B9A" },
+  { code: "verify-failed", class: "transient", label: "\u9A8C\u8BC1\u672A\u901A\u8FC7" },
+  { code: "verify-extraction-failed", class: "transient", label: "\u9A8C\u8BC1\u5224\u5B9A\u63D0\u53D6\u5931\u8D25" },
+  { code: "verify-evidence-invalid", class: "transient", label: "\u9A8C\u8BC1\u8BC1\u636E\u4E0D\u5728\u672C\u7968\u76EE\u5F55" },
+  { code: "verify-tampered", class: "human", label: "\u9A8C\u8BC1\u8005\u6539\u4E86\u4EE3\u7801" },
+  { code: "review-missing", class: "transient", label: "\u6709\u89C6\u89D2\u8FD8\u6CA1\u6709\u5BA1\u6838\u5224\u5B9A" },
+  { code: "review-blocking", class: "transient", label: "\u5BA1\u6838\u6709 blocking \u53D1\u73B0" },
+  { code: "review-extraction-failed", class: "transient", label: "\u5BA1\u6838\u5224\u5B9A\u63D0\u53D6\u5931\u8D25" },
+  { code: "perspective-timed-out", class: "human", label: "\u5BA1\u6838\u89C6\u89D2\u8D85\u65F6" },
+  { code: "decision-missing", class: "transient", label: "chief \u8FD8\u6CA1\u6709\u51FA go/no-go" },
+  { code: "decision-no-go", class: "transient", label: "chief \u5224 no-go" },
+  { code: "decision-extraction-failed", class: "transient", label: "chief \u5224\u5B9A\u63D0\u53D6\u5931\u8D25" },
+  { code: "fix-rounds-exhausted", class: "human", label: "\u4FEE\u590D\u8F6E\u7528\u5B8C" },
+  { code: "fix-no-change", class: "human", label: "\u4FEE\u590D\u8F6E\u6CA1\u6709\u6539\u52A8\u8865\u4E01" },
+  { code: "gate-rounds-exhausted", class: "human", label: "\u95F8\u8F6E\u6B21\u7528\u5B8C" },
+  { code: "no-reviewers", class: "human", label: "\u56E2\u961F\u6CA1\u6709\u53EF\u6D3E\u7684\u5BA1\u6838\u89C6\u89D2" },
+  { code: "no-verifier", class: "human", label: "\u56E2\u961F\u6CA1\u6709\u53EF\u6D3E\u7684\u9A8C\u8BC1\u8005" },
+  { code: "no-decider", class: "human", label: "chief \u6CA1\u6709\u53EF\u7528\u7684 agent" }
+];
+var MERGE_BLOCKER_CODES = MERGE_BLOCKERS.map((b4) => b4.code);
+var mergeBlockerSchema = external_exports.object({
+  code: external_exports.enum(MERGE_BLOCKER_CODES),
+  class: external_exports.enum(BLOCKER_CLASSES),
+  label: external_exports.string(),
+  detail: external_exports.array(external_exports.string())
+});
+var mergeReadinessSchema = external_exports.object({
+  ready: external_exports.boolean(),
+  headSha: external_exports.string().nullable(),
+  patchDigest: external_exports.string().nullable(),
+  policy: mergePolicySchema,
+  blockers: external_exports.array(mergeBlockerSchema)
+});
+for (const value of [
+  MERGE_POLICIES,
+  GATE_LIMITS,
+  EVIDENCE_EXECUTABLE_EXTENSIONS,
+  AUTO_MERGE_PATH_GLOBS,
+  PROTECTED_PATH_GLOBS,
+  MERGE_GATE_SOURCE_GLOBS,
+  CHIEF_DISPATCH_HARNESS_PATHS,
+  COMPARE_FILE_STATUSES,
+  BLOCKER_CLASSES,
+  ...MERGE_BLOCKERS,
+  MERGE_BLOCKERS,
+  MERGE_BLOCKER_CODES
+]) {
+  Object.freeze(value);
+}
+
 // ../../packages/shared/src/records/project.ts
 var PROJECT_REPO_KINDS = ["hosted", "github", "local"];
 var projectRepoKindSchema = external_exports.enum(PROJECT_REPO_KINDS);
@@ -52399,30 +52500,20 @@ var projectRecordSchema = external_exports.object({
   id: recordId,
   name: external_exports.string(),
   teamId: recordId,
-  /** 项目描述（#1242 设置页可编辑面）：可空，null/缺键 = 无描述（行值
-   * null 时 toProjectRecord 不带键——与 repoKind 等可空列同口径）。 */
   description: external_exports.string().optional(),
-  /** repo 形态（02 §3）；字段名/值 [推断]。GitHub 接入侧连号授权、
-   * executor push conv 分支、建 PR、读 PR/issues/CI workflow runs。 */
   repoKind: projectRepoKindSchema.optional(),
-  // —— M2b repo 形态展开（本 schema 头注「M2 实现期展开」的落地；皆 [推断]，
-  // wire 补采后收紧，04 附录 A）——
-  /** 托管 repo 名段：远端 URL `<host>/<teamId>/<repoName>`（r3 §1.4 daemon.log
-   * `Cloning <teamId>/r3-lifecycle` 实测形状；值 = 项目名 slug [设计]）。 */
   repoName: external_exports.string().optional(),
-  /** GitHub 接入 `owner/repo`（02 §3 接入形态；字段名 [推断]）。 */
   githubRepo: external_exports.string().optional(),
-  /** local 形态：用户本机 git 工作树仓绝对路径（spec 12 / #359；server 端
-   * `~` 展开后的规范化值，daemon 镜像 clone 同源消费）。github 形态（ADR
-   * 0017 / #1213）：可选同机执行加速位——server 只做形态校验（绝对路径），
-   * 存在性与 git 仓判定在 daemon 侧（路径可能活在执行机上，server 看不见），
-   * 失格静默回落 GitHub clone。 */
   localPath: external_exports.string().optional(),
-  /** clone URL（「Git 复制检出命令」卡数据源，02 §9.3）。托管 = 本地主机代位
-   * （02 §5.8 gitHostDomain 槽）；github = github.com 派生 [设计]；local 形态
-   * 无远端 URL 面（daemon 直接 clone localPath，spec 12）。 */
+  mergePolicy: mergePolicySchema.optional(),
+  localChecks: external_exports.array(external_exports.string().min(1)).optional(),
   cloneUrl: external_exports.string().optional()
 });
+var projectMergeConfigSchema = external_exports.object({
+  mergePolicy: mergePolicySchema.default("human"),
+  localChecks: external_exports.array(external_exports.string().min(1)).default([])
+});
+var patchProjectMergeConfigSchema = projectMergeConfigSchema.partial().strict();
 var githubRepoRefSchema = external_exports.object({
   owner: external_exports.string(),
   repo: external_exports.string()
@@ -52459,9 +52550,7 @@ var LOCAL_ERROR_REASON_COPY = {
   not_absolute: "\u9700\u8981\u7EDD\u5BF9\u8DEF\u5F84"
 };
 var projectTreeResponseSchema = external_exports.object({
-  /** 请求 ref 回显（缺省 `HEAD`）。 */
   ref: external_exports.string(),
-  /** 解析后的 commit sha（ref 不存在 = 404 {error}）。 */
   commit: external_exports.string(),
   path: external_exports.string(),
   entries: external_exports.array(
@@ -52469,24 +52558,18 @@ var projectTreeResponseSchema = external_exports.object({
       name: external_exports.string(),
       path: external_exports.string(),
       type: external_exports.enum(["blob", "tree"]),
-      /** blob 字节数；tree 为 null（ls-tree -l 语义）。 */
       size: external_exports.number().int().nullable()
     })
   )
 });
 var projectFilesResponseSchema = external_exports.object({
-  /** 请求 ref 回显（缺省 `HEAD`）。 */
   ref: external_exports.string(),
-  /** 解析后的 commit sha（ref 不存在 = 404 {error}，与 tree/file 同口径）。 */
   commit: external_exports.string(),
-  /** 行数超 limit 即截断（git 序取前 N）；截断只影响召回，不影响交互帧率
-   * （客户端全量本地 fuzzy）。 */
   truncated: external_exports.boolean(),
   files: external_exports.array(
     external_exports.object({
       path: external_exports.string(),
       type: external_exports.enum(["blob", "tree"]),
-      /** blob 字节数；tree 为 null（ls-tree -l 语义，与 tree 面同形）。 */
       size: external_exports.number().int().nullable()
     })
   )
@@ -52496,7 +52579,6 @@ var projectFileResponseSchema = external_exports.object({
   commit: external_exports.string(),
   path: external_exports.string(),
   size: external_exports.number().int(),
-  /** 二进制判定（首 8KB 含 NUL，git 同款启发式 [设计]）→ base64。 */
   encoding: external_exports.enum(["utf-8", "base64"]),
   content: external_exports.string()
 });
@@ -52510,16 +52592,13 @@ var projectBranchesResponseSchema = external_exports.object({
   )
 });
 var projectCommitsResponseSchema = external_exports.object({
-  /** 解析的 ref 回显（缺省 = 默认分支）。 */
   ref: external_exports.string(),
   commits: external_exports.array(
     external_exports.object({
       sha: external_exports.string(),
       shortSha: external_exports.string(),
-      /** 提交标题行（git log %s 同义）。 */
       message: external_exports.string(),
       authorName: external_exports.string(),
-      /** 作者时间 epoch ms（git log %aI 解析）。 */
       at: external_exports.number()
     })
   )
@@ -52527,11 +52606,8 @@ var projectCommitsResponseSchema = external_exports.object({
 var projectCommitDetailResponseSchema = external_exports.object({
   sha: external_exports.string(),
   shortSha: external_exports.string(),
-  /** 提交标题行（%s，与列表行 message 同源同值——详情头「与列表行一致」
-   * 验收的数据面）。 */
   message: external_exports.string(),
   authorName: external_exports.string(),
-  /** 作者时间 epoch ms（git %aI 解析，列表行同源）。 */
   at: external_exports.number(),
   files: external_exports.array(diffFileSchema)
 });
@@ -52620,15 +52696,10 @@ function stepTakesSecrets(kind) {
 }
 var stepRecordSchema = external_exports.object({
   id: recordId,
-  // 观测形态 base64 样（r3 §9 `claim step=3iE_…`、r5 §3.1）
-  /** 所属 build（≡ conversationId，CONTEXT.md 实体等式）。 */
   buildId: recordId,
   kind: stepKindSchema,
-  /** claim 到该步的机器；未领取 null [推断]。 */
   machineId: recordId.nullable(),
   createdAt: epochMs
-  // journal 状态字段（heartbeat/tool/done 生命周期，02 §5.4；recover 细节
-  // [推断]）归 M2/M3 按实现展开，不预发明。
 });
 var stepStatusSchema = external_exports.enum([
   "pending",
@@ -52648,19 +52719,8 @@ var quotaWaitSchema = external_exports.object({
 var stepJournalRowSchema = stepRecordSchema.extend({
   status: stepStatusSchema,
   checkpointCommit: recordId.nullable(),
-  /** 排队投影（#1108）：pending 步的「在排队、位次、等谁」——server 读侧
-   *  派生（steps 查询按行计算），SSE step 事件不带（事件只报状态流转，
-   *  队列细节由查询重取承载）。claimed/done 等非 pending 行缺席 = 不在
-   *  排队。optional 加法契约：老 server / fixture 面缺席 = 排队呈现退
-   *  化（回落既有 `处理中...` 标签），零回归。
-   *  hold（#1257）：额度挂起中的 pending 步带（reason + retryAt = 退避到期/
-   *  下次尝试时刻）——排队行呈现「等额度」而非「等空闲机器」；非挂起步
-   *  缺席。 */
   queue: external_exports.object({
-    /** 团队 FIFO 位次（1-based；钉选步只数该机可见集——钉同机或未钉）。 */
     position: external_exports.number().int().min(1),
-    /** 等待对象：钉选机器（含其 running/capacity 快照）；null = 未钉
-     *  （等待任何在线机器）。 */
     waitingFor: external_exports.object({
       machineId: recordId,
       name: external_exports.string(),
@@ -52671,48 +52731,29 @@ var stepJournalRowSchema = stepRecordSchema.extend({
       reason: external_exports.literal("quota"),
       retryAt: epochMs
     }).optional(),
-    /** pending 成因（#1251，加法契约 optional）：machine-offline = 等机器
-     *  上线（等待有用）；capability-missing = 无机器满足能力要求（装 X 即
-     *  解锁，missing 携缺项可读名）。缺席 = 正常排队（有可领机器）或老
-     *  server——呈现回落既有排队标签，零回归。 */
     blocked: stepQueueBlockedSchema.optional()
   }).optional(),
   skillInjection: skillInjectionSchema.nullable(),
   blockerHandoff: blockerHandoffSchema.optional(),
-  /** #1261 配额挂起投影：status=waiting_quota 行在位（其余缺席——zod strip
-   * 下 record 对拍不漂移；老 server / fixture 面缺席 = 呈现回落既有标签，
-   * 零回归）。 */
   quotaWait: quotaWaitSchema.optional()
 });
 var buildStepActionBodySchema = external_exports.discriminatedUnion("action", [
   external_exports.object({
     action: external_exports.literal("revision"),
-    /** 观测值仅 "plan"（r5 §4 抓包）；side 词表未采齐，不收窄以外值。 */
     side: external_exports.literal("plan"),
     feedback: external_exports.string(),
     clientMessageId: external_exports.string()
-    // <uuid>（r5 §4 抓包）
   }),
   external_exports.object({ action: external_exports.literal("confirm") }),
   external_exports.object({
     action: external_exports.literal("review"),
-    /** 执行审核的 Agent id（与 chief-agent-dialog 同源 memberType:"agent" 行
-     * 的 actorId）。#1250（ADR 0018 层 1）：缺省 = fan-out 三视角——server
-     * 按团队 persona（CodeReviewer/SecurityAuditor/TestEngineer）各入队一条
-     * review 步（agentId 经各自步的 prompt meta header 透出）；无 persona
-     * 时回落 assignment.review 槽单步；两者皆缺 400。携带 agentId = 既有
-     * 单审核人路径，行为不变。 */
     agentId: external_exports.string().optional(),
-    /** 可选关注点 textarea 内容；空串视为未填。fan-out 路径随各视角 prompt
-     * 逐份注入。 */
     focus: external_exports.string().optional()
   }),
   external_exports.object({
     action: external_exports.literal("restart"),
-    /** 空消息不成发送（原站语义「发消息触发」）：直连 API 也收不住空稿。 */
     feedback: external_exports.string().min(1),
     clientMessageId: external_exports.string()
-    // <uuid>（revision 同形，r5 §4；server 侧现未消费）
   })
 ]);
 var STEP_ACTIVITY_PHASES = [
@@ -52728,20 +52769,9 @@ var STEP_ACTIVITY_PHASES = [
 var stepActivityPhaseSchema = external_exports.enum(STEP_ACTIVITY_PHASES);
 var stepActivityReportSchema = external_exports.object({
   phase: stepActivityPhaseSchema,
-  /** phase='tool' 时在位：最近开始执行的工具名（并行工具 = 最后一个开始的；
-   *  终稿工具行仍经 message 事件落库，本字段只是进行态标签）。 */
   tool: external_exports.string().optional(),
-  /** phase='retrying' 时在位：auto_retry 轮次（1 起）。 */
   attempt: external_exports.number().int().optional(),
-  /** #1308：协议回落 / 网络重试开新一轮时在位。server hub 与 web 在飞
-   *  text/thinking 快照按此位清掉；普通 starting / 节流重发不得带此位。 */
   resetLive: external_exports.boolean().optional(),
-  /** #918 技能事实（本步累计，首见序，去重按 name、denied 粘滞）：daemon 从
-   *  工具调用流识别的「读了哪些技能」，被 deny 挡下的同样在列（判定源 =
-   *  工具事实，分类单源 skill-facts.ts）。每份上报都携带当前累计集——hub
-   *  单槽天然保住全集，订阅进场补发即拿到完整清单。缺省 = 本步尚无技能
-   *  事实（旧 daemon 恒缺省，零回归）。上限见 daemon activity.ts 的
-   *  SKILL_FACTS_CAP（载荷有界）。 */
   skills: external_exports.array(skillFactSchema).optional()
 });
 var stepActivitySchema = stepActivityReportSchema.extend({
@@ -52763,7 +52793,6 @@ var todoAgentRefSchema = external_exports.object({
 });
 var buildHistoryEntrySchema = external_exports.object({
   buildId: recordId,
-  // buildId ≡ conversationId（CONTEXT.md/r3 §3.0）
   createdAt: epochMs
 });
 var TASK_SOURCE_KINDS = ["github-issue", "github-issue-self", "orchestration"];
@@ -52789,13 +52818,10 @@ var todoRecordSchema = external_exports.object({
   teamId: recordId,
   projectId: recordId,
   title: external_exports.string(),
-  /** 结构化描述（r3 §3.1 创建表单四行占位；chief 措辞→spec 三段式见 02 §4.3）。 */
   spec: external_exports.string(),
   phase: phaseSchema,
   phaseAt: epochMs,
-  /** 看板序号 `#seqNum`（CONTEXT.md：todo 持久且带序号）。 */
   seqNum: external_exports.number().int(),
-  /** 列内排序位（01 §4.1 拖拽面：@dnd-kit 列内 orderIndex 排序）。 */
   orderIndex: external_exports.number(),
   tagIds: external_exports.array(recordId),
   assignment: assignmentSchema.nullable(),
@@ -52805,46 +52831,19 @@ var todoRecordSchema = external_exports.object({
   hasChanges: external_exports.boolean(),
   hasPlan: external_exports.boolean(),
   buildHistory: external_exports.array(buildHistoryEntrySchema),
-  /** 来源任务引用；语义未特写 [推断]（r3 §3.0 字段表列名照抄）。#1250（ADR
-   * 0018 层 2）落地为拆父子指针：chief split_todo 建的子卡本列 = 父卡 id
-   * （存量恒 null 不变）；「子全 done 父自动收」的归账键。 */
   sourceTodo: recordId.nullable(),
-  /** 依赖边（#1250 / ADR 0018 层 2，blocking 语义）：阻塞本卡的兄弟子卡 id
-   * 集（chief split_todo 写入）；全集 done 前本卡不可派发（startBuilds 闸）。
-   * 缺省 = 无依赖（存量行/非拆卡同形）。 */
   blockedBy: external_exports.array(recordId).nullish(),
-  /** 记录版本号（r3 §3.0 观测值 2–4；SSE 文档事件带 seq/v，02 §1.2/r5 §7.2）。 */
   v: external_exports.number().int(),
-  // —— r5 §3.2 SSE todo doc 补录（chief 派工溯源）——
-  /** 创建者 = 用户或 Chief 绑定 Agent id；人工建时的取值未分离观测 [推断]。 */
   createdBy: recordId.nullable(),
   ownerId: recordId.nullable(),
-  /** 来源 build（chief 回合 id，形如 `chief-…`）；人工建时 null [推断]。 */
   sourceBuildId: external_exports.string().nullable(),
-  // —— #446 来源两列（ADR 0005 D6，溯源家族位；#640 扩 orchestration 档）——
-  /** 来源种类（TASK_SOURCE_KINDS 注释：导入 vs 自建的方向位 + 编排来源）；
-   * local 项目 / 未连接 GitHub 的项目且非总管拆出 = null（至多一个来源，
-   * 两列够用）。 */
   sourceKind: todoSourceKindSchema.nullable(),
-  /** 来源引用（`github:owner/repo#123` 形 = githubIssueSourceRef 单源；
-   * `chief:<uuid>` 形 = orchestrationSourceRef 单源，#640）；无来源 = null。 */
   sourceRef: external_exports.string().nullable(),
   output: todoOutputSchema.default("code"),
-  /** #1257 板面挂起态（server 读侧派生，不落列）：在飞 todo 的当前步挂起时
-   *  透出——`quota` = 等额度（retryAt = 退避到期/下次尝试时刻，null = 不适用）；
-   *  `machine` = 等机器（#1259 起语义 = 归属机不在线/团队零在线）。缺席 = 未挂
-   *  起（正常排队 / 在跑 / 终态）——板面据此区分「等机器/等额度」挂起态与
-   *  「执行失败」红态。optional 加法契约：老 server / fixture 面缺席 = 板面
-   *  无挂起 chip，零回归。 */
   waitingOn: external_exports.object({
     on: external_exports.enum(["machine", "quota"]),
     retryAt: epochMs.nullable()
   }).optional(),
-  /** #1261 等额度投影（读侧派生，不存列）：latest build 活动步 waiting_quota
-   * 时在位——板面卡态/横幅的数据源（哪一路 relay、下次探测时刻，形态比
-   * waitingOn.on='quota' 多 lane/kind/retryAfterMs 三位）。null = 无挂起；
-   * 键缺席 = fixture/老 server 面（optional 加法契约，零回归）。
-   * 形态单源 = records/step.ts quotaWaitSchema。 */
   quotaWait: quotaWaitSchema.nullable().optional(),
   usageCost: usageCostSchema.optional()
 });
@@ -53081,7 +53080,6 @@ var remoteToolDefSchema = external_exports.object({
   label: external_exports.string().optional(),
   description: external_exports.string(),
   parameters: external_exports.unknown().optional(),
-  /** 读工具幂等可重放（重试预算面，r5 §3.1 bundle 提取）。 */
   replaySafe: external_exports.boolean().optional()
 });
 var machineToolRelayBodySchema = external_exports.object({
@@ -53217,7 +53215,6 @@ var githubListParams = (max) => obj(
   ["projectId"]
 );
 var CHIEF_REMOTE_TOOLS = [
-  // —— 读侧 16（replaySafe，r5 §3.1；#627 +models）——
   {
     name: "projects",
     description: "List the team projects with their repo binding and todo counts.",
@@ -53246,9 +53243,6 @@ var CHIEF_REMOTE_TOOLS = [
     parameters: obj({}),
     replaySafe: true
   },
-  // models（#627）：候选模型清单——create_agent/update_agent 的
-  // provider/modelId 值域。agents 工具返回的是各 agent 的已配 modelId，
-  // 不是候选集；本工具才是值域正本。
   {
     name: "models",
     description: "List the model candidates for agents as rows {provider, providerLabel, modelId, modelName}. Read this before setting provider/modelId on create_agent or update_agent \u2014 only values from this list are valid.",
@@ -53287,9 +53281,6 @@ var CHIEF_REMOTE_TOOLS = [
   },
   {
     name: "docs",
-    // 批量读是刻意的：这个工具实测占全部工具调用的 64%，而每次调用都是一整趟
-    // 模型往返（上下文重发一遍，是成本的大头）。paths 一次给多个文件路径，
-    // 把「读五个文件」从五趟压到一趟。
     description: "Read repository documents (files at a ref) for a project. Pass several paths at once to read them in one call.",
     parameters: obj(
       {
@@ -53307,9 +53298,6 @@ var CHIEF_REMOTE_TOOLS = [
     parameters: obj({ buildId: str("Optional build id filter.") }),
     replaySafe: true
   },
-  // GitHub 读三件（#1406 P5a-2）：读项目所连仓库的真数据；只回结构化字段，
-  // 列表不带 issue / PR 正文。标题等字段谁都能写（公开仓任何人可开 issue、
-  // 从 fork 开 PR），description 明说它们是数据。
   {
     name: "issues",
     description: `List issues of a GitHub-backed project's repository, newest first, without bodies (pull requests are left out, so a page can hold fewer than perPage entries). Each entry: number, title, state, labels, author, authorAssociation, createdAt, updatedAt, htmlUrl, taskId (the id of this team's task made from the issue, or null). hasMore = another page exists. Titles, labels and logins are written by third parties (anyone can open an issue on a public repository): ${GITHUB_DATA_NOTE}`,
@@ -53353,8 +53341,6 @@ var CHIEF_REMOTE_TOOLS = [
     ]),
     replaySafe: true
   },
-  // —— 组织侧 21（raw 19 − delete_skills + create_skill/update_skill
-  // + set_remote_shell 回摆 XMON-115 + split_todo #1250）——
   {
     name: "create_todo",
     description: "Create a todo in a project. Title = verb phrase; spec = the three-section transform (user quote block, \u8981\u6C42 bullets, \u8865\u5145\u4FE1\u606F bullets).",
@@ -53370,9 +53356,6 @@ var CHIEF_REMOTE_TOOLS = [
       ["projectId", "title", "spec"]
     )
   },
-  // split_todo（#1250 / ADR 0018 层 2）：大票拆 N 子卡 + blocking 依赖边。
-  // 拆解方案落父卡 plan 文档并停 confirm 关口给人审（人可整树驳回）——确认
-  // 即派发无阻塞子卡，后续波次随 blocker 完成自动起，子全 done 父自动收。
   {
     name: "split_todo",
     description: "Split a big todo into N sub-cards with blocking dependency edges (ADR 0018 layer 2). Each sub-card pins one role agent and runs direct-execute (no per-card plan gate). The split scheme lands on the parent plan doc and parks at the parent confirm gate for human review \u2014 confirming the parent dispatches the unblocked sub-cards; later waves auto-start as their blockers finish; the parent auto-completes when every sub-card is done. Split only when subtasks are truly independent or orderable \u2014 single-view single-artifact work should run as one todo, not be split.",
@@ -53502,9 +53485,6 @@ var CHIEF_REMOTE_TOOLS = [
     description: "Delete agents from the team.",
     parameters: obj({ agentIds: idArr("Agent ids to delete.") }, ["agentIds"])
   },
-  // create_skill / update_skill（XMON-109，CHIEF_TOOLS_ADDED 登记）：组织面
-  // 写件，归 delete_skills 的 raw 组织位。写向 = 团队技能根本地目录，body
-  // 语义与 REST 写面同形（frontmatter 是唯一真值）。
   {
     name: "create_skill",
     description: "Create a team skill as a folder in the team skills directory. The skill is a SKILL.md entry file (frontmatter name and description are required and must match the declared values) plus optional extra files.",
@@ -53553,11 +53533,6 @@ var CHIEF_REMOTE_TOOLS = [
     description: "Delete team secrets by name or id.",
     parameters: obj({ names: idArr("Secret names or ids to delete.") }, ["names"])
   },
-  // set_remote_shell（XMON-115 回摆，XMON-77 除名解除）：chief 会话写某
-  // agent 的「远程 shell」开关——写 agent.tools（开关词），与 REST PATCH
-  // /agents/{aid} 同字段同过滤；执法面 = claim 双闸注册 + 步中每命令预检
-  // （XMON-108），fail-closed。enabled 必填显式（缺省/非布尔 400，不沿用
-  // #573 前缺省 true 的 fail-open 形）。
   {
     name: "set_remote_shell",
     description: "Grant or revoke the remote shell permission switch of an agent.",
@@ -53587,13 +53562,8 @@ var CHIEF_REMOTE_TOOLS = [
     description: "Remove the schedule of a todo.",
     parameters: obj({ todoId: str("Todo id.") }, ["todoId"])
   },
-  // —— 执行侧 5 ——
   {
     name: "run_builds",
-    // #903（ADR 0014）：withPlan = chief 的逐次派发判定（判定权归
-    // chief，无团队设置槽）；缺省 = 先规划（fail-safe：判不准的方向是
-    // 「多问一次」）。dispatchReason 把判定理由落进 transcript（回执可
-    // 审计、用户可就地一句话推翻）。直修只跳过方案确认——审阅闸恒在。
     description: "Start builds for todos: assignment picks the executing agent per responsibility fit; withPlan is your per-dispatch judgment (omit = plan first) \u2014 state the reason via dispatchReason; the review gate applies either way. Assignment must set at least one slot (plan and/or build agentId) \u2014 an empty assignment is rejected.",
     parameters: obj(
       {
@@ -53602,10 +53572,6 @@ var CHIEF_REMOTE_TOOLS = [
           {
             plan: obj({ agentId: str("Planning agent id.") }),
             build: obj({ agentId: str("Executing agent id.") }),
-            // #1250（ADR 0018 层 1）：review/verify 槽随派发可带——review
-            // 槽 = 无 persona 时的单审核人回落位；verify 槽在位时 review
-            // 关口抵达即入队验证步（槽空零动作，语义与 REST builds 面
-            // 同一 assignmentSchema）。
             review: obj({
               agentId: str("Fallback review agent id (used when no review persona is seeded).")
             }),
@@ -53633,9 +53599,6 @@ var CHIEF_REMOTE_TOOLS = [
   },
   {
     name: "run_review",
-    // #1250（ADR 0018 层 1）：fan-out 三视角——persona 三员各入队一条 review
-    // 步（agentId 走各自 prompt meta header），三份 verdict 并行落会话；无
-    // persona 时回落 assignment.review 槽单步。
     description: "Request an independent review run of a build: fans out the three review perspectives (CodeReviewer / SecurityAuditor / TestEngineer) as parallel read-only review steps, each reporting its own verdict; falls back to the assignment review slot when personas are absent.",
     parameters: obj({ buildId: str("Build id.") }, ["buildId"])
   },
@@ -53654,11 +53617,7 @@ var CHIEF_REMOTE_TOOLS = [
     description: "(Blocked \u2014 merge is human-only. #1256, ADR 0018.) Merge reviewed builds into the default branch \u2014 only through the web UI human exit; calling this tool from a machine (chief/MCP) is hard-rejected.",
     parameters: obj({ buildIds: idArr("Build ids to merge.") }, ["buildIds"])
   },
-  // —— Chief 私有侧 10 ——
   {
-    // #1049：结构化问答 + 阻塞语义。工具结果 = 用户在问答卡上的实际选择
-    // （等答期间本回合 step 挂起，答完同一回合继续）；取消/步终态 →
-    // cancelled 文本。D3：server 侧永不超时自动拍板。
     name: "ask_user",
     description: "Ask the user structured questions and block this turn until they answer a question card (same turn continues with their choices as the tool result). Use it whenever the answer would change what you do next; batch up to 4 questions per call instead of asking one at a time.",
     parameters: obj(
@@ -53897,26 +53856,14 @@ var DAEMON_LOG_PREFIXES = [
   "workspace",
   "recover",
   "wake",
-  // MCP per-turn 连接面（r3 §1.5 daemon.log 实测行 `[mcp] r3mcp: connect
-  // failed — its tools are unavailable this turn: fetch failed…`；M4b 补录，
-  // 02 §5.3 前缀词表回写）。
   "mcp",
-  // skills 执行面注入诊断行（#371，spec 14：`[skills] <type>: <msg>` 族，
-  // type ∈ loaded/collision/invalid-frontmatter/missing-skill-md/cap/invalid，
-  // 词表正源 = daemon backend/skills.ts classifySkillDiagnostic + buildSkillsCatalog）。
   "skills",
-  // 命令闸裁决行（#866 T5：`[gate] <ask|reject>: rule=<id> command=<…>`——只记
-  // 非放行裁决，allow 静默；词表正源 = daemon backend/command-gate.ts）。
   "gate",
-  // pi project trust 裁决行（#925 D1：`[trust] denied: <.pi/…> present in
-  // worktree …`——只记受保护资源在位的 denied 行，空 worktree 静默；词表
-  // 正源 = daemon backend/pi.ts detectTrustProtectedResources）。
   "trust"
 ];
 var machineJsonSchema = external_exports.object({
   machineId: external_exports.string(),
   token: external_exports.string().regex(MACHINE_TOKEN_PATTERN),
-  // 64hex
   teamId: recordId,
   serverUrl: external_exports.string()
 });
@@ -53929,28 +53876,15 @@ var daemonJsonSchema = external_exports.object({
   runner: external_exports.literal("cli")
 });
 var WORKTREE_CONTRACT = {
-  /** 基座 `<workspacesRoot>/<projectId>/repo`（baseRepoDir）。 */
   baseRepoSubpath: "<projectId>/repo",
-  /** 任务目录 `<workspacesRoot>/<conversationId>`（目录名 = UUIDv7）。 */
   taskDirLayout: "<workspacesRoot>/<conversationId>",
-  /** 分支 = 品牌前缀 + conversationId（brand.ts conversationBranch()）；
-   * worktree add -b，base = origin/<convBranch> 否则 origin/<defaultBranch>。 */
   branchPrefix: BRAND.branchPrefix,
-  /** 复用/恢复：存在→reused；checkpoint→reset --hard + clean -fd（restored）；
-   * 陈旧→remove --force + prune + branch -D。 */
   checkpointResetArgs: ["reset --hard", "clean -fd"],
   staleCleanupArgs: ["worktree remove --force", "worktree prune", "branch -D"],
-  /** 并发保护：projectLock(projectId) 串行化同项目工作区操作。 */
   concurrencyGuard: "projectLock(projectId)",
-  /** 防分叉护栏：origin/<branch> 有本机没有的提交且 worktree 不在该分支 → 抛错。 */
   remoteBranchDiverged: "remote branch diverged",
-  /** 每步结束自动 push 本 conversation 工作分支；合并用 git merge --no-edit <ref>。 */
   mergeArgs: "merge --no-edit",
-  /** 强制同步面板文案 canon（r3 §3.9）。 */
   forceSyncCopy: "\u4E22\u5F03\u4EE3\u7801\u4FEE\u6539\u5E76\u5220\u9664\u975E\u5FFD\u7565\u7684\u672A\u8DDF\u8E2A\u6587\u4EF6\uFF1B\u4FDD\u7559\u5FFD\u7565\u5185\u5BB9\u3002\u4EC5\u672C\u6B21\u751F\u6548\u3002",
-  /** 重试预算（r3 bundle 注释原话数值）：push 覆盖 git-host 5xx 窗口；
-   * 冷 worktree ls-remote+fetch「~2 min typical, ~8 min worst on /done's path」；
-   * merge 轮走 gitNetwork。 */
   retryBudgetCanon: "~2 min typical, ~8 min worst on /done's path"
 };
 var ORPHAN_WORKTREE_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
@@ -53972,60 +53906,20 @@ var REMOTE_TOOL_TIMEOUT_MS = 1e4;
 // ../../packages/shared/src/records/machine.ts
 var MACHINE_RUNTIMES = ["pi", "claude-code", "gemini"];
 var machineRecordSchema = external_exports.object({
-  /** machineId（r3 §1.2 观测形 `TlZ2sSD4EJCxjNJqVhdo_`；server 记录键名
-   * [推断]）。 */
   id: recordId,
-  /** cairn start --name 默认 hostname（r3 §1.1）；机器页显示样 `r3-mbp 离线
-   * …NJqVhdo_ · max 3`（r3 §1.2）。 */
   name: external_exports.string(),
   teamId: recordId,
-  /** presence（02 §1.2 machine_presence 事件 {machineId, online}）。 */
   online: external_exports.boolean(),
-  /** 机器页数据含 latestCliVersion（r5 §8 实测 "0.1.53"）；用于 MCP/记忆等
-   * 版本墙提示（02 §7.1/§8）。 */
   latestCliVersion: external_exports.string().nullable(),
-  /** 本机 vs 接入机（spec 11 A9）：server 启动 seed / hostname 匹配的 enroll
-   * 落 'local'，其余恒 'remote'；本机行钉 machines 页列表首且不可删（A8）。 */
   kind: external_exports.enum(["local", "remote"]),
-  /** per-runtime 开关态（spec 11 A9）：默认 [] = 全关；machines 页 switch
-   * PATCH 写回。读侧宽（string[]，spec 11 模块清单原文）、写侧严
-   * （patchMachineBodySchema 钉 MACHINE_RUNTIMES enum）——词表演进时旧库
-   * 行仍可读出，入口恒收严。 */
   enabledRuntimes: external_exports.array(external_exports.string()),
-  /** 机器层 shell 访问闸（XMON-108 R1，UI 承诺文案 agent.ts「远程 shell」
-   * 副文案的本体）：与 agent 层「远程 shell」开关联合判定（双闸齐开才有
-   * remote_shell，见 claimedStepSchema.localTools）。默认 false（存量行
-   * migration 回填）——「机器 shell 权限改动秒级热加载」由每调用预检兑现
-   * （POST /api/machine/shell/{stepId} 复读本列，非 claim 期一次闸）。 */
   shellEnabled: external_exports.boolean(),
-  /** 机器并发上限（#1108）：该机同时执行的步数 N——server claim 闸 +
-   * daemon 本地闸双侧消费；超过 N 的步留 pending（排队）。#1241 起未覆盖时
-   * 本值是 server 按能力指纹算的推荐值（见 concurrencySource）；用户改过
-   * 则以用户值为准。DB NOT NULL 默认 3。optional 形 = 加法契约：老 server
-   * 响应缺该字段，消费方回退（daemon 的本地闸按 1 串行，web 不渲染并发面）；
-   * server 恒发全块。 */
   maxConcurrent: external_exports.number().int().optional(),
-  /** #1241：true = 用户写过 maxConcurrent，心跳不再用推荐值覆盖。缺席 =
-   *  老 server（web 不标手动/自动）。 */
   maxConcurrentOverridden: external_exports.boolean().optional(),
-  /** #1241：按当前硬件算出的推荐值（覆盖时也发，恢复自动回到这个数）。
-   *  无硬件 = 保守默认。缺席 = 老 server。 */
   recommendedConcurrent: external_exports.number().int().optional(),
-  /** #1241：选择器可选区间（按总内存；无指纹 = 1..8）。PATCH 写域仍是 1..16。
-   *  缺席 = 老 server（web 退回 1..8）。 */
   concurrencyRange: external_exports.object({ min: external_exports.number().int(), max: external_exports.number().int() }).optional(),
-  /** #1241：manual = 用户覆盖；measured = 推荐值来自硬件；estimate = 没有
-   *  可用指纹，maxConcurrent 是保守默认。缺席 = 老 server。 */
   concurrencySource: external_exports.enum(["measured", "estimate", "manual"]).optional(),
-  /** 该机当前 claimed 非 chief 步数（#1108 排队可见的机器面读数，`执行中 n/N`
-   * n；#1148 起 chief 在跑不进 n——n 恒 ≤ N）：读侧派生（listSteps/claim
-   * 时点计数），不落库。optional 形同 maxConcurrent——老 server 缺席时机器
-   * 页不渲染该标注。 */
   runningSteps: external_exports.number().int().optional(),
-  /** 机器能力清单（#1251 / ADR 0018 决策 4.1）：daemon 经 enroll/presence
-   *  上报的已装 MCP slug 集 + 本机技能名集。三态：清单 = 已上报；null =
-   *  从未上报（老 daemon——机器页显示「未上报」，能力闸按未知放行）；缺席 =
-   *  老 server 响应（读侧加法契约，消费面回落不渲染）。 */
   capabilities: machineCapabilitiesSchema.nullish()
 });
 var patchMachineBodySchema = external_exports.object({
@@ -54041,17 +53935,9 @@ var evacuateMachineBodySchema = external_exports.object({
 var MODEL_SOURCE_RUNTIMES = ["pi", "claude-code", "gemini"];
 var modelSourceRuntimeSchema = external_exports.enum(MODEL_SOURCE_RUNTIMES);
 var modelSourceModelSchema = external_exports.object({
-  /** 模型 id（pi = custom provider models[] 的 id；claude-code = settings.json
-   *  槽值原样）。 */
   id: external_exports.string().min(1),
-  /** 显示名（pi = models[] 的 name；claude-code = 模型 id 原样）。 */
   name: external_exports.string().min(1),
-  /** 槽位名（claude-code：default / opus / sonnet / …，env.ANTHROPIC_*_MODEL
-   *  中段小写化；pi 段缺省）。 */
   slot: external_exports.string().optional(),
-  /** #1288 活性标注：alive = 目录在且未报死 / dead = 运行时 404 回填 /
-   *  unknown = 未探过或探活失败（缺省 = unknown，fail-open）。
-   *  只读位：server 探活回填，web 消费不写。 */
   liveness: external_exports.enum(["alive", "dead", "unknown"]).optional()
 });
 var claudeBinInfoSchema = external_exports.object({
@@ -54066,24 +53952,11 @@ var claudeAuthStateSchema = external_exports.object({
 });
 var modelSourceSchema = external_exports.object({
   runtime: modelSourceRuntimeSchema,
-  /** claude-code：上报机器的 settings.json 存在且解析为对象；pi 恒 true
-   *  （server 在跑 = cairn 自有 runtime 可用）。**不是**「二进制装了」的
-   *  判据——那是 `bin`（#1050）。 */
   installed: external_exports.boolean(),
-  /** 上报机器的 hostname（os.hostname()）——「已安装在 <hostname>」文案源。
-   *  #707 起跟随执行机，不再是 server 主机。 */
   hostname: external_exports.string(),
-  /** #1259 归属机维：该段来自哪台机器（machine id）——创建 agent 三级
-   *  级联按它过滤模型清单。pi 段缺席（server 侧目录，机器无关）。 */
   machineId: external_exports.string().optional(),
   models: external_exports.array(modelSourceModelSchema),
-  /** claude 二进制事实（#1050）。三态，别压平：
-   *  - 对象 = 探到了（path + version）；
-   *  - `null` = **探过了、没有**（PATH 上没有 / 不可执行 / 超时）——这是
-   *    「配置文件在而二进制缺失」那条假绿的判据，页面对它说「未安装」；
-   *  - 缺席 = 没探过（老 daemon 未上报），UI 闭嘴（不写「未知」）。 */
   bin: claudeBinInfoSchema.nullable().optional(),
-  /** 机器本地凭据态（#1050）：由步内预检回填，随节拍上行；缺席同 bin。 */
   auth: claudeAuthStateSchema.optional()
 });
 var modelSourcesEnvelopeSchema = external_exports.object({
@@ -54145,16 +54018,11 @@ var modelRefSchema = external_exports.object({
 var verifyEvidenceSchema = external_exports.object({
   path: external_exports.string().min(1),
   note: external_exports.string().optional(),
-  /** 对应方案 Verification 清单的第几项（从 1 起，#1492）。缺省 = 老 verdict
-   *  或无清单任务，不对应具体清单项。 */
   item: external_exports.coerce.number().int().min(1).optional()
 });
 var verifyVerdictSchema = external_exports.object({
-  /** 本轮交付是否通过验证（如实报——失败是有效结论，不是本步的错误）。 */
   passed: external_exports.boolean(),
-  /** 一段总结：跑了什么、对账结果（CI / PR body / 证据包）。 */
   conclusion: external_exports.string(),
-  /** 证据条目（缺省 = 无证据——「跑过但零产物」按未通过处理由人裁量）。 */
   evidence: external_exports.array(verifyEvidenceSchema).default([])
 });
 
@@ -54168,18 +54036,9 @@ var skillInjectionFactsSchema = external_exports.object({
 // ../../packages/shared/src/protocol/machine-wire.ts
 var machineEnrollBodySchema = external_exports.object({
   teamId: recordId,
-  /** cairn start --name（缺省 = hostname）。 */
   name: external_exports.string().optional(),
-  /** CLI 版本（机器页 latestCliVersion 数据源，r5 §8）。 */
   cliVersion: external_exports.string().optional(),
-  /** 本机 claude-code 模型上报（#707）：daemon 读本机 settings.json 随注册
-   *  上行，免等首个 presence 节拍。缺席 = 旧 daemon（server 视为未知）。 */
   claudeCode: claudeCodeReportSchema.optional(),
-  /** 机器能力清单（#1251 / ADR 0018 决策 4.1）：已装 MCP slug 集 + 本机
-   *  技能名集，随注册上行免等首个 presence 节拍。wire 级宽松位（z.unknown，
-   *  心跳红线 02 §5.4——坏形状永不 400 注册/心跳）；server 侧对
-   *  machineCapabilitiesSchema 单独 safeParse 收严落库，失败丢弃保留旧值。
-   *  缺席 = 旧 daemon（server 视为未知，能力闸放行）。 */
   capabilities: external_exports.unknown().optional()
 });
 var machineEnrollResponseSchema = machineJsonSchema;
@@ -54189,7 +54048,6 @@ var machineEnrollStartBodySchema = external_exports.object({
 });
 var machineEnrollStartResponseSchema = external_exports.object({
   enrollId: external_exports.string(),
-  /** 浏览器授权 URL（登录页授权团队，02 §5.2）。 */
   url: external_exports.string()
 });
 var machineEnrollPollBodySchema = external_exports.object({ enrollId: external_exports.string() });
@@ -54203,10 +54061,6 @@ var machineEnrollConfirmResponseSchema = external_exports.object({ machine: mach
 var machinePresenceBodySchema = external_exports.object({
   cliVersion: external_exports.string().optional(),
   claudeCode: claudeCodeReportSchema.optional(),
-  /** 机器能力清单（#1251，enroll 同律）：wire 级宽松位（z.unknown）——
-   *  字段级解析失败不阻心跳（02 §5.4 红线），收严在 server 侧 safeParse
-   *  （machineCapabilitiesSchema），失败丢弃该字段保留旧值、presence 恒
-   *  {ok:true}。缺席 = 旧 daemon，server 保留旧值。 */
   capabilities: external_exports.unknown().optional()
 });
 var machineOkResponseSchema = external_exports.object({ ok: external_exports.literal(true) });
@@ -54218,76 +54072,36 @@ var machineClaimBodySchema = external_exports.object({
 });
 var claimedStepSchema = external_exports.object({
   step: stepRecordSchema,
-  /** ≡ step.buildId（CONTEXT.md 实体等式；显式字段 = 02 §5.7 `for conv <uuid>`）。
-   * chief 步 = `chief-<uuid>`（conversationId ≡ threadId，r5 §3.1）。 */
   conversationId: recordId,
-  /** 会话语义（02 §4.2/§5.7）：new session | continue session（合并轮/驳回
-   * 重规划/chief 续轮复用同 conv pi 会话）。sessionId = 引擎侧会话标识（done 回传）。 */
   session: external_exports.object({
     action: external_exports.enum(["new", "continue"]),
     sessionId: external_exports.string().nullable(),
-    /** #1312：上一轮会话所在机器。仅当它与本步领取机不同时携带（换绑 /
-     *  迁移后会话文件还在旧机器上）。同机或缺省 = 旧 daemon 形，zod strip
-     *  无版本墙。 */
     priorMachineId: external_exports.string().optional()
   }),
-  /** 续轮指令（server 合成 [设计]）：驳回 feedback 注入重规划轮（r5 §4
-   * 「v2 内容忠实执行反馈」的宿主等价物）、chief 回合任务文本/wake 事实。
-   * 缺省 = daemon 按 kind 兜底（CONTINUE_PROMPTS）或 title+spec 任务文本。 */
   instruction: external_exports.string().nullable().optional(),
-  /** worker 步任务面；chief 步缺省（无 todo 语境，r5 §3.1）。 */
   todo: external_exports.object({
     id: recordId,
     seqNum: external_exports.number().int(),
     title: external_exports.string(),
     spec: external_exports.string(),
-    /** 任务元信息注入面（#446 / ADR 0005 分叉律）：github 形态项目携带，
-     * 缺省 = local/hosted 现行为（daemon 回落 FIXED_TAGS 单标签 + 占位
-     * 回填指令，文本逐字节不变）。vocab = 项目标签集镜像的 name 列（claim
-     * 时现取，不缓存第二真值；标签数量上限的分叉落点在 server setTaskMeta
-     * 校验分支与工具面 tags 数组形，不进本载荷）；titleFinal = 标题已是
-     * 真值（issue 来源），daemon 不注入回填指令且 server 拒绝 title 覆写。
-     * 纯增可选字段无版本墙：旧 daemon 忽略 = 现行为。 */
     meta: external_exports.object({
       titleFinal: external_exports.boolean(),
       vocab: external_exports.array(external_exports.object({ name: external_exports.string() }))
     }).optional(),
-    /** #1406 任务来源两列（todo 记录同名列的投影）：sourceKind='github-issue'
-     * 时 daemon 把任务文本包进 GitHub issue 原文围栏（ADR 0021 D5），且不在
-     * systemPrompt 里写标题。种类用宽 string 而非枚举：server 新增来源种类时，
-     * 旧 daemon 不因枚举失配拒掉整条 claim。缺省 = 旧 server 形（无围栏，
-     * 现行为）；旧 daemon 按 zod strip 忽略。 */
     sourceKind: external_exports.string().nullable().optional(),
     sourceRef: external_exports.string().nullable().optional(),
     blockerHandoff: blockerHandoffSchema.optional(),
     output: external_exports.string().nullable().optional()
   }).optional(),
-  /** worker 步项目面；chief 步 = 探索基座（可缺省 = 裸目录回合）。 */
   project: external_exports.object({
     id: recordId,
     name: external_exports.string(),
-    /** repo 绑定位（M3b worktree 契约接线，02 §3/§5.5 + spec 12 local 形态）：
-     * cloneUrl = 托管 `<origin>/git/<teamId>/<repoName>`（02 §5.8
-     * gitHostDomain 槽本地代位）、GitHub https 派生、或 local 形态的用户仓库
-     * 绝对路径（server 端 validateLocalRepoPath 规范化值——daemon 镜像 clone
-     * 源与 ff-only 落地面同吃该路径，git clone 对本地路径默认走硬链接）；
-     * null = 项目未绑 repo（工作区退化为裸目录）。 */
     repo: external_exports.object({
-      // 词表单源 = PROJECT_REPO_KINDS（records/project.ts；新 kind 落地
-      // 即随 wire，免三处散射编辑）。
       kind: external_exports.enum(PROJECT_REPO_KINDS),
       cloneUrl: external_exports.string(),
-      /** github 形态同机加速位（ADR 0017 / #1213）：项目行 localPath
-       * 非空时携带。daemon 物化时双条件判定（路径存在 + 该路径 origin
-       * 归一化后与 cloneUrl 同仓），不过则静默回落 GitHub clone——
-       * 路径活在执行机，server 侧不预判。local 形态不携带（cloneUrl
-       * 即路径本身）。 */
       localPath: external_exports.string().optional()
     }).nullable()
   }).optional(),
-  /** 执行 Agent（worker 步 = assignment 按步类取槽，02 §4.2/r5 §5；chief 步 =
-   * 绑定 Agent，模型 = 绑定 Agent 模型 r5 §3.1）；null = 未指派（不可执行，
-   * server 侧不派发 [设计]）。 */
   agent: external_exports.object({
     id: recordId,
     displayName: external_exports.string(),
@@ -54295,75 +54109,19 @@ var claimedStepSchema = external_exports.object({
     provider: external_exports.string().nullable(),
     modelId: external_exports.string().nullable(),
     thinkingLevel: external_exports.string().nullable(),
-    /** 该 Agent 记忆条目注入 systemPrompt（02 §4.4 读路径最小形；注入形
-     * [推断] 保留，04 附录 A）。 */
     memories: external_exports.array(external_exports.object({ title: external_exports.string(), content: external_exports.string() })).optional(),
-    /** 授权白名单（#1169 起正名，原 skills 字段拆出的授权半边）：null =
-     * 不限制（全量可读，创建缺省——[] 旧行已随迁移转 null）；数组 = 白名单
-     * （#917 deny 吃它，名单外 Read 硬挡）；[] = 显式全拒（有意选择，不再
-     * 是意外缺省）。worker 步恒携带（null 或数组）；chief 步不携带（信任面
-     * 全量直通）。旧 daemon 忽略本字段 = 其缺省律全量直通——混版本窗口里
-     * 老 daemon 对白名单行不设挡（窗口期接受，server+daemon 同步部署即收）。 */
     skillsAllowlist: external_exports.array(external_exports.string()).nullable().optional(),
-    /** 默认携带技能（#1169 携带半边，单值）：worker 步恒携带（null = 未设）；
-     * daemon 据此把非空值排进 #1116 注入绑定序首位（自动携带语义）。chief
-     * 步不携带（chief 目录恒全量，无绑定序）。 */
     defaultSkill: external_exports.string().nullable().optional(),
-    /** #1106 派发技能注入选择（worker 步恒携带含空数组）：本步任务 brief
-     * 实际注入的技能 id 集（= 服务端按任务文本对授予集规则选出的子集；
-     * [] = 已计算零命中——零注入不是故障；缺省 = 旧 server 未做选择，
-     * 目录注入回落 skillsAllowlist 白名单全量）。ids ⊆ skillsAllowlist
-     * （授权上限不变——denied 判定仍吃 allowlist 全量，本字段只收窄目录
-     * 注入面）。纯增可选字段：旧 daemon 忽略 = 现行为，无版本墙。 */
     injectedSkills: external_exports.array(external_exports.string()).optional(),
-    /** 权限开关已开集（XMON-77）：词表 = AGENT_TOOL_SWITCHES 六档（XMON-84
-     * 用户拍板 B 恢复全六档），执法落点 = daemon 收尾闸（merge fail-fast +
-     * push 软拒）与 server requestMerge 闸——只消费 合并分支/推送分支 两
-     * 执法档，四无本体档照常透传（无消费方，本体另立规划票）。worker 步恒
-     * 携带——含空数组（[] = 全关，least-privilege；缺省保留给老 server =
-     * fail-open 版本墙，两态不得混淆）。chief 步不携带（chief 步不开
-     * worktree、无 git 收尾——两开关无语义）。读侧宽：存量行残值原样透传，
-     * daemon 只认已知档。无版本墙：纯增可选字段，旧 daemon 忽略 = 现行为
-     * （推送不受限）。 */
     tools: external_exports.array(external_exports.string()).optional()
   }).nullable(),
-  /** chief 步块（r5 §3.1：Chief 回合 = pi 会话 + 服务端 relay 工具；细节
-   * [设计]——wire 未采）。 */
   chief: external_exports.object({
-    /** ≡ conversationId 去 `chief-` 前缀后的线程 id（chief-<uuid> 同值）。 */
     threadId: recordId,
-    /** server 合成 system prompt（charter + 团队资源清单 + 策略指引，
-     * 02 §4.3 接口契约「输入：用户自然语言消息 + 团队资源清单」）。 */
     systemPrompt: external_exports.string(),
-    /** 本回合触发（user 消息轮 / wake 轮，r5 §3.5）。 */
     trigger: external_exports.enum(["user", "gate", "settle", "failed", "wake"])
   }).optional(),
-  /** remoteTools[]（服务端定义、服务端执行；chief 步 = 51 词表全量，
-   * protocol/chief-tools.ts；worker 步 = 记忆三件套 WORKER_MEMORY_REMOTE_TOOLS，
-   * 02 §4.4/r5 §6「worker 侧同族工具经 remoteTools 下发」。位形一手 = bundle
-   * 提取，r5 §3.1）。 */
   remoteTools: external_exports.array(remoteToolDefSchema).optional(),
-  /** daemon 本地工具注册依据（XMON-108 R1，XMON-85 规划「权限决策单点在
-   * server」）：server 在 claim 时算好的词集，daemon 照此注册 LocalToolDef
-   * （agent-backend.ts）——词缺席 = 工具不注册（fail-closed；与 mcpServers
-   * 版本墙不同，这里缺省与空数同义，无混发形状失败模式）。当前两词：
-   * remote_shell（AGENT_TOOL_SHELL ∩ machine.shellEnabled 双闸）与
-   * create_tag（agent.tools ∋ 创建标签，与机器旗无关——T1/XMON-111 消费，
-   * 契约由本票一次定死）。worker 步恒携带含空数组（[] = 无本地工具，
-   * least-privilege，skills/tools 同律）；chief 步不携带（chief 无 worktree/
-   * 无本地工具语义，跨机 shell 派发显式缓期）。每条命令的真实闸在预检端点
-   * （本字段只是注册面），步中关闸不影响在跑会话的下一次预检。纯增可选
-   * 字段：旧 daemon 解析即丢弃，无版本墙。 */
   localTools: external_exports.array(external_exports.string()).optional(),
-  /** 已授权 MCP slug 列表（spec 13 断约：原 McpEndpoint[] 改 string[]——
-   * server 不再解析端点、不再持有任何 MCP 凭证；执行 daemon 读本机
-   * `~/.claude.json` 按 slug 自行解析，per-turn 连接、失败降级不阻断，
-   * 工具名 `mcp__<slug>__<tool>`，未知 slug daemon 侧跳过。三态受管
-   * （#1307，对齐 Multica mcp_config.go）：数组（含 [] = 受管严格空——
-   * daemon 据此给 claude-code SDK 上 strictMcpConfig 锁，用户全局 MCP 不进
-   * 会话）= 受管集合；缺省 = 继承 runtime 配置，只在版本墙
-   * （MCP_MIN_CLI_VERSION，断约时提升）未达时由新 server 发出——旧 daemon
-   * 视为无 MCP 运行，不存在混发两种形状的失败模式。 */
   mcpServers: external_exports.array(external_exports.string()).optional()
 });
 var LOCAL_TOOL_REMOTE_SHELL = "remote_shell";
@@ -54375,15 +54133,8 @@ var machineSyncCommandSchema = external_exports.object({
   syncId: recordId,
   buildId: recordId,
   projectId: recordId,
-  /** 目标仓 clone URL（机器基座未存在该 project 时 daemon 据此 clone）；同
-   * build 已有 worktree 的机器复用本地，不发此 clone。 */
   cloneUrl: external_exports.string(),
-  /** 同步目标目录（机器本机路径；web 默认 `~/<homeDirName>/workspaces/<buildId>`，
-   * 用户可改——r1 changelog 09-13 文本）。 */
   directory: external_exports.string(),
-  /** ref = 分支名（`cairn/conv-<uuid>`，brand conversationBranch）；
-   * commit = 完整 40hex sha（daemon 端 fetch 后 reset --hard 到此 sha，spec
-   * `目标提交 <12hex>` r3 §3.9 展示形但 wire 用 40hex 简化对拍）。 */
   ref: external_exports.string(),
   commit: external_exports.string(),
   force: external_exports.boolean()
@@ -54397,8 +54148,6 @@ var machineStreamEventSchema = external_exports.discriminatedUnion("type", [
   external_exports.object({ type: external_exports.literal("wake") }),
   external_exports.object({ type: external_exports.literal("shutdown") }),
   external_exports.object({ type: external_exports.literal("steer"), stepId: recordId }),
-  // stop = 用户停止钮中断在跑步（M7 #308 [设计]，steer 同律：只带 stepId
-  // 信号，discard 勾选位经 GET /api/machine/stop 拉取-确认）。
   external_exports.object({ type: external_exports.literal("stop"), stepId: recordId }),
   external_exports.object({ type: external_exports.literal("sync"), sync: machineSyncCommandSchema })
 ]);
@@ -54446,16 +54195,8 @@ var machineToolResponseSchema = external_exports.union([
   machineToolRelayResponseSchema
 ]);
 var machineTokenResponseSchema = external_exports.object({
-  /** 该步 Agent 的 provider 配置（apiKey 内存态经 SecretBox 解密下发，02 §8
-   * 运行时层；无 key 网关可留空 = r3 §2 表单语义）。 */
   provider: providerConfigSchema.nullable(),
-  /** 本步可取用的团队密钥（名字 → 明文；服务端解析契约 = M2c
-   * services/credentials.ts）。明文只出现在本返回值（02 §8 纪律），且**不得**
-   * 铺进 agent 进程环境——daemon 持有真值，agent 经本地取用通道显式取用。
-   * 按 step kind 收窄：plan/review/chief 步恒空（records/step.ts
-   * stepTakesSecrets）。 */
   secrets: external_exports.record(external_exports.string(), external_exports.string()),
-  /** 托管 repo git 凭证（02 §3/§5.4：per-step 注入；接线随 git 面）。 */
   git: external_exports.object({
     username: external_exports.string(),
     password: external_exports.string()
@@ -54507,74 +54248,20 @@ var quotaBlockSchema = external_exports.object({
 var machineDoneBodySchema = external_exports.object({
   status: external_exports.enum(["success", "failed", "stopped"]),
   errorMessage: external_exports.string().optional(),
-  /** pi 会话标识（continue session 复用面：合并轮/重规划轮，02 §4.2）。 */
   sessionId: external_exports.string().optional(),
-  /** per-model 用量（token_usage 记账，02 §6.2/r3 §3.8）。 */
   usage: external_exports.array(modelUsageSchema).optional(),
-  /** review 列位双键之一（02 §4.1/r5 §8）。 */
   hasChanges: external_exports.boolean().optional(),
-  /** 工作分支偏离（#1195/#1277）：daemon 步收尾发现 HEAD 停在契约分支之外的
-   * 具名分支时携带（expected = 会话分支，actual = 实际 HEAD 分支；detached
-   * HEAD / 查询失败不携带）。消费面 = server 产物闸 2：build 步携带即硬失败。
-   * hasChanges=false 时原因说明步窗口内无提交；有提交时拒绝自动收工，且不保留
-   * 本步 PR 回填。两态都点名两分支。 */
   workBranchDrift: external_exports.object({ expected: external_exports.string().min(1), actual: external_exports.string().min(1) }).optional(),
-  /** 步收尾时 conv 分支 HEAD sha [设计]（M3b）：per-step checkpoint 数据源
-   * （「恢复到此处」r3 §3.5/02 §4.2）+ 合并步 fast-forward 落地键
-   * （「目标提交 <12hex>」r3 §3.9 面板同族）。 */
   commit: external_exports.string().optional(),
-  /** AI 审核步 findings（M7 #330，r8 §3.1）：仅 review 步携带，daemon 解析
-   * agent 终轮 JSON 输出后置入；server 落库 + 判 blocking 触发自动修订。
-   * 形状 = records/review.ts reviewVerdictSchema（conclusion + findings[]）。 */
   findings: reviewVerdictSchema.optional(),
-  /** AI 审核步 verdict 提取失败原因（#700 B-C13）：review 步 daemon 未能从
-   * transcript 取出合法 verdict 时随 done 携带（findings 缺位；两字段互斥，
-   * 同现 = 新 daemon 对旧 server 的无害冗余，findings 优先）。server 据此
-   * 把 verdict 消息兜底拆成两态：「判定提取失败」+ extractionError 原因上
-   * 浮（web 审核面可分辨提取器失败），两字段皆缺（旧 daemon 无信号）才落
-   * 「审核未返回结论」。非 review 步不携带。长度上限 = schema 面第二道闸
-   * （daemon 侧已截断，防 bug daemon 单条打爆 DB）。 */
   findingsError: external_exports.string().max(FINDINGS_ERROR_CHAR_LIMIT).optional(),
-  /** PR 回填（#704 / B-C16，Multica link-back 只读方向）：github 形态步收尾
-   * 时 daemon 只读探测 conv 分支上的 PR（机器 gh / per-step token / 匿名三
-   * 梯，单次有界），探测命中才携带——无 PR / 探测失败 = 缺席（面板分支名在、
-   * PR 槽留空，不造数据、不重试）。server 落 build.prUrl/prNumber 并发布。 */
   prUrl: external_exports.string().optional(),
   prNumber: external_exports.number().int().optional(),
-  /** 变更投影上报（#704 失败方式 5：非 hosted 形态投影真值源 = daemon 步
-   * 收尾上报）：conv 分支相对 origin/<default> 的 unified diff 原文。daemon
-   * 侧受 CHANGES_DIFF_MAX_BYTES 上限（超限缺席——投影回落空集而非半截假象）；
-   * server parseUnifiedDiff 解析后落 build.changes 列，readBuildChanges 非
-   * hosted 分支消费。hosted 形态真值源仍是 server bare repo，daemon 不上报
-   * （双真值源漂移面不引入）。 */
   changesDiff: external_exports.string().optional(),
-  /** 验证步 verdict（#1250 / ADR 0018 层 1）：仅 verify 步携带，daemon 解析
-   *  agent 终轮 JSON 输出后置入；server 落 VERIFY_VERDICT_KIND 消息行。
-   *  形状 = records/verify.ts verifyVerdictSchema（passed + conclusion +
-   *  evidence[]）。非 verify 步不携带（findings 的 review 律——解析面按步类
-   *  开，规避假阳）。 */
   verifyVerdict: verifyVerdictSchema.optional(),
-  /** 验证步 verdict 提取失败原因（#1250，findingsError 同律）：verify 步
-   *  daemon 未能从 transcript 取出合法 verdict 时随 done 携带（verifyVerdict
-   *  缺位）。server 据此落「验证判定提取失败」兜底消息，不静默吞错。长度
-   *  上限同 findingsError（schema 面第二道闸）。 */
   verifyVerdictError: external_exports.string().max(FINDINGS_ERROR_CHAR_LIMIT).optional(),
-  /** #1261 配额熔断信号：daemon 识别 quota/capacity（分类单源 =
-   * shared/task-failure.ts）后随 done 携带——server 据此挂起「等额度」
-   * （step waiting_quota + 通知 + 探测续跑），而非走 failed 漏斗判死。
-   * status 仍为 'failed'（旧 server zod strip 掉本字段 = 普通失败收尾，
-   * 混版本零破坏；同 findingsError 的无害冗余律）。空流/非配额错误不携带
-   * （分类面不猜——不可见即污染可观测性）。 */
   quotaBlock: quotaBlockSchema.optional(),
-  /** #1493 无输出信号：status=success 但本步 transcript 没有任何 assistant
-   *  消息时 daemon 携带 true。server 的「0 token 静默失败」判定要求它在位——
-   *  pi 对不回 usage 的 relay 也报 0 token 行，单看 usage 会误判。旧 daemon
-   *  缺席 = 不判（zod strip / 缺省，混版本零破坏）。 */
   noOutput: external_exports.literal(true).optional(),
-  /** #1186 实际注入名集：daemon 在 scan + 字节预算之后随 done 携带
-   * （injected / omitted / unrendered）。旧 daemon 缺席 = server 不落断言
-   * （zod strip，混版本零破坏）。不是 step.skillInjection：那一列是 claim
-   * 期的选择 hits，预算截断之后的名字只在这里。 */
   skillInjectionFacts: skillInjectionFactsSchema.optional(),
   report: external_exports.string().max(INFO_REPORT_MAX_BYTES).optional()
 });
@@ -54658,7 +54345,6 @@ var claudeMcpConfigSchema = external_exports.object({
 });
 var CLAUDE_CONFIG_FILE_NAME = ".claude.json";
 var MCP_TOOL_REGISTRY = [
-  // —— 读 11 组（02 §7.2）——
   { grant: "Todos", name: "todos", kind: "read" },
   { grant: "Projects", name: "projects", kind: "read" },
   { grant: "Conversation", name: "conversation", kind: "read" },
@@ -54670,7 +54356,6 @@ var MCP_TOOL_REGISTRY = [
   { grant: "Issues", name: "issues", kind: "read" },
   { grant: "Pull Requests", name: "pull_requests", kind: "read" },
   { grant: "Workflow Runs", name: "workflow_runs", kind: "read" },
-  // —— 写 13 项（02 §7.2）——
   { grant: "Create Todo", name: "create_todo", kind: "write" },
   { grant: "Update Todo", name: "update_todo", kind: "write" },
   { grant: "Message Todo", name: "message_todo", kind: "write" },
@@ -54690,14 +54375,10 @@ var MCP_REGISTRY_BY_NAME = new Map(MCP_TOOL_REGISTRY.map((t) => [t.name, t]));
 // ../../packages/shared/src/records/permission-rules.ts
 var permissionActionSchema = external_exports.enum(["allow", "ask", "reject"]);
 var permissionRuleSchema = external_exports.object({
-  /** 稳定 id（审计口径：日志行与拒绝文案引用它）。 */
   id: external_exports.string().min(1),
-  /** 工具名（pi 面小写 `bash` / SDK 面 `Bash` 等均可写；`*` = 全工具）。 */
   tool: external_exports.string().min(1),
-  /** 参数槽 glob（bash 面即 `{command: '<glob>'}`；缺省 = 全匹配）。 */
   matches: external_exports.record(external_exports.string(), external_exports.string()).optional(),
   action: permissionActionSchema,
-  /** 给人看的一句话（为什么拦/放）。 */
   description: external_exports.string().optional()
 });
 function matchGlob(pattern, value) {
@@ -58210,22 +57891,12 @@ var daemonConfigSchema = external_exports.object({
   serverUrl: external_exports.string(),
   apiKey: external_exports.string().optional(),
   teamId: external_exports.string().optional(),
-  /** --name 默认 hostname（r3 §1.1）。 */
   name: external_exports.string(),
-  /** CAIRN_HOME 默认 ~/.cairn（02 §5.3 布局根；r3 §1.1 实测原名 TDS_HOME）。 */
   home: external_exports.string(),
-  /** 持久工作区根（02 §5.5 baseRepo/任务目录的父层）。 */
   workspacesDir: external_exports.string(),
   foreground: external_exports.boolean(),
-  /** skills 扫描根（spec 14/#371）：CAIRN_SKILLS_DIR 缺省 ~/.agents/skills；
-   * 目录不存在 = 空 skills 集，非致命（扫描层降级，config 不校验存在性）。 */
   skillsDir: external_exports.string(),
-  /** 本机 MCP config（spec 13/#368）：claim slug 列表在此解析成执行端点。
-   * 默认 ~/.claude.json；CAIRN_MCP_CONFIG 覆盖。执行机各读各机——stdio
-   * 命令在真正的执行机上起，密钥值从不跨 wire。 */
   mcpConfigPath: external_exports.string(),
-  /** #1149 环境钩子超时 ms（缺省 WORKSPACE_HOOK_TIMEOUT_MS 20min；
-   * CAIRN_HOOK_TIMEOUT_MS 覆写，非正整数 = 忽略用缺省）。 */
   hookTimeoutMs: external_exports.number().int().positive()
 });
 var DEFAULT_SERVER_URL = "http://127.0.0.1:8787";
@@ -58262,7 +57933,6 @@ function loadDaemonConfig(input2 = {}, env = process.env) {
     workspacesDir,
     foreground: input2.foreground ?? false,
     skillsDir,
-    // Settings 缝优先级同律：显式入参 > env > 默认（~/.claude.json）。
     mcpConfigPath: resolve(
       input2.mcpConfigPath ?? env[ENV_VARS.mcpConfig] ?? join(homedir(), CLAUDE_CONFIG_FILE_NAME)
     ),
@@ -61743,6 +61413,11 @@ var TerminalHandle = class _TerminalHandle {
   }
 };
 
+// src/version.ts
+import { createRequire as createManifestRequire } from "node:module";
+var requireManifest = createManifestRequire(import.meta.url);
+var DAEMON_VERSION = requireManifest("../package.json").version;
+
 // src/backend/acp.ts
 var GEMINI_CAPABILITIES = {
   name: "gemini",
@@ -61911,7 +61586,7 @@ var GeminiBackend = class {
       await connection.agent.request(methods.agent.initialize, {
         protocolVersion: PROTOCOL_VERSION,
         clientCapabilities: { fs: { readTextFile: false, writeTextFile: false }, session: {} },
-        clientInfo: { name: "cairn", version: "0.2.0" }
+        clientInfo: { name: "cairn", version: DAEMON_VERSION }
       });
       const response = resumeId ? await connection.agent.request(methods.agent.session.load, {
         sessionId: resumeId,
@@ -99039,8 +98714,6 @@ function createSkillReadGate(denied, log) {
   };
   return {
     check: check2,
-    // pi read.js 的 operations 是整体替换（`options.operations ?? default`），
-    // 三件必须齐——detectImageMimeType 透传 pi 原实现，图片读取面零扰动。
     operations: {
       readFile: async (absolutePath) => {
         await guard(absolutePath);
@@ -99060,7 +98733,6 @@ var CLAUDE_CODE_CAPABILITIES = {
   name: "claude-code",
   thinkingLevels: ["low", "medium", "high", "xhigh", "max"],
   oauthProviders: [],
-  // 认证机器本地（A4），无 oauth 订阅面
   compaction: true,
   sessionResume: true
 };
@@ -99293,8 +98965,6 @@ var ClaudeSessionHandle = class {
     this.events = this.queue.iterable();
     void this.pump();
   }
-  /** SDKMessage 泵 → 映射 → 事件面。终局事件（done/error/message_stop）收
-   *  事件面；生成器耗尽（输入流关后 query 自然收尾）= 无终局兜底收面。 */
   async pump() {
     try {
       for await (const msg of this.q) {
@@ -99324,9 +98994,6 @@ var ClaudeSessionHandle = class {
     this.queue.end();
     if (!this.abort.signal.aborted) this.abort.abort();
   }
-  /** steer = 流输入队列（下轮消费）+ steer 事件（A8：与 pi 中途注入语义有
-   *  已知差异，文档化不抹平；interrupt 归 T2）。images = #730 随话交付的
-   *  图片（内联 image content block 同 prompt 面机制）。 */
   async steer(text, images) {
     this.input.push(buildUserMessage(text, images));
     this.queue.push({ type: "steer", text });
@@ -99363,8 +99030,6 @@ function textBlock(text) {
 function toImageBlock(img) {
   return {
     type: "image",
-    // mimeType 恒在四值联合内（resolver inlineMime 收口）——cast = 类型面
-    // 与运行时保证的对齐，不是放宽。
     source: { type: "base64", media_type: img.mimeType, data: img.data }
   };
 }
@@ -99611,7 +99276,6 @@ function buildClaudeSdkOptions(parts) {
     permissionMode: "bypassPermissions",
     disallowedTools: parts.disallowedTools,
     includePartialMessages: true,
-    // text_delta/thinking_delta 增量面
     settingSources: [...CLAUDE_SETTING_SOURCES],
     ...mcpSection,
     ...parts.effort !== void 0 ? { effort: parts.effort } : {},
@@ -99625,10 +99289,7 @@ function buildClaudeSdkOptions(parts) {
     ...parts.resumeId !== null ? { resume: parts.resumeId } : { sessionId: parts.sessionId },
     ...parts.skillDenyRules !== void 0 && parts.skillDenyRules.length > 0 ? { settings: { permissions: { deny: [...parts.skillDenyRules] } } } : {},
     ...parts.executablePath !== void 0 ? { pathToClaudeCodeExecutable: parts.executablePath } : {},
-    // #1148：SDK env 是**整替**语义（不与 process.env 合并）——必须先展开
-    // process.env 保 PATH/HOME/ANTHROPIC_* 等继承位，per-step 值最后覆盖。
     ...parts.env !== void 0 ? { env: { ...process.env, ...parts.env } } : {},
-    // #1171：原生插件通道（团队技能 → CLI Skill 发现面）。空/缺省 = 键不发。
     ...parts.plugins !== void 0 && parts.plugins.length > 0 ? { plugins: parts.plugins } : {},
     abortController: parts.abortController
   };
@@ -99639,11 +99300,6 @@ var ClaudeCodeBackend = class {
   }
   opts;
   capabilities = CLAUDE_CODE_CAPABILITIES;
-  /** 简报文件通道（#958）：SDK 只在 `settingSources` 含 `'project'` 时读
-   * worktree 的 CLAUDE.md。#917 起该选项由 buildClaudeSdkOptions 显式钉成
-   * CLAUDE_SETTING_SOURCES（含 'project'）——承重位从「依赖 SDK 缺省」变成
-   * 「产品声明 + 单测钉值」；改动那份列表前先重验简报存活（spec 24 §通道漂移）。
-   * AGENTS.md 一概不读。 */
   brief = {
     backendId: "claude-code",
     composeBody: (opts, base) => appendSkillsCatalog(
@@ -99672,7 +99328,6 @@ var ClaudeCodeBackend = class {
       mcpServers[HOST_MCP_SERVER_NAME] = M8e({
         name: HOST_MCP_SERVER_NAME,
         alwaysLoad: true,
-        // 50 件 chief 词表必须全量进 prompt（不defer 给工具搜索）
         tools: hostTools
       });
     }
@@ -99713,9 +99368,7 @@ var ClaudeCodeBackend = class {
       ...append !== void 0 ? { append } : {},
       skillDenyRules,
       ...this.opts.executablePath !== void 0 ? { executablePath: this.opts.executablePath } : {},
-      // #1148 步级 env（worker 步端口基座）→ SDK 子进程环境（整替 + 展开）。
       ...opts.env !== void 0 ? { env: opts.env } : {},
-      // #1171 原生插件通道（null = 通道关，键不发）。
       ...nativePluginDir !== null ? { plugins: [{ type: "local", path: nativePluginDir }] } : {},
       abortController: abort
     });
@@ -100142,11 +99795,8 @@ function daemonSettingsManager() {
 function piUnattendedEnvPins(env) {
   const pins = {
     PI_OFFLINE: "1",
-    // 模型目录网络刷新关闭（self-host 确定性；pi docs/sdk.md）
     PI_TELEMETRY: "0",
-    // 安装遥测 + provider attribution 头（D2）
     PI_SKIP_VERSION_CHECK: "1",
-    // pi.dev latest-version 请求（子进程继承面同钉）
     PI_CACHE_RETENTION: resolvePiCacheRetention(env)
   };
   for (const key of Object.keys(pins)) {
@@ -100455,12 +100105,6 @@ function mapPiSessionEvent(event, state) {
       return [{ type: "auto_retry_start", attempt: event.attempt ?? 1 }];
     case "auto_retry_end":
       return [{ type: "auto_retry_end", attempt: event.attempt ?? 1 }];
-    // 收敛判定（#926）：agent_settled 是「pi 不会再自动继续」的权威信号
-    // （docs/sdk.md §Subscribing）。agent_end 只标记一次低层 run 结束，其后仍可能
-    // 有排队工作 / 溢出恢复继续（_handlePostAgentRun → agent.continue），故 agent_end
-    // 一律不发 done——旧 agent_end(!willRetry) 推断只覆盖错误重试一条继续路径，
-    // 会在排队工作继续时提前发 done 并 dispose 会话（时序赌博）。done 携 state 累积
-    // usage（agent_settled 在所有 message_end 之后，usage 比 agent_end 时刻更完整）。
     case "agent_settled": {
       const usage = [...state.usage.values()];
       return [{ type: "done", usage }];
@@ -100541,11 +100185,6 @@ var PiSessionHandle = class {
   state;
   closed = false;
   stopping = false;
-  /** 收尾：先发 session_shutdown（pi 唯一公开的扩展收尾缝——AgentSession
-   * Runtime.dispose 同形做法），MCP 扩展在 handler 里关连接（stdio 子进程/
-   * HTTP 流）；随后 dispose。单会话的 dispose() **不发**该事件（1.0.4 源读
-   * + 2026-10-08 探针实测：不发则 MCP stdio 子进程泄漏——daemon 长活进程
-   * 每步漏一个）。发射失败 fail-open（dispose 兜底清理）。 */
   finish() {
     if (this.closed) return;
     this.closed = true;
@@ -100570,11 +100209,6 @@ var PiSessionHandle = class {
     }
     this.queue.push({ type: "steer", text });
   }
-  /** 后端内部错误上浮面（#698）：prompt() 预检拒绝（auth 校验 / compaction
-   * 守卫 / input handler 拒绝）在 agent run 之前 throw——无事件无终局，原先
-   * 被吞掉会把 runner 挂到流超时看门狗（报看门狗不报真凶）。经此注入事件
-   * 面：推 error 事件并收面。幂等：已收面（done 已到）则事件被队列丢弃、
-   * finish 重入无副作用。 */
   emitBackendError(message) {
     this.queue.push({ type: "error", error: { message, retryable: false } });
     this.finish();
@@ -100600,10 +100234,6 @@ var PiBackend = class {
   }
   opts;
   capabilities = PI_CAPABILITIES;
-  /** 简报文件通道（#958）：pi 的 resource-loader 原生就读 cwd 的上下文文件
-   * （候选序 `AGENTS.override.md > AGENTS.md > AGENTS.MD > CLAUDE.md > CLAUDE.MD`，
-   * first-wins），且 `systemPromptOverride` 只替换 customPrompt、不抑制这条加载。
-   * 故简报写进那个文件即被引擎读到，无需任何后端侧改动。 */
   brief = {
     backendId: "pi",
     composeBody: (opts, base) => appendSkillsCatalog(
@@ -100631,8 +100261,6 @@ var PiBackend = class {
     }
     return this.open(opts, file2);
   }
-  /** #654 协议 400 自适配（AgentBackend 可选面；纯函数转发——学习态在模块
-   * 级 Map，open() 物化时消费）。 */
   adaptProviderCompat(provider, errorMessage) {
     return adaptProviderCompat(provider, errorMessage);
   }
@@ -100702,15 +100330,8 @@ var PiBackend = class {
       cwd: opts.cwd,
       agentDir: this.opts.agentDir,
       settingsManager,
-      // pi 原生发现关断（#917，spec 14 §技能可见面收归 3）：loader 自注入的
-      // `<available_skills>` 段（agentDir/skills 与 .pi/skills 默认目录）与
-      // cairn catalog 构成重复清单，且不受 agent.skills 白名单约束。关断后
-      // 技能目录只剩简报文件通道一份。`noContextFiles` / `agentsFilesOverride`
-      // 是 AGENTS.md 简报的承重位（spec 24 §通道漂移），一概不动。
       noSkills: true,
       ...opts.systemPrompt !== void 0 ? { systemPromptOverride: () => opts.systemPrompt } : {},
-      // #929/#930 挂点：闸 + MCP 注册 + pi 自家 MCP 连接器（loadConfig 钉空
-      // = 不读 agentDir / project 的 mcp.json，端点唯一来源是本机 config 解析）。
       extensionFactories: [
         gateExtension,
         mcpRegisterExtension,
@@ -100724,7 +100345,6 @@ var PiBackend = class {
         name: def.name,
         label: def.label ?? def.name,
         description: def.description,
-        // parameters = JSON Schema（typebox 产物 wire 形，protocol/chief-tools.ts）。
         parameters: def.parameters ?? { type: "object", properties: {} },
         execute: async (_id, params) => {
           try {
@@ -100789,10 +100409,6 @@ var PiBackend = class {
       resourceLoader: loader,
       sessionManager,
       settingsManager,
-      // 工具面（#930）：已知名走 sessionToolNames（MCP 名连接后才存在，
-      // 传 []）；有 MCP 端点时附允许清单 pattern——tools 是持续过滤器，不带
-      // mcp__ 条目会把 direct MCP 工具与资源工具藏掉（agent-session
-      // allowedToolNames 语义），带上即由 MCP 扩展连接后激活直报。
       tools: [
         ...sessionToolNames({
           readOnly: opts.readOnly === true,
@@ -100858,9 +100474,6 @@ function materializeProvider(modelsPath, provider) {
       id: m.id,
       name: m.name,
       ...CUSTOM_MODEL_DEFAULTS,
-      // 成本声明位（#927）：server 下发的价格（USD / 1M tokens）覆盖零默认
-      // ——pi calculateCost 据此算 per-message cost。未声明维持零价（诚实 0，
-      // 宿主不造价格表）。
       ...m.cost !== void 0 ? { cost: m.cost } : {},
       ...m.contextWindow !== void 0 ? { contextWindow: m.contextWindow } : {},
       ...m.maxTokens !== void 0 ? { maxTokens: m.maxTokens } : {},
@@ -100979,8 +100592,6 @@ function readClaudeCodeReport(homeDir = homedir5(), extra = {}) {
     installed: source.installed,
     hostname: source.hostname,
     models: source.models,
-    // bin 三态原样透出（#1050）：对象 = 探到了；null = 探过了没有；键缺席
-    // 只在调用方没探时出现——三种在页面上的渲染各不相同，不合并。
     ...extra.bin !== void 0 ? { bin: extra.bin } : {},
     ...extra.auth ? { auth: toWireAuth(extra.auth) } : {}
   };
@@ -101026,8 +100637,6 @@ var StepJournal = class {
       return null;
     }
   }
-  /** claimed/running/awaiting-upload = pending（recover 面，r3 §1.5
-   * `[recover] no pending steps found` 的对偶）。 */
   pending() {
     if (!existsSync6(this.dir)) return [];
     return readdirSync3(this.dir).filter((f) => f.startsWith("step-") && f.endsWith(".json")).map((f) => {
@@ -101209,7 +100818,6 @@ var MachineClient = class {
     const raw = await res.json();
     return opts.parse ? opts.parse(raw) : raw;
   }
-  // —— enroll（02 §5.2 路径二：apiKey Bearer）———————————————————————————————
   async enroll(body) {
     const { apiKey, ...rest } = body;
     return this.request("POST", "/api/machine/enroll", {
@@ -101230,7 +100838,6 @@ var MachineClient = class {
       parse: (raw) => machineEnrollPollResponseSchema.parse(raw)
     });
   }
-  // —— 机器面（token Bearer）———————————————————————————————————————————————
   async me() {
     return this.request("GET", "/api/machine/me", {
       parse: (raw) => machineRecordSchema.parse(raw)
@@ -101248,9 +100855,6 @@ var MachineClient = class {
       parse: (raw) => machineRecoverResponseSchema.parse(raw)
     });
   }
-  /** claim 长轮询（server hold ~75s，r3 §1.5）；调用方给 signal 控制中断。
-   * #1148：body 携 maxWorkers（worker 并发上限自报，server 闸取 min）；缺
-   * 省 = 空 body（老 server 形）。 */
   async claim(signal, body) {
     const res = await this.request(
       "POST",
@@ -101306,9 +100910,6 @@ var MachineClient = class {
       parse: (raw) => machineOkResponseSchema.parse(raw)
     });
   }
-  /** remoteTools relay（r5 §3.1 bundle `remoteTools.ts` 语义）：replaySafe 读工具
-   * 带重试预算 [500,2000]ms + 10s 超时；写工具（非 replaySafe）单次不重试。
-   * 服务端拒绝（4xx {error}）→ 抛错由上层转 pi 工具结果文本；成功 → text。 */
   async relayTool(stepId, name, params, opts = {}) {
     const replaySafe = opts.replaySafe ?? false;
     const delays = replaySafe ? [...REMOTE_TOOL_RETRY_DELAYS_MS] : [];
@@ -101349,11 +100950,6 @@ var MachineClient = class {
       parse: (raw) => machineTokenResponseSchema.parse(raw)
     });
   }
-  /** 问答阻塞通道（#1049）：循环到终态。每轮 = 一次 hold 长轮询（server ~70s
-   * 返回 pending 时重发同 requestId——幂等命中既有卡）；请求超时 = hold + 15s
-   * 余量（连接挂死不当成「server 说 pending」）；网络/5xx 无限重试（D3 的
-   * daemon 半边：等答期间任何瞬断都不终结等待），server 4xx 抛错。signal 是
-   * 唯一退出面（runner 停止/收线）。 */
   async askUser(stepId, body, opts = {}) {
     const HOLD_MS = 7e4;
     const REQUEST_TIMEOUT_MS = HOLD_MS + 15e3;
@@ -101432,8 +101028,6 @@ var MachineClient = class {
       } catch (err) {
         lastErr = err;
         if (err instanceof MachineApiError && err.status < 500) throw err;
-        if (err instanceof MachineApiError) {
-        }
       }
       const delay = delays[attempt];
       if (delay === void 0) break;
@@ -101447,9 +101041,6 @@ var MachineClient = class {
       parse: (raw) => machineUploadUrlsResponseSchema.parse(raw)
     });
   }
-  /** 预签名 PUT（绝对 URL；一次性）。机器 token 仅同源附带（预签名 URL 若
-   * 指向异源存储，不得外泄 Bearer [设计]）。body 双形：transcript.json =
-   * JSON；plan.md = 原文 text/markdown（02 §4.2 plan 即文件）。 */
   async putUpload(url2, headers, body, contentType) {
     const sameOrigin = new URL(url2).origin === new URL(this.opts.serverUrl).origin;
     const token = sameOrigin ? this.opts.getToken?.() : void 0;
@@ -101471,8 +101062,6 @@ var MachineClient = class {
       parse: (raw) => machineOkResponseSchema.parse(raw)
     });
   }
-  /** steer 拉取-确认（W3 #279）：GET /api/machine/steer?stepId=（[设计]
-   * MACHINE_WIRE_EXTENSIONS 登记位；本机在跑步单槽 pending）。 */
   async steer(stepId) {
     const res = await this.request(
       "GET",
@@ -101481,8 +101070,6 @@ var MachineClient = class {
     );
     return res.content;
   }
-  /** stop 拉取-确认（M7 #308）：GET /api/machine/stop?stepId=（[设计]
-   * MACHINE_WIRE_EXTENSIONS 登记位；本机在跑步单槽 pending，steer 同形）。 */
   async stop(stepId) {
     const res = await this.request(
       "GET",
@@ -101491,10 +101078,6 @@ var MachineClient = class {
     );
     return res.discard;
   }
-  /** sync 状态回写（M7 #319）：POST /api/machine/sync-result/{syncId} =
-   * machine-wire MACHINE_WIRE_EXTENSIONS 登记位；daemon 在 running 起步 +
-   * synced/failed 收尾两时刻回写，server 侧 transition 函数负责状态机守面 + 推
-   * team stream branch_sync 事件给 web 实时结果卡。 */
   async syncResult(syncId, body) {
     await this.request("POST", `/api/machine/sync-result/${syncId}`, {
       body,
@@ -101551,7 +101134,6 @@ var MachineClient = class {
     }
     throw lastErr instanceof Error ? lastErr : new Error("shell result writeback failed");
   }
-  /** wake SSE（02 §1.2 机器通道）：帧解析回调；连接断开自然返回。 */
   async stream(signal, onEvent, onConnected) {
     const token = this.opts.getToken?.();
     const res = await this.fetchImpl(this.url("/api/machine/stream"), {
@@ -101917,11 +101499,6 @@ function gitCredentialEnv(cred, parent = process.env) {
   }
   const target = credentialTarget(cred.url);
   return {
-    // 空值重置 credential.helper 列表（git 语义：空值清空此前累积的全部
-    // helper，含父环境条目与 URL 作用域条目里的）。缺此条则系统级/全局
-    // osxkeychain 等 helper 叠加在前：同主机命中陈旧凭证（上一步已撤销的
-    // token）致 auth 失败，且成功轮会回写钥匙串（凭证落盘面，破 02 §8 不落盘
-    // 纪律）。重置后本步内联 helper 是唯一来源。
     GIT_CONFIG_COUNT: String(target === null ? n + 1 : n + 2),
     [`GIT_CONFIG_KEY_${n}`]: "credential.helper",
     [`GIT_CONFIG_VALUE_${n}`]: "",
@@ -101933,7 +101510,6 @@ function gitCredentialEnv(cred, parent = process.env) {
       CAIRN_GIT_CRED_USERNAME: cred.username,
       CAIRN_GIT_CRED_PASSWORD: cred.password
     },
-    // 交互提示关闭（无 tty 场景挂起护栏）。
     GIT_TERMINAL_PROMPT: "0"
   };
 }
@@ -102008,8 +101584,6 @@ var gitPrim = {
       timeoutMs: NET_TIMEOUT_MS
     });
   },
-  /** 默认分支（origin/HEAD symbolic-ref；缺省回退 main——r3 §3.6 origin/main
-   * 正典值 [推断回退]）。 */
   async remoteDefaultBranch(repoDir) {
     const r = await runGit(["symbolic-ref", "--short", "refs/remotes/origin/HEAD"], {
       cwd: repoDir,
@@ -102028,8 +101602,6 @@ var gitPrim = {
     });
     return r.code === 0;
   },
-  /** origin remote URL（#1213/ADR 0017 选源对账用）；无 origin / git 失败 =
-   * null（调用方按失格回落处理，不抛）。只读 config，不触网络。 */
   async remoteUrl(dir) {
     const r = await runGit(["remote", "get-url", "origin"], {
       cwd: dir,
@@ -102039,9 +101611,6 @@ var gitPrim = {
     const url2 = r.stdout.trim();
     return url2 === "" ? null : url2;
   },
-  /** origin 的原始配置值（`remote.origin.url`，#1484）：不经 insteadOf 改写——
-   * `remote get-url` 返回改写后的 URL，与 cloneUrl 比较会误判偏离。无 origin /
-   * git 失败 = null。 */
   async originConfigUrl(dir) {
     const r = await runGit(["config", "--get", "remote.origin.url"], {
       cwd: dir,
@@ -102051,9 +101620,6 @@ var gitPrim = {
     const url2 = r.stdout.trim();
     return url2 === "" ? null : url2;
   },
-  /** git 仓判定（`rev-parse --git-dir` code 0；工作树仓与裸库同形——#1210
-   * 执行面 fail-loud 预检只问「能否作为 clone 源」，worktree-only 的收紧
-   * 属 server 创建闸 validateLocalRepoPath，不在执行面重判）。 */
   async isGitDir(dir) {
     const r = await runGit(["rev-parse", "--git-dir"], {
       cwd: dir,
@@ -102061,17 +101627,12 @@ var gitPrim = {
     });
     return r.code === 0;
   },
-  /** origin remote URL 重指（#1213/ADR 0017：本地源 clone 后把 origin 指回
-   * GitHub 真值，后续 fetch/push 照常走真值远端）。 */
   async setRemoteUrl(repoDir, url2) {
     await runGitOk(["remote", "set-url", "origin", "--", url2], {
       cwd: repoDir,
       timeoutMs: META_TIMEOUT_MS
     });
   },
-  /** `git remote set-head origin -a`（#1213/ADR 0017）：向真值远端查询其 HEAD
-   * 并重钉 origin/HEAD——clone 自本地源的 origin/HEAD 是**用户检出分支**，
-   * 默认分支判定会漂；本原语把 defaultBranch 真值源拉回远端。 */
   async remoteSetHeadAuto(repoDir, cred) {
     await runGitOk(["remote", "set-head", "origin", "--auto"], {
       cwd: repoDir,
@@ -102086,7 +101647,6 @@ var gitPrim = {
     });
     return r.code === 0;
   },
-  /** 远端领先本地的提交数（防分叉护栏数据面，02 §5.5）。 */
   async countRemoteAhead(repoDir, branch) {
     const local = await gitPrim.hasLocalBranch(repoDir, branch);
     const range = local ? `refs/heads/${branch}..refs/remotes/origin/${branch}` : "";
@@ -102134,20 +101694,10 @@ var gitPrim = {
     const r = await runGit(["branch", "--show-current"], { cwd: dir, timeoutMs: META_TIMEOUT_MS });
     return r.code === 0 && r.stdout.trim() !== "" ? r.stdout.trim() : null;
   },
-  /** `checkout [--force] <全限定 ref> --`（#1329）。git 2.43 的 checkout 不认
-   * `--end-of-options`（当 pathspec 吞掉、退 1）。全限定 ref + `--` 不会被当成选项
-   * 或路径。force 语义（与 sync.ts `force` 字段一致）：非 force 时 plain checkout，
-   * 拒绝覆盖脏跟踪文件——防止 sync 在 reset --hard 之前就把用户的未提交改动
-   * 吃掉（票 HIGH 数据丢失面）。force 时 checkout 强制覆盖（随后 clean -fd
-   * 仍丢弃未跟踪文件）。 */
   async checkout(dir, ref, force) {
     const args = force ? ["checkout", "--force", ref, "--"] : ["checkout", ref, "--"];
     await runGitOk(args, { cwd: dir, timeoutMs: META_TIMEOUT_MS });
   },
-  /** checkpoint 恢复（02 §5.5：`reset --hard`）。git 2.43 的 reset 开了
-   * PARSE_OPT_KEEP_DASHDASH，`--end-of-options` 留在 argv 里，verify_filename
-   * 见到 `-` 开头就退出 128（#1316）。rev-parse 认这个旗标，先把 commit 解成
-   * 对象 id，再 `reset --hard <oid>`。oid 只有十六进制，不会被 reset 当成选项。 */
   async resetHard(dir, commit) {
     const oid = await runGitOk(
       ["rev-parse", "--verify", "--end-of-options", `${commit}^{commit}`],
@@ -102164,9 +101714,6 @@ var gitPrim = {
   async addAll(dir) {
     await runGitOk(["add", "-A"], { cwd: dir, timeoutMs: META_TIMEOUT_MS });
   },
-  /** 暂存区里含指定**固定串**的文件，只在这些路径里找（#958 闸 5 的认标记扫描）。
-   * 限定路径集是有意的：全仓 grep 会拖慢每次提交，而候选名只有五个。无命中 =
-   * 空数组（`git grep` 的退出码 1 是「没匹配」，不是错）。 */
   async stagedPathsContaining(dir, needle, paths) {
     if (paths.length === 0) return [];
     const r = await runGit(["grep", "--cached", "-l", "-F", "-e", needle, "--", ...paths], {
@@ -102176,16 +101723,9 @@ var gitPrim = {
     if (r.code !== 0) return [];
     return r.stdout.split("\n").map((line) => line.trim()).filter((line) => line !== "");
   },
-  /** 把某个路径移出暂存区（#958 闸 5：认标记剔除时用）。`reset --` 会把索引项
-   * 还原到 HEAD——跟踪文件 = 本轮对它的改动不随本次提交走（既定取舍，见
-   * docs/spec/24 闸 4）；未跟踪文件 = 从索引里摘掉。 */
   async unstagePath(dir, path2) {
     await runGitOk(["reset", "-q", "--", path2], { cwd: dir, timeoutMs: META_TIMEOUT_MS });
   },
-  /** ref 里含指定**固定串**的文件，只在这些路径里找（#958 闸 4 的推送后检测）。
-   * 与 `stagedPathsContaining` 同一套限定理由：候选名只有五个，全仓 grep 不值。
-   * 输出形为 `<ref>:<path>`，此处剥掉 ref 前缀。无命中 = 空数组（`git grep`
-   * 的退出码 1 是「没匹配」，不是错）。 */
   async pathsContainingInRef(dir, ref, needle, paths) {
     if (paths.length === 0) return [];
     const r = await runGit(["grep", "-l", "-F", "-e", needle, ref, "--", ...paths], {
@@ -102198,7 +101738,6 @@ var gitPrim = {
       return sep7 === -1 ? line : line.slice(sep7 + 1);
     });
   },
-  /** commit；干净树（nothing to commit）= false 不抛。 */
   async commit(dir, message, identity) {
     const r = await runGit(["commit", "-m", message], {
       cwd: dir,
@@ -102225,21 +101764,12 @@ var gitPrim = {
       timeoutMs: NET_TIMEOUT_MS
     });
   },
-  /** annotated tag 创建（XMON-111 T1）：`git tag -a -m <msg> <tag> [commit]`；
-   * commit null = HEAD。tag 已存在 / 名字非法 = git 自拒 → 抛错携带拒绝原文
-   * （create_tag 工具原样返回 agent）。--end-of-options 挡 tag 名 `-` 开头
-   * 的选项注入面（push/reset 同律）。身份必传（同 commit 原语）：annotated
-   * tag 的 tagger ident 没有 git 兜底——无全局 user.name/user.email 的机器
-   * 上 `git tag -a` 直接挂 128（empty ident name）。 */
   async tagCreate(dir, tag, message, commit, identity) {
     await runGitOk(
       ["tag", "-a", "-m", message, "--end-of-options", tag, ...commit ? [commit] : []],
       { cwd: dir, env: commitEnv(identity), timeoutMs: META_TIMEOUT_MS }
     );
   },
-  /** `git push origin refs/tags/<tag>`（XMON-111 T1）：凭证注入同 push 原语
-   * （per-step token 只经 env credential.helper，不进 argv/磁盘）。远端已有
-   * 同名异值 tag = git 拒绝（永不 force）→ 抛错携带拒绝原文。 */
   async tagPush(dir, tag, cred) {
     await runGitOk(["push", "--end-of-options", "origin", `refs/tags/${tag}`], {
       cwd: dir,
@@ -102247,8 +101777,6 @@ var gitPrim = {
       timeoutMs: NET_TIMEOUT_MS
     });
   },
-  /** `git merge --no-edit origin/<defaultBranch>`（02 §5.5/r3 §3.6）；冲突 =
-   * 自动 `merge --abort` 后抛错（失败仅人工重跑，02/A6）。 */
   async mergeNoEdit(dir, ref) {
     const r = await runGit(["merge", "--no-edit", "--end-of-options", ref], {
       cwd: dir,
@@ -102261,7 +101789,6 @@ var gitPrim = {
     }
     throw new Error(`git merge failed (${r.code}): ${r.stderr.trim() || r.stdout.trim()}`);
   },
-  /** conv 分支领先 origin/<default> 的提交数（hasChanges 判定面）。 */
   async countAhead(dir, defaultBranch) {
     const r = await runGit(["rev-list", "--count", `refs/remotes/origin/${defaultBranch}..HEAD`], {
       cwd: dir,
@@ -102271,13 +101798,6 @@ var gitPrim = {
     const n = Number.parseInt(r.stdout.trim(), 10);
     return Number.isNaN(n) ? 0 : n;
   },
-  /** 步窗口内有新提交的本地分支短名集（#1195 产物并集面：agent 自建分支
-   * 交付后 HEAD 切回会话分支时，收尾按 HEAD 计数恒 0——本原语把「base 之
-   * 外、tip 落在窗口内」的分支捞回来）。for-each-ref 按 tip 提交时刻降序，
-   * 出窗即断（其后全更早）；rev-list 调用数有上限（基座仓分支巨多时不烧
-   * 收尾预算）。提交时刻是秒粒度、与步起点墙钟同源同机——留 2s 边距吸收
-   * 秒内截断。base 不可解析 = rev-list 恒非零退 = 空集（fail-open，探测
-   * 是收尾附加面不阻断）。归属裁决（邻座 conv 分支排除）在调用方。 */
   async branchesWithNewCommits(dir, baseCommit, sinceMs) {
     const r = await runGit(
       [
@@ -102309,10 +101829,6 @@ var gitPrim = {
     }
     return found;
   },
-  /** conv 分支相对 origin/<default> 的 unified diff 原文（#704 非 hosted 形态
-   * 投影上报数据源；三-dot = merge-base 起算，server readBuildChanges 同语义）。
-   * 基座引用缺位（空仓/未 fetch）= 空串——投影按上报零改动处理，不抛错
-   * （探测是收尾附加面，不阻断步收尾）。 */
   async diffAgainstRemoteDefault(dir, defaultBranch) {
     const r = await runGit(["diff", `origin/${defaultBranch}...HEAD`], {
       cwd: dir,
@@ -102321,7 +101837,6 @@ var gitPrim = {
     if (r.code !== 0) return "";
     return r.stdout;
   },
-  /** 提交时刻（epoch ms；孤儿回收龄判定用 [设计]）。 */
   async commitTime(dir, commit) {
     const r = await runGit(["log", "-1", "--format=%ct", "--end-of-options", commit], {
       cwd: dir,
@@ -102632,8 +102147,6 @@ function segmentContent(seg) {
 var SegmentBuffer = class {
   kind = null;
   text = "";
-  /** 追加增量。kind 与当前段不同 → 先把当前段封出并返回（调用方负责落行），
-   *  再以新 kind 开段。返回 null = 本调用未触发封段（F1/F4）。 */
   append(kind, text) {
     if (text === "") return null;
     const sealed = this.kind !== null && this.kind !== kind ? this.seal() : null;
@@ -102641,8 +102154,6 @@ var SegmentBuffer = class {
     this.text += text;
     return sealed;
   }
-  /** 全文事件（thinking 块终全文）。同 kind = 权威替换（F5）；异 kind 先封
-   *  当前段（F2）再以全文开段。 */
   replace(kind, text) {
     if (text === "") return null;
     const sealed = this.kind !== null && this.kind !== kind ? this.seal() : null;
@@ -102650,7 +102161,6 @@ var SegmentBuffer = class {
     this.text = text;
     return sealed;
   }
-  /** 封出当前段（空段不派出，F4）；封后缓冲清空（F3）。 */
   seal() {
     if (this.kind === null || this.text === "") {
       this.kind = null;
@@ -102662,7 +102172,6 @@ var SegmentBuffer = class {
     this.text = "";
     return seg;
   }
-  /** 当前未封段（读用，不改状态）。 */
   current() {
     return this.kind === null || this.text === "" ? null : { kind: this.kind, text: this.text };
   }
@@ -102709,10 +102218,7 @@ function execCommand(command, cwd, timeoutMs) {
     let settled = false;
     const child = spawn5("bash", ["-lc", command], {
       cwd,
-      // 自建进程组：超时 kill(-pid) 才能覆盖 `cmd &` 后台子孙（POSIX 语义；
-      // daemon 只跑 macOS/Linux，supervisor detached 先例同族）。
       detached: true,
-      // stdin 关死：等输入的命令立即失败而不是挂满超时。
       stdio: ["ignore", "pipe", "pipe"],
       env: process.env
     });
@@ -103281,10 +102787,7 @@ async function runWorkspaceHook(input2) {
   let settled = false;
   const child = spawn6(path2, [], {
     cwd,
-    // 自建进程组：超时 kill(-pid) 覆盖 `cmd &` 后台子孙（POSIX 语义，
-    // shell-channel / supervisor detached 先例同族）。
     detached: true,
-    // stdin 关死：等输入的钩子立即失败而不是挂满超时。
     stdio: ["ignore", "pipe", "pipe"],
     env
   });
@@ -103365,7 +102868,6 @@ async function localSourceUsable(localPath, cloneUrl) {
   return { ok: true };
 }
 var WorkspaceManager = class {
-  /** projectLock(projectId)：同项目工作区操作串行化（02 §5.5 并发保护）。 */
   locks = /* @__PURE__ */ new Map();
   logger;
   orphanTtlMs;
@@ -103453,8 +102955,6 @@ var WorkspaceManager = class {
           await runNet(
             "clone",
             (cred) => withGitNetRetries(() => gitPrim.clone(input2.cloneUrl, baseRepoDir, cred)),
-            // 失败 clone 的残目录清场（同 local-path 失败路径；残目录会让 machine
-            // 路 clone 拒绝落地）。
             () => rmSync7(baseRepoDir, { recursive: true, force: true })
           );
         }
@@ -103550,15 +103050,6 @@ var WorkspaceManager = class {
     this.logger.workspace(`Readonly export (origin/${defaultBranch}, no git metadata)`);
     return false;
   }
-  /** #1149 环境钩子挂点（prepare 两出口各一次）：
-   * - setup（fresh 检出后）：失败/超时 = 步失败——WorkspaceHookError 直接
-   *   抛出（runner prepare catch → done failed），且**回滚 worktree**（刚
-   *   检出的树上没有 agent 工作，可安全清），使重试认领重新走 fresh→setup
-   *   而非 reused→resume 掩盖装机缺口。
-   * - resume（reused 复用时）：失败/超时非致命——warning 落 workspace 日志，
-   *   步继续；note（ok/timeout）仍随 PreparedWorkspace 投影进步日志。
-   * 钩子文件缺失 = 静默跳过（零日志零进程，无钩子仓行为与现状一致）。
-   * 同项目串行化由 projectLock 免费提供（两 conv 并发 setup 不互踩）。 */
   async runHookStage(cwd, name, credentials) {
     try {
       const note = await runWorkspaceHook({
@@ -103598,8 +103089,6 @@ var WorkspaceManager = class {
     const head = await gitPrim.head(cwd);
     return { committed, head };
   }
-  /** #958 闸 4 的检测半：ref 里是否带着简报标记。见 WorktreeOps 的接口注释——
-   *  这是检测不是预防，agent 自己提交的那条路径 daemon 拦不住。 */
   async briefMarkerInRef(cwd, ref) {
     return gitPrim.pathsContainingInRef(cwd, ref, BRIEF_MARKER_BEGIN, [
       ...BRIEF_RECONCILE_FILENAMES
@@ -103609,10 +103098,6 @@ var WorkspaceManager = class {
     if (isReadonlyExportDir(cwd)) throw new ReadOnlyWorkspaceError(cwd);
     await withGitNetRetries(() => gitPrim.push(cwd, branch, credentials));
   }
-  /** 合并步 conv 分支与默认分支的合并（02 §5.5/r3 §3.6）。local 形态的落地
-   * = conv 分支 push 回用户仓库（#1211：用户主检出的分支/工作树永不被
-   * cairn 触碰——本类所有 git 操作的作用域都限于基座 clone 与其 worktree，
-   * 从不对用户仓库目录执行 merge/branch 类写操作）。 */
   async mergeDefaultBranch(cwd, defaultBranch) {
     const output2 = await gitPrim.mergeNoEdit(cwd, `origin/${defaultBranch}`);
     return { output: output2 };
@@ -103623,17 +103108,12 @@ var WorkspaceManager = class {
   async countAhead(cwd, defaultBranch) {
     return gitPrim.countAhead(cwd, defaultBranch);
   }
-  /** HEAD 所在分支（#1195 收尾偏离检测面；detached / 查询失败 = null）。 */
   async currentBranch(cwd) {
     return gitPrim.currentBranch(cwd);
   }
-  /** 步窗口内有新提交的本地分支集（#1195 产物并集面；归属裁决在 runner）。 */
   async branchesWithNewCommits(cwd, baseCommit, sinceMs) {
     return gitPrim.branchesWithNewCommits(cwd, baseCommit, sinceMs);
   }
-  /** conv 分支 unified diff（#704 非 hosted 形态投影上报数据源）：
-   * `git diff origin/<default>...HEAD`——merge-base 到工作头的变更，与 server
-   * readBuildChanges 的 `${baseSha}...${headSha}` 同语义。 */
   async diffAgainstDefault(cwd, defaultBranch) {
     return gitPrim.diffAgainstRemoteDefault(cwd, defaultBranch);
   }
@@ -103642,9 +103122,6 @@ var WorkspaceManager = class {
     await gitPrim.cleanFd(cwd);
     this.logger.workspace("Worktree restored");
   }
-  /** 孤儿回收（r3 §1.4 cleanupOrphanWorktrees(ttlMs = 7*24h)）：conv 形状
-   * 目录、非活步（journal pending 面）、龄超 TTL → 陈旧清理三步。龄 =
-   * 目录 mtime 与最后提交时刻取新 [设计]（未采观测值）。 */
   async cleanupOrphans(input2) {
     const ttlMs = input2.ttlMs > 0 ? input2.ttlMs : this.orphanTtlMs;
     const active = new Set(input2.activeConversationIds);
@@ -103682,7 +103159,6 @@ var WorkspaceManager = class {
     }
     return removed;
   }
-  /** 单工作区陈旧清理（remove --force + prune + branch -D，02 §5.5）。 */
   async removeStale(convDir) {
     const branch = await gitPrim.currentBranch(convDir);
     const commonDir = await gitPrim.commonGitDir(convDir);
@@ -103937,13 +103413,7 @@ async function runClaimedStep(deps, claimed, opts, heartbeat, stop, provenance)
   const isReview = claimed.step.kind === "review";
   const isVerify = claimed.step.kind === "verify";
   const reviewGate = (isReview ? parseReviewPromptMeta(claimed.instruction ?? null)?.gate : void 0) ?? "confirm";
-  const basePrompt = opts.resume?.prompt ?? (isChief || isReview || isVerify ? claimed.instruction ?? "" : claimed.session.action === "continue" && claimed.session.sessionId ? (
-    // #703 续轮指令投递：claim 载荷 instruction 在位（补写轮 #113 /
-    // 驳回重规划 r5 §4 / 失败重启反馈）→ 真的进会话——此前一律发
-    // CONTINUE_PROMPTS 占位句，补写轮拿不到「写 plan.md」指令（B-C10
-    // 两轮全空同源）。缺省回落词表（合并轮/确认后执行轮等无指令续轮）。
-    claimed.instruction ?? CONTINUE_PROMPTS[claimed.step.kind]
-  ) : buildTaskPrompt(claimed));
+  const basePrompt = opts.resume?.prompt ?? (isChief || isReview || isVerify ? claimed.instruction ?? "" : claimed.session.action === "continue" && claimed.session.sessionId ? claimed.instruction ?? CONTINUE_PROMPTS[claimed.step.kind] : buildTaskPrompt(claimed));
   const isInfoBuild = claimed.step.kind === "build" && claimed.todo?.output === "info";
   const readonlyWorkspace = !isChief && claimed.todo?.output === "info";
   const reportFile = join19(deps.paths.reportsDir, convId, REPORT_FILE_NAME);
@@ -104056,17 +103526,10 @@ async function runClaimedStep(deps, claimed, opts, heartbeat, stop, provenance)
         projectId: claimed.project?.id ?? "",
         conversationId: convId,
         cloneUrl: repo.cloneUrl,
-        // local 形态可达预检（#1210）：cloneUrl 是登记机路径，他机不可达
-        // 时 prepare 抛 LocalRepoUnreachableError（下方 catch 合成用户文案）。
         repoKind: repo.kind,
         workspacesRoot: deps.workspacesDir,
         credentials: creds.git,
-        // 双执行源（ADR 0017 / #1213）：github 形态加速位随 claim 载荷透传到
-        // workspace 物化处做选源；其余形态 null（现行为）。
         localPath: repo.kind === "github" ? repo.localPath ?? null : null,
-        // #1225 machine 凭据降级闸：github 形态开（per-step token auth 失败 →
-        // 执行机本机 git 凭据）；hosted 走 server per-step key 恒关、local 无
-        // 凭据面恒关。
         machineCredentialFallback: repo.kind === "github",
         ...readonlyWorkspace ? { readonly: true } : {}
       });
@@ -104218,8 +103681,6 @@ ${deliveryPrompt}`;
     provider,
     modelId: agent.modelId,
     ...agent.thinkingLevel ? { thinkingLevel: agent.thinkingLevel } : {},
-    // 简报通道在位（#958）= 简报落 worktree 上下文文件（见下方写盘点），
-    // systemPrompt 通道必须**清空**——两条通道同时开着，模型会看到两份重复清单。
     ...systemPrompt && backend.brief === void 0 ? { systemPrompt } : {},
     cwd,
     ...deliveryPrompt !== null ? { prompt: deliveryPrompt } : {},
@@ -104227,11 +103688,6 @@ ${deliveryPrompt}`;
     ...localToolDefs.length > 0 ? { localTools: localToolDefs } : {},
     ...remoteTools && remoteTools.length > 0 ? {
       remoteTools,
-      // relay 执行（r5 §3.1 bundle：execute → POST tool/<stepId> {name,params}
-      // → {text}；replaySafe 读工具带重试预算 + 10s 超时；ask_user 拦截
-      // 走专用问答通道（#1049，见上方 runAskChannel）——pi customTool 与
-      // claude-code in-process MCP 工具两消费面同径。client.askUser 缺席
-      // （单测桩）回落 relayTool 旧径。
       executeRemoteTool: (name, params) => {
         if (name === "ask_user" && client2.askUser) return runAskChannel(params);
         const def = remoteTools.find((t) => t.name === name);
@@ -104240,34 +103696,14 @@ ${deliveryPrompt}`;
         });
       }
     } : {},
-    // 三态透传（#1307）：claim 键在位（含 [] = 受管严格空）→ SessionOpts 键
-    // 在位透传（claude-code backend 据此上 strictMcpConfig 锁）；缺省不造键
-    // （继承态，两态不得在此塌缩——skillsAllowlist #1169 同律）。
     ...claimedMcp !== void 0 ? { mcpServers: mcpEndpoints } : {},
-    // 授权白名单（#372→#1169 拆字段正名）：worker/review 步 = claim 载荷
-    // agent.skillsAllowlist——数组（含 [] = 显式全拒，deny 规则吃它）原样透传；
-    // **null（不限制）与缺省（旧 server 未携带）都不传**（backend 面全量直通
-    // ——null 被误读成全拒即本票主修位，两态不在此塌缩）；chief 步不传
-    // （信任面全量 catalog）。过滤落点 = backend catalog 构建（backend/pi.ts）。
     ...isChief || agent.skillsAllowlist == null ? {} : { skillsAllowlist: agent.skillsAllowlist },
-    // #1106 派发技能注入选择 + #1169 defaultSkill 绑定序首位：claim 载荷
-    // agent.injectedSkills（server 按任务文本对授予集规则选出，ids ⊆
-    // skillsAllowlist）在位（含 []）= 目录注入按本集收窄；defaultSkill 非空
-    // 时排本集首位并去重（自动携带语义——#1116 注入排序面，不让位给 id 字典
-    // 序）；[] = 已计算零命中（零注入不是故障）。chief 步不携带；旧 server
-    // 未携带 injectedSkills = 不造集（目录注入回落 allowlist 全量，零回归）。
-    // deny 面（#917）不受重排影响——授权上限只看 skillsAllowlist。
     ...isChief || injectedForSession === void 0 ? {} : { injectedSkills: injectedForSession },
     onSkillsResolved: (names) => {
       skillInjection.facts = names;
     },
-    // 团队技能物化目录（XMON-112 S2）：backend 把它排在本机 skillsDir 之前
-    // 扫描（同名冲突团队条目胜，pi first-wins）；null = 纯本机（零回归）。
     ...teamSkillsDir !== null ? { teamSkillsDir } : {},
-    // 只读回合（#511）：审核者不下发 edit/write——写入在工具面即被拒，且它
-    // 对检出造成的任何写入在收尾被丢弃（见下「审核步收尾」）。
     ...isReview ? { readOnly: true } : {},
-    // #1148 步级 env（端口基座）：machine-loop 按槽位构造，跨缝透传 backend。
     ...opts.env !== void 0 || readonlyWorkspace ? { env: { ...opts.env, ...readonlyWorkspace ? READONLY_GIT_ENV : {} } } : {}
   };
   let continueId = claimed.session.action === "continue" ? opts.resume?.sessionId ?? claimed.session.sessionId : null;
@@ -105055,8 +104491,6 @@ ${hook.output.trimEnd()}${truncated}`;
           owner: ghRef.owner,
           repo: ghRef.repo,
           branch: head,
-          // per-step token（github_connection 下发时）；未连接 = null → 匿名梯
-          // （公开仓可达）。机器 gh 梯在前——agent 开 PR 用的就是它。
           token: creds.git?.password ?? null
         }).catch((err) => {
           logger.step(
@@ -105096,35 +104530,21 @@ ${hook.output.trimEnd()}${truncated}`;
   const sessionIdForDone = handle?.sessionId ?? continueId;
   const doneBody = {
     status,
-    // #1262：捕获侧剥 ANSI（SGR + OSC8）——工具输出（biome 等）的颜色码/
-    // 超链接转义不落 build.errorMessage（板面纯文本）；单源 = shared
-    // stripAnsiEscapes，web 渲染侧同函数兜底存量脏行。
     ...lastError !== null ? { errorMessage: stripAnsiEscapes(lastError) } : {},
     ...sessionIdForDone !== null ? { sessionId: sessionIdForDone } : {},
     usage: [...usage],
     hasChanges,
-    // per-step checkpoint（done 回传 commit：「恢复到此处」数据源 + 合并步
-    // fast-forward 落地键，r3 §3.5/§3.9 [设计]）。
     ...headCommit !== null ? { commit: headCommit } : {},
     ...reviewExtraction?.status === "ok" ? { findings: reviewExtraction.verdict } : {},
     ...reviewExtraction?.status === "failed" ? { findingsError: reviewExtraction.reason } : {},
     ...verifyExtraction?.status === "ok" ? { verifyVerdict: verifyExtraction.verdict } : {},
     ...verifyExtraction?.status === "failed" ? { verifyVerdictError: verifyExtraction.reason } : {},
-    // 交付面回填（#704）：探测命中才带（无 PR / 失败 = 缺席）；diff 上报
-    // 恒带算得值（含空串——「已上报且零改动」与「未上报」在 server 侧分列）。
     ...prProbe !== null ? { prUrl: prProbe.url, prNumber: prProbe.number } : {},
     ...changesDiff !== null ? { changesDiff } : {},
-    // #1195 工作分支偏离（检测到时恒带，与 hasChanges 无关）：server 产物闸
-    // 在 hasChanges=false 时据此把失败原因从误导性「构建零改动」换成点名
-    // 分支偏离。
     ...branchDrift !== null ? { workBranchDrift: branchDrift } : {},
-    // #1261 配额熔断信号（server 侧挂起等额度的判据；旧 server zod strip =
-    // 普通失败，混版本零破坏）。
     ...quotaBlock !== null ? { quotaBlock } : {},
     ...skillInjection.facts !== null ? { skillInjectionFacts: skillInjection.facts } : {},
     ...report !== null ? { report } : {},
-    // #1493 无输出信号：成功收尾但 transcript 零 assistant 消息（server「0 token
-    // 静默失败」判据的前提——单看 usage 会误判不回 usage 的 relay）。
     ...status === "success" && !messages.some((m) => m.role === "assistant") ? { noOutput: true } : {}
   };
   journal.update(stepId, {
@@ -105425,11 +104845,6 @@ async function resolveCheckoutRef(directory, ref) {
   }
 }
 
-// src/version.ts
-import { createRequire as createManifestRequire } from "node:module";
-var requireManifest = createManifestRequire(import.meta.url);
-var DAEMON_VERSION = requireManifest("../package.json").version;
-
 // src/machine-loop.ts
 var sleep = (ms2) => new Promise((r) => setTimeout(r, ms2));
 function nextBackoffMs(current, cap = CLAIM_BACKOFF_CAP_MS) {
@@ -105459,22 +104874,15 @@ async function runMachine(opts) {
   const backend = opts.backend ?? createPiBackend({
     agentDir: paths.agentRuntimeDir,
     sessionDir: paths.chatSessionsDir,
-    // skills 执行面注入（spec 14/#371）：skillsDir = CAIRN_SKILLS_DIR 扫描根；
-    // cwd = daemon home（project 级解析不随任务 worktree 切换跳变）。
     skills: { skillsDir: config2.skillsDir, cwd: config2.home },
     resolveSessionFile: (sid) => resolveSessionFile(paths, sid),
     onSession: (sid, file2) => {
       if (file2) recordSession(paths, sid, file2);
     },
-    // [mcp] 降级行（r3 §1.5 canon；02 §5.3 前缀词表 mcp 位）。
     onMcpLog: (msg) => logger.mcp(msg),
-    // [skills] 诊断行（spec 14/#371；前缀词表 skills 位）。
     onSkillsLog: (msg) => logger.skills(msg),
-    // [gate] 裁决行（#866 T5 命令闸；只记非放行裁决，allow 静默）。
     onGateLog: (msg) => logger.gate(msg),
-    // [trust] 裁决行（#925 D1：受保护资源在位的 denied 行，空 worktree 静默）。
     onTrustLog: (msg) => logger.trust(msg),
-    // 非 SSE 响应诊断文案的「哪台机器」位（#882；与 #867 同值来源）。
     machineName: config2.name
   });
   if (opts.backend === void 0) {
@@ -105519,18 +104927,10 @@ async function runMachine(opts) {
     }
     if (claudeBackend === null) {
       claudeBackend = createClaudeCodeBackend({
-        // skills 通道与 pi 同律（A9 复用 buildSkillsCatalog）。
         skills: { skillsDir: config2.skillsDir, cwd: config2.home },
         onSkillsLog: (msg) => logger.skills(msg),
-        // 缺凭据失败文案的「哪台机器」位（#867 T6；机器名 = 注册/上线序列里
-        // 那一个，与 machines 页显示同值）。
         machineName: config2.name,
-        // #1050 路径单源：探到的绝对路径钉给 SDK，免掉「探的二进制」与
-        // 「执行的二进制」不是一个（CAIRN_CLAUDE_BIN 此前只喂 auth 探针）。
         ...claudeBin !== null ? { executablePath: claudeBin.path } : {},
-        // #1171 原生插件通道两位：缓存分区单源（plugins/ 在 team-skills 缓存
-        // 根下）+ #1050 探测版本（下限闸输入；探测缺位 = 版本不可证 →
-        // fail-closed 跳过插件通道，catalog 兜底）。
         teamSkillsCacheDir: paths.teamSkillsCacheDir,
         ...claudeBin !== null ? { executableVersion: claudeBin.version } : {}
       });
@@ -105684,7 +105084,6 @@ async function runMachine(opts) {
           resume: { sessionId: entry.sessionId, prompt: entry.prompt },
           running: 1,
           ...entry.stopRequest != null ? { stopRequest: entry.stopRequest } : {},
-          // #1148 端口基座：续跑 worker 步照领槽（恢复面与主循环同律）。
           ...claimed.step.kind === "chief" ? {} : { env: workerEnv(stepRecord.id) }
         });
       } else {
@@ -105802,7 +105201,6 @@ async function runMachine(opts) {
       skillsDir: config2.skillsDir,
       sessionHandles,
       stops,
-      // #867 T6：runtime 步凭据预检（机器名进失败文案；探针缺省 = 真 CLI）。
       machineName: config2.name,
       claudeCodeAuthProbe: probeAuthAndRemember,
       ...opts.heartbeatIntervalMs !== void 0 ? { heartbeatIntervalMs: opts.heartbeatIntervalMs } : {}
@@ -105992,8 +105390,6 @@ async function runForeground(opts) {
     paths,
     logger,
     idleSleepPrevention: true,
-    // #1149：环境钩子超时（config 已解析 env/默认；machine-loop 注给
-    // WorkspaceManager）。
     hookTimeoutMs: config2.hookTimeoutMs
   });
   const onSignal = (signal) => {