tree-sitter-analyzer 1.6.1__tar.gz → 1.6.1.1__tar.gz

tree_sitter_analyzer-1.6.1.1/.roo/AGENTS.md

@@ -0,0 +1,74 @@
+# ROO規則 - Tree-Sitter-Analyzer MCP最適化ガイド
+
+## 🎯 核心原則
+
+### 1. 言語サポート
+**対応拡張子**: `.java`, `.js`, `.mjs`, `.jsx`, `.ts`, `.tsx`, `.py`, `.md`
+**制限**: 上記以外は構造解析機能が制限されます
+
+### 2. 基本規則
+- **禁止**: 標準`read_file`での直接コードファイル読取
+- **必須**: tree-sitter-analyzer MCPツール使用
+- **推奨**: `check_code_scale`による事前評価
+
+### 3. 効率化ワークフロー
+```
+search_content → check_code_scale → 推奨戦略に従う
+```
+
+## 📋 実践ガイド
+
+### 小規模分析
+```markdown
+search_content → read_file
+```
+
+### 大規模分析  
+```markdown
+search_content → check_code_scale → analyze_code_structure
+suppress_output=true + output_file
+```
+
+### 安全検索
+```markdown
+# Token爆発防止
+search_content (total_only=true) → 数量確認 → 詳細検索
+```
+
+## ⚡ 最適化テクニック
+
+### Token節約
+- 大量結果: `suppress_output=true + output_file`
+- 検索: `total_only → summary_only → 詳細`の段階的アプローチ
+- 日本語検索: 汎用語（「項目名」「データ」「処理」）回避
+
+### システム対応
+- **Windows**: Unixコマンド（`grep`, `find`等）禁止
+- **Python実行**: 直接`python -c`禁止、テストファイル作成推奨
+
+## 🚨 重要注意
+
+### Token爆発防止
+⚠️ **危険**: 汎用語検索での大量結果
+✅ **対策**: 必ず`total_only=true`で事前確認
+
+### 効率化パラメータ
+```markdown
+# 検索制限
+max_count: 20
+include_globs: ["*.py", "*.java", "*.js", "*.ts", "*.md"]
+
+# 出力制御  
+suppress_output: true
+output_file: "analysis_result.json"
+```
+
+## 🔧 クイックリファレンス
+
+| 目的 | 手法 | パラメータ |
+|------|------|------------|
+| ファイル探索 | search_content → read_file | - |
+| 大規模分析 | check_code_scale → analyze_code_structure | suppress_output=true |
+| 安全検索 | search_content | total_only=true |
+| 構造解析 | analyze_code_structure | format_type=full |
+

tree_sitter_analyzer-1.6.1.1/.roo/commands/release.md

@@ -0,0 +1,3 @@
+# release
+
+GitFlowリリースプロセス自動化 - 詳細は [.roo/docs/release.md](.roo/docs/release.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.analyze.md

@@ -0,0 +1,3 @@
+# analyze
+
+コードベース分析とスケール評価 - 詳細は [.roo/docs/speckit.analyze.md](.roo/docs/speckit.analyze.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.checklist.md

@@ -0,0 +1,3 @@
+# checklist
+
+タスク管理とチェックリスト作成 - 詳細は [.roo/docs/speckit.checklist.md](.roo/docs/speckit.checklist.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.clarify.md

@@ -0,0 +1,3 @@
+# clarify
+
+要件明確化と質問生成 - 詳細は [.roo/docs/speckit.clarify.md](.roo/docs/speckit.clarify.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.constitution.md

@@ -0,0 +1,3 @@
+# constitution
+
+プロジェクト憲法と基本原則 - 詳細は [.roo/docs/speckit.constitution.md](.roo/docs/speckit.constitution.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.implement.md

@@ -0,0 +1,3 @@
+# implement
+
+実装とコード生成 - 詳細は [.roo/docs/speckit.implement.md](.roo/docs/speckit.implement.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.plan.md

@@ -0,0 +1,3 @@
+# plan
+
+プロジェクト計画と設計 - 詳細は [.roo/docs/speckit.plan.md](.roo/docs/speckit.plan.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.specify.md

@@ -0,0 +1,3 @@
+# specify
+
+仕様書作成と要件定義 - 詳細は [.roo/docs/speckit.specify.md](.roo/docs/speckit.specify.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/commands/speckit.tasks.md

@@ -0,0 +1,3 @@
+# tasks
+
+タスク分解と進捗管理 - 詳細は [.roo/docs/speckit.tasks.md](.roo/docs/speckit.tasks.md) を参照

tree_sitter_analyzer-1.6.1.1/.roo/docs/release.md

@@ -0,0 +1,141 @@
+---
+description: GitFlowリリースプロセスを自動化実行 - PyPI優先戦略でrelease分岐からmain/developへの安全なマージを実行
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Outline
+
+1. **前提条件確認**: 現在のブランチ状態とリリース準備状況を検証
+   - 現在のブランチが`develop`であることを確認
+   - 未コミットの変更がないことを確認
+   - リモートとの同期状態を確認
+
+2. **バージョン情報取得**: ユーザー入力またはpyproject.tomlから次のバージョンを決定
+   - 引数でバージョンが指定された場合: そのバージョンを使用
+   - 引数が空の場合: pyproject.tomlから現在のバージョンを読み取り、パッチバージョンを自動インクリメント
+   - バージョン形式検証 (semantic versioning: x.y.z)
+
+3. **Release分岐作成**: developからrelease/vX.Y.Z分岐を作成
+   ```bash
+   git fetch origin
+   git checkout -b release/v{VERSION} origin/develop
+   ```
+
+4. **リリース準備作業**: バージョン更新と文書同期
+   - pyproject.tomlのバージョン更新
+   - server_versionの更新
+   - `uv run python scripts/sync_version_minimal.py`実行
+   - 品質指標取得:
+     * テスト数: `uv run python -m pytest --collect-only -q | findstr /C:"collected"`
+     * 注意：カバレッジはCodecov自動徽章を使用、手動更新不要
+   - 文書更新:
+     * README.md (バージョン、テスト数)
+     * README_zh.md, README_ja.md
+     * CHANGELOG.md
+     * バージョン徽章、テスト徽章更新（カバレッジ徽章はCodecov自動更新）
+
+5. **Release分岐プッシュ**: PyPI自動発布トリガー
+   ```bash
+   git add .
+   git commit -m "Release v{VERSION}: Update version and documentation"
+   git push origin release/v{VERSION}
+   ```
+
+6. **PyPI発布待機**: 自動化ワークフローの完了を監視
+   - GitHub Actionsページでrelease-automation.ymlの実行状況を確認
+   - PyPI発布成功の確認
+   - 失敗時のエラーハンドリング
+
+7. **Main分岐マージ**: PyPI発布成功後のmain分岐更新
+   ```bash
+   git checkout main
+   git merge release/v{VERSION}
+   git tag -a v{VERSION} -m "Release v{VERSION}"
+   git push origin main --tags
+   ```
+
+8. **Develop分岐マージ**: 変更をdevelopに反映
+   ```bash
+   git checkout develop
+   git merge release/v{VERSION}
+   git push origin develop
+   ```
+
+9. **GitHub Release作成**: 自動化されたリリースノート生成
+   - release_message.mdテンプレート作成
+   - gh CLIを使用したリリース作成
+   - リリースノートの品質指標含む
+
+10. **クリーンアップ**: Release分岐削除
+    ```bash
+    git branch -d release/v{VERSION}
+    git push origin --delete release/v{VERSION}
+    ```
+
+## 実行フロー
+
+### Phase 1: 準備と検証
+- 現在の状態確認 (ブランチ、未コミット変更、リモート同期)
+- バージョン決定 (引数 or 自動インクリメント)
+- Release分岐作成
+
+### Phase 2: リリース準備
+- バージョンファイル更新
+- 品質指標取得
+- 文書更新とコミット
+- Release分岐プッシュ
+
+### Phase 3: PyPI発布監視
+- GitHub Actions監視
+- 発布成功確認
+- エラー時の対応指示
+
+### Phase 4: 分岐マージ
+- Main分岐マージとタグ作成
+- Develop分岐マージ
+- GitHub Release作成
+
+### Phase 5: 後処理
+- 完了報告
+
+## エラーハンドリング
+
+### 前提条件エラー
+- 現在のブランチがdevelopでない → 指示とともに停止
+- 未コミット変更あり → コミットまたはstash指示
+- リモート非同期 → fetch/pull指示
+
+### PyPI発布エラー
+- GitHub Actions失敗 → ログ確認指示
+- PyPI発布失敗 → 手動対応手順提示
+- タイムアウト → 状況確認と次ステップ提示
+
+### マージエラー
+- コンフリクト発生 → 解決手順提示
+- プッシュ失敗 → 権限確認指示
+
+## 成功基準
+
+1. ✅ Release分岐が正常に作成された
+2. ✅ バージョンファイルが正しく更新された
+3. ✅ PyPI発布が成功した
+4. ✅ Main分岐にマージされタグが作成された
+5. ✅ Develop分岐にマージされた
+6. ✅ GitHub Releaseが作成された
+
+## 注意事項
+
+- **PyPI優先戦略**: パッケージ発布成功後にmain分岐を更新
+- **自動化依存**: GitHub Actionsのrelease-automation.ymlに依存
+- **品質保証**: テスト実行とカバレッジ確認が必須
+- **文書同期**: 多言語README更新が必要
+- **タグ管理**: セマンティックバージョニング準拠
+
+このコマンドはGITFLOW_zh.mdで定義されたリリースプロセスを完全自動化し、PyPI優先戦略により安全で確実なリリースを実現します。

tree_sitter_analyzer-1.6.1.1/.roo/docs/speckit.analyze.md

@@ -0,0 +1,184 @@
+---
+description: Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Goal
+
+Identify inconsistencies, duplications, ambiguities, and underspecified items across the three core artifacts (`spec.md`, `plan.md`, `tasks.md`) before implementation. This command MUST run only after `/tasks` has successfully produced a complete `tasks.md`.
+
+## Operating Constraints
+
+**STRICTLY READ-ONLY**: Do **not** modify any files. Output a structured analysis report. Offer an optional remediation plan (user must explicitly approve before any follow-up editing commands would be invoked manually).
+
+**Constitution Authority**: The project constitution (`.specify/memory/constitution.md`) is **non-negotiable** within this analysis scope. Constitution conflicts are automatically CRITICAL and require adjustment of the spec, plan, or tasks—not dilution, reinterpretation, or silent ignoring of the principle. If a principle itself needs to change, that must occur in a separate, explicit constitution update outside `/analyze`.
+
+## Execution Steps
+
+### 1. Initialize Analysis Context
+
+Run `.specify/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:
+
+- SPEC = FEATURE_DIR/spec.md
+- PLAN = FEATURE_DIR/plan.md
+- TASKS = FEATURE_DIR/tasks.md
+
+Abort with an error message if any required file is missing (instruct the user to run missing prerequisite command).
+For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
+
+### 2. Load Artifacts (Progressive Disclosure)
+
+Load only the minimal necessary context from each artifact:
+
+**From spec.md:**
+
+- Overview/Context
+- Functional Requirements
+- Non-Functional Requirements
+- User Stories
+- Edge Cases (if present)
+
+**From plan.md:**
+
+- Architecture/stack choices
+- Data Model references
+- Phases
+- Technical constraints
+
+**From tasks.md:**
+
+- Task IDs
+- Descriptions
+- Phase grouping
+- Parallel markers [P]
+- Referenced file paths
+
+**From constitution:**
+
+- Load `.specify/memory/constitution.md` for principle validation
+
+### 3. Build Semantic Models
+
+Create internal representations (do not include raw artifacts in output):
+
+- **Requirements inventory**: Each functional + non-functional requirement with a stable key (derive slug based on imperative phrase; e.g., "User can upload file" → `user-can-upload-file`)
+- **User story/action inventory**: Discrete user actions with acceptance criteria
+- **Task coverage mapping**: Map each task to one or more requirements or stories (inference by keyword / explicit reference patterns like IDs or key phrases)
+- **Constitution rule set**: Extract principle names and MUST/SHOULD normative statements
+
+### 4. Detection Passes (Token-Efficient Analysis)
+
+Focus on high-signal findings. Limit to 50 findings total; aggregate remainder in overflow summary.
+
+#### A. Duplication Detection
+
+- Identify near-duplicate requirements
+- Mark lower-quality phrasing for consolidation
+
+#### B. Ambiguity Detection
+
+- Flag vague adjectives (fast, scalable, secure, intuitive, robust) lacking measurable criteria
+- Flag unresolved placeholders (TODO, TKTK, ???, `<placeholder>`, etc.)
+
+#### C. Underspecification
+
+- Requirements with verbs but missing object or measurable outcome
+- User stories missing acceptance criteria alignment
+- Tasks referencing files or components not defined in spec/plan
+
+#### D. Constitution Alignment
+
+- Any requirement or plan element conflicting with a MUST principle
+- Missing mandated sections or quality gates from constitution
+
+#### E. Coverage Gaps
+
+- Requirements with zero associated tasks
+- Tasks with no mapped requirement/story
+- Non-functional requirements not reflected in tasks (e.g., performance, security)
+
+#### F. Inconsistency
+
+- Terminology drift (same concept named differently across files)
+- Data entities referenced in plan but absent in spec (or vice versa)
+- Task ordering contradictions (e.g., integration tasks before foundational setup tasks without dependency note)
+- Conflicting requirements (e.g., one requires Next.js while other specifies Vue)
+
+### 5. Severity Assignment
+
+Use this heuristic to prioritize findings:
+
+- **CRITICAL**: Violates constitution MUST, missing core spec artifact, or requirement with zero coverage that blocks baseline functionality
+- **HIGH**: Duplicate or conflicting requirement, ambiguous security/performance attribute, untestable acceptance criterion
+- **MEDIUM**: Terminology drift, missing non-functional task coverage, underspecified edge case
+- **LOW**: Style/wording improvements, minor redundancy not affecting execution order
+
+### 6. Produce Compact Analysis Report
+
+Output a Markdown report (no file writes) with the following structure:
+
+## Specification Analysis Report
+
+| ID | Category | Severity | Location(s) | Summary | Recommendation |
+|----|----------|----------|-------------|---------|----------------|
+| A1 | Duplication | HIGH | spec.md:L120-134 | Two similar requirements ... | Merge phrasing; keep clearer version |
+
+(Add one row per finding; generate stable IDs prefixed by category initial.)
+
+**Coverage Summary Table:**
+
+| Requirement Key | Has Task? | Task IDs | Notes |
+|-----------------|-----------|----------|-------|
+
+**Constitution Alignment Issues:** (if any)
+
+**Unmapped Tasks:** (if any)
+
+**Metrics:**
+
+- Total Requirements
+- Total Tasks
+- Coverage % (requirements with >=1 task)
+- Ambiguity Count
+- Duplication Count
+- Critical Issues Count
+
+### 7. Provide Next Actions
+
+At end of report, output a concise Next Actions block:
+
+- If CRITICAL issues exist: Recommend resolving before `/implement`
+- If only LOW/MEDIUM: User may proceed, but provide improvement suggestions
+- Provide explicit command suggestions: e.g., "Run /specify with refinement", "Run /plan to adjust architecture", "Manually edit tasks.md to add coverage for 'performance-metrics'"
+
+### 8. Offer Remediation
+
+Ask the user: "Would you like me to suggest concrete remediation edits for the top N issues?" (Do NOT apply them automatically.)
+
+## Operating Principles
+
+### Context Efficiency
+
+- **Minimal high-signal tokens**: Focus on actionable findings, not exhaustive documentation
+- **Progressive disclosure**: Load artifacts incrementally; don't dump all content into analysis
+- **Token-efficient output**: Limit findings table to 50 rows; summarize overflow
+- **Deterministic results**: Rerunning without changes should produce consistent IDs and counts
+
+### Analysis Guidelines
+
+- **NEVER modify files** (this is read-only analysis)
+- **NEVER hallucinate missing sections** (if absent, report them accurately)
+- **Prioritize constitution violations** (these are always CRITICAL)
+- **Use examples over exhaustive rules** (cite specific instances, not generic patterns)
+- **Report zero issues gracefully** (emit success report with coverage statistics)
+
+## Context
+
+$ARGUMENTS