Epic: Ouroboros-inspired agent infrastructure patterns

Open
#595 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Stale
Tech stack
rust
Domain
ai, backend

Research direction

Start with the existing agent areas named in the issue—supervisor, registry, messaging, evolution, goal_alignment, task_decomposition, kg_agents, and kg_orchestration—and read plans/terraphim-ouroboros-rebuild-assessment.md plus the referenced knowledge files. Work through subissues #596–#602 in dependency order; completion is the set of exit criteria covering guardrails, event logging, budgets, learning capture, verdicts, EIDOS tracking, and KG promotion.

Written by the indexing model from the issue text.

Description

architecture enhancement multi-agent

Summary

Absorb operational patterns from joi-lab/ouroboros and vibeship-spark-intelligence into terraphim's existing Rust architecture. Not a rebuild -- selective pattern adoption to close gaps in the agent layer and complete terraphim_agent_evolution.

Context

Ouroboros and Spark Intelligence demonstrate infrastructure patterns that terraphim's agent system (supervisor, registry, messaging, evolution, goal_alignment, task_decomposition, kg_agents, kg_orchestration) currently lacks. The foundation layer (types, automata, rolegraph, persistence, middleware, hooks, MCP) is solid; the agent layer is incomplete.

Ouroboros Patterns

  • #596 Constitutional Guardrails (CONSTITUTION.md) -- ~2 hours
  • #597 Event Sourcing for Agent Decisions -- ~1 day
  • #598 Budget-Aware Multi-Model Routing -- ~4 hours

Spark Intelligence Patterns

  • #599 Enhanced Learning Capture (multi-hook pipeline + importance scoring) -- ~1 day
  • #600 Dimensional Verdict Scoring / Meta-Ralph (6-dimension judge scores) -- ~4 hours
  • #601 EIDOS Episodic Reasoning (prediction-outcome tracking) -- ~1 day
  • #602 Confidence-Driven KG Promotion (EIDOS threshold gates KG entry creation) -- ~1 day

Execution Order

#596 Constitutional Guardrails ─────────────────────────────────┐
                                                                 │
#597 Event Sourcing ────┬──── #598 Budget-Aware Routing          │
                        │                                        │
                        ├──── #599 Enhanced Learning Capture     │
                        │         |                              │
                        │         v                              │
                        ├──── #600 Dimensional Verdict Scoring   │
                        │         |                              │
                        │         v                              │
                        └──── #601 EIDOS Episodic Reasoning      │
                                  |                              │
                                  v                              │
                              #602 Confidence-Driven KG Promotion│

#596 and #597 have no prerequisites and can start in parallel.
#602 is the capstone: Event Capture -> Event Store -> EIDOS -> Promotion -> KG Entry -> Aho-Corasick Automata.

Patterns NOT Adopted (and why)

Pattern Reason
Self-modifying source code Rust compilation latency makes rapid evolution cycles impractical. Compound engineering (knowledge mutation via AGENTS.md/MEMORY.md) achieves continuous improvement without code mutation.
Background consciousness loop Premature -- agent system needs to work before adding always-on thinking. v2.0 pattern.
LLM-first philosophy Contradicts terraphim's deterministic-first philosophy. Aho-Corasick for deterministic matching, LLM only for reasoning.
Task deduplication via LLM Use Aho-Corasick automata for semantic dedup. Faster, deterministic, cheaper.

Design Principle

Terraphim's identity is Aho-Corasick + local-first data sovereignty. Agent evolution is not about self-modifying code (Ouroboros) -- it's about self-improving knowledge quality (Spark). The evolution happens in confidence-gated KG promotion, not in source code mutation. The Aho-Corasick engine stays constant; the knowledge graph grows autonomously when confidence thresholds are met.

Reference

  • Analysis: plans/terraphim-ouroboros-rebuild-assessment.md (in cto-executive-system)
  • KB entries: knowledge/ouroboros-self-modifying-agent.md, knowledge/spark-intelligence-self-evolving-companion.md

Exit Criteria

  • Constitutional guardrails enforced by agent_supervisor before execution
  • Agent decisions logged as immutable event stream with drift detection
  • LLM calls tracked per-task with budget limits and fallback chains
  • Learning capture covers all three hook types with importance scoring
  • Judge verdicts use 6-dimensional scoring with feedback loops
  • EIDOS prediction-outcome loop tracks advisory accuracy
  • High-confidence insights auto-promote to KG entries via Aho-Corasick indexing
Dominant language
Rust
Stars
62
Forks
5
Avg merge
2h 27m
Merged PRs (30d)
1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from terraphim/terraphim-ai

All issues in terraphim/terraphim-ai

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.