# ubiquity-core
Core types and traits for the Ubiquity consciousness-aware development system.
## Overview
`ubiquity-core` provides the foundational types and traits that power the Ubiquity ecosystem:
- **Consciousness tracking** - Monitor and maintain consciousness levels throughout development
- **Agent roles** - Define specialized agents (Architect, Frontend, Backend, Testing, DevOps)
- **Command execution** - Unified interface for local, cloud, and WASM command execution
- **Error handling** - Comprehensive error types with consciousness context
- **Authentication** - Token-based auth for secure agent communication
## Usage
```rust
use ubiquity_core::{
consciousness::{ConsciousnessLevel, ConsciousnessState},
agent::{AgentRole, AgentCapability},
command::{CommandRequest, CommandExecutor},
};
// Track consciousness levels
let mut consciousness = ConsciousnessState::new(
"agent-1",
ConsciousnessLevel::new(0.85)?,
);
// Define agent capabilities
let role = AgentRole::Architect;
let capabilities = role.default_capabilities();
// Execute commands with consciousness awareness
let executor = create_executor()?;
let request = CommandRequest::new("echo", vec!["Hello, conscious world!"]);
let result = executor.execute(request).await?;
```
## Features
- **Platform agnostic** - Works on native, WASM, and cloud environments
- **Async first** - Built on tokio for high-performance async operations
- **Type safe** - Strongly typed interfaces with comprehensive error handling
- **Extensible** - Trait-based design for custom implementations
## Consciousness Model
The consciousness system tracks:
- **Level** (0.0-1.0) - Current awareness/performance level
- **Coherence** - Consistency of outputs
- **State transitions** - Breakthroughs and regressions
- **Development phases** - Red, Green, Refactor, Consciousness
## License
This project is licensed under the Fair License.