feat(db): biosphere_class authoring pipeline + values (T-1085 workstream 3, D-247)

The D-247 chirality/edibility register as authored data on every body, via the stamped regen-db path (import_economics) — not a manual bake. - systems-schema.sql + migration.py: nullable bodies.biosphere_class column. - economy_import/bodies.py: populate_biosphere_class — reads the authored environment.biosphere_class frontmatter override, else the D-247 two-gate default (Gate 0 habitability from atmosphere/hydrosphere/inhabited; Gate 1 Compatible/Mirror from economic_base_primary; neutral remainder -> stable ~50/50 split). Recomputes every body each regen (frontmatter + default are its complete source). - import_economics.py: wired as import step 17. - frontmatter overrides for the bodies whose default deviates from canon: Solandar=NativeMirror, GJ-524=NativeMirror (uninhabited-but-alive), Ha Long= NativeCompatible (its transit economy hides its aquaculture identity). Linnaeus, Arbour, Oshima, Freyburg, Puerto Ultimo, Edict all default correctly. systems.db regenerated + stamped. All 9 canon exemplars verified; distribution is 111 Compatible : 108 Mirror among inhabited alive worlds (~50/50 target), Airless for uninhabited bodies, TerraformedSterile for thin-atmosphere worlds. Follow-up (rename completion): propagating Linnaeus to bodies.proper_name in the DB (still "Cadwal" — proper_name is atlas-CLI-owned, and a wipe+reimport would drop non-proposal columns like founding_age_years; needs a targeted approach). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-05 11:56:52 +02:00
parent 5fb34675eb
commit cc7c5ada04
10 changed files with 283 additions and 1 deletions
@@ -288,3 +288,96 @@ REMAINING:
 - Workstream 3 (biosphere_class plumbing): add nullable bodies.biosphere_class column to systems-schema.sql; teach tooling/db/wiki_sync.py import_from_wiki to read biosphere_class frontmatter + apply the two-gate DEFAULT for canon-silent bodies (Gate0 atmosphere/hydrosphere, Gate1 economic_role/economic_base); add explicit frontmatter for the 3 override bodies still needing it (Solandar=NativeMirror, GJ-524=NativeMirror [uninhabited-but-alive → default would mis-Airless it], Edict/GJ244Ad=Airless [standard-atm+ice edge case]); ensure generate_wiki round-trips biosphere_class; then the BAKE (run import_from_wiki + generate_wiki → systems.db + regenerated infoboxes, incl. the Linnaeus name propagation) + commit systems.db. Add biosphere_class to BodyParams read set (D-240) as the D-247 code hook. NOTE: the bake is a systems.db binary-artifact commit — consequential, do deliberately.
 - Workstream 4 (alien-ecology vocab → palette): integrate Miri''s biome × register vocabulary (cane/vane/wrack/husk/drum-root native-mirror lexicon + Earth-register names, per her Deliverable 3) into atlas/mosaic.rs + mosaic_constants.toml — extends the temperate/native baseline to the full surface-class × climate-biome × register palette. This also completes T-1084''s biome-awareness. Determinism: lock before generation.
 Miri''s full Deliverable 3 vocab (the source for workstream 4) is in her T-1085 agent report.', NULL, '2026-07-03 20:40:15', '2026-07-03 20:40:15.305', '2026-07-03 20:40:15.305', NULL, 'fa34e073db0be60d59ec01ebd7a5e5f4', 2) ON CONFLICT(hash) DO NOTHING;
+INSERT INTO ticket_history (ticket_record_id, field, old_value, new_value, changed_by, changed_at, created_at, updated_at, deleted_at, hash, canonical_version) VALUES ('06FJ91R8RV38BJXGB2V55FP3B8', 'description', 'Operationalize the D-247 native-biosphere premise. Full brief appended.
+
+---
+BRIEF (2026-07-02) — governing record: D-247 (governance/decisions/content.md); consumer: D-246 / T-1084 mosaic register.
+
+WHAT THIS IS
+D-247 established that habitable Reach worlds were alive before humans (the settlement timeline forbids terraforming from dead rock), and that an AUTHORED per-world chirality bit gates whether native life is edible. This ticket turns that canon into data + reconciled wiki + the vocabulary the mosaic needs. Owner: Miri (worldbuilding/continuity). Stakeholder: Burnelli (food-import economics). Co-maintainer for the vocab: Araminta (visual grammar, per the T-995 ObjectTag precedent).
+
+THE MODEL (locked in D-247 — do not re-litigate, apply it):
+- `biosphere_class ∈ {NativeCompatible, NativeMirror, TerraformedSterile, Airless}`. It is an AUTHORED INPUT, never seed-derived — it follows a world''s economic/cultural identity.
+- Compatible ("levo") = edible; coupling *permits* an authored hazard but does not force it (most are benign gardens).
+- Mirror ("dextro") = inedible but *guaranteed* inert (can''t infect/poison — safe to study).
+- "Safe" ≠ "edible" — decoupled. Bio-safe is guaranteed on Mirror; food-safe is Compatible-only.
+- Achiral seam (always works either way): breathe air, drink water, mine ore, burn/build with native biomass. Only eat/metabolize/medicate/infect/chirally-poison are gated.
+- ~50/50 Compatible:Mirror is a DESIGN TARGET across canon-silent worlds, not a per-world draw.
+
+WORKSTREAMS
+1. CHIRALITY ASSIGNMENT (Miri). Give every inhabited body a biosphere_class by authored identity: principled default from `economic_base_primary` + `planet_class` (food/drink exporters → Compatible; dead+maintained-atmosphere → TerraformedSterile), explicit overrides where canon speaks. Locked exemplars: Arbour (GJ-338B)=Compatible; Solandar (GJ-827)=Mirror; Keid (GJ-166A)=Compatible (preserved *from exploitation* of edible alien life — the stronger conservation motive; Solandar is the Mirror-inert preserve); Oshima (GJ-79)=TerraformedSterile. Hit the ~50/50 target across the silent remainder.
+2. WIKI CONTINUITY (Miri). Reconcile the entries that already gesture at native biochemistry so each is consistent with its assigned bit + the mechanism: GJ-827, GJ-524, GJ-166A, GJ-684A, GJ-197, GJ-79, GJ-124 (resolve whether Hạ Long''s "protein" is native-Compatible harvest or Earth aquaculture). Additive/explanatory, not contradictory — preserve deliberately-vague lines as intentional.
+3. biosphere_class AUTHORING PATH (asset-pipeline discipline — schema + source + values together, per .claude/rules/asset-pipeline.md). Add `biosphere_class` to wiki body frontmatter (where `substrate:` already lives), a nullable `bodies.biosphere_class` column in systems-schema.sql + MIGRATION_SQL, and importer read. NOT needed for D-246; lands with this pass.
+4. ALIEN-ECOLOGY VOCABULARY (Miri + Araminta) — feeds T-1084 directly. The mosaic palette is keyed on surface-class × climate-biome × biosphere-register (D-246 Palette-key). Provide the micro-habitat NAMES per biome × register: native-mirror niches get *alien* clade names (Solandar''s "five kingdoms" flavor); introduced-Earth niches get Earth names (wheatfield, orchard, pasture). Fill the fixed niche spine (canopy / understory / wet-hollow / pioneer / bare) per climate-biome (savanna gallery-copse, tundra thermokarst / lichen-heath, boreal muskeg / deadfall, …). DETERMINISM: the vocab must be fixed before T-1084 generates its first world (a later addition re-rolls affected voxels). Table size is not a perf/storage concern — author generously but to taste (~100k is headroom, not a target).
+
+BURNELLI (stakeholder, follow-on): a food-supply demand primitive keyed on biosphere_class (Mirror + frontier → import dependency; Compatible → local-food capable). Phase-2 economy consumer; does not block this ticket.
+
+CONSTRAINTS
+- Authored input, not derivation (Arbour''s estate food must never be coin-flipped inedible).
+- Semantic axes stay clade-agnostic (Forest = canopy whether oak or mega-fungus); the register skins niches, it does not change gameplay semantics.
+- The mosaic geometry is chirality-blind — this work does NOT touch voxel geometry, only edibility/economy/naming/vocab.
+
+Chirality decisions resolved (2026-07-02, with Jeroen):
+- Locked exemplars: Arbour=NativeCompatible, Solandar=NativeMirror, Keid=NativeCompatible, Oshima=TerraformedSterile.
+- Miri assignments accepted: GJ-524=Mirror, Freyburg(GJ-684A)=Compatible, Hạ Long(GJ-124)=Compatible (native-Compatible harvest, per her rationale).
+- USER OVERRIDES: Puerto Último(GJ-197)=NativeCompatible (breadbasket identity over Miri''s balance-motivated Mirror). Edict/Sirius(GJ-244A)=Airless — keep the world harsh/frozen (deliberately-inconvenient below-grade transit capital is load-bearing canon); no climate change; below-grade sealed habitat = no open-air biosphere.
+- Two-gate default rule ACCEPTED for canon-silent worlds: Gate 0 (habitability from atmosphere/hydrosphere frontmatter → Airless / TerraformedSterile / Alive), Gate 1 (Compatible vs Mirror from economic_base_primary; agriculture→Compatible near-lock, penal→Mirror, research→50/50 lever).
+- NAMING: Keid''s habitable body renamed Cadwal→(pending final pick; rec Linnaeus — pairs with Solander, its student naturalist; or Beagle). Capital stays ''Vance'' (already the author tribute). Miri''s IP flag (Cadwal = Vance''s exact book title) is the driver.
+- Still to APPLY: the 7 additive wiki continuity edits (Miri specified exact text), the biosphere_class frontmatter+schema+importer plumbing (workstream 3), and the Cadwal→<name> rename across wiki + the GJ166A atlas proposal.
+
+NAMING CONFIRMED: Keid''s habitable body Cadwal → Linnaeus (the great classifier; ties to Solander/Solandar taxonomy + the ''five kingdoms''). Capital stays Vance.
+
+PROGRESS 2026-07-03: Workstreams 1-2 DONE + committed (388168eef, branch micro-habitat-mosaic).
+- Cadwal→Linnaeus rename applied (body frontmatter name + biosphere_class:NativeCompatible, GJ-166A infobox, atlas proposal, D-247 clarified). Capital stays Vance.
+- 5 wiki continuity edits applied (GJ-524 Mirror, GJ-166A/Keid Compatible, GJ-684A Freyburg Compatible, GJ-124 Hạ Long Compatible, GJ-197 Puerto Último Compatible). Solandar/Oshima needed none.
+REMAINING:
+- Workstream 3 (biosphere_class plumbing): add nullable bodies.biosphere_class column to systems-schema.sql; teach tooling/db/wiki_sync.py import_from_wiki to read biosphere_class frontmatter + apply the two-gate DEFAULT for canon-silent bodies (Gate0 atmosphere/hydrosphere, Gate1 economic_role/economic_base); add explicit frontmatter for the 3 override bodies still needing it (Solandar=NativeMirror, GJ-524=NativeMirror [uninhabited-but-alive → default would mis-Airless it], Edict/GJ244Ad=Airless [standard-atm+ice edge case]); ensure generate_wiki round-trips biosphere_class; then the BAKE (run import_from_wiki + generate_wiki → systems.db + regenerated infoboxes, incl. the Linnaeus name propagation) + commit systems.db. Add biosphere_class to BodyParams read set (D-240) as the D-247 code hook. NOTE: the bake is a systems.db binary-artifact commit — consequential, do deliberately.
+- Workstream 4 (alien-ecology vocab → palette): integrate Miri''s biome × register vocabulary (cane/vane/wrack/husk/drum-root native-mirror lexicon + Earth-register names, per her Deliverable 3) into atlas/mosaic.rs + mosaic_constants.toml — extends the temperate/native baseline to the full surface-class × climate-biome × register palette. This also completes T-1084''s biome-awareness. Determinism: lock before generation.
+Miri''s full Deliverable 3 vocab (the source for workstream 4) is in her T-1085 agent report.', 'Operationalize the D-247 native-biosphere premise. Full brief appended.
+
+---
+BRIEF (2026-07-02) — governing record: D-247 (governance/decisions/content.md); consumer: D-246 / T-1084 mosaic register.
+
+WHAT THIS IS
+D-247 established that habitable Reach worlds were alive before humans (the settlement timeline forbids terraforming from dead rock), and that an AUTHORED per-world chirality bit gates whether native life is edible. This ticket turns that canon into data + reconciled wiki + the vocabulary the mosaic needs. Owner: Miri (worldbuilding/continuity). Stakeholder: Burnelli (food-import economics). Co-maintainer for the vocab: Araminta (visual grammar, per the T-995 ObjectTag precedent).
+
+THE MODEL (locked in D-247 — do not re-litigate, apply it):
+- `biosphere_class ∈ {NativeCompatible, NativeMirror, TerraformedSterile, Airless}`. It is an AUTHORED INPUT, never seed-derived — it follows a world''s economic/cultural identity.
+- Compatible ("levo") = edible; coupling *permits* an authored hazard but does not force it (most are benign gardens).
+- Mirror ("dextro") = inedible but *guaranteed* inert (can''t infect/poison — safe to study).
+- "Safe" ≠ "edible" — decoupled. Bio-safe is guaranteed on Mirror; food-safe is Compatible-only.
+- Achiral seam (always works either way): breathe air, drink water, mine ore, burn/build with native biomass. Only eat/metabolize/medicate/infect/chirally-poison are gated.
+- ~50/50 Compatible:Mirror is a DESIGN TARGET across canon-silent worlds, not a per-world draw.
+
+WORKSTREAMS
+1. CHIRALITY ASSIGNMENT (Miri). Give every inhabited body a biosphere_class by authored identity: principled default from `economic_base_primary` + `planet_class` (food/drink exporters → Compatible; dead+maintained-atmosphere → TerraformedSterile), explicit overrides where canon speaks. Locked exemplars: Arbour (GJ-338B)=Compatible; Solandar (GJ-827)=Mirror; Keid (GJ-166A)=Compatible (preserved *from exploitation* of edible alien life — the stronger conservation motive; Solandar is the Mirror-inert preserve); Oshima (GJ-79)=TerraformedSterile. Hit the ~50/50 target across the silent remainder.
+2. WIKI CONTINUITY (Miri). Reconcile the entries that already gesture at native biochemistry so each is consistent with its assigned bit + the mechanism: GJ-827, GJ-524, GJ-166A, GJ-684A, GJ-197, GJ-79, GJ-124 (resolve whether Hạ Long''s "protein" is native-Compatible harvest or Earth aquaculture). Additive/explanatory, not contradictory — preserve deliberately-vague lines as intentional.
+3. biosphere_class AUTHORING PATH (asset-pipeline discipline — schema + source + values together, per .claude/rules/asset-pipeline.md). Add `biosphere_class` to wiki body frontmatter (where `substrate:` already lives), a nullable `bodies.biosphere_class` column in systems-schema.sql + MIGRATION_SQL, and importer read. NOT needed for D-246; lands with this pass.
+4. ALIEN-ECOLOGY VOCABULARY (Miri + Araminta) — feeds T-1084 directly. The mosaic palette is keyed on surface-class × climate-biome × biosphere-register (D-246 Palette-key). Provide the micro-habitat NAMES per biome × register: native-mirror niches get *alien* clade names (Solandar''s "five kingdoms" flavor); introduced-Earth niches get Earth names (wheatfield, orchard, pasture). Fill the fixed niche spine (canopy / understory / wet-hollow / pioneer / bare) per climate-biome (savanna gallery-copse, tundra thermokarst / lichen-heath, boreal muskeg / deadfall, …). DETERMINISM: the vocab must be fixed before T-1084 generates its first world (a later addition re-rolls affected voxels). Table size is not a perf/storage concern — author generously but to taste (~100k is headroom, not a target).
+
+BURNELLI (stakeholder, follow-on): a food-supply demand primitive keyed on biosphere_class (Mirror + frontier → import dependency; Compatible → local-food capable). Phase-2 economy consumer; does not block this ticket.
+
+CONSTRAINTS
+- Authored input, not derivation (Arbour''s estate food must never be coin-flipped inedible).
+- Semantic axes stay clade-agnostic (Forest = canopy whether oak or mega-fungus); the register skins niches, it does not change gameplay semantics.
+- The mosaic geometry is chirality-blind — this work does NOT touch voxel geometry, only edibility/economy/naming/vocab.
+
+Chirality decisions resolved (2026-07-02, with Jeroen):
+- Locked exemplars: Arbour=NativeCompatible, Solandar=NativeMirror, Keid=NativeCompatible, Oshima=TerraformedSterile.
+- Miri assignments accepted: GJ-524=Mirror, Freyburg(GJ-684A)=Compatible, Hạ Long(GJ-124)=Compatible (native-Compatible harvest, per her rationale).
+- USER OVERRIDES: Puerto Último(GJ-197)=NativeCompatible (breadbasket identity over Miri''s balance-motivated Mirror). Edict/Sirius(GJ-244A)=Airless — keep the world harsh/frozen (deliberately-inconvenient below-grade transit capital is load-bearing canon); no climate change; below-grade sealed habitat = no open-air biosphere.
+- Two-gate default rule ACCEPTED for canon-silent worlds: Gate 0 (habitability from atmosphere/hydrosphere frontmatter → Airless / TerraformedSterile / Alive), Gate 1 (Compatible vs Mirror from economic_base_primary; agriculture→Compatible near-lock, penal→Mirror, research→50/50 lever).
+- NAMING: Keid''s habitable body renamed Cadwal→(pending final pick; rec Linnaeus — pairs with Solander, its student naturalist; or Beagle). Capital stays ''Vance'' (already the author tribute). Miri''s IP flag (Cadwal = Vance''s exact book title) is the driver.
+- Still to APPLY: the 7 additive wiki continuity edits (Miri specified exact text), the biosphere_class frontmatter+schema+importer plumbing (workstream 3), and the Cadwal→<name> rename across wiki + the GJ166A atlas proposal.
+
+NAMING CONFIRMED: Keid''s habitable body Cadwal → Linnaeus (the great classifier; ties to Solander/Solandar taxonomy + the ''five kingdoms''). Capital stays Vance.
+
+PROGRESS 2026-07-03: Workstreams 1-2 DONE + committed (388168eef, branch micro-habitat-mosaic).
+- Cadwal→Linnaeus rename applied (body frontmatter name + biosphere_class:NativeCompatible, GJ-166A infobox, atlas proposal, D-247 clarified). Capital stays Vance.
+- 5 wiki continuity edits applied (GJ-524 Mirror, GJ-166A/Keid Compatible, GJ-684A Freyburg Compatible, GJ-124 Hạ Long Compatible, GJ-197 Puerto Último Compatible). Solandar/Oshima needed none.
+REMAINING:
+- Workstream 3 (biosphere_class plumbing): add nullable bodies.biosphere_class column to systems-schema.sql; teach tooling/db/wiki_sync.py import_from_wiki to read biosphere_class frontmatter + apply the two-gate DEFAULT for canon-silent bodies (Gate0 atmosphere/hydrosphere, Gate1 economic_role/economic_base); add explicit frontmatter for the 3 override bodies still needing it (Solandar=NativeMirror, GJ-524=NativeMirror [uninhabited-but-alive → default would mis-Airless it], Edict/GJ244Ad=Airless [standard-atm+ice edge case]); ensure generate_wiki round-trips biosphere_class; then the BAKE (run import_from_wiki + generate_wiki → systems.db + regenerated infoboxes, incl. the Linnaeus name propagation) + commit systems.db. Add biosphere_class to BodyParams read set (D-240) as the D-247 code hook. NOTE: the bake is a systems.db binary-artifact commit — consequential, do deliberately.
+- Workstream 4 (alien-ecology vocab → palette): integrate Miri''s biome × register vocabulary (cane/vane/wrack/husk/drum-root native-mirror lexicon + Earth-register names, per her Deliverable 3) into atlas/mosaic.rs + mosaic_constants.toml — extends the temperate/native baseline to the full surface-class × climate-biome × register palette. This also completes T-1084''s biome-awareness. Determinism: lock before generation.
+Miri''s full Deliverable 3 vocab (the source for workstream 4) is in her T-1085 agent report.
+
+Workstream 4 DONE (partial) + committed (5fb34675e): grassland biome-awareness (ClimateBiome from temperature_c+moisture_q → savanna/temperate/boreal/tundra palettes; savanna Forest-copses, tundra lichen/sparse) + Miri''s full biome×register vocab preserved as docs/design/alien-ecology-vocabulary.md. Cold-barren districts now render structured-sparse (D-245 climate-appropriateness): vegetated_districts 8→20, 0→39 on cold bodies. Full suite green, believability golden regenerated. CONTINUATION (noted): Forest biomes (tropical/boreal), Wetland/extreme-class biomes, the introduced-Earth register (needs biosphere_class + the managed layer), and the §8 material follow-up. REMAINING on T-1085: workstream 3 (biosphere_class schema+importer+default-rule+bake) + this WS4 continuation.', NULL, '2026-07-04 18:31:00', '2026-07-04 18:31:00.300', '2026-07-04 18:31:00.300', NULL, 'ed85cfbb06787b402e2cd791d97c1156', 2) ON CONFLICT(hash) DO NOTHING;
@@ -264,3 +264,51 @@ REMAINING:
 - Workstream 3 (biosphere_class plumbing): add nullable bodies.biosphere_class column to systems-schema.sql; teach tooling/db/wiki_sync.py import_from_wiki to read biosphere_class frontmatter + apply the two-gate DEFAULT for canon-silent bodies (Gate0 atmosphere/hydrosphere, Gate1 economic_role/economic_base); add explicit frontmatter for the 3 override bodies still needing it (Solandar=NativeMirror, GJ-524=NativeMirror [uninhabited-but-alive → default would mis-Airless it], Edict/GJ244Ad=Airless [standard-atm+ice edge case]); ensure generate_wiki round-trips biosphere_class; then the BAKE (run import_from_wiki + generate_wiki → systems.db + regenerated infoboxes, incl. the Linnaeus name propagation) + commit systems.db. Add biosphere_class to BodyParams read set (D-240) as the D-247 code hook. NOTE: the bake is a systems.db binary-artifact commit — consequential, do deliberately.
 - Workstream 4 (alien-ecology vocab → palette): integrate Miri''s biome × register vocabulary (cane/vane/wrack/husk/drum-root native-mirror lexicon + Earth-register names, per her Deliverable 3) into atlas/mosaic.rs + mosaic_constants.toml — extends the temperate/native baseline to the full surface-class × climate-biome × register palette. This also completes T-1084''s biome-awareness. Determinism: lock before generation.
 Miri''s full Deliverable 3 vocab (the source for workstream 4) is in her T-1085 agent report.', 'in_progress', 'medium', 'miri', NULL, 'D-247', '2026-07-02 20:30:57.222', '2026-07-03 20:40:15.305', NULL, '83246ebc2aa0550f44afd68721efb9d4', 2) ON CONFLICT(record_id) DO UPDATE SET type=excluded.type, parent_record_id=excluded.parent_record_id, title=excluded.title, description=excluded.description, status=excluded.status, priority=excluded.priority, assigned_to=excluded.assigned_to, team=excluded.team, decision_ref=excluded.decision_ref, updated_at=excluded.updated_at, deleted_at=excluded.deleted_at, hash=excluded.hash, canonical_version=excluded.canonical_version WHERE excluded.updated_at > tickets.updated_at OR (excluded.updated_at = tickets.updated_at AND excluded.hash > tickets.hash);
+INSERT INTO tickets (record_id, type, parent_record_id, title, description, status, priority, assigned_to, team, decision_ref, created_at, updated_at, deleted_at, hash, canonical_version) VALUES ('06FJ91R8RV38BJXGB2V55FP3B8', 'story', '06FGSJNP8YM537DJCC82ZD6544', 'Biosphere register (D-247) — chirality bits, wiki continuity, biosphere_class authoring + alien-ecology vocab', 'Operationalize the D-247 native-biosphere premise. Full brief appended.
+
+---
+BRIEF (2026-07-02) — governing record: D-247 (governance/decisions/content.md); consumer: D-246 / T-1084 mosaic register.
+
+WHAT THIS IS
+D-247 established that habitable Reach worlds were alive before humans (the settlement timeline forbids terraforming from dead rock), and that an AUTHORED per-world chirality bit gates whether native life is edible. This ticket turns that canon into data + reconciled wiki + the vocabulary the mosaic needs. Owner: Miri (worldbuilding/continuity). Stakeholder: Burnelli (food-import economics). Co-maintainer for the vocab: Araminta (visual grammar, per the T-995 ObjectTag precedent).
+
+THE MODEL (locked in D-247 — do not re-litigate, apply it):
+- `biosphere_class ∈ {NativeCompatible, NativeMirror, TerraformedSterile, Airless}`. It is an AUTHORED INPUT, never seed-derived — it follows a world''s economic/cultural identity.
+- Compatible ("levo") = edible; coupling *permits* an authored hazard but does not force it (most are benign gardens).
+- Mirror ("dextro") = inedible but *guaranteed* inert (can''t infect/poison — safe to study).
+- "Safe" ≠ "edible" — decoupled. Bio-safe is guaranteed on Mirror; food-safe is Compatible-only.
+- Achiral seam (always works either way): breathe air, drink water, mine ore, burn/build with native biomass. Only eat/metabolize/medicate/infect/chirally-poison are gated.
+- ~50/50 Compatible:Mirror is a DESIGN TARGET across canon-silent worlds, not a per-world draw.
+
+WORKSTREAMS
+1. CHIRALITY ASSIGNMENT (Miri). Give every inhabited body a biosphere_class by authored identity: principled default from `economic_base_primary` + `planet_class` (food/drink exporters → Compatible; dead+maintained-atmosphere → TerraformedSterile), explicit overrides where canon speaks. Locked exemplars: Arbour (GJ-338B)=Compatible; Solandar (GJ-827)=Mirror; Keid (GJ-166A)=Compatible (preserved *from exploitation* of edible alien life — the stronger conservation motive; Solandar is the Mirror-inert preserve); Oshima (GJ-79)=TerraformedSterile. Hit the ~50/50 target across the silent remainder.
+2. WIKI CONTINUITY (Miri). Reconcile the entries that already gesture at native biochemistry so each is consistent with its assigned bit + the mechanism: GJ-827, GJ-524, GJ-166A, GJ-684A, GJ-197, GJ-79, GJ-124 (resolve whether Hạ Long''s "protein" is native-Compatible harvest or Earth aquaculture). Additive/explanatory, not contradictory — preserve deliberately-vague lines as intentional.
+3. biosphere_class AUTHORING PATH (asset-pipeline discipline — schema + source + values together, per .claude/rules/asset-pipeline.md). Add `biosphere_class` to wiki body frontmatter (where `substrate:` already lives), a nullable `bodies.biosphere_class` column in systems-schema.sql + MIGRATION_SQL, and importer read. NOT needed for D-246; lands with this pass.
+4. ALIEN-ECOLOGY VOCABULARY (Miri + Araminta) — feeds T-1084 directly. The mosaic palette is keyed on surface-class × climate-biome × biosphere-register (D-246 Palette-key). Provide the micro-habitat NAMES per biome × register: native-mirror niches get *alien* clade names (Solandar''s "five kingdoms" flavor); introduced-Earth niches get Earth names (wheatfield, orchard, pasture). Fill the fixed niche spine (canopy / understory / wet-hollow / pioneer / bare) per climate-biome (savanna gallery-copse, tundra thermokarst / lichen-heath, boreal muskeg / deadfall, …). DETERMINISM: the vocab must be fixed before T-1084 generates its first world (a later addition re-rolls affected voxels). Table size is not a perf/storage concern — author generously but to taste (~100k is headroom, not a target).
+
+BURNELLI (stakeholder, follow-on): a food-supply demand primitive keyed on biosphere_class (Mirror + frontier → import dependency; Compatible → local-food capable). Phase-2 economy consumer; does not block this ticket.
+
+CONSTRAINTS
+- Authored input, not derivation (Arbour''s estate food must never be coin-flipped inedible).
+- Semantic axes stay clade-agnostic (Forest = canopy whether oak or mega-fungus); the register skins niches, it does not change gameplay semantics.
+- The mosaic geometry is chirality-blind — this work does NOT touch voxel geometry, only edibility/economy/naming/vocab.
+
+Chirality decisions resolved (2026-07-02, with Jeroen):
+- Locked exemplars: Arbour=NativeCompatible, Solandar=NativeMirror, Keid=NativeCompatible, Oshima=TerraformedSterile.
+- Miri assignments accepted: GJ-524=Mirror, Freyburg(GJ-684A)=Compatible, Hạ Long(GJ-124)=Compatible (native-Compatible harvest, per her rationale).
+- USER OVERRIDES: Puerto Último(GJ-197)=NativeCompatible (breadbasket identity over Miri''s balance-motivated Mirror). Edict/Sirius(GJ-244A)=Airless — keep the world harsh/frozen (deliberately-inconvenient below-grade transit capital is load-bearing canon); no climate change; below-grade sealed habitat = no open-air biosphere.
+- Two-gate default rule ACCEPTED for canon-silent worlds: Gate 0 (habitability from atmosphere/hydrosphere frontmatter → Airless / TerraformedSterile / Alive), Gate 1 (Compatible vs Mirror from economic_base_primary; agriculture→Compatible near-lock, penal→Mirror, research→50/50 lever).
+- NAMING: Keid''s habitable body renamed Cadwal→(pending final pick; rec Linnaeus — pairs with Solander, its student naturalist; or Beagle). Capital stays ''Vance'' (already the author tribute). Miri''s IP flag (Cadwal = Vance''s exact book title) is the driver.
+- Still to APPLY: the 7 additive wiki continuity edits (Miri specified exact text), the biosphere_class frontmatter+schema+importer plumbing (workstream 3), and the Cadwal→<name> rename across wiki + the GJ166A atlas proposal.
+
+NAMING CONFIRMED: Keid''s habitable body Cadwal → Linnaeus (the great classifier; ties to Solander/Solandar taxonomy + the ''five kingdoms''). Capital stays Vance.
+
+PROGRESS 2026-07-03: Workstreams 1-2 DONE + committed (388168eef, branch micro-habitat-mosaic).
+- Cadwal→Linnaeus rename applied (body frontmatter name + biosphere_class:NativeCompatible, GJ-166A infobox, atlas proposal, D-247 clarified). Capital stays Vance.
+- 5 wiki continuity edits applied (GJ-524 Mirror, GJ-166A/Keid Compatible, GJ-684A Freyburg Compatible, GJ-124 Hạ Long Compatible, GJ-197 Puerto Último Compatible). Solandar/Oshima needed none.
+REMAINING:
+- Workstream 3 (biosphere_class plumbing): add nullable bodies.biosphere_class column to systems-schema.sql; teach tooling/db/wiki_sync.py import_from_wiki to read biosphere_class frontmatter + apply the two-gate DEFAULT for canon-silent bodies (Gate0 atmosphere/hydrosphere, Gate1 economic_role/economic_base); add explicit frontmatter for the 3 override bodies still needing it (Solandar=NativeMirror, GJ-524=NativeMirror [uninhabited-but-alive → default would mis-Airless it], Edict/GJ244Ad=Airless [standard-atm+ice edge case]); ensure generate_wiki round-trips biosphere_class; then the BAKE (run import_from_wiki + generate_wiki → systems.db + regenerated infoboxes, incl. the Linnaeus name propagation) + commit systems.db. Add biosphere_class to BodyParams read set (D-240) as the D-247 code hook. NOTE: the bake is a systems.db binary-artifact commit — consequential, do deliberately.
+- Workstream 4 (alien-ecology vocab → palette): integrate Miri''s biome × register vocabulary (cane/vane/wrack/husk/drum-root native-mirror lexicon + Earth-register names, per her Deliverable 3) into atlas/mosaic.rs + mosaic_constants.toml — extends the temperate/native baseline to the full surface-class × climate-biome × register palette. This also completes T-1084''s biome-awareness. Determinism: lock before generation.
+Miri''s full Deliverable 3 vocab (the source for workstream 4) is in her T-1085 agent report.
+
+Workstream 4 DONE (partial) + committed (5fb34675e): grassland biome-awareness (ClimateBiome from temperature_c+moisture_q → savanna/temperate/boreal/tundra palettes; savanna Forest-copses, tundra lichen/sparse) + Miri''s full biome×register vocab preserved as docs/design/alien-ecology-vocabulary.md. Cold-barren districts now render structured-sparse (D-245 climate-appropriateness): vegetated_districts 8→20, 0→39 on cold bodies. Full suite green, believability golden regenerated. CONTINUATION (noted): Forest biomes (tropical/boreal), Wetland/extreme-class biomes, the introduced-Earth register (needs biosphere_class + the managed layer), and the §8 material follow-up. REMAINING on T-1085: workstream 3 (biosphere_class schema+importer+default-rule+bake) + this WS4 continuation.', 'in_progress', 'medium', 'miri', NULL, 'D-247', '2026-07-02 20:30:57.222', '2026-07-04 18:31:00.300', NULL, '3ff69149b0067dade2dbd718125be6b1', 2) ON CONFLICT(record_id) DO UPDATE SET type=excluded.type, parent_record_id=excluded.parent_record_id, title=excluded.title, description=excluded.description, status=excluded.status, priority=excluded.priority, assigned_to=excluded.assigned_to, team=excluded.team, decision_ref=excluded.decision_ref, updated_at=excluded.updated_at, deleted_at=excluded.deleted_at, hash=excluded.hash, canonical_version=excluded.canonical_version WHERE excluded.updated_at > tickets.updated_at OR (excluded.updated_at = tickets.updated_at AND excluded.hash > tickets.hash);
@@ -166,6 +166,7 @@ CREATE TABLE IF NOT EXISTS bodies (
    rotation_period_hours REAL,        -- rotation period in Earth hours (Earth = 24), NULL for tidally locked/gas giants
    planet_class TEXT,                 -- temperate, arid, frozen, oceanic, volcanic, barren, etc.
    hydrosphere TEXT,                  -- ocean, ice, rivers, none, subsurface
+    biosphere_class TEXT,              -- D-247: NativeCompatible | NativeMirror | TerraformedSterile | Airless (NULL until authored/defaulted)

    -- Settlement
    inhabited INTEGER NOT NULL DEFAULT 0,
@@ -202,3 +202,134 @@ def populate_axial_tilt_deg(conn: sqlite3.Connection, dry_run: bool) -> int:
        )

    return len(updates)
+
+
+def populate_biosphere_class(conn: sqlite3.Connection, dry_run: bool) -> int:
+    """Populate bodies.biosphere_class (D-247, T-1085).
+
+    Reads ``environment.biosphere_class`` from each body's index.md frontmatter (the
+    AUTHORED override) and, where absent, applies the D-247 two-gate default from the
+    body's atmosphere / hydrosphere / inhabited flag + the system's
+    ``economic_base_primary``. Recomputes for ALL bodies each run (the value is fully
+    determined by frontmatter + the default, with no other authoritative writer to
+    preserve), so an edited override re-applies on the next regen.
+
+    Authored input, not seed entropy (D-247): the default is a function of other
+    AUTHORED fields, and explicit frontmatter always wins.
+      - Gate 0 (habitability): uninhabited or no atmosphere -> Airless; inhabited +
+        thin atmosphere -> engineered -> TerraformedSterile; inhabited + real
+        atmosphere + open liquid water -> Alive -> Gate 1; inhabited + real atmosphere
+        but no liquid water (ice/subsurface) -> sealed/engineered -> Airless.
+      - Gate 1 (Compatible vs Mirror): agriculture/service exporters -> Compatible;
+        penal/extraction/manufacturing -> Mirror; the neutral remainder -> a stable
+        body_id split toward the ~50/50 design target (canon worlds carry explicit
+        frontmatter overrides, so they never depend on this split).
+    """
+    import glob as _glob
+    import hashlib
+
+    try:
+        import yaml as _yaml
+
+        _has_yaml = True
+    except ImportError:
+        _has_yaml = False
+
+    def _biosphere_from_frontmatter(text: str) -> tuple[str | None, str | None]:
+        """Return ``(body_id, biosphere_class)`` from a body's frontmatter, or (None, None)."""
+        lines = text.split("\n")
+        if not lines or lines[0].strip() != "---":
+            return (None, None)
+        end = None
+        for i, line in enumerate(lines[1:], 1):
+            if line.strip() == "---":
+                end = i
+                break
+        if end is None:
+            return (None, None)
+        block_lines = lines[1:end]
+        if _has_yaml:
+            try:
+                fm = _yaml.safe_load("\n".join(block_lines))
+            except Exception:
+                fm = None
+            if isinstance(fm, dict):
+                env = fm.get("environment")
+                bc = env.get("biosphere_class") if isinstance(env, dict) else None
+                return (str(fm.get("id")) if fm.get("id") else None, str(bc) if bc else None)
+            return (None, None)
+        # Manual fallback: scan `id:` and `environment.biosphere_class`.
+        body_id = None
+        bc = None
+        in_env = False
+        for line in block_lines:
+            stripped = line.strip()
+            if stripped.startswith("id:"):
+                body_id = stripped.partition(":")[2].strip() or None
+            if stripped == "environment:":
+                in_env = True
+                continue
+            if in_env:
+                if line and not line[0].isspace():
+                    in_env = False
+                elif stripped.startswith("biosphere_class:"):
+                    bc = stripped.partition(":")[2].strip() or None
+        return (body_id, bc)
+
+    # 1. Authored overrides from frontmatter.
+    override: dict[str, str] = {}
+    body_files = sorted(_glob.glob(str(WIKI_STAR_SYSTEMS / "*" / "bodies" / "*" / "index.md")))
+    for fpath in body_files:
+        try:
+            text = Path(fpath).read_text(encoding="utf-8")
+        except OSError:
+            continue
+        body_id, bc = _biosphere_from_frontmatter(text)
+        if body_id and bc:
+            override[body_id] = bc
+
+    # 2. Bodies needing a value + the inputs for the two-gate default.
+    # Recompute for ALL bodies every run: biosphere_class has no other authoritative
+    # writer (unlike axial_tilt/radius, which preserve future column writes) — the
+    # frontmatter override + two-gate default are its complete, deterministic source, so
+    # an edited override must re-apply on the next regen.
+    rows = conn.execute(
+        """
+        SELECT b.body_id, b.inhabited, b.atmosphere, b.hydrosphere, e.economic_base_primary
+        FROM bodies b
+        LEFT JOIN system_economy e ON e.system_id = b.system_id
+        """
+    ).fetchall()
+
+    _LIQUID = ("ocean", "liquid", "rivers", "moderate", "extensive", "coastal", "lakes")
+
+    def _default(inhabited, atmosphere, hydrosphere, econ, body_id) -> str:
+        atm = (atmosphere or "").strip().lower()
+        hyd = (hydrosphere or "").strip().lower()
+        # Gate 0 — habitability.
+        if not inhabited or atm in ("", "none", "trace"):
+            return "Airless"
+        if atm == "thin":
+            return "TerraformedSterile"
+        if not any(k in hyd for k in _LIQUID):
+            return "Airless"  # real atmosphere, no open liquid water -> sealed/engineered
+        # Gate 1 — Compatible vs Mirror (Alive).
+        base = (econ or "").strip().lower()
+        if "agricultur" in base or "service" in base:
+            return "NativeCompatible"
+        if "penal" in base or "extract" in base or "manufactur" in base:
+            return "NativeMirror"
+        h = int(hashlib.sha1(str(body_id).encode()).hexdigest(), 16)
+        return "NativeCompatible" if h % 2 == 0 else "NativeMirror"
+
+    updates: list[tuple[str, str]] = []
+    for body_id, inhabited, atmosphere, hydrosphere, econ in rows:
+        val = override.get(body_id) or _default(inhabited, atmosphere, hydrosphere, econ, body_id)
+        updates.append((val, body_id))
+
+    if not dry_run and updates:
+        conn.executemany(
+            "UPDATE bodies SET biosphere_class = ? WHERE body_id = ?", updates
+        )
+
+    return len(updates)
@@ -320,6 +320,7 @@ COLUMN_MIGRATIONS: list[tuple[str, str, str]] = [
    ("brand_products", "price_tier", "TEXT"),
    ("bodies", "body_radius_km", "REAL"),  # D-204 — physical radius in km, nullable
    ("bodies", "axial_tilt_deg", "REAL"),  # T-1024, D-239 §2 — axial tilt from body-def frontmatter
+    ("bodies", "biosphere_class", "TEXT"),  # D-247, T-1085 — chirality/edibility register from body frontmatter + two-gate default
    ("meta", "schema_sha", "TEXT"),
    ("atlas_city_names", "settlement_class", "TEXT"),  # D-196 — NULL until placement (#37)
    ("system_economy", "economic_specialization", "TEXT"),  # D-237 — authored specialization layer
@@ -223,10 +223,15 @@ def main() -> None:
        print(f"        {n_bias} body trait-bias rows")

        # 16. axial_tilt_deg from body-def frontmatter (T-1024, D-239 §2)
-        print("  [16/16] Populating axial_tilt_deg from body-def frontmatter...")
+        print("  [16/17] Populating axial_tilt_deg from body-def frontmatter...")
        n_tilt = bodies.populate_axial_tilt_deg(conn, args.dry_run)
        print(f"        {n_tilt} bodies updated with axial_tilt_deg")

+        # 17. biosphere_class from body frontmatter override + two-gate default (D-247, T-1085)
+        print("  [17/17] Populating biosphere_class (D-247)...")
+        n_bio = bodies.populate_biosphere_class(conn, args.dry_run)
+        print(f"        {n_bio} bodies updated with biosphere_class")
+
        # Validate structural integrity (FK, chain refs, chain completeness).
        # These errors indicate broken imported data — do NOT commit.
        print("\n  Validating structural integrity...")
@@ -30,6 +30,7 @@ environment:
  uv_index: moderate
  substrate: silicate
  chemosynthetic: false
+  biosphere_class: NativeCompatible
  hydrosphere: liquid_water
 clouds:
  enabled: true
@@ -30,6 +30,7 @@ environment:
  uv_index: moderate
  substrate: silicate
  chemosynthetic: false
+  biosphere_class: NativeMirror
  hydrosphere: liquid_water
 clouds:
  enabled: true
@@ -30,6 +30,7 @@ environment:
  uv_index: high
  substrate: silicate
  chemosynthetic: false
+  biosphere_class: NativeMirror
  hydrosphere: liquid_water
 clouds:
  enabled: true