blueprintcanonicalOWNER-2026-07-10

BP-003 — CODELAND Spatial Organization Engine · bp-003-codeland-engine

Owner directive (2026-07-10), canonical. Scenarios become complete biomes with film-set realism; every org gets a Dynamic Island; the <C/_ page edits every PAD/POD/scenery; the Lab configures the three OSes; versioned cores propagate updates to all instances; squads descend from Warden/Aura/Essentia with the Construct from domanar. Archived as prompts-archive entry 337.

Content

The program that evolves spatial-site into the CODELAND engine: ten shippable stages, each deployed on completion.

Rulings (D1–D10):

  1. Versioned cores — kernel = packages/engine (semver, 2.0.0); new packages/cogni (versioned rules + evaluator); genome schema_version (v2) with hand-rolled validator + migrations; a cores stamp block in every genome; scripts/regen-all.ts = "update once, update all"; CI check-cores compat gate.
  2. Multi-org — ONE static export, /o/<slug>/ routes over library/genomes/orgs/*.json; subdomain-ready via nginx rewrite later. Bake tiers: deep (mainland, sollex, bastion, remotica — full arc, unique assets) / standard (~12 orgs — shared archetype packs + cheap per-org splat recolor) / light (~13 orgs — one ambient slice + anchors). Tier lives in the genome.
  3. gen-3d pipeline — provider abstraction (HFProvider first: TripoSR / InstantMesh / Stable-Fast-3D class single-image→mesh via plain-HTTP Spaces calls; MeshyProvider as the documented example slot; island mode fully local + token-free = dry-run default); hand-rolled minimal GLB reader; mesh-sampler.ts area-weighted sampling into the existing 32-byte SplatFileWriter (loader untouched); realism pass (baked AO, sun lambert, per-biome-archetypes material ramps) applied to generated AND procedural assets; manifest kind: 'generated' with provenance.
  4. In-scene devices — genome-declared anchors {kind: pad|pod, device: DITTO|DOOIT, position, payload} (diegetic-ui); engine devices/ projects anchors + POD dolly-zoom; DOM overlays carry the venture element (3d/text/image/form). DITTO→PAD, DOOIT→POD.
  5. <C/_ editor — dispatch service on hos-neural-engine becomes the gateway: GET/POST /genome/:slug (token, schema-validated patch, git commit to genome-staging branch, 201 commit-sha receipt), POST /genome/:slug/asset-job, GET /gateway/pad/:slug/:pad_id honoring Verify→Validate→Augment→Disponibilize. Notebook gains edit mode with diff + optimistic UI. Merge staging→main triggers rebake+deploy.
  6. The Lab (/lab) — Remotica/Bastion/Mainland tabs: Kernel (components + render devices) / Cogni (rule weights) / Genome panels; live test bench = ambient engine + __hosEngine sliders; Persist = same genome endpoint; OS genomes at library/genomes/os/.
  7. HOS-Webdoc registration — one tight PR: spatial-site district (7-section config), registry 26→27, CLandEndpoint records pointing at engine.mainland.digital.
  8. Squads v2 — every squad stamped lineage warden|aura|essentia (derived from brand_core dominant axis, owner-reviewable); every construct seat lineage domanar; 29 venture-squads generated; one RUN per wave (RUN-019 bakes, RUN-020 Sollex, RUN-021 final wave).
  9. Storytelling — genome story per slice (beats, lens, diegetic labels, sensory fields); sensory-genome + storytelling-lenses rules: ORIGINAL prose only, in nature-writing spirit, blocklist lint against reproducing published authors; docs pb-004 + cb-sensory-genome.
  10. Biome derivation — derive-biome.ts pure function over org theme.variant/palette/motion.brand_art_type/brand_core → archetype (biome-archetypes: Solarpunk Oasis, Cyberpunk Metropolis, Oceanic Rig, Desert Caravan, + Gold Desert for royalorbit); table generated to library/genomes/biome-map.json for owner review; hand-edits win.

Genome v2 delta: +cores{kernel_version,cogni_version,schema_version,baked_with} · +strand.bake_tier · +slices[].anchors[] · +slices[].story{beats,lens,diegetic_labels,sensory} · +strand.world_age · +device_bindings[] · holonprint provenance when generated.

Stage order: S0 archival+schema → S1 cores → S2 gen-3d → S3 biomes+routes → S4 devices → S5 gateway+editor → S6 Lab → S7 Sollex deep → S8 Webdoc+squads → S9 KB/storytelling (parallel lane) → S10 29-org wave. Each stage has its gate; CI budget ceilings per tier (deep ≤60MB, standard ≤15MB, light ≤5MB).

Delta 2026-07-10: gs_config (3DGUT profile)

Per owner directive, the POD's gaussian-splatting layer gains an optional gs_config block (profile 3dgut) whose field names mirror NVIDIA's 3DGRUT config vocabulary. It lives at genome top level (biome default) with per-holonprint override, validated by the hand-rolled genome validator and its vendored gateway copy. The block spans three parameter domains — trainer-side (unscented-transform + densify settings, carried and validated but not runtime-executed), ingest-side (prune/decimate rules the PLY-to-splat converter applies), and runtime-side (spark.*, the only keys the WebGL renderer honors live). It is tunable in The Lab and persistable through the <C/_ editor → dispatch gateway; a parameter Spark cannot honor is carried and round-tripped, never dropped. See cb-3dgut-config.

Composition

See also

Linked from — 3 cards