memnexus 0.2.0__tar.gz

memnexus-0.2.0/.gitattributes

@@ -0,0 +1,39 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Python files
+*.py text eol=lf
+*.pyx text eol=lf
+*.pyd binary
+
+# Web files
+*.js text eol=lf
+*.ts text eol=lf
+*.tsx text eol=lf
+*.json text eol=lf
+*.css text eol=lf
+*.html text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+
+# Documentation
+*.md text eol=lf
+*.txt text eol=lf
+
+# Scripts
+*.sh text eol=lf
+*.bat text eol=crlf
+
+# Binary files
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.svg text
+*.pdf binary
+*.zip binary
+*.gz binary
+*.tar binary
+*.db binary

memnexus-0.2.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Run command '...'
+2. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Logs**
+If applicable, add logs to help explain your problem.
+```
+Paste logs here
+```
+
+**Environment (please complete the following information):**
+ - OS: [e.g. macOS, Linux]
+ - Python Version: [e.g. 3.12]
+ - MemNexus Version: [e.g. 0.1.0]
+ - Installation Method: [e.g. pip, source]
+
+**Additional context**
+Add any other context about the problem here.

memnexus-0.2.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

memnexus-0.2.0/.github/pull_request_template.md

@@ -0,0 +1,31 @@
+## Description
+<!-- Please include a summary of the changes -->
+
+Fixes # (issue)
+
+## Type of Change
+<!-- Please check the relevant option(s) -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+
+## Testing
+<!-- Please describe the tests you ran -->
+
+## Screenshots (if applicable)
+
+## Additional Notes

memnexus-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test-python:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.12', '3.13']
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
+      with:
+        version: "latest"
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        uv sync --all-extras --dev
+    
+    - name: Lint with ruff
+      run: |
+        uv run ruff check .
+        uv run ruff format --check .
+    
+    - name: Type check with mypy
+      run: |
+        uv run mypy src/memnexus
+    
+    - name: Test with pytest
+      run: |
+        uv run pytest --cov=memnexus --cov-report=xml
+    
+    - name: Upload coverage
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false
+
+  test-frontend:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '18'
+        cache: 'npm'
+        cache-dependency-path: frontend/package-lock.json
+    
+    - name: Install dependencies
+      run: |
+        cd frontend
+        npm ci
+    
+    - name: Build frontend
+      run: |
+        cd frontend
+        npm run build
+    
+    - name: Lint frontend
+      run: |
+        cd frontend
+        npm run lint || true
+
+  check-docs:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Check documentation
+      run: |
+        # Check if README.md exists
+        test -f README.md
+        # Check if CHANGELOG.md exists
+        test -f CHANGELOG.md
+        # Check if LICENSE exists
+        test -f LICENSE

memnexus-0.2.0/.gitignore

@@ -0,0 +1,89 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# MyPy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# Data
+.memnexus/
+data/
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+*.log
+logs/
+
+# LanceDB
+*.lance
+
+# Frontend
+frontend/node_modules/
+frontend/dist/
+frontend/.cache/
+
+# Misc
+*.bak
+*.tmp
+*.temp
+
+# Research (local only, not tracked)
+research/
+!research/README.md  # Keep only the index
+!research/**/README.md  # Keep sub-indexes
+
+# Sisyphus planning files (development only)
+.sisyphus/

memnexus-0.2.0/.python-version

@@ -0,0 +1 @@
+3.12

memnexus-0.2.0/AGENTS.md

@@ -0,0 +1,216 @@
+# MemNexus - AI Agent 开发指南
+
+> **目标读者**: AI 编程助手（如 Claude Code、Kimi CLI 等）
+>
+> **项目状态**: v0.2.0 - Code Memory for AI Programming Tools
+
+---
+
+## 项目概述
+
+MemNexus 是一个**代码记忆基础设施**（Code Memory Infrastructure），为 AI 编程工具提供持久的项目记忆能力。
+
+### 核心定位
+
+**不是**：多 Agent 协作编排系统、通用记忆层、项目管理工具
+
+**而是**：专为 AI 编程场景设计的代码记忆基础设施
+
+- **Code-Aware**: 理解代码结构（AST），不只是文本
+- **Git-Native**: 与 Git 历史深度集成
+- **Tool-Agnostic**: 服务所有 AI 编程工具
+
+### 核心功能
+
+1. **Git 历史索引** - 索引 commit 历史，支持语义搜索
+2. **代码解析** - 解析 Python 代码结构（函数、类、方法）
+3. **向量记忆** - LanceDB 存储，支持语义检索
+4. **Kimi CLI 插件** - 原生集成 Kimi CLI 1.25.0+
+
+---
+
+## 技术栈
+
+| 层级 | 技术 | 用途 |
+|------|------|------|
+| 存储 | LanceDB | 向量数据库 |
+| Embedding | sentence-transformers | 文本向量化 |
+| 代码解析 | Python AST | Python 代码分析 |
+| Git 操作 | GitPython | Git 历史提取 |
+| Web | FastAPI | HTTP API |
+| CLI | Typer + Rich | 命令行界面 |
+
+---
+
+## 项目结构
+
+```
+MemNexus/
+├── src/memnexus/              # Python 源代码
+│   ├── __init__.py            # 导出 CodeMemory, SearchResult
+│   ├── code_memory.py         # 核心 CodeMemory 类
+│   ├── cli.py                 # CLI 入口
+│   ├── server.py              # FastAPI 服务器
+│   └── memory/                # 记忆系统
+│       ├── store.py           # LanceDB 向量存储
+│       ├── git.py             # Git 集成
+│       └── code.py            # 代码解析
+├── docs/                      # 文档
+│   ├── VISION.md              # 产品定位
+│   ├── ROADMAP.md             # 路线图
+│   ├── API.md                 # API 文档
+│   └── CLI.md                 # CLI 文档
+├── tests/                     # 测试
+├── README.md                  # 项目说明
+├── INSTALL.md                 # 安装指南
+└── CHANGELOG.md               # 更新日志
+```
+
+---
+
+## 快速开始
+
+### 安装
+
+```bash
+pip install memnexus
+```
+
+### 使用
+
+```python
+import asyncio
+from memnexus import CodeMemory
+
+async def main():
+    # 初始化
+    memory = await CodeMemory.init("./my-project")
+    
+    # 索引
+    await memory.index_git_history()
+    await memory.index_codebase()
+    
+    # 搜索
+    results = await memory.search("authentication")
+    for r in results:
+        print(f"{r.source}: {r.content[:100]}")
+
+asyncio.run(main())
+```
+
+### CLI
+
+```bash
+memnexus init              # 初始化项目
+memnexus index --git       # 索引 Git 历史
+memnexus index --code      # 索引代码
+memnexus search "query"    # 搜索记忆
+memnexus server            # 启动 API 服务
+```
+
+---
+
+## 核心 API
+
+### CodeMemory
+
+```python
+class CodeMemory:
+    # 初始化
+    @classmethod
+    async def init(cls, project_path: str) -> "CodeMemory"
+    
+    # Git 相关
+    async def index_git_history(self, limit: int = 1000) -> Dict
+    async def query_git_history(self, query: str, limit: int = 5) -> List[GitSearchResult]
+    async def get_file_history(self, file_path: str, limit: int = 20) -> List[GitSearchResult]
+    
+    # 代码相关
+    async def index_codebase(self, languages: List[str] = None) -> Dict
+    async def search_code(self, query: str, symbol_type: str = None) -> List[SearchResult]
+    async def find_symbol(self, name: str) -> Optional[SearchResult]
+    
+    # 通用
+    async def add(self, content: str, source: str, metadata: dict = None) -> str
+    async def search(self, query: str, limit: int = 5) -> List[SearchResult]
+```
+
+---
+
+## HTTP API 端点
+
+| 方法 | 端点 | 描述 |
+|------|------|------|
+| GET | `/health` | 健康检查 |
+| GET | `/stats` | 项目统计 |
+| GET | `/api/v1/search` | 搜索记忆 |
+| POST | `/api/v1/memory` | 添加记忆 |
+| POST | `/api/v1/git/index` | 索引 Git |
+| GET | `/api/v1/git/search` | 搜索 Git |
+| POST | `/api/v1/code/index` | 索引代码 |
+| GET | `/api/v1/code/search` | 搜索代码 |
+| GET | `/api/v1/code/symbol/{name}` | 查找符号 |
+
+---
+
+## 开发指南
+
+### 构建
+
+```bash
+# 安装依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest
+
+# 代码检查
+ruff format .
+ruff check . --fix
+mypy src/memnexus
+```
+
+### 发布
+
+```bash
+# 构建
+python -m build
+
+# 检查
+twine check dist/*
+
+# 上传
+twine upload dist/*
+```
+
+---
+
+## 冻结功能（Experimental）
+
+以下功能已标记为 experimental，当前版本不维护但保留代码：
+
+- `advanced_rag.py` - 复杂 RAG 系统
+- `layers/` - 分层记忆架构
+- `retrieval/adaptive.py` - 自适应检索
+- `rmt/` - 循环记忆传递
+- `knowledge_graph/` - 知识图谱
+
+这些功能在 `memory/` 目录中带有 README 说明。
+
+---
+
+## 参考文档
+
+| 文档 | 路径 | 说明 |
+|------|------|------|
+| 愿景 | `docs/VISION.md` | 产品定位 |
+| 路线图 | `docs/ROADMAP.md` | 开发计划 |
+| API | `docs/API.md` | API 参考 |
+| CLI | `docs/CLI.md` | CLI 参考 |
+| 安装 | `INSTALL.md` | 安装指南 |
+| 贡献 | `CONTRIBUTING.md` | 贡献指南 |
+
+---
+
+**版本**: 0.2.0  
+**最后更新**: 2026-03-25

memnexus-0.2.0/CHANGELOG.md

@@ -0,0 +1,107 @@
+# Changelog
+
+All notable changes to MemNexus will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.0] - 2026-03-25
+
+### 🎉 First Public Release - Code Memory for AI Programming Tools
+
+This is the first public release of MemNexus as a **Code Memory** tool for AI programming assistants.
+
+### ✨ New Features
+
+#### Core Memory System
+- **CodeMemory** - Main entry point for library usage
+- **Vector Storage** - LanceDB-based semantic search
+- **MemoryStore** - Add, search, and manage memory entries
+
+#### Git Integration
+- **GitMemoryExtractor** - Extract commit history from Git repositories
+- **Commit Indexing** - Index commit messages, authors, and file changes
+- **Semantic Search** - Search Git history with natural language
+- **File History** - Get complete history for specific files
+
+#### Code Parsing
+- **CodeParser** - Parse Python code using AST
+- **Symbol Extraction** - Extract functions, classes, and methods
+- **Import Analysis** - Extract and analyze import statements
+- **CodeChunker** - Create embeddable code chunks with context
+- **Signature Extraction** - Capture function signatures with type annotations
+
+#### CLI Interface
+- **memnexus init** - Initialize project for memory tracking
+- **memnexus index** - Index Git history and/or code
+- **memnexus search** - Search project memory
+- **memnexus status** - Check project indexing status
+- **memnexus server** - Start HTTP API server
+
+#### HTTP API
+- `GET /health` - Health check
+- `GET /stats` - Project statistics
+- `GET /api/v1/search` - Search all memories
+- `POST /api/v1/memory` - Add memory entry
+- `POST /api/v1/git/index` - Index Git history
+- `GET /api/v1/git/search` - Search Git history
+- `POST /api/v1/code/index` - Index codebase
+- `GET /api/v1/code/search` - Search code symbols
+- `GET /api/v1/code/symbol/{name}` - Find specific symbol
+
+#### Kimi CLI Plugin
+- **Plugin Support** - Native integration with Kimi CLI 1.25.0+
+- **6 Tools** - memory_search, memory_store, memory_status, memory_index, find_symbol, get_file_history
+- **Slash Commands** - `/memory search`, `/memory store`, `/memory status`, etc.
+
+### 🐛 Known Issues
+
+- Code parsing currently only supports Python
+- TypeScript/JavaScript support coming in next release
+- Large repositories may require tuning batch sizes
+
+### 📁 New Files
+
+```
+src/memnexus/
+├── __init__.py              # Main exports
+├── code_memory.py           # Core CodeMemory class
+├── cli.py                   # CLI interface
+├── server.py                # FastAPI server
+├── memory/
+│   ├── git.py              # Git integration
+│   ├── code.py             # Code parsing
+│   └── store.py            # Vector storage
+└── scripts/
+    └── kimi_plugin.py      # Kimi CLI plugin
+
+~/.kimi/plugins/memnexus/
+├── plugin.json             # Plugin manifest
+└── SKILL.md                # Plugin documentation
+```
+
+### 📊 Statistics
+
+- Total Lines of Code: ~5,000
+- Python Files: 15
+- Test Coverage: Core functionality tested
+- Documentation: Complete user guides
+
+## [0.1.0] - 2026-02-20 (Internal)
+
+### Initial Prototype
+
+> **Note:** This was an internal prototype with a different focus (Multi-Agent Orchestration). 
+> The project was significantly refactored for the 0.2.0 release.
+
+Original features:
+- Multi-Agent Collaboration Orchestration
+- ACP Protocol implementation
+- LlamaIndex RAG Pipeline
+- React Frontend
+- Task Scheduler and Intervention System
+
+[0.2.0]: https://github.com/Leeelics/MemNexus/releases/tag/v0.2.0
+[0.1.0]: https://github.com/Leeelics/MemNexus/releases/tag/v0.1.0