jordan/stemedb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
71d7892735
stemedb/ai-lookup/features/simulation.md
jml 9bfa626203 docs: reorganize documentation structure for clarity 
Major documentation restructure to improve discoverability and reduce duplication.

## Changes

**Deleted (Archived/Consolidated)**:
- Removed duplicate getting started guides
- Archived outdated planning documents
- Consolidated corpus and configuration docs
- Removed obsolete vision/spec files (superseded by vision.md)
- Cleaned up scrapyard and old PDFs

**New Structure**:
- docs/about/ - Project overview and introduction
- docs/guides/ - User guides (moved from root)
- docs/specs/ - Technical specifications
- docs/sdk/ - SDK documentation (Go)
- docs/references/ - API references
- docs/archive/ - Archived historical docs
- applications/aphoria/docs/advanced/ - Advanced topics
- applications/aphoria/docs/reference/ - CLI reference
- applications/aphoria/docs/archive/ - Archived aphoria docs

**Updated**:
- README.md - New root README with clear navigation
- CONTRIBUTING.md - Contribution guidelines
- CLAUDE.md - Updated paths to new structure
- roadmap.md - Added recent completions

## Files Changed
- 57 files changed
- 1,977 insertions(+)
- 961 deletions(-)

**Net change**: +1,016 lines (added CONTRIBUTING.md, README.md, reorganized content)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-11 07:33:40 +00:00

2.8 KiB
Raw Blame History

Simulation System ("The Arena")

Last Updated: 2026-01-31 Confidence: High Status: Phase 1 Complete (Spine validation)

Summary

The Simulation is an Agent-Based Modeling (ABM) environment that validates StemeDB under emergent, adversarial, and evolutionary pressure. It simulates a society of AI agents with conflicting goals living within the knowledge graph.

Key Facts:

  • Codename: "The Arena"
  • Purpose: Integration testing via societal stress tests, not unit tests
  • Architecture: stemedb-sim binary orchestrating agent swarms via tokio
  • Agents communicate only through StemeDB reads/writes

File Pointers:

  • Implementation: crates/stemedb-sim/src/main.rs
  • Vision document: /simulation-vision.md
  • Incremental roadmap: /roadmap.md#arena-simulation-roadmap

Agent Personas

Persona Goal Behavior
Scientist Converge on truth High-confidence assertions, cites sources
Troll Sow chaos Low-confidence contradictions, frequent forks
Believer Amplify consensus Trusts high-reputation agents
Skeptic Find variance Reduces confidence of unverified claims
Historian Preserve context Resurrects dormant truths with new evidence

The Gameplay Loop

  1. Assertion: Agent reads ground truth, creates assertion
  2. Fork: Adversarial agent forks reality with contradiction
  3. Lens Resolution: Query agent applies Lens (e.g., Consensus)
  4. Reputation Update: TrustRank adjusts agent reputations
  5. Decay: Unverified assertions fade via Dormancy Protocol

Success Criteria

  • Truth survives: High-reputation assertions outlive spam
  • Lenses work: Consensus lens filters Troll noise
  • Performance: 1000 concurrent agents without locking
  • Emergence: Trust clusters form without hardcoded rules

Metrics

Tracked via Prometheus/Grafana:

  • global_truth_convergence - Entropy of the graph
  • agent_reputation_distribution - Reputation spread
  • fork_depth_max - Deepest branch depth

Current Status

The simulator currently validates Phase 1: The Spine (WAL + Ingestor + KV Store). It proves the write path works end-to-end with signature verification.

What's implemented:

  • 3 agents (2 Scientists, 1 Troll)
  • 10 ticks of assertion creation
  • Ed25519 signature verification
  • WAL → Ingestor → KV Store pipeline

What's NOT implemented yet:

  • Query path (uses direct KV access, not QueryEngine)
  • Voting and consensus
  • TrustRank reputation
  • Concurrent agents
  • Agent persona differentiation

Roadmap

See roadmap.md - Arena section for the incremental path from current state to full ABM environment.

Related Topics