code wiki / swarm
topic: swarm
35 modules sharing the swarm name family (derived from the tree's prefix discipline).
The 'swarm' topic family enables coordinated resource management and communication across the Nishi sovereign ecosystem, ensuring seamless operation of distributed systems. Modules like nx_swarm_admit and nx_swarm_admit_gate control access to the swarm, while nx_swarm_arbitrate manages resource allocation across workstreams. Together, these modules support the swarm's ability to dynamically coordinate, discover, and execute tasks efficiently.
auto-narrated by the local model from this topic's module headers; links verified against the wiki index.
narrated overview -- maintained by the narration lane, module links verified against this wiki.
| module | description | lines | funcs |
|---|---|---|---|
| nx_swarm_admit.nx | THE GENERAL ECOSYSTEM ADMISSION CAPABILITY (operator 2026-07-16: host- | 101 | 4 |
| nx_swarm_admit_gate.nx | gate for the general swarm admission capability. | 59 | 1 |
| nx_swarm_arbitrate.nx | SWARM FABRIC cross-workstream RESOURCE ARBITRATION (SF-ARB): the layer that | 119 | 4 |
| nx_swarm_beat.nx | SWARM FABRIC fleet-beat store (SF-R1b): every worker reports its beacon NODE | 465 | 14 |
| nx_swarm_coord.nx | SWARM FABRIC class-aware COORDINATOR (SF-R-COORD): the missing UNIFIER that routes | 245 | 10 |
| nx_swarm_discover.nx | SF-DISCOVER: find GPU inference capacity on the LAN and register it. | 228 | 11 |
| nx_swarm_endpoint.nx | thin CLI over nx_swarm_endpoint_lib (the resolver SSOT). | 145 | 1 |
| nx_swarm_endpoint_lib.nx | THE one act every swarm caller performs: resolve a ROLE to an ADDRESS. | 245 | 15 |
| nx_swarm_gpu.nx | SWARM FABRIC GPU/VRAM inventory + SPLIT-MODEL SHARD PLANNER (F792). The keystone of | 556 | 15 |
| nx_swarm_heal.nx | HUB-SIDE swarm endpoint self-heal (2026-08-12, residue debt 1786545237 item 4). | 264 | 14 |
| nx_swarm_job.nx | SWARM FABRIC job engine (SF-R3): decompose a chunky GEN job into independent | 513 | 22 |
| nx_swarm_job_evidence_t67.nx | SWARM FABRIC job engine (SF-R3): decompose a chunky GEN job into independent | 513 | 22 |
| nx_swarm_journal_evidence_gate_t67.nx | 42 | 3 | |
| nx_swarm_lib.nx | SWARM FABRIC shared lib: the NODE-row contract (validate/freshness), bounded | 172 | 7 |
| nx_swarm_maturity.nx | SWARM FABRIC MATURITY census (SF-MAT): the HONEST measurement the operator | 358 | 12 |
| nx_swarm_pack.nx | SWARM FABRIC heterogeneous MAX-UTILIZATION scheduler (SF-R-PACK): get the MOST out | 578 | 23 |
| nx_swarm_pack_measured_gate_t68.nx | Validates and measures node and GPU configurations against expected values using timestamped snapshots. | 61 | 4 |
| nx_swarm_pack_measured_t68.nx | SWARM FABRIC heterogeneous MAX-UTILIZATION scheduler (SF-R-PACK): get the MOST out | 578 | 23 |
| nx_swarm_pack_queue_gate_t68.nx | ORIGINAL. Isolated resource-vector regression: no worker dispatch or hardware writes. | 33 | 1 |
| nx_swarm_pack_queue_t68.nx | SWARM FABRIC heterogeneous MAX-UTILIZATION scheduler (SF-R-PACK): get the MOST out | 451 | 13 |
| nx_swarm_pack_units_baseline_t70.nx | 20 | 4 | |
| nx_swarm_pack_units_gate_t70.nx | Validates and compares node and GPU resource configurations against expected values using timestamped snapshots. | 66 | 4 |
| nx_swarm_pack_units_t70.nx | SWARM FABRIC heterogeneous MAX-UTILIZATION scheduler (SF-R-PACK): get the MOST out | 578 | 23 |
| nx_swarm_place.nx | SWARM FABRIC placement brain (SF-R2): given the fleet snapshot (NODE rows | 333 | 10 |
| nx_swarm_place_epoch_baseline_t71.nx | 31 | 2 | |
| nx_swarm_place_epoch_gate_t71.nx | 31 | 2 | |
| nx_swarm_place_epoch_t71.nx | SWARM FABRIC placement brain (SF-R2): given the fleet snapshot (NODE rows | 333 | 10 |
| nx_swarm_queue.nx | INTELLIGENT QUEUING + COORDINATION for the swarm admission plane (operator | 449 | 19 |
| nx_swarm_queue_gate.nx | gate for the intelligent queue scheduler. | 111 | 2 |
| nx_swarm_shardserve.nx | SPLIT-MODEL SERVE PIPELINE (F838 keystone): run a stack of N sovereign no-float | 432 | 36 |
| nx_swarm_sim.nx | deterministic swarm simulator + download engine (bits-up, replayable). | 147 | 6 |
| nx_swarm_sim_test.nx | KAT for the deterministic swarm simulator / download engine. | 88 | 2 |
| nx_swarm_tend.nx | ACTIVE QUEUE TENDER (operator 2026-07-16: "whoever in the nishi RACI is part | 139 | 5 |
| nx_swarm_tend_gate.nx | gate for the active queue tender (SOTA queue ops, no fire-and-forget). | 92 | 2 |
| nx_swarm_tile.nx | SWARM FABRIC chunk EXECUTOR (SF-R3 real-artifact): a sovereign, embarrassingly- | 387 | 16 |