openspec-dashboard 0.1.0 → 0.1.1

package/README.en.md

@@ -0,0 +1,50 @@
+# OpenSpec Dashboard
+
+[中文](./README.md) | **English**
+
+> A zero-config visual dashboard for OpenSpec SDD — track the full spec-driven development workflow in your browser with a single command, with built-in visual skill execution.
+
+[![npm version](https://img.shields.io/npm/v/openspec-dashboard.svg)](https://www.npmjs.com/package/openspec-dashboard)
+[![node](https://img.shields.io/node/v/openspec-dashboard.svg)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/openspec-dashboard.svg)](./LICENSE)
+
+## Quick Install
+
+`npm i -g openspec-dashboard`.
+
+## Features
+
+- **Three-column Kanban board** — In Progress / Ready / Archived, see the stage of every change at a glance
+- **Artifact visualization** — Live rendering of `proposal.md` / `design.md` / `tasks.md`, with automatic task completion stats
+- **One-click skill execution** — Smart recommendations of `continue` / `apply` / `archive` based on change status, click to run with real-time streaming logs
+- **Hot reload** — `chokidar` + WebSocket, instant refresh on save, no manual reload needed
+- **New project wizard** — Three-step form to generate `openspec/config.yaml`, supports Java / Node / Python / Go
+
+## CLI Options
+
+```bash
+openspec-dashboard [options]
+
+  -p, --port <port>   Server port (default 3456)
+  -d, --dir <dir>     Specify the openspec directory (default: auto-discover up 5 levels)
+  --no-open           Do not auto-open the browser on startup
+```
+
+## Directory Convention
+
+```text
+your-project/
+└── openspec/
+    ├── config.yaml
+    ├── schemas/<name>/schema.yaml
+    └── changes/<change-name>/
+        ├── .openspec.yaml
+        ├── proposal.md
+        ├── design.md
+        ├── tasks.md
+        └── specs/<capability>/spec.md
+```
+
+## License
+
+MIT

package/README.md

@@ -1,109 +1,50 @@
 # OpenSpec Dashboard
 
-本地可视化看板，实时展示 OpenSpec SDD（Spec-Driven Development）流程中的变更状态。在包含 `openspec/` 目录的项目中启动，即可获得带热更新的 Web 看板界面。
+**中文** | [English](./README.en.md)
 
-## 功能特性
+> 零配置的 OpenSpec SDD 可视化看板 —— 一个命令 即可在浏览器中追踪规格驱动开发的全流程，提供可视化操作skill功能。
 
-### 📋 变更全局可视化看板
-- **三列 Kanban 视图**：进行中、待实现、已归档
-- 每张卡片展示变更名称、类型标签、产物进度条、创建时间
-- 支持变更类型识别：`feat-*`、`fix-*`、`hotfix-*`
-- 产物状态追踪：proposal → specs → design → tasks
+[![npm version](https://img.shields.io/npm/v/openspec-dashboard.svg)](https://www.npmjs.com/package/openspec-dashboard)
+[![node](https://img.shields.io/node/v/openspec-dashboard.svg)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/openspec-dashboard.svg)](./LICENSE)
 
-### 📄 变更详情查看
-- Markdown 产物内容实时渲染
-- tasks.md checkbox 完成度统计
-- 相关 spec 文件列表展示
+## 快速安装
 
-### 🚀 新项目快速接入向导
-- 三步式表单引导：基础信息 → 工作流选择 → 生成确认
-- 支持多种技术栈：Java / Node / Python / Go
-- 内置流程模板：标准流程 / 轻量流程 / Hotfix 流程
-- 一键生成项目配置文件
+`npm i -g openspec-dashboard`。
 
-### ⚡ 实时更新
-- 文件系统监听（chokidar）
-- WebSocket 增量推送
-- 热更新无需手动刷新
+## 核心功能
 
-### 🛠️ 技能执行面板
-- 可视化技能选择器
-- 命令执行终端
-- 实时输出展示
+- **三列 Kanban 看板** — 进行中 / 待实现 / 已归档，一眼掌握所有变更的阶段分布
+- **产物可视化** — 实时渲染 `proposal.md` / `design.md` / `tasks.md`，自动统计 tasks 完成度
+- **一键技能执行** — 根据变更状态智能推荐 `continue` / `apply` / `archive`，点击即跑，日志实时流式回传
+- **热更新** — `chokidar` + WebSocket，编辑保存即刷新，无需手动操作
+- **新项目向导** — 三步表单生成 `openspec/config.yaml`，支持 Java / Node / Python / Go
 
-## 快速开始
+## CLI 参数
 
 ```bash
-npm install
-npm run dev
-```
-
-开发服务启动后会自动打开浏览器，展示当前项目的变更看板。
-
-## CLI 使用
-
-```bash
-# 默认启动（自动发现 openspec/ 目录）
-npx openspec-dashboard
-
-# 自定义端口
-openspec-dashboard --port 3000
+openspec-dashboard [options]
 
-# 指定项目路径
-openspec-dashboard --dir ./path
+  -p, --port <port>   服务端口（默认 3456）
+  -d, --dir <dir>     指定 openspec 目录（默认自动向上查找 5 层）
+  --no-open           启动后不自动打开浏览器
 ```
 
-## 构建与生产运行
-
-```bash
-npm run build
-npm start
+## 目录约定
+
+```text
+your-project/
+└── openspec/
+    ├── config.yaml
+    ├── schemas/<name>/schema.yaml
+    └── changes/<change-name>/
+        ├── .openspec.yaml
+        ├── proposal.md
+        ├── design.md
+        ├── tasks.md
+        └── specs/<capability>/spec.md
 ```
 
-## 测试
-
-```bash
-npm test
-```
-
-## 技术栈
-
-- **前端框架**: React 18 + Vite
-- **样式**: TailwindCSS 3 + shadcn/ui
-- **后端**: Node.js + Express
-- **文件监听**: chokidar
-- **WebSocket**: ws
-- **Markdown 渲染**: react-markdown + remark-gfm
-
-## 项目结构
-
-```
-openspec-dashboard/
-├── src/
-│   ├── server/          # 后端服务
-│   │   ├── parser/      # OpenSpec 解析器
-│   │   ├── routes/      # API 路由
-│   │   ├── watcher.ts   # 文件监听
-│   │   └── ws.ts        # WebSocket
-│   └── client/          # 前端应用
-│       ├── components/  # UI 组件
-│       ├── hooks/       # 自定义 Hooks
-│       └── lib/         # 工具函数
-├── openspec/            # 示例 OpenSpec 配置
-└── tests/               # 测试文件
-```
-
-## OpenSpec SDD 流程
-
-OpenSpec Dashboard 支持 Spec-Driven Development 流程，通过以下产物管理变更：
-
-1. **proposal.md** - 变更提案
-2. **specs/** - 技术规格文档
-3. **design.md** - 设计文档
-4. **tasks.md** - 任务清单
-
-变更状态自动判定：
-- **进行中**：有产物但未全部完成
-- **待实现**：所有产物已就绪，等待 apply
-- **已归档**：位于 `archive/` 目录下的变更
+## License
 
+MIT

package/dist/bin/cli.js

@@ -1,24 +1,55 @@
 #!/usr/bin/env node
 import {
   startServer
-} from "../chunk-YBLVDJ3Y.js";
+} from "../chunk-JYWT57PM.js";
 
 // src/bin/cli.ts
 import { program } from "commander";
-import path from "path";
+import path2 from "path";
 import fs from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// src/shared/version.ts
+import { readFileSync } from "fs";
+import path from "path";
 import { fileURLToPath } from "url";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = path.dirname(__filename);
-program.name("openspec-dashboard").description("OpenSpec SDD \u672C\u5730\u53EF\u89C6\u5316\u770B\u677F").version("0.1.0").option("-p, --port <port>", "\u670D\u52A1\u7AEF\u53E3", "3456").option("-d, --dir <dir>", "\u6307\u5B9A openspec \u76EE\u5F55\u8DEF\u5F84").option("--no-open", "\u4E0D\u81EA\u52A8\u6253\u5F00\u6D4F\u89C8\u5668").action(async (opts) => {
+var cachedVersion = null;
+function getVersion() {
+  if (cachedVersion) return cachedVersion;
+  const __filename2 = fileURLToPath(import.meta.url);
+  const __dirname2 = path.dirname(__filename2);
+  const candidates = [
+    path.resolve(__dirname2, "../../package.json"),
+    path.resolve(__dirname2, "../package.json"),
+    path.resolve(__dirname2, "../../../package.json")
+  ];
+  for (const candidate of candidates) {
+    try {
+      const raw = readFileSync(candidate, "utf-8");
+      const pkg = JSON.parse(raw);
+      if (pkg.version) {
+        cachedVersion = pkg.version;
+        return cachedVersion;
+      }
+    } catch {
+    }
+  }
+  cachedVersion = "0.0.0";
+  return cachedVersion;
+}
+
+// src/bin/cli.ts
+var __filename = fileURLToPath2(import.meta.url);
+var __dirname = path2.dirname(__filename);
+program.name("openspec-dashboard").description("OpenSpec SDD \u672C\u5730\u53EF\u89C6\u5316\u770B\u677F").version(getVersion()).option("-p, --port <port>", "\u670D\u52A1\u7AEF\u53E3", "3456").option("-d, --dir <dir>", "\u6307\u5B9A openspec \u76EE\u5F55\u8DEF\u5F84").option("--no-open", "\u4E0D\u81EA\u52A8\u6253\u5F00\u6D4F\u89C8\u5668").action(async (opts) => {
   const port = parseInt(opts.port, 10);
   const openspecDir = resolveOpenspecDir(opts.dir);
   if (!openspecDir) {
     console.error("\u9519\u8BEF\uFF1A\u672A\u627E\u5230 openspec/ \u76EE\u5F55\u3002\u8BF7\u5728\u5305\u542B openspec/ \u7684\u9879\u76EE\u4E2D\u8FD0\u884C\uFF0C\u6216\u4F7F\u7528 --dir \u6307\u5B9A\u8DEF\u5F84\u3002");
     process.exit(1);
   }
-  const staticDir = path.resolve(__dirname, "../client");
-  const { shutdown } = await startServer({ openspecDir, port, staticDir, projectDir: path.resolve(openspecDir, "..") });
+  const staticDir = path2.resolve(__dirname, "../client");
+  const { shutdown } = await startServer({ openspecDir, port, staticDir, projectDir: path2.resolve(openspecDir, "..") });
   if (opts.open !== false) {
     const open = await import("open");
     await open.default(`http://localhost:${port}`);
@@ -30,17 +61,17 @@ program.name("openspec-dashboard").description("OpenSpec SDD \u672C\u5730\u53EF\
 });
 function resolveOpenspecDir(dir) {
   if (dir) {
-    const abs = path.resolve(dir);
+    const abs = path2.resolve(dir);
     if (fs.existsSync(abs)) return abs;
     return null;
   }
   let current = process.cwd();
   for (let i = 0; i < 5; i++) {
-    const candidate = path.join(current, "openspec");
+    const candidate = path2.join(current, "openspec");
     if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
       return candidate;
     }
-    const parent = path.dirname(current);
+    const parent = path2.dirname(current);
     if (parent === current) break;
     current = parent;
   }

package/dist/{chunk-YBLVDJ3Y.js → chunk-JYWT57PM.js}

@@ -166,6 +166,19 @@ async function parseTaskProgressFromFile(filePath) {
 }
 
 // src/server/parser/change-parser.ts
+function extractWhyFromProposal(proposalContent) {
+  if (!proposalContent) return void 0;
+  const match = proposalContent.match(/##\s+Why\s*\n+([^#]+?)(?:\n+[^#]|#|$)/);
+  if (!match) return void 0;
+  let why = match[1].trim();
+  if (!why) return void 0;
+  why = why.replace(/\*\*([^*]+)\*\*/g, "$1");
+  why = why.replace(/\s+/g, " ").trim();
+  if (why.length > 100) {
+    why = why.slice(0, 97) + "...";
+  }
+  return why;
+}
 function deriveChangeType(name) {
   if (name.startsWith("feat-")) return "feat";
   if (name.startsWith("fix-")) return "fix";
@@ -284,7 +297,7 @@ async function parseOneChange(changeDir, name, schemas, isArchived) {
   if (!createdAt) {
     try {
       const stats = await fs5.stat(changeDir);
-      createdAt = stats.birthtime.toISOString();
+      createdAt = stats.mtime.toISOString();
     } catch {
     }
   }
@@ -292,6 +305,14 @@ async function parseOneChange(changeDir, name, schemas, isArchived) {
   const hasProposal = await fileExists(path4.join(changeDir, "proposal.md"));
   const hasTasks = await fileExists(path4.join(changeDir, "tasks.md"));
   const taskProgress = await parseTaskProgressFromFile(path4.join(changeDir, "tasks.md"));
+  let why;
+  if (hasProposal) {
+    try {
+      const proposalContent = await fs5.readFile(path4.join(changeDir, "proposal.md"), "utf-8");
+      why = extractWhyFromProposal(proposalContent);
+    } catch {
+    }
+  }
   const specsDir = path4.join(changeDir, "specs");
   let applied = false;
   try {
@@ -318,7 +339,8 @@ async function parseOneChange(changeDir, name, schemas, isArchived) {
     artifacts,
     taskProgress: taskProgress ?? void 0,
     createdAt,
-    applied
+    applied,
+    why
   };
 }
 async function parseChanges(openspecDir, schemas) {
@@ -486,6 +508,38 @@ function createChangesRouter(getData, getOpenspecDir) {
     const allSuccess = results.every((r) => r.success);
     res.status(allSuccess ? 200 : 207).json({ results });
   });
+  router.post("/batch-delete", async (req, res) => {
+    const { names } = req.body;
+    if (!Array.isArray(names) || names.length === 0) {
+      res.status(400).json({ error: "names must be a non-empty array" });
+      return;
+    }
+    const openspecDir = getOpenspecDir();
+    const changesDir = path5.join(openspecDir, "changes");
+    const archiveDir = path5.join(changesDir, "archive");
+    const results = [];
+    for (const name of names) {
+      const activeChangeDir = path5.join(changesDir, name);
+      const archivedChangeDir = path5.join(archiveDir, name);
+      try {
+        let dirToDelete = null;
+        if (fs6.existsSync(activeChangeDir)) {
+          dirToDelete = activeChangeDir;
+        } else if (fs6.existsSync(archivedChangeDir)) {
+          dirToDelete = archivedChangeDir;
+        } else {
+          results.push({ name, success: false, error: "Change not found" });
+          continue;
+        }
+        fs6.rmSync(dirToDelete, { recursive: true, force: true });
+        results.push({ name, success: true });
+      } catch (err) {
+        results.push({ name, success: false, error: String(err) });
+      }
+    }
+    const allSuccess = results.every((r) => r.success);
+    res.status(allSuccess ? 200 : 207).json({ results });
+  });
   return router;
 }
 
@@ -669,8 +723,7 @@ async function getProjectName(openspecDir, fallback) {
 }
 async function validateProjectPath(projectPath) {
   try {
-    const openspecPath = path8.join(projectPath, "openspec");
-    const stat = await fs9.stat(openspecPath);
+    const stat = await fs9.stat(projectPath);
     return stat.isDirectory();
   } catch {
     return false;
@@ -702,7 +755,7 @@ function createProjectsRouter(getOpenspecDir, switchProject) {
     }
     const valid = await validateProjectPath(projectPath);
     if (!valid) {
-      res.status(400).json({ error: "Invalid project path: no openspec/ directory found" });
+      res.status(400).json({ error: "Invalid project path: directory does not exist" });
       return;
     }
     try {
@@ -715,6 +768,85 @@ function createProjectsRouter(getOpenspecDir, switchProject) {
   return router;
 }
 
+// src/server/routes/terminal.ts
+import { Router as Router7 } from "express";
+import { exec } from "child_process";
+import os from "os";
+function createTerminalRouter() {
+  const router = Router7();
+  function getPlatform() {
+    const platform = os.platform();
+    if (platform === "win32") return "windows";
+    if (platform === "darwin") return "macos";
+    return "linux";
+  }
+  function tryTerminalCommand(command) {
+    return new Promise((resolve) => {
+      exec(command, (error, _stdout, _stderr) => {
+        if (error) {
+          resolve(null);
+        } else {
+          resolve(command);
+        }
+      });
+    });
+  }
+  function buildTerminalCommand(projectPath, platform) {
+    const escapedPath = projectPath.replace(/"/g, '\\"');
+    switch (platform) {
+      case "windows":
+        return `start cmd /k "cd /d "${escapedPath}" && claude"`;
+      case "macos":
+        return `osascript -e 'tell app "Terminal"' -e 'activate' -e 'do script "cd \\"${escapedPath}\\" && claude"' -e 'end tell'`;
+      case "linux":
+        return `gnome-terminal -- bash -c 'cd "${escapedPath}" && claude; exec bash'`;
+    }
+  }
+  router.post("/", async (req, res) => {
+    const { projectPath } = req.body;
+    if (!projectPath || typeof projectPath !== "string") {
+      return res.status(400).json({
+        success: false,
+        error: "\u9879\u76EE\u8DEF\u5F84\u65E0\u6548"
+      });
+    }
+    const trimmedPath = projectPath.trim();
+    if (!trimmedPath) {
+      return res.status(400).json({
+        success: false,
+        error: "\u9879\u76EE\u8DEF\u5F84\u4E3A\u7A7A"
+      });
+    }
+    const platform = getPlatform();
+    const command = buildTerminalCommand(trimmedPath, platform);
+    return new Promise((resolve) => {
+      exec(command, (error, _stdout, stderr) => {
+        if (error) {
+          console.error("Failed to open terminal:", error);
+          console.error("stderr:", stderr);
+          return res.status(500).json({
+            success: false,
+            error: "\u65E0\u6CD5\u6253\u5F00\u7EC8\u7AEF",
+            details: process.env.NODE_ENV === "development" ? stderr : void 0
+          });
+        }
+        res.json({
+          success: true,
+          platform,
+          message: "\u7EC8\u7AEF\u5DF2\u6253\u5F00"
+        });
+        resolve();
+      });
+    });
+  });
+  router.post("/restart", (_req, res) => {
+    console.log("Restart requested, exiting process...");
+    res.json({ success: true, message: "\u9879\u76EE\u5DF2\u91CD\u542F" });
+    setTimeout(() => process.exit(1), 100);
+  });
+  return router;
+}
+
 // src/server/watcher.ts
 import chokidar from "chokidar";
 import fs10 from "fs";
@@ -894,6 +1026,11 @@ var SkillExecutor = class {
   currentStdin = null;
   currentSkill = "";
   currentChange = "";
+  disableRealtimeProgress = process.env.DISABLE_REALTIME_PROGRESS === "true";
+  // 跟踪有待处理问题且用户尚未响应
+  waitingForUserResponse = false;
+  // 跟踪是否有待处理问题被广播
+  hasPendingQuestion = false;
   constructor(options) {
     this.openspecDir = options.openspecDir;
     this.projectDir = options.projectDir;
@@ -905,6 +1042,9 @@ var SkillExecutor = class {
     }
     this.currentSkill = skill;
     this.currentChange = change;
+    this.waitingForUserResponse = false;
+    this.hasPendingQuestion = false;
+    const totalTasks = this.parseTotalTasks(skill, change);
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const state = {
       skill,
@@ -912,7 +1052,7 @@ var SkillExecutor = class {
       status: "running",
       phase: skill === "apply" ? "implementing" : "creating_artifact",
       currentTask: 0,
-      totalTasks: 0,
+      totalTasks,
       currentArtifact: null,
       startedAt: now,
       updatedAt: now
@@ -952,8 +1092,7 @@ var SkillExecutor = class {
         for (const line of lines) {
           if (!line.trim()) continue;
           try {
-            const event = JSON.parse(line);
-            this.handleStreamEvent(event);
+            this.handleStreamEvent(JSON.parse(line));
           } catch {
             this.appendLog(line);
             this.broadcast({ type: "skill_log", data: { line, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
@@ -969,6 +1108,21 @@ var SkillExecutor = class {
         this.currentProcess = null;
         this.currentStdin = null;
         const currentState = this.readState();
+        if (this.hasPendingQuestion) {
+          const completed = {
+            ...currentState,
+            status: "completed",
+            updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          this.writeState(completed);
+          this.appendLog(`\u26A0 /opsx:${skill} \u8FDB\u7A0B\u5DF2\u9000\u51FA\uFF0C\u7B49\u5F85\u7528\u6237\u54CD\u5E94`);
+          this.broadcast({ type: "skill_complete", data: completed });
+          this.broadcast({ type: "skill_log", data: { line: `[${this.timestamp()}] \u26A0 /opsx:${skill} \u8FDB\u7A0B\u5DF2\u9000\u51FA\uFF0C\u8BF7\u9009\u62E9\u91CD\u65B0\u6267\u884C`, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+          this.waitingForUserResponse = false;
+          this.hasPendingQuestion = false;
+          resolve();
+          return;
+        }
         if (code === 0 && currentState.status === "running") {
           const completed = {
             ...currentState,
@@ -991,6 +1145,8 @@ var SkillExecutor = class {
           this.broadcast({ type: "skill_complete", data: failed });
           this.broadcast({ type: "skill_log", data: { line: `[${this.timestamp()}] \u2717 /opsx:${skill} failed (exit code ${code})`, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
         }
+        this.waitingForUserResponse = false;
+        this.hasPendingQuestion = false;
         resolve();
       });
       proc.on("error", (err) => {
@@ -1004,6 +1160,11 @@ var SkillExecutor = class {
         this.writeState(failed);
         this.appendLog(`\u2717 Failed to start: ${err.message}`);
         this.broadcast({ type: "skill_complete", data: failed });
+        if (this.hasPendingQuestion) {
+          this.broadcast({ type: "skill_question", data: null });
+        }
+        this.waitingForUserResponse = false;
+        this.hasPendingQuestion = false;
         reject(err);
       });
     });
@@ -1022,6 +1183,11 @@ var SkillExecutor = class {
     this.writeState(cancelled);
     this.appendLog(`\u2717 /opsx:${this.currentSkill} cancelled by user`);
     this.broadcast({ type: "skill_complete", data: cancelled });
+    if (this.hasPendingQuestion) {
+      this.broadcast({ type: "skill_question", data: null });
+    }
+    this.waitingForUserResponse = false;
+    this.hasPendingQuestion = false;
     return true;
   }
   isRunning() {
@@ -1035,6 +1201,9 @@ var SkillExecutor = class {
       this.currentStdin.write(text + "\n");
       this.appendLog(`[\u7528\u6237\u8F93\u5165] ${text}`);
       this.broadcast({ type: "skill_log", data: { line: `[\u7528\u6237\u8F93\u5165] ${text}`, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+      this.waitingForUserResponse = false;
+      this.hasPendingQuestion = false;
+      this.broadcast({ type: "skill_question", data: null });
       return { success: true };
     } catch (err) {
       return { success: false, error: "\u65E0\u6CD5\u53D1\u9001\u8F93\u5165" };
@@ -1054,6 +1223,43 @@ var SkillExecutor = class {
     this.openspecDir = openspecDir;
     this.projectDir = projectDir;
   }
+  isTaskCompletionLine(line) {
+    const patterns = [
+      /Task \d+ completed/i,
+      /✓ Task/i,
+      /^\s*✓\s*\d+\./,
+      /Created task/i,
+      /Working on task.*complete/i,
+      /^✓\s.+\(task\s*\d+\/\d+\)/i
+    ];
+    return patterns.some((p) => p.test(line));
+  }
+  parseTotalTasks(skill, change) {
+    if (this.disableRealtimeProgress) return 0;
+    try {
+      if (skill === "apply") {
+        const tasksPath = path10.join(this.openspecDir, "changes", change, "tasks.md");
+        const content = fs11.readFileSync(tasksPath, "utf-8");
+        const taskLines = content.split("\n").filter((line) => /^\s*-\s*\[[ x]\]\s*\d+\.?/.test(line));
+        return taskLines.length;
+      }
+    } catch {
+    }
+    return 0;
+  }
+  updateTaskProgress() {
+    if (this.disableRealtimeProgress) return;
+    const state = this.readState();
+    if (state.currentTask < state.totalTasks) {
+      const updated = {
+        ...state,
+        currentTask: state.currentTask + 1,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      this.writeState(updated);
+      this.broadcast({ type: "skill_progress", data: updated });
+    }
+  }
   handleStreamEvent(event) {
     const type = event.type;
     if (type === "assistant") {
@@ -1066,13 +1272,40 @@ var SkillExecutor = class {
             for (const line of lines) {
               this.appendLog(line);
               this.broadcast({ type: "skill_log", data: { line, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+              if (this.isTaskCompletionLine(line)) {
+                this.updateTaskProgress();
+              }
             }
           }
           if (block.type === "tool_use") {
-            const inputStr = block.input ? JSON.stringify(block.input) : "";
-            const toolLine = `\u2192 ${block.name} ${inputStr}`;
-            this.appendLog(toolLine);
-            this.broadcast({ type: "skill_log", data: { line: toolLine, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+            if (block.name === "AskUserQuestion") {
+              const input = block.input;
+              const questions = input?.questions;
+              if (Array.isArray(questions) && questions.length > 0) {
+                const q = questions[0];
+                const pendingQuestion = {
+                  question: q.question || "",
+                  header: q.header || "",
+                  options: Array.isArray(q.options) ? q.options.map((opt) => ({
+                    label: opt.label || "",
+                    description: opt.description || ""
+                  })) : [],
+                  multiSelect: q.multiSelect ?? false,
+                  timestamp: (/* @__PURE__ */ new Date()).toISOString()
+                };
+                this.broadcast({ type: "skill_question", data: pendingQuestion });
+                const friendlyLine = `\u23F3 \u7B49\u5F85\u9009\u62E9: ${pendingQuestion.question}`;
+                this.appendLog(friendlyLine);
+                this.broadcast({ type: "skill_log", data: { line: friendlyLine, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+                this.hasPendingQuestion = true;
+                this.waitingForUserResponse = true;
+              }
+            } else {
+              const inputStr = block.input ? JSON.stringify(block.input) : "";
+              const toolLine = `\u2192 ${block.name} ${inputStr}`;
+              this.appendLog(toolLine);
+              this.broadcast({ type: "skill_log", data: { line: toolLine, timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+            }
           }
         }
       }
@@ -1144,6 +1377,7 @@ async function createServer(options) {
   app.use("/api/execution", createExecutionRouter(() => openspecDir));
   app.use("/api/projects", createProjectsRouter(() => openspecDir, async () => {
   }));
+  app.use("/api/terminal", createTerminalRouter());
   if (options.staticDir) {
     app.use(express.static(options.staticDir));
     app.get("*", (_req, res) => {
@@ -1184,6 +1418,7 @@ async function startServer(options) {
     broadcast({ type: "refresh" });
   };
   app.use("/api/projects", createProjectsRouter(() => currentOpenspecDir, switchProject));
+  app.use("/api/terminal", createTerminalRouter());
   if (options.staticDir) {
     app.use(express.static(options.staticDir));
     app.get("*", (_req, res) => {