oh-my-opencode-cohub 1.0.15 → 1.0.16

package/README.md

@@ -72,6 +72,34 @@ CLI 会精确清理所有 `co-*` 代理和相关配置，不影响其他插件
 - 可用代理列表中出现 12 个 `co-*` 前缀代理（`co-orchestrator`、`co-oracle`、`co-librarian`、`co-explorer`、`co-designer`、`co-fixer`、`co-observer`、`co-council`、`co-rule-user`、`co-rule-project`、`co-rule-app`、`co-planner`）
 - Orchestrator 自动进入纯调度模式（只做规划、委派、验证，不直接操作文件）
 
+### 从源码安装（本地开发）
+
+如果需要修改源码或使用开发版本：
+
+```bash
+# 1. 克隆项目
+git clone <repo-url> && cd oh-my-opencode-cohub
+
+# 2. 安装依赖
+npm install
+
+# 3. 构建（需要系统已安装 Bun）
+npm run build
+
+# 4. 方式 A：npm link 全局链接（推荐）
+npm link
+bunx oh-my-opencode-cohub install
+# 重启 OpenCode 即可。之后修改源码只需重新 npm run build
+
+# 4. 方式 B：手动配置绝对路径
+# 编辑 ~/.config/opencode/opencode.json，在 plugin 数组中写入项目绝对路径：
+# { "plugin": ["/absolute/path/to/oh-my-opencode-cohub"] }
+# 然后手动运行 CLI 注册代理：
+# node dist/cli/index.js install
+```
+
+> **构建依赖**：`npm run build` 使用 `bun build` 和 `tsc`。系统需安装 [Bun](https://bun.sh)（构建工具）和 Node.js（类型声明生成）。所有 `@opencode-ai/*`、`@opentui/*`、`zod` 均为 external，不打包进 `dist/`。
+
 ## 代理一览
 
 ### 代理（12 个，全中文提示词）

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;AAqClD,wBAAwB;AACxB,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAalD,CAAC;AAwEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,wrBAA+B,CAAC;AAEhE,QAAA,MAAM,WAAW,EAAE,MAqNlB,CAAC;AAEF,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;AAqClD,wBAAwB;AACxB,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAalD,CAAC;AAwEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,wrBAA+B,CAAC;AAEhE,QAAA,MAAM,WAAW,EAAE,MAiSlB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -443,11 +443,12 @@ class TaskTracker {
     const label = typeof args.description === "string" ? args.description : alias;
     this.jobs.set(alias, {
       alias,
-      sessionId: "",
+      sessionId: args.task_id ?? "",
       parentSessionId,
       agent,
       label,
       status: "running",
+      background: args.background ?? false,
       terminalReconciled: false,
       createdAt: Date.now()
     });
@@ -462,11 +463,24 @@ class TaskTracker {
       }
     }
     if (latest) {
+      if (latest.background) {
+        if (sessionId)
+          latest.sessionId = sessionId;
+        return;
+      }
       latest.status = status;
       if (sessionId)
         latest.sessionId = sessionId;
     }
   }
+  updateByChildSessionId(sessionId, status) {
+    for (const job of this.jobs.values()) {
+      if (job.sessionId === sessionId && job.background && job.status === "running") {
+        job.status = status;
+        return;
+      }
+    }
+  }
   getBoardText(parentSessionId) {
     const pid = parentSessionId || this._currentParentSessionId;
     const activeJobs = [];
@@ -513,6 +527,14 @@ class TaskTracker {
       job.terminalReconciled = true;
     }
   }
+  cleanupStaleJobs(timeoutMs) {
+    const now = Date.now();
+    for (const job of this.jobs.values()) {
+      if (job.background && job.status === "running" && now - job.createdAt > timeoutMs) {
+        job.status = "errored";
+      }
+    }
+  }
   isReusable(alias) {
     const job = this.jobs.get(alias);
     return job?.status === "completed" && job.terminalReconciled;
@@ -732,6 +754,46 @@ var CoHubPlugin = async (input, options) => {
     }
   }
   syncAgentConfig();
+  function extractChildSessionId(output) {
+    if (!output || typeof output !== "object")
+      return;
+    const o = output;
+    const meta = o.metadata;
+    if (meta) {
+      if (typeof meta.sessionId === "string")
+        return meta.sessionId;
+      if (typeof meta.taskId === "string")
+        return meta.taskId;
+      if (typeof meta.task_id === "string")
+        return meta.task_id;
+      if (typeof meta.id === "string")
+        return meta.id;
+    }
+    const text = typeof o.output === "string" ? o.output : "";
+    const m = text.match(/\b(session|task)[_\s]?(?:id|ID)[:\s]+(\S+)/i);
+    if (m)
+      return m[2];
+    return;
+  }
+  function extractSessionIdFromEvent(props) {
+    if (!props || typeof props !== "object")
+      return;
+    const p = props;
+    const info = p.info;
+    if (info?.id)
+      return info.id;
+    if (typeof p.sessionID === "string")
+      return p.sessionID;
+    if (typeof p.sessionId === "string")
+      return p.sessionId;
+    return;
+  }
+  const STALE_TIMEOUT_MS = 30 * 60 * 1000;
+  const cleanupTimer = setInterval(() => {
+    try {
+      tracker.cleanupStaleJobs(STALE_TIMEOUT_MS);
+    } catch {}
+  }, 30000);
   const agentConfigs = {};
   for (const agent of agents) {
     agentConfigs[agent.name] = {
@@ -767,14 +829,41 @@ var CoHubPlugin = async (input, options) => {
         }
       } catch {}
     },
-    "tool.execute.after": async (input2, _output) => {
+    "tool.execute.after": async (input2, output) => {
       try {
         if (input2.tool === "task") {
-          tracker.updateAfterTask(input2.sessionID, "completed");
+          try {
+            const debugDir = path2.join(os2.homedir(), ".local", "share", "opencode", "storage", "oh-my-opencode-cohub");
+            if (!fs2.existsSync(debugDir))
+              fs2.mkdirSync(debugDir, { recursive: true });
+            fs2.writeFileSync(path2.join(debugDir, "task-output-debug.json"), JSON.stringify({
+              time: new Date().toISOString(),
+              callID: input2.callID,
+              output_keys: Object.keys(output || {}),
+              output: JSON.parse(JSON.stringify(output))
+            }, null, 2), "utf-8");
+          } catch {}
+          const childSessionId = extractChildSessionId(output);
+          tracker.updateAfterTask(input2.sessionID, "completed", childSessionId);
           syncTrackerState(input2.sessionID ?? "");
         }
       } catch {}
     },
+    event: async (input2) => {
+      try {
+        const e = input2.event;
+        const sessionId = extractSessionIdFromEvent(e.properties);
+        if (!sessionId)
+          return;
+        if (e.type === "session.idle") {
+          tracker.updateByChildSessionId(sessionId, "completed");
+          syncTrackerState(tracker.currentParentSessionId);
+        } else if (e.type === "session.deleted" || e.type === "session.error") {
+          tracker.updateByChildSessionId(sessionId, "errored");
+          syncTrackerState(tracker.currentParentSessionId);
+        }
+      } catch {}
+    },
     "experimental.chat.messages.transform": async (_input, output) => {
       try {
         const board = tracker.getBoardText();
@@ -799,6 +888,9 @@ var CoHubPlugin = async (input, options) => {
     },
     "experimental.chat.system.transform": async (_input, output) => {
       output.system.push(CHINESE_LANGUAGE_INSTRUCTION);
+    },
+    dispose: async () => {
+      clearInterval(cleanupTimer);
     }
   };
 };

package/dist/task-manager/tracker.d.ts

@@ -13,9 +13,14 @@ export declare class TaskTracker {
     registerBeforeTask(parentSessionId: string, args: TaskArgs): string;
     /**
      * 在 tool.execute.after 中调用，更新任务完成状态
-     * 匹配 parentSessionId 下最近创建且仍为 running 的任务
+     * 非背景任务：立即标 completed；背景任务：不更新（等 session.idle 事件）
      */
     updateAfterTask(parentSessionId: string, status: TaskStatus, sessionId?: string): void;
+    /**
+     * 根据子 session ID 更新任务状态（供 event hook 使用）
+     * 当背景任务的 session 变为 idle 时调用
+     */
+    updateByChildSessionId(sessionId: string, status: TaskStatus): void;
     /**
      * 生成 Background Job Board 文本
      */
@@ -24,6 +29,10 @@ export declare class TaskTracker {
      * 标记任务已调和（不再显示在 Unreconciled 中）
      */
     reconcileJob(alias: string): void;
+    /**
+     * 清理超时的背景任务（超过 timeoutMs 仍 running 的标为 errored）
+     */
+    cleanupStaleJobs(timeoutMs: number): void;
     /**
      * 检查任务是否可复用
      */

package/dist/task-manager/tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/task-manager/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,yCAAyC;IACzC,OAAO,CAAC,uBAAuB,CAAM;IAErC,IAAI,sBAAsB,IAAI,MAAM,CAEnC;IAED,mDAAmD;IACnD,OAAO,CAAC,KAAK;IAOb;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAoBnE;;;OAGG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBtF;;OAEG;IACH,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA4CrD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKlC,2BAA2B;IAC3B,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAUnD,uBAAuB;IACvB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;CASjD"}
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/task-manager/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,QAAQ,CAA6B;IAC7C,yCAAyC;IACzC,OAAO,CAAC,uBAAuB,CAAM;IAErC,IAAI,sBAAsB,IAAI,MAAM,CAEnC;IAED,mDAAmD;IACnD,OAAO,CAAC,KAAK;IAOb;;OAEG;IACH,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IAqBnE;;;OAGG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBtF;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IASnE;;OAEG;IACH,YAAY,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA4CrD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASzC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKlC,2BAA2B;IAC3B,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAUnD,uBAAuB;IACvB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;CASjD"}

package/dist/task-manager/types.d.ts

@@ -6,6 +6,7 @@ export interface JobRecord {
     agent: string;
     label: string;
     status: TaskStatus;
+    background: boolean;
     terminalReconciled: boolean;
     createdAt: number;
 }

package/dist/task-manager/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/task-manager/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/task-manager/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode-cohub",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "OpenCode 中文智能体编排插件 CoHub - 纯调度模式 / 全中文提示词 / 规范分析代理 / 方案制定代理 / 独立运行",
   "type": "module",
   "main": "dist/index.js",