spectra-cli 4.1.1 → 4.3.0

package/dist/mcp/server.js

@@ -1,198 +1,260 @@
 /**
  * MCP Server 定义
- * 注册 10 个工具（prepare、generate、batch、diff、panoramic-query + 5 个 graph 查询工具）供 Claude Code 通过 MCP 协议调用
+ * 注册 17 个工具（prepare、generate、batch、diff、panoramic-query +
+ * 6 个 graph 查询工具 + 3 个 agent-context 工具 impact / context / detect_changes +
+ * 3 个 file-navigation 工具 view_file / search_in_file / list_directory）
+ * 供 Claude Code 通过 MCP 协议调用。
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { readFileSync } from 'node:fs';
+import { readFileSync, statSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { prepareContext, generateSpec } from '../core/single-spec-orchestrator.js';
-import { runBatch } from '../batch/batch-orchestrator.js';
+import { runBatch, buildAstGraphOnly } from '../batch/batch-orchestrator.js';
+import { resolveRegenPlan } from '../batch/regen-plan.js';
 import { loadProjectConfig } from '../config/project-config.js';
 import { detectDrift } from '../diff/drift-orchestrator.js';
-import { bootstrapAdapters } from '../adapters/index.js';
-import { bootstrapGenerators } from '../panoramic/generator-registry.js';
-import { bootstrapParsers } from '../panoramic/parser-registry.js';
+import { bootstrapRuntime } from '../runtime-bootstrap.js';
 import { scanFiles } from '../utils/file-scanner.js';
 import { queryPanoramic } from '../panoramic/query.js';
 import { registerGraphTools } from './graph-tools.js';
+import { registerAgentContextTools } from './agent-context-tools.js';
+import { registerFileNavTools } from './file-nav-tools.js';
+import { buildErrorResponse } from './lib/tool-response.js';
+import { withTelemetry } from './lib/telemetry.js';
 // 读取 package.json 版本号
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgPath = resolve(__dirname, '..', '..', 'package.json');
 const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+/**
+ * MCP server 级 instructions（F184 FR-002）：经 SDK `ServerOptions` 注入 initialize result，
+ * 给 driver / 子代理在无明确指令时一份工具分组导览 + 典型链路 + 恢复流，提升 MCP 工具采用率。
+ *
+ * 约束：
+ * - 控制在 ≤1600 字符（server 级一次性导览，避免上下文膨胀；F184 Codex Plan W-004）
+ * - 不硬编码工具总数（用分组描述，降工具增减时的漂移；新增/删除工具时同步本文）
+ * - 必含典型链路串 `detect_changes → impact → context → view_file` 与 `graph-not-built` 恢复流
+ */
+export const TOOL_GUIDE = [
+    'Spectra 把代码库变成可查询的知识图谱，工具分四组：',
+    '• 上下文导航（最常用）：detect_changes（git diff→受影响 symbol）、impact（某 symbol 的 BFS 影响面与 caller 链）、context（symbol 360°：定义+caller+callee+import）。',
+    '• 文件查看：view_file（按行区间或 symbolId 看片段，省 token 替代全文 Read）、search_in_file（文件内 pattern 搜索）、list_directory（列目录）。',
+    '• 图谱查询：graph_query（关键词子图）、graph_node（节点详情+邻居）、graph_path（两节点最短调用路径）、graph_community（模块聚类）、graph_god_nodes（高耦合枢纽）、graph_hyperedges（跨模块协作超边）。',
+    '• Spec 生成：prepare、generate、batch、diff、panoramic-query。',
+    '',
+    '典型链路：detect_changes → impact → context → view_file（改动评估→影响面→symbol 上下文→定位代码行）。',
+    '按任务选工具：评估改动影响/blast radius → impact；找 caller/谁调用了 X → impact(direction=upstream)；看某 symbol 定义+依赖 → context；定位某段代码行 → view_file；不清楚结构先探索 → graph_query。',
+    '',
+    '恢复流：工具返回 graph-not-built 时，优先运行 `spectra batch --mode graph-only`（纯 AST · 零 LLM · 无需认证 · <2min）快速建图再重试；需要完整 spec 关系图再跑 `spectra batch`。symbol 入参类工具（context/impact/view_file）支持 fuzzy——名字有偏差会自动 resolve（warnings: fuzzy-resolved）或回传候选（context.fuzzyMatches），不必精确。',
+].join('\n');
 /**
  * 创建并配置 MCP Server 实例
  */
 export function createMcpServer() {
-    // 注册所有语言适配器
-    bootstrapAdapters();
-    // 注册所有文档生成器
-    bootstrapGenerators();
-    // 注册所有制品解析器
-    bootstrapParsers();
+    // 单一 runtime 初始化（FR-10）：注册语言适配器 / 文档生成器 / 制品解析器
+    bootstrapRuntime();
+    // F184 FR-002：instructions 属于 SDK 第二个 ServerOptions 参数（非 serverInfo 对象），
+    // 写错位置不会进入 initialize result。
     const server = new McpServer({
         name: 'spectra',
         version: pkg.version,
+    }, {
+        instructions: TOOL_GUIDE,
     });
     // ─── 工具 1: prepare — AST 预处理 + 上下文组装 ───
-    server.tool('prepare', 'AST 预处理 + 上下文组装', {
+    server.tool('prepare', `AST 预处理 + 上下文组装：对文件/目录抽取 CodeSkeleton 结构，供后续 spec 生成。
+
+Use this tool when:
+- 想先看某目录的 AST 结构与语言分布
+- generate 前的轻量预处理
+- 只要结构化骨架、不需要 LLM 推断时
+
+Example:
+- Input: { targetPath: "src/auth", deep: false }
+- Output: { skeletons, mergedSkeleton, detectedLanguages }
+
+Typical chained usage:
+- prepare → generate（预处理后生成完整 spec）`, {
         targetPath: z.string().describe('目标文件或目录路径（绝对或相对于 cwd）'),
         deep: z.boolean().default(false).describe('深度分析模式（包含函数体）'),
-    }, async ({ targetPath, deep }) => {
+    }, withTelemetry('prepare', async (args) => {
+        const { targetPath, deep } = args;
+        // 顶层异常由 withTelemetry 捕获 → 脱敏 internal-error（F177）
+        const result = await prepareContext(targetPath, {
+            deep,
+            projectRoot: process.cwd(),
+        });
+        // 提取 detectedLanguages（Feature 031）—— 局部失败不影响主流程
+        let detectedLanguages;
         try {
-            const result = await prepareContext(targetPath, {
-                deep,
-                projectRoot: process.cwd(),
-            });
-            // 提取 detectedLanguages（Feature 031）
-            let detectedLanguages;
-            try {
-                const resolvedTarget = require('node:path').resolve(targetPath);
-                const fs = require('node:fs');
-                if (fs.statSync(resolvedTarget).isDirectory()) {
-                    const sr = scanFiles(resolvedTarget, { projectRoot: process.cwd() });
-                    if (sr.languageStats && sr.languageStats.size > 0) {
-                        detectedLanguages = Array.from(sr.languageStats.keys());
-                    }
+            const resolvedTarget = resolve(targetPath);
+            if (statSync(resolvedTarget).isDirectory()) {
+                const sr = scanFiles(resolvedTarget, { projectRoot: process.cwd() });
+                if (sr.languageStats && sr.languageStats.size > 0) {
+                    detectedLanguages = Array.from(sr.languageStats.keys());
                 }
             }
-            catch {
-                // 语言检测失败不影响主流程
-            }
-            const responseData = detectedLanguages
-                ? { ...result, detectedLanguages }
-                : result;
-            return {
-                content: [{ type: 'text', text: JSON.stringify(responseData) }],
-            };
         }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `prepare 失败: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
+        catch {
+            // 语言检测失败不影响主流程
         }
-    });
+        const responseData = detectedLanguages
+            ? { ...result, detectedLanguages }
+            : result;
+        return {
+            content: [{ type: 'text', text: JSON.stringify(responseData) }],
+        };
+    }));
     // ─── 工具 2: generate — 完整 Spec 生成流水线 ───
-    server.tool('generate', '完整 Spec 生成流水线', {
+    server.tool('generate', `完整 Spec 生成流水线：对目标文件/目录跑 AST + LLM 推断，产出 .spec.md 文档。
+
+Use this tool when:
+- 要为某模块生成可读的规范文档
+- 单文件/单目录的一次性 spec 生成
+- prepare 之后要落地完整文档
+
+Example:
+- Input: { targetPath: "src/auth/login.ts", deep: true }
+- Output: { specPath, tokenUsage, confidence, warnings }
+
+Typical chained usage:
+- prepare → generate；大范围生成改用 batch`, {
         targetPath: z.string().describe('目标文件或目录路径'),
         deep: z.boolean().default(false).describe('深度分析模式'),
         outputDir: z.string().default('specs').describe('输出目录'),
-    }, async ({ targetPath, deep, outputDir }) => {
-        try {
-            const result = await generateSpec(targetPath, {
-                deep,
-                outputDir,
-                projectRoot: process.cwd(),
-            });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            specPath: result.specPath,
-                            tokenUsage: result.tokenUsage,
-                            confidence: result.confidence,
-                            warnings: result.warnings,
-                        }),
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `generate 失败: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
+    }, withTelemetry('generate', async (args) => {
+        const { targetPath, deep, outputDir } = args;
+        const result = await generateSpec(targetPath, {
+            deep,
+            outputDir,
+            projectRoot: process.cwd(),
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        specPath: result.specPath,
+                        tokenUsage: result.tokenUsage,
+                        confidence: result.confidence,
+                        warnings: result.warnings,
+                    }),
+                },
+            ],
+        };
+    }));
     // ─── 工具 3: batch — 批量 Spec 生成 ───
-    server.tool('batch', '批量 Spec 生成', {
+    server.tool('batch', `批量 Spec 生成：对整个项目按语言/增量批量产出 spec，带 checkpoint 与增量 cache，并生成 graph.json。
+
+Use this tool when:
+- 首次为项目生成全套 spec
+- 代码改动后增量重生成受影响 spec
+- 需要图谱工具的前置 graph.json
+
+Example:
+- Input: { projectRoot: ".", mode: "full" }
+- Output: { successful, skipped, failed, indexGenerated }
+
+Typical chained usage:
+- batch → graph_query / context / impact（先建图再查询）`, {
         projectRoot: z
             .string()
             .optional()
             .describe('项目根目录（默认为当前工作目录）'),
-        force: z.boolean().optional().describe('强制重新生成所有 spec'),
+        full: z
+            .boolean()
+            .optional()
+            .describe('显式全量重生成（regen 轴逃生口，绕过增量 cache + checkpoint）；与 --mode full 质量维度正交'),
+        force: z
+            .boolean()
+            .optional()
+            .describe('强制重新生成所有 spec（full 的等义别名，向后兼容）'),
         incremental: z
             .boolean()
             .optional()
-            .describe('仅重生成受影响的 spec（增量模式）'),
+            .describe('仅重生成受影响的 spec（增量模式）；未指定时默认走增量（FR-001）'),
         languages: z
             .array(z.string())
             .optional()
             .describe('仅处理指定语言（如 ["typescript", "python"]）'),
         // F5：运行模式参数（FR-007）
         mode: z
-            .enum(['full', 'reading', 'code-only'])
+            .enum(['full', 'reading', 'code-only', 'graph-only'])
             .optional()
-            .describe('运行模式：full（默认，完整文档）| reading（轻量，跳过产品文档层）| code-only（纯 AST，跳过所有 LLM 推断）'),
-    }, async ({ projectRoot, force, incremental, languages, mode }) => {
-        try {
-            const root = projectRoot ?? process.cwd();
-            // F5：F-009 修复 — MCP 路径 mode 日志输出（FR-006）
-            const effectiveMode = mode ?? 'full';
-            const mcpLogger = { info: (msg) => console.error(msg) };
-            mcpLogger.info(`[info] batch mode=${effectiveMode}`);
-            // 加载项目配置作为 fallback（MCP 显式参数优先）
-            const fileConfig = loadProjectConfig(root);
-            const result = await runBatch(root, {
-                force: force ?? fileConfig.force,
-                incremental: incremental ?? fileConfig.incremental,
-                languages: languages ?? fileConfig.languages,
-                mode: effectiveMode,
-            });
-            return {
-                content: [{ type: 'text', text: JSON.stringify(result) }],
-            };
-        }
-        catch (err) {
+            .describe('spec 文档质量维度（与 regen 轴正交）：full（默认，完整文档）| reading（轻量，跳过产品文档层）| code-only（仅跳 enrichment 层，仍逐模块调 spec-gen LLM，非零成本）| graph-only（纯 AST · 零 LLM · 无需认证 · 仅建图不生成 spec 文档，可作为 impact/context 工具的前置步骤）'),
+    }, withTelemetry('batch', async (args) => {
+        const { projectRoot, full, force, incremental, languages, mode } = args;
+        const root = projectRoot ?? process.cwd();
+        // F5：F-009 修复 — MCP 路径 mode 日志输出（FR-006）
+        const effectiveMode = mode ?? 'full';
+        const mcpLogger = { info: (msg) => console.error(msg) };
+        mcpLogger.info(`[info] batch mode=${effectiveMode}`);
+        // graph-only 提前拦截：纯 AST 零 LLM，不走 runBatch/regen 轴（复用 buildAstGraphOnly，对齐 CLI 范式）
+        if (effectiveMode === 'graph-only') {
+            if (languages?.length) {
+                mcpLogger.info('[warn] graph-only 不支持 languages 过滤，将全仓建图');
+            }
+            const graphResult = await buildAstGraphOnly(root);
             return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `batch 失败: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
+                content: [{ type: 'text', text: JSON.stringify(graphResult) }],
             };
         }
-    });
+        // 加载项目配置作为 fallback（MCP 显式参数优先）
+        const fileConfig = loadProjectConfig(root);
+        // F175 FR-002：合并 config fallback 后统一解析 regen 计划（唯一默认值来源）。
+        const regenPlan = resolveRegenPlan({
+            incremental: incremental ?? fileConfig.incremental,
+            full,
+            force: force ?? fileConfig.force,
+        });
+        const result = await runBatch(root, {
+            incremental: regenPlan.incremental,
+            full: regenPlan.full,
+            languages: languages ?? fileConfig.languages,
+            mode: effectiveMode,
+        });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    }));
     // ─── 工具 4: diff — Spec 漂移检测 ───
-    server.tool('diff', 'Spec 漂移检测', {
+    server.tool('diff', `Spec 漂移检测：比对 .spec.md 与源码，找出文档与实现的偏差、新增行为、过期条目。
+
+Use this tool when:
+- 代码改动后检查 spec 是否过时
+- 重构前确认 spec 与实现一致
+- 审查 spec 文档准确性
+
+Example:
+- Input: { specPath: "src/auth.spec.md", sourcePath: "src/auth.ts" }
+- Output: { summary, items, recommendation }
+
+Typical chained usage:
+- batch → diff（生成 spec 后检查漂移）`, {
         specPath: z.string().describe('Spec 文件路径（.spec.md）'),
         sourcePath: z.string().describe('源代码文件或目录路径'),
-    }, async ({ specPath, sourcePath }) => {
-        try {
-            const report = await detectDrift(resolve(specPath), resolve(sourcePath));
-            return {
-                content: [{ type: 'text', text: JSON.stringify(report) }],
-            };
-        }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `diff 失败: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
+    }, withTelemetry('diff', async (args) => {
+        const { specPath, sourcePath } = args;
+        const report = await detectDrift(resolve(specPath), resolve(sourcePath));
+        return {
+            content: [{ type: 'text', text: JSON.stringify(report) }],
+        };
+    }));
     // ─── 工具 5: panoramic-query — panoramic 架构分析 ───
-    server.tool('panoramic-query', '运行 panoramic 架构分析，支持 cross-package / architecture-ir / overview / natural-language 四种操作', {
+    server.tool('panoramic-query', `panoramic 架构分析：cross-package / architecture-ir / overview / natural-language 四种操作，做架构级查询。
+
+Use this tool when:
+- 想要 monorepo 跨包依赖全景
+- 问架构级自然语言问题（operation=natural-language）
+- 需要项目 overview 而非单 symbol 上下文
+
+Example:
+- Input: { operation: "natural-language", projectRoot: ".", question: "认证流程怎么走" }
+- Output: { answer, citations, tokenUsage }（其他 operation 返回各自结构，如 architecture-ir 返回 IR、overview 返回分层视图）
+
+Typical chained usage:
+- batch → panoramic-query（建图后做架构级查询）`, {
         operation: z
             .enum(['cross-package', 'architecture-ir', 'overview', 'natural-language'])
             .describe('分析操作类型；natural-language 触发自然语言问答（FR-009）'),
@@ -204,32 +266,28 @@ export function createMcpServer() {
             .string()
             .optional()
             .describe('问题文本（operation=natural-language 时必填，其他 operation 忽略）'),
-    }, async ({ operation, projectRoot, question }) => {
-        try {
-            const result = await queryPanoramic({ operation, projectRoot, question });
-            if (!result.ok) {
-                return {
-                    content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }],
-                };
+    }, withTelemetry('panoramic-query', async (args) => {
+        const { operation, projectRoot, question } = args;
+        const result = await queryPanoramic({ operation, projectRoot, question });
+        if (!result.ok) {
+            // F177（修隐性 bug EC-6：旧实现此路径未置 isError，且用旧 {error} 形态）：
+            // 按 query 层判别区分——预期输入失败回传安全文案；内部异常脱敏为 internal-error
+            // （result.error 可能含绝对路径，不回传原文，spec C-4 / Codex CRITICAL-D）。
+            if (result.kind === 'invalid-input') {
+                return buildErrorResponse('invalid-input', result.error);
             }
-            return {
-                content: [{ type: 'text', text: JSON.stringify(result.data) }],
-            };
+            return buildErrorResponse('internal-error', 'panoramic-query 内部错误');
         }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `panoramic-query 失败: ${err instanceof Error ? err.message : String(err)}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    });
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result.data) }],
+        };
+    }));
     // ─── 注册图谱查询工具（graph_query / graph_node / graph_path / graph_community / graph_god_nodes） ───
     registerGraphTools(server);
+    // ─── Feature 155 — Agent-Context tools（impact / context / detect_changes） ───
+    registerAgentContextTools(server);
+    // ─── Feature 171 — File Navigation tools（view_file / search_in_file / list_directory） ───
+    registerFileNavTools(server);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/models/call-site.d.ts

@@ -0,0 +1,68 @@
+/**
+ * CallSite — 单个函数调用位置的原始记录（CL-01 schema）。
+ *
+ * 由各语言 mapper 在 AST 抽取阶段产出（如 PythonMapper.extractCallSites），
+ * 由 call-resolver 在 buildUnifiedGraph 阶段消费，产出 calls 边。
+ *
+ * 设计层级（DAG 方向）：models → knowledge-graph → panoramic。
+ * 本文件位于 models 层，被 CodeSkeleton 与 UnifiedGraph 双向消费但不反向依赖任一上层。
+ */
+import { z } from 'zod';
+/**
+ * CalleeKind — 函数调用 callee 的分类。
+ *
+ * - `free`：模块顶层 callable（同模块函数 / 全局函数）
+ * - `member`：self.method() / Class.method() 形式
+ * - `cross-module`：通过 import 引入的外部 callee
+ * - `dunder`：__add__ / __radd__ 等运算符重载（binary_operator / unary_operator AST 派生）
+ * - `super`：super().method() 调用链
+ * - `decorator`：带参 decorator（@app.route("/x") 形式；bare decorator 不记录，CL-04）
+ * - `unresolved`：解析失败 / 无法定位 → call-resolver 进入 Stage 4 兜底
+ */
+export declare const CalleeKindSchema: z.ZodEnum<["free", "member", "cross-module", "dunder", "super", "decorator", "unresolved"]>;
+export type CalleeKind = z.infer<typeof CalleeKindSchema>;
+/**
+ * CallSite — 单个函数调用位置的原始记录。
+ *
+ * confidence **不在此 schema 上**：tier 由 call-resolver 在 4 阶段 resolution 后计算，
+ * CallSite 仅承载位置 + 分类 + caller 上下文等用于 resolver 决策的最小信息。
+ */
+export declare const CallSiteSchema: z.ZodObject<{
+    /** callee 名称（如 "foo" / "method" / "__add__"） */
+    calleeName: z.ZodString;
+    /** callee 分类（CL-01：必填，决定 resolver 进入哪个 Stage） */
+    calleeKind: z.ZodEnum<["free", "member", "cross-module", "dunder", "super", "decorator", "unresolved"]>;
+    /** 调用所在源码行号（1-based，CL-01：必填，便于 cross-module debug） */
+    line: z.ZodNumber;
+    /** 调用所在列号（CL-01：可选，节省 schema 字节） */
+    column: z.ZodOptional<z.ZodNumber>;
+    /** caller 所在 function/class 上下文（如 "Value.__add__"，用于 member resolution） */
+    callerContext: z.ZodOptional<z.ZodString>;
+    /**
+     * callee 限定符 — Codex P1 C-2 修订。
+     *
+     * 用于 attribute call（如 `Engine.helper()` / `numpy.array()` / `obj.method()`）的 receiver 名。
+     * resolver 会优先用此 qualifier 在 importIndex / classMemberIndex 中定位 callee 真实来源：
+     * - calleeKind=cross-module → calleeQualifier 是 module alias（如 "numpy"）
+     * - calleeKind=member（Class.method 形式）→ calleeQualifier 是类名（如 "Engine"）
+     * - calleeKind=member（self/cls.method）→ calleeQualifier=undefined（用 callerContext）
+     * - calleeKind=free / dunder / decorator / super / unresolved → 通常 undefined
+     */
+    calleeQualifier: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    calleeName: string;
+    calleeKind: "free" | "member" | "cross-module" | "dunder" | "super" | "decorator" | "unresolved";
+    line: number;
+    column?: number | undefined;
+    callerContext?: string | undefined;
+    calleeQualifier?: string | undefined;
+}, {
+    calleeName: string;
+    calleeKind: "free" | "member" | "cross-module" | "dunder" | "super" | "decorator" | "unresolved";
+    line: number;
+    column?: number | undefined;
+    callerContext?: string | undefined;
+    calleeQualifier?: string | undefined;
+}>;
+export type CallSite = z.infer<typeof CallSiteSchema>;
+//# sourceMappingURL=call-site.d.ts.map

package/dist/models/call-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-site.d.ts","sourceRoot":"","sources":["../../src/models/call-site.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,6FAQ3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,cAAc;IACzB,gDAAgD;;IAEhD,iDAAiD;;IAEjD,uDAAuD;;IAEvD,oCAAoC;;IAEpC,2EAA2E;;IAE3E;;;;;;;;;OASG;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/models/call-site.js

@@ -0,0 +1,60 @@
+/**
+ * CallSite — 单个函数调用位置的原始记录（CL-01 schema）。
+ *
+ * 由各语言 mapper 在 AST 抽取阶段产出（如 PythonMapper.extractCallSites），
+ * 由 call-resolver 在 buildUnifiedGraph 阶段消费，产出 calls 边。
+ *
+ * 设计层级（DAG 方向）：models → knowledge-graph → panoramic。
+ * 本文件位于 models 层，被 CodeSkeleton 与 UnifiedGraph 双向消费但不反向依赖任一上层。
+ */
+import { z } from 'zod';
+/**
+ * CalleeKind — 函数调用 callee 的分类。
+ *
+ * - `free`：模块顶层 callable（同模块函数 / 全局函数）
+ * - `member`：self.method() / Class.method() 形式
+ * - `cross-module`：通过 import 引入的外部 callee
+ * - `dunder`：__add__ / __radd__ 等运算符重载（binary_operator / unary_operator AST 派生）
+ * - `super`：super().method() 调用链
+ * - `decorator`：带参 decorator（@app.route("/x") 形式；bare decorator 不记录，CL-04）
+ * - `unresolved`：解析失败 / 无法定位 → call-resolver 进入 Stage 4 兜底
+ */
+export const CalleeKindSchema = z.enum([
+    'free',
+    'member',
+    'cross-module',
+    'dunder',
+    'super',
+    'decorator',
+    'unresolved',
+]);
+/**
+ * CallSite — 单个函数调用位置的原始记录。
+ *
+ * confidence **不在此 schema 上**：tier 由 call-resolver 在 4 阶段 resolution 后计算，
+ * CallSite 仅承载位置 + 分类 + caller 上下文等用于 resolver 决策的最小信息。
+ */
+export const CallSiteSchema = z.object({
+    /** callee 名称（如 "foo" / "method" / "__add__"） */
+    calleeName: z.string().min(1),
+    /** callee 分类（CL-01：必填，决定 resolver 进入哪个 Stage） */
+    calleeKind: CalleeKindSchema,
+    /** 调用所在源码行号（1-based，CL-01：必填，便于 cross-module debug） */
+    line: z.number().int().positive(),
+    /** 调用所在列号（CL-01：可选，节省 schema 字节） */
+    column: z.number().int().nonnegative().optional(),
+    /** caller 所在 function/class 上下文（如 "Value.__add__"，用于 member resolution） */
+    callerContext: z.string().optional(),
+    /**
+     * callee 限定符 — Codex P1 C-2 修订。
+     *
+     * 用于 attribute call（如 `Engine.helper()` / `numpy.array()` / `obj.method()`）的 receiver 名。
+     * resolver 会优先用此 qualifier 在 importIndex / classMemberIndex 中定位 callee 真实来源：
+     * - calleeKind=cross-module → calleeQualifier 是 module alias（如 "numpy"）
+     * - calleeKind=member（Class.method 形式）→ calleeQualifier 是类名（如 "Engine"）
+     * - calleeKind=member（self/cls.method）→ calleeQualifier=undefined（用 callerContext）
+     * - calleeKind=free / dunder / decorator / super / unresolved → 通常 undefined
+     */
+    calleeQualifier: z.string().optional(),
+});
+//# sourceMappingURL=call-site.js.map

package/dist/models/call-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-site.js","sourceRoot":"","sources":["../../src/models/call-site.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,MAAM;IACN,QAAQ;IACR,cAAc;IACd,QAAQ;IACR,OAAO;IACP,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,gDAAgD;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,iDAAiD;IACjD,UAAU,EAAE,gBAAgB;IAC5B,uDAAuD;IACvD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,oCAAoC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACjD,2EAA2E;IAC3E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC;;;;;;;;;OASG;IACH,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}