spectra-cli 4.1.1

package/dist/cli/commands/community.js

@@ -0,0 +1,92 @@
+/**
+ * community 子命令 handler
+ * 基于已有 graph.json 执行社区检测并生成 GRAPH_REPORT.md
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { runCommunityAnalysis } from '../../panoramic/community/index.js';
+import { loadGraph, detectCommunities } from '../../panoramic/community/community-detector.js';
+import { writeKnowledgeGraph } from '../../panoramic/graph/index.js';
+const COMMUNITY_HELP = `spectra community — 社区检测与架构洞察分析
+
+用法:
+  spectra community [--min-size <N>] [--output-dir <dir>]
+
+说明:
+  读取 _meta/graph.json，执行 Louvain 社区检测、God Node 识别和
+  跨社区异常边发现，生成 _meta/GRAPH_REPORT.md 架构洞察报告。
+
+  需要先运行 \`spectra graph\` 生成知识图谱。
+
+选项:
+  --min-size <N>      最小社区节点数过滤（默认不过滤）
+  --output-dir <dir>  指定输出根目录（默认：{cwd}/specs）
+  --help              显示帮助信息
+
+输出:
+  {output-dir}/_meta/GRAPH_REPORT.md
+
+退出码:
+  0  成功
+  1  分析失败`;
+/**
+ * 执行 community 子命令
+ */
+export async function runCommunityCommand(command) {
+    if (command.help) {
+        console.log(COMMUNITY_HELP);
+        return;
+    }
+    const outputDir = command.outputDir ?? path.join(process.cwd(), 'specs');
+    const graphPath = path.join(outputDir, '_meta', 'graph.json');
+    // 检查 graph.json 是否存在
+    if (!fs.existsSync(graphPath)) {
+        console.error('[community] graph.json 不存在，请先运行 `spectra graph` 生成知识图谱');
+        process.exitCode = 1;
+        return;
+    }
+    // 读取并验证 graph.json
+    let graphJson;
+    try {
+        const content = fs.readFileSync(graphPath, 'utf-8');
+        graphJson = JSON.parse(content);
+        if (!Array.isArray(graphJson.nodes) || !Array.isArray(graphJson.links)) {
+            console.error('[community] graph.json 格式异常：缺少 nodes 或 links 数组');
+            process.exitCode = 1;
+            return;
+        }
+    }
+    catch (err) {
+        console.error(`[community] graph.json 解析失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+        return;
+    }
+    // 空图处理
+    if (graphJson.nodes.length === 0) {
+        console.log('[community] graph.json 中无节点，跳过分析');
+        return;
+    }
+    try {
+        const reportPath = runCommunityAnalysis(graphJson, outputDir, {
+            minSize: command.communityMinSize,
+        });
+        console.log(`✓ GRAPH_REPORT.md 已生成: ${reportPath}`);
+        // 将社区 ID 持久化回 graph.json 节点 metadata
+        // detectCommunities 是确定性算法（Louvain 固定 seed），两次调用结果一致
+        const g = loadGraph(graphJson);
+        const { nodeCommunityMap } = detectCommunities(g, { minSize: command.communityMinSize });
+        for (const node of graphJson.nodes) {
+            const communityId = nodeCommunityMap.get(node.id);
+            if (communityId !== undefined) {
+                node.metadata['community'] = String(communityId);
+            }
+        }
+        writeKnowledgeGraph(graphJson, outputDir);
+        console.log(`✓ graph.json 社区 ID 已更新`);
+    }
+    catch (err) {
+        console.error(`[community] 社区分析失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=community.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * diff 子命令
+ * 检测 Spec 与源代码之间的漂移
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 diff 子命令
+ */
+export declare function runDiff(command: CLICommand, version: string): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

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

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

package/dist/cli/commands/diff.js

@@ -0,0 +1,49 @@
+/**
+ * diff 子命令
+ * 检测 Spec 与源代码之间的漂移
+ */
+import { resolve } from 'node:path';
+import { detectDrift } from '../../diff/drift-orchestrator.js';
+import { validateTargetPath, checkAuth, handleError, EXIT_CODES, } from '../utils/error-handler.js';
+/**
+ * 执行 diff 子命令
+ */
+export async function runDiff(command, version) {
+    const specFile = command.specFile;
+    const source = command.target;
+    console.log(`spectra v${version} — 漂移检测`);
+    console.log(`Spec: ${specFile}`);
+    console.log(`Source: ${source}`);
+    if (!validateTargetPath(resolve(specFile))) {
+        process.exitCode = EXIT_CODES.TARGET_ERROR;
+        return;
+    }
+    if (!validateTargetPath(resolve(source))) {
+        process.exitCode = EXIT_CODES.TARGET_ERROR;
+        return;
+    }
+    if (!checkAuth()) {
+        process.exitCode = EXIT_CODES.API_ERROR;
+        return;
+    }
+    try {
+        const report = await detectDrift(resolve(specFile), resolve(source), {
+            outputDir: command.outputDir,
+        });
+        const { summary } = report;
+        console.log(`  结构差异: ${summary.totalChanges} 项 (HIGH: ${summary.high}, MEDIUM: ${summary.medium}, LOW: ${summary.low})`);
+        console.log(`  噪声过滤: 移除 ${report.filteredNoise} 项`);
+        if (summary.high > 0) {
+            console.log(`⚠ 检测到 HIGH 级别漂移`);
+        }
+        console.log(`✓ ${report.outputPath} 已生成`);
+        // 退出码：HIGH/MEDIUM → 1, 仅 LOW → 0
+        process.exitCode = (summary.high > 0 || summary.medium > 0)
+            ? EXIT_CODES.TARGET_ERROR
+            : EXIT_CODES.SUCCESS;
+    }
+    catch (err) {
+        process.exitCode = handleError(err);
+    }
+}
+//# sourceMappingURL=diff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/cli/commands/diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,UAAU,GACX,MAAM,2BAA2B,CAAC;AAGnC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAmB,EAAE,OAAe;IAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAS,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAO,CAAC;IAE/B,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,SAAS,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IAEjC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,YAAY,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACzC,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,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;YACnE,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,YAAY,aAAa,OAAO,CAAC,IAAI,aAAa,OAAO,CAAC,MAAM,UAAU,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;QACzH,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,UAAU,MAAM,CAAC,CAAC;QAE1C,iCAAiC;QACjC,OAAO,CAAC,QAAQ,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACzD,CAAC,CAAC,UAAU,CAAC,YAAY;YACzB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/cli/commands/direction-audit.d.ts

@@ -0,0 +1,12 @@
+/**
+ * direction-audit 子命令 handler
+ * 读取 graph.json 对每条跨模块边进行方向分类审计
+ * 支持 --snapshot / --compare-snapshot 作为 SC-006 CI regression guard
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 direction-audit 子命令
+ * 完整流程：读取 graph.json → 审计边方向 → 输出报告 → 可选快照操作
+ */
+export declare function runDirectionAuditCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=direction-audit.d.ts.map

package/dist/cli/commands/direction-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction-audit.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/direction-audit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAkezD;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgGjF"}

package/dist/cli/commands/direction-audit.js

@@ -0,0 +1,458 @@
+/**
+ * direction-audit 子命令 handler
+ * 读取 graph.json 对每条跨模块边进行方向分类审计
+ * 支持 --snapshot / --compare-snapshot 作为 SC-006 CI regression guard
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { SEMANTIC_EDGE_RELATIONS } from '../../panoramic/graph/graph-types.js';
+// ============================================================
+// 帮助文本
+// ============================================================
+const DIRECTION_AUDIT_HELP = `spectra direction-audit — 依赖方向自查工具
+
+用法:
+  spectra direction-audit [--graph <path>] [--output <path>] [--format json|text]
+  spectra direction-audit --snapshot <path>
+  spectra direction-audit --compare-snapshot <path>
+
+说明:
+  读取 graph.json 并对每条跨模块边进行方向分类：
+  - correct:    有 AST import 证据支撑的边（置信度 EXTRACTED）
+  - suspicious: 无直接 import 证据（LLM 推断或 cross-reference 推断）
+  - incorrect:  AST 证据与边方向矛盾（反向 import 存在）
+  - skipped:    无充分数据判断（如纯文档节点）
+
+  schema v2.0 语义边（自动分类为 skipped，不触发违规）:
+  - references:              文档直接引用代码实体
+  - conceptually_related_to: 文档与代码概念层面相关
+  - rationale_for:           文档章节为代码决策提供设计依据
+
+选项:
+  --graph <path>            graph.json 路径（默认: specs/_meta/graph.json）
+  --output <path>           报告写入路径（默认: 仅 stdout）
+  --format json|text        输出格式（默认: text）
+  --snapshot <path>         生成 CI baseline 快照并写入文件
+  --compare-snapshot <path> 对比快照；incorrect 增加时以 exit 1 退出
+  --help                    显示帮助信息
+
+退出码:
+  0  成功 / incorrect 未增加
+  1  incorrect 增加（compare-snapshot 模式）/ 文件读取失败`;
+// ============================================================
+// 核心审计逻辑
+// ============================================================
+/**
+ * 解析 graph.json 中 confidence 字段，统一为 ConfidenceLevel 字符串
+ * graph.json 可能存放字符串（'EXTRACTED'/'INFERRED'/'AMBIGUOUS'）或数值分数
+ */
+function parseConfidenceLevel(edge) {
+    if (typeof edge.confidence === 'string') {
+        return edge.confidence.toUpperCase();
+    }
+    // 数值形式：>= 0.9 视为 EXTRACTED，>= 0.6 视为 INFERRED，其余 AMBIGUOUS
+    const score = edge.confidenceScore ?? (typeof edge.confidence === 'number' ? edge.confidence : 0);
+    if (score >= 0.9)
+        return 'EXTRACTED';
+    if (score >= 0.6)
+        return 'INFERRED';
+    return 'AMBIGUOUS';
+}
+/**
+ * 解析 confidence 数值分数（0.0-1.0）
+ * 用于 DirectionAuditEdge.confidence 字段
+ */
+function parseConfidenceScore(edge) {
+    if (typeof edge.confidenceScore === 'number')
+        return Math.min(1, Math.max(0, edge.confidenceScore));
+    if (typeof edge.confidence === 'number')
+        return Math.min(1, Math.max(0, edge.confidence));
+    // 字符串 confidence level 映射为数值
+    const level = typeof edge.confidence === 'string' ? edge.confidence.toUpperCase() : '';
+    if (level === 'EXTRACTED')
+        return 0.95;
+    if (level === 'INFERRED')
+        return 0.65;
+    return 0.3;
+}
+/**
+ * 判断边的 source 和 target 是否跨模块
+ * 简单策略：比较 source/target 的顶级路径前缀（第一个 "/" 前部分）
+ * 完全匹配的视为同模块
+ */
+function isCrossModuleEdge(source, target) {
+    // 若 source 与 target 完全相同则非跨模块（自环）
+    if (source === target)
+        return false;
+    // 取路径第一段作为模块标识
+    const getModule = (id) => {
+        const normalized = id.replace(/\\/g, '/');
+        const parts = normalized.split('/');
+        return parts[0] ?? id;
+    };
+    const srcModule = getModule(source);
+    const tgtModule = getModule(target);
+    // 若第一段相同则视为同模块（src/a/foo → src/a/bar 同属 src 模块）
+    // 若 ID 不含路径分隔符，则均视为独立模块（跨模块）
+    return srcModule !== tgtModule || (!source.includes('/') && !target.includes('/') && source !== target);
+}
+/**
+ * 对单条边进行方向分类
+ * 分类规则：
+ * - 若边类型属于语义边白名单（references/conceptually_related_to/rationale_for）
+ *   且 source 或 target 至少一侧为文档类节点 → skipped（无需 AST 方向审计）
+ * - 若节点为纯文档类型（spec/document/diagram）→ skipped
+ * - 若 confidence 为 EXTRACTED → correct（有 AST 证据）
+ * - 若 confidence 为 INFERRED 且 relation 含 cross-reference → suspicious（cross-reference-inference 阶段）
+ * - 若 confidence 为 INFERRED → suspicious（panoramic-builder 阶段）
+ * - 否则 → suspicious（unknown 来源）
+ *
+ * incorrect 的判断需要"反向 AST import 存在"的机制，
+ * 当前 Phase 仅通过 metadata 标记检测（若 metadata.reversedBy 存在则视为 incorrect）
+ */
+function classifyEdge(edge, nodeKindMap) {
+    const sourceId = edge.source;
+    const targetId = edge.target;
+    const relation = edge.relation ?? 'unknown';
+    const confidenceScore = parseConfidenceScore(edge);
+    const confidenceLevel = parseConfidenceLevel(edge);
+    // 检查 metadata 中是否有 reversedBy 标记（表示反向 AST import 存在 → incorrect）
+    const hasReversal = Boolean(edge.metadata?.['reversedBy']);
+    const srcKind = nodeKindMap.get(sourceId) ?? 'module';
+    const tgtKind = nodeKindMap.get(targetId) ?? 'module';
+    // 文档类节点判断辅助函数
+    const isDocKind = (kind) => kind === 'spec' || kind === 'document' || kind === 'diagram';
+    // schema v2.0 语义边白名单：至少一侧为文档节点时直接 skipped
+    // 语义边（references/conceptually_related_to/rationale_for）不参与 AST 方向审计
+    const semanticEdgeValues = Object.values(SEMANTIC_EDGE_RELATIONS);
+    const isSemanticRelation = semanticEdgeValues.includes(relation);
+    const hasDocSide = isDocKind(srcKind) || isDocKind(tgtKind);
+    if (isSemanticRelation && hasDocSide) {
+        return {
+            sourceId,
+            targetId,
+            relation,
+            result: 'skipped',
+            confidence: confidenceScore,
+            rationale: `语义边类型（${relation}）含文档侧节点，不参与 AST 方向审计`,
+        };
+    }
+    // 纯文档节点（spec/document/diagram）无法做 AST 方向审计 → skipped
+    const isDocOnly = isDocKind(srcKind) && isDocKind(tgtKind);
+    if (isDocOnly) {
+        return {
+            sourceId,
+            targetId,
+            relation,
+            result: 'skipped',
+            confidence: confidenceScore,
+            rationale: '两侧均为文档节点，无 AST import 数据可供方向审计',
+        };
+    }
+    // incorrect：metadata 明确标记了反向 import
+    if (hasReversal) {
+        const reversedBy = String(edge.metadata?.['reversedBy'] ?? '');
+        return {
+            sourceId,
+            targetId,
+            relation,
+            result: 'incorrect',
+            confidence: confidenceScore,
+            rationale: `AST 证据显示依赖方向相反：${reversedBy} 实际 import ${sourceId}，但图中边为 ${sourceId} → ${targetId}`,
+            suspectedStage: 'ast-extraction',
+        };
+    }
+    // correct：EXTRACTED 置信度 → 有 AST import 证据
+    if (confidenceLevel === 'EXTRACTED') {
+        return {
+            sourceId,
+            targetId,
+            relation,
+            result: 'correct',
+            confidence: confidenceScore,
+            rationale: 'AST import 证据支撑（EXTRACTED 置信度）',
+        };
+    }
+    // suspicious：cross-reference 推断
+    const isCrossRef = relation.includes('cross-reference') || relation.includes('cross_reference') ||
+        (typeof edge.metadata?.['source'] === 'string' && edge.metadata['source'].includes('cross-reference'));
+    if (isCrossRef) {
+        return {
+            sourceId,
+            targetId,
+            relation,
+            result: 'suspicious',
+            confidence: confidenceScore,
+            rationale: '边来自 cross-reference 推断，无直接 AST import 证据',
+            suspectedStage: 'cross-reference-inference',
+        };
+    }
+    // suspicious：INFERRED（LLM 语义推断）
+    if (confidenceLevel === 'INFERRED') {
+        return {
+            sourceId,
+            targetId,
+            relation,
+            result: 'suspicious',
+            confidence: confidenceScore,
+            rationale: '边来自 LLM 语义推断（INFERRED 置信度），无直接 AST import 证据',
+            suspectedStage: 'panoramic-builder',
+        };
+    }
+    // 其余（AMBIGUOUS / 未知）→ suspicious
+    return {
+        sourceId,
+        targetId,
+        relation,
+        result: 'suspicious',
+        confidence: confidenceScore,
+        rationale: `弱置信度（${confidenceLevel}），无直接 AST import 证据`,
+        suspectedStage: 'panoramic-builder',
+    };
+}
+/**
+ * 计算 incorrect 边集合的稳定 SHA-256 哈希（前 32 位十六进制）
+ * 按 sourceId+targetId 排序后序列化
+ */
+function computeIncorrectHash(incorrectEdges) {
+    const sorted = [...incorrectEdges]
+        .sort((a, b) => {
+        const ka = `${a.sourceId}\0${a.targetId}`;
+        const kb = `${b.sourceId}\0${b.targetId}`;
+        return ka < kb ? -1 : ka > kb ? 1 : 0;
+    })
+        .map((e) => `${e.sourceId}|${e.targetId}|${e.relation}`)
+        .join('\n');
+    return crypto.createHash('sha256').update(sorted).digest('hex').slice(0, 32);
+}
+/**
+ * 主审计函数：读取 graph.json，对所有跨模块边分类，返回报告
+ */
+function auditGraph(graphPath) {
+    const raw = fs.readFileSync(graphPath, 'utf-8');
+    const graphJson = JSON.parse(raw);
+    const links = graphJson.links ?? [];
+    const nodes = graphJson.nodes ?? [];
+    // 建立 nodeId → kind 映射，供方向分类使用
+    const nodeKindMap = new Map();
+    for (const node of nodes) {
+        nodeKindMap.set(node.id, node.kind ?? 'module');
+    }
+    // 仅审计跨模块边
+    const crossModuleLinks = links.filter((e) => isCrossModuleEdge(e.source, e.target));
+    // 对每条跨模块边分类
+    const auditedEdges = crossModuleLinks.map((edge) => classifyEdge(edge, nodeKindMap));
+    // 汇总统计
+    const summary = { correct: 0, suspicious: 0, incorrect: 0, skipped: 0 };
+    const rootCauseBreakdown = {
+        astExtraction: 0,
+        panoramicBuilder: 0,
+        crossReferenceInference: 0,
+        unknown: 0,
+    };
+    for (const edge of auditedEdges) {
+        summary[edge.result]++;
+        if (edge.result === 'incorrect' || edge.result === 'suspicious') {
+            switch (edge.suspectedStage) {
+                case 'ast-extraction':
+                    rootCauseBreakdown.astExtraction++;
+                    break;
+                case 'panoramic-builder':
+                    rootCauseBreakdown.panoramicBuilder++;
+                    break;
+                case 'cross-reference-inference':
+                    rootCauseBreakdown.crossReferenceInference++;
+                    break;
+                default:
+                    // incorrect 但无 suspectedStage 时记入 unknown
+                    if (edge.result === 'incorrect')
+                        rootCauseBreakdown.unknown++;
+            }
+        }
+    }
+    return {
+        graphPath,
+        generatedAt: new Date().toISOString(),
+        totalEdges: auditedEdges.length,
+        summary,
+        edges: auditedEdges,
+        rootCauseBreakdown,
+    };
+}
+// ============================================================
+// 输出格式化
+// ============================================================
+/** 生成 text 格式报告 */
+function formatText(report) {
+    const lines = [
+        'Direction Audit Report',
+        '======================',
+        `Graph:     ${report.graphPath}`,
+        `Generated: ${report.generatedAt}`,
+        `Total cross-module edges: ${report.totalEdges}`,
+        `  correct:    ${report.summary.correct} (AST-grounded)`,
+        `  suspicious: ${report.summary.suspicious} (no direct AST evidence)`,
+        `  incorrect:  ${report.summary.incorrect} (AST contradicts direction)`,
+        `  skipped:    ${report.summary.skipped} (doc-only nodes, no AST data)`,
+    ];
+    if (report.summary.incorrect > 0) {
+        lines.push('');
+        lines.push('Incorrect edges (direction contradicted by AST):');
+        for (const edge of report.edges.filter((e) => e.result === 'incorrect')) {
+            lines.push(`  [INCORRECT] ${edge.sourceId} → ${edge.targetId}`);
+            lines.push(`              relation: ${edge.relation}`);
+            lines.push(`              rationale: ${edge.rationale}`);
+        }
+    }
+    if (report.summary.suspicious > 0) {
+        // 仅显示前 10 条 suspicious（避免输出过长）
+        const suspiciousList = report.edges.filter((e) => e.result === 'suspicious').slice(0, 10);
+        lines.push('');
+        lines.push(`Suspicious edges (first ${suspiciousList.length} of ${report.summary.suspicious}):`);
+        for (const edge of suspiciousList) {
+            lines.push(`  [SUSPICIOUS] ${edge.sourceId} → ${edge.targetId}`);
+            lines.push(`               relation: ${edge.relation}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ============================================================
+// 快照操作
+// ============================================================
+/** 生成并写入 CI baseline 快照 */
+function writeSnapshot(report, snapshotPath) {
+    const incorrectEdges = report.edges.filter((e) => e.result === 'incorrect');
+    const snapshot = {
+        generatedAt: report.generatedAt,
+        graphPath: report.graphPath,
+        incorrectCount: report.summary.incorrect,
+        incorrectHash: computeIncorrectHash(incorrectEdges),
+    };
+    const dir = path.dirname(snapshotPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(snapshotPath, JSON.stringify(snapshot, null, 2), 'utf-8');
+    console.log(`[direction-audit] 快照已写入: ${snapshotPath}`);
+    console.log(`  incorrect count: ${snapshot.incorrectCount}`);
+    console.log(`  incorrect hash:  ${snapshot.incorrectHash}`);
+}
+/**
+ * 对比当前报告与快照
+ * @returns true = 通过（incorrect 未增加），false = 失败（incorrect 增加）
+ */
+function compareSnapshot(report, snapshotPath) {
+    const raw = fs.readFileSync(snapshotPath, 'utf-8');
+    const snapshot = JSON.parse(raw);
+    const currentIncorrect = report.summary.incorrect;
+    const baselineIncorrect = snapshot.incorrectCount;
+    console.log(`[direction-audit] 对比快照: ${snapshotPath}`);
+    console.log(`  baseline incorrect: ${baselineIncorrect}`);
+    console.log(`  current  incorrect: ${currentIncorrect}`);
+    if (currentIncorrect > baselineIncorrect) {
+        console.error(`[direction-audit] 回归检测：incorrect 边数从 ${baselineIncorrect} 增加到 ${currentIncorrect}，存在依赖方向倒置引入！`);
+        return false;
+    }
+    if (currentIncorrect < baselineIncorrect) {
+        console.log(`[direction-audit] incorrect 边数减少（${baselineIncorrect} → ${currentIncorrect}），建议更新 baseline 快照`);
+    }
+    else {
+        console.log(`[direction-audit] incorrect 边数无变化，通过`);
+    }
+    return true;
+}
+// ============================================================
+// CLI 入口
+// ============================================================
+/**
+ * 执行 direction-audit 子命令
+ * 完整流程：读取 graph.json → 审计边方向 → 输出报告 → 可选快照操作
+ */
+export async function runDirectionAuditCommand(command) {
+    if (command.help) {
+        console.log(DIRECTION_AUDIT_HELP);
+        return;
+    }
+    // 解析参数
+    const graphPath = command.directionAuditGraph ?? path.join(process.cwd(), 'specs', '_meta', 'graph.json');
+    const outputPath = command.directionAuditOutput;
+    const format = command.directionAuditFormat ?? 'text';
+    const snapshotPath = command.directionAuditSnapshot;
+    const compareSnapshotPath = command.directionAuditCompareSnapshot;
+    // 检查 graph.json 是否存在
+    if (!fs.existsSync(graphPath)) {
+        console.error(`[direction-audit] graph.json 不存在: ${graphPath}`);
+        console.error('请先运行 `spectra graph` 生成 graph.json');
+        process.exitCode = 1;
+        return;
+    }
+    // 执行审计
+    let report;
+    try {
+        report = auditGraph(graphPath);
+    }
+    catch (err) {
+        console.error(`[direction-audit] 审计失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+        return;
+    }
+    // 快照写入模式（--snapshot）
+    if (snapshotPath) {
+        try {
+            writeSnapshot(report, snapshotPath);
+        }
+        catch (err) {
+            console.error(`[direction-audit] 快照写入失败: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+        return;
+    }
+    // 快照对比模式（--compare-snapshot）
+    if (compareSnapshotPath) {
+        if (!fs.existsSync(compareSnapshotPath)) {
+            console.error(`[direction-audit] 快照文件不存在: ${compareSnapshotPath}`);
+            console.error('请先运行 `spectra direction-audit --snapshot <path>` 生成 baseline');
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const passed = compareSnapshot(report, compareSnapshotPath);
+            if (!passed) {
+                process.exitCode = 1;
+            }
+        }
+        catch (err) {
+            console.error(`[direction-audit] 快照对比失败: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+        return;
+    }
+    // 常规输出模式
+    let output;
+    if (format === 'json') {
+        output = JSON.stringify(report, null, 2);
+    }
+    else {
+        output = formatText(report);
+    }
+    // 写入文件（若指定 --output）
+    if (outputPath) {
+        try {
+            const dir = path.dirname(outputPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(outputPath, output, 'utf-8');
+            console.log(`[direction-audit] 报告已写入: ${outputPath}`);
+        }
+        catch (err) {
+            console.error(`[direction-audit] 报告写入失败: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // 始终输出到 stdout
+    console.log(output);
+}
+//# sourceMappingURL=direction-audit.js.map

package/dist/cli/commands/direction-audit.js.map

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