spectra-cli 4.1.1 → 4.3.0

package/dist/batch/regen-plan.d.ts

@@ -0,0 +1,78 @@
+import type { ModuleGroup } from './module-grouper.js';
+/** RegenPlan 的来源标记，用于可观测日志与降级追溯 */
+export type RegenPlanSource = 'full' | 'incremental-explicit' | 'default';
+/**
+ * resolveRegenPlan 的扁平输入。
+ * config 合并由各入口在自己现状位置完成（CLI 在 batch.ts，MCP 在 server.ts 用 `?? fileConfig.x`），
+ * 本函数只接收"合并后的有效值"，不做 cli/mcp/config 笛卡尔积。
+ */
+export interface RegenPlanInput {
+    /** 已合并：--incremental / mcp.incremental / config.incremental */
+    incremental?: boolean;
+    /** 已合并：--full / mcp.full（config 无 full 字段，用 force 表达） */
+    full?: boolean;
+    /** 已合并：--force / mcp.force / config.force（--full 的等义别名） */
+    force?: boolean;
+}
+/** resolveRegenPlan 的解析结果（唯一真值） */
+export interface RegenPlan {
+    /** true = 走 DeltaRegenerator */
+    incremental: boolean;
+    /** true = 绕 DeltaRegenerator + 绕 checkpoint 全量重生成（full|force 合并真值） */
+    full: boolean;
+    /** 来源标记 */
+    source: RegenPlanSource;
+}
+/**
+ * 把"合并后的有效输入"解析为唯一的 RegenPlan。
+ *
+ * 解析规则（优先级自上而下）：
+ *   (1) full===true || force===true → { incremental:false, full:true, source:'full' }
+ *   (2) incremental===true（显式 opt-in，未给 full/force）→ { incremental:true, full:false, source:'incremental-explicit' }
+ *   (3) incremental===false（显式 opt-out）→ { incremental:false, full:false, source:'incremental-explicit' }
+ *   (4) 全 undefined（默认）→ { incremental:true, full:false }（FR-001 默认翻转）
+ *
+ * 显式 incremental===true（规则 2）与显式 incremental===false（规则 3）都尊重调用方意图；
+ * 仅在未给出任何 regen 轴参数时（规则 4）落默认增量（FR-001）。
+ */
+export declare function resolveRegenPlan(input: RegenPlanInput): RegenPlan;
+/**
+ * 把系统路径分隔符归一化为正斜杠。
+ *
+ * Feature 178：batch 内单参口径的唯一来源（delta-regenerator / batch-orchestrator import 此处），
+ * 消除三份逐字副本。注意与 panoramic 的双参变体 `(inputPath, projectRoot)`（先 path.relative）
+ * 语义不同，不在此合并范围。
+ */
+export declare function normalizeProjectPath(inputPath: string): string;
+/**
+ * 计算单个模块的 sourceTarget（与 batch-orchestrator.processOneModule:713-720 等价）。
+ *
+ * H4 修复语义：文件级降级场景（非 root + 单文件 + dirPath 冲突）下 sourceTarget 须与文件路径
+ * 保持一致，否则 --incremental 的 regenerateTargets 查询与 storedSpecByTarget 查询全部错位。
+ *
+ * @param group 模块分组
+ * @param conflictingDirPaths 与其他单文件目录冲突的 dirPath 集合
+ * @param isRoot 是否 root 模块（root 模块按文件展开，调用方自行处理，本函数返回 dirPath 口径）
+ * @returns 归一化后的 sourceTarget
+ */
+export declare function resolveSourceTarget(group: ModuleGroup, conflictingDirPaths: Set<string>, isRoot: boolean): string;
+/**
+ * 从纯路径 sourceTarget 派生增量缓存 key（Feature 182）。
+ *
+ * 修复同目录多语言组 Map 键碰撞：同一 dirPath 被 language-split 成两个 ModuleGroup 时，
+ * resolveSourceTarget 对两组返回相同纯路径，导致 storedSpecByTarget / regenerateTargets
+ * 键碰撞、后写覆盖前写、增量永久 miss。
+ *
+ * 本 helper 仅在 languageSplit 组追加 `::language` 后缀派生唯一 cache key；
+ * 单语言目录维持纯路径（最小化存量缓存失效面）。
+ *
+ * 关键不变量：frontmatter 的 sourceTarget 保持纯路径不变（panoramic / spec-store 路径
+ * 匹配消费方零改动）；cache key 只存在于 src/batch/ 内的 Map/Set 与新增 frontmatter
+ * 字段 sourceTargetKey。
+ *
+ * @param sourceTarget resolveSourceTarget 返回的纯路径
+ * @param group 仅需 language / languageSplit 两字段
+ * @returns 单语言：原路径；语言拆分组：`${sourceTarget}::${language}`
+ */
+export declare function buildSpecCacheKey(sourceTarget: string, group: Pick<ModuleGroup, 'language' | 'languageSplit'>): string;
+//# sourceMappingURL=regen-plan.d.ts.map

package/dist/batch/regen-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regen-plan.d.ts","sourceRoot":"","sources":["../../src/batch/regen-plan.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvD,mCAAmC;AACnC,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,sBAAsB,GACtB,SAAS,CAAC;AAEd;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,IAAI,EAAE,OAAO,CAAC;IACd,WAAW;IACX,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAmBjE;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,EAChC,MAAM,EAAE,OAAO,GACd,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,eAAe,CAAC,GACrD,MAAM,CAIR"}

package/dist/batch/regen-plan.js

@@ -0,0 +1,93 @@
+/**
+ * Batch 重生成计划解析（regen-plan）
+ *
+ * 提供两个纯函数，供 batch 三入口（CLI / MCP / runBatch 直调）与 DeltaRegenerator 共享：
+ *   - resolveRegenPlan：把"已合并后的有效输入"解析为唯一的 RegenPlan 真值
+ *   - resolveSourceTarget：统一 module → sourceTarget 的口径（含目录冲突分支）
+ *
+ * 从 batch-orchestrator.ts 提取，消除 GREEN 阶段在两处分别推演 target / regen 语义的认知负担。
+ */
+import * as path from 'node:path';
+/**
+ * 把"合并后的有效输入"解析为唯一的 RegenPlan。
+ *
+ * 解析规则（优先级自上而下）：
+ *   (1) full===true || force===true → { incremental:false, full:true, source:'full' }
+ *   (2) incremental===true（显式 opt-in，未给 full/force）→ { incremental:true, full:false, source:'incremental-explicit' }
+ *   (3) incremental===false（显式 opt-out）→ { incremental:false, full:false, source:'incremental-explicit' }
+ *   (4) 全 undefined（默认）→ { incremental:true, full:false }（FR-001 默认翻转）
+ *
+ * 显式 incremental===true（规则 2）与显式 incremental===false（规则 3）都尊重调用方意图；
+ * 仅在未给出任何 regen 轴参数时（规则 4）落默认增量（FR-001）。
+ */
+export function resolveRegenPlan(input) {
+    // 规则 (1)：full 或 force 优先（force 是 full 的等义别名）
+    if (input.full === true || input.force === true) {
+        return { incremental: false, full: true, source: 'full' };
+    }
+    // 规则 (2)：显式 incremental=true → 走增量（任何阶段都尊重显式 opt-in）
+    if (input.incremental === true) {
+        return { incremental: true, full: false, source: 'incremental-explicit' };
+    }
+    // 规则 (3)：显式 incremental=false 走旧"仅看文件存在"兼容路径
+    if (input.incremental === false) {
+        return { incremental: false, full: false, source: 'incremental-explicit' };
+    }
+    // 规则 (4)：undefined 默认路径
+    // FR-001 默认翻转：未传任何 regen 轴参数时走增量（DeltaRegenerator）。
+    return { incremental: true, full: false, source: 'default' };
+}
+// ============================================================
+// resolveSourceTarget：统一 module → sourceTarget 口径
+// ============================================================
+/**
+ * 把系统路径分隔符归一化为正斜杠。
+ *
+ * Feature 178：batch 内单参口径的唯一来源（delta-regenerator / batch-orchestrator import 此处），
+ * 消除三份逐字副本。注意与 panoramic 的双参变体 `(inputPath, projectRoot)`（先 path.relative）
+ * 语义不同，不在此合并范围。
+ */
+export function normalizeProjectPath(inputPath) {
+    return inputPath.split(path.sep).join('/');
+}
+/**
+ * 计算单个模块的 sourceTarget（与 batch-orchestrator.processOneModule:713-720 等价）。
+ *
+ * H4 修复语义：文件级降级场景（非 root + 单文件 + dirPath 冲突）下 sourceTarget 须与文件路径
+ * 保持一致，否则 --incremental 的 regenerateTargets 查询与 storedSpecByTarget 查询全部错位。
+ *
+ * @param group 模块分组
+ * @param conflictingDirPaths 与其他单文件目录冲突的 dirPath 集合
+ * @param isRoot 是否 root 模块（root 模块按文件展开，调用方自行处理，本函数返回 dirPath 口径）
+ * @returns 归一化后的 sourceTarget
+ */
+export function resolveSourceTarget(group, conflictingDirPaths, isRoot) {
+    const hasDirPathConflict = !isRoot && group.files.length === 1 && conflictingDirPaths.has(group.dirPath);
+    return hasDirPathConflict
+        ? normalizeProjectPath(group.files[0])
+        : normalizeProjectPath(group.dirPath);
+}
+/**
+ * 从纯路径 sourceTarget 派生增量缓存 key（Feature 182）。
+ *
+ * 修复同目录多语言组 Map 键碰撞：同一 dirPath 被 language-split 成两个 ModuleGroup 时，
+ * resolveSourceTarget 对两组返回相同纯路径，导致 storedSpecByTarget / regenerateTargets
+ * 键碰撞、后写覆盖前写、增量永久 miss。
+ *
+ * 本 helper 仅在 languageSplit 组追加 `::language` 后缀派生唯一 cache key；
+ * 单语言目录维持纯路径（最小化存量缓存失效面）。
+ *
+ * 关键不变量：frontmatter 的 sourceTarget 保持纯路径不变（panoramic / spec-store 路径
+ * 匹配消费方零改动）；cache key 只存在于 src/batch/ 内的 Map/Set 与新增 frontmatter
+ * 字段 sourceTargetKey。
+ *
+ * @param sourceTarget resolveSourceTarget 返回的纯路径
+ * @param group 仅需 language / languageSplit 两字段
+ * @returns 单语言：原路径；语言拆分组：`${sourceTarget}::${language}`
+ */
+export function buildSpecCacheKey(sourceTarget, group) {
+    return group.languageSplit && group.language
+        ? `${sourceTarget}::${group.language}`
+        : sourceTarget;
+}
+//# sourceMappingURL=regen-plan.js.map

package/dist/batch/regen-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regen-plan.js","sourceRoot":"","sources":["../../src/batch/regen-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAqClC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,6CAA6C;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC5D,CAAC;IAED,qDAAqD;IACrD,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC5E,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QAChC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC7E,CAAC;IAED,wBAAwB;IACxB,oDAAoD;IACpD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/D,CAAC;AAED,+DAA+D;AAC/D,kDAAkD;AAClD,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAkB,EAClB,mBAAgC,EAChC,MAAe;IAEf,MAAM,kBAAkB,GACtB,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChF,OAAO,kBAAkB;QACvB,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACvC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,KAAsD;IAEtD,OAAO,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,QAAQ;QAC1C,CAAC,CAAC,GAAG,YAAY,KAAK,KAAK,CAAC,QAAQ,EAAE;QACtC,CAAC,CAAC,YAAY,CAAC;AACnB,CAAC"}

package/dist/cli/commands/batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/batch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAqBzD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmHzF"}
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/batch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAqBzD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkJzF"}

package/dist/cli/commands/batch.js

@@ -3,7 +3,8 @@
  * 对当前项目执行批量 Spec 生成
  */
 import { resolve } from 'node:path';
-import { runBatch } from '../../batch/batch-orchestrator.js';
+import { runBatch, buildAstGraphOnly } from '../../batch/batch-orchestrator.js';
+import { resolveRegenPlan } from '../../batch/regen-plan.js';
 import { checkAuth, handleError, EXIT_CODES } from '../utils/error-handler.js';
 import { loadProjectConfig, mergeConfig } from '../../config/project-config.js';
 import { readBatchConcurrency } from '../../config/spec-driver-config.js';
@@ -27,10 +28,6 @@ function resolveBatchConcurrency(cliConcurrency, projectRoot) {
  */
 export async function runBatchCommand(command, version) {
     console.log(`spectra v${version} — 批量生成`);
-    if (!checkAuth()) {
-        process.exitCode = EXIT_CODES.API_ERROR;
-        return;
-    }
     try {
         // 解析目标路径：优先使用 CLI 传入的 target，其次使用 cwd
         const projectRoot = resolve(command.target ?? process.cwd());
@@ -42,15 +39,46 @@ export async function runBatchCommand(command, version) {
             languages: command.languages,
             outputDir: command.outputDir,
         }, fileConfig, command._explicitFlags ?? new Set());
+        // F195：graph-only 零 LLM 建图——在 checkAuth 之前拦截并 dispatch 到姊妹管线。
+        // why 不调 checkAuth：graph-only 纯 AST、不调任何 LLM，行为对齐 prepare（FR-005）。
+        // why 放在 projectRoot + config merge 之后：buildAstGraphOnly 需要 projectRoot 与 outputDir。
+        if (command.batchMode === 'graph-only') {
+            if (command.languages?.length) {
+                console.warn('⚠ graph-only 不支持 --languages 过滤，将构建全仓 AST 图');
+            }
+            const graphResult = await buildAstGraphOnly(projectRoot, {
+                outputDir: merged.outputDir,
+            });
+            console.log('  模式: graph-only（纯 AST · 零 LLM）');
+            console.log(`  节点: ${graphResult.nodeCount} | 边: ${graphResult.edgeCount} ` +
+                `(calls ${graphResult.callEdgeCount}, depends-on ${graphResult.dependsOnEdgeCount}) ` +
+                `| Python 符号: ${graphResult.pythonSymbolCount} | 耗时: ${(graphResult.durationMs / 1000).toFixed(1)}s`);
+            console.log(`✓ 知识图谱: ${graphResult.graphPath}`);
+            process.exitCode = EXIT_CODES.SUCCESS;
+            return;
+        }
+        // 非 graph-only 路径：spec-gen 需要认证
+        if (!checkAuth()) {
+            process.exitCode = EXIT_CODES.API_ERROR;
+            return;
+        }
+        // F175 FR-002：合并后统一解析 regen 计划（唯一默认值来源，消除三处漂移）。
+        // --full（regen 轴逃生口）仅来自 CLI，不参与 config 合并；--force 为等义别名（已合并）。
+        const regenPlan = resolveRegenPlan({
+            incremental: merged.incremental,
+            full: command.full,
+            force: merged.force,
+        });
         // Feature 135 Bug 4：reading 模式 TTY hint
         // 避免用户误以为 reading 模式是"快速模式"——模块级 LLM 仍会运行
         if (command.batchMode === 'reading' && process.stdout.isTTY) {
             console.log('提示：reading 模式省约 38% 时间，但模块级 LLM 仍运行（非快速模式）。\n' +
-                '如需最快分析（< 30s），请使用 --mode code-only');
+                '如需进一步跳过 enrichment 层，可使用 --mode code-only（注：仍逐模块调 spec-gen LLM，非零成本）');
         }
         const result = await runBatch(projectRoot, {
-            force: merged.force,
-            incremental: merged.incremental,
+            // F175：传入已解析的 RegenPlan 真值（runBatch 内对直接调用方仍会兜底解析，幂等）。
+            incremental: regenPlan.incremental,
+            full: regenPlan.full,
             languages: merged.languages,
             outputDir: merged.outputDir,
             concurrency: resolveBatchConcurrency(command.concurrency, projectRoot),

package/dist/cli/commands/batch.js.map

@@ -1 +1 @@
-{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../../src/cli/commands/batch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../../src/cli/commands/batch.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/graph.js

@@ -123,7 +123,7 @@ export async function runGraphCommand(command) {
     const outputDir = command.outputDir ?? path.join(process.cwd(), 'specs');
     // 加载 ArchitectureIR（从磁盘缓存读取）
     const architectureIR = loadArchitectureIR(outputDir);
-    // 构建轻量 DocGraph（基于已存储 spec 文件，无需 DependencyGraph）
+    // 构建轻量 DocGraph（基于已存储 spec 文件，无需 ModuleGraph）
     // 通过 SpecStore 过滤，排除 orphan/bundle_copy/derived
     let docGraph;
     try {

package/dist/cli/commands/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/cli/commands/graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/cli/commands/graph.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,8 @@
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 spectra index 子命令。
+ *
+ * @param command 已解析的 CLICommand
+ */
+export declare function runIndexCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA2DzD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCxE"}

package/dist/cli/commands/index.js

@@ -0,0 +1,274 @@
+/**
+ * Feature 156 — `spectra index` 子命令 handler。
+ *
+ * 三种运行模式（W3 阶段全部实装）：
+ *   spectra index               → 全量索引：扫描全部源文件 → buildUnifiedGraph →
+ *                                  写入 .spectra/unified-graph.json（FR-11 / AC-9）
+ *   spectra index --incremental → 一次性增量更新（FR-30 + buildIncremental 路径）
+ *   spectra index --watch       → 持续监听模式（FR-12 + FileWatcher + buildIncremental 批量路径）
+ *   spectra index --caller-depth N → 默认 1，clarify Q3 决议（接口预留 N）
+ *
+ * 进度输出（FR-14 SHOULD）：每个阶段输出一行机器可读 JSON（`scan` / `build` /
+ * `save` / `done` / `diff` / `caller-expand` / `watch` / `fallback`），方便上游脚本用 `jq` 提取关键字段。
+ *
+ * --watch 与 --incremental 互斥（FR-30）：两个 flag 同时传入 → 错误 + exit 1。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { scanFiles } from '../../utils/file-scanner.js';
+import { LanguageAdapterRegistry } from '../../adapters/language-adapter-registry.js';
+import { analyzeFile } from '../../core/ast-analyzer.js';
+import { buildUnifiedGraph } from '../../knowledge-graph/index.js';
+import { buildSnapshotWrapper, computeAllFileHashes, saveSnapshot, snapshotPath, } from '../../knowledge-graph/persistence.js';
+import { buildIncremental } from '../../knowledge-graph/incremental.js';
+import { FileWatcher } from '../../watcher/file-watcher.js';
+const INDEX_HELP = `spectra index — 构建并持久化 UnifiedGraph snapshot
+
+用法:
+  spectra index                       全量索引（扫描所有源文件 + 写 .spectra/unified-graph.json）
+  spectra index --incremental         一次性增量更新（基于 git diff + caller expansion）
+  spectra index --watch               持续监听模式（chokidar + 批量 incremental，进程不退出）
+  spectra index --caller-depth <N>    增量 caller 扩展深度（默认 1，接口预留 N）
+  spectra index --git-range <ref>     post-commit hook 上下文的 git ref 范围（默认 'HEAD'，
+                                       仅 --incremental 时生效；仅允许预设格式如 'ORIG_HEAD HEAD'）
+  spectra index --project-root <dir>  指定项目根目录（默认 cwd）
+
+说明:
+  --watch 与 --incremental 互斥；同时传入将导致 exit 1。
+  --watch 模式监听 .gitignore 之外的源码文件（chokidar v4 + .gitignore 过滤）。
+  --incremental 在无 snapshot / shallow clone 等场景自动降级为全量索引（仍 exit 0）。
+
+输出:
+  {project-root}/.spectra/unified-graph.json    (pretty JSON，含 SnapshotWrapperSchema)
+
+退出码:
+  0  成功（含 --watch 用户 Ctrl+C / --incremental 降级 full）
+  1  --watch 与 --incremental 互斥参数冲突，或 --project-root 不存在
+  2  索引失败（文件读写 / AST 解析错误）`;
+/** 输出一行机器可读 JSON 进度（FR-14） */
+function emit(line) {
+    process.stdout.write(`${JSON.stringify(line)}\n`);
+}
+/**
+ * 执行 spectra index 子命令。
+ *
+ * @param command 已解析的 CLICommand
+ */
+export async function runIndexCommand(command) {
+    if (command.help) {
+        console.log(INDEX_HELP);
+        return;
+    }
+    // FR-30：--watch 与 --incremental 互斥
+    if (command.indexWatch && command.indexIncremental) {
+        console.error('[index] --watch 与 --incremental 互斥，不能同时传入');
+        process.exitCode = 1;
+        return;
+    }
+    // 默认值 = 1（FR-7 / clarify Q3）
+    const callerDepth = command.indexCallerDepth ?? 1;
+    const projectRoot = path.resolve(command.projectRoot ?? process.cwd());
+    if (!fs.existsSync(projectRoot)) {
+        console.error(`[index] 项目目录不存在: ${projectRoot}`);
+        process.exitCode = 2;
+        return;
+    }
+    // ── --watch 模式（持续监听）──
+    if (command.indexWatch) {
+        await runWatchMode(projectRoot, callerDepth);
+        return;
+    }
+    // ── --incremental 模式（一次性增量）──
+    if (command.indexIncremental) {
+        await runIncrementalOnce(projectRoot, callerDepth, command.indexGitRange);
+        return;
+    }
+    // ── 默认：全量索引 ──
+    await runFullIndex(projectRoot);
+}
+// ───────────────────────────────────────────────────────────
+// 全量索引（保持 W2 行为不变）
+// ───────────────────────────────────────────────────────────
+async function runFullIndex(projectRoot) {
+    const t0 = Date.now();
+    try {
+        const registry = LanguageAdapterRegistry.getInstance();
+        const supportedExts = registry.getSupportedExtensions();
+        const scanResult = scanFiles(projectRoot, {
+            projectRoot,
+            extensions: supportedExts,
+        });
+        const absFiles = scanResult.files.map((rel) => path.isAbsolute(rel) ? rel : path.join(projectRoot, rel));
+        emit({ phase: 'scan', files: absFiles.length });
+        if (absFiles.length === 0) {
+            emit({ phase: 'skip', reason: 'no-source-files' });
+        }
+        const tBuild0 = Date.now();
+        const codeSkeletons = new Map();
+        for (const absFile of absFiles) {
+            try {
+                const sk = await analyzeFile(absFile, { projectRoot });
+                if (sk)
+                    codeSkeletons.set(absFile, sk);
+            }
+            catch (err) {
+                console.error(`[index] analyzeFile 失败 (${absFile}): ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        const graph = buildUnifiedGraph({ projectRoot, codeSkeletons });
+        emit({
+            phase: 'build',
+            duration_ms: Date.now() - tBuild0,
+            nodes: graph.nodes.length,
+            edges: graph.edges.length,
+        });
+        const fileHashes = await computeAllFileHashes(projectRoot, absFiles);
+        const tSave0 = Date.now();
+        const snapshot = buildSnapshotWrapper(graph, fileHashes);
+        await saveSnapshot(snapshot, projectRoot);
+        const targetPath = snapshotPath(projectRoot);
+        let sizeBytes = 0;
+        try {
+            sizeBytes = fs.statSync(targetPath).size;
+        }
+        catch {
+            /* 文件应该存在，仅统计用 */
+        }
+        emit({
+            phase: 'save',
+            path: path.relative(projectRoot, targetPath),
+            size_bytes: sizeBytes,
+            duration_ms: Date.now() - tSave0,
+        });
+        emit({
+            phase: 'done',
+            mode: 'full',
+            total_ms: Date.now() - t0,
+            changedFiles: -1,
+        });
+    }
+    catch (err) {
+        console.error(`[index] 索引失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 2;
+    }
+}
+// ───────────────────────────────────────────────────────────
+// --incremental 一次性增量
+// ───────────────────────────────────────────────────────────
+async function runIncrementalOnce(projectRoot, callerDepth, gitRange) {
+    const t0 = Date.now();
+    try {
+        const tBuild0 = Date.now();
+        const result = await buildIncremental({ projectRoot, callerDepth, gitRange });
+        if (result.fallbackToFull) {
+            // 输出 fallback 信号，但保持 exit 0（git hook 兼容）
+            emit({ phase: 'fallback', reason: result.fallbackReason ?? 'unknown' });
+        }
+        else {
+            // W3 WARN-3：'diff' 输出原始 git diff 数；'caller-expand' 输出"扩展数"（差值）
+            emit({ phase: 'diff', changedFiles: result.origChangedFilesCount });
+            emit({
+                phase: 'caller-expand',
+                expanded: Math.max(0, result.changedFiles.length - result.origChangedFilesCount),
+            });
+        }
+        emit({
+            phase: 'build',
+            duration_ms: Date.now() - tBuild0,
+            nodes: result.snapshot.graph.nodes.length,
+            edges: result.snapshot.graph.edges.length,
+        });
+        const targetPath = snapshotPath(projectRoot);
+        let sizeBytes = 0;
+        try {
+            sizeBytes = fs.statSync(targetPath).size;
+        }
+        catch {
+            /* 空 diff 短路时未触发写盘也算正常 */
+        }
+        emit({
+            phase: 'save',
+            path: path.relative(projectRoot, targetPath),
+            size_bytes: sizeBytes,
+        });
+        // spec AC-4：第二次无变更时输出 skippedReason: 'no-diff' 让消费方区分"真无变更"vs "fallback"
+        const isNoDiff = !result.fallbackToFull && result.changedFiles.length === 0;
+        emit({
+            phase: 'done',
+            mode: 'incremental',
+            total_ms: Date.now() - t0,
+            changedFiles: result.changedFiles.length,
+            fallbackToFull: result.fallbackToFull,
+            ...(isNoDiff ? { skippedReason: 'no-diff' } : {}),
+        });
+    }
+    catch (err) {
+        console.error(`[index] 增量索引失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 2;
+    }
+}
+// ───────────────────────────────────────────────────────────
+// --watch 持续监听
+// ───────────────────────────────────────────────────────────
+async function runWatchMode(projectRoot, callerDepth) {
+    // 启动前先确保有一份 baseline snapshot：若不存在则跑一次全量
+    const baselinePath = snapshotPath(projectRoot);
+    if (!fs.existsSync(baselinePath)) {
+        emit({ phase: 'watch', event: 'baseline-missing-running-full' });
+        await runFullIndex(projectRoot);
+    }
+    // FileWatcher 内部处理 debounce + .gitignore 过滤；W3 用 200ms（clarify Q-D1 决议）
+    const watcher = new FileWatcher({
+        projectRoot,
+        debounceMs: 200,
+        verbose: false,
+    }, async (events) => {
+        // WARN-1 关闭：events 是批量数组，需聚合 path 并过滤 category === 'code'
+        const changedPaths = new Set(events.filter((e) => e.category === 'code').map((e) => e.path));
+        if (changedPaths.size === 0)
+            return;
+        const tInc0 = Date.now();
+        try {
+            const result = await buildIncremental({
+                projectRoot,
+                callerDepth,
+                changedFilesOverride: Array.from(changedPaths),
+            });
+            if (result.fallbackToFull) {
+                emit({
+                    phase: 'fallback',
+                    reason: result.fallbackReason ?? 'unknown',
+                    context: 'watch',
+                });
+            }
+            emit({
+                phase: 'watch',
+                changedFiles: changedPaths.size,
+                expandedFiles: result.changedFiles.length,
+                duration_ms: Date.now() - tInc0,
+            });
+        }
+        catch (err) {
+            console.error(`[index] watch incremental 失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    await watcher.start();
+    emit({ phase: 'watch-ready', projectRoot });
+    // SIGINT / SIGTERM 优雅退出
+    await new Promise((resolve) => {
+        const shutdown = async (signal) => {
+            emit({ phase: 'watch', event: 'shutdown', signal });
+            try {
+                await watcher.stop();
+            }
+            catch {
+                /* 忽略关闭错误 */
+            }
+            resolve();
+        };
+        process.once('SIGINT', () => void shutdown('SIGINT'));
+        process.once('SIGTERM', () => void shutdown('SIGTERM'));
+    });
+    // exit code = 0（用户主动 Ctrl+C 视为正常退出）
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA4BzD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxE"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA4BzD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDxE"}

package/dist/cli/commands/query.js

@@ -57,9 +57,11 @@ export async function runQueryCommand(command) {
         return;
     }
     // 加载图谱并执行查询
+    // F170e：透传 process.cwd() 作为 projectRoot（与 graphPath 同源），
+    // 让 engine 内部文件定位与 CLI 运行目录一致。
     let engine;
     try {
-        engine = GraphQueryEngine.loadFromFile(graphPath);
+        engine = GraphQueryEngine.loadFromFile(graphPath, process.cwd());
     }
     catch (err) {
         console.error(`[query] 加载图谱失败：${err instanceof Error ? err.message : String(err)}`);