sillyspec 3.29.5 → 3.30.0

package/src/run/command.js

@@ -20,14 +20,14 @@
  *     './run/stage.js' → './shared.js' 等同级
  */
 import { basename, join, resolve, dirname } from 'node:path'
-import { existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync, rmSync, unlinkSync } from 'node:fs'
+import { existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync, rmSync, unlinkSync, statSync } from 'node:fs'
 import { randomBytes, randomUUID } from 'node:crypto'
 import { fileURLToPath } from 'node:url'
 import { writeAtomicSync } from '../fs-atomic.js'
-import { resolveSpecDir, countAncestorSpecDirs, ancestorSpecDirs, resolveAncestorCeiling, resolveChangeDir, triggerSync, getStageSteps, formatWaitOptions, checkApproval, warnApprovalUnknown, didYouMean, assertSafeChangeName, assertDatedChangeName, detectQuickSessionDrift, detectWorktreeSpecDrift, resolveRuntimeRoot, resolveQuickSessionsDir, writePlatformPointer, checkPlatformManaged, isSelfReferentialSpecRoot, isTempResidueSpecRoot, PLATFORM_MANAGED_FILENAME, warnSelfRefPointerOnce } from './shared.js'
+import { resolveSpecDir, countAncestorSpecDirs, ancestorSpecDirs, resolveAncestorCeiling, resolveChangeDir, triggerSync, getStageSteps, formatWaitOptions, checkApproval, warnApprovalUnknown, didYouMean, assertSafeChangeName, assertDatedChangeName, detectQuickSessionDrift, detectWorktreeSpecDrift, resolveRuntimeRoot, resolveQuickSessionsDir, writePlatformPointer, checkPlatformManaged, isSelfReferentialSpecRoot, isTempResidueSpecRoot, PLATFORM_MANAGED_FILENAME, warnSelfRefPointerOnce, readStageBurst, STAGE_BURST_STAGES } from './shared.js'
 import { resolveQuickLinkedChanges } from './quick-audit.js'
 import { outputStep, collectStageWaitHistory } from './prompt.js'
-import { completeStep, skipStep, waitStep, continueStep, synthesizeStepOutput } from './complete.js'
+import { completeStep, completeStepBurst, skipStep, waitStep, continueStep, synthesizeStepOutput } from './complete.js'
 import { runStage } from './stage.js'
 import { sanitizeDesc } from '../quicklog.js'
 import { ProgressManager, resolveSessionIdentity } from '../progress.js'
@@ -52,6 +52,7 @@ const VALUE_FLAGS = new Set([
   '--base', // scan diff 基线 commit（吃值；只在 run scan --diff 转发路径消费）
   '--session', // 显式会话标识（吃值；2026-09-14-change-ownership-guards task-02 所有权三级解析最高优先级层，启动 claim 消费）
   '--inherit-from', // wait 继承盖章锚点 <D-xxx@vN>（吃值；2026-09-18-preflight-slimming task-03 / D-003@v2：仅 --wait 场景合法，--wait 分发点校验消费）
+  '--step', // --done --step <名|序号> 意图断言（吃值；:340 消费。漏登记死路同 --wait-interactive 前例：burst 说明书出示该形态却被未知参数 exit(2) 拦死，2026-09-23 执行会话实证）
 ])
 
 /**
@@ -720,6 +721,10 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
     '--takeover', // 所有权护栏显式强制接管（task-02 / FR-01：本层只注册透传，实际消费在 index.js apply/cleanup 子命令层——run 侧带上不报未知参数，语义出口在 worktree 命令）
     '--skip-apply', // 归档收口跳过 apply 校验（task-02 只注册透传不改行为，消费归 task-03 archive 接线）
     '--inherit-from', // wait 继承盖章 <D-xxx@vN>（2026-09-18-preflight-slimming task-03：仅 --wait 场景合法，hasDecisionId 校验+盖章在 --wait 分发点/complete 层）
+    '--step', // --done 意图断言 <名|序号>（吃值，VALUE_FLAGS 同步登记；:340 消费——漏登记则说明书出示的 --done --step 形态进命令即被未知参数拦死，2026-09-23 执行会话实证）
+    '--upgrade-thick', // 轻量→完整升档用户同意门（2026-09-25-thin-upgrade-consent：布尔 flag，混跑回退写侧 :1362 消费——无 flag 拒跑，带 flag 落 legacy_fallback+同意时点留痕）
+    '--same-session', // R17 实验实证死路清偿（cli-protocol-trust）：STAGE_WALL 报错指引「加 --same-session 重跑」（stage.js 硬墙文案），消费在 runStage 逃生口——此前漏登记，照指引重跑即被本白名单 exit 2（指引指向死路的自我矛盾）
+    '--force', // 同族第二实例（静态扫描新发现）：quick --cancel 强清消费点与报错指引（可用 --force）在场但未登记——同死路；一致性钉 test/flag-contract.test.mjs 守护整类
     '-h',
   ])
   for (let i = 0; i < flags.length; i++) {
@@ -795,6 +800,43 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
         } catch {}
       }
       if (!quickSessionId) {
+        // 坑 quick-done-长静默与快照行尾假阳性 坑3（2026-09-21 实证）：`quick --status` 不带
+        // --change 时缺省语义是「新建」而非「查看」——查进度忘带 --change 直接误开空壳会话
+        //（需 --cancel 清理）。只读意图（--status）拦截：读 current marker 与最近 guard 目录
+        // 展示最近会话状态 + 提示带 --change，零副作用退出（绝不新建）。
+        if (isStatus) {
+          const recentRoot = resolveRuntimeRoot(platformOpts, specRoot)
+          let recent = null
+          try {
+            const idFile = join(recentRoot, 'current-quick-run-id')
+            if (existsSync(idFile)) {
+              const v = readFileSync(idFile, 'utf8').trim()
+              if (QUICK_SID_RE.test(v)) recent = v
+            }
+          } catch { /* 读失败按无 marker 处理 */ }
+          if (!recent) {
+            try {
+              const sessRoot = join(recentRoot, 'quick-sessions')
+              if (existsSync(sessRoot)) {
+                const cands = readdirSync(sessRoot, { withFileTypes: true })
+                  .filter(d => d.isDirectory() && QUICK_SID_RE.test(d.name))
+                  .map(d => ({ name: d.name, m: statSync(join(sessRoot, d.name, 'guard.json')).mtimeMs }))
+                  .filter(x => x.m > 0)
+                  .sort((a, b) => b.m - a.m)
+                if (cands.length > 0) recent = cands[0].name
+              }
+            } catch { /* 枚举失败按无近期会话处理 */ }
+          }
+          console.log('ℹ️ `run quick --status` 不带 --change 查的是最近会话，不会新建（查进度请带 --change <sessionId>）')
+          if (recent) {
+            console.log(`   最近会话: ${recent}（本命令将展示其状态）`)
+            quickSessionId = recent
+            quickFallbackUsed = true
+          } else {
+            console.log('   本仓无近期 quick 会话记录（current marker 与 quick-sessions 均空）——新工作请走轻量变更：sillyspec flow start --change <名> --input "<动机与背景；随后独立一行『成功标准：』；再每行一条『- <可验证标准>』>"')
+            process.exit(0)
+          }
+        } else {
         // 坑 quick-no-input-placeholder-title（2026-08-24 二期①；2026-09-19 上移）：全新 quick 会话
         // （即将生成新 sessionId）缺 --input 且无可取标题的 --linked-changes → 拒绝启动（exit 2，
         // 零沉没成本）。原位置在 flag 校验之后，但 sessionId 生成/「已建立」公告与 agent-log 平台
@@ -828,6 +870,7 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
         // 若把命令拖过 exec 超时，调用方仍能从输出头部拿到 sessionId 续用（--status / guard.json
         // 核对），不会误开空壳新会话。
         console.log(`📌 quick 会话已建立: ${quickSessionId}（后续若超时/中断，用 --change ${quickSessionId} 续用）`)
+        }
       }
       changeName = quickSessionId
     } else {
@@ -1305,6 +1348,45 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
   // 注册变更到全局活跃列表（如果尚未注册）
   if (effectiveChange) {
     pm.registerChange(cwd, effectiveChange)
+    // ── watcher 拉起（R7 切片一 / D-001：观测与协议解耦）──
+    // effectiveChange 解析后无条件 spawn（不做「检测新建」——registerChange 是 INSERT OR
+    // IGNORE 不返回新建信号），活锁在跑由单飞锁合并 coalesced。best-effort：失败只 warn
+    // 绝不阻断主流程；未连接平台也 spawn（本地 jsonl 是事件唯一真相源）；
+    // SILLYSPEC_WATCHER=0 逃生阀。default 容器行不监听（非真实变更）。
+    if (effectiveChange !== 'default') {
+      // ── 混跑回退写侧（R7 切片二 / FR-06 / D-002：thin change 上跑 run <stage> = 该 change
+      // 回 legacy 记账——flow done 读侧拒裁并指路厚档；两套记账不叠加。一次性置位留痕。）──
+      // 升厚同意门（2026-09-25-thin-upgrade-consent，R16 实测驱动）：轻量→完整是成本数倍的资源
+      // 决策，归属用户——agent 不得凭 CLI 的 advisory 自行转道。混跑回退须显式 --upgrade-thick
+      // （=「用户已同意」的落痕 flag，同 --force 留痕先例）；无 flag 拒跑指路。
+      try {
+        const flowStatePath = join(specRoot, 'changes', effectiveChange, 'flow-state.yaml')
+        if (existsSync(flowStatePath)) {
+          const { readFlowState, writeFlowState } = await import('../flow.js')
+          const changeDir = join(specRoot, 'changes', effectiveChange)
+          const st = readFlowState(changeDir)
+          if (st && !st.legacy_fallback) {
+            if (!flags.includes('--upgrade-thick')) {
+              console.error(`⛔ 本变更在轻量跑道上（flow-state 在场）——升厚走完整流程需用户同意，agent 不得自行转道：`)
+              console.error(`   · 征得用户同意后带 --upgrade-thick 重跑本命令（落痕留档，首次转厚即转）`)
+              console.error(`   · 用户未确认或选择轻量跑 → 继续轻量变更：直接干活，收口 sillyspec flow done --change ${effectiveChange}`)
+              process.exit(2)
+            }
+            writeFlowState(changeDir, { legacy_fallback: true, upgraded_by_consent: new Date().toISOString() })
+            console.warn(`⚠️ [flow] thin change「${effectiveChange}」经用户同意（--upgrade-thick 落痕）升厚——已混跑回退 legacy（flow done 将按厚档拒裁并指路；两套记账不叠加）`)
+          }
+        }
+      } catch { /* 探测失败不阻断既有 run 流程（process.exit 直出不经 catch） */ }
+      try {
+        const { spawnWatcher } = await import('../watcher.js')
+        const r = await spawnWatcher(cwd, effectiveChange, { ...platformOpts, specBase })
+        if (r.status === 'spawned') {
+          console.log(`🔄 [watcher] 观测旁路已拉起（产物签名轮询，事件恒带 provisional:true）: ${effectiveChange}`)
+        }
+      } catch (e) {
+        console.warn(`⚠️ [watcher] 拉起失败（观测旁路 best-effort，不影响主流程）: ${(e && e.message) || e}`)
+      }
+    }
     // ── 所有权首建 claim（2026-09-14-change-ownership-guards task-02 / FR-01 / D-001@v1）──
     // run <stage> 启动即认领 owner（claimChangeOwner 守卫语义：已有值不覆盖——他人持有不抢
     // 也不拒；拒绝语义只锁接管类操作，见 index.js apply/cleanup/assess 接线）。会话标识三级：
@@ -1656,11 +1738,16 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
     const doneAnswer = getFlagValue('--answer')
     // isSkipApply/sessionFlag（task-03）：--skip-apply 归档收口跳过 + --session 所有权会话标识，
     // 随 completeStep options 透传（isNoDocs 同款链路）——消费点 archive/quick 收尾 handler。
+    // burst 分发门（2026-09-22-stage-burst-fold D-003@v2/FR-06）：白名单主阶段 + readStageBurst
+    // 开启 → completeStepBurst 循环收口（completeStep 本体零改动，守卫逐轮生效）；options 原样透传。
+    if (STAGE_BURST_STAGES.includes(stageName) && await readStageBurst(cwd)) {
+      return await completeStepBurst(pm, progress, stageName, cwd, outputText, inputText, { confirm: isConfirm, changeName: effectiveChange, nonInteractive: isNonInteractive && !isInteractive, platformOpts, doneAnswer, isForceBaseline, isAllowNew, isAllowDelete, isNoDocs, isSkipApply, sessionFlag: getFlagValue('--session'), quickFiles, stepAssert: stepAssertValue })
+    }
     return await completeStep(pm, progress, stageName, cwd, outputText, inputText, { confirm: isConfirm, changeName: effectiveChange, nonInteractive: isNonInteractive && !isInteractive, platformOpts, doneAnswer, isForceBaseline, isAllowNew, isAllowDelete, isNoDocs, isSkipApply, sessionFlag: getFlagValue('--session'), quickFiles, stepAssert: stepAssertValue })
   }
 
   // 默认：输出当前步骤
-  return await runStage(pm, progress, stageName, cwd, effectiveChange, isSkipApproval, platformOpts, { quickFiles, isAllowNew, isAllowDelete, isForceBaseline, isForceRescan, linkedChanges, linkedChangesAuto: linkedAuto, taskDescription: inputText, adoptBranch: stageName === 'execute' && flags.includes('--adopt-branch') })
+  return await runStage(pm, progress, stageName, cwd, effectiveChange, isSkipApproval, platformOpts, { quickFiles, isAllowNew, isAllowDelete, isForceBaseline, isForceRescan, linkedChanges, linkedChangesAuto: linkedAuto, taskDescription: inputText, adoptBranch: stageName === 'execute' && flags.includes('--adopt-branch'), sameSession: flags.includes('--same-session') })
 }
 
 /**
@@ -1848,6 +1935,23 @@ async function runAutoMode(pm, progress, cwd, flags, changeName, platformOpts =
   // 零活跃建变更已上移入口守卫层，多活跃 exit 2 由入口守卫处理）。
   if (changeName) console.log(`🎯 auto 目标变更（单活跃自动选中或显式指定）：${changeName}`)
 
+  // ── watcher 拉起（2026-09-23-sentinel-rules task-05 / FR-09）──
+  // run auto 在 runCommand 主干的 spawnWatcher 挂点（effectiveChange 解析后那处）之前
+  // 早退进本函数——auto 路径是 run 族唯一观测缺口。语义同 flow start 接线：best-effort
+  // 失败只 warn 不阻断，SILLYSPEC_WATCHER=0 逃生阀在 spawnWatcher 内短路，活锁合并
+  // coalesced，未连接平台也 spawn（本地 jsonl 是事件唯一真相源）。
+  if (changeName && changeName !== 'default') {
+    try {
+      const { spawnWatcher } = await import('../watcher.js')
+      const r = await spawnWatcher(cwd, changeName, { ...platformOpts, specBase })
+      if (r.status === 'spawned') {
+        console.log(`🔄 [watcher] 观测旁路已拉起（auto 路径补挂，事件恒带 provisional:true）: ${changeName}`)
+      }
+    } catch (e) {
+      console.warn(`⚠️ [watcher] 拉起失败（观测旁路 best-effort，不影响主流程）: ${(e && e.message) || e}`)
+    }
+  }
+
   // Helper: 在 auto 模式下获取步骤定义
   const getAutoSteps = async (stage) => {
     if (stage === 'brainstorm') {
@@ -1905,8 +2009,9 @@ async function runAutoMode(pm, progress, cwd, flags, changeName, platformOpts =
     const localConfig = readAutoModeFromLocalYaml(cwd)
     const classification = classifyChange({ description: inputText || '', explicitMode, localConfig })
     if (classification.mode === 'quick') {
-      console.log(`📊 auto 模式分类：${classification.mode}（${classification.reason}）`)
-      console.log(`   此变更建议使用 quick 模式，运行：sillyspec run quick "${inputText || '需求'}"`)
+      console.log(`📊 auto 模式分类：${classification.reason} 判为小变更`)
+      console.log(`   小变更请走轻量变更（quick 通道已退役，v3.30.0 起拒绝新会话）：`)
+      console.log(`   sillyspec flow start --change <名> --input "<动机与背景；随后独立一行『成功标准：』；再每行一条『- <可验证标准>』>"`)
       return
     }
     console.log(`📊 auto 模式分类：${classification.mode}（${classification.reason}）`)
@@ -1993,16 +2098,24 @@ async function runAutoMode(pm, progress, cwd, flags, changeName, platformOpts =
     return
   }
 
-  if (!outputText) {
+  // burst 分发门（2026-09-22-stage-burst-fold D-003@v2/X-4，FR-06）：auto 路径 burst 分支跳过
+  // --output 预合成（预合成文本在 burst 下沦为横幅重复打印——burst 直接透传原始 outputText，
+  // 横幅去重归 completeStepBurst 单点），循环收口后本路径既有推进逻辑（nextPendingIdx 渲染 /
+  // nextInFlow 阶段推进）基于重读 progress 自然衔接。
+  const _autoBurstOn = STAGE_BURST_STAGES.includes(currentStage) && await readStageBurst(cwd)
+
+  if (!outputText && !_autoBurstOn) {
     // P0-2（noai-ir-roadmap §3）：auto --done 的 --output 同样可省略——与 completeStep 同源
     // 的事实性摘要合成（此前硬拒 exit 2 是用法守卫；SS-META 的 doneCommand 仍带 --output，
     // 照抄路径零变化，省略路径不再罚一轮）。
     const _autoStep = progress?.stages?.[currentStage]?.steps?.find((s) => s && ['pending', 'in-progress', 'blocked'].includes(s.status))
-    outputText = synthesizeStepOutput({ stageName: currentStage, stepName: _autoStep?.name || currentStage, cwd })
+    outputText = synthesizeStepOutput({ stageName: currentStage, stepName: _autoStep?.name || currentStage, cwd, platformOpts })
     console.log(`🤖 auto --done 未带 --output——CLI 已按事实合成步骤摘要（语义说明下次带 --output 手写）。`)
   }
 
-  const result = await completeStep(pm, progress, currentStage, cwd, outputText, inputText, { printNext: false, changeName, platformOpts })
+  const result = _autoBurstOn
+    ? await completeStepBurst(pm, progress, currentStage, cwd, outputText, inputText, { printNext: false, changeName, platformOpts })
+    : await completeStep(pm, progress, currentStage, cwd, outputText, inputText, { printNext: false, changeName, platformOpts })
   if (!result) return
   progress = pm.read(cwd, changeName)
   // change 行被并发归档/删除时 read 返回 null（体检 BUG-05）：引导排查而非 TypeError 崩溃
@@ -2161,7 +2274,7 @@ export async function maybeWaitInteractive(stepDef, changeName, stageName, { rlF
       const { execFileSync } = await import('node:child_process')
       const binSelf = resolveBinSelfPath()
       try {
-        execFileSync(process.execPath, [binSelf, 'run', 'auto', '--continue', '--answer', answer.trim(), '--change', changeName], { stdio: 'inherit', cwd: process.cwd() })
+        execFileSync(process.execPath, [binSelf, 'run', 'auto', '--continue', '--answer', answer.trim(), '--change', changeName], { stdio: 'inherit', cwd: process.cwd(), windowsHide: true })
       } catch { /* continue 失败（非 waiting 态等）静默——回三段式由 agent 走 */ }
     }
   } catch (e) {