feat(v0.2.5): add variable tracking, line-level references, and symbol_refs

- Add module-level variable tracking (const/static/let/var) for all 8 languages
  (TypeScript, JavaScript, Python, Go, Rust, Java, C, C++)
- Add line-level cross-file reference tracking (SymbolRef with import_line + use_lines)
- Add scan_symbol_uses to scanner for identifier-level usage detection
- Upgrade query engine: --type variable filter, CallerRef with line info
- Fix collect_module_stats double-counting bug in slicer.rs
- Fix update command to compute symbol_refs during incremental updates
- Add 25 integration tests (variable_compat.rs) covering all languages + pipeline
- Restore 3 deleted query tests (query_dependencies, format_symbol_results)
- Update plugin version 0.2.4 → 0.2.5, CLI version 0.2.0 → 0.2.5
- Update README, query command prompt, and SKILL.md routing table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: invalid

README.md

@@ -10,6 +10,8 @@ AST-based code graph mapping plugin for [Claude Code](https://docs.anthropic.com
 - **AST 解析 / AST Parsing** — 使用 tree-sitter 原生绑定进行精确的结构分析，非正则猜测 / Uses tree-sitter native bindings for accurate structural analysis, no regex guessing
 - **多语言支持 / Multi-Language** — TypeScript, JavaScript, Python, Go, Rust, Java, C, C++
 - **智能切片 / Smart Slicing** — 项目概览 (~500 tokens) + 按模块切片 (~2-5k tokens)，替代全量源码 (~200k+) / Project overview (~500 tokens) + per-module slices (~2-5k tokens) instead of full source (~200k+)
+- **变量追踪 / Variable Tracking** — 追踪模块级 const/static/let/var 声明，支持按 `--type variable` 查询 / Tracks module-level const/static/let/var declarations, queryable with `--type variable`
+- **行号级引用 / Line-Level References** — 跨文件引用精确到 import 行号 + 使用行号，而非仅文件名 / Cross-file references pinpoint import line + usage lines, not just file names
 - **增量更新 / Incremental Updates** — 基于文件哈希比较检测变更，仅重新解析修改的文件 / File hash comparison detects changes; only re-parses modified files
 - **影响分析 / Impact Analysis** — 重构前查看哪些模块会受影响 / See what's affected before you refactor
 - **自动触发 / Auto-Triggering** — Skill 根据对话上下文自动激活 / Skills activate automatically based on your conversation context
@@ -170,8 +172,8 @@ cd rust-cli && cargo test
 # 2. 提交并打 tag，CI 自动构建并发布 / Commit, tag, and let CI build & release
 cd ..
 git add .
-git commit -m "release: v0.2.2"
-git tag v0.2.2
+git commit -m "release: v0.2.5"
+git tag v0.2.5
 git push origin main --tags
 # GitHub Actions 会自动为所有平台构建并创建 Release
 # GitHub Actions will automatically build for all platforms and create a Release
@@ -217,7 +219,7 @@ CodeMap/
 │   │   ├── path_utils.rs       #   共享路径工具函数
 │   │   ├── traverser.rs        #   文件遍历与语言检测
 │   │   └── languages/          #   语言适配器 (8 种)
-│   └── tests/                  #   集成测试 (286 tests)
+│   └── tests/                  #   集成测试 (127 tests)
 ├── README.md
 └── LICENSE                     # MIT
 ```
@@ -234,7 +236,7 @@ All commands run via `codegraph <command>` (pre-compiled binary, no Node.js requ
 |---------|-------------|
 | `scan <dir>` | 全量 AST 扫描，生成 `.codemap/` 图谱和切片 / Full AST scan, generates `.codemap/` with graph + slices |
 | `status [dir]` | 显示图谱元信息（文件数、模块、上次扫描时间）/ Show graph metadata (files, modules, last scan time) |
-| `query <symbol>` | 按名称搜索函数、类、类型 / Search for functions, classes, types by name |
+| `query <symbol>` | 按名称搜索函数、类、类型、变量 / Search for functions, classes, types, variables by name |
 | `slice [module]` | 输出项目概览或指定模块切片（JSON）/ Output project overview or a specific module slice as JSON |
 | `update [dir]` | 增量更新——仅重新解析变更的文件 / Incremental update — re-parse only changed files |
 | `impact <target>` | 分析修改目标会影响哪些模块 / Analyze which modules are affected by changing a target |
@@ -306,14 +308,14 @@ The `codemap` skill auto-activates based on conversation context and intelligent
 
 | 语言 / Language | 扩展名 / Extensions | 提取结构 / Extracted Structures |
 |----------|-----------|---------------------|
-| TypeScript | `.ts`, `.tsx` | 函数、导入、导出、类、接口、类型别名 / Functions, imports, exports, classes, interfaces, type aliases |
-| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | 函数、导入、导出、类 / Functions, imports, exports, classes |
-| Python | `.py` | 函数（含装饰器）、导入、`__all__` 导出、类 / Functions (decorated), imports, `__all__` exports, classes |
-| Go | `.go` | 函数、方法（含接收者）、导入、导出名、结构体、类型声明 / Functions, methods (with receiver), imports, exported names, structs, type specs |
-| Rust | `.rs` | 函数、impl 方法、use 声明、pub 导出、结构体、枚举、trait / Functions, impl methods, use declarations, pub exports, structs, enums, traits |
-| Java | `.java` | 方法、构造器、导入、public 导出、类、接口、枚举 / Methods, constructors, imports, public exports, classes, interfaces, enums |
-| C | `.c`, `.h` | 函数、`#include`、非 static 导出、结构体、枚举、typedef / Functions, `#include`, non-static exports, structs, enums, typedefs |
-| C++ | `.cpp`, `.cc`, `.cxx`, `.hpp`, `.hh` | 限定函数名（`Class::method`）、include、类、结构体、命名空间 / Qualified functions (`Class::method`), includes, classes, structs, namespaces |
+| TypeScript | `.ts`, `.tsx` | 函数、导入、导出、类、接口、类型别名、变量（const/let）/ Functions, imports, exports, classes, interfaces, type aliases, variables (const/let) |
+| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` | 函数、导入、导出、类、变量（const/let）/ Functions, imports, exports, classes, variables (const/let) |
+| Python | `.py` | 函数（含装饰器）、导入、`__all__` 导出、类、模块级变量 / Functions (decorated), imports, `__all__` exports, classes, module-level variables |
+| Go | `.go` | 函数、方法（含接收者）、导入、导出名、结构体、类型声明、变量（var/const）/ Functions, methods (with receiver), imports, exported names, structs, type specs, variables (var/const) |
+| Rust | `.rs` | 函数、impl 方法、use 声明、pub 导出、结构体、枚举、trait、变量（const/static）/ Functions, impl methods, use declarations, pub exports, structs, enums, traits, variables (const/static) |
+| Java | `.java` | 方法、构造器、导入、public 导出、类、接口、枚举、静态字段 / Methods, constructors, imports, public exports, classes, interfaces, enums, static fields |
+| C | `.c`, `.h` | 函数、`#include`、非 static 导出、结构体、枚举、typedef、全局变量 / Functions, `#include`, non-static exports, structs, enums, typedefs, global variables |
+| C++ | `.cpp`, `.cc`, `.cxx`, `.hpp`, `.hh` | 限定函数名（`Class::method`）、include、类、结构体、命名空间、全局变量 / Qualified functions (`Class::method`), includes, classes, structs, namespaces, global variables |
 
 ---
 
@@ -341,7 +343,7 @@ Scanning produces a `.codemap/` directory inside the target project:
 ```bash
 cd rust-cli
 cargo test
-# 286 tests, all passing
+# 127 tests, all passing
 ```
 
 ## 许可证 / License

ccplugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codemap",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "AST-based code graph mapping plugin for Claude Code — scan once, persist structural graph, load compact slices to save ~95% tokens",
   "author": {
     "name": "killvxk",

ccplugin/commands/query.md

@@ -1,17 +1,17 @@
 ---
-description: 在代码图谱中查询函数、类、类型的定义位置和调用关系
+description: 在代码图谱中查询函数、类、类型、变量的定义位置和调用关系
 arguments:
   - name: symbol
-    description: 要查询的符号名称（函数名、类名、类型名）
+    description: 要查询的符号名称（函数名、类名、类型名、变量名）
     required: true
   - name: type
-    description: "过滤符号类型: function, class, type"
+    description: "过滤符号类型: function, class, type, variable"
     required: false
 ---
 
 # CodeMap Query — 符号查询
 
-在代码图谱中搜索函数、类、类型或模块的定义和关联信息。
+在代码图谱中搜索函数、类、类型、变量或模块的定义和关联信息。
 
 ## 执行步骤
 
@@ -24,10 +24,10 @@ arguments:
 ### 2. 展示结果
 
 向用户展示：
-- 符号类型（函数/类/接口/类型别名）
+- 符号类型（函数/类/接口/类型别名/变量）
 - 定义位置（文件:行号）
-- 函数签名（如果是函数）
-- 调用者和被调用者
+- 函数签名（如果是函数）或变量声明（如果是变量）
+- 调用者和被调用者（含行号级引用信息）
 - 所属模块
 
 ### 3. 深入查看

ccplugin/skills/codemap/SKILL.md

@@ -9,6 +9,7 @@ description: >
   影响分析, 重构, scan, load, query, impact, update, prompts, codemap, code graph,
   understand codebase, project overview, code structure, 了解代码, 开始工作,
   查找函数, 哪里定义, 谁调用了, 影响范围, 依赖分析, 更新图谱, 刷新,
+  变量, 常量, variable, const, static, 全局变量, 模块变量,
   CLAUDE.md, 使用规范, 注入规则.
 ---
 
@@ -44,7 +45,8 @@ ls .codemap/graph.json 2>/dev/null && echo "CODEMAP_EXISTS" || echo "NO_CODEMAP"
 |----------|----------|
 | 会话刚开始 / 想了解项目 / 无特定需求 | 执行 `/codemap:load` 加载概览 |
 | 提到特定模块名 | 执行 `/codemap:load <模块名>` |
-| 问某个函数/类/类型在哪、谁调用了 | 执行 `/codemap:query <符号名>` |
+| 问某个函数/类/类型/变量在哪、谁调用了 | 执行 `/codemap:query <符号名>` |
+| 查询变量/常量定义 | 执行 `/codemap:query <变量名> --type variable` |
 | 谈到重构、改动影响、风险评估 | 执行 `/codemap:impact <目标>` |
 | 说代码改了、图谱过期、要刷新 | 执行 `/codemap:update` |
 | 要重新全量扫描 | 执行 `/codemap:scan` |

rust-cli/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "codegraph"
-version = "0.2.0"
+version = "0.2.5"
 edition = "2021"
 
 [[bin]]

rust-cli/Cargo.toml

@@ -5,7 +5,7 @@ use std::path::PathBuf;
 pub struct QueryArgs {
     /// Symbol or module name to query
     pub symbol: String,
-    /// Filter by type: function, class, or type
+    /// Filter by type: function, class, type, or variable
     #[arg(long)]
     pub r#type: Option<String>,
     /// Project directory

rust-cli/src/commands/query.rs

@@ -125,13 +125,32 @@ pub fn run(args: UpdateArgs) {
         let lang_imports = adapter.extract_imports(&tree, content);
         let lang_exports = adapter.extract_exports(&tree, content);
         let lang_classes = adapter.extract_classes(&tree, content);
+        let lang_variables = adapter.extract_variables(&tree, content);
         let lines = content.iter().filter(|&&b| b == b'\n').count() as u32 + 1;
 
         let functions = crate::scanner::convert_functions(&lang_functions);
         let classes = crate::scanner::convert_classes(&lang_classes);
         let types = crate::scanner::convert_types(&lang_classes, lang);
         let imports = crate::scanner::convert_imports(&lang_imports);
         let exports = crate::scanner::convert_exports(&lang_exports);
+        let variables = crate::scanner::convert_variables(&lang_variables);
+
+        // 构建 symbol_refs（与 scan_project 一致）
+        let imported_symbols: std::collections::HashSet<String> = imports.iter()
+            .flat_map(|imp| imp.symbols.iter().cloned())
+            .collect();
+        let symbol_uses = crate::scanner::scan_symbol_uses(&tree, content, &imported_symbols);
+        let mut symbol_refs: std::collections::BTreeMap<String, crate::graph::SymbolRef> = std::collections::BTreeMap::new();
+        for imp in &imports {
+            for sym in &imp.symbols {
+                let use_lines = symbol_uses.get(sym).cloned().unwrap_or_default();
+                symbol_refs.insert(sym.clone(), crate::graph::SymbolRef {
+                    symbol: sym.clone(),
+                    import_line: imp.import_line,
+                    use_lines,
+                });
+            }
+        }
 
         let module_name = crate::scanner::detect_module_name(&abs_path, &root);
         let hash = new_hashes[rel_path].clone();
@@ -146,9 +165,11 @@ pub fn run(args: UpdateArgs) {
                 functions,
                 classes,
                 types,
+                variables,
                 imports,
                 exports,
                 is_entry_point: crate::graph::is_entry_point(&abs_path),
+                symbol_refs,
             },
         );
     }

rust-cli/src/commands/update.rs

@@ -239,9 +239,11 @@ mod tests {
             functions: vec![],
             classes: vec![],
             types: vec![],
+            variables: vec![],
             imports: vec![],
             exports: vec![],
             is_entry_point: false,
+            symbol_refs: std::collections::BTreeMap::new(),
         }
     }
 
@@ -387,6 +389,7 @@ mod tests {
             source: "../utils/helper".to_string(),
             symbols: vec![],
             is_external: false,
+            import_line: 0,
         }];
         graph.files.insert("src/auth/login.ts".to_string(), auth_file);
 

rust-cli/src/differ.rs

@@ -22,6 +22,8 @@ pub struct ImportInfo {
     pub symbols: Vec<String>,
     #[serde(rename = "isExternal")]
     pub is_external: bool,
+    #[serde(rename = "importLine", default)]
+    pub import_line: u32,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize)]
@@ -43,6 +45,25 @@ pub struct TypeInfo {
     pub end_line: u32,
 }
 
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct VariableInfo {
+    pub name: String,
+    pub kind: String, // "const" | "static" | "let" | "var"
+    #[serde(rename = "startLine")]
+    pub start_line: u32,
+    #[serde(rename = "isExported", default)]
+    pub is_exported: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct SymbolRef {
+    pub symbol: String,
+    #[serde(rename = "importLine", default)]
+    pub import_line: u32,
+    #[serde(rename = "useLines", default)]
+    pub use_lines: Vec<u32>,
+}
+
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct FileEntry {
     pub language: String,
@@ -52,10 +73,14 @@ pub struct FileEntry {
     pub functions: Vec<FunctionInfo>,
     pub classes: Vec<ClassInfo>,
     pub types: Vec<TypeInfo>,
+    #[serde(default)]
+    pub variables: Vec<VariableInfo>,
     pub imports: Vec<ImportInfo>,
     pub exports: Vec<String>,
     #[serde(rename = "isEntryPoint")]
     pub is_entry_point: bool,
+    #[serde(rename = "symbolRefs", default)]
+    pub symbol_refs: BTreeMap<String, SymbolRef>,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize)]
@@ -81,6 +106,8 @@ pub struct GraphSummary {
     pub total_functions: u32,
     #[serde(rename = "totalClasses")]
     pub total_classes: u32,
+    #[serde(rename = "totalVariables", default)]
+    pub total_variables: u32,
     pub languages: HashMap<String, u32>,
     pub modules: Vec<String>,
     #[serde(rename = "entryPoints")]
@@ -153,6 +180,7 @@ pub fn create_empty_graph(project_name: &str, root_dir: &str) -> CodeGraph {
             total_files: 0,
             total_functions: 0,
             total_classes: 0,
+            total_variables: 0,
             languages: HashMap::new(),
             modules: vec![],
             entry_points: vec![],