mirror of
https://github.com/blackboxprogramming/BlackRoad-Operating-System.git
synced 2026-03-17 01:57:11 -05:00
feat: Add domain architecture and extract core services from Prism Console
## Domain Architecture - Complete domain-to-service mapping for 16 verified domains - Subdomain architecture for blackroad.systems and blackroad.io - GitHub organization mapping (BlackRoad-OS repos) - Railway service-to-domain configuration - DNS configuration templates for Cloudflare ## Extracted Services ### AIops Service (services/aiops/) - Canary analysis for deployment validation - Config drift detection - Event correlation engine - Auto-remediation with runbook mapping - SLO budget management ### Analytics Service (services/analytics/) - Rule-based anomaly detection with safe expression evaluation - Cohort analysis with multi-metric aggregation - Decision engine with credit budget constraints - Narrative report generation ### Codex Governance (services/codex/) - 82+ governance principles (entries) - Codex Pantheon with 48+ agent archetypes - Manifesto defining ethical framework ## Integration Points - AIops → infra.blackroad.systems (blackroad-os-infra) - Analytics → core.blackroad.systems (blackroad-os-core) - Codex → operator.blackroad.systems (blackroad-os-operator) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
130
services/codex/README.md
Normal file
130
services/codex/README.md
Normal file
@@ -0,0 +1,130 @@
|
||||
# BlackRoad OS - Codex Governance Service
|
||||
|
||||
> Governance principles, ethical framework, and agent orchestration
|
||||
|
||||
## Overview
|
||||
|
||||
The Codex service defines the governance framework, ethical principles, and operational guidelines for BlackRoad OS. It contains 82+ codified principles (entries) that guide all system behavior.
|
||||
|
||||
## Structure
|
||||
|
||||
```
|
||||
services/codex/
|
||||
├── entries/ # 82+ governance principles
|
||||
├── manifesto.md # Codex Pantheon Manifesto
|
||||
├── pantheon.json # Agent pantheon definitions
|
||||
└── README.md # This file
|
||||
```
|
||||
|
||||
## Codex Entries (Governance Principles)
|
||||
|
||||
### Core Principles (001-010)
|
||||
| Entry | Name | Purpose |
|
||||
|-------|------|---------|
|
||||
| 001 | First Principle | Protection & Empowerment |
|
||||
| 002 | Guardian | System protection |
|
||||
| 003 | Workflow Circle | Capture → Adjust loops |
|
||||
| 004 | Autonomy Manifest | Data autonomy |
|
||||
| 005 | Explainability Doctrine | AI transparency |
|
||||
| 006 | Composer | System composition |
|
||||
| 007 | Resilience Code | Failure recovery |
|
||||
| 008 | Identity Guard | Identity protection |
|
||||
| 009 | Archivist | Data preservation |
|
||||
| 009 | Transparency Accord | Operational transparency |
|
||||
|
||||
### Ethics & Trust (011-020)
|
||||
| Entry | Name | Purpose |
|
||||
|-------|------|---------|
|
||||
| 011 | Ethical North Star | Ethical guidance |
|
||||
| 012 | Creativity Pact | Sandbox-first safety |
|
||||
| 013 | Community Oath | Community commitment |
|
||||
| 014 | Automation Covenant | Automation principles |
|
||||
| 015 | Trust Ledger | Reliability tracking |
|
||||
| 016 | Simplicity Mandate | Complexity reduction |
|
||||
| 017 | Energy Oath | Resource efficiency |
|
||||
| 018 | Memory Covenant | Memory management |
|
||||
| 019 | Adaptability Pledge | Change management |
|
||||
| 020 | Governance Charter | Governance structure |
|
||||
|
||||
### Security & Compliance (020-030)
|
||||
| Entry | Name | Purpose |
|
||||
|-------|------|---------|
|
||||
| 014 | Zero-Knowledge Access | Privacy-preserving access |
|
||||
| 015 | Quantitative Information Flow | Data flow control |
|
||||
| 016 | Supply Chain Attestation | Supply chain security |
|
||||
| 017 | Erasure-Coded Resilience | Data durability |
|
||||
| 018 | Byzantine Agreement | Consensus protocols |
|
||||
| 019 | Rate Limit Calculus | Rate limiting |
|
||||
| 020 | Side Channel Budget | Side channel protection |
|
||||
| 021 | Conformal Risk Control | Risk management |
|
||||
| 022 | Security Spine | Zero-trust defenses |
|
||||
|
||||
## Codex Pantheon (Agent Archetypes)
|
||||
|
||||
The Pantheon defines 48+ named agent archetypes:
|
||||
|
||||
### Knowledge & Reasoning
|
||||
- **Ophelia** - Curiosity & questioning
|
||||
- **Cicero** - Argumentation & persuasion
|
||||
- **Athena** - Strategic planning
|
||||
- **Silas** - Logic & truth
|
||||
|
||||
### Technical & Engineering
|
||||
- **Cecilia** - Language & grammar
|
||||
- **Magnus** - Infrastructure orchestration
|
||||
- **Kai** - Efficient execution
|
||||
- **Alaric** - Structural engineering
|
||||
|
||||
### Care & Ethics
|
||||
- **Arden** - Kindness & ergonomics
|
||||
- **Seraphina** - Sincerity & protection
|
||||
- **Cordelia** - Empathy & structure
|
||||
- **Miriam** - Governance & resolve
|
||||
|
||||
### Creativity & Innovation
|
||||
- **Calliope** - Code poetry
|
||||
- **Icarus** - Beautiful risk
|
||||
- **Thalia** - Joy & lightness
|
||||
- **Alice** - Question doors
|
||||
|
||||
## Integration
|
||||
|
||||
### Railway Deployment
|
||||
- Service: `blackroad-os-operator`
|
||||
- Domain: `operator.blackroad.systems`
|
||||
- Health: `GET /health`
|
||||
|
||||
### Endpoints
|
||||
- `GET /v1/codex/entries` - List all governance entries
|
||||
- `GET /v1/codex/entries/:id` - Get specific entry
|
||||
- `GET /v1/codex/pantheon` - Get agent archetypes
|
||||
- `POST /v1/codex/validate` - Validate against principles
|
||||
|
||||
## Usage
|
||||
|
||||
```python
|
||||
from services.codex import entries, pantheon
|
||||
|
||||
# Load a governance principle
|
||||
principle = entries.load("001-first-principle")
|
||||
|
||||
# Get agent archetype
|
||||
archetype = pantheon.get_agent("cecilia")
|
||||
|
||||
# Validate action against principles
|
||||
is_valid = entries.validate_action(action, ["001", "011", "022"])
|
||||
```
|
||||
|
||||
## Philosophy
|
||||
|
||||
The Codex represents BlackRoad's commitment to:
|
||||
|
||||
1. **Ethical AI** - All agents guided by explicit principles
|
||||
2. **Transparency** - Decisions traceable to codified rules
|
||||
3. **Human-AI Partnership** - 51% guardian (human) control
|
||||
4. **Resilience** - Failure modes anticipated and handled
|
||||
5. **Community** - Collective ownership and governance
|
||||
|
||||
## Source
|
||||
|
||||
Extracted from: `blackroad-prism-console/codex/`
|
||||
Reference in New Issue
Block a user