sillyspec 3.11.10 → 3.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.11.10",
+  "version": "3.12.0",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",
@@ -29,6 +29,7 @@
     "chokidar": "^4.0",
     "open": "^10.1",
     "ora": "^9.3.0",
+    "sql.js": "^1.14.1",
     "ws": "^8.18"
   }
 }

package/src/db.js

@@ -0,0 +1,168 @@
+import initSqlJs from 'sql.js';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname } from 'path';
+
+export class DB {
+  constructor(dbPath) {
+    this.dbPath = dbPath;
+    this.db = null;
+  }
+
+  async init() {
+    // 1. 确保父目录存在
+    const dir = dirname(this.dbPath);
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
+    // 2. 初始化 sql.js
+    const SQL = await initSqlJs();
+
+    // 3. 加载已有数据库或创建新库
+    if (existsSync(this.dbPath)) {
+      const buf = readFileSync(this.dbPath);
+      this.db = new SQL.Database(buf);
+    } else {
+      this.db = new SQL.Database();
+    }
+
+    // 4. 设置 PRAGMA
+    this.db.run('PRAGMA journal_mode = WAL');
+    this.db.run('PRAGMA busy_timeout = 5000');
+    this.db.run('PRAGMA foreign_keys = ON');
+    this.db.run('PRAGMA synchronous = NORMAL');
+
+    // 5. 创建表结构
+    this._createSchema();
+
+    // 6. 保存到磁盘
+    this._save();
+  }
+
+  close() {
+    if (this.db) {
+      this._save();
+      this.db.close();
+      this.db = null;
+    }
+  }
+
+  transaction(fn) {
+    if (!this.db) throw new Error('DB not initialized');
+    this.db.run('BEGIN');
+    try {
+      const result = fn(this.db);
+      this.db.run('COMMIT');
+      this._save();
+      return result;
+    } catch (err) {
+      this.db.run('ROLLBACK');
+      throw err;
+    }
+  }
+
+  /** 获取底层 db 对象（供 progress.js 直接使用） */
+  getDb() {
+    return this.db;
+  }
+
+  /** 将内存中的数据库持久化到磁盘 */
+  _save() {
+    if (!this.db) return;
+    const data = this.db.export();
+    const buffer = Buffer.from(data);
+    writeFileSync(this.dbPath, buffer);
+    // sql.js 的 export() 会重置 PRAGMA 状态，需要重新设置
+    this.db.run('PRAGMA journal_mode = WAL');
+    this.db.run('PRAGMA busy_timeout = 5000');
+    this.db.run('PRAGMA foreign_keys = ON');
+    this.db.run('PRAGMA synchronous = NORMAL');
+  }
+
+  _createSchema() {
+    // project 表
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS project (
+        id INTEGER PRIMARY KEY DEFAULT 1,
+        name TEXT NOT NULL,
+        schema_version INTEGER DEFAULT 4,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      )
+    `);
+
+    // changes 表
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS changes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT UNIQUE NOT NULL,
+        current_stage TEXT DEFAULT 'scan',
+        status TEXT DEFAULT 'active',
+        no_worktree INTEGER DEFAULT 0,
+        created_at TEXT NOT NULL,
+        last_active TEXT NOT NULL,
+        platform_change_id INTEGER,
+        platform_workspace_id INTEGER,
+        platform_last_sync TEXT,
+        platform_sync_enabled INTEGER DEFAULT 0
+      )
+    `);
+
+    // stages 表
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS stages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        change_id INTEGER NOT NULL REFERENCES changes(id) ON DELETE CASCADE,
+        stage TEXT NOT NULL,
+        status TEXT DEFAULT 'pending',
+        started_at TEXT,
+        completed_at TEXT,
+        UNIQUE(change_id, stage)
+      )
+    `);
+
+    // steps 表
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS steps (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        stage_id INTEGER NOT NULL REFERENCES stages(id) ON DELETE CASCADE,
+        name TEXT NOT NULL,
+        status TEXT DEFAULT 'pending',
+        output TEXT,
+        completed_at TEXT,
+        ordering INTEGER NOT NULL DEFAULT 0
+      )
+    `);
+
+    // batch_progress 表
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS batch_progress (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        change_id INTEGER NOT NULL REFERENCES changes(id) ON DELETE CASCADE,
+        total INTEGER DEFAULT 0,
+        completed INTEGER DEFAULT 0,
+        failed INTEGER DEFAULT 0,
+        skipped INTEGER DEFAULT 0,
+        UNIQUE(change_id)
+      )
+    `);
+
+    // approvals 表
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS approvals (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        change_id INTEGER NOT NULL REFERENCES changes(id) ON DELETE CASCADE,
+        status TEXT DEFAULT 'not_required',
+        requested_at TEXT,
+        approved_by TEXT,
+        approved_at TEXT,
+        rejection_reason TEXT,
+        UNIQUE(change_id)
+      )
+    `);
+
+    // 索引
+    this.db.run('CREATE INDEX IF NOT EXISTS idx_changes_current_stage ON changes(current_stage)');
+    this.db.run('CREATE INDEX IF NOT EXISTS idx_changes_status ON changes(status)');
+    this.db.run('CREATE INDEX IF NOT EXISTS idx_stages_change ON stages(change_id)');
+    this.db.run('CREATE INDEX IF NOT EXISTS idx_steps_stage ON steps(stage_id)');
+  }
+}

package/src/hooks/worktree-guard.js

@@ -3,6 +3,10 @@
  *
  * 三重门禁：stageGate × locationGate × fileGate
  * 纯判断模块，不做实际的 hook 注入。
+ *
+ * P0 优化：
+ * - 阶段检测 fallback：gate-status.json → progress.json currentStage
+ * - 拦截提示针对每个阶段给出具体修复建议
  */
 
 import { existsSync, readFileSync } from 'fs'
@@ -39,6 +43,41 @@ const DANGER_STASH_ACTIONS = new Set(['drop', 'clear', 'pop'])
 /** 危险命令前缀 */
 const DANGER_PREFIXES = ['sudo', 'rm -rf', 'rm -r', 'rmdir']
 
+// ── 阶段 → 拦截提示映射 ──
+
+const STAGE_HINTS = {
+  '(none)': [
+    '没有检测到活跃的 SillySpec 流程。',
+    '你需要先启动一个任务流程才能修改源码：',
+    '',
+    '  小改动（≤3 文件）：sillyspec run quick "任务描述"',
+    '  大改动（>3 文件）：sillyspec run brainstorm → plan → execute',
+    '  全自动模式：    sillyspec run auto "任务描述"',
+  ],
+  'brainstorm': [
+    '当前在 brainstorm（需求分析）阶段，这个阶段只写文档，不写代码。',
+    '完成 brainstorm 后，流程会自动推进到 plan → execute。',
+    'execute 阶段才允许写代码。',
+  ],
+  'plan': [
+    '当前在 plan（计划制定）阶段，这个阶段只写计划文档和任务蓝图，不写代码。',
+    '完成 plan 后，运行 sillyspec run execute 进入执行阶段。',
+  ],
+  'verify': [
+    '当前在 verify（验证）阶段，只做代码审查和测试验证，不修改源码。',
+    '如需修改，请先回到 execute 阶段或使用 quick 模式：',
+    '  sillyspec run quick "修改描述"',
+  ],
+  'archive': [
+    '当前在 archive（归档）阶段，不修改源码。',
+    '如需修改，请开启新变更：sillyspec run quick "修改描述"',
+  ],
+  'explore': [
+    '当前在 explore（探索）阶段，只读不写。',
+    '确认方案后使用：sillyspec run brainstorm 或 sillyspec run quick',
+  ],
+}
+
 // ── 辅助函数 ──
 
 function resolveWorktreeDir(cwd) {
@@ -60,6 +99,46 @@ function readGateStatus(cwd) {
   }
 }
 
+/**
+ * 从 progress.json fallback 读取 currentStage
+ * 优先级：gate-status.json > 全局 progress.json > 变更级 progress.json
+ * @param {string} cwd
+ * @returns {string|null} 阶段名，null 表示无法确定
+ */
+function readCurrentStage(cwd) {
+  // 1. gate-status.json（权威来源）
+  const gateStatus = readGateStatus(cwd)
+  if (gateStatus && gateStatus.stage) return gateStatus.stage
+
+  // 2. 全局 progress.json
+  const globalProgress = path.join(cwd, '.sillyspec', '.runtime', 'progress.json')
+  if (existsSync(globalProgress)) {
+    try {
+      const data = JSON.parse(readFileSync(globalProgress, 'utf8'))
+      if (data.currentStage) return data.currentStage
+    } catch { /* skip */ }
+  }
+
+  // 3. 变更级 progress.json（从 global.json 找到活跃变更）
+  const globalFile = path.join(cwd, '.sillyspec', '.runtime', 'global.json')
+  if (existsSync(globalFile)) {
+    try {
+      const global = JSON.parse(readFileSync(globalFile, 'utf8'))
+      const changesDir = path.join(cwd, '.sillyspec', 'changes')
+      for (const cn of (global.activeChanges || [])) {
+        const pp = path.join(changesDir, cn, 'progress.json')
+        if (!existsSync(pp)) continue
+        try {
+          const data = JSON.parse(readFileSync(pp, 'utf8'))
+          if (data.currentStage) return data.currentStage
+        } catch { /* skip */ }
+      }
+    } catch { /* skip */ }
+  }
+
+  return null
+}
+
 /**
  * 检查当前变更是否处于 noWorktree 模式
  * @param {string} cwd
@@ -153,7 +232,6 @@ function loadLocalConfig(cwd) {
   for (const p of candidates) {
     if (!existsSync(p)) continue
     try {
-      // 简单 YAML 解析（只处理顶层键值对和简单数组）
       const content = readFileSync(p, 'utf8')
       return parseSimpleYaml(content)
     } catch {
@@ -327,6 +405,16 @@ function matchDangerBlacklist(command) {
   return parts.some(p => isSingleCommandDangerous(p))
 }
 
+/**
+ * 构建阶段拦截提示
+ * @param {string} stage
+ * @returns {string}
+ */
+function buildStageHint(stage) {
+  const hint = STAGE_HINTS[stage] || STAGE_HINTS['(none)']
+  return hint.join('\n')
+}
+
 // ── 公共接口 ──
 
 /**
@@ -336,6 +424,10 @@ function matchDangerBlacklist(command) {
  * - noWorktree 模式下，execute/quick 阶段不允许源码写入（没有隔离环境）
  * - 除非同时设置 SILLYSPEC_DISABLE_HOOKS=1
  *
+ * P0 优化：
+ * - 使用 readCurrentStage() fallback 读取阶段（gate-status → progress）
+ * - 拦截提示按阶段给出具体修复建议
+ *
  * @param {string} filePath - 目标文件绝对路径
  * @param {string} cwd - 当前工作目录
  * @returns {{ blocked: boolean, reason?: string }}
@@ -348,21 +440,14 @@ export function shouldBlockWrite(filePath, cwd) {
   // 1. 文件门禁：文档类/配置类始终放行
   if (matchFileWhitelist(absPath)) return { blocked: false }
 
-  // 2. 阶段门禁
+  // 2. 阶段门禁（使用 fallback 读取）
   const effectiveCwd = cwd || process.cwd()
-  const gateStatus = readGateStatus(effectiveCwd)
-  if (!gateStatus || !ALLOWED_STAGES.includes(gateStatus.stage)) {
-    const stage = gateStatus?.stage || '(none)'
+  const stage = readCurrentStage(effectiveCwd) || '(none)'
+
+  if (!ALLOWED_STAGES.includes(stage)) {
     return {
       blocked: true,
-      reason: [
-        `当前阶段 "${stage}" 不允许修改源码。`,
-        `源码修改只能在 execute 或 quick 阶段进行。`,
-        '请先完成文档规划流程：',
-        '  - 小改动：运行 sillyspec run quick',
-        '  - 大改动：运行 sillyspec run brainstorm → plan → execute',
-        '  - 或使用 sillyspec run auto 连续推进全流程',
-      ].join('\n')
+      reason: buildStageHint(stage)
     }
   }
 
@@ -385,8 +470,14 @@ export function shouldBlockWrite(filePath, cwd) {
     blocked: true,
     reason: [
       '源码修改只能在 worktree 隔离环境中进行。',
-      'execute/quick 阶段会自动创建 worktree。',
-      '如果你正在 execute 阶段，请确认 worktree 已创建：sillyspec worktree list',
+      '',
+      '你可能需要：',
+      '  1. 确认 worktree 已创建：sillyspec worktree list',
+      '  2. 如未创建，先创建：sillyspec worktree create <变更名>',
+      '  3. 在 worktree 目录中工作（子代理的 cwd 设为 worktree 路径）',
+      '',
+      '如果你在 execute 阶段，通常会自动创建 worktree。',
+      '检查是否跳过了 "创建 worktree" 步骤。',
     ].join('\n')
   }
 }
@@ -405,25 +496,18 @@ export function shouldBlockBash(command, cwd) {
   // cwd 在 worktree 内 → 全部放行
   if (isInsideWorktree(effectiveCwd)) return { blocked: false }
 
-  // 阶段门禁
-  const gateStatus = readGateStatus(effectiveCwd)
-  const stageOk = gateStatus && ALLOWED_STAGES.includes(gateStatus.stage)
+  // 阶段门禁（使用 fallback 读取）
+  const stage = readCurrentStage(effectiveCwd) || '(none)'
+  const stageOk = ALLOWED_STAGES.includes(stage)
 
   if (!stageOk) {
     // 非 execute/quick 阶段，只允许只读白名单
     const localConfig = loadLocalConfig(effectiveCwd)
     const extraReadonly = localConfig.worktreeHook?.readonlyCommands || localConfig['worktree-hook']?.readonlyCommands || []
     if (matchReadonlyWhitelist(command, extraReadonly)) return { blocked: false }
-    const stage = gateStatus?.stage || '(none)'
     return {
       blocked: true,
-      reason: [
-        `当前阶段 "${stage}" 不允许执行此命令。`,
-        '源码修改只能在 execute 或 quick 阶段进行。',
-        '请先完成文档规划流程：',
-        '  - 小改动：运行 sillyspec run quick',
-        '  - 大改动：运行 sillyspec run brainstorm → plan → execute',
-      ].join('\n')
+      reason: buildStageHint(stage)
     }
   }
 

package/src/index.js

@@ -35,7 +35,7 @@ SillySpec CLI — 规范驱动开发工具包
     auto                       连续推进 brainstorm→plan→execute→verify
 
   可选阶段:
-    scan, brainstorm, plan, execute, verify, archive
+    scan, brainstorm, propose, plan, execute, verify, archive
     quick, explore, status, doctor
 
   sillyspec progress <cmd>     进度记录（轻量，不强制顺序）
@@ -50,6 +50,15 @@ SillySpec CLI — 规范驱动开发工具包
 
   sillyspec docs migrate       迁移旧文档到统一结构
 
+  sillyspec platform <cmd>      SillyHub 平台同步
+    connect <url> [--token <t>]  连接平台
+    disconnect                    断开连接
+    sync [--change <name>]        同步变更状态
+    sync-docs [--change <name>]   同步四件套文档
+    status                        查看同步状态
+    approve <change-name>         审批变更
+    reject <change-name> [--reason <r>]  拒绝变更
+
   sillyspec dashboard          启动 Dashboard Web UI
     [--port <number>]          指定端口（默认 3456）
     [--no-open]                不自动打开浏览器
@@ -136,7 +145,6 @@ async function main() {
       break;
     case 'progress': {
       const pm = new ProgressManager();
-      pm._migrateIfNeeded(dir);
       const subCommand = filteredArgs[1];
       const stageIdx = filteredArgs.indexOf('--stage');
       const stage = stageIdx >= 0 && filteredArgs[stageIdx + 1] ? filteredArgs[stageIdx + 1] : null;
@@ -372,6 +380,94 @@ SillySpec worktree — git worktree 隔离管理
       }
       break;
     }
+    case 'platform': {
+      const platformSub = filteredArgs[1];
+      const platformArgs = filteredArgs.slice(2);
+
+      if (!platformSub || platformSub === 'help' || platformSub === '--help' || platformSub === '-h') {
+        console.log(`
+SillySpec platform — SillyHub 平台同步
+
+用法:
+  sillyspec platform connect <url> [--token <token>]
+  sillyspec platform disconnect
+  sillyspec platform sync [--change <name>]
+  sillyspec platform sync-docs [--change <name>]
+  sillyspec platform status
+  sillyspec platform approve <change-name>
+  sillyspec platform reject <change-name> [--reason <reason>]
+`);
+        break;
+      }
+
+      let syncModule;
+      try {
+        syncModule = await import('./sync.js');
+      } catch {
+        console.error('❌ 平台同步功能不可用（sync.js 未实现）');
+        process.exit(1);
+      }
+
+      switch (platformSub) {
+        case 'connect': {
+          const url = platformArgs[0];
+          if (!url) {
+            console.error('❌ 用法: sillyspec platform connect <url> [--token <token>]');
+            process.exit(1);
+          }
+          const tokenIdx = args.indexOf('--token');
+          const token = tokenIdx >= 0 && args[tokenIdx + 1] ? args[tokenIdx + 1] : undefined;
+          if (!token) {
+            console.error('⚠️ 未提供 --token，将使用交互式输入（TODO: task-11）');
+          }
+          await syncModule.connect(url, token, dir);
+          break;
+        }
+        case 'disconnect':
+          await syncModule.disconnect(dir);
+          break;
+        case 'sync': {
+          const syncChangeIdx = args.indexOf('--change');
+          const syncChangeName = syncChangeIdx >= 0 && args[syncChangeIdx + 1] ? args[syncChangeIdx + 1] : null;
+          await syncModule.sync(syncChangeName, dir);
+          break;
+        }
+        case 'sync-docs': {
+          const syncDocsChangeIdx = args.indexOf('--change');
+          const syncDocsChangeName = syncDocsChangeIdx >= 0 && args[syncDocsChangeIdx + 1] ? args[syncDocsChangeIdx + 1] : null;
+          await syncModule.syncDocuments(syncDocsChangeName, dir);
+          break;
+        }
+        case 'status':
+          await syncModule.status(dir);
+          break;
+        case 'approve': {
+          const approveName = platformArgs[0];
+          if (!approveName) {
+            console.error('❌ 用法: sillyspec platform approve <change-name>');
+            process.exit(1);
+          }
+          await syncModule.approve(approveName, dir);
+          break;
+        }
+        case 'reject': {
+          const rejectName = platformArgs[0];
+          if (!rejectName) {
+            console.error('❌ 用法: sillyspec platform reject <change-name> [--reason <reason>]');
+            process.exit(1);
+          }
+          const reasonIdx = args.indexOf('--reason');
+          const reason = reasonIdx >= 0 && args[reasonIdx + 1] ? args[reasonIdx + 1] : undefined;
+          await syncModule.reject(rejectName, reason, dir);
+          break;
+        }
+        default:
+          console.error(`❌ 未知子命令: platform ${platformSub}`);
+          console.log('   运行 sillyspec platform --help 查看帮助');
+          process.exit(1);
+      }
+      break;
+    }
     default:
       console.error(`❌ 未知命令: ${command}`);
       printUsage();

package/src/init.js

@@ -147,15 +147,9 @@ async function doInstall(projectDir, tools, subprojects = []) {
     mkdirSync(join(runtimeDir, sub), { recursive: true });
   }
 
-  // 创建全局状态文件
+  // 初始化 SQLite 数据库（创建 DB + 建表 + 写入 project 行 + user-inputs.md）
   const pm = new ProgressManager();
-  pm.init(projectDir);
-
-  // 创建初始 user-inputs.md
-  const inputsPath = join(runtimeDir, 'user-inputs.md');
-  if (!existsSync(inputsPath)) {
-    writeFileSync(inputsPath, '# 用户输入记录\n\n> 每步完成时由 AI 自动追加，记录用户所有原话。\n\n');
-  }
+  await pm.init(projectDir);
 
   const gitignorePath = join(projectDir, '.gitignore');
   const ignoreRules = ['.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/'];