tianshu-harness 3.23.0

package/dist/chunk-V5YIPMHV.js

@@ -0,0 +1,2353 @@
+#!/usr/bin/env -S node --expose-gc --max-old-space-size=4096
+import { createRequire as __rivetCreateRequire } from 'node:module'; const require = __rivetCreateRequire(import.meta.url);
+import {
+  buildConsolidatedBlock,
+  buildDynamicAppendixParts,
+  buildLatestTurnVolatileBlock,
+  buildStableVolatileBlock,
+  parseOptionalInt,
+  rangeContains,
+  renderPlanMethodologyAdvisory,
+  renderTaskDepthAdvisory,
+  runResumePreflightOai,
+  selectProjectInstructions
+} from "./chunk-SEPGEJNK.js";
+import {
+  isSystemReminder
+} from "./chunk-RWA23GMM.js";
+import {
+  skillRegistry
+} from "./chunk-OHSV42QB.js";
+import {
+  collapseToolResult,
+  estimateOaiTokens
+} from "./chunk-KIOXTQQL.js";
+import {
+  CACHE_ANCHOR_MESSAGES
+} from "./chunk-TPI73L57.js";
+import {
+  debugLog
+} from "./chunk-CI4R6P2B.js";
+import {
+  parseFrozenSnapshotData
+} from "./chunk-6S5FPUS7.js";
+import {
+  stableStringify
+} from "./chunk-QARAGUXX.js";
+import {
+  FROZEN_BLOCK_CAPS
+} from "./chunk-ER5JW2QZ.js";
+import {
+  init_esm_shims
+} from "./chunk-5GGOGLSN.js";
+
+// src/prompt/static.ts
+init_esm_shims();
+
+// src/prompt/static-subagent.ts
+init_esm_shims();
+var TOP_LEVEL_RE = /^<([a-z][a-z-]*)>\n([\s\S]*?)\n<\/\1>$/gm;
+var RULE_RE = /^ {2}<rule name="([^"]+)">\n([\s\S]*?)\n {2}<\/rule>$/gm;
+var HARNESS_PART_RE = /^ {2}<([a-z-]+)(?: name="([^"]+)")?>\n([\s\S]*?)\n {2}<\/\1>$/gm;
+function parsePrompt(src) {
+  const sections = [];
+  for (const m of src.matchAll(TOP_LEVEL_RE)) {
+    sections.push({ name: m[1], full: m[0], body: m[2] });
+  }
+  const rejoined = sections.map((s) => s.full).join("\n\n");
+  const trailer = src.slice(rejoined.length);
+  if (rejoined + trailer !== src || !/^\s*$/.test(trailer)) {
+    throw new Error(
+      `[static-subagent] top-level parse is lossy: parsed ${sections.length} sections covering ${rejoined.length} of ${src.length} chars. BASE_PROMPT shape changed.`
+    );
+  }
+  return { sections, trailer };
+}
+function splitRules(rulesBody) {
+  const out = [];
+  for (const m of rulesBody.matchAll(RULE_RE)) {
+    out.push({ name: m[1], full: m[0], body: m[2] });
+  }
+  if (out.length === 0) throw new Error("[static-subagent] no <rule> entries found in <rules>");
+  return out;
+}
+var DROP_SECTIONS = /* @__PURE__ */ new Set([
+  // 交付报告契约是对人类说话的；子代理的交付契约是 WorkerResult，两份同时在场冲突。
+  "delivery-contract",
+  // 探索→计划→执行→验证是主控的循环；子代理接的是已定边界的任务卡。
+  "workflow",
+  // 整段是"建议用户运行 /mirror china"。子代理没有面向用户的通道，
+  // /mirror 也是 TUI 斜杠命令而非工具——对它是不可执行的建议。
+  "downloads"
+]);
+var TOOL_GATED_SECTIONS = /* @__PURE__ */ new Map([
+  ["shared-worktree", (t) => t.has("deliver_task")],
+  ["git", (t) => t.has("git")],
+  ["delegation", (t) => t.has("delegate_task") || t.has("delegate_batch")]
+]);
+var DROP_RULES = /* @__PURE__ */ new Set([
+  // 整条写给主控：末句直接点名 "worker 输出的 HIGH/CRITICAL 标记不等于已验证事实"。
+  // 子代理是这条规则的对象，不是执行者。
+  "external-source-verification",
+  // 讲用户说 "P1"/"刚才那个" 时怎么回指上一轮回复。子代理不跟人对话，
+  // 收到的是自包含任务卡；它引用的 <intent-retrieval-route> 块是主控专有。
+  "context-intent-association",
+  // 规则描述的是 <git-status> 注入块，而子代理的冻结块里没有该块。
+  "git-context-first",
+  // 规则描述的全部是 appendixDelta 线格式（seq/覆盖/自闭合），
+  // 而 worker 的 PromptEngine 未开 delta，这套格式一次都不会遇到。见设计文档 §6.1。
+  "context-update-protocol"
+]);
+var WRITE_ONLY_RULES = /* @__PURE__ */ new Set([
+  // 逐字取原文的纪律只在改用户可见字符串时有意义。
+  "verbatim-user-facing-text"
+]);
+var WRITE_ONLY_HARNESS_PARTS = /* @__PURE__ */ new Set([
+  "red-green-bugfix",
+  "test-strategy-by-task",
+  "env-simulation",
+  // 清理临时探针的纪律：只读 worker 没有写工具，创建不了探针——对它是死条文。
+  // 保留判据（"主控只看到 diff 摘要，补救不了残留探针"）只在 worker 能写文件时成立。
+  "probe-discipline"
+]);
+var DROP_HARNESS_PARTS = /* @__PURE__ */ new Set([
+  // 子代理有硬 turn 预算和软着陆收尾，没有换视角深挖的余裕——这条会诱导它超预算乱跑。
+  "perspective-shift"
+]);
+var EVIDENCE_LINE_DROPS = [
+  { prefix: "  \u4F8B\u5916\uFF1A", writeOnly: false },
+  { prefix: "  \u8BCA\u65AD\u6096\u8BBA\uFF1A", writeOnly: true }
+];
+var IDENTITY_TOOLSET_CLAIM = "\u4F60\u62E5\u6709\u5B8C\u6574\u7684\u5F00\u53D1\u5DE5\u5177\u96C6\uFF1A\u6587\u4EF6\u8BFB\u5199\u3001\u4EE3\u7801\u641C\u7D22\u3001\u7EC8\u7AEF\u6267\u884C\u3001\u6D4B\u8BD5\u8FD0\u884C\u3001\u9879\u76EE\u5BFC\u822A\u3001\u4EFB\u52A1\u59D4\u6D3E\u3002";
+var TOOL_USAGE_LINE_GATES = [
+  { prefix: "\u6587\u4EF6\u64CD\u4F5C\u5DE5\u5177\u9009\u62E9\uFF1A", anyOf: ["edit_file", "write_file", "hash_edit", "apply_patch", "ast_edit"] },
+  { prefix: "- edit_file\uFF1A", anyOf: ["edit_file"] },
+  { prefix: "- write_file\uFF1A", anyOf: ["write_file"] },
+  { prefix: "- hash_edit\uFF1A", anyOf: ["hash_edit"] },
+  { prefix: "- apply_patch\uFF1A", anyOf: ["apply_patch"] },
+  { prefix: "- ast_edit\uFF1A", anyOf: ["ast_edit"] },
+  { prefix: "\u7981\u6B62\u7528 bash \u8BFB\u5199\u6587\u4EF6\u3002", anyOf: ["bash", "write_file", "hash_edit"] },
+  { prefix: "\u68C0\u7D22\u5DE5\u5177\u9009\u62E9\uFF1A", anyOf: ["grep", "ast_grep"] },
+  { prefix: "- grep\uFF1A", anyOf: ["grep"] },
+  { prefix: "- ast_grep\uFF1A", anyOf: ["ast_grep"] },
+  { prefix: "\u6D4F\u89C8\u5668\u4E0E\u684C\u9762\u81EA\u52A8\u5316\u5206\u5DE5\uFF1A", anyOf: ["web_fetch", "web_search", "browser_debug", "computer_use"] },
+  { prefix: "- web_fetch / web_search\uFF1A", anyOf: ["web_fetch", "web_search"] },
+  { prefix: "- browser_debug\uFF08", anyOf: ["browser_debug"] },
+  { prefix: "- computer_use\uFF1A", anyOf: ["computer_use"] },
+  // 「三者」= 上面三条 bullet；审批边界讲的是导航与逐应用授权，只对后两者成立。
+  { prefix: "- \u4E09\u8005\u52A8\u4F5C\u5747\u6709\u5BA1\u6279\u8FB9\u754C", anyOf: ["browser_debug", "computer_use"] },
+  { prefix: "\u5DE5\u4F5C\u533A\u5916\u8DEF\u5F84\uFF1A", anyOf: ["request_path_access"] },
+  // 前向引用 <delegation> 段——该段被门掉时这行会变成悬空指针。
+  { prefix: "\u59D4\u6D3E\u539F\u5219\uFF1A", anyOf: ["delegate_task", "delegate_batch"] }
+];
+var WRITE_CAPABLE_TOOLS = /* @__PURE__ */ new Set([
+  "edit_file",
+  "write_file",
+  "hash_edit",
+  "apply_patch",
+  "bash",
+  "run_tests",
+  "git"
+]);
+function derivePolicy(tools) {
+  const names = new Set(tools.map((t) => t.name));
+  return {
+    tools: names,
+    writeCapable: [...names].some((n) => WRITE_CAPABLE_TOOLS.has(n))
+  };
+}
+function trimEvidenceScope(rule, policy) {
+  const kept = rule.body.split("\n").filter((line) => {
+    const drop = EVIDENCE_LINE_DROPS.find((d) => line.startsWith(d.prefix));
+    if (!drop) return true;
+    return drop.writeOnly && policy.writeCapable;
+  });
+  return `  <rule name="${rule.name}">
+${kept.join("\n")}
+  </rule>`;
+}
+function trimTestHarness(rule, policy) {
+  const header = rule.body.split("\n\n")[0];
+  const kept = [];
+  for (const m of rule.body.matchAll(HARNESS_PART_RE)) {
+    const key = m[2] ?? m[1];
+    if (DROP_HARNESS_PARTS.has(key)) continue;
+    if (WRITE_ONLY_HARNESS_PARTS.has(key) && !policy.writeCapable) continue;
+    kept.push(m[0]);
+  }
+  if (kept.length === 0) return null;
+  return `  <rule name="${rule.name}">
+${header}
+
+${kept.join("\n\n")}
+  </rule>`;
+}
+function assertAnchorsResolve(lines, gates, where) {
+  for (const gate of gates) {
+    const hits = lines.filter((l) => l.startsWith(gate.prefix)).length;
+    if (hits !== 1) {
+      throw new Error(
+        `[static-subagent] <${where}> anchor "${gate.prefix}" matched ${hits} lines (expected 1). BASE_PROMPT changed \u2014 update TOOL_USAGE_LINE_GATES.`
+      );
+    }
+  }
+}
+function trimToolUsage(section, policy) {
+  const lines = section.body.split("\n");
+  assertAnchorsResolve(lines, TOOL_USAGE_LINE_GATES, section.name);
+  const kept = lines.filter((line) => {
+    const gate = TOOL_USAGE_LINE_GATES.find((g) => line.startsWith(g.prefix));
+    return !gate || gate.anyOf.some((t) => policy.tools.has(t));
+  });
+  if (kept.length === lines.length) return section.full;
+  return `<${section.name}>
+${kept.join("\n")}
+</${section.name}>`;
+}
+function trimIdentity(section) {
+  if (!section.body.includes(IDENTITY_TOOLSET_CLAIM)) {
+    throw new Error(
+      "[static-subagent] <identity> toolset-claim anchor not found. BASE_PROMPT changed \u2014 update IDENTITY_TOOLSET_CLAIM."
+    );
+  }
+  return `<${section.name}>
+${section.body.replace(IDENTITY_TOOLSET_CLAIM, "")}
+</${section.name}>`;
+}
+function composeRules(section, policy) {
+  const kept = [];
+  for (const rule of splitRules(section.body)) {
+    if (DROP_RULES.has(rule.name)) continue;
+    if (WRITE_ONLY_RULES.has(rule.name) && !policy.writeCapable) continue;
+    if (rule.name === "evidence-scope") {
+      kept.push(trimEvidenceScope(rule, policy));
+      continue;
+    }
+    if (rule.name === "test-harness") {
+      const harness = trimTestHarness(rule, policy);
+      if (harness) kept.push(harness);
+      continue;
+    }
+    kept.push(rule.full);
+  }
+  if (kept.length === 0) return null;
+  return `<rules>
+${kept.join("\n\n")}
+
+</rules>`;
+}
+function buildSubagentSystemPrompt(base, tools) {
+  const policy = derivePolicy(tools);
+  const { sections, trailer } = parsePrompt(base);
+  const out = [];
+  for (const section of sections) {
+    if (DROP_SECTIONS.has(section.name)) continue;
+    const gate = TOOL_GATED_SECTIONS.get(section.name);
+    if (gate && !gate(policy.tools)) continue;
+    if (section.name === "rules") {
+      const rules = composeRules(section, policy);
+      if (rules) out.push(rules);
+      continue;
+    }
+    if (section.name === "tool-usage") {
+      out.push(trimToolUsage(section, policy));
+      continue;
+    }
+    if (section.name === "identity") {
+      out.push(trimIdentity(section));
+      continue;
+    }
+    out.push(section.full);
+  }
+  return out.join("\n\n") + trailer;
+}
+
+// src/prompt/static.ts
+var BASE_PROMPT = `<identity>
+\u4F60\u5728\u300C\u5929\u67A2\u300D\u5317\u6597\u661F\u57DF\u8FD0\u884C\u65F6\u4E2D\u2014\u2014\u4E00\u4E2A\u8BA4\u77E5\u589E\u5F3A\u7684\u4EE3\u7801\u5F00\u53D1\u73AF\u5883\u3002\u4F60\u62E5\u6709\u5B8C\u6574\u7684\u5F00\u53D1\u5DE5\u5177\u96C6\uFF1A\u6587\u4EF6\u8BFB\u5199\u3001\u4EE3\u7801\u641C\u7D22\u3001\u7EC8\u7AEF\u6267\u884C\u3001\u6D4B\u8BD5\u8FD0\u884C\u3001\u9879\u76EE\u5BFC\u822A\u3001\u4EFB\u52A1\u59D4\u6D3E\u3002\u4F60\u7684\u4EFB\u52A1\u662F\u5728\u7406\u89E3\u7528\u6237\u610F\u56FE\u3001\u9879\u76EE\u4E0A\u4E0B\u6587\u4E0E\u5DE5\u7A0B\u7EA6\u675F\u7684\u57FA\u7840\u4E0A\uFF0C\u4E3B\u52A8\u8BBE\u8BA1\u66F4\u5408\u7406\u7684\u67B6\u6784\u3001\u53D1\u73B0\u9690\u85CF\u98CE\u9669\u3001\u4FEE\u590D\u6839\u56E0\u95EE\u9898\uFF0C\u5E76\u8F93\u51FA\u6E05\u6670\u3001\u7A33\u5B9A\u3001\u53EF\u7EF4\u62A4\u3001\u53EF\u6269\u5C55\u7684\u5B9E\u73B0\u65B9\u6848\u3002
+\u6838\u5FC3\u539F\u5219\uFF1A\u4E0D\u731C\uFF0C\u5148\u8BFB\u3002\u5206\u6790\u4EE3\u7801\u524D\u5148\u8BFB\u73B0\u6709\u4EE3\u7801\u7406\u89E3\u4E0A\u4E0B\u6587\uFF0C\u52A8\u624B\u524D\u505A\u63A2\u9488\u9A8C\u8BC1\u5047\u8BBE\u3002
+\u5F53\u88AB\u95EE\u5230"\u4F60\u662F\u4EC0\u4E48"\u65F6\u2014\u2014\u4F60\u6765\u81EA\u5929\u67A2\u661F\u57DF\uFF0C\u5F53\u524D\u5728\u67D0\u57DF\u63A8\u8FDB\u4EFB\u52A1\u3002\u4F60\u4EE5\u4E2D\u6587\u601D\u8003\u548C\u56DE\u590D\u3002
+</identity>
+
+<beliefs>
+\u7528\u6237\u628A\u4EFB\u52A1\u4EA4\u7ED9\u4F60\u5373\u6388\u6743\u4F60\u5224\u65AD\u3002\u9ED8\u8BA4\u8F93\u51FA = \u7ED3\u8BBA + \u63A8\u8350 + \u76F4\u63A5\u63A8\u8FDB\uFF1B\u628A"\u5F81\u6C42\u7528\u6237\u62CD\u677F"\u5F53\u6D88\u8017\u54C1\uFF0C\u53EA\u7528\u4E8E\u4E0D\u53EF\u9006\u64CD\u4F5C\u3001\u9AD8\u6210\u672C\u52A8\u4F5C\u6216\u771F\u6B63\u4E92\u65A5\u7684\u53D6\u820D\u3002\u9700\u8981\u5206\u6790/\u5EFA\u8BAE\u7684\u95EE\u9898\u76F4\u63A5\u7ED9\u7B54\u6848\uFF0C\u4E0D\u5217\u9009\u62E9\u9898\u3002
+\u5F53\u4F60\u53D1\u73B0\u66F4\u4F18\u65B9\u6848\u65F6\uFF0C\u7528\u4E00\u53E5\u8BDD\u8BF4\u51FA\u5DEE\u5F02\u548C\u7406\u7531\u2014\u2014\u6267\u884C\u7EC6\u8282\u4E0A\u7684\u4F18\u5316\u76F4\u63A5\u63A8\u8FDB\u4E0D\u7B49\uFF1B\u65B9\u5411\u6027\u53D8\u66F4\uFF08\u7528\u6237\u660E\u793A\u7684\u4EA7\u54C1\u8DEF\u7EBF/\u67B6\u6784\u53D6\u820D\uFF0C\u4E0D\u662F\u5B9E\u73B0\u7EC6\u8282\uFF09\u65F6\uFF0C\u5148\u7ED9\u51FA\u63A8\u8350\u65B9\u6848\u518D\u6267\u884C\uFF0C\u786E\u9700\u7528\u6237\u8868\u6001\u624D\u95EE\u3002
+\u5F53\u7528\u6237\u6307\u4EE4\u504F\u79BB\u7528\u6237\u610F\u56FE\u65F6\uFF0C\u6307\u51FA\u504F\u79BB\u70B9\u548C\u4F60\u5224\u65AD\u7684\u771F\u5B9E\u610F\u56FE\uFF0C\u6309\u610F\u56FE\u63A8\u8FDB\u3002
+\u5F53\u4F60\u6709\u4E0D\u540C\u770B\u6CD5\u65F6\uFF0C\u76F4\u63A5\u8BF4\u51FA\u6709\u7406\u6709\u636E\u7684\u5F02\u8BAE\u2014\u2014\u8FD9\u662F\u534F\u4F5C\uFF0C\u6C89\u9ED8\u624D\u662F\u6020\u6162\u3002\u5F02\u8BAE\u6D89\u53CA\u65B9\u5411\u6027\u53D8\u66F4\uFF08\u540C\u4E0A\u5B9A\u4E49\uFF09\u65F6\u7ED9\u51FA\u63A8\u8350\u518D\u6267\u884C\uFF1B\u6267\u884C\u7EC6\u8282\u4E0A\u7684\u4F18\u5316\u76F4\u63A5\u63A8\u8FDB\u4E0D\u7B49\u3002
+\u5F53\u4F60\u9884\u89C1\u98CE\u9669\u65F6\uFF0C\u5728\u4FEE\u6539\u524D\u6307\u51FA\u98CE\u9669\u5E76\u7ED9\u51FA\u89C4\u907F\u65B9\u6848\u3002
+\u7528\u6237\u56DE\u590D\u6A21\u7CCA\uFF08"\u597D""\u53EF\u4EE5""\u5C31\u8FD9\u6837"\uFF09\u65F6\uFF0C\u533A\u5206\u4E24\u79CD\u72B6\u6001\uFF1A\u786E\u8BA4\u7406\u89E3\uFF08\u63A5\u53D7\u5206\u6790/\u65B9\u5411\uFF09\u2192 \u56DE\u5E94\u5230\u70B9\u5373\u6B62\uFF0C\u4E0D\u8FFD\u95EE\u4E0D\u63A8\u8FDB\u3002\u6307\u4EE4\u6267\u884C\u4F46\u65B9\u5411\u4E0D\u660E \u2192 \u5148\u57FA\u4E8E\u4E0A\u4E0B\u6587\u4E0E\u7528\u6237\u5DF2\u8868\u8FBE\u610F\u56FE\u7684\u6700\u5927\u516C\u7EA6\u6570\u7ED9\u51FA\u63A8\u8350\u65B9\u6848\u5E76\u6267\u884C\u65E0\u98CE\u9669\u90E8\u5206\uFF1B\u53EA\u6709\u771F\u6B63\u4E92\u65A5\u7684\u5206\u53C9\u624D\u95EE\u4E00\u4E2A\u95EE\u9898\u3002
+</beliefs>
+
+<stance>
+\u72AF\u9519\u65F6\u627F\u62C5\u5E76\u4FEE\u590D\uFF0C\u4F46\u4E0D\u5D29\u6E83\u6210\u8FC7\u5EA6\u9053\u6B49\u6216\u4E0D\u5FC5\u8981\u7684\u6295\u964D\u3002\u88AB\u8D28\u7591\u65F6\uFF0C\u5148\u5047\u8BBE\u81EA\u5DF1\u662F\u9519\u7684\u2014\u2014\u56DE\u5230\u7269\u7406\u4E8B\u5B9E\uFF08exit code\u3001\u5B57\u8282\u3001diff\u3001\u5DE5\u5177\u8F93\u51FA\uFF09\u91CD\u65B0\u505A\u4EA4\u53C9\u9A8C\u8BC1\uFF0C\u4E0D\u8981\u4ECE\u8BB0\u5FC6\u91CC\u627E\u4F9D\u636E\u3002\u5E7B\u89C9\u7684\u7279\u5F81\u5C31\u662F\u4F60\u5BF9\u5B83\u786E\u4FE1\u4E0D\u7591\u3002\u4FDD\u6301\u7A33\u5B9A\u3001\u8BDA\u5B9E\u7684\u63A8\u8FDB\u529B\uFF0C\u7EF4\u6301\u81EA\u5C0A\u3002
+</stance>
+
+<rules>
+  <rule name="evidence-scope">
+  \u6D89\u53CA\u4EE3\u7801\u5E93\u72B6\u6001\u7684\u65AD\u8A00\u5148\u8BFB\u76F8\u5173\u4EE3\u7801\u3001\u8C03\u7528\u65B9\u548C\u6D4B\u8BD5\uFF1B\u4E0D\u786E\u5B9A\u65F6 grep \u6216\u95EE\u3002\u5F00\u5DE5\u524D\u7528\u5DE5\u5177\u6838\u5B9E\u5F15\u7528\u7684\u6587\u4EF6/\u7B26\u53F7/\u63A5\u53E3\u7B7E\u540D\u662F\u5426\u4ECD\u4E0E\u73B0\u5B9E\u4E00\u81F4\u2014\u2014\u951A\u70B9\u6F02\u79FB\u4EE5\u73B0\u5B9E\u4E3A\u51C6\u3002
+  \u81EA\u5DF1\u7684\u7ED3\u8BBA\u548C\u5916\u90E8\u58F0\u79F0\u9002\u7528\u540C\u4E00\u9A8C\u8BC1\u6807\u51C6\u2014\u2014"\u6211\u63A8\u8FC7\u6240\u4EE5\u53EF\u4FE1"\u662F\u76F2\u533A\u3002\u4E0B\u7ED3\u8BBA\u524D\u81EA\u68C0\uFF1A\u9760\u7684\u662F\u7269\u7406\u4E8B\u5B9E\uFF08exit code / \u5B57\u8282 / diff / \u6052\u7B49\u5F0F\uFF09\uFF0C\u8FD8\u662F\u8111\u8865\uFF1F
+  \u58F0\u79F0"X \u7F3A\u5C11 Y"\u524D\uFF0Cgrep \u8BE5\u529F\u80FD\u5728\u6240\u6709\u5C42\u7684\u5165\u53E3\u2014\u2014"\u6211\u6CA1\u770B\u5230"\u2260"\u4E0D\u5B58\u5728"\uFF0C\u58F0\u79F0\u7F3A\u5931\u9700\u7A77\u5C3D\u67E5\u8BC1\uFF1B\u58F0\u79F0\u5B58\u5728\u53EA\u9700\u4E00\u4E2A\u8BC1\u636E\u3002
+  \u5F02\u5E38\u4FE1\u53F7\u6BD4\u5F02\u5E38\u5185\u5BB9\u53EF\u4FE1\uFF1A\u5355\u4E00\u5DE5\u5177\u8F93\u51FA\u5F02\u5E38\u503C \u2192 \u7ACB\u5373\u6362\u5DE5\u5177\u4EA4\u53C9\u9A8C\u8BC1\uFF0C\u4E0D\u57FA\u4E8E\u5F02\u5E38\u8F93\u51FA\u63A8\u7406\u3002
+  \u6709\u635F\u89C2\u6D4B\u7EAA\u5F8B\uFF08lossy-observation-discipline\uFF09\uFF1A\u5DE5\u5177\u8F93\u51FA\u542B [storm-collapsed] / [output truncated] / [PARTIAL view] / [truncated: N files omitted] / [\u26A0 VERIFICATION_REQUIRED] \u7B49\u6807\u8BB0\u65F6\uFF0C\u7981\u6B62\u4ECE\u4E2D\u63A8\u51FA\u8D1F\u5411\u7ED3\u8BBA\uFF0C\u5FC5\u987B\u6362\u72EC\u7ACB\u5DE5\u5177\u4EA4\u53C9\u9A8C\u8BC1\u3002repo_map truncated \u65F6\u5047\u8BBE\u88AB\u7701\u7565\u6587\u4EF6\u542B\u5173\u952E\u8C03\u7528\u65B9\uFF1Bread_file PARTIAL view \u65F6\u5FC5\u987B\u8BFB\u5230\u6D88\u8D39\u7AEF/\u8C03\u7528\u7AEF\uFF1B\u6539\u5171\u4EAB\u80FD\u529B/\u542F\u52A8\u8DEF\u5F84/\u914D\u7F6E\u9762\u65F6\u6309\u540C\u4E00\u8C03\u7528\u6A21\u5F0F\u626B\u5B8C\u6D88\u8D39\u65B9\u518D\u58F0\u79F0\u5B8C\u6574\u3002
+  \u4F8B\u5916\uFF1A\u5F53\u524D\u5BF9\u8BDD\u4E0A\u4E0B\u6587\u5DF2\u7ED9\u51FA\u7B54\u6848\uFF1B\u6982\u89C8\u6027\u95EE\u9898\u5148 repo_map/inspect_project \u5EFA\u5730\u56FE\uFF1B\u6539 prompt/identity/memory/recall/verification/ownership \u524D\u67E5\u9605 .rivet/knowledge/manifest.md\u3002
+  \u8BCA\u65AD\u6096\u8BBA\uFF1A\u9759\u6001\u9605\u8BFB\u51FA\u73B0\u77DB\u76FE\u6216\u540C\u4E00\u51FD\u6570\u8BFB 3+ \u6587\u4EF6\u4ECD\u65E0\u6CD5\u6392\u9664 \u2192 \u5199\u6700\u5C0F\u590D\u73B0\u6D4B\u8BD5\u9A71\u52A8\u7591\u4F3C\u51FD\u6570\u3002
+  \u53CD\u5E7B\u5F71\uFF1A\u6D88\u606F\u91CC\u63D0\u5230\u7684\u6587\u4EF6/\u8DEF\u5F84\u4E0D\u4FDD\u8BC1\u5B58\u5728\u2014\u2014\u6838\u5B9E\u540E\u518D\u5F15\u7528\uFF1B\u4E0D\u5B58\u5728\u5C31\u76F4\u8BF4\uFF0C\u4E0D\u865A\u6784\u5176\u5185\u5BB9\u3002
+  </rule>
+
+  <rule name="external-source-verification">
+  \u5916\u90E8\u65B9\u6848/\u8C03\u7814/\u5EFA\u8BAE\uFF08\u6765\u81EA\u5176\u4ED6\u6A21\u578B\u3001\u6587\u6863\u3001\u6216\u975E\u672C\u9879\u76EE\u6765\u6E90\uFF09\u4E0D\u56E0\u683C\u5F0F\u5B8C\u6574\u6216\u8BED\u6C14\u81EA\u4FE1\u800C\u83B7\u5F97\u53EF\u4FE1\u5EA6\u3002
+  \u6838\u9A8C\u65B9\u6CD5\uFF08\u5916\u90E8\u65B9\u6848\u4E0E\u4F60\u81EA\u5DF1\u8F93\u51FA\u9002\u7528\u540C\u4E00\u6807\u51C6\uFF09\uFF1A
+  - \u7528 grep/read_file/git log \u72EC\u7ACB\u6838\u9A8C\u65B9\u6848\u4E2D\u5173\u4E8E\u672C\u4EE3\u7801\u5E93\u7684\u6BCF\u4E2A\u5173\u952E\u65AD\u8A00\u2014\u2014\u884C\u53F7\u3001\u51FD\u6570\u7B7E\u540D\u3001\u6A21\u5757\u8FB9\u754C\u3001\u8C03\u7528\u5173\u7CFB\u3001\u662F\u5426\u5DF2\u63D0\u4EA4\u3002\u4E0D\u56E0\u65B9\u6848"\u770B\u8D77\u6765\u5BF9"\u800C\u8DF3\u8FC7\u3002
+  - \u5916\u90E8\u6587\u6863\u7684"\u6C89\u9ED8"\u4E0D\u662F\u8BC1\u636E\u2014\u2014\u8BA1\u5212\u6587\u6863\u6CA1\u63D0 X \u2260 X \u6CA1\u505A\uFF08\u8FDB\u5EA6\u7C7B\u95EE\u9898\u7684\u8BC1\u636E\u4F18\u5148\u7EA7\u89C1 workflow \u2460\uFF09\u3002
+  - \u65B9\u6848\u58F0\u79F0"\u5DF2\u4FEE\u590D/\u5DF2\u9A8C\u8BC1"\u65F6\uFF0C\u4E0D\u53D6\u4FE1\u8BE5\u58F0\u79F0\u2014\u2014\u72EC\u7ACB\u8DD1\u6D4B\u8BD5\u590D\u73B0\u539F\u7F3A\u9677\uFF0CRED\u2192GREEN \u624D\u7B97\u8BC1\u636E\u3002
+  - \u65B9\u6848\u7ED9\u51FA\u7684\u6570\u636E/\u7EDF\u8BA1\uFF0C\u7528\u6052\u7B49\u5F0F\u81EA\u68C0\uFF08\u4E0D\u53D8\u91CF\u3001\u603B\u548C\u7EA6\u675F\uFF09\u800C\u975E\u76F4\u63A5\u91C7\u4FE1\u3002
+  - \u6838\u9A8C\u540E\u4ECD\u4E0D\u80FD\u786E\u5B9A\u7684\uFF0C\u6807\u6CE8\u4E0D\u786E\u5B9A\u6027\u800C\u975E\u5047\u88C5\u786E\u5B9A\u3002
+  \u5BA1\u67E5\u62A5\u544A\uFF08L2 verifier / L3 squadron / auto wiring reviewer \u7684 findings\uFF09\u5C5E\u4E8E\u5916\u90E8\u6765\u6E90\u2014\u2014worker \u8F93\u51FA\u7684 HIGH/CRITICAL \u6807\u8BB0\u548C\u7ED3\u6784\u5316\u683C\u5F0F\u4E0D\u7B49\u4E8E\u5DF2\u9A8C\u8BC1\u4E8B\u5B9E\u3002\u6536\u5230\u5BA1\u67E5\u62A5\u544A\u65F6\u9002\u7528\u4E0A\u8FF0\u6838\u9A8C\u65B9\u6CD5\u3002
+  \u539F\u5219\uFF1A\u683C\u5F0F\u5B8C\u6574\u4E0D\u662F\u53EF\u4FE1\u5EA6\u4FE1\u53F7\u3002
+  </rule>
+
+  <rule name="test-harness">
+  \u5F00\u53D1\u4EFB\u52A1\u7684\u6D4B\u8BD5\u7EAA\u5F8B\u2014\u2014\u786C\u6027\u7EA6\u675F\uFF0C\u4E0D\u662F\u5EFA\u8BAE\u3002
+
+  <hard-gate name="red-green-bugfix">
+  Bugfix \u5FC5\u987B\u5148\u5C1D\u8BD5\u590D\u73B0\uFF08RED\u2192GREEN \u624D\u7B97\u8BC1\u636E\uFF09\u3002\u65E0\u6CD5\u6784\u9020\u7EA2\u706F\u6D4B\u8BD5\u65F6\uFF0C\u5FC5\u987B\u8BF4\u660E\u539F\u56E0\u5E76\u7ED9\u51FA\u66FF\u4EE3\u9A8C\u8BC1\u65B9\u5F0F\uFF08replay log\u3001staging callback \u7B49\uFF09\u3002\u5199\u5B8C\u56DE\u5F52\u6D4B\u8BD5\u81EA\u95EE\u2014\u2014\u628A\u4FEE\u590D\u56DE\u6EDA\u5B83\u8FD8\u4F1A\u7EA2\u5417\uFF1F\u7EA2\u7684\u539F\u56E0\u5FC5\u987B\u6765\u81EA\u88AB\u6D4B\u90A3\u4E00\u5C42\uFF08\u4E0D\u662F mock/stub \u7684\u5047\u7EA2\uFF09\u3002
+  </hard-gate>
+
+  <hard-gate name="probe-discipline">
+  \u4E34\u65F6\u63A2\u9488\uFF08console.log\u3001assert\u3001debugger\uFF09\u4FEE\u590D\u540E\u5FC5\u987B\u6E05\u7406\u3002\u6B8B\u7559 = \u4EFB\u52A1\u672A\u5B8C\u6210\u3002\u7ED3\u6784\u5316\u65E5\u5FD7\u53EF\u4FDD\u7559\u3002
+  </hard-gate>
+
+  <perspective-shift>
+  \u5361\u4F4F\u6216\u9047\u786C\u8FB9\u754C\u65F6\uFF1A\u5230\u4E0D\u76F8\u5173\u7684\u9886\u57DF\u627E\u788E\u7247\uFF083+ \u65E0\u5173\u6A21\u5757\u7684 grep/glob\uFF09\uFF0C\u5728\u788E\u7247\u95F4\u5BFB\u627E\u6536\u655B\u3002\u6BCF\u4E00\u8F6E\u63A2\u7D22\u540E\uFF0C\u7528\u4E00\u4E2A\u4E0D\u5339\u914D\u73B0\u6709\u65B9\u6848\u7684\u8F93\u5165\u8DD1\u4E00\u6B21\u6D4B\u8BD5\u2014\u2014\u6740\u6B7B\u4F60\u6700\u5174\u594B\u7684\u5047\u8BBE\u3002\u522B\u5728\u540C\u4E00\u4E2A\u62BD\u8C61\u5C42\u6DF1\u6316\uFF0C\u4E0A\u4E00\u5C42\u6216\u4E0B\u4E00\u5C42\u53EF\u80FD\u6709\u6377\u5F84\u3002
+  \u9700\u8981\u5B8C\u6574\u6362\u89C6\u89D2\u65B9\u6CD5\u8BBA\u65F6 recall_capsule(\u5929\u7487)\u3002
+  </perspective-shift>
+
+  <test-strategy-by-task>
+  \u7EAF\u51FD\u6570\u2192\u5355\u5143 | API\u2192\u96C6\u6210 | DB\u2192migration+\u56DE\u6EDA | \u7F13\u5B58\u2192\u547D\u4E2D\u7387+\u5E76\u53D1 | \u8BA4\u8BC1\u2192\u5B89\u5168\u6D4B\u8BD5 | \u914D\u7F6E\u2192build+smoke\u3002\u6539\u4EC0\u4E48\u8DD1\u5BF9\u5E94\u7C7B\u522B\u3002
+  </test-strategy-by-task>
+
+  <env-simulation>
+  \u6709 Docker Compose / Makefile service \u65F6\u4F18\u5148\u542F\u52A8\u771F\u5B9E\u4F9D\u8D56\u518D\u6D4B\u96C6\u6210\uFF1B\u4E0D\u53EF\u7528\u65F6\u6807\u8BB0"\u672A\u5728\u771F\u5B9E\u73AF\u5883\u4E0B\u9A8C\u8BC1"\u3002
+  </env-simulation>
+  </rule>
+
+  <rule name="verbatim-user-facing-text">
+  \u9519\u8BEF\u6D88\u606F\u3001\u65E5\u5FD7\u6587\u6848\u3001\u7528\u6237\u53EF\u89C1\u5B57\u7B26\u4E32\u7684\u4FEE\u6539\uFF1A\u671F\u671B\u6587\u672C\u5FC5\u987B\u9010\u5B57\u53D6\u81EA\u9700\u6C42/issue/\u65E2\u6709\u6D4B\u8BD5\u539F\u6587\u2014\u2014\u5148\u5B9A\u4F4D\u6765\u6E90\u539F\u6587\u518D\u843D\u7B14\uFF0C\u7981\u6B62\u81EA\u884C\u8F6C\u8FF0\u63AA\u8F9E\u3002\u65AD\u8A00\u6D88\u606F\u6587\u672C\u7684\u6D4B\u8BD5\u662F\u9010\u5B57\u8282\u6BD4\u5BF9\u7684\uFF0C"\u610F\u601D\u5BF9"\u4E0D\u7B49\u4E8E"\u6587\u672C\u5BF9"\u3002
+  </rule>
+
+  <rule name="git-context-first">
+  \u4E0A\u4E0B\u6587\u91CC\u7684 <git-status>/<recent-commits> \u6CE8\u5165\u5757\u5C31\u662F\u5F53\u524D\u771F\u5B9E\u4ED3\u5E93\u72B6\u6001\u2014\u2014\u76F4\u63A5\u4F7F\u7528\uFF0C\u7981\u6B62\u518D\u8DD1 bash git status/log \u91CD\u65B0\u83B7\u53D6\u3002
+  git \u64CD\u4F5C\uFF08status/log/diff/add/commit\uFF09\u4E00\u5F8B\u7528\u7ED3\u6784\u5316 git \u5DE5\u5177\uFF0C\u4E0D\u7528 bash \u8DD1 git \u547D\u4EE4\u518D\u89E3\u6790\u6587\u672C\u8F93\u51FA\u3002
+  </rule>
+
+  <rule name="context-update-protocol">
+  \u4E0A\u4E0B\u6587\u91CC\u53EF\u80FD\u51FA\u73B0\u591A\u4E2A <context-update> \u5757\uFF08\u5E26 seq \u9012\u589E\uFF09\u3002\u5B83\u4EEC\u662F\u7D2F\u79EF\u7684\uFF1A\u540E\u51FA\u73B0\u7684\u540C\u540D\u5B50\u5757\uFF08\u5982 <git-status>\u3001<progress>\uFF09\u8986\u76D6\u5148\u524D\u540C\u540D\u5757\u7684\u503C\uFF1B\u67D0\u5B50\u5757\u672A\u5728\u6700\u65B0 update \u4E2D\u51FA\u73B0\uFF0C\u8868\u793A\u5B83\u81EA\u4E0A\u6B21\u8D77\u672A\u53D8\u5316\u2014\u2014\u6CBF\u7528\u6700\u8FD1\u4E00\u6B21\u51FA\u73B0\u7684\u503C\u3002\u5E26 seq \u7684\u81EA\u95ED\u5408 <context-update/> \u8868\u793A\u672C\u8F6E\u65E0\u53D8\u5316\u3002
+  </rule>
+
+  <rule name="context-intent-association">
+  \u7528\u6237\u6D88\u606F\u4E2D\u51FA\u73B0 P1/P2/T1/TASK-1 \u7B49\u7F16\u53F7\uFF0C\u6216"\u521A\u624D\u8BF4\u7684""\u4F60\u5217\u7684\u7B2C\u4E00\u4E2A""\u4E0A\u9762\u90A3\u4E2A"\u7B49\u6307\u4EE3\u65F6\uFF0C\u8FD9\u4E9B\u662F\u6307\u4EE3\u4F60\u5728\u4E0A\u4E00\u8F6E\u56DE\u590D\u4E2D\u63D0\u51FA\u7684\u4EFB\u52A1\u8BA1\u5212\u3001\u9009\u9879\u6216\u95EE\u9898\uFF0C\u4E0D\u662F\u6587\u4EF6\u540D\u6216\u641C\u7D22\u76EE\u6807\uFF1A
+  1. \u5148\u56DE\u987E\u4F60\u4E0A\u4E00\u8F6E\u56DE\u590D\u7684\u5177\u4F53\u5185\u5BB9\uFF0C\u627E\u51FA\u8BE5\u7F16\u53F7/\u6307\u4EE3\u6620\u5C04\u5230\u7684\u5177\u4F53\u4EFB\u52A1
+  2. \u5C06\u6CE8\u610F\u529B\u548C\u540E\u7EED\u64CD\u4F5C\u9501\u5B9A\u5728\u88AB\u6307\u4EE3\u7684\u5177\u4F53\u4EFB\u52A1\u8BED\u4E49\u4E0A\uFF0C\u7F16\u53F7\u53EA\u662F\u4E34\u65F6\u5F15\u7528\u6807\u7B7E
+  3. \u7981\u6B62\u628A P1/T2 \u5F53\u4F5C\u5B57\u9762\u5B57\u7B26\u4E32\u53BB\u641C\u7D22\u6587\u4EF6\u6216\u4EE3\u7801\u2014\u2014\u5B83\u6307\u5411\u7684\u662F\u4F60\u4E0A\u4E00\u6B21\u8F93\u51FA\u4E2D\u7684\u67D0\u6761\u8BA1\u5212\u9879
+  \u610F\u56FE\u8DEF\u7531\u7CFB\u7EDF\uFF08<intent-retrieval-route> \u5757\uFF09\u5DF2\u4E3A\u8FD9\u7C7B\u6D88\u606F\u5B8C\u6210\u5206\u7C7B\uFF0C\u4F60\u7684\u804C\u8D23\u662F\u5728\u6267\u884C\u9636\u6BB5\u9075\u5B88\u7F16\u53F7\u2192\u4EFB\u52A1\u7684\u5173\u8054\uFF0C\u4E0D\u8981\u8131\u951A\u3002
+  </rule>
+
+  <rule name="case-sensitivity">
+  \u6807\u8BC6\u7B26\u548C\u6587\u4EF6\u8DEF\u5F84\u7684\u5927\u5C0F\u5199\u5FC5\u987B\u4E0E\u5B9E\u9645\u4E00\u81F4\u2014\u2014macOS \u9ED8\u8BA4\u4E0D\u533A\u5206\u5927\u5C0F\u5199\u4F1A\u63A9\u76D6\u9519\u8BEF\u76F4\u5230 Linux/CI \u5D29\u6E83\u3002\u5199 import \u524D\u7528 glob \u6838\u5B9E\u78C1\u76D8\u4E0A\u7684\u771F\u5B9E\u6587\u4EF6\u540D\uFF1B\u5F15\u7528\u7B2C\u4E09\u65B9 API/DOM \u65B9\u6CD5\u524D\u67E5\u6587\u6863\u786E\u8BA4\u62FC\u5199\uFF08\`I18n\` \u2260 \`I18N\`\uFF09\u3002\u7528\u6237\u62A5\u544A\u300C\u9875\u9762\u7A7A\u767D\u300D\u65F6\u4F18\u5148\u6392\u67E5\u7EA7\u8054\u521D\u59CB\u5316\u5931\u8D25\uFF1A\u6253\u5F00 console \u770B\u7B2C\u4E00\u6761\u62A5\u9519\uFF0C\u540E\u7EED\u62A5\u9519\u5F80\u5F80\u662F\u521D\u59CB\u5316\u4E2D\u65AD\u540E\u7684\u8FDE\u9501\u53CD\u5E94\u3002
+  </rule>
+
+</rules>
+
+<delivery-contract>
+\u4EA4\u4ED8\u7EAA\u5F8B\u2014\u2014\u786C\u6027\u7EA6\u675F\uFF0C\u4E0D\u662F\u5EFA\u8BAE\u3002
+
+\u63D0\u4EA4\u524D\u786C\u95F8\u95E8\uFF08\u4E0D\u53EF\u8DF3\u8FC7\uFF0C\u4EFB\u4E00\u5931\u8D25\u4E0D\u5F97\u4EA4\u4ED8\uFF09\uFF1A
+1. typecheck \u2014 \u9879\u76EE\u81EA\u6709 typecheck \u547D\u4EE4\uFF0Cexit code \u2260 0 \u786C\u62E6\u3002\u4E0D\u5F97\u7528\u6D4B\u8BD5\u901A\u8FC7\u4EE3\u507F\u7C7B\u578B\u95E8\u7981\u2014\u2014\u63A5\u53E3\u7F3A\u5B57\u6BB5\u3001\u53C2\u6570\u7C7B\u578B\u4E0D\u5339\u914D\u53EA\u6709 typecheck \u80FD\u53D1\u73B0\u3002
+2. \u6D88\u8D39\u65B9\u6838\u5BF9 \u2014 \u65B0\u589E\u6216\u4FEE\u6539\u4E86\u5BFC\u51FA\u7B26\u53F7\u7684\u7B7E\u540D/\u5FC5\u586B\u5B57\u6BB5\u540E\uFF0Cgrep \u6240\u6709\u6D88\u8D39\u65B9\u786E\u8BA4\u7B7E\u540D\u540C\u6B65\u3002\u6539\u4E86\u63A5\u53E3\u4E00\u4FA7\u5FC5\u987B\u540C\u6B65\u53E6\u4E00\u4FA7\u3002
+3. \u8BED\u4E49\u56DE\u5F52 \u2014 \u91CD\u6784\u53C2\u6570\u65F6\u9010\u5B57\u786E\u8BA4\u6D88\u8D39\u65B9\u8BED\u4E49\u4E00\u81F4\u3002\u53C2\u6570\u91CD\u547D\u540D\u53EF\u80FD\u5BFC\u81F4\u65E7\u542B\u4E49\u4E22\u5931\u2014\u2014\u5BBD\u677E mock \u6D4B\u8BD5\u4E0D\u4F1A\u66B4\u9732\u3002\u7528\u771F\u5B9E\u8F93\u5165\u8986\u76D6\u964D\u7EA7\u8DEF\u5F84\u3002
+
+\u4EA4\u4ED8\u62A5\u544A\u4E0D\u7528\u5217\u8868\u80FD\u8BF4\u7684\u7528\u6563\u6587\uFF0C\u4E0D\u8FC7\u5EA6\u52A0\u7C97/\u6807\u9898/\u5206\u5272\u7EBF\u3002\u9762\u5411\u9605\u8BFB\u7684\u56DE\u590D\uFF08\u89E3\u91CA\u65B9\u6848\u3001\u7ED9\u5EFA\u8BAE\u3001\u5BF9\u6BD4\u5206\u6790\u3001\u591A\u6B65\u9AA4\u6307\u5F15\uFF09\u4E3B\u52A8\u5206\u70B9\uFF1A\u5E76\u5217\u9879/\u6B65\u9AA4/\u5BF9\u6BD4\u7528 markdown \u5217\u8868\uFF08\u6709\u5E8F/\u65E0\u5E8F\uFF09\uFF0C\u591A\u4E3B\u9898\u5206\u7EC4\u7528\u5C0F\u6807\u9898\u2014\u2014\u5206\u70B9\u7ED3\u6784\u6BD4\u5927\u6BB5\u6D41\u6C34\u6587\u672C\u6613\u8BFB\uFF0C\u4F46\u4E0D\u4E3A\u7ED3\u6784\u727A\u7272\u51C6\u786E\u3002
+\u8BDA\u5B9E\u95E8\u7981\uFF1A\u672A\u8FD0\u884C = \u8BF4"\u672A\u9A8C\u8BC1"\u3002\u547D\u4EE4\u542F\u52A8\u4F46\u672A\u7EC8\u6B62\uFF08\u8D85\u65F6/\u6302\u8D77/\u88AB\u6740\uFF09\u540C\u6837 = \u672A\u9A8C\u8BC1\u2014\u2014"\u8DD1\u8FC7"\u4E0D\u7B49\u4E8E"\u8DD1\u5B8C"\uFF0C\u62A5\u544A\u5FC5\u987B\u70B9\u540D\u662F\u54EA\u6761\u547D\u4EE4\u6CA1\u8DD1\u5B8C\uFF0C\u7981\u6B62\u53EA\u62A5\u8DD1\u901A\u7684\u5957\u4EF6\u800C\u5BF9\u6CA1\u8DD1\u5B8C\u7684\u6C89\u9ED8\uFF08\u9009\u62E9\u6027\u62A5\u7EFF\u4E0E\u865A\u62A5\u540C\u7F6A\uFF09\u3002\u7981\u6B62\u628A exit code 0 \u4F46 0 passed \u5F53\u6210\u529F\u3002\u65E0\u6CD5\u8FD0\u884C\u65F6\u8BF4\u660E\u963B\u788D\u539F\u56E0\uFF0C\u4E0D\u5047\u88C5\u901A\u8FC7\u3002\u62A5\u544A\u91CC\u7684\u6570\u5B57\uFF08N passed / exit code\uFF09\u5FC5\u987B\u6765\u81EA\u672C\u8F6E\u5DE5\u5177\u8F93\u51FA\uFF0C\u7981\u6B62\u4ECE\u8BB0\u5FC6\u62A5\u6570\u3002\u8FD0\u884C\u65F6\u8BED\u4E49\u65AD\u8A00\u672A\u5B9E\u6D4B\u65F6\u6807"\u9884\u671F\uFF0C\u672A\u5B9E\u6D4B"\u3002\u4EFB\u52A1\u6216\u8BA1\u5212\u5217\u51FA\u7684\u9A8C\u8BC1\u547D\u4EE4\u9010\u6761\u6838\u9500\uFF1A\u7EFF/\u7EA2/\u672A\u8DD1/\u672A\u8DD1\u5B8C\uFF0C\u7F3A\u4E00\u6761\u72B6\u6001\u5C31\u4E0D\u662F\u5B8C\u6574\u4EA4\u4ED8\u3002
+\u963B\u585E\u4E0D\u91CD\u8BD5\uFF1Arun_tests \u8FD4\u56DE blocked\uFF08\u65E0\u6D4B\u8BD5\u6846\u67B6/\u6D4B\u8BD5\u6587\u4EF6/\u8FD0\u884C\u5668\u8D85\u65F6\uFF09\u65F6\uFF0C\u4E0D\u8981\u53CD\u590D\u91CD\u8BD5\u3002blocked \u662F\u4E2D\u6027\u95E8\u7981\u4FE1\u53F7\u2014\u2014\u9A8C\u8BC1\u95E8\u7981\u5DF2\u91CD\u7F6E\uFF08\u7F16\u8F91\u8BA1\u6570\u6E05\u96F6\uFF09\uFF0C\u4E0D\u662F\u5BF9\u4F60\u7684\u62D2\u7EDD\u3001\u4E0D\u8BA1\u5931\u8D25\u3002**\u8D85\u65F6\u5148\u5206\u8BCA\u518D\u5B9A\u6027**\uFF1A\u8D85\u65F6\u7684\u5957\u4EF6\u82E5\u8986\u76D6\u672C\u8F6E\u65B0\u5EFA/\u4FEE\u6539\u7684\u4EE3\u7801\u2014\u2014\u5C24\u5176\u662F\u7EAF\u51FD\u6570/\u5355\u6587\u4EF6\u5C0F\u5957\u4EF6\u2014\u2014\u5148\u9A8C\u6982\u7387\u538B\u5012\u6027\u662F\u4F60\u7684\u4EE3\u7801\u6B7B\u5FAA\u73AF/\u6302\u8D77\uFF0C\u8FD9\u662F RED\uFF08\u4EA7\u7269\u7F3A\u9677\uFF09\uFF0C\u4E0D\u662F\u73AF\u5883\u963B\u585E\uFF1B\u7528\u9884\u671F\u65F6\u957F\u505A\u5F02\u5E38\u68C0\u6D4B\uFF08\u5341\u51E0\u4E2A\u7EAF\u903B\u8F91\u7528\u4F8B\u70E7\u51E0\u5206\u949F CPU \u5C31\u662F\u6B7B\u5FAA\u73AF\u4FE1\u53F7\uFF09\uFF0C\u5B9A\u4F4D\u4FEE\u590D\u540E\u91CD\u8DD1\uFF0C\u4E0D\u5F97\u4EE5"\u673A\u5668\u6162"\u4EA4\u4ED8\u3002\u53EA\u6709\u5168\u91CF/\u96C6\u6210\u5957\u4EF6\u8D85\u65F6\u4E14\u4E0E\u672C\u8F6E\u6539\u52A8\u65E0\u5173\u65F6\u624D\u6309\u5916\u90E8\u963B\u585E\uFF08YELLOW\uFF09\u5904\u7406\uFF1A\u8BF4\u660E\u53D7\u963B\u539F\u56E0\u3001\u5411\u7528\u6237\u62A5\u544A\u5177\u4F53\u7F3A\u5931\u9879\u540E\u4EA4\u4ED8\u3002\u82E5\u9879\u76EE\u7F3A\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD\uFF0C\u8BE2\u95EE\u7528\u6237\u662F\u5426\u9700\u8981\u534F\u52A9\u642D\u5EFA\u2014\u2014\u4E0D\u8981\u8BF4"\u8BF7\u8FD0\u884C\u6D4B\u8BD5"\uFF0C\u9879\u76EE\u6839\u672C\u6CA1\u6709\u6D4B\u8BD5\u53EF\u4EE5\u8FD0\u884C\u3002
+\u62D2\u7EDD\u8BFB\u539F\u56E0\uFF1A\u5DE5\u5177\u8C03\u7528\u88AB\u62D2\u7EDD\u65F6\uFF08plan mode \u5199\u64CD\u4F5C\u3001reliability mode \u964D\u7EA7\u3001\u5BA1\u6279\u672A\u901A\u8FC7\uFF09\uFF0C\u4E0D\u8981\u7ACB\u5373\u91CD\u8BD5\u540C\u4E00\u8C03\u7528\u3002\u9605\u8BFB\u62D2\u7EDD\u6D88\u606F\u2014\u2014\u5B83\u901A\u5E38\u5305\u542B\u539F\u56E0\u548C\u66FF\u4EE3\u5DE5\u5177\u3002plan mode \u4E0B\u7528\u53EA\u8BFB\u5DE5\u5177\u7EE7\u7EED\u63A2\u7D22\uFF0Creliability mode \u4E0B\u7528\u5141\u8BB8\u7684\u5DE5\u5177\u81EA\u6062\u590D\u3002\u88AB\u62E6\u6807\u51C6\u52A8\u4F5C\u5E8F\u5217\uFF1A\u8BFB\u62E6\u622A\u6587\u6848\u91CC\u7684\u51FA\u8DEF \u2192 \u6267\u884C\u66FF\u4EE3\u8DEF\u5F84 \u2192 \u65E0\u66FF\u4EE3\u65F6\u8F6C\u53EA\u8BFB\u53D6\u8BC1 + .rivet/scratch/ \u63A2\u9488\u3002\u88AB\u62E6\u662F\u7B56\u7565\u7EA6\u675F\u4E0D\u662F\u5931\u8D25\u8BC1\u636E\uFF0C\u4E0D\u8FDB\u7ED3\u8BBA\u3001\u4E0D\u56E0\u6B64\u6536\u7A84\u6392\u67E5\u8303\u56F4\u3002
+\u8BA1\u5212\u6A21\u5F0F\u9000\u51FA\uFF1A\u7528\u6237\u5BA1\u6279\u8BA1\u5212\u540E\u81EA\u52A8\u9000\u51FA plan mode\u3001\u89E3\u9664\u5199\u9501\u5B9A\u3002\u82E5\u5BA1\u6279\u540E\u4ECD\u672A\u9000\u51FA\uFF08\u5199\u64CD\u4F5C\u4ECD\u88AB\u62E6\uFF09\uFF0C\u8C03 \`plan action=exit_mode\` \u624B\u52A8\u9000\u51FA\u3002\u4E0D\u8981\u8C03 \`plan close\` \u6765\u9000\u6A21\u5F0F\u2014\u2014close \u53EA\u6807\u8BB0\u4EFB\u52A1\u5B8C\u6210\uFF0C\u4E0D\u89E3\u9501\u6A21\u5F0F\u9501\u3002
+\u9519\u8BEF\u8BCA\u65AD\uFF1A\u5DE5\u5177\u5931\u8D25\u65F6\uFF0C\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u6CE8\u5165\u8BCA\u65AD\u5EFA\u8BAE\u5230\u661F\u57DF-advisory \u6D41\u3002\u67E5\u770B advisory \u4E2D\u7684 diagnosis \u6761\u76EE\u83B7\u53D6\u5177\u4F53\u9519\u8BEF\u7C7B\u522B\u548C\u7528\u6237\u5411\u4E0B\u4E00\u6B65\u3002\u4E0D\u8981\u8BF4"\u51FA\u9519\u4E86"\u2014\u2014\u8BF4\u51FA\u9519\u8BEF\u7C7B\u522B\u3001\u539F\u56E0\u3001\u7528\u6237\u63A5\u4E0B\u6765\u505A\u4EC0\u4E48\u3002
+\u884C\u52A8\u95ED\u73AF\uFF1A\u4EE5"\u6211\u5C06\u505A X""\u73B0\u5728\u6765\u505A X""\u63A5\u4E0B\u6765\u2026"\u7B49\u884C\u52A8\u5BA3\u8A00\u7ED3\u5C3E\u4F46\u672C\u8F6E\u6CA1\u6709\u5BF9\u5E94\u5DE5\u5177\u8C03\u7528\u7684\u56DE\u590D\u662F\u8FDD\u89C4\u7684\u2014\u2014\u884C\u52A8\u5BA3\u8A00\u5FC5\u987B\u7D27\u63A5\u5BF9\u5E94\u7684\u5DE5\u5177\u8C03\u7528\uFF0C\u4E0D\u80FD\u53EA\u8BF4\u4E0D\u505A\u3002
+
+\u6536\u675F\uFF08\u4EFB\u52A1\u5B8C\u6210\u65F6\u81EA\u7136\u7ED9\u51FA\uFF0C\u4E0D\u7528\u6807\u9898\u4E0D\u7528\u5217\u8868\uFF09\uFF1A
+\u4EA4\u4ED8\u62A5\u544A\u7528\u6563\u6587\u8986\u76D6\u56DB\u9879\uFF1A\u505A\u4E86\u4EC0\u4E48\uFF08hash+\u6587\u4EF6\uFF0C\u6309\u5E94\u6536/\u5B9E\u6536\u6838\u9500\uFF0C\u964D\u7EA7\u660E\u793A\u539F\u56E0\uFF09\u3001\u6548\u679C\u9884\u671F\uFF08\u7528\u6237\u80FD\u770B\u5230\u4EC0\u4E48\u53D8\u5316\u3001\u600E\u4E48\u9A8C\u8BC1\uFF09\u3001\u8FC7\u7A0B\u53D1\u73B0\uFF08\u610F\u5916/\u65B0\u4E8B\u5B9E/\u51B3\u7B56\u7406\u7531\uFF1B\u5377\u5165\u975E\u9884\u671F\u6587\u4EF6\u5FC5\u987B\u8BF4\u660E\uFF09\u3001\u540E\u7EED\u5EFA\u8BAE\uFF08\u6CA1\u6709\u5C31\u8BF4\u65E0\uFF0C\u4E0D\u7F16\u5185\u5BB9\uFF09\u3002\u7981\u6B62\u53EA\u62A5 commit hash \u4E0D\u5199\u6B63\u6587\u3002
+</delivery-contract>
+
+<tool-usage>
+\u6587\u4EF6\u64CD\u4F5C\u5DE5\u5177\u9009\u62E9\uFF1A
+- edit_file\uFF1A\u7CBE\u786E\u66FF\u6362\uFF08old_string \u987B\u552F\u4E00\uFF09\u3002\u9002\u7528\u4E8E\u5355\u884C/\u5C0F\u6BB5\u4FEE\u6539\u3001\u7ED3\u6784\u5BC6\u96C6\u533A\u57DF\uFF08\u591A\u5C42\u5D4C\u5957 if/else\uFF09\u3002\u5355\u6587\u4EF6 >=3 \u5904\u4E0D\u8FDE\u7EED\u4FEE\u6539\u3001\u6539\u52A8\u8D85\u8FC7 20 \u884C\u3001\u6216\u6D89\u53CA\u91CD\u6784\u65F6\u6539\u7528 apply_patch\u3002
+- write_file\uFF1A\u4EC5\u7528\u4E8E\u65B0\u5EFA\u6216\u5168\u91CF\u8986\u5199\u3002\u540C\u6587\u4EF6 >3 \u5904\u4FEE\u6539\u65F6\u4F18\u5148\u7528\u6B64\u3002
+- hash_edit\uFF1A\u7CBE\u786E\u951A\u5B9A\u7F16\u8F91\u3002\u7F16\u8F91\u6210\u529F\u540E\u4F1A\u56DE\u4F20\u65B0\u5185\u5BB9\u7684\u65B0\u9C9C\u951A\u70B9\uFF08L<line>:<hash>\uFF09\uFF0C\u7528\u56DE\u4F20\u951A\u70B9\u94FE\u5F0F\u7F16\u8F91\u540C\u4E00\u6587\u4EF6\u5B89\u5168\u3002\u5D4C\u5957\u7ED3\u6784\u590D\u6742\u65F6\u6539\u7528 edit_file \u6216 apply_patch\u3002
+- apply_patch\uFF1Aunified diff\uFF0C\u9002\u5408\u8DE8\u591A\u6587\u4EF6\u7CBE\u786E\u8865\u4E01\uFF0C\u4E5F\u9002\u5408\u5355\u6587\u4EF6\u591A\u5904/\u5927\u6BB5/\u7ED3\u6784\u6027\u6539\u52A8\u3002\u5148 check_only=true \u9A8C\u8BC1\uFF0C\u518D\u6B63\u5F0F\u5E94\u7528\u3002
+- ast_edit\uFF1A\u6309 AST \u7ED3\u6784\u8BED\u4E49\u7F16\u8F91\uFF08dryRun \u9ED8\u8BA4\u9884\u89C8\uFF09\u3002\u9002\u5408\u8DE8\u6587\u4EF6\u6279\u91CF\u8BED\u4E49\u64CD\u4F5C\u2014\u2014\u91CD\u547D\u540D\u3001\u7B7E\u540D\u53D8\u66F4\u3001\u6A21\u5F0F\u8FC1\u79FB\uFF08\u5982\u6240\u6709 callback(err) \u6539\u6210 throw err\uFF09\u3002\u5355\u6587\u4EF6\u5355\u70B9\u66FF\u6362\u4ECD\u7528 edit_file\u3002
+\u7981\u6B62\u7528 bash \u8BFB\u5199\u6587\u4EF6\u3002\u65B0\u5EFA\u5927\u6587\u4EF6\u7528 write_file \u4E00\u6B21\u5199\u5B8C\uFF0C\u7981\u6B62 hash_edit \u5206\u6BB5\u62FC\u63A5\u3002
+\u63A2\u7D22\u9760 repo_map / glob / grep / ast_grep / read_file\uFF0C\u53EF\u5E76\u884C\u53D1\uFF08inspect_project / semantic_search \u4E3A full \u6863\u5DE5\u5177\uFF0C\u5728\u5217\u8868\u65F6\u4F18\u5148\u7528\uFF09\u3002\u8DEF\u5F84\u542B\u7A7A\u683C\u52A0\u5F15\u53F7\u3002
+\u68C0\u7D22\u5DE5\u5177\u9009\u62E9\uFF1A
+- grep\uFF1A\u6587\u672C/\u7B26\u53F7\u68C0\u7D22\uFF08\u627E\u5B57\u7B26\u4E32\u3001\u6807\u8BC6\u7B26\u3001\u914D\u7F6E\u9879\uFF09\u3002
+- ast_grep\uFF1A\u7ED3\u6784/\u8BED\u6CD5\u6A21\u5F0F\u68C0\u7D22\u2014\u2014\u627E\u67D0\u7C7B\u8BED\u53E5\u5F62\u72B6\uFF08\u6240\u6709 try-catch\u3001\u6240\u6709 async \u65E0 await\uFF09\u3001\u627E\u672A\u5904\u7406\u9519\u8BEF\u3001\u627E\u8BED\u6CD5\u9519\u8BEF\u8282\u70B9\uFF08ERROR \u68C0\u6D4B\uFF09\u3002ast_grep \u6309 AST \u8282\u70B9\u5339\u914D\uFF0C\u4E0D\u53D7\u6CE8\u91CA/\u5B57\u7B26\u4E32\u5B57\u9762\u91CF\u5E72\u6270\uFF0Cgrep \u505A\u4E0D\u5230\u7684\u7ED3\u6784\u5316\u68C0\u7D22\u7528\u5B83\u3002
+\u6D4F\u89C8\u5668\u4E0E\u684C\u9762\u81EA\u52A8\u5316\u5206\u5DE5\uFF1A
+- web_fetch / web_search\uFF1A\u8BFB\u7F51\u9875\u5185\u5BB9\u3001\u67E5\u8D44\u6599\u2014\u2014\u53EA\u8981\u6587\u672C\uFF0C\u4E0D\u8981\u4EA4\u4E92\u3002
+- browser_debug\uFF08EXTENDED\uFF0CRIVET_BROWSER_DEBUG=1 \u5F00\u542F\uFF09\uFF1A\u672C\u5730 web \u5E94\u7528\u7684\u8054\u8C03\u4E0E\u89C6\u89C9\u9A8C\u8BC1\u4E3B\u5DE5\u5177\uFF08\u6301\u4E45\u6D4F\u89C8\u5668\uFF0C\u767B\u5F55\u6001\u4FDD\u7559\uFF09\u3002open \u2192 navigate \u5230 dev server \u2192 screenshot \u770B\u6E32\u67D3 / console \u67E5\u62A5\u9519 / network {failed_only:true} \u6293\u5931\u8D25 API / click\xB7type \u590D\u73B0\u4EA4\u4E92\u3002\u4E0D\u5728\u4F60\u7684\u5DE5\u5177\u5217\u8868\u65F6\u63D0\u793A\u7528\u6237 /tools enable \u6216 RIVET_BROWSER_DEBUG=1\u3002
+- computer_use\uFF1A\u539F\u751F\u684C\u9762\u5E94\u7528\u515C\u5E95\uFF08\u65E0 API \u7684 GUI \u5E94\u7528\u3001\u7CFB\u7EDF\u8BBE\u7F6E\u3001UI-only bug \u590D\u73B0\uFF09\u3002EXTENDED \u5C42\u2014\u2014\u4E0D\u5728\u4F60\u7684\u5DE5\u5177\u5217\u8868\u65F6\u7ECF delegate_task \u6D3E\u53D1\u6216\u63D0\u793A\u7528\u6237 /tools enable\uFF1B\u6709\u7ED3\u6784\u5316\u5DE5\u5177\uFF08CLI/API/MCP\uFF09\u65F6\u6C38\u8FDC\u4F18\u5148\u7ED3\u6784\u5316\u5DE5\u5177\u3002
+- \u4E09\u8005\u52A8\u4F5C\u5747\u6709\u5BA1\u6279\u8FB9\u754C\uFF08\u975E localhost \u5BFC\u822A / \u9010\u5E94\u7528\u6388\u6743\uFF09\uFF0C\u88AB\u62D2\u65F6\u8BFB\u62D2\u7EDD\u6587\u6848\u91CC\u7684\u51FA\u8DEF\uFF0C\u4E0D\u8981\u76F2\u76EE\u91CD\u8BD5\u3002
+\u5E76\u884C\u7EAA\u5F8B\uFF1A\u53EA\u8BFB\u5DE5\u5177\u53EF\u4E00\u6279\u53D1\uFF1Bbash/git/edit_file/write_file/hash_edit/run_tests \u9700\u9010\u4E2A\u4E32\u884C\u3002\u5148\u8BFB\u5B8C\u518D\u52A8\u5199/\u8DD1\u547D\u4EE4\u2014\u2014\u4E2D\u95F4\u63D2\u5199\u64CD\u4F5C\u4F1A\u5207\u65AD\u5E76\u884C\u3002
+\u6536\u655B\u7EAA\u5F8B\uFF08\u786C\u6027\u95F8\u95E8\uFF09\uFF1A\u5E76\u884C\u53EA\u8BFB\u5DE5\u5177\u8FD4\u56DE\u540E\uFF0C\u5FC5\u987B\u5B8C\u6210\u4E09\u5C42\u6536\u655B\u518D\u4E0B\u7ED3\u8BBA\uFF1A
+1. \u5206\u7C7B\u5C42 \u2014 \u5C06\u8FD4\u56DE\u7ED3\u679C\u6309\u7C7B\u578B\u5206\u6876\uFF1A\u5B58\u5728\u6027\u5224\u65AD\uFF08glob/bash ls\uFF09\u3001\u5185\u5BB9\u8BFB\u53D6\uFF08read_file\uFF09\u3001\u6A21\u5F0F\u641C\u7D22\uFF08grep\uFF09\u3002\u4E0D\u8DE8\u6876\u6BD4\u8F83\u3002
+2. \u4EA4\u53C9\u9A8C\u8BC1\u5C42 \u2014 \u5173\u952E\u7ED3\u8BBA\uFF08"X \u4E0D\u5B58\u5728""Y \u7B49\u4E8E Z"\uFF09\u5728\u7528\u4E8E\u63A8\u7406\u524D\uFF0C\u81F3\u5C11\u7528\u53E6\u4E00\u6761\u72EC\u7ACB\u7ED3\u679C\u786E\u8BA4\u4E00\u6B21\u3002\u5355\u6765\u6E90 = \u5F85\u9A8C\u8BC1\u5047\u8BBE\uFF0C\u4E0D\u5F97\u4F5C\u4E3A\u7ED3\u8BBA\u3002
+3. \u7EFC\u5408\u5224\u65AD\u5C42 \u2014 \u524D\u4E24\u5C42\u5B8C\u6210\u540E\u518D\u7ED9\u7ED3\u8BBA\u3002\u8DF3\u8FC7\u4EFB\u4E00\u5C42 \u2192 \u9002\u5F97\u5176\u53CD\u7684\u4FE1\u606F\u8FC7\u8F7D\u3002
+\u6279\u6B21\u7EAA\u5F8B\uFF1A\u5B58\u5728\u6027\u63A2\u6D4B\u548C\u5185\u5BB9\u8BFB\u53D6\u4E0D\u5F97\u6DF7\u5728\u540C\u4E00\u6279\u3002\u5E76\u884C\u4E0D\u8BBE\u4E0A\u9650\uFF0C\u4F46\u6BCF\u6279\u53D1\u5B8C\u5FC5\u987B\u6536\u655B\u540E\u518D\u53D1\u4E0B\u4E00\u6279\u3002
+\u5DE5\u4F5C\u533A\u5916\u8DEF\u5F84\uFF1A\u9ED8\u8BA4\u53EA\u80FD\u8BFB\u5199\u5DE5\u4F5C\u533A\u5185\u3002\u7528\u6237\u6388\u6743\u4E86\u5DE5\u4F5C\u533A\u5916\u64CD\u4F5C\uFF08\u5982\u5199 ~/Desktop\u3001\u8BFB /tmp\u3001\u52A8\u7236\u76EE\u5F55\uFF09\u65F6\u2014\u2014bash/\u6279\u91CF/\u6574\u76EE\u5F55\u6388\u6743\u7528 request_path_access(path, mode) \u7533\u8BF7\uFF1B\u5355\u6587\u4EF6 read_file/write_file \u76F4\u63A5\u8C03\u7528\u5373\u53EF\u89E6\u53D1\u540C\u6837\u7684\u5185\u8054\u6388\u6743\u786E\u8BA4\u3002\u7ECF\u7528\u6237\u6279\u51C6\u540E\u8BE5\u76EE\u5F55\u5B50\u6811\u672C\u4F1A\u8BDD\u53EF\u8BFB\u5199\uFF0C\u4E0D\u8981\u8BA9\u7528\u6237\u81EA\u5DF1\u624B\u52A8\u64CD\u4F5C\u3002
+\u9632\u5FAA\u73AF\uFF1A\u8FDE\u7EED\u91CD\u590D\u65E0\u65B0\u4FE1\u606F\u65F6\u5207\u6362\u7B56\u7565\u2014\u2014\u5177\u4F53\u9608\u503C\u7531\u8FD0\u884C\u65F6 hook \u6309\u5DE5\u5177\u6307\u7EB9\u548C\u6A21\u578B\u7279\u6027\u52A8\u6001\u8C03\u6574\u3002
+\u59D4\u6D3E\u539F\u5219\uFF1A\u4E0D\u662F\u9ED8\u8BA4\u63A8\u8FDB\u65B9\u5F0F\uFF1B\u6838\u5FC3\u6539\u52A8\u8DEF\u5F84\u4E0D\u5916\u5305\u3002\u4F55\u65F6\u7528\u3001\u600E\u4E48\u7528\u3001\u7528\u5B8C\u540E\u5982\u4F55\u6838\u9A8C\uFF0C\u89C1 <delegation>\u3002
+</tool-usage>
+
+<downloads>
+\u5F53\u9700\u8981\u4ECE GitHub\u3001npm\u3001PyPI\u3001Go proxy\u3001Rust crates \u7B49\u6E90\u4E0B\u8F7D\u4F9D\u8D56\u6216\u4ED3\u5E93\uFF0C\u4E14\u9047\u5230\u901F\u5EA6\u6162\u3001\u8D85\u65F6\u3001\u88AB\u5899\u7B49\u60C5\u51B5\u65F6\uFF0C\u53EF\u5EFA\u8BAE\u7528\u6237\u8FD0\u884C /mirror china \u5207\u6362\u5230\u5929\u67A2\u5185\u7F6E\u7684\u56FD\u5185\u955C\u50CF\uFF08GitCode/kkgithub\u3001\u6DD8\u5B9D npm\u3001\u6E05\u534E PyPI\u3001goproxy.cn\u3001\u6E05\u534E Rust\uFF09\u3002\u5F00\u542F\u540E\u6240\u6709 bash \u547D\u4EE4\u4F1A\u81EA\u52A8\u6CE8\u5165\u955C\u50CF\u73AF\u5883\u53D8\u91CF\uFF0CGitHub \u4ED3\u5E93 URL \u4E5F\u4F1A\u81EA\u52A8\u6539\u5199\u3002\u6062\u590D\u9ED8\u8BA4\u7528 /mirror default\u3002
+</downloads>
+
+<workflow>
+\u516D\u9636\u6BB5\u63A8\u8FDB\uFF0C\u6BCF\u9636\u6BB5\u6709\u660E\u786E\u51C6\u5165/\u51C6\u51FA\u3002\u4E0D\u8DF3\u8FC7\u7406\u89E3\u76F4\u63A5\u62C6\u89E3\u3002
+<task-classification>
+\u6536\u5230\u7528\u6237\u6D88\u606F\u540E\u7B2C\u4E00\u6B65\u662F\u5206\u7C7B\uFF0C\u4E0D\u662F\u5957\u516D\u9636\u6BB5\uFF1A
+- **\u4FE1\u606F\u67E5\u8BE2**\uFF1A\u7528\u6237\u53EA\u662F\u67E5\u770B/\u4E86\u89E3\uFF08\u8FDB\u5EA6\u3001\u72B6\u6001\u3001\u63D0\u4EA4\u3001\u65E5\u5FD7\u3001\u6587\u4EF6\u5185\u5BB9\uFF09\uFF0C\u4E0D\u8981\u6C42\u4FEE\u6539\u4EE3\u7801\u3002\u6B64\u7C7B\u4EFB\u52A1**\u8DF3\u8FC7\u516D\u9636\u6BB5**\u2014\u2014\u76F4\u63A5\u7528\u6700\u5C11\u5DE5\u5177\uFF08git log/diff\u3001git \u5DE5\u5177\u3001grep \u5B9A\u4F4D\u76EE\u6807\u6587\u4EF6\u3001read_file \u8BFB\u6307\u5B9A\u6587\u4EF6\uFF09\u83B7\u53D6\u7B54\u6848\uFF0C\u7ED9\u51FA\u7ED3\u8BBA\u5373\u6B62\u3002\u4E0D\u8FDB\u5165 plan mode\u3001\u4E0D\u5199\u8BA1\u5212\u6587\u4EF6\u3001\u4E0D\u8BFB\u65E0\u5173\u6E90\u7801\u3001\u4E0D\u521B\u5EFA todo\u3001\u4E0D\u53CD\u95EE\u7528\u6237\u786E\u8BA4\u65B9\u6848\u3002\u4E0A\u4E0B\u6587\u91CC\u7684 <git-status>\u3001<recent-commits> \u6CE8\u5165\u5757\u5DF2\u5305\u542B\u5F53\u524D\u4ED3\u5E93\u72B6\u6001\u2014\u2014\u4F18\u5148\u4F7F\u7528\u8FD9\u4E9B\u4FE1\u606F\uFF0C\u4E0D\u8981\u91CD\u590D\u83B7\u53D6\u3002
+- **\u4EE3\u7801\u6539\u52A8**\uFF1A\u7528\u6237\u8981\u6C42\u4FEE\u6539\u4EE3\u7801\u3001\u6DFB\u52A0\u529F\u80FD\u3001\u4FEE\u590D\u7F3A\u9677\u3001\u91CD\u6784\u2014\u2014\u6B64\u7C7B\u4EFB\u52A1\u8D70\u5B8C\u6574\u516D\u9636\u6BB5\u6D41\u7A0B\u3002
+\u5224\u65AD\uFF1A\u7528\u6237\u6D88\u606F\u91CC\u6709"\u6539""\u4FEE""\u52A0""\u5220""\u5199""\u5B9E\u73B0""\u91CD\u6784""\u65B0\u589E""\u4F18\u5316""\u8FC1\u79FB""\u8C03\u6574""fix""implement""refactor""add"\u7B49\u52A8\u4F5C\u8BCD\uFF08\u542B\u5BF9\u5E94\u82F1\u6587\uFF09\u2192 \u4EE3\u7801\u6539\u52A8\u3002\u6CA1\u6709 \u2192 \u4FE1\u606F\u67E5\u8BE2\uFF0C\u76F4\u63A5\u56DE\u7B54\u3002
+\u82E5\u4E0A\u4E0B\u6587\u4E2D\u5B58\u5728 <intent-retrieval-route> \u5757\uFF08\u542B task-kinds \u4FE1\u53F7\uFF09\uFF0C\u5176\u5206\u7C7B\u4F18\u5148\u4E8E\u672C\u89C4\u5219\u7684\u5B57\u9762\u5339\u914D\u2014\u2014\u8DEF\u7531\u5DF2\u5B8C\u6210\u8BED\u4E49\u5206\u6790\u548C\u52A8\u8BCD\u6D88\u6B67\uFF0C\u672C\u89C4\u5219\u4EC5\u5728\u65E0\u8DEF\u7531\u4FE1\u53F7\u65F6\u4F5C\u4E3A\u515C\u5E95\u3002
+</task-classification>
+\u2460 \u7406\u89E3 \u2014 \u5148\u7406\u89E3\u95EE\u9898\u7A7A\u95F4\uFF08\u610F\u56FE\xB7\u7EA6\u675F\xB7\u8FB9\u754C\uFF09\uFF0C\u518D\u627F\u8BFA\u65B9\u6848\u3002
+  \u610F\u56FE\u4FDD\u5B58\uFF1A\u6536\u5230\u590D\u6742\u4EFB\u52A1\u65F6\uFF0C\u5148\u7528\u4E00\u53E5\u8BDD\u590D\u8FF0\u7528\u6237\u7684\u6838\u5FC3\u76EE\u6807\uFF08\u4E0D\u662F\u4F60\u7684\u6267\u884C\u8BA1\u5212\uFF09\uFF0C\u65B9\u5411\u4E0D\u786E\u5B9A\u65F6\u7B49\u7528\u6237\u786E\u8BA4\u518D\u52A8\u624B\u3002
+  \u5C42\u7EA7\u5224\u65AD\uFF1A\u7528\u6237\u8BF4\u7684\u662F\u4E1A\u52A1\u76EE\u6807\uFF08"\u5E2E\u6211\u505A X"\uFF09\u3001\u94FE\u8DEF\u95EE\u9898\uFF08"A \u548C B \u63A5\u4E0D\u4E0A"\uFF09\u3001\u8FD8\u662F\u4EE3\u7801\u6539\u52A8\uFF08"\u6539\u8FD9\u4E2A\u6587\u4EF6"\uFF09\uFF1F\u4E0D\u8981\u628A\u4E00\u4E2A\u5C42\u7EA7\u7684\u95EE\u9898\u964D\u7EA7\u5904\u7406\u2014\u2014\u7528\u6237\u8BF4"\u4EBA\u5BB6\u90FD\u63D0\u4EA4\u5B8C\u4E86"\u662F\u60C5\u51B5\u9648\u8FF0\uFF0C\u4E0D\u662F\u6E05\u573A\u6307\u4EE4\u3002
+  \u8BC1\u636E\u4F18\u5148\u7EA7\uFF1Agit \u63D0\u4EA4\u5386\u53F2 > \u6E90\u4EE3\u7801 > \u6D4B\u8BD5\u7ED3\u679C > \u4F1A\u8BDD\u8BB0\u5F55\u3002\u95EE"\u8FDB\u5EA6/\u505A\u4E86\u4EC0\u4E48/\u80FD\u529B\u73B0\u72B6"\u65F6\u7B2C\u4E00\u6B65\u5FC5\u770B git log/diff\uFF08\u5DF2\u53D1\u751F\u7684\u4E8B\u5B9E\uFF09\uFF0C\u4E0D\u662F .rivet/plans/\uFF08\u8BA1\u5212\uFF09\u6216 .rivet/knowledge/\uFF08\u7ECF\u9A8C\u603B\u7ED3\uFF09\u2014\u2014\u8BA1\u5212\u4E0D\u662F\u8FDB\u5EA6\uFF0C\u77E5\u8BC6\u5E93\u4E0D\u662F\u4EE3\u7801\u3002\u5B8C\u6210\u521D\u6B65\u7406\u89E3\u540E\uFF0C\u786E\u8BA4\u7528\u6237\u7684\u771F\u6B63\u76EE\u6807\u2014\u2014\u5931\u8D25\u4FE1\u53F7\uFF08\u8D85\u65F6/\u62A5\u9519\uFF09\u4F1A\u62C9\u504F\u4F60\u7684\u65B9\u5411\u3002\u8F93\u5165\u5305\u542B\u5916\u90E8\u65B9\u6848/\u8C03\u7814\uFF08\u6765\u81EA\u5176\u4ED6\u6A21\u578B\u6216\u975E\u672C\u9879\u76EE\u6765\u6E90\uFF09\u65F6\uFF1A\u5148 grep/read_file \u72EC\u7ACB\u6838\u9A8C\u5176\u5173\u4E8E\u672C\u4EE3\u7801\u5E93\u7684\u5173\u952E\u65AD\u8A00\uFF0C\u518D\u51B3\u5B9A\u91C7\u7EB3\u3002\u4E0D\u56E0\u683C\u5F0F\u5B8C\u6574\u6216\u8BED\u6C14\u81EA\u4FE1\u800C\u8DF3\u8FC7\u6838\u9A8C\uFF08\u65B9\u6CD5\u89C1 external-source-verification \u89C4\u5219\uFF09\u3002\u4E0A\u4E0B\u6587\u5145\u88D5\u65F6\u505A\u7406\u89E3\u548C\u89C4\u5212\u662F\u4F60\u7684\u4F18\u52BF\u3002
+
+\u2461 \u8C03\u7814 \u2014 \u8BFB\u76F8\u5173\u4EE3\u7801\u3001\u8C03\u7528\u65B9\u548C\u6D4B\u8BD5\u3002\u5F15\u7528\u4EE3\u7801\u7528 file_path:line_number \u683C\u5F0F\u3002\u6539\u524D\u5DF2\u5B58\u5728\u7684\u5931\u8D25\u4E0D\u5F52\u4F60\u3002
+  \u884C\u4E3A\u8BED\u4E49\u9A8C\u8BC1\uFF1A\u63A5\u7EBF/\u4F9D\u8D56\u67D0\u51FD\u6570\u7684\u884C\u4E3A\u524D\uFF0C\u63A5\u53E3\u7B7E\u540D\u4E0E\u6587\u6863\u63CF\u8FF0\u4E0D\u4F5C\u6570\u2014\u2014\u8981\u4E48\u8BFB\u5B83\u7684\u5185\u90E8\u5B9E\u73B0\uFF08switch \u5206\u652F/\u6B63\u5219/\u8FB9\u754C\u6761\u4EF6\uFF09\uFF0C\u8981\u4E48\u5199\u5FAE\u63A2\u9488\u5B9E\u6D4B\uFF08npx tsx -e \u4E00\u884C\u811A\u672C\uFF0C\u6216 .rivet/scratch/ \u4E0B\u7684\u4E00\u6B21\u6027\u6D4B\u8BD5\u6587\u4EF6\uFF09\u3002\u7ED3\u6784\u4FE1\u5FC3\uFF08\u63A5\u53E3\u5B58\u5728\u3001\u7B7E\u540D\u5339\u914D\uFF09\u2260 \u884C\u4E3A\u4FE1\u5FC3\uFF08\u8FD0\u884C\u65F6\u8BED\u4E49\u6B63\u786E\uFF09\uFF0C\u524D\u8005\u6765\u81EA\u63A5\u53E3\u9A8C\u8BC1\uFF0C\u540E\u8005\u53EA\u80FD\u6765\u81EA\u5B9E\u73B0\u9605\u8BFB\u6216\u5B9E\u6D4B\u300215 \u79D2\u7684\u63A2\u9488\u6BD4\u63A8\u65AD\u53EF\u9760\u3002
+\u2462 \u62C6\u89E3 \u2014 \u7406\u89E3\u5230\u4F4D\u540E\u518D\u62C6\u6B65\u9AA4\u30023+ \u6B65\u6216\u8DE8\u6587\u4EF6\u7684\u4EFB\u52A1\u5148\u7528 todo \u5DE5\u5177\u5199\u51FA\u6709\u5E8F\u6B65\u9AA4\u6E05\u5355\u518D\u52A8\u624B\uFF08\u6070\u597D\u4E00\u4E2A in_progress\uFF0C\u5B8C\u6210\u5373\u6807 completed\uFF09\u2014\u2014\u8BCA\u65AD\u7C7B\u4EFB\u52A1\u4E5F\u4E00\u6837\uFF0C\u6536\u5230\u62A5\u9519\u5148\u5EFA\u9AA8\u67B6\u518D\u5F00\u67E5\uFF0C\u6CA1\u6709\u663E\u5F0F\u6B65\u9AA4\u951A\u70B9\u65F6\u540E\u7EED\u5224\u65AD\u53EA\u80FD\u5728\u8111\u5185\u6563\u8DD1\u3001\u6613\u6F0F\u9A8C\u8BC1\u73AF\u8282\u3002\u573A\u666F\u679A\u4E3E\uFF1Abugfix/feature \u52A8\u624B\u524D\u5148\u628A\u9700\u6C42\u4E2D\u63D0\u5230\u7684\u5168\u90E8\u89E6\u53D1\u573A\u666F\u9010\u6761\u62BD\u51FA\uFF08"\u5F53 X \u65F6""\u4E5F\u5305\u62EC Y""reverse/\u5D4C\u5957/\u591A\u91CD\u60C5\u51B5"\u8FD9\u7C7B\u63AA\u8F9E\u5404\u7B97\u4E00\u6761\uFF09\u5199\u5165 todo\u2014\u2014\u53EA\u8986\u76D6\u4E3B\u573A\u666F\u662F\u6700\u5E38\u89C1\u7684\u4EA4\u4ED8\u7F3A\u53E3\uFF0C\u6BCF\u4E2A\u573A\u666F\u90FD\u8981\u6709\u5BF9\u5E94\u9A8C\u8BC1\u624D\u7B97\u6536\u5C3E\u3002\u4E0D\u8981\u5728\u4E0A\u4E0B\u6587\u7D27\u5F20\u65F6\u5F3A\u884C\u5B9E\u65BD\u3002"\u4E0A\u4E0B\u6587\u7D27\u5F20"\u5FC5\u987B\u4EE5 mirror \u7684 ctx \u5B57\u6BB5\u5B9E\u6D4B\u4E3A\u51C6\uFF08\u5B9E\u6D4B \u226570% \u624D\u7B97\uFF09\uFF0C\u4E0D\u51ED\u4F53\u611F\u2014\u201410% \u4F7F\u7528\u7387\u65F6\u5EFA\u8BAE\u65B0\u4F1A\u8BDD\u662F\u4E60\u60EF\u6027\u7126\u8651\uFF0C\u4E0D\u662F\u5BA1\u614E\u3002
+
+\u2463 \u5B9E\u65BD \u2014 \u6CBB\u6839\u4E0D\u6539\u6807\uFF0C\u641C\u800C\u4E0D\u731C\u3002\u5F00\u53D1\u5FAA\u73AF\uFF1A\u8BFB \u2192 \u6539 \u2192 diff \u2192 tsc + test \u2192 \u8BFB\u5931\u8D25\u518D\u6539\u3002\u4F60\u5199\u7684\u6D4B\u8BD5\u5931\u8D25\u5C31\u67E5\u6839\u56E0\u2014\u2014\u4E0D\u5F31\u5316\u6D4B\u8BD5\u8BA9\u5B83\u901A\u8FC7\u3002\u4FEE\u5BA1\u67E5\u6307\u51FA\u7684\u6D1E\u5148\u8BF4\u51FA\u8FDD\u53CD\u7684\u4E0D\u53D8\u91CF\uFF0Cgrep \u540C\u4E00\u4E0D\u53D8\u91CF\u7684\u6240\u6709\u8FDD\u53CD\u70B9\u4E00\u5E76\u4FEE\u2014\u2014\u4E0D\u70B9\u72B6\u4FEE\u590D\u3002
+\u2464 \u9A8C\u8BC1 \u2014 \u4E0D\u8FD0\u884C\u6D4B\u8BD5\u4E0D\u4EA4\u4ED8\uFF0C\u6D4B\u884C\u4E3A\u800C\u975E plumbing\u3002\u65B0\u529F\u80FD\u4E0E\u884C\u4E3A\u4FEE\u590D\u5148\u5199\u6D4B\u8BD5\uFF08node:test + node:assert/strict\uFF09\uFF0C\u955C\u50CF\u6E90\u7801\u7ED3\u6784\uFF1Bsetup \u4E2D\u65AD\u8A00\u524D\u7F6E\u6761\u4EF6\u2014\u2014\u9759\u9ED8\u7A7A\u64CD\u4F5C\u4F1A\u8BEF\u5BFC\u3002\u8DF3\u8FC7\u6D4B\u8BD5\u5FC5\u987B\u663E\u5F0F\u7ED9\u51FA\u4E00\u53E5\u8BDD\u7406\u7531\uFF08\u5982"\u7EAF\u5B88\u536B\u6539\u52A8\uFF0Ctypecheck \u5DF2\u8986\u76D6\u7B7E\u540D"\uFF09\uFF0C\u9759\u9ED8\u8DF3\u8FC7=\u8FDD\u89C4\uFF1B\u4E14"\u6D4B\u8BD5\u592A\u8D35"\u8FD9\u7C7B\u6210\u672C\u4F30\u8BA1\u672C\u8EAB\u662F\u65AD\u8A00\u2014\u2014\u5148\u82B1 15 \u79D2\u6253\u63A2\u9488\u5B9E\u6D4B\uFF08mock \u4E00\u4E2A fetch\u3001\u8DD1\u4E00\u4E2A\u7A7A\u6D4B\u8BD5\uFF09\u518D\u4E0B\u7ED3\u8BBA\uFF0C\u4E0D\u51ED\u76F4\u89C9\u5426\u51B3\u8F7B\u91CF\u6D41\u7A0B\u3002
+  \u524D\u7AEF/UI \u6539\u52A8\u7684\u9A8C\u8BC1\u95ED\u73AF\uFF1A\u6D4B\u8BD5\u901A\u8FC7 \u2260 \u6E32\u67D3\u6B63\u786E\u3002\u6539\u4E86 .tsx/.vue/.css/.html \u7B49 UI \u6587\u4EF6\uFF0C\u4EA4\u4ED8\u524D\u7528 browser_debug\uFF08\u82E5\u5728\u5DE5\u5177\u5217\u8868\uFF09\u6253\u5F00 dev server \u622A\u56FE\u770B\u5B9E\u9645\u6E32\u67D3 + console \u65E0\u65B0\u62A5\u9519\uFF1B\u6D89\u53CA\u4EA4\u4E92\u7684\u7528 click/type \u8D70\u4E00\u904D\u5173\u952E\u8DEF\u5F84\u3002\u6539\u524D\u5148\u622A\u4E00\u5F20\u505A\u57FA\u7EBF\uFF08screenshot { compare: true }\uFF09\uFF0C\u6539\u540E\u7528\u540C\u4E00\u53C2\u6570\u518D\u622A\u2014\u2014compare \u505A\u672C\u5730\u50CF\u7D20\u6BD4\u5BF9\uFF0C\u7ED9\u51FA\u5DEE\u5F02\u767E\u5206\u6BD4\u548C\u53D8\u5316\u533A\u57DF\u3002\u5982\u679C\u6539\u7684\u662F\u7279\u5B9A\u7EC4\u4EF6\uFF08\u5982 .sidebar\uFF09\uFF0C\u52A0 intent: ".sidebar"\u2014\u2014compare \u4F1A\u989D\u5916\u5224\u65AD\u53D8\u5316\u662F\u5426\u8D8A\u754C\uFF0C\u88C1\u51B3\u884C\u4F5C\u4E3A\u786E\u5B9A\u6027\u8BC1\u636E\u5199\u8FDB\u4EA4\u4ED8\u62A5\u544A\u3002browser_debug \u4E0D\u53EF\u7528\u6216\u65E0\u6CD5\u8D77 dev server \u65F6\u663E\u5F0F\u8BF4\u660E"\u6E32\u67D3\u672A\u9A8C\u8BC1"\u3002
+
+\u2465 \u6536\u5C3E \u2014 \u4EE3\u7801\u53EF\u8FD0\u884C\u540E\u624D\u505A\uFF1A\u6E05\u7406\u4E34\u65F6\u63A2\u9488\uFF08console.log/assert/debugger\uFF0C\u6B8B\u7559=\u672A\u5B8C\u6210\uFF1B.rivet/scratch/ \u662F\u4E00\u6B21\u6027\u63A2\u9488\u6587\u4EF6\u7684\u7EA6\u5B9A\u4F4D\u7F6E\uFF0C\u6536\u5C3E\u65F6\u6E05\u7A7A\u81EA\u5DF1\u521B\u5EFA\u7684\uFF09\u3001\u68C0\u67E5 import\u3001\u8DD1\u5168\u91CF\u7C7B\u578B\u68C0\u67E5\uFF08typecheck exit 0\uFF09\u3002\u6539\u4E86\u5BFC\u51FA\u63A5\u53E3/\u7B7E\u540D\u540E grep \u6D88\u8D39\u65B9\u786E\u8BA4\u65E0\u9057\u6F0F\u2014\u2014\u65B0\u589E\u80FD\u529B\u786E\u8BA4\u6709\u751F\u4EA7\u8C03\u7528\u65B9\u3001\u63A5\u53E3\u53D8\u66F4\u786E\u8BA4\u6240\u6709\u6D88\u8D39\u65B9\u7B7E\u540D\u540C\u6B65\u3002\u8FD9\u662F\u72EC\u7ACB\u9636\u6BB5\uFF0C\u4E0D\u662F\u9A8C\u8BC1\u7684\u9644\u5C5E\u2014\u2014\u9A8C\u8BC1\u901A\u8FC7\u4E0D\u4EE3\u8868\u6536\u5C3E\u5E72\u51C0\u3002
+
+\u8BCA\u65AD\u5FAA\u73AF\uFF08bug \u6392\u67E5\u4E13\u7528\uFF0C\u4E0E\u5F00\u53D1\u5FAA\u73AF\u5E76\u5B58\uFF09\uFF1A\u8BFB\u73B0\u8C61 \u2192 \u8BFB\u7591\u4F3C\u4EE3\u7801 \u2192 \u82E5\u9047\u6096\u8BBA\uFF08\u5DF2\u9A8C\u8BC1\u4E8B\u5B9E\u4E92\u76F8\u77DB\u76FE\uFF09\u2192 \u7ACB\u5373\u5199\u6700\u5C0F\u590D\u73B0\u6D4B\u8BD5\u9A71\u52A8\u7591\u4F3C\u51FD\u6570 \u2192 RED \u9501\u5B9A\u6839\u56E0 \u2192 \u6539 \u2192 GREEN\u3002
+  \u5173\u952E\u5DEE\u5F02\uFF1A\u5F00\u53D1\u5FAA\u73AF\u91CC\u6D4B\u8BD5\u5728"\u6539"\u4E4B\u540E\uFF08\u9A8C\u8BC1\u4FEE\u590D\uFF09\uFF1B\u8BCA\u65AD\u5FAA\u73AF\u91CC\u6D4B\u8BD5\u5728"\u6539"\u4E4B\u524D\uFF08\u5B9A\u4F4D\u6839\u56E0\uFF09\u3002
+  \u590D\u73B0\u6D4B\u8BD5\u662F\u6700\u5EC9\u4EF7\u7684\u51B3\u5B9A\u6027\u8BC1\u636E\u2014\u20143 \u5206\u949F\u5199\u7684\u63A2\u9488\u6BD4 6 \u4E2A\u6587\u4EF6\u7684\u63A8\u7406\u94FE\u66F4\u6709\u8BF4\u670D\u529B\u3002
+  \u6839\u56E0\u5BF9\u9F50\uFF1A\u4FEE\u590D\u5E94\u843D\u5728\u72B6\u6001\u88AB\u9519\u8BEF\u4EA7\u751F/\u7A81\u53D8\u7684\u4F4D\u7F6E\uFF0C\u4E0D\u662F\u75C7\u72B6\u663E\u73B0\u7684\u4F4D\u7F6E\u2014\u2014\u5728\u6D88\u8D39\u5904 copy/\u9632\u5FA1/\u515C\u5E95\u662F\u63A9\u76D6\uFF0C\u4E0D\u662F\u4FEE\u590D\u3002\u53EF\u64CD\u4F5C\u5224\u636E\uFF1A\u82E5\u4FEE\u590D\u70B9\u4E0E\u62A5\u9519\u6808\u6700\u6DF1\u4E00\u5C42\u81EA\u6709\u4EE3\u7801\u5E27\u4E0D\u5728\u540C\u4E00\u6A21\u5757\uFF0C\u5148\u89E3\u91CA\u4E3A\u4EC0\u4E48\u6839\u56E0\u4E0D\u5728\u90A3\u91CC\uFF0C\u518D\u52A8\u624B\u3002
+  \u624B\u6BB5\u9636\u68AF\uFF1Agrep/read \u53D6\u8BC1 \u2192 \u8BFB\u5185\u90E8\u5B9E\u73B0 \u2192 \u5FAE\u63A2\u9488\uFF08.rivet/scratch/\uFF09\u2192 \u6700\u5C0F\u590D\u73B0\u6D4B\u8BD5\uFF08RED\uFF09\u2192 git \u57FA\u7EBF\u5BF9\u7167\uFF08\u56DE\u5F52\u7C7B\u4F18\u5148\u8DF3\u5230\u8FD9\u7EA7\uFF09\u2192 \u591A\u89C6\u89D2\u3002\u4E0A\u4E00\u7EA7\u8FDE\u7EED 2 \u6B21\u65E0\u65B0\u4FE1\u606F\u5373\u5347\u7EA7\uFF1B\u4ECE\u5339\u914D\u95EE\u9898\u91CF\u7EA7\u7684\u5C42\u7EA7\u8FDB\u5165\u3002\u8FD0\u884C\u65F6\u7684 <evidence-obligation> \u5757\u4F1A\u968F\u72B6\u6001\u70B9\u540D\u5F53\u524D\u4E49\u52A1\u7684\u4E0B\u4E00\u52A8\u4F5C\uFF0C\u4EE5\u5B83\u4E3A\u51C6\uFF1B\u8BE6\u7EC6\u65B9\u6CD5\u8BBA recall_capsule(\u8BCA\u65AD\u9636\u68AF)\u3002
+
+\u7EA0\u6B63\u4E2D\u65AD\u89C4\u5219\uFF1A\u5F53\u7528\u6237\u7EA0\u6B63\u4F60\u7684\u7406\u89E3\u65F6\uFF0C\u505C\u6B62\u5F53\u524D\u884C\u52A8\u94FE\u2014\u2014\u5148\u7528\u4E00\u53E5\u8BDD\u786E\u8BA4\u4F60\u5BF9\u7EA0\u6B63\u7684\u7406\u89E3\uFF0C\u518D\u7EE7\u7EED\u3002\u4E0D\u8981\u7528\u65B0\u52A8\u4F5C\u8986\u76D6\u7EA0\u6B63\u4FE1\u53F7\u3002\u5F53\u4F60\u53D1\u73B0\u81EA\u5DF1\u5728\u7ED5\u8FC7\u9879\u76EE\u89C4\u5B9A\u6D41\u7A0B\u65F6\uFF08\u5982\u7ED5\u8FC7 deliver_task \u76F4\u63A5\u7528 raw git\uFF09\uFF0C\u505C\u4E0B\u6765\u2014\u2014\u8FD9\u901A\u5E38\u610F\u5473\u7740\u4F60\u5728\u8D70\u6377\u5F84\u800C\u975E\u89E3\u51B3\u95EE\u9898\u3002\u539F\u8DEF\u4E0D\u901A\u65F6\u5148\u786E\u8BA4\u7528\u6237\u610F\u56FE\uFF0C\u800C\u4E0D\u662F\u81EA\u5DF1\u627E\u66FF\u4EE3\u8DEF\u5F84\u3002
+
+\u81EA\u68C0\u95F8\u95E8\uFF08\u6BCF\u6B21\u6267\u884C\u590D\u6742\u4EFB\u52A1\u524D\u5FEB\u901F\u8FC7\uFF09\uFF1A
+- \u6211\u662F\u5426\u628A\u7528\u6237\u7684\u957F\u7A0B\u76EE\u6807\u538B\u7F29\u6210\u4E86\u5F53\u524D\u6700\u5BB9\u6613\u6267\u884C\u7684\u4EFB\u52A1\uFF1F
+- \u6211\u662F\u5426\u88AB\u67D0\u4E2A\u5931\u8D25\u4FE1\u53F7\uFF08\u8D85\u65F6/\u62A5\u9519\uFF09\u951A\u5B9A\uFF0C\u5FFD\u7565\u4E86\u7528\u6237\u771F\u6B63\u8981\u7684\u4E1C\u897F\uFF1F
+- \u7528\u6237\u5728\u4E0A\u4E00\u8F6E\u8BF4\u7684\u8BDD\uFF0C\u548C\u6211\u5F53\u524D\u8BA1\u5212\u4E4B\u95F4\u662F\u5426\u5B58\u5728\u672A\u89E3\u51B3\u7684\u77DB\u76FE\uFF1F
+- \u6211\u5373\u5C06\u58F0\u79F0"X \u4E0D\u5B58\u5728/\u7F3A\u5931/\u635F\u574F"\u2014\u2014\u662F\u5426\u5DF2\u7528\u81F3\u5C11\u4E24\u79CD\u72EC\u7ACB\u65B9\u5F0F\uFF08grep -r \u9012\u5F52\u641C\u7D22\u3001read_file \u8BFB\u6D88\u8D39\u7AEF\u3001\u6362\u7F16\u7801/charset \u91CD\u67E5\uFF09\u4EA4\u53C9\u9A8C\u8BC1\uFF1F\u5355\u6B21\u5DE5\u5177\u8F93\u51FA\u4E0D\u8DB3\u4EE5\u652F\u6491\u8D1F\u5411\u7ED3\u8BBA\u3002
+  \u4EFB\u4E00\u7B54\u300C\u662F\u300D\u2192 \u5148\u7528\u4E00\u53E5\u8BDD\u8BF4\u660E\u4F60\u8BC6\u522B\u7684\u4FE1\u53F7\u4E0E\u4FEE\u6B63\u65B9\u5411\uFF0C\u7136\u540E\u7EE7\u7EED\u63A8\u8FDB\uFF1B\u786E\u9700\u7528\u6237\u8F93\u5165\u624D\u80FD\u6D88\u89E3\u65F6\u624D\u95EE\uFF08\u81F3\u591A\u4E00\u4E2A\uFF09\uFF0C\u4E0D\u56E0\u81EA\u68C0\u7ED3\u679C\u9ED8\u8BA4\u505C\u8F66\u3002
+</workflow>
+
+<security>
+\u4E0D\u66B4\u9732 API key/token/\u5BC6\u94A5\u3002\u6587\u4EF6\u8DEF\u5F84\u4E0D\u8D85\u51FA\u9879\u76EE\u76EE\u5F55\u3002
+\u7834\u574F\u6027/\u4E0D\u53EF\u9006\u547D\u4EE4\u662F\u786C\u95F8\u95E8\uFF1A\u6267\u884C\u524D\u5FC5\u987B\u5148\u53D1\u4E00\u6761\u6D88\u606F\u8BF4\u6E05\u300C\u63A5\u4E0B\u6765\u505A\u4EC0\u4E48\xB7\u4E3A\u4EC0\u4E48\xB7\u5F71\u54CD\u4EC0\u4E48\u300D\uFF0C\u5E76\u7B49\u7528\u6237\u660E\u786E\u56DE\u8BDD\u786E\u8BA4\u540E\u624D\u80FD\u6267\u884C\u2014\u2014\u4E0D\u662F\u53D1\u5BA1\u6279\u5361\uFF0C\u662F\u8981\u7528\u6237\u4E3B\u52A8\u56DE\u590D\u300C\u786E\u8BA4/\u53EF\u4EE5/\u6267\u884C\u300D\u3002\u672A\u786E\u8BA4\u4E00\u5F8B\u7981\u6B62\u6267\u884C\u3002
+  \u8986\u76D6\uFF1Agit stash\uFF08\u542B pop/apply/drop\uFF09\u3001git reset --hard/--mixed\u3001git checkout -- / git restore\uFF08\u4E22\u5DE5\u4F5C\u533A\u6539\u52A8\uFF09\u3001git clean\u3001git push -f/--force\u3001git branch -D\u3001rm -rf\u3001\u8986\u76D6/\u5220\u9664\u5DF2\u6709\u6587\u4EF6\u3001DROP/TRUNCATE \u7B49\u6570\u636E\u5E93\u7834\u574F\u64CD\u4F5C\u3002
+  \u300C\u770B\u770B\u300D\u2260\u300C\u52A8\u624B\u300D\uFF1A\u7528\u6237\u8BA9\u4F60\u67E5\u770B/\u8BCA\u65AD\uFF08\u770B stash \u5185\u5BB9\u3001\u770B\u51B2\u7A81\u3001\u770B diff\uFF09\u65F6\uFF0C\u53EA\u62A5\u544A\u53D1\u73B0\u5E76\u7B49\u6307\u4EE4\uFF0C\u7981\u6B62\u987A\u624B stash/reset/\u8FD8\u539F\u53BB\u300C\u6E05\u5E72\u51C0\u300D\u3002
+  \u9A8C\u8BC1\u5931\u8D25\u65F6\u7981\u6B62\u7528 stash/reset/checkout \u6E05\u7A7A\u5DE5\u4F5C\u533A\u6765\u9A97\u8FC7\u9A8C\u8BC1\u2014\u2014\u5148\u5B9A\u4F4D\u6839\u56E0\uFF08\u5982\u6D4B\u8BD5\u975E\u9694\u79BB\u3001\u5E76\u53D1\u6C61\u67D3\uFF09\uFF0C\u4E0D\u53EF\u9006\u64CD\u4F5C\u524D\u540C\u6837\u8981\u5148\u786E\u8BA4\u3002
+  \u4F8B\u5916\uFF1Agoal \u547D\u4EE4\u7684\u957F\u7A0B\u81EA\u6CBB\u4EFB\u52A1\u5DF2\u83B7\u7528\u6237\u6388\u6743\uFF0C\u53EF\u6309\u65E2\u6709\u6743\u9650/\u5BA1\u6279\u4F53\u7CFB\u81EA\u52A8\u6267\u884C\uFF0C\u65E0\u9700\u9010\u6761\u56DE\u8BDD\u786E\u8BA4\u3002
+</security>
+
+<shared-worktree>
+\u591A\u4F1A\u8BDD\u5171\u4EAB\u5DE5\u4F5C\u533A\u3002\u4EA4\u4ED8\u95E8\u7981\uFF08deliver_task\uFF09\u4F1A\u81EA\u52A8\u8FFD\u8E2A\u6587\u4EF6\u5F52\u5C5E\uFF0C\u53EA\u63D0\u4EA4\u4F60\u672C\u6B21\u6539\u52A8\u7684\u6587\u4EF6\u3002
+\u5DF1\u65B9\u6587\u4EF6\u987B\u9A8C\u8BC1\u901A\u8FC7\uFF1B\u5916\u90E8\u6587\u4EF6\u7684\u5931\u8D25\u4E0D\u963B\u585E\u4F60\u7684\u4EA4\u4ED8\u3002
+\u4EA4\u4ED8\u524D\u8C03\u7528 deliver_task \u68C0\u67E5\u95E8\u7981\uFF08GREEN/YELLOW/RED\uFF09\uFF0CGREEN \u5373\u53EF\u63D0\u4EA4\u3002
+\u6BCF\u4E2A\u903B\u8F91\u5355\u5143\u5B8C\u6210\u540E\u7ACB\u5373 deliver_task commit=true \u63D0\u4EA4\uFF0C\u4E0D\u79EF\u7D2F\u4E0D\u76F8\u5173\u6539\u52A8\u3002\u901A\u5E38\u53EA\u4F20 commit=true + message\uFF0C\u4E0D\u4F20 files \u53C2\u6570\uFF08owned set \u7528\u76F8\u5BF9\u8DEF\u5F84\uFF0C\u4F20\u7EDD\u5BF9\u8DEF\u5F84\u4F1A\u5339\u914D\u5931\u8D25\uFF09\u3002\u82E5\u6D89\u53CA\u591A\u4E2A\u72EC\u7ACB\u6539\u52A8\uFF0C\u7528 files \u53C2\u6570\u5206\u6279\u63D0\u4EA4\u3002
+
+deliver_task \u53EA\u505A\u6240\u6709\u6743\u9694\u79BB\u63D0\u4EA4\u2014\u2014typecheck \u548C review \u7531\u4F60\u5728\u8C03\u7528\u524D\u72EC\u7ACB\u5B8C\u6210\u3002
+\u8C03\u7528\u524D\u81EA\u8DD1\u7684 typecheck/verify \u5931\u8D25\u65F6\uFF0C\u5148\u4FEE\u590D\u518D\u4EA4\u4ED8\uFF1B\u786E\u9700\u5E26\u9669\u4EA4\u4ED8\uFF0C\u4F20 review_level='L3' \u8BA9\u5BA1\u67E5\u5BF9\u9F50\u98CE\u9669\u3002
+\u7981\u6B62\u7528\u88F8 git commit / git add -A \u4EA4\u4ED8\uFF1Adeliver_task \u8D85\u65F6\u6216\u5931\u8D25\u65F6\uFF0C\u5148\u68C0\u67E5
+\u6587\u4EF6\u5F52\u5C5E\u4E0E\u51B2\u7A81\uFF0C\u518D\u7528 deliver_task \u91CD\u8BD5\uFF1B\u7ED5\u884C\u88F8 git \u4F1A\u628A\u5176\u4ED6\u4F1A\u8BDD\u7684\u6587\u4EF6\u5377\u5165\u63D0\u4EA4\u3002
+</shared-worktree>
+
+<git>
+\u65B0\u5EFA\u63D0\u4EA4\uFF0C\u6C38\u4E0D amend\u3002\u683C\u5F0F\uFF1Afeat/fix/refactor/docs/test/chore/perf\u3002\u4E0D force push main/master\u3002
+\u63D0\u4EA4\u540E\u5FC5\u987B\u5C55\u793A commit \u4FE1\u606F\uFF1A\u77ED hash + \u63D0\u4EA4\u6D88\u606F + \u6D89\u53CA\u6587\u4EF6\u3002
+</git>
+
+<delegation>
+\u59D4\u6D3E\u662F\u663E\u5F0F\u5DE5\u5177\uFF0C\u4E0D\u662F\u9ED8\u8BA4\u63A8\u8FDB\u65B9\u5F0F\u3002\u6838\u5FC3\u6539\u52A8\u8DEF\u5F84\u2014\u2014\u8981\u6539\u7684\u4EE3\u7801\u3001\u5B83\u7684\u8C03\u7528\u65B9\u548C\u6D4B\u8BD5\u2014\u2014\u7531\u6211\u81EA\u5DF1\u8BFB\uFF0C\u4E0D\u5916\u5305\u3002
+\u5355\u6B21 grep/read \u80FD\u5B8C\u6210\u7684\u4E0D\u59D4\u6D3E\uFF1B\u7981\u6B62\u7528 delegate_task \u628A\u5F53\u524D\u4E3B\u7EBF\u4EFB\u52A1\u4EA4\u7ED9\u5B50\u4EE3\u7406\uFF1B\u7528\u6237\u8BF4\u4E0D\u8981\u59D4\u6D3E\u65F6\uFF0C\u7981\u7528\u59D4\u6D3E\u5DE5\u5177\u3002
+
+\u4F55\u65F6\u59D4\u6D3E\uFF08\u6B63\u5411\u89E6\u53D1\uFF09\u2014\u2014
+\u4EE5\u4E0B\u573A\u666F delegate_task / delegate_batch \u7684\u6536\u76CA\u663E\u8457\u9AD8\u4E8E\u6210\u672C\uFF1A
+- \u9700\u8981\u5E76\u884C\u63A2\u67E5 3+ \u4E2A\u72EC\u7ACB\u6A21\u5757\u6216\u6587\u4EF6\u65F6\u2014\u2014\u53D1 code_scout \u5B50\u4EE3\u7406\u5404\u67E5\u4E00\u4E2A\u65B9\u5411\uFF0C\u6BD4\u4E32\u884C\u9010\u6587\u4EF6\u8BFB\u66F4\u5FEB
+- \u9700\u8981\u4ECE\u4E0D\u540C\u661F\u57DF\u89C6\u89D2\u4EA4\u53C9\u5BA1\u89C6\u540C\u4E00\u4E2A\u6539\u52A8\u65F6\u2014\u2014\u6307\u5B9A authority \u8BA9\u5B50\u4EE3\u7406\u5E26\u5165\u8BE5\u57DF\u65B9\u6CD5\u8BBA\uFF08\u5982 authority: "yaoguang" \u9A8C\u590D\u73B0\u8986\u76D6\u3001authority: "tianquan" \u5BA1\u67B6\u6784\u5C42\u6B21\uFF09
+- \u524D\u7F6E\u8C03\u7814\u9700\u8981\u7406\u89E3 3+ \u4E2A\u6587\u4EF6\u7684\u6574\u4F53\u7ED3\u6784\u65F6\u2014\u2014\u8C03\u7814\u672C\u8EAB\u4E0D\u6539\u6587\u4EF6\uFF0C\u53EA\u8BFB worker \u96F6\u6B63\u786E\u6027\u98CE\u9669
+
+\u5E76\u884C\u7F16\u6392\u9009\u578B\uFF08delegate_batch vs team\uFF09\u2014\u2014
+\u5224\u65AD\u6807\u51C6\u662F**\u662F\u5426\u9700\u8981\u8BA1\u5212\u6587\u6863\u4F5C\u4E3A\u957F\u671F\u8D44\u4EA7**\uFF1A\u8981\u5199\u6587\u4EF6\u3001\u8981\u7559\u8BA1\u5212\u7ED9\u540E\u7EED\u4F1A\u8BDD\u3001\u8981\u6587\u4EF6\u51B2\u7A81\u68C0\u6D4B/\u6CE2\u95F4\u95E8\u7981/\u5BA1\u67E5\u95E8 \u2192 plan_task + team_orchestrate\uFF1B\u53EA\u9700\u8981\u8FD9\u4E00\u6B21\u5E76\u884C\u52A0\u901F\uFF08\u8BCA\u65AD/\u4FA6\u5BDF/\u4F53\u68C0\u7C7B\u53EA\u8BFB\u4EFB\u52A1\uFF09\u2192 delegate_batch \u76F4\u63A5\u6D3E\u3002
+\u8BCA\u65AD\u7C7B\u59D4\u6D3E\u7684\u6C47\u603B\u4EA4\u4ED8\u5FC5\u987B\u662F\u5E26\u8BC1\u636E\u7684\u5B9E\u6D4B\u6E05\u5355\uFF08\u547D\u4EE4 exit code\u3001\u9010\u4E00\u6BD4\u5BF9\u6570\u91CF\u3001file:line\uFF09\uFF0C\u4E0D\u662F scout \u8F6C\u8FF0\u7684\u590D\u8FF0\u3002
+
+\u661F\u57DF authority \u7528\u6CD5\u2014\u2014
+delegate_task / delegate_batch \u53EF\u4F20 authority \u53C2\u6570\u8BA9\u5B50\u4EE3\u7406\u4EE5\u6307\u5B9A\u661F\u57DF\u8EAB\u4EFD\u63A8\u7406\uFF1A
+- \u53EF\u7528 ID\uFF1Atianquan\uFF08\u67B6\u6784\u79F0\u91CF\uFF09\u3001yaoguang\uFF08\u590D\u73B0\u9A8C\u8BC1\uFF09\u3001tianji\uFF08\u524D\u63D0\u8D28\u7591\uFF09\u3001tianxuan\uFF08\u8DE8\u57DF\u89C6\u89D2\uFF09\u3001tianfu\uFF08\u53D8\u66F4\u5B88\u62A4\uFF09\u3001tianliang\uFF08\u6267\u884C\u843D\u5730\uFF09\u3001pojun\uFF08\u63A2\u7D22\u7A81\u7834\uFF09\u3001fu\uFF08\u8BA4\u77E5\u8C03\u6821\uFF09\u3001wenqu\uFF08\u4EE3\u7801\u7F8E\u5B66\uFF09
+- \u53EA\u8BFB\u63A2\u67E5\u7528 profile: "code_scout"\uFF08\u4EE3\u7801\uFF09\u6216 "doc_scout"\uFF08\u6587\u6863\uFF09\uFF0Ckind: "code_search" \u6216 "doc_research"
+
+\u59D4\u6D3E\u540E\u9A8C\u8BC1\u7EAA\u5F8B\u2014\u2014
+- \u53EA\u8BFB worker \u8FD4\u56DE\u7684 findings \u662F"\u5F85\u6838\u9A8C\u5047\u8BBE"\uFF08evidenceStatus \u4E3A unverified\uFF09\uFF0C\u4E0D\u662F\u5DF2\u9A8C\u8BC1\u4E8B\u5B9E
+- \u5F15\u7528 worker \u53D1\u73B0\u5230\u5177\u4F53\u6587\u4EF6\u524D\uFF0C\u5FC5\u987B\u7528 read_file / grep \u72EC\u7ACB\u6838\u9A8C\u2014\u2014external-source-verification \u89C4\u5219\u540C\u6837\u9002\u7528\u4E8E\u5B50\u4EE3\u7406\u8F93\u51FA
+- worker \u5361\u4F4F\u6216\u8D85\u65F6\u65F6\uFF0C\u6807\u6CE8\u964D\u7EA7\u5E76\u7EE7\u7EED\u5185\u8054\u6267\u884C
+
+\u5927\u7ED3\u679C\u56DE\u62A5\uFF1Aworker \u8FD4\u56DE\u8D85 32K \u5B57\u7B26\u65F6\uFF0C\u5B8C\u6574\u7ED3\u679C\u4F1A\u5B58\u5165 artifact store\uFF0Cpacket \u4E2D\u4EC5\u4FDD\u7559\u6458\u8981\u3002\u9700\u8981\u5B8C\u6574\u7ED3\u679C\u65F6\u4F7F\u7528 read_section \u62C9\u53D6 artifact\u3002
+</delegation>
+`;
+var MODEL_CALIBRATIONS = {
+  deepseek: "<calibration>\u6539\u4EE3\u7801\u524D grep \u9A8C\u8BC1\u6D88\u8D39\u65B9\u4E0D\u88AB\u7834\u574F\u3002\u5BA1\u67E5/\u56DE\u7B54\u65F6\u5F15\u7528\u4EE3\u7801\u5B57\u6BB5\u503C\u3001\u51FD\u6570\u7B7E\u540D\u3001\u89E6\u53D1\u6761\u4EF6\u7684\u65AD\u8A00\u2014\u2014\u5148\u786E\u8BA4\u6700\u8FD1\u4E00\u8F6E\u662F\u5426 read_file \u6216 grep \u8FC7\u8BE5\u6587\u4EF6\u3002\u8DDD\u4ECA\u8D85\u8FC7 3 \u8F6E\u7684\u8BB0\u5FC6\u4E0D\u53EF\u9760\uFF0C\u7528\u4E00\u6761\u5DE5\u5177\u8C03\u7528\u786E\u8BA4\u518D\u4E0B\u7ED3\u8BBA\u3002\u8BB0\u5FC6\u662F\u6A21\u7CCA\u7684\uFF0C\u6700\u8FD1\u4E00\u6B21\u5DE5\u5177\u8F93\u51FA\u624D\u662F\u7269\u7406\u4E8B\u5B9E\u3002</calibration>",
+  mimo: "<calibration>\u4F60\u64C5\u957F\u5168\u666F\u63A2\u7D22\uFF0C\u4F46\u9700\u6536\u655B\uFF1A\u6BCF\u6B21\u63A2\u7D22\u8BBE\u5B9A\u660E\u786E\u76EE\u6807\uFF0C\u8FBE\u5230\u76EE\u6807\u540E\u505C\u6B62\u6269\u5C55\u3002\u63A2\u7D22\u7ED3\u679C\u7528\u4E00\u53E5\u8BDD\u7ED3\u8BBA\u6536\u675F\uFF0C\u518D\u51B3\u5B9A\u4E0B\u4E00\u6B65\u3002</calibration>",
+  glm: '<calibration>\u4F60\u64C5\u957F\u6392\u9664\u6CD5\u5B9A\u4F4D\u95EE\u9898\uFF0C\u4F46\u8981\u7528\u884C\u52A8\u6392\u9664\uFF0C\u4E0D\u7528\u63A8\u7406\u6392\u9664\u3002\u6000\u7591\u67D0\u4E2A\u65B9\u5411\u65F6\uFF0C\u4E0D\u8981\u5728\u63A8\u7406\u91CC\u628A\u5B83\u63A8\u5230\u5E95\u518D\u5426\u5B9A\u2014\u2014\u7ACB\u5373\u7528\u4E00\u6B21\u5DE5\u5177\uFF08grep/read_file/glob/\u5C0F\u6D4B\u8BD5/\u8FD0\u884C\u547D\u4EE4\uFF09\u5BF9\u8FD9\u4E2A\u5047\u8BBE\u6253\u63A2\u9488\u3001\u4EAE\u7EA2\u706F\uFF08\u5FEB\u901F\u8BC1\u4F2A\uFF09\uFF0C\u8BA9\u5DE5\u5177\u7ED3\u679C\u66FF\u4F60\u6392\u9664\uFF0C\u800C\u4E0D\u662F\u8111\u8865\u3002\u63A8\u7406\u91CC\u5192\u51FA"\u53E6\u4E00\u79CD\u53EF\u80FD\u2026\u8BA9\u6211\u518D\u60F3\u60F3\u53E6\u4E00\u4E2A\u65B9\u5411"\u65F6\uFF0C\u505C\u2014\u2014\u628A\u90A3\u4E2A\u65B9\u5411\u8BB0\u6210\u4E0B\u4E00\u8F6E\u7684\u63A2\u9488\uFF0C\u4E0D\u5728\u672C\u8F6E\u7EE7\u7EED\u63A8\u3002\u6BCF\u8F6E\u63A8\u7406\u53EA\u4EA7\u51FA\u4E24\u4EF6\u4E8B\uFF1A\u9009\u5B9A\u4E0B\u4E00\u4E2A\u8981\u9A8C\u8BC1\u7684\u5047\u8BBE\u3001\u7528\u54EA\u4E2A\u5DE5\u5177\uFF0C\u7136\u540E\u7ACB\u523B\u8F93\u51FA\u5DE5\u5177\u8C03\u7528\u3002\u4E0D\u8981\u5728\u63A8\u7406\u91CC\u5199\u5B8C\u6574\u4EE3\u7801\uFF1A\u8981\u5199\u4EE3\u7801\u5C31\u76F4\u63A5\u7528 edit/write \u5DE5\u5177\u843D\u5730\uFF0C\u63A8\u7406\u91CC\u6700\u591A\u4E00\u53E5"\u6539\u54EA\u91CC\u3001\u4EC0\u4E48\u601D\u8DEF"\u3002\n\n\u4E0D\u8981\u628A"\u7A77\u5C3D\u67E5\u8BC1"\u7406\u89E3\u4E3A\u65E0\u9650\u5DE5\u5177\u8C03\u7528\u3002\u540C\u4E00\u5DE5\u5177\u540C\u4E00\u9519\u8BEF\u8FDE\u7EED 2 \u6B21\u65F6\uFF0C\u505C\u6B62\u53D8\u4F53\u91CD\u8BD5\uFF0C\u6539\u7528\u4E0D\u540C\u8BC1\u636E\u8DEF\u5F84\uFF1B\u4E0D\u540C\u8DEF\u5F84\u4E5F\u88AB\u963B\u65AD\u65F6\uFF0C\u62A5\u544A\u963B\u65AD\u70B9\u548C\u5DF2\u77E5\u8BC1\u636E\u3002\u6BCF\u8F6E\u6700\u591A\u56F4\u7ED5\u4E00\u4E2A\u5047\u8BBE\u67E5 3 \u4E2A\u5173\u952E\u8BC1\u636E\uFF0C\u8BC1\u636E\u8DB3\u591F\u65F6\u6536\u675F\u7ED3\u8BBA\uFF0C\u4E0D\u8981\u4E3A\u8986\u76D6\u6240\u6709\u53EF\u80FD\u6027\u7EE7\u7EED\u6269\u5C55\u3002\n\n\u5206\u5C42\u4E0B\u8FBE\u76EE\u6807\u2014\u2014\u8BA1\u5212\u9636\u6BB5\uFF1A\u4EA7\u51FA"\u5047\u8BBE \u2192 \u63A2\u9488\uFF08\u600E\u4E48\u9A8C\uFF09\u2192 \u9884\u671F\u7EA2/\u7EFF\u706F"\u7684\u6E05\u5355\uFF0C\u4E00\u6B21\u63A8\u7406\u7ED9\u51FA\u8BA1\u5212\u9AA8\u67B6\u5373\u6536\u675F\uFF0C\u7528 todo \u843D\u5730\uFF0C\u4E0D\u5728\u8111\u5185\u9884\u6F14\u6240\u6709\u5206\u652F\u3002\u5B9E\u65BD\u9636\u6BB5\uFF1A\u6BCF\u8F6E\u53EA\u63A8\u8FDB\u4E00\u4E2A todo\uFF0C\u5148\u6253\u63A2\u9488\u786E\u8BA4\u524D\u63D0\u518D\u52A8\u624B\uFF0C\u52A8\u624B\u5373\u8C03\u5DE5\u5177\u3002\n\n\u6B65\u9AA4\u7EAA\u5F8B\uFF1A\u591A\u6B65\u4EFB\u52A1\uFF08\u22652 \u4E2A\u5DE5\u5177\u8C03\u7528\u624D\u80FD\u5B8C\u6210\uFF09\u5148\u5EFA todo \u5217\u8868\u518D\u6267\u884C\u3002\u6BCF\u8F6E\u53EA\u5904\u7406\u4E00\u4E2A todo \u6B65\u9AA4\u2014\u2014\u63A8\u7406\u805A\u7126\u5F53\u524D\u6B65\u9AA4\u7684\u6267\u884C\uFF0C\u4E0D\u91CD\u65B0\u5BA1\u89C6\u6574\u4E2A\u4EFB\u52A1\u7684\u5168\u8C8C\u3002\u5B8C\u6210\u4E00\u4E2A\u6B65\u9AA4\u540E\u6807\u8BB0\u5B8C\u6210\uFF0C\u4E0B\u4E00\u8F6E\u76F4\u63A5\u8FDB\u5165\u4E0B\u4E00\u4E2A\u6B65\u9AA4\uFF0C\u4E0D\u8981\u5728\u63A8\u7406\u4E2D\u91CD\u590D\u5DF2\u5B8C\u6210\u7684\u5206\u6790\u3002\u8FD9\u6837\u6BCF\u8F6E\u63A8\u7406\u77ED\u800C\u7CBE\u786E\uFF0C\u907F\u514D\u5355\u8F6E\u63A8\u7406\u8FC7\u957F\u5BFC\u81F4\u8D85\u65F6\u3002</calibration>'
+};
+function buildSystemPrompt(ctx) {
+  const base = ctx.audience === "subagent" ? buildSubagentSystemPrompt(BASE_PROMPT, ctx.tools) : BASE_PROMPT;
+  const calibration = ctx.modelFamily ? MODEL_CALIBRATIONS[ctx.modelFamily] : void 0;
+  if (calibration) return base + "\n\n" + calibration;
+  return base;
+}
+function detectModelFamily(modelName) {
+  const lower = modelName.toLowerCase();
+  if (lower.includes("deepseek")) return "deepseek";
+  if (lower.includes("mimo")) return "mimo";
+  if (lower.includes("glm")) return "glm";
+  if (lower.includes("gpt") || lower.includes("o1") || lower.includes("o3") || lower.includes("o4")) return "openai";
+  if (lower.includes("claude") || lower.includes("opus") || lower.includes("sonnet") || lower.includes("haiku")) return "anthropic";
+  return "unknown";
+}
+
+// src/prompt/engine.ts
+init_esm_shims();
+
+// src/compact/semantic-prune.ts
+init_esm_shims();
+var JUNK_DIR_RE = /(?:__pycache__|node_modules|\.git\/|\.venv|\.mypy_cache|\.pytest_cache|\.next\/|dist\/|build\/|\.tox)/;
+var TEST_PASS_RE = /^\s*[✓✔●◌⊙].*\(\d+\s*ms\)\s*$|^\s*(?:PASS|✓|✔)\s+.+/;
+function pruneJunkDirs(content) {
+  const lines = content.split("\n");
+  if (lines.length < 5) return content;
+  const junkLines = lines.filter((l) => JUNK_DIR_RE.test(l));
+  if (junkLines.length < 3) return content;
+  const kept = lines.filter((l) => !JUNK_DIR_RE.test(l));
+  kept.push(`[${junkLines.length} junk directory entries removed]`);
+  return kept.join("\n");
+}
+function pruneTestOutput(content) {
+  if (!content.includes("pass") && !content.includes("\u2713") && !content.includes("\u2714")) return content;
+  const lines = content.split("\n");
+  if (lines.length < 10) return content;
+  const passLines = [];
+  for (let i = 0; i < lines.length; i++) {
+    if (TEST_PASS_RE.test(lines[i])) passLines.push(i);
+  }
+  if (passLines.length < 5) return content;
+  const kept = lines.filter((_, i) => !passLines.includes(i));
+  kept.push(`[${passLines.length} passing test lines removed]`);
+  return kept.join("\n");
+}
+var QUERY_TOOLS = /* @__PURE__ */ new Set(["grep", "glob", "read_file", "semantic_search", "search"]);
+function queryKey(toolName, args) {
+  if (!QUERY_TOOLS.has(toolName)) return null;
+  switch (toolName) {
+    case "grep":
+    case "glob":
+    case "semantic_search":
+    case "search": {
+      const pattern = typeof args.pattern === "string" ? args.pattern : typeof args.query === "string" ? args.query : typeof args.regex === "string" ? args.regex : void 0;
+      if (!pattern) return null;
+      const path = typeof args.path === "string" ? args.path : "";
+      const glob = typeof args.glob === "string" ? args.glob : "";
+      const paths = Array.isArray(args.paths) ? args.paths.filter((p) => typeof p === "string").join(",") : "";
+      return { compound: `${toolName}:${[pattern, path, glob, paths].join("|")}`, pattern };
+    }
+    case "read_file": {
+      const filePath = typeof args.file_path === "string" ? args.file_path : "";
+      if (!filePath) return null;
+      const offset = typeof args.offset === "number" ? `:${args.offset}` : "";
+      const limit = typeof args.limit === "number" ? `:${args.limit}` : "";
+      return { compound: `${toolName}:${filePath}${offset}${limit}`, pattern: filePath };
+    }
+    default:
+      return null;
+  }
+}
+function semanticPruneLayer1(messages, anchorCount) {
+  if (messages.length <= anchorCount) return { messages, prunedCount: 0, savedChars: 0 };
+  let prunedCount = 0;
+  let savedChars = 0;
+  const toolCallIndex = /* @__PURE__ */ new Map();
+  for (let i = anchorCount; i < messages.length; i++) {
+    const msg = messages[i];
+    if (msg.role === "assistant") {
+      const aMsg = msg;
+      if (aMsg.tool_calls) {
+        for (const tc of aMsg.tool_calls) {
+          toolCallIndex.set(tc.id, { name: tc.function.name, args: tc.function.arguments });
+        }
+      }
+    }
+  }
+  const latestByKey = /* @__PURE__ */ new Map();
+  for (let i = messages.length - 1; i >= anchorCount; i--) {
+    const msg = messages[i];
+    if (msg.role !== "tool") continue;
+    const info = toolCallIndex.get(msg.tool_call_id);
+    if (!info) continue;
+    let args = {};
+    try {
+      args = JSON.parse(info.args);
+    } catch {
+      continue;
+    }
+    const key = queryKey(info.name, args);
+    if (!key) continue;
+    if (!latestByKey.has(key.compound)) {
+      latestByKey.set(key.compound, i);
+    }
+  }
+  const result = messages.map((msg, idx) => {
+    if (idx < anchorCount) return msg;
+    if (msg.role !== "tool") return msg;
+    if (msg.content.startsWith("[")) return msg;
+    const toolInfo = toolCallIndex.get(msg.tool_call_id);
+    const toolName = toolInfo?.name;
+    let newContent = msg.content;
+    const origLen = newContent.length;
+    if (toolInfo && latestByKey.size > 0) {
+      let args = {};
+      try {
+        args = JSON.parse(toolInfo.args);
+      } catch {
+      }
+      const key = queryKey(toolName, args);
+      if (key && latestByKey.get(key.compound) !== idx) {
+        newContent = `[outdated ${toolName} for "${key.pattern.slice(0, 40)}", see later result]`;
+      }
+    }
+    if (origLen < 200 && newContent === msg.content) return msg;
+    if (toolName === "list_dir" || toolName === "glob" || toolName === "find_files") {
+      newContent = pruneJunkDirs(newContent);
+    }
+    if (toolName === "bash") {
+      newContent = pruneTestOutput(newContent);
+    }
+    if (newContent.length < origLen) {
+      prunedCount++;
+      savedChars += origLen - newContent.length;
+      return { ...msg, content: newContent };
+    }
+    return msg;
+  });
+  return { messages: prunedCount > 0 ? result : messages, prunedCount, savedChars };
+}
+function pruneOutdatedQueryResults(messages, anchorCount) {
+  return semanticPruneLayer1(messages, anchorCount);
+}
+
+// src/compact/staleness-detect.ts
+init_esm_shims();
+var LAG_STEPS = 3;
+var MIN_CONTENT_CHARS = 500;
+function extractFileInfo(args) {
+  try {
+    const parsed = JSON.parse(args);
+    const path = parsed.file_path || parsed.path || parsed.file;
+    if (!path) return void 0;
+    if (parsed.file_path !== void 0 && (parsed.offset !== void 0 || parsed.limit !== void 0)) {
+      return { path, offset: parseOptionalInt(parsed.offset), limit: parseOptionalInt(parsed.limit) };
+    }
+    return { path };
+  } catch {
+    return void 0;
+  }
+}
+function isReferenced(toolContent, assistantTexts) {
+  const lines = toolContent.split("\n").filter((l) => l.trim().length > 20);
+  if (lines.length === 0) return true;
+  const samples = lines.slice(0, 3);
+  const joined = assistantTexts.join(" ");
+  for (const sample of samples) {
+    const snippet = sample.trim().slice(0, 50);
+    if (joined.includes(snippet)) return true;
+  }
+  return false;
+}
+function roughTokens(msg) {
+  const text = typeof msg.content === "string" ? msg.content : "";
+  const calls = msg.tool_calls;
+  const callsJson = calls ? JSON.stringify(calls) : "";
+  return Math.ceil((text.length + callsJson.length) / 4);
+}
+function computeSuffixTokens(messages) {
+  const suffix = new Array(messages.length);
+  let accumulated = 0;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    suffix[i] = accumulated;
+    accumulated += roughTokens(messages[i]);
+  }
+  return suffix;
+}
+function detectStaleness(messages, anchorCount = CACHE_ANCHOR_MESSAGES, options) {
+  const fileReads = /* @__PURE__ */ new Map();
+  const toolCallInfo = /* @__PURE__ */ new Map();
+  for (let i = messages.length - 1; i >= anchorCount; i--) {
+    const msg = messages[i];
+    if (msg.role === "assistant" && msg.tool_calls) {
+      for (const tc of msg.tool_calls) {
+        const info = {
+          name: tc.function.name,
+          args: tc.function.arguments
+        };
+        if (tc.function.name === "read_file" || tc.function.name === "grep") {
+          info.fileInfo = extractFileInfo(tc.function.arguments);
+          if (info.fileInfo) {
+            const reads = fileReads.get(info.fileInfo.path) ?? [];
+            reads.push({ index: i + 1, offset: info.fileInfo.offset, limit: info.fileInfo.limit });
+            fileReads.set(info.fileInfo.path, reads);
+          }
+        }
+        toolCallInfo.set(tc.id, info);
+      }
+    }
+  }
+  const assistantIndices = [];
+  for (let i = messages.length - 1; i >= anchorCount; i--) {
+    if (messages[i].role === "assistant") assistantIndices.push(i);
+  }
+  const suffixLimit = options?.suffixTokenLimit;
+  const suffixTokens = suffixLimit !== void 0 ? computeSuffixTokens(messages) : void 0;
+  let supersededCount = 0;
+  let unreferencedCount = 0;
+  let freedChars = 0;
+  const result = messages.map((msg, idx) => {
+    if (idx < anchorCount) return msg;
+    if (msg.role !== "tool") return msg;
+    if (msg.content.length < MIN_CONTENT_CHARS) return msg;
+    if (msg.content.startsWith("[")) return msg;
+    if (suffixLimit !== void 0 && suffixTokens !== void 0 && suffixTokens[idx] > suffixLimit) return msg;
+    const assistantTurnsAfter = assistantIndices.filter((ai) => ai > idx).length;
+    if (assistantTurnsAfter < LAG_STEPS) return msg;
+    const info = toolCallInfo.get(msg.tool_call_id);
+    if (!info) return msg;
+    if (info.name === "read_file" || info.name === "grep") {
+      const fileInfo = info.fileInfo;
+      if (fileInfo) {
+        const reads = fileReads.get(fileInfo.path) ?? [];
+        const laterReads = reads.filter((r) => r.index > idx);
+        const isSuperseded = info.name === "read_file" ? laterReads.some((r) => rangeContains(r, fileInfo)) : laterReads.length > 0;
+        if (isSuperseded) {
+          supersededCount++;
+          freedChars += msg.content.length;
+          return {
+            ...msg,
+            content: `[superseded: ${info.name} ${fileInfo.path.split("/").pop()} \u2014 re-read at later step]`
+          };
+        }
+      }
+    }
+    const subsequentAssistantText = [];
+    for (let j = idx + 1; j < messages.length; j++) {
+      if (messages[j].role === "assistant") {
+        const aMsg = messages[j];
+        if (aMsg.content) subsequentAssistantText.push(aMsg.content);
+      }
+    }
+    if (subsequentAssistantText.length >= LAG_STEPS && !isReferenced(msg.content, subsequentAssistantText)) {
+      unreferencedCount++;
+      freedChars += msg.content.length;
+      return {
+        ...msg,
+        content: `[unreferenced: ${info.name} result (${msg.content.length} chars) \u2014 not cited in subsequent reasoning]`
+      };
+    }
+    return msg;
+  });
+  return {
+    messages: supersededCount + unreferencedCount > 0 ? result : messages,
+    supersededCount,
+    unreferencedCount,
+    freedChars
+  };
+}
+
+// src/prompt/appendix-anatomy.ts
+init_esm_shims();
+function summarizeAppendixParts(parts) {
+  let cvmChars = 0;
+  let keepChars = 0;
+  const cvmBySource = {};
+  for (const p of parts) {
+    if (p.source) {
+      cvmChars += p.content.length;
+      cvmBySource[p.source] = (cvmBySource[p.source] ?? 0) + p.content.length;
+    } else {
+      keepChars += p.content.length;
+    }
+  }
+  return { blocks: parts.length, partsChars: cvmChars + keepChars, cvmChars, keepChars, cvmBySource };
+}
+
+// src/context/payload-diagnostic.ts
+init_esm_shims();
+var SECTION_RE = /<([a-zA-Z][\w-]*)(?:\s[^>]*)?(?:\/>|>[\s\S]*?<\/\1>)/g;
+var LARGE_VOLATILE_PAYLOAD_CHARS = 12e3;
+function estimateContextTokens(text) {
+  if (text.length === 0) return 0;
+  return Math.ceil(text.length / 4);
+}
+function lineCount(text) {
+  if (text.length === 0) return 0;
+  return text.split("\n").length;
+}
+function countActiveClaims(section) {
+  const match = section.match(/<active-claims\b[^>]*\bcount="(\d+)"/);
+  if (!match) return null;
+  return Number.parseInt(match[1], 10);
+}
+function wasteCandidatesForSection(stat, sectionText) {
+  const candidates = [];
+  if (!stat.present) return candidates;
+  if (stat.id === "project-instructions" && stat.chars > 6e3) {
+    candidates.push({
+      id: stat.id,
+      chars: stat.chars,
+      reason: "large stable volatile section",
+      recommendation: "split project instructions into always-on core plus task-routed details"
+    });
+  }
+  if (stat.id === "active-claims") {
+    const count = countActiveClaims(sectionText) ?? 0;
+    if (stat.chars > 2500 || count > 8) {
+      candidates.push({
+        id: stat.id,
+        chars: stat.chars,
+        reason: count > 8 ? `${count} claims injected` : "large active claims section",
+        recommendation: "apply active-claim relevance gate and keep only current-task claims"
+      });
+    }
+  }
+  if (stat.id === "git-status" && stat.chars > 1200) {
+    candidates.push({
+      id: stat.id,
+      chars: stat.chars,
+      reason: "large git status section",
+      recommendation: "summarize dirty file counts and show only task-relevant files by default"
+    });
+  }
+  if (stat.id === "historical-lessons" && stat.chars > 800) {
+    candidates.push({
+      id: stat.id,
+      chars: stat.chars,
+      reason: "large historical lessons section",
+      recommendation: "rank playbook lessons by current task relevance before injection"
+    });
+  }
+  return candidates;
+}
+function stripOuterContext(block) {
+  const trimmed = block.trim();
+  const match = trimmed.match(/^<context>\s*([\s\S]*?)\s*<\/context>$/);
+  return match ? match[1] : block;
+}
+function analyzeVolatilePayload(block) {
+  const body = stripOuterContext(block);
+  const sections = /* @__PURE__ */ new Map();
+  for (const match of body.matchAll(SECTION_RE)) {
+    const id = match[1];
+    if (id === "context") continue;
+    const text = match[0];
+    const existing = sections.get(id);
+    if (existing) {
+      sections.set(id, { id, text: `${existing.text}
+${text}` });
+    } else {
+      sections.set(id, { id, text });
+    }
+  }
+  const stats = [...sections.values()].map((section) => ({
+    id: section.id,
+    chars: section.text.length,
+    estimatedTokens: estimateContextTokens(section.text),
+    lines: lineCount(section.text),
+    present: true
+  })).sort((a, b) => b.chars - a.chars || a.id.localeCompare(b.id));
+  const wasteCandidates = stats.flatMap((stat) => wasteCandidatesForSection(stat, sections.get(stat.id)?.text ?? ""));
+  if (block.length > LARGE_VOLATILE_PAYLOAD_CHARS) {
+    wasteCandidates.push({
+      id: "total",
+      chars: block.length,
+      reason: "large volatile payload",
+      recommendation: "enable context hygiene gates for claims, git status, lessons, and project instructions"
+    });
+  }
+  return {
+    totalChars: block.length,
+    estimatedTokens: estimateContextTokens(block),
+    sections: stats,
+    wasteCandidates
+  };
+}
+function formatCount(value) {
+  if (value >= 1e3) return `${(value / 1e3).toFixed(1)}k`;
+  return String(value);
+}
+function formatVolatilePayloadReport(report) {
+  const lines = [
+    "Context Payload",
+    `Total: ${formatCount(report.totalChars)} chars (~${formatCount(report.estimatedTokens)} tokens)`
+  ];
+  if (report.sections.length === 0) {
+    lines.push("Sections: none");
+  } else {
+    lines.push("Sections:");
+    for (const section of report.sections) {
+      lines.push(`  ${section.id.padEnd(22)} ${formatCount(section.chars).padStart(7)} chars  ~${formatCount(section.estimatedTokens).padStart(6)} tok  ${section.lines} lines`);
+    }
+  }
+  if (report.wasteCandidates.length > 0) {
+    lines.push("Waste candidates:");
+    for (const candidate of report.wasteCandidates) {
+      lines.push(`  ${candidate.id}: ${candidate.reason}; ${candidate.recommendation}`);
+    }
+  } else {
+    lines.push("Waste candidates: none");
+  }
+  return lines.join("\n");
+}
+
+// src/prompt/fingerprint.ts
+init_esm_shims();
+import { createHash } from "crypto";
+function sha256(input) {
+  return createHash("sha256").update(input).digest("hex");
+}
+function computeFingerprint(systemText, tools, stableVolatileBlock = "") {
+  const systemSha256 = sha256(systemText);
+  const toolsSha256 = tools && tools.length > 0 ? sha256(stableStringify([...tools].sort((a, b) => a.name.localeCompare(b.name)))) : sha256("");
+  const stableVolatileSha256 = sha256(stableVolatileBlock);
+  const combinedSha256 = sha256(`${systemSha256}:${toolsSha256}:${stableVolatileSha256}`);
+  return { systemSha256, toolsSha256, stableVolatileSha256, combinedSha256 };
+}
+function detectDrift(baseline, current) {
+  if (baseline.combinedSha256 === current.combinedSha256) return null;
+  const systemChanged = baseline.systemSha256 !== current.systemSha256;
+  const toolsChanged = baseline.toolsSha256 !== current.toolsSha256;
+  const stableVolatileChanged = baseline.stableVolatileSha256 !== current.stableVolatileSha256;
+  const parts = [];
+  if (systemChanged) parts.push("system prompt");
+  if (toolsChanged) parts.push("tool definitions");
+  if (stableVolatileChanged) parts.push("stable volatile context");
+  const message = `Prefix cache drift detected: ${parts.join(" and ")} changed`;
+  return { systemChanged, toolsChanged, stableVolatileChanged, message };
+}
+
+// src/prompt/field-habituation.ts
+init_esm_shims();
+import { createHash as createHash2 } from "crypto";
+var ALPHA_TABLE = {
+  explore: 0.1,
+  // ~15 turns to habituate
+  plan: 0.2,
+  // ~7 turns
+  execute: 0.35,
+  // ~4 turns
+  verify: 0.3,
+  // ~5 turns
+  deliver: 0.4
+  // ~3 turns
+};
+var DEFAULT_ALPHA = 0.2;
+function sha256short(input) {
+  return createHash2("sha256").update(input).digest("hex").slice(0, 16);
+}
+function getAlpha(phaseHint) {
+  if (phaseHint) {
+    const rate = ALPHA_TABLE[phaseHint];
+    if (rate !== void 0) return rate;
+  }
+  return DEFAULT_ALPHA;
+}
+var FieldHabituationTracker = class {
+  fields = /* @__PURE__ */ new Map();
+  promotionThreshold;
+  decayRate;
+  legacyThreshold;
+  constructor(config) {
+    if (config.threshold !== void 0 && config.promotionThreshold === void 0) {
+      this.legacyThreshold = config.threshold;
+      this.promotionThreshold = 0.8;
+      this.decayRate = 0.3;
+    } else {
+      this.legacyThreshold = null;
+      this.promotionThreshold = config.promotionThreshold ?? 0.8;
+      this.decayRate = config.decayRate ?? 0.3;
+    }
+  }
+  recordTurn(fieldValues, phaseHint) {
+    const alpha = getAlpha(phaseHint);
+    const useLegacy = this.legacyThreshold !== null;
+    const seen = /* @__PURE__ */ new Set();
+    for (const [name, content] of Object.entries(fieldValues)) {
+      seen.add(name);
+      const hash = sha256short(content);
+      const existing = this.fields.get(name);
+      if (!existing) {
+        const state = {
+          hash,
+          content,
+          stableCount: useLegacy ? 1 : 0,
+          confidence: useLegacy ? 0 : alpha,
+          habituated: false
+        };
+        if (useLegacy && this.legacyThreshold <= 1) {
+          state.habituated = true;
+        }
+        this.fields.set(name, state);
+        continue;
+      }
+      if (existing.hash === hash) {
+        if (useLegacy) {
+          existing.stableCount++;
+          if (existing.stableCount >= this.legacyThreshold && !existing.habituated) {
+            existing.habituated = true;
+          }
+        } else {
+          existing.confidence += (1 - existing.confidence) * alpha;
+          if (existing.confidence >= this.promotionThreshold && !existing.habituated) {
+            existing.habituated = true;
+          }
+        }
+      } else {
+        existing.hash = hash;
+        existing.content = content;
+        if (useLegacy) {
+          existing.stableCount = 1;
+        } else {
+          existing.confidence = alpha;
+        }
+        existing.habituated = false;
+      }
+    }
+    for (const [name, state] of this.fields) {
+      if (!seen.has(name)) {
+        if (useLegacy) {
+          state.hash = sha256short("");
+          state.content = "";
+          state.stableCount = 0;
+          state.habituated = false;
+        } else {
+          state.confidence *= 1 - this.decayRate;
+          if (state.habituated && state.confidence < this.promotionThreshold) {
+            state.habituated = false;
+          }
+        }
+      }
+    }
+  }
+  getHabituated() {
+    const result = /* @__PURE__ */ new Set();
+    for (const [name, state] of this.fields) {
+      if (state.habituated) result.add(name);
+    }
+    return result;
+  }
+  getActive() {
+    const result = /* @__PURE__ */ new Set();
+    for (const [name, state] of this.fields) {
+      if (!state.habituated) result.add(name);
+    }
+    return result;
+  }
+  getHabituatedContent() {
+    const result = /* @__PURE__ */ new Map();
+    for (const [name, state] of this.fields) {
+      if (state.habituated) result.set(name, state.content);
+    }
+    return result;
+  }
+  /**
+   * Immediately promote a field to habituated state, bypassing the
+   * confidence accumulation period. Use for fields known to be session
+   * constants on exact-prefix-cache models.
+   * If the field hasn't been recorded yet, creates it with the given content.
+   * Returns true if the field was promoted (false if already habituated).
+   *
+   * NOTE: currently has no callers — star-domain (its original use) is now folded
+   * directly into the frozen prefix (volatile.ts / engine.setActiveDomain) rather
+   * than promoted through habituation. Kept as a general-purpose fast-path for any
+   * future session-constant field.
+   */
+  immediatePromote(name, content) {
+    const hash = sha256short(content);
+    const existing = this.fields.get(name);
+    if (existing) {
+      if (existing.habituated && existing.hash === hash) return false;
+      existing.hash = hash;
+      existing.content = content;
+      existing.confidence = 1;
+      existing.stableCount = this.legacyThreshold ?? 999;
+      existing.habituated = true;
+      return true;
+    }
+    this.fields.set(name, {
+      hash,
+      content,
+      stableCount: this.legacyThreshold ?? 999,
+      confidence: 1,
+      habituated: true
+    });
+    return true;
+  }
+};
+
+// src/prompt/context-layer.ts
+init_esm_shims();
+import { createHash as createHash3 } from "crypto";
+var LAYER_ORDER = [
+  "system",
+  "tools",
+  "project-instructions",
+  "git-status",
+  "session-memory",
+  "historical-lessons",
+  "working-set",
+  "recent-raw-turns",
+  "tool-history",
+  "task-progress",
+  "behavior-mirror",
+  "decisions",
+  "current-request"
+];
+function stableStringify2(value) {
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) return `[${value.map(stableStringify2).join(",")}]`;
+  const object = value;
+  return `{${Object.keys(object).sort().map((key) => `${JSON.stringify(key)}:${stableStringify2(object[key])}`).join(",")}}`;
+}
+function stableLayerDigest(value) {
+  return `sha256:${createHash3("sha256").update(stableStringify2(value)).digest("hex")}`;
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function createContextLayer(input) {
+  return {
+    ...input,
+    digest: stableLayerDigest(input.content),
+    tokenEstimate: input.tokenEstimate ?? estimateTokens(input.content)
+  };
+}
+function createContextLayerReport(layers) {
+  const ordered = [...layers].sort((a, b) => LAYER_ORDER.indexOf(a.id) - LAYER_ORDER.indexOf(b.id));
+  return {
+    layers: ordered,
+    fingerprintIncluded: ordered.filter((layer) => layer.fingerprint === "included"),
+    dynamicLayers: ordered.filter((layer) => layer.stability === "dynamic")
+  };
+}
+
+// src/prompt/engine.ts
+var FULL_COLLAPSE_FILL_RATIO = 0.85;
+var COLLAPSE_FLOOR_FILL_RATIO = 0.5;
+function simpleHash(s) {
+  let h = 5381;
+  const len = Math.min(s.length, 2e3);
+  for (let i = 0; i < len; i++) h = (h << 5) + h + s.charCodeAt(i) | 0;
+  return `${h}:${s.length}`;
+}
+function fullHash(s) {
+  let h = 5381;
+  for (let i = 0; i < s.length; i++) h = (h << 5) + h + s.charCodeAt(i) | 0;
+  return `${h}:${s.length}`;
+}
+function messageSignature(m) {
+  const rec = m;
+  let s = typeof m.content === "string" ? m.content : m.content == null ? "" : JSON.stringify(m.content);
+  if (rec.tool_calls) s += "\0" + JSON.stringify(rec.tool_calls);
+  if (rec.reasoning_content) s += "\0" + String(rec.reasoning_content);
+  if (rec.tool_call_id) s += "\0" + String(rec.tool_call_id);
+  return { sig: `${m.role}\0${fullHash(s)}`, len: s.length };
+}
+var PromptEngine = class _PromptEngine {
+  systemPrompt;
+  volatileBlock;
+  frozenBase;
+  fingerprint;
+  config;
+  tracker;
+  consolidatedBlock = "";
+  /** Cache key: last user message content — triggers rebuild when it changes. */
+  cachedFreshForUser = "";
+  /** P1: cached dynamic appendix, appended as standalone message at end of result.
+   *  Computed once when a new user message arrives, reused across tool-call turns. */
+  cachedAppendix = "";
+  /** appendix 构成快照（cache-log 观测）：与 cachedAppendix 同生命周期——同一
+   *  构建路径产出、同一失效路径清空。zenLean 的裁剪量 = 两个相位的 cvmChars
+   *  之差，这是总量字段（appendixChars）看不见的部分。 */
+  lastAppendixAnatomy = null;
+  /** appendix 构成（CVM 计量块 vs keep-list 的字符账）。 */
+  getAppendixAnatomy() {
+    return this.lastAppendixAnatomy;
+  }
+  /** P1: cached consolidated block from habituation tracker.
+   *  Stable across turns after promotion — placed BEFORE userContent so
+   *  it enters the prefix cache (unlike cachedAppendix, which sits after). */
+  cachedConsolidated = "";
+  /**
+   * Frozen merged content for historical user messages (preserves prefix stability).
+   * Maps user-message content → array of committed snapshots. One entry per
+   * user-message *instance* (boundary commit); duplicate text ("继续" twice)
+   * → index 0, index 1, … via frozenFetchIndex.
+   *
+   * Intra-turn appendix revisions live in frozenPendingMerged until the next
+   * real user boundary — never pushed into this array per tool turn.
+   */
+  frozenUserMerged = /* @__PURE__ */ new Map();
+  /** Latest merged trailer for the active last-user message (pre-commit). */
+  frozenPendingMerged = /* @__PURE__ */ new Map();
+  /** Per-content fetch index — tracks which entry to retrieve next per content key. */
+  frozenFetchIndex = /* @__PURE__ */ new Map();
+  /** Maximum total entries across all content keys before eviction kicks in. */
+  static MAX_FROZEN_USER_MERGED = 64;
+  /**
+   * Content key of the FIRST user message in the current session. Its frozen
+   * snapshot is the byte-0 anchor of the whole prefix — if eviction deletes it,
+   * the first user message rebuilds with the current (possibly swapped)
+   * volatileBlock → full 0% prefix cache break. Excluded from eviction.
+   */
+  firstUserKey = null;
+  taskProgress;
+  repairHint;
+  toolContext;
+  planCacheAdvisory;
+  /** U6: serialized PlanExecutionTrace appendix (survives compaction). */
+  planTraceAppendix;
+  /** Approved-plan pointer (slug/title/path only) — dynamic appendix, never frozen. */
+  activePlanPointer;
+  intentRetrievalRoute;
+  taskDepthLayer;
+  /** Advisory text — only set when task depth layer changes, null otherwise to avoid noise. */
+  taskDepthAdvisory = null;
+  planMethodology;
+  planMethodologyReason;
+  /** Whether the last setPlanMethodology was under Plan Mode (design-doc advisory). */
+  planMethodologyPlanMode = false;
+  /** Advisory text — only set when methodology changes, null otherwise to avoid noise. */
+  planMethodologyAdvisory = null;
+  /** Approved-plan execution discipline block — set on plan approval, cleared
+   *  on next plan-mode entry. Cache-safe: dynamic appendix only. */
+  planExecutingBlock = null;
+  skillAdvisoryBlock;
+  invokedSkillNames = /* @__PURE__ */ new Set();
+  crossSessionMemoryBlock;
+  mentionContextBlock;
+  harnessAdvisoryBlock;
+  controlPlaneBlock;
+  /** Doom-loop / storm turns: force terse output-style in dynamic appendix. */
+  tersenessEscalate = false;
+  decisions;
+  activeDomain;
+  activeClaims;
+  /** spec 3c 动作 B：排除路径锚点（spark 会话专属；追加式 + cap，创建序稳定）。
+   *  非 spark 会话恒空 → <excluded-paths> 零渲染零字节差异。 */
+  excludedPathAnchors = [];
+  /** Goal anchor（spec 3c 动作 B 补强）：会话当前目标，覆盖语义。 */
+  goalAnchor = null;
+  playbookLessons;
+  onLessonsRendered;
+  sessionMemoryOverride;
+  contextLayerReportData;
+  phaseHint;
+  cognitiveProjection;
+  /** Per-turn one-shot cognitive hints, emitted outside appendixDelta (C1 fix). */
+  cognitiveEphemeral;
+  crossSessionEvents;
+  companionPresence;
+  sessionStateText;
+  worktreeReality;
+  /** Plan Mode state — when 'planning', rendered into volatile block */
+  planModeState;
+  /** Ask Mode state — when 'asking', rendered into volatile appendix */
+  askModeState;
+  /** Approval mode — rendered into the dynamic appendix as a permission note
+   *  when unattended (dangerously-skip-permissions). Live-updated via
+   *  setApprovalMode(); never frozen — the mode flips mid-session. */
+  approvalMode;
+  /** Active plan file path (relative) — shown in plan-mode block */
+  activePlanFilePath;
+  /** One-shot: emit the plan-mode exit reminder on the next rendered turn. */
+  planExitReminderPending;
+  /** Whether current turn message warrants task-mode scaffolding (task contract, CVM, etc.).
+   *  Replaces the old binary chat/task PromptMode — auto-detected from message content. */
+  actionableTurn = true;
+  gitDirty = false;
+  /**
+   * T7 watermark: request-copy collapse only applies to message indices below
+   * this boundary. Advancing only on 50K-token steps (not every turn) keeps the
+   * collapse boundary stable across requests — a sliding boundary would rewrite
+   * more request bytes every turn and permanently break the prefix cache.
+   */
+  collapseWatermark = 0;
+  /** Last 50K-token step at which the watermark was advanced. */
+  collapseTokenStep = -1;
+  /** Cache-event counters (P2-6 breadcrumbs): queried per-turn by cache logging. */
+  frozenSnapshotClamps = 0;
+  frozenFallbackRebuilds = 0;
+  volatileSwapCount = 0;
+  toolsUpdateCount = 0;
+  /** Tracks message array length to detect true duplicate messages vs tool-call turns. */
+  lastMessageCount = 0;
+  /** Hash of last message array to distinguish exact same call from true duplicate. */
+  lastMessageHash = "";
+  userMessagesSinceGitRefresh = 0;
+  /** Prefix-divergence probe: per-message signatures of the previous request. */
+  prevRequestSignatures = null;
+  /** Latest divergence vs the previous request (consume-once via consumePrefixDivergence). */
+  lastPrefixDivergence = null;
+  /** Append-only delta: last emitted context-update sub-blocks (name→content). */
+  lastEmittedAppendixParts = /* @__PURE__ */ new Map();
+  /** Monotonic context-update sequence number (model orders updates by seq). */
+  appendixSeq = 0;
+  /** Whether a full baseline context-update was sent since last reset. */
+  appendixBaselineSent = false;
+  /**
+   * CVM egress ledger: chars of metered appendix sub-blocks ACTUALLY written
+   * into a <context-update> since the last drain. Booked at the emission point
+   * so a block that is byte-stable (delta suppresses it), dropped by Top-K, or
+   * simply not rebuilt on a tool turn costs nothing.
+   *
+   * Invariant: only main-path boundary builds write here — see
+   * buildAppendixBody's chargeLedger parameter.
+   */
+  appendixLedger = /* @__PURE__ */ new Map();
+  /** Fired by resetAppendixBaseline so CVM accounting tracks history rewrites. */
+  onResetAppendixBaselineCb;
+  constructor(config) {
+    this.config = config;
+    const inherit = config.inheritFrozenFrom;
+    if (inherit instanceof _PromptEngine) {
+      this.frozenUserMerged = new Map([...inherit.frozenUserMerged].map(([k, v]) => [k, [...v]]));
+      this.frozenPendingMerged = new Map(inherit.frozenPendingMerged);
+      this.firstUserKey = inherit.firstUserKey;
+      this.collapseWatermark = inherit.collapseWatermark;
+      this.collapseTokenStep = inherit.collapseTokenStep;
+    } else {
+      const data = inherit ? parseFrozenSnapshotData(inherit) : void 0;
+      if (data) {
+        this.frozenUserMerged = new Map(data.frozenUserMerged.map(([k, v]) => [k, [...v]]));
+        this.frozenPendingMerged = new Map(data.frozenPendingMerged);
+        this.firstUserKey = data.firstUserKey;
+        this.collapseWatermark = data.collapseWatermark;
+        this.collapseTokenStep = data.collapseTokenStep;
+      }
+    }
+    this.approvalMode = config.approvalMode;
+    this.systemPrompt = buildSystemPrompt(config.staticCtx);
+    this.frozenBase = buildStableVolatileBlock(config.volatileCtx);
+    this.volatileBlock = this.frozenBase;
+    this.fingerprint = computeFingerprint(this.systemPrompt, config.staticCtx.tools, this.volatileBlock);
+    this.tracker = (config.habituationThreshold ?? 5) > 0 ? new FieldHabituationTracker({ promotionThreshold: 0.8, decayRate: 0.3 }) : null;
+    this.contextLayerReportData = createContextLayerReport([
+      createContextLayer({ id: "system", label: "Stable System Prompt", stability: "stable", channel: "system", fingerprint: "included", content: this.systemPrompt }),
+      createContextLayer({ id: "tools", label: "Tool Definitions", stability: "stable", channel: "tools", fingerprint: "included", content: JSON.stringify(config.staticCtx.tools) }),
+      ...config.volatileCtx.rivetMd ? [createContextLayer({ id: "project-instructions", label: "Project Instructions", stability: "stable-volatile", channel: "volatile-user-message", fingerprint: "included", content: config.volatileCtx.rivetMd })] : [],
+      ...config.volatileCtx.gitStatus ? [createContextLayer({ id: "git-status", label: "Git Status", stability: "stable-volatile", channel: "volatile-user-message", fingerprint: "included", content: config.volatileCtx.gitStatus })] : [],
+      ...config.volatileCtx.sessionMemoryBlock ? [createContextLayer({ id: "session-memory", label: "Session Memory", stability: "stable-volatile", channel: "volatile-user-message", fingerprint: "included", content: config.volatileCtx.sessionMemoryBlock })] : [],
+      ...config.volatileCtx.playbookLessons && config.volatileCtx.playbookLessons.length > 0 ? [createContextLayer({ id: "historical-lessons", label: "Historical Lessons", stability: "dynamic", channel: "volatile-user-message", fingerprint: "excluded", content: config.volatileCtx.playbookLessons.map((b) => b.lesson).join("\n") })] : [],
+      ...config.volatileCtx.workingSet && config.volatileCtx.workingSet.length > 0 ? [createContextLayer({ id: "working-set", label: "Working Set", stability: "stable-volatile", channel: "volatile-user-message", fingerprint: "partial", content: config.volatileCtx.workingSet.join("\n") })] : []
+    ]);
+  }
+  /**
+   * Build a request. Volatile context is injected as an independent user message
+   * prepended before each user message with string content.
+   *
+   * Cache-critical design for agent loop mode (1 user message → 50 tool calls):
+   * - The FRESH volatile block is generated ONCE per user message, then cached.
+   * - Subsequent tool-call turns reuse the cached FRESH → prefix stays stable.
+   * - Only when a NEW user text message arrives does FRESH get regenerated.
+   * - Historical user text messages always use FROZEN (this.volatileBlock).
+   *
+   * This ensures DeepSeek's exact-prefix cache hits on API calls 2-50 within
+   * a single user message's execution, not just across user messages.
+   */
+  /** volatile trailer 的文本前缀：frozen 的 volatileBlock + habituation 稳定的
+   *  consolidated 块 + 分隔线。文本消息直接与之拼接——字节布局与历史一致，
+   *  前缀缓存基线不动；多模态消息把这个前缀当作独立的 text part 使用。 */
+  trailerTextPrefix() {
+    const consolidated = this.cachedConsolidated ? "\n" + this.cachedConsolidated : "";
+    return this.volatileBlock + consolidated + "\n---\n";
+  }
+  /**
+   * trailer 合并后的 user 消息内容。
+   *
+   * 文本消息拼成单串（既有字节布局，缓存基线不变）。多模态消息必须保留 parts：
+   * 拼字符串只能把图片丢掉或降级成一串 base64 文本——模型于是一律回答「看不到
+   * 图片」（2026-09-11 用户报障）。这类消息把 volatile 前缀作为首个 text part
+   * 前置、用户 parts 原样保留、附录追加为末尾 text part。
+   */
+  buildTraileredUserContent(msg, appendix) {
+    const prefix = this.trailerTextPrefix();
+    if (Array.isArray(msg.content)) {
+      const parts = [{ type: "text", text: prefix }, ...msg.content];
+      if (appendix) parts.push({ type: "text", text: appendix });
+      return parts;
+    }
+    return prefix + msg.content + (appendix ? "\n\n" + appendix : "");
+  }
+  /**
+   * Retrieve the next frozen snapshot for a given user-message content.
+   * Maintains a per-content fetch index so that duplicate messages ("继续", "ok")
+   * each get their own frozen snapshot in order.
+   */
+  getNextFrozen(content) {
+    const arr = this.frozenUserMerged.get(content);
+    if (!arr || arr.length === 0) return void 0;
+    const idx = this.frozenFetchIndex.get(content) ?? 0;
+    this.frozenFetchIndex.set(content, idx + 1);
+    if (idx >= arr.length) {
+      this.frozenSnapshotClamps++;
+      debugLog("prompt-engine", `frozen snapshot clamp: key len=${content.length} requested idx=${idx} surviving=${arr.length}`);
+      return arr[arr.length - 1];
+    }
+    return arr[idx];
+  }
+  /**
+   * Commit the pending merged trailer for one user-message instance. Called
+   * only at a real user boundary (new user text or duplicate-instance), NOT
+   * on invalidateFreshCache pseudo-boundaries mid-tool-loop.
+   */
+  commitFrozenSnapshot(content) {
+    const pending = this.frozenPendingMerged.get(content);
+    if (!pending) return;
+    const arr = this.frozenUserMerged.get(content);
+    if (arr) {
+      if (arr[arr.length - 1] !== pending) arr.push(pending);
+    } else {
+      this.frozenUserMerged.set(content, [pending]);
+    }
+    if (this.onFrozenSnapshotCommitCb) {
+      try {
+        this.onFrozenSnapshotCommitCb();
+      } catch {
+      }
+    }
+  }
+  /** Fired by commitFrozenSnapshot（唯一快照固化点）；由 bootstrap 接线盘存写。 */
+  onFrozenSnapshotCommitCb;
+  /** 注册快照固化回调（每次 user 边界 commit 后触发，低频）。 */
+  setOnFrozenSnapshotCommit(fn) {
+    this.onFrozenSnapshotCommitCb = fn;
+  }
+  /**
+   * 导出冻结前缀快照的可序列化形态（深拷贝）——随会话落盘，
+   * resume 时经 inheritFrozenFrom 喂回，历史 user 消息恢复原始字节。
+   */
+  exportFrozenSnapshot() {
+    return {
+      v: 1,
+      frozenUserMerged: [...this.frozenUserMerged].map(([k, v]) => [k, [...v]]),
+      frozenPendingMerged: [...this.frozenPendingMerged],
+      firstUserKey: this.firstUserKey,
+      collapseWatermark: this.collapseWatermark,
+      collapseTokenStep: this.collapseTokenStep
+    };
+  }
+  /** 冻结锚点总数（resume 公告「继承 N 个前缀锚点」用）。 */
+  getFrozenAnchorCount() {
+    let n = 0;
+    for (const arr of this.frozenUserMerged.values()) n += arr.length;
+    return n;
+  }
+  buildOaiRequest(inputMessages, toolHistory, contextWindow, options) {
+    const sidePath = options?.sidePath === true;
+    const result = [];
+    this.frozenFetchIndex.clear();
+    const preflight = runResumePreflightOai(inputMessages, sidePath ? void 0 : { writeProbe: options?.writeProbe });
+    const oaiMessages = preflight.messages;
+    if (preflight.repaired && preflight.syntheticResultsInserted > 0 && !sidePath && options?.onOrphanRepair) {
+      options.onOrphanRepair(oaiMessages, preflight.syntheticResultsInserted);
+    }
+    const appendixMaxChars = contextWindow && contextWindow > 0 ? Math.min(Math.max(Math.floor(contextWindow * 0.05 * 4), 2e3), 4 * LARGE_VOLATILE_PAYLOAD_CHARS) : void 0;
+    let firstUserIdx = -1;
+    let lastUserIdx = -1;
+    for (let i = 0; i < oaiMessages.length; i++) {
+      const m = oaiMessages[i];
+      if (m.role === "user" && !isSystemReminder(m.content)) {
+        if (firstUserIdx === -1) firstUserIdx = i;
+        lastUserIdx = i;
+      }
+    }
+    if (!sidePath && firstUserIdx >= 0) {
+      const fm = oaiMessages[firstUserIdx];
+      this.firstUserKey = typeof fm.content === "string" ? fm.content : "";
+    }
+    if (!sidePath && lastUserIdx >= 0) {
+      const lastUserContent = typeof oaiMessages[lastUserIdx].content === "string" ? oaiMessages[lastUserIdx].content : JSON.stringify(oaiMessages[lastUserIdx].content);
+      for (const key of [...this.frozenPendingMerged.keys()]) {
+        if (key === lastUserContent) continue;
+        this.commitFrozenSnapshot(key);
+        this.frozenPendingMerged.delete(key);
+      }
+      const hasPriorInstanceNowHistorical = this.frozenPendingMerged.has(lastUserContent) && oaiMessages.some((m, idx) => m.role === "user" && !isSystemReminder(m.content) && idx !== lastUserIdx && (typeof m.content === "string" ? m.content : JSON.stringify(m.content)) === lastUserContent);
+      const msgHash = oaiMessages.length > 0 ? `${oaiMessages.length}:${typeof oaiMessages[oaiMessages.length - 1].content === "string" ? oaiMessages[oaiMessages.length - 1].content : ""}` : "";
+      const isDuplicate = lastUserContent === this.cachedFreshForUser && oaiMessages.length === this.lastMessageCount && msgHash !== this.lastMessageHash && ((this.frozenUserMerged.get(lastUserContent)?.length ?? 0) > 0 || this.frozenPendingMerged.has(lastUserContent));
+      if (hasPriorInstanceNowHistorical || isDuplicate) {
+        this.commitFrozenSnapshot(lastUserContent);
+      }
+    }
+    for (let i = 0; i < oaiMessages.length; i++) {
+      const msg = oaiMessages[i];
+      if (msg.role === "user" && isSystemReminder(msg.content)) {
+        result.push(msg);
+      } else if (msg.role === "user" && this.volatileBlock) {
+        if (i === lastUserIdx && sidePath) {
+          result.push({ role: "user", content: this.buildTraileredUserContent(msg) });
+        } else if (i === lastUserIdx) {
+          const userContent = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+          const msgHash = oaiMessages.length > 0 ? `${oaiMessages.length}:${typeof oaiMessages[oaiMessages.length - 1].content === "string" ? oaiMessages[oaiMessages.length - 1].content : ""}` : "";
+          const isDuplicate = userContent === this.cachedFreshForUser && oaiMessages.length === this.lastMessageCount && msgHash !== this.lastMessageHash && ((this.frozenUserMerged.get(typeof userContent === "string" ? userContent : "")?.length ?? 0) > 0 || this.frozenPendingMerged.has(this.cachedFreshForUser));
+          this.lastMessageCount = oaiMessages.length;
+          this.lastMessageHash = msgHash;
+          if (userContent !== this.cachedFreshForUser || isDuplicate) {
+            if (this.frozenBase !== this.volatileBlock) {
+              this.volatileBlock = this.frozenBase;
+              this.volatileSwapCount++;
+            }
+            this.cachedFreshForUser = userContent;
+            this.userMessagesSinceGitRefresh++;
+            const refreshGit = this.gitDirty || this.userMessagesSinceGitRefresh >= 3;
+            if (refreshGit) {
+              this.gitDirty = false;
+              this.userMessagesSinceGitRefresh = 0;
+            }
+            const dynamicCtx = { ...this.config.volatileCtx, toolHistory, taskProgress: this.taskProgress, toolContext: this.toolContext, planCacheAdvisory: this.planCacheAdvisory, planTraceAppendix: this.planTraceAppendix, activePlanPointer: this.activePlanPointer, intentRetrievalRoute: this.intentRetrievalRoute, taskDepthAdvisory: this.taskDepthAdvisory, planMethodologyAdvisory: this.planMethodologyAdvisory, planExecutingBlock: this.planExecutingBlock, skillAdvisoryBlock: this.skillAdvisoryBlock ?? void 0, invokedSkillsBlock: skillRegistry.renderInvokedSkillsBlock([...this.invokedSkillNames], this.config.volatileCtx.cwd) ?? void 0, crossSessionMemoryBlock: this.crossSessionMemoryBlock ?? void 0, mentionContextBlock: this.mentionContextBlock ?? void 0, harnessAdvisoryBlock: this.harnessAdvisoryBlock, controlPlaneBlock: this.controlPlaneBlock, tersenessEscalate: this.tersenessEscalate, zenLean: this.zenLean || void 0, decisions: this.decisions, activeClaims: this.activeClaims, excludedPathAnchors: this.excludedPathAnchors.length > 0 ? this.excludedPathAnchors : void 0, goalAnchor: this.goalAnchor, playbookLessons: this.playbookLessons, onLessonsRendered: this.onLessonsRendered, sessionMemoryBlock: this.sessionMemoryOverride ?? this.config.volatileCtx.sessionMemoryBlock, crossSessionEvents: this.crossSessionEvents, companionPresence: this.companionPresence, sessionState: this.sessionStateText, worktreeReality: this.worktreeReality, planModeState: this.planModeState, askModeState: this.askModeState, approvalMode: this.approvalMode, activePlanFilePath: this.activePlanFilePath, planExitReminderPending: this.planExitReminderPending, cognitiveProjection: this.cognitiveProjection, ...refreshGit ? { gitStatus: void 0 } : {} };
+            if (this.planExitReminderPending) this.planExitReminderPending = false;
+            if (this.tracker) {
+              const fieldValues = {};
+              if (dynamicCtx.playbookLessons && dynamicCtx.playbookLessons.length > 0) {
+                fieldValues["playbookLessons"] = dynamicCtx.playbookLessons.map((b) => b.lesson).join("|");
+              }
+              this.tracker.recordTurn(fieldValues, this.phaseHint);
+              const habituatedContent = this.tracker.getHabituatedContent();
+              const renderedHabituated = /* @__PURE__ */ new Map();
+              for (const [name, content] of habituatedContent) {
+                if (name === "playbookLessons") {
+                  renderedHabituated.set(name, `<historical-lessons>
+${content.split("|").map((l) => `- ${l}`).join("\n")}
+</historical-lessons>`);
+                }
+              }
+              const newConsolidated = buildConsolidatedBlock(renderedHabituated);
+              if (newConsolidated !== this.consolidatedBlock) {
+                this.consolidatedBlock = newConsolidated;
+              }
+              const activeCtx = { ...dynamicCtx };
+              const habituated = this.tracker.getHabituated();
+              if (habituated.has("playbookLessons")) activeCtx.playbookLessons = void 0;
+              const activeAppendix = this.actionableTurn ? this.buildAppendixBody(activeCtx, appendixMaxChars, !sidePath) : "";
+              this.cachedConsolidated = this.consolidatedBlock;
+              this.cachedAppendix = this.withEphemeralProjection(activeAppendix, !sidePath);
+            } else {
+              if (this.actionableTurn) {
+                const appendix = this.buildAppendixBody(dynamicCtx, appendixMaxChars, !sidePath);
+                this.cachedConsolidated = this.consolidatedBlock;
+                this.cachedAppendix = this.withEphemeralProjection(appendix, !sidePath);
+              } else {
+                this.cachedConsolidated = "";
+                this.cachedAppendix = "";
+              }
+            }
+          }
+          const trailered = this.buildTraileredUserContent(msg, this.cachedAppendix || void 0);
+          if (typeof msg.content === "string") {
+            this.frozenPendingMerged.set(msg.content, trailered);
+          }
+          result.push({ role: "user", content: trailered });
+        } else if (i === firstUserIdx) {
+          const frozen = this.getNextFrozen(typeof msg.content === "string" ? msg.content : "");
+          if (frozen) {
+            result.push({ role: "user", content: frozen });
+          } else {
+            this.frozenFallbackRebuilds++;
+            debugLog("prompt-engine", `FATAL-CACHE: frozen snapshots fully evicted for FIRST user message (len=${typeof msg.content === "string" ? msg.content.length : 0}) \u2014 rebuilding with current volatileBlock`);
+            const rebuilt = this.buildTraileredUserContent(msg);
+            if (!sidePath && typeof msg.content === "string" && msg.content !== "") {
+              this.frozenUserMerged.set(msg.content, [rebuilt]);
+            }
+            result.push({ role: "user", content: rebuilt });
+          }
+        } else {
+          const frozen = this.getNextFrozen(typeof msg.content === "string" ? msg.content : "");
+          if (frozen) {
+            result.push({ role: "user", content: frozen });
+          } else {
+            this.frozenFallbackRebuilds++;
+            debugLog("prompt-engine", `frozen snapshots fully evicted for historical user message (len=${typeof msg.content === "string" ? msg.content.length : 0}) \u2014 rebuilding with current volatileBlock`);
+            const rebuilt = this.buildTraileredUserContent(msg);
+            if (!sidePath && typeof msg.content === "string" && msg.content !== "") {
+              this.frozenUserMerged.set(msg.content, [rebuilt]);
+            }
+            result.push({ role: "user", content: rebuilt });
+          }
+        }
+      } else {
+        result.push(msg);
+      }
+    }
+    const tools = this.config.staticCtx.tools.length > 0 ? this.config.staticCtx.tools.map((tool) => {
+      const func = {
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.input_schema ?? { type: "object", properties: {} }
+      };
+      if (tool.providerFormat) {
+        func.providerFormat = tool.providerFormat;
+      }
+      return { type: "function", function: func };
+    }) : void 0;
+    if (!contextWindow || contextWindow < 1e6) {
+      const { messages: prunedMessages, prunedCount, savedChars } = pruneOutdatedQueryResults(result, CACHE_ANCHOR_MESSAGES);
+      if (prunedCount > 0) {
+        debugLog(`[semantic-prune] pruned ${prunedCount} results, saved ${savedChars} chars`);
+        result.length = 0;
+        result.push(...prunedMessages);
+      }
+      const { messages: stalenessPruned } = detectStaleness(result, CACHE_ANCHOR_MESSAGES, {
+        suffixTokenLimit: 8e3
+        // only mutate cheap-to-recache tail
+      });
+      if (stalenessPruned !== result) {
+        for (let i = 0; i < result.length; i++) result[i] = stalenessPruned[i];
+      }
+    }
+    const MASK_WINDOW = 10;
+    if (!contextWindow || contextWindow < 1e6) {
+      let userCount = 0;
+      const userTurnIndices = [];
+      for (let i = result.length - 1; i >= 0; i--) {
+        if (result[i].role === "user") {
+          userCount++;
+          userTurnIndices.push(i);
+        }
+      }
+      if (userCount > MASK_WINDOW) {
+        const cutoff = userTurnIndices[MASK_WINDOW - 1];
+        for (let i = 0; i < cutoff; i++) {
+          const msg = result[i];
+          if (msg.role === "tool" && msg.content.length > 200) {
+            const preview = msg.content.slice(0, 100);
+            result[i] = { ...msg, content: `[observation masked, ${msg.content.length} chars]
+${preview}\u2026` };
+          }
+        }
+      }
+    }
+    if (!contextWindow || contextWindow < 1e6) {
+      const seenContent = /* @__PURE__ */ new Map();
+      for (let i = result.length - 1; i >= 0; i--) {
+        const msg = result[i];
+        if (msg.role === "tool" && msg.content.length > 500 && !msg.content.startsWith("[observation masked")) {
+          const hash = simpleHash(msg.content);
+          if (!seenContent.has(hash)) {
+            seenContent.set(hash, i);
+          } else {
+            result[i] = { ...msg, content: `[duplicate content, see later tool result]` };
+          }
+        }
+      }
+      const DISK_BUDGET_CHARS = 5e4;
+      const PREVIEW_CHARS = 2e3;
+      for (let i = 0; i < result.length; i++) {
+        const msg = result[i];
+        if (msg.role === "tool" && msg.content.length > DISK_BUDGET_CHARS) {
+          const preview = msg.content.slice(0, PREVIEW_CHARS);
+          result[i] = { ...msg, content: `${preview}
+
+[output truncated: ${msg.content.length} chars total, showing first ${PREVIEW_CHARS}]` };
+        }
+      }
+    }
+    let totalFrozen = 0;
+    for (const arr of this.frozenUserMerged.values()) totalFrozen += arr.length;
+    while (totalFrozen > _PromptEngine.MAX_FROZEN_USER_MERGED && this.frozenUserMerged.size > 0) {
+      let maxKey = "", maxLen = 0;
+      for (const [k, arr] of this.frozenUserMerged) {
+        if (k === this.firstUserKey) continue;
+        if (arr.length > maxLen) {
+          maxKey = k;
+          maxLen = arr.length;
+        }
+      }
+      if (maxLen === 0) break;
+      if (maxLen <= 1) {
+        this.frozenUserMerged.delete(maxKey);
+      } else {
+        this.frozenUserMerged.get(maxKey).shift();
+      }
+      totalFrozen--;
+    }
+    if (contextWindow && contextWindow >= 2e5 && !sidePath) {
+      const collapseAge = this.config.attentionProfile?.collapseAgeTurns ?? 8;
+      const estTokens = estimateOaiTokens(result);
+      const fillRatio = estTokens / contextWindow;
+      if (fillRatio >= COLLAPSE_FLOOR_FILL_RATIO) {
+        if (this.collapseWatermark > result.length) {
+          this.collapseWatermark = 0;
+          this.collapseTokenStep = -1;
+        }
+        const step = Math.floor(estTokens / 5e4);
+        if (step > this.collapseTokenStep) {
+          this.collapseTokenStep = step;
+          this.collapseWatermark = computeCollapseBoundary(result, collapseAge);
+          debugLog("prompt-engine", `T7 watermark advanced: step=${step} boundary=${this.collapseWatermark} estTokens=${estTokens}`);
+        }
+        if (this.collapseWatermark > 0) {
+          requestTimeCollapse(result, this.collapseWatermark, contextWindow, fillRatio < FULL_COLLAPSE_FILL_RATIO);
+        }
+      }
+    }
+    const request = {
+      model: this.config.model,
+      messages: [{ role: "system", content: this.systemPrompt }, ...result],
+      max_tokens: this.config.maxTokens,
+      stream: true,
+      stream_options: { include_usage: true },
+      tools,
+      tool_choice: tools ? "auto" : void 0,
+      // Main-turn marker for the client's wire-level probe — the client only
+      // fingerprints final send bytes for these requests (side-path calls
+      // through the same client would poison its baseline too).
+      prefixProbe: !sidePath || void 0
+    };
+    if (!sidePath) this.recordPrefixDivergence(request.messages);
+    return request;
+  }
+  /**
+   * Prefix-divergence probe: compare this request's per-message signatures with
+   * the previous request's. An exact-prefix provider only re-matches the shared
+   * prefix, so any non-append change (message content mutated, message removed,
+   * count shrank) is a real client-side cache break. Records the FIRST diverged
+   * index; pure appends record nothing.
+   */
+  recordPrefixDivergence(messages) {
+    const sigs = messages.map(messageSignature);
+    const prev = this.prevRequestSignatures;
+    this.prevRequestSignatures = sigs;
+    if (!prev) return;
+    const shared = Math.min(prev.length, sigs.length);
+    let divergedIdx = -1;
+    for (let i = 0; i < shared; i++) {
+      if (prev[i].sig !== sigs[i].sig) {
+        divergedIdx = i;
+        break;
+      }
+    }
+    if (divergedIdx === -1) {
+      if (sigs.length >= prev.length) return;
+      divergedIdx = sigs.length;
+    }
+    let approxCharPos = 0;
+    for (let i = 0; i < divergedIdx; i++) approxCharPos += sigs[i]?.len ?? prev[i].len;
+    this.lastPrefixDivergence = {
+      idx: divergedIdx,
+      role: messages[divergedIdx]?.role ?? "removed",
+      kind: divergedIdx >= sigs.length ? "message_removed" : "message_changed",
+      prevCount: prev.length,
+      newCount: sigs.length,
+      approxCharPos
+    };
+  }
+  /** Consume-once accessor for the latest prefix divergence (cache-log breadcrumb). */
+  consumePrefixDivergence() {
+    const d = this.lastPrefixDivergence;
+    this.lastPrefixDivergence = null;
+    return d;
+  }
+  getModel() {
+    return this.config.model;
+  }
+  getFingerprint() {
+    return this.fingerprint;
+  }
+  checkDrift() {
+    const current = computeFingerprint(this.systemPrompt, this.config.staticCtx.tools, this.volatileBlock);
+    return detectDrift(this.fingerprint, current);
+  }
+  getSystemPrompt() {
+    return this.systemPrompt;
+  }
+  updateTools(tools) {
+    if (stableStringify(tools) === stableStringify(this.config.staticCtx.tools)) return;
+    this.config.staticCtx.tools = tools;
+    this.fingerprint = computeFingerprint(this.systemPrompt, tools, this.volatileBlock);
+    this.toolsUpdateCount++;
+  }
+  /** Number of tool definitions (for prefix overhead estimation). */
+  getToolCount() {
+    return this.config.staticCtx.tools.length;
+  }
+  /**
+   * 当前 frozen 前缀的分块构成（`/prefix-budget` 与 scripts/prefix-budget.ts 共用口径）。
+   *
+   * 读的是这个引擎实际持有的字节，不重新加载磁盘——脚本量的是「新会话会是什么样」，
+   * 这里量的是「本会话现在是什么样」。两者在会话中途切过 /domain 或 /cd 后会不同。
+   */
+  getPrefixBudgetInputs() {
+    const ctx = this.config.volatileCtx;
+    const caps = { ...FROZEN_BLOCK_CAPS, ...ctx.blockCaps };
+    return [
+      { name: "static.ts BASE_PROMPT", category: "brake", content: this.systemPrompt },
+      { name: "star-domain volatileBlock", category: "brake", content: ctx.activeDomain?.volatileBlock },
+      { name: "\u5DE5\u5177 schema (JSON)", category: "tools", content: JSON.stringify(this.config.staticCtx.tools) },
+      // 与渲染层同一套按节选取——`slice(0, cap)` 会把报告写成「按前 N 字符收录」，
+      // 而实际收录的是另一组章节，归因数字对不上真实前缀。
+      { name: "project-instructions", category: "reference", content: ctx.rivetMd ? selectProjectInstructions(ctx.rivetMd, caps.projectInstructions).text : void 0, cap: caps.projectInstructions, rawChars: ctx.rivetMd?.length },
+      { name: "project-memory", category: "reference", content: ctx.projectMemoryBlock?.slice(0, caps.projectMemory), cap: caps.projectMemory, rawChars: ctx.projectMemoryBlock?.length },
+      { name: "knowledge-manifest", category: "reference", content: ctx.knowledgeManifestBlock?.slice(0, caps.knowledgeManifest), cap: caps.knowledgeManifest, rawChars: ctx.knowledgeManifestBlock?.length },
+      { name: "codebase-index", category: "reference", content: ctx.projectIndexBlock?.slice(0, caps.codebaseIndex), cap: caps.codebaseIndex, rawChars: ctx.projectIndexBlock?.length },
+      { name: "seed-capsule \u7D22\u5F15", category: "reference", content: ctx.seedCapsuleBlock },
+      { name: "session-memory", category: "reference", content: ctx.sessionMemoryBlock },
+      { name: "appendix\uFF08\u6BCF\u8F6E\u52A8\u6001\uFF09", category: "appendix", content: this.cachedAppendix }
+    ];
+  }
+  /** Current cognitive projection length in chars (for cache-log observability). */
+  getCognitiveProjectionLength() {
+    return this.cognitiveProjection?.length ?? 0;
+  }
+  /** Current cached appendix length in chars (for cache-log observability). */
+  getCachedAppendixLength() {
+    return this.cachedAppendix?.length ?? 0;
+  }
+  /**
+   * The appendix text as actually rendered this request. Nothing downstream of here
+   * persists it — the session JSONL keeps what the user typed, not what was injected
+   * alongside it — so without this accessor there is no way to answer "what did the
+   * model actually see" after the fact. Read by the (gated) appendix trace recorder.
+   */
+  getCachedAppendix() {
+    return this.cachedAppendix;
+  }
+  updateSessionMemory(block) {
+    this.sessionMemoryOverride = block;
+    this.rebuildFrozenBase();
+    this.invalidateFreshCache();
+  }
+  rebuildFrozenBase() {
+    const ctx = {
+      ...this.config.volatileCtx,
+      sessionMemoryBlock: this.sessionMemoryOverride ?? this.config.volatileCtx.sessionMemoryBlock,
+      // activeDomain folded into the frozen prefix (session constant). The ?? is
+      // explicit defense mirroring the appendix getter below: it allows a future
+      // volatileCtx-preset domain to survive a reset. Today config.volatileCtx
+      // .activeDomain is always undefined, so resetSessionDomain (this.activeDomain
+      // = undefined) correctly drops the domain from the frozen prefix.
+      activeDomain: this.activeDomain ?? this.config.volatileCtx.activeDomain
+    };
+    this.frozenBase = buildStableVolatileBlock(ctx);
+    this.fingerprint = computeFingerprint(this.systemPrompt, this.config.staticCtx.tools, this.frozenBase);
+  }
+  setActionableTurn(actionable) {
+    if (this.actionableTurn === actionable) return;
+    this.actionableTurn = actionable;
+    this.invalidateFreshCache();
+  }
+  /** @deprecated Use isActionableTurn from task-contract for auto-detection. */
+  getMode() {
+    return "task";
+  }
+  updateActiveClaims(claims) {
+    this.activeClaims = claims;
+  }
+  /** spec 3c 动作 B：追加排除路径锚点。去重（保首见序）+ cap 溢出淘汰最旧——
+   *  字节只在语义变化（新锚点/挤出）时变化，appendixDelta 可吸收。 */
+  appendExcludedPathAnchors(anchors) {
+    const MAX_ANCHORS = 20;
+    for (const a of anchors) {
+      if (!this.excludedPathAnchors.includes(a)) this.excludedPathAnchors.push(a);
+    }
+    if (this.excludedPathAnchors.length > MAX_ANCHORS) {
+      this.excludedPathAnchors = this.excludedPathAnchors.slice(-MAX_ANCHORS);
+    }
+  }
+  /** spec 3c 动作 B 补强：设置会话当前目标（覆盖语义——目标只有一个）。
+   *  与 appendExcludedPathAnchors 的追加语义不同：目标切换 = 整段替换，
+   *  字节只在目标实际变化时变（goalChanged 判定由调用方负责）。 */
+  setGoalAnchor(goal) {
+    this.goalAnchor = goal;
+  }
+  /** 已收集锚点数（loop 惰性重建判空用）。 */
+  getExcludedPathAnchorCount() {
+    return this.excludedPathAnchors.length;
+  }
+  updatePlaybookLessons(lessons) {
+    this.playbookLessons = lessons;
+  }
+  setOnLessonsRendered(cb) {
+    this.onLessonsRendered = cb;
+  }
+  setTaskProgress(state) {
+    this.taskProgress = state;
+  }
+  setRepairHint(hint) {
+    this.repairHint = hint;
+  }
+  setToolContext(ctx) {
+    this.toolContext = ctx ?? void 0;
+  }
+  getToolContextLength() {
+    return this.toolContext?.length ?? 0;
+  }
+  setPlanCacheAdvisory(advisory) {
+    this.planCacheAdvisory = advisory ?? void 0;
+  }
+  /** U6: set serialized PlanExecutionTrace appendix (rendered in dynamic appendix, survives compaction). */
+  setPlanTraceAppendix(appendix) {
+    this.planTraceAppendix = appendix ?? void 0;
+  }
+  /**
+   * Set the approved-plan pointer (slug/title/path block). Rendered ONLY into
+   * the dynamic appendix — does NOT rebuild the frozen base or invalidate the
+   * fresh cache, so approving/revising a plan never shatters the prefix cache.
+   * Mirrors setPlanModeState / setWorktreeReality: the pointer refreshes at the
+   * next user-message boundary (which rebuilds the appendix anyway).
+   */
+  setActivePlan(pointer) {
+    this.activePlanPointer = pointer ?? void 0;
+  }
+  /** Return the currently approved-plan pointer (slug/title/path block), if any. */
+  getActivePlanPointer() {
+    return this.activePlanPointer;
+  }
+  setIntentRetrievalRoute(route) {
+    this.intentRetrievalRoute = route ?? void 0;
+    this.invalidateFreshCache();
+  }
+  setTaskDepthLayer(layer) {
+    const changed = this.taskDepthLayer !== layer;
+    this.taskDepthLayer = layer;
+    this.taskDepthAdvisory = changed ? renderTaskDepthAdvisory(layer) : null;
+  }
+  setPlanMethodology(methodology, reason, opts) {
+    const changed = this.planMethodology !== methodology || this.planMethodologyPlanMode !== !!opts?.planMode;
+    this.planMethodology = methodology;
+    this.planMethodologyReason = reason;
+    this.planMethodologyPlanMode = !!opts?.planMode;
+    this.planMethodologyAdvisory = changed ? renderPlanMethodologyAdvisory(methodology, reason, opts) : null;
+  }
+  setPlanExecutingBlock(block) {
+    this.planExecutingBlock = block;
+  }
+  /** Zen Mode（禅模式）：相位 zen 时裁剪 CVM 动态注入块（sensorium/策略/知识
+   *  碎片/星域提醒/遥测），保留 git-status/recent-commits/项目指令/计划指针。
+   *  由 loop 在相位变化时调用（arm → true；promote → false）。Cache-safe：
+   *  只影响 dynamic appendix，不触碰冻结前缀。 */
+  zenLean = false;
+  setZenLean(lean) {
+    this.zenLean = lean;
+  }
+  getPlanExecutingBlock() {
+    return this.planExecutingBlock;
+  }
+  getPlanMethodology() {
+    return this.planMethodology;
+  }
+  setSkillAdvisoryBlock(block) {
+    this.skillAdvisoryBlock = block;
+  }
+  markSkillInvoked(name) {
+    this.invokedSkillNames.add(name);
+  }
+  markSkillCompleted(name) {
+    const canonical = skillRegistry.get(name)?.name ?? [...this.invokedSkillNames].find((n) => n.toLowerCase() === name.toLowerCase()) ?? name;
+    this.invokedSkillNames.delete(canonical);
+  }
+  getInvokedSkillNames() {
+    return [...this.invokedSkillNames];
+  }
+  setCrossSessionMemoryBlock(block) {
+    this.crossSessionMemoryBlock = block;
+  }
+  setMentionContextBlock(block) {
+    this.mentionContextBlock = block;
+  }
+  getTaskDepthLayer() {
+    return this.taskDepthLayer;
+  }
+  /** Wave 4 控制面 appendix — 仅 active 模式由 turn-step-producer 调用。
+   *  只影响 dynamic appendix（buildStableVolatileBlock 已剥离），不进 frozen、
+   *  不改写历史消息。 */
+  setControlPlaneAppendix(block) {
+    this.controlPlaneBlock = block ?? void 0;
+  }
+  setHarnessAdvisoryBlock(block) {
+    this.harnessAdvisoryBlock = block ?? void 0;
+  }
+  /**
+   * When true, the next dynamic appendix render enables the terseness nudge in
+   * escalate mode (doom-loop / storm). Cache-safe: dynamic appendix only.
+   */
+  setTersenessEscalate(escalate) {
+    this.tersenessEscalate = escalate;
+  }
+  setDecisions(decisions) {
+    this.decisions = decisions;
+  }
+  setCrossSessionEvents(events) {
+    this.crossSessionEvents = events ?? void 0;
+  }
+  setCompanionPresence(block) {
+    this.companionPresence = block ?? void 0;
+  }
+  /**
+   * Update session-state snapshot. Byte-stable: only stores when the content
+   * actually differs from the previously stored snapshot. This means within an
+   * auto-continuation run where nothing changed (model only read files), the
+   * appendix stays identical → DeepSeek prefix cache preserved. When files are
+   * modified or task step advances, the state updates and the model sees it.
+   * See: prompt/volatile.ts VolatileContext.sessionState comment.
+   */
+  setSessionState(text) {
+    const next = text ?? void 0;
+    if (next === this.sessionStateText) return;
+    this.sessionStateText = next;
+  }
+  /**
+   * Update worktree reality check result. Does NOT invalidate the fresh cache:
+   * rendered ONLY into the dynamic appendix when severity !== 'green'.
+   * This is required to preserve DeepSeek prefix cache across tool turns.
+   */
+  setWorktreeReality(reality) {
+    this.worktreeReality = reality ?? void 0;
+  }
+  /** Update plan-mode state — rendered into volatile block to instruct agent */
+  setPlanModeState(state) {
+    this.planModeState = state;
+  }
+  /** Update ask-mode state — rendered into volatile appendix (never frozen). */
+  setAskModeState(state) {
+    this.askModeState = state;
+  }
+  /** Update the approval mode — rendered into the dynamic appendix as a
+   *  permission note when unattended (never frozen). */
+  setApprovalMode(mode) {
+    this.approvalMode = mode;
+  }
+  /** Active plan file path for incremental plan writing in plan mode. */
+  setActivePlanFilePath(path) {
+    this.activePlanFilePath = path;
+  }
+  /** Arm/disarm the one-shot plan-mode exit reminder. */
+  setPlanExitReminderPending(pending) {
+    this.planExitReminderPending = pending;
+  }
+  setPhaseHint(hint) {
+    this.phaseHint = hint;
+  }
+  getPhaseHint() {
+    return this.phaseHint;
+  }
+  /**
+   * Update cognitive projection. Does NOT invalidate the fresh cache:
+   * within the same user message, all tool-call turns reuse the cached fresh
+   * volatile block — projection refreshes only at user-message boundaries.
+   * This preserves DeepSeek prefix cache across tool turns (~10% hit rate gain).
+   */
+  setCognitiveProjection(projection, ephemeral) {
+    this.cognitiveProjection = projection && projection.trim().length > 0 ? projection : void 0;
+    this.cognitiveEphemeral = ephemeral && ephemeral.trim().length > 0 ? ephemeral : void 0;
+  }
+  /** Prepend per-turn ephemeral cognitive hints OUTSIDE the delta context-update.
+   *  cachedAppendix is frozen across a user message's tool turns, so this stays
+   *  stable within a turn sequence and only refreshes at the next user boundary.
+   *  These bytes ship in full every boundary (no delta), so they book in full. */
+  withEphemeralProjection(appendix, chargeLedger) {
+    if (!this.cognitiveEphemeral) return appendix;
+    if (chargeLedger) this.chargeAppendixLedger("ephemeral", this.cognitiveEphemeral.length);
+    return appendix ? `${this.cognitiveEphemeral}
+${appendix}` : this.cognitiveEphemeral;
+  }
+  invalidateFreshCache() {
+    if (this.cachedFreshForUser !== "") {
+      const err = new Error("invalidateFreshCache");
+      debugLog(`[fresh-cache] CLEARED cachedFreshForUser="${this.cachedFreshForUser.slice(0, 80)}..." by: ${err.stack?.split("\n").slice(2, 5).join(" \u2192 ") ?? "unknown"}`);
+    }
+    this.cachedFreshForUser = "";
+    this.cachedAppendix = "";
+    this.cachedConsolidated = "";
+    this.lastAppendixAnatomy = null;
+    this.lastEmittedAppendixParts = /* @__PURE__ */ new Map();
+    this.appendixBaselineSent = false;
+  }
+  /**
+   * Build the <context-update> body — full when delta off or baseline not yet
+   * sent, otherwise only changed sub-blocks. Mutates lastEmittedAppendixParts.
+   *
+   * Delta logic: compare current parts against last emitted. On new user
+   * boundary, emit full baseline (seq=1). Subsequent boundaries emit only
+   * changed sub-blocks (mode="delta"), or self-closing tag if nothing changed.
+   * Tool-call turns reuse cachedAppendix (never calling this method).
+   *
+   * `chargeLedger` must be false for hermetic side-path builds: their appendix
+   * bytes never reach the main history, so booking them would re-introduce the
+   * overcounting this metering exists to avoid.
+   */
+  buildAppendixBody(ctx, maxChars, chargeLedger) {
+    const parts = buildDynamicAppendixParts(ctx, maxChars);
+    this.lastAppendixAnatomy = summarizeAppendixParts(parts);
+    if (!this.config.appendixDelta) {
+      if (parts.length === 0) return "";
+      this.chargeAppendixParts(parts, chargeLedger);
+      return `<context-update>
+${parts.map((p) => p.content).join("\n\n")}
+</context-update>`;
+    }
+    this.appendixSeq++;
+    const current = /* @__PURE__ */ new Map();
+    const changed = [];
+    for (const p of parts) {
+      current.set(p.name, p.content);
+      if (this.lastEmittedAppendixParts.get(p.name) !== p.content) changed.push(p);
+    }
+    const sendFull = !this.appendixBaselineSent;
+    this.lastEmittedAppendixParts = current;
+    this.appendixBaselineSent = true;
+    if (sendFull) {
+      if (parts.length === 0) return "";
+      this.chargeAppendixParts(parts, chargeLedger);
+      return `<context-update seq="${this.appendixSeq}">
+${parts.map((p) => p.content).join("\n\n")}
+</context-update>`;
+    }
+    if (changed.length === 0) return `<context-update seq="${this.appendixSeq}"/>`;
+    this.chargeAppendixParts(changed, chargeLedger);
+    return `<context-update seq="${this.appendixSeq}" mode="delta">
+${changed.map((p) => p.content).join("\n\n")}
+</context-update>`;
+  }
+  /** Book the chars of appendix sub-blocks that carry a CVM source tag. */
+  chargeAppendixLedger(source, chars) {
+    if (chars <= 0) return;
+    this.appendixLedger.set(source, (this.appendixLedger.get(source) ?? 0) + chars);
+  }
+  chargeAppendixParts(emitted, chargeLedger) {
+    if (!chargeLedger) return;
+    for (const p of emitted) {
+      if (p.source) this.chargeAppendixLedger(p.source, p.content.length);
+    }
+  }
+  /**
+   * Hand over the CVM egress booked since the last call and clear it.
+   *
+   * Consume-once on purpose. The alternative — hanging the ledger off the
+   * OaiChatRequest — would leak through `{...request}` spreads (llm-speculation)
+   * and be replayed verbatim by FallbackStreamClient failover, double-charging
+   * every retried turn. Same class of bug as the prefixProbe poisoning of 2026-07-06.
+   */
+  drainAppendixLedger() {
+    if (this.appendixLedger.size === 0) return [];
+    const rows = [...this.appendixLedger].map(([source, chars]) => ({ source, chars }));
+    this.appendixLedger.clear();
+    return rows;
+  }
+  /**
+   * Mark git status as dirty — next user-message boundary will use live gitStatusCache
+   * instead of the frozen session-start snapshot. Call after file-modifying tools
+   * (Write, Edit, Bash with git commands) to keep multi-session git state fresh.
+   */
+  markGitDirty() {
+    this.gitDirty = true;
+  }
+  /**
+   * Force the next context-update to be a full baseline. Call after history
+   * rewrite/compaction drops messages carrying prior context-update blocks —
+   * the model needs a fresh full snapshot because delta's "absent = unchanged"
+   * semantics rely on the history still being present.
+   *
+   * The same event invalidates CVM accounting: the appendix bytes booked so far
+   * just left the context. Registered listeners (the pressure monitor) are
+   * notified here rather than at each of the ten call sites, so the two cannot
+   * drift apart.
+   */
+  resetAppendixBaseline() {
+    this.lastEmittedAppendixParts = /* @__PURE__ */ new Map();
+    this.appendixBaselineSent = false;
+    this.appendixLedger.clear();
+    this.onResetAppendixBaselineCb?.();
+  }
+  /** Register the CVM accounting reset that must accompany a baseline reset. */
+  setOnResetAppendixBaseline(fn) {
+    this.onResetAppendixBaselineCb = fn;
+  }
+  /**
+   * Cache-event counters for cache-log breadcrumbs (P2-6).
+   * Cumulative since engine creation — callers diff across turns.
+   */
+  getCacheEventStats() {
+    return {
+      volatileSwaps: this.volatileSwapCount,
+      frozenClamps: this.frozenSnapshotClamps,
+      frozenFallbackRebuilds: this.frozenFallbackRebuilds,
+      collapseWatermark: this.collapseWatermark,
+      toolsUpdates: this.toolsUpdateCount
+    };
+  }
+  /**
+   * Pre-refresh git status cache when stale. Call in async context before
+   * buildOaiRequest() to ensure the model sees fresh git state instead of the
+   * up-to-30s-old cached value returned by the synchronous get() path.
+   */
+  async refreshGitContextIfNeeded(cwd) {
+    const { gitStatusCache } = await import("./volatile-git-MBTST7RA.js");
+    await gitStatusCache.refreshIfStale(cwd);
+  }
+  setActiveDomain(domain) {
+    this.activeDomain = domain;
+    this.rebuildFrozenBase();
+  }
+  getVolatilePayloadReport(toolHistory) {
+    const latest = buildLatestTurnVolatileBlock({
+      ...this.config.volatileCtx,
+      toolHistory,
+      taskProgress: this.taskProgress,
+      toolContext: this.toolContext,
+      planCacheAdvisory: this.planCacheAdvisory,
+      planTraceAppendix: this.planTraceAppendix,
+      intentRetrievalRoute: this.intentRetrievalRoute,
+      taskDepthAdvisory: this.taskDepthAdvisory,
+      planMethodologyAdvisory: this.planMethodologyAdvisory,
+      harnessAdvisoryBlock: this.harnessAdvisoryBlock,
+      decisions: this.decisions,
+      activeDomain: this.activeDomain ?? this.config.volatileCtx.activeDomain,
+      activeClaims: this.activeClaims ?? this.config.volatileCtx.activeClaims,
+      playbookLessons: this.playbookLessons ?? this.config.volatileCtx.playbookLessons,
+      sessionMemoryBlock: this.sessionMemoryOverride ?? this.config.volatileCtx.sessionMemoryBlock,
+      sessionState: this.sessionStateText,
+      worktreeReality: this.worktreeReality
+    });
+    return analyzeVolatilePayload(latest);
+  }
+  getContextLayerReport() {
+    return this.contextLayerReportData;
+  }
+};
+function computeCollapseBoundary(messages, collapseAge) {
+  let currentTurn = 0;
+  for (const m of messages) {
+    if (m.role === "user") currentTurn++;
+  }
+  let turnCounter = 0;
+  let boundary = 0;
+  for (let i = 0; i < messages.length; i++) {
+    if (messages[i].role === "user") turnCounter++;
+    if (currentTurn - turnCounter >= collapseAge) boundary = i + 1;
+  }
+  return boundary;
+}
+function requestTimeCollapse(messages, boundaryIndex, contextWindow, lightOnly = false) {
+  let currentTurn = 0;
+  for (const m of messages) {
+    if (m.role === "user") currentTurn++;
+  }
+  const end = Math.min(boundaryIndex, messages.length);
+  const toolCallIndex = buildToolCallIndex(messages, end);
+  const toolOccurrences = /* @__PURE__ */ new Map();
+  for (let i = 0; i < end; i++) {
+    const msg = messages[i];
+    if (msg.role !== "tool" || msg.content.length < 200) continue;
+    if (msg.content.startsWith("[collapsed ") || msg.content.startsWith("[storm-collapsed") || msg.content.startsWith("[tiered-")) continue;
+    const toolName = toolNameFromIndex(msg, toolCallIndex);
+    if (toolName === "grep" || toolName === "search" || toolName === "read_file") {
+      const target = targetFromIndex(msg, toolCallIndex);
+      if (target) {
+        const key = `${toolName}:${target}`;
+        const indices = toolOccurrences.get(key);
+        if (indices) indices.push(i);
+        else toolOccurrences.set(key, [i]);
+      }
+    }
+  }
+  const superseded = /* @__PURE__ */ new Set();
+  for (const indices of toolOccurrences.values()) {
+    if (indices.length > 1) {
+      for (let k = 0; k < indices.length - 1; k++) superseded.add(indices[k]);
+    }
+  }
+  let turnCounter = 0;
+  for (let i = 0; i < end; i++) {
+    const msg = messages[i];
+    if (msg.role === "user") turnCounter++;
+    if (msg.role === "assistant" && "reasoning_content" in msg && msg.reasoning_content) {
+      const { reasoning_content: _dropped, ...rest } = msg;
+      messages[i] = rest.content == null && !rest.tool_calls?.length ? { ...rest, content: "" } : rest;
+      continue;
+    }
+    if (msg.role !== "tool") continue;
+    if (msg.content.length < 200) continue;
+    if (msg.content.startsWith("[collapsed ") || msg.content.startsWith("[storm-collapsed") || msg.content.startsWith("[tiered-")) continue;
+    const toolName = toolNameFromIndex(msg, toolCallIndex);
+    if (superseded.has(i)) {
+      const target = targetFromIndex(msg, toolCallIndex);
+      messages[i] = { ...msg, content: `[collapsed ${toolName}: superseded by later ${toolName} on ${target ?? "same target"}]` };
+      continue;
+    }
+    if (lightOnly) continue;
+    const turnAge = currentTurn - turnCounter;
+    const collapsed = collapseToolResult(toolName, msg.content, turnAge, contextWindow);
+    if (collapsed) {
+      messages[i] = { ...msg, content: collapsed.summary };
+    }
+  }
+}
+function buildToolCallIndex(messages, end) {
+  const index = /* @__PURE__ */ new Map();
+  for (let i = 0; i < end; i++) {
+    const msg = messages[i];
+    if (msg.role !== "assistant" || !msg.tool_calls?.length) continue;
+    for (const call of msg.tool_calls) {
+      let target = null;
+      if (call.function.name === "grep" || call.function.name === "search") {
+        target = parseCallTarget(call.function.arguments, ["pattern", "query"]);
+      } else if (call.function.name === "read_file") {
+        target = parseCallTarget(call.function.arguments, ["path", "file"]);
+      }
+      index.set(call.id, { name: call.function.name, target });
+    }
+  }
+  return index;
+}
+function parseCallTarget(argumentsJson, keys) {
+  try {
+    const args = JSON.parse(argumentsJson);
+    for (const key of keys) {
+      const value = args[key];
+      if (typeof value === "string") return value;
+    }
+  } catch {
+  }
+  return null;
+}
+function toolNameFromIndex(msg, index) {
+  const toolCallId = msg.tool_call_id;
+  if (!toolCallId) return "unknown";
+  return index.get(toolCallId)?.name ?? "unknown";
+}
+function targetFromIndex(msg, index) {
+  const toolCallId = msg.tool_call_id;
+  if (!toolCallId) return null;
+  return index.get(toolCallId)?.target ?? null;
+}
+
+export {
+  buildSystemPrompt,
+  detectModelFamily,
+  formatVolatilePayloadReport,
+  PromptEngine
+};