dr-eamer-ai-shared 1.0.0__tar.gz

dr_eamer_ai_shared-1.0.0/CLAUDE.md

@@ -0,0 +1,353 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+The `/home/coolhand/shared` directory is a comprehensive Python library providing reusable AI development infrastructure. It's designed to be imported by multiple projects and contains:
+
+- **LLM Provider Abstraction**: Unified interface for 10+ AI providers (OpenAI, Anthropic, xAI, Mistral, Cohere, Gemini, etc.)
+- **Orchestration Framework**: BaseOrchestrator pattern for building multi-agent workflows with streaming support
+- **MCP Server Infrastructure**: Model Context Protocol servers exposing tools, resources, and orchestration capabilities
+- **Data Fetching Clients**: Structured clients for ArXiv, Census, GitHub, NASA, News APIs, Semantic Scholar, Wikipedia, YouTube, and more
+- **Document Generation**: PDF, DOCX, and Markdown output with professional formatting
+- **Configuration Management**: Multi-source config loading (defaults, config files, .env, environment variables)
+- **Utilities**: Vision (image analysis), TTS, document parsers, async adapters, time utilities, validation
+
+This library is published as `dr-eamer-ai-shared` and follows the naming convention "Dreamwalker" for orchestration tools.
+
+## Key Architecture
+
+### LLM Providers (`llm_providers/`)
+
+All providers implement `BaseLLMProvider` with standardized methods:
+- `complete()`: Generate completions
+- `stream_complete()`: Stream completions
+- `generate_image()`: Image generation (OpenAI, xAI)
+- `analyze_image()`: Vision capabilities (OpenAI, Anthropic, xAI, Gemini)
+
+Use `ProviderFactory` to instantiate providers:
+```python
+from llm_providers import ProviderFactory
+
+provider = ProviderFactory.create_provider(
+    provider_name='xai',  # or 'openai', 'anthropic', etc.
+    api_key='your-key',
+    model='grok-3'
+)
+
+response = provider.complete(messages=[...])
+```
+
+**Complexity Router**: `complexity_router.py` implements automatic provider selection based on task complexity (uses cheaper models for simple tasks, expensive models for complex ones).
+
+### Orchestration Framework (`orchestration/`)
+
+Build multi-agent workflows by extending `BaseOrchestrator`:
+
+**Required Methods:**
+1. `decompose_task()`: Break task into subtasks
+2. `execute_subtask()`: Execute individual subtasks
+3. `synthesize_results()`: Combine results into final output
+
+**Built-in Orchestrators:**
+- `DreamCascadeOrchestrator`: Hierarchical research (Belter → Drummer → Camina tiers)
+- `DreamSwarmOrchestrator`: Multi-domain parallel search
+- `SequentialOrchestrator`: Staged execution with per-step handlers
+- `ConditionalOrchestrator`: Runtime branch selection
+- `IterativeOrchestrator`: Looped refinement until success predicate
+
+**Streaming Support**: All orchestrators emit `StreamEvent` objects for real-time progress tracking via SSE/webhooks.
+
+**Document Generation**: Automatic PDF/DOCX/Markdown generation with configurable templates.
+
+### MCP Server (`mcp/`)
+
+The Model Context Protocol server exposes orchestrator agents and utilities:
+
+**Main Server**: `unified_server.py` - Comprehensive MCP server with tools and resources
+**Tools Exposed**:
+- `dream_research`: Execute Dream Cascade workflow
+- `dream_search`: Execute Dream Swarm workflow
+- `dreamwalker_status`: Check workflow status
+- `dreamwalker_cancel`: Cancel running workflow
+- `dreamwalker_patterns`: List orchestrator patterns
+- `dreamwalker_list_tools`: List registered tools
+- `dreamwalker_execute_tool`: Execute a registered tool
+
+**Resources Exposed**:
+- `orchestrator://{pattern}/info`: Orchestrator metadata
+- `orchestrator://{task_id}/status`: Workflow status
+- `orchestrator://{task_id}/results`: Workflow results
+
+**Streaming**: SSE endpoint at `/stream/{task_id}` for real-time updates
+
+**Other Servers**:
+- `providers_server.py`: LLM provider discovery and invocation
+- `data_server.py`: Data fetching client tools
+- `cache_server.py`: Redis-based caching
+- `utility_server.py`: General utilities
+- `web_search_server.py`: Web search integration
+
+**Running MCP Server**:
+```bash
+cd /home/coolhand/shared/mcp
+python unified_server.py
+# Serves at http://localhost:5060
+```
+
+### Data Fetching (`data_fetching/`)
+
+Structured API clients with consistent error handling:
+- `arxiv_client.py`: Academic paper search
+- `census_client.py`: US Census data
+- `github_client.py`: GitHub repository/user data
+- `nasa_client.py`: NASA imagery and data
+- `news_client.py`: News articles via NewsAPI
+- `semantic_scholar.py`: Academic citations and papers
+- `wikipedia_client.py`: Wikipedia content
+- `youtube_client.py`: YouTube video metadata
+- `fec_client.py`: Federal Election Commission data
+- `judiciary_client.py`: Court records
+- `mal_client.py`: MyAnimeList data
+
+Use `ClientFactory` for instantiation:
+```python
+from data_fetching import ClientFactory
+
+client = ClientFactory.create_client('arxiv', api_key='optional')
+results = client.search(query='quantum computing', max_results=10)
+```
+
+### Configuration (`config.py`)
+
+Multi-source configuration with clear precedence:
+1. Default values
+2. Custom config file (e.g., `.myapp`)
+3. `.env` file
+4. Environment variables
+5. Command-line arguments
+
+```python
+from config import ConfigManager
+
+config = ConfigManager(
+    app_name='myapp',
+    defaults={'MODEL': 'grok-3', 'PROVIDER': 'xai'}
+)
+
+model = config.get('MODEL')
+api_key = config.get_api_key('xai')
+available = config.list_available_providers()
+```
+
+### Web Interface (`web/dreamwalker/`)
+
+Flask control panel for MCP orchestrator:
+- Dashboard for health, tools, resources
+- Launch workflows with custom parameters
+- SSE proxy for browser-based streaming
+- REST API for orchestration management
+
+**Running Dreamwalker**:
+```bash
+export MCP_BASE_URL=http://localhost:5060
+python -m web.dreamwalker.app
+# Serves at http://localhost:5000
+```
+
+## Common Development Tasks
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run specific test file
+pytest tests/test_orchestrators.py
+
+# Run with verbose output
+pytest -v
+
+# Run with coverage
+pytest --cov=. --cov-report=html
+```
+
+### Building and Installing
+
+```bash
+# Install in editable mode (for development)
+pip install -e .
+
+# Install with all optional dependencies
+pip install -e .[all]
+
+# Install specific provider dependencies
+pip install -e .[anthropic,openai,xai]
+
+# Build distribution packages
+python setup.py sdist bdist_wheel
+```
+
+### Using Shared Components in Other Projects
+
+```python
+# In another project, reference shared library
+import sys
+sys.path.insert(0, '/home/coolhand/shared')
+
+# Or install as package
+pip install -e /home/coolhand/shared
+
+# Then import normally
+from llm_providers import ProviderFactory
+from orchestration import DreamCascadeOrchestrator
+from config import ConfigManager
+from data_fetching import ClientFactory
+```
+
+### Creating Custom Orchestrators
+
+1. Extend `BaseOrchestrator`
+2. Implement 3 required methods: `decompose_task()`, `execute_subtask()`, `synthesize_results()`
+3. Configure with `OrchestratorConfig` or create custom config class
+4. Use built-in helpers: `_execute_agents_parallel()`, `_emit_event()`, `_generate_documents()`
+
+See `orchestration/templates/orchestrator_template.py` for boilerplate.
+
+Reference `ORCHESTRATOR_GUIDE.md` for detailed implementation guide.
+
+## Important Conventions
+
+### Naming Conventions
+- **"Dreamwalker"** is the public-facing name for orchestration tools and MCP servers
+- **"Dream Cascade"** refers to hierarchical research orchestrators (formerly "Beltalowda")
+- **"Dream Swarm"** refers to multi-domain search orchestrators
+- Internal code may use legacy names (`BeltalowdaOrchestrator`, `SwarmOrchestrator`) but these are aliased to new names
+
+### Code Style
+- All code credits Luke Steuber as author
+- Use first person ("I") in documentation, not "we"
+- No "Created with Claude" or similar AI attribution comments
+- Type hints required for public APIs
+- Docstrings required for all public functions/classes
+
+### API Keys and Secrets
+- Store in `/home/coolhand/API_KEYS.md` (referenced by global CLAUDE.md)
+- Never commit API keys to version control
+- Use `ConfigManager` to load keys from environment/config files
+- Keys are masked when displayed via `config.as_dict(mask_secrets=True)`
+
+### Port Allocation
+- MCP server: `5060`
+- Dreamwalker UI: `5080` (when managed by service_manager)
+- Development testing: `5010-5019`, `5050-5059`
+- Caddy reverse proxy handles `/5010-5019` → `localhost:5010-5019`
+
+### File Organization
+- Shared components go in `/home/coolhand/shared`
+- Tests go in `tests/` directory
+- MCP servers in `mcp/` subdirectory
+- Documentation (guides, benchmarks) in root or relevant subdirectory
+
+## Dependencies
+
+### Core Dependencies
+- `python-dotenv>=1.0.0`: Environment variable loading
+- `requests>=2.32.5`: HTTP client (security patched)
+- `pillow>=11.0.0`: Image processing
+- `aiohttp>=3.12.14`: Async HTTP operations
+
+### Provider-Specific (Optional)
+Install only what you need via extras:
+- `anthropic`: Claude models
+- `openai`: GPT models, DALL-E, Whisper
+- `xai`: Grok models (uses OpenAI-compatible API)
+- `mistral`: Mistral models
+- `cohere`: Cohere models
+- `gemini`: Google Gemini models
+- `huggingface`: HuggingFace models
+
+### MCP Server Dependencies
+- `flask>=3.0.0`, `flask-cors>=4.0.0`: Web framework
+- `gunicorn>=21.0.0`: Production WSGI server
+- `gevent>=24.0.0`: Async worker support (greenlet-based)
+
+### Document Generation (Optional)
+- `reportlab>=4.0.0`: PDF generation
+- `python-docx>=1.0.0`: DOCX generation
+
+## Integration with Main System
+
+This shared library is part of a larger ecosystem:
+- **Server**: dr.eamer.dev, d.reamwalker.com, d.reamwalk.com
+- **Web Root**: `/home/coolhand/html`
+- **Service Manager**: `/home/coolhand/service_manager.py` manages services
+- **Caddy Config**: `/etc/caddy/Caddyfile` for reverse proxy
+- **Projects Directory**: Other projects import from this shared library
+
+When making changes that affect other projects, test integration points:
+1. Verify imports work from external projects
+2. Check MCP server endpoints are accessible
+3. Ensure Dreamwalker UI connects to MCP server correctly
+4. Validate service_manager can start/stop services
+
+## Troubleshooting
+
+### Import Errors
+If imports fail, ensure:
+1. `sys.path.insert(0, '/home/coolhand/shared')` is called before imports
+2. Or install package: `pip install -e /home/coolhand/shared`
+3. Check for circular imports in module structure
+
+### API Provider Issues
+If provider calls fail:
+1. Verify API key is set: `config.has_api_key('provider_name')`
+2. Check provider is available: `config.list_available_providers()`
+3. Install provider extras: `pip install -e .[provider_name]`
+4. Check `/home/coolhand/API_KEYS.md` for key configuration
+
+### MCP Server Not Starting
+1. Check port 5060 is available: `sudo lsof -i :5060`
+2. Verify dependencies installed: `pip install -r mcp/requirements.txt`
+3. Check logs for import errors or missing API keys
+4. Ensure `/home/coolhand/shared` is in PYTHONPATH
+
+### Orchestrator Execution Failures
+1. Verify LLM provider is configured and has API key
+2. Check task complexity matches model capabilities
+3. Review streaming events for error details
+4. Enable debug logging: `logging.basicConfig(level=logging.DEBUG)`
+
+## Testing Philosophy
+
+- Write tests for public APIs and orchestrator workflows
+- Mock external API calls (don't hit real APIs in tests)
+- Test configuration loading from multiple sources
+- Validate streaming event emission
+- Test error handling and graceful degradation
+- Use pytest fixtures for common setup
+
+## Documentation
+
+Key documentation files in this repository:
+- `ORCHESTRATOR_GUIDE.md`: Building custom orchestrators
+- `ORCHESTRATOR_SELECTION_GUIDE.md`: Choosing the right pattern
+- `ORCHESTRATOR_BENCHMARKS.md`: Performance characteristics
+- Sample workflows in `orchestration/templates/`
+
+Web-based documentation:
+- Generated docs at `https://dr.eamer.dev/shared/`
+- Tool catalog and API reference in Dreamwalker UI
+
+## Version Control
+
+This library is part of a monorepo at `https://github.com/lukeslp/kernel`
+
+When committing changes:
+1. Add and commit every 1.5 hours during active development
+2. Write clear commit messages describing "why" not just "what"
+3. Use format: `type(scope): message` (e.g., `feat(orchestration): add conditional orchestrator`)
+4. Test changes before committing: `pytest`
+5. Update CLAUDE.md when making architectural changes

dr_eamer_ai_shared-1.0.0/DOCUMENTATION_RECOMMENDATIONS.md

@@ -0,0 +1,291 @@
+# Documentation Audit & Recommendations
+
+**Date**: November 20, 2025
+**Status**: Documentation cleanup after Dreamwalker naming convention migration
+
+---
+
+## Current State
+
+### ✅ Documentation that EXISTS and should KEEP
+
+**In Repository:**
+1. **CLAUDE.md** (NEW) - Comprehensive codebase guide for Claude Code
+2. **orchestration/ORCHESTRATOR_GUIDE.md** - Building custom orchestrators
+3. **orchestration/ORCHESTRATOR_SELECTION_GUIDE.md** - Decision matrices
+4. **orchestration/ORCHESTRATOR_BENCHMARKS.md** - Performance data
+
+**As HTML (in /home/coolhand/html/shared/):**
+1. **agents.html** - Agent catalog
+2. **status.html** - Project status tracker
+3. **tools-index.html** - Tool registry
+4. **claude-code-integration.html** - Claude Code setup
+5. **dreamwalker-naming-guide.html** - Naming conventions
+
+---
+
+## 📁 DELETED Documentation (Git shows "D")
+
+### ⭐ HIGH VALUE - Should RESTORE or RECREATE
+
+#### 1. **README.md** (CRITICAL)
+**Status**: Deleted but had comprehensive overview
+**Recommendation**: **CREATE NEW** using content from git history
+**Why**: Essential for GitHub/PyPI visibility, onboarding new developers
+
+**Suggested Content:**
+- Project overview and purpose
+- Quick installation (`pip install -e .`)
+- Simple usage examples for each major component
+- Link to CLAUDE.md for detailed architecture
+- Link to orchestration guides
+- Contribution guidelines
+- License (MIT)
+
+#### 2. **LLM_PROVIDER_MATRIX.md**
+**Status**: Deleted, contained provider capability matrix
+**Recommendation**: **RESTORE as HTML** at `/home/coolhand/html/shared/provider-matrix.html`
+**Why**: User requested documentation be HTML not MD for mobile reference
+**Content**: Provider comparison table, capabilities, model lists, test results
+
+#### 3. **DATA_FETCHING_GUIDE.md**
+**Status**: Deleted, contained comprehensive guide to data clients
+**Recommendation**: **RESTORE as HTML** at `/home/coolhand/html/shared/data-fetching.html`
+**Why**: 12+ data sources need clear documentation for discovery
+**Content**: Client usage, factory patterns, API key requirements, examples
+
+#### 4. **IMAGE_VISION_GUIDE.md**
+**Status**: Deleted, contained vision/image gen guide
+**Recommendation**: **RESTORE as HTML** at `/home/coolhand/html/shared/vision-guide.html`
+**Why**: Vision and image generation are key features
+**Content**: Provider comparison, usage examples, capabilities matrix
+
+---
+
+### 🗄️ MEDIUM VALUE - Archive to HTML or Integrate
+
+#### 5. **MCP Documentation** (Multiple files deleted)
+**Files**:
+- mcp/README.md
+- mcp/QUICK_START.md
+- mcp/API.md
+- mcp/EXAMPLES.md
+- mcp/INDEX.md
+
+**Recommendation**: **CONSOLIDATE to single HTML** at `/home/coolhand/html/shared/mcp-guide.html`
+**Why**: MCP server is core functionality, needs comprehensive single-page reference
+**Content**: Server overview, tool catalog, resource catalog, streaming API, deployment
+
+#### 6. **Integration & Setup Guides**
+**Files**:
+- mcp/CLAUDE_CODE_SETUP.md
+- mcp/CURSOR_SETUP_INSTRUCTIONS.md
+- mcp/APP_INTEGRATION_GUIDE.md
+
+**Recommendation**: **CONSOLIDATE** into existing `/home/coolhand/html/shared/claude-code-integration.html`
+**Why**: Already have HTML for this, just need to ensure comprehensive
+
+---
+
+### ❌ LOW VALUE - Can ARCHIVE or DELETE
+
+#### 7. **Status Reports** (Obsolete)
+**Files**:
+- COMPLETION_SUMMARY.md
+- CONSOLIDATION_REPORT.md
+- ENHANCEMENT_SUMMARY.md
+- IMPROVEMENT_SUMMARY.md
+- MIGRATION_SUMMARY.md
+- EXTRACTION_SUMMARY.md
+
+**Recommendation**: **ARCHIVE** to `.backups/documentation_archive_YYYYMMDD/`
+**Why**: Historical record, but not needed for active development
+**Action**: Move to archive, not in repo
+
+#### 8. **Analysis/Audit Reports** (Obsolete)
+**Files**:
+- CODE_QUALITY_INDEX.md
+- LOW_HANGING_FRUIT_ANALYSIS.md
+- SHARED_COMPONENTS_CATALOG.md
+- SHARED_USAGE_AUDIT.md
+- TOOL_CAPABILITIES_AUDIT.md
+
+**Recommendation**: **ARCHIVE** to `.backups/documentation_archive_YYYYMMDD/`
+**Why**: Point-in-time analysis, superseded by current code state
+
+#### 9. **Implementation/Planning Docs** (Obsolete)
+**Files**:
+- QUICK_WINS_CHECKLIST.md
+- QUICK_WINS_IMPLEMENTATION.md
+- MIGRATION_GUIDE.md
+- MIGRATION_TARGETS.md
+- MCP_IMPLEMENTATION.md
+- MCP_SERVER_CONCEPT.md
+
+**Recommendation**: **ARCHIVE**
+**Why**: Implementation complete, historical interest only
+
+#### 10. **Integration Experiments** (Obsolete)
+**Files**:
+- COZE_AGENTS_EVALUATION.md
+- COZE_INTEGRATION_EXAMPLES.md
+- HYBRID_WORKFLOW.md
+
+**Recommendation**: **DELETE** or **ARCHIVE** if any contain useful patterns
+**Why**: Experimental, likely superseded by current implementation
+
+#### 11. **Detailed Implementation Docs** (Redundant)
+**Files**:
+- INTEGRATION_ARCHITECTURE_REPORT.md
+- DEPLOYMENT_VERIFIED.md (mcp/)
+- PRODUCTION_DEPLOYMENT_REVIEW.md (mcp/)
+- IMPLEMENTATION_SUMMARY.md (mcp/)
+
+**Recommendation**: **DELETE** - Info now in CLAUDE.md
+**Why**: Architecture now documented in CLAUDE.md
+
+---
+
+## 📋 Action Plan
+
+### Phase 1: Critical Documentation (DO NOW)
+
+1. **Create README.md**
+   ```bash
+   git show HEAD:README.md > /tmp/old_readme.md
+   # Review and create new README.md with essential info
+   ```
+
+2. **Restore provider matrix as HTML**
+   ```bash
+   git show HEAD:LLM_PROVIDER_MATRIX.md > /tmp/provider_matrix.md
+   # Convert to HTML at /home/coolhand/html/shared/provider-matrix.html
+   ```
+
+3. **Restore data fetching guide as HTML**
+   ```bash
+   git show HEAD:DATA_FETCHING_GUIDE.md > /tmp/data_guide.md
+   # Convert to HTML at /home/coolhand/html/shared/data-fetching.html
+   ```
+
+4. **Restore vision guide as HTML**
+   ```bash
+   git show HEAD:IMAGE_VISION_GUIDE.md > /tmp/vision_guide.md
+   # Convert to HTML at /home/coolhand/html/shared/vision-guide.html
+   ```
+
+### Phase 2: Consolidate MCP Docs (NEXT)
+
+5. **Create comprehensive MCP guide HTML**
+   ```bash
+   # Combine mcp/README.md, QUICK_START.md, API.md, EXAMPLES.md
+   # Output: /home/coolhand/html/shared/mcp-guide.html
+   ```
+
+6. **Update claude-code-integration.html**
+   ```bash
+   # Merge setup instructions from deleted Cursor/Claude Code docs
+   ```
+
+### Phase 3: Archive Historical Docs (THEN)
+
+7. **Create archive directory**
+   ```bash
+   mkdir -p /home/coolhand/shared/.backups/documentation_archive_20251120
+   ```
+
+8. **Move obsolete docs to archive**
+   ```bash
+   # Use git show to extract old files and save to archive
+   # Keep in git history, just not active in repo
+   ```
+
+### Phase 4: Organize HTML Documentation (FINALLY)
+
+9. **Create documentation index**
+   ```bash
+   # Create /home/coolhand/html/shared/docs.html
+   # Central hub linking to all documentation
+   ```
+
+---
+
+## 🎯 Final Documentation Structure
+
+### In Repository (`/home/coolhand/shared/`)
+```
+shared/
+├── CLAUDE.md                          # Codebase guide for Claude Code
+├── README.md                          # Project overview (TO CREATE)
+├── LICENSE                            # MIT license
+├── setup.py                           # Package setup
+├── pyproject.toml                     # Modern Python packaging
+├── pytest.ini                         # Test configuration
+└── orchestration/
+    ├── ORCHESTRATOR_GUIDE.md          # Building custom orchestrators
+    ├── ORCHESTRATOR_SELECTION_GUIDE.md # Decision matrices
+    └── ORCHESTRATOR_BENCHMARKS.md     # Performance data
+```
+
+### As HTML (`/home/coolhand/html/shared/`)
+```
+html/shared/
+├── index.html                         # Documentation hub (TO CREATE)
+├── agents.html                        # Agent catalog ✅
+├── status.html                        # Project status ✅
+├── tools-index.html                   # Tool registry ✅
+├── provider-matrix.html               # LLM provider capabilities (TO CREATE)
+├── data-fetching.html                 # Data client guide (TO CREATE)
+├── vision-guide.html                  # Vision/Image gen guide (TO CREATE)
+├── mcp-guide.html                     # MCP server comprehensive guide (TO CREATE)
+├── claude-code-integration.html       # IDE setup ✅
+└── dreamwalker-naming-guide.html      # Naming conventions ✅
+```
+
+### Archived (`/home/coolhand/shared/.backups/`)
+```
+.backups/
+└── documentation_archive_20251120/
+    ├── status_reports/                # All *_SUMMARY.md files
+    ├── analysis_reports/              # All *_AUDIT.md, *_INDEX.md files
+    ├── implementation_plans/          # All *_GUIDE.md, *_IMPLEMENTATION.md
+    └── experiments/                   # COZE_*, HYBRID_*, etc.
+```
+
+---
+
+## 💡 Guidelines for Future Documentation
+
+### When to Use Markdown (in repo)
+- **CLAUDE.md**: Codebase architecture for AI assistants
+- **README.md**: Project overview and quick start
+- **Guides**: Step-by-step tutorials (orchestrator guides)
+- **Technical specs**: API contracts, data models
+
+### When to Use HTML (in /home/coolhand/html/shared/)
+- **Reference materials**: Matrices, catalogs, indexes
+- **Interactive docs**: Searchable tool lists, filterable tables
+- **Mobile-friendly**: User wants to reference on phone
+- **Rich formatting**: Code highlighting, collapsible sections
+- **Frequent updates**: Status trackers, dashboards
+
+### Documentation Principles
+1. **Single Source of Truth**: Don't duplicate content
+2. **Link Rather Than Copy**: Reference other docs
+3. **Keep It Current**: Delete obsolete docs, don't let them rot
+4. **Make It Discoverable**: Central index/hub
+5. **User-Focused**: What do developers need to know?
+
+---
+
+## Summary
+
+**Immediate Actions:**
+1. ✅ CLAUDE.md created
+2. ⏳ Create README.md from git history
+3. ⏳ Convert 3 key MD guides to HTML (provider matrix, data fetching, vision)
+4. ⏳ Consolidate MCP docs to single HTML
+5. ⏳ Archive obsolete status/analysis reports
+6. ⏳ Create documentation index hub
+
+**Result**: Clean, maintainable documentation structure optimized for reference on mobile, with clear separation between in-repo guides and web-based catalogs.

dr_eamer_ai_shared-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Luke Steuber
+
+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.