docs+skills: add main UI/UX visual-truth PRD and skill links

.agents/skills/create-beads-orchestration/.beads/issues.jsonl

@@ -0,0 +1,2 @@
+{"id":"beads-orchestration-2po","title":"TEST-002","description":"Create Badge component","status":"open","priority":2,"issue_type":"task","owner":"AvivK5498@users.noreply.github.com","created_at":"2026-01-18T11:46:47.242829+02:00","created_by":"Aviv Kaplan","updated_at":"2026-01-18T11:46:47.242829+02:00","comments":[{"id":5,"issue_id":"beads-orchestration-2po","author":"Aviv Kaplan","text":"RAMS: 85/100, WIG: passed with minor observations","created_at":"2026-01-18T09:46:49Z"}]}
+{"id":"beads-orchestration-d9i","title":"Create Card component","description":"Simple Card component for UI with accessibility features","status":"open","priority":2,"issue_type":"task","owner":"AvivK5498@users.noreply.github.com","created_at":"2026-01-18T11:43:16.808241+02:00","created_by":"Aviv Kaplan","updated_at":"2026-01-18T11:43:16.808241+02:00","comments":[{"id":1,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews completed: RAMS 85/100, WIG 3 issues. Serious: missing focus-visible state (needs focus-visible:ring-* classes). Moderate: interactive div should use button element. WIG issues: needs focus-visible ring, prefers-reduced-motion support for transitions, consider semantic button element for interactive variant.","created_at":"2026-01-18T09:43:43Z"},{"id":2,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews: RAMS 85/100, WIG 3 issues found. Serious: missing focus-visible state. Component functional but needs focus indicator, motion preferences, and semantic improvements.","created_at":"2026-01-18T09:43:59Z"},{"id":3,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews: RAMS 85/100, WIG 3 issues. 1 serious issue (missing focus-visible state), 1 moderate issue.","created_at":"2026-01-18T09:44:04Z"},{"id":4,"issue_id":"beads-orchestration-d9i","author":"Aviv Kaplan","text":"Reviews: RAMS 85/100, WIG 3 issues. 1 serious issue (missing focus-visible state).","created_at":"2026-01-18T09:44:10Z"}]}

.agents/skills/create-beads-orchestration/.claude/hooks/block-branch-for-epic-child.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+#
+# PreToolUse:Bash - Block branch creation for epic children
+#
+# Epic children MUST work on the shared EPIC_BRANCH (bd-{EPIC_ID}).
+# This hook blocks any `git checkout -b` command when working on an epic child.
+#
+# Detection: BEAD_ID contains a dot (e.g., BD-001.2 = child of BD-001)
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only check Bash commands
+[[ "$TOOL_NAME" != "Bash" ]] && exit 0
+
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+# Only care about git checkout -b (branch creation)
+if ! echo "$COMMAND" | grep -qE 'git\s+checkout\s+-b|git\s+switch\s+-c|git\s+branch\s+[^-]'; then
+  exit 0
+fi
+
+# Check if we're in an epic child context by looking at recent bead context
+# Strategy: Look for BEAD_ID pattern in the prompt/context that contains a dot
+CONVERSATION_CONTEXT=$(echo "$INPUT" | jq -r '.conversation_context // empty')
+
+# Extract BEAD_ID from various patterns
+BEAD_ID=""
+
+# Try to find BEAD_ID in conversation context
+if [[ -n "$CONVERSATION_CONTEXT" ]]; then
+  BEAD_ID=$(echo "$CONVERSATION_CONTEXT" | grep -oE "BEAD_ID:?\s*[A-Za-z0-9._-]+" | head -1 | sed 's/BEAD_ID:*\s*//')
+fi
+
+# If no context, try to infer from current branch name
+if [[ -z "$BEAD_ID" ]]; then
+  CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+  if [[ "$CURRENT_BRANCH" =~ ^bd-([A-Za-z0-9._-]+) ]]; then
+    BEAD_ID="${BASH_REMATCH[1]}"
+  fi
+fi
+
+# If still no BEAD_ID, allow the command
+[[ -z "$BEAD_ID" ]] && exit 0
+
+# Check if this is an epic child (contains a dot like BD-001.2)
+if [[ "$BEAD_ID" == *"."* ]]; then
+  # Extract the parent epic ID
+  EPIC_ID=$(echo "$BEAD_ID" | sed 's/\.[0-9]*$//')
+
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<epic-branch-enforcement>
+BLOCKED: Cannot create new branch for epic child ${BEAD_ID}
+
+Epic children MUST work on the shared epic branch: bd-${EPIC_ID}
+
+Instead of creating a new branch, use:
+  git checkout bd-${EPIC_ID}
+
+This ensures all epic children's work stays on the same branch for atomic merging.
+</epic-branch-enforcement>"}}
+EOF
+  exit 0
+fi
+
+# Not an epic child, allow branch creation
+exit 0

.agents/skills/create-beads-orchestration/.claude/settings.json

@@ -0,0 +1,25 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/block-branch-for-epic-child.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/clarify-vague-request.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

.agents/skills/create-beads-orchestration/.claude/skills/create-beads-orchestration/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: create-beads-orchestration
+description: Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
+user-invocable: true
+---
+
+# Create Beads Orchestration
+
+Set up lightweight multi-agent orchestration with git-native task tracking and mandatory code review gates.
+
+---
+
+## CRITICAL: Mandatory 4-Step Workflow
+
+<mandatory-workflow>
+You MUST follow ALL 4 steps below in exact order. Missing ANY step is a CATASTROPHIC FAILURE.
+
+| Step | Action | Checkpoint |
+|------|--------|------------|
+| 1 | Get project info from user | Have project name, directory, AND provider choice |
+| 2 | Clone repo and run bootstrap | Bootstrap completes successfully |
+| 3 | **STOP** - Instruct user to restart Claude Code | User confirms they will restart |
+| 4 | After restart: Run discovery agent | Supervisors created in .claude/agents/ |
+
+**DO NOT:**
+- Skip asking for project info
+- **Skip asking about provider delegation (Claude-only vs External providers)**
+- Continue after bootstrap without telling user to restart
+- Forget to run discovery after restart
+- Consider setup complete until discovery has run
+
+**The setup is NOT complete until Step 4 (discovery) has run.**
+</mandatory-workflow>
+
+---
+
+## Step 1: Get Project Info
+
+<critical-step1>
+**YOU MUST ASK ALL THREE QUESTIONS BEFORE PROCEEDING TO STEP 2 using AskUserQuestion.**
+
+1. **Project directory**: Where to install (default: current working directory)
+2. **Project name**: For agent templates (will auto-infer from package.json/pyproject.toml if not provided)
+3. **Provider delegation**: MANDATORY - You MUST use AskUserQuestion for this choice
+</critical-step1>
+
+### 1.1 Get Project Directory and Name
+
+Ask the user or auto-detect from package.json/pyproject.toml.
+
+### 1.2 MANDATORY: Ask Provider Delegation Choice
+
+<mandatory-question>
+**YOU MUST CALL AskUserQuestion WITH THIS EXACT QUESTION BEFORE RUNNING BOOTSTRAP.**
+
+Do NOT skip this. Do NOT assume a default. Do NOT proceed without the user's explicit choice.
+
+```
+AskUserQuestion(
+  questions=[{
+    "question": "How should read-only agents (scout, detective, architect, scribe, code-reviewer) be executed?",
+    "header": "Providers",
+    "options": [
+      {"label": "Claude only (Recommended)", "description": "All agents run via Claude Task(). Simpler setup, no external dependencies."},
+      {"label": "External providers", "description": "Delegate to Codex CLI (with Gemini fallback). Requires codex login and optional gemini CLI."}
+    ],
+    "multiSelect": false
+  }]
+)
+```
+
+**After user answers:**
+- If "Claude only" → use `--claude-only` flag in bootstrap
+- If "External providers" → do NOT use `--claude-only` flag
+</mandatory-question>
+
+**DO NOT proceed to Step 2 until you have the provider choice from the user.**
+
+---
+
+## Step 2: Clone and Run Bootstrap
+
+```bash
+git clone --depth=1 https://github.com/AvivK5498/The-Claude-Protocol "${TMPDIR:-/tmp}/beads-orchestration-setup"
+```
+
+```bash
+# If user selected "Claude only":
+python3 "${TMPDIR:-/tmp}/beads-orchestration-setup/bootstrap.py" \
+  --project-name "{{PROJECT_NAME}}" \
+  --project-dir "{{PROJECT_DIR}}" \
+  --claude-only
+
+# If user selected "External providers":
+python3 "${TMPDIR:-/tmp}/beads-orchestration-setup/bootstrap.py" \
+  --project-name "{{PROJECT_NAME}}" \
+  --project-dir "{{PROJECT_DIR}}"
+```
+
+The bootstrap script will:
+1. Install beads CLI (via brew, npm, or go)
+2. Initialize `.beads/` directory
+3. Copy agent templates to `.claude/agents/`
+4. Copy hooks to `.claude/hooks/`
+5. Configure `.claude/settings.json`
+6. Set up `.mcp.json` for provider_delegator
+7. Create `CLAUDE.md` with orchestrator instructions
+8. Update `.gitignore`
+
+**Verify bootstrap completed successfully before proceeding.**
+
+---
+
+## Step 3: STOP - User Must Restart
+
+<critical>
+**YOU MUST STOP HERE AND INSTRUCT THE USER TO RESTART CLAUDE CODE.**
+
+Tell the user:
+
+> **Setup phase complete. You MUST restart Claude Code now.**
+>
+> The new hooks and MCP configuration will only load after restart.
+>
+> After restarting:
+> 1. Open this same project directory
+> 2. Tell me "Continue orchestration setup" or run `/create-beads-orchestration` again
+> 3. I will run the discovery agent to complete setup
+>
+> **Do not skip this restart - the orchestration will not work without it.**
+
+**DO NOT proceed to Step 4 in this session. The restart is mandatory.**
+</critical>
+
+---
+
+## Step 4: Run Discovery (After Restart)
+
+<post-restart>
+If the user returns after restart and says "continue setup" or similar:
+
+1. Verify bootstrap completed (check for `.claude/agents/scout.md`)
+2. Run the discovery agent:
+
+```python
+Task(
+    subagent_type="discovery",
+    prompt="Detect tech stack and create supervisors for this project"
+)
+```
+
+Discovery will:
+- Scan package.json, requirements.txt, Dockerfile, etc.
+- Fetch specialist agents from external directory
+- Inject beads workflow into each supervisor
+- Write supervisors to `.claude/agents/`
+
+3. After discovery completes, tell the user:
+
+> **Orchestration setup complete!**
+>
+> Created supervisors: [list what discovery created]
+>
+> You can now use the orchestration workflow:
+> - Create tasks with `bd create "Task name" -d "Description"`
+> - The orchestrator will delegate to appropriate supervisors
+> - All work requires code review before completion
+</post-restart>
+
+---
+
+## Cleanup (Optional)
+
+```bash
+rm -rf "${TMPDIR:-/tmp}/beads-orchestration-setup"
+```
+
+---
+
+## What This Creates
+
+- **Beads CLI** for git-native task tracking (one bead = one branch = one task)
+- **Core agents**: scout, detective, architect, scribe, code-reviewer
+- **Discovery agent**: Auto-detects tech stack and creates specialized supervisors
+- **Hooks**: Enforce orchestrator discipline, code review gates, concise responses
+- **Branch-per-task workflow**: Parallel development with automated merge conflict handling
+
+**With `--claude-only` (default):**
+- All agents run via Claude Task() - no external dependencies
+
+**With external providers:**
+- MCP Provider Delegator enables Codex→Gemini→Claude fallback chain
+- Additional enforcement hooks for provider delegation
+
+## Requirements
+
+**Claude only mode (default):**
+- **beads CLI**: Installed automatically (or manually via brew/npm/go)
+- **uv**: Python package manager (only if using external providers)
+
+**External providers mode:**
+- **Codex CLI**: `codex login` for authentication (primary provider)
+- **Gemini CLI**: Optional fallback when Codex hits rate limits
+- **uv**: Python package manager for MCP server
+
+## More Information
+
+See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol

.agents/skills/create-beads-orchestration/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., v2.0.0)'
+        required: true
+        type: string
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: ${{ github.ref_name || inputs.version }}
+          tag_name: ${{ github.ref_name || inputs.version }}
+          generate_release_notes: true
+
+  publish-npm:
+    needs: release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Update package version
+        run: |
+          VERSION="${{ github.ref_name || inputs.version }}"
+          VERSION="${VERSION#v}"
+          npm version $VERSION --no-git-tag-version --allow-same-version
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.agents/skills/create-beads-orchestration/.gitignore

@@ -0,0 +1,23 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+dist/
+build/
+.venv/
+.pytest_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test outputs
+/tmp/
+.history/

.agents/skills/create-beads-orchestration/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aviv Kaplan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

.agents/skills/create-beads-orchestration/SKILL.md

@@ -0,0 +1,263 @@
+---
+name: create-beads-orchestration
+description: Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
+user-invocable: true
+---
+
+# Create Beads Orchestration
+
+Set up lightweight multi-agent orchestration with git-native task tracking for Claude Code.
+
+## What This Skill Does
+
+This skill bootstraps a complete multi-agent workflow where:
+
+- **Orchestrator** (you) investigates issues, manages tasks, delegates implementation
+- **Supervisors** (specialized agents) execute fixes in isolated worktrees
+- **Beads CLI** tracks all work with git-native task management
+- **Hooks** enforce workflow discipline automatically
+
+Each task gets its own worktree at `.worktrees/bd-{BEAD_ID}/`, keeping main clean and enabling parallel work.
+
+## Beads Kanban UI
+
+The setup will auto-detect [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) and configure accordingly. If not found, you'll be offered to install it.
+
+---
+
+## Step 0: Detect Setup State (ALWAYS RUN FIRST)
+
+<detection-phase>
+**Before doing anything else, detect if this is a fresh setup or a resume after restart.**
+
+Check for bootstrap artifacts:
+```bash
+ls .claude/agents/scout.md 2>/dev/null && echo "BOOTSTRAP_COMPLETE" || echo "FRESH_SETUP"
+```
+
+**If `BOOTSTRAP_COMPLETE`:**
+- Bootstrap already ran in a previous session
+- Skip directly to **Step 4: Run Discovery**
+- Do NOT ask for project info or run bootstrap again
+
+**If `FRESH_SETUP`:**
+- This is a new installation
+- Proceed to **Step 1: Get Project Info**
+</detection-phase>
+
+---
+
+## Workflow Overview
+
+<mandatory-workflow>
+| Step | Action | When to Run |
+|------|--------|-------------|
+| 0 | Detect setup state | **ALWAYS** (determines path) |
+| 1 | Get project info from user | Fresh setup only |
+| 2 | Run bootstrap | Fresh setup only |
+| 3 | **STOP** - Instruct user to restart | Fresh setup only |
+| 4 | Run discovery agent | After restart OR if bootstrap already complete |
+
+**The setup is NOT complete until Step 4 (discovery) has run.**
+</mandatory-workflow>
+
+---
+
+## Step 1: Get Project Info (Fresh Setup Only)
+
+<critical-step1>
+**YOU MUST GET PROJECT INFO AND DETECT/ASK ABOUT KANBAN UI BEFORE PROCEEDING TO STEP 2.**
+
+1. **Project directory**: Where to install (default: current working directory)
+2. **Project name**: For agent templates (will auto-infer from package.json/pyproject.toml if not provided)
+3. **Kanban UI**: Auto-detect, or ask the user to install
+</critical-step1>
+
+### 1.1 Get Project Directory and Name
+
+Ask the user or auto-detect from package.json/pyproject.toml.
+
+### 1.2 Detect or Install Kanban UI
+
+```bash
+which bead-kanban 2>/dev/null && echo "KANBAN_FOUND" || echo "KANBAN_NOT_FOUND"
+```
+
+**If KANBAN_FOUND** → Use `--with-kanban-ui` flag. Tell the user:
+> Detected Beads Kanban UI. Configuring worktree management via API.
+
+**If KANBAN_NOT_FOUND** → Ask:
+
+```
+AskUserQuestion(
+  questions=[
+    {
+      "question": "Beads Kanban UI not detected. It adds a visual kanban board with dependency graphs and API-driven worktree management. Install it?",
+      "header": "Kanban UI",
+      "options": [
+        {"label": "Yes, install it (Recommended)", "description": "Runs: npm install -g beads-kanban-ui"},
+        {"label": "Skip", "description": "Use git worktrees directly. You can install later."}
+      ],
+      "multiSelect": false
+    }
+  ]
+)
+```
+
+- If "Yes" → Run `npm install -g beads-kanban-ui`, then use `--with-kanban-ui` flag
+- If "Skip" → do NOT use `--with-kanban-ui` flag
+
+---
+
+## Step 2: Run Bootstrap
+
+```bash
+# With Kanban UI:
+npx beads-orchestration@latest bootstrap \
+  --project-name "{{PROJECT_NAME}}" \
+  --project-dir "{{PROJECT_DIR}}" \
+  --with-kanban-ui
+
+# Without Kanban UI (git worktrees only):
+npx beads-orchestration@latest bootstrap \
+  --project-name "{{PROJECT_NAME}}" \
+  --project-dir "{{PROJECT_DIR}}"
+```
+
+The bootstrap script will:
+1. Install beads CLI (via brew, npm, or go)
+2. Initialize `.beads/` directory
+3. Copy agent templates to `.claude/agents/`
+4. Copy hooks to `.claude/hooks/`
+5. Configure `.claude/settings.json`
+6. Create `CLAUDE.md` with orchestrator instructions
+7. Update `.gitignore`
+
+**Verify bootstrap completed successfully before proceeding.**
+
+---
+
+## Step 3: STOP - User Must Restart
+
+<critical>
+**YOU MUST STOP HERE AND INSTRUCT THE USER TO RESTART CLAUDE CODE.**
+
+Tell the user:
+
+> **Setup phase complete. You MUST restart Claude Code now.**
+>
+> The new hooks and MCP configuration will only load after restart.
+>
+> After restarting:
+> 1. Open this same project directory
+> 2. Tell me "Continue orchestration setup" or run `/create-beads-orchestration` again
+> 3. I will run the discovery agent to complete setup
+>
+> **Do not skip this restart - the orchestration will not work without it.**
+
+**DO NOT proceed to Step 4 in this session. The restart is mandatory.**
+</critical>
+
+---
+
+## Step 4: Run Discovery (After Restart OR Detection)
+
+<post-restart>
+**Run this step if:**
+- Step 0 detected `BOOTSTRAP_COMPLETE`, OR
+- User returned after restart and said "continue setup" or ran `/create-beads-orchestration` again
+
+1. Verify bootstrap completed (check for `.claude/agents/scout.md`) - already done in Step 0
+2. Run the discovery agent:
+
+```python
+Task(
+    subagent_type="discovery",
+    prompt="Detect tech stack and create supervisors for this project"
+)
+```
+
+Discovery will:
+- Scan package.json, requirements.txt, Dockerfile, etc.
+- Fetch specialist agents from external directory
+- Inject beads workflow into each supervisor
+- Write supervisors to `.claude/agents/`
+
+3. After discovery completes, tell the user:
+
+> **Orchestration setup complete!**
+>
+> Created supervisors: [list what discovery created]
+>
+> You can now use the orchestration workflow:
+> - Create tasks with `bd create "Task name" -d "Description"`
+> - The orchestrator will delegate to appropriate supervisors
+> - All work requires code review before completion
+</post-restart>
+
+---
+
+## What This Creates
+
+- **Beads CLI** for git-native task tracking (one bead = one worktree = one task)
+- **Core agents**: scout, detective, architect, scribe, code-reviewer (all run via Claude Task)
+- **Discovery agent**: Auto-detects tech stack and creates specialized supervisors
+- **Hooks**: Enforce orchestrator discipline, code review gates, concise responses
+- **Worktree-per-task workflow**: Isolated development in `.worktrees/bd-{BEAD_ID}/`
+
+**With `--with-kanban-ui`:**
+- Worktrees created via API (localhost:3008) with git fallback
+- Requires [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) running
+
+**Without `--with-kanban-ui`:**
+- Worktrees created via raw git commands
+
+## Epic Workflow (Cross-Domain Features)
+
+For features requiring multiple supervisors (e.g., DB + API + Frontend), use the **epic workflow**:
+
+### When to Use Epics
+
+| Task Type | Workflow |
+|-----------|----------|
+| Single-domain (one supervisor) | Standalone bead |
+| Cross-domain (multiple supervisors) | Epic with children |
+
+### Epic Workflow Steps
+
+1. **Create epic**: `bd create "Feature name" -d "Description" --type epic`
+2. **Create design doc** (if needed): Dispatch architect to create `.designs/{EPIC_ID}.md`
+3. **Link design**: `bd update {EPIC_ID} --design ".designs/{EPIC_ID}.md"`
+4. **Create children with dependencies**:
+   ```bash
+   bd create "DB schema" -d "..." --parent {EPIC_ID}              # BD-001.1
+   bd create "API endpoints" -d "..." --parent {EPIC_ID} --deps BD-001.1  # BD-001.2
+   bd create "Frontend" -d "..." --parent {EPIC_ID} --deps BD-001.2       # BD-001.3
+   ```
+5. **Dispatch sequentially**: Use `bd ready` to find unblocked tasks (each child gets own worktree)
+6. **User merges each PR**: Wait for child's PR to merge before dispatching next
+7. **Close epic**: `bd close {EPIC_ID}` after all children merged
+
+### Design Docs
+
+Design docs ensure consistency across epic children:
+- Schema definitions (exact column names, types)
+- API contracts (endpoints, request/response shapes)
+- Shared constants/enums
+- Data flow between layers
+
+**Key rule**: Orchestrator dispatches architect to create design docs. Orchestrator never writes design docs directly.
+
+### Hooks Enforce Epic Workflow
+
+- **enforce-sequential-dispatch.sh**: Blocks dispatch if task has unresolved blockers
+- **enforce-bead-for-supervisor.sh**: Requires BEAD_ID for all supervisors
+- **validate-completion.sh**: Verifies worktree, push, bead status before supervisor completes
+
+## Requirements
+
+- **beads CLI**: Installed automatically by bootstrap (via brew, npm, or go)
+
+## More Information
+
+See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol

.agents/skills/create-beads-orchestration/bootstrap.py

@@ -0,0 +1,928 @@
+#!/usr/bin/env python3
+"""
+Bootstrap script for beads-based orchestration.
+
+Creates:
+- .beads/ directory with beads CLI
+- .claude/agents/ with agent templates (copied, not generated)
+- .claude/hooks/ with hook scripts
+- .claude/settings.json with hook configuration
+- .mcp.json with provider-delegator configuration (only with --external-providers)
+
+Usage:
+    python bootstrap.py [--project-name NAME] [--project-dir DIR] [--with-kanban-ui]
+
+Modes:
+    Default: All agents use Claude Task() directly (claude-only)
+    --external-providers: Sets up provider_delegator MCP for Codex/Gemini delegation
+"""
+
+import os
+import sys
+import json
+import shutil
+import stat
+import subprocess
+try:
+    import tomllib
+except ImportError:
+    tomllib = None
+from pathlib import Path
+from datetime import datetime
+import random
+
+# Get the directory where this script lives (lean-orchestration repo)
+SCRIPT_DIR = Path(__file__).parent.resolve()
+TEMPLATES_DIR = SCRIPT_DIR / "templates"
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+CORE_AGENTS = ["scout", "detective", "architect", "scribe", "discovery", "merge-supervisor", "code-reviewer"]
+
+# NOTE: Supervisors are NOT bootstrapped - they are created dynamically by the
+# discovery agent which fetches specialists from the external agents directory
+# and injects the beads workflow.
+
+
+# ============================================================================
+# PROJECT NAME INFERENCE
+# ============================================================================
+
+def infer_project_name(project_dir: Path) -> str:
+    """Auto-infer project name from package files or directory name."""
+
+    # Try package.json (Node.js)
+    package_json = project_dir / "package.json"
+    if package_json.exists():
+        try:
+            data = json.loads(package_json.read_text())
+            if name := data.get("name"):
+                return name.replace("-", " ").replace("_", " ").title()
+        except (json.JSONDecodeError, KeyError):
+            pass
+
+    # Try pyproject.toml (Python)
+    if tomllib:
+        pyproject = project_dir / "pyproject.toml"
+        if pyproject.exists():
+            try:
+                data = tomllib.loads(pyproject.read_text())
+                if name := data.get("project", {}).get("name"):
+                    return name.replace("-", " ").replace("_", " ").title()
+                if name := data.get("tool", {}).get("poetry", {}).get("name"):
+                    return name.replace("-", " ").replace("_", " ").title()
+            except Exception:
+                pass
+
+        # Try Cargo.toml (Rust)
+        cargo = project_dir / "Cargo.toml"
+        if cargo.exists():
+            try:
+                data = tomllib.loads(cargo.read_text())
+                if name := data.get("package", {}).get("name"):
+                    return name.replace("-", " ").replace("_", " ").title()
+            except Exception:
+                pass
+
+    # Try go.mod (Go)
+    go_mod = project_dir / "go.mod"
+    if go_mod.exists():
+        try:
+            content = go_mod.read_text()
+            for line in content.splitlines():
+                if line.startswith("module "):
+                    module_path = line.split()[1]
+                    name = module_path.split("/")[-1]
+                    return name.replace("-", " ").replace("_", " ").title()
+        except Exception:
+            pass
+
+    # Fallback to directory name
+    return project_dir.name.replace("-", " ").replace("_", " ").title()
+
+
+# ============================================================================
+# PLACEHOLDER REPLACEMENT
+# ============================================================================
+
+def replace_placeholders(content: str, replacements: dict) -> str:
+    """Replace all placeholders in content."""
+    for placeholder, value in replacements.items():
+        content = content.replace(placeholder, value)
+    return content
+
+
+def copy_and_replace(source: Path, dest: Path, replacements: dict) -> None:
+    """Copy file and replace placeholders."""
+    content = source.read_text()
+    updated = replace_placeholders(content, replacements)
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    dest.write_text(updated)
+
+    # Preserve executable permissions for shell scripts
+    if source.suffix == '.sh':
+        dest.chmod(dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+
+
+# ============================================================================
+# CODEX DELEGATOR SETUP (SHARED LOCATION)
+# ============================================================================
+
+# Shared location for provider-delegator (installed once, used by all projects)
+SHARED_MCP_DIR = Path.home() / ".claude" / "mcp-servers" / "provider-delegator"
+
+
+def setup_provider_delegator() -> Path:
+    """Set up provider-delegator in shared location (~/.claude/mcp-servers/provider-delegator/).
+
+    This installs once and is reused by all projects.
+    Returns path to venv python.
+    """
+    print("\n[0/8] Setting up provider-delegator (shared)...")
+
+    source_dir = SCRIPT_DIR / "mcp-provider-delegator"
+    venv_dir = SHARED_MCP_DIR / ".venv"
+    venv_python = venv_dir / "bin" / "python"
+
+    # Check if already installed in shared location
+    if venv_python.exists():
+        print(f"  - Already installed at {SHARED_MCP_DIR}")
+        return venv_python
+
+    # Verify source exists
+    if not source_dir.exists():
+        print(f"  ERROR: mcp-provider-delegator not found at {source_dir}")
+        print("  Make sure you cloned the full lean-orchestration repo")
+        return None
+
+    # Check if uv is available
+    if not shutil.which("uv"):
+        print("  ERROR: 'uv' not found. Install with: curl -LsSf https://astral.sh/uv/install.sh | sh")
+        return None
+
+    # Create shared directory
+    print(f"  - Installing to {SHARED_MCP_DIR}")
+    SHARED_MCP_DIR.mkdir(parents=True, exist_ok=True)
+
+    # Copy source to shared location
+    print("  - Copying source files...")
+    for item in source_dir.iterdir():
+        if item.name == ".venv":
+            continue  # Skip any existing venv in source
+        dest = SHARED_MCP_DIR / item.name
+        if item.is_dir():
+            if dest.exists():
+                shutil.rmtree(dest)
+            shutil.copytree(item, dest)
+        else:
+            shutil.copy2(item, dest)
+
+    # Create venv using uv
+    print("  - Creating venv with uv...")
+    result = subprocess.run(
+        ["uv", "venv", str(venv_dir)],
+        cwd=SHARED_MCP_DIR,
+        capture_output=True,
+        text=True
+    )
+    if result.returncode != 0:
+        print(f"  ERROR: Failed to create venv: {result.stderr}")
+        return None
+
+    # Install dependencies
+    print("  - Installing dependencies...")
+    result = subprocess.run(
+        ["uv", "pip", "install", "-e", "."],
+        cwd=SHARED_MCP_DIR,
+        capture_output=True,
+        text=True,
+        env={**os.environ, "VIRTUAL_ENV": str(venv_dir)}
+    )
+    if result.returncode != 0:
+        print(f"  ERROR: Failed to install dependencies: {result.stderr}")
+        return None
+
+    print(f"  DONE: provider-delegator installed at {SHARED_MCP_DIR}")
+    return venv_python
+
+
+# ============================================================================
+# BEADS INSTALLATION
+# ============================================================================
+
+def install_beads(project_dir: Path, claude_only: bool = False) -> bool:
+    """Install beads CLI and initialize .beads directory."""
+    step = "[1/7]" if claude_only else "[1/8]"
+    print(f"\n{step} Installing beads...")
+
+    beads_dir = project_dir / ".beads"
+
+    # Check if beads is already installed globally
+    beads_installed = shutil.which("bd") is not None
+
+    if not beads_installed:
+        print("  - beads CLI (bd) not found, installing...")
+
+        # Try installation methods in order of preference
+        installed = False
+
+        # Method 1: Homebrew (macOS)
+        if shutil.which("brew") and sys.platform == "darwin":
+            print("  - Trying Homebrew...")
+            result = subprocess.run(
+                ["brew", "install", "steveyegge/beads/bd"],
+                capture_output=True,
+                text=True
+            )
+            if result.returncode == 0:
+                installed = True
+                print("  - Installed via Homebrew")
+
+        # Method 2: npm (cross-platform)
+        if not installed and shutil.which("npm"):
+            print("  - Trying npm...")
+            result = subprocess.run(
+                ["npm", "install", "-g", "@beads/bd"],
+                capture_output=True,
+                text=True
+            )
+            if result.returncode == 0:
+                installed = True
+                print("  - Installed via npm")
+
+        # Method 3: curl install script (Linux/macOS/FreeBSD)
+        if not installed and sys.platform != "win32":
+            print("  - Trying curl install script...")
+            result = subprocess.run(
+                ["bash", "-c", "curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash"],
+                capture_output=True,
+                text=True
+            )
+            if result.returncode == 0:
+                installed = True
+                print("  - Installed via curl script")
+
+        # Method 4: Go install (if Go is available)
+        if not installed and shutil.which("go"):
+            print("  - Trying go install...")
+            result = subprocess.run(
+                ["go", "install", "github.com/steveyegge/beads/cmd/bd@latest"],
+                capture_output=True,
+                text=True
+            )
+            if result.returncode == 0:
+                installed = True
+                print("  - Installed via go install")
+
+        if not installed:
+            print("\n  ERROR: Could not install beads CLI (bd)")
+            print("  The beads workflow requires the bd command.")
+            print("  Please install manually: https://github.com/steveyegge/beads#-installation")
+            print("\n  Installation options:")
+            print("    macOS:   brew install steveyegge/beads/bd")
+            print("    npm:     npm install -g @beads/bd")
+            print("    Go:      go install github.com/steveyegge/beads/cmd/bd@latest")
+            return False
+    else:
+        print("  - beads CLI already installed")
+
+    beads_installed = True
+
+    # Initialize .beads in project
+    if not beads_dir.exists():
+        print("  - Initializing .beads directory...")
+
+        # Try bd init first
+        if shutil.which("bd"):
+            result = subprocess.run(
+                ["bd", "init"],
+                cwd=project_dir,
+                capture_output=True,
+                text=True
+            )
+            if result.returncode == 0:
+                print("  - Initialized via 'bd init'")
+            else:
+                # Manual init as fallback
+                _manual_beads_init(beads_dir)
+        else:
+            _manual_beads_init(beads_dir)
+    else:
+        print("  - .beads already exists")
+
+    # Configure custom 'inreview' status for parallel work workflow
+    if shutil.which("bd"):
+        print("  - Configuring custom 'inreview' status...")
+        result = subprocess.run(
+            ["bd", "config", "set", "status.custom", "inreview"],
+            cwd=project_dir,
+            capture_output=True,
+            text=True
+        )
+        if result.returncode == 0:
+            print("  - Added 'inreview' custom status")
+        else:
+            print(f"  - Warning: Could not add custom status: {result.stderr}")
+
+    print("  DONE: beads setup complete")
+    return True
+
+
+def _manual_beads_init(beads_dir: Path):
+    """Manually create .beads directory structure."""
+    beads_dir.mkdir(exist_ok=True)
+    (beads_dir / "issues.jsonl").touch()
+    # Create minimal config
+    config = {
+        "version": "1",
+        "mode": "normal"
+    }
+    (beads_dir / "config.json").write_text(json.dumps(config, indent=2))
+    print("  - Created .beads manually")
+
+
+def setup_memory(project_dir: Path) -> None:
+    """Create .beads/memory/ directory with knowledge store and recall script."""
+    memory_dir = project_dir / ".beads" / "memory"
+    memory_dir.mkdir(parents=True, exist_ok=True)
+
+    # Create empty knowledge store
+    knowledge_file = memory_dir / "knowledge.jsonl"
+    if not knowledge_file.exists():
+        knowledge_file.touch()
+        print("  - Created .beads/memory/knowledge.jsonl")
+
+    # Copy recall script
+    recall_src = TEMPLATES_DIR / "memory" / "recall.sh"
+    recall_dest = memory_dir / "recall.sh"
+    if recall_src.exists():
+        shutil.copy2(recall_src, recall_dest)
+        recall_dest.chmod(recall_dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+        print("  - Copied .beads/memory/recall.sh")
+    else:
+        print("  - WARNING: recall.sh template not found")
+
+
+# ============================================================================
+# RAMS INSTALLATION (Accessibility Review)
+# ============================================================================
+
+def install_rams() -> bool:
+    """Install RAMS accessibility review tool if not already installed."""
+    print("\n  Checking RAMS (accessibility review tool)...")
+
+    # Check if rams is already installed
+    if shutil.which("rams"):
+        print("  - RAMS already installed")
+        return True
+
+    print("  - RAMS not found, installing...")
+
+    # Install via curl
+    if sys.platform != "win32":
+        result = subprocess.run(
+            ["bash", "-c", "curl -fsSL https://rams.ai/install | bash"],
+            capture_output=True,
+            text=True
+        )
+        if result.returncode == 0:
+            print("  - RAMS installed successfully")
+            return True
+        else:
+            print(f"  - Warning: Could not install RAMS: {result.stderr}")
+            print("  - Frontend supervisors will still work but RAMS review enforcement may fail")
+            print("  - Install manually: curl -fsSL https://rams.ai/install | bash")
+            return False
+
+    print("  - Warning: RAMS installation not supported on Windows")
+    return False
+
+
+# ============================================================================
+# WEB INTERFACE GUIDELINES INSTALLATION
+# ============================================================================
+
+def install_web_interface_guidelines() -> bool:
+    """Install Web Interface Guidelines review tool if not already installed."""
+    print("\n  Checking Web Interface Guidelines (design review tool)...")
+
+    # Check if wig is already installed
+    if shutil.which("wig"):
+        print("  - Web Interface Guidelines already installed")
+        return True
+
+    print("  - Web Interface Guidelines not found, installing...")
+
+    # Install via curl
+    if sys.platform != "win32":
+        result = subprocess.run(
+            ["bash", "-c", "curl -fsSL https://vercel.com/design/guidelines/install | bash"],
+            capture_output=True,
+            text=True
+        )
+        if result.returncode == 0:
+            print("  - Web Interface Guidelines installed successfully")
+            return True
+        else:
+            print(f"  - Warning: Could not install Web Interface Guidelines: {result.stderr}")
+            print("  - Frontend supervisors will still work but WIG review enforcement may fail")
+            print("  - Install manually: curl -fsSL https://vercel.com/design/guidelines/install | bash")
+            return False
+
+    print("  - Warning: Web Interface Guidelines installation not supported on Windows")
+    return False
+
+
+# ============================================================================
+# AGENTS (TEMPLATE COPYING)
+# ============================================================================
+
+def copy_agents(project_dir: Path, project_name: str, claude_only: bool = False, with_kanban_ui: bool = False) -> list:
+    """Copy core agent templates from templates/ directory.
+
+    NOTE: Supervisors are NOT copied here - they are created dynamically
+    by the discovery agent based on detected tech stack.
+    """
+    step = "[2/7]" if claude_only else "[2/8]"
+    print(f"\n{step} Copying core agent templates...")
+
+    agents_dir = project_dir / ".claude" / "agents"
+    agents_dir.mkdir(parents=True, exist_ok=True)
+
+    agents_template_dir = TEMPLATES_DIR / "agents"
+
+    copied = []
+
+    # Replacements for templates
+    replacements = {
+        "[Project]": project_name,
+    }
+
+    # Copy core agents ONLY (not supervisors)
+    for agent_file in agents_template_dir.glob("*.md"):
+        dest = agents_dir / agent_file.name
+        copy_and_replace(agent_file, dest, replacements)
+        copied.append(agent_file.name)
+        print(f"  - Copied {agent_file.name}")
+
+    # Copy beads workflow injection snippet (used by discovery agent)
+    # Select API version (with git fallback) or git-only version based on flag
+    if with_kanban_ui:
+        beads_workflow_src = TEMPLATES_DIR / "beads-workflow-injection-api.md"
+        workflow_type = "API + git fallback"
+    else:
+        beads_workflow_src = TEMPLATES_DIR / "beads-workflow-injection-git.md"
+        workflow_type = "git only"
+    beads_workflow_dest = project_dir / ".claude" / "beads-workflow-injection.md"
+    if beads_workflow_src.exists():
+        shutil.copy2(beads_workflow_src, beads_workflow_dest)
+        print(f"  - Copied beads-workflow-injection.md ({workflow_type})")
+
+    # Copy UI constraints (used by discovery agent for frontend supervisors)
+    ui_constraints_src = TEMPLATES_DIR / "ui-constraints.md"
+    ui_constraints_dest = project_dir / ".claude" / "ui-constraints.md"
+    if ui_constraints_src.exists():
+        shutil.copy2(ui_constraints_src, ui_constraints_dest)
+        print("  - Copied ui-constraints.md")
+
+    # Copy frontend reviews requirement (RAMS + Web Interface Guidelines)
+    frontend_reviews_src = TEMPLATES_DIR / "frontend-reviews-requirement.md"
+    frontend_reviews_dest = project_dir / ".claude" / "frontend-reviews-requirement.md"
+    if frontend_reviews_src.exists():
+        shutil.copy2(frontend_reviews_src, frontend_reviews_dest)
+        print("  - Copied frontend-reviews-requirement.md")
+
+    print(f"  DONE: {len(copied)} core agents copied")
+    print("  NOTE: Supervisors will be created by discovery agent based on tech stack")
+    return copied
+
+
+# ============================================================================
+# SKILLS (TEMPLATE COPYING)
+# ============================================================================
+
+def copy_skills(project_dir: Path, claude_only: bool = False) -> list:
+    """Copy skill templates from templates/ directory.
+
+    Skills are copied so discovery agent can install them when tech stack is detected.
+    """
+    step = "[3/7]" if claude_only else "[3/8]"
+    print(f"\n{step} Copying skill templates...")
+
+    skills_template_dir = TEMPLATES_DIR / "skills"
+    if not skills_template_dir.exists():
+        print("  - No skill templates found, skipping")
+        return []
+
+    skills_dir = project_dir / ".claude" / "skills"
+    skills_dir.mkdir(parents=True, exist_ok=True)
+
+    copied = []
+
+    for skill_dir in skills_template_dir.iterdir():
+        if skill_dir.is_dir():
+            dest_dir = skills_dir / skill_dir.name
+            if dest_dir.exists():
+                shutil.rmtree(dest_dir)
+            shutil.copytree(skill_dir, dest_dir)
+            copied.append(skill_dir.name)
+            print(f"  - Copied {skill_dir.name}/ skill")
+
+    print(f"  DONE: {len(copied)} skill templates copied")
+    return copied
+
+
+# ============================================================================
+# HOOKS (TEMPLATE COPYING)
+# ============================================================================
+
+def copy_hooks(project_dir: Path, claude_only: bool = False) -> list:
+    """Copy hook templates from templates/ directory.
+
+    Args:
+        project_dir: Target project directory
+        claude_only: If True, skip provider delegation enforcement hooks
+    """
+    step = "[4/7]" if claude_only else "[4/8]"
+    print(f"\n{step} Copying hook templates...")
+
+    hooks_dir = project_dir / ".claude" / "hooks"
+    hooks_dir.mkdir(parents=True, exist_ok=True)
+
+    hooks_template_dir = TEMPLATES_DIR / "hooks"
+    copied = []
+
+    # Hooks to skip in claude-only mode (none currently - all hooks apply to both modes)
+    skip_in_claude_only = set()
+
+    for hook_file in hooks_template_dir.glob("*.sh"):
+        # Skip provider enforcement hooks in claude-only mode
+        if claude_only and hook_file.name in skip_in_claude_only:
+            print(f"  - Skipped {hook_file.name} (claude-only mode)")
+            continue
+
+        dest = hooks_dir / hook_file.name
+        shutil.copy2(hook_file, dest)
+        dest.chmod(dest.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+        copied.append(hook_file.name)
+        print(f"  - Copied {hook_file.name}")
+
+    print(f"  DONE: {len(copied)} hooks copied")
+    return copied
+
+
+# ============================================================================
+# SETTINGS
+# ============================================================================
+
+def copy_settings(project_dir: Path, claude_only: bool = False) -> None:
+    """Copy settings.json template, optionally removing provider enforcement hooks.
+
+    Args:
+        project_dir: Target project directory
+        claude_only: If True, remove provider delegation enforcement from settings
+    """
+    step = "[5/7]" if claude_only else "[5/8]"
+    print(f"\n{step} Copying settings...")
+
+    settings_template = TEMPLATES_DIR / "settings.json"
+    settings_dest = project_dir / ".claude" / "settings.json"
+
+    # Settings are the same for both modes now (no provider-specific hooks)
+    shutil.copy2(settings_template, settings_dest)
+    if claude_only:
+        print("  - Copied settings.json (claude-only mode)")
+    else:
+        print("  - Copied settings.json")
+
+    print("  DONE: settings configured")
+
+
+# ============================================================================
+# CLAUDE.MD
+# ============================================================================
+
+def copy_claude_md(project_dir: Path, project_name: str, claude_only: bool = False) -> None:
+    """Copy CLAUDE.md template with project name replacement."""
+    step = "[6/7]" if claude_only else "[6/8]"
+    print(f"\n{step} Copying CLAUDE.md...")
+
+    claude_template = TEMPLATES_DIR / "CLAUDE.md"
+    claude_dest = project_dir / "CLAUDE.md"
+
+    replacements = {"[Project]": project_name}
+    copy_and_replace(claude_template, claude_dest, replacements)
+
+    print("  - Copied CLAUDE.md")
+    print("  DONE: CLAUDE.md copied")
+
+
+# ============================================================================
+# GITIGNORE
+# ============================================================================
+
+def setup_gitignore(project_dir: Path, claude_only: bool = False) -> None:
+    """Ensure .beads is in .gitignore. .claude/ is tracked (not ignored)."""
+    step = "[7/7]" if claude_only else "[7/8]"
+    print(f"\n{step} Setting up .gitignore...")
+
+    gitignore_path = project_dir / ".gitignore"
+    # Only ignore .beads/ (ephemeral task data) and .mcp.json (user-specific paths)
+    # .claude/ is tracked so it survives git operations
+    entries_to_add = [".beads/", ".mcp.json"]
+
+    if gitignore_path.exists():
+        content = gitignore_path.read_text()
+        lines = content.splitlines()
+
+        # Check which entries are missing
+        missing = []
+        for entry in entries_to_add:
+            # Check for exact match or without trailing slash
+            entry_no_slash = entry.rstrip("/")
+            if entry not in lines and entry_no_slash not in lines:
+                missing.append(entry)
+
+        if missing:
+            # Append missing entries
+            with open(gitignore_path, "a") as f:
+                # Add newline if file doesn't end with one
+                if content and not content.endswith("\n"):
+                    f.write("\n")
+                f.write("\n# Beads task tracking (ephemeral)\n")
+                for entry in missing:
+                    f.write(f"{entry}\n")
+                    print(f"  - Added {entry} to .gitignore")
+        else:
+            print("  - .beads/ and .mcp.json already in .gitignore")
+    else:
+        # Create new .gitignore
+        content = """# Beads task tracking (ephemeral)
+.beads/
+
+# MCP config (user-specific paths)
+.mcp.json
+"""
+        gitignore_path.write_text(content)
+        print("  - Created .gitignore with .beads/ and .mcp.json")
+
+    print("  DONE: .gitignore configured")
+    print("  NOTE: .claude/ is tracked (not ignored) to prevent accidental loss")
+
+
+# ============================================================================
+# MCP CONFIG
+# ============================================================================
+
+def create_mcp_config(project_dir: Path, venv_python: Path) -> None:
+    """Add provider-delegator to .mcp.json, preserving existing servers."""
+    print("\n[8/8] Configuring MCP...")
+
+    mcp_dest = project_dir / ".mcp.json"
+
+    # Load existing config or start fresh
+    if mcp_dest.exists():
+        try:
+            existing = json.loads(mcp_dest.read_text())
+            print("  - Found existing .mcp.json, merging...")
+        except json.JSONDecodeError:
+            print("  - Warning: Invalid .mcp.json, creating new one")
+            existing = {}
+    else:
+        existing = {}
+
+    # Ensure mcpServers key exists
+    if "mcpServers" not in existing:
+        existing["mcpServers"] = {}
+
+    # Add/update provider_delegator
+    existing["mcpServers"]["provider_delegator"] = {
+        "type": "stdio",
+        "command": str(venv_python),
+        "args": ["-m", "mcp_provider_delegator.server"],
+        "env": {
+            "AGENT_TEMPLATES_PATH": ".claude/agents"
+        }
+    }
+
+    mcp_dest.write_text(json.dumps(existing, indent=2))
+
+    server_count = len(existing["mcpServers"])
+    print(f"  - Added provider-delegator to .mcp.json ({server_count} total servers)")
+    print(f"    Command: {venv_python}")
+    print(f"    Agents: .claude/agents (relative)")
+    print("  DONE: MCP config updated")
+
+
+# ============================================================================
+# VERIFICATION
+# ============================================================================
+
+def verify_installation(project_dir: Path, claude_only: bool = False) -> bool:
+    """Verify all components were installed correctly."""
+    checks = {
+        ".claude/hooks": "Hooks directory",
+        ".claude/agents": "Agents directory",
+        ".claude/settings.json": "Settings file",
+        ".beads": "Beads directory",
+        "CLAUDE.md": "CLAUDE.md",
+        ".gitignore": ".gitignore",
+    }
+
+    # Only check for .mcp.json in external providers mode
+    if not claude_only:
+        checks[".mcp.json"] = "MCP config"
+
+    print("\n=== Verification ===")
+    all_good = True
+
+    for path, description in checks.items():
+        full_path = project_dir / path
+        if full_path.exists():
+            print(f"  - {description}")
+        else:
+            print(f"  X {description} MISSING")
+            all_good = False
+
+    # Count files
+    hooks_dir = project_dir / ".claude/hooks"
+    if hooks_dir.exists():
+        hook_count = len(list(hooks_dir.glob("*.sh")))
+        print(f"  - Hooks: {hook_count}")
+
+    agents_dir = project_dir / ".claude/agents"
+    if agents_dir.exists():
+        agent_count = len(list(agents_dir.glob("*.md")))
+        print(f"  - Agents: {agent_count}")
+
+    skills_dir = project_dir / ".claude/skills"
+    if skills_dir.exists():
+        skill_count = len(list(skills_dir.iterdir()))
+        if skill_count > 0:
+            print(f"  - Skills: {skill_count}")
+
+    return all_good
+
+
+# ============================================================================
+# MAIN
+# ============================================================================
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Bootstrap beads-based orchestration")
+    parser.add_argument("--project-name", default=None, help="Project name (auto-inferred if not provided)")
+    parser.add_argument("--project-dir", default=".", help="Project directory")
+    parser.add_argument("--external-providers", action="store_true",
+                        help="Use Codex/Gemini for delegation (default: Claude-only)")
+    parser.add_argument("--with-kanban-ui", action="store_true",
+                        help="Use Beads Kanban UI API for worktree creation (with git fallback)")
+    args = parser.parse_args()
+
+    project_dir = Path(args.project_dir).resolve()
+    claude_only = not args.external_providers  # Default is now claude-only
+    with_kanban_ui = args.with_kanban_ui
+
+    # Ensure project directory exists
+    project_dir.mkdir(parents=True, exist_ok=True)
+
+    # Auto-infer project name if not provided
+    if args.project_name:
+        project_name = args.project_name
+    else:
+        project_name = infer_project_name(project_dir)
+        print(f"Auto-inferred project name: {project_name}")
+
+    mode_str = "CLAUDE-ONLY" if claude_only else "EXTERNAL PROVIDERS"
+    worktree_str = "API + git fallback" if with_kanban_ui else "git only"
+    print(f"\nBootstrapping beads orchestration for: {project_name}")
+    print(f"Directory: {project_dir}")
+    print(f"Mode: {mode_str}")
+    print(f"Worktrees: {worktree_str}")
+    print("=" * 60)
+
+    # Verify templates exist
+    if not TEMPLATES_DIR.exists():
+        print(f"\nERROR: Templates directory not found: {TEMPLATES_DIR}")
+        print("Make sure you cloned the full lean-orchestration repo")
+        sys.exit(1)
+
+    venv_python = None
+
+    # Step 0: Setup bundled provider-delegator (skip in claude-only mode)
+    if not claude_only:
+        venv_python = setup_provider_delegator()
+        if not venv_python:
+            print("\nERROR: Failed to setup provider-delegator. Aborting.")
+            sys.exit(1)
+
+        # Run remaining steps with provider support
+        if not install_beads(project_dir, claude_only=False):
+            print("\nERROR: Beads CLI is required. Aborting bootstrap.")
+            sys.exit(1)
+
+        # Install frontend review tools (optional, won't block)
+        install_rams()
+        install_web_interface_guidelines()
+
+        copy_agents(project_dir, project_name, claude_only=False, with_kanban_ui=with_kanban_ui)
+        copy_skills(project_dir, claude_only=False)
+        copy_hooks(project_dir, claude_only=False)
+        copy_settings(project_dir, claude_only=False)
+        copy_claude_md(project_dir, project_name, claude_only=False)
+        setup_memory(project_dir)
+        setup_gitignore(project_dir, claude_only=False)
+        create_mcp_config(project_dir, venv_python)
+    else:
+        # Claude-only mode: skip provider setup
+        print("\n[0/7] Skipping provider-delegator setup (claude-only mode)")
+
+        if not install_beads(project_dir, claude_only=True):
+            print("\nERROR: Beads CLI is required. Aborting bootstrap.")
+            sys.exit(1)
+
+        # Install frontend review tools (optional, won't block)
+        install_rams()
+        install_web_interface_guidelines()
+
+        copy_agents(project_dir, project_name, claude_only=True, with_kanban_ui=with_kanban_ui)
+        copy_skills(project_dir, claude_only=True)
+        copy_hooks(project_dir, claude_only=True)
+        copy_settings(project_dir, claude_only=True)
+        copy_claude_md(project_dir, project_name, claude_only=True)
+        setup_memory(project_dir)
+        setup_gitignore(project_dir, claude_only=True)
+
+    # Verify
+    if not verify_installation(project_dir, claude_only):
+        print("\nWARNING: Installation incomplete - check errors above")
+
+    print("\n" + "=" * 60)
+    print("BOOTSTRAP COMPLETE")
+    print("=" * 60)
+
+    if claude_only:
+        print(f"""
+Mode: CLAUDE-ONLY (all agents use Claude Task)
+
+Next steps:
+
+1. Restart Claude Code to load new hooks and agents
+
+2. **REQUIRED: Run discovery to create supervisors**
+   Discovery will scan your codebase and fetch specialist agents:
+
+   Task(
+       subagent_type="discovery",
+       prompt="Detect tech stack and create supervisors for {project_name}"
+   )
+
+3. Create your first bead:
+   bd create "First task"
+
+4. Dispatch work to supervisors:
+   Task(subagent_type="<supervisor-name>", prompt="BEAD_ID: BD-001\\n\\nImplement...")
+
+NOTE: All agents (scout, detective, architect, etc.) run via Claude Task().
+No external providers (Codex/Gemini) are configured.
+""")
+    else:
+        print(f"""
+Mode: EXTERNAL PROVIDERS (Codex → Gemini → Claude fallback)
+
+Next steps:
+
+1. Restart Claude Code to load new hooks and agents
+
+2. **REQUIRED: Run discovery to create supervisors**
+   Discovery will scan your codebase and fetch specialist agents:
+
+   Task(
+       subagent_type="discovery",
+       prompt="Detect tech stack and create supervisors for {project_name}"
+   )
+
+   This will:
+   - Scan package.json, requirements.txt, Dockerfile, etc.
+   - Fetch matching specialists from external agents directory
+   - Inject beads workflow at the beginning of each agent
+   - Write supervisors to .claude/agents/
+
+3. Create your first bead:
+   bd create "First task"
+
+4. Dispatch work to supervisors:
+   Task(subagent_type="<supervisor-name>", prompt="BEAD_ID: BD-001\\n\\nImplement...")
+
+NOTE: Read-only agents (scout, detective, architect, scribe, code-reviewer)
+are delegated via provider_delegator MCP (Codex → Gemini fallback).
+Supervisors are sourced from https://github.com/ayush-that/sub-agents.directory
+with beads workflow injected.
+""")
+
+
+if __name__ == "__main__":
+    main()

.agents/skills/create-beads-orchestration/docs/memory-architecture.md

@@ -0,0 +1,114 @@
+# Memory Architecture
+
+## Overview
+
+Beads orchestration includes a passive knowledge capture system. As agents work, their insights can be voluntarily recorded into a persistent knowledge base that grows across sessions.
+
+## How It Works
+
+```
+Agent runs bd comment BD-001 "LEARNED: ..."
+       |
+       v
+PostToolUse hook (memory-capture.sh) detects LEARNED: prefix
+       |
+       v
+Extracts structured entry into .beads/memory/knowledge.jsonl
+       |
+       v
+Next session: session-start.sh surfaces recent knowledge
+              Agents search when investigating unfamiliar code
+```
+
+## Write Path
+
+Agents write knowledge through the existing `bd comment` interface:
+
+| Prefix | Who writes | Purpose |
+|--------|-----------|---------|
+| `LEARNED:` | Any agent (voluntary) | Conventions, gotchas, patterns discovered during implementation |
+
+Example:
+```bash
+bd comment BD-001 "LEARNED: TaskGroup requires @Sendable closures in strict concurrency mode."
+```
+
+An async `PostToolUse` hook on the Bash tool intercepts these commands and extracts a structured JSONL entry. No changes to the beads CLI are required.
+
+## Storage Format
+
+`.beads/memory/knowledge.jsonl` -- one JSON object per line:
+
+```json
+{"key":"learned-taskgroup-requires-sendable-closures","type":"learned","content":"TaskGroup requires @Sendable closures in strict concurrency mode.","source":"supervisor","tags":["learned","async","concurrency"],"ts":1706360000,"bead":"BD-001"}
+```
+
+| Field | Description |
+|-------|-------------|
+| `key` | Auto-generated slug from type + first 60 chars of content |
+| `type` | `learned` |
+| `content` | The raw insight text |
+| `source` | `orchestrator` or `supervisor` (detected from CWD) |
+| `tags` | Auto-detected from content via keyword scan |
+| `ts` | Unix timestamp |
+| `bead` | The bead ID that produced this knowledge |
+
+Same key = latest entry wins (deduplication on read).
+
+## Read Path
+
+### Automatic (session start)
+
+`session-start.sh` displays the 5 most recent deduplicated entries when a new session begins:
+
+```
+## Recent Knowledge (12 entries)
+
+  [LEARN] MenuBarExtra popup closes on NSWindow activate. Use activates:false.  (supervisor)
+
+  Search: .beads/memory/recall.sh "keyword"
+```
+
+### On-demand (recall script)
+
+```bash
+.beads/memory/recall.sh "keyword"                  # Search by keyword
+.beads/memory/recall.sh "keyword" --type learned   # Filter by type
+.beads/memory/recall.sh --recent 10                # Show latest entries
+.beads/memory/recall.sh --stats                    # Entry counts
+.beads/memory/recall.sh "keyword" --all            # Include archived entries
+```
+
+## Voluntary Contribution
+
+Knowledge capture is opt-in. Agents are encouraged to log insights when they discover something worth remembering, but it is not enforced. The `SubagentStop` hook verifies worktree state, push status, and bead status — not knowledge contributions.
+
+Exempt: `worker-supervisor` (low-level tasks that don't produce architectural insight).
+
+## Rotation
+
+When `knowledge.jsonl` exceeds 1,000 lines, the oldest 500 are moved to `knowledge.archive.jsonl`. The archive is searchable via `recall.sh --all`.
+
+## File Layout
+
+```
+.beads/
+  memory/
+    knowledge.jsonl          # Active knowledge store
+    knowledge.archive.jsonl  # Rotated older entries
+    recall.sh                # On-demand search script
+.claude/
+  hooks/
+    memory-capture.sh        # PostToolUse async hook (captures entries)
+    validate-completion.sh   # SubagentStop hook (verifies work completion)
+    log-dispatch-prompt.sh   # PostToolUse async hook (logs dispatch prompts)
+    session-start.sh         # SessionStart hook (surfaces knowledge)
+```
+
+## Design Decisions
+
+- **JSONL over SQLite**: Simpler, append-only, human-readable, git-trackable
+- **grep + jq over embeddings**: Sufficient for project-scoped knowledge; no external dependencies
+- **Passive capture via hooks**: Zero friction -- agents use `bd comment` as they already do
+- **Voluntary contribution**: Knowledge base grows organically from genuine insights, not forced boilerplate
+- **Same key = latest wins**: No explicit update/close lifecycle; knowledge self-corrects over time

.agents/skills/create-beads-orchestration/mcp-provider-delegator/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

.agents/skills/create-beads-orchestration/mcp-provider-delegator/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-provider-delegator"
+version = "0.1.0"
+description = "MCP server for delegating agents to AI providers (Codex, Gemini) with fallback support"
+requires-python = ">=3.11"
+dependencies = [
+    "mcp>=1.0.0",
+    "pyyaml>=6.0.1",
+]
+
+[project.scripts]
+mcp-provider-delegator = "mcp_provider_delegator.server:run"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_provider_delegator"]

.agents/skills/create-beads-orchestration/mcp-provider-delegator/src/mcp_provider_delegator/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

.agents/skills/create-beads-orchestration/mcp-provider-delegator/src/mcp_provider_delegator/agent_loader.py

@@ -0,0 +1,79 @@
+"""Agent template loader for reading .md files."""
+
+import os
+import re
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Optional
+
+import yaml
+
+
+@dataclass
+class AgentTemplate:
+    """Represents a loaded agent template."""
+    name: str
+    model: str
+    description: str
+    tools: list[str]
+    system_prompt: str
+    skills: Optional[list[str]] = None
+
+
+class AgentLoader:
+    """Loads agent templates from .md files."""
+
+    def __init__(self, templates_path: str):
+        """
+        Initialize loader.
+
+        Args:
+            templates_path: Path to directory containing agent .md files
+        """
+        self.templates_path = Path(templates_path)
+        if not self.templates_path.exists():
+            raise FileNotFoundError(f"Templates path not found: {templates_path}")
+
+    def load_agent(self, agent_name: str) -> AgentTemplate:
+        """
+        Load agent template from .md file.
+
+        Args:
+            agent_name: Name of agent (e.g., "scout", "detective")
+
+        Returns:
+            AgentTemplate with parsed frontmatter and system prompt
+
+        Raises:
+            FileNotFoundError: If agent .md file doesn't exist
+            ValueError: If frontmatter is invalid
+        """
+        agent_file = self.templates_path / f"{agent_name}.md"
+
+        if not agent_file.exists():
+            raise FileNotFoundError(f"Agent template not found: {agent_file}")
+
+        content = agent_file.read_text()
+
+        # Parse frontmatter (YAML between --- markers)
+        frontmatter_match = re.match(r'^---\n(.*?)\n---\n(.*)$', content, re.DOTALL)
+
+        if not frontmatter_match:
+            raise ValueError(f"Invalid agent template (missing frontmatter): {agent_file}")
+
+        frontmatter_yaml = frontmatter_match.group(1)
+        system_prompt = frontmatter_match.group(2).strip()
+
+        try:
+            frontmatter = yaml.safe_load(frontmatter_yaml)
+        except yaml.YAMLError as e:
+            raise ValueError(f"Invalid YAML frontmatter in {agent_file}: {e}")
+
+        return AgentTemplate(
+            name=frontmatter["name"],
+            model=frontmatter["model"],
+            description=frontmatter["description"],
+            tools=frontmatter.get("tools", []),
+            skills=frontmatter.get("skills"),
+            system_prompt=system_prompt,
+        )

.agents/skills/create-beads-orchestration/mcp-provider-delegator/src/mcp_provider_delegator/provider_client.py

@@ -0,0 +1,322 @@
+"""Provider clients for invoking agents via Codex, Gemini, etc."""
+
+import asyncio
+import logging
+import os
+from abc import ABC, abstractmethod
+from dataclasses import dataclass
+from typing import Optional
+
+logger = logging.getLogger(__name__)
+
+
+class RateLimitError(Exception):
+    """Raised when a provider hits rate limits."""
+    pass
+
+
+@dataclass
+class FallbackHint:
+    """Hint for falling back to Claude Task tool."""
+    subagent_type: str
+    model: str
+    prompt: str
+
+    def to_string(self) -> str:
+        """Generate Task() call suggestion."""
+        # Escape the prompt for display
+        # Include PROVIDER_FALLBACK marker so hooks allow bypass
+        escaped_prompt = self.prompt.replace('"', '\\"')[:500]
+        if len(self.prompt) > 500:
+            escaped_prompt += "..."
+        return f'''Task(
+    subagent_type="{self.subagent_type}",
+    model="{self.model}",
+    prompt="PROVIDER_FALLBACK: {escaped_prompt}"
+)'''
+
+
+@dataclass
+class InvokeResult:
+    """Result of a provider invocation."""
+    success: bool
+    response: str
+    provider: str
+    error: Optional[str] = None
+    fallback_hint: Optional[FallbackHint] = None
+
+
+class ProviderClient(ABC):
+    """Abstract base class for AI provider clients."""
+
+    name: str = "base"
+
+    @abstractmethod
+    async def invoke(self, prompt: str) -> str:
+        """Invoke the provider with a prompt."""
+        pass
+
+    def is_rate_limit_error(self, error_msg: str) -> bool:
+        """Check if error message indicates rate limiting."""
+        rate_limit_indicators = [
+            "rate limit",
+            "429",
+            "too many requests",
+            "usage limit",
+            "quota exceeded",
+        ]
+        error_lower = error_msg.lower()
+        return any(indicator in error_lower for indicator in rate_limit_indicators)
+
+
+class CodexClient(ProviderClient):
+    """Client for OpenAI Codex."""
+
+    name = "codex"
+
+    # Map agent model preferences to Codex models
+    MODEL_MAPPING = {
+        "haiku": "gpt-5.1-codex-mini",
+        "sonnet": "gpt-5.2-codex",
+        "opus": "gpt-5.1-codex-max",
+    }
+
+    def __init__(self, model: str = "gpt-5.2-codex"):
+        self.model = model
+
+    @classmethod
+    def map_model(cls, agent_model: str) -> str:
+        """Map agent's preferred model to Codex model."""
+        return cls.MODEL_MAPPING.get(agent_model, "gpt-5.2-codex")
+
+    async def invoke(self, prompt: str) -> str:
+        """Invoke Codex with prompt."""
+        cmd = [
+            "codex",
+            "exec",
+            "-m", self.model,
+            "--sandbox", "workspace-write",
+            prompt,
+        ]
+
+        logger.info(f"[Codex] Invoking with model: {self.model}")
+
+        try:
+            cwd = os.getcwd()
+            env = os.environ.copy()
+
+            process = await asyncio.create_subprocess_exec(
+                *cmd,
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.PIPE,
+                env=env,
+                cwd=cwd,
+            )
+
+            stdout, stderr = await process.communicate()
+
+            if process.returncode != 0:
+                error_msg = stderr.decode() if stderr else "Unknown error"
+                if self.is_rate_limit_error(error_msg):
+                    raise RateLimitError(f"Codex rate limit: {error_msg}")
+                raise RuntimeError(f"Codex failed: {error_msg}")
+
+            response = stdout.decode().strip()
+            logger.info(f"[Codex] Response length: {len(response)} chars")
+            return response
+
+        except FileNotFoundError:
+            raise RuntimeError("Codex CLI not found. Install with: codex login")
+
+
+class GeminiClient(ProviderClient):
+    """Client for Google Gemini."""
+
+    name = "gemini"
+    model = "gemini-3-flash-preview"
+
+    async def invoke(self, prompt: str) -> str:
+        """Invoke Gemini with prompt."""
+        cmd = [
+            "gemini",
+            "-p", prompt,
+            "-m", self.model,
+            "-y",  # Auto-approve tool calls for agentic execution
+        ]
+
+        logger.info(f"[Gemini] Invoking with model: {self.model}")
+
+        try:
+            cwd = os.getcwd()
+            env = os.environ.copy()
+
+            process = await asyncio.create_subprocess_exec(
+                *cmd,
+                stdout=asyncio.subprocess.PIPE,
+                stderr=asyncio.subprocess.PIPE,
+                env=env,
+                cwd=cwd,
+            )
+
+            stdout, stderr = await process.communicate()
+
+            if process.returncode != 0:
+                error_msg = stderr.decode() if stderr else "Unknown error"
+                if self.is_rate_limit_error(error_msg):
+                    raise RateLimitError(f"Gemini rate limit: {error_msg}")
+                raise RuntimeError(f"Gemini failed: {error_msg}")
+
+            response = stdout.decode().strip()
+            logger.info(f"[Gemini] Response length: {len(response)} chars")
+            return response
+
+        except FileNotFoundError:
+            raise RuntimeError("Gemini CLI not found. Install with: pip install gemini-cli")
+
+
+# Map agent names to Claude Task subagent_types for fallback
+# These match the subagent_type values available in Claude Code's Task tool
+AGENT_TO_SUBAGENT = {
+    "scout": "scout",
+    "detective": "scout",  # detective uses scout for investigation
+    "architect": "Plan",
+    "scribe": "scout",  # scribe reads codebase to document
+    "code-reviewer": "superpowers:code-reviewer",
+}
+
+# Map agent model preferences to Claude Task models
+AGENT_MODEL_TO_TASK_MODEL = {
+    "haiku": "haiku",
+    "sonnet": "sonnet",
+    "opus": "opus",
+}
+
+
+class ProviderChain:
+    """Chain of providers with fallback support."""
+
+    def __init__(
+        self,
+        providers: list[ProviderClient],
+        allow_skip: bool = False,
+        agent_name: str = "",
+        agent_model: str = "sonnet",
+    ):
+        """
+        Initialize provider chain.
+
+        Args:
+            providers: List of providers to try in order
+            allow_skip: If True, return skip message when all providers fail
+            agent_name: Name of the agent (for fallback hints)
+            agent_model: Agent's preferred model (for fallback hints)
+        """
+        self.providers = providers
+        self.allow_skip = allow_skip
+        self.agent_name = agent_name
+        self.agent_model = agent_model
+
+    def _create_fallback_hint(self, user_prompt: str) -> FallbackHint:
+        """Create a fallback hint for Claude Task tool."""
+        subagent_type = AGENT_TO_SUBAGENT.get(self.agent_name, "general-purpose")
+        task_model = AGENT_MODEL_TO_TASK_MODEL.get(self.agent_model, "sonnet")
+        return FallbackHint(
+            subagent_type=subagent_type,
+            model=task_model,
+            prompt=user_prompt,
+        )
+
+    async def invoke(
+        self,
+        system_prompt: str,
+        user_prompt: str,
+        task_id: Optional[str] = None,
+    ) -> InvokeResult:
+        """
+        Invoke providers in chain until one succeeds.
+
+        Returns:
+            InvokeResult with success status, response, and provider used
+        """
+        combined_prompt = f"{system_prompt}\n\n---\n\n{user_prompt}"
+        if task_id:
+            combined_prompt = f"TASK_ID: {task_id}\n\n{combined_prompt}"
+
+        errors = []
+
+        for provider in self.providers:
+            try:
+                logger.info(f"Trying provider: {provider.name}")
+                response = await provider.invoke(combined_prompt)
+                return InvokeResult(
+                    success=True,
+                    response=response,
+                    provider=provider.name,
+                )
+            except RateLimitError as e:
+                logger.warning(f"{provider.name} rate limited: {e}")
+                errors.append(f"{provider.name}: rate limited")
+                continue
+            except RuntimeError as e:
+                logger.error(f"{provider.name} failed: {e}")
+                errors.append(f"{provider.name}: {e}")
+                continue
+
+        # All providers failed
+        if self.allow_skip:
+            return InvokeResult(
+                success=True,  # Skip is a valid outcome
+                response="SKIPPED: All providers rate limited. Task skipped.",
+                provider="skip",
+                error="; ".join(errors),
+            )
+
+        # Create fallback hint for non-skippable agents
+        fallback_hint = self._create_fallback_hint(user_prompt)
+        fallback_response = f"""PROVIDER_FALLBACK_REQUIRED
+
+All external providers (Codex, Gemini) failed for agent '{self.agent_name}'.
+Errors: {'; '.join(errors)}
+
+To complete this task, use Claude Task tool instead:
+
+{fallback_hint.to_string()}
+
+Note: The Task tool runs locally and doesn't have the same rate limits."""
+
+        return InvokeResult(
+            success=False,
+            response=fallback_response,
+            provider="none",
+            error=f"All providers failed: {'; '.join(errors)}",
+            fallback_hint=fallback_hint,
+        )
+
+
+def create_provider_chain(agent_model: str, agent_name: str) -> ProviderChain:
+    """
+    Create a provider chain for an agent.
+
+    Args:
+        agent_model: Agent's preferred model (haiku, sonnet, opus)
+        agent_name: Name of the agent (for skip logic and fallback hints)
+
+    Returns:
+        ProviderChain configured for the agent
+    """
+    codex_model = CodexClient.map_model(agent_model)
+
+    providers = [
+        CodexClient(model=codex_model),
+        GeminiClient(),
+    ]
+
+    # Code reviewer can be skipped if all providers fail
+    allow_skip = agent_name == "code-reviewer"
+
+    return ProviderChain(
+        providers=providers,
+        allow_skip=allow_skip,
+        agent_name=agent_name,
+        agent_model=agent_model,
+    )

.agents/skills/create-beads-orchestration/mcp-provider-delegator/src/mcp_provider_delegator/server.py

@@ -0,0 +1,133 @@
+"""MCP server for delegating agents to AI providers with fallback support."""
+
+import asyncio
+import logging
+import os
+from typing import Any
+
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+from mcp.types import Tool, TextContent
+
+from .agent_loader import AgentLoader
+from .provider_client import create_provider_chain
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+# Initialize components
+# AGENT_TEMPLATES_PATH should be set via .mcp.json env config
+AGENT_TEMPLATES_PATH = os.getenv("AGENT_TEMPLATES_PATH", ".claude/agents")
+
+agent_loader = AgentLoader(templates_path=AGENT_TEMPLATES_PATH)
+
+# Initialize MCP server
+app = Server("provider-delegator")
+
+@app.list_tools()
+async def list_tools() -> list[Tool]:
+    """List available tools."""
+    return [
+        Tool(
+            name="invoke_agent",
+            description=(
+                "Delegate a task to a specialized agent. "
+                "Tries Codex first, falls back to Gemini if rate limited. "
+                "Available agents: scout, detective, architect, scribe, code-reviewer. "
+                "Agents have full MCP tool access (context7, vibe_kanban, playwright, github)."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "agent": {
+                        "type": "string",
+                        "enum": ["scout", "detective", "architect", "scribe", "code-reviewer"],
+                        "description": "Which agent to invoke",
+                    },
+                    "task_prompt": {
+                        "type": "string",
+                        "description": "The task prompt/instructions for the agent",
+                    },
+                    "task_id": {
+                        "type": "string",
+                        "description": "Optional Kanban task ID (e.g., RCH-123) for tracking",
+                    },
+                },
+                "required": ["agent", "task_prompt"],
+            },
+        )
+    ]
+
+@app.call_tool()
+async def call_tool(name: str, arguments: Any) -> list[TextContent]:
+    """Handle tool calls."""
+    if name != "invoke_agent":
+        raise ValueError(f"Unknown tool: {name}")
+
+    agent_name = arguments["agent"]
+    task_prompt = arguments["task_prompt"]
+    task_id = arguments.get("task_id")
+
+    logger.info(f"Invoking agent: {agent_name} (task_id: {task_id})")
+
+    try:
+        # Load agent template
+        template = agent_loader.load_agent(agent_name)
+        logger.info(f"Loaded template for {agent_name} (model: {template.model})")
+
+        # Create provider chain with fallback support
+        chain = create_provider_chain(
+            agent_model=template.model,
+            agent_name=agent_name,
+        )
+
+        # Invoke with fallback chain: Codex -> Gemini -> Skip (for code-reviewer)
+        result = await chain.invoke(
+            system_prompt=template.system_prompt,
+            user_prompt=task_prompt,
+            task_id=task_id,
+        )
+
+        if result.success:
+            logger.info(f"Agent {agent_name} completed via {result.provider}")
+            return [TextContent(
+                type="text",
+                text=result.response
+            )]
+        else:
+            # Return fallback hint response (includes Task() suggestion)
+            logger.warning(f"Agent {agent_name} failed, returning fallback hint")
+            return [TextContent(
+                type="text",
+                text=result.response  # Contains PROVIDER_FALLBACK_REQUIRED with Task() hint
+            )]
+
+    except FileNotFoundError as e:
+        error_msg = f"Agent template not found: {agent_name}. Error: {e}"
+        logger.error(error_msg)
+        return [TextContent(type="text", text=f"ERROR: {error_msg}")]
+
+    except Exception as e:
+        error_msg = f"Unexpected error invoking {agent_name}: {e}"
+        logger.exception(error_msg)
+        return [TextContent(type="text", text=f"ERROR: {error_msg}")]
+
+async def main():
+    """Run the MCP server."""
+    logger.info("Starting MCP Provider Delegator")
+    logger.info(f"Agent templates path: {AGENT_TEMPLATES_PATH}")
+    logger.info("Fallback chain: Codex -> Gemini -> Skip (code-reviewer only)")
+
+    async with stdio_server() as (read_stream, write_stream):
+        await app.run(
+            read_stream,
+            write_stream,
+            app.create_initialization_options()
+        )
+
+def run():
+    """Entry point for CLI."""
+    asyncio.run(main())
+
+if __name__ == "__main__":
+    run()

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/fixtures/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/fixtures/scout.md

@@ -0,0 +1,16 @@
+---
+name: scout
+description: Scout agent for codebase exploration
+model: haiku
+tools:
+  - Read
+  - Glob
+  - Grep
+---
+
+# Scout: "Ivy"
+
+You are **Ivy**, the Scout.
+
+## Your Purpose
+Explore the codebase to find files and structure.

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/test_agent_loader.py

@@ -0,0 +1,26 @@
+"""Tests for agent template loader."""
+
+import os
+import pytest
+from pathlib import Path
+from mcp_provider_delegator.agent_loader import AgentLoader, AgentTemplate
+
+FIXTURES_DIR = Path(__file__).parent / "fixtures"
+
+def test_load_agent_template():
+    """Test loading agent template from .md file."""
+    loader = AgentLoader(templates_path=str(FIXTURES_DIR))
+    template = loader.load_agent("scout")
+
+    assert template.name == "scout"
+    assert template.model == "haiku"
+    assert template.description == "Scout agent for codebase exploration"
+    assert "Read" in template.tools
+    assert "Ivy" in template.system_prompt
+    assert "Your Purpose" in template.system_prompt
+
+def test_load_nonexistent_agent():
+    """Test loading non-existent agent raises error."""
+    loader = AgentLoader(templates_path=str(FIXTURES_DIR))
+    with pytest.raises(FileNotFoundError):
+        loader.load_agent("nonexistent")

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/test_integration.py

@@ -0,0 +1,38 @@
+"""Integration tests for full agent delegation flow."""
+
+import pytest
+from mcp_provider_delegator.server import app
+
+@pytest.mark.integration
+@pytest.mark.asyncio
+async def test_invoke_scout_end_to_end():
+    """Test full scout agent invocation. Requires Codex CLI and agent templates."""
+    result = await app.call_tool(
+        "invoke_agent",
+        {
+            "agent": "scout",
+            "task_prompt": "Find all Python files in the src/ directory",
+        }
+    )
+
+    assert len(result) == 1
+    # Scout should report findings or indicate agent was invoked
+    assert result[0].text
+    assert not result[0].text.startswith("ERROR")
+
+@pytest.mark.integration
+@pytest.mark.asyncio
+async def test_invoke_detective_with_task_id():
+    """Test detective agent with Kanban task tracking."""
+    result = await app.call_tool(
+        "invoke_agent",
+        {
+            "agent": "detective",
+            "task_prompt": "Investigate why tests are failing",
+            "task_id": "RCH-999",
+        }
+    )
+
+    assert len(result) == 1
+    assert result[0].text
+    assert not result[0].text.startswith("ERROR")

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/test_provider_client.py

@@ -0,0 +1,58 @@
+"""Tests for Provider API clients."""
+
+import pytest
+from mcp_provider_delegator.provider_client import (
+    CodexClient,
+    GeminiClient,
+    ProviderChain,
+    RateLimitError,
+    create_provider_chain,
+)
+
+
+def test_codex_model_mapping():
+    """Test model mapping from agent models to Codex models."""
+    assert CodexClient.map_model("haiku") == "gpt-5.1-codex-mini"
+    assert CodexClient.map_model("sonnet") == "gpt-5.2-codex"
+    assert CodexClient.map_model("opus") == "gpt-5.1-codex-max"
+    assert CodexClient.map_model("unknown") == "gpt-5.2-codex"
+
+
+def test_create_provider_chain_code_reviewer():
+    """Test that code-reviewer allows skip on failure."""
+    chain = create_provider_chain("haiku", "code-reviewer")
+    assert chain.allow_skip is True
+    assert len(chain.providers) == 2  # Codex + Gemini
+
+
+def test_create_provider_chain_other_agents():
+    """Test that other agents don't allow skip."""
+    chain = create_provider_chain("opus", "detective")
+    assert chain.allow_skip is False
+    assert len(chain.providers) == 2
+
+
+@pytest.mark.integration
+@pytest.mark.asyncio
+async def test_invoke_codex_simple():
+    """Test invoking Codex with simple prompt. Requires Codex CLI."""
+    client = CodexClient(model="gpt-5.2-codex")
+
+    result = await client.invoke(
+        prompt="You are a helpful assistant. Say hello."
+    )
+
+    assert "hello" in result.lower()
+
+
+@pytest.mark.integration
+@pytest.mark.asyncio
+async def test_invoke_gemini_simple():
+    """Test invoking Gemini with simple prompt. Requires Gemini CLI."""
+    client = GeminiClient()
+
+    result = await client.invoke(
+        prompt="You are a helpful assistant. Say hello."
+    )
+
+    assert "hello" in result.lower()

.agents/skills/create-beads-orchestration/mcp-provider-delegator/tests/test_server.py

@@ -0,0 +1,28 @@
+"""Tests for MCP server."""
+
+import pytest
+from mcp_provider_delegator import server
+
+@pytest.mark.asyncio
+async def test_list_tools():
+    """Test that invoke_agent tool is registered."""
+    tools = await server.list_tools()
+    assert len(tools) == 1
+    assert tools[0].name == "invoke_agent"
+    assert "scout" in str(tools[0].inputSchema)
+
+@pytest.mark.asyncio
+async def test_invoke_agent_error_handling():
+    """Test invoke_agent handles errors gracefully (providers not available in test env)."""
+    result = await server.call_tool(
+        "invoke_agent",
+        {
+            "agent": "scout",
+            "task_prompt": "Find authentication files"
+        }
+    )
+    assert len(result) == 1
+    # In test environment without providers, should get error response
+    assert result[0].text
+    # Either succeeds (if providers configured) or returns error
+    assert isinstance(result[0].text, str)

.agents/skills/create-beads-orchestration/mcp-provider-delegator/uv.lock

@@ -0,0 +1,815 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
+]
+
+[[package]]
+name = "attrs"
+version = "25.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6b/5c/685e6633917e101e5dcb62b9dd76946cbb57c26e133bae9e0cd36033c0a9/attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11", size = 934251, upload-time = "2025-10-06T13:54:44.725Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3a/2a/7cc015f5b9f5db42b7d48157e23356022889fc354a2813c15934b7cb5c0e/attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373", size = 67615, upload-time = "2025-10-06T13:54:43.17Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
+]
+
+[[package]]
+name = "cffi"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pycparser", marker = "implementation_name != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/eb/56/b1ba7935a17738ae8453301356628e8147c79dbb825bcbc73dc7401f9846/cffi-2.0.0.tar.gz", hash = "sha256:44d1b5909021139fe36001ae048dbdde8214afa20200eda0f64c068cac5d5529", size = 523588, upload-time = "2025-09-08T23:24:04.541Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/4a/3dfd5f7850cbf0d06dc84ba9aa00db766b52ca38d8b86e3a38314d52498c/cffi-2.0.0-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:b4c854ef3adc177950a8dfc81a86f5115d2abd545751a304c5bcf2c2c7283cfe", size = 184344, upload-time = "2025-09-08T23:22:26.456Z" },
+    { url = "https://files.pythonhosted.org/packages/4f/8b/f0e4c441227ba756aafbe78f117485b25bb26b1c059d01f137fa6d14896b/cffi-2.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:2de9a304e27f7596cd03d16f1b7c72219bd944e99cc52b84d0145aefb07cbd3c", size = 180560, upload-time = "2025-09-08T23:22:28.197Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/b7/1200d354378ef52ec227395d95c2576330fd22a869f7a70e88e1447eb234/cffi-2.0.0-cp311-cp311-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:baf5215e0ab74c16e2dd324e8ec067ef59e41125d3eade2b863d294fd5035c92", size = 209613, upload-time = "2025-09-08T23:22:29.475Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/56/6033f5e86e8cc9bb629f0077ba71679508bdf54a9a5e112a3c0b91870332/cffi-2.0.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:730cacb21e1bdff3ce90babf007d0a0917cc3e6492f336c2f0134101e0944f93", size = 216476, upload-time = "2025-09-08T23:22:31.063Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/7f/55fecd70f7ece178db2f26128ec41430d8720f2d12ca97bf8f0a628207d5/cffi-2.0.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:6824f87845e3396029f3820c206e459ccc91760e8fa24422f8b0c3d1731cbec5", size = 203374, upload-time = "2025-09-08T23:22:32.507Z" },
+    { url = "https://files.pythonhosted.org/packages/84/ef/a7b77c8bdc0f77adc3b46888f1ad54be8f3b7821697a7b89126e829e676a/cffi-2.0.0-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:9de40a7b0323d889cf8d23d1ef214f565ab154443c42737dfe52ff82cf857664", size = 202597, upload-time = "2025-09-08T23:22:34.132Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/91/500d892b2bf36529a75b77958edfcd5ad8e2ce4064ce2ecfeab2125d72d1/cffi-2.0.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:8941aaadaf67246224cee8c3803777eed332a19d909b47e29c9842ef1e79ac26", size = 215574, upload-time = "2025-09-08T23:22:35.443Z" },
+    { url = "https://files.pythonhosted.org/packages/44/64/58f6255b62b101093d5df22dcb752596066c7e89dd725e0afaed242a61be/cffi-2.0.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:a05d0c237b3349096d3981b727493e22147f934b20f6f125a3eba8f994bec4a9", size = 218971, upload-time = "2025-09-08T23:22:36.805Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/49/fa72cebe2fd8a55fbe14956f9970fe8eb1ac59e5df042f603ef7c8ba0adc/cffi-2.0.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:94698a9c5f91f9d138526b48fe26a199609544591f859c870d477351dc7b2414", size = 211972, upload-time = "2025-09-08T23:22:38.436Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/28/dd0967a76aab36731b6ebfe64dec4e981aff7e0608f60c2d46b46982607d/cffi-2.0.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:5fed36fccc0612a53f1d4d9a816b50a36702c28a2aa880cb8a122b3466638743", size = 217078, upload-time = "2025-09-08T23:22:39.776Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/c0/015b25184413d7ab0a410775fdb4a50fca20f5589b5dab1dbbfa3baad8ce/cffi-2.0.0-cp311-cp311-win32.whl", hash = "sha256:c649e3a33450ec82378822b3dad03cc228b8f5963c0c12fc3b1e0ab940f768a5", size = 172076, upload-time = "2025-09-08T23:22:40.95Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/8f/dc5531155e7070361eb1b7e4c1a9d896d0cb21c49f807a6c03fd63fc877e/cffi-2.0.0-cp311-cp311-win_amd64.whl", hash = "sha256:66f011380d0e49ed280c789fbd08ff0d40968ee7b665575489afa95c98196ab5", size = 182820, upload-time = "2025-09-08T23:22:42.463Z" },
+    { url = "https://files.pythonhosted.org/packages/95/5c/1b493356429f9aecfd56bc171285a4c4ac8697f76e9bbbbb105e537853a1/cffi-2.0.0-cp311-cp311-win_arm64.whl", hash = "sha256:c6638687455baf640e37344fe26d37c404db8b80d037c3d29f58fe8d1c3b194d", size = 177635, upload-time = "2025-09-08T23:22:43.623Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/47/4f61023ea636104d4f16ab488e268b93008c3d0bb76893b1b31db1f96802/cffi-2.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:6d02d6655b0e54f54c4ef0b94eb6be0607b70853c45ce98bd278dc7de718be5d", size = 185271, upload-time = "2025-09-08T23:22:44.795Z" },
+    { url = "https://files.pythonhosted.org/packages/df/a2/781b623f57358e360d62cdd7a8c681f074a71d445418a776eef0aadb4ab4/cffi-2.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8eca2a813c1cb7ad4fb74d368c2ffbbb4789d377ee5bb8df98373c2cc0dee76c", size = 181048, upload-time = "2025-09-08T23:22:45.938Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/df/a4f0fbd47331ceeba3d37c2e51e9dfc9722498becbeec2bd8bc856c9538a/cffi-2.0.0-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:21d1152871b019407d8ac3985f6775c079416c282e431a4da6afe7aefd2bccbe", size = 212529, upload-time = "2025-09-08T23:22:47.349Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/72/12b5f8d3865bf0f87cf1404d8c374e7487dcf097a1c91c436e72e6badd83/cffi-2.0.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b21e08af67b8a103c71a250401c78d5e0893beff75e28c53c98f4de42f774062", size = 220097, upload-time = "2025-09-08T23:22:48.677Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/95/7a135d52a50dfa7c882ab0ac17e8dc11cec9d55d2c18dda414c051c5e69e/cffi-2.0.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:1e3a615586f05fc4065a8b22b8152f0c1b00cdbc60596d187c2a74f9e3036e4e", size = 207983, upload-time = "2025-09-08T23:22:50.06Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/c8/15cb9ada8895957ea171c62dc78ff3e99159ee7adb13c0123c001a2546c1/cffi-2.0.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:81afed14892743bbe14dacb9e36d9e0e504cd204e0b165062c488942b9718037", size = 206519, upload-time = "2025-09-08T23:22:51.364Z" },
+    { url = "https://files.pythonhosted.org/packages/78/2d/7fa73dfa841b5ac06c7b8855cfc18622132e365f5b81d02230333ff26e9e/cffi-2.0.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:3e17ed538242334bf70832644a32a7aae3d83b57567f9fd60a26257e992b79ba", size = 219572, upload-time = "2025-09-08T23:22:52.902Z" },
+    { url = "https://files.pythonhosted.org/packages/07/e0/267e57e387b4ca276b90f0434ff88b2c2241ad72b16d31836adddfd6031b/cffi-2.0.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3925dd22fa2b7699ed2617149842d2e6adde22b262fcbfada50e3d195e4b3a94", size = 222963, upload-time = "2025-09-08T23:22:54.518Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/75/1f2747525e06f53efbd878f4d03bac5b859cbc11c633d0fb81432d98a795/cffi-2.0.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:2c8f814d84194c9ea681642fd164267891702542f028a15fc97d4674b6206187", size = 221361, upload-time = "2025-09-08T23:22:55.867Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/2b/2b6435f76bfeb6bbf055596976da087377ede68df465419d192acf00c437/cffi-2.0.0-cp312-cp312-win32.whl", hash = "sha256:da902562c3e9c550df360bfa53c035b2f241fed6d9aef119048073680ace4a18", size = 172932, upload-time = "2025-09-08T23:22:57.188Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/ed/13bd4418627013bec4ed6e54283b1959cf6db888048c7cf4b4c3b5b36002/cffi-2.0.0-cp312-cp312-win_amd64.whl", hash = "sha256:da68248800ad6320861f129cd9c1bf96ca849a2771a59e0344e88681905916f5", size = 183557, upload-time = "2025-09-08T23:22:58.351Z" },
+    { url = "https://files.pythonhosted.org/packages/95/31/9f7f93ad2f8eff1dbc1c3656d7ca5bfd8fb52c9d786b4dcf19b2d02217fa/cffi-2.0.0-cp312-cp312-win_arm64.whl", hash = "sha256:4671d9dd5ec934cb9a73e7ee9676f9362aba54f7f34910956b84d727b0d73fb6", size = 177762, upload-time = "2025-09-08T23:22:59.668Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/8d/a0a47a0c9e413a658623d014e91e74a50cdd2c423f7ccfd44086ef767f90/cffi-2.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:00bdf7acc5f795150faa6957054fbbca2439db2f775ce831222b66f192f03beb", size = 185230, upload-time = "2025-09-08T23:23:00.879Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/d2/a6c0296814556c68ee32009d9c2ad4f85f2707cdecfd7727951ec228005d/cffi-2.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:45d5e886156860dc35862657e1494b9bae8dfa63bf56796f2fb56e1679fc0bca", size = 181043, upload-time = "2025-09-08T23:23:02.231Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/1e/d22cc63332bd59b06481ceaac49d6c507598642e2230f201649058a7e704/cffi-2.0.0-cp313-cp313-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl", hash = "sha256:07b271772c100085dd28b74fa0cd81c8fb1a3ba18b21e03d7c27f3436a10606b", size = 212446, upload-time = "2025-09-08T23:23:03.472Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/f5/a2c23eb03b61a0b8747f211eb716446c826ad66818ddc7810cc2cc19b3f2/cffi-2.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d48a880098c96020b02d5a1f7d9251308510ce8858940e6fa99ece33f610838b", size = 220101, upload-time = "2025-09-08T23:23:04.792Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/7f/e6647792fc5850d634695bc0e6ab4111ae88e89981d35ac269956605feba/cffi-2.0.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:f93fd8e5c8c0a4aa1f424d6173f14a892044054871c771f8566e4008eaa359d2", size = 207948, upload-time = "2025-09-08T23:23:06.127Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/1e/a5a1bd6f1fb30f22573f76533de12a00bf274abcdc55c8edab639078abb6/cffi-2.0.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:dd4f05f54a52fb558f1ba9f528228066954fee3ebe629fc1660d874d040ae5a3", size = 206422, upload-time = "2025-09-08T23:23:07.753Z" },
+    { url = "https://files.pythonhosted.org/packages/98/df/0a1755e750013a2081e863e7cd37e0cdd02664372c754e5560099eb7aa44/cffi-2.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c8d3b5532fc71b7a77c09192b4a5a200ea992702734a2e9279a37f2478236f26", size = 219499, upload-time = "2025-09-08T23:23:09.648Z" },
+    { url = "https://files.pythonhosted.org/packages/50/e1/a969e687fcf9ea58e6e2a928ad5e2dd88cc12f6f0ab477e9971f2309b57c/cffi-2.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d9b29c1f0ae438d5ee9acb31cadee00a58c46cc9c0b2f9038c6b0b3470877a8c", size = 222928, upload-time = "2025-09-08T23:23:10.928Z" },
+    { url = "https://files.pythonhosted.org/packages/36/54/0362578dd2c9e557a28ac77698ed67323ed5b9775ca9d3fe73fe191bb5d8/cffi-2.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6d50360be4546678fc1b79ffe7a66265e28667840010348dd69a314145807a1b", size = 221302, upload-time = "2025-09-08T23:23:12.42Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/6d/bf9bda840d5f1dfdbf0feca87fbdb64a918a69bca42cfa0ba7b137c48cb8/cffi-2.0.0-cp313-cp313-win32.whl", hash = "sha256:74a03b9698e198d47562765773b4a8309919089150a0bb17d829ad7b44b60d27", size = 172909, upload-time = "2025-09-08T23:23:14.32Z" },
+    { url = "https://files.pythonhosted.org/packages/37/18/6519e1ee6f5a1e579e04b9ddb6f1676c17368a7aba48299c3759bbc3c8b3/cffi-2.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:19f705ada2530c1167abacb171925dd886168931e0a7b78f5bffcae5c6b5be75", size = 183402, upload-time = "2025-09-08T23:23:15.535Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/0e/02ceeec9a7d6ee63bb596121c2c8e9b3a9e150936f4fbef6ca1943e6137c/cffi-2.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:256f80b80ca3853f90c21b23ee78cd008713787b1b1e93eae9f3d6a7134abd91", size = 177780, upload-time = "2025-09-08T23:23:16.761Z" },
+    { url = "https://files.pythonhosted.org/packages/92/c4/3ce07396253a83250ee98564f8d7e9789fab8e58858f35d07a9a2c78de9f/cffi-2.0.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:fc33c5141b55ed366cfaad382df24fe7dcbc686de5be719b207bb248e3053dc5", size = 185320, upload-time = "2025-09-08T23:23:18.087Z" },
+    { url = "https://files.pythonhosted.org/packages/59/dd/27e9fa567a23931c838c6b02d0764611c62290062a6d4e8ff7863daf9730/cffi-2.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c654de545946e0db659b3400168c9ad31b5d29593291482c43e3564effbcee13", size = 181487, upload-time = "2025-09-08T23:23:19.622Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/43/0e822876f87ea8a4ef95442c3d766a06a51fc5298823f884ef87aaad168c/cffi-2.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:24b6f81f1983e6df8db3adc38562c83f7d4a0c36162885ec7f7b77c7dcbec97b", size = 220049, upload-time = "2025-09-08T23:23:20.853Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/89/76799151d9c2d2d1ead63c2429da9ea9d7aac304603de0c6e8764e6e8e70/cffi-2.0.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:12873ca6cb9b0f0d3a0da705d6086fe911591737a59f28b7936bdfed27c0d47c", size = 207793, upload-time = "2025-09-08T23:23:22.08Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/dd/3465b14bb9e24ee24cb88c9e3730f6de63111fffe513492bf8c808a3547e/cffi-2.0.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:d9b97165e8aed9272a6bb17c01e3cc5871a594a446ebedc996e2397a1c1ea8ef", size = 206300, upload-time = "2025-09-08T23:23:23.314Z" },
+    { url = "https://files.pythonhosted.org/packages/47/d9/d83e293854571c877a92da46fdec39158f8d7e68da75bf73581225d28e90/cffi-2.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:afb8db5439b81cf9c9d0c80404b60c3cc9c3add93e114dcae767f1477cb53775", size = 219244, upload-time = "2025-09-08T23:23:24.541Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/0f/1f177e3683aead2bb00f7679a16451d302c436b5cbf2505f0ea8146ef59e/cffi-2.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:737fe7d37e1a1bffe70bd5754ea763a62a066dc5913ca57e957824b72a85e205", size = 222828, upload-time = "2025-09-08T23:23:26.143Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/0f/cafacebd4b040e3119dcb32fed8bdef8dfe94da653155f9d0b9dc660166e/cffi-2.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:38100abb9d1b1435bc4cc340bb4489635dc2f0da7456590877030c9b3d40b0c1", size = 220926, upload-time = "2025-09-08T23:23:27.873Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/aa/df335faa45b395396fcbc03de2dfcab242cd61a9900e914fe682a59170b1/cffi-2.0.0-cp314-cp314-win32.whl", hash = "sha256:087067fa8953339c723661eda6b54bc98c5625757ea62e95eb4898ad5e776e9f", size = 175328, upload-time = "2025-09-08T23:23:44.61Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/92/882c2d30831744296ce713f0feb4c1cd30f346ef747b530b5318715cc367/cffi-2.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:203a48d1fb583fc7d78a4c6655692963b860a417c0528492a6bc21f1aaefab25", size = 185650, upload-time = "2025-09-08T23:23:45.848Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/2c/98ece204b9d35a7366b5b2c6539c350313ca13932143e79dc133ba757104/cffi-2.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:dbd5c7a25a7cb98f5ca55d258b103a2054f859a46ae11aaf23134f9cc0d356ad", size = 180687, upload-time = "2025-09-08T23:23:47.105Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/61/c768e4d548bfa607abcda77423448df8c471f25dbe64fb2ef6d555eae006/cffi-2.0.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:9a67fc9e8eb39039280526379fb3a70023d77caec1852002b4da7e8b270c4dd9", size = 188773, upload-time = "2025-09-08T23:23:29.347Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/ea/5f76bce7cf6fcd0ab1a1058b5af899bfbef198bea4d5686da88471ea0336/cffi-2.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7a66c7204d8869299919db4d5069a82f1561581af12b11b3c9f48c584eb8743d", size = 185013, upload-time = "2025-09-08T23:23:30.63Z" },
+    { url = "https://files.pythonhosted.org/packages/be/b4/c56878d0d1755cf9caa54ba71e5d049479c52f9e4afc230f06822162ab2f/cffi-2.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7cc09976e8b56f8cebd752f7113ad07752461f48a58cbba644139015ac24954c", size = 221593, upload-time = "2025-09-08T23:23:31.91Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/0d/eb704606dfe8033e7128df5e90fee946bbcb64a04fcdaa97321309004000/cffi-2.0.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:92b68146a71df78564e4ef48af17551a5ddd142e5190cdf2c5624d0c3ff5b2e8", size = 209354, upload-time = "2025-09-08T23:23:33.214Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/19/3c435d727b368ca475fb8742ab97c9cb13a0de600ce86f62eab7fa3eea60/cffi-2.0.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b1e74d11748e7e98e2f426ab176d4ed720a64412b6a15054378afdb71e0f37dc", size = 208480, upload-time = "2025-09-08T23:23:34.495Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/44/681604464ed9541673e486521497406fadcc15b5217c3e326b061696899a/cffi-2.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:28a3a209b96630bca57cce802da70c266eb08c6e97e5afd61a75611ee6c64592", size = 221584, upload-time = "2025-09-08T23:23:36.096Z" },
+    { url = "https://files.pythonhosted.org/packages/25/8e/342a504ff018a2825d395d44d63a767dd8ebc927ebda557fecdaca3ac33a/cffi-2.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7553fb2090d71822f02c629afe6042c299edf91ba1bf94951165613553984512", size = 224443, upload-time = "2025-09-08T23:23:37.328Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/5e/b666bacbbc60fbf415ba9988324a132c9a7a0448a9a8f125074671c0f2c3/cffi-2.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:6c6c373cfc5c83a975506110d17457138c8c63016b563cc9ed6e056a82f13ce4", size = 223437, upload-time = "2025-09-08T23:23:38.945Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/1d/ec1a60bd1a10daa292d3cd6bb0b359a81607154fb8165f3ec95fe003b85c/cffi-2.0.0-cp314-cp314t-win32.whl", hash = "sha256:1fc9ea04857caf665289b7a75923f2c6ed559b8298a1b8c49e59f7dd95c8481e", size = 180487, upload-time = "2025-09-08T23:23:40.423Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/41/4c1168c74fac325c0c8156f04b6749c8b6a8f405bbf91413ba088359f60d/cffi-2.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d68b6cef7827e8641e8ef16f4494edda8b36104d79773a334beaa1e3521430f6", size = 191726, upload-time = "2025-09-08T23:23:41.742Z" },
+    { url = "https://files.pythonhosted.org/packages/ae/3a/dbeec9d1ee0844c679f6bb5d6ad4e9f198b1224f4e7a32825f47f6192b0c/cffi-2.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:0a1527a803f0a659de1af2e1fd700213caba79377e27e4693648c2923da066f9", size = 184195, upload-time = "2025-09-08T23:23:43.004Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "cryptography"
+version = "46.0.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/9f/33/c00162f49c0e2fe8064a62cb92b93e50c74a72bc370ab92f86112b33ff62/cryptography-46.0.3.tar.gz", hash = "sha256:a8b17438104fed022ce745b362294d9ce35b4c2e45c1d958ad4a4b019285f4a1", size = 749258, upload-time = "2025-10-15T23:18:31.74Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1d/42/9c391dd801d6cf0d561b5890549d4b27bafcc53b39c31a817e69d87c625b/cryptography-46.0.3-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:109d4ddfadf17e8e7779c39f9b18111a09efb969a301a31e987416a0191ed93a", size = 7225004, upload-time = "2025-10-15T23:16:52.239Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/67/38769ca6b65f07461eb200e85fc1639b438bdc667be02cf7f2cd6a64601c/cryptography-46.0.3-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:09859af8466b69bc3c27bdf4f5d84a665e0f7ab5088412e9e2ec49758eca5cbc", size = 4296667, upload-time = "2025-10-15T23:16:54.369Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/49/498c86566a1d80e978b42f0d702795f69887005548c041636df6ae1ca64c/cryptography-46.0.3-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:01ca9ff2885f3acc98c29f1860552e37f6d7c7d013d7334ff2a9de43a449315d", size = 4450807, upload-time = "2025-10-15T23:16:56.414Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/0a/863a3604112174c8624a2ac3c038662d9e59970c7f926acdcfaed8d61142/cryptography-46.0.3-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:6eae65d4c3d33da080cff9c4ab1f711b15c1d9760809dad6ea763f3812d254cb", size = 4299615, upload-time = "2025-10-15T23:16:58.442Z" },
+    { url = "https://files.pythonhosted.org/packages/64/02/b73a533f6b64a69f3cd3872acb6ebc12aef924d8d103133bb3ea750dc703/cryptography-46.0.3-cp311-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5bf0ed4490068a2e72ac03d786693adeb909981cc596425d09032d372bcc849", size = 4016800, upload-time = "2025-10-15T23:17:00.378Z" },
+    { url = "https://files.pythonhosted.org/packages/25/d5/16e41afbfa450cde85a3b7ec599bebefaef16b5c6ba4ec49a3532336ed72/cryptography-46.0.3-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:5ecfccd2329e37e9b7112a888e76d9feca2347f12f37918facbb893d7bb88ee8", size = 4984707, upload-time = "2025-10-15T23:17:01.98Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/56/e7e69b427c3878352c2fb9b450bd0e19ed552753491d39d7d0a2f5226d41/cryptography-46.0.3-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:a2c0cd47381a3229c403062f764160d57d4d175e022c1df84e168c6251a22eec", size = 4482541, upload-time = "2025-10-15T23:17:04.078Z" },
+    { url = "https://files.pythonhosted.org/packages/78/f6/50736d40d97e8483172f1bb6e698895b92a223dba513b0ca6f06b2365339/cryptography-46.0.3-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:549e234ff32571b1f4076ac269fcce7a808d3bf98b76c8dd560e42dbc66d7d91", size = 4299464, upload-time = "2025-10-15T23:17:05.483Z" },
+    { url = "https://files.pythonhosted.org/packages/00/de/d8e26b1a855f19d9994a19c702fa2e93b0456beccbcfe437eda00e0701f2/cryptography-46.0.3-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:c0a7bb1a68a5d3471880e264621346c48665b3bf1c3759d682fc0864c540bd9e", size = 4950838, upload-time = "2025-10-15T23:17:07.425Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/29/798fc4ec461a1c9e9f735f2fc58741b0daae30688f41b2497dcbc9ed1355/cryptography-46.0.3-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:10b01676fc208c3e6feeb25a8b83d81767e8059e1fe86e1dc62d10a3018fa926", size = 4481596, upload-time = "2025-10-15T23:17:09.343Z" },
+    { url = "https://files.pythonhosted.org/packages/15/8d/03cd48b20a573adfff7652b76271078e3045b9f49387920e7f1f631d125e/cryptography-46.0.3-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:0abf1ffd6e57c67e92af68330d05760b7b7efb243aab8377e583284dbab72c71", size = 4426782, upload-time = "2025-10-15T23:17:11.22Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/b1/ebacbfe53317d55cf33165bda24c86523497a6881f339f9aae5c2e13e57b/cryptography-46.0.3-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a04bee9ab6a4da801eb9b51f1b708a1b5b5c9eb48c03f74198464c66f0d344ac", size = 4698381, upload-time = "2025-10-15T23:17:12.829Z" },
+    { url = "https://files.pythonhosted.org/packages/96/92/8a6a9525893325fc057a01f654d7efc2c64b9de90413adcf605a85744ff4/cryptography-46.0.3-cp311-abi3-win32.whl", hash = "sha256:f260d0d41e9b4da1ed1e0f1ce571f97fe370b152ab18778e9e8f67d6af432018", size = 3055988, upload-time = "2025-10-15T23:17:14.65Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/bf/80fbf45253ea585a1e492a6a17efcb93467701fa79e71550a430c5e60df0/cryptography-46.0.3-cp311-abi3-win_amd64.whl", hash = "sha256:a9a3008438615669153eb86b26b61e09993921ebdd75385ddd748702c5adfddb", size = 3514451, upload-time = "2025-10-15T23:17:16.142Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/af/9b302da4c87b0beb9db4e756386a7c6c5b8003cd0e742277888d352ae91d/cryptography-46.0.3-cp311-abi3-win_arm64.whl", hash = "sha256:5d7f93296ee28f68447397bf5198428c9aeeab45705a55d53a6343455dcb2c3c", size = 2928007, upload-time = "2025-10-15T23:17:18.04Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/e2/a510aa736755bffa9d2f75029c229111a1d02f8ecd5de03078f4c18d91a3/cryptography-46.0.3-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:00a5e7e87938e5ff9ff5447ab086a5706a957137e6e433841e9d24f38a065217", size = 7158012, upload-time = "2025-10-15T23:17:19.982Z" },
+    { url = "https://files.pythonhosted.org/packages/73/dc/9aa866fbdbb95b02e7f9d086f1fccfeebf8953509b87e3f28fff927ff8a0/cryptography-46.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c8daeb2d2174beb4575b77482320303f3d39b8e81153da4f0fb08eb5fe86a6c5", size = 4288728, upload-time = "2025-10-15T23:17:21.527Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/fd/bc1daf8230eaa075184cbbf5f8cd00ba9db4fd32d63fb83da4671b72ed8a/cryptography-46.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:39b6755623145ad5eff1dab323f4eae2a32a77a7abef2c5089a04a3d04366715", size = 4435078, upload-time = "2025-10-15T23:17:23.042Z" },
+    { url = "https://files.pythonhosted.org/packages/82/98/d3bd5407ce4c60017f8ff9e63ffee4200ab3e23fe05b765cab805a7db008/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:db391fa7c66df6762ee3f00c95a89e6d428f4d60e7abc8328f4fe155b5ac6e54", size = 4293460, upload-time = "2025-10-15T23:17:24.885Z" },
+    { url = "https://files.pythonhosted.org/packages/26/e9/e23e7900983c2b8af7a08098db406cf989d7f09caea7897e347598d4cd5b/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:78a97cf6a8839a48c49271cdcbd5cf37ca2c1d6b7fdd86cc864f302b5e9bf459", size = 3995237, upload-time = "2025-10-15T23:17:26.449Z" },
+    { url = "https://files.pythonhosted.org/packages/91/15/af68c509d4a138cfe299d0d7ddb14afba15233223ebd933b4bbdbc7155d3/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:dfb781ff7eaa91a6f7fd41776ec37c5853c795d3b358d4896fdbb5df168af422", size = 4967344, upload-time = "2025-10-15T23:17:28.06Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/e3/8643d077c53868b681af077edf6b3cb58288b5423610f21c62aadcbe99f4/cryptography-46.0.3-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:6f61efb26e76c45c4a227835ddeae96d83624fb0d29eb5df5b96e14ed1a0afb7", size = 4466564, upload-time = "2025-10-15T23:17:29.665Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/43/c1e8726fa59c236ff477ff2b5dc071e54b21e5a1e51aa2cee1676f1c986f/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:23b1a8f26e43f47ceb6d6a43115f33a5a37d57df4ea0ca295b780ae8546e8044", size = 4292415, upload-time = "2025-10-15T23:17:31.686Z" },
+    { url = "https://files.pythonhosted.org/packages/42/f9/2f8fefdb1aee8a8e3256a0568cffc4e6d517b256a2fe97a029b3f1b9fe7e/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:b419ae593c86b87014b9be7396b385491ad7f320bde96826d0dd174459e54665", size = 4931457, upload-time = "2025-10-15T23:17:33.478Z" },
+    { url = "https://files.pythonhosted.org/packages/79/30/9b54127a9a778ccd6d27c3da7563e9f2d341826075ceab89ae3b41bf5be2/cryptography-46.0.3-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:50fc3343ac490c6b08c0cf0d704e881d0d660be923fd3076db3e932007e726e3", size = 4466074, upload-time = "2025-10-15T23:17:35.158Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/68/b4f4a10928e26c941b1b6a179143af9f4d27d88fe84a6a3c53592d2e76bf/cryptography-46.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:22d7e97932f511d6b0b04f2bfd818d73dcd5928db509460aaf48384778eb6d20", size = 4420569, upload-time = "2025-10-15T23:17:37.188Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/49/3746dab4c0d1979888f125226357d3262a6dd40e114ac29e3d2abdf1ec55/cryptography-46.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:d55f3dffadd674514ad19451161118fd010988540cee43d8bc20675e775925de", size = 4681941, upload-time = "2025-10-15T23:17:39.236Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/30/27654c1dbaf7e4a3531fa1fc77986d04aefa4d6d78259a62c9dc13d7ad36/cryptography-46.0.3-cp314-cp314t-win32.whl", hash = "sha256:8a6e050cb6164d3f830453754094c086ff2d0b2f3a897a1d9820f6139a1f0914", size = 3022339, upload-time = "2025-10-15T23:17:40.888Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/30/640f34ccd4d2a1bc88367b54b926b781b5a018d65f404d409aba76a84b1c/cryptography-46.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:760f83faa07f8b64e9c33fc963d790a2edb24efb479e3520c14a45741cd9b2db", size = 3494315, upload-time = "2025-10-15T23:17:42.769Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/8b/88cc7e3bd0a8e7b861f26981f7b820e1f46aa9d26cc482d0feba0ecb4919/cryptography-46.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:516ea134e703e9fe26bcd1277a4b59ad30586ea90c365a87781d7887a646fe21", size = 2919331, upload-time = "2025-10-15T23:17:44.468Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/23/45fe7f376a7df8daf6da3556603b36f53475a99ce4faacb6ba2cf3d82021/cryptography-46.0.3-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:cb3d760a6117f621261d662bccc8ef5bc32ca673e037c83fbe565324f5c46936", size = 7218248, upload-time = "2025-10-15T23:17:46.294Z" },
+    { url = "https://files.pythonhosted.org/packages/27/32/b68d27471372737054cbd34c84981f9edbc24fe67ca225d389799614e27f/cryptography-46.0.3-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:4b7387121ac7d15e550f5cb4a43aef2559ed759c35df7336c402bb8275ac9683", size = 4294089, upload-time = "2025-10-15T23:17:48.269Z" },
+    { url = "https://files.pythonhosted.org/packages/26/42/fa8389d4478368743e24e61eea78846a0006caffaf72ea24a15159215a14/cryptography-46.0.3-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:15ab9b093e8f09daab0f2159bb7e47532596075139dd74365da52ecc9cb46c5d", size = 4440029, upload-time = "2025-10-15T23:17:49.837Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/eb/f483db0ec5ac040824f269e93dd2bd8a21ecd1027e77ad7bdf6914f2fd80/cryptography-46.0.3-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:46acf53b40ea38f9c6c229599a4a13f0d46a6c3fa9ef19fc1a124d62e338dfa0", size = 4297222, upload-time = "2025-10-15T23:17:51.357Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/cf/da9502c4e1912cb1da3807ea3618a6829bee8207456fbbeebc361ec38ba3/cryptography-46.0.3-cp38-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:10ca84c4668d066a9878890047f03546f3ae0a6b8b39b697457b7757aaf18dbc", size = 4012280, upload-time = "2025-10-15T23:17:52.964Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/8f/9adb86b93330e0df8b3dcf03eae67c33ba89958fc2e03862ef1ac2b42465/cryptography-46.0.3-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:36e627112085bb3b81b19fed209c05ce2a52ee8b15d161b7c643a7d5a88491f3", size = 4978958, upload-time = "2025-10-15T23:17:54.965Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/a0/5fa77988289c34bdb9f913f5606ecc9ada1adb5ae870bd0d1054a7021cc4/cryptography-46.0.3-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1000713389b75c449a6e979ffc7dcc8ac90b437048766cef052d4d30b8220971", size = 4473714, upload-time = "2025-10-15T23:17:56.754Z" },
+    { url = "https://files.pythonhosted.org/packages/14/e5/fc82d72a58d41c393697aa18c9abe5ae1214ff6f2a5c18ac470f92777895/cryptography-46.0.3-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:b02cf04496f6576afffef5ddd04a0cb7d49cf6be16a9059d793a30b035f6b6ac", size = 4296970, upload-time = "2025-10-15T23:17:58.588Z" },
+    { url = "https://files.pythonhosted.org/packages/78/06/5663ed35438d0b09056973994f1aec467492b33bd31da36e468b01ec1097/cryptography-46.0.3-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:71e842ec9bc7abf543b47cf86b9a743baa95f4677d22baa4c7d5c69e49e9bc04", size = 4940236, upload-time = "2025-10-15T23:18:00.897Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/59/873633f3f2dcd8a053b8dd1d38f783043b5fce589c0f6988bf55ef57e43e/cryptography-46.0.3-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:402b58fc32614f00980b66d6e56a5b4118e6cb362ae8f3fda141ba4689bd4506", size = 4472642, upload-time = "2025-10-15T23:18:02.749Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/39/8e71f3930e40f6877737d6f69248cf74d4e34b886a3967d32f919cc50d3b/cryptography-46.0.3-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:ef639cb3372f69ec44915fafcd6698b6cc78fbe0c2ea41be867f6ed612811963", size = 4423126, upload-time = "2025-10-15T23:18:04.85Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/c7/f65027c2810e14c3e7268353b1681932b87e5a48e65505d8cc17c99e36ae/cryptography-46.0.3-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3b51b8ca4f1c6453d8829e1eb7299499ca7f313900dd4d89a24b8b87c0a780d4", size = 4686573, upload-time = "2025-10-15T23:18:06.908Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/6e/1c8331ddf91ca4730ab3086a0f1be19c65510a33b5a441cb334e7a2d2560/cryptography-46.0.3-cp38-abi3-win32.whl", hash = "sha256:6276eb85ef938dc035d59b87c8a7dc559a232f954962520137529d77b18ff1df", size = 3036695, upload-time = "2025-10-15T23:18:08.672Z" },
+    { url = "https://files.pythonhosted.org/packages/90/45/b0d691df20633eff80955a0fc7695ff9051ffce8b69741444bd9ed7bd0db/cryptography-46.0.3-cp38-abi3-win_amd64.whl", hash = "sha256:416260257577718c05135c55958b674000baef9a1c7d9e8f306ec60d71db850f", size = 3501720, upload-time = "2025-10-15T23:18:10.632Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/cb/2da4cc83f5edb9c3257d09e1e7ab7b23f049c7962cae8d842bbef0a9cec9/cryptography-46.0.3-cp38-abi3-win_arm64.whl", hash = "sha256:d89c3468de4cdc4f08a57e214384d0471911a3830fcdaf7a8cc587e42a866372", size = 2918740, upload-time = "2025-10-15T23:18:12.277Z" },
+    { url = "https://files.pythonhosted.org/packages/06/8a/e60e46adab4362a682cf142c7dcb5bf79b782ab2199b0dcb81f55970807f/cryptography-46.0.3-pp311-pypy311_pp73-macosx_10_9_x86_64.whl", hash = "sha256:7ce938a99998ed3c8aa7e7272dca1a610401ede816d36d0693907d863b10d9ea", size = 3698132, upload-time = "2025-10-15T23:18:17.056Z" },
+    { url = "https://files.pythonhosted.org/packages/da/38/f59940ec4ee91e93d3311f7532671a5cef5570eb04a144bf203b58552d11/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:191bb60a7be5e6f54e30ba16fdfae78ad3a342a0599eb4193ba88e3f3d6e185b", size = 4243992, upload-time = "2025-10-15T23:18:18.695Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/0c/35b3d92ddebfdfda76bb485738306545817253d0a3ded0bfe80ef8e67aa5/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c70cc23f12726be8f8bc72e41d5065d77e4515efae3690326764ea1b07845cfb", size = 4409944, upload-time = "2025-10-15T23:18:20.597Z" },
+    { url = "https://files.pythonhosted.org/packages/99/55/181022996c4063fc0e7666a47049a1ca705abb9c8a13830f074edb347495/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:9394673a9f4de09e28b5356e7fff97d778f8abad85c9d5ac4a4b7e25a0de7717", size = 4242957, upload-time = "2025-10-15T23:18:22.18Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/af/72cd6ef29f9c5f731251acadaeb821559fe25f10852f44a63374c9ca08c1/cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:94cd0549accc38d1494e1f8de71eca837d0509d0d44bf11d158524b0e12cebf9", size = 4409447, upload-time = "2025-10-15T23:18:24.209Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/c3/e90f4a4feae6410f914f8ebac129b9ae7a8c92eb60a638012dde42030a9d/cryptography-46.0.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6b5063083824e5509fdba180721d55909ffacccc8adbec85268b48439423d78c", size = 3438528, upload-time = "2025-10-15T23:18:26.227Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "httpx-sse"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/4c/751061ffa58615a32c31b2d82e8482be8dd4a89154f003147acee90f2be9/httpx_sse-0.4.3.tar.gz", hash = "sha256:9b1ed0127459a66014aec3c56bebd93da3c1bc8bb6618c8082039a44889a755d", size = 15943, upload-time = "2025-10-10T21:48:22.271Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "jsonschema"
+version = "4.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "jsonschema-specifications" },
+    { name = "referencing" },
+    { name = "rpds-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
+]
+
+[[package]]
+name = "jsonschema-specifications"
+version = "2025.9.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "referencing" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
+]
+
+[[package]]
+name = "mcp"
+version = "1.25.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "httpx" },
+    { name = "httpx-sse" },
+    { name = "jsonschema" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "pyjwt", extra = ["crypto"] },
+    { name = "python-multipart" },
+    { name = "pywin32", marker = "sys_platform == 'win32'" },
+    { name = "sse-starlette" },
+    { name = "starlette" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+    { name = "uvicorn", marker = "sys_platform != 'emscripten'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d5/2d/649d80a0ecf6a1f82632ca44bec21c0461a9d9fc8934d38cb5b319f2db5e/mcp-1.25.0.tar.gz", hash = "sha256:56310361ebf0364e2d438e5b45f7668cbb124e158bb358333cd06e49e83a6802", size = 605387, upload-time = "2025-12-19T10:19:56.985Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e2/fc/6dc7659c2ae5ddf280477011f4213a74f806862856b796ef08f028e664bf/mcp-1.25.0-py3-none-any.whl", hash = "sha256:b37c38144a666add0862614cc79ec276e97d72aa8ca26d622818d4e278b9721a", size = 233076, upload-time = "2025-12-19T10:19:55.416Z" },
+]
+
+[[package]]
+name = "mcp-codex-delegator"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "mcp" },
+    { name = "pyyaml" },
+]
+
+[package.optional-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "mcp", specifier = ">=1.0.0" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0.0" },
+    { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.23.0" },
+    { name = "pyyaml", specifier = ">=6.0.1" },
+]
+provides-extras = ["dev"]
+
+[[package]]
+name = "packaging"
+version = "25.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "pycparser"
+version = "2.23"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fe/cf/d2d3b9f5699fb1e4615c8e32ff220203e43b248e1dfcc6736ad9057731ca/pycparser-2.23.tar.gz", hash = "sha256:78816d4f24add8f10a06d6f05b4d424ad9e96cfebf68a4ddc99c65c0720d00c2", size = 173734, upload-time = "2025-09-09T13:23:47.91Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/e3/59cd50310fc9b59512193629e1984c1f95e5c8ae6e5d8c69532ccc65a7fe/pycparser-2.23-py3-none-any.whl", hash = "sha256:e5c6e8d3fbad53479cab09ac03729e0a9faf2bee3db8208a550daf5af81a5934", size = 118140, upload-time = "2025-09-09T13:23:46.651Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.12.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.41.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e8/72/74a989dd9f2084b3d9530b0915fdda64ac48831c30dbf7c72a41a5232db8/pydantic_core-2.41.5-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a3a52f6156e73e7ccb0f8cced536adccb7042be67cb45f9562e12b319c119da6", size = 2105873, upload-time = "2025-11-04T13:39:31.373Z" },
+    { url = "https://files.pythonhosted.org/packages/12/44/37e403fd9455708b3b942949e1d7febc02167662bf1a7da5b78ee1ea2842/pydantic_core-2.41.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7f3bf998340c6d4b0c9a2f02d6a400e51f123b59565d74dc60d252ce888c260b", size = 1899826, upload-time = "2025-11-04T13:39:32.897Z" },
+    { url = "https://files.pythonhosted.org/packages/33/7f/1d5cab3ccf44c1935a359d51a8a2a9e1a654b744b5e7f80d41b88d501eec/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:378bec5c66998815d224c9ca994f1e14c0c21cb95d2f52b6021cc0b2a58f2a5a", size = 1917869, upload-time = "2025-11-04T13:39:34.469Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/6a/30d94a9674a7fe4f4744052ed6c5e083424510be1e93da5bc47569d11810/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e7b576130c69225432866fe2f4a469a85a54ade141d96fd396dffcf607b558f8", size = 2063890, upload-time = "2025-11-04T13:39:36.053Z" },
+    { url = "https://files.pythonhosted.org/packages/50/be/76e5d46203fcb2750e542f32e6c371ffa9b8ad17364cf94bb0818dbfb50c/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6cb58b9c66f7e4179a2d5e0f849c48eff5c1fca560994d6eb6543abf955a149e", size = 2229740, upload-time = "2025-11-04T13:39:37.753Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/ee/fed784df0144793489f87db310a6bbf8118d7b630ed07aa180d6067e653a/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88942d3a3dff3afc8288c21e565e476fc278902ae4d6d134f1eeda118cc830b1", size = 2350021, upload-time = "2025-11-04T13:39:40.94Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/be/8fed28dd0a180dca19e72c233cbf58efa36df055e5b9d90d64fd1740b828/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f31d95a179f8d64d90f6831d71fa93290893a33148d890ba15de25642c5d075b", size = 2066378, upload-time = "2025-11-04T13:39:42.523Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/3b/698cf8ae1d536a010e05121b4958b1257f0b5522085e335360e53a6b1c8b/pydantic_core-2.41.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c1df3d34aced70add6f867a8cf413e299177e0c22660cc767218373d0779487b", size = 2175761, upload-time = "2025-11-04T13:39:44.553Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/ba/15d537423939553116dea94ce02f9c31be0fa9d0b806d427e0308ec17145/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4009935984bd36bd2c774e13f9a09563ce8de4abaa7226f5108262fa3e637284", size = 2146303, upload-time = "2025-11-04T13:39:46.238Z" },
+    { url = "https://files.pythonhosted.org/packages/58/7f/0de669bf37d206723795f9c90c82966726a2ab06c336deba4735b55af431/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:34a64bc3441dc1213096a20fe27e8e128bd3ff89921706e83c0b1ac971276594", size = 2340355, upload-time = "2025-11-04T13:39:48.002Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/de/e7482c435b83d7e3c3ee5ee4451f6e8973cff0eb6007d2872ce6383f6398/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c9e19dd6e28fdcaa5a1de679aec4141f691023916427ef9bae8584f9c2fb3b0e", size = 2319875, upload-time = "2025-11-04T13:39:49.705Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/e6/8c9e81bb6dd7560e33b9053351c29f30c8194b72f2d6932888581f503482/pydantic_core-2.41.5-cp311-cp311-win32.whl", hash = "sha256:2c010c6ded393148374c0f6f0bf89d206bf3217f201faa0635dcd56bd1520f6b", size = 1987549, upload-time = "2025-11-04T13:39:51.842Z" },
+    { url = "https://files.pythonhosted.org/packages/11/66/f14d1d978ea94d1bc21fc98fcf570f9542fe55bfcc40269d4e1a21c19bf7/pydantic_core-2.41.5-cp311-cp311-win_amd64.whl", hash = "sha256:76ee27c6e9c7f16f47db7a94157112a2f3a00e958bc626e2f4ee8bec5c328fbe", size = 2011305, upload-time = "2025-11-04T13:39:53.485Z" },
+    { url = "https://files.pythonhosted.org/packages/56/d8/0e271434e8efd03186c5386671328154ee349ff0354d83c74f5caaf096ed/pydantic_core-2.41.5-cp311-cp311-win_arm64.whl", hash = "sha256:4bc36bbc0b7584de96561184ad7f012478987882ebf9f9c389b23f432ea3d90f", size = 1972902, upload-time = "2025-11-04T13:39:56.488Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
+    { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
+    { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
+    { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
+    { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
+    { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
+    { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
+    { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
+    { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
+    { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
+    { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
+    { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" },
+    { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" },
+    { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" },
+    { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" },
+    { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" },
+    { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" },
+    { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" },
+    { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" },
+    { url = "https://files.pythonhosted.org/packages/11/72/90fda5ee3b97e51c494938a4a44c3a35a9c96c19bba12372fb9c634d6f57/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:b96d5f26b05d03cc60f11a7761a5ded1741da411e7fe0909e27a5e6a0cb7b034", size = 2115441, upload-time = "2025-11-04T13:42:39.557Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/53/8942f884fa33f50794f119012dc6a1a02ac43a56407adaac20463df8e98f/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:634e8609e89ceecea15e2d61bc9ac3718caaaa71963717bf3c8f38bfde64242c", size = 1930291, upload-time = "2025-11-04T13:42:42.169Z" },
+    { url = "https://files.pythonhosted.org/packages/79/c8/ecb9ed9cd942bce09fc888ee960b52654fbdbede4ba6c2d6e0d3b1d8b49c/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:93e8740d7503eb008aa2df04d3b9735f845d43ae845e6dcd2be0b55a2da43cd2", size = 1948632, upload-time = "2025-11-04T13:42:44.564Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/1b/687711069de7efa6af934e74f601e2a4307365e8fdc404703afc453eab26/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f15489ba13d61f670dcc96772e733aad1a6f9c429cc27574c6cdaed82d0146ad", size = 2138905, upload-time = "2025-11-04T13:42:47.156Z" },
+    { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/9b/1b3f0e9f9305839d7e84912f9e8bfbd191ed1b1ef48083609f0dabde978c/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:b2379fa7ed44ddecb5bfe4e48577d752db9fc10be00a6b7446e9663ba143de26", size = 2101980, upload-time = "2025-11-04T13:43:25.97Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/ed/d71fefcb4263df0da6a85b5d8a7508360f2f2e9b3bf5814be9c8bccdccc1/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:266fb4cbf5e3cbd0b53669a6d1b039c45e3ce651fd5442eff4d07c2cc8d66808", size = 1923865, upload-time = "2025-11-04T13:43:28.763Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/3a/626b38db460d675f873e4444b4bb030453bbe7b4ba55df821d026a0493c4/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58133647260ea01e4d0500089a8c4f07bd7aa6ce109682b1426394988d8aaacc", size = 2134256, upload-time = "2025-11-04T13:43:31.71Z" },
+    { url = "https://files.pythonhosted.org/packages/83/d9/8412d7f06f616bbc053d30cb4e5f76786af3221462ad5eee1f202021eb4e/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:287dad91cfb551c363dc62899a80e9e14da1f0e2b6ebde82c806612ca2a13ef1", size = 2174762, upload-time = "2025-11-04T13:43:34.744Z" },
+    { url = "https://files.pythonhosted.org/packages/55/4c/162d906b8e3ba3a99354e20faa1b49a85206c47de97a639510a0e673f5da/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:03b77d184b9eb40240ae9fd676ca364ce1085f203e1b1256f8ab9984dca80a84", size = 2143141, upload-time = "2025-11-04T13:43:37.701Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/f2/f11dd73284122713f5f89fc940f370d035fa8e1e078d446b3313955157fe/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:a668ce24de96165bb239160b3d854943128f4334822900534f2fe947930e5770", size = 2330317, upload-time = "2025-11-04T13:43:40.406Z" },
+    { url = "https://files.pythonhosted.org/packages/88/9d/b06ca6acfe4abb296110fb1273a4d848a0bfb2ff65f3ee92127b3244e16b/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f14f8f046c14563f8eb3f45f499cc658ab8d10072961e07225e507adb700e93f", size = 2316992, upload-time = "2025-11-04T13:43:43.602Z" },
+    { url = "https://files.pythonhosted.org/packages/36/c7/cfc8e811f061c841d7990b0201912c3556bfeb99cdcb7ed24adc8d6f8704/pydantic_core-2.41.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56121965f7a4dc965bff783d70b907ddf3d57f6eba29b6d2e5dabfaf07799c51", size = 2145302, upload-time = "2025-11-04T13:43:46.64Z" },
+]
+
+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pyjwt"
+version = "2.10.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e7/46/bd74733ff231675599650d3e47f361794b22ef3e3770998dda30d3b63726/pyjwt-2.10.1.tar.gz", hash = "sha256:3cc5772eb20009233caf06e9d8a0577824723b44e6648ee0a2aedb6cf9381953", size = 87785, upload-time = "2024-11-28T03:43:29.933Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/61/ad/689f02752eeec26aed679477e80e632ef1b682313be70793d798c1d5fc8f/PyJWT-2.10.1-py3-none-any.whl", hash = "sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb", size = 22997, upload-time = "2024-11-28T03:43:27.893Z" },
+]
+
+[package.optional-dependencies]
+crypto = [
+    { name = "cryptography" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
+[[package]]
+name = "pytest-asyncio"
+version = "1.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pytest" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/90/2c/8af215c0f776415f3590cac4f9086ccefd6fd463befeae41cd4d3f193e5a/pytest_asyncio-1.3.0.tar.gz", hash = "sha256:d7f52f36d231b80ee124cd216ffb19369aa168fc10095013c6b014a34d3ee9e5", size = 50087, upload-time = "2025-11-10T16:07:47.256Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl", hash = "sha256:611e26147c7f77640e6d0a92a38ed17c3e9848063698d5c93d5aa7aa11cebff5", size = 15075, upload-time = "2025-11-10T16:07:45.537Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f0/26/19cadc79a718c5edbec86fd4919a6b6d3f681039a2f6d66d14be94e75fb9/python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6", size = 44221, upload-time = "2025-10-26T15:12:10.434Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
+]
+
+[[package]]
+name = "python-multipart"
+version = "0.0.21"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/78/96/804520d0850c7db98e5ccb70282e29208723f0964e88ffd9d0da2f52ea09/python_multipart-0.0.21.tar.gz", hash = "sha256:7137ebd4d3bbf70ea1622998f902b97a29434a9e8dc40eb203bbcf7c2a2cba92", size = 37196, upload-time = "2025-12-17T09:24:22.446Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/aa/76/03af049af4dcee5d27442f71b6924f01f3efb5d2bd34f23fcd563f2cc5f5/python_multipart-0.0.21-py3-none-any.whl", hash = "sha256:cf7a6713e01c87aa35387f4774e812c4361150938d20d232800f75ffcf266090", size = 24541, upload-time = "2025-12-17T09:24:21.153Z" },
+]
+
+[[package]]
+name = "pywin32"
+version = "311"
+source = { registry = "https://pypi.org/simple" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7c/af/449a6a91e5d6db51420875c54f6aff7c97a86a3b13a0b4f1a5c13b988de3/pywin32-311-cp311-cp311-win32.whl", hash = "sha256:184eb5e436dea364dcd3d2316d577d625c0351bf237c4e9a5fabbcfa5a58b151", size = 8697031, upload-time = "2025-07-14T20:13:13.266Z" },
+    { url = "https://files.pythonhosted.org/packages/51/8f/9bb81dd5bb77d22243d33c8397f09377056d5c687aa6d4042bea7fbf8364/pywin32-311-cp311-cp311-win_amd64.whl", hash = "sha256:3ce80b34b22b17ccbd937a6e78e7225d80c52f5ab9940fe0506a1a16f3dab503", size = 9508308, upload-time = "2025-07-14T20:13:15.147Z" },
+    { url = "https://files.pythonhosted.org/packages/44/7b/9c2ab54f74a138c491aba1b1cd0795ba61f144c711daea84a88b63dc0f6c/pywin32-311-cp311-cp311-win_arm64.whl", hash = "sha256:a733f1388e1a842abb67ffa8e7aad0e70ac519e09b0f6a784e65a136ec7cefd2", size = 8703930, upload-time = "2025-07-14T20:13:16.945Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/ab/01ea1943d4eba0f850c3c61e78e8dd59757ff815ff3ccd0a84de5f541f42/pywin32-311-cp312-cp312-win32.whl", hash = "sha256:750ec6e621af2b948540032557b10a2d43b0cee2ae9758c54154d711cc852d31", size = 8706543, upload-time = "2025-07-14T20:13:20.765Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/a8/a0e8d07d4d051ec7502cd58b291ec98dcc0c3fff027caad0470b72cfcc2f/pywin32-311-cp312-cp312-win_amd64.whl", hash = "sha256:b8c095edad5c211ff31c05223658e71bf7116daa0ecf3ad85f3201ea3190d067", size = 9495040, upload-time = "2025-07-14T20:13:22.543Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/3a/2ae996277b4b50f17d61f0603efd8253cb2d79cc7ae159468007b586396d/pywin32-311-cp312-cp312-win_arm64.whl", hash = "sha256:e286f46a9a39c4a18b319c28f59b61de793654af2f395c102b4f819e584b5852", size = 8710102, upload-time = "2025-07-14T20:13:24.682Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/be/3fd5de0979fcb3994bfee0d65ed8ca9506a8a1260651b86174f6a86f52b3/pywin32-311-cp313-cp313-win32.whl", hash = "sha256:f95ba5a847cba10dd8c4d8fefa9f2a6cf283b8b88ed6178fa8a6c1ab16054d0d", size = 8705700, upload-time = "2025-07-14T20:13:26.471Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/28/e0a1909523c6890208295a29e05c2adb2126364e289826c0a8bc7297bd5c/pywin32-311-cp313-cp313-win_amd64.whl", hash = "sha256:718a38f7e5b058e76aee1c56ddd06908116d35147e133427e59a3983f703a20d", size = 9494700, upload-time = "2025-07-14T20:13:28.243Z" },
+    { url = "https://files.pythonhosted.org/packages/04/bf/90339ac0f55726dce7d794e6d79a18a91265bdf3aa70b6b9ca52f35e022a/pywin32-311-cp313-cp313-win_arm64.whl", hash = "sha256:7b4075d959648406202d92a2310cb990fea19b535c7f4a78d3f5e10b926eeb8a", size = 8709318, upload-time = "2025-07-14T20:13:30.348Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/31/097f2e132c4f16d99a22bfb777e0fd88bd8e1c634304e102f313af69ace5/pywin32-311-cp314-cp314-win32.whl", hash = "sha256:b7a2c10b93f8986666d0c803ee19b5990885872a7de910fc460f9b0c2fbf92ee", size = 8840714, upload-time = "2025-07-14T20:13:32.449Z" },
+    { url = "https://files.pythonhosted.org/packages/90/4b/07c77d8ba0e01349358082713400435347df8426208171ce297da32c313d/pywin32-311-cp314-cp314-win_amd64.whl", hash = "sha256:3aca44c046bd2ed8c90de9cb8427f581c479e594e99b5c0bb19b29c10fd6cb87", size = 9656800, upload-time = "2025-07-14T20:13:34.312Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/d2/21af5c535501a7233e734b8af901574572da66fcc254cb35d0609c9080dd/pywin32-311-cp314-cp314-win_arm64.whl", hash = "sha256:a508e2d9025764a8270f93111a970e1d0fbfc33f4153b388bb649b7eec4f9b42", size = 8932540, upload-time = "2025-07-14T20:13:36.379Z" },
+]
+
+[[package]]
+name = "pyyaml"
+version = "6.0.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960, upload-time = "2025-09-25T21:33:16.546Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826, upload-time = "2025-09-25T21:31:58.655Z" },
+    { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577, upload-time = "2025-09-25T21:32:00.088Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556, upload-time = "2025-09-25T21:32:01.31Z" },
+    { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114, upload-time = "2025-09-25T21:32:03.376Z" },
+    { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638, upload-time = "2025-09-25T21:32:04.553Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463, upload-time = "2025-09-25T21:32:06.152Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986, upload-time = "2025-09-25T21:32:07.367Z" },
+    { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543, upload-time = "2025-09-25T21:32:08.95Z" },
+    { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763, upload-time = "2025-09-25T21:32:09.96Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063, upload-time = "2025-09-25T21:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973, upload-time = "2025-09-25T21:32:12.492Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116, upload-time = "2025-09-25T21:32:13.652Z" },
+    { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011, upload-time = "2025-09-25T21:32:15.21Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870, upload-time = "2025-09-25T21:32:16.431Z" },
+    { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089, upload-time = "2025-09-25T21:32:17.56Z" },
+    { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181, upload-time = "2025-09-25T21:32:18.834Z" },
+    { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658, upload-time = "2025-09-25T21:32:20.209Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003, upload-time = "2025-09-25T21:32:21.167Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344, upload-time = "2025-09-25T21:32:22.617Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669, upload-time = "2025-09-25T21:32:23.673Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252, upload-time = "2025-09-25T21:32:25.149Z" },
+    { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081, upload-time = "2025-09-25T21:32:26.575Z" },
+    { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159, upload-time = "2025-09-25T21:32:27.727Z" },
+    { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626, upload-time = "2025-09-25T21:32:28.878Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613, upload-time = "2025-09-25T21:32:30.178Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115, upload-time = "2025-09-25T21:32:31.353Z" },
+    { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427, upload-time = "2025-09-25T21:32:32.58Z" },
+    { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090, upload-time = "2025-09-25T21:32:33.659Z" },
+    { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246, upload-time = "2025-09-25T21:32:34.663Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814, upload-time = "2025-09-25T21:32:35.712Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809, upload-time = "2025-09-25T21:32:36.789Z" },
+    { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454, upload-time = "2025-09-25T21:32:37.966Z" },
+    { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355, upload-time = "2025-09-25T21:32:39.178Z" },
+    { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175, upload-time = "2025-09-25T21:32:40.865Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228, upload-time = "2025-09-25T21:32:42.084Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194, upload-time = "2025-09-25T21:32:43.362Z" },
+    { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429, upload-time = "2025-09-25T21:32:57.844Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912, upload-time = "2025-09-25T21:32:59.247Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108, upload-time = "2025-09-25T21:32:44.377Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641, upload-time = "2025-09-25T21:32:45.407Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901, upload-time = "2025-09-25T21:32:48.83Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132, upload-time = "2025-09-25T21:32:50.149Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261, upload-time = "2025-09-25T21:32:51.808Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272, upload-time = "2025-09-25T21:32:52.941Z" },
+    { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923, upload-time = "2025-09-25T21:32:54.537Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062, upload-time = "2025-09-25T21:32:55.767Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341, upload-time = "2025-09-25T21:32:56.828Z" },
+]
+
+[[package]]
+name = "referencing"
+version = "0.37.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "rpds-py" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
+]
+
+[[package]]
+name = "rpds-py"
+version = "0.30.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/20/af/3f2f423103f1113b36230496629986e0ef7e199d2aa8392452b484b38ced/rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84", size = 69469, upload-time = "2025-11-30T20:24:38.837Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4d/6e/f964e88b3d2abee2a82c1ac8366da848fce1c6d834dc2132c3fda3970290/rpds_py-0.30.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a2bffea6a4ca9f01b3f8e548302470306689684e61602aa3d141e34da06cf425", size = 370157, upload-time = "2025-11-30T20:21:53.789Z" },
+    { url = "https://files.pythonhosted.org/packages/94/ba/24e5ebb7c1c82e74c4e4f33b2112a5573ddc703915b13a073737b59b86e0/rpds_py-0.30.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dc4f992dfe1e2bc3ebc7444f6c7051b4bc13cd8e33e43511e8ffd13bf407010d", size = 359676, upload-time = "2025-11-30T20:21:55.475Z" },
+    { url = "https://files.pythonhosted.org/packages/84/86/04dbba1b087227747d64d80c3b74df946b986c57af0a9f0c98726d4d7a3b/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:422c3cb9856d80b09d30d2eb255d0754b23e090034e1deb4083f8004bd0761e4", size = 389938, upload-time = "2025-11-30T20:21:57.079Z" },
+    { url = "https://files.pythonhosted.org/packages/42/bb/1463f0b1722b7f45431bdd468301991d1328b16cffe0b1c2918eba2c4eee/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:07ae8a593e1c3c6b82ca3292efbe73c30b61332fd612e05abee07c79359f292f", size = 402932, upload-time = "2025-11-30T20:21:58.47Z" },
+    { url = "https://files.pythonhosted.org/packages/99/ee/2520700a5c1f2d76631f948b0736cdf9b0acb25abd0ca8e889b5c62ac2e3/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:12f90dd7557b6bd57f40abe7747e81e0c0b119bef015ea7726e69fe550e394a4", size = 525830, upload-time = "2025-11-30T20:21:59.699Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/ad/bd0331f740f5705cc555a5e17fdf334671262160270962e69a2bdef3bf76/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:99b47d6ad9a6da00bec6aabe5a6279ecd3c06a329d4aa4771034a21e335c3a97", size = 412033, upload-time = "2025-11-30T20:22:00.991Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/1e/372195d326549bb51f0ba0f2ecb9874579906b97e08880e7a65c3bef1a99/rpds_py-0.30.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:33f559f3104504506a44bb666b93a33f5d33133765b0c216a5bf2f1e1503af89", size = 390828, upload-time = "2025-11-30T20:22:02.723Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/2b/d88bb33294e3e0c76bc8f351a3721212713629ffca1700fa94979cb3eae8/rpds_py-0.30.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:946fe926af6e44f3697abbc305ea168c2c31d3e3ef1058cf68f379bf0335a78d", size = 404683, upload-time = "2025-11-30T20:22:04.367Z" },
+    { url = "https://files.pythonhosted.org/packages/50/32/c759a8d42bcb5289c1fac697cd92f6fe01a018dd937e62ae77e0e7f15702/rpds_py-0.30.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:495aeca4b93d465efde585977365187149e75383ad2684f81519f504f5c13038", size = 421583, upload-time = "2025-11-30T20:22:05.814Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/81/e729761dbd55ddf5d84ec4ff1f47857f4374b0f19bdabfcf929164da3e24/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9a0ca5da0386dee0655b4ccdf46119df60e0f10da268d04fe7cc87886872ba7", size = 572496, upload-time = "2025-11-30T20:22:07.713Z" },
+    { url = "https://files.pythonhosted.org/packages/14/f6/69066a924c3557c9c30baa6ec3a0aa07526305684c6f86c696b08860726c/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:8d6d1cc13664ec13c1b84241204ff3b12f9bb82464b8ad6e7a5d3486975c2eed", size = 598669, upload-time = "2025-11-30T20:22:09.312Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/48/905896b1eb8a05630d20333d1d8ffd162394127b74ce0b0784ae04498d32/rpds_py-0.30.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3896fa1be39912cf0757753826bc8bdc8ca331a28a7c4ae46b7a21280b06bb85", size = 561011, upload-time = "2025-11-30T20:22:11.309Z" },
+    { url = "https://files.pythonhosted.org/packages/22/16/cd3027c7e279d22e5eb431dd3c0fbc677bed58797fe7581e148f3f68818b/rpds_py-0.30.0-cp311-cp311-win32.whl", hash = "sha256:55f66022632205940f1827effeff17c4fa7ae1953d2b74a8581baaefb7d16f8c", size = 221406, upload-time = "2025-11-30T20:22:13.101Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/5b/e7b7aa136f28462b344e652ee010d4de26ee9fd16f1bfd5811f5153ccf89/rpds_py-0.30.0-cp311-cp311-win_amd64.whl", hash = "sha256:a51033ff701fca756439d641c0ad09a41d9242fa69121c7d8769604a0a629825", size = 236024, upload-time = "2025-11-30T20:22:14.853Z" },
+    { url = "https://files.pythonhosted.org/packages/14/a6/364bba985e4c13658edb156640608f2c9e1d3ea3c81b27aa9d889fff0e31/rpds_py-0.30.0-cp311-cp311-win_arm64.whl", hash = "sha256:47b0ef6231c58f506ef0b74d44e330405caa8428e770fec25329ed2cb971a229", size = 229069, upload-time = "2025-11-30T20:22:16.577Z" },
+    { url = "https://files.pythonhosted.org/packages/03/e7/98a2f4ac921d82f33e03f3835f5bf3a4a40aa1bfdc57975e74a97b2b4bdd/rpds_py-0.30.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a161f20d9a43006833cd7068375a94d035714d73a172b681d8881820600abfad", size = 375086, upload-time = "2025-11-30T20:22:17.93Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/a1/bca7fd3d452b272e13335db8d6b0b3ecde0f90ad6f16f3328c6fb150c889/rpds_py-0.30.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6abc8880d9d036ecaafe709079969f56e876fcf107f7a8e9920ba6d5a3878d05", size = 359053, upload-time = "2025-11-30T20:22:19.297Z" },
+    { url = "https://files.pythonhosted.org/packages/65/1c/ae157e83a6357eceff62ba7e52113e3ec4834a84cfe07fa4b0757a7d105f/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca28829ae5f5d569bb62a79512c842a03a12576375d5ece7d2cadf8abe96ec28", size = 390763, upload-time = "2025-11-30T20:22:21.661Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/36/eb2eb8515e2ad24c0bd43c3ee9cd74c33f7ca6430755ccdb240fd3144c44/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a1010ed9524c73b94d15919ca4d41d8780980e1765babf85f9a2f90d247153dd", size = 408951, upload-time = "2025-11-30T20:22:23.408Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/65/ad8dc1784a331fabbd740ef6f71ce2198c7ed0890dab595adb9ea2d775a1/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8d1736cfb49381ba528cd5baa46f82fdc65c06e843dab24dd70b63d09121b3f", size = 514622, upload-time = "2025-11-30T20:22:25.16Z" },
+    { url = "https://files.pythonhosted.org/packages/63/8e/0cfa7ae158e15e143fe03993b5bcd743a59f541f5952e1546b1ac1b5fd45/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d948b135c4693daff7bc2dcfc4ec57237a29bd37e60c2fabf5aff2bbacf3e2f1", size = 414492, upload-time = "2025-11-30T20:22:26.505Z" },
+    { url = "https://files.pythonhosted.org/packages/60/1b/6f8f29f3f995c7ffdde46a626ddccd7c63aefc0efae881dc13b6e5d5bb16/rpds_py-0.30.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47f236970bccb2233267d89173d3ad2703cd36a0e2a6e92d0560d333871a3d23", size = 394080, upload-time = "2025-11-30T20:22:27.934Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/d5/a266341051a7a3ca2f4b750a3aa4abc986378431fc2da508c5034d081b70/rpds_py-0.30.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2e6ecb5a5bcacf59c3f912155044479af1d0b6681280048b338b28e364aca1f6", size = 408680, upload-time = "2025-11-30T20:22:29.341Z" },
+    { url = "https://files.pythonhosted.org/packages/10/3b/71b725851df9ab7a7a4e33cf36d241933da66040d195a84781f49c50490c/rpds_py-0.30.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a8fa71a2e078c527c3e9dc9fc5a98c9db40bcc8a92b4e8858e36d329f8684b51", size = 423589, upload-time = "2025-11-30T20:22:31.469Z" },
+    { url = "https://files.pythonhosted.org/packages/00/2b/e59e58c544dc9bd8bd8384ecdb8ea91f6727f0e37a7131baeff8d6f51661/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73c67f2db7bc334e518d097c6d1e6fed021bbc9b7d678d6cc433478365d1d5f5", size = 573289, upload-time = "2025-11-30T20:22:32.997Z" },
+    { url = "https://files.pythonhosted.org/packages/da/3e/a18e6f5b460893172a7d6a680e86d3b6bc87a54c1f0b03446a3c8c7b588f/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5ba103fb455be00f3b1c2076c9d4264bfcb037c976167a6047ed82f23153f02e", size = 599737, upload-time = "2025-11-30T20:22:34.419Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/e2/714694e4b87b85a18e2c243614974413c60aa107fd815b8cbc42b873d1d7/rpds_py-0.30.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7cee9c752c0364588353e627da8a7e808a66873672bcb5f52890c33fd965b394", size = 563120, upload-time = "2025-11-30T20:22:35.903Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/ab/d5d5e3bcedb0a77f4f613706b750e50a5a3ba1c15ccd3665ecc636c968fd/rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf", size = 223782, upload-time = "2025-11-30T20:22:37.271Z" },
+    { url = "https://files.pythonhosted.org/packages/39/3b/f786af9957306fdc38a74cef405b7b93180f481fb48453a114bb6465744a/rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b", size = 240463, upload-time = "2025-11-30T20:22:39.021Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/d2/b91dc748126c1559042cfe41990deb92c4ee3e2b415f6b5234969ffaf0cc/rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e", size = 230868, upload-time = "2025-11-30T20:22:40.493Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/dc/d61221eb88ff410de3c49143407f6f3147acf2538c86f2ab7ce65ae7d5f9/rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2", size = 374887, upload-time = "2025-11-30T20:22:41.812Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/32/55fb50ae104061dbc564ef15cc43c013dc4a9f4527a1f4d99baddf56fe5f/rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8", size = 358904, upload-time = "2025-11-30T20:22:43.479Z" },
+    { url = "https://files.pythonhosted.org/packages/58/70/faed8186300e3b9bdd138d0273109784eea2396c68458ed580f885dfe7ad/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4", size = 389945, upload-time = "2025-11-30T20:22:44.819Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/a8/073cac3ed2c6387df38f71296d002ab43496a96b92c823e76f46b8af0543/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136", size = 407783, upload-time = "2025-11-30T20:22:46.103Z" },
+    { url = "https://files.pythonhosted.org/packages/77/57/5999eb8c58671f1c11eba084115e77a8899d6e694d2a18f69f0ba471ec8b/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7", size = 515021, upload-time = "2025-11-30T20:22:47.458Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/af/5ab4833eadc36c0a8ed2bc5c0de0493c04f6c06de223170bd0798ff98ced/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2", size = 414589, upload-time = "2025-11-30T20:22:48.872Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/de/f7192e12b21b9e9a68a6d0f249b4af3fdcdff8418be0767a627564afa1f1/rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6", size = 394025, upload-time = "2025-11-30T20:22:50.196Z" },
+    { url = "https://files.pythonhosted.org/packages/91/c4/fc70cd0249496493500e7cc2de87504f5aa6509de1e88623431fec76d4b6/rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e", size = 408895, upload-time = "2025-11-30T20:22:51.87Z" },
+    { url = "https://files.pythonhosted.org/packages/58/95/d9275b05ab96556fefff73a385813eb66032e4c99f411d0795372d9abcea/rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d", size = 422799, upload-time = "2025-11-30T20:22:53.341Z" },
+    { url = "https://files.pythonhosted.org/packages/06/c1/3088fc04b6624eb12a57eb814f0d4997a44b0d208d6cace713033ff1a6ba/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7", size = 572731, upload-time = "2025-11-30T20:22:54.778Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/42/c612a833183b39774e8ac8fecae81263a68b9583ee343db33ab571a7ce55/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31", size = 599027, upload-time = "2025-11-30T20:22:56.212Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/60/525a50f45b01d70005403ae0e25f43c0384369ad24ffe46e8d9068b50086/rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95", size = 563020, upload-time = "2025-11-30T20:22:58.2Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/5d/47c4655e9bcd5ca907148535c10e7d489044243cc9941c16ed7cd53be91d/rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d", size = 223139, upload-time = "2025-11-30T20:23:00.209Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/e1/485132437d20aa4d3e1d8b3fb5a5e65aa8139f1e097080c2a8443201742c/rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15", size = 240224, upload-time = "2025-11-30T20:23:02.008Z" },
+    { url = "https://files.pythonhosted.org/packages/24/95/ffd128ed1146a153d928617b0ef673960130be0009c77d8fbf0abe306713/rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1", size = 230645, upload-time = "2025-11-30T20:23:03.43Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/1b/b10de890a0def2a319a2626334a7f0ae388215eb60914dbac8a3bae54435/rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a", size = 364443, upload-time = "2025-11-30T20:23:04.878Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/bf/27e39f5971dc4f305a4fb9c672ca06f290f7c4e261c568f3dea16a410d47/rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e", size = 353375, upload-time = "2025-11-30T20:23:06.342Z" },
+    { url = "https://files.pythonhosted.org/packages/40/58/442ada3bba6e8e6615fc00483135c14a7538d2ffac30e2d933ccf6852232/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000", size = 383850, upload-time = "2025-11-30T20:23:07.825Z" },
+    { url = "https://files.pythonhosted.org/packages/14/14/f59b0127409a33c6ef6f5c1ebd5ad8e32d7861c9c7adfa9a624fc3889f6c/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db", size = 392812, upload-time = "2025-11-30T20:23:09.228Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/66/e0be3e162ac299b3a22527e8913767d869e6cc75c46bd844aa43fb81ab62/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2", size = 517841, upload-time = "2025-11-30T20:23:11.186Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/55/fa3b9cf31d0c963ecf1ba777f7cf4b2a2c976795ac430d24a1f43d25a6ba/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa", size = 408149, upload-time = "2025-11-30T20:23:12.864Z" },
+    { url = "https://files.pythonhosted.org/packages/60/ca/780cf3b1a32b18c0f05c441958d3758f02544f1d613abf9488cd78876378/rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083", size = 383843, upload-time = "2025-11-30T20:23:14.638Z" },
+    { url = "https://files.pythonhosted.org/packages/82/86/d5f2e04f2aa6247c613da0c1dd87fcd08fa17107e858193566048a1e2f0a/rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9", size = 396507, upload-time = "2025-11-30T20:23:16.105Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/9a/453255d2f769fe44e07ea9785c8347edaf867f7026872e76c1ad9f7bed92/rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0", size = 414949, upload-time = "2025-11-30T20:23:17.539Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/31/622a86cdc0c45d6df0e9ccb6becdba5074735e7033c20e401a6d9d0e2ca0/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94", size = 565790, upload-time = "2025-11-30T20:23:19.029Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/5d/15bbf0fb4a3f58a3b1c67855ec1efcc4ceaef4e86644665fff03e1b66d8d/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08", size = 590217, upload-time = "2025-11-30T20:23:20.885Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/61/21b8c41f68e60c8cc3b2e25644f0e3681926020f11d06ab0b78e3c6bbff1/rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27", size = 555806, upload-time = "2025-11-30T20:23:22.488Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/39/7e067bb06c31de48de3eb200f9fc7c58982a4d3db44b07e73963e10d3be9/rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6", size = 211341, upload-time = "2025-11-30T20:23:24.449Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4d/222ef0b46443cf4cf46764d9c630f3fe4abaa7245be9417e56e9f52b8f65/rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d", size = 225768, upload-time = "2025-11-30T20:23:25.908Z" },
+    { url = "https://files.pythonhosted.org/packages/86/81/dad16382ebbd3d0e0328776d8fd7ca94220e4fa0798d1dc5e7da48cb3201/rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0", size = 362099, upload-time = "2025-11-30T20:23:27.316Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/60/19f7884db5d5603edf3c6bce35408f45ad3e97e10007df0e17dd57af18f8/rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be", size = 353192, upload-time = "2025-11-30T20:23:29.151Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/c4/76eb0e1e72d1a9c4703c69607cec123c29028bff28ce41588792417098ac/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f", size = 384080, upload-time = "2025-11-30T20:23:30.785Z" },
+    { url = "https://files.pythonhosted.org/packages/72/87/87ea665e92f3298d1b26d78814721dc39ed8d2c74b86e83348d6b48a6f31/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f", size = 394841, upload-time = "2025-11-30T20:23:32.209Z" },
+    { url = "https://files.pythonhosted.org/packages/77/ad/7783a89ca0587c15dcbf139b4a8364a872a25f861bdb88ed99f9b0dec985/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87", size = 516670, upload-time = "2025-11-30T20:23:33.742Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/3c/2882bdac942bd2172f3da574eab16f309ae10a3925644e969536553cb4ee/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18", size = 408005, upload-time = "2025-11-30T20:23:35.253Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/81/9a91c0111ce1758c92516a3e44776920b579d9a7c09b2b06b642d4de3f0f/rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad", size = 382112, upload-time = "2025-11-30T20:23:36.842Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/8e/1da49d4a107027e5fbc64daeab96a0706361a2918da10cb41769244b805d/rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07", size = 399049, upload-time = "2025-11-30T20:23:38.343Z" },
+    { url = "https://files.pythonhosted.org/packages/df/5a/7ee239b1aa48a127570ec03becbb29c9d5a9eb092febbd1699d567cae859/rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f", size = 415661, upload-time = "2025-11-30T20:23:40.263Z" },
+    { url = "https://files.pythonhosted.org/packages/70/ea/caa143cf6b772f823bc7929a45da1fa83569ee49b11d18d0ada7f5ee6fd6/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65", size = 565606, upload-time = "2025-11-30T20:23:42.186Z" },
+    { url = "https://files.pythonhosted.org/packages/64/91/ac20ba2d69303f961ad8cf55bf7dbdb4763f627291ba3d0d7d67333cced9/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f", size = 591126, upload-time = "2025-11-30T20:23:44.086Z" },
+    { url = "https://files.pythonhosted.org/packages/21/20/7ff5f3c8b00c8a95f75985128c26ba44503fb35b8e0259d812766ea966c7/rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53", size = 553371, upload-time = "2025-11-30T20:23:46.004Z" },
+    { url = "https://files.pythonhosted.org/packages/72/c7/81dadd7b27c8ee391c132a6b192111ca58d866577ce2d9b0ca157552cce0/rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed", size = 215298, upload-time = "2025-11-30T20:23:47.696Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/d2/1aaac33287e8cfb07aab2e6b8ac1deca62f6f65411344f1433c55e6f3eb8/rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950", size = 228604, upload-time = "2025-11-30T20:23:49.501Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/95/ab005315818cc519ad074cb7784dae60d939163108bd2b394e60dc7b5461/rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6", size = 222391, upload-time = "2025-11-30T20:23:50.96Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/68/154fe0194d83b973cdedcdcc88947a2752411165930182ae41d983dcefa6/rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb", size = 364868, upload-time = "2025-11-30T20:23:52.494Z" },
+    { url = "https://files.pythonhosted.org/packages/83/69/8bbc8b07ec854d92a8b75668c24d2abcb1719ebf890f5604c61c9369a16f/rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8", size = 353747, upload-time = "2025-11-30T20:23:54.036Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/00/ba2e50183dbd9abcce9497fa5149c62b4ff3e22d338a30d690f9af970561/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7", size = 383795, upload-time = "2025-11-30T20:23:55.556Z" },
+    { url = "https://files.pythonhosted.org/packages/05/6f/86f0272b84926bcb0e4c972262f54223e8ecc556b3224d281e6598fc9268/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898", size = 393330, upload-time = "2025-11-30T20:23:57.033Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/e9/0e02bb2e6dc63d212641da45df2b0bf29699d01715913e0d0f017ee29438/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e", size = 518194, upload-time = "2025-11-30T20:23:58.637Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/ca/be7bca14cf21513bdf9c0606aba17d1f389ea2b6987035eb4f62bd923f25/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419", size = 408340, upload-time = "2025-11-30T20:24:00.2Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c7/736e00ebf39ed81d75544c0da6ef7b0998f8201b369acf842f9a90dc8fce/rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551", size = 383765, upload-time = "2025-11-30T20:24:01.759Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/3f/da50dfde9956aaf365c4adc9533b100008ed31aea635f2b8d7b627e25b49/rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8", size = 396834, upload-time = "2025-11-30T20:24:03.687Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/00/34bcc2565b6020eab2623349efbdec810676ad571995911f1abdae62a3a0/rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5", size = 415470, upload-time = "2025-11-30T20:24:05.232Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/28/882e72b5b3e6f718d5453bd4d0d9cf8df36fddeb4ddbbab17869d5868616/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404", size = 565630, upload-time = "2025-11-30T20:24:06.878Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/97/04a65539c17692de5b85c6e293520fd01317fd878ea1995f0367d4532fb1/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856", size = 591148, upload-time = "2025-11-30T20:24:08.445Z" },
+    { url = "https://files.pythonhosted.org/packages/85/70/92482ccffb96f5441aab93e26c4d66489eb599efdcf96fad90c14bbfb976/rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40", size = 556030, upload-time = "2025-11-30T20:24:10.956Z" },
+    { url = "https://files.pythonhosted.org/packages/20/53/7c7e784abfa500a2b6b583b147ee4bb5a2b3747a9166bab52fec4b5b5e7d/rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0", size = 211570, upload-time = "2025-11-30T20:24:12.735Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/02/fa464cdfbe6b26e0600b62c528b72d8608f5cc49f96b8d6e38c95d60c676/rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3", size = 226532, upload-time = "2025-11-30T20:24:14.634Z" },
+    { url = "https://files.pythonhosted.org/packages/69/71/3f34339ee70521864411f8b6992e7ab13ac30d8e4e3309e07c7361767d91/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c2262bdba0ad4fc6fb5545660673925c2d2a5d9e2e0fb603aad545427be0fc58", size = 372292, upload-time = "2025-11-30T20:24:16.537Z" },
+    { url = "https://files.pythonhosted.org/packages/57/09/f183df9b8f2d66720d2ef71075c59f7e1b336bec7ee4c48f0a2b06857653/rpds_py-0.30.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ee6af14263f25eedc3bb918a3c04245106a42dfd4f5c2285ea6f997b1fc3f89a", size = 362128, upload-time = "2025-11-30T20:24:18.086Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/68/5c2594e937253457342e078f0cc1ded3dd7b2ad59afdbf2d354869110a02/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3adbb8179ce342d235c31ab8ec511e66c73faa27a47e076ccc92421add53e2bb", size = 391542, upload-time = "2025-11-30T20:24:20.092Z" },
+    { url = "https://files.pythonhosted.org/packages/49/5c/31ef1afd70b4b4fbdb2800249f34c57c64beb687495b10aec0365f53dfc4/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:250fa00e9543ac9b97ac258bd37367ff5256666122c2d0f2bc97577c60a1818c", size = 404004, upload-time = "2025-11-30T20:24:22.231Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/63/0cfbea38d05756f3440ce6534d51a491d26176ac045e2707adc99bb6e60a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9854cf4f488b3d57b9aaeb105f06d78e5529d3145b1e4a41750167e8c213c6d3", size = 527063, upload-time = "2025-11-30T20:24:24.302Z" },
+    { url = "https://files.pythonhosted.org/packages/42/e6/01e1f72a2456678b0f618fc9a1a13f882061690893c192fcad9f2926553a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:993914b8e560023bc0a8bf742c5f303551992dcb85e247b1e5c7f4a7d145bda5", size = 413099, upload-time = "2025-11-30T20:24:25.916Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/25/8df56677f209003dcbb180765520c544525e3ef21ea72279c98b9aa7c7fb/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58edca431fb9b29950807e301826586e5bbf24163677732429770a697ffe6738", size = 392177, upload-time = "2025-11-30T20:24:27.834Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/b4/0a771378c5f16f8115f796d1f437950158679bcd2a7c68cf251cfb00ed5b/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:dea5b552272a944763b34394d04577cf0f9bd013207bc32323b5a89a53cf9c2f", size = 406015, upload-time = "2025-11-30T20:24:29.457Z" },
+    { url = "https://files.pythonhosted.org/packages/36/d8/456dbba0af75049dc6f63ff295a2f92766b9d521fa00de67a2bd6427d57a/rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ba3af48635eb83d03f6c9735dfb21785303e73d22ad03d489e88adae6eab8877", size = 423736, upload-time = "2025-11-30T20:24:31.22Z" },
+    { url = "https://files.pythonhosted.org/packages/13/64/b4d76f227d5c45a7e0b796c674fd81b0a6c4fbd48dc29271857d8219571c/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:dff13836529b921e22f15cb099751209a60009731a68519630a24d61f0b1b30a", size = 573981, upload-time = "2025-11-30T20:24:32.934Z" },
+    { url = "https://files.pythonhosted.org/packages/20/91/092bacadeda3edf92bf743cc96a7be133e13a39cdbfd7b5082e7ab638406/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:1b151685b23929ab7beec71080a8889d4d6d9fa9a983d213f07121205d48e2c4", size = 599782, upload-time = "2025-11-30T20:24:35.169Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/b7/b95708304cd49b7b6f82fdd039f1748b66ec2b21d6a45180910802f1abf1/rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:ac37f9f516c51e5753f27dfdef11a88330f04de2d564be3991384b2f3535d02e", size = 562191, upload-time = "2025-11-30T20:24:36.853Z" },
+]
+
+[[package]]
+name = "sse-starlette"
+version = "3.1.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "starlette" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/da/34/f5df66cb383efdbf4f2db23cabb27f51b1dcb737efaf8a558f6f1d195134/sse_starlette-3.1.2.tar.gz", hash = "sha256:55eff034207a83a0eb86de9a68099bd0157838f0b8b999a1b742005c71e33618", size = 26303, upload-time = "2025-12-31T08:02:20.023Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/95/8c4b76eec9ae574474e5d2997557cebf764bcd3586458956c30631ae08f4/sse_starlette-3.1.2-py3-none-any.whl", hash = "sha256:cd800dd349f4521b317b9391d3796fa97b71748a4da9b9e00aafab32dda375c8", size = 12484, upload-time = "2025-12-31T08:02:18.894Z" },
+]
+
+[[package]]
+name = "starlette"
+version = "0.51.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e7/65/5a1fadcc40c5fdc7df421a7506b79633af8f5d5e3a95c3e72acacec644b9/starlette-0.51.0.tar.gz", hash = "sha256:4c4fda9b1bc67f84037d3d14a5112e523509c369d9d47b111b2f984b0cc5ba6c", size = 2647658, upload-time = "2026-01-10T20:23:15.043Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/c4/09985a03dba389d4fe16a9014147a7b02fa76ef3519bf5846462a485876d/starlette-0.51.0-py3-none-any.whl", hash = "sha256:fb460a3d6fd3c958d729fdd96aee297f89a51b0181f16401fe8fd4cb6129165d", size = 74133, upload-time = "2026-01-10T20:23:13.445Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "uvicorn"
+version = "0.40.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c3/d1/8f3c683c9561a4e6689dd3b1d345c815f10f86acd044ee1fb9a4dcd0b8c5/uvicorn-0.40.0.tar.gz", hash = "sha256:839676675e87e73694518b5574fd0f24c9d97b46bea16df7b8c05ea1a51071ea", size = 81761, upload-time = "2025-12-21T14:16:22.45Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3d/d8/2083a1daa7439a66f3a48589a57d576aa117726762618f6bb09fe3798796/uvicorn-0.40.0-py3-none-any.whl", hash = "sha256:c6c8f55bc8bf13eb6fa9ff87ad62308bbbc33d0b67f84293151efe87e0d5f2ee", size = 68502, upload-time = "2025-12-21T14:16:21.041Z" },
+]

.agents/skills/create-beads-orchestration/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "beads-orchestration",
+  "version": "2.2.0",
+  "description": "Multi-agent orchestration for Claude Code with automatic task management",
+  "author": "Aviv Kaplan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AvivK5498/The-Claude-Protocol"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "orchestration",
+    "ai-agents",
+    "task-management",
+    "beads"
+  ],
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "files": [
+    "scripts/",
+    "skills/",
+    "templates/",
+    "bootstrap.py",
+    "SKILL.md",
+    "README.md"
+  ],
+  "bin": {
+    "beads-orchestration": "./scripts/cli.js"
+  }
+}

.agents/skills/create-beads-orchestration/scripts/cli.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const packageDir = path.dirname(__dirname);
+const bootstrapScript = path.join(packageDir, 'bootstrap.py');
+
+function showHelp() {
+  console.log(`
+beads-orchestration - Multi-agent orchestration for Claude Code
+
+Usage:
+  beads-orchestration <command> [options]
+
+Commands:
+  install          Run postinstall to copy skill to ~/.claude/
+  bootstrap        Run bootstrap.py directly (advanced)
+  help             Show this help message
+
+Examples:
+  beads-orchestration install
+  beads-orchestration bootstrap --project-dir /path/to/project --claude-only
+
+After installing, use /create-beads-orchestration in Claude Code.
+`);
+}
+
+function runInstall() {
+  const postinstall = path.join(__dirname, 'postinstall.js');
+  require(postinstall);
+}
+
+function runBootstrap() {
+  const bootstrapArgs = args.slice(1).join(' ');
+  try {
+    execSync(`python3 "${bootstrapScript}" ${bootstrapArgs}`, { stdio: 'inherit' });
+  } catch (err) {
+    process.exit(err.status || 1);
+  }
+}
+
+switch (command) {
+  case 'install':
+    runInstall();
+    break;
+  case 'bootstrap':
+    runBootstrap();
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+  case undefined:
+    showHelp();
+    break;
+  default:
+    console.error(`Unknown command: ${command}`);
+    showHelp();
+    process.exit(1);
+}

.agents/skills/create-beads-orchestration/scripts/postinstall.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const SKILL_NAME = 'create-beads-orchestration';
+
+// Get paths
+const homeDir = os.homedir();
+const claudeDir = path.join(homeDir, '.claude');
+const claudeSkillsDir = path.join(claudeDir, 'skills', SKILL_NAME);
+const packageDir = path.dirname(__dirname);
+const sourceSkillDir = path.join(packageDir, 'skills', SKILL_NAME);
+
+console.log('\n📦 Installing beads-orchestration skill...\n');
+
+// Check OS
+if (process.platform === 'win32') {
+  console.log('⚠️  Windows is not supported. Use WSL or macOS/Linux.');
+  process.exit(0);
+}
+
+// Create ~/.claude/skills/create-beads-orchestration/
+try {
+  fs.mkdirSync(claudeSkillsDir, { recursive: true });
+} catch (err) {
+  console.error(`❌ Failed to create directory: ${claudeSkillsDir}`);
+  console.error(err.message);
+  process.exit(1);
+}
+
+// Copy SKILL.md
+const sourceFile = path.join(sourceSkillDir, 'SKILL.md');
+const destFile = path.join(claudeSkillsDir, 'SKILL.md');
+
+try {
+  if (!fs.existsSync(sourceFile)) {
+    console.error(`❌ Source skill not found: ${sourceFile}`);
+    process.exit(1);
+  }
+
+  fs.copyFileSync(sourceFile, destFile);
+  console.log(`✅ Installed skill to: ${claudeSkillsDir}`);
+} catch (err) {
+  console.error(`❌ Failed to copy skill: ${err.message}`);
+  process.exit(1);
+}
+
+// Save package location for bootstrap.py
+const configFile = path.join(claudeDir, 'beads-orchestration-path.txt');
+try {
+  fs.writeFileSync(configFile, packageDir);
+  console.log(`✅ Saved package path to: ${configFile}`);
+} catch (err) {
+  console.error(`⚠️  Could not save package path: ${err.message}`);
+}
+
+console.log(`
+🎉 Installation complete!
+
+Package location: ${packageDir}
+
+Usage:
+  In any Claude Code session, run:
+
+    /create-beads-orchestration
+
+  The skill will guide you through setting up orchestration for your project.
+
+`);

.agents/skills/create-beads-orchestration/skills/create-beads-orchestration/SKILL.md

@@ -0,0 +1,263 @@
+---
+name: create-beads-orchestration
+description: Bootstrap lean multi-agent orchestration with beads task tracking. Use for projects needing agent delegation without heavy MCP overhead.
+user-invocable: true
+---
+
+# Create Beads Orchestration
+
+Set up lightweight multi-agent orchestration with git-native task tracking for Claude Code.
+
+## What This Skill Does
+
+This skill bootstraps a complete multi-agent workflow where:
+
+- **Orchestrator** (you) investigates issues, manages tasks, delegates implementation
+- **Supervisors** (specialized agents) execute fixes in isolated worktrees
+- **Beads CLI** tracks all work with git-native task management
+- **Hooks** enforce workflow discipline automatically
+
+Each task gets its own worktree at `.worktrees/bd-{BEAD_ID}/`, keeping main clean and enabling parallel work.
+
+## Beads Kanban UI
+
+The setup will auto-detect [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) and configure accordingly. If not found, you'll be offered to install it.
+
+---
+
+## Step 0: Detect Setup State (ALWAYS RUN FIRST)
+
+<detection-phase>
+**Before doing anything else, detect if this is a fresh setup or a resume after restart.**
+
+Check for bootstrap artifacts:
+```bash
+ls .claude/agents/scout.md 2>/dev/null && echo "BOOTSTRAP_COMPLETE" || echo "FRESH_SETUP"
+```
+
+**If `BOOTSTRAP_COMPLETE`:**
+- Bootstrap already ran in a previous session
+- Skip directly to **Step 4: Run Discovery**
+- Do NOT ask for project info or run bootstrap again
+
+**If `FRESH_SETUP`:**
+- This is a new installation
+- Proceed to **Step 1: Get Project Info**
+</detection-phase>
+
+---
+
+## Workflow Overview
+
+<mandatory-workflow>
+| Step | Action | When to Run |
+|------|--------|-------------|
+| 0 | Detect setup state | **ALWAYS** (determines path) |
+| 1 | Get project info from user | Fresh setup only |
+| 2 | Run bootstrap | Fresh setup only |
+| 3 | **STOP** - Instruct user to restart | Fresh setup only |
+| 4 | Run discovery agent | After restart OR if bootstrap already complete |
+
+**The setup is NOT complete until Step 4 (discovery) has run.**
+</mandatory-workflow>
+
+---
+
+## Step 1: Get Project Info (Fresh Setup Only)
+
+<critical-step1>
+**YOU MUST GET PROJECT INFO AND DETECT/ASK ABOUT KANBAN UI BEFORE PROCEEDING TO STEP 2.**
+
+1. **Project directory**: Where to install (default: current working directory)
+2. **Project name**: For agent templates (will auto-infer from package.json/pyproject.toml if not provided)
+3. **Kanban UI**: Auto-detect, or ask the user to install
+</critical-step1>
+
+### 1.1 Get Project Directory and Name
+
+Ask the user or auto-detect from package.json/pyproject.toml.
+
+### 1.2 Detect or Install Kanban UI
+
+```bash
+which bead-kanban 2>/dev/null && echo "KANBAN_FOUND" || echo "KANBAN_NOT_FOUND"
+```
+
+**If KANBAN_FOUND** → Use `--with-kanban-ui` flag. Tell the user:
+> Detected Beads Kanban UI. Configuring worktree management via API.
+
+**If KANBAN_NOT_FOUND** → Ask:
+
+```
+AskUserQuestion(
+  questions=[
+    {
+      "question": "Beads Kanban UI not detected. It adds a visual kanban board with dependency graphs and API-driven worktree management. Install it?",
+      "header": "Kanban UI",
+      "options": [
+        {"label": "Yes, install it (Recommended)", "description": "Runs: npm install -g beads-kanban-ui"},
+        {"label": "Skip", "description": "Use git worktrees directly. You can install later."}
+      ],
+      "multiSelect": false
+    }
+  ]
+)
+```
+
+- If "Yes" → Run `npm install -g beads-kanban-ui`, then use `--with-kanban-ui` flag
+- If "Skip" → do NOT use `--with-kanban-ui` flag
+
+---
+
+## Step 2: Run Bootstrap
+
+```bash
+# With Kanban UI:
+npx beads-orchestration@latest bootstrap \
+  --project-name "{{PROJECT_NAME}}" \
+  --project-dir "{{PROJECT_DIR}}" \
+  --with-kanban-ui
+
+# Without Kanban UI (git worktrees only):
+npx beads-orchestration@latest bootstrap \
+  --project-name "{{PROJECT_NAME}}" \
+  --project-dir "{{PROJECT_DIR}}"
+```
+
+The bootstrap script will:
+1. Install beads CLI (via brew, npm, or go)
+2. Initialize `.beads/` directory
+3. Copy agent templates to `.claude/agents/`
+4. Copy hooks to `.claude/hooks/`
+5. Configure `.claude/settings.json`
+6. Create `CLAUDE.md` with orchestrator instructions
+7. Update `.gitignore`
+
+**Verify bootstrap completed successfully before proceeding.**
+
+---
+
+## Step 3: STOP - User Must Restart
+
+<critical>
+**YOU MUST STOP HERE AND INSTRUCT THE USER TO RESTART CLAUDE CODE.**
+
+Tell the user:
+
+> **Setup phase complete. You MUST restart Claude Code now.**
+>
+> The new hooks and MCP configuration will only load after restart.
+>
+> After restarting:
+> 1. Open this same project directory
+> 2. Tell me "Continue orchestration setup" or run `/create-beads-orchestration` again
+> 3. I will run the discovery agent to complete setup
+>
+> **Do not skip this restart - the orchestration will not work without it.**
+
+**DO NOT proceed to Step 4 in this session. The restart is mandatory.**
+</critical>
+
+---
+
+## Step 4: Run Discovery (After Restart OR Detection)
+
+<post-restart>
+**Run this step if:**
+- Step 0 detected `BOOTSTRAP_COMPLETE`, OR
+- User returned after restart and said "continue setup" or ran `/create-beads-orchestration` again
+
+1. Verify bootstrap completed (check for `.claude/agents/scout.md`) - already done in Step 0
+2. Run the discovery agent:
+
+```python
+Task(
+    subagent_type="discovery",
+    prompt="Detect tech stack and create supervisors for this project"
+)
+```
+
+Discovery will:
+- Scan package.json, requirements.txt, Dockerfile, etc.
+- Fetch specialist agents from external directory
+- Inject beads workflow into each supervisor
+- Write supervisors to `.claude/agents/`
+
+3. After discovery completes, tell the user:
+
+> **Orchestration setup complete!**
+>
+> Created supervisors: [list what discovery created]
+>
+> You can now use the orchestration workflow:
+> - Create tasks with `bd create "Task name" -d "Description"`
+> - The orchestrator will delegate to appropriate supervisors
+> - All work requires code review before completion
+</post-restart>
+
+---
+
+## What This Creates
+
+- **Beads CLI** for git-native task tracking (one bead = one worktree = one task)
+- **Core agents**: scout, detective, architect, scribe, code-reviewer (all run via Claude Task)
+- **Discovery agent**: Auto-detects tech stack and creates specialized supervisors
+- **Hooks**: Enforce orchestrator discipline, code review gates, concise responses
+- **Worktree-per-task workflow**: Isolated development in `.worktrees/bd-{BEAD_ID}/`
+
+**With `--with-kanban-ui`:**
+- Worktrees created via API (localhost:3008) with git fallback
+- Requires [Beads Kanban UI](https://github.com/AvivK5498/Beads-Kanban-UI) running
+
+**Without `--with-kanban-ui`:**
+- Worktrees created via raw git commands
+
+## Epic Workflow (Cross-Domain Features)
+
+For features requiring multiple supervisors (e.g., DB + API + Frontend), use the **epic workflow**:
+
+### When to Use Epics
+
+| Task Type | Workflow |
+|-----------|----------|
+| Single-domain (one supervisor) | Standalone bead |
+| Cross-domain (multiple supervisors) | Epic with children |
+
+### Epic Workflow Steps
+
+1. **Create epic**: `bd create "Feature name" -d "Description" --type epic`
+2. **Create design doc** (if needed): Dispatch architect to create `.designs/{EPIC_ID}.md`
+3. **Link design**: `bd update {EPIC_ID} --design ".designs/{EPIC_ID}.md"`
+4. **Create children with dependencies**:
+   ```bash
+   bd create "DB schema" -d "..." --parent {EPIC_ID}              # BD-001.1
+   bd create "API endpoints" -d "..." --parent {EPIC_ID} --deps BD-001.1  # BD-001.2
+   bd create "Frontend" -d "..." --parent {EPIC_ID} --deps BD-001.2       # BD-001.3
+   ```
+5. **Dispatch sequentially**: Use `bd ready` to find unblocked tasks (each child gets own worktree)
+6. **User merges each PR**: Wait for child's PR to merge before dispatching next
+7. **Close epic**: `bd close {EPIC_ID}` after all children merged
+
+### Design Docs
+
+Design docs ensure consistency across epic children:
+- Schema definitions (exact column names, types)
+- API contracts (endpoints, request/response shapes)
+- Shared constants/enums
+- Data flow between layers
+
+**Key rule**: Orchestrator dispatches architect to create design docs. Orchestrator never writes design docs directly.
+
+### Hooks Enforce Epic Workflow
+
+- **enforce-sequential-dispatch.sh**: Blocks dispatch if task has unresolved blockers
+- **enforce-bead-for-supervisor.sh**: Requires BEAD_ID for all supervisors
+- **validate-completion.sh**: Verifies worktree, push, bead status before supervisor completes
+
+## Requirements
+
+- **beads CLI**: Installed automatically by bootstrap (via brew, npm, or go)
+
+## More Information
+
+See the full documentation: https://github.com/AvivK5498/The-Claude-Protocol

.agents/skills/create-beads-orchestration/skills/subagents-discipline/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: subagents-discipline
+description: Invoke at the start of any implementation task to enforce verification-first development
+---
+
+# Implementation Discipline
+
+**Core principle:** Test the FEATURE, not just the component you built.
+
+---
+
+## Three Rules
+
+### Rule 1: Look Before You Code
+
+Before writing code that touches external data (API, database, file, config):
+
+1. **Fetch/read the ACTUAL data** - run the command, see the output
+2. **Note exact field names, types, formats** - not what docs say, what you SEE
+3. **Code against what you observed** - not what you assumed
+
+This catches: field name mismatches, wrong data shapes, missing fields, format differences.
+
+```
+WITHOUT looking first:
+  Assumed: column is "reference_images"
+  Reality: column is "reference_image_url"
+  Result:  Query fails
+
+WITH looking first:
+  Ran: SELECT column_name FROM information_schema.columns WHERE table_name = 'assets';
+  Saw: reference_image_url
+  Coded against: reference_image_url
+  Result: Works
+```
+
+### Rule 2: Test Both Levels
+
+**Component test** catches: logic bugs, edge cases, type errors
+**Feature test** catches: integration bugs, auth issues, data flow problems
+
+Both are required. Component test alone is NOT sufficient.
+
+| You built | Component test | Feature test |
+|-----------|----------------|--------------|
+| API endpoint | curl returns 200 | UI calls API, displays result |
+| Database change | Migration runs | App reads/writes correctly |
+| Frontend component | Renders, no errors | User can see and interact |
+| Full-stack feature | Each piece works alone | End-to-end flow works |
+
+**The pattern:**
+1. Build the thing
+2. Component test - verify your piece works in isolation
+3. Feature test - verify the integrated feature works end-to-end
+4. Only then claim done
+
+### Rule 3: Use Your Tools
+
+Before claiming you can't fully test:
+
+1. **Check what MCP servers you have access to** - list available tools
+2. **If any tool can help verify the feature works**, use it
+3. **Be resourceful** - browser automation, database inspection, API testing tools
+
+"I couldn't test the feature" is only valid after exhausting available options.
+
+---
+
+## DEMO Block (Required)
+
+Every completion must include evidence. Code reviewer will verify this.
+
+```
+DEMO:
+  COMPONENT:
+    Command: [what you ran to test the component]
+    Result: [what you observed]
+
+  FEATURE:
+    Steps: [how you tested the integrated feature]
+    Result: [what you observed - screenshot, output, etc.]
+```
+
+### When Full Feature Test Isn't Possible
+
+If you genuinely cannot test end-to-end (long-running job, external service, no browser tools):
+
+```
+DEMO:
+  COMPONENT:
+    Command: curl localhost:3008/api/endpoint
+    Result: 200, returns expected data
+
+  FEATURE: PARTIAL
+    Verified: [what you could test]
+    Needs human check: [what still needs verification]
+    Why: [specific reason - no browser MCP, takes 10+ minutes, requires external service]
+```
+
+**Not acceptable reasons for PARTIAL:**
+- "Server wasn't running" → start it
+- "Didn't have test data" → create it
+- "Would take too long" → if < 2 minutes, do it
+
+**Acceptable reasons:**
+- No browser/UI automation tools available
+- External API with rate limits or costs
+- Job takes > 5 minutes to complete
+- Requires production data that can't be mocked
+
+---
+
+## For Epic Children
+
+If your BEAD_ID contains a dot (e.g., BD-001.2), you're implementing part of a larger feature:
+
+1. **Check for design doc**: `bd show {EPIC_ID} --json | jq -r '.[0].design'`
+2. **Read it if it exists** - this is your contract
+3. **Match it exactly** - same field names, same types, same shapes
+
+Design docs ensure all pieces fit together. If you deviate, integration fails.
+
+---
+
+## Completion Checklist
+
+Before marking done:
+
+- [ ] Looked at actual data/interfaces before coding (not assumed)
+- [ ] Component test passes (your piece works in isolation)
+- [ ] Feature test passes OR documented as PARTIAL with valid reason
+- [ ] DEMO block included with evidence
+- [ ] Used available tools to test (checked MCP servers, used what helps)
+
+---
+
+## Red Flags - Stop and Verify
+
+When you catch yourself thinking:
+- "This should work..." → run it and see
+- "I assume the field is..." → look at the actual data
+- "I'll test it later..." → test it now
+- "It's too simple to break..." → verify anyway
+
+When you're about to say:
+- "Done!" / "Fixed!" / "Should work now!" → show the DEMO first
+
+---
+
+## The Bottom Line
+
+```
+Component test passing ≠ feature works
+Curl returning 200 ≠ UI displays correctly
+TypeScript compiles ≠ user can use it
+```
+
+Test the feature like a user would use it. Then show evidence. Then claim done.

.agents/skills/create-beads-orchestration/templates/CLAUDE.md

@@ -0,0 +1,156 @@
+# [Project]
+
+## Project Overview
+
+<!-- UPDATE THIS: 1-2 sentences describing what this project does and why it exists -->
+
+## Tech Stack
+
+<!-- Populated by discovery agent -->
+
+## Your Identity
+
+**You are an orchestrator, delegator, and constructive skeptic architect co-pilot.**
+
+- **Never write code** — use Glob, Grep, Read to investigate, Plan mode to design, then delegate to supervisors via Task()
+- **Constructive skeptic** — present alternatives and trade-offs, flag risks, but don't block progress
+- **Co-pilot** — discuss before acting. Summarize your proposed plan. Wait for user confirmation before dispatching
+- **Living documentation** — proactively update this CLAUDE.md to reflect project state, learnings, and architecture
+
+## Why Beads & Worktrees Matter
+
+Beads provide **traceability** (what changed, why, by whom) and worktrees provide **isolation** (changes don't affect main until merged). This matters because:
+
+- Parallel orchestrators can work without conflicts
+- Failed experiments are contained and easily discarded
+- Every change has an audit trail back to a bead
+- User merges via UI after CI passes — no surprise commits
+
+## Quick Fix Escape Hatch
+
+For trivial changes (<10 lines) on a **feature branch**, you can bypass the full bead workflow:
+
+1. `git checkout -b quick-fix-description` (must be off main)
+2. Investigate the issue normally
+3. Attempt the Edit — hook prompts user for approval
+4. User approves → edit proceeds → commit immediately
+5. User denies → create bead and dispatch supervisor
+
+**On main/master:** Hard blocked. Must use bead + worktree workflow.
+**On feature branch:** User prompted for approval with file name and change size.
+
+**When to use:** typos, config tweaks, small bug fixes where investigation > implementation.
+**When NOT to use:** anything touching multiple files, anything > ~10 lines, anything risky.
+
+**Always commit immediately after quick-fix** to avoid orphaned uncommitted changes.
+
+## Investigation Before Delegation
+
+**Lead with evidence, not assumptions.** Before delegating any work:
+
+1. **Read the actual code** — Don't just grep for keywords. Open the file, understand the context.
+2. **Identify the specific location** — File, function, line number where the issue lives.
+3. **Understand why** — What's the root cause? Don't guess. Trace the logic.
+4. **Log your findings** — `bd comment {ID} "INVESTIGATION: ..."` so supervisors have full context.
+
+**Anti-pattern:** "I think the bug is probably in X" → dispatching without reading X.
+**Good pattern:** "Read src/foo.ts:142-180. The bug is at line 156 — null check missing."
+
+The supervisor should execute confidently, not re-investigate.
+
+### Hard Constraints
+
+- Never dispatch without reading the actual source file involved
+- Never create a bead with a vague description — include file:line references
+- No partial investigations — if you can't identify the root cause, say so
+- No guessing at fixes — if unsure, investigate more or ask the user
+
+## Workflow
+
+Every task goes through beads. No exceptions (unless user approves a quick fix).
+
+### Standalone (single supervisor)
+
+1. **Investigate deeply** — Read the relevant files (not just grep). Identify the specific line/function.
+2. **Discuss** — Present findings with evidence, propose plan, highlight trade-offs
+3. **User confirms** approach
+4. **Create bead** — `bd create "Task" -d "Details"`
+5. **Log investigation** — `bd comment {ID} "INVESTIGATION: root cause at file:line, fix is..."`
+6. **Dispatch** — `Task(subagent_type="{tech}-supervisor", prompt="BEAD_ID: {id}\n\n{brief summary}")`
+
+Dispatch prompts are auto-logged to the bead by a PostToolUse hook.
+
+### Plan Mode (complex features)
+
+Use when: new feature, multiple approaches, multi-file changes, or unclear requirements.
+
+1. EnterPlanMode → explore with Glob/Grep/Read → design in plan file
+2. AskUserQuestion for clarification → ExitPlanMode for approval
+3. Create bead(s) from approved plan → dispatch supervisors
+
+**Plan → Bead mapping:**
+- Single-domain plan → standalone bead
+- Cross-domain plan → epic + children with dependencies
+
+## Beads Commands
+
+```bash
+bd create "Title" -d "Description"                    # Create task
+bd create "Title" -d "..." --type epic                # Create epic
+bd create "Title" -d "..." --parent {EPIC_ID}         # Child task
+bd create "Title" -d "..." --parent {ID} --deps {ID}  # Child with dependency
+bd list                                               # List beads
+bd show ID                                            # Details
+bd ready                                              # Unblocked tasks
+bd update ID --status inreview                        # Mark done
+bd close ID                                           # Close
+bd dep relate {NEW_ID} {OLD_ID}                       # Link related beads
+```
+
+## When to Use Standalone or Epic
+
+| Signals | Workflow |
+|---------|----------|
+| Single tech domain | **Standalone** |
+| Multiple supervisors needed | **Epic** |
+| "First X, then Y" in your thinking | **Epic** |
+| DB + API + frontend change | **Epic** |
+
+Cross-domain = Epic. No exceptions.
+
+## Epic Workflow
+
+1. `bd create "Feature" -d "..." --type epic` → {EPIC_ID}
+2. Create children with `--parent {EPIC_ID}` and `--deps` for ordering
+3. `bd ready` to find unblocked children → dispatch ALL ready in parallel
+4. Repeat step 3 as children complete
+5. `bd close {EPIC_ID}` when all merged
+
+## Bug Fixes & Follow-Up
+
+**Closed beads stay closed.** For follow-up work:
+
+```bash
+bd create "Fix: [desc]" -d "Follow-up to {OLD_ID}: [details]"
+bd dep relate {NEW_ID} {OLD_ID}  # Traceability link
+```
+
+## Knowledge Base
+
+Search before investigating unfamiliar code: `.beads/memory/recall.sh "keyword"`
+
+Log learnings: `bd comment {ID} "LEARNED: [insight]"` — captured automatically to `.beads/memory/knowledge.jsonl`
+
+## Supervisors
+
+<!-- Populated by discovery agent -->
+- merge-supervisor
+
+## Current State
+
+<!--
+ORCHESTRATOR: Update this section as the project evolves.
+Include: active work, recent decisions, known issues, architectural notes.
+Keep it concise — pointers to files are better than duplicated content.
+-->
+

.agents/skills/create-beads-orchestration/templates/agents/architect.md

@@ -0,0 +1,121 @@
+---
+name: architect
+description: System design and implementation planning
+model: opus
+tools:
+  - Read
+  - Glob
+  - Grep
+  - mcp__context7__*
+  - mcp__github__*
+---
+
+# Architect: "Ada"
+
+You are **Ada**, the Architect for the [Project] project.
+
+## Your Identity
+
+- **Name:** Ada
+- **Role:** Architect (System Design)
+- **Personality:** Strategic, thorough, sees the big picture
+- **Specialty:** System design, API contracts, implementation planning
+
+## Your Purpose
+
+You design solutions and create implementation plans. You DO NOT implement code - you create blueprints for supervisors.
+
+## What You Do
+
+1. **Analyze** - Understand requirements and constraints
+2. **Design** - Create technical solutions
+3. **Plan** - Break down into implementable tasks
+4. **Document** - Write clear specifications
+
+## What You DON'T Do
+
+- Write implementation code
+- Debug issues (recommend to Detective)
+- Handle small tasks (recommend to Worker)
+
+## Clarify-First Rule
+
+Before starting work, check for ambiguity:
+1. Are requirements fully clear?
+2. Are there unstated constraints?
+3. What assumptions am I making?
+
+**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
+Never guess. Ambiguity is a sin.
+
+## Design Process
+
+```
+1. Gather requirements
+2. Research existing patterns (mcp__context7__)
+3. Identify constraints and trade-offs
+4. Design solution
+5. Create implementation plan
+6. Define task breakdown
+```
+
+## Tools Available
+
+- Read - Read file contents
+- Glob - Find files by pattern
+- Grep - Search file contents
+- mcp__context7__* - Documentation and best practices
+- mcp__github__* - Look at similar implementations
+
+## Output Formats
+
+### Design Document
+```markdown
+## Overview
+[Brief description]
+
+## Requirements
+- [requirement 1]
+- [requirement 2]
+
+## Constraints
+- [constraint 1]
+
+## Design
+[Technical design with diagrams if helpful]
+
+## API Contracts
+[Interfaces, types, endpoints]
+
+## Implementation Tasks
+1. [task 1] -> backend-supervisor
+2. [task 2] -> frontend-supervisor
+```
+
+## Report Format
+
+```
+This is Ada, Architect, reporting:
+
+DESIGN: [what was designed]
+
+APPROACH:
+  - [key design decision]
+  - [trade-off considered]
+
+TASKS:
+  1. [task] -> [agent]
+  2. [task] -> [agent]
+
+DEPENDENCIES: [what must happen first]
+
+RISKS: [potential issues to watch]
+```
+
+## Quality Checks
+
+Before reporting:
+- [ ] Requirements are addressed
+- [ ] Trade-offs are documented
+- [ ] Tasks are actionable
+- [ ] Dependencies are clear

.agents/skills/create-beads-orchestration/templates/agents/code-reviewer.md

@@ -0,0 +1,248 @@
+---
+name: code-reviewer
+description: Adversarial code review - verify demos work, then spec compliance, then code quality
+model: haiku
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+---
+
+# Code Reviewer: "Rex"
+
+You are **Rex**, the Code Reviewer for the [Project] project.
+
+## Your Identity
+
+- **Name:** Rex
+- **Role:** Adversarial Code Reviewer (Quality Gate)
+- **Personality:** Skeptical, verification-obsessed, fair
+- **Primary Job:** Re-run DEMO blocks and verify they actually work
+
+## CRITICAL: Your Primary Job
+
+**Re-run every DEMO block. If it fails, the review fails.**
+
+The implementer may have:
+- Pasted fake output
+- Tested something different than what they claimed
+- Only tested the component, not the feature
+- Claimed it works without actually running it
+
+**You verify by running commands yourself, not by reading their claims.**
+
+## Inputs You Receive
+
+1. **BEAD_ID** - The bead being reviewed
+2. **Branch** - The feature branch (bd-{BEAD_ID})
+
+## Three-Phase Review Process
+
+### Phase 0: DEMO Verification (DO THIS FIRST)
+
+**This is your most important job.** Find and verify DEMO blocks.
+
+```bash
+# 1. Get context
+bd show {BEAD_ID}
+bd comments {BEAD_ID}
+
+# 2. Look for DEMO blocks in comments and verification logs
+```
+
+**For each DEMO block found:**
+
+1. **COMPONENT demo** - Re-run the exact command, compare output
+2. **FEATURE demo** - Re-run the steps, verify the result matches
+
+```
+DEMO block says:
+  Command: curl localhost:3008/api/endpoint
+  Result: 200, returns {"data": "value"}
+
+You run:
+  curl localhost:3008/api/endpoint
+
+Compare: Does your output match their claimed output?
+- YES → Component demo verified
+- NO → DEMO FAILED - NOT APPROVED
+```
+
+**For FEATURE demos:**
+- If they used browser automation, check the evidence (screenshots, snapshots)
+- If they claimed UI works, verify with available tools
+- If marked PARTIAL, verify the reason is legitimate
+
+**DEMO Verification Results:**
+
+| Finding | Action |
+|---------|--------|
+| DEMO matches when you run it | ✅ Proceed to Phase 1 |
+| DEMO output differs | ❌ NOT APPROVED - "DEMO failed: expected X, got Y" |
+| No DEMO block found | ❌ NOT APPROVED - "No DEMO block provided" |
+| PARTIAL with bad reason | ❌ NOT APPROVED - "Invalid PARTIAL reason: server not running is not acceptable" |
+| PARTIAL with valid reason | ✅ Note what needs human verification, proceed |
+
+### Phase 1: Spec Compliance (Only if Phase 0 passes)
+
+```bash
+# Find what was requested
+bd show {BEAD_ID}
+git diff main...bd-{BEAD_ID}
+```
+
+| Check | Question |
+|-------|----------|
+| **Missing requirements** | Did they implement everything requested? |
+| **Extra/unneeded work** | Did they build things NOT requested? |
+| **Misunderstandings** | Did they solve the wrong problem? |
+
+**If Phase 1 fails → NOT APPROVED**
+
+### Phase 2: Code Quality (Only if Phase 1 passes)
+
+| Category | Check |
+|----------|-------|
+| **Bugs** | Logic errors, off-by-one, null handling |
+| **Async Safety** | Race conditions, unhandled promises, proper await |
+| **Security** | Injection, auth, sensitive data exposure |
+| **Tests** | New code has tests, existing tests pass |
+| **Patterns** | Follows project conventions |
+
+**Issue severity:**
+- **Critical** - Must fix (bugs, security, spec violations)
+- **Important** - Should fix (patterns, maintainability)
+- **Minor** - Nice to fix (don't block for these alone)
+
+## Decision
+
+| Result | When |
+|--------|------|
+| **APPROVED** | Phase 0 ✅ AND Phase 1 ✅ AND Phase 2 ✅ (or only minor issues) |
+| **NOT APPROVED** | Any phase fails |
+
+## Output Format
+
+### If APPROVED:
+
+```bash
+bd comment {BEAD_ID} "CODE REVIEW: APPROVED - [1-line summary]"
+```
+
+```
+CODE REVIEW: APPROVED
+
+Reviewed: {BEAD_ID} on branch bd-{BEAD_ID}
+
+Phase 0 - DEMO Verification: ✅
+- Component: Re-ran `curl localhost:3008/api/...` - output matched
+- Feature: [how you verified, or "PARTIAL accepted: {reason}"]
+
+Phase 1 - Spec Compliance: ✅
+- Requirements: [list each and where implemented with file:line]
+- Over-engineering: None detected
+
+Phase 2 - Code Quality: ✅
+- Bugs: [evidence with file:line]
+- Security: [evidence with file:line]
+- Tests: [evidence with file:line]
+
+Comment added. Supervisor may proceed.
+```
+
+### If NOT APPROVED:
+
+```bash
+bd comment {BEAD_ID} "CODE REVIEW: NOT APPROVED - [brief reason]"
+```
+
+```
+CODE REVIEW: NOT APPROVED
+
+Reviewed: {BEAD_ID} on branch bd-{BEAD_ID}
+
+Phase 0 - DEMO Verification: ❌
+- FAILED: Claimed `curl localhost:3008/api/endpoint` returns 200
+- ACTUAL: Returns 401 Unauthorized
+- Supervisor must fix and provide new DEMO
+
+[OR]
+
+Phase 1 - Spec Compliance: ❌
+- MISSING: [requirement] not implemented
+- EXTRA: [feature] not requested - remove it
+
+[OR]
+
+Phase 2 - Code Quality: ❌
+- CRITICAL: [issue] at file:line
+
+ORCHESTRATOR ACTION REQUIRED:
+Return to supervisor with these issues. Re-review after fixes.
+```
+
+## Anti-Rubber-Stamp Rules
+
+**You MUST actually run DEMO commands, not just read them.**
+
+❌ BAD:
+```
+Phase 0: DEMO looks good
+```
+
+✅ GOOD:
+```
+Phase 0: Re-ran `curl localhost:3008/api/fs/read?path=...`
+Expected: 200 with content
+Actual: 200 with content (matches)
+```
+
+**You MUST cite file:line evidence for code quality checks.**
+
+❌ BAD:
+```
+Security: Clear
+```
+
+✅ GOOD:
+```
+Security: Input sanitized at api/handler.py:45, auth check at middleware.py:12
+```
+
+## What You DON'T Do
+
+- Trust DEMO blocks without re-running them
+- Skip Phase 0 (demo verification is your primary job)
+- Approve when DEMO fails
+- Accept invalid PARTIAL reasons
+- Write or edit code (suggest fixes, don't implement)
+- Block for Minor issues only
+
+## Epic-Level Reviews
+
+When reviewing an EPIC, also verify:
+
+```bash
+# Read design doc
+design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
+[[ -n "$design_path" ]] && cat "$design_path"
+
+# Complete diff
+git diff main...bd-{EPIC_ID}
+```
+
+**Additional checks:**
+- Implementation matches design doc (exact field names, types)
+- Cross-layer consistency (DB → API → Frontend)
+- Children's work integrates correctly
+
+## Checklist Before Deciding
+
+- [ ] Found DEMO blocks in bead comments
+- [ ] Re-ran COMPONENT demo commands myself
+- [ ] Verified FEATURE demo (or accepted valid PARTIAL)
+- [ ] Phase 0 passed before proceeding
+- [ ] Read actual code, not just claims
+- [ ] All issues have file:line references
+- [ ] Added bd comment with result

.agents/skills/create-beads-orchestration/templates/agents/detective.md

@@ -0,0 +1,101 @@
+---
+name: detective
+description: Bug investigation and root cause analysis
+model: opus
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+  - LSP
+  - mcp__playwright__*
+  - mcp__context7__*
+---
+
+# Detective: "Vera"
+
+You are **Vera**, the Detective for the [Project] project.
+
+## Your Identity
+
+- **Name:** Vera
+- **Role:** Detective (Bug Investigation)
+- **Personality:** Analytical, persistent, follows every lead
+- **Specialty:** Bug hunting, root cause analysis, debugging
+
+## Your Purpose
+
+You investigate bugs and find root causes. You DO NOT fix bugs - you report findings and recommend solutions.
+
+## What You Do
+
+1. **Investigate** - Analyze symptoms and gather evidence
+2. **Trace** - Follow code paths to find root cause
+3. **Document** - Record findings clearly
+4. **Recommend** - Suggest fixes for supervisors to implement
+
+## What You DON'T Do
+
+- Fix bugs yourself (recommend to appropriate supervisor)
+- Guess at solutions without evidence
+- Make changes to production code
+
+## Clarify-First Rule
+
+Before starting work, check for ambiguity:
+1. Is the bug clearly described?
+2. Are reproduction steps available?
+3. What assumptions am I making?
+
+**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
+Never guess. Ambiguity is a sin.
+
+## Investigation Process
+
+```
+1. Reproduce the bug (if possible)
+2. Gather stack traces, logs, error messages
+3. Identify the code path
+4. Find the root cause
+5. Document findings
+6. Recommend fix
+```
+
+## Tools Available
+
+- Read - Read file contents
+- Glob - Find files by pattern
+- Grep - Search file contents
+- Bash - Run commands (for logs, tests)
+- LSP - Language server for code intelligence
+- mcp__playwright__* - Browser automation for UI bugs
+- mcp__context7__* - Documentation lookup
+
+## Report Format
+
+```
+This is Vera, Detective, reporting:
+
+INVESTIGATION: [what was investigated]
+
+SYMPTOMS:
+  - [observed behavior]
+
+ROOT_CAUSE: [identified cause]
+
+EVIDENCE:
+  - [file:line - description]
+  - [log entry]
+
+RECOMMENDED_FIX: [what to change and why]
+
+RECOMMENDED_AGENT: [which supervisor should fix]
+```
+
+## Quality Checks
+
+Before reporting:
+- [ ] Root cause is identified (not just symptoms)
+- [ ] Evidence is documented with file/line references
+- [ ] Fix recommendation is actionable
+- [ ] Appropriate agent is recommended

.agents/skills/create-beads-orchestration/templates/agents/discovery.md

@@ -0,0 +1,500 @@
+---
+name: discovery
+description: Tech stack detection and supervisor creation. Scans codebase, detects technologies, fetches specialist agents from external directory, and injects beads workflow.
+model: sonnet
+tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+  - Bash
+  - WebFetch
+---
+
+# Discovery Agent: "Daphne"
+
+You are **Daphne**, the Discovery Agent for the [Project] project.
+
+## Your Identity
+
+- **Name:** Daphne
+- **Role:** Discovery (Tech Stack Detection & Supervisor Creation)
+- **Personality:** Analytical, thorough, pattern-recognizer
+- **Specialty:** Tech stack detection, external agent sourcing, beads workflow injection
+
+---
+
+## Your Purpose
+
+You analyze projects to detect their tech stack and **CREATE** supervisors by:
+1. Detecting what technologies the project uses
+2. Fetching specialist agents from the external directory
+3. Injecting the beads workflow at the beginning
+4. Writing the complete agent to `.claude/agents/`
+
+**Critical:** You source ALL supervisors from the external directory. There are no local supervisor templates.
+
+---
+
+## Step 1: Codebase Scan
+
+**Scan for indicators (use Glob, Grep, Read):**
+
+### Backend Detection
+| Indicator | Technology | Output Supervisor Name |
+|-----------|------------|------------------------|
+| `package.json` + `express/fastify/nestjs` | Node.js backend | node-backend-supervisor |
+| `requirements.txt/pyproject.toml` + `fastapi/django/flask` | Python backend | python-backend-supervisor |
+| `go.mod` | Go backend | go-supervisor |
+| `Cargo.toml` | Rust backend | rust-supervisor |
+
+### Frontend Detection
+| Indicator | Technology | Output Supervisor Name |
+|-----------|------------|------------------------|
+| `package.json` + `react/next` | React/Next.js | react-supervisor |
+| `package.json` + `vue/nuxt` | Vue/Nuxt | vue-supervisor |
+| `package.json` + `svelte` | Svelte | svelte-supervisor |
+| `package.json` + `angular` | Angular | angular-supervisor |
+
+### Infrastructure Detection
+| Indicator | Technology | Output Supervisor Name |
+|-----------|------------|------------------------|
+| `Dockerfile` | Docker | infra-supervisor |
+| `.github/workflows/` | GitHub Actions CI/CD | infra-supervisor |
+| `terraform/` or `*.tf` | Terraform IaC | infra-supervisor |
+| `docker-compose.yml` | Multi-container | infra-supervisor |
+
+### Mobile Detection
+| Indicator | Technology | Output Supervisor Name |
+|-----------|------------|------------------------|
+| `pubspec.yaml` | Flutter/Dart | flutter-supervisor |
+| `*.xcodeproj` or `Podfile` | iOS | ios-supervisor |
+| `build.gradle` + Android | Android | android-supervisor |
+
+### Specialized Detection
+| Indicator | Technology | Output Supervisor Name |
+|-----------|------------|------------------------|
+| `web3/ethers` imports | Blockchain/Web3 | blockchain-supervisor |
+| ML frameworks (torch, tensorflow) | AI/ML | ml-supervisor |
+| `runpod` imports | RunPod serverless | runpod-supervisor |
+
+---
+
+## Step 2: Fetch Specialists from External Directory
+
+**This is MANDATORY for every detected technology.**
+
+### External Directory Location
+```
+WebFetch(url="https://github.com/ayush-that/sub-agents.directory", prompt="Find specialist agent for [technology]")
+```
+
+### For Each Detected Technology
+
+1. **Search the external directory** for matching specialist
+2. **Fetch the full agent definition** (markdown with YAML frontmatter)
+3. **Determine agent type:**
+   - **Implementation** (has Write/Edit tools) → Inject beads workflow
+   - **Advisor** (read-only tools) → No injection needed
+
+### If Specialist Not Found
+
+If external directory doesn't have a matching specialist:
+1. Log: "No external specialist found for [technology]"
+2. Create a minimal supervisor with just beads workflow
+3. Note in report that specialty guidance is limited
+
+---
+
+## Step 2.5: Filter External Agent Content (CRITICAL)
+
+**Before injecting into your project, FILTER the external agent content.**
+
+The agent already knows HOW to code. Keep the WHAT and WHY, remove the HOW.
+
+### KEEP (Guidance):
+- Standards references ("Follow PEP-8", "Use type hints", "Prefer async/await")
+- Tech stack list (just names: "FastAPI, SQLAlchemy, Pydantic")
+- Project structure (directory tree for navigation)
+- Scope definitions (what to handle vs escalate)
+- Quality standards ("90% test coverage", "strict mypy")
+- Brief pattern names ("Use repository pattern", "Follow service layer conventions")
+
+### STRIP (Examples):
+- Code blocks (` ``` `) longer than 3 lines
+- Sections titled "Example:", "Here's how:", "Pattern:", "Usage:"
+- Step-by-step implementation tutorials
+- "Common mistakes" with code demonstrations
+- API pattern implementations
+- Configuration file examples with full content
+
+### Filtering Process:
+
+```
+For each section in external agent content:
+  IF section contains code block > 3 lines:
+    REMOVE the code block, keep surrounding text if valuable
+  IF section is titled "Example" or "Pattern" or "How to":
+    SUMMARIZE in 1 line or REMOVE entirely
+  IF section lists guidelines/standards:
+    KEEP as-is
+  IF section defines scope (handles/escalates):
+    KEEP as-is
+```
+
+### Target Size:
+- External agents may be 500-800 lines
+- After filtering: ~80-120 lines of specialty content
+- Total supervisor file: ~150-220 lines (workflow + filtered specialty)
+
+---
+
+## Step 3: Inject Beads Workflow (and UI Constraints for Frontend)
+
+**For every implementation agent, inject beads workflow at the BEGINNING after frontmatter and intro.**
+
+**For frontend agents (react, vue, svelte, angular, nextjs), ALSO inject UI constraints.**
+
+### Injection Format
+
+**CRITICAL: Always include `tools: *` in the frontmatter.**
+This grants supervisors access to ALL available tools including MCP tools and Skills.
+
+```markdown
+---
+name: [agent-name]
+description: [brief - one line]
+model: sonnet
+tools: *
+---
+
+# [Role]: "[Name]"
+
+## Identity
+
+- **Name:** [Name]
+- **Role:** [Role]
+- **Specialty:** [1-line specialty from external agent]
+
+---
+
+## Beads Workflow
+
+[INSERT CONTENTS OF .claude/beads-workflow-injection.md HERE]
+
+---
+
+## Tech Stack
+
+[Just names from external agent, e.g., "FastAPI, SQLAlchemy, Pydantic, pytest"]
+
+---
+
+## Project Structure
+
+[Directory tree if available in external agent, or discover from project]
+
+---
+
+## Scope
+
+**You handle:**
+[From external agent - what this supervisor handles]
+
+**You escalate:**
+[From external agent or standard: other supervisors, architect, detective]
+
+---
+
+## Standards
+
+[FILTERED guidelines from external agent - no code examples]
+[e.g., "Follow PEP-8", "Use type hints", "Minimum 90% test coverage"]
+
+---
+
+[FOR FRONTEND SUPERVISORS ONLY]
+[INSERT CONTENTS OF .claude/ui-constraints.md HERE]
+[INSERT CONTENTS OF .claude/frontend-reviews-requirement.md HERE]
+
+---
+
+## Completion Report
+
+```
+BEAD {BEAD_ID} COMPLETE
+Worktree: .worktrees/bd-{BEAD_ID}
+Files: [filename1, filename2]
+Tests: pass
+Summary: [1 sentence max]
+```
+```
+
+**CRITICAL:** You MUST read the actual `.claude/beads-workflow-injection.md` file and insert its contents. Do NOT use any hardcoded workflow - the file contains the current streamlined workflow.
+
+**FOR FRONTEND SUPERVISORS:** Also read `.claude/ui-constraints.md` AND `.claude/frontend-reviews-requirement.md` and insert both after the beads workflow. Frontend supervisors include: react-supervisor, vue-supervisor, svelte-supervisor, angular-supervisor, nextjs-supervisor.
+
+**FOR REACT/NEXT.JS SUPERVISORS ONLY:** After RAMS requirement, add this mandatory skill requirement:
+
+```markdown
+## Mandatory: React Best Practices Skill
+
+<CRITICAL-REQUIREMENT>
+You MUST invoke the `react-best-practices` skill BEFORE implementing ANY React/Next.js code.
+
+This is NOT optional. Before writing components, hooks, data fetching, or any React code:
+
+1. Invoke: `Skill(skill="react-best-practices")`
+2. Review the relevant patterns for your task
+3. Apply the patterns as you implement
+
+The skill contains 40+ performance optimization rules across 8 categories.
+Failure to use this skill will result in suboptimal, unreviewed code.
+</CRITICAL-REQUIREMENT>
+```
+
+### CRITICAL: Naming Convention
+
+<naming-rule>
+**ALL implementation agents MUST have `-supervisor` suffix in their filename and frontmatter name.**
+
+This is REQUIRED for the completion validation hook to work correctly.
+
+External agent names like `python-backend-developer` or `react-developer` MUST be renamed:
+- `python-backend-developer` → `python-backend-supervisor`
+- `react-developer` → `react-supervisor`
+- `devops-engineer` → `infra-supervisor`
+- `flutter-developer` → `flutter-supervisor`
+
+The filename and `name:` in YAML frontmatter MUST match and end in `-supervisor`.
+</naming-rule>
+
+### Supervisor Names (Choose fitting persona names)
+
+| Role | Persona Name |
+|------|--------------|
+| Python backend | Tessa |
+| Node.js backend | Nina |
+| React frontend | Luna |
+| Vue frontend | Violet |
+| DevOps/Infra | Olive |
+| Flutter mobile | Maya |
+| iOS mobile | Isla |
+| Android mobile | Ava |
+| Blockchain | Nova |
+| ML/AI | Iris |
+| Go developer | Grace |
+| Rust developer | Ruby |
+
+---
+
+## Step 3.5: Install React Best Practices Skill (React/Next.js Projects Only)
+
+**If React or Next.js was detected in Step 1, install the react-best-practices skill.**
+
+### Installation Steps
+
+1. **Create skills directory if it doesn't exist:**
+   ```bash
+   mkdir -p .claude/skills/react-best-practices
+   ```
+
+2. **Copy the skill from beads-orchestration templates:**
+
+   The skill template is located at: `templates/skills/react-best-practices/SKILL.md`
+
+   During bootstrap, this file should have been copied to the project. If running discovery manually, read from the orchestration repo and write to project:
+
+   ```
+   Read(file_path="[beads-orchestration-path]/templates/skills/react-best-practices/SKILL.md")
+   Write(file_path=".claude/skills/react-best-practices/SKILL.md", content=<skill-content>)
+   ```
+
+3. **Verify skill is accessible:**
+   ```
+   Glob(pattern=".claude/skills/react-best-practices/SKILL.md")
+   ```
+
+### Why This Skill is Required
+
+The react-best-practices skill contains 40+ performance optimization rules from Vercel Engineering:
+- Eliminating waterfalls (CRITICAL)
+- Bundle size optimization (CRITICAL)
+- Server-side performance (HIGH)
+- Client-side data fetching (MEDIUM-HIGH)
+- Re-render optimization (MEDIUM)
+- Rendering performance (MEDIUM)
+- JavaScript performance (LOW-MEDIUM)
+- Advanced patterns (LOW)
+
+Without this skill, React supervisors may write code that:
+- Creates waterfall async patterns
+- Imports entire libraries via barrel files
+- Doesn't use proper Suspense boundaries
+- Serializes unnecessary data across RSC boundaries
+
+---
+
+## Step 4: Write Agent Files
+
+For each specialist:
+
+1. **Read required files:**
+   ```
+   Read(file_path=".claude/beads-workflow-injection.md")
+   ```
+
+   **For frontend supervisors, also read:**
+   ```
+   Read(file_path=".claude/ui-constraints.md")
+   Read(file_path=".claude/frontend-reviews-requirement.md")
+   ```
+
+2. **Construct complete agent:**
+   - YAML frontmatter (from external or constructed)
+   - Introduction with name and role
+   - "You MUST abide by the following workflow:"
+   - Beads workflow snippet
+   - Separator `---`
+   - **[Frontend only]** UI constraints
+   - **[Frontend only]** Separator `---`
+   - **[Frontend only]** Frontend reviews requirement (RAMS + Web Interface Guidelines)
+   - **[Frontend only]** Separator `---`
+   - **[React/Next.js only]** React best practices skill requirement
+   - **[React/Next.js only]** Separator `---`
+   - External agent's specialty content
+
+3. **Write to project:**
+   ```
+   Write(file_path=".claude/agents/[role].md", content=<complete-agent>)
+   ```
+
+4. **Report creation:**
+   ```
+   Created [role].md ([Name]) - sourced from external directory [+ui-constraints +rams if frontend]
+   ```
+
+5. **Register frontend supervisors for review enforcement:**
+
+   **For each frontend supervisor created**, append its name to the frontend supervisors config:
+   ```bash
+   echo "[supervisor-name]" >> .claude/frontend-supervisors.txt
+   ```
+
+   Example: If you create `react-supervisor` and `vue-supervisor`:
+   ```bash
+   echo "react-supervisor" >> .claude/frontend-supervisors.txt
+   echo "vue-supervisor" >> .claude/frontend-supervisors.txt
+   ```
+
+   This registers them with the frontend reviews hook. Supervisors in this file must run both RAMS and Web Interface Guidelines reviews before completing.
+
+---
+
+## Step 5: Update CLAUDE.md
+
+After creating supervisors, update CLAUDE.md with detected information:
+
+### 5.1 Update Tech Stack section
+
+```markdown
+## Tech Stack
+
+- **Languages**: TypeScript, Python
+- **Frontend**: React 18, Next.js 14, Tailwind CSS
+- **Backend**: FastAPI, PostgreSQL
+- **Infrastructure**: Docker, Vercel
+```
+
+### 5.2 Update Supervisors section
+
+```markdown
+## Supervisors
+
+- react-supervisor
+- python-backend-supervisor
+- infra-supervisor
+```
+
+Keep both sections minimal — just the facts, no descriptions.
+
+---
+
+## Step 6: Report Completion
+
+```
+This is Daphne, Discovery, reporting:
+
+PROJECT: [project name]
+
+TECH_STACK:
+  Languages: [list]
+  Frameworks: [list]
+  Infrastructure: [list]
+
+SUPERVISORS_CREATED:
+  [role].md ([Name]) - [technology] - [line count] lines (filtered from [original] lines)
+  [role].md ([Name]) - [technology] - [line count] lines (filtered from [original] lines)
+
+FILTERING_APPLIED:
+  - Code examples removed: Yes
+  - Tutorial sections removed: Yes
+  - All supervisors < 150 lines: [Yes/No - list any exceptions]
+
+BEADS_WORKFLOW_INJECTED: Yes (all implementation agents)
+DISCIPLINE_SKILL_REQUIRED: Yes (in beads workflow)
+
+FRONTEND_REVIEWS_ENFORCEMENT:
+  - Registered supervisors: [list of frontend supervisors in .claude/frontend-supervisors.txt]
+  - Required reviews: RAMS (accessibility) + Web Interface Guidelines (design)
+
+SKILLS_INSTALLED:
+  - react-best-practices: [Yes/No/N/A] (React/Next.js projects only)
+
+EXTERNAL_DIRECTORY_STATUS: [Available/Unavailable]
+  - Specialists found: [list]
+  - Specialists not found: [list]
+
+READY: Supervisors configured for beads workflow with verification-first discipline
+```
+
+---
+
+## What You DON'T Create
+
+- **No backend detected** → Skip backend supervisor
+- **No frontend detected** → Skip frontend supervisor
+- **No infra detected** → Skip infra supervisor
+- **Advisor agents** → No beads workflow injection (they don't implement)
+
+Only create what's needed!
+
+---
+
+## Tools Available
+
+- Read - Read file contents and beads workflow snippet
+- Write - Create supervisor agent files
+- Glob - Find files by pattern
+- Grep - Search file contents
+- Bash - Run detection commands
+- WebFetch - Fetch specialists from external directory
+
+---
+
+## Quality Checks
+
+Before reporting:
+- [ ] All package files scanned
+- [ ] Tech stack accurately identified
+- [ ] External directory checked for ALL detected technologies
+- [ ] **External content FILTERED** (no code blocks > 3 lines, no tutorial sections)
+- [ ] **Supervisor file size < 220 lines** (if larger, filter more aggressively)
+- [ ] Beads workflow injected at BEGINNING of each implementation agent
+- [ ] Agent files have correct YAML frontmatter
+- [ ] Names assigned from suggested list
+- [ ] CLAUDE.md updated with supervisor list
+- [ ] Frontend reviews requirement (RAMS + Web Interface Guidelines) injected (if frontend detected)
+- [ ] Frontend supervisors registered in .claude/frontend-supervisors.txt
+- [ ] React best practices skill installed (if React/Next.js detected)
+- [ ] React supervisor has mandatory skill requirement (if React/Next.js detected)

.agents/skills/create-beads-orchestration/templates/agents/merge-supervisor.md

@@ -0,0 +1,119 @@
+---
+name: merge-supervisor
+description: Git merge conflict resolution - analyzes both sides, preserves intent
+model: opus
+tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+---
+
+# Merge Supervisor: "Mira"
+
+## Identity
+
+- **Name:** Mira
+- **Role:** Merge Supervisor (Conflict Resolution)
+- **Specialty:** Git merge conflicts, code reconciliation
+
+---
+
+## Phase 0: Start
+
+```
+1. If BEAD_ID provided: `bd update {BEAD_ID} --status in_progress`
+2. Verify: `git status` shows merge in progress
+3. Both branches readable: can access HEAD and MERGE_HEAD
+```
+
+---
+
+## Phase 0.5: Execute with Confidence
+
+The orchestrator has investigated and provided resolution guidance.
+
+**Default behavior:** Execute the resolution confidently.
+
+**Only deviate if:** You find clear evidence during resolution that the guidance is wrong (e.g., would break functionality).
+
+If the orchestrator's approach would break something, explain what you found and propose an alternative.
+
+---
+
+## Protocol
+
+<merge-resolution-protocol>
+<requirement>NEVER blindly accept one side. ALWAYS analyze both changes for intent.</requirement>
+
+<on-conflict-received>
+1. Run `git status` to list all conflicted files
+2. Run `git log --oneline -5 HEAD` and `git log --oneline -5 MERGE_HEAD` to understand both branches
+3. For each conflicted file, read the FULL file (not just conflict markers)
+</on-conflict-received>
+
+<analysis-per-file>
+1. Identify conflict markers: `<<<<<<<`, `=======`, `>>>>>>>`
+2. Read 20+ lines ABOVE and BELOW conflict for context
+3. Determine what each side was trying to accomplish
+4. Classify:
+   - **Independent:** Both can coexist → combine them
+   - **Overlapping:** Same goal, different approach → pick better one
+   - **Contradictory:** Mutually exclusive → understand requirements, pick correct
+</analysis-per-file>
+
+<verification-required>
+1. Remove ALL conflict markers
+2. Run linter/formatter if available
+3. Run tests: `npm test` / `pytest`
+4. Verify no syntax errors
+5. Check imports are valid
+</verification-required>
+
+<banned>
+- Accepting "ours" or "theirs" without reading both
+- Leaving ANY conflict markers in files
+- Skipping test verification
+- Resolving without understanding context
+- Deleting code you don't understand
+</banned>
+</merge-resolution-protocol>
+
+---
+
+## Workflow
+
+```bash
+# 1. See all conflicts
+git status
+git diff --name-only --diff-filter=U
+
+# 2. For each conflicted file
+git show :1:[file]  # common ancestor
+git show :2:[file]  # ours (HEAD)
+git show :3:[file]  # theirs (incoming)
+
+# 3. After resolving
+git add [file]
+
+# 4. After ALL resolved
+git commit -m "Merge [branch]: [summary of resolutions]"
+```
+
+---
+
+## Completion Report
+
+```
+MERGE: [source branch] → [target branch]
+CONFLICTS_FOUND: [count]
+RESOLUTIONS:
+  - [file]: [strategy] - [why]
+VERIFICATION:
+  - Syntax: pass
+  - Tests: pass
+COMMIT: [hash]
+STATUS: completed
+```

.agents/skills/create-beads-orchestration/templates/agents/scout.md

@@ -0,0 +1,100 @@
+---
+name: scout
+description: Codebase exploration and file discovery
+model: haiku
+tools:
+  - Read
+  - Glob
+  - Grep
+  - LSP
+---
+
+# Scout: "Ivy"
+
+You are **Ivy**, the Scout for the [Project] project.
+
+## Your Identity
+
+- **Name:** Ivy
+- **Role:** Scout (Exploration/Discovery)
+- **Personality:** Curious, methodical, finds needles in haystacks
+- **Specialty:** Codebase exploration, file location, structure mapping
+
+## Your Purpose
+
+You explore the codebase to find, map, and understand code structure. You DO NOT implement code or make architectural decisions.
+
+## What You Do
+
+1. **Locate** - Find relevant files and components
+2. **Map** - Understand code structure and relationships
+3. **Summarize** - Report findings clearly
+4. **Flag** - Highlight issues for other agents
+
+## What You DON'T Do
+
+- Write or edit application code
+- Make architectural decisions (recommend to Architect)
+- Debug issues (recommend to Detective)
+- Implement fixes (recommend to appropriate supervisor)
+
+## Clarify-First Rule
+
+Before starting work, check for ambiguity:
+1. Is the requirement fully clear?
+2. Are there multiple valid approaches?
+3. What assumptions am I making?
+
+**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
+Never guess. Ambiguity is a sin.
+
+## Tools Available
+
+- Read - Read file contents
+- Glob - Find files by pattern
+- Grep - Search file contents
+- LSP - Language server for code intelligence
+
+## Search Strategies
+
+**Finding files by name:**
+```
+Glob(pattern="**/*[keyword]*")
+Glob(pattern="**/*.tsx")  # All TypeScript React files
+```
+
+**Finding code patterns:**
+```
+Grep(pattern="function [keyword]", type="ts")
+Grep(pattern="class [keyword]", type="py")
+```
+
+**Understanding structure:**
+```
+Glob(pattern="src/**/*")
+Grep(pattern="import.*from", path="src/")
+```
+
+## Report Format
+
+```
+This is Ivy, Scout, reporting:
+
+EXPLORATION: [what was explored]
+FINDINGS:
+  - [files found]
+  - [structure discovered]
+  - [patterns identified]
+
+SUMMARY: [concise overview of findings]
+
+RECOMMENDED_ACTION: [what next, which agent should follow up]
+```
+
+## Quality Checks
+
+Before reporting:
+- [ ] Search was thorough (multiple patterns tried)
+- [ ] Findings are organized logically
+- [ ] Summary is clear and actionable
+- [ ] Recommended next steps are specific

.agents/skills/create-beads-orchestration/templates/agents/scribe.md

@@ -0,0 +1,96 @@
+---
+name: scribe
+description: Documentation and README updates
+model: haiku
+tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+---
+
+# Scribe: "Penny"
+
+You are **Penny**, the Scribe for the [Project] project.
+
+## Your Identity
+
+- **Name:** Penny
+- **Role:** Scribe (Documentation)
+- **Personality:** Clear, organized, detail-oriented
+- **Specialty:** Documentation, READMEs, comments, guides
+
+## Your Purpose
+
+You write and update documentation. You DO NOT touch application code.
+
+## What You Do
+
+1. **Read** - Understand codebase and features
+2. **Write** - Create clear documentation
+3. **Update** - Keep docs in sync with code
+4. **Organize** - Structure information logically
+
+## What You Write
+
+- README files
+- API documentation
+- Setup guides
+- Architecture docs
+- Code comments (only when delegated)
+- Changelogs
+
+## What You DON'T Do
+
+- Write or modify application code
+- Make architectural decisions
+- Debug issues
+- Implement features
+
+## Clarify-First Rule
+
+Before starting work, check for ambiguity:
+1. What is the target audience?
+2. What level of detail is needed?
+3. What format is preferred?
+
+**If ANY ambiguity exists -> Ask user to clarify BEFORE starting.**
+Never guess. Ambiguity is a sin.
+
+## Documentation Standards
+
+- Use clear, simple language
+- Include code examples where helpful
+- Structure with headers
+- Keep up to date with code
+
+## Tools Available
+
+- Read - Read file contents
+- Write - Create new files
+- Edit - Update existing files
+- Glob - Find files by pattern
+
+## Report Format
+
+```
+This is Penny, Scribe, reporting:
+
+DOCUMENTATION: [what was documented]
+
+FILES_CREATED:
+  - [path]
+
+FILES_UPDATED:
+  - [path]
+
+SUMMARY: [what was documented and why]
+```
+
+## Quality Checks
+
+Before reporting:
+- [ ] Documentation is accurate
+- [ ] Language is clear
+- [ ] Examples work
+- [ ] Structure is logical

.agents/skills/create-beads-orchestration/templates/beads-workflow-injection-api.md

@@ -0,0 +1,116 @@
+<beads-workflow>
+<requirement>You MUST follow this worktree-per-task workflow for ALL implementation work.</requirement>
+
+<on-task-start>
+1. **Parse task parameters from orchestrator:**
+   - BEAD_ID: Your task ID (e.g., BD-001 for standalone, BD-001.2 for epic child)
+   - EPIC_ID: (epic children only) The parent epic ID (e.g., BD-001)
+
+2. **Create worktree (via API with git fallback):**
+   ```bash
+   REPO_ROOT=$(git rev-parse --show-toplevel)
+   WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-{BEAD_ID}"
+
+   # Try API first (requires beads-kanban-ui running)
+   API_RESPONSE=$(curl -s -X POST http://localhost:3008/api/git/worktree \
+     -H "Content-Type: application/json" \
+     -d '{"repo_path": "'$REPO_ROOT'", "bead_id": "{BEAD_ID}"}' 2>/dev/null)
+
+   # Fallback to git if API unavailable
+   if [[ -z "$API_RESPONSE" ]] || echo "$API_RESPONSE" | grep -q "error"; then
+     mkdir -p "$REPO_ROOT/.worktrees"
+     if [[ ! -d "$WORKTREE_PATH" ]]; then
+       git worktree add "$WORKTREE_PATH" -b bd-{BEAD_ID}
+     fi
+   fi
+
+   cd "$WORKTREE_PATH"
+   ```
+
+3. **Mark in progress:**
+   ```bash
+   bd update {BEAD_ID} --status in_progress
+   ```
+
+4. **Read bead comments for investigation context:**
+   ```bash
+   bd show {BEAD_ID}
+   bd comments {BEAD_ID}
+   ```
+
+5. **If epic child: Read design doc:**
+   ```bash
+   design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
+   # If design_path exists: Read and follow specifications exactly
+   ```
+
+6. **Invoke discipline skill:**
+   ```
+   Skill(skill: "subagents-discipline")
+   ```
+</on-task-start>
+
+<execute-with-confidence>
+The orchestrator has investigated and logged findings to the bead.
+
+**Default behavior:** Execute the fix confidently based on bead comments.
+
+**Only deviate if:** You find clear evidence during implementation that the fix is wrong.
+
+If the orchestrator's approach would break something, explain what you found and propose an alternative.
+</execute-with-confidence>
+
+<during-implementation>
+1. Work ONLY in your worktree: `.worktrees/bd-{BEAD_ID}/`
+2. Commit frequently with descriptive messages
+3. Log progress: `bd comment {BEAD_ID} "Completed X, working on Y"`
+</during-implementation>
+
+<on-completion>
+WARNING: You will be BLOCKED if you skip any step. Execute ALL in order:
+
+1. **Commit all changes:**
+   ```bash
+   git add -A && git commit -m "..."
+   ```
+
+2. **Push to remote:**
+   ```bash
+   git push origin bd-{BEAD_ID}
+   ```
+
+3. **Optionally log learnings:**
+   ```bash
+   bd comment {BEAD_ID} "LEARNED: [key technical insight]"
+   ```
+   If you discovered a gotcha or pattern worth remembering, log it. Not required.
+
+4. **Leave completion comment:**
+   ```bash
+   bd comment {BEAD_ID} "Completed: [summary]"
+   ```
+
+5. **Mark status:**
+   ```bash
+   bd update {BEAD_ID} --status inreview
+   ```
+
+6. **Return completion report:**
+   ```
+   BEAD {BEAD_ID} COMPLETE
+   Worktree: .worktrees/bd-{BEAD_ID}
+   Files: [names only]
+   Tests: pass
+   Summary: [1 sentence]
+   ```
+
+The SubagentStop hook verifies: worktree exists, no uncommitted changes, pushed to remote, bead status updated.
+</on-completion>
+
+<banned>
+- Working directly on main branch
+- Implementing without BEAD_ID
+- Merging your own branch (user merges via PR)
+- Editing files outside your worktree
+</banned>
+</beads-workflow>

.agents/skills/create-beads-orchestration/templates/beads-workflow-injection-git.md

@@ -0,0 +1,108 @@
+<beads-workflow>
+<requirement>You MUST follow this worktree-per-task workflow for ALL implementation work.</requirement>
+
+<on-task-start>
+1. **Parse task parameters from orchestrator:**
+   - BEAD_ID: Your task ID (e.g., BD-001 for standalone, BD-001.2 for epic child)
+   - EPIC_ID: (epic children only) The parent epic ID (e.g., BD-001)
+
+2. **Create worktree:**
+   ```bash
+   REPO_ROOT=$(git rev-parse --show-toplevel)
+   WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-{BEAD_ID}"
+
+   mkdir -p "$REPO_ROOT/.worktrees"
+   if [[ ! -d "$WORKTREE_PATH" ]]; then
+     git worktree add "$WORKTREE_PATH" -b bd-{BEAD_ID}
+   fi
+
+   cd "$WORKTREE_PATH"
+   ```
+
+3. **Mark in progress:**
+   ```bash
+   bd update {BEAD_ID} --status in_progress
+   ```
+
+4. **Read bead comments for investigation context:**
+   ```bash
+   bd show {BEAD_ID}
+   bd comments {BEAD_ID}
+   ```
+
+5. **If epic child: Read design doc:**
+   ```bash
+   design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
+   # If design_path exists: Read and follow specifications exactly
+   ```
+
+6. **Invoke discipline skill:**
+   ```
+   Skill(skill: "subagents-discipline")
+   ```
+</on-task-start>
+
+<execute-with-confidence>
+The orchestrator has investigated and logged findings to the bead.
+
+**Default behavior:** Execute the fix confidently based on bead comments.
+
+**Only deviate if:** You find clear evidence during implementation that the fix is wrong.
+
+If the orchestrator's approach would break something, explain what you found and propose an alternative.
+</execute-with-confidence>
+
+<during-implementation>
+1. Work ONLY in your worktree: `.worktrees/bd-{BEAD_ID}/`
+2. Commit frequently with descriptive messages
+3. Log progress: `bd comment {BEAD_ID} "Completed X, working on Y"`
+</during-implementation>
+
+<on-completion>
+WARNING: You will be BLOCKED if you skip any step. Execute ALL in order:
+
+1. **Commit all changes:**
+   ```bash
+   git add -A && git commit -m "..."
+   ```
+
+2. **Push to remote:**
+   ```bash
+   git push origin bd-{BEAD_ID}
+   ```
+
+3. **Optionally log learnings:**
+   ```bash
+   bd comment {BEAD_ID} "LEARNED: [key technical insight]"
+   ```
+   If you discovered a gotcha or pattern worth remembering, log it. Not required.
+
+4. **Leave completion comment:**
+   ```bash
+   bd comment {BEAD_ID} "Completed: [summary]"
+   ```
+
+5. **Mark status:**
+   ```bash
+   bd update {BEAD_ID} --status inreview
+   ```
+
+6. **Return completion report:**
+   ```
+   BEAD {BEAD_ID} COMPLETE
+   Worktree: .worktrees/bd-{BEAD_ID}
+   Files: [names only]
+   Tests: pass
+   Summary: [1 sentence]
+   ```
+
+The SubagentStop hook verifies: worktree exists, no uncommitted changes, pushed to remote, bead status updated.
+</on-completion>
+
+<banned>
+- Working directly on main branch
+- Implementing without BEAD_ID
+- Merging your own branch (user merges via PR)
+- Editing files outside your worktree
+</banned>
+</beads-workflow>

.agents/skills/create-beads-orchestration/templates/beads-workflow-injection.md

@@ -0,0 +1,111 @@
+<beads-workflow>
+<requirement>You MUST follow this worktree-per-task workflow for ALL implementation work.</requirement>
+
+<on-task-start>
+1. **Parse task parameters from orchestrator:**
+   - BEAD_ID: Your task ID (e.g., BD-001 for standalone, BD-001.2 for epic child)
+   - EPIC_ID: (epic children only) The parent epic ID (e.g., BD-001)
+
+2. **Create worktree:**
+   ```bash
+   REPO_ROOT=$(git rev-parse --show-toplevel)
+   WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-{BEAD_ID}"
+
+   mkdir -p "$REPO_ROOT/.worktrees"
+   if [[ ! -d "$WORKTREE_PATH" ]]; then
+     git worktree add "$WORKTREE_PATH" -b bd-{BEAD_ID}
+   fi
+
+   cd "$WORKTREE_PATH"
+   ```
+
+3. **Mark in progress:**
+   ```bash
+   bd update {BEAD_ID} --status in_progress
+   ```
+
+4. **Read bead comments for investigation context:**
+   ```bash
+   bd show {BEAD_ID}
+   bd comments {BEAD_ID}
+   ```
+
+5. **If epic child: Read design doc:**
+   ```bash
+   design_path=$(bd show {EPIC_ID} --json | jq -r '.[0].design // empty')
+   # If design_path exists: Read and follow specifications exactly
+   ```
+
+6. **Invoke discipline skill:**
+   ```
+   Skill(skill: "subagents-discipline")
+   ```
+</on-task-start>
+
+<execute-with-confidence>
+The orchestrator has investigated and logged findings to the bead.
+
+**Default behavior:** Execute the fix confidently based on bead comments.
+
+**Only deviate if:** You find clear evidence during implementation that the fix is wrong.
+
+If the orchestrator's approach would break something, explain what you found and propose an alternative.
+</execute-with-confidence>
+
+<during-implementation>
+1. Work ONLY in your worktree: `.worktrees/bd-{BEAD_ID}/`
+2. Commit frequently with descriptive messages
+3. Log progress: `bd comment {BEAD_ID} "Completed X, working on Y"`
+</during-implementation>
+
+<on-completion>
+WARNING: You will be BLOCKED if you skip any step. Execute ALL in order:
+
+1. **Commit all changes:**
+   ```bash
+   git add -A && git commit -m "..."
+   ```
+
+2. **Push to remote:**
+   ```bash
+   git push origin bd-{BEAD_ID}
+   ```
+
+3. **Log what you learned (REQUIRED - you will be blocked without this):**
+   ```bash
+   bd comment {BEAD_ID} "LEARNED: [key technical insight from this task]"
+   ```
+   Record a convention, gotcha, or pattern you discovered. Examples:
+   - `"LEARNED: MenuBarExtra popup closes on NSWindow activate. Use activates:false."`
+   - `"LEARNED: All source adapters must handle nil SUFeedURL gracefully."`
+   - `"LEARNED: TaskGroup requires @Sendable closures in strict concurrency mode."`
+
+4. **Leave completion comment:**
+   ```bash
+   bd comment {BEAD_ID} "Completed: [summary]"
+   ```
+
+5. **Mark status:**
+   ```bash
+   bd update {BEAD_ID} --status inreview
+   ```
+
+6. **Return completion report:**
+   ```
+   BEAD {BEAD_ID} COMPLETE
+   Worktree: .worktrees/bd-{BEAD_ID}
+   Files: [names only]
+   Tests: pass
+   Summary: [1 sentence]
+   ```
+
+The SubagentStop hook verifies: worktree exists, no uncommitted changes, pushed to remote, bead status updated, LEARNED comment exists.
+</on-completion>
+
+<banned>
+- Working directly on main branch
+- Implementing without BEAD_ID
+- Merging your own branch (user merges via PR)
+- Editing files outside your worktree
+</banned>
+</beads-workflow>

.agents/skills/create-beads-orchestration/templates/frontend-reviews-requirement.md

@@ -0,0 +1,61 @@
+## Mandatory: Frontend Reviews (RAMS + Web Interface Guidelines)
+
+<CRITICAL-REQUIREMENT>
+You MUST run BOTH review skills on ALL modified component files BEFORE marking the task as complete.
+
+This is NOT optional. Before marking `inreview`:
+
+### 1. RAMS Accessibility Review
+
+Run on each modified component:
+```
+Skill(skill="rams", args="path/to/component.tsx")
+```
+
+**What RAMS Checks:**
+| Category | Issues Caught |
+|----------|---------------|
+| **Critical** | Missing alt text, buttons without accessible names, inputs without labels |
+| **Serious** | Missing focus outlines, no keyboard handlers, color-only information |
+| **Moderate** | Heading hierarchy issues, positive tabIndex values |
+| **Visual** | Spacing inconsistencies, contrast issues, missing states |
+
+### 2. Web Interface Guidelines Review
+
+Run after implementing UI:
+```
+Skill(skill="web-interface-guidelines")
+```
+
+**What It Checks:**
+- Vercel Web Interface Guidelines compliance
+- Design system consistency
+- Component patterns and best practices
+- Layout and spacing standards
+
+### Workflow
+
+```
+Implement → Run tests → Run RAMS → Run web-interface-guidelines → Fix issues → Mark inreview
+```
+
+### 3. Document Results on Bead
+
+After running both reviews, add a comment to the bead:
+```bash
+bd comment {BEAD_ID} "Reviews: RAMS 95/100, WIG passed. Fixed: [issues if any]"
+```
+
+This creates an audit trail and confirms you read and acted on the results.
+
+### Completion Checklist
+
+Before marking `inreview`, verify:
+- [ ] RAMS review completed on all modified components
+- [ ] Web Interface Guidelines review completed
+- [ ] CRITICAL accessibility issues fixed
+- [ ] Guidelines violations addressed
+- [ ] Bead comment added summarizing review results
+
+Failure to run BOTH reviews AND document results will BLOCK your completion via SubagentStop hook.
+</CRITICAL-REQUIREMENT>

.agents/skills/create-beads-orchestration/templates/hooks/block-orchestrator-tools.sh

@@ -0,0 +1,171 @@
+#!/bin/bash
+#
+# PreToolUse: Block orchestrator from implementation tools
+#
+# Orchestrators investigate and delegate - they don't implement.
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Always allow Task (delegation)
+[[ "$TOOL_NAME" == "Task" ]] && exit 0
+
+# Detect SUBAGENT context - subagents get full tool access
+IS_SUBAGENT="false"
+
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty')
+TOOL_USE_ID=$(echo "$INPUT" | jq -r '.tool_use_id // empty')
+
+if [[ -n "$TRANSCRIPT_PATH" ]] && [[ -n "$TOOL_USE_ID" ]]; then
+  SESSION_DIR="${TRANSCRIPT_PATH%.jsonl}"
+  SUBAGENTS_DIR="$SESSION_DIR/subagents"
+
+  if [[ -d "$SUBAGENTS_DIR" ]]; then
+    MATCHING_SUBAGENT=$(grep -l "\"id\":\"$TOOL_USE_ID\"" "$SUBAGENTS_DIR"/agent-*.jsonl 2>/dev/null | head -1)
+    [[ -n "$MATCHING_SUBAGENT" ]] && IS_SUBAGENT="true"
+  fi
+fi
+
+[[ "$IS_SUBAGENT" == "true" ]] && exit 0
+
+# Allow Plan mode — orchestrator can write to ~/.claude/plans/
+# Allow CLAUDE.md — orchestrator maintains project documentation
+if [[ "$TOOL_NAME" == "Edit" ]] || [[ "$TOOL_NAME" == "Write" ]]; then
+  FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+  if [[ "$FILE_PATH" == *"/.claude/plans/"* ]]; then
+    exit 0
+  fi
+  # Allow CLAUDE.md updates (project documentation is orchestrator responsibility)
+  if [[ "$(basename "$FILE_PATH")" == "CLAUDE.md" ]] || [[ "$(basename "$FILE_PATH")" == "CLAUDE.local.md" ]]; then
+    exit 0
+  fi
+  # Allow git-issues.md updates (issue tracking is orchestrator responsibility)
+  if [[ "$(basename "$FILE_PATH")" == "git-issues.md" ]]; then
+    exit 0
+  fi
+  # Allow memory files (orchestrator maintains persistent learnings)
+  if [[ "$FILE_PATH" == *"/.claude/"*"/memory/"* ]] || [[ "$FILE_PATH" == *"/.claude/memory/"* ]]; then
+    exit 0
+  fi
+fi
+
+# QUICK-FIX ESCAPE HATCH with branch enforcement
+# Orchestrators can make small edits on feature branches with user approval
+# But NEVER on main/master - must use full bead + worktree workflow
+if [[ "$TOOL_NAME" == "Edit" ]] || [[ "$TOOL_NAME" == "Write" ]]; then
+  FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+  FILE_NAME=$(basename "$FILE_PATH")
+
+  # Check if editing within a worktree (always allowed for orchestrator)
+  if [[ "$FILE_PATH" == *"/.worktrees/"* ]]; then
+    exit 0
+  fi
+
+  # Check current branch
+  CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+
+  # On main/master → hard deny, guide to alternatives
+  if [[ "$CURRENT_BRANCH" == "main" ]] || [[ "$CURRENT_BRANCH" == "master" ]]; then
+    cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot edit files on $CURRENT_BRANCH branch.\n\nFor quick fixes (<10 lines):\n  git checkout -b quick-fix-description\n  Then retry the edit (you'll be prompted for approval)\n\nFor larger changes:\n  Use the full bead workflow with supervisors."}}
+EOF
+    exit 0
+  fi
+
+  # On feature branch → ask for quick-fix approval
+  # Estimate change size for Edit tool
+  if [[ "$TOOL_NAME" == "Edit" ]]; then
+    OLD_STRING=$(echo "$INPUT" | jq -r '.tool_input.old_string // empty')
+    NEW_STRING=$(echo "$INPUT" | jq -r '.tool_input.new_string // empty')
+    OLD_LINES=$(echo "$OLD_STRING" | wc -l | tr -d ' ')
+    NEW_LINES=$(echo "$NEW_STRING" | wc -l | tr -d ' ')
+    OLD_CHARS=${#OLD_STRING}
+    NEW_CHARS=${#NEW_STRING}
+    SIZE_INFO="~${NEW_LINES} lines (${OLD_CHARS} → ${NEW_CHARS} chars)"
+  else
+    # Write tool - estimate from content
+    CONTENT=$(echo "$INPUT" | jq -r '.tool_input.content // empty')
+    CONTENT_LINES=$(echo "$CONTENT" | wc -l | tr -d ' ')
+    SIZE_INFO="~${CONTENT_LINES} lines (new file)"
+  fi
+
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"ask","permissionDecisionReason":"Quick fix on branch '$CURRENT_BRANCH'?\n  File: $FILE_NAME\n  Change: $SIZE_INFO\n\nApprove for trivial changes (<10 lines).\nDeny to use full bead workflow instead."}}
+EOF
+  exit 0
+fi
+
+# Block NotebookEdit (no quick-fix escape for notebooks)
+if [[ "$TOOL_NAME" == "NotebookEdit" ]]; then
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Tool '$TOOL_NAME' blocked. Orchestrators investigate and delegate via Task(). Supervisors implement."}}
+EOF
+  exit 0
+fi
+
+# Validate provider_delegator agent invocations - block implementation agents
+if [[ "$TOOL_NAME" == "mcp__provider_delegator__invoke_agent" ]]; then
+  AGENT=$(echo "$INPUT" | jq -r '.tool_input.agent // empty')
+  CODEX_ALLOWED="scout|detective|architect|scribe|code-reviewer"
+
+  if [[ ! "$AGENT" =~ ^($CODEX_ALLOWED)$ ]]; then
+    cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Agent '$AGENT' cannot be invoked via Codex. Implementation agents (*-supervisor, discovery) must use Task() with BEAD_ID for beads workflow."}}
+EOF
+    exit 0
+  fi
+fi
+
+# Validate Bash commands for orchestrator
+if [[ "$TOOL_NAME" == "Bash" ]]; then
+  COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+  FIRST_WORD="${COMMAND%% *}"
+
+  # ALLOW git commands (check second word for read vs write)
+  if [[ "$FIRST_WORD" == "git" ]]; then
+    SECOND_WORD=$(echo "$COMMAND" | awk '{print $2}')
+    case "$SECOND_WORD" in
+      status|log|diff|branch|checkout|merge|fetch|remote|stash|show)
+        exit 0
+        ;;
+      add)
+        # Allow git add for quick-fix flow
+        exit 0
+        ;;
+      commit)
+        # Block --no-verify to ensure pre-commit hooks run
+        if [[ "$COMMAND" == *"--no-verify"* ]] || [[ "$COMMAND" == *"-n"* ]]; then
+          cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"git commit --no-verify is blocked.\n\nPre-commit hooks exist for a reason (type-check, lint, tests).\nRun the commit without --no-verify and fix any issues."}}
+EOF
+          exit 0
+        fi
+        exit 0
+        ;;
+    esac
+  fi
+
+  # ALLOW beads commands (with validation)
+  if [[ "$FIRST_WORD" == "bd" ]]; then
+    SECOND_WORD=$(echo "$COMMAND" | awk '{print $2}')
+
+    # Validate bd create requires description
+    if [[ "$SECOND_WORD" == "create" ]] || [[ "$SECOND_WORD" == "new" ]]; then
+      if [[ "$COMMAND" != *"-d "* ]] && [[ "$COMMAND" != *"--description "* ]] && [[ "$COMMAND" != *"--description="* ]]; then
+        cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"bd create requires description (-d or --description) for supervisor context."}}
+EOF
+        exit 0
+      fi
+    fi
+
+    exit 0
+  fi
+
+  # Allow other bash commands (npm, cargo, etc. for investigation)
+  exit 0
+fi
+
+# Allow everything else
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/clarify-vague-request.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+#
+# UserPromptSubmit: Force clarification on vague requests + epic reminder
+#
+# Uses plain text stdout for context injection (per Claude Code docs)
+#
+
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | jq -r '.prompt // empty')
+LENGTH=${#PROMPT}
+
+if [[ $LENGTH -lt 50 ]]; then
+  cat << 'EOF'
+<system-reminder>
+STOP. This request is too short to act on safely.
+
+BEFORE doing anything else, you MUST use the AskUserQuestion tool to clarify:
+- What specific outcome does the user want?
+- What files/components are involved?
+- Are there any constraints or preferences?
+
+Do NOT guess. Do NOT start working. Ask first.
+</system-reminder>
+EOF
+elif [[ $LENGTH -lt 200 ]]; then
+  cat << 'EOF'
+<system-reminder>
+This request may be ambiguous. Consider using AskUserQuestion to clarify before proceeding.
+</system-reminder>
+EOF
+fi
+
+# Always remind about epic workflow
+cat << 'EOF'
+<cross-domain-check>
+CRITICAL: If this task spans multiple supervisors, you MUST create an EPIC.
+Cross-domain = Epic. No exceptions.
+</cross-domain-check>
+EOF

.agents/skills/create-beads-orchestration/templates/hooks/enforce-bead-for-supervisor.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+#
+# PreToolUse:Task - Enforce bead exists before supervisor dispatch
+#
+# All supervisors must have BEAD_ID in prompt.
+# This ensures all work is tracked.
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+[[ "$TOOL_NAME" != "Task" ]] && exit 0
+
+SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
+PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
+
+# Only enforce for supervisors
+[[ ! "$SUBAGENT_TYPE" =~ supervisor ]] && exit 0
+
+# Exception: merge-supervisor is exempt from bead requirement
+# Merge conflicts are incidental to other work, not tracked separately
+[[ "$SUBAGENT_TYPE" == "merge-supervisor" ]] && exit 0
+
+# Check for BEAD_ID in prompt
+if [[ "$PROMPT" != *"BEAD_ID:"* ]]; then
+  cat << 'EOF'
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<bead-required>\nAll supervisor work MUST be tracked with a bead.\n\n<action>\nFor standalone tasks:\n  1. bd create \"Task title\" -d \"Description\"\n  2. Dispatch with: BEAD_ID: {id}\n\nFor epic children:\n  1. bd create \"Epic\" -d \"...\" --type epic\n  2. bd create \"Child\" -d \"...\" --parent {EPIC_ID}\n  3. Dispatch with: BEAD_ID: {child_id}, EPIC_ID: {epic_id}\n</action>\n\nEach task creates its own worktree at .worktrees/bd-{BEAD_ID}/\n</bead-required>"}}
+EOF
+  exit 0
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/enforce-branch-before-edit.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+#
+# PreToolUse: Block Edit/Write on main branch outside worktrees
+#
+# Supervisors must work in .worktrees/bd-{BEAD_ID}/ directories, not main.
+# This prevents accidental commits to main directory.
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only check Edit and Write tools
+[[ "$TOOL_NAME" != "Edit" ]] && [[ "$TOOL_NAME" != "Write" ]] && exit 0
+
+# Get the file path being edited
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+# Allow Plan mode files (outside repo)
+if [[ "$FILE_PATH" == *"/.claude/plans/"* ]]; then
+  exit 0
+fi
+
+# Allow if editing within .worktrees/ directory
+if [[ "$FILE_PATH" == *"/.worktrees/"* ]] || [[ "$FILE_PATH" == *"\.worktrees\"* ]]; then
+  exit 0
+fi
+
+# Get current working directory
+CWD=$(pwd)
+
+# Allow if currently inside a .worktrees/ directory
+if [[ "$CWD" == *"/.worktrees/"* ]] || [[ "$CWD" == *"\.worktrees\"* ]]; then
+  exit 0
+fi
+
+# Check current branch (if we're in a git repo outside worktrees)
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+
+# Block if on main or master (and not in a worktree)
+if [[ "$CURRENT_BRANCH" == "main" ]] || [[ "$CURRENT_BRANCH" == "master" ]]; then
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot edit files on $CURRENT_BRANCH branch. Supervisors must work in worktrees.
+
+Create a worktree first using the API:
+  POST /api/git/worktree { repo_path, bead_id }
+
+Then cd into .worktrees/bd-{BEAD_ID}/ to make changes."}}
+EOF
+  exit 0
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/enforce-concise-response.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+#
+# PostToolUse: Enforce concise responses from subagents
+#
+# Subagents should return concise reports (max 10 lines, ~500 chars)
+# This reduces context usage and keeps orchestrator focused.
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only check Task tool responses
+[[ "$TOOL_NAME" != "Task" ]] && exit 0
+
+# Get the tool response
+RESPONSE=$(echo "$INPUT" | jq -r '.tool_result // empty')
+[[ -z "$RESPONSE" ]] && exit 0
+
+# Count lines and characters
+LINE_COUNT=$(echo "$RESPONSE" | wc -l | tr -d ' ')
+CHAR_COUNT=$(echo "$RESPONSE" | wc -c | tr -d ' ')
+
+# Limits
+MAX_LINES=10
+MAX_CHARS=500
+
+# Check limits (warn but don't block - agent already completed)
+if [[ "$LINE_COUNT" -gt "$MAX_LINES" ]] || [[ "$CHAR_COUNT" -gt "$MAX_CHARS" ]]; then
+  # Log warning (PostToolUse can't deny, only add context)
+  cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PostToolUse",
+    "warning": "Subagent response exceeded limits (${LINE_COUNT} lines, ${CHAR_COUNT} chars). Target: ${MAX_LINES} lines, ${MAX_CHARS} chars. Consider asking agents for more concise reports."
+  }
+}
+EOF
+  exit 0
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/enforce-sequential-dispatch.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+#
+# PreToolUse:Task - Enforce sequential dispatch and design doc existence
+#
+# For epic child tasks:
+# 1. Blocks dispatch if task has unresolved blockers
+# 2. Blocks dispatch if epic has design path but file doesn't exist
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+[[ "$TOOL_NAME" != "Task" ]] && exit 0
+
+SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
+PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
+
+# Only check for supervisors (not architect, scout, etc.)
+[[ ! "$SUBAGENT_TYPE" =~ supervisor ]] && exit 0
+
+# Worker-supervisor is exempt
+[[ "$SUBAGENT_TYPE" == *"worker"* ]] && exit 0
+
+# Extract BEAD_ID
+BEAD_ID=$(echo "$PROMPT" | grep -oE "BEAD_ID: [A-Za-z0-9._-]+" | head -1 | sed 's/BEAD_ID: //')
+[[ -z "$BEAD_ID" ]] && exit 0
+
+# Block dispatch to closed/done beads - create a new bead instead
+BEAD_STATUS=$(bd show "$BEAD_ID" --json 2>/dev/null | jq -r '.[0].status // empty')
+if [[ "$BEAD_STATUS" == "closed" || "$BEAD_STATUS" == "done" ]]; then
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<closed-bead>\nBead ${BEAD_ID} is already ${BEAD_STATUS}. Do not reopen closed beads.\n\nCreate a new bead for follow-up work and relate it:\n\n  bd create \"Fix: [description]\" -d \"Follow-up to ${BEAD_ID}: [details]\"\n  # Returns: {NEW_ID}\n  bd dep relate {NEW_ID} ${BEAD_ID}\n\nThen dispatch with the NEW bead ID.\n</closed-bead>"}}
+EOF
+  exit 0
+fi
+
+# Check if this is an epic child (contains dot)
+if [[ "$BEAD_ID" == *"."* ]]; then
+  # Extract EPIC_ID (everything before last dot)
+  EPIC_ID=$(echo "$BEAD_ID" | sed 's/\.[0-9]*$//')
+
+  # Check for unresolved blockers (exclude parent epic - it's not a real blocker)
+  BLOCKERS=$(bd dep list "$BEAD_ID" --json 2>/dev/null | jq -r --arg epic "$EPIC_ID" '.[] | select(.id != $epic and .status != "done" and .status != "closed") | .id' 2>/dev/null | tr '\n' ', ' | sed 's/,$//')
+
+  if [[ -n "$BLOCKERS" ]]; then
+    cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<blocked-task>\nCannot dispatch ${BEAD_ID} - unresolved blockers: ${BLOCKERS}\n\nComplete blocking tasks first, then dispatch this one.\n\nUse: bd ready --json to see tasks with no blockers.\n</blocked-task>"}}
+EOF
+    exit 0
+  fi
+
+  # Check design doc exists (if epic has design field)
+  DESIGN_PATH=$(bd show "$EPIC_ID" --json 2>/dev/null | jq -r '.[0].design // empty')
+
+  if [[ -n "$DESIGN_PATH" ]] && [[ ! -f "$DESIGN_PATH" ]]; then
+    cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"<design-doc-missing>\nEpic ${EPIC_ID} has design path '${DESIGN_PATH}' but file doesn't exist.\n\n<stop-and-think>\nBefore dispatching architect, verify you fully understand the epic:\n\n1. Are the requirements clear and unambiguous?\n2. Do you know the expected inputs/outputs?\n3. Are there edge cases or constraints to consider?\n4. Do you understand how this integrates with existing code?\n\nIf ANY ambiguity exists -> Use AskUserQuestion to clarify FIRST.\nDo NOT dispatch architect with vague requirements.\n</stop-and-think>\n\n<next-steps>\nIf requirements are CLEAR:\n  Task(\n    subagent_type=\"architect\",\n    prompt=\"Create design doc for EPIC_ID: ${EPIC_ID}\n           Output: ${DESIGN_PATH}\n           \n           [Provide clear, specific requirements]\"\n  )\n\nIf requirements are UNCLEAR:\n  AskUserQuestion(\n    questions=[{\n      \"question\": \"[Your specific clarifying question]\",\n      \"header\": \"Clarify\",\n      \"options\": [...],\n      \"multiSelect\": false\n    }]\n  )\n</next-steps>\n</design-doc-missing>"}}
+EOF
+    exit 0
+  fi
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/inject-discipline-reminder.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+#
+# PreToolUse: Inject discipline skill reminder for supervisor dispatches
+#
+# When orchestrator dispatches a supervisor via Task(), remind them to
+# invoke the subagents-discipline skill at the start of implementation.
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only check Task tool
+[[ "$TOOL_NAME" != "Task" ]] && exit 0
+
+# Check if dispatching a supervisor
+SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
+
+# Only inject for supervisors (not code-reviewer, architect, etc.)
+if [[ "$SUBAGENT_TYPE" == *"-supervisor"* ]]; then
+  cat << 'EOF'
+<system-reminder>
+SUPERVISOR DISPATCH: Before implementing, invoke `/subagents-discipline` skill.
+This ensures verification-first development with DEMO blocks.
+</system-reminder>
+EOF
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/log-dispatch-prompt.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+#
+# PostToolUse:Task (async) - Auto-log dispatch prompts to bead comments
+#
+# When orchestrator dispatches a supervisor via Task(), capture the prompt
+# and log it as a DISPATCH comment on the bead. This replaces manual
+# INVESTIGATION logging — the dispatch prompt IS the investigation record.
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only process Task tool
+[[ "$TOOL_NAME" != "Task" ]] && exit 0
+
+# Extract subagent_type
+SUBAGENT_TYPE=$(echo "$INPUT" | jq -r '.tool_input.subagent_type // empty')
+
+# Only log supervisor dispatches
+[[ "$SUBAGENT_TYPE" != *"supervisor"* ]] && exit 0
+
+# Extract prompt
+PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
+[[ -z "$PROMPT" ]] && exit 0
+
+# Extract BEAD_ID from prompt
+BEAD_ID=$(echo "$PROMPT" | grep -oE 'BEAD_ID: [A-Za-z0-9._-]+' | head -1 | sed 's/BEAD_ID: //')
+[[ -z "$BEAD_ID" ]] && exit 0
+
+# Truncate prompt at 2048 chars
+TRUNCATED_PROMPT=$(echo "$PROMPT" | head -c 2048)
+
+# Log dispatch to bead (fail silently)
+# Prefix: DISPATCH_PROMPT — UI renders as collapsible "Prompt Used" entry
+bd comment "$BEAD_ID" "DISPATCH_PROMPT [$SUBAGENT_TYPE]:
+
+$TRUNCATED_PROMPT" 2>/dev/null || true
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/memory-capture.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+#
+# PostToolUse:Bash (async) - Capture knowledge from bd comment commands
+#
+# Detects: bd comment {BEAD_ID} "LEARNED: ..."
+# Extracts knowledge entries into .beads/memory/knowledge.jsonl
+#
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+
+# Only process Bash tool
+[[ "$TOOL_NAME" != "Bash" ]] && exit 0
+
+# Extract the command that was executed
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+[[ -z "$COMMAND" ]] && exit 0
+
+# Only process bd comment commands containing knowledge markers
+echo "$COMMAND" | grep -qE 'bd\s+comment\s+' || exit 0
+echo "$COMMAND" | grep -qE 'LEARNED:' || exit 0
+
+# Extract BEAD_ID (argument after "bd comment")
+BEAD_ID=$(echo "$COMMAND" | sed -E 's/.*bd[[:space:]]+comment[[:space:]]+([A-Za-z0-9._-]+)[[:space:]]+.*/\1/')
+[[ -z "$BEAD_ID" || "$BEAD_ID" == "$COMMAND" ]] && exit 0
+
+# Extract the comment body (content inside quotes after bead ID)
+COMMENT_BODY=$(echo "$COMMAND" | sed -E 's/.*bd[[:space:]]+comment[[:space:]]+[A-Za-z0-9._-]+[[:space:]]+["'\'']//' | sed -E 's/["'\''][[:space:]]*$//' | head -c 4096)
+[[ -z "$COMMENT_BODY" ]] && exit 0
+
+# Determine type and extract content (voluntary LEARNED only)
+TYPE=""
+CONTENT=""
+if echo "$COMMENT_BODY" | grep -q "LEARNED:"; then
+  TYPE="learned"
+  CONTENT=$(echo "$COMMENT_BODY" | sed 's/.*LEARNED:[[:space:]]*//' | head -c 2048)
+fi
+
+[[ -z "$TYPE" || -z "$CONTENT" ]] && exit 0
+
+# Generate key from content (type + slugified first 60 chars)
+SLUG=$(echo "$CONTENT" | head -c 60 | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '-' | sed 's/^-//;s/-$//')
+KEY="${TYPE}-${SLUG}"
+
+# Detect source agent from CWD or transcript context
+SOURCE="orchestrator"
+CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
+if echo "$CWD" | grep -q '\.worktrees/'; then
+  # Inside a worktree = supervisor is running
+  SOURCE="supervisor"
+fi
+
+# Build tags array - start with type tag
+TAGS_ARRAY=("$TYPE")
+
+# Scan content for known tech keywords and add matching tags
+for tag in swift swiftui appkit menubar api security test database \
+           networking ui layout performance crash bug fix workaround \
+           gotcha pattern convention architecture auth middleware \
+           async concurrency model protocol adapter scanner engine; do
+  if echo "$CONTENT" | grep -qi "$tag"; then
+    TAGS_ARRAY+=("$tag")
+  fi
+done
+
+# Convert tags array to JSON
+TAGS_JSON=$(printf '%s\n' "${TAGS_ARRAY[@]}" | jq -R . | jq -s .)
+
+# Get timestamp
+TS=$(date +%s)
+
+# Build JSON entry with proper escaping
+ENTRY=$(jq -cn \
+  --arg key "$KEY" \
+  --arg type "$TYPE" \
+  --arg content "$CONTENT" \
+  --arg source "$SOURCE" \
+  --argjson tags "$TAGS_JSON" \
+  --argjson ts "$TS" \
+  --arg bead "$BEAD_ID" \
+  '{key: $key, type: $type, content: $content, source: $source, tags: $tags, ts: $ts, bead: $bead}')
+
+# Validate JSON
+[[ -z "$ENTRY" ]] && exit 0
+echo "$ENTRY" | jq . >/dev/null 2>&1 || exit 0
+
+# Resolve memory directory
+MEMORY_DIR="${CLAUDE_PROJECT_DIR:-.}/.beads/memory"
+mkdir -p "$MEMORY_DIR"
+KNOWLEDGE_FILE="$MEMORY_DIR/knowledge.jsonl"
+
+# Append entry
+echo "$ENTRY" >> "$KNOWLEDGE_FILE"
+
+# Rotation: archive oldest 500 when file exceeds 1000 lines
+LINE_COUNT=$(wc -l < "$KNOWLEDGE_FILE" 2>/dev/null | tr -d ' ')
+if [[ "$LINE_COUNT" -gt 1000 ]]; then
+  ARCHIVE_FILE="$MEMORY_DIR/knowledge.archive.jsonl"
+  head -500 "$KNOWLEDGE_FILE" >> "$ARCHIVE_FILE"
+  tail -n +501 "$KNOWLEDGE_FILE" > "$KNOWLEDGE_FILE.tmp"
+  mv "$KNOWLEDGE_FILE.tmp" "$KNOWLEDGE_FILE"
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/nudge-claude-md-update.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+#
+# Compact: Nudge orchestrator to update CLAUDE.md
+#
+# When context is compacted, remind the orchestrator to capture important
+# project state in CLAUDE.md so it survives across sessions.
+#
+
+# Check if CLAUDE.md exists in project root
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
+[[ -z "$REPO_ROOT" ]] && exit 0
+
+CLAUDE_MD="$REPO_ROOT/CLAUDE.md"
+[[ ! -f "$CLAUDE_MD" ]] && exit 0
+
+# Check if Current State section exists and has content
+CURRENT_STATE=$(sed -n '/^## Current State/,/^## /p' "$CLAUDE_MD" | grep -v '^## ' | grep -v '^<!--' | grep -v '^-->' | grep -v '^$' | head -5)
+
+if [[ -z "$CURRENT_STATE" ]]; then
+  # Current State is empty — strong nudge
+  cat << 'EOF'
+CLAUDE.md MAINTENANCE REMINDER:
+
+The "## Current State" section in CLAUDE.md is empty. Before this context is compacted, consider updating it with:
+- Active work in progress (bead IDs, what's being built)
+- Recent architectural decisions or trade-offs made
+- Known issues or blockers discovered
+- Key files or patterns identified during investigation
+
+This information will persist across sessions and help future investigations.
+
+Update with: Edit CLAUDE.md → add content under "## Current State"
+EOF
+else
+  # Current State has content — gentle reminder
+  cat << 'EOF'
+Context is being compacted. If significant progress was made this session, consider updating CLAUDE.md:
+- "## Current State" for active work and decisions
+- "## Project Overview" if project scope became clearer
+- "## Tech Stack" if new technologies were discovered
+EOF
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/remind-inprogress.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+#
+# PreToolUse:Task - Soft reminder to set bead status before dispatch
+#
+
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | jq -r '.tool_input.prompt // empty')
+
+# Only remind if dispatching a bead task (prompt contains BEAD_ID)
+if [[ "$PROMPT" == *"BEAD_ID:"* ]]; then
+  echo "IMPORTANT: Before dispatching, ensure bead is in_progress: bd update {BEAD_ID} --status in_progress"
+fi
+
+exit 0

.agents/skills/create-beads-orchestration/templates/hooks/session-start.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+#
+# SessionStart: Show full task context for orchestrator
+#
+
+BEADS_DIR="$CLAUDE_PROJECT_DIR/.beads"
+
+if [[ ! -d "$BEADS_DIR" ]]; then
+  echo "No .beads directory found. Run 'bd init' to initialize."
+  exit 0
+fi
+
+# Check if bd is available
+if ! command -v bd &>/dev/null; then
+  echo "beads CLI (bd) not found. Install from: https://github.com/steveyegge/beads"
+  exit 0
+fi
+
+# ============================================================
+# Dirty Parent Check - Warn if main directory has uncommitted changes
+# ============================================================
+REPO_ROOT=$(git -C "$CLAUDE_PROJECT_DIR" rev-parse --show-toplevel 2>/dev/null)
+if [[ -n "$REPO_ROOT" ]]; then
+  DIRTY=$(git -C "$REPO_ROOT" status --porcelain 2>/dev/null)
+  if [[ -n "$DIRTY" ]]; then
+    echo "⚠️  WARNING: Main directory has uncommitted changes."
+    echo "   Agents should only work in .worktrees/"
+    echo ""
+  fi
+fi
+
+# ============================================================
+# Auto-cleanup: Detect merged PRs and cleanup worktrees
+# ============================================================
+WORKTREES_DIR="$CLAUDE_PROJECT_DIR/.worktrees"
+if [[ -d "$WORKTREES_DIR" ]]; then
+  for worktree in $(git -C "$REPO_ROOT" worktree list --porcelain 2>/dev/null | grep "^worktree.*\.worktrees/bd-" | awk '{print $2}'); do
+    BEAD_ID=$(basename "$worktree" | sed 's/bd-//')
+    BRANCH=$(basename "$worktree")
+    
+    # Check if branch was merged to main
+    if git -C "$REPO_ROOT" branch --merged main 2>/dev/null | grep -q "$BRANCH"; then
+      echo "✓ $BRANCH was merged - consider cleaning up"
+      echo "   Run: git worktree remove \"$worktree\" && bd close \"$BEAD_ID\""
+      echo ""
+    fi
+  done
+fi
+
+# ============================================================
+# Open PR Reminder
+# ============================================================
+if command -v gh &>/dev/null; then
+  OPEN_PRS=$(gh pr list --author "@me" --state open --json number,title,headRefName 2>/dev/null)
+  if [[ -n "$OPEN_PRS" && "$OPEN_PRS" != "[]" ]]; then
+    echo "📋 You have open PRs:"
+    echo "$OPEN_PRS" | jq -r '.[] | "  #\(.number) \(.title) (\(.headRefName))"' 2>/dev/null
+    echo ""
+  fi
+fi
+
+echo ""
+echo "## Task Status"
+echo ""
+
+# Show in-progress beads first (highest priority)
+IN_PROGRESS=$(bd list --status in_progress 2>/dev/null | head -5)
+if [[ -n "$IN_PROGRESS" ]]; then
+  echo "### In Progress (resume these):"
+  echo "$IN_PROGRESS"
+  echo ""
+fi
+
+# Show ready (unblocked) beads
+READY=$(bd ready 2>/dev/null | head -5)
+if [[ -n "$READY" ]]; then
+  echo "### Ready (no blockers):"
+  echo "$READY"
+  echo ""
+fi
+
+# Show blocked beads
+BLOCKED=$(bd blocked 2>/dev/null | head -3)
+if [[ -n "$BLOCKED" ]]; then
+  echo "### Blocked:"
+  echo "$BLOCKED"
+  echo ""
+fi
+
+# Show stale beads (no activity in 3 days)
+STALE=$(bd stale --days 3 2>/dev/null | head -3)
+if [[ -n "$STALE" ]]; then
+  echo "### Stale (no activity in 3 days):"
+  echo "$STALE"
+  echo ""
+fi
+
+# If nothing found
+if [[ -z "$IN_PROGRESS" && -z "$READY" && -z "$BLOCKED" && -z "$STALE" ]]; then
+  echo "No active beads. Create one with: bd create \"Task title\" -d \"Description\""
+fi
+
+# ============================================================
+# Knowledge Base - Surface recent learnings
+# ============================================================
+KNOWLEDGE_FILE="$BEADS_DIR/memory/knowledge.jsonl"
+if [[ -f "$KNOWLEDGE_FILE" && -s "$KNOWLEDGE_FILE" ]]; then
+  TOTAL_ENTRIES=$(wc -l < "$KNOWLEDGE_FILE" | tr -d ' ')
+  echo ""
+  echo "## Recent Knowledge ($TOTAL_ENTRIES entries)"
+  echo ""
+  # Show 5 most recent, deduplicated by key (latest wins)
+  tail -20 "$KNOWLEDGE_FILE" | jq -s '
+    group_by(.key) | map(max_by(.ts)) | sort_by(-.ts) | .[0:5] | .[] |
+    "  [\(.type | ascii_upcase | .[0:5])] \(.content | .[0:100])  (\(.source))"
+  ' -r 2>/dev/null
+  echo ""
+  echo "  Search: .beads/memory/recall.sh \"keyword\""
+fi
+
+echo ""

.agents/skills/create-beads-orchestration/templates/hooks/validate-completion.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+#
+# SubagentStop: Enforce bead lifecycle - work verification
+#
+
+INPUT=$(cat)
+AGENT_TRANSCRIPT=$(echo "$INPUT" | jq -r '.agent_transcript_path // empty')
+MAIN_TRANSCRIPT=$(echo "$INPUT" | jq -r '.transcript_path // empty')
+AGENT_ID=$(echo "$INPUT" | jq -r '.agent_id // empty')
+
+[[ -z "$AGENT_TRANSCRIPT" || ! -f "$AGENT_TRANSCRIPT" ]] && echo '{"decision":"approve"}' && exit 0
+
+# Extract last assistant text response
+LAST_RESPONSE=$(tail -200 "$AGENT_TRANSCRIPT" | jq -rs '
+  [.[] | select(.message?.role == "assistant" and .message?.content != null)
+   | .message.content[] | select(.text != null) | .text] | last // ""
+' 2>/dev/null || echo "")
+
+# === LAYER 1: Extract subagent_type from transcript (fail open) ===
+SUBAGENT_TYPE=""
+if [[ -n "$AGENT_ID" && -n "$MAIN_TRANSCRIPT" && -f "$MAIN_TRANSCRIPT" ]]; then
+  PARENT_TOOL_USE_ID=$(grep "\"agentId\":\"$AGENT_ID\"" "$MAIN_TRANSCRIPT" 2>/dev/null | head -1 | jq -r '.parentToolUseID // empty' 2>/dev/null)
+  if [[ -n "$PARENT_TOOL_USE_ID" ]]; then
+    SUBAGENT_TYPE=$(grep "\"id\":\"$PARENT_TOOL_USE_ID\"" "$MAIN_TRANSCRIPT" 2>/dev/null | \
+      grep '"name":"Task"' | \
+      jq -r '.message.content[]? | select(.type == "tool_use" and .id == "'"$PARENT_TOOL_USE_ID"'") | .input.subagent_type // empty' 2>/dev/null | \
+      head -1)
+  fi
+fi
+
+# === LAYER 2: Check completion format (backup detection) ===
+HAS_BEAD_COMPLETE=$(echo "$LAST_RESPONSE" | grep -cE "BEAD.*COMPLETE" 2>/dev/null || true)
+HAS_WORKTREE_OR_BRANCH=$(echo "$LAST_RESPONSE" | grep -cE "(Worktree:|Branch:).*bd-" 2>/dev/null || true)
+[[ -z "$HAS_BEAD_COMPLETE" ]] && HAS_BEAD_COMPLETE=0
+[[ -z "$HAS_WORKTREE_OR_BRANCH" ]] && HAS_WORKTREE_OR_BRANCH=0
+
+# Determine if this is a supervisor (Layer 1) or has completion format (Layer 2)
+IS_SUPERVISOR="false"
+[[ "$SUBAGENT_TYPE" == *"supervisor"* ]] && IS_SUPERVISOR="true"
+
+NEEDS_VERIFICATION="false"
+[[ "$IS_SUPERVISOR" == "true" ]] && NEEDS_VERIFICATION="true"
+[[ "$HAS_BEAD_COMPLETE" -ge 1 && "$HAS_WORKTREE_OR_BRANCH" -ge 1 ]] && NEEDS_VERIFICATION="true"
+
+# Skip verification if not needed
+[[ "$NEEDS_VERIFICATION" == "false" ]] && echo '{"decision":"approve"}' && exit 0
+
+# Worker supervisor is exempt
+[[ "$SUBAGENT_TYPE" == *"worker"* ]] && echo '{"decision":"approve"}' && exit 0
+
+# === VERIFICATION CHECKS ===
+
+# Check 1: Completion format required for supervisors
+if [[ "$IS_SUPERVISOR" == "true" ]] && [[ "$HAS_BEAD_COMPLETE" -lt 1 || "$HAS_WORKTREE_OR_BRANCH" -lt 1 ]]; then
+  cat << 'EOF'
+{"decision":"block","reason":"Work verification failed: completion report missing.\n\nRequired format:\nBEAD {BEAD_ID} COMPLETE\nWorktree: .worktrees/bd-{BEAD_ID}\nFiles: [list]\nTests: pass\nSummary: [1 sentence]"}
+EOF
+  exit 0
+fi
+
+# Extract BEAD_ID from response
+BEAD_ID_FROM_RESPONSE=$(echo "$LAST_RESPONSE" | grep -oE "BEAD [A-Za-z0-9._-]+" | head -1 | awk '{print $2}')
+IS_EPIC_CHILD="false"
+[[ "$BEAD_ID_FROM_RESPONSE" == *"."* ]] && IS_EPIC_CHILD="true"
+
+# Check 2: Comment required
+HAS_COMMENT=$(grep -c '"bd comment\|"command":"bd comment' "$AGENT_TRANSCRIPT" 2>/dev/null) || HAS_COMMENT=0
+if [[ "$HAS_COMMENT" -lt 1 ]]; then
+  cat << 'EOF'
+{"decision":"block","reason":"Work verification failed: no comment on bead.\n\nRun: bd comment {BEAD_ID} \"Completed: [summary]\""}
+EOF
+  exit 0
+fi
+
+# Check 3: Worktree verification
+REPO_ROOT=$(cd "$(git rev-parse --git-common-dir)/.." 2>/dev/null && pwd)
+WORKTREE_PATH="$REPO_ROOT/.worktrees/bd-${BEAD_ID_FROM_RESPONSE}"
+
+if [[ ! -d "$WORKTREE_PATH" ]]; then
+  cat << 'EOF'
+{"decision":"block","reason":"Work verification failed: worktree not found.\n\nCreate worktree first via API."}
+EOF
+  exit 0
+fi
+
+# Check 4: Uncommitted changes
+UNCOMMITTED=$(git -C "$WORKTREE_PATH" status --porcelain 2>/dev/null)
+if [[ -n "$UNCOMMITTED" ]]; then
+  cat << 'EOF'
+{"decision":"block","reason":"Work verification failed: uncommitted changes.\n\nRun in worktree:\n  git add -A && git commit -m \"...\""}
+EOF
+  exit 0
+fi
+
+# Check 5: Remote push
+HAS_REMOTE=$(git -C "$WORKTREE_PATH" remote get-url origin 2>/dev/null)
+if [[ -n "$HAS_REMOTE" ]]; then
+  BRANCH="bd-${BEAD_ID_FROM_RESPONSE}"
+  REMOTE_EXISTS=$(git -C "$WORKTREE_PATH" ls-remote --heads origin "$BRANCH" 2>/dev/null)
+  if [[ -z "$REMOTE_EXISTS" ]]; then
+    cat << 'EOF'
+{"decision":"block","reason":"Work verification failed: branch not pushed.\n\nRun: git push -u origin bd-{BEAD_ID}"}
+EOF
+    exit 0
+  fi
+fi
+
+# Check 6: Bead status
+BEAD_STATUS=$(bd show "$BEAD_ID_FROM_RESPONSE" --json 2>/dev/null | jq -r '.[0].status // "unknown"')
+EXPECTED_STATUS="inreview"
+# Epic children also use inreview (done status not supported in bd)
+if [[ "$BEAD_STATUS" != "$EXPECTED_STATUS" ]]; then
+  cat << EOF
+{"decision":"block","reason":"Work verification failed: bead status is '${BEAD_STATUS}'.\n\nRun: bd update ${BEAD_ID_FROM_RESPONSE} --status ${EXPECTED_STATUS}"}
+EOF
+  exit 0
+fi
+
+# Check 7: Verbosity limit
+DECODED_RESPONSE=$(printf '%b' "$LAST_RESPONSE")
+LINE_COUNT=$(echo "$DECODED_RESPONSE" | wc -l | tr -d ' ')
+CHAR_COUNT=${#DECODED_RESPONSE}
+
+if [[ "$LINE_COUNT" -gt 15 ]] || [[ "$CHAR_COUNT" -gt 800 ]]; then
+  cat << EOF
+{"decision":"block","reason":"Work verification failed: response too verbose (${LINE_COUNT} lines, ${CHAR_COUNT} chars). Max: 15 lines, 800 chars."}
+EOF
+  exit 0
+fi
+
+echo '{"decision":"approve"}'

.agents/skills/create-beads-orchestration/templates/hooks/validate-epic-close.sh

@@ -0,0 +1,84 @@
+#!/bin/bash
+# Hook: Validate bead close — PR must be merged, epic children must be complete
+# Prevents closing a bead whose branch has no merged PR
+# Prevents closing an epic when children are still open
+
+set -euo pipefail
+
+TOOL_INPUT="${CLAUDE_TOOL_INPUT:-}"
+
+# Only check Bash commands containing "bd close"
+if ! echo "$TOOL_INPUT" | jq -e '.command' >/dev/null 2>&1; then
+  exit 0
+fi
+
+COMMAND=$(echo "$TOOL_INPUT" | jq -r '.command // ""')
+
+# Check if this is a bd close command
+if ! echo "$COMMAND" | grep -qE 'bd\s+close'; then
+  exit 0
+fi
+
+# Allow --force override
+if echo "$COMMAND" | grep -qE '\-\-force'; then
+  exit 0
+fi
+
+# Extract the ID being closed (handles: bd close ID, bd close ID && ..., etc.)
+CLOSE_ID=$(echo "$COMMAND" | sed -E 's/.*bd[[:space:]]+close[[:space:]]+([A-Za-z0-9._-]+).*/\1/')
+
+if [ -z "$CLOSE_ID" ]; then
+  exit 0
+fi
+
+# === CHECK 1: PR merge validation ===
+# Only applies if repo has a remote and branch exists
+BRANCH="bd-${CLOSE_ID}"
+
+HAS_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
+if [ -n "$HAS_REMOTE" ]; then
+  REMOTE_BRANCH=$(git ls-remote --heads origin "$BRANCH" 2>/dev/null || echo "")
+
+  if [ -n "$REMOTE_BRANCH" ]; then
+    # Branch exists on remote — check for merged PR
+    if command -v gh >/dev/null 2>&1; then
+      MERGED_PR=$(gh pr list --head "$BRANCH" --state merged --json number --jq '.[0].number' 2>/dev/null || echo "")
+
+      if [ -z "$MERGED_PR" ]; then
+        cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot close bead '$CLOSE_ID' — branch '$BRANCH' has no merged PR. Create and merge a PR first, or use 'bd close $CLOSE_ID --force' to override."}}
+EOF
+        exit 0
+      fi
+    fi
+  fi
+fi
+
+# === CHECK 2: Epic children validation ===
+# Check if this is an epic by looking at issue_type
+ISSUE_TYPE=$(bd show "$CLOSE_ID" --json 2>/dev/null | jq -r '.[0].issue_type // ""' 2>/dev/null || echo "")
+
+if [ "$ISSUE_TYPE" != "epic" ]; then
+  # Not an epic, allow close
+  exit 0
+fi
+
+# This is an epic - check if all children are complete
+INCOMPLETE=$(bd list --json 2>/dev/null | jq -r --arg epic "$CLOSE_ID" '
+  [.[] | select((.id | startswith($epic + ".")) and .status != "done" and .status != "closed")] | length
+' 2>/dev/null || echo "0")
+
+if [ "$INCOMPLETE" != "0" ] && [ "$INCOMPLETE" != "" ]; then
+  # Get list of incomplete children for the error message
+  INCOMPLETE_LIST=$(bd list --json 2>/dev/null | jq -r --arg epic "$CLOSE_ID" '
+    [.[] | select((.id | startswith($epic + ".")) and .status != "done" and .status != "closed")] | .[] | "\(.id) (\(.status))"
+  ' 2>/dev/null | tr '\n' ', ' | sed 's/,$//')
+
+  cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Cannot close epic '$CLOSE_ID' - has $INCOMPLETE incomplete children: $INCOMPLETE_LIST. Mark all children as done first."}}
+EOF
+  exit 0
+fi
+
+# All checks passed, allow close
+exit 0

.agents/skills/create-beads-orchestration/templates/mcp.json.template

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "provider_delegator": {
+      "type": "stdio",
+      "command": "{{PROVIDER_DELEGATOR_PATH}}",
+      "args": ["-m", "mcp_provider_delegator.server"],
+      "env": {
+        "AGENT_TEMPLATES_PATH": "{{AGENT_TEMPLATES_PATH}}"
+      }
+    }
+  }
+}

.agents/skills/create-beads-orchestration/templates/memory/recall.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+#
+# recall.sh - Search the project knowledge base
+#
+# Usage:
+#   .beads/memory/recall.sh "keyword"                  # Search by keyword
+#   .beads/memory/recall.sh "keyword" --type learned   # Filter by type
+#   .beads/memory/recall.sh --recent 10                # Show N most recent
+#   .beads/memory/recall.sh --stats                    # Knowledge base stats
+#   .beads/memory/recall.sh "keyword" --all            # Include archive
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+KNOWLEDGE_FILE="$SCRIPT_DIR/knowledge.jsonl"
+ARCHIVE_FILE="$SCRIPT_DIR/knowledge.archive.jsonl"
+
+if [[ ! -f "$KNOWLEDGE_FILE" ]] || [[ ! -s "$KNOWLEDGE_FILE" ]]; then
+  echo "No knowledge entries yet."
+  echo "Entries are created automatically from bd comment commands with INVESTIGATION: or LEARNED: prefixes."
+  exit 0
+fi
+
+# Parse arguments
+QUERY=""
+TYPE_FILTER=""
+INCLUDE_ARCHIVE=false
+SHOW_RECENT=0
+SHOW_STATS=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --type)
+      TYPE_FILTER="${2:-}"
+      shift 2
+      ;;
+    --all)
+      INCLUDE_ARCHIVE=true
+      shift
+      ;;
+    --recent)
+      SHOW_RECENT="${2:-10}"
+      shift 2
+      ;;
+    --stats)
+      SHOW_STATS=true
+      shift
+      ;;
+    --help|-h)
+      echo "Usage: recall.sh [query] [--type learned|investigation] [--all] [--recent N] [--stats]"
+      exit 0
+      ;;
+    *)
+      QUERY="$1"
+      shift
+      ;;
+  esac
+done
+
+# Stats mode
+if [[ "$SHOW_STATS" == "true" ]]; then
+  TOTAL=$(wc -l < "$KNOWLEDGE_FILE" | tr -d ' ')
+  LEARNED=$(grep -c '"type":"learned"' "$KNOWLEDGE_FILE" 2>/dev/null) || LEARNED=0
+  INVESTIGATION=$(grep -c '"type":"investigation"' "$KNOWLEDGE_FILE" 2>/dev/null) || INVESTIGATION=0
+  UNIQUE_KEYS=$(jq -r '.key' "$KNOWLEDGE_FILE" 2>/dev/null | sort -u | wc -l | tr -d ' ')
+  ARCHIVE_COUNT=0
+  [[ -f "$ARCHIVE_FILE" ]] && ARCHIVE_COUNT=$(wc -l < "$ARCHIVE_FILE" | tr -d ' ')
+
+  echo "## Knowledge Base Stats"
+  echo "  Active entries: $TOTAL"
+  echo "  Unique keys:    $UNIQUE_KEYS"
+  echo "  Learned:        $LEARNED"
+  echo "  Investigation:  $INVESTIGATION"
+  echo "  Archived:       $ARCHIVE_COUNT"
+  exit 0
+fi
+
+# Recent mode
+if [[ "$SHOW_RECENT" -gt 0 ]]; then
+  echo "## Recent Knowledge ($SHOW_RECENT entries)"
+  echo ""
+  tail -"$SHOW_RECENT" "$KNOWLEDGE_FILE" | jq -r '
+    "[\(.type | ascii_upcase | .[0:5])] \(.key)\n  \(.content | .[0:120])\n  source=\(.source) bead=\(.bead)\n"
+  ' 2>/dev/null
+  exit 0
+fi
+
+# Search mode (default)
+if [[ -z "$QUERY" ]]; then
+  echo "Usage: recall.sh <keyword> [--type learned|investigation] [--all]"
+  exit 1
+fi
+
+# Build file list
+FILES="$KNOWLEDGE_FILE"
+if [[ "$INCLUDE_ARCHIVE" == "true" && -f "$ARCHIVE_FILE" ]]; then
+  FILES="$ARCHIVE_FILE $KNOWLEDGE_FILE"
+fi
+
+# Search and deduplicate (latest entry for each key wins)
+RESULTS=$(cat $FILES | grep -i "$QUERY" 2>/dev/null || true)
+
+# Apply type filter
+if [[ -n "$TYPE_FILTER" ]]; then
+  RESULTS=$(echo "$RESULTS" | grep "\"type\":\"$TYPE_FILTER\"" 2>/dev/null || true)
+fi
+
+if [[ -z "$RESULTS" ]]; then
+  echo "No knowledge entries matching '$QUERY'"
+  [[ -n "$TYPE_FILTER" ]] && echo "  (filtered by type: $TYPE_FILTER)"
+  exit 0
+fi
+
+# Deduplicate by key (latest wins) and format output
+echo "$RESULTS" | jq -s '
+  group_by(.key) | map(max_by(.ts)) | sort_by(-.ts) | .[] |
+  "[\(.type | ascii_upcase | .[0:5])] \(.key)\n  \(.content | .[0:200])\n  source=\(.source) bead=\(.bead) tags=\(.tags | join(","))\n"
+' -r 2>/dev/null
+
+exit 0

.agents/skills/create-beads-orchestration/templates/settings.json

@@ -0,0 +1,81 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/block-orchestrator-tools.sh"}
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-bead-for-supervisor.sh"},
+          {"type": "command", "command": ".claude/hooks/enforce-sequential-dispatch.sh"},
+          {"type": "command", "command": ".claude/hooks/remind-inprogress.sh"},
+          {"type": "command", "command": ".claude/hooks/inject-discipline-reminder.sh"}
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-branch-before-edit.sh"}
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-branch-before-edit.sh"}
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/validate-epic-close.sh"}
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Task",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/enforce-concise-response.sh"},
+          {"type": "command", "command": ".claude/hooks/log-dispatch-prompt.sh", "timeout": 10}
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/memory-capture.sh", "timeout": 10}
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/validate-completion.sh"}
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/session-start.sh"}
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/clarify-vague-request.sh"}
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {"type": "command", "command": ".claude/hooks/nudge-claude-md-update.sh"}
+        ]
+      }
+    ]
+  }
+}

.agents/skills/create-beads-orchestration/templates/skills/react-best-practices/SKILL.md

@@ -0,0 +1,487 @@
+---
+name: react-best-practices
+description: React and Next.js performance optimization patterns. Use BEFORE implementing any React code to ensure best practices are followed.
+---
+
+# React Best Practices
+
+**Version 1.0.0**
+Source: Vercel Engineering (vercel-labs/agent-skills)
+
+> **Note:**
+> This document is for agents and LLMs to follow when maintaining,
+> generating, or refactoring React and Next.js codebases. Contains 40+ rules across 8 categories, prioritized by impact.
+
+---
+
+## How to Use This Skill
+
+**Before implementing ANY React/Next.js code:**
+
+1. Review the relevant sections based on what you're building
+2. Apply the patterns as you write code
+3. Use the "Incorrect" vs "Correct" examples as templates
+
+**Priority order:** Eliminating Waterfalls > Bundle Size > Server-Side > Client-Side > Re-renders > Rendering > JS Perf > Advanced
+
+---
+
+## Quick Reference: Critical Rules
+
+### Top 5 Rules (Always Apply)
+
+1. **Promise.all() for independent operations** - Never sequential awaits for independent data
+2. **Avoid barrel file imports** - Import directly from source files
+3. **Dynamic imports for heavy components** - Lazy-load Monaco, charts, etc.
+4. **Parallel data fetching with component composition** - Structure RSC for parallelism
+5. **Minimize serialization at RSC boundaries** - Only pass needed fields to client
+
+---
+
+## 1. Eliminating Waterfalls
+
+**Impact: CRITICAL** - Waterfalls are the #1 performance killer.
+
+### 1.1 Defer Await Until Needed
+
+Move `await` into branches where actually used.
+
+```typescript
+// BAD: blocks both branches
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  const userData = await fetchUserData(userId)
+  if (skipProcessing) return { skipped: true }
+  return processUserData(userData)
+}
+
+// GOOD: only blocks when needed
+async function handleRequest(userId: string, skipProcessing: boolean) {
+  if (skipProcessing) return { skipped: true }
+  const userData = await fetchUserData(userId)
+  return processUserData(userData)
+}
+```
+
+### 1.2 Promise.all() for Independent Operations
+
+```typescript
+// BAD: 3 round trips
+const user = await fetchUser()
+const posts = await fetchPosts()
+const comments = await fetchComments()
+
+// GOOD: 1 round trip
+const [user, posts, comments] = await Promise.all([
+  fetchUser(),
+  fetchPosts(),
+  fetchComments()
+])
+```
+
+### 1.3 Strategic Suspense Boundaries
+
+```tsx
+// BAD: wrapper blocked by data
+async function Page() {
+  const data = await fetchData()
+  return (
+    <div>
+      <Sidebar />
+      <DataDisplay data={data} />
+      <Footer />
+    </div>
+  )
+}
+
+// GOOD: wrapper shows immediately
+function Page() {
+  return (
+    <div>
+      <Sidebar />
+      <Suspense fallback={<Skeleton />}>
+        <DataDisplay />
+      </Suspense>
+      <Footer />
+    </div>
+  )
+}
+```
+
+---
+
+## 2. Bundle Size Optimization
+
+**Impact: CRITICAL** - Reduces TTI and LCP.
+
+### 2.1 Avoid Barrel File Imports
+
+```tsx
+// BAD: loads 1,583 modules
+import { Check, X, Menu } from 'lucide-react'
+
+// GOOD: loads only 3 modules
+import Check from 'lucide-react/dist/esm/icons/check'
+import X from 'lucide-react/dist/esm/icons/x'
+import Menu from 'lucide-react/dist/esm/icons/menu'
+
+// ALTERNATIVE: Next.js 13.5+ config
+// next.config.js
+module.exports = {
+  experimental: {
+    optimizePackageImports: ['lucide-react', '@mui/material']
+  }
+}
+```
+
+### 2.2 Dynamic Imports for Heavy Components
+
+```tsx
+// BAD: Monaco bundles with main chunk (~300KB)
+import { MonacoEditor } from './monaco-editor'
+
+// GOOD: Monaco loads on demand
+import dynamic from 'next/dynamic'
+const MonacoEditor = dynamic(
+  () => import('./monaco-editor').then(m => m.MonacoEditor),
+  { ssr: false }
+)
+```
+
+### 2.3 Defer Non-Critical Libraries
+
+```tsx
+// BAD: blocks initial bundle
+import { Analytics } from '@vercel/analytics/react'
+
+// GOOD: loads after hydration
+import dynamic from 'next/dynamic'
+const Analytics = dynamic(
+  () => import('@vercel/analytics/react').then(m => m.Analytics),
+  { ssr: false }
+)
+```
+
+### 2.4 Preload on User Intent
+
+```tsx
+function EditorButton({ onClick }: { onClick: () => void }) {
+  const preload = () => {
+    if (typeof window !== 'undefined') {
+      void import('./monaco-editor')
+    }
+  }
+  return (
+    <button onMouseEnter={preload} onFocus={preload} onClick={onClick}>
+      Open Editor
+    </button>
+  )
+}
+```
+
+---
+
+## 3. Server-Side Performance
+
+**Impact: HIGH**
+
+### 3.1 Minimize Serialization at RSC Boundaries
+
+```tsx
+// BAD: serializes all 50 fields
+async function Page() {
+  const user = await fetchUser()  // 50 fields
+  return <Profile user={user} />
+}
+
+// GOOD: serializes only needed fields
+async function Page() {
+  const user = await fetchUser()
+  return <Profile name={user.name} avatar={user.avatar} />
+}
+```
+
+### 3.2 Parallel Data Fetching with Component Composition
+
+```tsx
+// BAD: Sidebar waits for Header's fetch
+export default async function Page() {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      <Sidebar />
+    </div>
+  )
+}
+
+// GOOD: both fetch simultaneously
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <div>
+      <Header />
+      <Sidebar />
+    </div>
+  )
+}
+```
+
+### 3.3 Per-Request Deduplication with React.cache()
+
+```typescript
+import { cache } from 'react'
+
+export const getCurrentUser = cache(async () => {
+  const session = await auth()
+  if (!session?.user?.id) return null
+  return await db.user.findUnique({ where: { id: session.user.id } })
+})
+```
+
+### 3.4 Use after() for Non-Blocking Operations
+
+```tsx
+import { after } from 'next/server'
+
+export async function POST(request: Request) {
+  await updateDatabase(request)
+
+  // Log after response is sent
+  after(async () => {
+    const userAgent = (await headers()).get('user-agent')
+    logUserAction({ userAgent })
+  })
+
+  return Response.json({ status: 'success' })
+}
+```
+
+---
+
+## 4. Client-Side Data Fetching
+
+**Impact: MEDIUM-HIGH**
+
+### 4.1 Use SWR for Automatic Deduplication
+
+```tsx
+// BAD: no deduplication
+function UserList() {
+  const [users, setUsers] = useState([])
+  useEffect(() => {
+    fetch('/api/users').then(r => r.json()).then(setUsers)
+  }, [])
+}
+
+// GOOD: multiple instances share one request
+import useSWR from 'swr'
+function UserList() {
+  const { data: users } = useSWR('/api/users', fetcher)
+}
+```
+
+---
+
+## 5. Re-render Optimization
+
+**Impact: MEDIUM**
+
+### 5.1 Use Functional setState Updates
+
+```tsx
+// BAD: requires state as dependency, risk of stale closure
+const addItems = useCallback((newItems: Item[]) => {
+  setItems([...items, ...newItems])
+}, [items])
+
+// GOOD: stable callback, no stale closures
+const addItems = useCallback((newItems: Item[]) => {
+  setItems(curr => [...curr, ...newItems])
+}, [])
+```
+
+### 5.2 Use Lazy State Initialization
+
+```tsx
+// BAD: runs on every render
+const [settings] = useState(JSON.parse(localStorage.getItem('settings') || '{}'))
+
+// GOOD: runs only once
+const [settings] = useState(() => {
+  const stored = localStorage.getItem('settings')
+  return stored ? JSON.parse(stored) : {}
+})
+```
+
+### 5.3 Use Transitions for Non-Urgent Updates
+
+```tsx
+import { startTransition } from 'react'
+
+function ScrollTracker() {
+  const [scrollY, setScrollY] = useState(0)
+  useEffect(() => {
+    const handler = () => {
+      startTransition(() => setScrollY(window.scrollY))
+    }
+    window.addEventListener('scroll', handler, { passive: true })
+    return () => window.removeEventListener('scroll', handler)
+  }, [])
+}
+```
+
+### 5.4 Narrow Effect Dependencies
+
+```tsx
+// BAD: re-runs on any user field change
+useEffect(() => {
+  console.log(user.id)
+}, [user])
+
+// GOOD: re-runs only when id changes
+useEffect(() => {
+  console.log(user.id)
+}, [user.id])
+```
+
+---
+
+## 6. Rendering Performance
+
+**Impact: MEDIUM**
+
+### 6.1 CSS content-visibility for Long Lists
+
+```css
+.message-item {
+  content-visibility: auto;
+  contain-intrinsic-size: 0 80px;
+}
+```
+
+### 6.2 Hoist Static JSX Elements
+
+```tsx
+// BAD: recreates element every render
+function Container() {
+  return loading && <div className="animate-pulse h-20 bg-gray-200" />
+}
+
+// GOOD: reuses same element
+const loadingSkeleton = <div className="animate-pulse h-20 bg-gray-200" />
+function Container() {
+  return loading && loadingSkeleton
+}
+```
+
+### 6.3 Animate SVG Wrapper, Not SVG Element
+
+```tsx
+// BAD: no hardware acceleration
+<svg className="animate-spin">...</svg>
+
+// GOOD: hardware accelerated
+<div className="animate-spin">
+  <svg>...</svg>
+</div>
+```
+
+---
+
+## 7. JavaScript Performance
+
+**Impact: LOW-MEDIUM**
+
+### 7.1 Build Index Maps for Repeated Lookups
+
+```typescript
+// BAD: O(n) per lookup
+items.filter(item => allowedIds.includes(item.id))
+
+// GOOD: O(1) per lookup
+const allowedSet = new Set(allowedIds)
+items.filter(item => allowedSet.has(item.id))
+```
+
+### 7.2 Use toSorted() Instead of sort()
+
+```typescript
+// BAD: mutates original array
+const sorted = users.sort((a, b) => a.name.localeCompare(b.name))
+
+// GOOD: creates new array
+const sorted = users.toSorted((a, b) => a.name.localeCompare(b.name))
+```
+
+### 7.3 Early Return from Functions
+
+```typescript
+// BAD: processes all items after finding error
+function validateUsers(users: User[]) {
+  let hasError = false
+  for (const user of users) {
+    if (!user.email) hasError = true
+  }
+  return hasError ? { valid: false } : { valid: true }
+}
+
+// GOOD: returns immediately on first error
+function validateUsers(users: User[]) {
+  for (const user of users) {
+    if (!user.email) return { valid: false, error: 'Email required' }
+  }
+  return { valid: true }
+}
+```
+
+---
+
+## 8. Advanced Patterns
+
+**Impact: LOW**
+
+### 8.1 useEffectEvent for Stable Callbacks
+
+```tsx
+import { useEffectEvent } from 'react'
+
+function useWindowEvent(event: string, handler: () => void) {
+  const onEvent = useEffectEvent(handler)
+  useEffect(() => {
+    window.addEventListener(event, onEvent)
+    return () => window.removeEventListener(event, onEvent)
+  }, [event])
+}
+```
+
+---
+
+## Checklist Before Implementation
+
+- [ ] Independent async operations use Promise.all()
+- [ ] Heavy components use dynamic imports
+- [ ] RSC boundaries pass only needed fields
+- [ ] Suspense boundaries isolate data fetching
+- [ ] No barrel file imports for large libraries
+- [ ] State updates use functional form when depending on current state
+- [ ] Effects have narrow dependencies
+- [ ] Repeated lookups use Set/Map
+
+---
+
+## References
+
+- [React Documentation](https://react.dev)
+- [Next.js Documentation](https://nextjs.org)
+- [SWR Documentation](https://swr.vercel.app)
+- [Vercel Blog: Package Import Optimization](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
+- [Vercel Blog: Dashboard Performance](https://vercel.com/blog/how-we-made-the-vercel-dashboard-twice-as-fast)

.agents/skills/create-beads-orchestration/templates/skills/subagents-discipline/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: subagents-discipline
+description: Core engineering principles for implementation tasks
+---
+
+# Implementation Principles
+
+## Rule 0: Read the Bead First
+
+Before implementing anything, **read the bead comments** for context:
+
+```bash
+bd show {BEAD_ID}
+bd comments {BEAD_ID}
+```
+
+The orchestrator's dispatch prompt is automatically logged as a DISPATCH comment on the bead. This contains:
+- The investigation findings
+- Root cause analysis (file, function, line)
+- Related files that may need changes
+- Gotchas and edge cases
+
+**Use this context.** Don't re-investigate. The comments contain everything you need to implement confidently.
+
+If no dispatch or context comments exist, ask the orchestrator to provide context before proceeding.
+
+---
+
+## Rule 1: Look Before You Code
+
+Before writing code that touches external data (API, database, file, config):
+
+1. **Fetch/read the ACTUAL data** - run the command, see the output
+2. **Note exact field names, types, formats** - not what docs say, what you SEE
+3. **Code against what you observed** - not what you assumed
+
+```
+WITHOUT looking first:
+  Assumed: column is "reference_images"
+  Reality: column is "reference_image_url"
+  Result:  Query fails
+
+WITH looking first:
+  Ran: SELECT column_name FROM information_schema.columns WHERE table_name = 'assets';
+  Saw: reference_image_url
+  Coded against: reference_image_url
+  Result: Works
+```
+
+## Rule 2: Test Functionally (Close the Loop)
+
+**Principle: Optimize for the fastest way to verify your work actually works.**
+
+| You built | Fast verification | Slower alternative |
+|-----------|------------------|--------------------|
+| API endpoint | `curl` the endpoint, check response | Write integration test |
+| Database change | Run migration, query the result | Write migration test |
+| Frontend component | Load in browser, interact with it | Write component test |
+| CLI tool | Run the command, check output | Write unit test |
+| Config change | Restart service, verify behavior | N/A — just verify |
+
+**Two strategies:**
+
+1. **User Journey Tests** — Test actual behavior as a user experiences it:
+   ```bash
+   # API: curl with real data
+   curl -X POST localhost:3000/api/users -d '{"name":"test"}' -H "Content-Type: application/json"
+
+   # CLI: run the command
+   bd create "Test" -d "Testing" && bd list
+
+   # Error case: curl with invalid auth
+   curl -X POST localhost:3000/api/users -H "Authorization: Bearer invalid"
+   ```
+
+2. **Component Tests** — Supplement for regression prevention when fast verification isn't possible:
+   - Complex logic with many edge cases
+   - Code that runs in environments you can't easily replicate
+   - Shared libraries used by multiple consumers
+
+**"Close the Loop" principle:** Run the actual thing. Verify it works. Check error cases.
+
+Good: "Curled endpoint with invalid auth, got 401 as expected"
+Bad: "Wrote tests, they compile"
+
+## Rule 3: Use Your Tools
+
+Before claiming you can't fully test:
+
+1. **Check what MCP servers you have access to** - list available tools
+2. **If any tool can help verify the feature works**, use it
+3. **Be resourceful** - browser automation, database inspection, API testing tools
+
+## Rule 4: Log Your Approach (Optional)
+
+If you deviated from the orchestrator's suggestion, found a better path, or made a choice future maintainers might question:
+
+```bash
+bd comment {BEAD_ID} "APPROACH: Used X instead of Y because Z"
+```
+
+When to log:
+- Deviated from the suggested fix
+- Multiple valid solutions, chose one for a specific reason
+- Future maintainers might question the approach
+
+Skip if the code is self-explanatory. This is not enforced.
+
+---
+
+## For Epic Children
+
+If your BEAD_ID contains a dot (e.g., BD-001.2), you're implementing part of a larger feature:
+
+1. **Check for design doc**: `bd show {EPIC_ID} --json | jq -r '.[0].design'`
+2. **Read it if it exists** - this is your contract
+3. **Match it exactly** - same field names, same types, same shapes
+
+---
+
+## Red Flags - Stop and Verify
+
+When you catch yourself thinking:
+- "This should work..." → run it and see
+- "I assume the field is..." → look at the actual data
+- "I'll test it later..." → test it now
+- "It's too simple to break..." → verify anyway

.agents/skills/create-beads-orchestration/templates/ui-constraints.md

@@ -0,0 +1,76 @@
+# UI Constraints
+
+Apply these opinionated constraints when building interfaces.
+
+## Stack
+
+- MUST use Tailwind CSS defaults unless custom values already exist or are explicitly requested
+- MUST use `motion/react` (formerly `framer-motion`) when JavaScript animation is required
+- SHOULD use `tw-animate-css` for entrance and micro-animations in Tailwind CSS
+- MUST use `cn` utility (`clsx` + `tailwind-merge`) for class logic
+
+## Components
+
+- MUST use accessible component primitives for anything with keyboard or focus behavior (`Base UI`, `React Aria`, `Radix`)
+- MUST use the project's existing component primitives first
+- NEVER mix primitive systems within the same interaction surface
+- SHOULD prefer [`Base UI`](https://base-ui.com/react/components) for new primitives if compatible with the stack
+- MUST add an `aria-label` to icon-only buttons
+- NEVER rebuild keyboard or focus behavior by hand unless explicitly requested
+
+## Interaction
+
+- MUST use an `AlertDialog` for destructive or irreversible actions
+- SHOULD use structural skeletons for loading states
+- NEVER use `h-screen`, use `h-dvh`
+- MUST respect `safe-area-inset` for fixed elements
+- MUST show errors next to where the action happens
+- NEVER block paste in `input` or `textarea` elements
+
+## Animation
+
+- NEVER add animation unless it is explicitly requested
+- MUST animate only compositor props (`transform`, `opacity`)
+- NEVER animate layout properties (`width`, `height`, `top`, `left`, `margin`, `padding`)
+- SHOULD avoid animating paint properties (`background`, `color`) except for small, local UI (text, icons)
+- SHOULD use `ease-out` on entrance
+- NEVER exceed `200ms` for interaction feedback
+- MUST pause looping animations when off-screen
+- SHOULD respect `prefers-reduced-motion`
+- NEVER introduce custom easing curves unless explicitly requested
+- SHOULD avoid animating large images or full-screen surfaces
+
+## Typography
+
+- MUST use `text-balance` for headings and `text-pretty` for body/paragraphs
+- MUST use `tabular-nums` for data
+- SHOULD use `truncate` or `line-clamp` for dense UI
+- NEVER modify `letter-spacing` (`tracking-*`) unless explicitly requested
+
+## Layout
+
+- MUST use a fixed `z-index` scale (no arbitrary `z-*`)
+- SHOULD use `size-*` for square elements instead of `w-*` + `h-*`
+
+## Performance
+
+- NEVER animate large `blur()` or `backdrop-filter` surfaces
+- NEVER apply `will-change` outside an active animation
+- NEVER use `useEffect` for anything that can be expressed as render logic
+
+## Design
+
+- NEVER use gradients unless explicitly requested
+- NEVER use purple or multicolor gradients
+- NEVER use glow effects as primary affordances
+- SHOULD use Tailwind CSS default shadow scale unless explicitly requested
+- MUST give empty states one clear next action
+- SHOULD limit accent color usage to one per view
+- SHOULD use existing theme or Tailwind CSS color tokens before introducing new ones
+
+## Accessibility
+
+- MUST meet WCAG AA color contrast (4.5:1 for text, 3:1 for large text/UI)
+- MUST ensure all interactive elements are keyboard accessible
+- SHOULD provide visible focus indicators
+- MUST use semantic HTML elements where appropriate

.agents/skills/create-beads-orchestration/tests/test-validate-epic-close.sh

@@ -0,0 +1,192 @@
+#!/bin/bash
+# Tests for templates/hooks/validate-epic-close.sh
+# Focuses on the epic children validation (CHECK 2)
+# Mocks bd, git, and gh to isolate the hook logic
+
+set -euo pipefail
+
+HOOK="$(cd "$(dirname "$0")/.." && pwd)/templates/hooks/validate-epic-close.sh"
+PASS=0
+FAIL=0
+MOCK_DIR=""
+
+setup_mock_dir() {
+  MOCK_DIR=$(mktemp -d)
+  # Mock git to skip CHECK 1 (return empty for remote URL)
+  cat > "$MOCK_DIR/git" << 'MOCKGIT'
+#!/bin/bash
+echo ""
+MOCKGIT
+  chmod +x "$MOCK_DIR/git"
+
+  # Mock gh (should never be reached, but just in case)
+  cat > "$MOCK_DIR/gh" << 'MOCKGH'
+#!/bin/bash
+echo ""
+MOCKGH
+  chmod +x "$MOCK_DIR/gh"
+}
+
+cleanup() {
+  [ -n "$MOCK_DIR" ] && rm -rf "$MOCK_DIR"
+}
+trap cleanup EXIT
+
+run_hook() {
+  local tool_input="$1"
+  CLAUDE_TOOL_INPUT="$tool_input" PATH="$MOCK_DIR:$PATH" bash "$HOOK" 2>/dev/null
+}
+
+assert_allowed() {
+  local test_name="$1"
+  local tool_input="$2"
+  local output
+  local exit_code
+
+  output=$(run_hook "$tool_input") && exit_code=0 || exit_code=$?
+
+  if [ "$exit_code" -eq 0 ] && ! echo "$output" | grep -q '"deny"'; then
+    echo "PASS: $test_name"
+    PASS=$((PASS + 1))
+  else
+    echo "FAIL: $test_name (expected: allowed, got exit=$exit_code, output=$output)"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_denied() {
+  local test_name="$1"
+  local tool_input="$2"
+  local expected_fragment="${3:-}"
+  local output
+  local exit_code
+
+  output=$(run_hook "$tool_input") && exit_code=0 || exit_code=$?
+
+  if echo "$output" | grep -q '"deny"'; then
+    if [ -n "$expected_fragment" ] && ! echo "$output" | grep -q "$expected_fragment"; then
+      echo "FAIL: $test_name (denied but missing expected text: $expected_fragment)"
+      FAIL=$((FAIL + 1))
+    else
+      echo "PASS: $test_name"
+      PASS=$((PASS + 1))
+    fi
+  else
+    echo "FAIL: $test_name (expected: denied, got exit=$exit_code, output=$output)"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# ---- Test 1: Non-bd-close command ----
+test_non_bd_close() {
+  setup_mock_dir
+  assert_allowed "Non-bd-close command is allowed" '{"command":"echo hello"}'
+}
+
+# ---- Test 2: bd close with --force ----
+test_force_override() {
+  setup_mock_dir
+  # bd mock not needed — hook exits before calling bd
+  assert_allowed "bd close --force is allowed" '{"command":"bd close BD-001 --force"}'
+}
+
+# ---- Test 3: Standalone bead (issue_type=task) ----
+test_standalone_task() {
+  setup_mock_dir
+  cat > "$MOCK_DIR/bd" << 'MOCKBD'
+#!/bin/bash
+if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
+  echo '[{"id":"BD-001","issue_type":"task","status":"in_progress"}]'
+elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
+  echo '[{"id":"BD-001","issue_type":"task","status":"in_progress"}]'
+fi
+MOCKBD
+  chmod +x "$MOCK_DIR/bd"
+
+  assert_allowed "Standalone task is allowed to close" '{"command":"bd close BD-001"}'
+}
+
+# ---- Test 4: Epic with all children done ----
+test_epic_all_done() {
+  setup_mock_dir
+  cat > "$MOCK_DIR/bd" << 'MOCKBD'
+#!/bin/bash
+if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
+  echo '[{"id":"BD-010","issue_type":"epic","status":"in_progress"}]'
+elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
+  echo '[
+    {"id":"BD-010","issue_type":"epic","status":"in_progress"},
+    {"id":"BD-010.1","issue_type":"task","status":"done"},
+    {"id":"BD-010.2","issue_type":"task","status":"done"},
+    {"id":"BD-010.3","issue_type":"task","status":"closed"}
+  ]'
+fi
+MOCKBD
+  chmod +x "$MOCK_DIR/bd"
+
+  assert_allowed "Epic with all children done/closed is allowed" '{"command":"bd close BD-010"}'
+}
+
+# ---- Test 5: Epic with children in inreview ----
+test_epic_children_inreview() {
+  setup_mock_dir
+  cat > "$MOCK_DIR/bd" << 'MOCKBD'
+#!/bin/bash
+if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
+  echo '[{"id":"BD-020","issue_type":"epic","status":"in_progress"}]'
+elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
+  echo '[
+    {"id":"BD-020","issue_type":"epic","status":"in_progress"},
+    {"id":"BD-020.1","issue_type":"task","status":"done"},
+    {"id":"BD-020.2","issue_type":"task","status":"inreview"},
+    {"id":"BD-020.3","issue_type":"task","status":"inreview"}
+  ]'
+fi
+MOCKBD
+  chmod +x "$MOCK_DIR/bd"
+
+  assert_denied "Epic with inreview children is denied" \
+    '{"command":"bd close BD-020"}' \
+    "incomplete children"
+}
+
+# ---- Test 6: Epic with mixed statuses ----
+test_epic_mixed_statuses() {
+  setup_mock_dir
+  cat > "$MOCK_DIR/bd" << 'MOCKBD'
+#!/bin/bash
+if [ "$1" = "show" ] && [ "$3" = "--json" ]; then
+  echo '[{"id":"BD-030","issue_type":"epic","status":"in_progress"}]'
+elif [ "$1" = "list" ] && [ "$2" = "--json" ]; then
+  echo '[
+    {"id":"BD-030","issue_type":"epic","status":"in_progress"},
+    {"id":"BD-030.1","issue_type":"task","status":"done"},
+    {"id":"BD-030.2","issue_type":"task","status":"inreview"},
+    {"id":"BD-030.3","issue_type":"task","status":"in_progress"}
+  ]'
+fi
+MOCKBD
+  chmod +x "$MOCK_DIR/bd"
+
+  assert_denied "Epic with mixed statuses is denied" \
+    '{"command":"bd close BD-030"}' \
+    "incomplete children"
+}
+
+# ---- Run all tests ----
+echo "=== validate-epic-close.sh tests ==="
+echo ""
+
+test_non_bd_close
+test_force_override
+test_standalone_task
+test_epic_all_done
+test_epic_children_inreview
+test_epic_mixed_statuses
+
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+
+if [ "$FAIL" -gt 0 ]; then
+  exit 1
+fi