zdashboard 2.1.0 → 2.1.1

package/dist/cli.js

@@ -2,13 +2,137 @@
 
 // src/cli.ts
 import path10 from "path";
+import fs11 from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { access, readdir } from "fs/promises";
 
 // src/server/detect.ts
+import fs2 from "fs";
+import path2 from "path";
+import { execFile } from "child_process";
+
+// src/server/bugs.ts
 import fs from "fs";
 import path from "path";
-import { execFile } from "child_process";
+
+// src/server/api/fetch.ts
+import ky from "ky";
+
+// src/server/errors.ts
+var HttpError = class extends Error {
+  constructor(status, message, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "HttpError";
+  }
+  status;
+  body;
+};
+var NetworkError = class extends Error {
+  constructor(message, cause) {
+    super(message);
+    this.cause = cause;
+    this.name = "NetworkError";
+  }
+  cause;
+};
+
+// src/server/api/fetch.ts
+async function fetchJson(url, init) {
+  try {
+    const res = await ky(url, { ...init, timeout: 8e3, retry: 2 });
+    return await res.json();
+  } catch (e) {
+    if (e instanceof HttpError) throw e;
+    if (e instanceof Error && e.name === "TimeoutError") {
+      throw new NetworkError(`\u8BF7\u6C42\u8D85\u65F6: ${url}`);
+    }
+    if (e instanceof Error && e.name === "HTTPError") {
+      throw new HttpError(e.status ?? 500, e.message);
+    }
+    throw new NetworkError(`\u8BF7\u6C42\u5931\u8D25: ${url}`, e);
+  }
+}
+
+// src/server/bugs.ts
+var BUGS_CONFIG_CANDIDATES = [".zdev/config.yaml", ".zgoal/config.yaml"];
+function loadConfig(root) {
+  for (const rel of BUGS_CONFIG_CANDIDATES) {
+    const file = path.join(root, rel);
+    if (!fs.existsSync(file)) continue;
+    const kv = {};
+    for (const line of fs.readFileSync(file, "utf8").split("\n")) {
+      const m = line.match(/^\s*([A-Za-z_]\w*)\s*:\s*(.+?)\s*$/);
+      if (m && !m[2].startsWith("#")) kv[m[1]] = m[2].replace(/^["']|["']$/g, "");
+    }
+    const product = Number(kv.product);
+    if (!kv.url || !product) return null;
+    return {
+      url: kv.url.replace(/\/+$/, ""),
+      account: kv.account ?? "",
+      password: kv.password,
+      token: kv.token,
+      product
+    };
+  }
+  return null;
+}
+var tokenCache = null;
+async function getToken(cfg) {
+  if (cfg.token) return cfg.token;
+  const key = `${cfg.url}|${cfg.account}|${cfg.password ?? ""}`;
+  if (tokenCache && tokenCache.key === key && Date.now() - tokenCache.at < 10 * 6e4) return tokenCache.token;
+  const json = await fetchJson(`${cfg.url}/api.php/v1/tokens`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ account: cfg.account, password: cfg.password })
+  });
+  const token = typeof json.token === "string" ? json.token : "";
+  if (!token) throw new Error("token \u83B7\u53D6\u5931\u8D25:\u68C0\u67E5 account / password");
+  tokenCache = { key, token, at: Date.now() };
+  return token;
+}
+function normBug(b, account) {
+  const assigned = b.assignedTo;
+  const assignedTo = typeof assigned === "string" ? assigned : assigned && typeof assigned === "object" && "realname" in assigned ? String(assigned.realname ?? "") : "";
+  const assignedAccount = typeof assigned === "string" ? assigned : assigned && typeof assigned === "object" ? String(assigned.account ?? "") : "";
+  const mine = !!account && (assignedAccount === account || assignedTo === account);
+  return {
+    id: Number(b.id),
+    title: String(b.title ?? ""),
+    severity: b.severity ?? 4,
+    pri: b.pri ?? 3,
+    status: String(b.status ?? ""),
+    assignedTo,
+    openedBy: typeof b.openedBy === "string" ? b.openedBy : void 0,
+    mine
+  };
+}
+async function fetchBugs(root) {
+  const cfg = loadConfig(root);
+  if (!cfg) {
+    const anyExists = BUGS_CONFIG_CANDIDATES.some((rel) => fs.existsSync(path.join(root, rel)));
+    return {
+      ok: false,
+      error: anyExists ? "\u914D\u7F6E\u5B58\u5728\u4F46\u65E0\u6548(\u7F3A url \u6216 product \u5B57\u6BB5)\u2014\u2014\u68C0\u67E5 .zdev/config.yaml" : ".zdev/config.yaml \u7F3A\u5931(\u7531 zgoal skill \u521B\u5EFA;\u5B58\u91CF .zgoal/config.yaml \u4EA6\u53EF)"
+    };
+  }
+  try {
+    const token = await getToken(cfg);
+    const json = await fetchJson(
+      `${cfg.url}/api.php/v1/products/${cfg.product}/bugs?page=1&limit=100`,
+      { headers: { Token: token } }
+    );
+    const raw = Array.isArray(json.bugs) ? json.bugs : [];
+    return { ok: true, url: cfg.url, total: Number(json.total ?? raw.length), bugs: raw.map((b) => normBug(b, cfg.account)) };
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return { ok: false, error: `\u7985\u9053\u8BF7\u6C42\u5931\u8D25(${msg})\u2014\u2014\u68C0\u67E5 url / \u51ED\u636E / \u662F\u5426\u5F00\u542F RESTful API v1` };
+  }
+}
+
+// src/server/detect.ts
 function justAvailable(cwd) {
   return new Promise((resolve) => {
     const child = execFile("just", ["--list", "--unsorted"], { cwd, timeout: 5e3 }, (err) => {
@@ -18,10 +142,10 @@ function justAvailable(cwd) {
   });
 }
 async function detect(root) {
-  const hasOpenspec = fs.existsSync(path.join(root, "openspec"));
-  const hasDocs = fs.existsSync(path.join(root, "docs"));
+  const hasOpenspec = fs2.existsSync(path2.join(root, "openspec"));
+  const hasDocs = fs2.existsSync(path2.join(root, "docs"));
   const hasJust = await justAvailable(root);
-  const hasBugs = fs.existsSync(path.join(root, ".zgoal", "config.yaml"));
+  const hasBugs = BUGS_CONFIG_CANDIDATES.some((rel) => fs2.existsSync(path2.join(root, rel)));
   return { hasOpenspec, hasDocs, hasJust, hasBugs };
 }
 
@@ -30,15 +154,15 @@ import { Context } from "cordis";
 
 // src/core/server.ts
 import http from "http";
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 import crypto from "crypto";
 import { fileURLToPath } from "url";
 
 // package.json
 var package_default = {
   name: "zdashboard",
-  version: "2.1.0",
+  version: "2.1.1",
   description: "ZCode skill dashboard platform \u2014 pluggable viewers for zdesign/zview/zreview/zgoal",
   type: "module",
   bin: {
@@ -124,20 +248,20 @@ var package_default = {
 import { Service } from "cordis";
 
 // src/core/instance.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path3 from "path";
 var RECORD_FILE = ".zdev/dashboard.json";
 var VERIFY_TIMEOUT_MS = 1500;
 var STOP_POLL_MS = 2e3;
 var STOP_POLL_INTERVAL_MS = 100;
 var STOP_FINAL_WAIT_MS = 100;
 function recordPath(root) {
-  return path2.join(root, RECORD_FILE);
+  return path3.join(root, RECORD_FILE);
 }
 function readRecord(root) {
   try {
     const fp = recordPath(root);
-    const raw = fs2.readFileSync(fp, "utf-8");
+    const raw = fs3.readFileSync(fp, "utf-8");
     const rec = JSON.parse(raw);
     if (typeof rec.pid === "number" && typeof rec.port === "number" && typeof rec.root === "string" && typeof rec.startedAt === "string") {
       return rec;
@@ -148,20 +272,20 @@ function readRecord(root) {
   }
 }
 function writeRecord(root, port) {
-  fs2.mkdirSync(path2.dirname(recordPath(root)), { recursive: true });
+  fs3.mkdirSync(path3.dirname(recordPath(root)), { recursive: true });
   const rec = {
     pid: process.pid,
     port,
     root,
     startedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  fs2.writeFileSync(recordPath(root), JSON.stringify(rec, null, 2) + "\n");
+  fs3.writeFileSync(recordPath(root), JSON.stringify(rec, null, 2) + "\n");
 }
 function clearRecord(root) {
   try {
     const rec = readRecord(root);
     if (rec && rec.pid !== process.pid) return;
-    fs2.unlinkSync(recordPath(root));
+    fs3.unlinkSync(recordPath(root));
   } catch {
   }
 }
@@ -221,14 +345,14 @@ async function stopInstance(record) {
 
 // src/core/open-url.ts
 import { exec } from "child_process";
-function openUrl2(url) {
+function openUrl(url) {
   const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
   exec(`${cmd} ${url}`);
 }
 
 // src/core/server.ts
 var VERSION = package_default.version;
-var __dirname = path3.dirname(fileURLToPath(import.meta.url));
+var __dirname = path4.dirname(fileURLToPath(import.meta.url));
 var MIME = {
   ".html": "text/html; charset=utf-8",
   ".htm": "text/html; charset=utf-8",
@@ -286,6 +410,7 @@ var ServerService = class extends Service {
   open;
   page;
   det;
+  dataDir;
   routes = /* @__PURE__ */ new Map();
   sses = /* @__PURE__ */ new Map();
   prefixStatic = /* @__PURE__ */ new Map();
@@ -299,6 +424,7 @@ var ServerService = class extends Service {
     this.open = config.open;
     this.page = config.page;
     this.det = config.detect;
+    this.dataDir = config.dataDir;
     this.onListen = config.onListen;
     ctx.effect(() => () => this.dispose());
     this.route("/__config", (_req, res) => {
@@ -330,12 +456,12 @@ var ServerService = class extends Service {
     this.ctx.effect(() => () => this.prefixStatic.delete(prefix));
   }
   serveFile(filePath, res, injectHtml) {
-    fs3.readFile(filePath, (err, data) => {
+    fs4.readFile(filePath, (err, data) => {
       if (err) {
         res.writeHead(404);
         return res.end("Not found");
       }
-      const ext = path3.extname(filePath).toLowerCase();
+      const ext = path4.extname(filePath).toLowerCase();
       const ct = MIME[ext] ?? "application/octet-stream";
       let body = data;
       if (injectHtml && ext === ".html") {
@@ -350,9 +476,9 @@ var ServerService = class extends Service {
     for (const [prefix, dir] of this.prefixStatic) {
       if (url.indexOf(prefix) === 0) {
         let rel = this.safeDecode(url.slice(prefix.length));
-        if (!rel || rel === "/" || !path3.extname(rel)) rel = path3.join(rel || "", "index.html");
-        const fp = path3.join(dir, rel);
-        if (fp.indexOf(dir + path3.sep) !== 0) {
+        if (!rel || rel === "/" || !path4.extname(rel)) rel = path4.join(rel || "", "index.html");
+        const fp = path4.join(dir, rel);
+        if (fp.indexOf(dir + path4.sep) !== 0) {
           res.writeHead(403);
           return res.end("Forbidden");
         }
@@ -391,17 +517,17 @@ var ServerService = class extends Service {
       if (this.servePrefix(url, res)) return;
       if (url === "/" || url.indexOf("/__app/") === 0 || url.indexOf("/assets/") === 0) {
         let fp2 = this.appDir;
-        if (url !== "/") fp2 = path3.join(this.appDir, this.safeDecode(url));
-        if (url.indexOf("/__app/") === 0) fp2 = path3.join(this.appDir, url.slice(7));
-        if (fp2 !== this.appDir && fp2.indexOf(this.appDir + path3.sep) !== 0) {
+        if (url !== "/") fp2 = path4.join(this.appDir, this.safeDecode(url));
+        if (url.indexOf("/__app/") === 0) fp2 = path4.join(this.appDir, url.slice(7));
+        if (fp2 !== this.appDir && fp2.indexOf(this.appDir + path4.sep) !== 0) {
           res.writeHead(403);
           return res.end("Forbidden");
         }
-        if (url === "/") fp2 = path3.join(this.appDir, "index.html");
+        if (url === "/") fp2 = path4.join(this.appDir, "index.html");
         return this.serveFile(fp2, res, false);
       }
-      const fp = path3.join(this.root, this.safeDecode(url));
-      if (fp !== this.root && fp.indexOf(this.root + path3.sep) !== 0) {
+      const fp = path4.join(this.root, this.safeDecode(url));
+      if (fp !== this.root && fp.indexOf(this.root + path4.sep) !== 0) {
         res.writeHead(403);
         return res.end("Forbidden");
       }
@@ -417,6 +543,8 @@ var ServerService = class extends Service {
   };
   start(port) {
     this.server = http.createServer(this.handler);
+    this.server.keepAliveTimeout = 65e3;
+    this.server.headersTimeout = 66e3;
     this.server.on("error", (err) => {
       if (err.code === "EADDRINUSE") {
         console.log(`[zdashboard] port ${port} busy, trying ${port + 1}`);
@@ -429,7 +557,8 @@ var ServerService = class extends Service {
       console.log(`[zdashboard] v${VERSION} dashboard -> ${u}`);
       console.log(`[zdashboard] project   -> ${this.root}`);
       console.log(`[zdashboard] detect    -> openspec:${this.det.hasOpenspec} docs:${this.det.hasDocs} just:${this.det.hasJust} bugs:${this.det.hasBugs}`);
-      if (this.open) openUrl2(target);
+      if (this.dataDir) console.log(`[zdashboard] data      -> ${this.dataDir}`);
+      if (this.open) openUrl(target);
       this.onListen?.(port);
     });
   }
@@ -467,7 +596,7 @@ var ServerService = class extends Service {
 };
 
 // src/core/reload.ts
-import fs4 from "fs";
+import fs5 from "fs";
 import { Service as Service2 } from "cordis";
 var WATCH_DEBOUNCE_MS = 150;
 var ReloadService = class extends Service2 {
@@ -483,7 +612,7 @@ var ReloadService = class extends Service2 {
       return () => this.clients.delete(res);
     });
     try {
-      this.watcher = fs4.watch(config.root, { recursive: true }, () => {
+      this.watcher = fs5.watch(config.root, { recursive: true }, () => {
         if (this.timer) clearTimeout(this.timer);
         this.timer = setTimeout(() => {
           this.broadcast("reload");
@@ -526,13 +655,13 @@ data: ${JSON.stringify(data == null ? "" : data)}
 };
 
 // src/server/spec-scan.ts
-import fs5 from "fs";
-import path4 from "path";
+import fs6 from "fs";
+import path5 from "path";
 function walkFiles(absDir, relDir, depth = 0) {
   if (depth > 4) return [];
   let ents;
   try {
-    ents = fs5.readdirSync(absDir, { withFileTypes: true });
+    ents = fs6.readdirSync(absDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -541,7 +670,7 @@ function walkFiles(absDir, relDir, depth = 0) {
     if (ent.name.startsWith(".") || ent.name === "node_modules") continue;
     const rel = relDir ? `${relDir}/${ent.name}` : ent.name;
     if (ent.isDirectory()) {
-      nodes.push({ name: ent.name, kind: "dir", children: walkFiles(path4.join(absDir, ent.name), rel, depth + 1) });
+      nodes.push({ name: ent.name, kind: "dir", children: walkFiles(path5.join(absDir, ent.name), rel, depth + 1) });
     } else {
       nodes.push({ name: ent.name, kind: "file", path: rel });
     }
@@ -551,41 +680,41 @@ function walkFiles(absDir, relDir, depth = 0) {
 }
 function scanTree(root, hasOpenspec, hasDocs) {
   const tree = [];
-  if (hasOpenspec && fs5.existsSync(path4.join(root, "openspec", "changes"))) {
-    const changesDir = path4.join(root, "openspec", "changes");
+  if (hasOpenspec && fs6.existsSync(path5.join(root, "openspec", "changes"))) {
+    const changesDir = path5.join(root, "openspec", "changes");
     const active = [];
     const archived = [];
-    for (const ent of fs5.readdirSync(changesDir, { withFileTypes: true })) {
+    for (const ent of fs6.readdirSync(changesDir, { withFileTypes: true })) {
       if (!ent.isDirectory() || ent.name.startsWith(".") || ent.name === "archive") continue;
-      active.push({ name: ent.name, kind: "dir", children: walkFiles(path4.join(changesDir, ent.name), `openspec/changes/${ent.name}`) });
+      active.push({ name: ent.name, kind: "dir", children: walkFiles(path5.join(changesDir, ent.name), `openspec/changes/${ent.name}`) });
     }
     active.sort((a, b) => a.name.localeCompare(b.name));
-    const archiveDir = path4.join(changesDir, "archive");
-    if (fs5.existsSync(archiveDir)) {
-      for (const ent of fs5.readdirSync(archiveDir, { withFileTypes: true })) {
+    const archiveDir = path5.join(changesDir, "archive");
+    if (fs6.existsSync(archiveDir)) {
+      for (const ent of fs6.readdirSync(archiveDir, { withFileTypes: true })) {
         if (!ent.isDirectory() || ent.name.startsWith(".")) continue;
-        archived.push({ name: ent.name, kind: "dir", children: walkFiles(path4.join(archiveDir, ent.name), `openspec/changes/archive/${ent.name}`) });
+        archived.push({ name: ent.name, kind: "dir", children: walkFiles(path5.join(archiveDir, ent.name), `openspec/changes/archive/${ent.name}`) });
       }
       archived.sort((a, b) => b.name.localeCompare(a.name));
     }
     if (active.length) tree.push({ name: `\u8FDB\u884C\u4E2D (${active.length})`, kind: "dir", children: active });
     if (archived.length) tree.push({ name: "archive", kind: "dir", defaultCollapsed: true, children: archived });
-    const specsDir = path4.join(root, "openspec", "specs");
-    if (fs5.existsSync(specsDir)) {
+    const specsDir = path5.join(root, "openspec", "specs");
+    if (fs6.existsSync(specsDir)) {
       const specs = walkFiles(specsDir, "openspec/specs");
       if (specs.length) tree.push({ name: "specs", kind: "dir", children: specs });
     }
   }
-  if (hasDocs && fs5.existsSync(path4.join(root, "docs"))) {
-    const docs = walkFiles(path4.join(root, "docs"), "docs");
+  if (hasDocs && fs6.existsSync(path5.join(root, "docs"))) {
+    const docs = walkFiles(path5.join(root, "docs"), "docs");
     if (docs.length) tree.push({ name: "docs", kind: "dir", children: docs });
   }
   const skip = /* @__PURE__ */ new Set(["openspec", "docs", "node_modules", ".git", "dist", "test-server"]);
   const etc = [];
   try {
-    for (const ent of fs5.readdirSync(root, { withFileTypes: true })) {
+    for (const ent of fs6.readdirSync(root, { withFileTypes: true })) {
       if (ent.name.startsWith(".") || skip.has(ent.name)) continue;
-      const ext = path4.extname(ent.name).toLowerCase();
+      const ext = path5.extname(ent.name).toLowerCase();
       if (ent.isFile() && (ext === ".md" || ext === ".markdown")) etc.push({ name: ent.name, kind: "file", path: ent.name });
     }
   } catch (e) {
@@ -655,13 +784,7 @@ import { spawn, execFile as execFile2 } from "child_process";
 var MAX_BUFFER = 1e3;
 var JustRunner = class {
   cwd;
-  child = null;
-  recipe = null;
-  state = "idle";
-  code = null;
-  buffer = [];
-  pending = "";
-  // 行缓冲:块缓冲输出(如 maven)的 chunk 会在行中间断开,攒到 \n 才切行
+  tasks = /* @__PURE__ */ new Map();
   clients = /* @__PURE__ */ new Set();
   recipesCache = null;
   constructor(cwd) {
@@ -695,26 +818,25 @@ var JustRunner = class {
   }
   subscribe(fn) {
     this.clients.add(fn);
-    for (const text of this.buffer) fn({ type: "log", text });
-    fn({ type: "state", state: this.state, recipe: this.recipe, code: this.code });
+    for (const t of this.tasks.values()) {
+      for (const text of t.buffer) fn({ type: "log", recipe: t.recipe, text });
+      fn({ type: "state", recipe: t.recipe, state: t.state, code: t.code, startedAt: t.startedAt });
+    }
     return () => this.clients.delete(fn);
   }
   emit(ev) {
     for (const fn of this.clients) fn(ev);
   }
-  info() {
-    return { state: this.state, recipe: this.recipe, code: this.code };
+  list() {
+    return Array.from(this.tasks.values(), (t) => ({ recipe: t.recipe, state: t.state, code: t.code, startedAt: t.startedAt }));
   }
-  /** 启动 recipe(调用方须先用 recipes() 校验名字);自动停旧进程 */
+  /** 启动 recipe:同名先停旧进程(重启语义),不影响其他任务;调用方须先用 recipes() 校验名字 */
   start(recipe) {
-    this.killChild();
-    this.recipe = recipe;
-    this.code = null;
-    this.state = "running";
-    this.buffer = [];
-    this.pending = "";
-    this.emit({ type: "clear" });
-    this.emit({ type: "state", state: "running", recipe, code: null });
+    this.killOne(recipe);
+    const task = { recipe, child: null, state: "running", code: null, startedAt: Date.now(), buffer: [], pending: "" };
+    this.tasks.set(recipe, task);
+    this.emit({ type: "clear", recipe });
+    this.emit({ type: "state", recipe, state: "running", code: null, startedAt: task.startedAt });
     const child = spawn("just", [recipe], {
       cwd: this.cwd,
       shell: true,
@@ -727,47 +849,62 @@ var JustRunner = class {
         CI: ""
       }
     });
-    this.child = child;
+    task.child = child;
+    const isStale = () => this.tasks.get(recipe) !== task;
     const push = (d) => {
-      this.pending += d.toString();
+      if (isStale()) return;
+      task.pending += d.toString();
       let idx;
-      while ((idx = this.pending.indexOf("\n")) >= 0) {
-        const line = this.pending.slice(0, idx + 1);
-        this.pending = this.pending.slice(idx + 1);
-        this.pushLine(line);
+      while ((idx = task.pending.indexOf("\n")) >= 0) {
+        const line = task.pending.slice(0, idx + 1);
+        task.pending = task.pending.slice(idx + 1);
+        this.pushLine(task, line);
       }
     };
     child.stdout?.on("data", push);
     child.stderr?.on("data", push);
     child.on("error", (err) => {
-      this.pushLine(`[zdashboard] spawn error: ${err.message}
+      this.pushLine(task, `[zdashboard] spawn error: ${err.message}
 `);
     });
-    child.on("exit", (code) => {
-      if (this.pending) {
-        this.pushLine(this.pending + "\n");
-        this.pending = "";
+    child.on("exit", (code, signal) => {
+      if (task.pending && !isStale()) {
+        this.pushLine(task, task.pending + "\n");
       }
-      this.child = null;
-      this.state = "exited";
-      this.code = code ?? 0;
-      this.emit({ type: "state", state: "exited", recipe: this.recipe, code: this.code });
+      task.pending = "";
+      task.child = null;
+      task.state = "exited";
+      task.code = code ?? 0;
+      task.signal = signal ?? void 0;
+      if (isStale()) return;
+      this.emit({ type: "state", recipe, state: "exited", code: task.code, startedAt: task.startedAt, signal: task.signal });
     });
   }
-  pushLine(line) {
-    this.buffer.push(line);
-    if (this.buffer.length > MAX_BUFFER) this.buffer.shift();
-    this.emit({ type: "log", text: line });
+  pushLine(task, line) {
+    task.buffer.push(line);
+    if (task.buffer.length > MAX_BUFFER) task.buffer.shift();
+    this.emit({ type: "log", recipe: task.recipe, text: line });
   }
-  stop() {
-    this.killChild();
+  /** 停单个任务;不传 recipe 停全部 */
+  stop(recipe) {
+    if (recipe === void 0) {
+      for (const t of this.tasks.values()) this.killOne(t.recipe);
+    } else this.killOne(recipe);
   }
   restart(recipe) {
-    const target = recipe ?? this.recipe;
-    if (target) this.start(target);
-  }
-  killChild() {
-    const child = this.child;
+    if (this.tasks.has(recipe)) this.start(recipe);
+  }
+  /** 清空某任务的日志缓冲并广播(真源清除,重连重放不会复活) */
+  clear(recipe) {
+    const task = this.tasks.get(recipe);
+    if (!task) return;
+    task.buffer = [];
+    task.pending = "";
+    this.emit({ type: "clear", recipe });
+  }
+  killOne(recipe) {
+    const task = this.tasks.get(recipe);
+    const child = task?.child;
     if (child?.pid) {
       try {
         if (process.platform === "win32") spawn("taskkill", ["/PID", String(child.pid), "/T", "/F"]);
@@ -775,7 +912,9 @@ var JustRunner = class {
       } catch {
       }
     }
-    this.child = null;
+    if (task) {
+      task.child = null;
+    }
   }
 };
 
@@ -788,6 +927,7 @@ var apply2 = {
       if (!ctx.server?.route) return;
       const runner = new JustRunner(root);
       ctx.effect(() => () => runner.stop());
+      ctx.dashboard.register({ mode: "just", label: "Just Runner", icon: "\u{1F4DC}", description: "Just \u591A\u4EFB\u52A1\u5E76\u53D1\u6267\u884C\u4E0E\u65E5\u5FD7" });
       ctx.server.route("/__just/recipes", async (_req, res) => {
         res.writeHead(200, { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-cache" });
         try {
@@ -805,7 +945,7 @@ var apply2 = {
         });
         return unsub;
       });
-      ctx.server.route("/__just/start", async (req, res) => {
+      const handleAction = async (req, res, act) => {
         if (req.headers["x-stop-token"] !== ctx.server.stopToken) {
           res.writeHead(403);
           res.end("forbidden");
@@ -817,61 +957,45 @@ var apply2 = {
           recipe = JSON.parse(body || "{}").recipe;
         } catch {
         }
-        const target = recipe ?? runner.info().recipe;
-        if (!target) {
-          res.writeHead(400);
-          res.end('{"error":"no recipe"}');
-          return;
-        }
-        const recipes = await runner.recipes();
-        if (!recipes.some((r) => r.name === target)) {
-          res.writeHead(403);
-          res.end('{"error":"unknown recipe"}');
-          return;
-        }
-        runner.start(target);
-        res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
-        res.end(JSON.stringify(runner.info()));
-      });
-      ctx.server.route("/__just/stop", async (req, res) => {
-        if (req.headers["x-stop-token"] !== ctx.server.stopToken) {
-          res.writeHead(403);
-          res.end("forbidden");
-          return;
-        }
-        runner.stop();
-        res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
-        res.end(JSON.stringify(runner.info()));
-      });
-      ctx.server.route("/__just/restart", async (req, res) => {
-        if (req.headers["x-stop-token"] !== ctx.server.stopToken) {
-          res.writeHead(403);
-          res.end("forbidden");
+        if (act === "clear") {
+          if (recipe) runner.clear(recipe);
+          res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+          res.end('{"ok":true}');
           return;
         }
-        const body = await readBody(req);
-        let recipe;
-        try {
-          recipe = JSON.parse(body || "{}").recipe;
-        } catch {
-        }
-        const target = recipe ?? runner.info().recipe;
-        if (!target) {
-          res.writeHead(400);
-          res.end('{"error":"no recipe"}');
-          return;
-        }
-        const recipes = await runner.recipes();
-        if (!recipes.some((r) => r.name === target)) {
-          res.writeHead(403);
-          res.end('{"error":"unknown recipe"}');
-          return;
+        if (act !== "stop") {
+          if (!recipe) {
+            res.writeHead(400);
+            res.end('{"error":"no recipe"}');
+            return;
+          }
+          const recipes = await runner.recipes();
+          if (!recipes.some((r) => r.name === recipe)) {
+            res.writeHead(403);
+            res.end('{"error":"unknown recipe"}');
+            return;
+          }
+          runner.start(recipe);
+        } else {
+          runner.stop(recipe || void 0);
         }
-        runner.restart(target);
         res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
-        res.end(JSON.stringify(runner.info()));
-      });
-      ctx.dashboard.register({ mode: "just", label: "Just Runner", icon: "\u{1F4DC}", description: "Just \u4EFB\u52A1\u65E5\u5FD7\u4E0E\u6267\u884C" });
+        res.end(JSON.stringify(runner.list()));
+      };
+      const routeAction = (name) => {
+        ctx.server.route(`/__just/${name}`, (req, res) => {
+          handleAction(req, res, name).catch(() => {
+            if (!res.headersSent) {
+              res.writeHead(500);
+              res.end('{"error":"internal"}');
+            }
+          });
+        });
+      };
+      routeAction("start");
+      routeAction("stop");
+      routeAction("restart");
+      routeAction("clear");
     });
   }
 };
@@ -882,120 +1006,10 @@ async function readBody(req) {
       data += c;
     });
     req.on("end", () => resolve(data));
+    req.on("error", () => resolve(""));
   });
 }
 
-// src/server/bugs.ts
-import fs6 from "fs";
-import path5 from "path";
-
-// src/server/api/fetch.ts
-import ky from "ky";
-
-// src/server/errors.ts
-var HttpError = class extends Error {
-  constructor(status, message, body) {
-    super(message);
-    this.status = status;
-    this.body = body;
-    this.name = "HttpError";
-  }
-  status;
-  body;
-};
-var NetworkError = class extends Error {
-  constructor(message, cause) {
-    super(message);
-    this.cause = cause;
-    this.name = "NetworkError";
-  }
-  cause;
-};
-
-// src/server/api/fetch.ts
-async function fetchJson(url, init) {
-  try {
-    const res = await ky(url, { ...init, timeout: 8e3, retry: 2 });
-    return await res.json();
-  } catch (e) {
-    if (e instanceof HttpError) throw e;
-    if (e instanceof Error && e.name === "TimeoutError") {
-      throw new NetworkError(`\u8BF7\u6C42\u8D85\u65F6: ${url}`);
-    }
-    if (e instanceof Error && e.name === "HTTPError") {
-      throw new HttpError(e.status ?? 500, e.message);
-    }
-    throw new NetworkError(`\u8BF7\u6C42\u5931\u8D25: ${url}`, e);
-  }
-}
-
-// src/server/bugs.ts
-function loadZgoalConfig(root) {
-  const file = path5.join(root, ".zgoal", "config.yaml");
-  if (!fs6.existsSync(file)) return null;
-  const kv = {};
-  for (const line of fs6.readFileSync(file, "utf8").split("\n")) {
-    const m = line.match(/^\s*([A-Za-z_]\w*)\s*:\s*(.+?)\s*$/);
-    if (m && !m[2].startsWith("#")) kv[m[1]] = m[2].replace(/^["']|["']$/g, "");
-  }
-  const product = Number(kv.product);
-  if (!kv.url || !product) return null;
-  return {
-    url: kv.url.replace(/\/+$/, ""),
-    account: kv.account ?? "",
-    password: kv.password,
-    token: kv.token,
-    product
-  };
-}
-var tokenCache = null;
-async function getToken(cfg) {
-  if (cfg.token) return cfg.token;
-  const key = `${cfg.url}|${cfg.account}|${cfg.password ?? ""}`;
-  if (tokenCache && tokenCache.key === key && Date.now() - tokenCache.at < 10 * 6e4) return tokenCache.token;
-  const json = await fetchJson(`${cfg.url}/api.php/v1/tokens`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ account: cfg.account, password: cfg.password })
-  });
-  const token = typeof json.token === "string" ? json.token : "";
-  if (!token) throw new Error("token \u83B7\u53D6\u5931\u8D25:\u68C0\u67E5 account / password");
-  tokenCache = { key, token, at: Date.now() };
-  return token;
-}
-function normBug(b, account) {
-  const assigned = b.assignedTo;
-  const assignedTo = typeof assigned === "string" ? assigned : assigned && typeof assigned === "object" && "realname" in assigned ? String(assigned.realname ?? "") : "";
-  const assignedAccount = typeof assigned === "string" ? assigned : assigned && typeof assigned === "object" ? String(assigned.account ?? "") : "";
-  const mine = !!account && (assignedAccount === account || assignedTo === account);
-  return {
-    id: Number(b.id),
-    title: String(b.title ?? ""),
-    severity: b.severity ?? 4,
-    pri: b.pri ?? 3,
-    status: String(b.status ?? ""),
-    assignedTo,
-    openedBy: typeof b.openedBy === "string" ? b.openedBy : void 0,
-    mine
-  };
-}
-async function fetchBugs(root) {
-  const cfg = loadZgoalConfig(root);
-  if (!cfg) return { ok: false, error: ".zgoal/config.yaml \u7F3A\u5931\u6216 url/product \u672A\u914D\u7F6E(\u7531 zgoal skill \u521B\u5EFA)" };
-  try {
-    const token = await getToken(cfg);
-    const json = await fetchJson(
-      `${cfg.url}/api.php/v1/products/${cfg.product}/bugs?page=1&limit=100`,
-      { headers: { Token: token } }
-    );
-    const raw = Array.isArray(json.bugs) ? json.bugs : [];
-    return { ok: true, url: cfg.url, total: Number(json.total ?? raw.length), bugs: raw.map((b) => normBug(b, cfg.account)) };
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
-    return { ok: false, error: `\u7985\u9053\u8BF7\u6C42\u5931\u8D25(${msg})\u2014\u2014\u68C0\u67E5 url / \u51ED\u636E / \u662F\u5426\u5F00\u542F RESTful API v1` };
-  }
-}
-
 // src/plugins/bugs/index.ts
 var apply3 = {
   inject: ["server", "dashboard"],
@@ -1021,15 +1035,16 @@ var apply3 = {
 import fs7 from "fs";
 import path6 from "path";
 import YAML from "yaml";
-var REVIEW_FILE = "review.yaml";
+var REVIEW_CANDIDATES = [".zdev/review.yaml", "review.yaml"];
 var ReviewStore = class {
   root;
   file;
   onChange;
   constructor(root, onChange) {
     this.root = root;
-    this.file = path6.join(root, REVIEW_FILE);
     this.onChange = onChange;
+    const existing = REVIEW_CANDIDATES.find((rel) => fs7.existsSync(path6.join(root, rel)));
+    this.file = path6.join(root, existing ?? REVIEW_CANDIDATES[0]);
   }
   exists() {
     return fs7.existsSync(this.file);
@@ -1044,6 +1059,7 @@ var ReviewStore = class {
     }
   }
   write(data) {
+    fs7.mkdirSync(path6.dirname(this.file), { recursive: true });
     fs7.writeFileSync(this.file, YAML.stringify(data), "utf8");
     this.onChange?.();
   }
@@ -1068,7 +1084,9 @@ var ReviewStore = class {
   }
   docs() {
     try {
-      return fs7.readdirSync(this.root).filter((f) => /\.(md|markdown)$/i.test(f) && fs7.statSync(path6.join(this.root, f)).isFile()).sort();
+      const zdevDir = path6.join(this.root, ".zdev");
+      if (!fs7.existsSync(zdevDir) || !fs7.statSync(zdevDir).isDirectory()) return [];
+      return fs7.readdirSync(zdevDir).filter((f) => /\.(md|markdown)$/i.test(f) && fs7.statSync(path6.join(zdevDir, f)).isFile()).sort();
     } catch {
       return [];
     }
@@ -1154,33 +1172,80 @@ function readText(p) {
     return "";
   }
 }
+function worktreeDir(root, name) {
+  return path7.join(root, ".zworktree", name);
+}
+function changeDir(root, name) {
+  return path7.join(root, "openspec", "changes", name);
+}
+function parseDependsOn(proposal) {
+  const deps = [];
+  const m = proposal.match(/^##\s+依赖\s*\n([\s\S]*?)(?:\n#{1,6}\s|\n---\s*\n|$)/i);
+  if (!m) return deps;
+  for (const line of m[1].split("\n")) {
+    if (!/^-\s+/.test(line)) continue;
+    const name = line.replace(/^-\s+/, "").trim();
+    if (name) deps.push(name);
+  }
+  return deps;
+}
 function scanApplyChanges(root) {
   const changesDir = path7.join(root, "openspec", "changes");
   if (!fs8.existsSync(changesDir)) return [];
   const out = [];
   for (const ent of fs8.readdirSync(changesDir, { withFileTypes: true })) {
     if (!ent.isDirectory() || ent.name.startsWith(".") || ent.name === "archive") continue;
-    const dir = path7.join(changesDir, ent.name);
-    const tasks = readText(path7.join(dir, "tasks.md"));
-    const { total, done } = countTasks(tasks);
-    out.push({
-      name: ent.name,
-      path: `openspec/changes/${ent.name}`,
-      total,
-      done,
-      hasProposal: fs8.existsSync(path7.join(dir, "proposal.md")),
-      hasDesign: fs8.existsSync(path7.join(dir, "design.md"))
-    });
+    const wt = worktreeDir(root, ent.name);
+    const tasks = readText(path7.join(wt, "openspec", "changes", ent.name, "tasks.md"));
+    if (!tasks) {
+      const fallback = readText(path7.join(changesDir, ent.name, "tasks.md"));
+      if (fallback) {
+        const { total, done } = countTasks(fallback);
+        const wtChange = path7.join(wt, "openspec", "changes", ent.name);
+        const mainChange = path7.join(changesDir, ent.name);
+        out.push({
+          name: ent.name,
+          path: `openspec/changes/${ent.name}`,
+          total,
+          done,
+          hasProposal: fs8.existsSync(path7.join(wtChange, "proposal.md")) || fs8.existsSync(path7.join(mainChange, "proposal.md")),
+          hasDesign: fs8.existsSync(path7.join(wtChange, "design.md")) || fs8.existsSync(path7.join(mainChange, "design.md")),
+          // worktree 目录存在即算执行中（tasks.md 可能尚未落盘）
+          inWorktree: fs8.existsSync(wtChange)
+        });
+      }
+    } else {
+      const { total, done } = countTasks(tasks);
+      const wtChange = path7.join(wt, "openspec", "changes", ent.name);
+      const mainChange = path7.join(changesDir, ent.name);
+      out.push({
+        name: ent.name,
+        path: `openspec/changes/${ent.name}`,
+        total,
+        done,
+        // 任一侧存在即算（详情读取是 worktree 优先、主目录兜底，列表标记保持一致）
+        hasProposal: fs8.existsSync(path7.join(wtChange, "proposal.md")) || fs8.existsSync(path7.join(mainChange, "proposal.md")),
+        hasDesign: fs8.existsSync(path7.join(wtChange, "design.md")) || fs8.existsSync(path7.join(mainChange, "design.md")),
+        inWorktree: true
+      });
+    }
   }
   out.sort((a, b) => a.name.localeCompare(b.name));
   return out;
 }
 function readApplyChange(root, name) {
-  const dir = path7.join(root, "openspec", "changes", name);
-  const proposal = readText(path7.join(dir, "proposal.md"));
-  const design = readText(path7.join(dir, "design.md"));
-  const tasks = readText(path7.join(dir, "tasks.md"));
+  const wt = worktreeDir(root, name);
+  const mainChangeDir = changeDir(root, name);
+  const proposalFrom = fs8.existsSync(path7.join(wt, "openspec", "changes", name, "proposal.md")) ? path7.join(wt, "openspec", "changes", name, "proposal.md") : path7.join(mainChangeDir, "proposal.md");
+  const designFrom = fs8.existsSync(path7.join(wt, "openspec", "changes", name, "design.md")) ? path7.join(wt, "openspec", "changes", name, "design.md") : path7.join(mainChangeDir, "design.md");
+  const tasksFrom = fs8.existsSync(path7.join(wt, "openspec", "changes", name, "tasks.md")) ? path7.join(wt, "openspec", "changes", name, "tasks.md") : path7.join(mainChangeDir, "tasks.md");
+  const proposal = readText(proposalFrom);
+  const design = readText(designFrom);
+  const tasks = readText(tasksFrom);
   const { total, done } = countTasks(tasks);
+  const inWorktree = fs8.existsSync(path7.join(wt, "openspec", "changes", name));
+  const dependsOn = parseDependsOn(proposal);
+  const hasTestStrategy = /^##\s+测试策略\s*$/m.test(design);
   return {
     name,
     path: `openspec/changes/${name}`,
@@ -1188,13 +1253,63 @@ function readApplyChange(root, name) {
     done,
     hasProposal: !!proposal,
     hasDesign: !!design,
+    inWorktree,
     proposal,
     design,
-    tasks
+    tasks,
+    dependsOn,
+    hasTestStrategy
   };
 }
 
 // src/plugins/apply/index.ts
+import { execFile as execFile3 } from "child_process";
+var GIT_TIMEOUT_MS = 5e3;
+function gitWorktrees(root) {
+  return new Promise((resolve) => {
+    execFile3(
+      "git",
+      ["worktree", "list", "--porcelain"],
+      { cwd: root, timeout: GIT_TIMEOUT_MS },
+      (err, stdout) => {
+        if (err) return resolve([]);
+        const entries = [];
+        const lines = stdout.split("\n");
+        let current = {};
+        for (const line of lines) {
+          const m = line.match(/^(worktree|HEAD|branch|detached)\s+(.+)$/);
+          if (m) {
+            const [, key, val] = m;
+            if (key === "worktree") {
+              if (current.path && current.path.includes(".zworktree/")) {
+                entries.push({
+                  path: current.path,
+                  name: current.path.split("/.zworktree/").pop() ?? "",
+                  branch: current.branch ?? "",
+                  head: current.head ?? ""
+                });
+              }
+              current = { path: val, head: "", branch: "" };
+            } else if (key === "HEAD") {
+              current.head = val;
+            } else if (key === "branch") {
+              current.branch = val.replace(/^refs\/heads\//, "");
+            }
+          }
+        }
+        if (current.path && current.path.includes(".zworktree/")) {
+          entries.push({
+            path: current.path,
+            name: current.path.split("/.zworktree/").pop() ?? "",
+            branch: current.branch ?? "",
+            head: current.head ?? ""
+          });
+        }
+        resolve(entries);
+      }
+    );
+  });
+}
 var apply5 = {
   inject: ["server", "dashboard"],
   apply(ctx, config) {
@@ -1228,6 +1343,16 @@ var apply5 = {
           res.end(JSON.stringify({ error: e instanceof Error ? e.message : "unknown error" }));
         }
       });
+      ctx.server.route("/__worktrees", async (_req, res) => {
+        try {
+          const entries = await gitWorktrees(root);
+          res.writeHead(200, { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-cache" });
+          res.end(JSON.stringify(entries));
+        } catch {
+          res.writeHead(200, { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-cache" });
+          res.end(JSON.stringify([]));
+        }
+      });
     });
   }
 };
@@ -1389,9 +1514,11 @@ var apply8 = {
 
 // src/cli.ts
 var __dirname2 = path10.dirname(fileURLToPath2(import.meta.url));
+var DEFAULT_PORT = 4190;
 function parseArgs() {
   const args = process.argv.slice(2);
   const opts = {};
+  let portExplicit = false;
   for (let i = 0; i < args.length; i++) {
     const a = args[i];
     if (a.startsWith("--")) {
@@ -1403,11 +1530,13 @@ function parseArgs() {
       } else {
         opts[key] = true;
       }
+      if (key === "port") portExplicit = true;
     }
   }
   return {
     dir: typeof opts.dir === "string" ? opts.dir : process.cwd(),
-    port: typeof opts.port === "string" ? Number(opts.port) : 4190,
+    port: typeof opts.port === "string" ? Number(opts.port) : DEFAULT_PORT,
+    portExplicit,
     open: !!opts.open,
     page: typeof opts.page === "string" ? opts.page : null,
     restart: !!opts.restart,
@@ -1481,20 +1610,25 @@ async function main() {
     await new Promise((resolve) => process.stdout.write("", () => resolve()));
     process.exit(0);
   }
-  if (existing && args.restart) {
-    console.log(`[zdashboard] --restart\uFF1A\u505C\u6B62\u65E7\u5B9E\u4F8B pid=${existing.pid}`);
-    await stopInstance(existing);
+  const oldRecord = existing && args.restart ? existing : null;
+  if (oldRecord) {
+    console.log(`[zdashboard] --restart\uFF1A\u505C\u6B62\u65E7\u5B9E\u4F8B pid=${oldRecord.pid}`);
+    await stopInstance(oldRecord);
   }
   const appDir = path10.resolve(__dirname2, "web");
+  const startPort = oldRecord && !args.portExplicit ? oldRecord.port : args.port;
+  const zdevDir = path10.join(root, ".zdev");
+  const dataDir = fs11.existsSync(zdevDir) ? ".zdev/" : "";
   const det = await detect(root);
   const ctx = new Context();
   ctx.plugin(ServerService, {
     root,
     appDir,
-    port: args.port,
+    port: startPort,
     open: args.open,
     detect: det,
     page: args.page,
+    dataDir: dataDir || void 0,
     onListen: (port) => writeRecord(root, port)
   });
   ctx.plugin(ReloadService, { root });