sillyspec 3.11.11 → 3.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.11.11",
+  "version": "3.12.1",
   "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/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/'];