Files
aevolution/schemas/genome-v2.md
T
dingoandClaude Opus 5.5 17fe23e5f0
Foundation / checks (deploy) (push) Successful in 3m32s
Foundation / checks (ecs) (push) Successful in 1m56s
Foundation / checks (client) (push) Successful in 12m56s
Foundation / checks (network) (push) Successful in 13m46s
Foundation / checks (tsan) (push) Successful in 7m59s
Foundation / checks (checks) (push) Successful in 33m36s
Foundation / checks (postgres) (push) Successful in 45m30s
Foundation / postgres-tools (push) Successful in 20s
Foundation / server-image (push) Successful in 25s
Foundation / image (push) Successful in 2m36s
M11.1: genome schema 2 with per-second rates (ADR-0099, segment 2)
Movement and ingestion are stored per second in schema 2 (ranges x20). Schema 1 records
stay valid, are never rewritten, and read as exactly x20 via Genome::per_second; drafts
default to schema 1 so existing literals keep their meaning. Development version 1
converts genome rates at its own 50 ms quantum (round down), so phenotypes are
unchanged. Mutation keeps the parent's schema and step; the lineage archive header names
exactly the highest schema held (all-schema-1 archives keep their bytes); the
development-v1 opening names schema 1. No golden changed; two tests that used 2 as an
unknown schema now use the next one. Refresh the dev session window.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 13:16:55 -04:00

40 lines
1.9 KiB
Markdown

# Genome record, schema version 2
Scope: schema 2 of the immutable genome record ([genome-v1.md](genome-v1.md),
[ADR-0030](../docs/adr/0030-immutable-genome-record.md)). It changes only the units of
the two rate capabilities, per [ADR-0099](../docs/adr/0099-time-based-biological-rates.md).
Its encoder and decoder are `src/biology/genome.cpp`, which reads schemas 1 and 2.
## Layout
The layout is byte for byte that of schema 1, except offset 8, which holds 2. The
magic stays `AEVOGEN1`; the schema field, not the magic, selects the capability table.
The digest and checksum rules are unchanged. The digest covers the schema field, so a
schema 1 record and its schema 2 translation are distinct records with distinct
digests.
## Capability table
| Kind | Unit (schema 2) | Range | Schema 1 unit and range |
|---|---|---|---|
| energy conversion | per thousand | 1-1000, required | same |
| membrane | micrometres | 1-10,000, required | same |
| movement | **micrometres per second** | 0-2,000,000 | um per 50 ms tick, 0-100,000 |
| ingestion | **femtograms per second** | 0-20,000,000 | fg per 50 ms tick, 0-1,000,000 |
| reproduction | per thousand | 1-1000 | same |
| target size | femtograms | 1-1,000,000,000, required | same |
| thermal tolerance | millikelvin | 1-100,000 | same |
Each rate range is schema 1's times 20, so every schema 1 value has an exact schema 2
equivalent.
## Compatibility
- **Schema 1 records** stay valid and are never rewritten. `Genome::per_second` reads
a schema 1 rate as exactly 20 times its per-tick value.
- **Drafts** default to schema 1, so existing literals keep their meaning. New
records name schema 2.
- **Mutation** keeps the parent's schema and that schema's adjustment step, one
hundredth of the range.
- **Lineage archives** name the highest schema they hold. An archive of schema 1
records keeps its exact bytes.
- **Unknown schemas** fail closed.