Metadata-Version: 2.4
Name: morpheus-libs
Version: 0.3.0
Summary: Morpheus framework - unified library package for AI-assisted development
Project-URL: Repository, https://github.com/pjsulin/morpheus
Author-email: Patrick <pjsulin@gmail.com>
License: MIT
Requires-Python: >=3.11
Requires-Dist: certifi>=2021.0.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: markdown-it-py>=3.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: structlog>=23.0.0
Requires-Dist: toml>=0.10.0
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: all
Requires-Dist: aiohttp>=3.8.0; extra == 'all'
Requires-Dist: anthropic>=0.25.0; extra == 'all'
Requires-Dist: chromadb>=0.4.0; extra == 'all'
Requires-Dist: docling>=0.1.0; extra == 'all'
Requires-Dist: faster-whisper>=0.10.0; extra == 'all'
Requires-Dist: google-genai>=1.0.0; extra == 'all'
Requires-Dist: litellm>=1.35.0; extra == 'all'
Requires-Dist: marker-pdf<1.7,>=1.6.0; extra == 'all'
Requires-Dist: markitdown>=0.0.1a; extra == 'all'
Requires-Dist: mypy>=1.5.0; extra == 'all'
Requires-Dist: openai>=1.0.0; extra == 'all'
Requires-Dist: opentelemetry-api>=1.15.0; extra == 'all'
Requires-Dist: opentelemetry-exporter-otlp>=1.15.0; extra == 'all'
Requires-Dist: pandas>=2.0.0; extra == 'all'
Requires-Dist: playwright>=1.40.0; extra == 'all'
Requires-Dist: pypandoc>=1.11; extra == 'all'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'all'
Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
Requires-Dist: pytest-mock>=3.10.0; extra == 'all'
Requires-Dist: pytest>=8.0.0; extra == 'all'
Requires-Dist: ruff>=0.1.0; extra == 'all'
Requires-Dist: scikit-learn>=1.3.0; extra == 'all'
Requires-Dist: sentence-transformers>=2.2.0; extra == 'all'
Requires-Dist: surya-ocr<0.14,>=0.13.0; extra == 'all'
Requires-Dist: tenacity>=8.0.0; extra == 'all'
Requires-Dist: tiktoken>=0.5.0; extra == 'all'
Requires-Dist: torch<2.7,>=2.5.0; extra == 'all'
Requires-Dist: transformers<4.52,>=4.45.0; extra == 'all'
Requires-Dist: tree-sitter-python>=0.20.0; extra == 'all'
Requires-Dist: tree-sitter>=0.20.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: documents-audio
Requires-Dist: faster-whisper>=0.10.0; extra == 'documents-audio'
Requires-Dist: markitdown>=0.0.1a; extra == 'documents-audio'
Provides-Extra: documents-docling
Requires-Dist: docling>=0.1.0; extra == 'documents-docling'
Provides-Extra: documents-full
Requires-Dist: docling>=0.1.0; extra == 'documents-full'
Requires-Dist: faster-whisper>=0.10.0; extra == 'documents-full'
Requires-Dist: marker-pdf<1.7,>=1.6.0; extra == 'documents-full'
Requires-Dist: markitdown>=0.0.1a; extra == 'documents-full'
Requires-Dist: pypandoc>=1.11; extra == 'documents-full'
Requires-Dist: surya-ocr<0.14,>=0.13.0; extra == 'documents-full'
Requires-Dist: torch<2.7,>=2.5.0; extra == 'documents-full'
Requires-Dist: transformers<4.52,>=4.45.0; extra == 'documents-full'
Provides-Extra: documents-marker
Requires-Dist: marker-pdf<1.7,>=1.6.0; extra == 'documents-marker'
Requires-Dist: surya-ocr<0.14,>=0.13.0; extra == 'documents-marker'
Requires-Dist: torch<2.7,>=2.5.0; extra == 'documents-marker'
Requires-Dist: transformers<4.52,>=4.45.0; extra == 'documents-marker'
Provides-Extra: documents-markitdown
Requires-Dist: markitdown>=0.0.1a; extra == 'documents-markitdown'
Provides-Extra: documents-pandoc
Requires-Dist: pypandoc>=1.11; extra == 'documents-pandoc'
Provides-Extra: learning
Requires-Dist: aiohttp>=3.8.0; extra == 'learning'
Requires-Dist: anthropic>=0.25.0; extra == 'learning'
Requires-Dist: litellm>=1.35.0; extra == 'learning'
Requires-Dist: openai>=1.0.0; extra == 'learning'
Requires-Dist: pandas>=2.0.0; extra == 'learning'
Requires-Dist: tenacity>=8.0.0; extra == 'learning'
Requires-Dist: tiktoken>=0.5.0; extra == 'learning'
Provides-Extra: llm
Requires-Dist: aiohttp>=3.8.0; extra == 'llm'
Requires-Dist: anthropic>=0.25.0; extra == 'llm'
Requires-Dist: litellm>=1.35.0; extra == 'llm'
Requires-Dist: openai>=1.0.0; extra == 'llm'
Requires-Dist: tenacity>=8.0.0; extra == 'llm'
Provides-Extra: llm-google
Requires-Dist: aiohttp>=3.8.0; extra == 'llm-google'
Requires-Dist: anthropic>=0.25.0; extra == 'llm-google'
Requires-Dist: google-genai>=1.0.0; extra == 'llm-google'
Requires-Dist: litellm>=1.35.0; extra == 'llm-google'
Requires-Dist: openai>=1.0.0; extra == 'llm-google'
Requires-Dist: tenacity>=8.0.0; extra == 'llm-google'
Provides-Extra: search
Requires-Dist: chromadb>=0.4.0; extra == 'search'
Requires-Dist: scikit-learn>=1.3.0; extra == 'search'
Requires-Dist: sentence-transformers>=2.2.0; extra == 'search'
Provides-Extra: telemetry-otel
Requires-Dist: opentelemetry-api>=1.15.0; extra == 'telemetry-otel'
Requires-Dist: opentelemetry-exporter-otlp>=1.15.0; extra == 'telemetry-otel'
Provides-Extra: validation
Requires-Dist: tree-sitter-python>=0.20.0; extra == 'validation'
Requires-Dist: tree-sitter>=0.20.0; extra == 'validation'
Provides-Extra: web
Requires-Dist: playwright>=1.40.0; extra == 'web'
Description-Content-Type: text/markdown

# Monorepo containing Morpheus, MAC, and CDG

## Components

### **Morpheus** - AI-First Development Framework
  - Standardized structure and code enforced rules to restrict your agents to known optimized processes
  - A core set of commonly used libraries, tools and agents in building LLM-based applications: llm proxy, document processing, vector search, etc.
  - A prompt optimization framework
  - Workflow-based context optimization system (80% token reduction)
  - Organizational standards (modes, workflows, observability) integrated from Organon project

**Contains:**
- `apps/` - User-facing applications
- `agents/` - AI agents and autonomous systems
- `tools/` - Development and deployment utilities (morpheus-cli, project-steward, document-store, codebase-scanner, search)
- `libs/` - Shared libraries and Python packages (LLM integration, document processing, telemetry)
- `templates/` - Project templates and workflow definitions for AI agents
- `admin/` - Framework management and maintenance
- `docs/` - Architecture documentation, sprint planning, and reference materials

### **MAC** - Multi-repository Container Infrastructure
Infrastructure layer providing workspace management and containerized development environments. Uses a config to launch and configure tmux session to a claude session in a container with multiple repos and dirs mounted for a completely isolated multi-agent task work on a set of related repos.

**Contains:**
- `mac-workspace/` - Multi-repository workspace management with mount and environment configuration
- `devcontainer/` - Container infrastructure for AI development environments

### **CDG** - Code Generation Domain
Specialized domain for Python-ObjectScript code generation with IRIS database integration.

**Contains:**
- `cdg/apps/` - CDG applications (web-translator FastAPI app, iris-execution Flask service)
- `cdg/agents/` - CDG-specific AI agents
- `cdg/tools/` - CDG-specific development tools
- `cdg/libs/` - CDG domain libraries (generation, analysis, knowledge management)

## Quick Start

### Installation
```bash
# Install all Morpheus packages (dev dependencies)
make install

# Install with full dependencies (includes ML/embedding for search)
make install-full

# Or install specific components manually
cd tools/morpheus-cli/
pip install -e .
```

### Usage Examples
```bash
# Morpheus unified CLI
morpheus --help
morpheus plugins

# Project management and standards
morpheus steward sprints create 14 MyFeatureName
morpheus steward sprints list --status Current
morpheus steward validate project ./tools/my-tool
morpheus steward structure generate ./tools/my-tool

# CDG workspace management
morpheus cdg workspace init my-project
morpheus cdg workspace status

# MAC workspace management
morpheus mac_workspace init my-project

# Document tools
morpheus search index ./docs
morpheus doc-conv scan ./files

# Codebase analysis
codebase-scanner scan .
codebase-scanner validate . --rules sample-rules/python.yaml
```

## System Validation

### **Quick Health Check** 
```bash
# Validate complete system (Sprint 06 integration test)
python tools/learning-integration-test/integration_test.py
```
**Expected**: All tests pass with " SUCCESS" status

### **Learning System Demo** 🧬
```bash
# See genetic algorithm in action (35%  92% fitness improvement)
python apps/morpheus-evolve/demo_walkthrough.py
```
**Expected**: Complete learning walkthrough demonstrating prompt evolution

**📖 Complete testing suite**: [docs/human-testing/](./docs/human-testing/)

## Documentation

### Core Documentation
- [`CLAUDE.md`](./CLAUDE.md) - AI agent development instructions and organizational standards
- [`templates/workflows/README.md`](./templates/workflows/README.md) - Workflow system documentation (Development, Research, Review, Debug)
- [`tools/project-steward/README.md`](./tools/project-steward/README.md) - Project management and standards enforcement
- [`docs/sprints/`](./docs/sprints/) - Sprint planning and tracking with standardized 4-document structure

### Architecture Documentation
- [`docs/MULTI_AGENT_WORKSPACE_ARCHITECTURE.md`](./docs/MULTI_AGENT_WORKSPACE_ARCHITECTURE.md) - Multi-agent architecture overview
- [`docs/MULTI_AGENT_WORKSPACE_IMPLEMENTATION_PLAN.md`](./docs/MULTI_AGENT_WORKSPACE_IMPLEMENTATION_PLAN.md) - Implementation roadmap
- [`docs/DEVCONTAINER_FOUNDATION_ANALYSIS.md`](./docs/DEVCONTAINER_FOUNDATION_ANALYSIS.md) - Container infrastructure analysis
- [`docs/CONTAINER_ORCHESTRATION_DESIGN.md`](./docs/CONTAINER_ORCHESTRATION_DESIGN.md) - Orchestration system design
- [`docs/reference/decisions/`](./docs/reference/decisions/) - Architecture Decision Records (ADRs)

## Development Workflow

### For AI Agents
1. Read [`CLAUDE.md`](./CLAUDE.md) for organizational standards and navigation protocol
2. Declare mode and workflow (see [`templates/workflows/README.md`](./templates/workflows/README.md))
3. Follow workflow-specific guidance for task at hand
4. Use `morpheus steward` commands for project management
5. Update `.claude-state.md` checkpoint for session continuity

### For Humans
1. Start with README.md files to understand components
2. Check CLAUDE.md files in projects for development instructions
3. Use shared components from `libs/` when possible
4. Follow established patterns within each category
5. Maintain clear separation between project types

## Navigation Pattern

- Each directory has STRUCTURE.md for navigation (generate with `morpheus steward structure generate`)
- Each project has CLAUDE.md for development instructions
- README.md files explain what the code does (for engineers)
- Use `templates/workflows/` for workflow-specific guidance
- Navigate systematically through the hierarchy

## License

See individual project licenses within each directory.
