Hivemind v2

Hivemind is deterministic workload-orchestration system prototype to drive serverless platforms.

Start here

1. Contributor rules
2. Testing and evidence semantics
3. Handoff contract
4. Executable harness catalog
5. POC v2 acceptance gate
6. Engineering principles and test boundaries
7. Control-plane contract

The wire fixture contract is the current bounded normative protocol-v6 corpus consumed by Zig, Rust, Go API, and Go bench. The live safety contract documents the prepared, fail-closed guarded entry point. Wire fixtures are deterministic compatibility evidence; the live path remains unexecuted and blocked before ownership on missing strict capabilities.

Components

• core/: Zig control plane, VRR consensus, scheduler, persistence, gossip, and VOPR simulation
• worker/: Rust node agent, runtimes, GPU/resource accounting, secrets, volumes, and worker simulation
• api/: Go REST/dashboard gateway
• bench/: Go benchmark tooling
• tests/: deterministic fixtures and local/runtime harnesses
• infra/: deployment and benchmark tooling; live use requires separate authorization

Build

cd core && zig build
cd ../worker && cargo build
cd ../api && go build ./...

Current versus historical material

Active status and product guidance:

• Current implementation status
• POC v2 acceptance
• Findings and production gaps
• Hivemind-native platform design

Historical records, not current-head evidence:

• POC v1 acceptance
• POC changelog
• docs/frozen/ and docs/legacy/

When prose conflicts with source or a maintained harness, source and harness behavior win. No POC v2 parity claim is made.