codegraph-java 0.1.0

package/README.md

@@ -0,0 +1,131 @@
+# CodeGraph
+
+面向 Java 代码库的语义代码图谱引擎 —— 将 Java 工程解析为可查询的知识图谱，供 AI 编码助手与开发者使用。**索引与分析 100% 在本地完成。**
+
+## 特性
+
+- **语义图谱**：用 tree-sitter 解析 Java 源码，生成符号 + 调用 / 继承 / 引用关系，存入本地 SQLite（FTS5 全文检索 + WAL）。
+- **MCP Server**：`cg install` 将 MCP 工具接入 Claude Code、Cursor、Codex CLI、opencode、Gemini CLI、Antigravity、Kiro、GitHub Copilot 等 AI 助手，用几次精准调用代替大量 Read/Grep。
+- **浏览器查看器**：`cg ui` 在 `http://127.0.0.1:4747` 以图形方式阅读图谱（符号视图 / 调用流 / 架构 Map / 影响分析 / 受影响测试等）；界面支持中 / 英文切换。
+- **Spring 感知**：识别 Spring Boot 控制器与配置绑定（route 节点），支持 application 配置键引用解析。
+- **确定性抽取**：图谱由 AST 派生，而非 LLM 摘要；同一版本对同一代码产出稳定结果。
+- **增量同步**：文件变更自动更新索引（`cg sync` / 常驻守护进程）。
+
+## 环境要求
+
+- **Node.js ≥ 22.5 且 < 25**（依赖内置 `node:sqlite`）。
+- 无需安装 Java 编译器或 Rust 工具链（解析使用内置 wasm 语法库）。
+
+## 安装
+
+```bash
+npm i -g codegraph-java
+```
+
+> 本产品是普通 npm 包，直接运行在你的 Node 运行时上；不提供自带 Node 的自包含安装器。
+
+## 快速开始
+
+```bash
+cd your-java-project
+cg init          # 在项目下创建 .codegraph/（初始化，不建索引）
+cg build         # 构建完整索引（可先编辑 .codegraph/codegraph.json 再执行）
+cg status        # 查看索引统计（Files by Language 应为 java）
+cg ui            # 在浏览器打开图谱查看器（127.0.0.1:4747）
+```
+
+### 接入 AI 助手（MCP）
+
+```bash
+cg install       # 检测并把 CodeGraph MCP server 写入已安装的 agent
+```
+
+### 常用命令
+
+| 命令                                        | 作用                                              |
+| ----------------------------------------- | ----------------------------------------------- |
+| `cg init [path]`                   | 初始化项目（创建 .codegraph/ 与配置，不建索引）              |
+| `cg build [path]`                  | 构建完整索引（全量重建）                                  |
+| `cg index [path]`                  | 全量重建索引（同 `cg build`）                           |
+| `cg sync [path]`                   | 增量同步变更                                          |
+| `cg status [path]`                 | 查看索引状态与统计                                       |
+| `cg query <search>`                | 按名称搜索符号                                         |
+| `cg explore <问题>`                  | 一次输出相关符号源码 + 调用路径（与 MCP `codegraph_explore` 同源） |
+| `cg context <任务>`                  | 为任务构建上下文：相关符号、关系与代码块                            |
+| `cg node <name>`                   | 查看符号源码与调用者/被调者链，或带行号读取文件                        |
+| `cg callers/callees/impact <name>` | 调用链与影响分析                                        |
+| `cg affected <files...>`           | 找出受变更影响的测试文件                                    |
+| `cg ui [path]`                     | 在浏览器打开图谱查看器（别名 `cg web`）                 |
+| `cg telemetry [on\|off\|status]`   | 管理匿名使用统计（见“遥测与隐私”）                              |
+| `cg install / uninstall`           | 把 CodeGraph 接入 / 移出 AI 助手                       |
+| `cg upgrade`                       | 升级到最新版（npm）                                     |
+| `cg uninit [path]`                 | 删除某项目的 `.codegraph/` 索引                         |
+
+## 项目级配置
+
+每个项目的配置与其索引数据同放于 `.codegraph/` 目录下：
+
+```jsonc
+// <project>/.codegraph/codegraph.json
+{
+  "exclude": ["**/billentity/**", "**/generated/**"]
+}
+```
+
+常用键：
+
+- `exclude`：gitignore 风格，彻底排除的路径（不进入索引）。
+- `include`：强制纳入（即使被 .gitignore 排除）。
+- `deprioritize`：保留但降低搜索排序权重。
+- `extensions`：自定义扩展名 → 语言映射（映射目标仅 `java`）。
+
+> 兼容说明：旧版位于项目根目录的 `codegraph.json` 仅做读取兼容，新的写入恒落在 `.codegraph/codegraph.json`。
+
+## 数据与体积
+
+索引数据存于项目内 `.codegraph/`（`codegraph.db` 等）。Java-only 实测参考（854 个 `.java`）：约 28,691 符号节点 / 65,574 关系边 / 3.3s 建图（详见 [docs/java-only-cutdown-checklist.md](docs/java-only-cutdown-checklist.md)）。
+
+工程实践建议：对大型仓库用 `exclude` 排除生成代码（如实体元数据类、`generated/**`），可显著压缩体积，且业务代码间的调用关系保持完整。
+
+## 仓库结构（顶层）
+
+| 目录         | 作用                                                                         |
+| ---------- | -------------------------------------------------------------------------- |
+| `src/`     | 引擎主体（TypeScript）：CLI、MCP server/daemon、提取、语义解析、图谱、内置 UI 服务、升级。发布包的构建来源。    |
+| `ui/`      | Svelte 图谱查看器（npm workspace，`@randlly/codegraph-ui`）；构建产物内嵌到 `dist/viewer`。 |
+| `scripts/` | 构建、门禁与发布辅助脚本。                                                              |
+| `docs/`    | 设计文档与 Java-only 裁剪维护记录。                                                    |
+
+> 发布包（npm `files`）只包含构建产物 `dist/` 与 README；除 `src/`、`ui/` 外的目录均为本地开发可选内容。
+
+## 开发与构建
+
+```bash
+npm ci
+npm run build             # tsc + 资源拷贝 + 查看器构建 + 构建门禁（全绿才能发布）
+npm run dev               # tsc --watch
+npm run cli               # build 后运行本地 CLI
+```
+
+说明：`ui/` 是 npm workspace（`npm run build --workspace ui` / 根 `build:ui` 已纳入默认构建链）；查看器由引擎内嵌服务，无需单独部署。
+
+## 遥测与隐私
+
+引擎内置**匿名使用统计**，用于统计子命令使用频率、是否成功、索引规模等**聚合指标，不含任何源码内容**。默认开启，上报到上游端点 `telemetry.getcodegraph.com`（本地缓冲、批量发送、完全静默失败）；可通过以下任一方式关闭，关闭后**不记录、不发送、并清空已缓冲数据**：
+
+```bash
+cg telemetry off       # 或 on / status
+# 环境变量方式：CODEGRAPH_TELEMETRY=0  或  DO_NOT_TRACK=1
+```
+
+采集契约详见 `docs/design/telemetry.md`；当前上报沿用上游端点 `telemetry.getcodegraph.com`（自建端点代码已从本仓库移除，需要时可从上游源码单独部署）。
+
+## 卸载
+
+```bash
+cg uninstall       # 移除已配置 agent 中的 CodeGraph，并可选删除 CLI
+cg uninit <path>   # 删除某项目的 .codegraph/ 索引
+```
+
+<br />
+

package/dist/base-graph/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * baseGraph — 跨图快照合并（upstream snapshot merge）
+ *
+ * 让下游项目把自己的调用/reference 指向的 UPSTREAM 代码图谱「合并」进本地图，
+ * 从而本地建图后能像查本地符号一样查询上游（calls/references 等边会被本地
+ * resolution 直接解析到这些导入的上游节点上，图遍历/上下文/MCP 无需任何改动）。
+ *
+ * 合并在全量建图（`cg build` / `cg index`）时执行、且仅在全量建图时执行：
+ *   1. 读取上游项目根下的 `.codegraph/codegraph.db`（只读连接）。
+ *   2. 校验上游 schema 版本与当前一致（不一致则拒绝合并，保持确定性）。
+ *   3. 把所有上游节点以 `origin='base'` 拷入本地（INSERT OR IGNORE，id 冲突时
+ *      本地节点优先 —— 上游是「外部」来源，本地同名定义更应被保留）。
+ *   4. 把所有上游边以 `origin='base'` 拷入本地（两端 id 均已存在，满足外键）。
+ *   5. 把导入统计写入本地 project_metadata，供 `cg status` / stats 展示。
+ *
+ * 快照模式（而非 Java 版的 LINKS_TO_BASE 透明跳转）是适配当前 TS 图模型的选择：
+ * 本项目边以节点 `id`（hash(filePath+qualifiedName)）做外键且 `foreign_keys=ON`，
+ * 无法像 Java（边存 FQN 字符串）那样指向本地不存在的上游节点。把上游节点拷进来
+ * 是让「边→节点」仍然闭合、查询层零改造的最小改动。
+ *
+ * 配置（`<项目根>/.codegraph/codegraph.json`）：
+ *   {
+ *     "baseGraph": { "path": "../upstream-project-root" }
+ *   }
+ * `path` 是上游项目根（包含其 `.codegraph/codegraph.db`），可为相对路径。
+ */
+import { DatabaseConnection } from '../db';
+/** Result of a successful baseGraph snapshot merge. */
+export interface BaseGraphImportResult {
+    /** Absolute upstream project root that was merged from. */
+    baseProject: string;
+    /** Number of upstream nodes actually inserted (skipped duplicates not counted). */
+    importedNodes: number;
+    /** Number of upstream edges actually inserted. */
+    importedEdges: number;
+    /** Upstream project name (basename of the project root), for stats/status. */
+    baseProjectName: string;
+}
+/** project_metadata keys written by a baseGraph merge. */
+export declare const BASE_GRAPH_METADATA_KEYS: {
+    readonly path: "base_graph_path";
+    readonly project: "base_graph_project";
+    readonly importedAt: "base_graph_imported_at";
+    readonly nodes: "base_graph_nodes";
+    readonly edges: "base_graph_edges";
+};
+/**
+ * Merge the configured upstream baseGraph into the local graph as a snapshot.
+ * Runs during a full build, while the store is still in the bulk-load window
+ * (before FTS/secondary indexes are rebuilt), so imported nodes/edges are
+ * captured by those rebuilds and available to the resolution pass.
+ *
+ * No-op (returns null) when no `baseGraph.path` is configured. Warnings (never
+ * fatal) when the upstream graph is missing or its schema version differs.
+ */
+export declare function mergeBaseGraphSnapshot(local: DatabaseConnection, projectRoot: string): BaseGraphImportResult | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/base-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base-graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAM3C,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB;;;;;;CAM3B,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,WAAW,EAAE,MAAM,GAClB,qBAAqB,GAAG,IAAI,CA8C9B"}

package/dist/base-graph/index.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * baseGraph — 跨图快照合并（upstream snapshot merge）
+ *
+ * 让下游项目把自己的调用/reference 指向的 UPSTREAM 代码图谱「合并」进本地图，
+ * 从而本地建图后能像查本地符号一样查询上游（calls/references 等边会被本地
+ * resolution 直接解析到这些导入的上游节点上，图遍历/上下文/MCP 无需任何改动）。
+ *
+ * 合并在全量建图（`cg build` / `cg index`）时执行、且仅在全量建图时执行：
+ *   1. 读取上游项目根下的 `.codegraph/codegraph.db`（只读连接）。
+ *   2. 校验上游 schema 版本与当前一致（不一致则拒绝合并，保持确定性）。
+ *   3. 把所有上游节点以 `origin='base'` 拷入本地（INSERT OR IGNORE，id 冲突时
+ *      本地节点优先 —— 上游是「外部」来源，本地同名定义更应被保留）。
+ *   4. 把所有上游边以 `origin='base'` 拷入本地（两端 id 均已存在，满足外键）。
+ *   5. 把导入统计写入本地 project_metadata，供 `cg status` / stats 展示。
+ *
+ * 快照模式（而非 Java 版的 LINKS_TO_BASE 透明跳转）是适配当前 TS 图模型的选择：
+ * 本项目边以节点 `id`（hash(filePath+qualifiedName)）做外键且 `foreign_keys=ON`，
+ * 无法像 Java（边存 FQN 字符串）那样指向本地不存在的上游节点。把上游节点拷进来
+ * 是让「边→节点」仍然闭合、查询层零改造的最小改动。
+ *
+ * 配置（`<项目根>/.codegraph/codegraph.json`）：
+ *   {
+ *     "baseGraph": { "path": "../upstream-project-root" }
+ *   }
+ * `path` 是上游项目根（包含其 `.codegraph/codegraph.db`），可为相对路径。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_GRAPH_METADATA_KEYS = void 0;
+exports.mergeBaseGraphSnapshot = mergeBaseGraphSnapshot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const db_1 = require("../db");
+const db_2 = require("../db");
+const migrations_1 = require("../db/migrations");
+const project_config_1 = require("../project-config");
+const errors_1 = require("../errors");
+/** project_metadata keys written by a baseGraph merge. */
+exports.BASE_GRAPH_METADATA_KEYS = {
+    path: 'base_graph_path',
+    project: 'base_graph_project',
+    importedAt: 'base_graph_imported_at',
+    nodes: 'base_graph_nodes',
+    edges: 'base_graph_edges',
+};
+/**
+ * Merge the configured upstream baseGraph into the local graph as a snapshot.
+ * Runs during a full build, while the store is still in the bulk-load window
+ * (before FTS/secondary indexes are rebuilt), so imported nodes/edges are
+ * captured by those rebuilds and available to the resolution pass.
+ *
+ * No-op (returns null) when no `baseGraph.path` is configured. Warnings (never
+ * fatal) when the upstream graph is missing or its schema version differs.
+ */
+function mergeBaseGraphSnapshot(local, projectRoot) {
+    const configured = (0, project_config_1.loadBaseGraphPath)(projectRoot);
+    if (!configured)
+        return null;
+    const baseProject = path.isAbsolute(configured)
+        ? path.resolve(configured)
+        : path.resolve(projectRoot, configured);
+    const baseDbPath = (0, db_2.getDatabasePath)(baseProject);
+    if (!fs.existsSync(baseDbPath)) {
+        (0, errors_1.logWarn)(`baseGraph: 未发现上游图谱 ${baseDbPath}（检查 codegraph.json 的 baseGraph.path）。跳过跨图合并。`);
+        return null;
+    }
+    const base = db_1.DatabaseConnection.open(baseDbPath);
+    try {
+        const baseVersion = base.getSchemaVersion()?.version ?? 0;
+        if (baseVersion !== migrations_1.CURRENT_SCHEMA_VERSION) {
+            (0, errors_1.logWarn)(`baseGraph: 上游图谱 schema 版本 ${baseVersion} 与本工具 ${migrations_1.CURRENT_SCHEMA_VERSION} 不一致，跳过跨图合并（请先对上游执行 cg index 升级图谱）。`);
+            return null;
+        }
+        const importedNodes = importNodes(local, base);
+        const importedEdges = importEdges(local, base);
+        // Record the merge so `cg status` / stats can surface it.
+        const now = String(Date.now());
+        writeMetadata(local, exports.BASE_GRAPH_METADATA_KEYS.path, baseDbPath);
+        writeMetadata(local, exports.BASE_GRAPH_METADATA_KEYS.project, path.basename(baseProject));
+        writeMetadata(local, exports.BASE_GRAPH_METADATA_KEYS.importedAt, now);
+        writeMetadata(local, exports.BASE_GRAPH_METADATA_KEYS.nodes, String(importedNodes));
+        writeMetadata(local, exports.BASE_GRAPH_METADATA_KEYS.edges, String(importedEdges));
+        return {
+            baseProject,
+            importedNodes,
+            importedEdges,
+            baseProjectName: path.basename(baseProject),
+        };
+    }
+    finally {
+        base.close();
+    }
+}
+/** Copy every upstream node into the local graph with origin='base'. */
+function importNodes(local, base) {
+    const nodeCols = [
+        'id', 'kind', 'name', 'qualified_name', 'file_path', 'language',
+        'start_line', 'end_line', 'start_column', 'end_column',
+        'docstring', 'signature', 'visibility',
+        'is_exported', 'is_async', 'is_static', 'is_abstract',
+        'decorators', 'type_parameters', 'return_type', 'updated_at',
+    ];
+    const colList = nodeCols.join(', ');
+    const placeholders = nodeCols.map(() => '?').join(', ');
+    const read = base.getDb().prepare(`SELECT ${colList} FROM nodes`);
+    const write = local.getDb().prepare(`INSERT OR IGNORE INTO nodes (${colList}, origin) VALUES (${placeholders}, 'base')`);
+    let imported = 0;
+    const rows = read.all();
+    const localInsert = local.getDb().transaction((rows) => {
+        for (const row of rows) {
+            imported += write.run(...nodeCols.map((c) => row[c])).changes;
+        }
+    });
+    localInsert(rows);
+    return imported;
+}
+/** Copy every upstream edge into the local graph with origin='base'. */
+function importEdges(local, base) {
+    const edgeCols = ['source', 'target', 'kind', 'metadata', 'line', 'col', 'provenance'];
+    const colList = edgeCols.join(', ');
+    const placeholders = edgeCols.map(() => '?').join(', ');
+    const read = base.getDb().prepare(`SELECT ${colList} FROM edges`);
+    const write = local.getDb().prepare(`INSERT OR IGNORE INTO edges (${colList}, origin) VALUES (${placeholders}, 'base')`);
+    let imported = 0;
+    const rows = read.all();
+    const localInsert = local.getDb().transaction((rows) => {
+        for (const row of rows) {
+            imported += write.run(...edgeCols.map((c) => row[c])).changes;
+        }
+    });
+    localInsert(rows);
+    return imported;
+}
+/** Upsert a single project_metadata row on the local graph. */
+function writeMetadata(local, key, value) {
+    local
+        .getDb()
+        .prepare(`INSERT INTO project_metadata (key, value, updated_at) VALUES (?, ?, ?)
+       ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`)
+        .run(key, value, Date.now());
+}
+//# sourceMappingURL=index.js.map

package/dist/base-graph/index.js.map

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

package/dist/bin/codegraph.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * CodeGraph CLI
+ *
+ * Command-line interface for CodeGraph code intelligence.
+ *
+ * Usage:
+ *   cg                         Run interactive installer (when no args)
+ *   cg install            Run interactive installer
+ *   cg uninstall          Remove CodeGraph from your agents
+ *   cg init [path]        Initialize CodeGraph in a project (creates .codegraph/, no indexing)
+ *   cg build [path]       Build the complete index
+ *   cg index [path]       Rebuild the full index from scratch
+ *   cg uninit [path]      Remove CodeGraph from a project
+ *   cg sync [path]        Sync changes since last index
+ *   cg status [path]      Show index status
+ *   cg query <search>     Search for symbols
+ *   cg files [options]    Show project file structure
+ *   cg context <task>     Build context for a task
+ *   cg callers <symbol>   Find what calls a function/method
+ *   cg callees <symbol>   Find what a function/method calls
+ *   cg impact <symbol>    Analyze what code is affected by changing a symbol
+ *   cg affected [files]   Find test files affected by changes
+ *   cg ui [path]          Open the browser viewer for an indexed project (alias: web)
+ *   cg upgrade [version]  Update CodeGraph to the latest release
+ */
+import '../mcp/early-ppid';
+//# sourceMappingURL=codegraph.d.ts.map

package/dist/bin/codegraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegraph.d.ts","sourceRoot":"","sources":["../../src/bin/codegraph.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,mBAAmB,CAAC"}