spectra-cli 4.1.1

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

@@ -0,0 +1,22 @@
+/**
+ * export 子命令 handler
+ * 将知识图谱导出为 Obsidian Vault 或 HTML 交互式可视化
+ * FR 追踪: FR-013、FR-014、FR-015、FR-016
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 export 子命令
+ *
+ * 执行流程：
+ * 1. 校验 exportFormat（obsidian 或 html）
+ * 2. 读取 _meta/graph.json（缺失则 graceful exit）
+ * 3. 校验图非空（空图则 graceful exit）
+ * 4. 重建 communityResult（detectCommunities + loadGraph）
+ * 5. 重建 godNodes（findGodNodes）
+ * 6. 路由到 generateObsidianVault 或 generateHtmlExport
+ * 7. 输出成功信息（文件数、耗时）
+ *
+ * @param command - 解析后的 CLI 命令对象
+ */
+export declare function runExportCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/export.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAgCzD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA8EzE"}

package/dist/cli/commands/export.js

@@ -0,0 +1,123 @@
+/**
+ * export 子命令 handler
+ * 将知识图谱导出为 Obsidian Vault 或 HTML 交互式可视化
+ * FR 追踪: FR-013、FR-014、FR-015、FR-016
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { loadGraph, detectCommunities } from '../../panoramic/community/community-detector.js';
+import { findGodNodes } from '../../panoramic/community/god-node-analyzer.js';
+import { generateObsidianVault } from '../../panoramic/exporters/obsidian-exporter.js';
+import { generateHtmlExport } from '../../panoramic/exporters/html-exporter.js';
+import { resolveGraphJsonPath } from '../../panoramic/graph/graph-paths.js';
+const EXPORT_HELP = `spectra export — 将知识图谱导出为可视化格式
+
+用法:
+  spectra export --format <obsidian|html> [--output-dir <dir>] [--project-root <path>]
+
+说明:
+  读取 _meta/graph.json（需先运行 spectra graph），重建社区归属，
+  导出为 Obsidian Vault（Markdown 文件集）或 HTML 交互式可视化。
+
+选项:
+  --format <obsidian|html>  导出格式（必填）
+  --output-dir <dir>        输出目录（默认: {project-root}/specs/_meta/export/）
+                            相对路径基于 --project-root 解析；绝对路径直接采用
+  --project-root <path>     项目根目录（默认: 当前 shell 目录）
+  --help                    显示帮助信息
+
+输出:
+  obsidian: {output-dir}/index.md + communities/*.md + god-nodes/*.md
+  html:     {output-dir}/graph.html
+
+退出码:
+  0  成功
+  1  graph.json 缺失或图为空，或格式无效`;
+/**
+ * 执行 export 子命令
+ *
+ * 执行流程：
+ * 1. 校验 exportFormat（obsidian 或 html）
+ * 2. 读取 _meta/graph.json（缺失则 graceful exit）
+ * 3. 校验图非空（空图则 graceful exit）
+ * 4. 重建 communityResult（detectCommunities + loadGraph）
+ * 5. 重建 godNodes（findGodNodes）
+ * 6. 路由到 generateObsidianVault 或 generateHtmlExport
+ * 7. 输出成功信息（文件数、耗时）
+ *
+ * @param command - 解析后的 CLI 命令对象
+ */
+export async function runExportCommand(command) {
+    if (command.help) {
+        console.log(EXPORT_HELP);
+        return;
+    }
+    // 校验导出格式（FR-013）
+    const { exportFormat } = command;
+    if (exportFormat !== 'obsidian' && exportFormat !== 'html') {
+        console.error(`[export] 无效的导出格式: ${exportFormat ?? '（未指定）'}`);
+        console.error('[export] 可选格式: obsidian | html');
+        console.error('[export] 用法: spectra export --format <obsidian|html>');
+        process.exitCode = 1;
+        return;
+    }
+    // 确定输出目录（FR-014：默认 specs/_meta/export/）
+    // 优先使用 --project-root 参数显式传入的项目根，回退到 process.cwd()
+    // 这让 spectra export 能从任意 shell 目录正确指向目标项目（fix(138)）
+    const cwd = command.projectRoot ?? process.cwd();
+    // 相对路径基于 projectRoot 解析（与 batch-orchestrator 一致），绝对路径直接采用
+    // 避免 --project-root /a --output-dir relative 被错误地基于 shell cwd 解析的反直觉行为
+    const outputDir = command.outputDir
+        ? (path.isAbsolute(command.outputDir) ? command.outputDir : path.join(cwd, command.outputDir))
+        : path.join(cwd, 'specs', '_meta', 'export');
+    // 读取 graph.json（FR-015：缺失则 graceful exit）
+    const graphJsonPath = resolveGraphJsonPath(cwd);
+    if (!fs.existsSync(graphJsonPath)) {
+        console.error('[export] 找不到 specs/_meta/graph.json');
+        console.error('[export] 请先运行 spectra graph 构建知识图谱');
+        process.exitCode = 1;
+        return;
+    }
+    let graphJson;
+    try {
+        const raw = fs.readFileSync(graphJsonPath, 'utf-8');
+        graphJson = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`[export] 读取 graph.json 失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+        return;
+    }
+    // 校验图非空（FR-015：空图 graceful exit，退出码非零）
+    if (!graphJson.nodes || graphJson.nodes.length === 0) {
+        console.error('[export] 图谱为空，无可导出内容');
+        console.error('[export] 请先运行 spectra graph 并确保项目有源码可分析');
+        process.exitCode = 1;
+        return;
+    }
+    // 重建社区归属（FR-016：detectCommunities 是确定性算法，结果等价）
+    let communityResult;
+    try {
+        const graph = loadGraph(graphJson);
+        communityResult = detectCommunities(graph);
+        const godNodes = findGodNodes(graph, communityResult.nodeCommunityMap);
+        // 路由到对应导出器
+        let result;
+        if (exportFormat === 'obsidian') {
+            result = generateObsidianVault(graphJson, communityResult, godNodes, outputDir);
+            console.log(`[export] Obsidian Vault 导出完成`);
+        }
+        else {
+            result = generateHtmlExport(graphJson, communityResult, godNodes, outputDir);
+            console.log(`[export] HTML 交互式可视化导出完成`);
+        }
+        console.log(`[export] 输出目录: ${outputDir}`);
+        console.log(`[export] 生成文件数: ${result.fileCount}`);
+        console.log(`[export] 耗时: ${result.durationMs} ms`);
+    }
+    catch (err) {
+        console.error(`[export] 导出失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=export.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * generate 子命令
+ * 对指定文件或目录生成单模块 Spec
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 generate 子命令
+ */
+export declare function runGenerate(command: CLICommand, version: string): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCrF"}

package/dist/cli/commands/generate.js

@@ -0,0 +1,50 @@
+/**
+ * generate 子命令
+ * 对指定文件或目录生成单模块 Spec
+ */
+import { resolve } from 'node:path';
+import { generateSpec } from '../../core/single-spec-orchestrator.js';
+import { ensureSpecifyTemplates } from '../../utils/specify-template-sync.js';
+import { validateTargetPath, checkAuth, handleError, EXIT_CODES, } from '../utils/error-handler.js';
+/**
+ * 执行 generate 子命令
+ */
+export async function runGenerate(command, version) {
+    const target = command.target;
+    const targetPath = resolve(target);
+    // 首次运行自动补齐 .specify/templates（不阻塞主流程）
+    try {
+        ensureSpecifyTemplates(process.cwd());
+    }
+    catch {
+        // 忽略模板同步失败，避免影响 generate 主流程
+    }
+    console.log(`spectra v${version}`);
+    console.log(`正在分析 ${target} ...`);
+    if (!validateTargetPath(targetPath)) {
+        process.exitCode = EXIT_CODES.TARGET_ERROR;
+        return;
+    }
+    if (!checkAuth()) {
+        process.exitCode = EXIT_CODES.API_ERROR;
+        return;
+    }
+    try {
+        const result = await generateSpec(targetPath, {
+            deep: command.deep,
+            outputDir: command.outputDir,
+            projectRoot: process.cwd(),
+        });
+        console.log(`✓ ${result.specPath} 已生成 (置信度: ${result.confidence})`);
+        if (result.warnings.length > 0) {
+            for (const w of result.warnings) {
+                console.warn(`⚠ ${w}`);
+            }
+        }
+        process.exitCode = EXIT_CODES.SUCCESS;
+    }
+    catch (err) {
+        process.exitCode = handleError(err);
+    }
+}
+//# sourceMappingURL=generate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,UAAU,GACX,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAmB,EAAE,OAAe;IACpE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC,sCAAsC;IACtC,IAAI,CAAC;QACH,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,MAAM,CAAC,CAAC;IAElC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC;QACxC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE;YAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;SAC3B,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * graph 子命令 handler
+ * 构建知识图谱并持久化为 _meta/graph.json
+ * 支持独立运行，不依赖完整 batch 流程
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 graph 子命令
+ * 支持独立调用图构建，不依赖完整 batch 流程
+ *
+ * 数据加载策略（独立运行，不走完整 batch）：
+ * 1. ArchitectureIR：读取 {outputDir}/_meta/architecture-ir.json（若存在）
+ * 2. DocGraph：基于已存储 spec 文件构建轻量 DocGraph（动态导入 scanStoredModuleSpecs）
+ * 3. CrossReferenceLinks：从已生成的 spec 文件中提取 crossReferenceIndex 段
+ * 任一数据源加载失败 → graceful skip，不中断图构建
+ *
+ * @param command - 解析后的 CLI 命令对象
+ */
+export declare function runGraphCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=graph.d.ts.map

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

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

package/dist/cli/commands/graph.js

@@ -0,0 +1,189 @@
+/**
+ * graph 子命令 handler
+ * 构建知识图谱并持久化为 _meta/graph.json
+ * 支持独立运行，不依赖完整 batch 流程
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { buildKnowledgeGraph, writeKnowledgeGraph } from '../../panoramic/graph/index.js';
+import { SpecStore } from '../../spec-store/index.js';
+const GRAPH_HELP = `spectra graph — 构建并持久化知识图谱
+
+用法:
+  spectra graph [--directed] [--output-dir <dir>]
+
+说明:
+  读取当前项目的 architecture-ir、doc-graph、cross-reference-index，
+  合并构建 NetworkX 兼容的 graph.json 并写入 _meta/ 目录。
+
+选项:
+  --directed          输出有向图（默认为无向图）
+  --output-dir <dir>  指定输出根目录（默认：{cwd}/specs）
+  --help              显示帮助信息
+
+输出:
+  {output-dir}/_meta/graph.json
+
+退出码:
+  0  成功
+  1  图构建失败（错误信息输出到 stderr）`;
+/**
+ * 从磁盘缓存加载 ArchitectureIR
+ * 读取 {outputDir}/_meta/architecture-ir.json，失败时返回 undefined
+ * 采用方案 B：仅检查顶层字段存在性
+ *
+ * @param outputDir - 项目输出目录
+ * @returns ArchitectureIR 对象或 undefined
+ */
+function loadArchitectureIR(outputDir) {
+    try {
+        const irPath = path.join(outputDir, '_meta', 'architecture-ir.json');
+        if (!fs.existsSync(irPath)) {
+            return undefined;
+        }
+        const content = fs.readFileSync(irPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // 方案 B：仅检查顶层 elements、relationships 字段存在性
+        if (!Array.isArray(parsed['elements']) ||
+            !Array.isArray(parsed['relationships'])) {
+            return undefined;
+        }
+        return parsed;
+    }
+    catch {
+        // 加载失败时 graceful skip
+        return undefined;
+    }
+}
+/**
+ * 从磁盘上的 spec 文件提取 crossReferenceIndex 中的 CrossReferenceLink
+ * 扫描 spec 文件中的 cross-reference-index 注释块，失败时返回空数组
+ *
+ * @param outputDir - 项目输出目录
+ * @returns CrossReferenceLink 数组
+ */
+function collectCrossRefs(outputDir) {
+    try {
+        const links = [];
+        /** 递归扫描目录中的 .spec.md 文件 */
+        function walkDir(dir) {
+            if (!fs.existsSync(dir))
+                return;
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walkDir(fullPath);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.spec.md')) {
+                    try {
+                        const content = fs.readFileSync(fullPath, 'utf-8');
+                        // 从 spec 文件提取 crossReferenceIndex JSON 块
+                        const match = content.match(/<!-- cross-reference-index: auto\s+([\s\S]*?)-->/);
+                        if (match?.[1]) {
+                            const parsed = JSON.parse(match[1].trim());
+                            if (Array.isArray(parsed.sameModule)) {
+                                links.push(...parsed.sameModule);
+                            }
+                            if (Array.isArray(parsed.crossModule)) {
+                                links.push(...parsed.crossModule);
+                            }
+                        }
+                    }
+                    catch {
+                        // 单个文件解析失败时跳过
+                    }
+                }
+            }
+        }
+        walkDir(outputDir);
+        return links;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 执行 graph 子命令
+ * 支持独立调用图构建，不依赖完整 batch 流程
+ *
+ * 数据加载策略（独立运行，不走完整 batch）：
+ * 1. ArchitectureIR：读取 {outputDir}/_meta/architecture-ir.json（若存在）
+ * 2. DocGraph：基于已存储 spec 文件构建轻量 DocGraph（动态导入 scanStoredModuleSpecs）
+ * 3. CrossReferenceLinks：从已生成的 spec 文件中提取 crossReferenceIndex 段
+ * 任一数据源加载失败 → graceful skip，不中断图构建
+ *
+ * @param command - 解析后的 CLI 命令对象
+ */
+export async function runGraphCommand(command) {
+    if (command.help) {
+        console.log(GRAPH_HELP);
+        return;
+    }
+    const outputDir = command.outputDir ?? path.join(process.cwd(), 'specs');
+    // 加载 ArchitectureIR（从磁盘缓存读取）
+    const architectureIR = loadArchitectureIR(outputDir);
+    // 构建轻量 DocGraph（基于已存储 spec 文件，无需 DependencyGraph）
+    // 通过 SpecStore 过滤，排除 orphan/bundle_copy/derived
+    let docGraph;
+    try {
+        const { scanStoredModuleSpecs } = await import('../../panoramic/builders/doc-graph-builder.js');
+        const projectRoot = path.dirname(outputDir);
+        const stored = scanStoredModuleSpecs(outputDir, projectRoot);
+        if (stored.length > 0) {
+            // 构造轻量 SpecStore（独立运行，无本次生成 spec），通过 storedOnlySpecs() 获取过滤后列表
+            const specStore = new SpecStore({
+                currentSpecs: [],
+                storedSpecs: stored,
+                projectRoot,
+                toProjectPath: (absPath) => {
+                    const rel = path.relative(projectRoot, absPath);
+                    return rel.startsWith('..') ? absPath : rel;
+                },
+            });
+            // storedOnlySpecs() 按 sourceKind 过滤，orphanSpecs() 获取 orphan 集合
+            const canonicalSpecs = specStore.storedOnlySpecs({ sourceKind: 'canonical' });
+            const orphanPaths = new Set(specStore.orphanSpecs().map((s) => s.outputPath));
+            // 排除 orphan（源文件不存在的 spec）
+            const validSpecs = canonicalSpecs.filter((s) => !orphanPaths.has(s.outputPath));
+            if (validSpecs.length > 0) {
+                docGraph = {
+                    projectRoot,
+                    generatedAt: new Date().toISOString(),
+                    specs: validSpecs.map((s) => ({
+                        specPath: s.specPath,
+                        sourceTarget: s.sourceTarget,
+                        relatedFiles: s.relatedFiles,
+                        linked: s.linked,
+                        confidence: s.confidence,
+                        currentRun: false,
+                    })),
+                    sourceToSpec: [],
+                    references: [],
+                    missingSpecs: [],
+                    unlinkedSpecs: [],
+                };
+            }
+        }
+    }
+    catch {
+        // DocGraph 构建失败时 graceful skip
+    }
+    // 从已生成的 spec 文件提取 crossReferenceLinks
+    const crossReferenceLinks = collectCrossRefs(outputDir);
+    try {
+        const graphJson = buildKnowledgeGraph({
+            architectureIR,
+            docGraph,
+            crossReferenceLinks,
+            directed: command.directed ?? false,
+        });
+        const writtenPath = writeKnowledgeGraph(graphJson, outputDir);
+        console.log(`✓ graph.json 已写入: ${writtenPath}`);
+    }
+    catch (err) {
+        console.error(`[graph] 图构建失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=graph.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * init 子命令入口
+ * 安装/移除 spectra skills
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 init 命令
+ */
+export declare function runInit(command: CLICommand): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AASzD;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAqBjD"}

package/dist/cli/commands/init.js

@@ -0,0 +1,33 @@
+/**
+ * init 子命令入口
+ * 安装/移除 spectra skills
+ */
+import { installSkills, removeSkills, resolveTargetDir, formatSummary, } from '../../installer/skill-installer.js';
+/**
+ * 执行 init 命令
+ */
+export function runInit(command) {
+    const mode = command.global ? 'global' : 'project';
+    const platforms = resolvePlatforms(command.skillTarget);
+    const summaries = platforms.map((platform) => {
+        const targetDir = resolveTargetDir(mode, platform);
+        if (command.remove) {
+            return removeSkills({ targetDir, mode, platform });
+        }
+        return installSkills({ targetDir, mode, platform });
+    });
+    const output = summaries.map((summary) => formatSummary(summary)).join('\n\n');
+    console.log(output);
+    // 全目标平台均失败时退出码为 1
+    const allFailed = summaries.every((summary) => summary.results.every((r) => r.status === 'failed'));
+    if (allFailed) {
+        process.exitCode = 1;
+    }
+}
+function resolvePlatforms(target) {
+    if (target === 'both') {
+        return ['claude', 'codex'];
+    }
+    return [target];
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,GAEd,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAmB;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,YAAY,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpB,kBAAkB;IAClB,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5C,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CACpD,CAAC;IACF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAiC;IAEjC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * install 子命令 handler
+ * 薄包装层：调用 hook-installer 和 git-hook-installer，处理错误输出
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 install 子命令
+ * 根据 --remove 和 --git 参数分别调用安装/卸载函数
+ */
+export declare function runInstall(command: CLICommand): void;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAqBzD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAoBpD"}

package/dist/cli/commands/install.js

@@ -0,0 +1,52 @@
+/**
+ * install 子命令 handler
+ * 薄包装层：调用 hook-installer 和 git-hook-installer，处理错误输出
+ */
+import { execSync } from 'node:child_process';
+import { installClaudeHook, removeClaudeHook } from '../../hooks/hook-installer.js';
+import { installGitHook, removeGitHook } from '../../hooks/git-hook-installer.js';
+import { printError } from '../utils/error-handler.js';
+/**
+ * 检测项目根目录
+ * 优先使用 git 仓库根目录；非 git 仓库时 fallback 到 cwd
+ */
+function detectProjectRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+            cwd: process.cwd(),
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+/**
+ * 执行 install 子命令
+ * 根据 --remove 和 --git 参数分别调用安装/卸载函数
+ */
+export function runInstall(command) {
+    const projectRoot = detectProjectRoot();
+    try {
+        if (command.installRemove) {
+            // 卸载模式：先卸载 Claude hook，再卸载 git hook（若 --git）
+            removeClaudeHook(projectRoot);
+            if (command.installGit) {
+                removeGitHook(projectRoot);
+            }
+        }
+        else {
+            // 安装模式：先安装 Claude hook，再安装 git hook（若 --git）
+            installClaudeHook(projectRoot);
+            if (command.installGit) {
+                installGitHook(projectRoot);
+            }
+        }
+    }
+    catch (err) {
+        printError(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=install.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;GAGG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,+BAA+B,EAAE;YAC/C,QAAQ,EAAE,OAAO;YACjB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAmB;IAC5C,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,6CAA6C;YAC7C,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAC9B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,aAAa,CAAC,WAAW,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAC/B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,cAAc,CAAC,WAAW,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,UAAU,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/commands/mcp-server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * mcp-server 子命令
+ * 启动 MCP stdio server，通过 JSON-RPC 2.0 暴露 spectra 工具能力
+ *
+ * dev 模式（--dev flag 或 SPECTRA_DEV=1 环境变量）：
+ *   通过 tsx --watch 启动子进程，文件变更后自动重启，下次 MCP 调用立即使用新代码。
+ *   CI 环境（CI=1 或 SPECTRA_DEV_DISABLE=1）下即使传了 --dev 也强制禁用，避免意外的 watcher 开销。
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 解析是否应启用 dev 热重载模式
+ *
+ * 规则（按优先级）：
+ *   1. SPECTRA_DEV_DISABLE=1 → 强制禁用，并打印提示
+ *   2. CI=true 或 CI=1      → 强制禁用，并打印提示
+ *   3. --dev flag 或 SPECTRA_DEV=1 → 启用
+ */
+export declare function resolveDevMode(command: Pick<CLICommand, 'mcpDev'>): boolean;
+/**
+ * 执行 mcp-server 子命令
+ */
+export declare function runMcpServer(command?: Pick<CLICommand, 'mcpDev'>): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/cli/commands/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,OAAO,CAa3E;AAqDD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtF"}