tree-sitter-analyzer 1.9.1__tar.gz → 1.9.3__tar.gz

{tree_sitter_analyzer-1.9.1 → tree_sitter_analyzer-1.9.3}/.gitignore

@@ -286,3 +286,16 @@ local_settings.py
 
 # Compiled tree-sitter parsers
 parsers/
+
+# Compatibility test results (keep directory structure, ignore content)
+compatibility_test/results/*/
+compatibility_test/reports/*.md
+!compatibility_test/results/.gitkeep
+!compatibility_test/reports/.gitkeep
+
+# Normalized comparison files
+.analysis-*-normalized/
+
+
+# Integration test reports
+phase7_integration_report.json

{tree_sitter_analyzer-1.9.1 → tree_sitter_analyzer-1.9.3}/.pre-commit-config.yaml

@@ -36,11 +36,6 @@ repos:
       - id: check-case-conflict
       - id: mixed-line-ending
         args: [--fix=lf]
-
-  # Python-specific checks
-  - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
-    hooks:
       - id: check-ast
       - id: check-builtin-literals
       - id: check-docstring-first
@@ -53,8 +48,8 @@ repos:
     rev: 1.7.10
     hooks:
       - id: bandit
-        args: [-r, tree_sitter_analyzer/]
         exclude: ^tests/
+        args: [--format, json]
 
   # Import sorting
   - repo: https://github.com/pycqa/isort
@@ -63,29 +58,43 @@ repos:
       - id: isort
         args: [--profile, black, --line-length, "88"]
 
-  # Type checking (optional, can be slow)
-  - repo: local
+  # Type checking
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.18.2
     hooks:
       - id: mypy
-        name: mypy
-        entry: uv run mypy
-        language: system
-        types: [python]
-        args: [--no-error-summary, --show-error-codes]
-        pass_filenames: false
-        stages: [manual]  # Only run when explicitly requested
+        args: [--ignore-missing-imports, --no-error-summary, --show-error-codes, --explicit-package-bases]
+        exclude: ^(examples/|scripts/|compatibility_test/|collect_project_metrics\.py|test_emergency_fix\.py|debug_async_test\.py|run_regression_tests\.py)
+        additional_dependencies: [
+          types-psutil>=5.9.0,
+        ]
 
-  # Custom quality check
-  - repo: local
+  # Documentation checks
+  - repo: https://github.com/pycqa/pydocstyle
+    rev: 6.3.0
     hooks:
-      - id: quality-check
-        name: Tree-sitter Analyzer Quality Check
-        entry: uv run python check_quality.py --new-code-only
-        language: system
-        pass_filenames: false
-        stages: [pre-push]  # Only run on push
+      - id: pydocstyle
+        args: [--convention=google, --add-ignore=D100,D101,D102,D103,D104,D105,D107]
+        exclude: ^(tests/|examples/)
 
+  # Python modernization
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.19.0
+    hooks:
+      - id: pyupgrade
+        args: [--py310-plus]
 
+  # Additional linting
+  - repo: https://github.com/PyCQA/flake8
+    rev: 7.1.1
+    hooks:
+      - id: flake8
+        args: [--max-line-length=88, --extend-ignore=E203,W503,E501]
+        additional_dependencies: [
+          flake8-bugbear,
+          flake8-comprehensions,
+          flake8-simplify,
+        ]
 
 # Configuration
 default_stages: [pre-commit]

tree_sitter_analyzer-1.9.3/.roo/commands/openspec-apply.md

@@ -0,0 +1,20 @@
+# OpenSpec: Apply
+
+Implement an approved OpenSpec change and keep tasks in sync.
+<!-- OPENSPEC:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
+
+**Steps**
+Track these steps as TODOs and complete them one by one.
+1. Read `changes/<id>/proposal.md`, `design.md` (if present), and `tasks.md` to confirm scope and acceptance criteria.
+2. Work through tasks sequentially, keeping edits minimal and focused on the requested change.
+3. Confirm completion before updating statuses—make sure every item in `tasks.md` is finished.
+4. Update the checklist after all work is done so each task is marked `- [x]` and reflects reality.
+5. Reference `openspec list` or `openspec show <item>` when additional context is required.
+
+**Reference**
+- Use `openspec show <id> --json --deltas-only` if you need additional context from the proposal while implementing.
+<!-- OPENSPEC:END -->

tree_sitter_analyzer-1.9.3/.roo/commands/openspec-archive.md

@@ -0,0 +1,24 @@
+# OpenSpec: Archive
+
+Archive a deployed OpenSpec change and update specs.
+<!-- OPENSPEC:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
+
+**Steps**
+1. Determine the change ID to archive:
+   - If this prompt already includes a specific change ID (for example inside a `<ChangeId>` block populated by slash-command arguments), use that value after trimming whitespace.
+   - If the conversation references a change loosely (for example by title or summary), run `openspec list` to surface likely IDs, share the relevant candidates, and confirm which one the user intends.
+   - Otherwise, review the conversation, run `openspec list`, and ask the user which change to archive; wait for a confirmed change ID before proceeding.
+   - If you still cannot identify a single change ID, stop and tell the user you cannot archive anything yet.
+2. Validate the change ID by running `openspec list` (or `openspec show <id>`) and stop if the change is missing, already archived, or otherwise not ready to archive.
+3. Run `openspec archive <id> --yes` so the CLI moves the change and applies spec updates without prompts (use `--skip-specs` only for tooling-only work).
+4. Review the command output to confirm the target specs were updated and the change landed in `changes/archive/`.
+5. Validate with `openspec validate --strict` and inspect with `openspec show <id>` if anything looks off.
+
+**Reference**
+- Use `openspec list` to confirm change IDs before archiving.
+- Inspect refreshed specs with `openspec list --specs` and address any validation issues before handing off.
+<!-- OPENSPEC:END -->

tree_sitter_analyzer-1.9.3/.roo/commands/openspec-proposal.md

@@ -0,0 +1,24 @@
+# OpenSpec: Proposal
+
+Scaffold a new OpenSpec change and validate strictly.
+<!-- OPENSPEC:START -->
+**Guardrails**
+- Favor straightforward, minimal implementations first and add complexity only when it is requested or clearly required.
+- Keep changes tightly scoped to the requested outcome.
+- Refer to `openspec/AGENTS.md` (located inside the `openspec/` directory—run `ls openspec` or `openspec update` if you don't see it) if you need additional OpenSpec conventions or clarifications.
+- Identify any vague or ambiguous details and ask the necessary follow-up questions before editing files.
+
+**Steps**
+1. Review `openspec/project.md`, run `openspec list` and `openspec list --specs`, and inspect related code or docs (e.g., via `rg`/`ls`) to ground the proposal in current behaviour; note any gaps that require clarification.
+2. Choose a unique verb-led `change-id` and scaffold `proposal.md`, `tasks.md`, and `design.md` (when needed) under `openspec/changes/<id>/`.
+3. Map the change into concrete capabilities or requirements, breaking multi-scope efforts into distinct spec deltas with clear relationships and sequencing.
+4. Capture architectural reasoning in `design.md` when the solution spans multiple systems, introduces new patterns, or demands trade-off discussion before committing to specs.
+5. Draft spec deltas in `changes/<id>/specs/<capability>/spec.md` (one folder per capability) using `## ADDED|MODIFIED|REMOVED Requirements` with at least one `#### Scenario:` per requirement and cross-reference related capabilities when relevant.
+6. Draft `tasks.md` as an ordered list of small, verifiable work items that deliver user-visible progress, include validation (tests, tooling), and highlight dependencies or parallelizable work.
+7. Validate with `openspec validate <id> --strict` and resolve every issue before sharing the proposal.
+
+**Reference**
+- Use `openspec show <id> --json --deltas-only` or `openspec show <spec> --type spec` to inspect details when validation fails.
+- Search existing requirements with `rg -n "Requirement:|Scenario:" openspec/specs` before writing new ones.
+- Explore the codebase with `rg <keyword>`, `ls`, or direct file reads so proposals align with current implementation realities.
+<!-- OPENSPEC:END -->

tree_sitter_analyzer-1.9.3/.roo/mcp.json

@@ -0,0 +1,112 @@
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-local": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "C:/git-private/tree-sitter-analyzer",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "C:/git-private/tree-sitter-analyzer",
+        "TREE_SITTER_OUTPUT_PATH": "C:/git-public/tree-sitter-analyzer/.analysis",
+        "TREE_SITTER_ANALYZER_ENABLE_FILE_LOG": "true",
+        "TREE_SITTER_ANALYZER_LOG_DIR": "C:/git-private/tree-sitter-analyzer/.analysis",
+        "TREE_SITTER_ANALYZER_LOG_LEVEL": "DEBUG"
+      },
+      "alwaysAllow": [
+        "check_code_scale",
+        "extract_code_section",
+        "set_project_path",
+        "query_code",
+        "analyze_code_structure",
+        "list_files",
+        "find_and_grep"
+      ],
+      "timeout": 3600,
+      "disabled": true
+    },
+    "tree-sitter-analyzer-bc-test": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "C:/git-private/tree-sitter-analyzer",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "C:/git-private/tree-sitter-analyzer",
+        "TREE_SITTER_OUTPUT_PATH": "C:/git-private/tree-sitter-analyzer/.analysis-bc-test"
+      },
+      "alwaysAllow": [
+        "check_code_scale",
+        "extract_code_section",
+        "set_project_path",
+        "query_code",
+        "analyze_code_structure",
+        "list_files",
+        "find_and_grep",
+        "search_content"
+      ],
+      "timeout": 3600,
+      "disabled": true
+    },
+    "tree-sitter-analyzer-1.6.1.2": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--with",
+        "tree-sitter-analyzer[mcp]==1.6.1.2",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "C:/git-private/tree-sitter-analyzer",
+        "TREE_SITTER_OUTPUT_PATH": "C:/git-private/tree-sitter-analyzer/.analysis-1.6.1.2"
+      },
+      "alwaysAllow": [
+        "analyze_code_structure",
+        "query_code",
+        "check_code_scale",
+        "extract_code_section",
+        "set_project_path",
+        "list_files",
+        "search_content"
+      ],
+      "timeout": 3600,
+      "disabled": true
+    },
+    "tree-sitter-analyzer-1.9.2": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--with",
+        "tree-sitter-analyzer[mcp]==1.9.2",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "C:/git-private/tree-sitter-analyzer",
+        "TREE_SITTER_OUTPUT_PATH": "C:/git-private/tree-sitter-analyzer/.analysis-1.9.2"
+      },
+      "alwaysAllow": [
+        "analyze_code_structure",
+        "query_code",
+        "check_code_scale",
+        "set_project_path",
+        "list_files",
+        "find_and_grep",
+        "search_content"
+      ],
+      "timeout": 3600,
+      "disabled": true
+    }
+  }
+}

tree_sitter_analyzer-1.9.3/.roo/rules/code-quality-standards.md

@@ -0,0 +1,150 @@
+# Tree-sitter Analyzer コード品質基準
+
+このファイルは`.pre-commit-config.yaml`の設定に基づき、Roo Codeが高品質なソースコードを作成するための包括的なガイドラインです。
+
+## コードフォーマット規則
+
+### Black フォーマッター
+- **行長制限**: 88文字
+- **Python バージョン**: Python 3.10+
+- **適用範囲**: 全ての`.py`ファイル
+
+### Ruff フォーマッター
+- **自動修正**: 有効（`--fix`オプション）
+- **エラー時終了**: 修正時も終了コード非ゼロ
+- **フォーマット**: ruff-format併用
+
+## リンティング規則
+
+### Ruff
+- 自動修正可能な問題は自動で修正
+- 修正後もエラーチェックを継続
+
+### Flake8
+- **行長制限**: 88文字
+- **無視するエラー**: E203, W503, E501
+- **追加プラグイン**:
+  - flake8-bugbear: バグの可能性があるコードパターンを検出
+  - flake8-comprehensions: リスト内包表記の改善提案
+  - flake8-simplify: コードの簡素化提案
+
+## 型チェック規則
+
+### MyPy
+- **設定**:
+  - `--ignore-missing-imports`: 外部ライブラリの型情報不足を無視
+  - `--no-error-summary`: エラーサマリーを非表示
+  - `--show-error-codes`: エラーコードを表示
+  - `--explicit-package-bases`: パッケージベースを明示
+- **除外ディレクトリ**: examples/, scripts/, compatibility_test/
+- **追加依存関係**: types-psutil>=5.9.0
+
+## インポート整理規則
+
+### isort
+- **プロファイル**: black互換
+- **行長**: 88文字
+- **ソート順序**: 標準ライブラリ → サードパーティ → ローカル
+
+## セキュリティ規則
+
+### Bandit
+- **フォーマット**: JSON出力
+- **除外**: tests/ディレクトリ
+- **チェック項目**: セキュリティ脆弱性の検出
+
+## ドキュメント規則
+
+### pydocstyle
+- **規約**: Google スタイル
+- **無視するエラー**: D100,D101,D102,D103,D104,D105,D107
+- **除外**: tests/, examples/
+- **必須**: パブリックモジュール、クラス、関数にはdocstring
+
+## Python近代化規則
+
+### pyupgrade
+- **対象バージョン**: Python 3.10+
+- **自動更新**: 古い構文を新しい構文に自動変換
+
+## ファイル品質規則
+
+### 基本チェック
+- **末尾空白**: 削除（.mdファイルは除外）
+- **ファイル末尾**: 改行で終了（.mdファイルは除外）
+- **YAML/JSON/TOML**: 構文チェック
+- **マージコンフリクト**: 検出
+- **大きなファイル**: 1MB以上は警告
+- **ケース競合**: ファイル名の大文字小文字競合検出
+- **改行コード**: LF統一
+- **AST**: Python構文チェック
+- **ビルトインリテラル**: 適切な使用チェック
+- **docstring位置**: 関数/クラス定義直後に配置
+- **デバッグ文**: print(), pdb等の削除
+- **テストファイル命名**: pytest形式（test_*.py）
+
+## コーディングベストプラクティス
+
+### 命名規則
+- **関数・変数**: snake_case
+- **クラス**: PascalCase
+- **定数**: UPPER_SNAKE_CASE
+- **プライベート**: 先頭アンダースコア（_private）
+
+### 型ヒント
+- 全ての関数にtype hintsを追加
+- 戻り値の型を明示
+- 複雑な型はtyping モジュールを使用
+
+### エラーハンドリング
+- 具体的な例外クラスを使用
+- 適切なログ出力
+- リソースの適切なクリーンアップ
+
+### 非同期プログラミング
+- asyncio使用時は適切なawait
+- コンテキストマネージャーの活用
+- リソースリークの防止
+
+### パフォーマンス
+- 不要なループの回避
+- 適切なデータ構造の選択
+- メモリ効率の考慮
+
+## プロジェクト固有ルール
+
+### Tree-sitter関連
+- tree-sitterクエリは適切にテスト
+- 言語サポートの一貫性維持
+- パーサーエラーの適切な処理
+
+### MCP (Model Context Protocol)
+- 非同期処理の適切な実装
+- エラーレスポンスの標準化
+- リソース管理の徹底
+
+### テスト
+- 各機能に対応するテストを作成
+- エッジケースのテスト
+- モックの適切な使用
+- テストカバレッジ80%以上を目標
+
+## 品質チェックコマンド
+
+```bash
+# 基本的な品質チェック
+uv run pre-commit run --all-files
+
+# 個別チェック
+uv run black --check --line-length=88 .
+uv run ruff check .
+uv run mypy tree_sitter_analyzer/
+uv run pytest tests/
+```
+
+## 継続的改善
+
+- 定期的なルール見直し
+- 新しいツールの評価・導入
+- チーム内でのベストプラクティス共有
+- パフォーマンス指標の監視

tree_sitter_analyzer-1.9.3/.roo/rules/coding-checklist.md

@@ -0,0 +1,185 @@
+# Roo Code 実装チェックリスト
+
+このファイルは、Roo Codeがソースコードを作成・修正する際の実践的なチェックリストです。
+
+## 🚀 コード作成前チェック
+
+### プロジェクト理解
+- [ ] プロジェクトの目的と要件を理解している
+- [ ] 既存のアーキテクチャパターンを把握している
+- [ ] 関連する既存コードを確認している
+- [ ] 影響範囲を特定している
+
+### 設計確認
+- [ ] 適切なモジュール・クラス構造を計画している
+- [ ] 依存関係を最小限に抑えている
+- [ ] 単一責任原則を遵守している
+- [ ] 拡張性を考慮している
+
+## 📝 コード実装チェック
+
+### 基本品質
+- [ ] **型ヒント**: 全ての関数・メソッドに型ヒントを追加
+- [ ] **docstring**: パブリックAPIにGoogle形式のdocstringを記述
+- [ ] **命名規則**: snake_case（関数・変数）、PascalCase（クラス）を使用
+- [ ] **行長制限**: 88文字以内に収める
+
+### エラーハンドリング
+- [ ] 適切な例外クラスを使用している
+- [ ] try-except文で具体的な例外をキャッチしている
+- [ ] エラーメッセージが分かりやすい
+- [ ] ログ出力が適切に設定されている
+
+### 非同期処理（該当する場合）
+- [ ] `async/await`を正しく使用している
+- [ ] リソースの適切なクリーンアップを実装している
+- [ ] デッドロックやレースコンディションを回避している
+- [ ] セマフォやロックを適切に使用している
+
+### セキュリティ
+- [ ] ファイルパスの検証を実装している
+- [ ] 入力値のサニタイゼーションを行っている
+- [ ] 機密情報をログに出力していない
+- [ ] SQLインジェクション等の脆弱性を回避している
+
+## 🧪 テスト実装チェック
+
+### テストカバレッジ
+- [ ] 正常ケースのテストを作成している
+- [ ] 異常ケース・エッジケースのテストを作成している
+- [ ] モックを適切に使用している
+- [ ] テストが独立して実行可能である
+
+### テスト品質
+- [ ] テスト名が分かりやすい
+- [ ] Arrange-Act-Assertパターンを使用している
+- [ ] テストデータが適切に管理されている
+- [ ] 非同期テストで`@pytest.mark.asyncio`を使用している
+
+## 🔧 コード品質チェック
+
+### フォーマット・リンティング
+- [ ] Blackフォーマッターを適用している
+- [ ] Ruffリンターでエラーがない
+- [ ] isortでインポートが整理されている
+- [ ] MyPyで型チェックが通る
+
+### セキュリティ・品質
+- [ ] Banditでセキュリティチェックが通る
+- [ ] pydocstyleでドキュメント品質が確保されている
+- [ ] pyupgradeで最新のPython構文を使用している
+- [ ] デバッグ文（print, pdb等）を削除している
+
+## 📚 プロジェクト固有チェック
+
+### Tree-sitter関連
+- [ ] パーサーエラーの適切な処理を実装している
+- [ ] 言語サポートの一貫性を維持している
+- [ ] クエリの最適化を考慮している
+- [ ] メモリ効率を考慮している
+
+### MCP (Model Context Protocol)
+- [ ] 非同期処理を正しく実装している
+- [ ] エラーレスポンスを標準化している
+- [ ] リソース管理を徹底している
+- [ ] セキュリティ要件を満たしている
+
+## 🚀 コード完成後チェック
+
+### 最終確認
+- [ ] 全てのテストが通る
+- [ ] pre-commitフックが通る
+- [ ] ドキュメントが更新されている
+- [ ] 変更ログが記録されている
+
+### パフォーマンス
+- [ ] 大きなファイルでの動作を確認している
+- [ ] メモリ使用量が適切である
+- [ ] 処理時間が許容範囲内である
+- [ ] キャッシュが適切に機能している
+
+## 🔄 継続的改善
+
+### コードレビュー観点
+- [ ] 可読性が高い
+- [ ] 保守性が高い
+- [ ] 再利用性がある
+- [ ] 拡張性がある
+
+### 品質指標
+- [ ] テストカバレッジ80%以上
+- [ ] 複雑度が適切な範囲内
+- [ ] 依存関係が最小限
+- [ ] パフォーマンスが要件を満たす
+
+## 📋 クイックリファレンス
+
+### よく使用する型ヒント
+```python
+from typing import Dict, List, Optional, Union, Any, Callable, AsyncIterator
+from pathlib import Path
+import asyncio
+
+# 基本的な関数
+async def process_file(
+    file_path: Path,
+    options: Optional[Dict[str, Any]] = None
+) -> Dict[str, Any]:
+    pass
+
+# ジェネレーター
+async def stream_results() -> AsyncIterator[Dict[str, Any]]:
+    pass
+
+# コールバック
+def callback_func(
+    result: Dict[str, Any],
+    callback: Optional[Callable[[str], None]] = None
+) -> None:
+    pass
+```
+
+### エラーハンドリングパターン
+```python
+try:
+    result = await risky_operation()
+except SpecificError as e:
+    logger.error(f"Specific error occurred: {e}")
+    raise CustomError(f"Operation failed: {e}") from e
+except Exception as e:
+    logger.error(f"Unexpected error: {e}")
+    raise
+finally:
+    await cleanup_resources()
+```
+
+### 非同期リソース管理
+```python
+async with managed_resource() as resource:
+    result = await resource.process()
+    return result
+```
+
+### テストパターン
+```python
+@pytest.mark.asyncio
+async def test_function_success():
+    # Arrange
+    input_data = create_test_data()
+    
+    # Act
+    result = await function_under_test(input_data)
+    
+    # Assert
+    assert result is not None
+    assert result["status"] == "success"
+```
+
+## 🎯 品質目標
+
+- **コードカバレッジ**: 80%以上
+- **型チェック**: MyPyエラーゼロ
+- **リンティング**: Ruff/Flake8エラーゼロ
+- **セキュリティ**: Bandit警告ゼロ
+- **ドキュメント**: パブリックAPI 100%カバー
+- **パフォーマンス**: 大きなファイル（1MB+）でも適切な応答時間