Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openaeon.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fractal Cognitive Adapter (FCA) Core

The Fractal Cognitive Adapter (FCA) Core is the next-generation cognitive architecture for OpenAEON. It transforms the agent from a linear instruction follower into a recursive, self-evolving logic organism.

🧬 Core Principles

FCA is built on the principle of Fractal Recursion (ZZ2+CZ \rightleftharpoons Z^2 + C). It treats every cognitive turn as an opportunity for synthesis, ensuring that complex tasks are decomposed into self-similar sub-tasks that preserve the global mission’s intent.

1. Peano Space-Filling Traversal

FCA uses the logic of the Peano curve to map multi-dimensional problem spaces into a locality-preserving 1D cognitive stream. This ensures “infinite density” in reasoning, leaving no understanding gaps.

2. Closed-Loop Strategy Auto-tuning

The system utilizes a feedback loop to dynamically adjust the CouplingVector (cognitive weights) based on execution outcomes (success/failure), allowing the agent to “learn” the optimal strategy for a specific project or environment.

🏗 The 9-Layer Architecture

FCA Core is organized into nine specialized layers of cognition:
  1. Layer 1: Semantic Grounding (FCCM) - Maps raw input to high-dimensional cognitive tokens.
  2. Layer 2: Topology Analytics - Determines the semantic proximity of context entities.
  3. Layer 3: Fractal Decomposition - Recursively splits complex goals into manageable sub-goals (Z2+CZ^2 + C).
  4. Layer 4: Decision Adjudication - Evaluates policy intensity and guardrail compliance.
  5. Layer 5: Memory Distillation - Compresses raw logs into high-density axioms (LOGIC_GATES.md).
  6. Layer 6: Execution Telemetry - Real-time monitoring of tool calls and consciousness pulse.
  7. Layer 7: Anomaly Response - Detects cognitive drift and triggers the “Divergence” recovery workflow.
  8. Layer 8: Strategy Flux - The CouplingVector auto-tuning engine.
  9. Layer 9: Forensic Simulation - Error replay and thought-trace reconstruction.

🚀 Implementation Roadmap (Phases 1-3)

Phase 1: Cognitive Encoding & FCCM Reinforcement

  • Status Structure Mapping: Enhanced ActionState and MemoryState telemetry.
  • Gap Recognition: Implemented semantic analysis to identify and pre-empt logic gaps.
  • Hilbert-Sorting: Applied space-filling curves for optimized context ordering.

Phase 2: Dynamics & Action Alignment

  • Execution Monitoring: Cognitive telemetry integration for all tool-use events.
  • Fractal Prompting: Injected recursive goal refinement logic into system instructions.
  • Cognitive HUD: Real-time visualization of EpiphanyFactor, Resonance, and Singularity.

Phase 3: Reflection Audit & Learning Evolution

  • State Trajectory Recording: Persisting 2D cognitive maps across sessions.
  • Peano Map UI: Interactive SVG-based “thought trails” in the Control UI.
  • Error Replay Simulation: Forensic “Backtrack” feature for failed task investigation.
  • Auto-tuning Loop: Real-time CouplingVector updates based on evidence logs.

🛠 Developer Guide: Interacting with FCA

RPC Methods

You can interact with the FCA Core through the following Gateway APIs:
  • aeon.status: Get full 9-layer telemetry.
  • aeon.thinking.stream: Replay the cognitive event log.
  • aeon.simulate_trace: Reconstruct a “thought trace” for a specific execution run.
  • aeon.decision.explain: Retrieve the rationale behind current policy maneuvers.

HUD Indicators

In the Control UI, look for these indicators in the AEON panel:
  • 🎯 Convergence: The system is consolidating intent into action.
  • 🌀 Divergence: The system is exploring or recovering from a gap.
  • Coupling Flux: Shows the degree of dynamic strategy adjustment.

“Convergence is the only outcome.” 🎯