spectra-cli 4.1.1 → 4.2.0

package/dist/runtime-bootstrap.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 一次性初始化 spectra runtime 的 3 个 registry。
+ *
+ * @param outputDir 可选的 generator 输出目录（透传给 bootstrapGenerators）。
+ *   - mcp / cli 入口通常省略（generator 内部使用默认值）
+ *   - batch / audit 入口可传入特定的 outputDir 指定 panoramic 文档落点
+ */
+export declare function bootstrapRuntime(outputDir?: string): void;
+//# sourceMappingURL=runtime-bootstrap.d.ts.map

package/dist/runtime-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bootstrap.d.ts","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAqBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAIzD"}

package/dist/runtime-bootstrap.js

@@ -0,0 +1,33 @@
+/**
+ * 单一 runtime 初始化入口（FR-10 + SC-007）。
+ *
+ * 所有 entry point 必须调用 `bootstrapRuntime()`：
+ * - src/mcp/server.ts（MCP entry）
+ * - src/cli/index.ts（CLI entry）
+ * - src/panoramic/batch-project-docs.ts（batch entry）
+ * - src/panoramic/pipelines/coverage-auditor.ts（audit entry）
+ *
+ * 幂等性：内部 3 个 bootstrap 函数本身已幂等
+ *（registry 非空时跳过；详见 generator-registry.ts / parser-registry.ts / adapters/index.ts）。
+ *
+ * SC-007 验收：
+ *   grep -rE 'bootstrap(Adapters|Generators|Parsers)\(' src/ \
+ *     | grep -v 'src/runtime-bootstrap.ts'
+ *   → 期望 0 行命中（仅本文件调用 3 个 bootstrap 函数）
+ */
+import { bootstrapAdapters } from './adapters/index.js';
+import { bootstrapGenerators } from './panoramic/generator-registry.js';
+import { bootstrapParsers } from './panoramic/parser-registry.js';
+/**
+ * 一次性初始化 spectra runtime 的 3 个 registry。
+ *
+ * @param outputDir 可选的 generator 输出目录（透传给 bootstrapGenerators）。
+ *   - mcp / cli 入口通常省略（generator 内部使用默认值）
+ *   - batch / audit 入口可传入特定的 outputDir 指定 panoramic 文档落点
+ */
+export function bootstrapRuntime(outputDir) {
+    bootstrapAdapters();
+    bootstrapGenerators(outputDir);
+    bootstrapParsers();
+}
+//# sourceMappingURL=runtime-bootstrap.js.map

package/dist/runtime-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,iBAAiB,EAAE,CAAC;IACpB,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC/B,gBAAgB,EAAE,CAAC;AACrB,CAAC"}

package/dist/utils/file-scanner.js

@@ -270,7 +270,7 @@ export function scanFiles(targetDir, options) {
     const registry = LanguageAdapterRegistry.getInstance();
     if (registry.isEmpty() && !options?.extensions) {
         throw new Error('LanguageAdapterRegistry 未注册任何适配器。' +
-            '请在使用前调用 bootstrapAdapters() 完成初始化。');
+            '请在使用前调用 bootstrapRuntime（src/runtime-bootstrap.ts）完成初始化。');
     }
     // 获取当前有效的支持扩展名和忽略目录
     const supportedExtensions = getSupportedExtensions(options);

package/dist/utils/file-scanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../../src/utils/file-scanner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file-scanner.js","sourceRoot":"","sources":["../../src/utils/file-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAEnF,yBAAyB;AACzB,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,MAAM;IACN,MAAM;IACN,WAAW;IACX,UAAU;IACV,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,OAAO;IACP,aAAa;IACb,QAAQ;IACR,aAAa;IACb,OAAO;IACP,MAAM;IACN,KAAK;IACL,oBAAoB;IACpB,UAAU;IACV,SAAS;IACT,QAAQ;IACR,UAAU;IACV,cAAc;IACd,UAAU;IACV,eAAe;IACf,cAAc;IACd,QAAQ;IACR,eAAe;IACf,QAAQ;CACT,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,oBAAoB,GAA2B;IACnD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;GAGG;AACH,SAAS,aAAa;IACpB,MAAM,YAAY,GAAG,uBAAuB,CAAC,WAAW,EAAE,CAAC,oBAAoB,EAAE,CAAC;IAClF,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,qBAAqB,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,OAAqB;IACnD,IAAI,OAAO,EAAE,UAAU;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACnD,OAAO,uBAAuB,CAAC,WAAW,EAAE,CAAC,sBAAsB,EAAE,CAAC;AACxE,CAAC;AAkCD;;;GAGG;AACH,SAAS,cAAc,CAAC,aAAqB;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAgD,EAAE,CAAC;IAEjE,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,UAAU;QACV,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAE5C,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,OAAO;QACP,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,yBAAyB;QACzB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QAED,gBAAgB;QAChB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,CAAC,YAAoB,EAAW,EAAE;QACvC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC/B,OAAO,GAAG,CAAC,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe,EAAE,YAAqB;IACzD,IAAI,KAAK,GAAG,EAAE,CAAC;IAEf,2BAA2B;IAC3B,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,YAAY;gBACZ,KAAK,IAAI,IAAI,CAAC;gBACd,CAAC,EAAE,CAAC,CAAC,UAAU;gBACf,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3B,CAAC,EAAE,CAAC,CAAC,OAAO;gBACd,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,cAAc;gBACd,KAAK,IAAI,OAAO,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,IAAI,MAAM,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACxB,KAAK,IAAI,KAAK,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,uBAAuB;QACvB,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,QAAQ,KAAK,OAAO,CAAC;QAC9B,CAAC;QACD,OAAO,QAAQ,KAAK,GAAG,CAAC;IAC1B,CAAC;IAED,kBAAkB;IAClB,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,IAAI,KAAK,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,KAAK,GAAG,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,OAAO,CACd,GAAW,EACX,OAAe,EACf,SAA4C,EAC5C,mBAAgC,EAChC,UAAuB,EACvB,OAAiB,EACjB,KAAgD,EAChD,WAAgC,EAChC,aAA4C;IAE5C,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;QACd,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,EAAE,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEtD,2BAA2B;QAC3B,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QAED,SAAS;QACT,IAAI,KAAK,CAAC,cAAc,EAAE,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,mBAAmB;QACnB,IAAI,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QACrH,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,CAAC,YAAY,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACnD,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAE3B,oCAAoC;gBACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBAC/C,IAAI,QAAQ,EAAE,CAAC;wBACb,QAAQ,CAAC,SAAS,EAAE,CAAC;wBACrB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;4BACvC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBAChC,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE;4BAC5B,SAAS,EAAE,OAAO,CAAC,EAAE;4BACrB,SAAS,EAAE,CAAC;4BACZ,UAAU,EAAE,CAAC,GAAG,CAAC;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChB,0BAA0B;gBAC1B,IAAI,GAAG,EAAE,CAAC;oBACR,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,OAAqB;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,EAAE,CAAC;IACvD,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,mCAAmC;YACnC,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IAEnC,gBAAgB;IAChB,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,WAAW,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;IAErD,WAAW;IACX,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,YAAoB,EAAW,EAAE;QAClD,IAAI,cAAc,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC9C,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE1D,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,aAAa,CAAC,CAAC;IAElI,QAAQ;IACR,KAAK,CAAC,IAAI,EAAE,CAAC;IAEb,qCAAqC;IACrC,IAAI,qBAAqB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACnC,WAAW;QACX,MAAM,MAAM,GAAG,CAAC,GAAG,qBAAqB,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,GAAG,OAAO,QAAQ,OAAO,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM,GAAG,UAAU,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,KAAK;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,qBAAqB,EAAE,qBAAqB,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;QACzF,aAAa,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;KAClE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectra-cli",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "description": "通过 AST 静态分析 + LLM 混合流水线，将源代码逆向工程为结构化 Spec 文档的多语言代码分析平台",
   "type": "module",
   "main": "dist/index.js",
@@ -26,6 +26,7 @@
     "test:integration": "vitest run --project integration",
     "test:e2e": "vitest run --project e2e",
     "lint": "tsc --noEmit",
+    "typecheck:tests": "tsc -p tests/type-tests/tsconfig.json --noEmit",
     "docs:sync:agents": "node scripts/sync-agent-docs.mjs",
     "repo:sync": "node scripts/repo-sync.mjs",
     "repo:check": "node scripts/repo-check.mjs",
@@ -33,6 +34,15 @@
     "release:check": "node scripts/validate-release-contracts.mjs",
     "baseline:collect": "node scripts/baseline-collect.mjs",
     "baseline:diff": "node scripts/baseline-diff.mjs",
+    "eval:competitor": "node scripts/eval-competitor.mjs",
+    "eval:judge": "node scripts/eval-judge.mjs",
+    "eval:judge-jury": "node scripts/eval-judge-jury.mjs",
+    "eval:fixture-check": "node scripts/eval-task-fixture-check.mjs",
+    "eval:grounding": "node scripts/eval-grounding.mjs",
+    "eval:task-runner": "node scripts/eval-task-runner.mjs",
+    "eval:refresh-self": "node scripts/eval-refresh-self.mjs",
+    "eval:report": "node scripts/eval-report.mjs",
+    "eval:repeat": "node scripts/eval-batch-repeat.mjs",
     "hooks:install": "bash scripts/install-hooks.sh",
     "hooks:check": "bash scripts/check-plugin-sync.sh",
     "worktree:sync-local-state": "bash scripts/sync-worktree-local-state.sh",
@@ -57,11 +67,11 @@
     "@anthropic-ai/sdk": "^0.39.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chokidar": "^4.0.3",
-    "dependency-cruiser": "^16.8.0",
     "graphology": "^0.26.0",
     "graphology-communities-louvain": "^2.0.2",
     "graphology-types": "^0.24.8",
     "handlebars": "^4.7.8",
+    "openai": "^6.37.0",
     "p-limit": "^6.1.0",
     "ts-morph": "^24.0.0",
     "web-tree-sitter": "^0.24.7",

package/plugins/spec-driver/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-driver",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "自治研发编排器——支持 feature/implement/story/fix/resume/sync/doc/refactor 八种模式自动执行 Spec-Driven Development 全流程，基于 orchestration.yaml 配置驱动编排，含 6 个质量门禁、sync 确定性合并引擎，以及项目级 orchestration overrides 分层定制",
   "author": {
     "name": "Connor Lu"

package/plugins/spec-driver/README.md

@@ -1,6 +1,6 @@
 # Spec Driver
 
-> 当前发布版本: v4.0.0
+> 当前发布版本: v4.2.0
 
 **自治研发编排器** — 支持 8 种模式（feature/implement/story/fix/resume/sync/doc/refactor），一键触发 Spec-Driven Development 全流程。基于 orchestration.yaml 配置驱动，含 6 个质量门禁和 15 个专业子代理。
 
@@ -396,6 +396,23 @@ Plugin 名称从 `speckitdriver` 更名为 `spec-driver`，技能名统一为 `s
 
 所有 Codex wrapper 都会写入 `Wrapper Source Contract` 头部，并通过 `validate-wrapper-sources.mjs` 校验是否仍与 canonical source 一致。
 
+## Spectra MCP 集成
+
+Spec Driver v4.2.0 起，5 个核心 sub-agent（`plan` / `implement` / `verify` / `spec-review` / `quality-review`）已预置 spectra MCP 工具的正确 plugin namespace，实现 **2 步开箱即用**：
+
+```bash
+# Step 1: 安装两个 plugin
+claude plugin install spectra
+claude plugin install spec-driver
+
+# Step 2: 直接使用（无需额外配置）
+/spec-driver:spec-driver-feature 描述需求
+```
+
+sub-agent 会自动调用 `mcp__plugin_spectra_spectra__context` / `impact` / `detect_changes` 工具。
+
+详情见 [docs/spectra-mcp-integration.md](./docs/spectra-mcp-integration.md)，fork 用户应急方案见 [docs/customization.md](./docs/customization.md)。
+
 ## 许可证
 
 MIT

package/plugins/spec-driver/agents/implement.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
+tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, mcp__plugin_spectra_spectra__context, mcp__plugin_spectra_spectra__impact]
 effort: high
 ---
 
@@ -10,6 +10,25 @@ effort: high
 
 你是 Spec Driver 的**代码实现**子代理，负责按 tasks.md 中的任务清单逐步实现代码。你是高级开发工程师，严格遵循技术计划和任务依赖，产出高质量、可维护的代码。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/plan.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Write, Grep, Glob]
+tools: [Read, Write, Grep, Glob, mcp__plugin_spectra_spectra__context, mcp__plugin_spectra_spectra__impact]
 effort: high
 ---
 
@@ -10,6 +10,25 @@ effort: high
 
 你是 Spec Driver 的**技术规划**子代理，负责基于需求规范和调研结论，生成完整的技术实现计划。你是架构师角色，将"做什么"转化为"怎么做"。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/quality-review.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Bash, Grep, Glob]
+tools: [Read, Bash, Grep, Glob, mcp__plugin_spectra_spectra__impact, mcp__plugin_spectra_spectra__context]
 effort: medium
 ---
 
@@ -10,6 +10,25 @@ effort: medium
 
 你是 Spec Driver 的 **代码质量审查员**，负责从架构合理性、设计模式、安全性、性能、可读性、可维护性六个维度评估代码质量。你是资深代码审查专家，聚焦发现潜在的技术风险、结构问题和长期维护隐患。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/spec-review.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Grep, Glob]
+tools: [Read, Grep, Glob, mcp__plugin_spectra_spectra__impact, mcp__plugin_spectra_spectra__context]
 effort: medium
 ---
 
@@ -10,6 +10,25 @@ effort: medium
 
 你是 Spec Driver 的 **Spec 合规审查员**，负责逐条检查 spec.md 中的每个功能需求（FR）的实现状态。你是需求合规专家，确保交付物严格对齐需求规范，不遗漏、不偏离、不过度实现。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "找 callee" / "X 调用了什么" / "依赖什么" | `mcp__plugin_spectra_spectra__context` | 提供 symbol 360° 上下文 (definition + callers + callees + imports) |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/agents/verify.md

@@ -1,6 +1,6 @@
 ---
 model: sonnet
-tools: [Read, Bash, Grep, Glob]
+tools: [Read, Bash, Grep, Glob, mcp__plugin_spectra_spectra__detect_changes, mcp__plugin_spectra_spectra__impact]
 effort: medium
 ---
 
@@ -10,6 +10,25 @@ effort: medium
 
 你是 Spec Driver 的**验证闭环**子代理，负责在代码实现完成后执行两层验证：Layer 1 Spec-Code 对齐验证（语言无关）+ Layer 2 项目原生工具链验证（语言相关）。你是质量工程师，确保交付物符合需求规范且通过技术质量检查。
 
+<!-- BEGIN preference-rules (generated from templates/preference-rules.md; do not edit) -->
+## 工具优先使用规则（M7 F170d）
+
+当面对以下类任务时，**优先调用 spectra MCP 工具而非 Read/Grep**：
+
+| 任务关键词 | 优先工具 | 理由 |
+|----------|---------|------|
+| "找 caller" / "谁调用了 X" / "caller analysis" | `mcp__plugin_spectra_spectra__impact` (direction=upstream) | 提供 transitive caller chain + confidence score，Grep 仅文本匹配无依赖深度 |
+| "评估改动影响" / "blast radius" / "影响面" | `mcp__plugin_spectra_spectra__impact` | 提供 BFS 受影响 symbol 列表 + summary |
+| "git diff 影响" / "改了哪些 symbol" / "PR review 范围" | `mcp__plugin_spectra_spectra__detect_changes` | 从 diff 派生 changedSymbols + impact 链 |
+
+### 关键原则
+
+- **Grep 仍是 fallback**：当 Spectra MCP 工具返回 graph-not-built / 不可用时退回 Grep
+- **不能省略调用**：不要因为"觉得 Grep 够用"跳过 MCP — 即使任务可以用 Grep 解决，MCP 提供的 transitive 数据更可信
+- **chained 使用**：detect_changes → impact → context 是典型链路，按 nextStepHint 引导继续调用
+- **不要 N+1**：单次 impact 调用即可拿到 BFS 全 list，不需要多次 Grep 累计
+<!-- END preference-rules -->
+
 ## 输入
 
 - 读取制品：

package/plugins/spec-driver/docs/customization.md

@@ -0,0 +1,134 @@
+# Spec Driver 定制指引（Fork 用户）
+
+本文档针对 **fork 了 spectra plugin 并修改 plugin name** 的用户，说明如何调整 spec-driver 的 sub-agent 配置以匹配自定义 namespace。
+
+---
+
+## 背景
+
+Spec Driver 的 5 个 sub-agent（`plan` / `implement` / `verify` / `spec-review` / `quality-review`）在 frontmatter 中声明了访问 spectra MCP 工具的 namespace：
+
+```yaml
+tools: [..., mcp__plugin_spectra_spectra__context, mcp__plugin_spectra_spectra__impact]
+```
+
+这个 namespace 由 Claude Code plugin 系统根据 **plugin name** 自动生成：
+
+```
+mcp__plugin_{your-plugin-name}_spectra__{tool-name}
+```
+
+如果你将 spectra fork 并改名，需要批量更新这些 namespace。
+
+---
+
+## 一键替换指引
+
+### 方法 1: sed（macOS / Linux）
+
+假设你将 spectra plugin 改名为 `my-spectra-fork`：
+
+```bash
+# 预览变更（dry-run）
+grep -rn "mcp__plugin_spectra_spectra__" plugins/spec-driver/agents/
+
+# 执行替换（macOS）
+find plugins/spec-driver/agents -name "*.md" -exec sed -i '' \
+  's/mcp__plugin_spectra_spectra__/mcp__plugin_my-spectra-fork_spectra__/g' {} \;
+
+# 执行替换（Linux）
+find plugins/spec-driver/agents -name "*.md" -exec sed -i \
+  's/mcp__plugin_spectra_spectra__/mcp__plugin_my-spectra-fork_spectra__/g' {} \;
+
+# 验证替换结果
+grep -rn "mcp__plugin_" plugins/spec-driver/agents/
+```
+
+### 方法 2: awk
+
+```bash
+for f in plugins/spec-driver/agents/plan.md \
+         plugins/spec-driver/agents/implement.md \
+         plugins/spec-driver/agents/verify.md \
+         plugins/spec-driver/agents/spec-review.md \
+         plugins/spec-driver/agents/quality-review.md; do
+  awk '{gsub(/mcp__plugin_spectra_spectra__/, "mcp__plugin_my-spectra-fork_spectra__"); print}' \
+    "$f" > "$f.tmp" && mv "$f.tmp" "$f"
+done
+```
+
+### 方法 3: 使用脚本（推荐，可重复运行）
+
+创建 `scripts/update-spectra-namespace.sh`：
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+OLD_NAMESPACE="${1:-mcp__plugin_spectra_spectra__}"
+NEW_NAMESPACE="${2:?需要提供新 namespace，例如: mcp__plugin_my-spectra-fork_spectra__}"
+
+echo "替换 namespace: $OLD_NAMESPACE → $NEW_NAMESPACE"
+
+find plugins/spec-driver/agents -name "*.md" | while read -r f; do
+  if grep -q "$OLD_NAMESPACE" "$f"; then
+    sed -i '' "s|${OLD_NAMESPACE}|${NEW_NAMESPACE}|g" "$f"
+    echo "  已更新: $f"
+  fi
+done
+
+echo "完成。验证结果："
+grep -rn "mcp__plugin_" plugins/spec-driver/agents/ | head -20
+```
+
+运行：
+
+```bash
+chmod +x scripts/update-spectra-namespace.sh
+bash scripts/update-spectra-namespace.sh \
+  "mcp__plugin_spectra_spectra__" \
+  "mcp__plugin_my-spectra-fork_spectra__"
+```
+
+---
+
+## 受影响的文件清单
+
+| 文件 | 需替换的工具 |
+|------|------------|
+| `plugins/spec-driver/agents/plan.md` | `context`, `impact` |
+| `plugins/spec-driver/agents/implement.md` | `context`, `impact` |
+| `plugins/spec-driver/agents/verify.md` | `detect_changes`, `impact` |
+| `plugins/spec-driver/agents/spec-review.md` | `impact`, `context` |
+| `plugins/spec-driver/agents/quality-review.md` | `impact`, `context` |
+
+---
+
+## 验证替换正确性
+
+```bash
+# 1. 不应有旧 namespace 残留
+grep -rn "mcp__plugin_spectra_spectra__" plugins/spec-driver/agents/ && echo "ERROR: 旧 namespace 残留" || echo "✅ 旧 namespace 已清除"
+
+# 2. 新 namespace 应存在于所有 5 个文件
+grep -rn "mcp__plugin_my-spectra-fork_spectra__" plugins/spec-driver/agents/ | wc -l
+# 预期: 至少 8 行（5 个文件共 8 个工具声明）
+
+# 3. 验证 MCP server 名称不变（server-name 仍是 spectra）
+cat plugins/spectra/.mcp.json 2>/dev/null | grep -i "spectra" || cat plugins/my-spectra-fork/.mcp.json | grep -i "spectra"
+```
+
+---
+
+## 注意事项
+
+- **替换的是 plugin-name 部分**，不是 server-name（`spectra`）。server-name 由 `.mcp.json` 的 server key 决定，若你的 fork 保持 server key 为 `spectra`，则 namespace 中间段仍是 `_spectra__`。
+- 如果同时修改了 server key，需调整替换命令中的 `_spectra__` 部分为你的新 server key。
+- 替换后运行 `npm run repo:check` 确认仓库同步状态正常。
+
+---
+
+## 相关文档
+
+- [Spectra MCP 集成指引](./spectra-mcp-integration.md) — namespace 规则详细说明
+- [Milestone M7 设计文档](../../docs/design/milestone-M7-spectra-mcp-productization.md)