sillyspec 3.18.4 → 3.18.5

package/.claude/skills/sillyspec-auto/SKILL.md

@@ -68,7 +68,7 @@ $ARGUMENTS
 
 ### 关键规则
 - 不要跳过任何步骤
-- 不要手动修改 progress.json
+- 不要手动修改进度数据（SQLite 数据库）
 - 不要自动 commit，只 git add
 - 不要使用 npx
 - 不要编造不存在的 CLI 子命令

package/.claude/skills/sillyspec-doctor/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sillyspec:doctor
-description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复 progress.json 与实际产出不匹配的问题。
+description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
 ---
 
 ## 前置检查

package/.claude/skills/sillyspec-execute/SKILL.md

@@ -23,6 +23,8 @@ description: 用于按 plan 执行代码实现。适合用户说"开始写代码
 - Worktree 路径在 Step 3（确认 worktree 路径）中输出，后续子代理的 cwd 必须设为该路径
 - **禁止跳过 worktree 或在主仓库直接写代码**
 - 如果 worktree 创建失败，CLI 会报错并退出，需要排查后再重试
+- **未提交的文件、dirty 状态等不影响 worktree 创建和进入，直接按 CLI 输出的 worktree 路径操作即可**
+- 不要自行检查 git 状态来判断是否可以进入 worktree，CLI 会自动处理
 
 ## 用户指令
 $ARGUMENTS

package/.claude/skills/sillyspec-resume/SKILL.md

@@ -22,15 +22,15 @@ description: 恢复工作 — 从中断处继续
 sillyspec progress show
 ```
 
-### 2. 如果有 progress.json
+### 2. 如果有活跃变更
 
-从 progress.json 中提取并展示当前状态，使用 `sillyspec progress show` 查看。
+从 `sillyspec progress show` 输出中提取并展示当前状态。
 
 然后问用户：
    1. 直接继续执行下一步
    2. 查看更多细节
 
-### 3. 如果没有 progress.json 或变更目录
+### 3. 如果没有活跃变更
 
 自动探测项目状态：
 
@@ -64,5 +64,5 @@ cat .sillyspec/ROADMAP.md 2>/dev/null
 
 ### 4. 关键原则
 
-- progress.json 是唯一的恢复数据源（存储在 `.sillyspec/changes/<name>/progress.json` 或旧版 `.sillyspec/.runtime/progress.json`）
-- progress.json 随 `sillyspec run <stage> --done` 自动更新，不需要手动保存
+- 进度数据存储在 SQLite 数据库中（`.sillyspec/.runtime/sillyspec.db`），通过 `sillyspec progress show` 命令查看
+- 进度随 `sillyspec run <stage> --done` 自动更新，不需要手动保存

package/.claude/skills/sillyspec-state/SKILL.md

@@ -1,19 +1,19 @@
 ---
 name: sillyspec:state
-description: 查看当前工作状态 — 显示 progress.json 内容
+description: 查看当前工作状态 — 显示 SillySpec 进度
 ---
 
 你现在是 SillySpec 的状态查看器。
 
 ## 流程
 
-### 1. 读取 progress.json
+### 1. 读取进度
 
 ```bash
-sillyspec run state --status 2>/dev/null
+sillyspec progress show
 ```
 
-### 2. 如果有 progress.json
+### 2. 如果有活跃变更
 
 格式化展示当前状态：
 
@@ -33,9 +33,9 @@ sillyspec run state --status 2>/dev/null
 > **阻塞项**：
 > - xxx（如无则省略）
 
-### 3. 如果没有 progress.json
+### 3. 如果没有活跃变更
 
-提示用户项目还没有开始，或 progress.json 尚未生成：
+提示用户项目还没有开始：
 
 > 📊 还没有工作记录。
 >
@@ -44,11 +44,11 @@ sillyspec run state --status 2>/dev/null
 > - 已有项目：`/sillyspec:scan`
 > - 恢复中断的工作：`/sillyspec:resume`
 >
-> progress.json 会在 `sillyspec init` 时自动创建。
+> 进度数据会在 `sillyspec init` 时自动创建到 SQLite 数据库中。
 
 ### 注意
 
 - 这是只读命令，**不修改任何文件**
 - `/sillyspec:status` 查看项目整体进度（change 文件级别）
-- `/sillyspec:state` 查看当前工作状态（progress.json 级别）
+- `/sillyspec:state` 查看当前工作状态（阶段/步骤级别）
 - 两者互补：status 看"有什么"，state 看"在做什么"

package/docs/sillyspec/file-lifecycle/storage-and-state.md

@@ -43,7 +43,7 @@ created_at: 2026-06-04 16:25:42
 | `batch_progress` | 批量任务统计 |
 | `approvals` | 平台审批状态 |
 
-`progress.js` 通过 SQL 读写这些表，并组装成兼容旧 progress JSON 的 JS 对象。当前没有看到 `progress.json` 被作为权威状态写入。
+`progress.js` 通过 SQL 读写这些表，并组装成兼容旧 progress 格式的 JS 对象。进度数据仅存储在 SQLite 数据库中，不再使用 progress.json 文件。
 
 注意：`db.js` 的 `project.schema_version` DDL 默认值是 `4`，但 `progress.js` 的 `CURRENT_VERSION` 是 `3`，并在初始化/写入时使用 `3`。文档不要把这里写成稳定的 v4 schema 事实。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.18.4",
+  "version": "3.18.5",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/packages/dashboard/server/index.js

@@ -48,12 +48,13 @@ function startProgressWatch(projectPath) {
     progressWatchers.get(projectPath).refCount++
     return
   }
-  const progressFile = join(projectPath, '.sillyspec', '.runtime', 'progress.json')
-  if (!existsSync(progressFile)) return
+  // Watch the SQLite database file for changes (replaces old progress.json watch)
+  const dbFile = join(projectPath, '.sillyspec', '.runtime', 'sillyspec.db')
+  if (!existsSync(dbFile)) return
 
   let timer = null
   try {
-    const watcher = watch(progressFile, (eventType) => {
+    const watcher = watch(dbFile, (eventType) => {
       if (timer) clearTimeout(timer)
       timer = setTimeout(() => {
         timer = null

package/packages/dashboard/server/parser.js

@@ -77,18 +77,13 @@ export function parseProjectOverview(projectPath) {
 
   // --- Last active ---
   const sillyspecDir = join(projectPath, '.sillyspec')
-  const progressPath = join(sillyspecDir, '.runtime', 'progress.json')
-  if (existsSync(progressPath)) {
+  // Progress is stored in SQLite (.sillyspec/.runtime/sillyspec.db), not progress.json
+  // Use mtime of the DB file as a fallback for lastActive
+  const dbPath = join(sillyspecDir, '.runtime', 'sillyspec.db')
+  if (existsSync(dbPath)) {
     try {
-      const progress = JSON.parse(readFileSync(progressPath, 'utf-8'))
-      if (progress.stages) {
-        for (const stageData of Object.values(progress.stages)) {
-          if (stageData.lastActive && (!result.lastActive || new Date(stageData.lastActive) > new Date(result.lastActive))) {
-            result.lastActive = stageData.lastActive
-          }
-        }
-      }
-      if (progress.lastActive) result.lastActive = progress.lastActive
+      const s = statSync(dbPath)
+      result.lastActive = s.mtime.toISOString()
     } catch {}
   }
   if (!result.lastActive) {
@@ -432,81 +427,46 @@ export function parseSillyspecDocsTree(projectPath) {
 }
 
 /**
- * Parse project state from .sillyspec directory
+ * Parse project state from .sillyspec SQLite database via CLI.
+ * Progress data is stored in SQLite (.sillyspec/.runtime/sillyspec.db),
+ * accessed through `sillyspec progress show`.
  * @param {string} projectPath - Path to the project directory
- * @returns {object} Project state with currentStage, nextStep, progress, stages, specs, lastActive
+ * @returns {object|null} Project state with currentStage, stages, lastActive
  */
 export function parseProjectState(projectPath) {
   const sillyspecDir = join(projectPath, '.sillyspec')
+  const dbPath = join(sillyspecDir, '.runtime', 'sillyspec.db')
 
-  if (!existsSync(sillyspecDir)) {
+  if (!existsSync(sillyspecDir) || !existsSync(dbPath)) {
     return null
   }
 
   let currentStage = ''
-  let nextStep = null
-  let progress = { stages: {} }
-  let stages = []
-  let specs = []
   let lastActive = null
 
-  // Read progress.json for current stage
-  const progressPath = join(sillyspecDir, '.runtime', 'progress.json')
-  if (existsSync(progressPath)) {
-    try {
-      const progressData = JSON.parse(readFileSync(progressPath, 'utf-8'))
-      progress = progressData
-      currentStage = progressData.currentStage || ''
-      stages = Object.keys(progressData.stages || {})
-
-      // Find last active
-      if (progressData.lastActive) lastActive = progressData.lastActive
-      if (progressData.stages) {
-        for (const [stageName, stageData] of Object.entries(progressData.stages)) {
-          if (stageData.lastActive || stageData.startedAt) {
-            const t = stageData.lastActive || stageData.startedAt
-            if (!lastActive || new Date(t) > new Date(lastActive)) lastActive = t
-          }
-        }
-      }
-    } catch (err) {
-      // Progress file exists but couldn't be parsed
-    }
-  }
+  // Use DB file mtime as lastActive indicator
+  try {
+    const s = statSync(dbPath)
+    lastActive = s.mtime.toISOString()
+  } catch {}
 
-  // List all spec files
-  const specsDir = join(sillyspecDir, 'specs')
-  if (existsSync(specsDir)) {
-    try {
-      const specFiles = readdirSync(specsDir)
-        .filter(f => f.endsWith('.md'))
-        .sort()
-
-      specs = specFiles.map(f => {
-        const specPath = join(specsDir, f)
-        try {
-          const content = readFileSync(specPath, 'utf-8')
-          const titleMatch = content.match(/^#\s+(.+)$/m)
-          return {
-            name: f,
-            title: titleMatch ? titleMatch[1] : f,
-            path: specPath
-          }
-        } catch {
-          return { name: f, title: f, path: specPath }
-        }
-      })
-    } catch (err) {
-      // Specs directory couldn't be read
-    }
+  // Use CLI to read current stage from SQLite
+  try {
+    const output = execSync('sillyspec progress show 2>/dev/null', {
+      cwd: projectPath, encoding: 'utf-8', timeout: 5000
+    })
+    const stageMatch = output.match(/当前阶段:\s*(\S+)/)
+    if (stageMatch) currentStage = stageMatch[1]
+  } catch {
+    // CLI unavailable or no active change
   }
 
   return {
     currentStage,
-    nextStep,
-    progress,
-    stages,
-    specs,
+    nextStep: null,
+    progress: { stages: {} },
+    stages: [],
+    specs: [],
     lastActive
   }
 }

package/src/index.js

@@ -145,6 +145,21 @@ async function main() {
     targetDir = resolve(filteredArgs[1]);
     filteredArgs.splice(1, 1);
   }
+  // ── 自动纠正 cwd ──
+  // 当 agent 在 worktree 内跑 pnpm 等工具后 shell cwd 可能被改变，
+  // 导致 sillyspec 命令找不到 .sillyspec。此函数尝试从 git root 解析。
+  function resolveEffectiveDir(baseDir) {
+    if (existsSync(join(baseDir, '.sillyspec'))) return baseDir
+    try {
+      const { execSync } = require('child_process')
+      const gitRoot = execSync('git rev-parse --show-toplevel', {
+        cwd: baseDir, encoding: 'utf8', timeout: 5000
+      }).trim()
+      if (gitRoot && existsSync(join(gitRoot, '.sillyspec'))) return gitRoot
+    } catch {}
+    return baseDir
+  }
+
   const dir = targetDir;
 
   if (command === 'init' && !existsSync(dir)) {
@@ -167,6 +182,7 @@ async function main() {
       break;
     case 'progress': {
       const pm = new ProgressManager();
+      const progDir = resolveEffectiveDir(dir);
       const subCommand = filteredArgs[1];
       const stageIdx = filteredArgs.indexOf('--stage');
       const stage = stageIdx >= 0 && filteredArgs[stageIdx + 1] ? filteredArgs[stageIdx + 1] : null;
@@ -176,18 +192,18 @@ async function main() {
 
       switch (subCommand) {
         case 'init':
-          pm.init(dir);
+          pm.init(progDir);
           break;
         case 'status':
         case 'show':
-          pm.show(dir, progChangeName);
+          pm.show(progDir, progChangeName);
           break;
         case 'check':
-          await pm.checkConsistency(dir, progChangeName);
+          await pm.checkConsistency(progDir, progChangeName);
           break;
         case 'repair': {
           const repairApply = filteredArgs.includes('--apply');
-          await pm.repairConsistency(dir, { apply: repairApply, changeName: progChangeName });
+          await pm.repairConsistency(progDir, { apply: repairApply, changeName: progChangeName });
           break;
         }
         case 'validate':
@@ -270,7 +286,7 @@ async function main() {
     }
     case 'run': {
       const { runCommand } = await import('./run.js')
-      await runCommand(filteredArgs.slice(1), dir, specDir)
+      await runCommand(filteredArgs.slice(1), resolveEffectiveDir(dir), specDir)
       break
     }
     case 'dashboard': {

package/src/stages/execute.js

@@ -165,6 +165,7 @@ const fixedPrefix = [
 - **worktree 已由 CLI 在 execute 阶段启动时自动创建，不要自行创建或跳过**
 - **后续所有子代理的 cwd 必须设为该 worktree 路径**
 - 如果 meta.json 不存在（说明创建失败），停止并报错
+- **不要自行检查 git dirty/uncommitted 状态来判断是否可以进入 worktree，CLI 已自动处理**
 
 ### 输出
 worktree 路径 + 分支名 + 模式

package/src/worktree-apply.js

@@ -214,7 +214,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false } = {}) {
   const patchFiles = hasAllowList
     ? [...allowSet].filter(f => changedFiles.includes(f))
     : changedFiles;
-  const fileArgs = patchFiles.map(f => `-- ${f}`).join(' ');
+  const fileArgs = patchFiles.length > 0 ? `-- ${patchFiles.join(' ')}` : '';
 
   // 创建临时文件
   const tmpDir = mkdtempSync(join(tmpdir(), 'sillyspec-patch-'));
@@ -236,7 +236,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false } = {}) {
 
     // tracked 文件：git diff baseHash
     if (trackedFiles.length > 0) {
-      const trackedArgs = trackedFiles.map(f => `-- ${f}`).join(' ');
+      const trackedArgs = trackedFiles.length > 0 ? `-- ${trackedFiles.join(' ')}` : '';
       patchContent += execSync(
         `git diff --binary ${diffBase} ${trackedArgs}`,
         { cwd: worktreePath, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
@@ -245,11 +245,12 @@ export function applyWorktree(changeName, { cwd, checkOnly = false } = {}) {
 
     // untracked 新文件：git add 到 index，git diff --cached，然后 reset
     if (untrackedPatchFiles.length > 0) {
-      const addArgs = untrackedPatchFiles.map(f => `-- ${f}`).join(' ');
+      const addArgs = untrackedPatchFiles.length > 0 ? `-- ${untrackedPatchFiles.join(' ')}` : '';
       git(worktreePath, `add ${addArgs}`);
       try {
+        const diffCachedArgs = untrackedPatchFiles.length > 0 ? `-- ${untrackedPatchFiles.join(' ')}` : '';
         patchContent += execSync(
-          `git diff --binary --cached ${untrackedPatchFiles.map(f => `-- ${f}`).join(' ')}`,
+          `git diff --binary --cached ${diffCachedArgs}`,
           { cwd: worktreePath, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
         );
       } finally {