sillyspec 3.29.5 → 3.31.0

package/src/sync.js

@@ -8,10 +8,10 @@
  * HTTP 请求：Node.js 原生 fetch（Node 22+）
  */
 
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync, chmodSync, rmSync } from 'fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync, chmodSync, rmSync, statSync } from 'fs';
 import { createHash } from 'crypto';
 import { writeAtomicSync } from './fs-atomic.js';
-import { join, dirname, basename, isAbsolute, relative } from 'path';
+import { join, dirname, basename, isAbsolute, relative, resolve as pathResolve } from 'path';
 import { homedir } from 'os';
 import { resolvePlatformSpecDir } from './progress.js';
 import { safeGit } from './git-helper.js';
@@ -68,6 +68,60 @@ function readLocalYaml(cwd) {
   }
 }
 
+/**
+ * 平台凭据解析（含向上回退链，2026-09-24 fr-test-readside 平台断流实证修复）：
+ * env（SILLYHUB_PLATFORM_URL/TOKEN）最高优先 → cwd 的 local.yaml platform 段 →
+ * 向上最多 7 级父目录逐层找 <dir>/.sillyspec/local.yaml 的 platform 段。
+ * 治「平台根 worktree 内跑命令」：worktree 的 local.yaml 是 gitignored 凭据不随
+ * checkout 跟进 → 无 platform 段 → 判未连接 → triggerSync 静默 no-op（verify/archive
+ * 瘦会话 cwd 在平台 worktree 时同步全程断流，bg 日志 13:29 后零同步轮实证）。
+ * 向上回退天然覆盖「worktree → 宿主仓」布局（宿主仓 local.yaml 持有连接凭据）。
+ * @returns {{url:string, token:string}|null}
+ */
+export function readPlatformConfig(cwd, opts = {}) {
+  if (process.env.SILLYHUB_PLATFORM_URL && process.env.SILLYHUB_PLATFORM_TOKEN) {
+    return { url: process.env.SILLYHUB_PLATFORM_URL, token: process.env.SILLYHUB_PLATFORM_TOKEN };
+  }
+  const maxDepth = Number.isInteger(opts.maxDepth) ? opts.maxDepth : 7; // opts.maxDepth 供单测隔离
+  const fromDir = (d) => { const p = readLocalYaml(d).platform; return p && p.url && p.token ? p : null };
+  const dir = pathResolve(cwd || process.cwd());
+  // ① 定 git 顶层（worktree 的 .git 是文件，也算顶层标记）：无 git 的目录链只看本层
+  //    ——回退链只在仓内有界，禁爬出仓外（家目录/祖先仓的凭据不该被任意子目录继承；
+  //    坑 check-approval-status 回归：tmpdir fixture 判「未连接」曾被无界回退翻真）。
+  let top = null;
+  let cur = dir;
+  for (let i = 0; i < maxDepth; i++) {
+    if (existsSync(join(cur, '.git'))) { top = cur; break; }
+    const parent = dirname(cur);
+    if (parent === cur) break;
+    cur = parent;
+  }
+  if (!top) return fromDir(dir);
+  // ② 仓内 cwd→顶层逐层查
+  cur = dir;
+  for (;;) {
+    const hit = fromDir(cur);
+    if (hit) return hit;
+    if (cur === top) break;
+    cur = dirname(cur);
+  }
+  // ③ worktree（顶层 .git 是文件）→ 宿主仓根（gitdir: <host>/.git/worktrees/<name>，
+  //    从 dirname(gitdir) 再上溯两次到 <host>）
+  try {
+    const dotGit = join(top, '.git');
+    if (statSync(dotGit).isFile()) {
+      const m = readFileSync(dotGit, 'utf8').match(/^gitdir:\s*(.+)$/m);
+      if (m) {
+        let host = pathResolve(dirname(m[1].trim()));
+        for (let k = 0; k < 2; k++) host = dirname(host);
+        const hostHit = fromDir(host);
+        if (hostHit) return hostHit;
+      }
+    }
+  } catch { /* gitdir 指针损坏 → 按无宿主处理 */ }
+  return null;
+}
+
 /** 读 local.yaml 原始文本（保留注释/换行/结构），不存在返回 ''。供 connect/disconnect 文本级改写。 */
 function readLocalYamlRaw(cwd) {
   const p = join(cwd, LOCAL_YAML);
@@ -674,9 +728,10 @@ export class SyncManager {
     this._suppressDocsMissingWarn = archivedQuietly;
 
     // X1 墓碑（design §5.5，变更 2026-08-29-change-delete-closure-and-spec-pull task-13）：
-    // 触发判据见循环内 tombstoneDue（DB status='archived'）。
+    // 触发判据见循环内 tombstoneDue（DB status='archived'|'deleted'）。
     // 常规终态推送保持原语义（archived/active 原值照推，platform-sync-archive-final-state 钉死），
-    // 墓碑作为推送链成功后的追加 POST（见 _pushTombstone）。
+    // 墓碑作为推送链成功后的追加 POST（见 _pushTombstone；终态透传，archived 链不伪装 deleted——
+    // 2026-09-23 archive-tombstone 坑修复）。
 
     const MAX_PUSH_ATTEMPTS = 2;
     for (let attempt = 1; attempt <= MAX_PUSH_ATTEMPTS; attempt++) {
@@ -700,7 +755,10 @@ export class SyncManager {
       // （unregisterChange 链——归档收尾/自愈/quick 收尾均置该值）或 status='deleted'
       // （change-delete 命令，2026-08-30——载荷本身携带 deleted，平台 _apply_cli_tombstone
       // 见该值即置 location='deleted'；追加墓碑 POST 幂等兜底）触发，常规推送成功后追加
-      // 一次 changes[].status='deleted' 墓碑（平台 task-04 写路径置 location='deleted' 收敛镜像）。
+      // 一次终态墓碑（终态透传：archived 链发 status='archived'、deleted 链发 'deleted'——
+      // 2026-09-23 前一律写死 'deleted' 致归档链被平台当删除软删，archive-tombstone 坑修复；
+      // 平台 task-04 写路径对 'deleted' 置 location='deleted' 收敛镜像，对 'archived' 新平台
+      // 置 location='archive'、旧平台读时投影零动作）。
       // 不再把「实体目录双失」当裸删发墓碑：platform pull（进度同步）只写 DB 不建目录 →
       // DB active + 目录双失是合法态，误发墓碑会让平台把活跃变更软删（全体成员生效）。
       // 真实裸删（用户手动 rm -rf 目录）由平台镜像收敛兜底（spec-sync delete ops → scoped
@@ -971,20 +1029,27 @@ export class SyncManager {
   }
 
   /**
-   * X1：把墓碑状态写进载荷——changes[0].status='deleted'（对齐既有 'archived' 状态语义，
-   * design §5.5）。平台写路径（服务端 task-04 `_apply_cli_tombstone`）见到该值即置
-   * Change.location='deleted' 并触发镜像软删收敛。
+   * X1：把终态写进墓碑载荷——**终态透传**（2026-09-23 archive-tombstone 坑修复）：DB
+   * status='deleted'（change-delete 链）透传 'deleted'，平台写路径 `_apply_cli_tombstone`
+   * 见值置 Change.location='deleted' 并镜像软删（行为不变）；DB status='archived'
+   * （unregisterChange 链）透传 'archived'——此前一律写死 'deleted'，归档链在平台被当
+   * 删除软删、面板「已归档」tab 隐身（MP 仓 docs/sillyspec/archive-tombstone-*.md 实证：
+   * 两工作区受影响，真删除历史仅 3 例且均非 archive 阶段）。'archived' 载荷旧平台走
+   * 读时投影零 location 动作（天然兼容），新平台写路径置 location='archive'。
    * @param {object} progressData serializeForSync 输出（原地修改，返回同一引用）
    */
   _applyTombstoneStatus(progressData) {
     if (progressData && Array.isArray(progressData.changes) && progressData.changes[0]) {
-      progressData.changes[0].status = 'deleted';
+      const terminal = progressData.changes[0].status;
+      progressData.changes[0].status = terminal === 'deleted' ? 'deleted' : 'archived';
     }
     return progressData;
   }
 
   /**
-   * X1 墓碑上行（design §5.5 / task-13）：同端点同结构的一次追加 POST（changes[].status='deleted'）。
+   * X1 墓碑上行（design §5.5 / task-13）：同端点同结构的一次追加 POST（终态透传：
+   * changes[].status='archived'|'deleted'，见 _applyTombstoneStatus——2026-09-23 起归档链
+   * 不再伪装成 deleted）。
    *
    * 由 sync() 成功路径在常规推送 + 文档/spec 树链之后触发（CLI 单进程顺序推送，base_ts 进程内
    * 单调，无乐观锁冲突）。fresh 重读 DB 序列化——常规推送成功的 base_ts 回填已落库，本推送带上
@@ -1022,7 +1087,7 @@ export class SyncManager {
       signal: opts.signal,
     });
     if (res.ok) {
-      console.log(`[sync] 已上行墓碑（status=deleted）: ${changeName}`);
+      console.log(`[sync] 已上行终态墓碑（status=${progressData.changes?.[0]?.status || '?'}）: ${changeName}`);
       try {
         const ackTs = res.body && typeof res.body.last_pushed_at === 'string' ? res.body.last_pushed_at : pushedAt;
         pm._updatePlatformLastSync(this.cwd, changeName, ackTs);
@@ -1240,14 +1305,9 @@ export class SyncManager {
    * （2026-08-26）后平台模式回传的主凭据实为 local.yaml platform 段（env 缺席时）。
    */
   _getPlatform() {
-    if (process.env.SILLYHUB_PLATFORM_URL && process.env.SILLYHUB_PLATFORM_TOKEN) {
-      return {
-        url: process.env.SILLYHUB_PLATFORM_URL,
-        token: process.env.SILLYHUB_PLATFORM_TOKEN,
-      };
-    }
-    const config = readLocalYaml(this.cwd);
-    return config.platform || null;
+    // 凭据走 readPlatformConfig 回退链（env → 本仓 local.yaml → 向上父目录）——平台根
+    // worktree cwd（gitignored 凭据不随 checkout 跟进）也能借宿主仓凭据连上（同 peek 修法）
+    return readPlatformConfig(this.cwd);
   }
 
   /**
@@ -2287,10 +2347,8 @@ export async function syncSpecTreeOnly(changeName, cwd, opts = {}) {
  * 未连接时不为一次注定 no-op 的同步 spawn 后台子进程（本地独立用户零开销零行为变化）。
  * 只做连接性预判不携带凭据：子进程自行经 _getPlatform 取全量配置（判据同源必一致）。
  */
-export function peekPlatformConnected(cwd) {
-  if (process.env.SILLYHUB_PLATFORM_URL && process.env.SILLYHUB_PLATFORM_TOKEN) return true;
-  const p = readLocalYaml(cwd).platform;
-  return Boolean(p && p.url && p.token);
+export function peekPlatformConnected(cwd, opts = {}) {
+  return Boolean(readPlatformConfig(cwd, opts));
 }
 
 // TBD-hub-api: approve/reject 端点路径与请求体以 SillyHub 仓库实际 API 为准；

package/src/task-done.js

@@ -0,0 +1,181 @@
+/**
+ * task-done.js — `sillyspec task done` 四合一（r5l-forensic-verdict 方案 1 / 评审护栏#3）。
+ *
+ * 背景（R5-L 法证桶①）：13 任务 × 每任务 4 连往返（task start → 实现 → review write →
+ * task finish，wt-commit 另计）≈ 52 次 CLI 调用纯属可合并——每次往返按当时全量上下文计费，
+ * 合并后每次省一次 ~300K 重发。本命令把收尾三连（review write 落 review.json + tasks.md
+ * 自动勾选 → task finish 清进行中标记 → 可选 wt-commit）收进单进程串行执行，输出合并为
+ * 分段结果行（一次调用一段可 grep 的结果，不再三条命令三段散落）。
+ *
+ * 原子性（评审护栏#3，硬约束）：
+ *   - 每子步先查自身完成标记，幂等跳过——review.json 已在且 verdict 指纹一致 → 跳过该步；
+ *     finish 标记不在 → 已完工跳过；wt-commit 无变更自然 skip（runWtCommit 既有语义）。
+ *   - 中段失败精确报告已完成子步（哪些已落盘、断在哪），重入直接重跑同命令从断点续。
+ *   - verdict 指纹不一致的已存在 review（改判场景）默认拒改写——继承 writeTaskReview 拒覆盖
+ *     语义，显式 --force 越过（与 review write 单独通道同款逃生门）。
+ *
+ * ownership 继承：不新增判定也不旁路既有判定——writeTaskReview 的拒覆盖/evidence 硬校验、
+ * runWtCommit 的 worktree 定位/文件锁/显式 pathspec 纪律原样生效（本模块只做编排）。
+ * `task start` 的受影响测试族注入不在本命令面（开工前置提示，保留不动）。
+ */
+import { existsSync, readFileSync, unlinkSync } from 'node:fs'
+import { join } from 'node:path'
+
+/**
+ * @param {{
+ *   changeName: string, cwd: string, taskId: string, verdict: string,
+ *   notes?: string, evidence?: string|null,
+ *   commitMessage?: string|null, pathspecs?: string[], pathspecFile?: string|null,
+ *   markerDir?: string|null, platformOpts?: object, force?: boolean,
+ * }} opts
+ * @returns {{ok: boolean, steps: Array<{name: string, status: string, detail: string}>}}
+ */
+export async function runTaskDone({ changeName, cwd, taskId, verdict, notes = '', evidence = null,
+  commitMessage = null, pathspecs = [], pathspecFile = null, markerDir = null, platformOpts = {}, force = false,
+  baseOverride = null, headOverride = null, changedFilesOverride = null }) {
+  const steps = []
+  const step = (name, status, detail) => { steps.push({ name, status, detail }) }
+  const specBase = (platformOpts && platformOpts.specRoot) || join(cwd, '.sillyspec')
+  const { resolveRuntimeRoot } = await import('./run/shared.js')
+  const runtimeRoot = resolveRuntimeRoot(platformOpts, specBase)
+  const { writeTaskReview, resolveLatestExecuteRunIdWithTasks, isValidExecuteRunId } = await import('./task-review.js')
+  // review.json 路径锚（子步 1 落定；子步 4 提交后回填 head 用——坑 task-done-head-premature：
+  // review 写在 wt-commit 之前，head 快照停在基线 → Task Review Gate 的 base..head 路径切片
+  // 为空被误判「零改动伪造」（R7 会话 5 份手工重对的机制化根治，2026-09-22）。
+  let reviewPathForBackfill = null
+
+  // ── 子步 1：review.json（幂等标记 = 同 executeRunId 同 task 同双 verdict 已在）──
+  // executeRunId 解析与 writeTaskReview 同源：marker 文件优先，缺省回退最新含 tasks 的 run。
+  let reviewWritten = false
+  let reviewSkipped = false
+  try {
+    let runId = ''
+    const markerFile = join(runtimeRoot, 'current-execute-run-id-' + changeName)
+    try {
+      if (existsSync(markerFile)) {
+        const c = readFileSync(markerFile, 'utf8').trim()
+        if (isValidExecuteRunId(c)) runId = c
+      }
+    } catch { /* 读失败走回退 */ }
+    if (!runId) runId = resolveLatestExecuteRunIdWithTasks({ runtimeRoot, changeName }) || ''
+    const existingPath = runId ? join(runtimeRoot, 'execute-runs', runId, 'tasks', taskId, 'review.json') : null
+    if (existingPath) reviewPathForBackfill = existingPath
+    if (existingPath && existsSync(existingPath)) {
+      let existing = null
+      try { existing = JSON.parse(readFileSync(existingPath, 'utf8')) } catch { /* 损坏按不存在处理 */ }
+      if (existing && existing.specVerdict === verdict && existing.qualityVerdict === verdict) {
+        reviewSkipped = true
+        step('review.json', 'skipped', `已在且 verdict 指纹一致（spec=${verdict} quality=${verdict}，${existingPath}）——幂等跳过`)
+      } else if (!force) {
+        step('review.json', 'failed', `已存在但 verdict 不一致（现存 spec=${existing ? existing.specVerdict : '?'} quality=${existing ? existing.qualityVerdict : '?'} ≠ 请求 ${verdict}）：${existingPath}——改判需显式 --force（保护既有 reviewer 结论，与 review write 拒覆盖同款）`)
+        return finishReport({ ok: false, steps, changeName, taskId })
+      }
+    }
+    if (!reviewSkipped) {
+      const preExisting = existingPath ? existsSync(existingPath) : false
+      const r = await writeTaskReview({
+        changeName, cwd, taskId,
+        specVerdict: verdict, qualityVerdict: verdict,
+        reviewerNotes: notes || '',
+        requiredEvidence: evidence ? [evidence] : [],
+        baseOverride, headOverride, changedFilesOverride,
+        force, platformOpts,
+      })
+      if (r.ok) {
+        reviewWritten = true
+        reviewPathForBackfill = r.reviewPath || reviewPathForBackfill
+        step('review.json', 'done', `${preExisting ? '覆盖写入（--force）' : '写入'} ${r.reviewPath}（executeRunId=${r.executeRunId}）`)
+      } else {
+        step('review.json', 'failed', r.errors.join('；'))
+        return finishReport({ ok: false, steps, changeName, taskId })
+      }
+    }
+  } catch (e) {
+    step('review.json', 'failed', `解析/写入异常：${e && e.message ? e.message : e}`)
+    return finishReport({ ok: false, steps, changeName, taskId })
+  }
+
+  // ── 子步 2：tasks.md checkbox 自动勾选（review write 单通道同款内嵌；幂等重跑无害）──
+  // task 真源归一（P2-f）：review.json verdict 是唯一真源，tasks.md 勾选是显示态，CLI 唯一勾选者。
+  try {
+    const { autoCheckPlanFromReviews } = await import('./run/complete.js')
+    const ac = await autoCheckPlanFromReviews({ stageName: 'execute', changeName, cwd, platformOpts })
+    if (ac.autoChecked && ac.checkedCount > 0) {
+      step('tasks.md 勾选', 'done', `按 review verdict 自动勾选 ${ac.checkedCount} 个（task 真源 = review.json，勿手动勾选）`)
+    } else {
+      step('tasks.md 勾选', 'skipped', '无可新勾选项（已勾/无卡——autoCheck 幂等）')
+    }
+  } catch (e) {
+    // 勾选 fail-soft（review write 单通道同款语义）：execute --done 时 autoCheck 兜底
+    step('tasks.md 勾选', 'skipped', `勾选降级（fail-soft，--done 时 autoCheck 兜底）：${e && e.message ? e.message : e}`)
+  }
+
+  // ── 子步 3：task finish（幂等标记 = 进行中标记文件不在 → 已完工跳过）──
+  const markerPath = markerDir ? join(markerDir, `${taskId}.json`) : null
+  if (markerPath && existsSync(markerPath)) {
+    try {
+      unlinkSync(markerPath)
+      step('task finish', 'done', `进行中标记已清除（${markerPath}）`)
+    } catch (e) {
+      step('task finish', 'failed', `标记清除失败：${e && e.message ? e.message : e}`)
+      return finishReport({ ok: false, steps, changeName, taskId })
+    }
+  } else {
+    step('task finish', 'skipped', markerPath ? '无进行中标记（已完工或从未 start）' : '无 markerDir（非 task start 流程，跳过）')
+  }
+
+  // ── 子步 4：wt-commit（可选；runWtCommit 自带 worktree 定位/文件锁/无变更 skip）──
+  if (!commitMessage) {
+    step('wt-commit', 'skipped', '未请求 --commit（如需提交工作区改动：加 --commit -m "<信息>" -- <精确路径>')
+  } else {
+    try {
+      const { runWtCommit } = await import('./wt-commit.js')
+      const r = await runWtCommit({ changeName, message: commitMessage, pathspecs, pathspecFile, cwd })
+      // head 回填（坑 task-done-head-premature 根治）：review 先于 commit 写入，head 停在基线
+      // → Task Review Gate base..head 切片空误判零改动。提交成功（HEAD 前移）即把 review.head
+      // 重锚为本提交全哈希+headBackfilledAt 审计戳；fail-soft（回填失败只警示不改判提交结果）。
+      let backfillNote = ''
+      if (!r.skipped && r.head && reviewPathForBackfill && existsSync(reviewPathForBackfill)) {
+        try {
+          const rev = JSON.parse(readFileSync(reviewPathForBackfill, 'utf8'))
+          if (rev && rev.head !== r.head) {
+            rev.head = r.head
+            rev.headBackfilledAt = new Date().toISOString()
+            const { writeAtomicSync } = await import('./fs-atomic.js')
+            writeAtomicSync(reviewPathForBackfill, JSON.stringify(rev, null, 2) + '\n')
+            backfillNote = `；review.head 已回填 ${r.shortHead}（提交后重锚）`
+          }
+        } catch (e) {
+          backfillNote = `；review.head 回填失败（fail-soft）: ${(e && e.message) || e}`
+        }
+      }
+      step('wt-commit', r.skipped ? 'skipped' : 'done',
+        r.skipped ? `无变更跳过（HEAD 不动）：${r.shortHead}` : `${r.shortHead}（${r.files.length} 文件，worktree=${r.worktreePath}）${backfillNote}`)
+    } catch (e) {
+      step('wt-commit', 'failed', `${e && e.message ? e.message : e}`)
+      return finishReport({ ok: false, steps, changeName, taskId })
+    }
+  }
+
+  return finishReport({ ok: true, steps, changeName, taskId })
+}
+
+/** 统一报告渲染：四段结果行 + 失败时已完成子步精确点名与重入指引 */
+function finishReport({ ok, steps, changeName, taskId }) {
+  const icon = (s) => (s.status === 'done' ? '✅' : s.status === 'skipped' ? '⏭️ ' : '❌')
+  if (ok) {
+    console.log(`✅ task done [${taskId}] @ ${changeName}：${steps.length} 个子步全部完成（done/skipped 均为终态）`)
+  } else {
+    console.error(`❌ task done [${taskId}] @ ${changeName} 中断：`)
+  }
+  steps.forEach((s, i) => {
+    const line = `   ${i + 1}. [${s.name}] ${icon(s)} ${s.status}——${s.detail}`
+    if (ok) console.log(line); else console.error(line)
+  })
+  if (!ok) {
+    const done = steps.filter((s) => s.status === 'done' || s.status === 'skipped')
+    console.error(`   已完成子步：${done.length > 0 ? done.map((s) => s.name).join('、') : '（无——首子步即失败）'}`)
+    console.error(`   重入：修复失败原因后重跑同一条命令——已完成子步幂等跳过，从断点续（review verdict 指纹一致即跳过写入）`)
+  }
+  return { ok, steps }
+}

package/src/task-review.js

@@ -815,29 +815,9 @@ export function verifyReviewGitEvidence(review, gitDir, cache = null, opts = {})
   return { ok: errors.length === 0, emptyDiff, errors, warnings, unavailable: false }
 }
 
-/**
- * 将 cannot_verify 的 requiredEvidence 写入 change 目录
- * 供 verify 阶段消费
- *
- * @param {string} changeDir - 变更目录（.sillyspec/changes/<name>）
- * @param {Array<{task: string, verdict: string, evidence: string[]}>} requiredEvidence
- * @returns {string|null} 写入的文件路径，null 表示无需写入
- */
-export function writeVerifyRequiredEvidence(changeDir, requiredEvidence) {
-  if (!requiredEvidence || requiredEvidence.length === 0) return null
-
-  const filePath = join(changeDir, 'verify-required-evidence.json')
-  const data = {
-    generatedAt: new Date().toISOString(),
-    schemaVersion: 1,
-    items: requiredEvidence,
-  }
-
-  mkdirSync(changeDir, { recursive: true })
-  writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n')
-
-  return filePath
-}
+// writeVerifyRequiredEvidence（cannot_verify 证据落盘 verify-required-evidence.json）已随
+// Task Review 层退役删除（2026-09-26-task-review-retire，唯一调用方 Execute Task Review Gate）：
+// 新变更停写该文件；verify 侧 runVerifyRequiredEvidenceCheck 兼容读在场存量（缺席=无 cannot_verify 任务）。
 
 /**
  * 生成 execute run id。
@@ -1920,14 +1900,14 @@ function detectInterruptedSyntaxResidue(changedFiles, candidateRoots) {
     }
     if (!abs) continue
     try {
-      execFileSync(process.execPath, ['--check', abs], { timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] })
+      execFileSync(process.execPath, ['--check', abs], { timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true })
       if (isPlainJs(f)) {
         // 无 type:module 上下文的 .js：file-check 通过不代表语法完整（Node v24 实测假阴），
         // 再跑 stdin ESM 全量解析兜底——两路都挂才判残留
         let src = ''
         try { src = readFileSync(abs, 'utf8') } catch { continue }
         try {
-          execFileSync(process.execPath, ['--input-type=module', '--check'], { input: src, timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] })
+          execFileSync(process.execPath, ['--input-type=module', '--check'], { input: src, timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true })
         } catch (e2) {
           if (e2 && e2.killed) continue
           const line = _syntaxErrLine(e2)
@@ -1947,7 +1927,7 @@ function detectInterruptedSyntaxResidue(changedFiles, candidateRoots) {
       let src = ''
       try { src = readFileSync(abs, 'utf8') } catch { continue }
       try {
-        execFileSync(process.execPath, ['--input-type=module', '--check'], { input: src, timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] })
+        execFileSync(process.execPath, ['--input-type=module', '--check'], { input: src, timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true })
       } catch (e2) {
         if (e2 && e2.killed) continue
         const line = _syntaxErrLine(e2) || _syntaxErrLine(e)
@@ -2200,32 +2180,5 @@ export function ensureTaskReviewDir(runtimeRoot, executeRunId, taskId) {
   return dir
 }
 
-/**
- * 打印校验结果
- * @param {{ ok: boolean, errors: string[], warnings: string[], requiredEvidence: Array }} result
- */
-export function printReviewResult(result, context = {}) {
-  if (result.ok && result.warnings.length === 0) {
-    console.log('\n✅ Task Review Gate — 所有任务评审通过')
-    return
-  }
-
-  if (result.errors.length > 0) {
-    console.error('\n🚫 Task Review Gate — FAILED')
-    for (const err of result.errors) {
-      console.error(`   - ${err}`)
-    }
-    const hint = context.runtimeRoot && context.executeRunId
-      ? `期望路径：${context.runtimeRoot}/execute-runs/${context.executeRunId}/tasks/<task-XX>/review.json`
-      : '为缺失/失败的任务补充 review.json'
-    console.error(`\n   提示：${hint}，然后重新 --done`)
-  }
-
-  if (result.warnings.length > 0) {
-    console.warn('\n⚠️ Task Review Gate — WARNING')
-    for (const w of result.warnings) {
-      console.warn(`   - ${w}`)
-    }
-    console.warn('\n   cannot_verify 的 requiredEvidence 将在 verify 阶段校验')
-  }
-}
+// printReviewResult（Task Review 校验结果打印）已随 Task Review 层退役删除
+// （2026-09-26-task-review-retire，调用方 gates.js 两个门均已退役）。