@ifrankwang/openspec-agents 0.146.0 → 0.147.0

package/.mcp-server/cli.mjs

@@ -7268,6 +7268,18 @@ function prefixIssues(path, issues) {
 function unwrapMessage(message) {
   return typeof message === "string" ? message : message?.message;
 }
+function sizeCaps(defChecks) {
+  const caps = [];
+  for (const ch of defChecks ?? []) {
+    const d = ch._zod.def;
+    if (!/_(length|size)$|_equals$/.test(d.check))
+      break;
+    const max = d.maximum ?? d.length ?? d.size;
+    if (max >= 0)
+      caps.push([max, ch]);
+  }
+  return caps;
+}
 function attachSchema(issues, start, inst) {
   var _a;
   for (let i = start;i < issues.length; i++) {
@@ -8270,7 +8282,7 @@ ${content.join(`
 var version = {
   major: 4,
   minor: 6,
-  patch: 5
+  patch: 6
 };
 
 // node_modules/zod/v4/core/schemas.js
@@ -8843,6 +8855,29 @@ var $ZodNever = /* @__PURE__ */ $constructor("$ZodNever", (inst, def) => {
     return payload;
   };
 });
+function capSize(inst, size) {
+  const caps = sizeCaps(inst._zod.def.checks);
+  if (!caps.length)
+    return;
+  const cap = Math.min(...caps.map((c) => c[0]));
+  const parse = inst._zod.parse;
+  inst._zod.parse = (payload, ctx) => {
+    const n = size(payload.value);
+    if (n > cap && !ctx?.skipChecks && ctx?.direction !== "backward") {
+      for (const [max, ch] of sizeCaps(inst._zod.def.checks)) {
+        if (n > max && ch._zod.def.when(payload)) {
+          const start = payload.issues.length;
+          ch._zod.check(payload);
+          payload.issues[start].continue = false;
+          attachSchema(payload.issues, start, inst);
+          return payload;
+        }
+      }
+    }
+    return parse(payload, ctx);
+  };
+}
+var arraySize = (input) => Array.isArray(input) ? input.length : -1;
 function handleArrayResult(result, final, index) {
   if (result.issues.length) {
     final.issues.push(...prefixIssues(index, result.issues));
@@ -8886,6 +8921,7 @@ var $ZodArray = /* @__PURE__ */ $constructor("$ZodArray", (inst, def) => {
     }
     return payload;
   };
+  capSize(inst, arraySize);
 });
 function handlePropertyResult(result, final, key, input, optin, optout) {
   const isPresent = key in input;
@@ -30533,7 +30569,7 @@ async function ensureDefaultUnattended(args, ctx) {
     }
   } catch {}
 }
-var PKG_VERSION = "0.146.0";
+var PKG_VERSION = "0.147.0";
 function buildMcpServer(worktree, opts = {}) {
   const mcp = new McpServer({ name: "openspec-agents", version: PKG_VERSION });
   for (const [name, spec] of Object.entries(TOOL_SPECS)) {
@@ -30560,9 +30596,9 @@ function buildMcpServer(worktree, opts = {}) {
 }
 
 // src/adapters/mcp-common/index.ts
-import { createServer as createServer3 } from "node:http";
+import { createServer as createServer2 } from "node:http";
 import { randomUUID } from "node:crypto";
-import { join as join5 } from "node:path";
+import { join as join4 } from "node:path";
 
 // node_modules/@hono/node-server/dist/constants-BLSFu_RU.mjs
 var X_ALREADY_SENT = "x-hono-already-sent";
@@ -32790,158 +32826,9 @@ class StreamableHTTPServerTransport {
     this._webStandardTransport.closeStandaloneSSEStream();
   }
 }
-
-// src/adapters/opencode/dashboard.ts
-import { createServer as createServer2 } from "node:http";
-
-// src/core/dashboard.ts
-import { readdirSync as readdirSync4, existsSync as existsSync5 } from "node:fs";
-import { readFile as readFile5 } from "node:fs/promises";
-import path7 from "path";
-function toWorkItemCard(item) {
-  const agentVerdicts = Object.entries(item.tags).map(([key, verdict]) => {
-    const sep = key.indexOf(":");
-    return {
-      stepId: sep === -1 ? key : key.slice(0, sep),
-      agentKey: sep === -1 ? key : key.slice(sep + 1),
-      verdict
-    };
-  });
-  const suspendReason = typeof item.metadata["suspend_reason"] === "string" ? item.metadata["suspend_reason"] : undefined;
-  return {
-    id: item.id,
-    type: item.type,
-    title: item.title,
-    description: item.description,
-    phase: item.phase,
-    suspended: item.suspended,
-    suspendReason,
-    currentStep: item.currentStep,
-    labels: item.labels,
-    source: item.source,
-    severity: item.severity,
-    agentVerdicts,
-    children: item.children.map((child) => ({
-      id: child.id,
-      type: child.type,
-      title: child.title,
-      phase: child.phase,
-      severity: child.severity
-    }))
-  };
-}
-function projectState(state) {
-  return {
-    active: true,
-    changeId: state.changeId,
-    currentTaskGroupId: state.taskGroupId,
-    baseBranch: state.baseBranch,
-    createdAt: state.createdAt,
-    updatedAt: state.updatedAt,
-    workItems: state.workItems,
-    workItemCards: state.workItems.map(toWorkItemCard)
-  };
-}
-async function readDashboardState(worktree, changeId) {
-  if (changeId) {
-    const state = await readStateByWorktree(worktree, changeId);
-    if (!state)
-      return null;
-    return projectState(state);
-  }
-  const stateDir = getStateDir(worktree);
-  if (!existsSync5(stateDir))
-    return null;
-  const files = readdirSync4(stateDir).filter((f) => f.endsWith(".json"));
-  const results = [];
-  for (const f of files) {
-    try {
-      const raw = await readFile5(path7.join(stateDir, f), "utf-8");
-      const state = JSON.parse(raw);
-      if (!state.changeId)
-        continue;
-      results.push(projectState(state));
-    } catch {}
-  }
-  if (results.length === 1)
-    return results[0];
-  return results.length > 0 ? results : null;
-}
-
-// src/dashboard/page.ts
-import { fileURLToPath as fileURLToPath3 } from "node:url";
-import { readFileSync as readFileSync5, existsSync as existsSync6 } from "node:fs";
-import { join as join3 } from "node:path";
-var _html = null;
-function resolveDashboardHtml() {
-  const __dirname2 = fileURLToPath3(new URL(".", import.meta.url));
-  const bundled = join3(__dirname2, "dashboard", "index.html");
-  if (existsSync6(bundled))
-    return bundled;
-  return join3(__dirname2, "../../assets/dashboard/index.html");
-}
-function getDashboardPage() {
-  if (_html)
-    return _html;
-  _html = readFileSync5(resolveDashboardHtml(), "utf-8");
-  return _html;
-}
-
-// src/adapters/opencode/dashboard.ts
-var BASE_PORT = 4519;
-var MAX_ATTEMPTS = 20;
-var servers = new Map;
-async function startDashboard(worktree) {
-  if (servers.has(worktree))
-    return;
-  const pageHtml = getDashboardPage();
-  for (let port = BASE_PORT;port < BASE_PORT + MAX_ATTEMPTS; port++) {
-    try {
-      const server = createServer2(async (req, res) => {
-        try {
-          const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "127.0.0.1"}`);
-          if (url.pathname === "/api/state") {
-            try {
-              const data = await readDashboardState(worktree);
-              res.writeHead(200, { "content-type": "application/json;charset=utf-8" });
-              res.end(JSON.stringify(data ?? { active: false }));
-            } catch (err) {
-              res.writeHead(500, { "content-type": "application/json;charset=utf-8" });
-              res.end(JSON.stringify({ active: false, error: String(err) }));
-            }
-            return;
-          }
-          res.writeHead(200, { "content-type": "text/html;charset=utf-8" });
-          res.end(pageHtml);
-        } catch (err) {
-          console.error("[dashboard]", err.message);
-          res.writeHead(500, { "content-type": "text/plain;charset=utf-8" });
-          res.end("internal error");
-        }
-      });
-      await new Promise((resolve, reject) => {
-        server.once("error", (err) => {
-          if (err.code === "EADDRINUSE") {
-            reject(err);
-          } else {
-            console.error("[dashboard]", err.message);
-            resolve();
-          }
-        });
-        server.listen(port, "127.0.0.1", () => resolve());
-      });
-      servers.set(worktree, server);
-      console.log(`[dashboard] 编排进度看板 http://127.0.0.1:${port}`);
-      return;
-    } catch {
-      continue;
-    }
-  }
-  console.error(`[dashboard] 无法启动编排进度看板：端口 ${BASE_PORT}-${BASE_PORT + MAX_ATTEMPTS - 1} 均被占用`);
-}
 // src/core/workflow/collector.ts
-import { readdirSync as readdirSync5, readFileSync as readFileSync6 } from "node:fs";
-import { join as join4 } from "node:path";
+import { readdirSync as readdirSync4, readFileSync as readFileSync5 } from "node:fs";
+import { join as join3 } from "node:path";
 var DEFAULT_POLL_INTERVAL_MS = 30000;
 var SOURCE = "openspec";
 var CHANGE_LABEL = "openspec-change";
@@ -32975,10 +32862,10 @@ class OpenSpecCollector {
     this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
   }
   async pull() {
-    const changesDir = join4(this.openspecDir, "changes");
+    const changesDir = join3(this.openspecDir, "changes");
     let entries;
     try {
-      entries = readdirSync5(changesDir, { withFileTypes: true });
+      entries = readdirSync4(changesDir, { withFileTypes: true });
     } catch {
       return [];
     }
@@ -32987,7 +32874,7 @@ class OpenSpecCollector {
       if (!entry.isDirectory())
         continue;
       try {
-        const proposalText = readFileSync6(join4(changesDir, entry.name, "proposal.md"), "utf8");
+        const proposalText = readFileSync5(join3(changesDir, entry.name, "proposal.md"), "utf8");
         refs.push({ changeName: entry.name, proposalText });
       } catch {
         continue;
@@ -33129,8 +33016,7 @@ var DEFAULT_PORT = 4525;
 var MAX_PORT_ATTEMPTS = 20;
 function startSideEffects(worktree) {
   try {
-    startDashboard(worktree);
-    registerCollector(new OpenSpecCollector({ openspecDir: join5(worktree, "openspec") }));
+    registerCollector(new OpenSpecCollector({ openspecDir: join4(worktree, "openspec") }));
     registerCollector(new AdoCollector);
     readContextFromWorktree(worktree).then((ctx) => {
       if (ctx?.changeId && ctx?.taskGroupId) {
@@ -33145,7 +33031,7 @@ async function startMcpServer(opts) {
   const port = opts.port ?? DEFAULT_PORT;
   const hostname = opts.hostname ?? "127.0.0.1";
   const transports = new Map;
-  const server = createServer3(async (req, res) => {
+  const server = createServer2(async (req, res) => {
     const url = new URL(req.url ?? "/", `http://${req.headers.host ?? hostname}`);
     if (url.pathname === "/mcp") {
       const sessionId = Array.isArray(req.headers["mcp-session-id"]) ? req.headers["mcp-session-id"][0] : req.headers["mcp-session-id"];
@@ -33207,7 +33093,7 @@ async function startMcpServer(opts) {
 }
 
 // src/adapters/mcp-common/cli.ts
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { realpathSync } from "node:fs";
 function parseArgs(argv) {
   const args = new Map;
@@ -33243,7 +33129,7 @@ async function main(argv) {
   startMcpServer(opts);
 }
 try {
-  if (realpathSync(fileURLToPath4(import.meta.url)) === realpathSync(process.argv[1] ?? "")) {
+  if (realpathSync(fileURLToPath3(import.meta.url)) === realpathSync(process.argv[1] ?? "")) {
     main(process.argv.slice(2));
   }
 } catch {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifrankwang/openspec-agents",
-  "version": "0.146.0",
+  "version": "0.147.0",
   "description": "OpenSpec change orchestration plugin for AI coding agents (Claude Code, Codex, ZCode, DeepSeek Harness, OpenCode)",
   "author": "ifrankwang",
   "license": "MIT",

package/src/adapters/deepseek-harness/index.ts

@@ -57,6 +57,14 @@ export const DSH_NATIVE_TOOLS_ROW_NAME = `${DSH_PLUGIN_NAME}${DSH_NATIVE_TOOLS_E
 /** cordis patch 中挂载原生工具插件的 insert 行 id。 */
 export const DSH_NATIVE_TOOLS_ROW_ID = "openspec-opx-tools"
 
+/**
+ * skill 根在插件包内的相对目录（分段写法：assets/skills）。
+ * patch 的 customSkillDirs 引用与构建落位共用本常量：两处各写一份字面量会各自漂移成
+ * 「patch 指 assets/skills、产物落位包根 skills/」，DSH 一个 skill 都加载不到——历史缺陷即此。
+ * 同一份 patch 同时服务 npm 根包与 dist 插件包两种安装形态，包根（仓库根）亦按 assets/skills 落位。
+ */
+export const DSH_SKILLS_DIR_SEGMENTS = ["assets", "skills"] as const
+
 /** 原生工具插件与 skill 根的基础 patch；子代理工具行由 buildDshPatchContent 动态追加。 */
 const DSH_BASE_PATCH_YAML = `# DeepSeek Harness (DSH) bundle patch: expose OpenSpec orchestration tools and skills.
 # The patch is applied as a bundle layer under dsh.profile.bundles.
@@ -78,7 +86,7 @@ const DSH_BASE_PATCH_YAML = `# DeepSeek Harness (DSH) bundle patch: expose OpenS
         providerName: openspec-filesystem
         includeDefaultRoots: false
         customSkillDirs:
-          - !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('./node_modules/${DSH_PLUGIN_NAME}/assets/skills', baseUrl))"
+          - !!js "process.getBuiltinModule('node:url').fileURLToPath(new URL('./node_modules/${DSH_PLUGIN_NAME}/${DSH_SKILLS_DIR_SEGMENTS.join("/")}', baseUrl))"
 `
 
 interface DshSubagentEntry {
@@ -177,14 +185,14 @@ export type DeepSeekHarnessPluginBuildResult = PluginPackageResult
 export function buildDeepSeekHarnessPlugin(outDir: string = DEEP_SEEK_HARNESS_PLUGIN_DIR): DeepSeekHarnessPluginBuildResult {
   rmSync(outDir, { recursive: true, force: true })
   mkdirSync(join(outDir, "agents"), { recursive: true })
-  mkdirSync(join(outDir, "skills"), { recursive: true })
   mkdirSync(join(outDir, "assets"), { recursive: true })
+  mkdirSync(join(outDir, ...DSH_SKILLS_DIR_SEGMENTS), { recursive: true })
   mkdirSync(join(outDir, ".dsh-plugin"), { recursive: true })
 
   const version = readPkgVersion()
   // DSH 通过上方 subagent 工具消费 agent 定义；agents/ 目录仍保留原始 markdown 供参考/审计。
   const agents = buildAgents(join(outDir, "agents"))
-  const skills = buildSkills(join(outDir, "skills"))
+  const skills = buildSkills(join(outDir, ...DSH_SKILLS_DIR_SEGMENTS))
   bundleDshNativeTools(outDir)
   copyWorkflows(outDir)
   copyLicense(outDir)

package/src/adapters/mcp-common/index.ts

@@ -1,6 +1,6 @@
 /**
  * MCP Server 启动入口：HTTP transport（node:http）承载 6 个 opx_* 工具，
- * 并承载 dashboard/collector/poller 副作用（原 OpenCode 插件壳职责迁移至此）。
+ * 并承载 collector/poller 副作用（原 OpenCode 插件壳职责迁移至此）。
  * 非 OpenCode agent（claude code / codex / zcode）经 MCP client 接入同一套编排状态机。
  */
 import { createServer, type Server } from "node:http"
@@ -8,7 +8,6 @@ import { randomUUID } from "node:crypto"
 import { join } from "node:path"
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js"
 import { buildMcpServer } from "./server.ts"
-import { startDashboard } from "../opencode/dashboard.ts"
 import { OpenSpecCollector, AdoCollector, registerCollector, startPolling } from "../../core/workflow/index.ts"
 import { readContextFromWorktree } from "../../core/state.ts"
 
@@ -23,10 +22,9 @@ export interface McpServerOptions {
 export const DEFAULT_PORT = 4525
 const MAX_PORT_ATTEMPTS = 20
 
-/** 启动 dashboard/collector/poller 副作用（原插件壳职责，单一宿主 = MCP server 进程）。 */
+/** 启动 collector/poller 副作用（原插件壳职责，单一宿主 = MCP server 进程）。 */
 function startSideEffects(worktree: string): void {
   try {
-    void startDashboard(worktree)
     // 注册内置收集器（OpenSpec + ADO 占位）并启动定时拉取；worktree 为动态上下文在此注入。
     registerCollector(new OpenSpecCollector({ openspecDir: join(worktree, "openspec") }))
     registerCollector(new AdoCollector())
@@ -37,7 +35,7 @@ function startSideEffects(worktree: string): void {
       }
     })
   } catch {
-    // dashboard/调度启动失败不影响编排功能
+    // 调度启动失败不影响编排功能
   }
 }
 

package/src/adapters/opencode/index.ts

@@ -12,7 +12,7 @@ import { writeAgents } from "./agents.ts"
  * - 随包 skill 走 skill 域 transform 逐项注册，path 指向包内 SKILL.md 以保留附属文件基准；
  * - 子代理以文件形式投放至项目 `.opencode/agents/`（V2 插件接口无新增 agent 的能力）。
  *
- * dashboard/collector/poller 副作用由 MCP server 进程承担（src/adapters/mcp-common/），
+ * collector/poller 副作用由 MCP server 进程承担（src/adapters/mcp-common/），
  * 插件壳不启动任何后台任务。
  *
  * 插件 ID 稳定为 openspec-agents：V2 以该 ID 标识插件、隔离其持久化存储，并用于配置中的
@@ -22,7 +22,7 @@ export const OPENCODE_PLUGIN_ID = "openspec-agents"
 
 /**
  * 构造 opx MCP server 配置。入口为包内 .mcp-server/cli.mjs（prepack 构建的自包含 bundle），
- * --worktree 指向当前加载本插件的项目根（ctx.location.directory），dashboard/collector 副作用
+ * --worktree 指向当前加载本插件的项目根（ctx.location.directory），collector 副作用
  * 与状态读写均以此为根。
  */
 function mcpServerConfig(projectRoot: string) {

package/src/adapters/plugin-common/index.ts

@@ -35,8 +35,6 @@ export function readPkgVersion(): string {
 export function bundleMcpServer(pluginDir: string): string {
   const out = join(pluginDir, ".mcp-server", "cli.mjs")
   mkdirSync(join(pluginDir, ".mcp-server"), { recursive: true })
-  // dashboard 页面资源随 bundle 同目录放置（page.ts 按此布局探测）
-  cpSync(resolve("assets", "dashboard"), join(pluginDir, ".mcp-server", "dashboard"), { recursive: true })
   const result = spawnSync(
     "bun",
     [

package/src/core/index.ts

@@ -65,9 +65,6 @@ export {
   renderAgentSummaries, formatFilePath, renderTaskItem, formatSeverity,
 } from "./views.ts"
 
-// dashboard
-export { readDashboardState } from "./dashboard.ts"
-
 // constants
 export {
   STATE_DIR_NAME, STATE_SUBDIR_NAME,

package/src/core/provider.ts

@@ -46,14 +46,12 @@ export interface RuntimeTool {
 /** 工具注册表：工具名 → 定义。 */
 export type ToolRegistry = Record<string, RuntimeTool>
 
-/** 运行时配置注入：agent/skill 注入指令与可选 dashboard 配置。 */
+/** 运行时配置注入：agent/skill 注入指令。 */
 export interface IRuntimeConfig {
   /** 分发的 agent 定义根目录（各适配器按自身注入格式消费）。 */
   agentsDir?: string
   /** 分发的 skill 根目录列表（各适配器按自身发现机制注册）。 */
   skillsDirs?: string[]
-  /** 可选编排进度看板。 */
-  dashboard?: { port?: number; hostname?: string }
 }
 
 /**

package/.mcp-server/dashboard/index.html

@@ -1,295 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>编排进度看板 · 5 列看板</title>
-<style>
-@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap');
-:root{
-  --bg:#f8fafc;--surface:#fff;--surface-2:#f1f5f9;
-  --ink:#0f172a;--muted:#475569;--quiet:#94a3b8;
-  --line:#e2e8f0;--line-2:#cbd5e1;
-  --blue:#2563eb;--blue-soft:#eff6ff;
-  --green:#16a34a;--green-soft:#f0fdf4;
-  --amber:#d97706;--amber-soft:#fffbeb;
-  --red:#dc2626;--red-soft:#fef2f2;
-  --violet:#7c3aed;--violet-soft:#f5f3ff;
-  --teal:#0d9488;--teal-soft:#f0fdfa;
-  --radius:12px;--radius-sm:8px;--pill:999px;
-  --shadow:0 1px 2px rgba(15,23,42,.04),0 6px 16px rgba(15,23,42,.04);
-  --sans:'Inter',system-ui,sans-serif;
-  --mono:'JetBrains Mono',ui-monospace,monospace;
-}
-*{box-sizing:border-box}html{font-size:15px}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.55;-webkit-font-smoothing:antialiased}
-button{font:inherit;cursor:pointer}button:focus-visible{outline:2px solid var(--blue);outline-offset:2px}
-.shell{max-width:1440px;margin:0 auto;padding:32px 28px 80px}
-/* header */
-.topbar{display:flex;justify-content:space-between;align-items:flex-start;gap:24px;padding-bottom:26px;border-bottom:1px solid var(--line)}
-.brand{display:flex;flex-direction:column;gap:8px}
-.badge{display:inline-flex;align-items:center;gap:8px;font:600 .68rem/1 var(--mono);letter-spacing:.08em;text-transform:uppercase;color:var(--muted)}
-.badge::before{content:"";width:7px;height:7px;border-radius:50%;background:var(--green);box-shadow:0 0 0 4px var(--green-soft)}
-h1{margin:0;font-size:1.6rem;font-weight:700;letter-spacing:-.03em}
-.meta{display:flex;gap:28px;text-align:right;font-size:.8rem;color:var(--muted)}
-.meta span{display:flex;flex-direction:column;gap:5px}.meta strong{color:var(--ink);font-weight:600}
-/* 5 列看板 */
-.board{display:grid;grid-template-columns:repeat(5,1fr);gap:16px;align-items:start;padding-top:24px}
-.col{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);box-shadow:var(--shadow);overflow:hidden;display:flex;flex-direction:column}
-.col-head{display:flex;justify-content:space-between;align-items:center;gap:8px;padding:14px 16px;border-bottom:1px solid var(--line)}
-.col-head h3{margin:0;font-size:.92rem;font-weight:700}
-.col-count{font:600 .78rem/1 var(--mono);padding:4px 10px;background:var(--surface-2);border-radius:var(--pill);color:var(--muted)}
-.col-body{max-height:calc(100vh - 280px);overflow:auto;padding:12px;display:flex;flex-direction:column;gap:12px}
-.board-empty{grid-column:1/-1;padding:48px 0;text-align:center;color:var(--quiet);font-size:.9rem}
-/* 卡片 */
-.card{position:relative;background:var(--surface);border:1px solid var(--line);border-left-width:3px;border-radius:var(--radius-sm);box-shadow:0 1px 2px rgba(15,23,42,.04);padding:12px 14px;display:flex;flex-direction:column;gap:8px}
-.card.task{border-left-color:var(--blue)}
-.card.issue{border-left-color:var(--violet)}
-.card.suspended{border-style:dashed;opacity:.94}
-.card-head{display:flex;align-items:center;gap:8px}
-.type-tag{flex:0 0 auto;width:22px;height:22px;border-radius:6px;display:inline-flex;align-items:center;justify-content:center;font:700 .7rem/1 var(--mono);color:#fff}
-.type-tag.task{background:var(--blue)}.type-tag.issue{background:var(--violet)}
-.src-icon{flex:0 0 auto;font-size:.85rem;color:var(--quiet);line-height:1}
-.card-title{margin:0;font-size:.9rem;font-weight:700;line-height:1.4;flex:1}
-.card-desc{font-size:.78rem;color:var(--muted);line-height:1.5}
-.card-desc.collapsed{display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
-.desc-toggle{margin-top:-4px;font-size:.72rem;color:var(--blue);background:none;border:none;padding:0;cursor:pointer;text-align:left}
-.card-labels{display:flex;flex-wrap:wrap;gap:6px}
-.chip{display:inline-flex;align-items:center;padding:2px 8px;border-radius:var(--pill);font:500 .68rem/1.4 var(--mono);background:var(--surface-2);color:var(--muted);border:1px solid var(--line)}
-.card-children{display:flex;flex-direction:column;gap:6px;border-top:1px dashed var(--line);padding-top:8px}
-.child-row{display:flex;align-items:center;gap:6px;font-size:.76rem;color:var(--muted)}
-.child-type{flex:0 0 auto;width:16px;height:16px;border-radius:4px;display:inline-flex;align-items:center;justify-content:center;font:700 .58rem/1 var(--mono);color:#fff}
-.child-type.task{background:var(--blue)}.child-type.issue{background:var(--violet)}
-.child-title{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.child-phase{flex:0 0 auto;padding:1px 6px;border-radius:var(--pill);font:600 .62rem/1.3 var(--mono);background:var(--surface-2);color:var(--muted);border:1px solid var(--line)}
-.card-foot{display:flex;justify-content:space-between;align-items:flex-end;gap:8px;margin-top:auto;border-top:1px solid var(--line);padding-top:8px}
-.card-verdicts{display:flex;flex-wrap:wrap;gap:6px}
-.verdict{display:inline-flex;align-items:center;gap:3px;padding:2px 7px;border-radius:var(--pill);font:600 .68rem/1.4 var(--mono);background:var(--surface-2);color:var(--muted)}
-.verdict.passed{background:var(--green-soft);color:var(--green)}
-.verdict.failed{background:var(--red-soft);color:var(--red)}
-.verdict.pending{background:var(--surface-2);color:var(--quiet)}
-.card-meta{display:flex;align-items:center;gap:6px;flex-shrink:0}
-.step-tag{font:.68rem/1.4 var(--mono);color:var(--quiet)}
-.suspend-tag{display:inline-flex;align-items:center;gap:4px;padding:2px 8px;border-radius:var(--pill);font:600 .7rem/1.4 var(--mono);background:var(--amber-soft);color:var(--amber);border:1px solid var(--amber);cursor:pointer}
-.suspend-reason{margin-top:4px;font-size:.72rem;color:var(--amber);background:var(--amber-soft);border-radius:var(--radius-sm);padding:6px 8px}
-/* severity 色条 */
-.sev-bar{position:absolute;top:0;left:0;right:0;height:4px;border-radius:var(--radius-sm) var(--radius-sm) 0 0}
-.sev-bar.critical{background:var(--red)}.sev-bar.high{background:var(--amber)}.sev-bar.medium{background:var(--violet)}.sev-bar.low{background:var(--teal)}.sev-bar.info{background:var(--line-2)}
-/* WorkItem 详情弹窗 */
-.modal-open{overflow:hidden}
-.modal-overlay{position:fixed;inset:0;z-index:100;background:rgba(15,23,42,.45);display:flex;align-items:flex-start;justify-content:center;padding:48px 16px;overflow:auto}
-.modal-overlay[hidden]{display:none}
-.modal-dialog{background:var(--surface);border-radius:var(--radius);box-shadow:0 20px 50px rgba(15,23,42,.2);max-width:640px;width:100%;max-height:calc(100vh - 96px);display:flex;flex-direction:column}
-.modal-head{display:flex;align-items:center;gap:12px;padding:14px 18px;border-bottom:1px solid var(--line)}
-.modal-title{flex:1;font-size:.92rem;font-weight:700}
-.modal-close{background:none;border:none;font-size:1.2rem;color:var(--muted);line-height:1;padding:4px 8px;border-radius:6px}
-.modal-close:hover{background:var(--surface-2);color:var(--ink)}
-.modal-back{background:none;border:1px solid var(--line);border-radius:var(--radius-sm);font-size:.78rem;color:var(--muted);padding:4px 10px}
-.modal-back:hover{background:var(--surface-2);color:var(--ink)}
-.modal-back[hidden]{display:none}
-.modal-body{padding:18px;overflow:auto;display:flex;flex-direction:column;gap:14px}
-.detail-title{margin:0;font-size:1.1rem;font-weight:700}
-.detail-block{display:flex;flex-direction:column;gap:8px}
-.detail-block h5{margin:0;font-size:.68rem;letter-spacing:.06em;text-transform:uppercase;color:var(--quiet)}
-.meta-row{display:flex;gap:10px;font-size:.8rem;padding:4px 0;border-bottom:1px dashed var(--line)}
-.meta-key{flex:0 0 96px;color:var(--quiet);font:500 .76rem/1.4 var(--mono)}
-.meta-val{flex:1;color:var(--ink);word-break:break-word}
-.detail-desc{margin:0;font-size:.82rem;color:var(--muted);white-space:pre-wrap}
-.detail-verdicts{display:flex;flex-wrap:wrap;gap:6px}
-.detail-verdict{display:inline-flex;align-items:center;gap:3px;padding:2px 7px;border-radius:var(--pill);font:600 .68rem/1.4 var(--mono);background:var(--surface-2);color:var(--muted)}
-.detail-verdict.passed{background:var(--green-soft);color:var(--green)}
-.detail-verdict.failed{background:var(--red-soft);color:var(--red)}
-.detail-verdict.pending{background:var(--surface-2);color:var(--quiet)}
-.detail-children{display:flex;flex-direction:column;gap:6px}
-.detail-child{display:flex;align-items:center;gap:8px;padding:8px 10px;border:1px solid var(--line);border-radius:var(--radius-sm);font-size:.8rem;cursor:pointer}
-.detail-child:hover{background:var(--surface-2);border-color:var(--line-2)}
-@media(max-width:1024px){.board{grid-template-columns:repeat(2,1fr)}}
-@media(max-width:640px){.board{grid-template-columns:1fr}.topbar{flex-direction:column;gap:14px}.meta{text-align:left}}
-</style>
-</head>
-<body>
-<div class="shell">
-  <header class="topbar">
-    <div class="brand">
-      <div class="badge" id="connBadge"><span>实时同步</span></div>
-      <h1>编排进度看板</h1>
-    </div>
-    <div class="meta">
-      <span>变更编号<strong id="changeId">-</strong></span>
-      <span>基准分支<strong id="baseBranch">-</strong></span>
-      <span>最后更新<strong id="updatedAt">-</strong></span>
-    </div>
-  </header>
-  <main id="dashboard"></main>
-</div>
-<div class="modal-overlay" id="wiModal" hidden>
-  <div class="modal-dialog" role="dialog" aria-modal="true" aria-label="工作项详情">
-    <header class="modal-head">
-      <button class="modal-back" id="wiBack" hidden>← 返回</button>
-      <span class="modal-title">工作项详情</span>
-      <button class="modal-close" id="wiClose" aria-label="关闭">×</button>
-    </header>
-    <div class="modal-body" id="wiBody"></div>
-  </div>
-</div>
-<script>
-const COLUMNS=[['todo','待办'],['in_progress','处理中'],['review','审核中'],['done','完成'],['cancelled','已取消']];
-const SOURCE_ICONS={openspec:'◈',ado:'◆',custom:'✚'};
-const VERDICT_ICONS={passed:'✓',failed:'✕',pending:'○'};
-const AGENT_SHORT={'openspec-architect':'architect','openspec-developer':'dev','openspec-reviewer-tool':'tool','openspec-reviewer-task':'task','openspec-reviewer-style':'style','openspec-reviewer-architecture':'arch','openspec-reviewer-performance':'perf','openspec-reviewer-security':'sec','openspec-reviewer-maintainability':'maint'};
-let dashboardState={};
-function esc(v){return String(v??'').replace(/[&<>'"]/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','\'':'&#39;','"':'&quot;'}[c]))}
-function cls(v){return String(v??'').replace(/[^a-zA-Z0-9_-]/g,'_')}
-function shortAgent(key){if(AGENT_SHORT[key])return AGENT_SHORT[key];const m=/^openspec-reviewer-(.+)$/.exec(key)||/^openspec-(.+)$/.exec(key);return m?m[1]:(key||'')}
-function descBlock(text){if(!text)return '';if(text.length<90)return `<div class="card-desc">${esc(text)}</div>`;return `<div class="card-desc collapsed">${esc(text)}</div><button class="desc-toggle">展开</button>`}
-function verdictDot(v){return `<span class="verdict ${cls(v.verdict)}" title="${esc(v.stepId)}">${esc(shortAgent(v.agentKey))}:${VERDICT_ICONS[v.verdict]||'○'}</span>`}
-function renderCard(c){
-  const isIssue=c.type==='issue';
-  const typeTag=`<span class="type-tag ${isIssue?'issue':'task'}">${isIssue?'I':'T'}</span>`;
-  const srcIcon=`<span class="src-icon" title="${esc(c.source||'')}">${SOURCE_ICONS[c.source]||'●'}</span>`;
-  const sevBar=isIssue&&c.severity?`<span class="sev-bar ${cls(String(c.severity).toLowerCase())}" title="${esc(c.severity)}"></span>`:'';
-  const labels=(c.labels||[]).map(l=>`<span class="chip">${esc(l)}</span>`).join('');
-  const step=c.currentStep?`<span class="step-tag">${esc(c.currentStep)}</span>`:'';
-  const suspTag=c.suspended?'<span class="suspend-tag" role="button" tabindex="0">⏸ 暂停</span>':'';
-  const suspReason=c.suspended?`<div class="suspend-reason" hidden>${esc(c.suspendReason||'未提供暂停原因')}</div>`:'';
-  const verdicts=(c.agentVerdicts||[]).map(verdictDot).join('');
-  const children=(c.children||[]).map(ch=>`<div class="child-row"><span class="child-type ${cls(ch.type)}">${ch.type==='issue'?'I':'T'}</span><span class="child-title">${esc(ch.title)}</span>${ch.type==='task'?`<span class="child-phase">${esc(ch.phase)}</span>`:''}</div>`).join('');
-  return `<article class="card ${isIssue?'issue':'task'}${c.suspended?' suspended':''}" data-id="${esc(c.id)}">${sevBar}
-    <div class="card-head">${typeTag}${srcIcon}<h4 class="card-title">${esc(c.title)}</h4></div>
-    ${descBlock(c.description)}
-    ${labels?`<div class="card-labels">${labels}</div>`:''}
-    ${children?`<div class="card-children">${children}</div>`:''}
-    <div class="card-foot">${verdicts?`<div class="card-verdicts">${verdicts}</div>`:'<span></span>'}<div class="card-meta">${step}${suspTag}</div></div>
-    ${suspReason}
-  </article>`;
-}
-function renderBoard(){
-  const cards=dashboardState.workItemCards||[];
-  if(!cards.length)return `<section class="board"><div class="board-empty">暂无工作项数据（旧格式状态或未初始化）</div></section>`;
-  return `<section class="board">${COLUMNS.map(([key,label])=>{
-    const items=cards.filter(c=>c.phase===key);
-    return `<div class="col" data-col="${key}"><header class="col-head"><h3>${label}</h3><span class="col-count">${items.length}</span></header><div class="col-body">${items.map(renderCard).join('')}</div></div>`;
-  }).join('')}</section>`;
-}
-function render(){
-  document.getElementById('changeId').textContent=dashboardState.changeId||'-';
-  document.getElementById('baseBranch').textContent=dashboardState.baseBranch||'-';
-  document.getElementById('updatedAt').textContent=dashboardState.updatedAt?new Date(dashboardState.updatedAt).toLocaleString():'-';
-  document.getElementById('dashboard').innerHTML=renderBoard();
-  document.querySelectorAll('.desc-toggle').forEach(btn=>btn.addEventListener('click',e=>{
-    const d=e.target.previousElementSibling;
-    if(d&&d.classList.contains('card-desc')){d.classList.toggle('collapsed');e.target.textContent=d.classList.contains('collapsed')?'展开':'收起'}
-  }));
-  document.querySelectorAll('.suspend-tag').forEach(tag=>tag.addEventListener('click',e=>{
-    const card=e.target.closest('.card');
-    const reason=card&&card.querySelector('.suspend-reason');
-    if(reason)reason.hidden=!reason.hidden;
-  }));
-  if(modalState.id)refreshModal();
-}
-/* WorkItem 详情弹窗 */
-let modalState={id:null,back:[]};
-function findWorkItem(items,id){
-  for(const it of items||[]){
-    if(it.id===id)return it;
-    if(it.children&&it.children.length){
-      const found=findWorkItem(it.children,id);
-      if(found)return found;
-    }
-  }
-  return null;
-}
-function renderTags(tags){
-  const verdicts=Object.entries(tags||{}).map(([key,verdict])=>{
-    const sep=key.indexOf(':');
-    const stepId=sep===-1?key:key.slice(0,sep);
-    const agentKey=sep===-1?key:key.slice(sep+1);
-    return `<span class="detail-verdict ${cls(verdict)}" title="${esc(key)}">${esc(shortAgent(agentKey))}:${VERDICT_ICONS[verdict]||'○'}</span>`;
-  }).join('');
-  return verdicts?`<div class="detail-block"><h5>Agent 裁决</h5><div class="detail-verdicts">${verdicts}</div></div>`:'';
-}
-function renderWriteback(wb){
-  if(!wb)return '';
-  const rows=Object.entries(wb).filter(([k])=>!k.startsWith('_')).map(([k,v])=>{
-    const val=typeof v==='object'?JSON.stringify(v):String(v);
-    return `<div class="meta-row"><span class="meta-key">${esc(k)}</span><span class="meta-val">${esc(val)}</span></div>`;
-  }).join('');
-  return rows?`<div class="detail-block"><h5>写回</h5>${rows}</div>`:'';
-}
-function renderMeta(metadata){
-  const rows=Object.entries(metadata||{}).filter(([k])=>!k.startsWith('_')).map(([k,v])=>{
-    const val=typeof v==='object'?JSON.stringify(v):String(v);
-    return `<div class="meta-row"><span class="meta-key">${esc(k)}</span><span class="meta-val">${esc(val)}</span></div>`;
-  }).join('');
-  return rows?`<div class="detail-block"><h5>元数据</h5>${rows}</div>`:'';
-}
-function renderChildren(children){
-  if(!children||!children.length)return '';
-  const rows=(children||[]).map(ch=>`<div class="detail-child" data-id="${esc(ch.id)}" role="button" tabindex="0">
-    <span class="child-type ${cls(ch.type)}">${ch.type==='issue'?'I':'T'}</span>
-    <span class="child-title">${esc(ch.title)}</span>
-    <span class="child-phase">${esc(ch.phase)}</span>
-  </div>`).join('');
-  return `<div class="detail-block"><h5>Children</h5><div class="detail-children">${rows}</div></div>`;
-}
-function renderDetail(item){
-  const rows=[['类型',item.type],['来源',item.source],['ID',item.id]];
-  if(item.externalId)rows.push(['外部ID',item.externalId]);
-  rows.push(['阶段',item.phase]);
-  if(item.severity)rows.push(['严重级别',item.severity]);
-  rows.push(['当前步骤',item.currentStep||'-']);
-  const kv=rows.map(([k,v])=>`<div class="meta-row"><span class="meta-key">${esc(k)}</span><span class="meta-val">${esc(v)}</span></div>`).join('');
-  return `<h3 class="detail-title">${esc(item.title)}</h3>
-    ${item.suspended?`<div class="suspend-reason">⏸ 暂停：${esc(typeof (item.metadata||{})['suspend_reason']==='string'?(item.metadata||{})['suspend_reason']:'未提供暂停原因')}</div>`:''}
-    ${item.description?`<div class="detail-block"><h5>描述</h5><p class="detail-desc">${esc(item.description)}</p></div>`:''}
-    <div class="detail-block"><h5>字段</h5>${kv}</div>
-    ${item.labels&&item.labels.length?`<div class="detail-block"><h5>标签</h5><div class="card-labels">${item.labels.map(l=>`<span class="chip">${esc(l)}</span>`).join('')}</div></div>`:''}
-    ${renderTags(item.tags)}
-    ${renderWriteback(item.writeback)}
-    ${renderMeta(item.metadata)}
-    ${renderChildren(item.children)}`;
-}
-function refreshModal(){
-  const modal=document.getElementById('wiModal');
-  const item=findWorkItem(dashboardState.workItems||[],modalState.id);
-  if(!item){closeDetail();return;}
-  document.getElementById('wiBody').innerHTML=renderDetail(item);
-  document.getElementById('wiBack').hidden=!modalState.back.length;
-  modal.hidden=false;
-  document.body.classList.add('modal-open');
-}
-function openDetail(id,back){
-  modalState={id,back:back||[]};
-  refreshModal();
-}
-function closeDetail(){
-  modalState={id:null,back:[]};
-  const modal=document.getElementById('wiModal');
-  if(modal)modal.hidden=true;
-  document.body.classList.remove('modal-open');
-}
-document.addEventListener('click',e=>{
-  if(e.target.closest('.desc-toggle,.suspend-tag'))return;
-  const card=e.target.closest('.card');
-  if(card&&card.dataset.id)openDetail(card.dataset.id,[]);
-});
-document.getElementById('wiModal').addEventListener('click',e=>{
-  if(e.target.closest('#wiBack')){
-    const prev=modalState.back[modalState.back.length-1];
-    openDetail(prev,modalState.back.slice(0,-1));
-    return;
-  }
-  if(e.target.classList.contains('modal-overlay')){closeDetail();return;}
-  if(e.target.closest('.modal-close')){closeDetail();return;}
-  const child=e.target.closest('.detail-child');
-  if(child&&child.dataset.id)openDetail(child.dataset.id,[...modalState.back,modalState.id]);
-});
-document.addEventListener('keydown',e=>{
-  if(e.key==='Escape'){const modal=document.getElementById('wiModal');if(modal&&!modal.hidden)closeDetail();}
-});
-async function loadState(){try{const res=await fetch('/api/state');if(!res.ok)throw new Error('fetch failed');const data=await res.json();if(data&&data.active===true){dashboardState=data;render()}}catch(e){console.error('[dashboard] load state failed',e)}}
-render();
-loadState();
-setInterval(loadState,2000);
-</script>
-</body>
-</html>

package/assets/dashboard/index.html

@@ -1,295 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>编排进度看板 · 5 列看板</title>
-<style>
-@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap');
-:root{
-  --bg:#f8fafc;--surface:#fff;--surface-2:#f1f5f9;
-  --ink:#0f172a;--muted:#475569;--quiet:#94a3b8;
-  --line:#e2e8f0;--line-2:#cbd5e1;
-  --blue:#2563eb;--blue-soft:#eff6ff;
-  --green:#16a34a;--green-soft:#f0fdf4;
-  --amber:#d97706;--amber-soft:#fffbeb;
-  --red:#dc2626;--red-soft:#fef2f2;
-  --violet:#7c3aed;--violet-soft:#f5f3ff;
-  --teal:#0d9488;--teal-soft:#f0fdfa;
-  --radius:12px;--radius-sm:8px;--pill:999px;
-  --shadow:0 1px 2px rgba(15,23,42,.04),0 6px 16px rgba(15,23,42,.04);
-  --sans:'Inter',system-ui,sans-serif;
-  --mono:'JetBrains Mono',ui-monospace,monospace;
-}
-*{box-sizing:border-box}html{font-size:15px}body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--sans);line-height:1.55;-webkit-font-smoothing:antialiased}
-button{font:inherit;cursor:pointer}button:focus-visible{outline:2px solid var(--blue);outline-offset:2px}
-.shell{max-width:1440px;margin:0 auto;padding:32px 28px 80px}
-/* header */
-.topbar{display:flex;justify-content:space-between;align-items:flex-start;gap:24px;padding-bottom:26px;border-bottom:1px solid var(--line)}
-.brand{display:flex;flex-direction:column;gap:8px}
-.badge{display:inline-flex;align-items:center;gap:8px;font:600 .68rem/1 var(--mono);letter-spacing:.08em;text-transform:uppercase;color:var(--muted)}
-.badge::before{content:"";width:7px;height:7px;border-radius:50%;background:var(--green);box-shadow:0 0 0 4px var(--green-soft)}
-h1{margin:0;font-size:1.6rem;font-weight:700;letter-spacing:-.03em}
-.meta{display:flex;gap:28px;text-align:right;font-size:.8rem;color:var(--muted)}
-.meta span{display:flex;flex-direction:column;gap:5px}.meta strong{color:var(--ink);font-weight:600}
-/* 5 列看板 */
-.board{display:grid;grid-template-columns:repeat(5,1fr);gap:16px;align-items:start;padding-top:24px}
-.col{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);box-shadow:var(--shadow);overflow:hidden;display:flex;flex-direction:column}
-.col-head{display:flex;justify-content:space-between;align-items:center;gap:8px;padding:14px 16px;border-bottom:1px solid var(--line)}
-.col-head h3{margin:0;font-size:.92rem;font-weight:700}
-.col-count{font:600 .78rem/1 var(--mono);padding:4px 10px;background:var(--surface-2);border-radius:var(--pill);color:var(--muted)}
-.col-body{max-height:calc(100vh - 280px);overflow:auto;padding:12px;display:flex;flex-direction:column;gap:12px}
-.board-empty{grid-column:1/-1;padding:48px 0;text-align:center;color:var(--quiet);font-size:.9rem}
-/* 卡片 */
-.card{position:relative;background:var(--surface);border:1px solid var(--line);border-left-width:3px;border-radius:var(--radius-sm);box-shadow:0 1px 2px rgba(15,23,42,.04);padding:12px 14px;display:flex;flex-direction:column;gap:8px}
-.card.task{border-left-color:var(--blue)}
-.card.issue{border-left-color:var(--violet)}
-.card.suspended{border-style:dashed;opacity:.94}
-.card-head{display:flex;align-items:center;gap:8px}
-.type-tag{flex:0 0 auto;width:22px;height:22px;border-radius:6px;display:inline-flex;align-items:center;justify-content:center;font:700 .7rem/1 var(--mono);color:#fff}
-.type-tag.task{background:var(--blue)}.type-tag.issue{background:var(--violet)}
-.src-icon{flex:0 0 auto;font-size:.85rem;color:var(--quiet);line-height:1}
-.card-title{margin:0;font-size:.9rem;font-weight:700;line-height:1.4;flex:1}
-.card-desc{font-size:.78rem;color:var(--muted);line-height:1.5}
-.card-desc.collapsed{display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
-.desc-toggle{margin-top:-4px;font-size:.72rem;color:var(--blue);background:none;border:none;padding:0;cursor:pointer;text-align:left}
-.card-labels{display:flex;flex-wrap:wrap;gap:6px}
-.chip{display:inline-flex;align-items:center;padding:2px 8px;border-radius:var(--pill);font:500 .68rem/1.4 var(--mono);background:var(--surface-2);color:var(--muted);border:1px solid var(--line)}
-.card-children{display:flex;flex-direction:column;gap:6px;border-top:1px dashed var(--line);padding-top:8px}
-.child-row{display:flex;align-items:center;gap:6px;font-size:.76rem;color:var(--muted)}
-.child-type{flex:0 0 auto;width:16px;height:16px;border-radius:4px;display:inline-flex;align-items:center;justify-content:center;font:700 .58rem/1 var(--mono);color:#fff}
-.child-type.task{background:var(--blue)}.child-type.issue{background:var(--violet)}
-.child-title{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.child-phase{flex:0 0 auto;padding:1px 6px;border-radius:var(--pill);font:600 .62rem/1.3 var(--mono);background:var(--surface-2);color:var(--muted);border:1px solid var(--line)}
-.card-foot{display:flex;justify-content:space-between;align-items:flex-end;gap:8px;margin-top:auto;border-top:1px solid var(--line);padding-top:8px}
-.card-verdicts{display:flex;flex-wrap:wrap;gap:6px}
-.verdict{display:inline-flex;align-items:center;gap:3px;padding:2px 7px;border-radius:var(--pill);font:600 .68rem/1.4 var(--mono);background:var(--surface-2);color:var(--muted)}
-.verdict.passed{background:var(--green-soft);color:var(--green)}
-.verdict.failed{background:var(--red-soft);color:var(--red)}
-.verdict.pending{background:var(--surface-2);color:var(--quiet)}
-.card-meta{display:flex;align-items:center;gap:6px;flex-shrink:0}
-.step-tag{font:.68rem/1.4 var(--mono);color:var(--quiet)}
-.suspend-tag{display:inline-flex;align-items:center;gap:4px;padding:2px 8px;border-radius:var(--pill);font:600 .7rem/1.4 var(--mono);background:var(--amber-soft);color:var(--amber);border:1px solid var(--amber);cursor:pointer}
-.suspend-reason{margin-top:4px;font-size:.72rem;color:var(--amber);background:var(--amber-soft);border-radius:var(--radius-sm);padding:6px 8px}
-/* severity 色条 */
-.sev-bar{position:absolute;top:0;left:0;right:0;height:4px;border-radius:var(--radius-sm) var(--radius-sm) 0 0}
-.sev-bar.critical{background:var(--red)}.sev-bar.high{background:var(--amber)}.sev-bar.medium{background:var(--violet)}.sev-bar.low{background:var(--teal)}.sev-bar.info{background:var(--line-2)}
-/* WorkItem 详情弹窗 */
-.modal-open{overflow:hidden}
-.modal-overlay{position:fixed;inset:0;z-index:100;background:rgba(15,23,42,.45);display:flex;align-items:flex-start;justify-content:center;padding:48px 16px;overflow:auto}
-.modal-overlay[hidden]{display:none}
-.modal-dialog{background:var(--surface);border-radius:var(--radius);box-shadow:0 20px 50px rgba(15,23,42,.2);max-width:640px;width:100%;max-height:calc(100vh - 96px);display:flex;flex-direction:column}
-.modal-head{display:flex;align-items:center;gap:12px;padding:14px 18px;border-bottom:1px solid var(--line)}
-.modal-title{flex:1;font-size:.92rem;font-weight:700}
-.modal-close{background:none;border:none;font-size:1.2rem;color:var(--muted);line-height:1;padding:4px 8px;border-radius:6px}
-.modal-close:hover{background:var(--surface-2);color:var(--ink)}
-.modal-back{background:none;border:1px solid var(--line);border-radius:var(--radius-sm);font-size:.78rem;color:var(--muted);padding:4px 10px}
-.modal-back:hover{background:var(--surface-2);color:var(--ink)}
-.modal-back[hidden]{display:none}
-.modal-body{padding:18px;overflow:auto;display:flex;flex-direction:column;gap:14px}
-.detail-title{margin:0;font-size:1.1rem;font-weight:700}
-.detail-block{display:flex;flex-direction:column;gap:8px}
-.detail-block h5{margin:0;font-size:.68rem;letter-spacing:.06em;text-transform:uppercase;color:var(--quiet)}
-.meta-row{display:flex;gap:10px;font-size:.8rem;padding:4px 0;border-bottom:1px dashed var(--line)}
-.meta-key{flex:0 0 96px;color:var(--quiet);font:500 .76rem/1.4 var(--mono)}
-.meta-val{flex:1;color:var(--ink);word-break:break-word}
-.detail-desc{margin:0;font-size:.82rem;color:var(--muted);white-space:pre-wrap}
-.detail-verdicts{display:flex;flex-wrap:wrap;gap:6px}
-.detail-verdict{display:inline-flex;align-items:center;gap:3px;padding:2px 7px;border-radius:var(--pill);font:600 .68rem/1.4 var(--mono);background:var(--surface-2);color:var(--muted)}
-.detail-verdict.passed{background:var(--green-soft);color:var(--green)}
-.detail-verdict.failed{background:var(--red-soft);color:var(--red)}
-.detail-verdict.pending{background:var(--surface-2);color:var(--quiet)}
-.detail-children{display:flex;flex-direction:column;gap:6px}
-.detail-child{display:flex;align-items:center;gap:8px;padding:8px 10px;border:1px solid var(--line);border-radius:var(--radius-sm);font-size:.8rem;cursor:pointer}
-.detail-child:hover{background:var(--surface-2);border-color:var(--line-2)}
-@media(max-width:1024px){.board{grid-template-columns:repeat(2,1fr)}}
-@media(max-width:640px){.board{grid-template-columns:1fr}.topbar{flex-direction:column;gap:14px}.meta{text-align:left}}
-</style>
-</head>
-<body>
-<div class="shell">
-  <header class="topbar">
-    <div class="brand">
-      <div class="badge" id="connBadge"><span>实时同步</span></div>
-      <h1>编排进度看板</h1>
-    </div>
-    <div class="meta">
-      <span>变更编号<strong id="changeId">-</strong></span>
-      <span>基准分支<strong id="baseBranch">-</strong></span>
-      <span>最后更新<strong id="updatedAt">-</strong></span>
-    </div>
-  </header>
-  <main id="dashboard"></main>
-</div>
-<div class="modal-overlay" id="wiModal" hidden>
-  <div class="modal-dialog" role="dialog" aria-modal="true" aria-label="工作项详情">
-    <header class="modal-head">
-      <button class="modal-back" id="wiBack" hidden>← 返回</button>
-      <span class="modal-title">工作项详情</span>
-      <button class="modal-close" id="wiClose" aria-label="关闭">×</button>
-    </header>
-    <div class="modal-body" id="wiBody"></div>
-  </div>
-</div>
-<script>
-const COLUMNS=[['todo','待办'],['in_progress','处理中'],['review','审核中'],['done','完成'],['cancelled','已取消']];
-const SOURCE_ICONS={openspec:'◈',ado:'◆',custom:'✚'};
-const VERDICT_ICONS={passed:'✓',failed:'✕',pending:'○'};
-const AGENT_SHORT={'openspec-architect':'architect','openspec-developer':'dev','openspec-reviewer-tool':'tool','openspec-reviewer-task':'task','openspec-reviewer-style':'style','openspec-reviewer-architecture':'arch','openspec-reviewer-performance':'perf','openspec-reviewer-security':'sec','openspec-reviewer-maintainability':'maint'};
-let dashboardState={};
-function esc(v){return String(v??'').replace(/[&<>'"]/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','\'':'&#39;','"':'&quot;'}[c]))}
-function cls(v){return String(v??'').replace(/[^a-zA-Z0-9_-]/g,'_')}
-function shortAgent(key){if(AGENT_SHORT[key])return AGENT_SHORT[key];const m=/^openspec-reviewer-(.+)$/.exec(key)||/^openspec-(.+)$/.exec(key);return m?m[1]:(key||'')}
-function descBlock(text){if(!text)return '';if(text.length<90)return `<div class="card-desc">${esc(text)}</div>`;return `<div class="card-desc collapsed">${esc(text)}</div><button class="desc-toggle">展开</button>`}
-function verdictDot(v){return `<span class="verdict ${cls(v.verdict)}" title="${esc(v.stepId)}">${esc(shortAgent(v.agentKey))}:${VERDICT_ICONS[v.verdict]||'○'}</span>`}
-function renderCard(c){
-  const isIssue=c.type==='issue';
-  const typeTag=`<span class="type-tag ${isIssue?'issue':'task'}">${isIssue?'I':'T'}</span>`;
-  const srcIcon=`<span class="src-icon" title="${esc(c.source||'')}">${SOURCE_ICONS[c.source]||'●'}</span>`;
-  const sevBar=isIssue&&c.severity?`<span class="sev-bar ${cls(String(c.severity).toLowerCase())}" title="${esc(c.severity)}"></span>`:'';
-  const labels=(c.labels||[]).map(l=>`<span class="chip">${esc(l)}</span>`).join('');
-  const step=c.currentStep?`<span class="step-tag">${esc(c.currentStep)}</span>`:'';
-  const suspTag=c.suspended?'<span class="suspend-tag" role="button" tabindex="0">⏸ 暂停</span>':'';
-  const suspReason=c.suspended?`<div class="suspend-reason" hidden>${esc(c.suspendReason||'未提供暂停原因')}</div>`:'';
-  const verdicts=(c.agentVerdicts||[]).map(verdictDot).join('');
-  const children=(c.children||[]).map(ch=>`<div class="child-row"><span class="child-type ${cls(ch.type)}">${ch.type==='issue'?'I':'T'}</span><span class="child-title">${esc(ch.title)}</span>${ch.type==='task'?`<span class="child-phase">${esc(ch.phase)}</span>`:''}</div>`).join('');
-  return `<article class="card ${isIssue?'issue':'task'}${c.suspended?' suspended':''}" data-id="${esc(c.id)}">${sevBar}
-    <div class="card-head">${typeTag}${srcIcon}<h4 class="card-title">${esc(c.title)}</h4></div>
-    ${descBlock(c.description)}
-    ${labels?`<div class="card-labels">${labels}</div>`:''}
-    ${children?`<div class="card-children">${children}</div>`:''}
-    <div class="card-foot">${verdicts?`<div class="card-verdicts">${verdicts}</div>`:'<span></span>'}<div class="card-meta">${step}${suspTag}</div></div>
-    ${suspReason}
-  </article>`;
-}
-function renderBoard(){
-  const cards=dashboardState.workItemCards||[];
-  if(!cards.length)return `<section class="board"><div class="board-empty">暂无工作项数据（旧格式状态或未初始化）</div></section>`;
-  return `<section class="board">${COLUMNS.map(([key,label])=>{
-    const items=cards.filter(c=>c.phase===key);
-    return `<div class="col" data-col="${key}"><header class="col-head"><h3>${label}</h3><span class="col-count">${items.length}</span></header><div class="col-body">${items.map(renderCard).join('')}</div></div>`;
-  }).join('')}</section>`;
-}
-function render(){
-  document.getElementById('changeId').textContent=dashboardState.changeId||'-';
-  document.getElementById('baseBranch').textContent=dashboardState.baseBranch||'-';
-  document.getElementById('updatedAt').textContent=dashboardState.updatedAt?new Date(dashboardState.updatedAt).toLocaleString():'-';
-  document.getElementById('dashboard').innerHTML=renderBoard();
-  document.querySelectorAll('.desc-toggle').forEach(btn=>btn.addEventListener('click',e=>{
-    const d=e.target.previousElementSibling;
-    if(d&&d.classList.contains('card-desc')){d.classList.toggle('collapsed');e.target.textContent=d.classList.contains('collapsed')?'展开':'收起'}
-  }));
-  document.querySelectorAll('.suspend-tag').forEach(tag=>tag.addEventListener('click',e=>{
-    const card=e.target.closest('.card');
-    const reason=card&&card.querySelector('.suspend-reason');
-    if(reason)reason.hidden=!reason.hidden;
-  }));
-  if(modalState.id)refreshModal();
-}
-/* WorkItem 详情弹窗 */
-let modalState={id:null,back:[]};
-function findWorkItem(items,id){
-  for(const it of items||[]){
-    if(it.id===id)return it;
-    if(it.children&&it.children.length){
-      const found=findWorkItem(it.children,id);
-      if(found)return found;
-    }
-  }
-  return null;
-}
-function renderTags(tags){
-  const verdicts=Object.entries(tags||{}).map(([key,verdict])=>{
-    const sep=key.indexOf(':');
-    const stepId=sep===-1?key:key.slice(0,sep);
-    const agentKey=sep===-1?key:key.slice(sep+1);
-    return `<span class="detail-verdict ${cls(verdict)}" title="${esc(key)}">${esc(shortAgent(agentKey))}:${VERDICT_ICONS[verdict]||'○'}</span>`;
-  }).join('');
-  return verdicts?`<div class="detail-block"><h5>Agent 裁决</h5><div class="detail-verdicts">${verdicts}</div></div>`:'';
-}
-function renderWriteback(wb){
-  if(!wb)return '';
-  const rows=Object.entries(wb).filter(([k])=>!k.startsWith('_')).map(([k,v])=>{
-    const val=typeof v==='object'?JSON.stringify(v):String(v);
-    return `<div class="meta-row"><span class="meta-key">${esc(k)}</span><span class="meta-val">${esc(val)}</span></div>`;
-  }).join('');
-  return rows?`<div class="detail-block"><h5>写回</h5>${rows}</div>`:'';
-}
-function renderMeta(metadata){
-  const rows=Object.entries(metadata||{}).filter(([k])=>!k.startsWith('_')).map(([k,v])=>{
-    const val=typeof v==='object'?JSON.stringify(v):String(v);
-    return `<div class="meta-row"><span class="meta-key">${esc(k)}</span><span class="meta-val">${esc(val)}</span></div>`;
-  }).join('');
-  return rows?`<div class="detail-block"><h5>元数据</h5>${rows}</div>`:'';
-}
-function renderChildren(children){
-  if(!children||!children.length)return '';
-  const rows=(children||[]).map(ch=>`<div class="detail-child" data-id="${esc(ch.id)}" role="button" tabindex="0">
-    <span class="child-type ${cls(ch.type)}">${ch.type==='issue'?'I':'T'}</span>
-    <span class="child-title">${esc(ch.title)}</span>
-    <span class="child-phase">${esc(ch.phase)}</span>
-  </div>`).join('');
-  return `<div class="detail-block"><h5>Children</h5><div class="detail-children">${rows}</div></div>`;
-}
-function renderDetail(item){
-  const rows=[['类型',item.type],['来源',item.source],['ID',item.id]];
-  if(item.externalId)rows.push(['外部ID',item.externalId]);
-  rows.push(['阶段',item.phase]);
-  if(item.severity)rows.push(['严重级别',item.severity]);
-  rows.push(['当前步骤',item.currentStep||'-']);
-  const kv=rows.map(([k,v])=>`<div class="meta-row"><span class="meta-key">${esc(k)}</span><span class="meta-val">${esc(v)}</span></div>`).join('');
-  return `<h3 class="detail-title">${esc(item.title)}</h3>
-    ${item.suspended?`<div class="suspend-reason">⏸ 暂停：${esc(typeof (item.metadata||{})['suspend_reason']==='string'?(item.metadata||{})['suspend_reason']:'未提供暂停原因')}</div>`:''}
-    ${item.description?`<div class="detail-block"><h5>描述</h5><p class="detail-desc">${esc(item.description)}</p></div>`:''}
-    <div class="detail-block"><h5>字段</h5>${kv}</div>
-    ${item.labels&&item.labels.length?`<div class="detail-block"><h5>标签</h5><div class="card-labels">${item.labels.map(l=>`<span class="chip">${esc(l)}</span>`).join('')}</div></div>`:''}
-    ${renderTags(item.tags)}
-    ${renderWriteback(item.writeback)}
-    ${renderMeta(item.metadata)}
-    ${renderChildren(item.children)}`;
-}
-function refreshModal(){
-  const modal=document.getElementById('wiModal');
-  const item=findWorkItem(dashboardState.workItems||[],modalState.id);
-  if(!item){closeDetail();return;}
-  document.getElementById('wiBody').innerHTML=renderDetail(item);
-  document.getElementById('wiBack').hidden=!modalState.back.length;
-  modal.hidden=false;
-  document.body.classList.add('modal-open');
-}
-function openDetail(id,back){
-  modalState={id,back:back||[]};
-  refreshModal();
-}
-function closeDetail(){
-  modalState={id:null,back:[]};
-  const modal=document.getElementById('wiModal');
-  if(modal)modal.hidden=true;
-  document.body.classList.remove('modal-open');
-}
-document.addEventListener('click',e=>{
-  if(e.target.closest('.desc-toggle,.suspend-tag'))return;
-  const card=e.target.closest('.card');
-  if(card&&card.dataset.id)openDetail(card.dataset.id,[]);
-});
-document.getElementById('wiModal').addEventListener('click',e=>{
-  if(e.target.closest('#wiBack')){
-    const prev=modalState.back[modalState.back.length-1];
-    openDetail(prev,modalState.back.slice(0,-1));
-    return;
-  }
-  if(e.target.classList.contains('modal-overlay')){closeDetail();return;}
-  if(e.target.closest('.modal-close')){closeDetail();return;}
-  const child=e.target.closest('.detail-child');
-  if(child&&child.dataset.id)openDetail(child.dataset.id,[...modalState.back,modalState.id]);
-});
-document.addEventListener('keydown',e=>{
-  if(e.key==='Escape'){const modal=document.getElementById('wiModal');if(modal&&!modal.hidden)closeDetail();}
-});
-async function loadState(){try{const res=await fetch('/api/state');if(!res.ok)throw new Error('fetch failed');const data=await res.json();if(data&&data.active===true){dashboardState=data;render()}}catch(e){console.error('[dashboard] load state failed',e)}}
-render();
-loadState();
-setInterval(loadState,2000);
-</script>
-</body>
-</html>

package/src/adapters/opencode/dashboard.ts

@@ -1,64 +0,0 @@
-import { createServer } from "node:http"
-import type { Server } from "node:http"
-import { readDashboardState } from "../../core/dashboard.ts"
-import { getDashboardPage } from "../../dashboard/page.ts"
-
-const BASE_PORT = 4519
-const MAX_ATTEMPTS = 20
-
-const servers = new Map<string, Server>()
-
-export async function startDashboard(worktree: string): Promise<void> {
-  if (servers.has(worktree)) return
-
-  const pageHtml = getDashboardPage()
-
-  // 端口占用自动递增：EADDRINUSE 走 server error 事件（异步），经 once("error") + await listen
-  // 判定重试；其余启动期错误仅记录不中断。修复前 try/catch 同步捕获永不触发，换端口失效。
-  for (let port = BASE_PORT; port < BASE_PORT + MAX_ATTEMPTS; port++) {
-    try {
-      const server = createServer(async (req, res) => {
-        try {
-          const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "127.0.0.1"}`)
-          if (url.pathname === "/api/state") {
-            try {
-              const data = await readDashboardState(worktree)
-              res.writeHead(200, { "content-type": "application/json;charset=utf-8" })
-              res.end(JSON.stringify(data ?? { active: false }))
-            } catch (err) {
-              res.writeHead(500, { "content-type": "application/json;charset=utf-8" })
-              res.end(JSON.stringify({ active: false, error: String(err) }))
-            }
-            return
-          }
-          res.writeHead(200, { "content-type": "text/html;charset=utf-8" })
-          res.end(pageHtml)
-        } catch (err) {
-          console.error("[dashboard]", (err as Error).message)
-          res.writeHead(500, { "content-type": "text/plain;charset=utf-8" })
-          res.end("internal error")
-        }
-      })
-      await new Promise<void>((resolve, reject) => {
-        server.once("error", (err: NodeJS.ErrnoException) => {
-          if (err.code === "EADDRINUSE") {
-            reject(err)
-          } else {
-            console.error("[dashboard]", err.message)
-            resolve()
-          }
-        })
-        server.listen(port, "127.0.0.1", () => resolve())
-      })
-      servers.set(worktree, server)
-      console.log(`[dashboard] 编排进度看板 http://127.0.0.1:${port}`)
-      return
-    } catch {
-      continue
-    }
-  }
-
-  console.error(
-    `[dashboard] 无法启动编排进度看板：端口 ${BASE_PORT}-${BASE_PORT + MAX_ATTEMPTS - 1} 均被占用`
-  )
-}

package/src/core/dashboard.ts

@@ -1,101 +0,0 @@
-import type { OrchestrateState } from "./types.ts"
-import { readStateByWorktree, readStateByChangeId, getStateDir } from "./state.ts"
-import { readdirSync, existsSync } from "node:fs"
-import { readFile } from "node:fs/promises"
-import path from "path"
-import type { WorkItem, WorkItemType, WorkItemPhase, Verdict } from "./workflow/types.ts"
-
-/** 看板卡片投影：WorkItem → 前端可渲染结构。 */
-export interface WorkItemCard {
-  id: string
-  type: WorkItemType
-  title: string
-  description: string
-  phase: WorkItemPhase
-  suspended: boolean
-  suspendReason?: string
-  currentStep: string | null
-  labels: string[]
-  source: string
-  severity?: string
-  agentVerdicts: Array<{ stepId: string; agentKey: string; verdict: Verdict }>
-  children: Array<{ id: string; type: WorkItemType; title: string; phase: WorkItemPhase; severity?: string }>
-}
-
-/** taskGroup → 看板投影（旧三面板视图已随单轨化移除）。 */
-
-/**
- * WorkItem → 看板卡片。
- * tags 键为 `${stepId}:${agentKey}`，拆解为可渲染的 agent 裁决数组；
- * metadata 仅暴露无下划线前缀的业务字段（suspend_reason），内部字段（_ 前缀）不泄露。
- */
-function toWorkItemCard(item: WorkItem): WorkItemCard {
-  const agentVerdicts = Object.entries(item.tags).map(([key, verdict]) => {
-    const sep = key.indexOf(":")
-    return {
-      stepId: sep === -1 ? key : key.slice(0, sep),
-      agentKey: sep === -1 ? key : key.slice(sep + 1),
-      verdict,
-    }
-  })
-  const suspendReason =
-    typeof item.metadata["suspend_reason"] === "string" ? (item.metadata["suspend_reason"] as string) : undefined
-  return {
-    id: item.id,
-    type: item.type,
-    title: item.title,
-    description: item.description,
-    phase: item.phase,
-    suspended: item.suspended,
-    suspendReason,
-    currentStep: item.currentStep,
-    labels: item.labels,
-    source: item.source,
-    severity: item.severity,
-    agentVerdicts,
-    children: item.children.map((child) => ({
-      id: child.id,
-      type: child.type,
-      title: child.title,
-      phase: child.phase,
-      severity: child.severity,
-    })),
-  }
-}
-
-/** OrchestrateState → 看板投影（workItems 单轨 + workItemCards 5 列视图）。 */
-function projectState(state: OrchestrateState) {
-  return {
-    active: true,
-    changeId: state.changeId,
-    currentTaskGroupId: state.taskGroupId,
-    baseBranch: state.baseBranch,
-    createdAt: state.createdAt,
-    updatedAt: state.updatedAt,
-    workItems: state.workItems,
-    workItemCards: state.workItems.map(toWorkItemCard),
-  }
-}
-
-export async function readDashboardState(worktree: string, changeId?: string) {
-  if (changeId) {
-    const state = await readStateByWorktree(worktree, changeId)
-    if (!state) return null
-    return projectState(state)
-  }
-
-  const stateDir = getStateDir(worktree)
-  if (!existsSync(stateDir)) return null
-  const files = readdirSync(stateDir).filter(f => f.endsWith(".json"))
-  const results: ReturnType<typeof projectState>[] = []
-  for (const f of files) {
-    try {
-      const raw = await readFile(path.join(stateDir, f), "utf-8")
-      const state = JSON.parse(raw) as OrchestrateState
-      if (!state.changeId) continue
-      results.push(projectState(state))
-    } catch { /* skip unreadable */ }
-  }
-  if (results.length === 1) return results[0]
-  return results.length > 0 ? results : null
-}

package/src/dashboard/page.ts

@@ -1,19 +0,0 @@
-import { fileURLToPath } from "node:url"
-import { readFileSync, existsSync } from "node:fs"
-import { join } from "node:path"
-
-let _html: string | null = null
-
-/** 页面资源定位：bundle 形态（ZCode 插件包）资源随 bundle 同目录放置；源码/包形态位于 ../../assets/dashboard/。 */
-function resolveDashboardHtml(): string {
-  const __dirname = fileURLToPath(new URL(".", import.meta.url))
-  const bundled = join(__dirname, "dashboard", "index.html")
-  if (existsSync(bundled)) return bundled
-  return join(__dirname, "../../assets/dashboard/index.html")
-}
-
-export function getDashboardPage(): string {
-  if (_html) return _html
-  _html = readFileSync(resolveDashboardHtml(), "utf-8")
-  return _html
-}