zdashboard 2.0.0 → 2.1.1

package/dist/cli.js

@@ -1,14 +1,138 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import path8 from "path";
+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,16 +154,15 @@ import { Context } from "cordis";
 
 // src/core/server.ts
 import http from "http";
-import fs2 from "fs";
-import path2 from "path";
+import fs4 from "fs";
+import path4 from "path";
 import crypto from "crypto";
-import { exec } from "child_process";
 import { fileURLToPath } from "url";
 
 // package.json
 var package_default = {
   name: "zdashboard",
-  version: "2.0.0",
+  version: "2.1.1",
   description: "ZCode skill dashboard platform \u2014 pluggable viewers for zdesign/zview/zreview/zgoal",
   type: "module",
   bin: {
@@ -123,8 +246,113 @@ var package_default = {
 
 // src/core/server.ts
 import { Service } from "cordis";
+
+// src/core/instance.ts
+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 path3.join(root, RECORD_FILE);
+}
+function readRecord(root) {
+  try {
+    const fp = recordPath(root);
+    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;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeRecord(root, port) {
+  fs3.mkdirSync(path3.dirname(recordPath(root)), { recursive: true });
+  const rec = {
+    pid: process.pid,
+    port,
+    root,
+    startedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  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;
+    fs3.unlinkSync(recordPath(root));
+  } catch {
+  }
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    if (e.code === "ESRCH") return false;
+    return true;
+  }
+}
+async function fetchWithTimeout(url) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), VERIFY_TIMEOUT_MS);
+  try {
+    return await fetch(url, { signal: controller.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function verifyRoot(port, root) {
+  try {
+    const res = await fetchWithTimeout(`http://127.0.0.1:${port}/__config`);
+    if (res.status !== 200) return false;
+    const body = await res.json();
+    if (typeof body.root !== "string") return false;
+    return body.root === root;
+  } catch {
+    return false;
+  }
+}
+async function findReusable(root) {
+  const rec = readRecord(root);
+  if (!rec) return null;
+  if (!isAlive(rec.pid)) return null;
+  if (!await verifyRoot(rec.port, root)) return null;
+  return rec;
+}
+async function stopInstance(record) {
+  try {
+    process.kill(record.pid, "SIGTERM");
+  } catch {
+    return;
+  }
+  const deadline = Date.now() + STOP_POLL_MS;
+  while (Date.now() < deadline) {
+    if (!isAlive(record.pid)) return;
+    await new Promise((r) => setTimeout(r, STOP_POLL_INTERVAL_MS));
+  }
+  try {
+    process.kill(record.pid, "SIGKILL");
+  } catch {
+  }
+  await new Promise((r) => setTimeout(r, STOP_FINAL_WAIT_MS));
+}
+
+// src/core/open-url.ts
+import { exec } from "child_process";
+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 = path2.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",
@@ -182,10 +410,12 @@ var ServerService = class extends Service {
   open;
   page;
   det;
+  dataDir;
   routes = /* @__PURE__ */ new Map();
   sses = /* @__PURE__ */ new Map();
   prefixStatic = /* @__PURE__ */ new Map();
   server;
+  onListen;
   constructor(ctx, config) {
     super(ctx, "server");
     this.stopToken = crypto.randomBytes(12).toString("hex");
@@ -194,6 +424,8 @@ 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) => {
       res.writeHead(200, { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-cache" });
@@ -211,25 +443,25 @@ var ServerService = class extends Service {
     });
     this.start(config.port);
   }
-  route(path9, handler) {
-    this.routes.set(path9, handler);
-    this.ctx.effect(() => () => this.routes.delete(path9));
+  route(path11, handler) {
+    this.routes.set(path11, handler);
+    this.ctx.effect(() => () => this.routes.delete(path11));
   }
-  sse(path9, onConnect) {
-    this.sses.set(path9, onConnect);
-    this.ctx.effect(() => () => this.sses.delete(path9));
+  sse(path11, onConnect) {
+    this.sses.set(path11, onConnect);
+    this.ctx.effect(() => () => this.sses.delete(path11));
   }
   static(prefix, dir) {
     this.prefixStatic.set(prefix, dir);
     this.ctx.effect(() => () => this.prefixStatic.delete(prefix));
   }
   serveFile(filePath, res, injectHtml) {
-    fs2.readFile(filePath, (err, data) => {
+    fs4.readFile(filePath, (err, data) => {
       if (err) {
         res.writeHead(404);
         return res.end("Not found");
       }
-      const ext = path2.extname(filePath).toLowerCase();
+      const ext = path4.extname(filePath).toLowerCase();
       const ct = MIME[ext] ?? "application/octet-stream";
       let body = data;
       if (injectHtml && ext === ".html") {
@@ -244,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 === "/" || !path2.extname(rel)) rel = path2.join(rel || "", "index.html");
-        const fp = path2.join(dir, rel);
-        if (fp.indexOf(dir + path2.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");
         }
@@ -285,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 = path2.join(this.appDir, this.safeDecode(url));
-        if (url.indexOf("/__app/") === 0) fp2 = path2.join(this.appDir, url.slice(7));
-        if (fp2 !== this.appDir && fp2.indexOf(this.appDir + path2.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 = path2.join(this.appDir, "index.html");
+        if (url === "/") fp2 = path4.join(this.appDir, "index.html");
         return this.serveFile(fp2, res, false);
       }
-      const fp = path2.join(this.root, this.safeDecode(url));
-      if (fp !== this.root && fp.indexOf(this.root + path2.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");
       }
@@ -311,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}`);
@@ -323,7 +557,9 @@ 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) exec(process.platform === "darwin" ? `open ${target}` : `start ${target}`);
+      if (this.dataDir) console.log(`[zdashboard] data      -> ${this.dataDir}`);
+      if (this.open) openUrl(target);
+      this.onListen?.(port);
     });
   }
   stop() {
@@ -333,6 +569,10 @@ var ServerService = class extends Service {
       } catch {
       }
     }
+    try {
+      clearRecord(this.root);
+    } catch {
+    }
     setTimeout(() => {
       try {
         this.ctx.root.fiber.dispose();
@@ -348,11 +588,15 @@ var ServerService = class extends Service {
       } catch {
       }
     }
+    try {
+      clearRecord(this.root);
+    } catch {
+    }
   }
 };
 
 // src/core/reload.ts
-import fs3 from "fs";
+import fs5 from "fs";
 import { Service as Service2 } from "cordis";
 var WATCH_DEBOUNCE_MS = 150;
 var ReloadService = class extends Service2 {
@@ -368,7 +612,7 @@ var ReloadService = class extends Service2 {
       return () => this.clients.delete(res);
     });
     try {
-      this.watcher = fs3.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");
@@ -411,13 +655,13 @@ data: ${JSON.stringify(data == null ? "" : data)}
 };
 
 // src/server/spec-scan.ts
-import fs4 from "fs";
-import path3 from "path";
+import fs6 from "fs";
+import path5 from "path";
 function walkFiles(absDir, relDir, depth = 0) {
   if (depth > 4) return [];
   let ents;
   try {
-    ents = fs4.readdirSync(absDir, { withFileTypes: true });
+    ents = fs6.readdirSync(absDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -426,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(path3.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 });
     }
@@ -436,41 +680,41 @@ function walkFiles(absDir, relDir, depth = 0) {
 }
 function scanTree(root, hasOpenspec, hasDocs) {
   const tree = [];
-  if (hasOpenspec && fs4.existsSync(path3.join(root, "openspec", "changes"))) {
-    const changesDir = path3.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 fs4.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(path3.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 = path3.join(changesDir, "archive");
-    if (fs4.existsSync(archiveDir)) {
-      for (const ent of fs4.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(path3.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 = path3.join(root, "openspec", "specs");
-    if (fs4.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 && fs4.existsSync(path3.join(root, "docs"))) {
-    const docs = walkFiles(path3.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 fs4.readdirSync(root, { withFileTypes: true })) {
+    for (const ent of fs6.readdirSync(root, { withFileTypes: true })) {
       if (ent.name.startsWith(".") || skip.has(ent.name)) continue;
-      const ext = path3.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) {
@@ -540,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) {
@@ -580,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,
@@ -612,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);
+    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 });
   }
-  killChild() {
-    const child = this.child;
+  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"]);
@@ -660,7 +912,9 @@ var JustRunner = class {
       } catch {
       }
     }
-    this.child = null;
+    if (task) {
+      task.child = null;
+    }
   }
 };
 
@@ -673,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 {
@@ -690,45 +945,7 @@ var apply2 = {
         });
         return unsub;
       });
-      ctx.server.route("/__just/start", async (req, res) => {
-        if (req.headers["x-stop-token"] !== ctx.server.stopToken) {
-          res.writeHead(403);
-          res.end("forbidden");
-          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;
-        }
-        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) => {
+      const handleAction = async (req, res, act) => {
         if (req.headers["x-stop-token"] !== ctx.server.stopToken) {
           res.writeHead(403);
           res.end("forbidden");
@@ -740,23 +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"}');
+        if (act === "clear") {
+          if (recipe) runner.clear(recipe);
+          res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+          res.end('{"ok":true}');
           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");
     });
   }
 };
@@ -767,120 +1006,10 @@ async function readBody(req) {
       data += c;
     });
     req.on("end", () => resolve(data));
+    req.on("error", () => resolve(""));
   });
 }
 
-// src/server/bugs.ts
-import fs5 from "fs";
-import path4 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 = path4.join(root, ".zgoal", "config.yaml");
-  if (!fs5.existsSync(file)) return null;
-  const kv = {};
-  for (const line of fs5.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"],
@@ -903,25 +1032,26 @@ var apply3 = {
 };
 
 // src/server/review-store.ts
-import fs6 from "fs";
-import path5 from "path";
+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 = path5.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 fs6.existsSync(this.file);
+    return fs7.existsSync(this.file);
   }
   read() {
     try {
-      const parsed = YAML.parse(fs6.readFileSync(this.file, "utf8"));
+      const parsed = YAML.parse(fs7.readFileSync(this.file, "utf8"));
       if (!parsed || !Array.isArray(parsed.items)) return { status: "draft", items: [] };
       return parsed;
     } catch {
@@ -929,7 +1059,8 @@ var ReviewStore = class {
     }
   }
   write(data) {
-    fs6.writeFileSync(this.file, YAML.stringify(data), "utf8");
+    fs7.mkdirSync(path6.dirname(this.file), { recursive: true });
+    fs7.writeFileSync(this.file, YAML.stringify(data), "utf8");
     this.onChange?.();
   }
   updateItem(id, patch) {
@@ -953,7 +1084,9 @@ var ReviewStore = class {
   }
   docs() {
     try {
-      return fs6.readdirSync(this.root).filter((f) => /\.(md|markdown)$/i.test(f) && fs6.statSync(path5.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 [];
     }
@@ -1025,8 +1158,8 @@ async function readBody2(req) {
 }
 
 // src/plugins/apply/scan.ts
-import fs7 from "fs";
-import path6 from "path";
+import fs8 from "fs";
+import path7 from "path";
 function countTasks(md) {
   const all = (md.match(/^\s*-\s*\[[ xX]\]\s*/gm) || []).length;
   const done = (md.match(/^\s*-\s*\[[xX]\]\s*/gm) || []).length;
@@ -1034,38 +1167,85 @@ function countTasks(md) {
 }
 function readText(p) {
   try {
-    return fs7.readFileSync(p, "utf8");
+    return fs8.readFileSync(p, "utf8");
   } catch {
     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 = path6.join(root, "openspec", "changes");
-  if (!fs7.existsSync(changesDir)) return [];
+  const changesDir = path7.join(root, "openspec", "changes");
+  if (!fs8.existsSync(changesDir)) return [];
   const out = [];
-  for (const ent of fs7.readdirSync(changesDir, { withFileTypes: true })) {
+  for (const ent of fs8.readdirSync(changesDir, { withFileTypes: true })) {
     if (!ent.isDirectory() || ent.name.startsWith(".") || ent.name === "archive") continue;
-    const dir = path6.join(changesDir, ent.name);
-    const tasks = readText(path6.join(dir, "tasks.md"));
-    const { total, done } = countTasks(tasks);
-    out.push({
-      name: ent.name,
-      path: `openspec/changes/${ent.name}`,
-      total,
-      done,
-      hasProposal: fs7.existsSync(path6.join(dir, "proposal.md")),
-      hasDesign: fs7.existsSync(path6.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 = path6.join(root, "openspec", "changes", name);
-  const proposal = readText(path6.join(dir, "proposal.md"));
-  const design = readText(path6.join(dir, "design.md"));
-  const tasks = readText(path6.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}`,
@@ -1073,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) {
@@ -1113,13 +1343,23 @@ 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([]));
+        }
+      });
     });
   }
 };
 
 // src/server/design-assets.ts
-import fs8 from "fs";
-import path7 from "path";
+import fs9 from "fs";
+import path8 from "path";
 var PAGE_EXTS = [".html", ".htm"];
 var ICON_EXTS = [".svg", ".png", ".ico", ".jpg", ".jpeg", ".gif", ".webp"];
 var VIDEO_EXTS = [".mp4", ".webm", ".mov", ".ogg", ".ogv"];
@@ -1136,18 +1376,21 @@ function categorize(rel, ext) {
   if (FONT_EXTS.includes(ext)) return "font";
   if (ICON_EXTS.includes(ext)) return "icon";
   if (PAGE_EXTS.includes(ext)) return "page";
-  if (CODE_EXTS.includes(ext)) return TOKEN_RE.test(rel) && (ext === ".css" || ext === ".json") ? "token" : "code";
+  if (CODE_EXTS.includes(ext)) {
+    if (TOKEN_RE.test(rel) && (ext === ".css" || ext === ".json")) return "token";
+    return null;
+  }
   return "other";
 }
 function scanAssets(root) {
   const out = {};
-  const keys = ["page", "component", "icon", "token", "md", "video", "audio", "pdf", "code", "font", "other"];
+  const keys = ["page", "component", "icon", "token", "md", "video", "audio", "pdf", "font", "other"];
   for (const k of keys) out[k] = [];
   const SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", "coverage", ".next", ".cache"]);
   function walk(dir, rel) {
     let ents;
     try {
-      ents = fs8.readdirSync(dir, { withFileTypes: true });
+      ents = fs9.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -1155,12 +1398,12 @@ function scanAssets(root) {
       if (ent.name.startsWith(".") || SKIP.has(ent.name)) continue;
       const r = rel ? `${rel}/${ent.name}` : ent.name;
       if (ent.isDirectory()) {
-        walk(path7.join(dir, ent.name), r);
+        walk(path8.join(dir, ent.name), r);
         continue;
       }
-      const ext = path7.extname(ent.name).toLowerCase();
+      const ext = path8.extname(ent.name).toLowerCase();
       const t = categorize(r, ext);
-      out[t].push({ path: r, name: ent.name, ext, type: t });
+      if (t) out[t].push({ path: r, name: ent.name, ext, type: t });
     }
   }
   walk(root, "");
@@ -1191,11 +1434,91 @@ var apply7 = {
   }
 };
 
+// src/plugins/stats/index.ts
+import fs10 from "fs";
+import path9 from "path";
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".next", ".cache"]);
+function scan(root) {
+  const stats = {
+    root: path9.basename(root),
+    files: 0,
+    dirs: 0,
+    totalSize: 0,
+    byExt: [],
+    markdown: 0,
+    openspec: { active: 0, archived: 0 },
+    hasJust: fs10.existsSync(path9.join(root, "justfile"))
+  };
+  const extMap = /* @__PURE__ */ new Map();
+  const walk = (dir) => {
+    let ents;
+    try {
+      ents = fs10.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const ent of ents) {
+      if (ent.name.startsWith(".") || SKIP_DIRS.has(ent.name)) continue;
+      const abs = path9.join(dir, ent.name);
+      if (ent.isDirectory()) {
+        stats.dirs++;
+        walk(abs);
+        continue;
+      }
+      stats.files++;
+      try {
+        stats.totalSize += fs10.statSync(abs).size;
+      } catch {
+      }
+      const ext = path9.extname(ent.name).toLowerCase() || "(\u65E0\u6269\u5C55\u540D)";
+      extMap.set(ext, (extMap.get(ext) ?? 0) + 1);
+      if (ext === ".md" || ext === ".markdown") stats.markdown++;
+    }
+  };
+  walk(root);
+  const changesDir = path9.join(root, "openspec", "changes");
+  if (fs10.existsSync(changesDir)) {
+    for (const ent of fs10.readdirSync(changesDir, { withFileTypes: true })) {
+      if (!ent.isDirectory() || ent.name.startsWith(".")) continue;
+      if (ent.name === "archive") {
+        try {
+          stats.openspec.archived = fs10.readdirSync(path9.join(changesDir, "archive"), { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".")).length;
+        } catch {
+        }
+      } else stats.openspec.active++;
+    }
+  }
+  stats.byExt = Array.from(extMap.entries()).map(([ext, count]) => ({ ext, count })).sort((a, b) => b.count - a.count).slice(0, 10);
+  return stats;
+}
+var apply8 = {
+  inject: ["server", "dashboard"],
+  apply(ctx, config) {
+    ctx.inject(["server", "dashboard"], () => {
+      const server = ctx.server;
+      const dashboard = ctx.dashboard;
+      if (!server?.route || !dashboard?.register) return;
+      dashboard.register({
+        mode: "stats",
+        label: "\u9879\u76EE\u7EDF\u8BA1",
+        icon: "\u{1F4CA}",
+        description: "\u9879\u76EE\u6587\u4EF6\u7EDF\u8BA1 \xB7 \u626B\u63CF\u751F\u6210"
+      });
+      server.route("/__stats/data", (_req, res) => {
+        res.writeHead(200, { "Content-Type": "application/json; charset=utf-8", "Cache-Control": "no-cache" });
+        res.end(JSON.stringify(scan(config.root)));
+      });
+    });
+  }
+};
+
 // src/cli.ts
-var __dirname2 = path8.dirname(fileURLToPath2(import.meta.url));
+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("--")) {
@@ -1207,13 +1530,16 @@ 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,
     plugins: typeof opts.plugins === "string" ? opts.plugins : null
   };
 }
@@ -1240,7 +1566,7 @@ async function loadExternal(ctx, dir, root) {
       if (!ent.isDirectory()) continue;
       const candidates = tsxLoaded ? ["index.ts", "index.js", "index.mjs"] : ["index.js", "index.mjs"];
       for (const name of candidates) {
-        const p = path8.join(dir, ent.name, name);
+        const p = path10.join(dir, ent.name, name);
         if (await pathExists(p)) {
           try {
             const mod = await import(p);
@@ -1255,8 +1581,8 @@ async function loadExternal(ctx, dir, root) {
               const m = ctx.dashboard.get(ent.name);
               if (m && m.mode === ent.name) {
                 const patch = { external: true };
-                const webDir = path8.join(dir, ent.name, "web");
-                if (await pathExists(path8.join(webDir, "index.html"))) {
+                const webDir = path10.join(dir, ent.name, "web");
+                if (await pathExists(path10.join(webDir, "index.html"))) {
                   ctx.server.static(`${PLUGIN_STATIC_PREFIX}${ent.name}/`, webDir);
                   if (!m.viewerUrl) patch.viewerUrl = `${PLUGIN_STATIC_PREFIX}${ent.name}/`;
                 }
@@ -1275,15 +1601,41 @@ async function loadExternal(ctx, dir, root) {
 }
 async function main() {
   const args = parseArgs();
-  const root = path8.resolve(args.dir);
-  const appDir = path8.resolve(__dirname2, "web");
+  const root = path10.resolve(args.dir);
+  const existing = await findReusable(root);
+  if (existing && !args.restart) {
+    const u = `http://localhost:${existing.port}` + (args.page ? `#${args.page}` : "");
+    if (args.open) openUrl(u);
+    console.log(`[zdashboard] \u5DF2\u590D\u7528\u5B9E\u4F8B ${u}\uFF08--restart \u53EF\u5F3A\u5236\u91CD\u5F00\uFF09`);
+    await new Promise((resolve) => process.stdout.write("", () => resolve()));
+    process.exit(0);
+  }
+  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, open: args.open, detect: det, page: args.page });
+  ctx.plugin(ServerService, {
+    root,
+    appDir,
+    port: startPort,
+    open: args.open,
+    detect: det,
+    page: args.page,
+    dataDir: dataDir || void 0,
+    onListen: (port) => writeRecord(root, port)
+  });
   ctx.plugin(ReloadService, { root });
   ctx.plugin(apply, { root });
   ctx.plugin(DashboardService);
   const plugins = [
+    { name: "stats", apply: apply8 },
     { name: "just", apply: apply2 },
     { name: "bugs", apply: apply3 },
     { name: "review", apply: apply4 },
@@ -1299,8 +1651,17 @@ async function main() {
     }
   }
   if (args.plugins) {
-    await loadExternal(ctx, path8.resolve(args.plugins), root);
+    await loadExternal(ctx, path10.resolve(args.plugins), root);
   }
+  const shutdown = () => {
+    try {
+      clearRecord(root);
+    } catch {
+    }
+    process.exit(0);
+  };
+  process.on("SIGTERM", shutdown);
+  process.on("SIGINT", shutdown);
   return ctx;
 }
 await main().catch((e) => {