Skip to main content

Crate vela_constellation

Crate vela_constellation 

Source
Expand description

§vela-constellation

The Vela Constellation layer: a network of connected Atlases across scientific domains.

§What a Constellation is

A Constellation (vco_*) is a read-only composition over one or more Atlases (vat_*), each itself a composition over Vela frontiers (vfr_*). The substrate stack:

Frontier (vfr_*)        bounded reviewable state, unit of replay
    │
    │ composed into
    ▼
Atlas (vat_*)           living domain map, unit of reviewer-
                        confirmed bridges
    │
    │ networked into
    ▼
Constellation (vco_*)   cross-domain map, read-only over Atlas
                        snapshots

See docs/MISSION_ATLAS.md. The Carina v0.5 schema for the Constellation primitive ships at examples/carina-kernel/schemas/constellation.schema.json.

§What this crate ships at v0.81

  • ConstellationManifest: typed constellations/<name>/manifest.yaml.
  • ConstellationSnapshot: the materialized cross-Atlas view.
  • init_constellation(): scaffolds a new Constellation pointing at one or more Atlases by vat_* id.
  • materialize_constellation(): reads each composing Atlas’s snapshot.json, sums findings + events + bridges across, and computes a content-addressed composition hash.

Constellation is read-only. Confirmed bridges live in Atlas; a cross_atlas_bridges[] field on the manifest is auto-populated by materialize_constellation for any confirmed bridge whose two endpoint frontiers land in different composing Atlases (v0.82.5).

Structs§

ConstellationAtlasRef
ConstellationAtlasSummary
ConstellationMaintainer
ConstellationManifest
constellations/<name>/manifest.yaml schema. Mirrors the Carina v0.5 Constellation primitive.
ConstellationSnapshot
The materialized Constellation snapshot.

Functions§

init_constellation
Initialize a Constellation: scaffold constellations/<name>/manifest.yaml pointing at one or more existing Atlas dirs.
materialize_constellation
Materialize a Constellation: read each composing Atlas’s snapshot.json, sum findings/events/bridges across, compute content-addressed composition hash, write constellations/<name>/snapshot.json and a static index.html.