sillyspec 3.12.5 → 3.12.6

package/package.json

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

package/src/hooks/worktree-guard.js

@@ -14,7 +14,7 @@ import path from 'path'
 
 // ── 常量 ──
 
-const ALLOWED_STAGES = ['execute', 'quick']
+const WORKTREE_STAGES = ['execute'] // 这些阶段必须在 worktree 里
 
 const WORKTREE_SEGMENT = '.sillyspec/.runtime/worktrees/'
 
@@ -410,14 +410,17 @@ export function shouldBlockWrite(filePath, cwd) {
   const effectiveCwd = cwd || process.cwd()
   const stage = readCurrentStage(effectiveCwd) || '(none)'
 
-  if (!ALLOWED_STAGES.includes(stage)) {
+  if (!['execute', 'quick'].includes(stage)) {
     return {
       blocked: true,
       reason: buildStageHint(stage)
     }
   }
 
-  // 3. 位置门禁
+  // quick 阶段直接放行（不要求 worktree）
+  if (stage === 'quick') return { blocked: false }
+
+  // execute 阶段：位置门禁
   if (isInsideWorktree(absPath)) return { blocked: false }
 
   // noWorktree 模式：无隔离环境，禁止源码写入（降级到更严格）
@@ -464,9 +467,8 @@ export function shouldBlockBash(command, cwd) {
 
   // 阶段门禁（使用 fallback 读取）
   const stage = readCurrentStage(effectiveCwd) || '(none)'
-  const stageOk = ALLOWED_STAGES.includes(stage)
 
-  if (!stageOk) {
+  if (!['execute', 'quick'].includes(stage)) {
     // 非 execute/quick 阶段，只允许只读白名单
     const localConfig = loadLocalConfig(effectiveCwd)
     const extraReadonly = localConfig.worktreeHook?.readonlyCommands || localConfig['worktree-hook']?.readonlyCommands || []
@@ -477,7 +479,16 @@ export function shouldBlockBash(command, cwd) {
     }
   }
 
-  // execute/quick 阶段 + 主工作区
+  // quick 阶段直接放行（不要求 worktree）
+  if (stage === 'quick') {
+    // 危险黑名单仍然拦截
+    if (matchDangerBlacklist(command)) {
+      return { blocked: true, reason: `dangerous command blocked: ${command.trim()}` }
+    }
+    return { blocked: false }
+  }
+
+  // execute 阶段 + 主工作区
   const localConfig = loadLocalConfig(effectiveCwd)
   const extraReadonly = localConfig.worktreeHook?.readonlyCommands || localConfig['worktree-hook']?.readonlyCommands || []
 

package/src/run.js

@@ -213,6 +213,10 @@ async function outputStep(stageName, stepIndex, steps, cwd, changeName, dbProjec
   promptText = promptText.replace(/<now-datetime>/g, nowDatetime)
   promptText = promptText.replace(/<now-timestamp>/g, nowTimestamp)
   promptText = promptText.replace(/<now-date>/g, nowDate)
+  // 替换 <change-name> 占位符
+  if (changeName && promptText.includes('<change-name>')) {
+    promptText = promptText.replace(/<change-name>/g, changeName)
+  }
   console.log(promptText)
   console.log(`\n### ⚠️ 铁律`)
   console.log('- **文档是核心资产，代码是文档的产物。** 没有文档就没有代码——文档是 AI 的记忆，是团队协作的基础，是后续维护的唯一依据。任何代码产出必须先有对应的设计/规范文档支撑。')

package/src/stages/quick.js

@@ -40,33 +40,12 @@ export const definition = {
       outputHint: '任务理解',
       optional: false
     },
-    {
-      name: '创建 worktree',
-      prompt: `为本次 quick 任务创建隔离的 git worktree。
-
-### 操作
-1. 确定变更名（change name）：
-   - 如携带 \`--change <变更名>\`，使用该变更名
-   - 否则，生成临时变更名：\`quick-<now-timestamp>\`
-2. 运行 \`sillyspec worktree create <变更名>\`
-3. 记录输出的 worktree 路径（后续步骤需要使用）
-4. 如果创建失败 → 报错并停止（不要在无隔离状态下继续）
-
-### 输出
-worktree 路径 + 变更名 + 分支名`,
-      outputHint: 'worktree 路径',
-      optional: false
-    },
     {
       name: '实现并验证',
-      prompt: `实现任务。
-
-### 工作目录
-你必须在上一步记录的 worktree 路径中工作。
-不要在主工作区修改源码文件。所有代码变更只在 worktree 中进行。
+      prompt: `直接在主工作区实现任务。
 
 ### 操作
-1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在（在 worktree 中读取）
+1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在
 2. 写代码完成任务
 3. 如涉及逻辑变更，建议写单元测试验证（不强制，纯配置/文档/小改动可跳过）
 4. **不要编译！** 除非用户明确要求或改动量很大
@@ -81,24 +60,6 @@ worktree 路径 + 变更名 + 分支名`,
       outputHint: '实现摘要',
       optional: false
     },
-    {
-      name: 'apply 并 cleanup',
-      prompt: `将 worktree 中的变更应用到主工作区并清理。
-
-### 操作
-1. 运行 \`sillyspec worktree apply --check-only <变更名>\`
-2. 展示 diff 摘要（文件列表 + 变更统计）
-3. 展示检查结果（是否通过文件清单校验）
-4. 用户确认后运行 \`sillyspec worktree apply <变更名>\`
-5. apply 成功 → 自动 cleanup，进入下一步
-6. apply 失败 → 展示错误详情，用户选择重试或手动处理
-7. 如果用户不想 apply → 运行 \`sillyspec worktree cleanup <变更名>\` 丢弃变更
-
-### 输出
-apply 结果 + 下一步建议`,
-      outputHint: 'apply 结果',
-      optional: false
-    },
     {
       name: '暂存和更新记录',
       prompt: `Git 暂存并更新任务记录。

package/src/stages/scan.js

@@ -134,7 +134,7 @@ export const definition = {
 
 ### 每个子代理的共同要求
 - **上下文注入**：主 agent 在启动子代理前，必须将以下信息拼入子代理 prompt：
-  - 项目名（<project>）
+  - 项目名（直接用本次 prompt 中的实际项目名）
   - 断点续扫步骤列出的缺失文档列表（哪些要生成、哪些跳过）
   - 环境探测结果摘要（构建工具、语言框架、关键依赖）
   - _env-detect.md 内容（如存在，直接贴入）

package/src/worktree.js

@@ -106,7 +106,13 @@ export class WorktreeManager {
 
     // 1. 检查 worktree 是否已存在
     if (existsSync(worktreePath)) {
-      throw new Error(`worktree already exists: ${name}. Run cleanup first.`);
+      // 目录在但 meta.json 不存在（幽灵状态），自动清理
+      if (!this.getMeta(name)) {
+        console.log(`⚠️  检测到幽灵 worktree 目录（无 meta.json），自动清理...`);
+        try { rmSync(worktreePath, { recursive: true, force: true }); } catch {}
+      } else {
+        throw new Error(`worktree already exists: ${name}. Run cleanup first.`);
+      }
     }
 
     // 2. 检查分支是否已存在
@@ -223,26 +229,27 @@ export class WorktreeManager {
   cleanup(changeName) {
     const name = validateChangeName(changeName);
     const meta = this.getMeta(name);
+    const worktreePath = this.getWorktreePath(name);
 
-    if (!meta) {
-      throw new Error(`worktree not found: ${name}。meta.json 不存在，可能已被清理或从未创建。`);
+    if (!meta && !existsSync(worktreePath)) {
+      throw new Error(`worktree not found: ${name}。meta.json 不存在，目录也不存在，可能已被清理或从未创建。`);
     }
 
-    const worktreePath = meta.worktreePath || this.getWorktreePath(name);
-    const branch = meta.branch || BRANCH_PREFIX + name;
-
-    // 2. 移除 git worktree
+    // 1. 尝试 git worktree remove
     try {
       git(this.cwd, `worktree remove ${worktreePath} --force`);
     } catch {
       // git worktree remove 失败，尝试直接删除目录
-      try {
-        if (existsSync(worktreePath)) {
-          rmSync(worktreePath, { recursive: true, force: true });
-        }
-      } catch (e) {
-        throw new Error(`清理 worktree 目录失败: ${e.message}`);
+    }
+    const branch = (meta && meta.branch) || BRANCH_PREFIX + name;
+
+    // 2. 确保目录已删除
+    try {
+      if (existsSync(worktreePath)) {
+        rmSync(worktreePath, { recursive: true, force: true });
       }
+    } catch (e) {
+      throw new Error(`清理 worktree 目录失败: ${e.message}`);
     }
 
     // 3. 删除分支（忽略分支不存在的错误）