stravinsky 0.2.11__tar.gz

stravinsky-0.2.11/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*" # Trigger on version tags like v0.2.9
+  workflow_dispatch: # Allow manual trigger
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # Required for trusted publishing
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          # Uses trusted publishing - no token needed if configured on PyPI
+          # Fallback to token if trusted publishing not set up:
+          password: ${{ secrets.PYPI_API_TOKEN }}

stravinsky-0.2.11/.gitignore

@@ -0,0 +1,35 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.env
+.venv
+env/
+venv/
+stravinsky/
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+.gemini/
+.claude/
+# .mcp.json
+# uv.lock

stravinsky-0.2.11/.mcp.json

@@ -0,0 +1,3 @@
+{
+  "mcpServers": {}
+}

stravinsky-0.2.11/.stravinsky/agents/agent_9b9fd4f0.out

@@ -0,0 +1 @@
+There are **27 `.py` files** in `./mcp_bridge`.

stravinsky-0.2.11/.stravinsky/agents.json

@@ -0,0 +1 @@
+{}

stravinsky-0.2.11/CLAUDE.md

@@ -0,0 +1,192 @@
+# Stravinsky - MCP Bridge (Claude Code Bridge)
+
+**Claude Code MCP server** for multi-model orchestration with OAuth authentication.
+
+## Commands
+
+### Authentication
+
+```bash
+# Login
+stravinsky-auth login gemini
+stravinsky-auth login openai
+
+# Status
+stravinsky-auth status
+
+# Logout
+stravinsky-auth logout gemini
+```
+
+## Setup in Claude Code
+
+### Installation
+
+**Option 1: From PyPI (Recommended)**
+
+```bash
+# One-shot installation with uvx
+claude mcp add stravinsky -- uvx stravinsky
+
+# Or install globally first
+uv tool install stravinsky
+claude mcp add stravinsky -- stravinsky
+```
+
+**Option 2: From Source (Development)**
+
+```bash
+# Install from local source
+uv tool install --editable .
+claude mcp add stravinsky -- stravinsky
+```
+
+### Slash Commands (Skills)
+
+- `/stravinsky`: Task Orchestrator & Planner
+- `/delphi`: Architecture & Debug Advisor
+- `/dewey`: Documentation & Research
+- `/context`: Refresh Git/Rules/Todo context
+- `/health`: Comprehensive system check
+
+## OAuth Flows
+
+### Gemini (Google Antigravity)
+
+- Browser-based OAuth 2.0 with PKCE
+- Uses same credentials as Stravinsky
+- Supports automatic token refresh
+
+### OpenAI (ChatGPT Plus/Pro)
+
+- Browser-based OAuth on port 1455 (same as Codex CLI)
+- Requires ChatGPT Plus/Pro subscription
+- Supports automatic token refresh
+
+## Tools (31)
+
+| 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`      |
+| **Code Search**  | `ast_grep_search`, `ast_grep_replace`, `grep_search`, `glob_files`                 |
+| **LSP**          | `lsp_diagnostics`, `lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, etc. |
+| **Sessions**     | `session_list`, `session_read`, `session_search`                                   |
+| **Skills**       | `skill_list`, `skill_get`                                                          |
+
+### Agent Tools
+
+Spawn background agents with **full tool access** via Claude Code CLI:
+
+- `agent_spawn(prompt, agent_type, description)` - Launch background agent
+- `agent_output(task_id, block)` - Get output (block=true to wait)
+- `agent_progress(task_id, lines)` - Real-time progress monitoring
+- `agent_cancel(task_id)` - Cancel running agent
+- `agent_list()` - List all agent tasks
+
+### LSP Tools (10)
+
+Full Language Server Protocol support for Python (via jedi):
+
+- `lsp_hover` - Type info and docs at position
+- `lsp_goto_definition` - Jump to symbol definition
+- `lsp_find_references` - Find all usages
+- `lsp_document_symbols` - File outline
+- `lsp_workspace_symbols` - Search symbols by name
+- `lsp_prepare_rename` - Validate rename
+- `lsp_rename` - Rename symbol across workspace
+- `lsp_code_actions` - Quick fixes and refactorings
+- `lsp_servers` - List available LSP servers
+- `lsp_diagnostics` - Errors and warnings
+
+### AST-Grep Tools
+
+- `ast_grep_search` - AST-aware code pattern search
+- `ast_grep_replace` - AST-aware code replacement
+
+## Agent Prompts (7)
+
+| Prompt            | Purpose                                                       |
+| ----------------- | ------------------------------------------------------------- |
+| `stravinsky`      | Task orchestration, planning, and goal-oriented execution.    |
+| `delphi`          | Strategic technical advisor (GPT-based) for hard debugging.   |
+| `dewey`           | Documentation and multi-repository research specialist.       |
+| `explore`         | Specialized for codebase-wide search and structural analysis. |
+| `frontend`        | UI/UX Engineer (Gemini-optimized) for component prototyping.  |
+| `document_writer` | Technical documentation and specification writer.             |
+| `multimodal`      | Visual analysis expert for UI screenshots and diagrams.       |
+
+## Project Structure
+
+```
+stravinsky/
+├── mcp_bridge/           # Python MCP server
+│   ├── server.py         # Entry point
+│   ├── auth/             # OAuth (Google & OpenAI)
+│   ├── tools/            # Model invoke, search, skills
+│   ├── prompts/          # Agent system prompts (Stravinsky, Delphi, Dewey, etc.)
+│   └── config/           # Bridge configuration
+├── .mcp.json             # Claude Code config
+├── pyproject.toml        # Build system
+└── CLAUDE.md             # This guide
+```
+
+## Architecture
+
+1. **MCP Transport**: Uses standard input/output for interaction with Claude Code.
+2. **Dynamic Tokens**: OAuth tokens are stored in the system keyring and refreshed on demand.
+3. **Specialized Models**:
+   - `invoke_gemini`: Best for UI, images, and creative generation.
+   - `invoke_openai`: Best for complex reasoning and strategic advice.
+4. **Tool Integrity**: All tools match the behavior of the original TypeScript implementation but are ported to native Python for speed and reliability.
+
+## 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 `python -m mcp_bridge.auth.cli login openai` to refresh manually if automatic refresh fails.
+
+## Stravinsky MCP (Parallel Agents)
+
+Use Stravinsky MCP tools. **DEFAULT: spawn parallel agents for multi-step tasks.**
+
+### Agent Tools
+
+- `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
+- `agent_list()` - Overview of all running agents
+- `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 (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
+3.  Monitor with agent_progress, collect with agent_output
+
+### ULTRATHINK / ULTRAWORK
+
+- **ULTRATHINK**: Engage exhaustive deep reasoning, multi-dimensional analysis
+- **ULTRAWORK**: Maximum parallel execution - spawn agents aggressively for every subtask
+
+---
+
+## Learn More
+
+- [PyPI Package](https://pypi.org/project/stravinsky/)
+- [Documentation](https://github.com/GratefulDave/stravinsky)

stravinsky-0.2.11/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: stravinsky
+Version: 0.2.11
+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: 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>=0.19.2
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: mcp>=1.2.1
+Requires-Dist: openai>=1.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pydantic>=2.0.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
+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'
+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
+- 🛠️ **31 MCP Tools** - Model invocation, code search, LSP integrations, session management, and more
+- 🧠 **7 Specialized Agents** - Stravinsky (orchestrator), Delphi (advisor), Dewey (documentation), and more
+- 🔄 **Background Tasks** - Spawn parallel agents with full tool access via Claude Code CLI
+- 📝 **LSP Integration** - Full Language Server Protocol support for Python (jedi)
+- 🔍 **AST-Aware Search** - Structural code search and refactoring with ast-grep
+
+## Quick Start
+
+### Installation
+
+**From PyPI (Recommended):**
+
+```bash
+# One-shot with uvx - no installation needed!
+claude mcp add stravinsky -- uvx stravinsky
+
+# Or install globally first:
+uv tool install stravinsky
+claude mcp add stravinsky -- stravinsky
+```
+
+**From Source (for development):**
+
+```bash
+uv tool install --editable /path/to/stravinsky
+claude mcp add 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
+
+### Repo Auto-Initialization
+
+Bootstrap any repository for Stravinsky in one command:
+
+```bash
+# In the root of your project:
+stravinsky-auth init
+````
+
+This will:
+
+1. Create/Update `CLAUDE.md` with Stravinsky parallel execution rules.
+2. Install standard slash commands into `.claude/commands/stra/`.
+
+````
+
+## Add to Your CLAUDE.md
+
+After installing globally, add this to your project's `CLAUDE.md`:
+
+```markdown
+## Stravinsky MCP (Parallel Agents)
+
+Use Stravinsky MCP tools. **DEFAULT: spawn parallel agents for multi-step tasks.**
+
+### Agent Tools
+
+- `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
+- `agent_list()` - Overview of all running agents
+- `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 (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
+3. Monitor with agent_progress, collect with agent_output
+
+### ULTRATHINK / ULTRAWORK
+
+- **ULTRATHINK**: Engage exhaustive deep reasoning, multi-dimensional analysis
+- **ULTRAWORK**: Maximum parallel execution - spawn agents aggressively for every subtask
+````
+
+## Tools (31)
+
+| 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`      |
+| **Code Search**  | `ast_grep_search`, `ast_grep_replace`, `grep_search`, `glob_files`                 |
+| **LSP**          | `lsp_diagnostics`, `lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, etc. |
+| **Sessions**     | `session_list`, `session_read`, `session_search`                                   |
+| **Skills**       | `skill_list`, `skill_get`                                                          |
+
+## Agent Prompts (7)
+
+| Prompt            | Purpose                                                       |
+| ----------------- | ------------------------------------------------------------- |
+| `stravinsky`      | Task orchestration, planning, and goal-oriented execution.    |
+| `delphi`          | Strategic technical advisor (GPT-based) for hard debugging.   |
+| `dewey`           | Documentation and multi-repository research specialist.       |
+| `explore`         | Specialized for codebase-wide search and structural analysis. |
+| `frontend`        | UI/UX Engineer (Gemini-optimized) for component prototyping.  |
+| `document_writer` | Technical documentation and specification writer.             |
+| `multimodal`      | Visual analysis expert for UI screenshots and diagrams.       |
+
+## Development
+
+```bash
+# Install in development mode
+uv pip install -e .
+
+# Run server
+stravinsky
+```
+
+## Project Structure
+
+```
+stravinsky/
+├── mcp_bridge/           # Python MCP server
+│   ├── server.py         # Entry point
+│   ├── auth/             # OAuth (Google & OpenAI)
+│   ├── tools/            # Model invoke, search, skills
+│   ├── prompts/          # Agent system prompts
+│   └── config/           # Bridge configuration
+├── pyproject.toml        # Build system
+└── 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
+
+## License
+
+MIT
+
+---

stravinsky-0.2.11/README.md

@@ -0,0 +1,178 @@
+<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
+- 🛠️ **31 MCP Tools** - Model invocation, code search, LSP integrations, session management, and more
+- 🧠 **7 Specialized Agents** - Stravinsky (orchestrator), Delphi (advisor), Dewey (documentation), and more
+- 🔄 **Background Tasks** - Spawn parallel agents with full tool access via Claude Code CLI
+- 📝 **LSP Integration** - Full Language Server Protocol support for Python (jedi)
+- 🔍 **AST-Aware Search** - Structural code search and refactoring with ast-grep
+
+## Quick Start
+
+### Installation
+
+**From PyPI (Recommended):**
+
+```bash
+# One-shot with uvx - no installation needed!
+claude mcp add stravinsky -- uvx stravinsky
+
+# Or install globally first:
+uv tool install stravinsky
+claude mcp add stravinsky -- stravinsky
+```
+
+**From Source (for development):**
+
+```bash
+uv tool install --editable /path/to/stravinsky
+claude mcp add 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
+
+### Repo Auto-Initialization
+
+Bootstrap any repository for Stravinsky in one command:
+
+```bash
+# In the root of your project:
+stravinsky-auth init
+````
+
+This will:
+
+1. Create/Update `CLAUDE.md` with Stravinsky parallel execution rules.
+2. Install standard slash commands into `.claude/commands/stra/`.
+
+````
+
+## Add to Your CLAUDE.md
+
+After installing globally, add this to your project's `CLAUDE.md`:
+
+```markdown
+## Stravinsky MCP (Parallel Agents)
+
+Use Stravinsky MCP tools. **DEFAULT: spawn parallel agents for multi-step tasks.**
+
+### Agent Tools
+
+- `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
+- `agent_list()` - Overview of all running agents
+- `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 (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
+3. Monitor with agent_progress, collect with agent_output
+
+### ULTRATHINK / ULTRAWORK
+
+- **ULTRATHINK**: Engage exhaustive deep reasoning, multi-dimensional analysis
+- **ULTRAWORK**: Maximum parallel execution - spawn agents aggressively for every subtask
+````
+
+## Tools (31)
+
+| 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`      |
+| **Code Search**  | `ast_grep_search`, `ast_grep_replace`, `grep_search`, `glob_files`                 |
+| **LSP**          | `lsp_diagnostics`, `lsp_hover`, `lsp_goto_definition`, `lsp_find_references`, etc. |
+| **Sessions**     | `session_list`, `session_read`, `session_search`                                   |
+| **Skills**       | `skill_list`, `skill_get`                                                          |
+
+## Agent Prompts (7)
+
+| Prompt            | Purpose                                                       |
+| ----------------- | ------------------------------------------------------------- |
+| `stravinsky`      | Task orchestration, planning, and goal-oriented execution.    |
+| `delphi`          | Strategic technical advisor (GPT-based) for hard debugging.   |
+| `dewey`           | Documentation and multi-repository research specialist.       |
+| `explore`         | Specialized for codebase-wide search and structural analysis. |
+| `frontend`        | UI/UX Engineer (Gemini-optimized) for component prototyping.  |
+| `document_writer` | Technical documentation and specification writer.             |
+| `multimodal`      | Visual analysis expert for UI screenshots and diagrams.       |
+
+## Development
+
+```bash
+# Install in development mode
+uv pip install -e .
+
+# Run server
+stravinsky
+```
+
+## Project Structure
+
+```
+stravinsky/
+├── mcp_bridge/           # Python MCP server
+│   ├── server.py         # Entry point
+│   ├── auth/             # OAuth (Google & OpenAI)
+│   ├── tools/            # Model invoke, search, skills
+│   ├── prompts/          # Agent system prompts
+│   └── config/           # Bridge configuration
+├── pyproject.toml        # Build system
+└── 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
+
+## License
+
+MIT
+
+---

stravinsky-0.2.11/assets/logo.png.txt

@@ -0,0 +1,2 @@
+# Placeholder - will be replaced with actual logo
+# For now, README will use generic image

stravinsky-0.2.11/error.log

@@ -0,0 +1,4 @@
+   Building stravinsky @ file:///Users/davidandrews/PycharmProjects/stravinsky
+      Built stravinsky @ file:///Users/davidandrews/PycharmProjects/stravinsky
+Installed 61 packages in 150ms
+INFO:mcp_bridge.server:Starting Stravinsky MCP Bridge Server...