sillyspec 3.32.3 → 3.32.5

package/src/hooks/worktree-guard.js

@@ -497,6 +497,22 @@ function parseSimpleYaml(content) {
       if (typeof result[topKey] !== 'object' || Array.isArray(result[topKey])) result[topKey] = {}
       if (!Array.isArray(result[topKey][childKey])) result[topKey][childKey] = []
       result[topKey][childKey].push(parseValue(trimmed.slice(2)))
+      continue
+    }
+
+    // indent>=4 的 `<子键>: <值>`（三层嵌套标量，坑 repo-inline-worktree-placement：repos 条目
+    // 对象形态 `repos: → <key>: → path:/worktree:`）——空数组占位（indent2 无值条目）转对象后
+    // 挂键。此前该形态被静默丢弃，analyzeCrossRepoCd 等消费方读不到三层配置。
+    if (indent >= 4 && childKey) {
+      const subMatch = trimmed.match(/^([^:]+):\s*(.*)$/)
+      if (!subMatch) continue
+      if (UNSAFE_KEYS.has(subMatch[1].trim())) continue
+      if (typeof result[topKey] !== 'object' || Array.isArray(result[topKey])) result[topKey] = {}
+      const cur = result[topKey][childKey]
+      if (Array.isArray(cur) && cur.length === 0) result[topKey][childKey] = {}
+      if (result[topKey][childKey] && typeof result[topKey][childKey] === 'object' && !Array.isArray(result[topKey][childKey])) {
+        result[topKey][childKey][subMatch[1].trim()] = parseValue(subMatch[2])
+      }
     }
   }
 
@@ -886,8 +902,25 @@ function analyzeCrossRepoCd(command, callerCwd, projectRoot, inWorktree) {
     const shellResolved = path.isAbsolute(t) ? t : path.resolve(callerCwd, t)
     const intended = path.isAbsolute(t) ? t : path.resolve(inWorktree ? projectRoot : callerCwd, t)
     for (const [key, raw] of Object.entries(repos)) {
-      if (typeof raw !== 'string' || !raw) continue
-      const repoRoot = path.isAbsolute(raw) ? raw : path.resolve(projectRoot, raw)
+      // 条目双形态（坑 repo-inline-worktree-placement）：'path' 字符串（parseSimpleYaml 原样）；
+      // 块式对象 {path, worktree}（parseSimpleYaml 嵌套）；inline '{path: ..}' 字符串
+      // （parseSimpleYaml 不解析 inline flow，原样字符串——手动提取 path 子键）
+      let repoPath = null
+      if (typeof raw === 'string' && raw) {
+        const t = raw.trim()
+        if (t.startsWith('{') && t.endsWith('}')) {
+          for (const part of t.slice(1, -1).split(',')) {
+            const idx = part.indexOf(':')
+            if (idx !== -1 && part.slice(0, idx).trim() === 'path') { repoPath = part.slice(idx + 1).trim().replace(/^['"]|['"]$/g, ''); break }
+          }
+        } else {
+          repoPath = raw
+        }
+      } else if (raw && typeof raw === 'object' && typeof raw.path === 'string' && raw.path) {
+        repoPath = raw.path
+      }
+      if (!repoPath) continue
+      const repoRoot = path.isAbsolute(repoPath) ? repoPath : path.resolve(projectRoot, repoPath)
       if (intended === repoRoot || isPathInside(intended, repoRoot)) {
         hits.push({ key, repoRoot, resolved: intended, shellResolved, target: t })
         break

package/src/index.js

@@ -246,7 +246,7 @@ async function main() {
 
   // E22：重路径统一加载（轻路径 --version/help 已早退，未付此税）。
   const { ProgressManager, resolvePlatformSpecDir, resolvePlatformOpts } = await import('./progress.js');
-  const { didYouMean, assertSafeChangeName, assertDatedChangeName, resolveSpecDir, detectWorktreeSpecDrift, detectCwdInsideWorktree, ancestorSpecDirs } = await import('./run/shared.js');
+  const { didYouMean, assertSafeChangeName, assertDatedChangeName, resolveSpecDir, detectWorktreeSpecDrift, detectCwdInsideWorktree, ancestorSpecDirs, resolveUninitCwdGate } = await import('./run/shared.js');
 
   // 解析全局选项
   let json = false;
@@ -354,7 +354,9 @@ async function main() {
     return baseDir
   }
 
-  const dir = targetDir;
+  // let：下方未初始化目录硬拦命中祖先链时重锚定到 spec 根（治裸 join(dir,'.sillyspec')
+  // 调用点如 review status rsSpecBase 的子目录漂移；resolveEffectiveDir 系本就上溯，变为无操作）
+  let dir = targetDir;
 
   if (command === 'init' && !existsSync(dir)) {
     const { mkdirSync } = await import('fs');
@@ -388,6 +390,33 @@ async function main() {
     }
   }
 
+  // ── 未初始化目录硬拦（坑：agent 在未初始化/错误目录跑非 init 命令，fail-soft 散点报错不说
+  //    正确 cwd——实测 status 在未初始化目录提示可开变更、flow start 到 local.yaml 才报错、
+  //    knowledge 只报参数错，agent 多轮试错）──
+  //    判定与豁免清单收敛在 run/shared.js resolveUninitCwdGate（单一真相源，测试直测）；
+  //    平台 pointer/接管声明/显式 --spec-dir/平台 flag 由其判 skip（平台项目不受本门误拦）。
+  //    未初始化目录无 ground truth——文案只给锚点（git root）与三条出路，不断言唯一正确 cwd。
+  const uninitGate = resolveUninitCwdGate(command, {
+    dir,
+    specDir,
+    // --spec-root 同为平台显式意图（平台模式首扫 run scan --spec-root 在无 pointer 的新目录
+    // 合法运行，spec 恒在仓外）——与 --workspace-id/--runtime-root 一并越过本门
+    platformFlags: platformWorkspaceId || platformRuntimeRoot || filteredArgs.includes('--spec-root'),
+  });
+  if (uninitGate.verdict === 'block') {
+    console.error(`\n❌ 当前目录未初始化（${dir}）：${uninitGate.gitRoot
+      ? `已上溯祖先链至 git root（${uninitGate.gitRoot}）`
+      : '已上溯祖先链（当前不在 git 仓内）'}未找到 .sillyspec，平台指针亦无。`);
+    console.error('   非 init/scan 类命令需要已初始化的项目根。');
+    console.error('   修复：① cd 回项目根（含 .sillyspec 的目录）再跑；② 新项目先 sillyspec init（棕地项目 sillyspec scan）；③ 或 --spec-dir <路径> 显式指定 .sillyspec 位置。');
+    console.error('   查询/诊断类命令（status/doctor/progress/next/knowledge 等）不受此拦。');
+    process.exit(2);
+  }
+  if (uninitGate.verdict === 'pass' && uninitGate.anchor && resolve(dir) !== uninitGate.anchor) {
+    console.log(`ℹ️ cwd 在子目录（${dir}），已锚定到项目根：${uninitGate.anchor}（spec 解析与产物落点以项目根为准）`);
+    dir = uninitGate.anchor;
+  }
+
   switch (command) {
     case 'init':
       await (await import('./init.js')).cmdInit(dir, { tool, tools: toolValues.length > 0 ? toolValues : null, interactive, specDir, noSkills, forceCards, platformOpts: (platformWorkspaceId || platformRuntimeRoot) ? { workspaceId: platformWorkspaceId, runtimeRoot: platformRuntimeRoot } : null });
@@ -4110,7 +4139,8 @@ SillySpec platform — SillyHub 平台同步
 用法:
   sillyspec platform connect <url> [--token <token>]
   sillyspec platform disconnect
-  sillyspec platform sync [--change <name>]
+  sillyspec platform sync [--change <name>]   带 --change 同步该变更进度六表+spec 树；
+                                             不带 --change 全树 spec 文件同步
   sillyspec platform sync-docs [--change <name>]
   sillyspec platform pull [--change <name>]
   sillyspec platform resolve <change-name> <--keep-local|--take-platform|--abort>
@@ -4225,8 +4255,26 @@ SillySpec platform — SillyHub 平台同步
         case 'sync': {
           const syncChangeIdx = args.indexOf('--change');
           const syncChangeName = syncChangeIdx >= 0 && args[syncChangeIdx + 1] && !String(args[syncChangeIdx + 1]).startsWith("--") ? args[syncChangeIdx + 1] : null;
-          // manual：用户显式同步，change_deleted 回执噪音闸旁路（显式动作的回执必须可见）
-          await syncModule.sync(syncChangeName, dir, { manual: true });
+          if (syncChangeName) {
+            // manual：用户显式同步，change_deleted 回执噪音闸旁路（显式动作的回执必须可见）
+            await syncModule.sync(syncChangeName, dir, { manual: true });
+          } else {
+            // 全树 spec 文件同步（2026-10-11-sync-conflict-tri-fix FR-03）：不带 --change
+            // 此前报「需要指定变更名称」——归档/历史变更无活跃会话标签时无从下手。现走
+            // syncSpecTreeOnly(null) 全树 diff（以服务器清单为锚）；进度六表仍按变更
+            // 粒度走 --change。未连接明确报错不静默（对齐 platform pull 口径）。
+            const smForCheck = new syncModule.SyncManager(dir);
+            if (!smForCheck._getPlatform()) {
+              console.error('❌ 未连接平台，请先 sillyspec platform connect');
+              process.exit(1);
+            }
+            const r = await syncModule.syncSpecTreeOnly(null, dir, {});
+            if (r && r.conflict) {
+              console.error(`⚠️ 全树同步检测到冲突（${(r.serverVersions && Object.keys(r.serverVersions).length) || 0} 个文件待裁决），处理：sillyspec platform status 查看 / platform resolve <变更名> 处置`);
+              process.exit(1);
+            }
+            console.log(`✅ 全树 spec 同步完成（${r ? r.synced : 0} 个文件差异）`);
+          }
           break;
         }
         case 'sync-docs': {

package/src/init.js

@@ -89,9 +89,9 @@ const TOOL_LABELS = {
   opencode: 'OpenCode (通过 INSTRUCTIONS.md)',
 };
 
-// 小段追加工具（gemini/opencode）。codex 不在此列——AGENTS.md 是跨工具通用的标准内容源，
-// codex 与 claude 共用完整模板注入（injectAgentsInstructions）；gemini/opencode 改 @AGENTS.md
-// 指针需先验证两家对 @ 导入语法的支持，留待后续变更。
+// 指令文件工具（gemini/opencode）。codex/claude/zcode 共用 AGENTS.md（跨工具通用标准内容源）；
+// gemini/opencode 写各自指令文件，内容与 AGENTS.md 同源同全文（改 @AGENTS.md 指针需先验证
+// 两家对 @ 导入语法的支持，留待后续变更）。
 const INSTRUCTION_TOOLS = ['gemini', 'opencode'];
 
 const INSTRUCTION_FILE_MAP = {
@@ -99,7 +99,13 @@ const INSTRUCTION_FILE_MAP = {
   opencode: 'INSTRUCTIONS.md',
 };
 
-const INJECTION_CONTENT = `## SillySpec — 规范驱动开发
+// ── 注入指令文件（全量方案，2026-10-10-init-full-injection：完整模板是唯一注入源）──
+
+const AGENTS_TEMPLATE_PATH = join(__dirname, '..', 'templates', 'agents-instruction.md');
+
+// 旧版小段（v≤3.32.3：AGENTS.md 追加态受管块与 injectInstructions 的注入源）。仅作老安装
+// 迁移的精确匹配文本，不再是任何注入源——所有状态一律写完整模板。
+const LEGACY_SMALL_BLOCK = `## SillySpec — 规范驱动开发
 
 在执行开发任务时，遵循以下规范：
 
@@ -113,41 +119,23 @@ const INJECTION_CONTENT = `## SillySpec — 规范驱动开发
 - 各阶段产出文件位于 \`.sillyspec/changes/<变更名>/\` 下
 `;
 
-// ── 注入指令文件 ──
-
-function injectInstructions(tool, projectDir) {
-  const fileName = INSTRUCTION_FILE_MAP[tool];
-  if (!fileName) return;
-  const filePath = join(projectDir, fileName);
-
-  // 文件不存在则创建
-  if (!existsSync(filePath)) {
-    writeFileSync(filePath, INJECTION_CONTENT);
-    return;
+function readInstructionTemplate() {
+  try {
+    return readFileSync(AGENTS_TEMPLATE_PATH, 'utf8');
+  } catch {
+    console.error(`❌ [sillyspec] 未找到 Agent 指引模板：${AGENTS_TEMPLATE_PATH}`);
+    return null;
   }
-
-  // 已存在 SillySpec 标记则跳过
-  const content = readFileSync(filePath, 'utf8');
-  if (content.includes('## SillySpec')) return;
-
-  // 追加到末尾
-  writeFileSync(filePath, content.trimEnd() + '\n\n' + INJECTION_CONTENT);
 }
 
-// ── 注入 AGENTS.md / CLAUDE.md（claude + codex，版本感知幂等）──
-// AGENTS.md 是唯一承载完整指引的内容源（跨工具通用标准）；CLAUDE.md 仅为 @AGENTS.md
-// 导入指针（Claude Code 记忆导入语法）。取代 design: 2026-08-02-init-claude-md 的
-// CLAUDE.md 单文件方案——其 D-004 预留的「marker 方案迁移」即本次变更。
-const AGENTS_TEMPLATE_PATH = join(__dirname, '..', 'templates', 'agents-instruction.md');
-
 /**
- * 移除 codex 老安装的旧版小段（injectInstructions 方案：`## SillySpec` 段，追加在 EOF）。
+ * 移除老安装的旧版小段（v≤3.32.3 方案：`## SillySpec` 段，追加在 EOF 或整文件即小段）。
  * 优先精确匹配旧文本；用户编辑过 / CRLF 漂移导致匹配失败时回退按标题截到 EOF。
- * @param {string} content - AGENTS.md 原文
+ * @param {string} content - 指引文件原文
  * @returns {string} 截除旧段后的内容（已 trimEnd）
  */
-function stripLegacyAgentsBlock(content) {
-  const exact = INJECTION_CONTENT.trimEnd();
+function stripLegacySmallBlock(content) {
+  const exact = LEGACY_SMALL_BLOCK.trimEnd();
   const idx = content.indexOf(exact);
   if (idx >= 0) return content.slice(0, idx).trimEnd();
   const headingIdx = content.indexOf('## SillySpec');
@@ -156,50 +144,49 @@ function stripLegacyAgentsBlock(content) {
 }
 
 /**
- * 为 AGENTS.md 注入完整指引（版本感知幂等，三态四分支 + 旧标记迁移）。
- * - 不存在：写完整模板（templates/agents-instruction.md）+ 顶部版本注释
- * - 存在无标记：追加受管段（INJECTION_CONTENT）+ 版本块标记；
- *   含旧 `## SillySpec` 段（codex 老安装）先截除再追加（marker 迁移，防双段）
+ * 向指引文件注入完整模板（版本感知幂等，三态四分支 + 旧标记迁移）。
+ * AGENTS.md / GEMINI.md / INSTRUCTIONS.md 共用；完整模板（templates/agents-instruction.md）
+ * 是唯一注入源。取代 design: 2026-08-02-init-claude-md 的 CLAUDE.md 单文件方案与
+ * v≤3.32.3 的追加态小段方案（其 D-004 预留的「marker 方案迁移」即彼方案）。
+ * - 不存在：写完整模板 + 顶部版本注释
+ * - 存在无标记：追加受管段（完整模板全文）+ 版本块标记；
+ *   含旧 `## SillySpec` 小段（v≤3.32.3 安装）先截除再追加（marker 迁移，防双段）
  * - 存在同版本标记：跳过（不写文件）
  * - 存在异版本标记：追加态刷新块 / 完整态仅 stderr 提示（保留用户改动）
- * @param {string} projectDir - 源码项目根
+ * @param {string} filePath - 指引文件绝对路径
  */
-export function injectAgentsInstructions(projectDir) {
-  const filePath = join(projectDir, 'AGENTS.md');
+function injectFullInstructions(filePath) {
   const version = getVersion();
+  const template = readInstructionTemplate();
+  if (template === null) return;
+  const fileName = basename(filePath);
   // 完整态顶部注释（新文件首行，轻量、不限制后续编辑）
   const fullHeader = `<!-- SillySpec v${version} — 由 sillyspec init 生成，可自由编辑；重跑 init 同版本不更新 -->`;
-  // 追加态受管段（包版本块标记，明确"勿手动编辑此段"）
-  const appendBlock =
+  // 追加态受管段（包版本块标记，明确"勿手动编辑此段"），内容=完整模板全文
+  const managedBlock =
     `<!-- SillySpec v${version} START — 由 sillyspec init 注入，勿手动编辑此段 -->\n` +
-    INJECTION_CONTENT.trimEnd() +
+    template.trimEnd() +
     `\n<!-- SillySpec END -->`;
 
   // 状态 1：文件不存在 → 写完整模板 + 顶部版本注释
   if (!existsSync(filePath)) {
-    let template = '';
-    try {
-      template = readFileSync(AGENTS_TEMPLATE_PATH, 'utf8');
-    } catch {
-      console.error(`❌ [sillyspec] 未找到 Agent 指引模板：${AGENTS_TEMPLATE_PATH}`);
-      return;
-    }
     writeFileSync(filePath, fullHeader + '\n' + template);
-    console.log(chalk.green(`    ✓ AGENTS.md 已生成（SillySpec v${version}，完整指引）`));
+    console.log(chalk.green(`    ✓ ${fileName} 已生成（SillySpec v${version}，完整指引）`));
     return;
   }
 
   let content = readFileSync(filePath, 'utf8');
 
-  // 无任何 `<!-- SillySpec v` 标记 → 状态 2：追加受管段（原文字节保留）
+  // 无任何 `<!-- SillySpec v` 标记 → 状态 2：追加完整受管段（原文字节保留）
   const markMatch = content.match(/<!-- SillySpec v(\S+)/);
   if (!markMatch) {
     if (content.includes('## SillySpec')) {
-      content = stripLegacyAgentsBlock(content);
-      console.log(chalk.green('    ✓ AGENTS.md 旧版 SillySpec 小段已迁移为新受管段'));
+      content = stripLegacySmallBlock(content);
+      console.log(chalk.green('    ✓ 旧版 SillySpec 小段已迁移为完整受管段'));
     }
-    writeFileSync(filePath, content + '\n\n' + appendBlock + '\n');
-    console.log(chalk.green(`    ✓ AGENTS.md 已追加 SillySpec 受管段（v${version}）`));
+    const body = content.trimEnd() === '' ? managedBlock : content.trimEnd() + '\n\n' + managedBlock;
+    writeFileSync(filePath, body + '\n');
+    console.log(chalk.green(`    ✓ ${fileName} 已追加 SillySpec 完整指引受管段（v${version}）`));
     return;
   }
 
@@ -210,15 +197,25 @@ export function injectAgentsInstructions(projectDir) {
   // 状态 4：异版本（升级）。区分追加态（有 START...END 块）/ 完整态（仅顶部注释）。
   const startBlockRe = /<!-- SillySpec v\S+\s+START[\s\S]*?<!-- SillySpec END -->/;
   if (startBlockRe.test(content)) {
-    // 4a：追加态 → 用当前版本受管段替换该块（块外用户内容字节保留）
-    writeFileSync(filePath, content.replace(startBlockRe, appendBlock));
-    console.log(chalk.green(`    ✓ AGENTS.md 受管段已升级（v${existingVersion} → v${version}）`));
+    // 4a：追加态 → 用当前版本完整受管段替换该块（块外用户内容字节保留）
+    writeFileSync(filePath, content.replace(startBlockRe, managedBlock));
+    console.log(chalk.green(`    ✓ ${fileName} 完整指引受管段已升级（v${existingVersion} → v${version}）`));
   } else {
     // 4b：完整态 → 不覆盖（保留用户改动），仅 stderr 打印升级提示
-    console.error(`⚠️ [sillyspec] SillySpec 升级 v${existingVersion}→v${version}，AGENTS.md 未自动更新（保留你的改动）。如需采用新模板：备份后删除 AGENTS.md 再跑 sillyspec init。`);
+    console.error(`⚠️ [sillyspec] SillySpec 升级 v${existingVersion}→v${version}，${fileName} 未自动更新（保留你的改动）。如需采用新模板：备份后删除 ${fileName} 再跑 sillyspec init。`);
   }
 }
 
+export function injectAgentsInstructions(projectDir) {
+  injectFullInstructions(join(projectDir, 'AGENTS.md'));
+}
+
+export function injectInstructions(tool, projectDir) {
+  const fileName = INSTRUCTION_FILE_MAP[tool];
+  if (!fileName) return;
+  injectFullInstructions(join(projectDir, fileName));
+}
+
 /**
  * 为 Claude Code 写 CLAUDE.md 指针（@AGENTS.md 导入，薄文件）。
  * - 不存在：写指针文件（版本头注释 + @AGENTS.md）
@@ -441,7 +438,7 @@ async function doInstall(projectDir, tools, subprojects = [], specDir = null, op
     }
   }
 
-  // 注入指令文件（gemini/opencode 小段追加，不进 AGENTS.md 注入器）
+  // 注入指令文件（gemini/opencode：与 AGENTS.md 同源同全文，共用全量注入器）
   for (let i = 0; i < tools.length; i++) {
     const toolName = tools[i];
     if (INSTRUCTION_TOOLS.includes(toolName)) {
@@ -449,7 +446,7 @@ async function doInstall(projectDir, tools, subprojects = [], specDir = null, op
     }
   }
 
-  // 注入 AGENTS.md 完整指引（claude/codex/zcode 共用：版本感知幂等三态四分支 + 旧 ## SillySpec 段迁移；
+  // 注入 AGENTS.md 完整指引（claude/codex/zcode 共用：版本感知幂等三态四分支 + 旧 ## SillySpec 小段迁移；
   // zcode 2026-09-21-flow-command-cards FR-05 入面——AGENTS.md 是跨工具通用标准内容源）
   if (tools.includes('claude') || tools.includes('codex') || tools.includes('zcode')) {
     injectAgentsInstructions(projectDir);

package/src/run/command.js

@@ -1274,6 +1274,25 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
     // 如果指定了变更名或有变更目录，自动初始化变更的 progress
     const autoChange = changeName || resolveChangeNameAuto(cwd, specRoot)
     if (autoChange) {
+      // 归档同名幽灵复活门（坑 archived-change-resurrect-by-merge，2026-10-10 实证：远端
+      // merge 把已归档变更的旧四件套带回活跃路径，run verify 见活跃目录即自动注册新进度行、
+      // 幽灵态推上平台）。活跃目录与 changes/archive/<同名>/ 并存且库内无该变更活跃行 →
+      // 拒绝注册，指向两出口（认归档：清幽灵目录 / 真要重开：换新名或先恢复归档）。
+      try {
+        const _archiveDup = join(specBase, 'changes', 'archive', autoChange)
+        if (existsSync(_archiveDup) && !progress) {
+          let _activeRows = []
+          try { _activeRows = pm.listChanges(cwd) } catch { /* 列举失败按无活跃行处置 */ }
+          if (!_activeRows.includes(autoChange)) {
+            console.error(`❌ 拒绝注册：${autoChange} 已有归档目录（changes/archive/${autoChange}/），当前活跃目录疑似 merge 带回的幽灵复活（库内无活跃行）。`)
+            console.error('   两个出口：')
+            console.error(`   ① 认归档（多数场景）：git rm -r .sillyspec/changes/${autoChange} 清幽灵目录后提交；归档侧工件在 changes/archive/${autoChange}/`)
+            console.error('   ② 确要重开同名变更：先换新变更名（推荐），或恢复归档（mv 回活跃目录并清理库内 archived 行）后再跑')
+            console.error('   核对：递归 diff 活跃 vs 归档目录确认归档侧为超集零信息损失（坑内处置实录）')
+            process.exit(2)
+          }
+        }
+      } catch { /* 守卫异常不拦正常注册（fail-open）*/ }
       // 创建时即写 title（与 name/KEY 同时落 db）：--input 首行推导 deriveChangeTitle（≤50 字，
       // 用户需求 2026-09-29）优先，长输入兜底 sanitizeDesc 压行，无则用 name 兜底。
       // proposal 还没写、无权威标题来源，这是临时值；brainstorm/plan 完成 proposal/design 落盘后由

package/src/run/multi-repo-context.js

@@ -25,6 +25,7 @@
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { git, gitQuiet } from '../git-helper.js';
+import { resolveCrossWorktreePathCandidates } from '../cross-placement.js';
 
 /**
  * @typedef {Object} RepoEntry
@@ -152,14 +153,19 @@ export class MultiRepoContext {
         `请补全路径（约束② fail-closed）。`
       );
     }
-    // worktree 模式检测：meta 在 = worktree-cross.js 已建隔离（路径公式与其 crossWorktreePath
-    // 保持同步；execute 启动时创建，晚于本构造的调用会命中）。
+    // worktree 模式检测：meta 在 = worktree-cross.js 已建隔离（寻址经 cross-placement 叶子模块
+    // resolveCrossWorktreePath——注册表优先、公式兜底；execute 启动时创建，晚于本构造的调用会
+    // 命中。不 import worktree-cross 避免 shared↔multi-repo-context 循环，落位逻辑下沉的
+    // 零依赖叶子模块两侧共用无环——坑 cross-wt-toolchain-split 评审吸收①）。
     const specBase = (this.platformOpts && this.platformOpts.specRoot) || join(this.cwd, '.sillyspec');
     let crossMeta = null;
     try {
-      // 同步读（构造函数是同步的，不 import worktree-cross 避免 shared↔multi-repo-context 循环）
-      const metaPath = join(specBase, '.runtime', 'worktrees', `${this.changeName}--${repoKey}`, 'meta.json');
-      if (existsSync(metaPath)) crossMeta = JSON.parse(readFileSync(metaPath, 'utf8'));
+      // 同步读（构造函数是同步的）；寻址候选逐级探测（注册表 → 仓内新公式 → 主仓 specBase 旧
+      // 公式 legacy 兜底）——无注册表条目的存量 worktree 在本读取面不失联
+      for (const cand of resolveCrossWorktreePathCandidates(specBase, this.changeName, repoKey, crossRepoPath)) {
+        const metaPath = join(cand, 'meta.json');
+        if (existsSync(metaPath)) { crossMeta = JSON.parse(readFileSync(metaPath, 'utf8')); break }
+      }
     } catch { crossMeta = null }
     const inWorktree = !!(crossMeta && crossMeta.isCross && crossMeta.worktreePath && existsSync(crossMeta.worktreePath));
     const workRoot = inWorktree ? crossMeta.worktreePath : crossRepoPath;

package/src/run/shared.js

@@ -60,7 +60,12 @@ export function didYouMean(input, candidates) {
 // ── 变更名路径穿越消毒（F6）──
 // change 名会被 join 进 .sillyspec/changes/<name>/ 当目录用。若含 ../ 或路径分隔符，
 // 会逃出 changes/ 写到任意位置（如 --change ../../etc/x 把 proposal.md 写到 changes 同级之外）。
-// 在 --change 解析边界统一消毒，比在每个 join 点守卫更集中。合法名：字母/数字/._-，禁分隔符与 ..
+// 在 --change 解析边界统一消毒，比在每个 join 点守卫更集中。合法名：字母/数字/._-/CJK，
+// 禁分隔符与 ..
+// 2026-10-11-sync-conflict-tri-fix FR-03：字符集扩 CJK（一-鿿，与下方 assertDatedChangeName
+// slug 同集）——本守卫的本职是路径穿越消毒，ASCII 限制是历史误伤：磁盘既有中文名变更
+//（实测 2026-10-10-取消LTC宽表校验规则）被拒致 platform sync/resolve 无法操作。
+// 新建变更名仍受 assertDatedChangeName 日期前缀门约束，不因本放宽回归。
 export function assertSafeChangeName(name, label = '变更名') {
   if (name == null) return
   const s = String(name)
@@ -69,8 +74,8 @@ export function assertSafeChangeName(name, label = '变更名') {
   if (/[\\/]/.test(s) || /(^|[/\\])\.\.(?=$|[/\\])/.test(s) || s === '..' || s.includes('..')) {
     throw new Error(`${label}「${s}」含路径分隔符或 ..，禁止路径穿越（变更名只能是 .sillyspec/changes/ 下的一个目录名，不能逃出）`)
   }
-  if (!/^[\w.\-]+$/.test(s)) {
-    throw new Error(`${label}「${s}」含非法字符（仅允许字母、数字、._-）`)
+  if (!/^[\w.\-一-鿿]+$/.test(s)) {
+    throw new Error(`${label}「${s}」含非法字符（仅允许字母、数字、._-、中文）`)
   }
 }
 
@@ -83,7 +88,8 @@ export function assertSafeChangeName(name, label = '变更名') {
 // 日期只校验形状（月 01-12 日 01-31），不校验「当天」——跨天续跑/次日重命名不应被拦。
 // slug 首字符放宽含 CJK（一-鿿，与 flow 族 validateChangeName 同字符集）：flow start 2026-09-28
 // 起复用本校验器，中文名（平台键 2026-09-25-中文名-a1b2c3 形态）是 flow 族既有测试特性；
-// run 族不受影响——其上游 assertSafeChangeName 仅放行 ASCII [\w.\-]，中文在到达本门之前已被拦。
+// 上游 assertSafeChangeName 自 2026-10-11-sync-conflict-tri-fix 起同放行 CJK（此前 ASCII
+// 限宽拦中文名，属历史误伤，见该守卫注释）。
 const DATED_CHANGE_NAME_RE = /^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])-[a-zA-Z0-9一-鿿][\w.\-一-鿿]*$/
 export function assertDatedChangeName(name, label = '变更名') {
   if (name == null) return
@@ -367,6 +373,81 @@ export function detectCwdInsideWorktree(dir) {
   return null
 }
 
+// ── 未初始化目录硬拦（坑：agent 在未初始化/错误目录跑非 init 命令，fail-soft 散点报错不说
+//    正确 cwd，agent 多轮试错）──
+// 豁免面 = 按设计可在未初始化目录运行的命令。每项豁免依据（勿凭感觉增删）：
+//   init/scan      初始化器与棕地入口，未初始化目录是本职（scan 亦是 monorepo 子项目独立建实例的合法入口）
+//   doctor/status/progress/next/workspace 未初始化是它们的设计输出态（run/next.js
+//                  '未初始化（无 .sillyspec 产物）'、workspace.js '未初始化（无 .sillyspec）'）
+//   setup/config   自带候选链 fail-closed 报错（'请先运行 sillyspec init'）
+//   knowledge      知识目录缺失走友好空态（stages/knowledge.js）
+//   local          纯 fs 嗅探生成 local.yaml，设计上 init 前可用
+//   mcp/dashboard/platform 服务/平台设施，自有路径解析
+//   wt-commit      子代理 workdir=worktree 内合法（worktree cwd 硬拦同款豁免）
+//   agent-log      --detect 现场探测不落盘，自有解析链
+export const UNINIT_CWD_GATE_EXEMPT = new Set([
+  'init', 'scan', 'doctor', 'status', 'progress', 'next', 'workspace',
+  'setup', 'knowledge', 'local', 'config', 'mcp', 'dashboard', 'platform',
+  'wt-commit', 'agent-log',
+])
+
+/**
+ * CLI 入口「未初始化目录」判定（与 detectCwdInsideWorktree 分工：那边判「在隔离 worktree
+ * 内」，文案更具体故先拦；这边判「任何形式的 spec 都解析不到」——覆盖未初始化目录与非
+ * sillspec 项目的误跑两类）。
+ *
+ * 判定复用 resolveSpecDir 全套守卫（home 拒绝 / tmp 边界 / .runtime 回环防护）——不重写
+ * 遍历，否则已修复的坑（2026-09-27-spec-sync-413 .runtime 回环等）会回归。
+ *
+ * 返回（风格仿 detectCwdInsideWorktree）：
+ *   { verdict: 'exempt' }            豁免命令 / 无命令（usage 已早退，保险不拦），不拦不锚
+ *   { verdict: 'skip' }              显式意图（--spec-dir、平台 flag、平台 pointer/接管声明在
+ *                                    dir）——spec 解析与错误面归命令自身的 fail-closed 文案
+ *                                    （PointerUnreachableError 等），本门不重复判、更不能拿
+ *                                    「dir 里没有 .sillyspec」误拦平台项目
+ *   { verdict: 'pass', anchor }      命中已初始化上下文。anchor=spec 根父目录（供调用方重锚定，
+ *                                    修裸 join(dir,'.sillyspec') 调用点如 review status rsSpecBase
+ *                                    的子目录漂移）；linked worktree  rescued 场景 anchor=null——
+ *                                    主仓 spec 不在 cwd 祖先链上，锚定交命令层自有逻辑
+ *                                    （如 endpoints baseline 的主仓锚定），本门不越俎
+ *   { verdict: 'block', gitRoot }    全链未命中 → 调用方硬报错 exit 2；gitRoot 供文案指路
+ *                                    （未初始化目录无 ground truth，只能给锚点不能断言唯一 cwd）
+ *
+ * @param {string} command 顶层命令名
+ * @param {{ dir?: string, specDir?: string, platformFlags?: unknown }} opts
+ *   dir=目标目录（cwd 或 --dir）；specDir=显式 --spec-dir；platformFlags=--workspace-id/
+ *   --runtime-root/--spec-root 任一显式给出即为真值（平台模式显式意图）
+ */
+export function resolveUninitCwdGate(command, { dir, specDir, platformFlags } = {}) {
+  if (!command || UNINIT_CWD_GATE_EXEMPT.has(command)) return { verdict: 'exempt' }
+  if (specDir || platformFlags) return { verdict: 'skip' }
+  const resolvedDir = resolve(dir || process.cwd())
+  if (existsSync(join(resolvedDir, '.sillyspec-platform.json')) || existsSync(join(resolvedDir, PLATFORM_MANAGED_FILENAME))) {
+    return { verdict: 'skip' }
+  }
+  const spec = resolveSpecDir(resolvedDir)
+  if (existsSync(spec)) return { verdict: 'pass', anchor: dirname(spec) }
+  // linked worktree 兜底（判据同 resolveEffectiveDir P1-1 / worktree.js _resolveMainRepoRoot：
+  // --git-dir ≠ --git-common-dir 且非 submodule）：主仓 .sillyspec 不在 cwd 祖先链上（如
+  // `git worktree add` 到兄弟路径的副本），resolveSpecDir 必 miss 但项目实为已初始化——
+  // 误拦会打断 endpoints baseline 等命令层自有的主仓锚定逻辑。放行不重锚：锚定归命令层。
+  const gd = safeGit(resolvedDir, ['rev-parse', '--git-dir'])
+  const gcd = safeGit(resolvedDir, ['rev-parse', '--git-common-dir'])
+  const superProj = safeGit(resolvedDir, ['rev-parse', '--show-superproject-working-tree'])
+  if (gd.value && gcd.value && gd.value !== gcd.value && !superProj.value) {
+    // common-dir 可能是相对路径，须相对 resolvedDir 绝对化（与 worktree.js 同坑同解）
+    const absCommonDir = resolve(resolvedDir, gcd.value)
+    if (existsSync(absCommonDir)) {
+      const mainRoot = dirname(absCommonDir)
+      if (mainRoot !== resolvedDir && existsSync(join(mainRoot, '.sillyspec'))) {
+        return { verdict: 'pass', anchor: null }
+      }
+    }
+  }
+  const gitRoot = safeGit(resolvedDir, ['rev-parse', '--show-toplevel']).value || null
+  return { verdict: 'block', gitRoot }
+}
+
 /**
  * 统一解析 .runtime 根目录（坑 execute-runs-isolation）。
  *