magatama-core 0.5.0__tar.gz

magatama_core-0.5.0/.gitignore

@@ -0,0 +1,120 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.db
+*.sqlite
+*.sqlite3
+.yata/
+storage/archive/*
+storage/changes/*
+!storage/archive/.gitkeep
+!storage/changes/.gitkeep
+
+# Framework knowledge repositories (cloned for analysis)
+frameworks/*
+!frameworks/.gitkeep
+
+# UV
+.uv/
+uv.lock
+
+# comP
+.comp/
+plan.md

magatama_core-0.5.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: magatama-core
+Version: 0.5.0
+Summary: MAGATAMA Core - Knowledge Graph Engine for Code Analysis
+Project-URL: Homepage, https://github.com/tsucky230/MAGATAMA
+Project-URL: Repository, https://github.com/tsucky230/MAGATAMA
+Project-URL: Documentation, https://github.com/tsucky230/MAGATAMA#readme
+Project-URL: Issues, https://github.com/tsucky230/MAGATAMA/issues
+Author: MAGATAMA Team
+License: MIT
+Keywords: ast-parser,code-analysis,knowledge-graph,tree-sitter
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.11
+Requires-Dist: networkx>=3.2.0
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: structlog>=24.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: tree-sitter-c-sharp>=0.23.0
+Requires-Dist: tree-sitter-c>=0.24.0
+Requires-Dist: tree-sitter-cpp>=0.23.0
+Requires-Dist: tree-sitter-elixir>=0.3.0
+Requires-Dist: tree-sitter-go>=0.25.0
+Requires-Dist: tree-sitter-groovy>=0.1.0
+Requires-Dist: tree-sitter-haskell>=0.23.0
+Requires-Dist: tree-sitter-java>=0.23.0
+Requires-Dist: tree-sitter-javascript>=0.24.0
+Requires-Dist: tree-sitter-julia>=0.23.0
+Requires-Dist: tree-sitter-kotlin>=1.1.0
+Requires-Dist: tree-sitter-lua>=0.2.0
+Requires-Dist: tree-sitter-objc>=3.0.0
+Requires-Dist: tree-sitter-php>=0.24.0
+Requires-Dist: tree-sitter-python>=0.24.0
+Requires-Dist: tree-sitter-ruby>=0.23.0
+Requires-Dist: tree-sitter-rust>=0.24.0
+Requires-Dist: tree-sitter-scala>=0.24.0
+Requires-Dist: tree-sitter-sql>=0.3.0
+Requires-Dist: tree-sitter-swift>=0.0.1
+Requires-Dist: tree-sitter-typescript>=0.23.0
+Requires-Dist: tree-sitter-yaml>=0.7.0
+Requires-Dist: tree-sitter-zig>=1.0.0
+Requires-Dist: tree-sitter>=0.24.0
+Provides-Extra: all-languages
+Requires-Dist: tree-sitter-c-sharp>=0.23.0; extra == 'all-languages'
+Requires-Dist: tree-sitter-java>=0.23.0; extra == 'all-languages'
+Requires-Dist: tree-sitter-ruby>=0.23.0; extra == 'all-languages'
+Provides-Extra: csharp
+Requires-Dist: tree-sitter-c-sharp>=0.23.0; extra == 'csharp'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.9.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: java
+Requires-Dist: tree-sitter-java>=0.23.0; extra == 'java'
+Provides-Extra: ruby
+Requires-Dist: tree-sitter-ruby>=0.23.0; extra == 'ruby'
+Description-Content-Type: text/markdown
+
+# magatama-core - Knowledge Graph Engine
+
+[![PyPI version](https://badge.fury.io/py/magatama-core.svg)](https://badge.fury.io/py/magatama-core)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> [MAGATAMA](https://github.com/tsucky230/MAGATAMA)（[YATA](https://github.com/nahisaho/YATA) のフォーク）の
+> コアライブラリパッケージです（パッケージ名 `magatama-core` / import 名 `magatama_core`）。
+
+独立したライブラリとして、コード解析と知識グラフ構築機能を提供します。
+
+## 特徴
+
+- 🔍 **マルチ言語解析**: Python, TypeScript, JavaScript, Rust, Go
+- 🕸️ **知識グラフ**: NetworkX によるエンティティ・関係性グラフ
+- 🔗 **関係性検出**: CALLS, IMPORTS, CONTAINS, INHERITS
+- 💾 **永続化**: JSON / SQLite ストレージ
+
+## インストール
+
+```bash
+pip install magatama-core
+```
+
+### オプション言語サポート
+
+```bash
+# Rust サポート
+pip install magatama-core[rust]
+
+# Go サポート
+pip install magatama-core[go]
+
+# 全言語サポート
+pip install magatama-core[all-languages]
+```
+
+## 使用方法
+
+### 基本的な使い方
+
+```python
+from magatama_core.infrastructure.parsers import PythonParser
+from magatama_core.infrastructure.storage import NetworkXKnowledgeGraph
+from magatama_core.application.usecases import ParseFileUseCase
+
+# パーサーとグラフを作成
+parser = PythonParser()
+graph = NetworkXKnowledgeGraph()
+
+# ユースケースを設定
+parse_file = ParseFileUseCase(
+    parsers={".py": parser},
+    knowledge_graph=graph,
+)
+
+# ファイルを解析
+from pathlib import Path
+result = parse_file.execute(Path("your_file.py"))
+
+print(f"Entities: {result.entity_count}")
+print(f"Relationships: {result.relationship_count}")
+```
+
+### エンティティの検索
+
+```python
+from magatama_core.domain.entities import EntityType
+
+# 関数をすべて取得
+functions = list(graph.entities.get_by_type(EntityType.FUNCTION))
+
+# 名前で検索
+all_entities = list(graph.entities.all())
+matches = [e for e in all_entities if "process" in e.name.lower()]
+```
+
+### グラフの永続化
+
+```python
+from magatama_core.infrastructure.storage import JSONGraphSerializer
+
+serializer = JSONGraphSerializer()
+
+# 保存
+serializer.save(graph, Path("graph.json"))
+
+# 読み込み
+loaded_graph = serializer.load(Path("graph.json"))
+```
+
+## アーキテクチャ
+
+magatama-core は Clean Architecture に基づいて設計されています：
+
+```
+magatama_core/
+├── domain/          # ドメイン層
+│   ├── entities/    # FunctionEntity, ClassEntity, etc.
+│   ├── value_objects/ # EntityId, Location
+│   └── repositories/ # インターフェース
+├── application/     # アプリケーション層
+│   ├── usecases/    # ParseFileUseCase, etc.
+│   └── services/    # Benchmark, etc.
+└── infrastructure/  # インフラ層
+    ├── parsers/     # PythonParser, TypeScriptParser, etc.
+    └── storage/     # NetworkXKnowledgeGraph, SQLiteKnowledgeGraph
+```
+
+## 対応言語
+
+| 言語 | 拡張子 | パーサー |
+|------|--------|----------|
+| Python | `.py` | `PythonParser` |
+| TypeScript | `.ts`, `.tsx` | `TypeScriptParser` |
+| JavaScript | `.js`, `.jsx` | `JavaScriptParser` |
+| Rust | `.rs` | `RustParser` |
+| Go | `.go` | `GoParser` |
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](../../LICENSE) を参照してください。
+
+## 関連プロジェクト
+
+- [magatama-mcp](https://github.com/tsucky230/MAGATAMA/tree/main/packages/magatama-mcp) - MCP Server

magatama_core-0.5.0/README.md

@@ -0,0 +1,126 @@
+# magatama-core - Knowledge Graph Engine
+
+[![PyPI version](https://badge.fury.io/py/magatama-core.svg)](https://badge.fury.io/py/magatama-core)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> [MAGATAMA](https://github.com/tsucky230/MAGATAMA)（[YATA](https://github.com/nahisaho/YATA) のフォーク）の
+> コアライブラリパッケージです（パッケージ名 `magatama-core` / import 名 `magatama_core`）。
+
+独立したライブラリとして、コード解析と知識グラフ構築機能を提供します。
+
+## 特徴
+
+- 🔍 **マルチ言語解析**: Python, TypeScript, JavaScript, Rust, Go
+- 🕸️ **知識グラフ**: NetworkX によるエンティティ・関係性グラフ
+- 🔗 **関係性検出**: CALLS, IMPORTS, CONTAINS, INHERITS
+- 💾 **永続化**: JSON / SQLite ストレージ
+
+## インストール
+
+```bash
+pip install magatama-core
+```
+
+### オプション言語サポート
+
+```bash
+# Rust サポート
+pip install magatama-core[rust]
+
+# Go サポート
+pip install magatama-core[go]
+
+# 全言語サポート
+pip install magatama-core[all-languages]
+```
+
+## 使用方法
+
+### 基本的な使い方
+
+```python
+from magatama_core.infrastructure.parsers import PythonParser
+from magatama_core.infrastructure.storage import NetworkXKnowledgeGraph
+from magatama_core.application.usecases import ParseFileUseCase
+
+# パーサーとグラフを作成
+parser = PythonParser()
+graph = NetworkXKnowledgeGraph()
+
+# ユースケースを設定
+parse_file = ParseFileUseCase(
+    parsers={".py": parser},
+    knowledge_graph=graph,
+)
+
+# ファイルを解析
+from pathlib import Path
+result = parse_file.execute(Path("your_file.py"))
+
+print(f"Entities: {result.entity_count}")
+print(f"Relationships: {result.relationship_count}")
+```
+
+### エンティティの検索
+
+```python
+from magatama_core.domain.entities import EntityType
+
+# 関数をすべて取得
+functions = list(graph.entities.get_by_type(EntityType.FUNCTION))
+
+# 名前で検索
+all_entities = list(graph.entities.all())
+matches = [e for e in all_entities if "process" in e.name.lower()]
+```
+
+### グラフの永続化
+
+```python
+from magatama_core.infrastructure.storage import JSONGraphSerializer
+
+serializer = JSONGraphSerializer()
+
+# 保存
+serializer.save(graph, Path("graph.json"))
+
+# 読み込み
+loaded_graph = serializer.load(Path("graph.json"))
+```
+
+## アーキテクチャ
+
+magatama-core は Clean Architecture に基づいて設計されています：
+
+```
+magatama_core/
+├── domain/          # ドメイン層
+│   ├── entities/    # FunctionEntity, ClassEntity, etc.
+│   ├── value_objects/ # EntityId, Location
+│   └── repositories/ # インターフェース
+├── application/     # アプリケーション層
+│   ├── usecases/    # ParseFileUseCase, etc.
+│   └── services/    # Benchmark, etc.
+└── infrastructure/  # インフラ層
+    ├── parsers/     # PythonParser, TypeScriptParser, etc.
+    └── storage/     # NetworkXKnowledgeGraph, SQLiteKnowledgeGraph
+```
+
+## 対応言語
+
+| 言語 | 拡張子 | パーサー |
+|------|--------|----------|
+| Python | `.py` | `PythonParser` |
+| TypeScript | `.ts`, `.tsx` | `TypeScriptParser` |
+| JavaScript | `.js`, `.jsx` | `JavaScriptParser` |
+| Rust | `.rs` | `RustParser` |
+| Go | `.go` | `GoParser` |
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](../../LICENSE) を参照してください。
+
+## 関連プロジェクト
+
+- [magatama-mcp](https://github.com/tsucky230/MAGATAMA/tree/main/packages/magatama-mcp) - MCP Server

magatama_core-0.5.0/pyproject.toml

@@ -0,0 +1,92 @@
+# MAGATAMA Core - Knowledge Graph Engine Library
+# Article I: Library-First Principle - Independent, reusable library
+# Article II: CLI Interface Mandate - Exposes CLI
+
+[project]
+name = "magatama-core"
+version = "0.5.0"
+description = "MAGATAMA Core - Knowledge Graph Engine for Code Analysis"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+authors = [{ name = "MAGATAMA Team" }]
+keywords = ["knowledge-graph", "ast-parser", "code-analysis", "tree-sitter"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    # AST Parsing (ADR-003)
+    "tree-sitter>=0.24.0",
+    # Tree-sitter language parsers (24 languages)
+    "tree-sitter-python>=0.24.0",
+    "tree-sitter-javascript>=0.24.0",
+    "tree-sitter-typescript>=0.23.0",
+    "tree-sitter-rust>=0.24.0",
+    "tree-sitter-go>=0.25.0",
+    "tree-sitter-ruby>=0.23.0",
+    "tree-sitter-java>=0.23.0",
+    "tree-sitter-c-sharp>=0.23.0",
+    "tree-sitter-cpp>=0.23.0",
+    "tree-sitter-objc>=3.0.0",
+    "tree-sitter-php>=0.24.0",
+    "tree-sitter-swift>=0.0.1",
+    "tree-sitter-kotlin>=1.1.0",
+    "tree-sitter-scala>=0.24.0",
+    "tree-sitter-lua>=0.2.0",
+    "tree-sitter-haskell>=0.23.0",
+    "tree-sitter-elixir>=0.3.0",
+    "tree-sitter-julia>=0.23.0",
+    "tree-sitter-sql>=0.3.0",
+    "tree-sitter-groovy>=0.1.0",
+    "tree-sitter-c>=0.24.0",
+    "tree-sitter-zig>=1.0.0",
+    "tree-sitter-yaml>=0.7.0",
+    # Graph Storage (ADR-004)
+    "networkx>=3.2.0",
+    # Data Validation
+    "pydantic>=2.5.0",
+    "pydantic-settings>=2.1.0",
+    # Utilities
+    "structlog>=24.0.0",
+    "tomli>=2.0.0;python_version<'3.11'",
+]
+
+[project.urls]
+Homepage = "https://github.com/tsucky230/MAGATAMA"
+Repository = "https://github.com/tsucky230/MAGATAMA"
+Documentation = "https://github.com/tsucky230/MAGATAMA#readme"
+Issues = "https://github.com/tsucky230/MAGATAMA/issues"
+
+[project.optional-dependencies]
+ruby = ["tree-sitter-ruby>=0.23.0"]
+java = ["tree-sitter-java>=0.23.0"]
+csharp = ["tree-sitter-c-sharp>=0.23.0"]
+all-languages = [
+    "tree-sitter-ruby>=0.23.0",
+    "tree-sitter-java>=0.23.0",
+    "tree-sitter-c-sharp>=0.23.0",
+]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "pytest-asyncio>=0.23.0",
+    "ruff>=0.4.0",
+    "mypy>=1.9.0",
+]
+
+[project.scripts]
+# Article II: CLI Interface Mandate
+magatama-core = "magatama_core.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/magatama_core"]

magatama_core-0.5.0/src/magatama_core/__init__.py

@@ -0,0 +1,41 @@
+"""
+MAGATAMA Core - Knowledge Graph Engine Library
+
+MAGATAMA (勾玉) is a knowledge graph engine for code analysis,
+providing AST parsing and graph-based code understanding.
+
+Article I Compliance: This is an independent library.
+"""
+
+from magatama_core.domain.entities import (
+    ClassEntity,
+    Entity,
+    EntityType,
+    FunctionEntity,
+    MethodEntity,
+    ModuleEntity,
+    Relationship,
+    RelationshipType,
+    TypeEntity,
+)
+from magatama_core.domain.value_objects import EntityId, LibraryId, Location, Version
+
+__version__ = "0.1.0"
+__all__ = [
+    # Entities
+    "Entity",
+    "EntityType",
+    "ClassEntity",
+    "FunctionEntity",
+    "MethodEntity",
+    "ModuleEntity",
+    "TypeEntity",
+    # Relationships
+    "Relationship",
+    "RelationshipType",
+    # Value Objects
+    "EntityId",
+    "LibraryId",
+    "Location",
+    "Version",
+]

magatama_core-0.5.0/src/magatama_core/application/__init__.py

@@ -0,0 +1,17 @@
+"""
+Application Layer - Use cases and application services.
+
+This layer orchestrates domain objects to fulfill use cases.
+"""
+
+from magatama_core.application.usecases.parse_usecase import (
+    ParseDirectoryUseCase,
+    ParseFileUseCase,
+    ParseResult,
+)
+
+__all__ = [
+    "ParseDirectoryUseCase",
+    "ParseFileUseCase",
+    "ParseResult",
+]

magatama_core-0.5.0/src/magatama_core/application/services/__init__.py

@@ -0,0 +1,29 @@
+"""
+Application Services - Use case implementations.
+"""
+
+from magatama_core.application.services.benchmark import (
+    Benchmark,
+    BenchmarkResult,
+    PerformanceProfiler,
+    measure_indexing_performance,
+    measure_query_performance,
+)
+from magatama_core.application.services.graph_validator import (
+    GraphValidator,
+    RepairResult,
+    ValidationIssue,
+    ValidationResult,
+)
+
+__all__ = [
+    "Benchmark",
+    "BenchmarkResult",
+    "GraphValidator",
+    "PerformanceProfiler",
+    "RepairResult",
+    "ValidationIssue",
+    "ValidationResult",
+    "measure_indexing_performance",
+    "measure_query_performance",
+]