sillyspec 3.26.7 → 3.26.9

package/src/init.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'fs';
 import { join, resolve, dirname, basename } from 'path';
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 import { checkbox, confirm, input } from '@inquirer/prompts';
 import { ProgressManager } from './progress.js';
 import chalk from 'chalk';
@@ -213,17 +213,27 @@ function isTTY() {
 
 // ── 核心安装逻辑 ──
 
-function doInstall(projectDir, tools, subprojects = [], specDir = null) {
+function doInstall(projectDir, tools, subprojects = [], specDir = null, options = {}) {
   // specDir: 规范目录（默认 projectDir/.sillyspec）
   // projectDir: 源码项目根目录（用于工具检测、指令注入、.gitignore）
+  // options.noSkills: 跳过 skills 复制段（--no-skills；指令注入不受影响）
+  // options.platformMode: 平台模式（cmdInit 收到 platformOpts 非空）——项目内 .sillyspec/
+  //   通常只有 local.yaml（平台 init lease 写、含用户手调 mcp 段），任何清理都会丢失，整体跳过
+  const { noSkills = false, platformMode = false } = options;
   const spec = specDir || join(projectDir, '.sillyspec');
 
   // 外部 specDir 时清理旧版本残留的 cwd/.sillyspec/（防止源码污染）。
   // ⚠️ 必须保护真实资产：若本地 .sillyspec 含 changes/（非空）、projects/（非空）
   // 或 sillyspec.db（进度库），说明该项目本身就用 SillySpec 管理，整体删除会丢资产。
   // 此时只清运行时残留，拒绝整删；确无资产时才视为旧残留清理。
+  // 平台模式（platformMode）整体绕过清理段：项目内 .sillyspec/ 常只有 local.yaml
+  // （平台 init lease 第 5 步写，含用户手调 mcp 段），整删/残留清理都会丢配置。
   const legacyDir = join(projectDir, '.sillyspec');
-  if (specDir && existsSync(legacyDir)) {
+  if (platformMode) {
+    if (specDir && existsSync(legacyDir)) {
+      console.log('⏭️ 平台模式：跳过项目内 .sillyspec/ 清理（保留 local.yaml 等本地配置）');
+    }
+  } else if (specDir && existsSync(legacyDir)) {
     let hasChanges = false;
     try {
       const changesDir = join(legacyDir, 'changes');
@@ -330,7 +340,12 @@ function doInstall(projectDir, tools, subprojects = [], specDir = null) {
   const isExternalSpec = specDir && resolve(spec) !== resolve(projectDir, '.sillyspec');
  if (!isExternalSpec) {
     const gitignorePath = join(projectDir, '.gitignore');
-    const ignoreRules = ['.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/'];
+    // 平台模式项目根落盘物（指针/声明/cleaned 标记）为本地运行时状态，不入库。
+    // 注意平台模式（外部 specDir）不进此分支——那两个文件照样不提交，由用户项目自己 ignore。
+    const ignoreRules = [
+      '.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/',
+      '.sillyspec-platform.json', '.sillyspec-platform-managed', '.sillyspec-platform-cleaned',
+    ];
     if (existsSync(gitignorePath)) {
       const content = readFileSync(gitignorePath, 'utf8');
       let updated = content.trimEnd();
@@ -358,7 +373,11 @@ function doInstall(projectDir, tools, subprojects = [], specDir = null) {
     injectClaudeInstructions(projectDir);
   }
 
-  // 复制 skills 到各工具目录
+  // 复制 skills 到各工具目录（--no-skills 可跳过：platform init 等场景勿污染项目内工具目录）
+  if (noSkills) {
+    console.log(chalk.dim('    ⏭️ 已跳过 skills 复制（--no-skills）'));
+    return;
+  }
   const skillToolDirs = {
     claude: '.claude/skills',
     codex: '.codex/skills',
@@ -386,6 +405,44 @@ function doInstall(projectDir, tools, subprojects = [], specDir = null) {
 
 // ── 安装完成总结 ──
 
+/**
+ * 平台模式 init 落盘指针（消除 init→scan 窗口期断点）。
+ *
+ * 触发条件：带平台专属信号（--workspace-id / --runtime-root，由 index.js 解析为 platformOpts）
+ * 且 --spec-dir 指向外部规范目录。仅 --spec-dir（本地外部目录用法）不触发——与 runCommand 侧
+ * 「带平台 flag 才算平台调用」判定一致，防本地用户误触发平台指针。
+ *
+ * 复用 scan 的指针生成逻辑（writePlatformPointer，单一数据源），status: active
+ * （POINTER_STATUS.ACTIVE，未 scan；24h STALE 清理只作用于 scan_completed，不会误删）。
+ */
+function writeInitPlatformPointer(projectDir, resolvedSpecDir, platformOpts) {
+  if (!platformOpts || !resolvedSpecDir) return;
+  const isExternalSpec = resolve(resolvedSpecDir) !== resolve(projectDir, '.sillyspec');
+  if (!isExternalSpec) return;
+  const { writePlatformPointer } = require_or_import_shared();
+  const ok = writePlatformPointer(projectDir, {
+    specRoot: resolve(resolvedSpecDir),
+    runtimeRoot: platformOpts.runtimeRoot || null,
+    workspaceId: platformOpts.workspaceId || null,
+    scanRunId: null,
+  }, { status: 'active' });
+  if (ok) {
+    console.log(chalk.green(`    ✓ 平台指针已落盘（.sillyspec-platform.json，status: active）`));
+    console.log(chalk.green(`      init→scan 窗口期裸调 run 命令将自动恢复平台 specRoot: ${resolvedSpecDir}`));
+  }
+}
+
+// ESM 下惰性加载 run/shared.js 的 writePlatformPointer。
+// 用 createRequire 而非顶层静态 import：init.js 被 index.js 按 case 动态加载已隔离，
+// 但 shared.js → git-helper 链在 CJS require 下无需解析 ESM 依赖图，路径最短。
+// （node:module 为内置模块，顶层 import 零依赖税。）
+import { createRequire } from 'node:module';
+function require_or_import_shared() {
+  const req = createRequire(import.meta.url);
+  return req('./run/shared.js');
+}
+
+
 function showSummary(version, tools, specDir) {
   const toolLabels = tools.map(t => TOOL_LABELS[t] || t);
 
@@ -409,10 +466,18 @@ function showSummary(version, tools, specDir) {
 // ── 主命令 ──
 
 export async function cmdInit(projectDir, options = {}) {
-  const { tool, interactive, specDir } = options;
+  const { tool, tools: toolsOpt, interactive, specDir, noSkills = false, platformOpts = null } = options;
   const version = getVersion();
   const resolvedSpecDir = specDir ? resolve(specDir) : null;
 
+  // C14c：绿地/棕地引导——必须在 doInstall 之前捕获目录状态（init 会创建 .sillyspec/CLAUDE.md/
+  // .gitignore 等，事后检测会误判）；棕地（已有非隐藏源码）建议 scan，绿地（空目录）建议 brainstorm。
+  let brownfield = false;
+  try {
+    const entries = readdirSync(projectDir, { withFileTypes: true });
+    brownfield = entries.some(e => !e.name.startsWith('.'));
+  } catch { brownfield = false; }
+
   // ── 交互式模式（--interactive 或 -i）──
   if (interactive && isTTY()) {
     // 欢迎画面
@@ -509,7 +574,8 @@ export async function cmdInit(projectDir, options = {}) {
     }
 
     console.log('');
-    await doInstall(projectDir, selectedTools, subprojects, resolvedSpecDir);
+    await doInstall(projectDir, selectedTools, subprojects, resolvedSpecDir, { noSkills, platformMode: platformOpts != null });
+    writeInitPlatformPointer(projectDir, resolvedSpecDir, platformOpts);
     showSummary(version, selectedTools, resolvedSpecDir);
     return;
   }
@@ -517,18 +583,27 @@ export async function cmdInit(projectDir, options = {}) {
   // ── 默认快速模式：检测 → 安装 → 结束 ──
 
   let tools = [];
-  if (tool) {
-    if (!VALID_TOOLS.includes(tool)) {
-      console.error(`❌ 未知工具: ${tool}`);
-      console.error(`支持的工具: ${VALID_TOOLS.join(', ')}`);
-      process.exit(1);
+  // --tool 多值（tools 数组，index.js 解析逗号分隔/重复 flag 收集）优先；
+  // 兼容旧 tool 单值（程序化调用）。两者都校验 VALID_TOOLS 并合并去重（保序）。
+  const requested = [
+    ...(Array.isArray(toolsOpt) && toolsOpt.length > 0 ? toolsOpt : []),
+    ...(tool ? [tool] : []),
+  ];
+  if (requested.length > 0) {
+    for (const t of requested) {
+      if (!VALID_TOOLS.includes(t)) {
+        console.error(`❌ 未知工具: ${t}`);
+        console.error(`支持的工具: ${VALID_TOOLS.join(', ')}`);
+        process.exit(1);
+      }
     }
-    tools = [tool];
+    tools = [...new Set(requested)];
   } else {
     tools = detectTools(projectDir);
   }
 
-  await doInstall(projectDir, tools, [], resolvedSpecDir);
+  await doInstall(projectDir, tools, [], resolvedSpecDir, { noSkills, platformMode: platformOpts != null });
+  writeInitPlatformPointer(projectDir, resolvedSpecDir, platformOpts);
 
   console.log('');
   console.log(chalk.green(`  ✅ SillySpec v${version} 安装完成！`));
@@ -536,9 +611,12 @@ export async function cmdInit(projectDir, options = {}) {
   const specDisplay = resolvedSpecDir || '.sillyspec';
   console.log(`  📁 规范目录: ${chalk.cyan(specDisplay)}`);
   console.log('');
-  console.log('  下一步：使用 AI 技能开始工作');
-  console.log(`    OpenClaw:    ${chalk.bold('/sillyspec:brainstorm')}`);
-  console.log(`    Claude Code: ${chalk.bold('/sillyspec:brainstorm')}`);
+  // C14c：绿地/棕地引导区分（README:73 棕地应 scan）——early 捕获的目录状态（init 前），
+  // 棕地有代码零上下文进 brainstorm 会迷失，建议先 scan 生成架构文档。
+  const nextCmd = brownfield ? '/sillyspec:scan' : '/sillyspec:brainstorm';
+  console.log('  下一步：使用 AI 技能开始工作' + (brownfield ? '（检测到现有代码，建议先扫描生成架构文档）' : ''));
+  console.log(`    OpenClaw:    ${chalk.bold(nextCmd)}`);
+  console.log(`    Claude Code: ${chalk.bold(nextCmd)}`);
   console.log('');
   console.log(chalk.dim('  💡 增强能力：sillyspec setup（安装 MCP 工具）'));
   console.log('');

package/src/machine-interface.js

@@ -113,14 +113,16 @@ export function buildEnvelope({
  */
 export async function runGate(stage, changeName, { cwd, specBase, runtimeRoot, specDriftAnchor, ctx = null } = {}) {
   const specRoot = specBase || resolveSpecDir(cwd);
-  const pm = new ProgressManager();
+  // A4：pm 用 specRoot（而非默认 resolveSpecDir(cwd)）——--spec-dir/平台模式下 specBase 是真实
+  // specDir，默认解析会指向本地孤儿库，与下方 planContent/changeDir 的 specRoot 两套事实源混拼。
+  const pm = new ProgressManager({ specDir: specRoot });
 
   try {
     // ── 只读契约守卫（D-002@v1）：db 不存在时 fail-closed 返回 exit 2，不触发建库落盘 ──
     // pm.read → _ensureDB → db.init() 在 db 不存在/schema 戳落后时会 _createSchema + _save 落盘
     // （db.js:init），这会让一个声明只读的查询命令在 spec 目录凭空建 sillyspec.db，违反只读契约。
     // db 还没建 = 该变更从未跑过流程，无从核验 → 显式返回「无法核验」而非建库。
-    const dbPath = join(resolveSpecDir(cwd), '.runtime', 'sillyspec.db');
+    const dbPath = join(specRoot, '.runtime', 'sillyspec.db');
     if (!existsSync(dbPath)) {
       const envelope = buildEnvelope({
         command: 'gate',
@@ -356,11 +358,12 @@ export async function runDerive(facet, changeName, { cwd, specBase, runtimeRoot,
   }
 
   const specRoot = specBase || resolveSpecDir(cwd);
-  const pm = new ProgressManager();
+  // A4：同 runGate——pm 用 specRoot 统一事实源，平台/--spec-dir 模式不读本地孤儿库。
+  const pm = new ProgressManager({ specDir: specRoot });
 
   try {
     // ── 只读契约守卫（D-002@v1，同 runGate）：db 不存在时 fail-closed 返回 exit 2，不建库落盘 ──
-    const dbPath = join(resolveSpecDir(cwd), '.runtime', 'sillyspec.db');
+    const dbPath = join(specRoot, '.runtime', 'sillyspec.db');
     if (!existsSync(dbPath)) {
       const envelope = buildEnvelope({
         command: 'derive',