bodai 0.1.1__tar.gz

bodai-0.1.1/.claude/settings.local.json

@@ -0,0 +1,18 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git commit:*)",
+      "Bash(.venv/bin/ruff check:*)",
+      "Bash(.venv/bin/ruff format:*)",
+      "Bash(git -C /Users/les/Projects/bodai status)",
+      "Bash(git -C /Users/les/Projects/bodai diff)",
+      "Bash(git -C /Users/les/Projects/bodai log --oneline -3)",
+      "Bash(git -C /Users/les/Projects/bodai add:*)",
+      "Bash(git -C:*)",
+      "Bash(mcp__crackerjack__init_crackerjack:*)",
+      "Bash(git push)",
+      "mcp__session-buddy__start_app_monitoring",
+      "mcp__session-buddy__start_conscious_agent"
+    ]
+  }
+}

bodai-0.1.1/.complexipy_cache/be4373305c912bdc9ab0e94e53284782.json

@@ -0,0 +1,175 @@
+{
+  "functions": [
+    {
+      "complexity": 0,
+      "file_name": "shell.py",
+      "function_name": "launch_shell",
+      "path": "bodai/admin/shell.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "cli.py",
+      "function_name": "health",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "cli.py",
+      "function_name": "status",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "cli.py",
+      "function_name": "_display_health_table",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "cli.py",
+      "function_name": "config_show",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "cli.py",
+      "function_name": "dashboard",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "cli.py",
+      "function_name": "shell",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 2,
+      "file_name": "cli.py",
+      "function_name": "restart",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 2,
+      "file_name": "cli.py",
+      "function_name": "start",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 2,
+      "file_name": "cli.py",
+      "function_name": "stop",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 3,
+      "file_name": "cli.py",
+      "function_name": "config_validate",
+      "path": "bodai/cli.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "config.py",
+      "function_name": "load_storage_map",
+      "path": "bodai/core/config.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "config.py",
+      "function_name": "load_ecosystem",
+      "path": "bodai/core/config.py"
+    },
+    {
+      "complexity": 10,
+      "file_name": "config.py",
+      "function_name": "load_portmap",
+      "path": "bodai/core/config.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "health.py",
+      "function_name": "check_component",
+      "path": "bodai/core/health.py"
+    },
+    {
+      "complexity": 2,
+      "file_name": "health.py",
+      "function_name": "check_all",
+      "path": "bodai/core/health.py"
+    },
+    {
+      "complexity": 4,
+      "file_name": "health.py",
+      "function_name": "check_port",
+      "path": "bodai/core/health.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "ecosystem.py",
+      "function_name": "Component::role_display",
+      "path": "bodai/models/ecosystem.py"
+    },
+    {
+      "complexity": 3,
+      "file_name": "ecosystem.py",
+      "function_name": "Ecosystem::get_by_port",
+      "path": "bodai/models/ecosystem.py"
+    },
+    {
+      "complexity": 3,
+      "file_name": "ecosystem.py",
+      "function_name": "Ecosystem::get_by_role",
+      "path": "bodai/models/ecosystem.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "dashboard.py",
+      "function_name": "BodaiDashboard::action_refresh",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "dashboard.py",
+      "function_name": "BodaiDashboard::compose",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "dashboard.py",
+      "function_name": "ComponentList::__init__",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "dashboard.py",
+      "function_name": "ComponentList::_load_components",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 0,
+      "file_name": "dashboard.py",
+      "function_name": "ComponentWidget::__init__",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "dashboard.py",
+      "function_name": "ComponentList::compose",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 1,
+      "file_name": "dashboard.py",
+      "function_name": "ComponentWidget::compose",
+      "path": "bodai/tui/dashboard.py"
+    },
+    {
+      "complexity": 2,
+      "file_name": "dashboard.py",
+      "function_name": "ComponentList::refresh_health",
+      "path": "bodai/tui/dashboard.py"
+    }
+  ],
+  "targets": [
+    "/Users/les/Projects/bodai/bodai"
+  ]
+}

bodai-0.1.1/.envrc

@@ -0,0 +1 @@
+layout uv

bodai-0.1.1/.gitignore

@@ -0,0 +1 @@
+__pycache__/

bodai-0.1.1/.python-version

@@ -0,0 +1 @@
+3.13

bodai-0.1.1/CLAUDE.md

@@ -0,0 +1,112 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Bodai (The Orb) is a meta-project for the Bodai ecosystem. It provides configuration, documentation, and operational tooling for managing interconnected components. The project serves as a central hub for ecosystem-wide operations, health monitoring, and configuration management.
+
+## Ecosystem Components
+
+| Component | Role | Port |
+|-----------|------|------|
+| Mahavishnu | Orchestrator | 8680 |
+| Akosha | Seer | 8682 |
+| Dhruva | Curator | 8683 |
+| Session-Buddy | Builder | 8678 |
+| Crackerjack | Inspector | 8676 |
+
+## Development Commands
+
+### Installation
+
+```bash
+uv sync --group dev
+```
+
+### Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run specific test file
+pytest tests/test_health.py
+
+# Run tests with coverage
+pytest --cov=bodai
+```
+
+### Code Quality
+
+```bash
+# Linting
+crackerjack lint
+
+# Type checking
+crackerjack typecheck
+
+# Security scanning
+crackerjack security
+```
+
+### Running CLI
+
+```bash
+# Health check command
+python -m bodai.cli health
+
+# Dashboard command
+python -m bodai.cli dashboard
+
+# Interactive shell
+python -m bodai.cli shell
+```
+
+## Architecture
+
+The Bodai project is organized into three primary layers:
+
+### 1. Config Layer
+
+- Configuration management for ecosystem components
+- YAML-based configuration files for each component
+- Environment-specific settings management
+
+### 2. Models Layer
+
+- Pydantic models for data validation and serialization
+- Component status and health check models
+- Ecosystem topology representations
+
+### 3. Operations Layer
+
+- CLI commands using Typer framework
+- Interactive TUI using Textual
+- Concurrent operations using ThreadPoolExecutor
+
+## Key Patterns
+
+### Pydantic Models
+
+All data models use Pydantic v2 for validation, serialization, and settings management. Models are defined with strict type hints and comprehensive validation rules.
+
+### Typer CLI Framework
+
+The CLI is built using Typer for intuitive command-line interfaces with automatic help generation and rich formatting via Rich integration.
+
+### Textual TUI
+
+Interactive dashboards and shells use Textual for terminal-based user interfaces with reactive components and event-driven architecture.
+
+### ThreadPoolExecutor
+
+Concurrent health checks and operations across ecosystem components use ThreadPoolExecutor for parallel execution with configurable thread pools.
+
+## Configuration Files
+
+The ecosystem configuration is managed through three YAML files:
+
+1. `config/components.yaml` - Component definitions and connection settings
+1. `config/monitoring.yaml` - Health check intervals and thresholds
+1. `config/operations.yaml` - Operational procedures and automation rules

bodai-0.1.1/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2023, Les Leslie & Wedgwood Web Works
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

bodai-0.1.1/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: bodai
+Version: 0.1.1
+Summary: The Orb - Ecosystem meta-project for Bodai
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: ipython>=8.0.0
+Requires-Dist: oneiric>=0.2.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.40.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Bodai
+
+Central meta-project for the Bodai ecosystem, providing configuration, documentation, and operations for all components.
+
+> **Etymology**: From Sanskrit *bodhi* (awakening, enlightenment) - the state of supreme understanding.
+
+## Ecosystem Components
+
+The Bodai ecosystem consists of six interconnected components, each with a distinct role. Five are network services with MCP servers, while Oneiric serves as a shared library.
+
+| Component | Role | Port | GitHub | Description |
+|-----------|------|------|--------|-------------|
+| [Mahavishnu](#mahavishnu---the-orchestrator) | Orchestrator | 8680 | [lesleslie/mahavishnu](https://github.com/lesleslie/mahavishnu) | Multi-engine workflow orchestration |
+| [Akosha](#akosha---the-seer) | Seer | 8682 | [lesleslie/akosha](https://github.com/lesleslie/akosha) | Cross-system intelligence & vector embeddings |
+| [Dhruva](#dhruva---the-curator) | Curator | 8683 | [lesleslie/dhruva](https://github.com/lesleslie/dhruva) | Persistent object storage with ACID |
+| [Session-Buddy](#session-buddy---the-builder) | Builder | 8678 | [lesleslie/session-buddy](https://github.com/lesleslie/session-buddy) | Session lifecycle & knowledge graphs |
+| [Crackerjack](#crackerjack---the-inspector) | Inspector | 8676 | [lesleslie/crackerjack](https://github.com/lesleslie/crackerjack) | Quality gates & CI/CD validation |
+| [Oneiric](#oneiric---the-resolver) | Resolver | N/A | [lesleslie/oneiric](https://github.com/lesleslie/oneiric) | Conflict resolution library |
+
+---
+
+### Mahavishnu - The Orchestrator
+
+> From Sanskrit *maha* (great) + *Vishnu* (the preserver in Hindu trinity)
+
+The central workflow engine that routes tasks to appropriate execution engines, coordinates multi-step processes across components, and manages workflow definitions and templates.
+
+- Routes tasks to Akosha for intelligence operations
+- Persists state to Dhruva for recovery
+- Tracks context in Session-Buddy
+- Validates with Crackerjack before execution
+
+### Akosha - The Seer
+
+> From Sanskrit *akasha* (sky, ether, space) - the fifth element, medium of consciousness
+
+Provides cross-system intelligence through vector embeddings, semantic search, pattern detection, and knowledge graphs. Enables predictive analysis and recommendations across all sessions.
+
+- Receives session data from Session-Buddy for embedding
+- Stores patterns in Dhruva
+- Provides intelligence to Mahavishnu
+- Receives code analysis from Crackerjack
+
+### Dhruva - The Curator
+
+> From Sanskrit *dhruva* (firm, constant, unchanging) - also the Pole Star
+
+The single source of truth for persistent data. Provides ACID transaction guarantees, data versioning, backup/recovery, and efficient querying.
+
+- Stores state for Mahavishnu
+- Persists patterns for Akosha
+- Backs up sessions for Session-Buddy
+- Stores quality reports for Crackerjack
+
+### Session-Buddy - The Builder
+
+The session lifecycle manager that tracks conversation history, builds knowledge graphs, and enables context switching between sessions.
+
+- Sends data to Akosha for embedding
+- Stores backups in Dhruva
+- Provides context to Mahavishnu
+- Receives quality metrics from Crackerjack
+
+### Crackerjack - The Inspector
+
+The quality enforcer that runs automated test suites, manages CI/CD pipelines, provides code analysis and linting, and tracks quality metrics over time.
+
+- Validates workflows for Mahavishnu
+- Sends code analysis to Akosha
+- Stores reports in Dhruva
+- Records metrics in Session-Buddy
+
+### Oneiric - The Resolver
+
+> From Greek *oneiros* (dream) - relating to dreams, the abstract and complex
+
+A shared library (no MCP server) that provides conflict resolution algorithms, dependency graph analysis, version conflict detection, and merge strategies. Embedded directly by other components.
+
+- Used by Mahavishnu for workflow conflict resolution
+- Used by Dhruva for data merge operations
+- Used by Session-Buddy for context merging
+
+---
+
+## Installation
+
+```bash
+uv sync
+```
+
+## Commands
+
+Bodai provides a unified CLI for managing the ecosystem:
+
+| Command | Description |
+|---------|-------------|
+| `bodai health` | Check health status of all ecosystem components |
+| `bodai start` | Start all ecosystem services |
+| `bodai stop` | Stop all ecosystem services |
+| `bodai restart` | Restart all ecosystem services |
+| `bodai dashboard` | Launch the interactive monitoring dashboard |
+| `bodai shell` | Open an interactive management shell |
+| `bodai config show` | Display current configuration |
+| `bodai config validate` | Validate configuration files |
+
+## Architecture
+
+For detailed architecture documentation, see [docs/architecture.md](docs/architecture.md).
+
+## Development
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Quality Checks
+
+```bash
+crackerjack run
+```
+
+## Related Documentation
+
+- [Architecture](docs/architecture.md) - System overview and data flow
+- [Component Roles](docs/roles.md) - Detailed descriptions of each component
+- [Symbiosis](docs/symbiosis.md) - How components work together
+- [Port Map](docs/portmap.md) - Port allocation and rationale

bodai-0.1.1/README.md

@@ -0,0 +1,129 @@
+# Bodai
+
+Central meta-project for the Bodai ecosystem, providing configuration, documentation, and operations for all components.
+
+> **Etymology**: From Sanskrit *bodhi* (awakening, enlightenment) - the state of supreme understanding.
+
+## Ecosystem Components
+
+The Bodai ecosystem consists of six interconnected components, each with a distinct role. Five are network services with MCP servers, while Oneiric serves as a shared library.
+
+| Component | Role | Port | GitHub | Description |
+|-----------|------|------|--------|-------------|
+| [Mahavishnu](#mahavishnu---the-orchestrator) | Orchestrator | 8680 | [lesleslie/mahavishnu](https://github.com/lesleslie/mahavishnu) | Multi-engine workflow orchestration |
+| [Akosha](#akosha---the-seer) | Seer | 8682 | [lesleslie/akosha](https://github.com/lesleslie/akosha) | Cross-system intelligence & vector embeddings |
+| [Dhruva](#dhruva---the-curator) | Curator | 8683 | [lesleslie/dhruva](https://github.com/lesleslie/dhruva) | Persistent object storage with ACID |
+| [Session-Buddy](#session-buddy---the-builder) | Builder | 8678 | [lesleslie/session-buddy](https://github.com/lesleslie/session-buddy) | Session lifecycle & knowledge graphs |
+| [Crackerjack](#crackerjack---the-inspector) | Inspector | 8676 | [lesleslie/crackerjack](https://github.com/lesleslie/crackerjack) | Quality gates & CI/CD validation |
+| [Oneiric](#oneiric---the-resolver) | Resolver | N/A | [lesleslie/oneiric](https://github.com/lesleslie/oneiric) | Conflict resolution library |
+
+---
+
+### Mahavishnu - The Orchestrator
+
+> From Sanskrit *maha* (great) + *Vishnu* (the preserver in Hindu trinity)
+
+The central workflow engine that routes tasks to appropriate execution engines, coordinates multi-step processes across components, and manages workflow definitions and templates.
+
+- Routes tasks to Akosha for intelligence operations
+- Persists state to Dhruva for recovery
+- Tracks context in Session-Buddy
+- Validates with Crackerjack before execution
+
+### Akosha - The Seer
+
+> From Sanskrit *akasha* (sky, ether, space) - the fifth element, medium of consciousness
+
+Provides cross-system intelligence through vector embeddings, semantic search, pattern detection, and knowledge graphs. Enables predictive analysis and recommendations across all sessions.
+
+- Receives session data from Session-Buddy for embedding
+- Stores patterns in Dhruva
+- Provides intelligence to Mahavishnu
+- Receives code analysis from Crackerjack
+
+### Dhruva - The Curator
+
+> From Sanskrit *dhruva* (firm, constant, unchanging) - also the Pole Star
+
+The single source of truth for persistent data. Provides ACID transaction guarantees, data versioning, backup/recovery, and efficient querying.
+
+- Stores state for Mahavishnu
+- Persists patterns for Akosha
+- Backs up sessions for Session-Buddy
+- Stores quality reports for Crackerjack
+
+### Session-Buddy - The Builder
+
+The session lifecycle manager that tracks conversation history, builds knowledge graphs, and enables context switching between sessions.
+
+- Sends data to Akosha for embedding
+- Stores backups in Dhruva
+- Provides context to Mahavishnu
+- Receives quality metrics from Crackerjack
+
+### Crackerjack - The Inspector
+
+The quality enforcer that runs automated test suites, manages CI/CD pipelines, provides code analysis and linting, and tracks quality metrics over time.
+
+- Validates workflows for Mahavishnu
+- Sends code analysis to Akosha
+- Stores reports in Dhruva
+- Records metrics in Session-Buddy
+
+### Oneiric - The Resolver
+
+> From Greek *oneiros* (dream) - relating to dreams, the abstract and complex
+
+A shared library (no MCP server) that provides conflict resolution algorithms, dependency graph analysis, version conflict detection, and merge strategies. Embedded directly by other components.
+
+- Used by Mahavishnu for workflow conflict resolution
+- Used by Dhruva for data merge operations
+- Used by Session-Buddy for context merging
+
+---
+
+## Installation
+
+```bash
+uv sync
+```
+
+## Commands
+
+Bodai provides a unified CLI for managing the ecosystem:
+
+| Command | Description |
+|---------|-------------|
+| `bodai health` | Check health status of all ecosystem components |
+| `bodai start` | Start all ecosystem services |
+| `bodai stop` | Stop all ecosystem services |
+| `bodai restart` | Restart all ecosystem services |
+| `bodai dashboard` | Launch the interactive monitoring dashboard |
+| `bodai shell` | Open an interactive management shell |
+| `bodai config show` | Display current configuration |
+| `bodai config validate` | Validate configuration files |
+
+## Architecture
+
+For detailed architecture documentation, see [docs/architecture.md](docs/architecture.md).
+
+## Development
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Quality Checks
+
+```bash
+crackerjack run
+```
+
+## Related Documentation
+
+- [Architecture](docs/architecture.md) - System overview and data flow
+- [Component Roles](docs/roles.md) - Detailed descriptions of each component
+- [Symbiosis](docs/symbiosis.md) - How components work together
+- [Port Map](docs/portmap.md) - Port allocation and rationale

bodai-0.1.1/bodai/__init__.py

@@ -0,0 +1,3 @@
+"""Bodai - The Orb. Ecosystem meta-project."""
+
+__version__ = "0.1.0"

bodai-0.1.1/bodai/admin/__init__.py

@@ -0,0 +1 @@
+"""Admin tools: IPython shell."""