This synthesis distills the directory structure and catalogue into FLOSS’s up-to-date foundational tenants and maps each major repository component to its specification artifacts, contracts, and test coverage.
- The spec (arf_flossi_0_ullk_sdd_master_specification_*.md) is the primary artifact.
- Code, contracts, and tests are regenerated and validated against executable specs.
- "Refactoring means clarifying the spec."
- Built on Holochain: agent-centric, sharded DHT, each agent controls their own chain (see docs/architecture.md, in.finite-nrg/infinity-bridge).
- Provenance, integrity, privacy, and autonomy are enforced by validation rules and NormKernel contracts.
- Domains (Rose Forest) focus on cognitive emancipation, bio-aware budgeting, and transparent architecture (docs/philosophy.md, architecture.md).
- Research shows formal validation of memory, embeddings, and swarm intelligence (conversation_memory.py, embedding_frames_of_scale.py).
- RSA algorithms, multi-agent swarm coordination, persistence across boundaries (test_breakthrough.py, test_human_coherence.py).
- Federated learning, cross-AI memory (Comprehensive_Research_Report__Agent-Centric,_Dist_2.md).
- BudgetEntry, resource allocations, incentives for useful knowledge contributions (Rose Forest zomes/coordinator/src/budget.rs).
- Contracts and validation in mutual credit, membership, and offers/needs workflows (arf_flossi_0_ullk_sdd_master_specification_v_0.md).
- Each performance/feature claim is linked to benchmarks or production deployments (FLOSSI0ULLK_Documentation_Update_Summary_Claude_4-5_11-10-2025.md).
- Ethics, safety, and rights protocols baked into the spec, test coverage, and governance flows.
- Spec docs:
- docs/arf_flossi_0_ullk_sdd_master_specification_v_0*.md — SDD (spec-driven development) templates, gates, and full-feature flows.
- docs/collision-node.md — Cognitive activation pattern.
- Symbolic-first code:
- conversation_memory.py, embedding_frames_of_scale.py — Symbolic/conversational memory and multi-scale embeddings.
- Contracts:
- contracts/identity.json, membership.json, attestations.json, policy.json — Strict schemas and validation for agent actions.
- Tests:
- test_breakthrough.py, test_human_coherence.py — ADR-0 protocol validation.
- Rose Forest: dnas/rose_forest/zomes/integrity/src/lib.rs — implements validation logic for cognitive sovereignty, budget, and provenance.
- docs specify contract, integration, e2e, and unit test coverage.
- Core Components:
- coordinator/src/[budget.rs, lib.rs]: Manages cognitive resource allocation, agent reasoning logic.
- integrity/src/lib.rs: Defines validation, data structures, license compliance, and embedding rules.
- Spec linkage:
- architecture.md, philosophy.md, vvs_bigger_bang_v_1^2.md — Map abstract principles to implementation and invariants.
- Contracts and Tests:
- Zome validation rules are enforced with test scenarios in tryorama/rose_forest.test.ts and firmware/hal/tests/gate*.rs.
- Explicit budget, provenance, entry validation tested per gate.
- Spec docs:
- EXECUTIVE_SUMMARY.md, START_HERE.md, DOWNLOAD_ALL.md — Provide protocol specification, performance benchmarks, deployment guides.
- infinity-bridge/docs/[ARCHITECTURE.md, HAL.md, QUICKSTART.md]
- Code & Contracts:
- firmware/hal/src/[correlate.rs, safety.rs, sync.rs, transport.rs] — Implements bridge orchestration, synchronization, and safety contracts.
- orchestration scripts in orchestrator/ — mcp_server.py, holochain_connector.py.
- Test Coverage:
- firmware/hal/tests/gate[1-3]_*.rs — Rust integration/unit tests for synchronization, truth, and safety.
- agents/examples/coherence_demo.py — Py test for agent coherence.
- Core Components:
- core/embedding.py, horde_client.py, pony_agent.py, swarm.py — Swarm agent logic, RSA aggregation, embeddings.
- Spec/Contracts:
- MOCK_MODE_GUIDE.md, SYNTHESIS_COMPLETE.md — Practice guidelines and mock/test protocols.
- Test Coverage:
- desktop_pony_swarm/tests/test_swarm.py — Python swarm & RSA integration test.
- Scripts:
- scripts/bootstrap.sh, launch.sh — CI/CD and deployment flows.
- CI Contracts:
- .github/workflows/rust.yml — Rust-based CI test validation, enforcing phase-gates.
- Living docs:
- Comprehensive_Research_Report__Agent-Centric,_Dist_2.md — landscape and best-practices synthesis.
- FLOSSI0ULLK_Documentation_Update_Summary_Claude_4-5_11-10-2025.md — Evidence updates and benchmark logs.
- manifest/test_results/test_4_human_coherence.json — Validation outputs, performance baselines.
| Component | Spec Document(s) | Contracts / Schemas | Test Suite(s) | Coverage Notes |
|---|---|---|---|---|
| ARF SDD/Spec | arf_flossi_0_ullk_sdd_*.md | identity.json, membership.json, attestations.json, policy.json | test_breakthrough.py, test_human_coherence.py | SDD, Phase gates |
| Cognitive Budget | vvs_bigger_bang_v_1^2.md, budget.rs | budget schemas (in code) | tryorama/rose_forest.test.ts, hal/tests/gate*.rs | Bio-aware budgeting |
| Agent Memory/Embeds | conversation_memory.py, embedding_frames_of_scale.py | N/A | Python/TypeScript/Rust unit+integ | Symbolic-first |
| Rose Forest Core | architecture.md, philosophy.md | lib.rs (core datatypes) | integration/unit in tryorama, hal/tests | Cognitive governance |
| Firmwares/Bridge | ARCHITECTURE.md, HAL.md | correlate.rs, safety.rs | hal/tests/gate*.rs | Safety, sync, truth |
| Swarm Reasoning | desktop_pony_swarm/ | swarm, embedding, agent py | test_swarm.py | RSA aggregation |
| Repo/Manifest | README.md, manifest.json | N/A | test_results.json, CI | Whole-repo snapshot |
- This mapping should be iteratively updated as manifests, contract schemas, and test outputs evolve.
- Each new feature or module must be linked to its spec, have clear contracts, and show explicit test coverage (Red → Green path via CI gates and manifests).
- This synthesis acts as the "table of contents" and traceability map for all future iterative spec-driven development.