sillyspec 3.9.0 → 3.10.0

package/packages/dashboard/src/composables/useLayout.js

@@ -0,0 +1,131 @@
+/**
+ * 布局管理 Composable
+ * 管理双层布局的概览/详情比例和三栏宽度
+ */
+import { reactive, ref, onMounted } from 'vue'
+
+const STORAGE_KEY = 'dashboard-layout-v2'
+
+// 默认值
+const DEFAULT_OVERVIEW_HEIGHT = 30 // 概览区域百分比
+const DEFAULT_COLUMN_WIDTHS = [33.33, 33.33, 33.33] // 三栏宽度百分比
+
+// 最小值限制
+const MIN_OVERVIEW_HEIGHT = 15
+const MAX_OVERVIEW_HEIGHT = 75
+const MIN_COLUMN_WIDTH = 10
+
+/**
+ * 布局管理 Hook
+ */
+export function useLayout() {
+  // 布局状态
+  const layout = reactive({
+    overviewHeight: DEFAULT_OVERVIEW_HEIGHT,
+    columnWidths: [...DEFAULT_COLUMN_WIDTHS]
+  })
+
+  // 拖动状态
+  const isDragging = ref(false)
+  const dragType = ref(null) // 'vertical' | 'horizontal'
+
+  /**
+   * 加载保存的布局
+   */
+  function loadLayout() {
+    try {
+      const saved = localStorage.getItem(STORAGE_KEY)
+      if (saved) {
+        const parsed = JSON.parse(saved)
+        if (parsed.overviewHeight !== undefined) {
+          layout.overviewHeight = Math.max(MIN_OVERVIEW_HEIGHT, Math.min(MAX_OVERVIEW_HEIGHT, parsed.overviewHeight))
+        }
+        if (Array.isArray(parsed.columnWidths) && parsed.columnWidths.length === 3) {
+          layout.columnWidths = parsed.columnWidths
+        }
+      }
+    } catch (e) {
+      console.error('Failed to load layout:', e)
+      // 使用默认值
+      resetLayout()
+    }
+  }
+
+  /**
+   * 保存布局到 localStorage
+   */
+  function saveLayout() {
+    try {
+      localStorage.setItem(STORAGE_KEY, JSON.stringify({
+        overviewHeight: layout.overviewHeight,
+        columnWidths: layout.columnWidths
+      }))
+    } catch (e) {
+      console.error('Failed to save layout:', e)
+    }
+  }
+
+  /**
+   * 重置布局为默认值
+   */
+  function resetLayout() {
+    layout.overviewHeight = DEFAULT_OVERVIEW_HEIGHT
+    layout.columnWidths = [...DEFAULT_COLUMN_WIDTHS]
+    saveLayout()
+  }
+
+  /**
+   * 设置概览区域高度（百分比）
+   */
+  function setOverviewHeight(percent) {
+    layout.overviewHeight = Math.max(MIN_OVERVIEW_HEIGHT, Math.min(MAX_OVERVIEW_HEIGHT, percent))
+    saveLayout()
+  }
+
+  /**
+   * 设置列宽度（索引，百分比）
+   */
+  function setColumnWidth(index, percent) {
+    if (index >= 0 && index < 3) {
+      layout.columnWidths[index] = Math.max(MIN_COLUMN_WIDTH, percent)
+      saveLayout()
+    }
+  }
+
+  /**
+   * 开始拖动
+   */
+  function startDrag(type) {
+    isDragging.value = true
+    dragType.value = type
+    document.body.classList.add('resizing')
+  }
+
+  /**
+   * 结束拖动
+   */
+  function endDrag() {
+    isDragging.value = false
+    dragType.value = null
+    document.body.classList.remove('resizing')
+    saveLayout()
+  }
+
+  // 组件挂载时加载布局
+  onMounted(() => {
+    loadLayout()
+  })
+
+  return {
+    layout,
+    isDragging,
+    dragType,
+    loadLayout,
+    saveLayout,
+    resetLayout,
+    setOverviewHeight,
+    setColumnWidth,
+    startDrag,
+    endDrag
+  }
+}

package/packages/dashboard/src/main.js

@@ -1,5 +1,8 @@
 import { createApp } from 'vue'
+import naive from 'naive-ui'
 import App from './App.vue'
 import './style.css'
 
-createApp(App).mount('#app')
+const app = createApp(App)
+app.use(naive)
+app.mount('#app')

package/packages/dashboard/src/style.css

@@ -1,20 +1,20 @@
 @import "tailwindcss";
 
 @theme {
-  --color-bg: #0A0A0B;
-  --color-primary: #FBBF24;
-  --color-primary-dim: #B45309;
-  --color-warning: #FB923C;
-  --color-danger: #EF4444;
-  --color-muted: #525252;
-  --color-surface: #141416;
-  --color-surface-2: #1C1C1F;
-  --color-border: #2A2A2D;
-  --color-border-light: #3A3A3D;
-  --color-text: #E4E4E7;
-  --color-text-secondary: #8B8B8E;
-  --color-info: #38BDF8;
-  --color-success: #34D399;
+  --color-bg: #F5F5F7;
+  --color-primary: #D97706;
+  --color-primary-dim: #92400E;
+  --color-warning: #EA580C;
+  --color-danger: #DC2626;
+  --color-muted: #6B7280;
+  --color-surface: #FFFFFF;
+  --color-surface-2: #F0F0F3;
+  --color-border: #E5E5EA;
+  --color-border-light: #D1D1D6;
+  --color-text: #1C1C1E;
+  --color-text-secondary: #636366;
+  --color-info: #2563EB;
+  --color-success: #16A34A;
 
   --font-display: 'JetBrains Mono', monospace;
   --font-body: 'DM Sans', sans-serif;
@@ -96,7 +96,7 @@
 
 /* Skeleton shimmer */
 .skeleton-shimmer {
-  background: linear-gradient(90deg, #1C1C1F 25%, #2A2A2D 50%, #1C1C1F 75%);
+  background: linear-gradient(90deg, #1A1E28 25%, #2A3040 50%, #1A1E28 75%);
   background-size: 200% 100%;
   animation: shimmer 1.5s ease-in-out infinite;
 }
@@ -112,12 +112,12 @@
 }
 
 ::-webkit-scrollbar-thumb {
-  background: #2A2A2D;
+  background: #2A3040;
   border-radius: 10px;
 }
 
 ::-webkit-scrollbar-thumb:hover {
-  background: #3A3A3D;
+  background: #3A4555;
 }
 
 * {

package/src/index.js

@@ -4,11 +4,12 @@
  * SillySpec CLI — 安装工具
  *
  * 只负责两件事：init（安装命令模板）和 setup（安装 MCP 工具）。
- * 状态管理由 AI 直接读文件（STATE.md）完成，不需要 CLI。
+ * 状态管理通过 progress.json 完成，使用 `sillyspec progress` 命令。
  */
-import { existsSync } from 'fs';
-import { resolve } from 'path';
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { join, resolve } from 'path';
 import { cmdInit, getVersion } from './init.js';
+import { ProgressManager } from './progress.js';
 
 // ── CLI 入口 ──
 
@@ -19,15 +20,36 @@ SillySpec CLI — 规范驱动开发工具包
 用法:
   sillyspec init               初始化（零交互，自动检测工具）
     [--tool <name>]            只安装指定工具
-    [--workspace]              工作区模式
     [--interactive]            交互式引导
     [--dir <path>]             指定目录
+
   sillyspec setup [--list]     安装推荐 MCP 工具
     [--list]                   查看已安装状态
-  sillyspec step <phase>         步骤调度器
-    [--next] [--status] [--list] [--jump <n>]
-    [--sessions] [--clean]
-    [--session <id>] [--json]
+
+  sillyspec run <stage>        执行阶段步骤（核心命令）
+    --done --output "..."      完成当前步骤
+    --skip                     跳过可选步骤
+    --status                   查看阶段进度
+    --reset                    重置阶段
+    --change <name>            设置当前变更名
+    auto                       连续推进 brainstorm→plan→execute→verify
+
+  可选阶段:
+    scan, brainstorm, plan, execute, verify, archive
+    quick, explore, status, doctor
+
+  sillyspec progress <cmd>     进度记录（轻量，不强制顺序）
+    init                       初始化 progress.json
+    show                       查看当前进度
+    set-stage <stage>          设置当前阶段
+    add-step <stage> <name>    添加步骤
+    update-step <s> <n> --status <st> [--output <t>]
+    complete-stage <stage>     标记阶段完成
+    validate                   校验并修复
+    reset [--stage X]          重置进度
+
+  sillyspec docs migrate       迁移旧文档到统一结构
+
   sillyspec dashboard          启动 Dashboard Web UI
     [--port <number>]          指定端口（默认 3456）
     [--no-open]                不自动打开浏览器
@@ -38,11 +60,12 @@ SillySpec CLI — 规范驱动开发工具包
 
 示例:
   sillyspec init
-  sillyspec init --tool claude
-  sillyspec init --workspace
-  sillyspec setup
+  sillyspec run scan
+  sillyspec run brainstorm
+  sillyspec run quick
+  sillyspec run explore
+  sillyspec run brainstorm --done --output "需求已澄清"
   sillyspec setup --list
-  sillyspec dashboard
   sillyspec dashboard --port 8080 --no-open
 `);
 }
@@ -64,7 +87,6 @@ async function main() {
   let json = false;
   let targetDir = process.cwd();
   let tool = null;
-  let workspace = false;
   let interactive = false;
   const filteredArgs = [];
 
@@ -77,8 +99,6 @@ async function main() {
     } else if (args[i] === '--tool' && args[i + 1]) {
       tool = args[i + 1];
       i++;
-    } else if (args[i] === '--workspace' || args[i] === '-w') {
-      workspace = true;
     } else if (args[i] === '--interactive' || args[i] === '-i') {
       interactive = true;
     } else if (args[i] === '--list' || args[i] === '-l') {
@@ -89,8 +109,18 @@ async function main() {
   }
 
   const command = filteredArgs[0];
+  // 支持 sillyspec init /path/to/project 语法：如果第二个参数看起来像路径，当作 targetDir
+  if (command === 'init' && filteredArgs[1] && !filteredArgs[1].startsWith('-')) {
+    targetDir = resolve(filteredArgs[1]);
+    filteredArgs.splice(1, 1);
+  }
   const dir = targetDir;
 
+  if (command === 'init' && !existsSync(dir)) {
+    const { mkdirSync } = await import('fs');
+    mkdirSync(dir, { recursive: true });
+  }
+
   if (!existsSync(dir)) {
     console.error(`❌ 目录不存在: ${dir}`);
     process.exit(1);
@@ -98,21 +128,110 @@ async function main() {
 
   switch (command) {
     case 'init':
-      await cmdInit(dir, { tool, workspace, interactive });
+      await cmdInit(dir, { tool, interactive });
       break;
     case 'setup':
       const setupList = filteredArgs.includes('--list') || filteredArgs.includes('-l');
       await (await import('./setup.js')).cmdSetup(dir, { json, list: setupList });
       break;
-    case 'step': {
-      const stepArgs = filteredArgs.slice(1);
-      if (json) stepArgs.push('--json');
-      await (await import('./step.js')).cmdStep(dir, stepArgs);
+    case 'progress': {
+      const pm = new ProgressManager();
+      const subCommand = filteredArgs[1];
+      const stageIdx = filteredArgs.indexOf('--stage');
+      const stage = stageIdx >= 0 && filteredArgs[stageIdx + 1] ? filteredArgs[stageIdx + 1] : null;
+
+      switch (subCommand) {
+        case 'init':
+          pm.init(dir);
+          break;
+        case 'status':
+        case 'show':
+          pm.show(dir);
+          break;
+        case 'validate':
+          await pm.validate(dir);
+          break;
+        case 'reset':
+          pm.reset(dir, stage);
+          break;
+        case 'set-stage': {
+          const setStageName = filteredArgs[2];
+          if (!setStageName) { console.log('❌ 用法: sillyspec progress set-stage <stage>'); break; }
+          pm.setStage(dir, setStageName);
+          break;
+        }
+        case 'add-step': {
+          const addStepStage = filteredArgs[2];
+          const addStepName = filteredArgs[3];
+          if (!addStepStage || !addStepName) { console.log('❌ 用法: sillyspec progress add-step <stage> <step-name>'); break; }
+          pm.addStep(dir, addStepStage, addStepName);
+          break;
+        }
+        case 'update-step': {
+          const updStepStage = filteredArgs[2];
+          const updStepName = filteredArgs[3];
+          if (!updStepStage || !updStepName) { console.log('❌ 用法: sillyspec progress update-step <stage> <step-name> --status <status> [--output <text>]'); break; }
+          // Parse --status and --output from args
+          let updStatus = null, updOutput = undefined;
+          for (let ai = 0; ai < args.length; ai++) {
+            if (args[ai] === '--status' && args[ai + 1]) { updStatus = args[ai + 1]; ai++; }
+            if (args[ai] === '--output' && args[ai + 1]) { updOutput = args[ai + 1]; ai++; }
+          }
+          pm.updateStep(dir, updStepStage, updStepName, { status: updStatus, output: updOutput });
+          break;
+        }
+        case 'complete-stage': {
+          const compStageName = filteredArgs[2];
+          if (!compStageName) { console.log('❌ 用法: sillyspec progress complete-stage <stage>'); break; }
+          pm.completeStage(dir, compStageName);
+          break;
+        }
+        case 'batch': {
+          if (filteredArgs.includes('--status')) {
+            const bp = pm.readBatchProgress(dir);
+            if (!bp) { console.log('📭 无批量进度数据'); break; }
+            const line = pm._renderBatchProgress(bp);
+            console.log(line || '📭 无批量进度数据');
+            console.log(JSON.stringify(bp, null, 2));
+          } else {
+            let batchData = {};
+            const a = args;
+            for (let i = 0; i < a.length; i++) {
+              if (a[i] === '--total' && a[i + 1]) { batchData.total = parseInt(a[i + 1]); i++; }
+              if (a[i] === '--completed' && a[i + 1]) { batchData.completed = parseInt(a[i + 1]); i++; }
+              if (a[i] === '--failed' && a[i + 1]) { batchData.failed = parseInt(a[i + 1]); i++; }
+              if (a[i] === '--skipped' && a[i + 1]) { batchData.skipped = parseInt(a[i + 1]); i++; }
+            }
+            if (Object.keys(batchData).length === 0) {
+              console.log('用法: sillyspec progress batch --total 100 --completed 73');
+              console.log('     sillyspec progress batch --status');
+              break;
+            }
+            pm.updateBatchProgress(dir, batchData);
+            console.log('✅ 批量进度已更新');
+          }
+          break;
+        }
+        default:
+          console.log('用法: sillyspec progress <init|show|validate|reset|set-stage|add-step|update-step|complete-stage>');
+      }
       break;
     }
-    case 'progress':
-      console.log('⚠️  阶段控制功能已移除，各阶段独立运行。');
+    case 'docs': {
+      const docsSubCmd = filteredArgs[1];
+      if (docsSubCmd === 'migrate') {
+        const { migrateDocs } = await import('./migrate.js');
+        migrateDocs(dir);
+      } else {
+        console.log('用法: sillyspec docs migrate');
+      }
       break;
+    }
+    case 'run': {
+      const { runCommand } = await import('./run.js')
+      await runCommand(filteredArgs.slice(1), dir)
+      break
+    }
     case 'dashboard': {
       // Parse dashboard options
       let port = 3456;