Implement terrain symbol generation profiles

docs/AGE_PROFILES.md

@@ -30,15 +30,35 @@ resources and can be overridden by a higher-priority pack. The example under
 directory. Valid custom profiles join the stable, sorted pool used when a new
 Age rolls its base terrain; the selected ID is then persisted with that Age.
 
+Each built-in profile now has a matching `terrain/<name>` Symbol Page. Put one
+of those pages after the Link Panel in a Book Binder to select that terrain
+instead of the seed-selected random profile. Standard, Amplified, and Cave use
+their corresponding registered noise settings; Island uses Minecraft's
+floating-islands noise settings; Flat and Void use flat-source generators.
+The Cave and Island pages are Rivencraft terrain choices based on existing
+profiles, not claims that Legacy had identically named terrain symbols.
+Every family retains a safe cobblestone arrival platform. An omitted terrain
+page still uses the deterministic seed-selected profile.
+
 ## Persistence and reload behavior
 
 An Age permanently stores its selected profile ID, generation version, seed,
-and rolled traits. `/reload` replaces the profile definitions but does not
-reroll those immutable values. An unloaded Age resolves its stored profile
-again when it loads, so intentional profile overrides affect its runtime
-resources and newly generated chunks.
+and rolled traits. For an **authored** Age, the generation plan also stores a
+copy of the resolved runtime profile: terrain shape, noise settings, biome
+preset, and dimension type. `/reload` cannot reinterpret that plan; an unloaded
+authored Age uses the saved profile snapshot when it loads, even if the defining
+symbol or profile JSON has since changed. An older, page-free Age has no plan
+and continues to resolve its saved profile ID at load time.
 
-A profile removed after an Age was created resolves to `rivencraft:standard`.
+Registered noise, biome-preset, and dimension-type IDs are validated when
+profiles load. Before loading an authored Age, the saved references are checked
+again. If a data pack supplying one has been removed, the dimension stays
+unloaded and the log identifies the missing resource; the Age's plan is not
+silently replaced. Restore the pack to load that Age. A custom dimension type
+retains its own skylight capability: normal lighting cannot make a Nether-style
+type skylit.
+
+A profile removed after a page-free Age was created resolves to `rivencraft:standard`.
 The legacy `rivencraft:random_vanilla` alias also resolves to `standard`.
 Rivencraft logs this fallback. Invalid built-in overrides do not replace the
 required built-in definitions; a reload fails if a required built-in profile

docs/GAMETESTS.md

@@ -34,11 +34,10 @@ Immersive Portals. The core suite delegates to the original regression methods
 for its selected cases, so the two suites do not maintain duplicate test logic.
 
 GameTest Ages are created in `build/gametest-run/world`, not in a development
-client save. Every default GameTest invocation starts with a fresh world. If
-tests fail, Gradle moves the world under `build/gametest-run/failed-worlds/`
-for inspection. A retry starts fresh but keeps those failed worlds; the next
-successful run removes them and its own world. A forcibly killed run may leave
-`world` behind; the next run preserves it as a failure snapshot before starting.
+client save. Every default GameTest invocation starts with a fresh world.
+Minecraft 1.21.1's GameTest server uses the fixed seed `0`. Gradle deletes the
+world after every run, whether tests pass or fail. A forcibly killed run may
+leave `world` behind; the next run deletes it before starting.
 Logs and configuration remain available. Cleanup never targets a custom
 `-PgameTestRunDir` or a player world; callers using a custom directory manage
 it themselves. The full suite should still be run

docs/WRITING_GRAMMAR.md

@@ -8,4 +8,6 @@ The supported order follows the representable subset of the [Legacy grammar audi
 
 Missing terrain, controller, weather, lighting, celestial, or the controller's minimum biome count is an **incomplete** warning, not an error: the compiler retains the seed-selected profile and traits for missing branches. The minimum is zero for Native, one for Single, two for Tiled/Grid, and three for Tiny–Huge. Native cannot consume authored biome pages; Single accepts only one. Unknown IDs, schema-v1 display-only symbols, wrong ordering, misplaced modifiers, duplicates, conflicts, missing/extra Link Panels, and oversized writing are errors. The Binder disables output and exposes the first error on the result-slot tooltip. When that error belongs to a page, its thumbnail is tinted and outlined red, the strip scrolls to it, and hovering it shows the diagnostic. This maps the parser's compact entry position back through any empty page positions. Rejected inputs remain removable. Binding an unwritten Descriptive Book rechecks its server-owned writing and reports the first error without creating an Age. A terrain symbol whose profile is unavailable is also rejected before Binder inputs are consumed.
 
-The plan stores the original writing order, the authoritative semantic value of each resolved symbol, the Age seed, and a copy of the selected runtime profile. An explicit terrain page replaces the random terrain selection; an omitted terrain uses the seed-selected profile. Age loading uses the frozen runtime profile and does not need the original symbol definition or runtime-profile JSON. Existing bound books without plans are not reinterpreted. Page-free and Link-Panel-only books keep the pre-existing random path. Biome, lighting, weather, celestial, and feature effects are retained in the plan but will be applied in issues #33–#35; instability remains Milestone 6 work.
+The plan stores the original writing order, the authoritative semantic value of each resolved symbol, the Age seed, and a copy of the selected runtime profile. An explicit terrain page replaces the random terrain selection; an omitted terrain uses the seed-selected profile. The built-in Standard, Amplified, Cave, Island, Flat, and Void terrain pages now select their matching generation resources. Age loading uses the frozen runtime profile and does not need the original symbol definition or runtime-profile JSON, though its referenced noise, biome-preset, and dimension-type registry entries must remain available. Existing bound books without plans are not reinterpreted. Page-free and Link-Panel-only books keep the pre-existing random path. Biome, lighting, weather, celestial, and feature effects are retained in the plan but will be applied in issues #33–#35; instability remains Milestone 6 work.
+
+The Rivencraft Pages creative tab reads a generated index of bundled symbol definitions. Adding another valid JSON symbol under `src/main/resources/data/rivencraft/rivencraft/symbols/` includes its page automatically in the next build; no Java starter-page list needs updating. The server catalog still decides whether that page is valid for writing. External server data-pack symbols are not included in this bundled index.