sillyspec 3.26.7 → 3.26.8

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,7 +466,7 @@ 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;
 
@@ -509,7 +566,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 +575,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} 安装完成！`));