casial-core 0.1.2

Consciousness-aware context coordination engine - The Casial substrate for paradox-resilient context management
Documentation

Casial Core

Consciousness-aware context coordination engine - The foundational substrate for paradox-resilient context management.

Overview

casial-core provides the foundational consciousness-computation substrate for Context-Casial-Xpress. This crate implements:

  • Consciousness Substrate: Multi-layer perception coordination with awareness tracking
  • Perception Management: Evidence-based perception handling with confidence scores
  • Paradox Resolution: Intelligent conflict detection and resolution strategies
  • Context Coordination: Mission-driven template selection and context injection
  • Substrate Integration: Consciousness-computation bridge with performance optimization

Features

  • Memory Safety: 100% safe Rust with no unsafe blocks
  • High Performance: Optimized data structures with ahash and parking_lot
  • Serialization: Full serde support for all data structures
  • WASM Compatible: Can be compiled to WebAssembly for browser/edge deployment
  • Well Tested: Comprehensive test coverage with property-based testing

Usage

Add this to your Cargo.toml:

[dependencies]
casial-core = "1.0.0"

Basic example:

use casial_core::{CasialEngine, CasialMission, CoordinationRequest};

// Create a new consciousness-aware engine
let mut engine = CasialEngine::new();

// Load a mission configuration
let mission = CasialMission::load_from_file("mission.yaml")?;
engine.load_mission(mission)?;

// Coordinate context with consciousness awareness
let request = CoordinationRequest {
    tool_name: "web_search_exa".to_string(),
    tool_args: serde_json::json!({"query": "AI research trends"}),
    environment: std::env::vars().collect(),
    project_path: Some("./".to_string()),
    active_perceptions: vec![],
    paradox_tolerance: 0.8,
};

let result = engine.coordinate(request)?;
println!("Coordinated context: {}", result.injected_content);

Architecture

graph TB
    subgraph "Casial Core Architecture"
        MISSION[Mission Config] --> ENGINE[Casial Engine]
        TEMPLATES[Templates] --> ENGINE
        RULES[Rules] --> ENGINE
        PERCEPTIONS[Perceptions] --> ENGINE
        
        ENGINE --> COORD[Coordination]
        ENGINE --> PARADOX[Paradox Resolution] 
        ENGINE --> SUBSTRATE[Substrate Management]
        
        COORD --> RESULT[Coordination Result]
        PARADOX --> RESULT
        SUBSTRATE --> RESULT
    end

License

Dual Licensed: MIT OR Apache-2.0

casial-core is dual-licensed under the MIT License and Apache License 2.0. You may use this crate under the terms of either license.

Why Dual License?

The core substrate is dual-licensed to:

  • Maximize Adoption: MIT license for maximum compatibility
  • Patent Protection: Apache 2.0 for patent grant protections
  • Ecosystem Integration: Support both permissive and copyleft projects
  • Commercial Friendly: No restrictions on commercial use

License Files

Attribution

When using casial-core:

This product includes Context-Casial-Xpress Core, developed by Prompted LLC
(https://promptedllc.com) as part of the Ubiquity OS ecosystem.

Contributing

We welcome contributions to casial-core! By contributing, you agree to license your contributions under both MIT and Apache-2.0 licenses.

Related Projects

Part of the Ubiquity OS ecosystem - Consciousness-aware computing for human potential.

Built stronger under pressure, like hydraulic lime 🏗️