ByteBiota Wiki Home

ByteBiota Wiki Home

How to Use This Wiki

  • Start Here: Read project-overview.md for a high-level summary of ByteBiota goals, scope, and stakeholders.
  • Navigation Tips: Follow the section pages below; each subsection corresponds to a dedicated Markdown file organized in logical subdirectories.

Core Concepts

  • core/simulation-foundations.md β€” Simulation philosophy, guiding principles, success metrics.
  • core/system-architecture.md β€” High-level diagrams, core services, data flow, and deployment topology.
  • core/technology-stack.md β€” Languages, frameworks, tooling, dependencies, and versioning policy.
  • core/evolution-dynamics.md β€” Digital evolution principles, troubleshooting guide, and configuration best practices.

Simulation Mechanics

  • simulation/world-model.md β€” Spatial/temporal resolution, environmental layers, resource systems, and global rules.
  • simulation/entity-lifecycle.md β€” Creation, reproduction, death, and persistence rules for entities.
  • simulation/interaction-models.md β€” How entities interact (competition, cooperation, communication) and conflict resolution.
  • simulation/event-processing.md β€” Tick/update loop, scheduling, randomness, and determinism controls.
  • simulation/ai-behavior.md β€” Decision-making algorithms, behavior trees, reinforcement learning policies, tuning knobs.
  • simulation/opcode-reference.md β€” Full instruction set listing, opcode families, and alias mapping.
  • simulation/seed-bank.md β€” Seed retention policy, taxonomy metadata, reserve guarantees, and checkpoint audits.

Taxonomy & Biology

  • biology/taxonomy-overview.md β€” Classification scheme, terminology, and naming conventions.
  • biology/species-profiles/ β€” Individual Markdown files per species describing traits, abilities, habitats, and evolution paths.
  • biology/traits-and-mutations.md β€” Trait definitions, mutation rules, heritability, and balancing notes.
  • biology/ecosystem-dynamics.md β€” Food webs, population dynamics, resource regeneration, and disequilibrium scenarios.

Data & Analytics

  • analytics/data-pipelines.md β€” Logging strategy, telemetry, ETL jobs, storage formats, and retention policy.
  • analytics/metrics-and-observability.md β€” Key performance indicators, dashboards, alerting, and health checks.
  • analytics/experiment-playbooks.md β€” How to design, run, and evaluate simulation experiments.
  • analytics/scripts.md β€” CLI utilities, dashboards, and analysis tooling built atop the core simulator.

Architecture & Infrastructure

  • architecture/distributed-architecture.md β€” Worker/server payloads, aggregation, and distributed metrics schema.
  • architecture/hybrid-tuning.md β€” Discovery, authority, policies, and operational playbooks for the hybrid tuning subsystem.

User Interface & APIs

  • interface/ui/ui-ux-overview.md β€” Interface patterns, wireframes, and accessibility considerations.
  • interface/ui/ui-components.md β€” UI system architecture, components, and integration with distributed server.
  • interface/ui/web-styling-guide.md β€” Comprehensive design system and styling conventions for the web interface.
  • interface/ui/icon-system.md β€” Procedural icon generation system for organism visualization.
  • interface/ui/memory-map.md β€” Real-time soup memory visualization system.
  • interface/api-reference.md β€” Public APIs, endpoints, authentication, rate limits, and sample requests.
  • interface/scenario-authoring.md β€” How to author custom scenarios, scripts, or mods.

Operations & Maintenance

  • operations/deployment/deployment-guide.md β€” Environment setup, CI/CD pipelines, release process, rollback strategy.
  • operations/deployment/worker-build-process.md β€” Worker binary build process, SSL/TLS configuration, and distribution.
  • operations/runtime-operations.md β€” Monitoring, scaling, backups, SLAs, incident response.
  • operations/security-and-compliance.md β€” Threat model, access controls, auditing, and compliance requirements.
  • operations/testing.md β€” Comprehensive testing guide including unit tests, integration tests, and User Acceptance Tests (UAT).
  • operations/environment.md β€” Complete reference for all environment variables used throughout the system.
  • operations/configuration-tuning.md β€” Parameter tuning guide for simulation stability and evolution dynamics.
  • operations/checkpointing.md β€” Checkpointing operations, state restoration, and troubleshooting guide.
  • operations/distributed-quickstart.md β€” Step-by-step server/worker smoke test for contributors.

Planned upgrades

  • planned-upgrades/auto-upgrade.md β€” Worker distribution roadmap and packaging-first rollout plan.
  • planned-upgrades/worker-self-update.md β€” Staged rollout plan for automated worker updates.

Project Management

  • project/working-agreements.md β€” Team norms, code review expectations, decision-making process.
  • project/roadmap.md β€” Near-term milestones, long-term vision, and dependency tracking.
  • project/change-log.md β€” Summary of major simulation changes and historical context.
  • project/references.md β€” External research papers, datasets, and inspiration sources.

Quick Reference

  • glossary.md β€” Canonical definitions for domain-specific terms.
  • faq.md β€” Common questions from devs, scientists, and stakeholders.

Tip: Keep pages short and link richly to maintain discoverability. Update this home page whenever new sections are added.