oh-my-opencode-cohub 1.18.6 → 1.18.7

package/README.md

@@ -23,22 +23,21 @@ OpenCode 中文智能体编排插件 CoHub——纯调度模式、全中文提
 ### 前置条件
 
 - [OpenCode](https://opencode.ai) 已安装
-- [Bun](https://bun.sh) 已安装（CLI 安装和源码构建均需要）
+- [Bun](https://bun.sh) 已安装（隔离 HOME 检验与源码构建需要；官方插件安装不需要）
 
-### 方式一：CLI 一键安装（推荐）
+### 方式一：官方插件安装（推荐，真实 HOME）
 
 ```bash
-bunx oh-my-opencode-cohub install
+opencode plugin oh-my-opencode-cohub@<精确版本号> --global --force
 ```
 
-CLI 会自动完成以下操作：
+> 安装前先对 `~/.config/opencode/opencode.json` 与 `~/.config/opencode/tui.json` 做**时间戳备份**；命令只写入插件相关条目，**保留其他配置**。
 
-1. 将 `oh-my-opencode-cohub` 注册到 `~/.config/opencode/opencode.json` 的 `plugin` 数组
-2. 将插件注册到 TUI 配置 `~/.config/opencode/tui.json`
-3. 在 `opencode.json` 的 `agent` 字段中注册全部 12 个 `co-*` 代理
-4. 写入默认配置文件 `~/.config/opencode/oh-my-opencode-cohub.json`
+1. 将 `oh-my-opencode-cohub@<精确版本号>` 注册到全局 `plugin` 配置（`--global --force` 覆盖为指定精确版本）
+2. 插件运行时写入默认配置文件 `~/.config/opencode/oh-my-opencode-cohub.json`
+3. **重启 OpenCode 后生效**——已运行的会话不会热切加载新版本，需用户重启
 
-重启 OpenCode 即可生效。
+> **bunx 包 CLI 仅用于隔离 HOME 检验**：`bunx oh-my-opencode-cohub install/uninstall` 等包自带 CLI 只在隔离 HOME 环境中验证安装/卸载流程，**不要在真实 HOME 上整文件重写配置**。
 
 ### 方式二：npm 安装 + 手动配置
 
@@ -328,14 +327,19 @@ CoHub 内置轻量编排引擎（`src/orchestration/`，6 模块），**诚实
 
 ### 上下文共享
 
-ContextEngine（`src/context/`）按四种策略自动向子代理注入上下文：
+ContextEngine（`src/context/`）默认**不注入**历史上下文——所有代理默认策略为 `none`，每次委派不会自动读取父会话历史（避免无谓的上下文膨胀与 token 消耗）。需要历史上下文时由调度者显式 opt-in：
+
+- **任务级 opt-in**：`task` 调用传 `context_override` 参数（如 `context_override="relevant"`）；
+- **配置级 opt-in**：在 `oh-my-opencode-cohub.json` 的 `context.strategy` 中为指定代理显式配置非 `none` 策略。
 
-| 策略 | 适用代理 | 注入内容 |
-|------|---------|---------|
-| `none` | explorer / librarian / observer / rule-* | 不注入上下文，减少干扰 |
-| `relevant` | fixer / designer / planner | 相关文件路径 + 前置决策 + 近期错误 |
-| `summary` | oracle / council | 同上，且文件正文按 token 预算（2000）截断后注入 |
-| `full` | （预留） | 完整正文，目前未分配代理 |
+| 策略 | 注入内容 |
+|------|---------|
+| `none` | 不注入上下文（默认） |
+| `relevant` | 相关文件路径 + 前置决策 + 近期错误 |
+| `summary` | 同上，且文件正文按 token 预算（2000）截断后注入 |
+| `full` | 完整正文（预留） |
+
+**依赖传播（`context.dependencyPropagation`，默认 `false`）**：子代理结果默认不自动传播到后续子代理；需要依赖历史摘要时显式配置 `"context": { "dependencyPropagation": true }`。关闭时 `captureResult` 仍照常返回结果与质量/复用预算采样（任务追踪、质量回送不受影响），仅不做依赖缓存写入与注入。
 
 **summary 文件读取模式（`context.summaryReadMode`，默认 `bounded`）**：控制 `summary` 策略下**文件正文的读取方式**，与上面的上下文策略 `full` 是**两个不同维度**，不要混淆：
 
@@ -346,7 +350,11 @@ ContextEngine（`src/context/`）按四种策略自动向子代理注入上下
 
 ```json
 {
-  "context": { "summaryReadMode": "bounded" }
+  "context": {
+    "strategy": { "co-fixer": "relevant", "co-oracle": "summary" },
+    "dependencyPropagation": true,
+    "summaryReadMode": "bounded"
+  }
 }
 ```
 
@@ -370,7 +378,7 @@ ContextEngine（`src/context/`）按四种策略自动向子代理注入上下
 ### 注入膨胀防护
 
 - **prompt 预算兜底**：拼接超 12,000 token 时降级为裸用户 prompt，防止 JSON 超长截断
-- **CONTRACT 去重**：`stripExistingContracts` 清理历史残留契约块
+- **CONTRACT 去重**：`stripExistingContracts` 仅清理插件自生成的 goal-only 空壳契约块，含约束/前置/其他内容的契约块（含用户手写）保守保留；新契约非空才追加且不重复追加
 - **错误截断**：单条 ≤200 字符 + 渲染总量 ≤600
 - **Job Board 折叠**：展示上限 15 条 + `pruneTerminalJobs` 每 30 分钟清理终态任务
 

package/dist/cli/index.js

@@ -77,7 +77,7 @@ function computeStats(records, window = DEFAULT_STATS_WINDOW) {
   return result;
 }
 // package.json
-var version = "1.18.6";
+var version = "1.18.7";
 
 // src/cli/config-io.ts
 import * as fs2 from "node:fs";

package/dist/context/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/context/extractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAuB5C,yBAAyB;AACzB,UAAU,OAAO;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,sBAAsB;AACtB,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,CAmGhB;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAqBV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,UAAU,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAwBV;AAID,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/context/extractor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAyB5C,yBAAyB;AACzB,UAAU,OAAO;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,sBAAsB;AACtB,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,CAmGhB;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAqBV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,UAAU,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAwBV;AAID,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/context/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvE,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uBAAuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,4BAA4B;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,WAAW;AACX,eAAO,MAAM,sBAAsB,EAAE,aAwBpC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAe;AACf,eAAO,MAAM,2BAA2B,EAAE,iBAGzC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAEA,cAAc;AACd,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvE,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uBAAuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,4BAA4B;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B;IAC3B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,WAAW;AACX,eAAO,MAAM,sBAAsB,EAAE,aA4BpC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAe;AACf,eAAO,MAAM,2BAA2B,EAAE,iBAGzC,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAsIlD,QAAA,MAAM,WAAW,EAAE,MAglClB,CAAC;AAEF,eAAO,MAAM,MAAM,QAAc,CAAC;AAClC,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAsIlD,QAAA,MAAM,WAAW,EAAE,MAuqClB,CAAC;AAEF,eAAO,MAAM,MAAM,QAAc,CAAC;AAClC,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -832,11 +832,11 @@ var DEFAULT_CONTEXT_CONFIG = {
     "co-explorer": "none",
     "co-librarian": "none",
     "co-observer": "none",
-    "co-fixer": "relevant",
-    "co-designer": "relevant",
-    "co-planner": "relevant",
-    "co-oracle": "summary",
-    "co-council": "summary",
+    "co-fixer": "none",
+    "co-designer": "none",
+    "co-planner": "none",
+    "co-oracle": "none",
+    "co-council": "none",
     "co-rule-user": "none",
     "co-rule-project": "none",
     "co-rule-app": "none"
@@ -845,7 +845,7 @@ var DEFAULT_CONTEXT_CONFIG = {
   maxDecisions: 10,
   maxErrors: 5,
   maxDependencies: 8,
-  dependencyPropagation: true,
+  dependencyPropagation: false,
   summarizeMaxTokens: 2000,
   summaryReadMode: "bounded",
   relevantMessageWindow: 20,
@@ -1639,7 +1639,7 @@ var KNOWN_EXTENSIONS = new Set([
   "gitignore",
   "editorconfig"
 ]);
-var FILE_PATH_RE = /`?((?:[A-Za-z]:[\\\/]|\.{1,2}[\\\/]|~\/|\/|[\w-]+[\\\/])[\w\-\.\\\/]+\.\w{1,10})`?/g;
+var FILE_PATH_RE = /`?((?:[A-Za-z]:[\\\/]|\.{1,2}[\\\/]|~\/|\/|[\w\-~]+[\\\/])[\w\-\.\\\/~]+\.\w{1,10})`?/g;
 function extractRelevantFiles(messages, maxFiles, windowSize) {
   const recent = messages.slice(-windowSize);
   const fileMap = new Map;
@@ -3774,7 +3774,15 @@ class OrchestrationEngine {
 var CONTRACT_PATTERN = /<!-- CONTRACT_BEGIN -->\n([\s\S]*?)<!-- CONTRACT_END -->/;
 var CONTRACT_STRIP_PATTERN = /<!-- CONTRACT_BEGIN -->[\s\S]*?<!-- CONTRACT_END -->/g;
 function stripExistingContracts(text) {
-  return text.replace(CONTRACT_STRIP_PATTERN, "");
+  return text.replace(CONTRACT_STRIP_PATTERN, (match) => {
+    const inner = match.replace(/<!-- CONTRACT_BEGIN -->/, "").replace(/<!-- CONTRACT_END -->/, "").trim();
+    const lines = inner.split(`
+`).map((l) => l.trim()).filter(Boolean);
+    if (lines.length === 2 && lines[0] === "## 本任务前置上下文" && lines[1].startsWith("- 目标:")) {
+      return "";
+    }
+    return match;
+  });
 }
 
 class ContractManager {
@@ -3806,8 +3814,7 @@ class ContractManager {
     };
   }
   buildPrompt(context) {
-    const lines = ["<!-- CONTRACT_BEGIN -->", "## 本任务前置上下文"];
-    lines.push(`- 目标: ${context.goal}`);
+    const lines = [];
     if (context.constraints.length) {
       lines.push("- 约束:");
       context.constraints.forEach((c) => lines.push(`  - ${c}`));
@@ -3824,8 +3831,9 @@ class ContractManager {
         }
       });
     }
-    lines.push("<!-- CONTRACT_END -->");
-    return lines.join(`
+    if (lines.length === 0)
+      return "";
+    return ["<!-- CONTRACT_BEGIN -->", "## 本任务前置上下文", ...lines, "<!-- CONTRACT_END -->"].join(`
 `);
   }
   summarize(contracts) {
@@ -4263,12 +4271,12 @@ var CoHubPlugin = async (input, options) => {
     const aliasAtCall = job.alias;
     const childId = job.sessionId;
     if (!childId)
-      return;
+      return false;
     const verdict = await verifyChildTerminal(pluginClient, childId, job.createdAt);
     const nowJob = callAtCall ? tracker.getJobByCall(parentAtCall, callAtCall) : tracker.getJobBySessionId(childId);
     if (!nowJob || nowJob.alias !== aliasAtCall || nowJob.sessionId !== childId || nowJob.status !== "running") {
       appendSafeLog("event", `收尾竞态：候选已变更，不更新新调用 (session=${childId.slice(0, 20)})`);
-      return;
+      return false;
     }
     if (verdict === "completed" || verdict === "errored" || verdict === "cancelled") {
       const term = verdict === "completed" ? "completed" : verdict === "cancelled" ? "cancelled" : "errored";
@@ -4287,6 +4295,7 @@ var CoHubPlugin = async (input, options) => {
         durationMs: Date.now() - job.createdAt,
         lastActivityAt: Date.now()
       });
+      return verdict === "completed" && up.ok;
     } else {
       appendSafeLog("event", `无终态证据，保持 running (session=${childId.slice(0, 20)})`);
       taskDiag({
@@ -4297,8 +4306,46 @@ var CoHubPlugin = async (input, options) => {
         status: "running",
         lastActivityAt: Date.now()
       });
+      return false;
     }
   }
+  function captureAndWriteBack(opts) {
+    contextEngine.captureResult(opts.childSessionId, opts.alias, opts.agent, { notBefore: opts.createdAt }).then((captured) => {
+      if (samplingSeq.get(opts.alias) !== opts.seq)
+        return;
+      if (!captured)
+        return;
+      const wantQuality = isQualityEnabled(userConfig.quality);
+      const wantReuse = reuseBudget.enabled;
+      if (!wantQuality && !wantReuse)
+        return;
+      const now = opts.callID ? tracker.getJobByCall(opts.parentSessionId, opts.callID) : tracker.getJobBySessionId(opts.childSessionId);
+      if (!now || now.alias !== opts.alias || now.sessionId !== opts.childSessionId) {
+        appendSafeLog("event", "质量回送竞态：候选已变更，不写回复用/新调用");
+        return;
+      }
+      const freshSample = wantReuse && captured.reuseInput && captured.reuseInput.sampledAt >= opts.createdAt ? captured.reuseInput : undefined;
+      if (wantQuality) {
+        const quality = assessQuality({
+          output: captured.output,
+          decisions: captured.decisions,
+          latencyMs: Date.now() - opts.createdAt,
+          tokens: captured.tokens
+        });
+        tracker.updateQualityByAlias(opts.alias, {
+          score: quality.score,
+          ...quality.failureCategory ? { failureCategory: quality.failureCategory } : {},
+          ...quality.latencyMs !== undefined ? { latencyMs: quality.latencyMs } : {},
+          ...quality.tokens ? { tokens: quality.tokens } : {},
+          ...freshSample ? { reuseInput: freshSample } : {}
+        });
+      } else if (wantReuse) {
+        const prev = tracker.getJobByAlias(opts.alias)?.quality;
+        tracker.updateQualityByAlias(opts.alias, { ...prev ?? {}, reuseInput: freshSample });
+      }
+      syncTrackerState(tracker.currentParentSessionId);
+    }).catch((err) => appendSafeLog("event", "质量回送失败", err));
+  }
   const cleanupTimer = setInterval(() => {
     try {
       const staleSessions = tracker.cleanupStaleJobs(STALE_TASK_MS);
@@ -4427,12 +4474,15 @@ var CoHubPlugin = async (input, options) => {
               const targetField = output.args?.prompt ? "prompt" : "description";
               if (output.args?.[targetField] && typeof output.args[targetField] === "string") {
                 output.args[targetField] = stripExistingContracts(output.args[targetField]);
-                output.args[targetField] += `
-` + orchestrationLayer.contractMgr.buildPrompt({
+                const contractText = orchestrationLayer.contractMgr.buildPrompt({
                   goal: description,
                   prerequisites: [],
                   constraints: []
                 });
+                if (contractText && !output.args[targetField].includes("<!-- CONTRACT_BEGIN -->")) {
+                  output.args[targetField] += `
+` + contractText;
+                }
               }
               const lr = orchestrationLayer.engine.applyLifecycleEvent(alias, "running");
               if (!lr.ok) {
@@ -4466,19 +4516,13 @@ var CoHubPlugin = async (input, options) => {
             if (strategy !== "none") {
               const contextId = contextEngine.registerContext({ description });
               output.args ??= {};
-              const contextBlock = `
-
-### \uD83D\uDCCB 任务上下文 (CoHub 自动注入)
-` + "**当前任务**: " + description + `
-`;
               const targetField = typeof output.args.prompt === "string" ? "prompt" : "description";
-              output.args[targetField] = ((targetField === "prompt" ? output.args.prompt : description) ?? "") + contextBlock;
               await contextEngine.fillContextAsync(contextId, input.sessionID, {
                 strategy
               });
               const details = contextEngine.formatContextDetails(contextId);
               if (details) {
-                output.args[targetField] += details;
+                output.args[targetField] = ((targetField === "prompt" ? output.args.prompt : description) ?? "") + details;
               }
               contextEngine.releaseContext(contextId);
               if (ctxDiag.enabled) {
@@ -4590,6 +4634,13 @@ var CoHubPlugin = async (input, options) => {
                   lastActivityAt: Date.now()
                 });
               } else {
+                const snapAlias = job0.alias;
+                const snapParent = job0.parentSessionId;
+                const snapCall = job0.callID;
+                const snapChild = childSessionId ?? job0.sessionId;
+                const snapCreatedAt = job0.createdAt;
+                const snapAgent = job0.agent;
+                const wasRunningAtAfter = job0.status === "running";
                 taskDiag({
                   t: "task",
                   callID: input.callID,
@@ -4599,7 +4650,26 @@ var CoHubPlugin = async (input, options) => {
                   status: "running",
                   lastActivityAt: Date.now()
                 });
-                await reconcileJobTerminal(job0);
+                const seqAtAfter = samplingSeq.get(snapAlias) ?? 0;
+                const finalizedByThis = await reconcileJobTerminal(job0);
+                if (finalizedByThis && wasRunningAtAfter && snapChild) {
+                  if ((samplingSeq.get(snapAlias) ?? 0) === seqAtAfter) {
+                    const nowJob = snapCall ? tracker.getJobByCall(snapParent, snapCall) : tracker.getJobBySessionId(snapChild);
+                    if (nowJob && nowJob.status === "completed" && nowJob.alias === snapAlias && nowJob.sessionId === snapChild) {
+                      const seq = seqAtAfter + 1;
+                      samplingSeq.set(snapAlias, seq);
+                      captureAndWriteBack({
+                        alias: snapAlias,
+                        parentSessionId: snapParent,
+                        callID: snapCall,
+                        childSessionId: snapChild,
+                        agent: snapAgent,
+                        createdAt: snapCreatedAt,
+                        seq
+                      });
+                    }
+                  }
+                }
               }
             } catch (e) {
               appendSafeLog("orchestration", "afterTask engine 同步失败", e);
@@ -4632,48 +4702,22 @@ var CoHubPlugin = async (input, options) => {
           const qAlias = job.alias;
           const qParent = job.parentSessionId;
           const qCall = job.callID;
-          const qChild = sessionId;
           const qCreatedAt = job.createdAt;
+          const qAgent = job.agent;
           const seq = (samplingSeq.get(qAlias) ?? 0) + 1;
           samplingSeq.set(qAlias, seq);
           await reconcileJobTerminal(job);
           if (samplingSeq.get(qAlias) !== seq)
             return;
-          contextEngine.captureResult(sessionId, qAlias, job.agent, { notBefore: qCreatedAt }).then((captured) => {
-            if (samplingSeq.get(qAlias) !== seq)
-              return;
-            if (!captured)
-              return;
-            const wantQuality = isQualityEnabled(userConfig.quality);
-            const wantReuse = reuseBudget.enabled;
-            if (!wantQuality && !wantReuse)
-              return;
-            const now = qCall ? tracker.getJobByCall(qParent, qCall) : tracker.getJobBySessionId(qChild);
-            if (!now || now.alias !== qAlias || now.sessionId !== qChild) {
-              appendSafeLog("event", "质量回送竞态：候选已变更，不写回复用/新调用");
-              return;
-            }
-            const freshSample = wantReuse && captured.reuseInput && captured.reuseInput.sampledAt >= qCreatedAt ? captured.reuseInput : undefined;
-            if (wantQuality) {
-              const quality = assessQuality({
-                output: captured.output,
-                decisions: captured.decisions,
-                latencyMs: Date.now() - qCreatedAt,
-                tokens: captured.tokens
-              });
-              tracker.updateQualityByAlias(qAlias, {
-                score: quality.score,
-                ...quality.failureCategory ? { failureCategory: quality.failureCategory } : {},
-                ...quality.latencyMs !== undefined ? { latencyMs: quality.latencyMs } : {},
-                ...quality.tokens ? { tokens: quality.tokens } : {},
-                ...freshSample ? { reuseInput: freshSample } : {}
-              });
-            } else if (wantReuse) {
-              const prev = tracker.getJobByAlias(qAlias)?.quality;
-              tracker.updateQualityByAlias(qAlias, { ...prev ?? {}, reuseInput: freshSample });
-            }
-            syncTrackerState(tracker.currentParentSessionId);
-          }).catch((err) => appendSafeLog("event", "质量回送失败", err));
+          captureAndWriteBack({
+            alias: qAlias,
+            parentSessionId: qParent,
+            callID: qCall,
+            childSessionId: sessionId,
+            agent: qAgent,
+            createdAt: qCreatedAt,
+            seq
+          });
         } else if (e.type === "session.deleted") {
           if (!sessionId)
             return;

package/dist/orchestration/contract.d.ts

@@ -1,7 +1,12 @@
 import type { AgentContract } from './types';
 /**
- * 删除文本中所有 `<!-- CONTRACT_BEGIN -->...<!-- CONTRACT_END -->` 块。
- * 用于防止同一次 task() 的 prompt 中契约块重复膨胀。
+ * 清理历史残留的插件自生成「goal-only 空壳」契约块。
+ *
+ * 背景：旧版 buildPrompt 在无约束/无前置时仍输出 `## 本任务前置上下文 + - 目标: xxx`，
+ * 目标已随本任务 prompt 传递、无独立信息价值，同一次 task() 重复 before 会累积这些空壳块。
+ * 仅严格匹配该空壳形态（标题 + 仅一行 `- 目标:`、无任何其他内容）才清除；
+ * 含约束/前置结果/其他内容的契约块（含用户手写契约、调度显式约束）**保守保留**——
+ * 绝不按中文标题宽泛删除用户内容。
  * 无匹配时原样返回。
  */
 export declare function stripExistingContracts(text: string): string;
@@ -17,7 +22,10 @@ export declare class ContractManager {
      */
     private parseLines;
     /**
-     * 构建传递给子代理的提示词，包含目标、约束和前置任务结果。
+     * 构建传递给子代理的提示词，包含约束和显式前置任务结果交接。
+     * 目标不再重复输出（任务目标已在本任务 prompt 中，避免重复膨胀）；
+     * 仅当存在真正约束或显式前置依赖交接时才生成契约块，否则返回空字符串
+     * （入口仅在非空时追加，保证重复 before 不堆积空壳契约）。
      * 输出包含 CONTRACT_BEGIN/END 标记，子代理可追加自己的契约。
      */
     buildPrompt(context: {

package/dist/orchestration/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/orchestration/contract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,qBAAa,eAAe;IAC1B;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAM7C;;;OAGG;IACH,OAAO,CAAC,UAAU;IAqBlB;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,aAAa,CAAA;SAAE,EAAE,CAAC;QAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,GAAG,MAAM;IAuBV;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM;CAY9C"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/orchestration/contract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY3D;AAED,qBAAa,eAAe;IAC1B;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAM7C;;;OAGG;IACH,OAAO,CAAC,UAAU;IAqBlB;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,aAAa,CAAA;SAAE,EAAE,CAAC;QAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,GAAG,MAAM;IAsBV;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM;CAY9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode-cohub",
-  "version": "1.18.6",
+  "version": "1.18.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Mr-cjf/cohub.git",