openspec-dashboard 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# OpenSpec Dashboard
+
+本地可视化看板，实时展示 OpenSpec SDD（Spec-Driven Development）流程中的变更状态。在包含 `openspec/` 目录的项目中启动，即可获得带热更新的 Web 看板界面。
+
+## 功能特性
+
+### 📋 变更全局可视化看板
+- **三列 Kanban 视图**：进行中、待实现、已归档
+- 每张卡片展示变更名称、类型标签、产物进度条、创建时间
+- 支持变更类型识别：`feat-*`、`fix-*`、`hotfix-*`
+- 产物状态追踪：proposal → specs → design → tasks
+
+### 📄 变更详情查看
+- Markdown 产物内容实时渲染
+- tasks.md checkbox 完成度统计
+- 相关 spec 文件列表展示
+
+### 🚀 新项目快速接入向导
+- 三步式表单引导：基础信息 → 工作流选择 → 生成确认
+- 支持多种技术栈：Java / Node / Python / Go
+- 内置流程模板：标准流程 / 轻量流程 / Hotfix 流程
+- 一键生成项目配置文件
+
+### ⚡ 实时更新
+- 文件系统监听（chokidar）
+- WebSocket 增量推送
+- 热更新无需手动刷新
+
+### 🛠️ 技能执行面板
+- 可视化技能选择器
+- 命令执行终端
+- 实时输出展示
+
+## 快速开始
+
+```bash
+npm install
+npm run dev
+```
+
+开发服务启动后会自动打开浏览器，展示当前项目的变更看板。
+
+## CLI 使用
+
+```bash
+# 默认启动（自动发现 openspec/ 目录）
+npx openspec-dashboard
+
+# 自定义端口
+openspec-dashboard --port 3000
+
+# 指定项目路径
+openspec-dashboard --dir ./path
+```
+
+## 构建与生产运行
+
+```bash
+npm run build
+npm start
+```
+
+## 测试
+
+```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/` 目录下的变更
+

package/dist/bin/cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import {
+  startServer
+} from "../chunk-YBLVDJ3Y.js";
+
+// src/bin/cli.ts
+import { program } from "commander";
+import path from "path";
+import fs from "fs";
+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) => {
+  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, "..") });
+  if (opts.open !== false) {
+    const open = await import("open");
+    await open.default(`http://localhost:${port}`);
+  }
+  process.on("SIGINT", async () => {
+    await shutdown();
+    process.exit(0);
+  });
+});
+function resolveOpenspecDir(dir) {
+  if (dir) {
+    const abs = path.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");
+    if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+      return candidate;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+program.parse();

package/dist/bin/skill-hook.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+// src/bin/skill-hook.ts
+import fs from "fs";
+import path from "path";
+var IDLE_STATE = {
+  skill: "",
+  change: "",
+  status: "idle",
+  phase: "creating_artifact",
+  currentTask: 0,
+  totalTasks: 0,
+  currentArtifact: null,
+  startedAt: "",
+  updatedAt: ""
+};
+function resolveOpenspecDir() {
+  let current = process.cwd();
+  for (let i = 0; i < 5; i++) {
+    const candidate = path.join(current, "openspec");
+    if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+      return candidate;
+    }
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return null;
+}
+function inferSkillAndChange(filePath, openspecDir) {
+  const normalized = path.normalize(filePath);
+  const normalizedDir = path.normalize(openspecDir);
+  if (!normalized.startsWith(normalizedDir)) return null;
+  const relative = path.relative(normalizedDir, normalized);
+  const parts = relative.split(path.sep);
+  if (parts[0] === "changes" && parts.length >= 3) {
+    const changeName = parts[2] === "archive" ? parts[3] : parts[1];
+    const fileName = parts[parts.length - 1];
+    if (fileName === "tasks.md") {
+      return { skill: "apply", change: changeName, phase: "implementing", currentArtifact: null };
+    }
+    if (fileName === ".openspec.yaml") {
+      return { skill: "propose", change: changeName, phase: "creating_artifact", currentArtifact: null };
+    }
+    if (fileName.endsWith(".md")) {
+      const artifactId = fileName.replace(".md", "");
+      return { skill: "propose", change: changeName, phase: "creating_artifact", currentArtifact: artifactId };
+    }
+    return { skill: "continue", change: changeName, phase: "creating_artifact", currentArtifact: null };
+  }
+  return null;
+}
+function parseTaskProgress(content) {
+  const regex = /^- \[([ x])\]/gm;
+  let total = 0;
+  let completed = 0;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    total++;
+    if (match[1] === "x") completed++;
+  }
+  return { total, completed };
+}
+function readCurrentState(executionJsonPath) {
+  try {
+    const raw = fs.readFileSync(executionJsonPath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return { ...IDLE_STATE };
+  }
+}
+function writeState(executionJsonPath, state) {
+  fs.writeFileSync(executionJsonPath, JSON.stringify(state, null, 2) + "\n");
+}
+function appendLog(logPath, line) {
+  const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString("en-GB", { hour12: false });
+  const entry = `[${timestamp}] ${line}
+`;
+  fs.appendFileSync(logPath, entry);
+}
+async function main() {
+  let input = "";
+  try {
+    input = await new Promise((resolve) => {
+      let data = "";
+      process.stdin.setEncoding("utf-8");
+      process.stdin.on("data", (chunk) => {
+        data += chunk;
+      });
+      process.stdin.on("end", () => resolve(data));
+      setTimeout(() => resolve(data), 500);
+    });
+  } catch {
+    return;
+  }
+  let ctx;
+  try {
+    ctx = JSON.parse(input);
+  } catch {
+    return;
+  }
+  const filePath = ctx.filePath;
+  if (!filePath || !fs.existsSync(filePath)) return;
+  const openspecDir = resolveOpenspecDir();
+  if (!openspecDir) return;
+  const inferred = inferSkillAndChange(filePath, openspecDir);
+  if (!inferred) return;
+  const executionJsonPath = path.join(openspecDir, "execution.json");
+  const logPath = path.join(openspecDir, "execution.log");
+  const current = readCurrentState(executionJsonPath);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  if (current.status === "idle" || current.change !== inferred.change) {
+    const newState = {
+      skill: inferred.skill,
+      change: inferred.change,
+      status: "running",
+      phase: inferred.phase,
+      currentTask: 0,
+      totalTasks: 0,
+      currentArtifact: inferred.currentArtifact,
+      startedAt: current.change !== inferred.change ? now : current.startedAt || now,
+      updatedAt: now
+    };
+    if (inferred.skill === "apply" && filePath.endsWith("tasks.md")) {
+      try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const progress = parseTaskProgress(content);
+        newState.currentTask = progress.completed;
+        newState.totalTasks = progress.total;
+        if (progress.total > 0 && progress.completed === progress.total) {
+          newState.status = "completed";
+        }
+      } catch {
+      }
+    }
+    writeState(executionJsonPath, newState);
+    appendLog(logPath, `Starting /opsx:${inferred.skill} on ${inferred.change}`);
+  } else {
+    const updated = {
+      ...current,
+      phase: inferred.phase,
+      currentArtifact: inferred.currentArtifact ?? current.currentArtifact,
+      updatedAt: now
+    };
+    if (inferred.skill === "apply" && filePath.endsWith("tasks.md")) {
+      try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const progress = parseTaskProgress(content);
+        updated.currentTask = progress.completed;
+        updated.totalTasks = progress.total;
+        if (progress.total > 0 && progress.completed === progress.total) {
+          updated.status = "completed";
+        }
+      } catch {
+      }
+    }
+    writeState(executionJsonPath, updated);
+    if (inferred.skill === "apply" && filePath.endsWith("tasks.md")) {
+      try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const progress = parseTaskProgress(content);
+        if (updated.status === "completed") {
+          appendLog(logPath, `All tasks complete (${progress.completed}/${progress.total})`);
+        } else {
+          appendLog(logPath, `Working on task ${progress.completed + 1}/${progress.total}`);
+        }
+      } catch {
+      }
+    } else if (inferred.currentArtifact) {
+      appendLog(logPath, `Creating artifact: ${inferred.currentArtifact}`);
+    }
+  }
+}
+main().catch(() => process.exit(1));