stravinsky 0.2.40__py3-none-any.whl → 0.3.4__py3-none-any.whl

mcp_bridge/tools/templates.py

@@ -2,11 +2,16 @@
 Templates for stravinsky repository initialization.
 """
 
-CLAUDE_MD_TEMPLATE = """## stravinsky MCP (Parallel Agents)
+CLAUDE_MD_TEMPLATE = """## stravinsky MCP (Multi-Model Orchestration)
 
-Use stravinsky MCP tools. **DEFAULT: spawn parallel agents for multi-step tasks.**
+Stravinsky provides multi-model AI orchestration with parallel agent execution.
 
-### Agent Tools
+### Architecture
+- **Native Subagent**: Stravinsky orchestrator (.claude/agents/stravinsky.md) auto-delegates complex tasks
+- **MCP Tools**: agent_spawn, invoke_gemini, invoke_openai, LSP tools, code search
+- **Specialist Agents**: explore, dewey, frontend, delphi, multimodal, document_writer
+
+### Agent Tools (via MCP)
 - `agent_spawn(prompt, agent_type, description)` - Spawn background agent with full tool access
 - `agent_output(task_id, block)` - Get results (block=True to wait)
 - `agent_progress(task_id)` - Check real-time progress
@@ -14,15 +19,17 @@ Use stravinsky MCP tools. **DEFAULT: spawn parallel agents for multi-step tasks.
 - `agent_cancel(task_id)` - Stop a running agent
 
 ### Agent Types
-- `explore` - Codebase search, "where is X?" questions
-- `dewey` - Documentation research, implementation examples
-- `frontend` - UI/UX work, component design
-- `delphi` - Strategic advice, architecture review
-
-### Parallel Execution (IRONSTAR)
+- `explore` - Codebase search, structural analysis (Gemini 3 Flash)
+- `dewey` - Documentation research, web search (Gemini 3 Flash + Web)
+- `frontend` - UI/UX implementation (Gemini 3 Pro High)
+- `delphi` - Strategic advice, architecture review (GPT-5.2 Medium)
+- `multimodal` - Visual analysis, screenshots (Gemini 3 Flash Vision)
+- `document_writer` - Technical documentation (Gemini 3 Flash)
+
+### Parallel Execution (MANDATORY)
 For ANY task with 2+ independent steps:
 1. **Immediately use agent_spawn** for each independent component
-2. Fire all agents simultaneously, don't wait
+2. Fire all agents simultaneously in ONE response, don't wait
 3. Monitor with agent_progress, collect with agent_output
 
 ### Trigger Commands
@@ -30,6 +37,12 @@ For ANY task with 2+ independent steps:
 - **ULTRATHINK**: Engage exhaustive deep reasoning, multi-dimensional analysis
 - **SEARCH**: Maximize search effort across codebase and external resources
 - **ANALYZE**: Deep analysis mode with delphi consultation for complex issues
+
+### Native Subagent Benefits
+- ✅ Auto-delegation (no manual /stravinsky invocation)
+- ✅ Context isolation (orchestrator runs as subagent)
+- ✅ Full MCP tool access (agent_spawn, invoke_gemini/openai, LSP, etc.)
+- ✅ Multi-model routing (Gemini for UI/research, GPT for strategy)
 """
 
 COMMAND_STRAVINSKY = """---
@@ -74,15 +87,16 @@ stravinsky:agent_spawn(prompt="Task 3...", agent_type="dewey", description="Task
 stravinsky:agent_output(task_id="[id]", block=true)
 ```
 
-### DO NOT USE:
-- ❌ Built-in Read tool for file reading
-- ❌ Built-in Search/Glob for searching
-- ❌ Built-in Task tool for subagents
+### Recommended Tool Usage:
+- For file operations within agents: Use standard Read/Edit tools
+- For parallel agent spawning: Use stravinsky:agent_spawn (supports nesting, unlike native Task tool)
+- For collecting results: Use stravinsky:agent_output
+- For monitoring agents: Use stravinsky:agent_list
 
-### ALWAYS USE:
-- ✅ stravinsky:agent_spawn for ALL exploration
-- ✅ stravinsky:agent_output for collecting results
-- ✅ stravinsky:agent_list to see running agents
+### Native Subagent Integration:
+- Stravinsky orchestrator configured as native Claude Code subagent (.claude/agents/stravinsky.md)
+- Native subagents CAN call Stravinsky MCP tools (agent_spawn, invoke_gemini, etc.)
+- This enables auto-delegation without manual /stravinsky invocation
 
 ### Execution Modes:
 - `ironstar` / `irs` / `ultrawork` - Maximum parallel execution (10+ agents)

stravinsky-0.3.4.dist-info/METADATA

@@ -0,0 +1,420 @@
+Metadata-Version: 2.4
+Name: stravinsky
+Version: 0.3.4
+Summary: MCP Bridge for Claude Code with Multi-Model Support. Install globally: claude mcp add --scope user stravinsky -- uvx stravinsky. Add to CLAUDE.md: See https://pypi.org/project/stravinsky/
+Project-URL: Repository, https://github.com/GratefulDave/stravinsky
+Project-URL: Issues, https://github.com/GratefulDave/stravinsky/issues
+Author: Stravinsky Team
+License: MIT
+Keywords: claude,gemini,mcp,oauth,openai
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=23.1.0
+Requires-Dist: chromadb>=0.6.0; python_version < '3.14'
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: google-auth-oauthlib>=1.0.0
+Requires-Dist: google-auth>=2.20.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jedi-language-server>=0.41.0
+Requires-Dist: jedi>=0.19.2
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: lsprotocol>=2023.0.0
+Requires-Dist: mcp>=1.2.1
+Requires-Dist: ollama>=0.6.1
+Requires-Dist: openai>=1.0.0
+Requires-Dist: plyer>=2.1.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pygls>=1.3.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: ruff>=0.14.10
+Requires-Dist: tenacity>=8.5.0
+Requires-Dist: watchdog~=5.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: semantic
+Requires-Dist: chromadb>=0.5.0; extra == 'semantic'
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/GratefulDave/stravinsky/main/assets/logo.png" width="300" alt="Stravinsky Logo">
+  <h1>Stravinsky</h1>
+  <p><strong>The Avant-Garde MCP Bridge for Claude Code</strong></p>
+  <p><em>Movement • Rhythm • Precision</em></p>
+</div>
+
+---
+
+## What is Stravinsky?
+
+**Multi-model AI orchestration** with OAuth authentication for Claude Code.
+
+## Features
+
+- 🔐 **OAuth Authentication** - Secure browser-based auth for Google (Gemini) and OpenAI (ChatGPT)
+- 🤖 **Multi-Model Support** - Seamlessly invoke Gemini and GPT models from Claude
+- 🎯 **Native Subagent Orchestration** - Auto-delegating orchestrator with parallel execution (zero CLI overhead)
+- 🛠️ **38 MCP Tools** - Model invocation, code search, semantic search, LSP refactoring, session management, and more
+- 🧠 **9 Specialized Native Agents** - Stravinsky (orchestrator), Research Lead, Implementation Lead, Delphi (GPT-5.2 advisor), Dewey (documentation), Explore (code search), Frontend (Gemini 3 Pro High UI/UX), Code Reviewer, Debugger
+- 🔄 **Hook-Based Delegation** - PreToolUse hooks enforce delegation patterns with hard boundaries (exit code 2)
+- 📝 **LSP Integration** - Full Language Server Protocol support with persistent servers (35x speedup), code refactoring, and advanced navigation
+- 🔍 **AST-Aware Search** - Structural code search and refactoring with ast-grep
+- 🧠 **Semantic Code Search** - Natural language queries with local embeddings (ChromaDB + Ollama)
+- ⚡ **Cost-Optimized Routing** - Free/cheap agents (explore, dewey) always async, expensive (delphi) only when needed
+
+## Quick Start
+
+### Installation
+
+**CRITICAL: Always use --global with @latest for auto-updates**
+
+```bash
+# CORRECT: Global installation with automatic updates
+claude mcp add --global stravinsky -- uvx stravinsky@latest
+
+# Why this matters:
+# - --global: Works across all projects (not just current directory)
+# - @latest: Auto-checks PyPI on every Claude restart (no stale cache)
+```
+
+**WRONG - Do NOT use these:**
+
+```bash
+# ❌ Local scope (only works in one project)
+claude mcp add stravinsky -- uvx stravinsky@latest
+
+# ❌ No @latest (cache never updates, stays on old version)
+claude mcp add --global stravinsky -- uvx stravinsky
+
+# ❌ uv tool install (requires manual upgrades)
+uv tool install stravinsky
+```
+
+**Development (local editable install):**
+
+```bash
+# ONLY for active development on stravinsky source code
+uv tool install --editable /path/to/stravinsky
+claude mcp add --global stravinsky -- stravinsky
+```
+
+### Authentication
+
+```bash
+# Login to Google (Gemini)
+stravinsky-auth login gemini
+
+# Login to OpenAI (ChatGPT Plus/Pro required)
+stravinsky-auth login openai
+
+# Check status
+stravinsky-auth status
+
+# Logout
+stravinsky-auth logout gemini
+```
+
+### Slash Commands
+
+Slash commands are discovered from:
+- Project-local: `.claude/commands/**/*.md` (recursive)
+- User-global: `~/.claude/commands/**/*.md` (recursive)
+
+Commands can be organized in subdirectories (e.g., `.claude/commands/strav/stravinsky.md`).
+
+## Native Subagent Architecture
+
+Stravinsky uses **native Claude Code subagents** (.claude/agents/) with automatic delegation:
+
+### How It Works
+
+1. **Auto-Delegation**: Claude Code automatically delegates complex tasks to the Stravinsky orchestrator
+2. **Hook-Based Control**: PreToolUse hooks intercept direct tool calls and enforce delegation patterns
+3. **Parallel Execution**: Task tool enables true parallel execution of specialist agents
+4. **Multi-Model Routing**: Specialists use invoke_gemini/openai MCP tools for multi-model access
+
+### Agent Types
+
+| Agent | Model | Cost | Use For |
+|-------|-------|------|---------|
+| **stravinsky** | Claude Sonnet 4.5 (32k thinking) | Moderate | Auto-delegating orchestrator (primary) |
+| **explore** | Gemini 3 Flash (via MCP) | Free | Code search, always async |
+| **dewey** | Gemini 3 Flash + WebSearch | Cheap | Documentation research, always async |
+| **code-reviewer** | Claude Sonnet (native) | Cheap | Quality analysis, always async |
+| **debugger** | Claude Sonnet (native) | Medium | Root cause (after 2+ failures) |
+| **frontend** | Gemini 3 Pro High (via MCP) | Medium | ALL visual changes (blocking) |
+| **delphi** | GPT-5.2 Medium (via MCP) | Expensive | Architecture (after 3+ failures) |
+
+### Delegation Rules (oh-my-opencode Pattern)
+
+- **Always Async**: explore, dewey, code-reviewer (free/cheap)
+- **Blocking**: debugger (2+ failures), frontend (ALL visual), delphi (3+ failures or architecture)
+- **Never Work Alone**: Orchestrator blocks Read/Grep/Bash via PreToolUse hooks
+
+### ULTRATHINK / ULTRAWORK
+
+- **ULTRATHINK**: Engage exhaustive deep reasoning with extended thinking budget (32k tokens)
+- **ULTRAWORK**: Maximum parallel execution - spawn all async agents immediately
+````
+
+## Tools (38)
+
+| Category         | Tools                                                                              |
+| ---------------- | ---------------------------------------------------------------------------------- |
+| **Model Invoke** | `invoke_gemini`, `invoke_openai`, `get_system_health`                              |
+| **Environment**  | `get_project_context`, `task_spawn`, `task_status`, `task_list`                    |
+| **Agents**       | `agent_spawn`, `agent_output`, `agent_cancel`, `agent_list`, `agent_progress`, `agent_retry` |
+| **Code Search**  | `ast_grep_search`, `ast_grep_replace`, `grep_search`, `glob_files`                 |
+| **Semantic**     | `semantic_search`, `semantic_index`, `semantic_stats`                              |
+| **LSP**          | `lsp_diagnostics`, `lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, `lsp_document_symbols`, `lsp_workspace_symbols`, `lsp_prepare_rename`, `lsp_rename`, `lsp_code_actions`, `lsp_code_action_resolve`, `lsp_extract_refactor`, `lsp_servers` (12 tools) |
+| **Sessions**     | `session_list`, `session_read`, `session_search`                                   |
+| **Skills**       | `skill_list`, `skill_get`                                                          |
+
+### LSP Performance & Refactoring
+
+The Phase 2 update introduced the `LSPManager`, which maintains persistent language server instances:
+
+- **35x Speedup**: Subsequent LSP calls are near-instant because the server no longer needs to re-initialize and re-index the codebase for every request
+- **Code Refactoring**: New support for `lsp_extract_refactor` allows automated code extraction (e.g., extracting a method or variable) with full symbol resolution
+- **Code Actions**: `lsp_code_action_resolve` enables complex, multi-step refactoring workflows with automatic fixes for diagnostics
+
+### Semantic Code Search
+
+Natural language code search powered by embeddings. Find code by meaning, not just keywords.
+
+**Prerequisites:**
+
+```bash
+# Install Ollama (default provider - free, local)
+brew install ollama
+
+# Pull the recommended lightweight embedding model (274MB)
+ollama pull nomic-embed-text
+
+# Or for better accuracy (670MB, slower):
+ollama pull mxbai-embed-large
+```
+
+**Recommended model:** `nomic-embed-text` is lightweight (274MB), fast, and works great for code search. It's the best choice for most users, especially on space-constrained systems like MacBooks.
+
+**Workflow:**
+
+```bash
+# STEP 1: Initial indexing (REQUIRED - run once per project)
+semantic_index(project_path=".", provider="ollama")
+
+# STEP 2: Enable auto-updates (OPTIONAL - recommended for active projects)
+start_file_watcher(".", provider="ollama", debounce_seconds=2.0)
+
+# STEP 3: Search your codebase with natural language
+semantic_search(query="OAuth authentication logic", n_results=5)
+semantic_stats()  # View index statistics
+
+# STEP 4: Stop watching when done (optional - watcher cleans up on exit)
+stop_file_watcher(".")
+```
+
+**⚠️ Important:** You MUST run `semantic_index()` first before using semantic search or starting the FileWatcher. If you skip this step:
+- `semantic_search()` will return no results
+- `start_file_watcher()` will show a warning but still work (indexes on first file change)
+
+**Example queries:**
+- "find authentication logic"
+- "error handling in API endpoints"
+- "database connection pooling"
+
+**Providers:**
+
+| Provider | Model | Size | Cost | Setup |
+|----------|-------|------|------|-------|
+| `ollama` (default) | nomic-embed-text (recommended) | 274MB | Free/local | `ollama pull nomic-embed-text` |
+| `ollama` | mxbai-embed-large (advanced) | 670MB | Free/local | `ollama pull mxbai-embed-large` |
+| `gemini` | gemini-embedding-001 | N/A | OAuth/cloud | `stravinsky-auth login gemini` |
+| `openai` | text-embedding-3-small | N/A | OAuth/cloud | `stravinsky-auth login openai` |
+
+**Technical details:**
+- **AST-aware chunking**: Python files split by functions/classes for better semantic boundaries
+- **Persistent storage**: ChromaDB at `~/.stravinsky/vectordb/<project>_<provider>/`
+- **Async parallel embeddings**: 10 concurrent for fast indexing
+- **Automatic file watching**: Background reindexing on code changes with configurable debouncing (2s default)
+
+## Native Subagents (9)
+
+Configured in `.claude/agents/*.md`:
+
+| Agent            | Purpose                                                               | Location |
+| ---------------- | --------------------------------------------------------------------- | -------- |
+| `stravinsky`     | Task orchestration with 32k extended thinking (Sonnet 4.5)            | .claude/agents/stravinsky.md |
+| `research-lead`  | Research coordinator - spawns explore/dewey, synthesizes findings (Gemini Flash) | .claude/agents/research-lead.md |
+| `implementation-lead` | Implementation coordinator - spawns frontend/debugger/reviewer (Haiku) | .claude/agents/implementation-lead.md |
+| `explore`        | Codebase search and structural analysis (Gemini 3 Flash)              | .claude/agents/explore.md |
+| `dewey`          | Documentation research and web search (Gemini 3 Flash)                | .claude/agents/dewey.md |
+| `code-reviewer`  | Security, quality, and best practice analysis (Claude Sonnet)         | .claude/agents/code-reviewer.md |
+| `debugger`       | Root cause analysis and fix strategies (Claude Sonnet)                | .claude/agents/debugger.md |
+| `frontend`       | UI/UX implementation with creative generation (Gemini 3 Pro High)     | .claude/agents/frontend.md |
+| `delphi`         | Strategic architecture advisor with 32k thinking (GPT-5.2 Medium)     | .claude/agents/delphi.md |
+
+## Development
+
+```bash
+# Install in development mode
+uv pip install -e .
+
+# Run server
+stravinsky
+```
+
+## Project Structure
+
+```
+stravinsky/
+├── .claude/                      # Claude Code configuration
+│   ├── agents/                   # Native subagent configurations (7 agents)
+│   │   ├── stravinsky.md         # Orchestrator (auto-delegated)
+│   │   ├── explore.md            # Code search specialist
+│   │   ├── dewey.md              # Documentation research
+│   │   ├── code-reviewer.md      # Quality analysis
+│   │   ├── debugger.md           # Root cause analysis
+│   │   ├── frontend.md           # UI/UX specialist
+│   │   ├── delphi.md             # Strategic advisor (GPT-5.2)
+│   │   └── HOOKS.md              # Hook architecture guide
+│   ├── commands/                 # Slash commands (skills)
+│   │   ├── stravinsky.md         # /stravinsky orchestrator
+│   │   ├── delphi.md             # /delphi strategic advisor
+│   │   ├── dewey.md              # /dewey documentation research
+│   │   ├── publish.md            # /publish PyPI release
+│   │   ├── review.md             # /review code review
+│   │   ├── verify.md             # /verify post-implementation
+│   │   └── version.md            # /version diagnostic info
+│   ├── hooks/                    # Native Claude Code hooks (11 hooks)
+│   │   ├── stravinsky_mode.py    # PreToolUse delegation enforcer
+│   │   ├── context.py            # UserPromptSubmit context injection
+│   │   ├── todo_continuation.py  # UserPromptSubmit todo continuation
+│   │   ├── truncator.py          # PostToolUse output truncation
+│   │   ├── tool_messaging.py     # PostToolUse user messaging
+│   │   ├── edit_recovery.py      # PostToolUse edit backup
+│   │   ├── todo_delegation.py    # PostToolUse parallel reminder
+│   │   ├── parallel_execution.py # PostToolUse parallel enforcement
+│   │   ├── notification_hook.py  # PreToolUse agent spawn notifications
+│   │   ├── subagent_stop.py      # PostToolUse agent completion handling
+│   │   └── pre_compact.py        # PreCompact context preservation
+│   ├── skills/                   # Skill library (empty, skills in commands/)
+│   ├── settings.json             # Hook configuration
+│   └── HOOKS_INTEGRATION.md      # Hook integration guide
+├── mcp_bridge/                   # Python MCP server
+│   ├── server.py                 # MCP server entry point
+│   ├── server_tools.py           # Tool definitions
+│   ├── auth/                     # OAuth authentication
+│   │   ├── oauth.py              # Google OAuth (Gemini)
+│   │   ├── openai_oauth.py       # OpenAI OAuth (ChatGPT)
+│   │   ├── token_store.py        # Keyring storage
+│   │   ├── token_refresh.py      # Auto-refresh tokens
+│   │   └── cli.py                # stravinsky-auth CLI
+│   ├── tools/                    # MCP tool implementations
+│   │   ├── model_invoke.py       # invoke_gemini, invoke_openai
+│   │   ├── agent_manager.py      # agent_spawn, agent_output, etc.
+│   │   ├── code_search.py        # ast_grep, grep, glob
+│   │   ├── semantic_search.py    # semantic_search, semantic_index, semantic_stats
+│   │   ├── session_manager.py    # session_list, session_read, etc.
+│   │   ├── skill_loader.py       # skill_list, skill_get
+│   │   ├── project_context.py    # get_project_context
+│   │   ├── lsp/                  # LSP tool implementations
+│   │   └── templates.py          # Project templates
+│   ├── prompts/                  # Agent system prompts (legacy CLI)
+│   │   ├── stravinsky.py         # Legacy orchestrator prompt
+│   │   ├── delphi.py             # Legacy advisor prompt
+│   │   ├── dewey.py              # Legacy research prompt
+│   │   ├── explore.py            # Legacy search prompt
+│   │   ├── frontend.py           # Legacy UI/UX prompt
+│   │   └── multimodal.py         # Multimodal analysis prompt
+│   ├── hooks/                    # MCP internal hooks (17+ hooks)
+│   │   ├── manager.py            # Hook orchestration
+│   │   ├── truncator.py          # Output truncation
+│   │   ├── parallel_enforcer.py  # Parallel execution
+│   │   ├── todo_enforcer.py      # Todo continuation
+│   │   └── ...                   # 13+ more optimization hooks
+│   ├── native_hooks/             # Native Claude Code hooks
+│   │   ├── stravinsky_mode.py    # PreToolUse delegation enforcer
+│   │   ├── tool_messaging.py     # PostToolUse user messaging
+│   │   ├── todo_delegation.py    # TodoWrite parallel reminder
+│   │   ├── todo_continuation.py  # UserPromptSubmit todo injection
+│   │   ├── context.py            # UserPromptSubmit context
+│   │   ├── truncator.py          # PostToolUse truncation
+│   │   └── edit_recovery.py      # PostToolUse backup
+│   ├── cli/                      # CLI utilities
+│   │   └── session_report.py     # Session analysis
+│   ├── config/                   # Configuration
+│   │   └── hooks.py              # Hook configuration
+│   └── utils/                    # Utility functions
+├── .stravinsky/                  # Agent execution logs (gitignored)
+├── assets/                       # Logo, images
+├── docs/                         # Additional documentation
+├── logs/                         # Application logs
+├── tests/                        # Test suite
+├── pyproject.toml                # Build configuration
+├── uv.lock                       # Dependency lock
+├── ARCHITECTURE.md               # Architecture guide (oh-my-opencode comparison)
+├── CLAUDE.md                     # Project instructions
+├── INSTALL.md                    # Installation guide
+└── README.md                     # This file
+```
+
+## Troubleshooting
+
+### OpenAI "Port 1455 in use"
+
+The Codex CLI uses the same port. Stop it with: `killall codex`
+
+### OpenAI Authentication Failed
+
+- Ensure you have a ChatGPT Plus/Pro subscription
+- Tokens expire occasionally; run `stravinsky-auth login openai` to refresh
+
+### Claude Code Not Loading Latest Version After Update
+
+**Problem:** After deploying a new version to PyPI, Claude Code still uses the old cached version even after restart.
+
+**Root Cause:** `uvx` caches packages and doesn't automatically check for updates. This is a known uvx behavior that affects all packages, not just Stravinsky.
+
+**Solution - Force Reinstall:**
+
+```bash
+# Option 1: Run latest version with uvx (if using uvx in .mcp.json)
+uvx stravinsky@latest
+
+# Option 2: Upgrade with uv tool (if installed globally)
+uv tool install --upgrade --force stravinsky
+# or reinstall all tools:
+uv tool upgrade --all --reinstall
+
+# Option 3: Clear uvx cache entirely (nuclear option)
+uv cache prune
+
+# Option 4: Remove and re-add MCP server
+claude mcp remove stravinsky
+claude mcp add stravinsky -- uvx stravinsky@latest
+
+# After any option, restart Claude Code
+claude restart
+```
+
+**Verify Version:**
+
+```bash
+# Check installed version
+stravinsky --version
+# or
+python -c "import mcp_bridge; print(mcp_bridge.__version__)"
+
+# Check PyPI latest version
+curl -s https://pypi.org/pypi/stravinsky/json | python -c "import sys, json; print(json.load(sys.stdin)['info']['version'])"
+```
+
+## License
+
+MIT
+
+---

stravinsky-0.3.4.dist-info/RECORD

@@ -0,0 +1,79 @@
+mcp_bridge/__init__.py,sha256=oYLGMpySamd16KLiaBTfRyrAS7_oyp-TOEHmzmeumwg,22
+mcp_bridge/notifications.py,sha256=C4qPvGD1NnAsU_ukwbiqWdo7cA6ScU0qGhjie3vPpjM,5134
+mcp_bridge/server.py,sha256=kRt9BfPSM1AOc_jvfe9XFTBsR9zTr9jLdQaPcPCApLU,29476
+mcp_bridge/server_tools.py,sha256=dbhnz17VuoNv_dtS75uSNKctiKnjV7aFHs_dXr0M5Js,45070
+mcp_bridge/auth/__init__.py,sha256=AGHNtKzqvZYMLQ35Qg6aOabpxBqmkR-pjXv8Iby9oMw,797
+mcp_bridge/auth/cli.py,sha256=jaXyrzq6HwnW61g6CHHcj8bF5PJLYrYufD_jmN0jeiQ,8502
+mcp_bridge/auth/oauth.py,sha256=gWYk3KJWbUM1J5AKVDJ_4k4zdQzwwaYJZ5J25If0r8c,12804
+mcp_bridge/auth/openai_oauth.py,sha256=0Ks2X-NXLCBzqs3xnbj9QLZpugICOX5qB5y5vtDENOo,11522
+mcp_bridge/auth/token_refresh.py,sha256=goWp1Wz3yWOoFuxvFMDZLjo8gLPXcajZxHpzZtSoKcQ,3760
+mcp_bridge/auth/token_store.py,sha256=3A6TZJ7Wju6QfhALeX4IMhY5jzb9OWMrDzwRbfAukiU,5650
+mcp_bridge/cli/__init__.py,sha256=J1cFw06fYSm3uU7cbEj3GgWuDxTn1X0cDhPi1gJq7eM,200
+mcp_bridge/cli/install_hooks.py,sha256=cmLctih9xie1iaY8uyzO11egvEkpMa7Zc-Nyb5dITlg,36955
+mcp_bridge/cli/session_report.py,sha256=sYUje44R4qIwxML_GCaEyJwz4jgis4sZOwTDZGQJ3MM,22198
+mcp_bridge/config/__init__.py,sha256=uapHdrSWWrafVKD9CTB1J_7Dw0_RajRhoDGjy9zH21o,256
+mcp_bridge/config/hooks.py,sha256=WvWC6ZUc8y1IXPlGCjLYAAsGGigd5tWeGiw585OGNwA,4624
+mcp_bridge/hooks/HOOKS_SETTINGS.json,sha256=IY47eGigQwTaQ0XwM2NzVopGBga3Zaocmq09I1M1inw,6434
+mcp_bridge/hooks/README.md,sha256=ocKp2BE6U4o8OhnA4dbXoth8A9YD8MYQLi5uXw7bLEo,7549
+mcp_bridge/hooks/__init__.py,sha256=_R8Qbz7puDeQ_LWwKLSU_GKnxdA1JyESEihM1PM5HFo,3946
+mcp_bridge/hooks/agent_reminder.py,sha256=OxKPxi7e2MIBm44Ebzzl9j9fDV5bBgogGF0lj7wun5s,1913
+mcp_bridge/hooks/auto_slash_command.py,sha256=LUndZHxUzEF7PQuOdp3v7VfqNUgsiDE2gzI_TkR9he4,5280
+mcp_bridge/hooks/budget_optimizer.py,sha256=Im0qSGVUdRByk04hP5VyKt7tjlDVYG0LJb6IeUjjnj8,1323
+mcp_bridge/hooks/comment_checker.py,sha256=MslXZYiHjfxjUU7VzmZfa1n2WR9o4lnaktJ6eUPBUDs,3772
+mcp_bridge/hooks/compaction.py,sha256=UXTwmyo9C4Jm3j72KvVU11ukSAHaGaTey_h3L43e3rY,1186
+mcp_bridge/hooks/context.py,sha256=JBHqnX75qtMO3JAEFooBEAK6DxcsVaXykhrP7tdFm6E,949
+mcp_bridge/hooks/context_monitor.py,sha256=IEr75e_gqbPEUslxxfkwftiy6alDmJxQhSB6cy8BVg4,1885
+mcp_bridge/hooks/directory_context.py,sha256=0VjdJITJIGUqR4-q-wZlB6kmkFQMraaFvU2Nz2PnJCM,1225
+mcp_bridge/hooks/edit_recovery.py,sha256=1OWpb3v87txFUsgnNe1hoeTI7rIKCkKYONld5BK1TyA,1503
+mcp_bridge/hooks/empty_message_sanitizer.py,sha256=iZZnETju1wBvJXV1k4msV8FxLNg5LkVm2eaFA2nQWxI,6606
+mcp_bridge/hooks/git_noninteractive.py,sha256=1VETo7Gf76NYEx_J7RxA52wYnlj5wiOwFL9lSMdshEM,2864
+mcp_bridge/hooks/keyword_detector.py,sha256=w7wW8dYYKiHpmgMYJtWw2MJd0ly631C7rFVWtC_kkq8,6105
+mcp_bridge/hooks/manager.py,sha256=SG08soeyHSzfl9NE9yX2x5B_NEbv9LxJnmRBUaOhGfE,5835
+mcp_bridge/hooks/notification_hook.py,sha256=GElHxaIn0BF935IXuRQjYERk7W_msBiCm0UwutumdiM,2770
+mcp_bridge/hooks/parallel_enforcer.py,sha256=qzPB7PX22Laz6yC3MCbAmYBhP59P9ac6WHpgXOABOuQ,3651
+mcp_bridge/hooks/parallel_execution.py,sha256=nIINPRm-1P1dci3lTCacJKN_4NIkm9IyTrVx-rmbXl4,3602
+mcp_bridge/hooks/pre_compact.py,sha256=QXcCO9kByn8Ta27NWoQP8IPPUa379KO4qb1BBLzfzuU,3398
+mcp_bridge/hooks/preemptive_compaction.py,sha256=x4-dLWCconVFD-nR93P1EB_tG9n4LHdESq7uDFS3ut8,7937
+mcp_bridge/hooks/rules_injector.py,sha256=jZN9_b464ATEKAFJvIlIVKT-UvcoNAuZGDI4TmJ0Uxc,16485
+mcp_bridge/hooks/session_idle.py,sha256=5wo6XakXglWVCP-HN1i976OptfntwCNnbjxoM--veh4,3525
+mcp_bridge/hooks/session_notifier.py,sha256=dkrSwRquMbcCRuUCsBVqUY6cHSGDO2UuPWKTNf6Y7fc,3750
+mcp_bridge/hooks/session_recovery.py,sha256=c5eoIWJAgMTPY0wq_64MmCUNLCB_GSowZlA3lo4R9LU,6260
+mcp_bridge/hooks/stravinsky_mode.py,sha256=ru9vg5m1QjhK0ABwopC68S2Gzy2-sEW1b1AbveFO57o,4066
+mcp_bridge/hooks/subagent_stop.py,sha256=GUPY3FNVAtsc6J4PbddSRK9XuDs-gw2CaFoGXt5gsME,2865
+mcp_bridge/hooks/task_validator.py,sha256=YSeUWbtwjA-oWCrOVS5DTRxu9_0VTgzpF2mf-QIIw9E,2183
+mcp_bridge/hooks/tmux_manager.py,sha256=vXU0o612PrJ8Xb0IMq4qnEY3i_Z1sT_E-56SqalmrQA,4125
+mcp_bridge/hooks/todo_continuation.py,sha256=tmhTVfMZMDuDw4cwyuU7r_TkUqmtAx55u0WNTawgMyo,2652
+mcp_bridge/hooks/todo_delegation.py,sha256=tOAE1RYAPSH8UOeO8Vsk7sdLf9H4GmXE2lbc_GGjlYI,2676
+mcp_bridge/hooks/todo_enforcer.py,sha256=LRvVxYILqQ6YuQl3tky4hgyD-irXIPDE5e0EdKr6jcc,2274
+mcp_bridge/hooks/tool_messaging.py,sha256=Zfmny1w4wS-KHaFbZG2peaXIyejff5Qyt5RbbalrekU,5705
+mcp_bridge/hooks/truncator.py,sha256=h3hb8sZXTvc59C0-5GdZwCVZHlxBKdo47JT9TMxHG3g,530
+mcp_bridge/prompts/__init__.py,sha256=wzveum1x50IXGkE0JFpvHAj8P0yqnSrgtrmyIIpnnBI,358
+mcp_bridge/prompts/delphi.py,sha256=ZlnLY2o1PrK3CxLLaCkozAGPIAJ5OFmw5u8o6-LXmgI,4960
+mcp_bridge/prompts/dewey.py,sha256=u5OaOj8kinZERflWvUv4M4WVAwxw0kJrNT00wHksIHI,9264
+mcp_bridge/prompts/document_writer.py,sha256=hiCbxgTU8HKPJkS0eNpPPtzSqDXPreApU2OqiS6zh-0,5618
+mcp_bridge/prompts/explore.py,sha256=oZxh4fe4KNGa_ozakJSpLYeQVfO4-jQ2M1BSOw1Sw10,5801
+mcp_bridge/prompts/frontend.py,sha256=j91I8k5vcVed13eeX-Ebiv49x9Qj4HO_SQN1xhB8TLQ,4943
+mcp_bridge/prompts/multimodal.py,sha256=Q_rutR7r5iBcLViVfdLxoukCQe2OA0lDJhxkoo0OSMw,2692
+mcp_bridge/prompts/planner.py,sha256=wcdXIxPlZM0UYd9KQSKXnuXTRj2acSnqlqeQ_NxxEqw,6985
+mcp_bridge/prompts/stravinsky.py,sha256=gJgzMgsa6u0fLbFWOkPY2lq78-yJTuD46wrnk-5rem0,27498
+mcp_bridge/tools/__init__.py,sha256=SRnMaUni0BhlvCABBEYeyveNiOAMQPNBXmjUKG6aXQA,1150
+mcp_bridge/tools/agent_manager.py,sha256=PUiP0VJ-Ntu7f9-mq0mfWRMVU39-tIDJ-kNM7L4M-jE,35827
+mcp_bridge/tools/background_tasks.py,sha256=bwbVYWCDzuXb3Q_OdIr10r76lgjFTphfjdTmOHYZI7w,5252
+mcp_bridge/tools/code_search.py,sha256=xawUBapNSCp1lL_LESsiiVU6fno1iFeSji2Ke5WAO6M,13170
+mcp_bridge/tools/continuous_loop.py,sha256=MM3FnF3ULuR32h0tqJP8uF48iJg6R9dbyHy_36KLOls,2100
+mcp_bridge/tools/init.py,sha256=sU95M9M_tjsfuew389TrFrxxeCavuSC16qbkydk_6PU,1586
+mcp_bridge/tools/model_invoke.py,sha256=chWma7C2ZKew4sb_dyoW7iH8F31p87hruM7i_N3U32U,35669
+mcp_bridge/tools/project_context.py,sha256=bXKxuW1pGjtIbeNjMgpBoQL-d_CI94UPBVpRjUyhX20,4707
+mcp_bridge/tools/semantic_search.py,sha256=t45D7LlMmTpvLew-TpHU2hYNEyWiLhWRkXQaw_ssMH8,87056
+mcp_bridge/tools/session_manager.py,sha256=tCVLLvO-Kttla7OxPImb_NSGL_9aW46ilq5ej_IcnlA,9252
+mcp_bridge/tools/skill_loader.py,sha256=RQ5eC357pm-6q85G3EyrQugz0S3OO5lxWtM9n9ECF-c,6010
+mcp_bridge/tools/task_runner.py,sha256=xjE3MXv62gcUCwOEwHjAGL_Ud_ZlKFBN0UHpvFjj3uk,3918
+mcp_bridge/tools/templates.py,sha256=ANsSXGFKvc7NR58jbmR7SejlbBQucqXZi4DYagYz3CQ,7008
+mcp_bridge/tools/lsp/__init__.py,sha256=v-2OENfPrZxglAwpbooH3rFjcZDmhAMXEFZhygwq3II,753
+mcp_bridge/tools/lsp/manager.py,sha256=DR0XDDL0ElKsf8I3iqJIXhV4oX25Kh2QoPLGGtpgM7o,16272
+mcp_bridge/tools/lsp/tools.py,sha256=DANgPzp52vPomBAEnwOU9YZiNowz9yWQZGLQZ1wXTeY,34521
+mcp_bridge/utils/__init__.py,sha256=pbHV4nq5SLUYcAyTmLUZYrp293Ctud57X8hwsMGA_BM,20
+stravinsky-0.3.4.dist-info/METADATA,sha256=j29JYRyoH1mxUbZVx6bQ158hL78XHiPzSDMrwamKkUQ,19875
+stravinsky-0.3.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+stravinsky-0.3.4.dist-info/entry_points.txt,sha256=MB1dqHW9dx-ae0-cDi6fYEY9HtyzbyB5VhJxza0wDDc,215
+stravinsky-0.3.4.dist-info/RECORD,,

stravinsky-0.3.4.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+stravinsky = mcp_bridge.server:main
+stravinsky-auth = mcp_bridge.auth.cli:main
+stravinsky-install-hooks = mcp_bridge.cli.install_hooks:main
+stravinsky-sessions = mcp_bridge.cli.session_report:main

mcp_bridge/native_hooks/edit_recovery.py

@@ -1,46 +0,0 @@
-import os
-import sys
-import json
-import re
-
-def main():
-    # Claude Code PostToolUse inputs via Environment Variables
-    tool_name = os.environ.get("CLAUDE_TOOL_NAME")
-    
-    # We only care about Edit/MultiEdit
-    if tool_name not in ["Edit", "MultiEdit"]:
-        return
-
-    # Read from stdin (Claude Code passes the tool response via stdin for some hook types, 
-    # but for PostToolUse it's often better to check the environment variable if available.
-    # Actually, the summary says input is a JSON payload.
-    try:
-        data = json.load(sys.stdin)
-        tool_response = data.get("tool_response", "")
-    except Exception:
-        # Fallback to direct string if not JSON
-        return
-
-    # Error patterns
-    error_patterns = [
-        r"oldString not found",
-        r"oldString matched multiple times",
-        r"line numbers out of range"
-    ]
-
-    recovery_needed = any(re.search(p, tool_response, re.IGNORECASE) for p in error_patterns)
-
-    if recovery_needed:
-        correction = (
-            "\n\n[SYSTEM RECOVERY] It appears the Edit tool failed to find the target string. "
-            "Please call 'Read' on the file again to verify the current content, "
-            "then ensure your 'oldString' is an EXACT match including all whitespace."
-        )
-        # For PostToolUse, stdout is captured and appended/replaces output
-        print(tool_response + correction)
-    else:
-        # No change
-        print(tool_response)
-
-if __name__ == "__main__":
-    main()

mcp_bridge/native_hooks/truncator.py

@@ -1,23 +0,0 @@
-import os
-import sys
-import json
-
-MAX_CHARS = 30000
-
-def main():
-    try:
-        data = json.load(sys.stdin)
-        tool_response = data.get("tool_response", "")
-    except Exception:
-        return
-
-    if len(tool_response) > MAX_CHARS:
-        header = f"[TRUNCATED - {len(tool_response)} chars reduced to {MAX_CHARS}]\n"
-        footer = "\n...[TRUNCATED]"
-        truncated = tool_response[:MAX_CHARS]
-        print(header + truncated + footer)
-    else:
-        print(tool_response)
-
-if __name__ == "__main__":
-    main()