PyPI - codegraph-gen - Versions diffs - 0.2.0__tar.gz → 1.0.0__tar.gz - Mend

codegraph-gen 0.2.0tar.gz → 1.0.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

{codegraph_gen-0.2.0 → codegraph_gen-1.0.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: codegraph-gen
-Version: 0.2.0
+Version: 1.0.0
 Summary: AST-based codebase knowledge graph generator in Markdown
 Keywords: knowledge-graph,ast,codebase,markdown,tree-sitter,visualization,static-analysis,ai-agent,obsidian
 Author: twn39
@@ -10,6 +10,7 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -27,23 +28,30 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: tree-sitter-c>=0.24.2
 Requires-Dist: tree-sitter-cpp>=0.23.4
 Requires-Dist: tree-sitter-kotlin>=1.1.0
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Project-URL: Homepage, https://github.com/twn39/codegraph
 Project-URL: Repository, https://github.com/twn39/codegraph
 Project-URL: Issues, https://github.com/twn39/codegraph/issues
 Description-Content-Type: text/markdown
-# codegraph
+<h1 align="center">codegraph-gen</h1>
-`codegraph` 是一个面向 AI Agent（如 Antigravity、Codex、Claude Code 等）的静态代码知识图谱生成工具。它能够静态解析多语言 codebase，通过社区发现算法自动进行组件聚类，并导出为由标准 Markdown 文件组成的关联图谱库（Obsidian-like vault），极大地辅助 AI Agent 在本地进行精准的架构理解、逻辑导航与深度洞察分析。
+<p align="center">
+  <a href="https://pypi.org/project/codegraph-gen/"><img src="https://img.shields.io/pypi/v/codegraph-gen.svg" alt="PyPI Version"></a>
+  <img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/code%20style-ruff-26b22f.svg" alt="Ruff">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+</p>
-与基于图形化 Canvas 渲染的知识图谱不同，`codegraph` 采用全 Markdown 的扁平结构存储。它专门为 LLM 设计，摒弃了昂贵且复杂的数据库依赖，让 AI Agent 可以通过标准文件读取与路径导航（Relative Links）轻松周游整个代码库。
+`codegraph-gen` 是一个面向 AI Agent（如 Antigravity、Codex、Claude Code 等）的静态代码知识图谱生成工具。它能够静态解析多语言 codebase，通过社区发现算法自动进行组件聚类，并导出为由标准 Markdown 文件组成的关联图谱库（Obsidian-like vault），极大地辅助 AI Agent 在本地进行精准的架构理解、逻辑导航与深度洞察分析。
+与基于图形化 Canvas 渲染的知识图谱不同，`codegraph-gen` 采用全 Markdown 的扁平结构存储。它专门为 LLM 设计，摒弃了昂贵且复杂的数据库依赖，让 AI Agent 可以通过标准文件读取与路径导航（Relative Links）轻松周游整个代码库。
 ---
 ## 🚀 核心特性
-- **多语言 AST 解析**：基于 `tree-sitter`，原生支持 **Python, JavaScript, TypeScript, Go, Rust, Swift**。
+- **多语言 AST 解析**：基于 `tree-sitter`，原生支持 **Python, JavaScript, TypeScript, Kotlin, Go, Rust, Swift**。
 - **语义边解析与绑定**：静态解析跨文件的函数/方法调用（`calls`）、类型继承/接口实现（`inherits`/`implements`）以及文件导入关系（`imports`）。
 - **逻辑组件自动聚类**：利用贪心模块度社区发现算法（Louvain Modularity Clustering）将紧密耦合的文件和符号自动聚类为 **Component（逻辑组件）**，并根据组件核心节点智能命名。
 - **架构脆弱性分析**：自动识别 **God Nodes（度数最高的核心抽象）**，并静态检测文件级别的 **循环导入依赖（Circular Imports）**。
@@ -53,39 +61,29 @@ Description-Content-Type: text/markdown
 ## 📦 架构概览
-```mermaid
-graph TD
-    A[工作区源码 Workspace] --> B[detect: 语言识别与过滤]
-    B --> C[parser: Tree-Sitter AST 符号提取]
-    C --> D[builder: NetworkX 语义图组装与绑定]
-    D --> E[cluster: 社区模块度聚类命名]
-    E --> F[analyze: 上帝节点与循环导入分析]
-    F --> G[export: 导出至 .codegraph/]
-    G --> H[AGENT_PROMPT.md / AGENTS.md / README.md / nodes / components]
-```
+- **工作区源码 Workspace** -> **detect: 语言识别与过滤** -> **parser: Tree-Sitter AST 符号提取** -> **builder: NetworkX 语义图组装与绑定** -> **cluster: 社区模块度聚类命名** -> **analyze: 上帝节点与循环导入分析** -> **export: 导出至 .codegraph/** -> **生成 AGENT_PROMPT.md / AGENTS.md / README.md / nodes / components**
 ---
 ## 🛠️ 安装指南
-推荐使用 [uv](https://github.com/astral-sh/uv) 管理项目依赖与虚拟环境：
+推荐使用 [uv](https://github.com/astral-sh/uv) 直接安装工具：
 ```bash
-# 克隆仓库
-git clone <repository-url>
-cd codegraph
+# 全局安装 (推荐)
+uv tool install codegraph-gen
+```
-# 同步依赖并激活虚拟环境
-uv sync
-source .venv/bin/activate
+如果需要在当前虚拟环境中作为库依赖安装：
-# 全局安装 (推荐)
-uv tool install --force --no-cache .
+```bash
+# 安装至当前项目/环境
+uv pip install codegraph-gen
 ```
-### 2. 注入 AI Agent 斜杠命令集成
+### 注册 AI Agent 斜杠命令
-`codegraph` 支持一键将 `/codegraph` 自定义斜杠命令注册到您的 AI Agent（如 Codex 或 Antigravity）的全局配置中：
+`codegraph-gen` 支持一键将 `/codegraph` 自定义斜杠命令注册到您的 AI Agent（如 Codex 或 Antigravity）的全局配置中：
 ```bash
 # 为 Codex / Antigravity 注入 /codegraph 全局斜杠命令
@@ -130,7 +128,7 @@ codegraph build . --exclude extra_folder/ --exclude docs/
 ## 🤖 与 AI Agent（Codex / Antigravity / Claude Code）协同分析
-`codegraph` 的核心设计思想是**离线构建，Agent 分析**。这避免了在 CLI 中直接硬编码大模型 API，降低了使用成本，并充分利用了你当前对话中功能更强、带有上下文读取能力的外部 Agent。
+`codegraph-gen` 的核心设计思想是**离线构建，Agent 分析**。这避免了在 CLI 中直接硬编码大模型 API，降低了使用成本，并充分利用了你当前对话中功能更强、带有上下文读取能力的外部 Agent。
 ### 步骤 1：生成本地图谱

{codegraph_gen-0.2.0 → codegraph_gen-1.0.0}/README.md RENAMED Viewed

@@ -1,14 +1,21 @@
-# codegraph
+<h1 align="center">codegraph-gen</h1>
-`codegraph` 是一个面向 AI Agent（如 Antigravity、Codex、Claude Code 等）的静态代码知识图谱生成工具。它能够静态解析多语言 codebase，通过社区发现算法自动进行组件聚类，并导出为由标准 Markdown 文件组成的关联图谱库（Obsidian-like vault），极大地辅助 AI Agent 在本地进行精准的架构理解、逻辑导航与深度洞察分析。
+<p align="center">
+  <a href="https://pypi.org/project/codegraph-gen/"><img src="https://img.shields.io/pypi/v/codegraph-gen.svg" alt="PyPI Version"></a>
+  <img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python Version">
+  <img src="https://img.shields.io/badge/code%20style-ruff-26b22f.svg" alt="Ruff">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+</p>
-与基于图形化 Canvas 渲染的知识图谱不同，`codegraph` 采用全 Markdown 的扁平结构存储。它专门为 LLM 设计，摒弃了昂贵且复杂的数据库依赖，让 AI Agent 可以通过标准文件读取与路径导航（Relative Links）轻松周游整个代码库。
+`codegraph-gen` 是一个面向 AI Agent（如 Antigravity、Codex、Claude Code 等）的静态代码知识图谱生成工具。它能够静态解析多语言 codebase，通过社区发现算法自动进行组件聚类，并导出为由标准 Markdown 文件组成的关联图谱库（Obsidian-like vault），极大地辅助 AI Agent 在本地进行精准的架构理解、逻辑导航与深度洞察分析。
+与基于图形化 Canvas 渲染的知识图谱不同，`codegraph-gen` 采用全 Markdown 的扁平结构存储。它专门为 LLM 设计，摒弃了昂贵且复杂的数据库依赖，让 AI Agent 可以通过标准文件读取与路径导航（Relative Links）轻松周游整个代码库。
 ---
 ## 🚀 核心特性
-- **多语言 AST 解析**：基于 `tree-sitter`，原生支持 **Python, JavaScript, TypeScript, Go, Rust, Swift**。
+- **多语言 AST 解析**：基于 `tree-sitter`，原生支持 **Python, JavaScript, TypeScript, Kotlin, Go, Rust, Swift**。
 - **语义边解析与绑定**：静态解析跨文件的函数/方法调用（`calls`）、类型继承/接口实现（`inherits`/`implements`）以及文件导入关系（`imports`）。
 - **逻辑组件自动聚类**：利用贪心模块度社区发现算法（Louvain Modularity Clustering）将紧密耦合的文件和符号自动聚类为 **Component（逻辑组件）**，并根据组件核心节点智能命名。
 - **架构脆弱性分析**：自动识别 **God Nodes（度数最高的核心抽象）**，并静态检测文件级别的 **循环导入依赖（Circular Imports）**。
@@ -18,39 +25,29 @@
 ## 📦 架构概览
-```mermaid
-graph TD
-    A[工作区源码 Workspace] --> B[detect: 语言识别与过滤]
-    B --> C[parser: Tree-Sitter AST 符号提取]
-    C --> D[builder: NetworkX 语义图组装与绑定]
-    D --> E[cluster: 社区模块度聚类命名]
-    E --> F[analyze: 上帝节点与循环导入分析]
-    F --> G[export: 导出至 .codegraph/]
-    G --> H[AGENT_PROMPT.md / AGENTS.md / README.md / nodes / components]
-```
+- **工作区源码 Workspace** -> **detect: 语言识别与过滤** -> **parser: Tree-Sitter AST 符号提取** -> **builder: NetworkX 语义图组装与绑定** -> **cluster: 社区模块度聚类命名** -> **analyze: 上帝节点与循环导入分析** -> **export: 导出至 .codegraph/** -> **生成 AGENT_PROMPT.md / AGENTS.md / README.md / nodes / components**
 ---
 ## 🛠️ 安装指南
-推荐使用 [uv](https://github.com/astral-sh/uv) 管理项目依赖与虚拟环境：
+推荐使用 [uv](https://github.com/astral-sh/uv) 直接安装工具：
 ```bash
-# 克隆仓库
-git clone <repository-url>
-cd codegraph
+# 全局安装 (推荐)
+uv tool install codegraph-gen
+```
-# 同步依赖并激活虚拟环境
-uv sync
-source .venv/bin/activate
+如果需要在当前虚拟环境中作为库依赖安装：
-# 全局安装 (推荐)
-uv tool install --force --no-cache .
+```bash
+# 安装至当前项目/环境
+uv pip install codegraph-gen
 ```
-### 2. 注入 AI Agent 斜杠命令集成
+### 注册 AI Agent 斜杠命令
-`codegraph` 支持一键将 `/codegraph` 自定义斜杠命令注册到您的 AI Agent（如 Codex 或 Antigravity）的全局配置中：
+`codegraph-gen` 支持一键将 `/codegraph` 自定义斜杠命令注册到您的 AI Agent（如 Codex 或 Antigravity）的全局配置中：
 ```bash
 # 为 Codex / Antigravity 注入 /codegraph 全局斜杠命令
@@ -95,7 +92,7 @@ codegraph build . --exclude extra_folder/ --exclude docs/
 ## 🤖 与 AI Agent（Codex / Antigravity / Claude Code）协同分析
-`codegraph` 的核心设计思想是**离线构建，Agent 分析**。这避免了在 CLI 中直接硬编码大模型 API，降低了使用成本，并充分利用了你当前对话中功能更强、带有上下文读取能力的外部 Agent。
+`codegraph-gen` 的核心设计思想是**离线构建，Agent 分析**。这避免了在 CLI 中直接硬编码大模型 API，降低了使用成本，并充分利用了你当前对话中功能更强、带有上下文读取能力的外部 Agent。
 ### 步骤 1：生成本地图谱

{codegraph_gen-0.2.0 → codegraph_gen-1.0.0}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "codegraph-gen"
-version = "0.2.0"
+version = "1.0.0"
 description = "AST-based codebase knowledge graph generator in Markdown"
 readme = "README.md"
 authors = [
@@ -23,11 +23,12 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Topic :: Software Development :: Code Generators",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.11"
 dependencies = [
     "networkx>=3.0",
     "tree-sitter>=0.23.0",
@@ -59,7 +60,6 @@ Issues = "https://github.com/twn39/codegraph/issues"
 [project.scripts]
 codegraph = "codegraph_gen.__main__:main"
-codegraph-gen = "codegraph_gen.__main__:main"
 [build-system]
 requires = ["uv_build>=0.9.26,<0.10.0"]

{codegraph_gen-0.2.0 → codegraph_gen-1.0.0}/src/codegraph_gen/__main__.py RENAMED Viewed

@@ -294,12 +294,12 @@ def info():
     try:
         from importlib.metadata import version
-        ver = version("codegraph")
+        ver = version("codegraph-gen")
     except Exception:
-        ver = "0.2.0"
+        ver = "1.0.0"
     console.print(f"[bold]codegraph v{ver}[/bold]")
     console.print(
-        "Supported languages: Python, JavaScript, TypeScript, Go, Rust, Swift"
+        "Supported languages: Python, JavaScript, TypeScript, Kotlin, Go, Rust, Swift"
     )

{codegraph_gen-0.2.0 → codegraph_gen-1.0.0}/src/codegraph_gen/writer.py RENAMED Viewed

@@ -57,7 +57,7 @@ class VaultWriter:
         project_root = output_dir.parent
         agents_file = project_root / "AGENTS.md"
-        agents_rule_body = """## codegraph
+        agents_rule_body = """## codegraph-gen
 This project maintains a codebase knowledge graph at `.codegraph/`.
@@ -81,11 +81,11 @@ You MUST follow these rules when working in this codebase:
         if agents_file.exists():
             try:
                 content = agents_file.read_text(encoding="utf-8")
-                if "## codegraph" not in content:
+                if "## codegraph-gen" not in content:
                     new_content = content.rstrip() + "\n\n" + agents_rule_body
                     self.write_file(agents_file, new_content)
                     logger.info(
-                        "Appended codegraph rules to existing AGENTS.md at root"
+                        "Appended codegraph-gen rules to existing AGENTS.md at root"
                     )
             except Exception as e:
                 logger.warning(f"Could not read or append to existing AGENTS.md: {e}")