Part IV · Organs · Plate 04

Soma

On this page

Body schema / proprioception

Rust CLI · soma verifyivannovak/soma ↗ (repository access may be required)Wrapped by cnsS0–S11 verified

What must stay true about this codebase? Soma keeps human-curated invariants, regenerates the maps an agent reads, and runs the closeout gates.

Reviewed 2026-11-04 · CNS S0–S11 programme record; not a live health check. Programme labels and terminology.

Fig. 4.4.1   What Soma owns

Curated · Git-tracked

docs/soma/README.md and docs/soma/concerns/*.md hold authored invariants, not generated maps.

Generated · Git-excluded

.soma/ holds codemap, arteries, overview, registry, modules, anchors and manifest.

Closeout · fail honestly

soma verify and concerns check bind concerns to structural evidence. A requested oracle that did not run is not a pass.

Fig. 4.4.2   Concern lifecycle

  1. Author
    candidate concern
  2. Validate
    structure + evidence
  3. Promote
    tolerance set
  4. Enforce
    landed active concern

A fresh concern cannot certify its own changeset. The concern lifecycle contract defines promotion, base-version checks and ledger verification.

Table 4.4.1   Channels

DirectionChannelPeerCarried byContract
readsConnectome + DeltaReportV1AxonSQLite / JSONRead contract ↗
writesOptional rubric requestThalamusHTTP /v1/systemoneRead contract ↗
writesConcern ledgercns curate / operatorJSONLRead contract ↗

Listing 4.4.1   Commands

soma docs render
soma verify
soma concerns check --check
cns gate

Note 4.4.1   Running alone

Structural checks do not require Thalamus. The rubric is off by default; opting in makes it a requested oracle. Missing configuration or an unavailable oracle returns not evaluated, never a green result.