From e238801d0bd3b4bb7365cddb96acb84bf896cc6d Mon Sep 17 00:00:00 2001 From: dingo Date: Thu, 15 Oct 2026 22:47:59 -0400 Subject: [PATCH] M12.1: define ecological identity and time evidence --- docs/ROADMAP.md | 6 ++ docs/STATUS.md | 11 ++ ...3-ecological-identity-and-time-evidence.md | 87 +++++++++++++++ docs/adr/README.md | 2 + docs/architecture/DECISION_REGISTER.md | 8 +- docs/architecture/OPEN_QUESTIONS.md | 8 +- docs/biology/ECOLOGICAL_IDENTITY_AND_TIME.md | 101 ++++++++++++++++++ docs/biology/ECOLOGY_MODEL.md | 7 ++ docs/engineering/M12_DELIVERY_PLAN.md | 43 ++++++++ docs/engineering/VALIDATION.md | 15 +++ schemas/ecology/identity-and-time-v1.md | 43 ++++++++ 11 files changed, 323 insertions(+), 8 deletions(-) create mode 100644 docs/adr/0133-ecological-identity-and-time-evidence.md create mode 100644 docs/biology/ECOLOGICAL_IDENTITY_AND_TIME.md create mode 100644 docs/engineering/M12_DELIVERY_PLAN.md create mode 100644 schemas/ecology/identity-and-time-v1.md diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 004e92a..4d6e8bc 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -642,6 +642,12 @@ M12 supplies sustained world ecology rather than short-session evidence alone. ## M12 - Persistent ecology +2026-10-15: 12.1 engineering evidence policy and explicit deferrals are documented +in [ADR-0133](adr/0133-ecological-identity-and-time-evidence.md). M11's product +review and 12.2's model qualification remain open; automatic tiers stay disabled. +See the [12.1-12.5 delivery plan](engineering/M12_DELIVERY_PLAN.md) for dependencies +and the resolution required before 12.3-12.5 implementation. + **Goal:** player-derived lineages and ecological consequences survive player absence for days, with defensible aggregation, ancestry and extinction records. diff --git a/docs/STATUS.md b/docs/STATUS.md index c4f17b6..fbaf348 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,5 +1,16 @@ # Project status and next steps +## M12 start - 2026-10-15 + +M12.1 defines ecological identity, viability evidence and time boundaries in +[ADR-0133](adr/0133-ecological-identity-and-time-evidence.md), including explicit +deferral of species algorithms, autonomous mutation, evolving behavior and +whole-world wall-time catch-up. Existing M11 biology and runtime formats remain +unchanged. The [M12 delivery plan](engineering/M12_DELIVERY_PLAN.md) records the +open M11 product review and M12.2 population qualification prerequisites. +Automatic tier selection remains disabled; 12.3-12.5 cannot proceed on M4's +failed aggregation model. + ## Client update - 2026-10-14 (v10) The desktop cellular client now negotiates v10, exposes mutations with funded diff --git a/docs/adr/0133-ecological-identity-and-time-evidence.md b/docs/adr/0133-ecological-identity-and-time-evidence.md new file mode 100644 index 0000000..b64d640 --- /dev/null +++ b/docs/adr/0133-ecological-identity-and-time-evidence.md @@ -0,0 +1,87 @@ +# ADR-0133: Ecological identity, viability evidence and time boundaries + +## Status + +Accepted for M12.1's engineering evidence contract and explicit design deferrals +(2026-10-15). No runtime, biological rule, classification algorithm or persistent +format changes. This does not accept M11's product review or qualify a tier model. + +## Context + +M12 needs a vocabulary that cannot mistake an empty region for a dead lineage. +ADR-0034's archive can answer only for the organisms it records. ADR-0036's cohort +counts and residuals do not establish viability. ADR-0041 rejects all tested +aggregation widths; conservation and deterministic replay do not repair their +false extinctions. M11 now has funded wildlife, permanent death and frozen offline +players, but the M11.9 repeated-life product acceptance is not recorded. + +The founding vision requires player-origin ancestry, permanent history, optional +intelligence and no biological progression while a player is offline. New species, +autonomous mutation or outage mortality must not be inferred from measurement code. + +## Decision + +Use [ECOLOGICAL_IDENTITY_AND_TIME](../biology/ECOLOGICAL_IDENTITY_AND_TIME.md) +and the [v1 evidence contract](../../schemas/ecology/identity-and-time-v1.md). + +- A genome identity denotes an immutable versioned record. A lineage query names + an anchor genome and includes that genome and its descendants; a founder-rooted + lineage includes all its branches. Organism ancestry and genome ancestry remain + distinct. Neither a cohort sample nor a species label invents an individual parent. +- Species are optional, derived and versioned classifications. No species threshold + or algorithm is selected. No plant/animal classes, intelligence requirement, + capability gates or progression mechanics follow from classification. +- Evidence has explicit world/branch, lineage scope, simulated boundary, ownership + coverage and uncertainty. Incomplete evidence yields unknown; local absence is + scoped. Terminal extinction requires reconciled absence of all living members + and viable reserves, with transfers settled or counted, at a complete watermark. + M12.7 must implement and validate that reconciliation before any terminal claim. +- Suspended living players prevent terminal extinction. Dormant cells and funded + eggs/spores would also count if an accepted biological implementation establishes + their viability; they are examples, not newly implemented life stages. Unknown + viability blocks extinction. Generic nutrients and unbacked fractional density + do not establish a recoverable organism. +- Continue M11's exact-copy budding heredity and fixed bounded wildlife controller. + Autonomous mutation, recombination and heritable/evolving behavior are explicitly + deferred pending biological rules, funded transitions and seeded ensemble evidence. + This is a deferral, not a permanent prohibition on autonomous evolution. +- Time means committed simulation ticks at the versioned quantum. Recovery replays + committed inputs; it does not infer biology from elapsed wall time. Whole-world + outage catch-up remains explicitly deferred; retain the existing pause behavior. + A future catch-up policy requires a separate scoped ADR and clone comparison. + M12.4 must service admitted ecological intervals without silently skipping work, + report backlog/freshness, and keep controlled offline biology frozen throughout. + +## Alternatives considered + +Declaring extinction on zero active count ignores suspension and migration. +Treating fractional density as an individual invents unfunded viability; rounding +it away conceals uncertainty. Selecting a species distance, NPC mutation probability +or wall-time mortality now would turn unresolved experiments into game rules. +Calling the M4 fixture a cellular population model conflicts with ADR-0041. + +## Benefits + +Evidence can be reviewed before distributed reconciliation exists. Identity survives +reclassification, tier changes and extinction. Existing M11 behavior and retained +history keep their meaning. + +## Costs + +No classification or autonomous divergence is delivered. Global extinction and +unattended ecology remain later implementation work; uncertainty may persist until +all required owners and stores can be reconciled. + +## Risks + +A documentation schema cannot enforce cross-worker completeness. A future adapter +must prove coverage rather than fill in zeroes. M11 playtest acceptance, a qualified +M11-compatible population model and target-host fallback budgets remain prerequisites +for automatic tier selection, even if every worked history is consistent. + +## Consequences + +Review the worked histories against the founding vision, M11 heredity/freeze and +existing archive/cohort contracts. Keep runtime versions and goldens unchanged. +Track unresolved prerequisites in the [M12 delivery plan](../engineering/M12_DELIVERY_PLAN.md). +Stop M12.3-12.5 implementation expansion while M12.2 qualification is unmet. diff --git a/docs/adr/README.md b/docs/adr/README.md index c8ecac2..03ad669 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -1,5 +1,7 @@ # Architecture decision records +- [ADR-0133: Ecological identity and time evidence](0133-ecological-identity-and-time-evidence.md) - M12.1 engineering evidence, viability/time boundaries and explicit deferrals; no runtime changes or qualified aggregation. + - [ADR-0100: Primitive lives and persistent control](0100-primitive-lives-and-persistent-control.md) - accepted M11.2 direction: finite spawn pools, equal full-grown founders, new cellular checkpoint and atomic life publication. 11.2a adds in-memory funded creation; durability/integration follow. - [ADR-0101: Cellular microhabitat resource sites](0101-cellular-microhabitat-resources.md) - accepted M11.3 direction for finite, conserved sub-voxel food patches; 1 mm pitch is a versioned exploratory tunable, with no meter-scale coupling yet. - [ADR-0102: Bounded cellular space and locomotion trial](0102-cellular-spatial-trial.md) - accepted M11.3 trial direction for finite 2D region bounds, phenotype-limited movement and organism contact; tunable arena dimensions are not world geometry. diff --git a/docs/architecture/DECISION_REGISTER.md b/docs/architecture/DECISION_REGISTER.md index fc17a1f..74ca9aa 100644 --- a/docs/architecture/DECISION_REGISTER.md +++ b/docs/architecture/DECISION_REGISTER.md @@ -130,9 +130,9 @@ example, “Q3 B; Q14 A, with…”); the register will record the choice and an | 8 | Genome representation | A. Extend the immutable developmental-capability record. B. Replace it with literal DNA or a new representation. | A; maintain versioned capability schemas, not literal DNA. | v1 accepted; determine capability expansion/versioning before gameplay; ADR-0030. | | 9 | Developmental body representation | A. Typed developmental/body graph. B. Direct arbitrary mesh editing. | A; geometry must derive from capabilities and validated attachments. | Pending M13 morphology contract; ADR-0031 and OPEN_QUESTIONS. | | 10 | Heredity and reproductive mutation | A. Funded offspring with explicit seeded mutation and parent ancestry. B. Copy the genome unchanged. | A as a design direction; define mutation timing, costs, count, and inheritance before M11 gameplay. | Pending gameplay rule; ADR-0028/0033. | -| 11 | NPC mutation | A. Descendants can diverge under the same bounded mutation rules. B. NPC descendants retain their genome unless a player acts. | A is more consistent with autonomous evolution, but must be simulated and validated before adoption. | Explicitly undecided until M12; ADR-0034/0035. | -| 12 | Species/speciation | A. Derived, versioned biological classification with no class mechanics. B. Player-selected species/class labels. | A; taxonomy must not gate capabilities or progression. | Classification threshold/identity remains open for M12; founding requirement. | -| 13 | Lineage extinction | A. Extinct only with no living members and no viable reserve at any simulation tier. B. Mark extinct when no active individuals remain. | A; aggregate populations and durable reserves must count. | Define viability evidence/reserve semantics before M12; ADR-0034/0036. | +| 11 | NPC mutation | A. Descendants can diverge under the same bounded mutation rules. B. Retain M11 exact-copy budding pending qualification. | B for the current scope; autonomous divergence requires funded biological rules and ensemble evidence. | Explicitly deferred by M12.1; ADR-0133 preserves ADR-0125, not a permanent prohibition. | +| 12 | Species/speciation | A. Optional derived, versioned biological classification with no class mechanics. B. Player-selected species/class labels. | A; taxonomy must not gate capabilities or progression. | ADR-0133 distinguishes organism/genome/lineage/species; classifier and threshold explicitly deferred. | +| 13 | Lineage extinction | A. Extinct only with no living members and no viable reserve at any simulation tier. B. Mark extinct when no active individuals remain. | A; suspended, dormant, reproductive and in-flight evidence must be reconciled; uncertainty prevents terminal extinction. | Evidence semantics in ADR-0133; global reconciliation remains M12.7, local archive status unchanged. | | 14 | Offline player state | A. Remove/park the controlled organism with zero progression and explicit reconnect policy. B. Leave it active in-world and vulnerable. | A; never allow offline farming, and specify whether logout safely removes or leaves a non-progressing body before persistence. | Pending player-persistence design; founding requirement. | | 15 | Cellular-to-multicellular transition | A. Require physiological capability and ecological viability, without a linear ladder. B. Use a fixed progression threshold. | A; transition should emerge from development and available resources. | Pending M14 criteria; biology/world design. | | 16 | Population abstraction math | A. Use the M4 measured fixture bounds. B. Calibrate cohorts against representative multi-genome cellular ecology and declare error envelopes. | B; M4 proves loss can be measured but its numbers do not generalize. | Pending population model; ADR-0036–0041. | @@ -153,7 +153,7 @@ example, “Q3 B; Q14 A, with…”); the register will record the choice and an | 31 | Friend recognition | A. Separate authenticated social signal; no player/NPC tags. B. Show ownership/player labels. | A; this preserves the shared biological presentation requirement. | Principle locked; authorization and presentation details pending social feature. | | 32 | Anti-cheat | A. Server authority, bounded authenticated intents, rate limits and validation. B. Trust client state and reconcile abuses later. | A. | Core policy locked; threat review/abuse coverage continues at M10 and before gameplay; ADR-0017/0091/0097. | | 33 | AI behavior | A. Shared bounded intention interface and deterministic controller. B. Separate AI-only command path. | A; prevent privileged AI outcomes and keep control source separate from biology. | Pending behavior architecture before M11 AI; ADR-0022/0079. | -| 34 | Evolvable behavior | A. Optional heritable behavior capabilities with costs. B. Keep intelligence/behavior fixed and outside evolution. | A as an experiment only; intelligence must remain optional. | Pending M12/R&D; foundational design is explicit. | +| 34 | Evolvable behavior | A. Optional heritable behavior capabilities with costs. B. Retain the fixed bounded M11 wildlife controller for now. | B for the current scope; A remains an experiment and intelligence remains optional. | Explicitly deferred by M12.1/ADR-0133 pending funded heritable-state rules and evidence. | | 35 | Morphology limits | A. Body graph validates material, attachment and genetic capability. B. Allow arbitrary player geometry. | A. | Pending M13; ADR-0030/0031 and body-graph proposal. | | 36 | Procedural animation | A. Prototype IK/gaits/locomotion from morphology. B. Depend on hand-authored species animations. | A; hand-authored animation cannot define the open-ended body system. | R&D pending M13; no early implementation required. | | 37 | Retention | A. Keep genome ancestry permanently and tier older replay/snapshots/backups. B. Retain every raw event and snapshot forever at full resolution. | A; preserve history while defining separate replay/archive retention and verified backup policies. | Ancestry permanence locked; concrete retention periods pending backup design; ADR-0034/0062/0074. | diff --git a/docs/architecture/OPEN_QUESTIONS.md b/docs/architecture/OPEN_QUESTIONS.md index da9f33a..8a6b518 100644 --- a/docs/architecture/OPEN_QUESTIONS.md +++ b/docs/architecture/OPEN_QUESTIONS.md @@ -16,9 +16,9 @@ person. ADR indexes distinguish scoped proof choices from production proposals. | 8 | Genome representation | Immutable versioned developmental capabilities, not DNA | Biology; M3 | | 9 | Developmental body | Typed body graph proposal | Biology/engine; M13 | | 10 | Heredity/reproductive mutation | M11 (ADR-0098): budding; a bud copies its parent's current genome exactly, with ancestry; no mutation at birth. Recombination stays open | Biology/design; M3/M11 | -| 11 | NPC mutation | Undecided; no silent autonomous divergence | Biology/design; M12 | -| 12 | Species/speciation | Derived classifications; no class mechanics | Biology/design; M12 | -| 13 | Lineage extinction | Need world-wide no-living/no-viable-reserve evidence | Ecology; M4/M12 | +| 11 | NPC mutation | Explicitly deferred in M12.1; retain M11 exact-copy budding, no silent autonomous divergence (ADR-0133) | Biology/design; future funded mutation and ensemble gate | +| 12 | Species/speciation | Optional derived versioned classification; classifier/threshold deferred, no class mechanics (ADR-0133) | Biology/design; M12/future classifier gate | +| 13 | Lineage extinction | ADR-0133 scopes evidence across living, suspended, viable reserves and transfers; incomplete viability is unknown, world reconciliation unimplemented | Ecology; M12.7 | | 14 | Offline state | M11 (ADR-0098): biology freezes at once on logout or a detected disconnect; the organism lingers in the world, frozen but vulnerable (tunable, 10 s), then suspends durably; resume in place or at the nearest valid spot within a bounded radius, else it stays suspended. How long suspension is retained stays open | Design/security; before player persistence | | 15 | Multicellular transition | Physiological and ecological criteria unresolved | Design/biology; M14 | | 16 | Population abstraction | Conservative cohort ledger + distributions, ensemble validation | Ecology; M4 | @@ -39,7 +39,7 @@ person. ADR indexes distinguish scoped proof choices from production proposals. | 31 | Friend recognition | Deferred explicitly for M11 (ADR-0098); revisit after the 11.9 playtests. No player/NPC labels | Design; after M11.9 | | 32 | Anti-cheat | Authoritative outcomes plus authenticated bounded intentions | Security; M10 | | 33 | AI behavior | Shared intention interface; bounded deterministic controller. M11 wildlife uses the same intentions as players, with no special biological rules (ADR-0098) | Simulation; M2/M11 | -| 34 | Evolvable behavior | Undecided; intelligence not mandatory | Biology/design; M12/R&D | +| 34 | Evolvable behavior | Explicitly deferred in M12.1; retain bounded fixed controller, intelligence not mandatory (ADR-0133) | Biology/design; funded heritable-state R&D | | 35 | Morphology limits | Development graph validates material, attachment and capability | Biology/design; M13 | | 36 | Procedural animation | Isolated locomotion prototypes; no authored animation dependence | Engine; M13 | | 37 | Retention | Permanent genome ancestry; tiered replay/snapshots/backups | Platform/design; M7/M8 | diff --git a/docs/biology/ECOLOGICAL_IDENTITY_AND_TIME.md b/docs/biology/ECOLOGICAL_IDENTITY_AND_TIME.md new file mode 100644 index 0000000..ef29f4a --- /dev/null +++ b/docs/biology/ECOLOGICAL_IDENTITY_AND_TIME.md @@ -0,0 +1,101 @@ +# Ecological identity and time evidence + +Authority: [ADR-0133](../adr/0133-ecological-identity-and-time-evidence.md). +M12.1 defines evidence and explicit deferrals. The evidence contract is +[identity-and-time-v1](../../schemas/ecology/identity-and-time-v1.md); it is not +an implemented codec or world extinction service. + +## Identity and classification + +An organism has a permanent identity and terminal death. An immutable genome has +its own identity, schema/development versions and retained parent links. A mutation +changes the genome carried by an organism without rewriting its birth record. +Many organisms can carry one genome. A founder-rooted lineage follows all genome +branches from a player-origin founder; a narrower lineage query explicitly names +its anchor genome and includes that genome and all descendants. A census of only +carriers of one genome must say so; it cannot imply that every descendant is absent. + +Species classification is an optional derived view, carrying a classifier version +and parameters if one is later adopted. It may group multiple lineages and may +change without changing ancestry. A genome ID is not a species. No universal species +boundary, fixed class tree, plant/animal split or mandatory intelligence is selected. +Classification grants no capability, account advantage or progression. + +M11 buds inherit the parent's current genome exactly. NPC mutation and recombination +are explicitly deferred, retaining ADR-0125. The shared bounded wildlife intention +controller remains fixed; evolving behavior/learning is also deferred. Reconsider +these with explicit heritable state, funded development, mutation timing, replay +and ensemble evidence. Intelligence must remain optional in any such proposal. + +## Viability and uncertainty + +Living stock includes active individuals, supported progressing cohorts, lingering +players and suspended living players, each with exclusive inventory ownership. +Dormant cells would be living members if a later accepted life-stage contract says +so. Eggs/spores or other reproductive reserves count as viable reserves only with +retained identity/provenance, finite funding and a versioned viable-development +condition. These life stages do not yet exist in the M11 cellular owner. + +In-flight migrants belong to transfer escrow until the durable settlement proves +who owns them. Count the stock once even when both regions retain transfer records. +Timeout or lost contact provides no evidence of death. Unsupported, stale or +ambiguous viability is unknown and prevents terminal extinction. Biomass, nutrients +or energy alone are not viable offspring. A cohort residual is an approximation +obligation, not a materializable organism; unresolved funded residuals require +viability reconciliation rather than rounding to zero or inventing a survivor. + +An observation can report present, absent in its stated scope, or unknown. Terminal +world extinction requires a reconciled watermark covering every relevant owner, +active/cohort stock, dormant/suspended stock, reproductive reserves and transfers. +Every required store must have complete evidence at the same simulation boundary, +or a proved reconciliation to it. No globally complete reconciler exists yet; +the existing archive's `living`/`absent` answers remain archive-local facts. + +Retain genomes, ancestry and accepted extinction evidence permanently. A restored +earlier backup is an explicitly identified rewind/branch with a new evidence +context; it does not resurrect a terminally dead organism in the original history. +M12.6/12.7 must supply the query and reconciliation implementations. + +## Time and outage boundaries + +Biology advances only through owned, committed simulation ticks with the recorded +quantum and rule versions. Batching fixed ticks must not integrate rates once at +a larger timestep. Admission limits and backlog are operational constraints; +they do not kill organisms, drop intervals or fabricate ecological extinction. + +Keep the current whole-world outage pause: no implicit wall-time catch-up on +restart. Selecting wall-time ecological catch-up is explicitly deferred until a +separate ADR defines its horizon, boundary inputs, capacity and clone evidence. +Recovery replays the durable prefix and resumes at the last committed boundary. +Future M12.4 unattended scheduling must continue wildlife without player presence, +within fenced ownership and durable bounded intervals, and report unsimulated +backlog. The existing M11 server still stops when no session or lingering player +keeps the region active; this document does not change that behavior. + +An offline controlled organism stays frozen under ADR-0128 through every interval, +outage and catch-up. It cannot age, feed, mutate, grow or reproduce. A lingering +organism remains vulnerable under the accepted rule; a dead one never resumes. +Suspension has no newly introduced expiry or culling rule. Its retention duration +remains unresolved, so elapsed time alone cannot remove its viability evidence. + +## Worked histories (contract examples, not executed simulations) + +All rows concern a founder-rooted lineage L, at a stated world boundary. New life +stages below are hypothetical and confer no implementation permission. + +| History | Evidence and conclusion | +|---|---| +| Player P buds wildlife W, then P dies | W retains P's current genome and known organism parent. L is present; P's death cannot remove W or the genome history. | +| L branches from genome G to H; G has no carriers | A G-only census is absent, but the G-anchored lineage is present through H. Neither fact defines a species. | +| The last player suspends while wildlife dies | The region has no active carrier, but the suspended player is living stock. L is not terminally extinct and resumes only under ADR-0128. | +| No active cells, one dormant cell at tick 400 | If an accepted dormancy rule proves viability, L is present. If its viability is unverified, world status is unknown, never extinct. | +| Last cell dies; one funded egg or spore remains | Under an accepted development rule, a viable reserve prevents extinction. An unverified reserve gives unknown. A corpse's generic nutrients alone do not count as an egg. | +| Last member moves A to B at tick 500 | A's local absence plus a delayed B receipt is insufficient. Escrow retains the member once until idempotent settlement; a timeout cannot discard or duplicate it. | +| Cohort has zero whole members and residual 250000/1000000 | No whole member can be materialized solely from this count. Resolve funding/viability and approximation uncertainty; neither present-individual count nor terminal extinction follows from rounding. | +| All owners report zero at 600 except disconnected C at 580 | The 600 world watermark is incomplete. Report unknown, retaining C's last observation and backlog. | +| Every required store reconciles to 700 with no living or viable stock | Only an implemented and validated M12.7 reconciler may accept terminal extinction with the retained evidence set. The local archive alone cannot. | +| World stops at 800 and restarts a day later | Replay to the committed boundary. No elapsed-day births, death or offline development are inferred. Pending admitted intervals remain visible; full wall-time catch-up is deferred. | + +The examples cover identity, reserves, transfer ownership, stale evidence and time; +they do not establish demographic fidelity, a species algorithm or a viable +population model. diff --git a/docs/biology/ECOLOGY_MODEL.md b/docs/biology/ECOLOGY_MODEL.md index 75bcaa0..c7107a1 100644 --- a/docs/biology/ECOLOGY_MODEL.md +++ b/docs/biology/ECOLOGY_MODEL.md @@ -1,5 +1,12 @@ # Ecology and simulation fidelity +M12.1's current scoped identity/time policy and explicit deferrals are in +[ECOLOGICAL_IDENTITY_AND_TIME](ECOLOGICAL_IDENTITY_AND_TIME.md) and +[ADR-0133](../adr/0133-ecological-identity-and-time-evidence.md). Historical M4 +sections below retain their original implementation scope; no population model +or automatic tier policy has qualified. See the +[M12 delivery plan](../engineering/M12_DELIVERY_PLAN.md). + Locked: scalable tiers and independent persistent descendants. Contracts below are recommended; population math, lineage/species classifications are experiments. diff --git a/docs/engineering/M12_DELIVERY_PLAN.md b/docs/engineering/M12_DELIVERY_PLAN.md new file mode 100644 index 0000000..d78df0f --- /dev/null +++ b/docs/engineering/M12_DELIVERY_PLAN.md @@ -0,0 +1,43 @@ +# M12.1-12.5 delivery and prerequisite conflicts + +Requested scope: ecological identity, population qualification, durable automatic +tier transitions, unattended scheduling/migration and environmental coupling. +Commit and push each validated scoped segment separately. + +## Gate status (2026-10-15) + +| Subset | State | Evidence or condition for completion | +|---|---|---| +| 12.1 | Engineering evidence policy and explicit deferrals documented | ADR-0133, identity/time contract and worked histories; no new game rules or runtime versions. | +| 12.2 | Qualification open; automatic tier selection disabled | ADR-0041 rejects every tested width. Reproduce failures, then qualify a model against M11 cellular rules with hold-outs and target-host budgets. | +| 12.3 | Blocked on 12.2 | No accepted population model, deterministic durable conversion sample or profile integrating cellular/cohort state. | +| 12.4 | Blocked on 12.2-12.3 | Existing cellular worker pauses without sessions/lingering players; bounded unattended recovery and biological migration escrow remain unimplemented. | +| 12.5 | Blocked on 12.2-12.4 | Finite M6 process fixtures do not qualify coupled persistent cellular/cohort atmosphere/water budgets. | + +M12's roadmap entry also requires the M11 playable-loop product review. The +[M11.9 plan](M11_9_DELIVERY_PLAN.md) records engineering delivery and a first +sign-in playtest, but no completed repeated-life results or product acceptance. +Beginning policy work does not fabricate that acceptance. + +## Architectural conflict and resolution + +Automatic transitions or regional aggregation now would conflict with ADR-0041 +and ECOLOGY_MODEL: the measured model can erase viable populations while exactly +conserving inventory. The M4 test-only model is not the M11 spatial cellular model; +wrapping its in-memory conversion primitives in persistence would not qualify it. +Under the engineering constitution, stop expanding the affected implementation. + +Resolve this by retaining the failed baseline and adding a separately versioned +candidate experiment that preserves relevant age/reserve/genome variation. Before +running it, declare population/biomass/diversity trajectory bounds, extinction +criteria, supported cellular states and hold-out seed/regime splits. Compare +against the accepted M11 controller, contact, contested intake, budding, death and +offline rules. An exact retained-member control can check the instrument but +cannot by itself establish useful aggregation or acceptable target-host cost. + +Measure bin/interval sensitivity, conversion and full-region costs on the Linux +target host, including active fallback capacity and backpressure. Passing the M4 +synthetic envelope alone is insufficient. Record M11's product review separately. +Only then accept the model/tier ADR and proceed to 12.3, followed by owned durable +intervals/escrow in 12.4 and versioned finite resource coupling in 12.5. No World0 +deployment or promotion follows from these gates. diff --git a/docs/engineering/VALIDATION.md b/docs/engineering/VALIDATION.md index 38a7f5b..552a92b 100644 --- a/docs/engineering/VALIDATION.md +++ b/docs/engineering/VALIDATION.md @@ -1,5 +1,20 @@ # Validation report +## 2026-10-15 - M12.1 identity and time evidence + +Documentation-only segment: ADR-0133, ecological identity/time policy, semantic +evidence schema, worked histories and M12 prerequisite plan. Reviewed against +the founding vision, engineering constitution, archive/cohort public contracts, +ADR-0034/0036/0040/0041 and M11 heredity/freeze rules. Updated the decision register, +open questions, roadmap and status together. Runtime formats and goldens unchanged. + +Executed: `git diff --check` and relative Markdown link validation for all four +new documents (7 links, all resolve). Worked histories are reviewed contract +examples, not executed simulations. No C++ changes, so builds, clang-format, +clang-tidy and sanitizers were not required for this segment. M11 product review +and M12.2 model/target-host qualification remain open; no unattended-world, +extinction-reconciliation or production population claim is made. + Recorded 2026-09-19; subsequent gate evidence is appended by date below. Latest historical verified Linux delivery at the time of the foundation report was **run 1402** on `4c2cc04ac47d37c6191a9ef02d4bbba716a930dc`. Native check history and later diff --git a/schemas/ecology/identity-and-time-v1.md b/schemas/ecology/identity-and-time-v1.md new file mode 100644 index 0000000..bedfefb --- /dev/null +++ b/schemas/ecology/identity-and-time-v1.md @@ -0,0 +1,43 @@ +# Ecological identity and time evidence v1 + +Authority: [ADR-0133](../../docs/adr/0133-ecological-identity-and-time-evidence.md). +This is a semantic contract for later M12.6/12.7 adapters, not a wire format, +database migration, C++ API or claim of implemented world reconciliation. + +## Evidence envelope + +| Field | Meaning and validation obligation | +|---|---| +| evidence_version | 1; a future writer must reject unsupported versions rather than reinterpret fields. | +| world / history branch | Exact world and recovery branch; observations from clones or rewound histories cannot be merged into the original world. | +| lineage scope | Anchor genome plus descendant closure, or an explicitly labeled exact-genome census; retained ancestry must resolve to player-origin founders. | +| rule / representation versions | Versions used to interpret biological state, viability, units, tick quantum and approximation. | +| simulated boundary | Completed simulation tick; wall-clock observation time is auxiliary freshness metadata and cannot advance biology. | +| coverage | Enumerated required regions, owners/epochs and store categories, with their committed watermarks and reconciliation proofs. Unknown coverage is incomplete. | +| living evidence | Active, cohort, lingering, suspended and supported dormant stocks, with identity/provenance and exclusive ownership; count and approximation uncertainty remain distinct. | +| reserve evidence | Supported reproductive reserves, funding reference and viable/nonviable/unknown judgment under a named rule version; no implicit egg/spore implementation. | +| transfers | Durable transfer identity, source/destination, escrow inventory and settlement state. Count each stock once; unsettled stock must not disappear. | +| uncertainty | Missing/stale stores, unsupported state, unresolved residual viability and model error bounds; an unmeasured bound is unknown rather than zero. | +| conclusion | Present, scoped absence or unknown. A terminal-extinction acceptance additionally requires a validated global reconciliation record, complete coverage, no living/viable stock and no unresolved viability. | + +Absent values mean missing evidence, never zero stock. A store category can be +marked inapplicable only with proof that the world's accepted rules and persisted +state cannot contain that category. A positive living/viable observation refutes +terminal extinction even when other evidence is missing; it does not make the +world census complete. Old observations do not certify current presence or absence. + +Terminal-extinction records must retain the evidence references, reconciliation +version, boundary and acceptance identity permanently. No existing local archive +status is upgraded to terminal extinction by adopting this document. + +## Deferred classifications and time policy + +Species output is absent until a classifier is accepted. Future output must include +classifier version/parameters and genome membership; changing it never rewrites +genome/organism identity or parentage. + +The current outage policy is pause at the committed simulated boundary. No +elapsed-wall-time input belongs in the deterministic biology kernel. Future +unattended intervals require begin/end, owner epoch, rule/quantum identity, +committed prefix and visible backlog. Recovery cannot reroll conversion samples, +re-spend an interval or thaw controlled offline biology.