@reicek/neataptic-ts 0.1.25 → 0.1.26

package/test/examples/flappy_bird/constants/README.md

@@ -47,112 +47,59 @@ flowchart TB
 
 Default host container id for the browser demo mount point.
 
-### FLAPPY_EMULATION_SPEED_MULTIPLIER
-
-Emulation speed multiplier for browser playback (1.5 => 50% faster).
-
-### FLAPPY_HUD_UPDATE_INTERVAL_FRAMES
-
-Update HUD counters every N simulation frames to reduce DOM churn.
-
-The value trades freshness for stability. Updating every frame would make the
-numbers twitchier and force more frequent DOM work on the main thread.
-
-### FLAPPY_BROWSER_POPULATION_SIZE
-
-Default population size for browser playback worker initialization.
-
-The browser default is intentionally smaller than the long-running trainer so
-the interactive demo remains responsive.
-
-### FLAPPY_BROWSER_ELITISM_COUNT
-
-Default elitism count for browser playback worker initialization.
-
-Keeping elitism small in the browser demo emphasizes visible variety over raw
-training efficiency.
-
-### FLAPPY_DEFAULT_RNG_SEED
-
-Deterministic default RNG seed shared by browser runtime and trainer flows.
-
-Reusing one canonical seed makes debugging and README examples more
-repeatable.
-
-### FLAPPY_FLAP_THRESHOLD
-
-Normalized decision threshold used for scalar output flap policies.
-
-### FLAPPY_HALF
-
-Canonical half multiplier for centering and gap math.
-
-### FLAPPY_HUD_ZERO_TEXT
-
-Shared HUD value for integer zero fields.
-
-### FLAPPY_HUD_ZERO_DECIMAL_TEXT
-
-Shared HUD value for decimal zero fields.
-
-### FLAPPY_HUD_OFF_TEXT
-
-Shared HUD value when a metric is intentionally disabled.
-
-### FLAPPY_HUD_INITIALIZING_TEXT
-
-Initial status text displayed before evolution starts.
-
-### FLAPPY_STATUS_PLAYING_TEXT
+### FLAPPY_BIAS_TIER_CENTER_THRESHOLD
 
-Runtime status text shown while a generation playback is running.
+Bias-tier center threshold around zero.
 
-### FLAPPY_STATUS_EVOLVING_TEXT
+### FLAPPY_BIAS_TIER_EDGE_START_ABS_VALUE
 
-Runtime status text shown between playback episodes.
+Bias-tier edge region start magnitude.
 
-### FLAPPY_HUD_UPDATES_WINDOW_MS
+### FLAPPY_BIAS_TIER_MAX_ABS_VALUE
 
-HUD sliding-window size used when computing updates-per-second metric.
+Bias-tier max absolute magnitude used by diverging color tiers.
 
-### FLAPPY_HUD_UPDATES_WINDOW_SECONDS
+### FLAPPY_BIRD_AURA_ALPHA
 
-HUD updates window duration in seconds for per-second conversion.
+Opacity used for the extra Radiant-style aura around each bird.
 
-### FLAPPY_MINOR_GC_WINDOW_MS
+This is intentionally subtle: it should read as a soft bloom that lifts the
+bird off the background, without turning the bird into a big glowing blob.
 
-Sliding-window size used when computing minor GC events per minute.
+### FLAPPY_BIRD_AURA_BLUR_MULTIPLIER
 
-### FLAPPY_PIPE_ENTRY_RIM_INSET_PX
+Blur multiplier used for the Radiant-style bird aura plate.
 
-Inset used for the pipe entrance rim line measured from the gap-facing edge.
+### FLAPPY_BIRD_AURA_EXPAND_PX
 
-### FLAPPY_PIPE_OUTLINE_GLOW_ALPHA
+Pixel expansion used for the Radiant-style bird aura plate.
 
-Opacity used for the soft pipe glow stroke pass.
+### FLAPPY_BIRD_BODY_GLOW_BLUR_PX
 
-### FLAPPY_PIPE_OUTLINE_GLOW_STROKE_WIDTH_PX
+Base neon blur radius used for bird body glow.
 
-Stroke width used for the soft pipe glow stroke pass (pixels).
+### FLAPPY_BIRD_CHAMPION_EXTRA_GLOW_BLUR_PX
 
-### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_COLOR
+Additional blur radius applied to the champion red body glow.
 
-Cyan neon glow used for pipe outline shadow.
+This keeps the champion body bloom aligned with the same neon blur
+intensity used by the pipe outline glow, so the leader reads with
+comparable visual weight.
 
-This intentionally matches the asciiMaze `neonCyan` ANSI color (`\x1b[38;5;87m`)
-which maps to xterm color 87 ~= rgb(95, 255, 255) / hex `#5fffff`.
+### FLAPPY_BIRD_HEIGHT_PX
 
-### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_BLUR_PX
+Bird collision height (diameter, pixels).
 
-Blur radius used for the cyan pipe outline glow (pixels).
+### FLAPPY_BIRD_RADIUS_PX
 
-### FLAPPY_WORLD_WIDTH_PX
+Bird collision radius (pixels).
 
-Width of the simulated world (pixels).
+### FLAPPY_BIRD_VIEWPORT_X_RATIO
 
-### FLAPPY_WORLD_HEIGHT_PX
+Horizontal viewport anchor for the bird.
 
-Height of the simulated world (pixels).
+A value of `0.33` places the bird roughly one-third from the left, leaving
+more lookahead space for incoming pipes.
 
 ### FLAPPY_BIRD_X_PX
 
@@ -161,47 +108,47 @@ Fixed horizontal position of the bird (pixels).
 A fixed x-anchor turns the task into primarily vertical control while pipes
 move left, making policy behavior easier to visualize and debug.
 
-### FLAPPY_BIRD_RADIUS_PX
+### FLAPPY_BOX_MIN_COLUMNS
 
-Bird collision radius (pixels).
+Minimum safe columns for box-drawing helper output.
 
-### FLAPPY_BIRD_HEIGHT_PX
+### FLAPPY_BOX_MIN_ROWS
 
-Bird collision height (diameter, pixels).
+Minimum safe rows for box-drawing helper output.
 
-### FLAPPY_ENABLE_RUNTIME_INSTRUMENTATION
+### FLAPPY_BROWSER_ELITISM_COUNT
 
-Enables runtime telemetry counters used for profiling diagnostics.
+Default elitism count for browser playback worker initialization.
 
-Keep disabled during normal demo runs to avoid instrumentation overhead and
-to preserve a cleaner educational rendering path.
+Keeping elitism small in the browser demo emphasizes visible variety over raw
+training efficiency.
 
-### FLAPPY_MAX_FRAMES_PER_EPISODE
+### FLAPPY_BROWSER_POPULATION_SIZE
 
-Episode terminates after this many frames even if still alive.
+Default population size for browser playback worker initialization.
 
-This prevents extremely long outlier episodes from dominating generation
-runtime and keeps evolution throughput predictable.
+The browser default is intentionally smaller than the long-running trainer so
+the interactive demo remains responsive.
 
-### FLAPPY_GRAVITY_PX_PER_FRAME2
+### FLAPPY_CENTER_BLUE_RAMP
 
-Gravity acceleration applied each frame (pixels/frame²).
+Neutral-center blue ramp for near-zero diverging tiers.
 
-Slightly increased so birds settle faster after each flap and can make
-finer vertical corrections around narrow targets.
+### FLAPPY_CHAMPION_TRAIL_MAX_POINTS
 
-### FLAPPY_FLAP_VELOCITY_PX_PER_FRAME
+Maximum number of trail points retained for the champion-only short trail.
 
-Instantaneous upward velocity applied on flap (pixels/frame).
+### FLAPPY_CONNECTION_TIER_CENTER_THRESHOLD
 
-Reduced so each flap produces a smaller hop, improving precision when
-threading tighter gaps.
+Connection-tier center threshold around zero.
 
-### FLAPPY_MAX_FALL_SPEED_PX_PER_FRAME
+### FLAPPY_CONNECTION_TIER_EDGE_START_ABS_VALUE
 
-Maximum downward speed clamp (pixels/frame).
+Connection-tier edge region start magnitude.
 
-This cap limits runaway fall acceleration and keeps trajectories learnable.
+### FLAPPY_CONNECTION_TIER_MAX_ABS_VALUE
+
+Connection-tier max absolute magnitude used by diverging color tiers.
 
 ### FLAPPY_CONTROL_SUBSTEPS_PER_FRAME
 
@@ -213,191 +160,190 @@ multiple react-and-integrate passes before the frame counter advances.
 This is one of the main levers that keeps high-speed play numerically stable
 without forcing the visible frame rate to explode.
 
-### FLAPPY_TARGET_FLAP_INTERVAL_FRAMES
+### FLAPPY_DEFAULT_RNG_SEED
 
-Target control cadence used for endgame reachability calculations.
+Deterministic default RNG seed shared by browser runtime and trainer flows.
 
-A smaller value means the policy is expected to correct more frequently
-(effectively "jumping more often"), which supports narrower endgame gaps.
+Reusing one canonical seed makes debugging and README examples more
+repeatable.
 
-The value is used analytically when estimating whether a late recovery is
-still plausible, not as the direct execution cadence of the simulation loop.
+### FLAPPY_DIFFICULTY_RAMP_PIPES
 
-### FLAPPY_PIPE_WIDTH_PX
+Pipe-pass count needed to reach maximum adaptive difficulty.
 
-Pipe width (pixels).
+After this point, spacing does not tighten further, so proficient agents can
+sustain long runs without additional spacing compression.
 
-### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
+### FLAPPY_EMULATION_SPEED_MULTIPLIER
 
-Visual gap between the pipe body and its outline on the sides (pixels).
+Emulation speed multiplier for browser playback (1.5 => 50% faster).
 
-### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
+### FLAPPY_ENABLE_RUNTIME_INSTRUMENTATION
 
-Visual gap between the pipe body and its outline at the pipe entrance rim (pixels).
+Enables runtime telemetry counters used for profiling diagnostics.
 
-### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+Keep disabled during normal demo runs to avoid instrumentation overhead and
+to preserve a cleaner educational rendering path.
 
-Stroke width used for the pipe outline (pixels).
+### FLAPPY_FITNESS_ALIGNMENT_WEIGHT_PER_FRAME
 
-### FLAPPY_PIPE_COLLISION_SIDE_EXPAND_PX
+Per-frame reward weight for staying vertically aligned with the next gap.
 
-Effective side expansion used for pipe collision checks (pixels).
+### FLAPPY_FITNESS_APPROACH_PROGRESS_WEIGHT
 
-Includes the visual side gap and half the outline stroke so collision
-matches the visible outer line thickness.
+Reward scale for reducing distance to the next pipe between consecutive frames.
 
-### FLAPPY_PIPE_COLLISION_ENTRANCE_EXPAND_PX
+### FLAPPY_FITNESS_BONUS_PER_PIPE
 
-Effective gap-rim expansion used for pipe collision checks (pixels).
+Fitness bonus added per pipe successfully passed.
 
-Includes the visual entrance gap and half the outline stroke so collision
-matches the visible outer line around the gap opening.
+### FLAPPY_FITNESS_CENTERING_PROGRESS_WEIGHT
 
-### FLAPPY_PIPE_GAP_PX
+Reward scale for reducing vertical error to the next gap center.
 
-Vertical opening size of each pipe gap (pixels).
+### FLAPPY_FITNESS_CLEARANCE_WEIGHT_PER_FRAME
 
-This is the nominal baseline gap before adaptive difficulty narrows it.
+Per-frame reward weight for keeping the bird inside next-gap clearance.
 
-### FLAPPY_PIPE_SPEED_PX_PER_FRAME
+### FLAPPY_FITNESS_SECOND_GAP_ALIGNMENT_WEIGHT_PER_FRAME
 
-Pipe horizontal speed (pixels/frame).
+Per-frame reward weight for pre-aligning with the second upcoming gap.
 
-Higher values shrink reaction time, which makes the same gap geometry much
-harder even before the adaptive curriculum starts tightening gaps.
+### FLAPPY_FITNESS_STABLE_VELOCITY_WEIGHT_PER_FRAME
 
-### FLAPPY_PIPE_SPAWN_INTERVAL_FRAMES
+Per-frame reward weight for maintaining controllable vertical velocity.
 
-Frames between spawning new pipes.
+### FLAPPY_FITNESS_SURVIVAL_WEIGHT
 
-Together with pipe speed, this controls horizontal pacing and how much time a
-policy has to recover between obstacles.
+Fraction of raw frame-survival reward kept in total fitness.
 
-### FLAPPY_PIPE_GAP_CENTER_MIN_Y_PX
+Lower values reduce the incentive to merely stay alive and increase pressure
+to center on gaps and pass pipes cleanly.
 
-Minimum allowed gap center height (pixels).
+### FLAPPY_FITNESS_TERMINAL_ALIGNMENT_BONUS_WEIGHT
 
-### FLAPPY_PIPE_GAP_CENTER_MAX_Y_PX
+Terminal bonus based on final alignment with the next gap center.
 
-Maximum allowed gap center height (pixels).
+### FLAPPY_FITNESS_TERMINAL_PROGRESS_BONUS_WEIGHT
 
-### FLAPPY_MEMORY_CORE_FEATURE_COUNT
+Terminal bonus based on final progress toward the next pipe.
 
-Number of core per-frame observation features retained for temporal stacking.
+### FLAPPY_FLAP_THRESHOLD
 
-### FLAPPY_MEMORY_STACKED_FRAME_COUNT
+Normalized decision threshold used for scalar output flap policies.
 
-Number of temporal frames included in the stacked observation window.
+### FLAPPY_FLAP_VELOCITY_PX_PER_FRAME
 
-### FLAPPY_MEMORY_ACTION_WINDOW_STEPS
+Instantaneous upward velocity applied on flap (pixels/frame).
 
-Number of past actions retained for the action-memory channel.
+Reduced so each flap produces a smaller hop, improving precision when
+threading tighter gaps.
 
-### FLAPPY_NETWORK_INPUT_SIZE
+### FLAPPY_FRAME_GLYPH_ROW_HEIGHT_PX
 
-Number of observation features fed into each Flappy policy network.
+Glyph-row height used for box-drawing rows (pixels).
 
-### FLAPPY_NETWORK_OUTPUT_SIZE
+### FLAPPY_FRAME_MIN_COLUMNS
 
-Number of output action scores emitted by each Flappy policy network.
+Minimum glyph columns to keep frame readable on narrow widths.
 
-### FLAPPY_NETWORK_HIDDEN_LAYER_SIZES
+### FLAPPY_FRAME_MIN_GLYPH_WIDTH_PX
 
-Hidden-layer sizes used to seed initial Flappy policy architectures.
+Minimum measured glyph width fallback (pixels).
 
-Using at least two hidden layers improves representational flexibility for
-precise vertical control near narrow, fast-changing pipe targets.
+### FLAPPY_FRAME_MONOSPACE_FONT
 
-### FLAPPY_FITNESS_BONUS_PER_PIPE
+Reusable monospaced HUD font for glyph-based frame rendering.
 
-Fitness bonus added per pipe successfully passed.
+### FLAPPY_FRAME_RESERVED_COLUMNS
 
-### FLAPPY_FITNESS_SURVIVAL_WEIGHT
+Reserved columns to keep right edge in bounds during metrics fit.
 
-Fraction of raw frame-survival reward kept in total fitness.
+### FLAPPY_GLYPH_BOTTOM_LEFT
 
-Lower values reduce the incentive to merely stay alive and increase pressure
-to center on gaps and pass pipes cleanly.
+Glyph character for bottom-left box corner.
 
-### FLAPPY_FITNESS_ALIGNMENT_WEIGHT_PER_FRAME
+### FLAPPY_GLYPH_BOTTOM_RIGHT
 
-Per-frame reward weight for staying vertically aligned with the next gap.
+Glyph character for bottom-right box corner.
 
-### FLAPPY_FITNESS_APPROACH_PROGRESS_WEIGHT
+### FLAPPY_GLYPH_HORIZONTAL
 
-Reward scale for reducing distance to the next pipe between consecutive frames.
+Glyph character for horizontal box segment.
 
-### FLAPPY_FITNESS_CENTERING_PROGRESS_WEIGHT
+### FLAPPY_GLYPH_SPACE
 
-Reward scale for reducing vertical error to the next gap center.
+Glyph character for interior spacing.
 
-### FLAPPY_FITNESS_CLEARANCE_WEIGHT_PER_FRAME
+### FLAPPY_GLYPH_TOP_LEFT
 
-Per-frame reward weight for keeping the bird inside next-gap clearance.
+Glyph character for top-left box corner.
 
-### FLAPPY_FITNESS_SECOND_GAP_ALIGNMENT_WEIGHT_PER_FRAME
+### FLAPPY_GLYPH_TOP_RIGHT
 
-Per-frame reward weight for pre-aligning with the second upcoming gap.
+Glyph character for top-right box corner.
 
-### FLAPPY_FITNESS_STABLE_VELOCITY_WEIGHT_PER_FRAME
+### FLAPPY_GLYPH_VERTICAL
 
-Per-frame reward weight for maintaining controllable vertical velocity.
+Glyph character for vertical box segment.
 
-### FLAPPY_FITNESS_TERMINAL_ALIGNMENT_BONUS_WEIGHT
+### FLAPPY_GRAVITY_PX_PER_FRAME2
 
-Terminal bonus based on final alignment with the next gap center.
+Gravity acceleration applied each frame (pixels/frame²).
 
-### FLAPPY_FITNESS_TERMINAL_PROGRESS_BONUS_WEIGHT
+Slightly increased so birds settle faster after each flap and can make
+finer vertical corrections around narrow targets.
 
-Terminal bonus based on final progress toward the next pipe.
+### FLAPPY_HALF
 
-### FLAPPY_MIN_CLEARANCE_MARGIN_PX
+Canonical half multiplier for centering and gap math.
 
-Small geometric buffer so "barely possible" remains physically solvable.
+### FLAPPY_HEADER_CANVAS_HEIGHT_PX
 
-### FLAPPY_MIN_PIPE_RECOVERY_FRAMES
+Header canvas fixed height (pixels).
 
-Hard floor on time between pipes at max speed so controllers can recover.
+### FLAPPY_HEADER_TITLE_TEXT
 
-This prevents endgame spacing from becoming too tight for realistic policy
-reaction and vertical correction.
+Title rendered inside the standalone header box.
 
-### FLAPPY_MIN_EDGE_TO_EDGE_PIPE_SPACING_PX
+### FLAPPY_HUD_INITIALIZING_TEXT
 
-Minimum edge-to-edge spacing needed to recover between consecutive pipes.
+Initial status text displayed before evolution starts.
 
-Derived from bird size + expected control drop budget + a small margin.
+### FLAPPY_HUD_OFF_TEXT
 
-### FLAPPY_PIPE_GAP_MIN_PX
+Shared HUD value when a metric is intentionally disabled.
 
-Minimum pipe gap used at peak adaptive difficulty.
+### FLAPPY_HUD_UPDATE_INTERVAL_FRAMES
 
-### FLAPPY_PIPE_GAP_START_MULTIPLIER
+Update HUD counters every N simulation frames to reduce DOM churn.
 
-Initial spawn gap multiplier relative to the current hardest gap target.
+The value trades freshness for stability. Updating every frame would make the
+numbers twitchier and force more frequent DOM work on the main thread.
 
-### FLAPPY_PIPE_GAP_SHRINK_PER_PIPE_PX
+### FLAPPY_HUD_UPDATES_WINDOW_MS
 
-Per-pipe gap shrink step toward the current hardest target gap (pixels).
+HUD sliding-window size used when computing updates-per-second metric.
 
-### FLAPPY_PIPE_GAP_RANDOM_JITTER_PX
+### FLAPPY_HUD_UPDATES_WINDOW_SECONDS
 
-Random jitter range applied to each spawned pipe gap (pixels).
+HUD updates window duration in seconds for per-second conversion.
 
-### FLAPPY_PIPE_GAP_CENTER_MAX_DELTA_PX
+### FLAPPY_HUD_ZERO_DECIMAL_TEXT
 
-Maximum allowed vertical jump between consecutive pipe gap centers (pixels).
+Shared HUD value for decimal zero fields.
 
-This reduces abrupt zig-zag transitions that are often unrecoverable once
-spacing tightens at higher difficulty.
+### FLAPPY_HUD_ZERO_TEXT
 
-### FLAPPY_PIPE_SPEED_MAX_PX_PER_FRAME
+Shared HUD value for integer zero fields.
 
-Maximum pipe speed used at peak adaptive difficulty.
+### FLAPPY_INSTRUMENTATION_STATS_KEYS
+
+Stats keys that are hidden when runtime instrumentation is disabled.
 
-### FLAPPY_PIPE_SPAWN_INTERVAL_MIN_FRAMES
+### FLAPPY_LIGHT_NEON_RAMP
 
-Minimum spawn interval used at peak adaptive difficulty.
+Light neon ramp used for high-contrast negative scales.
 
 ### FLAPPY_MAX_DIFFICULTY_EDGE_TO_EDGE_PIPE_SPACING_PX
 
@@ -415,762 +361,816 @@ This is the distance from one pipe's leading edge to the next pipe's leading
 edge at the hardest steady-state cadence. It is the periodicity the ground
 grid must match if each spawned pipe should land on the same grid phase.
 
-### FLAPPY_PIPE_SPAWN_INTERVAL_START_MULTIPLIER
+### FLAPPY_MAX_FALL_SPEED_PX_PER_FRAME
 
-Initial spawn-interval multiplier relative to the current hardest interval target.
+Maximum downward speed clamp (pixels/frame).
 
-### FLAPPY_PIPE_SPAWN_INTERVAL_SHRINK_PER_PIPE_FRAMES
+This cap limits runaway fall acceleration and keeps trajectories learnable.
 
-Per-pipe spawn-interval shrink step toward the current hardest interval target (frames).
+### FLAPPY_MAX_FRAMES_PER_EPISODE
 
-### FLAPPY_DIFFICULTY_RAMP_PIPES
+Episode terminates after this many frames even if still alive.
 
-Pipe-pass count needed to reach maximum adaptive difficulty.
+This prevents extremely long outlier episodes from dominating generation
+runtime and keeps evolution throughput predictable.
 
-After this point, spacing does not tighten further, so proficient agents can
-sustain long runs without additional spacing compression.
+### FLAPPY_MEMORY_ACTION_WINDOW_STEPS
 
-### FLAPPY_TRAIL_OPACITY_FACTOR
+Number of past actions retained for the action-memory channel.
 
-Fraction of parent bird opacity used for drawing trails.
+### FLAPPY_MEMORY_CORE_FEATURE_COUNT
 
-For example, `0.5` means a bird at 20% opacity gets a 10% opacity trail.
+Number of core per-frame observation features retained for temporal stacking.
 
-### FLAPPY_NORMALIZATION_EPSILON
+### FLAPPY_MEMORY_STACKED_FRAME_COUNT
 
-Small epsilon divisor guard for world/physics normalization.
+Number of temporal frames included in the stacked observation window.
 
-Prevents division by near-zero values when view-dependent scales are very
-small, keeping feature values numerically stable.
+### FLAPPY_MIN_CLEARANCE_MARGIN_PX
 
-If you want a quick refresher on why feature scaling matters, the Wikipedia
-article on "feature scaling" is a useful background reference.
+Small geometric buffer so "barely possible" remains physically solvable.
 
-### FLAPPY_FRAME_MONOSPACE_FONT
+### FLAPPY_MIN_EDGE_TO_EDGE_PIPE_SPACING_PX
 
-Reusable monospaced HUD font for glyph-based frame rendering.
+Minimum edge-to-edge spacing needed to recover between consecutive pipes.
+
+Derived from bird size + expected control drop budget + a small margin.
+
+### FLAPPY_MIN_PIPE_RECOVERY_FRAMES
+
+Hard floor on time between pipes at max speed so controllers can recover.
+
+This prevents endgame spacing from becoming too tight for realistic policy
+reaction and vertical correction.
+
+### FLAPPY_MINOR_GC_WINDOW_MS
+
+Sliding-window size used when computing minor GC events per minute.
 
 ### FLAPPY_MONOSPACE_FONT_FAMILY
 
 Shared monospace font stack used by all HUD and visualization text.
 
-### FLAPPY_HEADER_TITLE_TEXT
+### FLAPPY_NEON_BIRD_PALETTE
 
-Title rendered inside the standalone header box.
+Neon bird palette for per-agent render color assignment.
 
-### FLAPPY_HEADER_CANVAS_HEIGHT_PX
+### FLAPPY_NEON_PALETTE
 
-Header canvas fixed height (pixels).
+TRON-like neon palette matching asciiMaze style.
 
-### FLAPPY_FRAME_GLYPH_ROW_HEIGHT_PX
+### FLAPPY_NETWORK_ARCHITECTURE_COLUMN_SEPARATOR
 
-Glyph-row height used for box-drawing rows (pixels).
+Separator used between architecture columns in the compact header label.
 
-### FLAPPY_FRAME_MIN_GLYPH_WIDTH_PX
+### FLAPPY_NETWORK_ARCHITECTURE_LINE_SEPARATOR
 
-Minimum measured glyph width fallback (pixels).
+Line separator used by the two-line architecture label block.
 
-### FLAPPY_FRAME_MIN_COLUMNS
+### FLAPPY_NETWORK_BASELINE_HEIGHT_PX
 
-Minimum glyph columns to keep frame readable on narrow widths.
+Baseline network panel height before complexity adjustments.
 
-### FLAPPY_FRAME_RESERVED_COLUMNS
+### FLAPPY_NETWORK_EMPTY_HIDDEN_LAYER_LABEL
 
-Reserved columns to keep right edge in bounds during metrics fit.
+Placeholder label used when the network has no hidden layers.
 
-### FLAPPY_TITLE_BOX_MIN_WIDTH
+### FLAPPY_NETWORK_GRAPH_BOTTOM_PADDING_PX
 
-Minimum box width when building standalone title frame.
+Graph-bottom padding for network visualization content.
 
-### FLAPPY_TITLE_BOX_MARGIN_COLUMNS
+### FLAPPY_NETWORK_GRAPH_INNER_PADDING_PX
 
-Total side margin columns reserved around centered title box.
+Extra inner graph padding for topology-driven sizing.
 
-### FLAPPY_TITLE_BOX_WIDTH_RATIO
+### FLAPPY_NETWORK_GRAPH_LEFT_PADDING_PX
 
-Preferred title width relative to available frame width.
+Graph-left padding for network visualization content.
 
-### FLAPPY_TITLE_BOX_MIN_HALF_SPAN
+### FLAPPY_NETWORK_GRAPH_RIGHT_PADDING_PX
 
-Minimum half-span when clamping centered title extents.
+Graph-right padding for network visualization content.
 
-### FLAPPY_TITLE_BOX_MIN_OUTER_GAP_COLUMNS
+### FLAPPY_NETWORK_GRAPH_TOP_PADDING_PX
 
-Minimum columns between title box and outer rails.
+Graph-top padding for network visualization content.
 
-### FLAPPY_BOX_MIN_COLUMNS
+### FLAPPY_NETWORK_HEADER_FONT_SIZE_PX
 
-Minimum safe columns for box-drawing helper output.
+Header font size for architecture label lines.
 
-### FLAPPY_BOX_MIN_ROWS
+### FLAPPY_NETWORK_HEADER_TEXT_COLOR
 
-Minimum safe rows for box-drawing helper output.
+Header text color for architecture label in visualization.
 
-### FLAPPY_GLYPH_TOP_LEFT
+### FLAPPY_NETWORK_HIDDEN_LAYER_SEPARATOR
 
-Glyph character for top-left box corner.
+Separator used between hidden-layer sizes inside architecture labels.
 
-### FLAPPY_GLYPH_TOP_RIGHT
+### FLAPPY_NETWORK_HIDDEN_LAYER_SIZES
 
-Glyph character for top-right box corner.
+Hidden-layer sizes used to seed initial Flappy policy architectures.
 
-### FLAPPY_GLYPH_BOTTOM_LEFT
+Using at least two hidden layers improves representational flexibility for
+precise vertical control near narrow, fast-changing pipe targets.
 
-Glyph character for bottom-left box corner.
+### FLAPPY_NETWORK_HIDDEN_NODE_STROKE_COLOR
 
-### FLAPPY_GLYPH_BOTTOM_RIGHT
+Hidden-node stroke color.
 
-Glyph character for bottom-right box corner.
+### FLAPPY_NETWORK_INFERRED_HIDDEN_LAYER_PREFIX
 
-### FLAPPY_GLYPH_HORIZONTAL
+Prefix used when hidden-layer counts are inferred rather than declared.
 
-Glyph character for horizontal box segment.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_GAP_PX
 
-### FLAPPY_GLYPH_VERTICAL
+Horizontal gap between input-node column and vertical group label band.
 
-Glyph character for vertical box segment.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_WIDTH_PX
 
-### FLAPPY_GLYPH_SPACE
+Width of the vertical input-group label band.
 
-Glyph character for interior spacing.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_SIZE_PX
 
-### FLAPPY_NEON_PALETTE
+Font size used for vertical input-group label text.
 
-TRON-like neon palette matching asciiMaze style.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_WEIGHT
 
-### FLAPPY_NEON_BIRD_PALETTE
+Font weight used for vertical input-group label text.
 
-Neon bird palette for per-agent render color assignment.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_MIN_HEIGHT_PX
 
-### FLAPPY_REGULAR_NEON_RAMP
+Minimum visual height for any input-group label band.
 
-Regular neon ramp used for strong positive/baseline scales.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_RADIUS_PX
 
-### FLAPPY_LIGHT_NEON_RAMP
+Corner radius used by input-group label band backgrounds.
 
-Light neon ramp used for high-contrast negative scales.
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_TEXT_COLOR
 
-### FLAPPY_CENTER_BLUE_RAMP
+Text color for vertical input-group labels on neon backgrounds.
 
-Neutral-center blue ramp for near-zero diverging tiers.
+### FLAPPY_NETWORK_INPUT_LAYER_TARGET_GAP_PX
 
-### FLAPPY_TIER_ABOVE_COLOR
+Preferred vertical spacing between input-layer nodes.
 
-Fallback color when a value exceeds all configured tiers.
+### FLAPPY_NETWORK_INPUT_SIZE
 
-### FLAPPY_NETWORK_LEGEND_CONNECTION_TITLE_COLOR
+Number of observation features fed into each Flappy policy network.
 
-Legend section title color for connection weight rows.
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_BASELINE_COUNT
+
+Baseline layer-count threshold before layer-complexity height increments apply.
+
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_HEIGHT_STEP_PX
+
+Additional height increment per extra layer above baseline.
+
+### FLAPPY_NETWORK_LEGEND_BACKGROUND
+
+Legend panel background fill color.
 
 ### FLAPPY_NETWORK_LEGEND_BIAS_TITLE_COLOR
 
 Legend section title color for node bias rows.
 
-### FLAPPY_NETWORK_LEGEND_ROW_TEXT_COLOR
+### FLAPPY_NETWORK_LEGEND_BOTTOM_PADDING_PX
 
-Legend row text color.
+Legend bottom padding in compact/regular layouts.
 
-### FLAPPY_NETWORK_HEADER_TEXT_COLOR
+### FLAPPY_NETWORK_LEGEND_COMPACT_FONT_SIZE_PX
 
-Header text color for architecture label in visualization.
+Legend font size for compact mode.
 
-### FLAPPY_NETWORK_NODE_LABEL_FILL_COLOR
+### FLAPPY_NETWORK_LEGEND_COMPACT_HEIGHT_THRESHOLD_PX
 
-Dark fill color used for node bias labels.
+Compact legend height threshold for network visualization.
 
-### FLAPPY_NETWORK_OUTPUT_NODE_STROKE_COLOR
+### FLAPPY_NETWORK_LEGEND_COMPACT_ROW_HEIGHT_PX
 
-Output-node stroke color.
+Legend row height in compact mode.
 
-### FLAPPY_NETWORK_HIDDEN_NODE_STROKE_COLOR
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_GAP_PX
 
-Hidden-node stroke color.
+Legend section gap in compact mode.
 
-### FLAPPY_NETWORK_OUTPUT_NODE_GLOW_COLOR
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_TITLE_HEIGHT_PX
 
-Output-node glow color.
+Legend section title height in compact mode.
 
-### FLAPPY_SCREEN_PADDING_PX
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_PX
 
-Screen-edge padding between viewport border and demo frame.
+Compact legend panel width.
 
-### FLAPPY_BIRD_VIEWPORT_X_RATIO
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_THRESHOLD_PX
 
-Horizontal viewport anchor for the bird.
+Compact legend width threshold for network visualization.
 
-A value of `0.33` places the bird roughly one-third from the left, leaving
-more lookahead space for incoming pipes.
+### FLAPPY_NETWORK_LEGEND_CONNECTION_LINE_WIDTH_PX
 
-### FLAPPY_UI_OUTER_FRAME_BACKGROUND
+Connection row stroke line width in legend.
 
-Outer frame background color for the browser demo host.
+### FLAPPY_NETWORK_LEGEND_CONNECTION_TITLE_COLOR
 
-### FLAPPY_UI_NETWORK_HOST_BACKGROUND
+Legend section title color for connection weight rows.
 
-Host panel background color behind the network visualization canvas.
+### FLAPPY_NETWORK_LEGEND_GRAPH_GAP_PX
 
-### FLAPPY_UI_NETWORK_CANVAS_BACKGROUND
+Gap between graph body and floating legend panel.
 
-Inner canvas clear color for the network visualization area.
+### FLAPPY_NETWORK_LEGEND_HEADER_COLOR
 
-### FLAPPY_UI_UNIFIED_INSET_SHADOW
+Legend header color.
 
-Shared inset glow shadow used by neon HUD panels.
+### FLAPPY_NETWORK_LEGEND_HEADER_HEIGHT_PX
 
-### FLAPPY_UI_DOUBLE_PANEL_BORDER
+Legend header row height.
 
-Shared double-line border style matching title-box aesthetics.
+### FLAPPY_NETWORK_LEGEND_MARGIN_PX
 
-### FLAPPY_UI_CANVAS_INSET_SHADOW
+Legend panel outer margin.
 
-Thin inset shadow used on canvases for subtle neon depth.
+### FLAPPY_NETWORK_LEGEND_MIN_TOP_PX
 
-### FLAPPY_UI_SPLIT_BRIDGE_COLOR
+Minimum top clamp for legend placement.
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_FONT_SIZE_PX
+
+Legend font size for regular mode.
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_ROW_HEIGHT_PX
+
+Legend row height in regular mode.
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_GAP_PX
+
+Legend section gap in regular mode.
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_TITLE_HEIGHT_PX
+
+Legend section title height in regular mode.
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_WIDTH_PX
+
+Regular legend panel width.
+
+### FLAPPY_NETWORK_LEGEND_RIGHT_SIDE_THRESHOLD_RATIO
+
+Ratio used to decide whether the legend occupies the right half of the canvas.
 
-Vertical split guide color between stats and network panes.
+### FLAPPY_NETWORK_LEGEND_ROW_TEXT_COLOR
 
-### FLAPPY_UI_OUTER_FRAME_MIN_SIDE_PADDING_PX
+Legend row text color.
 
-Side padding fallback for the outer frame when viewport is very narrow.
+### FLAPPY_NETWORK_LEGEND_TARGET_TOP_PX
 
-### FLAPPY_UI_OUTER_FRAME_SIDE_PADDING_OFFSET_PX
+Target top offset used for legend placement.
 
-Side padding offset applied to shared screen padding for frame layout.
+### FLAPPY_NETWORK_LEGEND_TOP_LEFT_THRESHOLD_PX
 
-### FLAPPY_UI_CONTENT_COLUMN_TOP_PADDING_PX
+Canvas width threshold to prefer top-left legend placement.
 
-Top padding for the vertical content column hosting canvases and stats.
+### FLAPPY_NETWORK_MAX_HEIGHT_PX
 
-### FLAPPY_UI_NETWORK_HOST_INITIAL_HEIGHT_PX
+Maximum clamped network panel height.
 
-Initial network panel height before topology-driven resizing runs.
+### FLAPPY_NETWORK_MAX_NODE_HEIGHT_PX
 
-### FLAPPY_UI_NETWORK_HOST_FIXED_HEIGHT_PX
+Maximum node height in network visualization.
 
-Fixed network panel height used by responsive browser layout.
+### FLAPPY_NETWORK_MAX_NODE_WIDTH_PX
 
-### FLAPPY_UI_NETWORK_HOST_INSET_PX
+Maximum node width in network visualization.
 
-Inner host padding subtracted from measured network canvas dimensions.
+### FLAPPY_NETWORK_MIN_DRAWABLE_SIZE_PX
 
-### FLAPPY_VIEWPORT_MINIMUM_STATS_HEIGHT_PX
+Minimum drawable graph dimension after padding is removed.
 
-Minimum stats panel height used by responsive viewport sizing.
+### FLAPPY_NETWORK_MIN_HEIGHT_PX
 
-### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_PX
+Minimum clamped network panel height.
 
-Minimum simulation canvas height floor in responsive viewport sizing.
+### FLAPPY_NETWORK_MIN_INTER_NODE_GAP_PX
 
-### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_RATIO
+Minimum inter-node vertical gap for topology-driven sizing.
 
-Minimum simulation height ratio relative to window height.
+### FLAPPY_NETWORK_MIN_LABEL_HEIGHT_PX
 
-### FLAPPY_VIEWPORT_VERTICAL_LAYOUT_GUTTER_PX
+Minimum node label height in pixels.
 
-Vertical layout gutter between stats panel and simulation canvas.
+### FLAPPY_NETWORK_MIN_NODE_FIT_HEIGHT_PX
 
-### FLAPPY_VIEWPORT_SIMULATION_BOTTOM_MARGIN_PX
+Minimum fit-based node height before width and label constraints are applied.
 
-Additional bottom margin reserved during simulation canvas sizing.
+### FLAPPY_NETWORK_MIN_NODE_HEIGHT_LABEL_EXTRA_PX
 
-### FLAPPY_VIEWPORT_MIN_NETWORK_HEIGHT_BUDGET_PX
+Extra pixel allowance above label baseline for minimum node-height readability.
 
-Minimum network panel height budget for responsive viewport sizing.
+### FLAPPY_NETWORK_MIN_NODE_INNER_PADDING_PX
 
-### FLAPPY_VIEWPORT_NETWORK_ONLY_BREAKPOINT_PX
+Minimum inner padding for node labels.
 
-Width breakpoint below which stats pane is hidden and network gets full width.
+### FLAPPY_NETWORK_MIN_NODE_WIDTH_PX
 
-### FLAPPY_VIEWPORT_NETWORK_OVERLAY_HIDDEN_BREAKPOINT_PX
+Minimum node width in network visualization.
 
-Width breakpoint below which network legend and architecture text are hidden.
+### FLAPPY_NETWORK_NODE_DENSITY_BASELINE_COUNT
 
-### FLAPPY_VIEWPORT_MOBILE_MINIMAL_UI_BREAKPOINT_PX
+Baseline node-count threshold before node-density height increments apply.
 
-Width breakpoint below which only title + main simulation canvas are shown.
+### FLAPPY_NETWORK_NODE_DENSITY_HEIGHT_STEP_PX
 
-In this minimal mobile layout, stats and network-visualization panels are
-hidden to maximize readable gameplay area.
+Additional height increment per node above baseline density.
 
-### FLAPPY_STATS_KEYS
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_DIVISOR
 
-Ordered keys for the runtime stats table.
+Layer-fit divisor used when deriving max node height from dense layer stacks.
 
-### FLAPPY_STATS_ROWS
+Larger values keep nodes shorter in dense topologies so labels remain legible.
 
-Ordered row descriptors rendered into the runtime stats table.
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_MIN_DENOMINATOR
 
-### FLAPPY_INSTRUMENTATION_STATS_KEYS
+Minimum denominator clamp for dense-layer node-height derivation.
 
-Stats keys that are hidden when runtime instrumentation is disabled.
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_DIVISOR
 
-### FLAPPY_STATS_SECTION_KEYS
+Width-fit divisor used when deriving node height from layer count.
 
-Stats keys rendered as section headers rather than key/value rows.
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_MIN_DENOMINATOR
 
-### FLAPPY_STATS_ARCHITECTURE_KEYS
+Minimum denominator clamp for layer-width node-height derivation.
 
-Stats keys whose values should render multi-line architecture content.
+### FLAPPY_NETWORK_NODE_LABEL_FILL_COLOR
 
-### FLAPPY_UI_STATS_ROW_BORDER
+Dark fill color used for node bias labels.
 
-Border style for regular stats rows.
+### FLAPPY_NETWORK_NODE_LABEL_FONT_WEIGHT
 
-### FLAPPY_UI_STATS_SECTION_BORDER
+Font-weight used when rendering node bias values.
 
-Border style for stats section headers.
+### FLAPPY_NETWORK_NODE_LABEL_SIZE_RATIO
 
-### FLAPPY_NETWORK_LEGEND_HEADER_COLOR
+Relative label-height ratio used when rendering node bias values.
 
-Legend header color.
+### FLAPPY_NETWORK_NODE_LAYOUT_PADDING_PX
 
-### FLAPPY_CONNECTION_TIER_MAX_ABS_VALUE
+Inner node-layout padding inside drawable network region.
 
-Connection-tier max absolute magnitude used by diverging color tiers.
+### FLAPPY_NETWORK_NODE_TOP_MARGIN_PX
 
-### FLAPPY_CONNECTION_TIER_CENTER_THRESHOLD
+Fixed top margin for node stacks inside the network drawable area.
 
-Connection-tier center threshold around zero.
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_DIVISOR
 
-### FLAPPY_CONNECTION_TIER_EDGE_START_ABS_VALUE
+Width-fit divisor used when deriving node width from layer count.
 
-Connection-tier edge region start magnitude.
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_MIN_DENOMINATOR
 
-### FLAPPY_BIAS_TIER_MAX_ABS_VALUE
+Minimum denominator clamp for layer-width node-width derivation.
 
-Bias-tier max absolute magnitude used by diverging color tiers.
+### FLAPPY_NETWORK_NODE_WIDTH_TO_HEIGHT_RATIO
 
-### FLAPPY_BIAS_TIER_CENTER_THRESHOLD
+Width-to-height ratio used for node rectangle proportions.
 
-Bias-tier center threshold around zero.
+### FLAPPY_NETWORK_OUTPUT_NODE_GLOW_COLOR
 
-### FLAPPY_BIAS_TIER_EDGE_START_ABS_VALUE
+Output-node glow color.
 
-Bias-tier edge region start magnitude.
+### FLAPPY_NETWORK_OUTPUT_NODE_STROKE_COLOR
 
-### FLAPPY_TIER_LOGARITHMIC_STEEPNESS
+Output-node stroke color.
 
-Shared logarithmic steepness for diverging color tier mapping.
+### FLAPPY_NETWORK_OUTPUT_SIZE
 
-### FLAPPY_TIER_EDGE_COUNT
+Number of output action scores emitted by each Flappy policy network.
 
-Number of linearly distributed edge tiers near maximum magnitudes.
+### FLAPPY_NETWORK_TOPOLOGY_HEIGHT_MULTIPLIER
 
-### FLAPPY_NETWORK_GRAPH_LEFT_PADDING_PX
+Additional multiplier used for topology-driven minimum host-height recommendation.
 
-Graph-left padding for network visualization content.
+### FLAPPY_NON_CHAMPION_BODY_GLOW_BLUR_PX
 
-### FLAPPY_NETWORK_GRAPH_TOP_PADDING_PX
+Glow blur radius used for simplified non-champion bird bodies.
 
-Graph-top padding for network visualization content.
+### FLAPPY_NON_CHAMPION_OPACITY
 
-### FLAPPY_NETWORK_GRAPH_RIGHT_PADDING_PX
+Opacity used for non-champion bird fills and trails.
 
-Graph-right padding for network visualization content.
+### FLAPPY_NORMALIZATION_EPSILON
 
-### FLAPPY_NETWORK_GRAPH_BOTTOM_PADDING_PX
+Small epsilon divisor guard for world/physics normalization.
 
-Graph-bottom padding for network visualization content.
+Prevents division by near-zero values when view-dependent scales are very
+small, keeping feature values numerically stable.
 
-### FLAPPY_NETWORK_MIN_DRAWABLE_SIZE_PX
+If you want a quick refresher on why feature scaling matters, the Wikipedia
+article on "feature scaling" is a useful background reference.
 
-Minimum drawable graph dimension after padding is removed.
+### FLAPPY_PIPE_COLLISION_ENTRANCE_EXPAND_PX
 
-### FLAPPY_NETWORK_LEGEND_GRAPH_GAP_PX
+Effective gap-rim expansion used for pipe collision checks (pixels).
 
-Gap between graph body and floating legend panel.
+Includes the visual entrance gap and half the outline stroke so collision
+matches the visible outer line around the gap opening.
 
-### FLAPPY_NETWORK_LEGEND_RIGHT_SIDE_THRESHOLD_RATIO
+### FLAPPY_PIPE_COLLISION_SIDE_EXPAND_PX
 
-Ratio used to decide whether the legend occupies the right half of the canvas.
+Effective side expansion used for pipe collision checks (pixels).
 
-### FLAPPY_NETWORK_NODE_LAYOUT_PADDING_PX
+Includes the visual side gap and half the outline stroke so collision
+matches the visible outer line thickness.
 
-Inner node-layout padding inside drawable network region.
+### FLAPPY_PIPE_ENTRY_RIM_INSET_PX
 
-### FLAPPY_NETWORK_MIN_LABEL_HEIGHT_PX
+Inset used for the pipe entrance rim line measured from the gap-facing edge.
 
-Minimum node label height in pixels.
+### FLAPPY_PIPE_GAP_CENTER_MAX_DELTA_PX
 
-### FLAPPY_NETWORK_MIN_NODE_INNER_PADDING_PX
+Maximum allowed vertical jump between consecutive pipe gap centers (pixels).
 
-Minimum inner padding for node labels.
+This reduces abrupt zig-zag transitions that are often unrecoverable once
+spacing tightens at higher difficulty.
 
-### FLAPPY_NETWORK_INPUT_LAYER_TARGET_GAP_PX
+### FLAPPY_PIPE_GAP_CENTER_MAX_Y_PX
 
-Preferred vertical spacing between input-layer nodes.
+Maximum allowed gap center height (pixels).
 
-### FLAPPY_NETWORK_NODE_TOP_MARGIN_PX
+### FLAPPY_PIPE_GAP_CENTER_MIN_Y_PX
 
-Fixed top margin for node stacks inside the network drawable area.
+Minimum allowed gap center height (pixels).
 
-### FLAPPY_NETWORK_NODE_LABEL_SIZE_RATIO
+### FLAPPY_PIPE_GAP_MIN_PX
 
-Relative label-height ratio used when rendering node bias values.
+Minimum pipe gap used at peak adaptive difficulty.
 
-### FLAPPY_NETWORK_NODE_LABEL_FONT_WEIGHT
+### FLAPPY_PIPE_GAP_PX
 
-Font-weight used when rendering node bias values.
+Vertical opening size of each pipe gap (pixels).
 
-### FLAPPY_NETWORK_MIN_NODE_WIDTH_PX
+This is the nominal baseline gap before adaptive difficulty narrows it.
 
-Minimum node width in network visualization.
+### FLAPPY_PIPE_GAP_RANDOM_JITTER_PX
 
-### FLAPPY_NETWORK_MAX_NODE_HEIGHT_PX
+Random jitter range applied to each spawned pipe gap (pixels).
 
-Maximum node height in network visualization.
+### FLAPPY_PIPE_GAP_SHRINK_PER_PIPE_PX
 
-### FLAPPY_NETWORK_MAX_NODE_WIDTH_PX
+Per-pipe gap shrink step toward the current hardest target gap (pixels).
 
-Maximum node width in network visualization.
+### FLAPPY_PIPE_GAP_START_MULTIPLIER
 
-### FLAPPY_NETWORK_MIN_INTER_NODE_GAP_PX
+Initial spawn gap multiplier relative to the current hardest gap target.
 
-Minimum inter-node vertical gap for topology-driven sizing.
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_BLUR_PX
 
-### FLAPPY_NETWORK_GRAPH_INNER_PADDING_PX
+Blur radius used for the cyan pipe outline glow (pixels).
 
-Extra inner graph padding for topology-driven sizing.
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_COLOR
 
-### FLAPPY_NETWORK_BASELINE_HEIGHT_PX
+Cyan neon glow used for pipe outline shadow.
 
-Baseline network panel height before complexity adjustments.
+This intentionally matches the asciiMaze `neonCyan` ANSI color (`\x1b[38;5;87m`)
+which maps to xterm color 87 ~= rgb(95, 255, 255) / hex `#5fffff`.
 
-### FLAPPY_NETWORK_NODE_DENSITY_HEIGHT_STEP_PX
+### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
 
-Additional height increment per node above baseline density.
+Visual gap between the pipe body and its outline at the pipe entrance rim (pixels).
 
-### FLAPPY_NETWORK_LAYER_COMPLEXITY_HEIGHT_STEP_PX
+### FLAPPY_PIPE_OUTLINE_GLOW_ALPHA
 
-Additional height increment per extra layer above baseline.
+Opacity used for the soft pipe glow stroke pass.
 
-### FLAPPY_NETWORK_MIN_HEIGHT_PX
+### FLAPPY_PIPE_OUTLINE_GLOW_STROKE_WIDTH_PX
 
-Minimum clamped network panel height.
+Stroke width used for the soft pipe glow stroke pass (pixels).
 
-### FLAPPY_NETWORK_MAX_HEIGHT_PX
+### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
 
-Maximum clamped network panel height.
+Visual gap between the pipe body and its outline on the sides (pixels).
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_THRESHOLD_PX
+### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
 
-Compact legend width threshold for network visualization.
+Stroke width used for the pipe outline (pixels).
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_HEIGHT_THRESHOLD_PX
+### FLAPPY_PIPE_SPAWN_INTERVAL_FRAMES
 
-Compact legend height threshold for network visualization.
+Frames between spawning new pipes.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_PX
+Together with pipe speed, this controls horizontal pacing and how much time a
+policy has to recover between obstacles.
 
-Compact legend panel width.
+### FLAPPY_PIPE_SPAWN_INTERVAL_MIN_FRAMES
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_WIDTH_PX
+Minimum spawn interval used at peak adaptive difficulty.
 
-Regular legend panel width.
+### FLAPPY_PIPE_SPAWN_INTERVAL_SHRINK_PER_PIPE_FRAMES
 
-### FLAPPY_NETWORK_LEGEND_HEADER_HEIGHT_PX
+Per-pipe spawn-interval shrink step toward the current hardest interval target (frames).
 
-Legend header row height.
+### FLAPPY_PIPE_SPAWN_INTERVAL_START_MULTIPLIER
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_TITLE_HEIGHT_PX
+Initial spawn-interval multiplier relative to the current hardest interval target.
 
-Legend section title height in compact mode.
+### FLAPPY_PIPE_SPEED_MAX_PX_PER_FRAME
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_TITLE_HEIGHT_PX
+Maximum pipe speed used at peak adaptive difficulty.
 
-Legend section title height in regular mode.
+### FLAPPY_PIPE_SPEED_PX_PER_FRAME
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_ROW_HEIGHT_PX
+Pipe horizontal speed (pixels/frame).
 
-Legend row height in compact mode.
+Higher values shrink reaction time, which makes the same gap geometry much
+harder even before the adaptive curriculum starts tightening gaps.
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_ROW_HEIGHT_PX
+### FLAPPY_PIPE_WIDTH_PX
 
-Legend row height in regular mode.
+Pipe width (pixels).
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_GAP_PX
+### FLAPPY_REGULAR_NEON_RAMP
 
-Legend section gap in compact mode.
+Regular neon ramp used for strong positive/baseline scales.
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_GAP_PX
+### FLAPPY_SCREEN_PADDING_PX
 
-Legend section gap in regular mode.
+Screen-edge padding between viewport border and demo frame.
 
-### FLAPPY_NETWORK_LEGEND_BOTTOM_PADDING_PX
+### FLAPPY_STARFIELD_CANVAS_CONTEXT_ID
 
-Legend bottom padding in compact/regular layouts.
+Canvas rendering context identifier used for starfield tile generation.
 
-### FLAPPY_NETWORK_LEGEND_MARGIN_PX
+### FLAPPY_STARFIELD_COMPOSITE_SOURCE_OVER
 
-Legend panel outer margin.
+Composite mode used for normal starfield canvas drawing passes.
 
-### FLAPPY_NETWORK_LEGEND_TOP_LEFT_THRESHOLD_PX
+### FLAPPY_STARFIELD_CYAN_FILL_STYLE
 
-Canvas width threshold to prefer top-left legend placement.
+Fill color used for cyan stars and glow dots in the generated tile.
 
-### FLAPPY_NETWORK_LEGEND_TARGET_TOP_PX
+### FLAPPY_STARFIELD_FAR_SCROLL_RATIO
 
-Target top offset used for legend placement.
+Horizontal scroll ratio for the farthest parallax layer.
 
-### FLAPPY_NETWORK_LEGEND_MIN_TOP_PX
+### FLAPPY_STARFIELD_FULL_ALPHA
 
-Minimum top clamp for legend placement.
+Default fully opaque alpha restored after tile generation.
 
-### FLAPPY_NETWORK_LEGEND_BACKGROUND
+### FLAPPY_STARFIELD_INCLUSIVE_RANGE_OFFSET
 
-Legend panel background fill color.
+Inclusive range offset used when converting size bounds into random spans.
 
-### FLAPPY_NETWORK_LEGEND_CONNECTION_LINE_WIDTH_PX
+### FLAPPY_STARFIELD_LAYER_SPECS
 
-Connection row stroke line width in legend.
+Declarative layer specs for the default starfield parallax bands.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_FONT_SIZE_PX
+Keeping the layer recipe in data form makes it easier to swap the lower
+segment to a different parallax family without changing the tile builder.
 
-Legend font size for compact mode.
+### FLAPPY_STARFIELD_MID_SCROLL_RATIO
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_FONT_SIZE_PX
+Horizontal scroll ratio for the middle parallax layer.
 
-Legend font size for regular mode.
+### FLAPPY_STARFIELD_MIN_DIMENSION_PX
 
-### FLAPPY_NETWORK_HEADER_FONT_SIZE_PX
+Minimum positive dimension allowed for generated starfield canvases.
 
-Header font size for architecture label lines.
+### FLAPPY_STARFIELD_NEAR_SCROLL_RATIO
 
-### FLAPPY_NETWORK_MIN_NODE_HEIGHT_LABEL_EXTRA_PX
+Horizontal scroll ratio for the nearest parallax layer.
 
-Extra pixel allowance above label baseline for minimum node-height readability.
+### FLAPPY_STARFIELD_NO_BLUR_PX
 
-### FLAPPY_NETWORK_MIN_NODE_FIT_HEIGHT_PX
+Blur reset value used after the star glow pass.
 
-Minimum fit-based node height before width and label constraints are applied.
+### FLAPPY_STARFIELD_ORIGIN_PX
 
-### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_DIVISOR
+Zero pixel origin used for starfield canvas clears and draws.
 
-Layer-fit divisor used when deriving max node height from dense layer stacks.
+### FLAPPY_STARFIELD_TILE_HEIGHT_PX
 
-Larger values keep nodes shorter in dense topologies so labels remain legible.
+Height of one repeated starfield tile (pixels).
 
-### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_MIN_DENOMINATOR
+### FLAPPY_STARFIELD_TILE_WIDTH_PX
 
-Minimum denominator clamp for dense-layer node-height derivation.
+Width of one repeated starfield tile (pixels).
 
-### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_DIVISOR
+### FLAPPY_STARFIELD_TRANSPARENT_SHADOW_COLOR
 
-Width-fit divisor used when deriving node height from layer count.
+Transparent shadow reset value used after glow drawing.
 
-### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_MIN_DENOMINATOR
+### FLAPPY_STARFIELD_UNSIGNED_NORMALIZATION_DIVISOR
 
-Minimum denominator clamp for layer-width node-height derivation.
+Divisor that normalizes unsigned 32-bit RNG state into the unit interval.
 
-### FLAPPY_NETWORK_NODE_WIDTH_TO_HEIGHT_RATIO
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_FINAL
 
-Width-to-height ratio used for node rectangle proportions.
+Final left-shift used by the xorshift32 random transition.
 
-### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_DIVISOR
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_PRIMARY
 
-Width-fit divisor used when deriving node width from layer count.
+Primary left-shift used by the xorshift32 random transition.
 
-### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_MIN_DENOMINATOR
+### FLAPPY_STARFIELD_XORSHIFT_RIGHT_SHIFT
 
-Minimum denominator clamp for layer-width node-width derivation.
+Middle right-shift used by the xorshift32 random transition.
 
-### FLAPPY_NETWORK_NODE_DENSITY_BASELINE_COUNT
+### FLAPPY_STATS_ARCHITECTURE_KEYS
 
-Baseline node-count threshold before node-density height increments apply.
+Stats keys whose values should render multi-line architecture content.
 
-### FLAPPY_NETWORK_LAYER_COMPLEXITY_BASELINE_COUNT
+### FLAPPY_STATS_KEYS
 
-Baseline layer-count threshold before layer-complexity height increments apply.
+Ordered keys for the runtime stats table.
 
-### FLAPPY_NETWORK_TOPOLOGY_HEIGHT_MULTIPLIER
+### FLAPPY_STATS_ROWS
 
-Additional multiplier used for topology-driven minimum host-height recommendation.
+Ordered row descriptors rendered into the runtime stats table.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_GAP_PX
+### FLAPPY_STATS_SECTION_KEYS
 
-Horizontal gap between input-node column and vertical group label band.
+Stats keys rendered as section headers rather than key/value rows.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_WIDTH_PX
+### FLAPPY_STATUS_EVOLVING_TEXT
 
-Width of the vertical input-group label band.
+Runtime status text shown between playback episodes.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_MIN_HEIGHT_PX
+### FLAPPY_STATUS_PLAYING_TEXT
 
-Minimum visual height for any input-group label band.
+Runtime status text shown while a generation playback is running.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_RADIUS_PX
+### FLAPPY_TARGET_FLAP_INTERVAL_FRAMES
 
-Corner radius used by input-group label band backgrounds.
+Target control cadence used for endgame reachability calculations.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_SIZE_PX
+A smaller value means the policy is expected to correct more frequently
+(effectively "jumping more often"), which supports narrower endgame gaps.
 
-Font size used for vertical input-group label text.
+The value is used analytically when estimating whether a late recovery is
+still plausible, not as the direct execution cadence of the simulation loop.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_WEIGHT
+### FLAPPY_TIER_ABOVE_COLOR
 
-Font weight used for vertical input-group label text.
+Fallback color when a value exceeds all configured tiers.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_TEXT_COLOR
+### FLAPPY_TIER_EDGE_COUNT
 
-Text color for vertical input-group labels on neon backgrounds.
+Number of linearly distributed edge tiers near maximum magnitudes.
 
-### FLAPPY_NETWORK_EMPTY_HIDDEN_LAYER_LABEL
+### FLAPPY_TIER_LOGARITHMIC_STEEPNESS
 
-Placeholder label used when the network has no hidden layers.
+Shared logarithmic steepness for diverging color tier mapping.
 
-### FLAPPY_NETWORK_INFERRED_HIDDEN_LAYER_PREFIX
+### FLAPPY_TITLE_BOX_MARGIN_COLUMNS
 
-Prefix used when hidden-layer counts are inferred rather than declared.
+Total side margin columns reserved around centered title box.
 
-### FLAPPY_NETWORK_HIDDEN_LAYER_SEPARATOR
+### FLAPPY_TITLE_BOX_MIN_HALF_SPAN
 
-Separator used between hidden-layer sizes inside architecture labels.
+Minimum half-span when clamping centered title extents.
 
-### FLAPPY_NETWORK_ARCHITECTURE_COLUMN_SEPARATOR
+### FLAPPY_TITLE_BOX_MIN_OUTER_GAP_COLUMNS
 
-Separator used between architecture columns in the compact header label.
+Minimum columns between title box and outer rails.
 
-### FLAPPY_NETWORK_ARCHITECTURE_LINE_SEPARATOR
+### FLAPPY_TITLE_BOX_MIN_WIDTH
 
-Line separator used by the two-line architecture label block.
+Minimum box width when building standalone title frame.
 
-### FLAPPY_TRAIL_MAX_POINTS
+### FLAPPY_TITLE_BOX_WIDTH_RATIO
 
-Maximum number of trail points retained per bird trail polyline.
+Preferred title width relative to available frame width.
 
-### FLAPPY_CHAMPION_TRAIL_MAX_POINTS
+### FLAPPY_TRAIL_EDGE_FADE_DISTANCE_PX
 
-Maximum number of trail points retained for the champion-only short trail.
+Distance from world edge over which trails fade to transparent (pixels).
 
 ### FLAPPY_TRAIL_LINE_WIDTH_PX
 
 Stroke width used for per-bird trail line rendering.
 
-### FLAPPY_TRAIL_EDGE_FADE_DISTANCE_PX
+### FLAPPY_TRAIL_MAX_POINTS
 
-Distance from world edge over which trails fade to transparent (pixels).
+Maximum number of trail points retained per bird trail polyline.
 
-### FLAPPY_NON_CHAMPION_OPACITY
+### FLAPPY_TRAIL_MIN_HORIZONTAL_SEGMENT_PX
 
-Opacity used for non-champion bird fills and trails.
+Minimum horizontal segment length used by stepped trail rendering.
 
-### FLAPPY_BIRD_BODY_GLOW_BLUR_PX
+### FLAPPY_TRAIL_MIN_VERTICAL_SEGMENT_PX
 
-Base neon blur radius used for bird body glow.
+Minimum vertical segment length used by stepped trail rendering.
 
-### FLAPPY_NON_CHAMPION_BODY_GLOW_BLUR_PX
+### FLAPPY_TRAIL_OPACITY_FACTOR
 
-Glow blur radius used for simplified non-champion bird bodies.
+Fraction of parent bird opacity used for drawing trails.
 
-### FLAPPY_BIRD_AURA_ALPHA
+For example, `0.5` means a bird at 20% opacity gets a 10% opacity trail.
 
-Opacity used for the extra Radiant-style aura around each bird.
+### FLAPPY_UI_CANVAS_INSET_SHADOW
 
-This is intentionally subtle: it should read as a soft bloom that lifts the
-bird off the background, without turning the bird into a big glowing blob.
+Thin inset shadow used on canvases for subtle neon depth.
 
-### FLAPPY_BIRD_AURA_EXPAND_PX
+### FLAPPY_UI_CONTENT_COLUMN_TOP_PADDING_PX
 
-Pixel expansion used for the Radiant-style bird aura plate.
+Top padding for the vertical content column hosting canvases and stats.
 
-### FLAPPY_BIRD_AURA_BLUR_MULTIPLIER
+### FLAPPY_UI_DOUBLE_PANEL_BORDER
 
-Blur multiplier used for the Radiant-style bird aura plate.
+Shared double-line border style matching title-box aesthetics.
 
-### FLAPPY_BIRD_CHAMPION_EXTRA_GLOW_BLUR_PX
+### FLAPPY_UI_NETWORK_CANVAS_BACKGROUND
 
-Additional blur radius applied to the champion red body glow.
+Inner canvas clear color for the network visualization area.
 
-This keeps the champion body bloom aligned with the same neon blur
-intensity used by the pipe outline glow, so the leader reads with
-comparable visual weight.
+### FLAPPY_UI_NETWORK_HOST_BACKGROUND
 
-### FLAPPY_TRAIL_MIN_HORIZONTAL_SEGMENT_PX
+Host panel background color behind the network visualization canvas.
 
-Minimum horizontal segment length used by stepped trail rendering.
+### FLAPPY_UI_NETWORK_HOST_FIXED_HEIGHT_PX
 
-### FLAPPY_TRAIL_MIN_VERTICAL_SEGMENT_PX
+Fixed network panel height used by responsive browser layout.
 
-Minimum vertical segment length used by stepped trail rendering.
+### FLAPPY_UI_NETWORK_HOST_INITIAL_HEIGHT_PX
 
-### FLAPPY_STARFIELD_TILE_WIDTH_PX
+Initial network panel height before topology-driven resizing runs.
 
-Width of one repeated starfield tile (pixels).
+### FLAPPY_UI_NETWORK_HOST_INSET_PX
 
-### FLAPPY_STARFIELD_MIN_DIMENSION_PX
+Inner host padding subtracted from measured network canvas dimensions.
 
-Minimum positive dimension allowed for generated starfield canvases.
+### FLAPPY_UI_OUTER_FRAME_BACKGROUND
 
-### FLAPPY_STARFIELD_ORIGIN_PX
+Outer frame background color for the browser demo host.
 
-Zero pixel origin used for starfield canvas clears and draws.
+### FLAPPY_UI_OUTER_FRAME_MIN_SIDE_PADDING_PX
 
-### FLAPPY_STARFIELD_CANVAS_CONTEXT_ID
+Side padding fallback for the outer frame when viewport is very narrow.
 
-Canvas rendering context identifier used for starfield tile generation.
+### FLAPPY_UI_OUTER_FRAME_SIDE_PADDING_OFFSET_PX
 
-### FLAPPY_STARFIELD_COMPOSITE_SOURCE_OVER
+Side padding offset applied to shared screen padding for frame layout.
 
-Composite mode used for normal starfield canvas drawing passes.
+### FLAPPY_UI_SPLIT_BRIDGE_COLOR
 
-### FLAPPY_STARFIELD_TRANSPARENT_SHADOW_COLOR
+Vertical split guide color between stats and network panes.
 
-Transparent shadow reset value used after glow drawing.
+### FLAPPY_UI_STATS_ROW_BORDER
 
-### FLAPPY_STARFIELD_FULL_ALPHA
+Border style for regular stats rows.
 
-Default fully opaque alpha restored after tile generation.
+### FLAPPY_UI_STATS_SECTION_BORDER
 
-### FLAPPY_STARFIELD_NO_BLUR_PX
+Border style for stats section headers.
 
-Blur reset value used after the star glow pass.
+### FLAPPY_UI_UNIFIED_INSET_SHADOW
 
-### FLAPPY_STARFIELD_INCLUSIVE_RANGE_OFFSET
+Shared inset glow shadow used by neon HUD panels.
 
-Inclusive range offset used when converting size bounds into random spans.
+### FLAPPY_VIEWPORT_MIN_NETWORK_HEIGHT_BUDGET_PX
+
+Minimum network panel height budget for responsive viewport sizing.
 
-### FLAPPY_STARFIELD_UNSIGNED_NORMALIZATION_DIVISOR
+### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_PX
 
-Divisor that normalizes unsigned 32-bit RNG state into the unit interval.
+Minimum simulation canvas height floor in responsive viewport sizing.
 
-### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_PRIMARY
+### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_RATIO
 
-Primary left-shift used by the xorshift32 random transition.
+Minimum simulation height ratio relative to window height.
 
-### FLAPPY_STARFIELD_XORSHIFT_RIGHT_SHIFT
+### FLAPPY_VIEWPORT_MINIMUM_STATS_HEIGHT_PX
 
-Middle right-shift used by the xorshift32 random transition.
+Minimum stats panel height used by responsive viewport sizing.
 
-### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_FINAL
+### FLAPPY_VIEWPORT_MOBILE_MINIMAL_UI_BREAKPOINT_PX
 
-Final left-shift used by the xorshift32 random transition.
+Width breakpoint below which only title + main simulation canvas are shown.
 
-### FLAPPY_STARFIELD_TILE_HEIGHT_PX
+In this minimal mobile layout, stats and network-visualization panels are
+hidden to maximize readable gameplay area.
 
-Height of one repeated starfield tile (pixels).
+### FLAPPY_VIEWPORT_NETWORK_ONLY_BREAKPOINT_PX
 
-### FLAPPY_STARFIELD_CYAN_FILL_STYLE
+Width breakpoint below which stats pane is hidden and network gets full width.
 
-Fill color used for cyan stars and glow dots in the generated tile.
+### FLAPPY_VIEWPORT_NETWORK_OVERLAY_HIDDEN_BREAKPOINT_PX
 
-### FLAPPY_STARFIELD_FAR_SCROLL_RATIO
+Width breakpoint below which network legend and architecture text are hidden.
 
-Horizontal scroll ratio for the farthest parallax layer.
+### FLAPPY_VIEWPORT_SIMULATION_BOTTOM_MARGIN_PX
 
-### FLAPPY_STARFIELD_MID_SCROLL_RATIO
+Additional bottom margin reserved during simulation canvas sizing.
 
-Horizontal scroll ratio for the middle parallax layer.
+### FLAPPY_VIEWPORT_VERTICAL_LAYOUT_GUTTER_PX
 
-### FLAPPY_STARFIELD_NEAR_SCROLL_RATIO
+Vertical layout gutter between stats panel and simulation canvas.
 
-Horizontal scroll ratio for the nearest parallax layer.
+### FLAPPY_WORLD_HEIGHT_PX
 
-### FLAPPY_STARFIELD_LAYER_SPECS
+Height of the simulated world (pixels).
 
-Declarative layer specs for the default starfield parallax bands.
+### FLAPPY_WORLD_WIDTH_PX
 
-Keeping the layer recipe in data form makes it easier to swap the lower
-segment to a different parallax family without changing the tile builder.
+Width of the simulated world (pixels).
 
 ## constants/constants.world.ts
 
@@ -1180,13 +1180,13 @@ This module groups stable geometry and run-budget values that define the
 simulation envelope. Keeping these together makes it easier to reason about
 how large the world is, where the bird is anchored, and when an episode ends.
 
-### FLAPPY_WORLD_WIDTH_PX
+### FLAPPY_BIRD_HEIGHT_PX
 
-Width of the simulated world (pixels).
+Bird collision height (diameter, pixels).
 
-### FLAPPY_WORLD_HEIGHT_PX
+### FLAPPY_BIRD_RADIUS_PX
 
-Height of the simulated world (pixels).
+Bird collision radius (pixels).
 
 ### FLAPPY_BIRD_X_PX
 
@@ -1195,14 +1195,6 @@ Fixed horizontal position of the bird (pixels).
 A fixed x-anchor turns the task into primarily vertical control while pipes
 move left, making policy behavior easier to visualize and debug.
 
-### FLAPPY_BIRD_RADIUS_PX
-
-Bird collision radius (pixels).
-
-### FLAPPY_BIRD_HEIGHT_PX
-
-Bird collision height (diameter, pixels).
-
 ### FLAPPY_ENABLE_RUNTIME_INSTRUMENTATION
 
 Enables runtime telemetry counters used for profiling diagnostics.
@@ -1217,6 +1209,14 @@ Episode terminates after this many frames even if still alive.
 This prevents extremely long outlier episodes from dominating generation
 runtime and keeps evolution throughput predictable.
 
+### FLAPPY_WORLD_HEIGHT_PX
+
+Height of the simulated world (pixels).
+
+### FLAPPY_WORLD_WIDTH_PX
+
+Width of the simulated world (pixels).
+
 ## constants/constants.physics.ts
 
 Flappy physics and control-cadence constants.
@@ -1227,12 +1227,15 @@ responds, and how often a policy can react inside each visible frame.
 Small changes here have outsized behavioral impact because they reshape the
 control problem the policy is trying to solve.
 
-### FLAPPY_GRAVITY_PX_PER_FRAME2
+### FLAPPY_CONTROL_SUBSTEPS_PER_FRAME
 
-Gravity acceleration applied each frame (pixels/frame²).
+Number of policy decision substeps executed inside each logical frame.
 
-Slightly increased so birds settle faster after each flap and can make
-finer vertical corrections around narrow targets.
+Values > 1 give agents finer temporal control in tight scenarios by allowing
+multiple react-and-integrate passes before the frame counter advances.
+
+This is one of the main levers that keeps high-speed play numerically stable
+without forcing the visible frame rate to explode.
 
 ### FLAPPY_FLAP_VELOCITY_PX_PER_FRAME
 
@@ -1241,21 +1244,18 @@ Instantaneous upward velocity applied on flap (pixels/frame).
 Reduced so each flap produces a smaller hop, improving precision when
 threading tighter gaps.
 
-### FLAPPY_MAX_FALL_SPEED_PX_PER_FRAME
-
-Maximum downward speed clamp (pixels/frame).
+### FLAPPY_GRAVITY_PX_PER_FRAME2
 
-This cap limits runaway fall acceleration and keeps trajectories learnable.
+Gravity acceleration applied each frame (pixels/frame²).
 
-### FLAPPY_CONTROL_SUBSTEPS_PER_FRAME
+Slightly increased so birds settle faster after each flap and can make
+finer vertical corrections around narrow targets.
 
-Number of policy decision substeps executed inside each logical frame.
+### FLAPPY_MAX_FALL_SPEED_PX_PER_FRAME
 
-Values > 1 give agents finer temporal control in tight scenarios by allowing
-multiple react-and-integrate passes before the frame counter advances.
+Maximum downward speed clamp (pixels/frame).
 
-This is one of the main levers that keeps high-speed play numerically stable
-without forcing the visible frame rate to explode.
+This cap limits runaway fall acceleration and keeps trajectories learnable.
 
 ### FLAPPY_TARGET_FLAP_INTERVAL_FRAMES
 
@@ -1279,21 +1279,12 @@ Pipe constants do double duty: some values describe actual gameplay geometry,
 while others are chosen so the visible pipe outline and the collision envelope
 feel aligned to a human viewer.
 
-### FLAPPY_PIPE_WIDTH_PX
-
-Pipe width (pixels).
-
-### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
-
-Visual gap between the pipe body and its outline on the sides (pixels).
-
-### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
-
-Visual gap between the pipe body and its outline at the pipe entrance rim (pixels).
+### FLAPPY_PIPE_COLLISION_ENTRANCE_EXPAND_PX
 
-### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+Effective gap-rim expansion used for pipe collision checks (pixels).
 
-Stroke width used for the pipe outline (pixels).
+Includes the visual entrance gap and half the outline stroke so collision
+matches the visible outer line around the gap opening.
 
 ### FLAPPY_PIPE_COLLISION_SIDE_EXPAND_PX
 
@@ -1302,12 +1293,13 @@ Effective side expansion used for pipe collision checks (pixels).
 Includes the visual side gap and half the outline stroke so collision
 matches the visible outer line thickness.
 
-### FLAPPY_PIPE_COLLISION_ENTRANCE_EXPAND_PX
+### FLAPPY_PIPE_GAP_CENTER_MAX_Y_PX
 
-Effective gap-rim expansion used for pipe collision checks (pixels).
+Maximum allowed gap center height (pixels).
 
-Includes the visual entrance gap and half the outline stroke so collision
-matches the visible outer line around the gap opening.
+### FLAPPY_PIPE_GAP_CENTER_MIN_Y_PX
+
+Minimum allowed gap center height (pixels).
 
 ### FLAPPY_PIPE_GAP_PX
 
@@ -1315,12 +1307,17 @@ Vertical opening size of each pipe gap (pixels).
 
 This is the nominal baseline gap before adaptive difficulty narrows it.
 
-### FLAPPY_PIPE_SPEED_PX_PER_FRAME
+### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
 
-Pipe horizontal speed (pixels/frame).
+Visual gap between the pipe body and its outline at the pipe entrance rim (pixels).
 
-Higher values shrink reaction time, which makes the same gap geometry much
-harder even before the adaptive curriculum starts tightening gaps.
+### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
+
+Visual gap between the pipe body and its outline on the sides (pixels).
+
+### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+
+Stroke width used for the pipe outline (pixels).
 
 ### FLAPPY_PIPE_SPAWN_INTERVAL_FRAMES
 
@@ -1329,13 +1326,16 @@ Frames between spawning new pipes.
 Together with pipe speed, this controls horizontal pacing and how much time a
 policy has to recover between obstacles.
 
-### FLAPPY_PIPE_GAP_CENTER_MIN_Y_PX
+### FLAPPY_PIPE_SPEED_PX_PER_FRAME
 
-Minimum allowed gap center height (pixels).
+Pipe horizontal speed (pixels/frame).
 
-### FLAPPY_PIPE_GAP_CENTER_MAX_Y_PX
+Higher values shrink reaction time, which makes the same gap geometry much
+harder even before the adaptive curriculum starts tightening gaps.
 
-Maximum allowed gap center height (pixels).
+### FLAPPY_PIPE_WIDTH_PX
+
+Pipe width (pixels).
 
 ## constants/constants.difficulty.ts
 
@@ -1345,38 +1345,45 @@ This module defines how spacing, speed, and gap variability tighten as
 agents become more capable. Keeping it separate helps tune curriculum
 behavior without mixing with core physics or rendering.
 
-### FLAPPY_MIN_CLEARANCE_MARGIN_PX
+### FLAPPY_DIFFICULTY_RAMP_PIPES
 
-Small geometric buffer so "barely possible" remains physically solvable.
+Pipe-pass count needed to reach maximum adaptive difficulty.
 
-### FLAPPY_MIN_PIPE_RECOVERY_FRAMES
+After this point, spacing does not tighten further, so proficient agents can
+sustain long runs without additional spacing compression.
 
-Hard floor on time between pipes at max speed so controllers can recover.
+### FLAPPY_MAX_DIFFICULTY_EDGE_TO_EDGE_PIPE_SPACING_PX
 
-This prevents endgame spacing from becoming too tight for realistic policy
-reaction and vertical correction.
+Actual edge-to-edge spacing produced at peak adaptive difficulty.
 
-### FLAPPY_MIN_EDGE_TO_EDGE_PIPE_SPACING_PX
+The recovery target above is a lower bound, but the runtime cadence is
+ultimately quantized by whole frames. This value is the real rendered pipe
+spacing once the minimum spawn interval has been rounded to an integer.
 
-Minimum edge-to-edge spacing needed to recover between consecutive pipes.
+### FLAPPY_MAX_DIFFICULTY_PIPE_PITCH_PX
 
-Derived from bird size + expected control drop budget + a small margin.
+Full pipe-to-pipe pitch produced at peak adaptive difficulty.
 
-### FLAPPY_PIPE_GAP_MIN_PX
+This is the distance from one pipe's leading edge to the next pipe's leading
+edge at the hardest steady-state cadence. It is the periodicity the ground
+grid must match if each spawned pipe should land on the same grid phase.
 
-Minimum pipe gap used at peak adaptive difficulty.
+### FLAPPY_MIN_CLEARANCE_MARGIN_PX
 
-### FLAPPY_PIPE_GAP_START_MULTIPLIER
+Small geometric buffer so "barely possible" remains physically solvable.
 
-Initial spawn gap multiplier relative to the current hardest gap target.
+### FLAPPY_MIN_EDGE_TO_EDGE_PIPE_SPACING_PX
 
-### FLAPPY_PIPE_GAP_SHRINK_PER_PIPE_PX
+Minimum edge-to-edge spacing needed to recover between consecutive pipes.
 
-Per-pipe gap shrink step toward the current hardest target gap (pixels).
+Derived from bird size + expected control drop budget + a small margin.
 
-### FLAPPY_PIPE_GAP_RANDOM_JITTER_PX
+### FLAPPY_MIN_PIPE_RECOVERY_FRAMES
 
-Random jitter range applied to each spawned pipe gap (pixels).
+Hard floor on time between pipes at max speed so controllers can recover.
+
+This prevents endgame spacing from becoming too tight for realistic policy
+reaction and vertical correction.
 
 ### FLAPPY_PIPE_GAP_CENTER_MAX_DELTA_PX
 
@@ -1385,44 +1392,37 @@ Maximum allowed vertical jump between consecutive pipe gap centers (pixels).
 This reduces abrupt zig-zag transitions that are often unrecoverable once
 spacing tightens at higher difficulty.
 
-### FLAPPY_PIPE_SPEED_MAX_PX_PER_FRAME
-
-Maximum pipe speed used at peak adaptive difficulty.
-
-### FLAPPY_PIPE_SPAWN_INTERVAL_MIN_FRAMES
+### FLAPPY_PIPE_GAP_MIN_PX
 
-Minimum spawn interval used at peak adaptive difficulty.
+Minimum pipe gap used at peak adaptive difficulty.
 
-### FLAPPY_MAX_DIFFICULTY_EDGE_TO_EDGE_PIPE_SPACING_PX
+### FLAPPY_PIPE_GAP_RANDOM_JITTER_PX
 
-Actual edge-to-edge spacing produced at peak adaptive difficulty.
+Random jitter range applied to each spawned pipe gap (pixels).
 
-The recovery target above is a lower bound, but the runtime cadence is
-ultimately quantized by whole frames. This value is the real rendered pipe
-spacing once the minimum spawn interval has been rounded to an integer.
+### FLAPPY_PIPE_GAP_SHRINK_PER_PIPE_PX
 
-### FLAPPY_MAX_DIFFICULTY_PIPE_PITCH_PX
+Per-pipe gap shrink step toward the current hardest target gap (pixels).
 
-Full pipe-to-pipe pitch produced at peak adaptive difficulty.
+### FLAPPY_PIPE_GAP_START_MULTIPLIER
 
-This is the distance from one pipe's leading edge to the next pipe's leading
-edge at the hardest steady-state cadence. It is the periodicity the ground
-grid must match if each spawned pipe should land on the same grid phase.
+Initial spawn gap multiplier relative to the current hardest gap target.
 
-### FLAPPY_PIPE_SPAWN_INTERVAL_START_MULTIPLIER
+### FLAPPY_PIPE_SPAWN_INTERVAL_MIN_FRAMES
 
-Initial spawn-interval multiplier relative to the current hardest interval target.
+Minimum spawn interval used at peak adaptive difficulty.
 
 ### FLAPPY_PIPE_SPAWN_INTERVAL_SHRINK_PER_PIPE_FRAMES
 
 Per-pipe spawn-interval shrink step toward the current hardest interval target (frames).
 
-### FLAPPY_DIFFICULTY_RAMP_PIPES
+### FLAPPY_PIPE_SPAWN_INTERVAL_START_MULTIPLIER
 
-Pipe-pass count needed to reach maximum adaptive difficulty.
+Initial spawn-interval multiplier relative to the current hardest interval target.
 
-After this point, spacing does not tighten further, so proficient agents can
-sustain long runs without additional spacing compression.
+### FLAPPY_PIPE_SPEED_MAX_PX_PER_FRAME
+
+Maximum pipe speed used at peak adaptive difficulty.
 
 ## constants/constants.observation.ts
 
@@ -1452,6 +1452,10 @@ Flappy policy-network and temporal memory constants.
 This module defines observation window shape and initial architecture sizing
 used when seeding agents for evolution.
 
+### FLAPPY_MEMORY_ACTION_WINDOW_STEPS
+
+Number of past actions retained for the action-memory channel.
+
 ### FLAPPY_MEMORY_CORE_FEATURE_COUNT
 
 Number of core per-frame observation features retained for temporal stacking.
@@ -1460,9 +1464,12 @@ Number of core per-frame observation features retained for temporal stacking.
 
 Number of temporal frames included in the stacked observation window.
 
-### FLAPPY_MEMORY_ACTION_WINDOW_STEPS
+### FLAPPY_NETWORK_HIDDEN_LAYER_SIZES
 
-Number of past actions retained for the action-memory channel.
+Hidden-layer sizes used to seed initial Flappy policy architectures.
+
+Using at least two hidden layers improves representational flexibility for
+precise vertical control near narrow, fast-changing pipe targets.
 
 ### FLAPPY_NETWORK_INPUT_SIZE
 
@@ -1472,13 +1479,6 @@ Number of observation features fed into each Flappy policy network.
 
 Number of output action scores emitted by each Flappy policy network.
 
-### FLAPPY_NETWORK_HIDDEN_LAYER_SIZES
-
-Hidden-layer sizes used to seed initial Flappy policy architectures.
-
-Using at least two hidden layers improves representational flexibility for
-precise vertical control near narrow, fast-changing pipe targets.
-
 ## constants/constants.fitness.ts
 
 Flappy reward-shaping constants.
@@ -1486,17 +1486,6 @@ Flappy reward-shaping constants.
 These values tune the learning signal seen by evolution. Separating them from
 world/physics constants keeps behavior tuning explicit and easier to teach.
 
-### FLAPPY_FITNESS_BONUS_PER_PIPE
-
-Fitness bonus added per pipe successfully passed.
-
-### FLAPPY_FITNESS_SURVIVAL_WEIGHT
-
-Fraction of raw frame-survival reward kept in total fitness.
-
-Lower values reduce the incentive to merely stay alive and increase pressure
-to center on gaps and pass pipes cleanly.
-
 ### FLAPPY_FITNESS_ALIGNMENT_WEIGHT_PER_FRAME
 
 Per-frame reward weight for staying vertically aligned with the next gap.
@@ -1505,6 +1494,10 @@ Per-frame reward weight for staying vertically aligned with the next gap.
 
 Reward scale for reducing distance to the next pipe between consecutive frames.
 
+### FLAPPY_FITNESS_BONUS_PER_PIPE
+
+Fitness bonus added per pipe successfully passed.
+
 ### FLAPPY_FITNESS_CENTERING_PROGRESS_WEIGHT
 
 Reward scale for reducing vertical error to the next gap center.
@@ -1521,6 +1514,13 @@ Per-frame reward weight for pre-aligning with the second upcoming gap.
 
 Per-frame reward weight for maintaining controllable vertical velocity.
 
+### FLAPPY_FITNESS_SURVIVAL_WEIGHT
+
+Fraction of raw frame-survival reward kept in total fitness.
+
+Lower values reduce the incentive to merely stay alive and increase pressure
+to center on gaps and pass pipes cleanly.
+
 ### FLAPPY_FITNESS_TERMINAL_ALIGNMENT_BONUS_WEIGHT
 
 Terminal bonus based on final alignment with the next gap center.
@@ -1544,16 +1544,12 @@ which defaults the demo uses when bootstrapping the worker.
 
 Default host container id for the browser demo mount point.
 
-### FLAPPY_EMULATION_SPEED_MULTIPLIER
-
-Emulation speed multiplier for browser playback (1.5 => 50% faster).
-
-### FLAPPY_HUD_UPDATE_INTERVAL_FRAMES
+### FLAPPY_BROWSER_ELITISM_COUNT
 
-Update HUD counters every N simulation frames to reduce DOM churn.
+Default elitism count for browser playback worker initialization.
 
-The value trades freshness for stability. Updating every frame would make the
-numbers twitchier and force more frequent DOM work on the main thread.
+Keeping elitism small in the browser demo emphasizes visible variety over raw
+training efficiency.
 
 ### FLAPPY_BROWSER_POPULATION_SIZE
 
@@ -1562,13 +1558,6 @@ Default population size for browser playback worker initialization.
 The browser default is intentionally smaller than the long-running trainer so
 the interactive demo remains responsive.
 
-### FLAPPY_BROWSER_ELITISM_COUNT
-
-Default elitism count for browser playback worker initialization.
-
-Keeping elitism small in the browser demo emphasizes visible variety over raw
-training efficiency.
-
 ### FLAPPY_DEFAULT_RNG_SEED
 
 Deterministic default RNG seed shared by browser runtime and trainer flows.
@@ -1576,41 +1565,32 @@ Deterministic default RNG seed shared by browser runtime and trainer flows.
 Reusing one canonical seed makes debugging and README examples more
 repeatable.
 
-### FLAPPY_FLAP_THRESHOLD
+### FLAPPY_EMULATION_SPEED_MULTIPLIER
 
-Normalized decision threshold used for scalar output flap policies.
+Emulation speed multiplier for browser playback (1.5 => 50% faster).
 
-### FLAPPY_NORMALIZATION_EPSILON
+### FLAPPY_FLAP_THRESHOLD
 
-Small epsilon divisor guard for world/physics normalization.
+Normalized decision threshold used for scalar output flap policies.
 
 ### FLAPPY_HALF
 
 Canonical half multiplier for centering and gap math.
 
-### FLAPPY_HUD_ZERO_TEXT
-
-Shared HUD value for integer zero fields.
-
-### FLAPPY_HUD_ZERO_DECIMAL_TEXT
+### FLAPPY_HUD_INITIALIZING_TEXT
 
-Shared HUD value for decimal zero fields.
+Initial status text displayed before evolution starts.
 
 ### FLAPPY_HUD_OFF_TEXT
 
 Shared HUD value when a metric is intentionally disabled.
 
-### FLAPPY_HUD_INITIALIZING_TEXT
-
-Initial status text displayed before evolution starts.
-
-### FLAPPY_STATUS_PLAYING_TEXT
-
-Runtime status text shown while a generation playback is running.
+### FLAPPY_HUD_UPDATE_INTERVAL_FRAMES
 
-### FLAPPY_STATUS_EVOLVING_TEXT
+Update HUD counters every N simulation frames to reduce DOM churn.
 
-Runtime status text shown between playback episodes.
+The value trades freshness for stability. Updating every frame would make the
+numbers twitchier and force more frequent DOM work on the main thread.
 
 ### FLAPPY_HUD_UPDATES_WINDOW_MS
 
@@ -1620,10 +1600,30 @@ HUD sliding-window size used when computing updates-per-second metric.
 
 HUD updates window duration in seconds for per-second conversion.
 
+### FLAPPY_HUD_ZERO_DECIMAL_TEXT
+
+Shared HUD value for decimal zero fields.
+
+### FLAPPY_HUD_ZERO_TEXT
+
+Shared HUD value for integer zero fields.
+
 ### FLAPPY_MINOR_GC_WINDOW_MS
 
 Sliding-window size used when computing minor GC events per minute.
 
+### FLAPPY_NORMALIZATION_EPSILON
+
+Small epsilon divisor guard for world/physics normalization.
+
+### FLAPPY_STATUS_EVOLVING_TEXT
+
+Runtime status text shown between playback episodes.
+
+### FLAPPY_STATUS_PLAYING_TEXT
+
+Runtime status text shown while a generation playback is running.
+
 ## constants/constants.layout.ts
 
 Browser UI layout and responsive-viewport constants.
@@ -1631,10 +1631,6 @@ Browser UI layout and responsive-viewport constants.
 This module contains spacing, panel sizing, and breakpoint values used to
 keep the demo readable from compact to wide viewports.
 
-### FLAPPY_SCREEN_PADDING_PX
-
-Screen-edge padding between viewport border and demo frame.
-
 ### FLAPPY_BIRD_VIEWPORT_X_RATIO
 
 Horizontal viewport anchor for the bird.
@@ -1642,33 +1638,45 @@ Horizontal viewport anchor for the bird.
 A value of `0.33` places the bird roughly one-third from the left, leaving
 more lookahead space for incoming pipes.
 
-### FLAPPY_UI_OUTER_FRAME_BACKGROUND
+### FLAPPY_SCREEN_PADDING_PX
 
-Outer frame background color for the browser demo host.
+Screen-edge padding between viewport border and demo frame.
 
-### FLAPPY_UI_NETWORK_HOST_BACKGROUND
+### FLAPPY_UI_CANVAS_INSET_SHADOW
 
-Host panel background color behind the network visualization canvas.
+Thin inset shadow used on canvases for subtle neon depth.
+
+### FLAPPY_UI_CONTENT_COLUMN_TOP_PADDING_PX
+
+Top padding for the vertical content column hosting canvases and stats.
+
+### FLAPPY_UI_DOUBLE_PANEL_BORDER
+
+Shared double-line border style matching title-box aesthetics.
 
 ### FLAPPY_UI_NETWORK_CANVAS_BACKGROUND
 
 Inner canvas clear color for the network visualization area.
 
-### FLAPPY_UI_UNIFIED_INSET_SHADOW
+### FLAPPY_UI_NETWORK_HOST_BACKGROUND
 
-Shared inset glow shadow used by neon HUD panels.
+Host panel background color behind the network visualization canvas.
 
-### FLAPPY_UI_DOUBLE_PANEL_BORDER
+### FLAPPY_UI_NETWORK_HOST_FIXED_HEIGHT_PX
 
-Shared double-line border style matching title-box aesthetics.
+Fixed network panel height used by responsive browser layout.
 
-### FLAPPY_UI_CANVAS_INSET_SHADOW
+### FLAPPY_UI_NETWORK_HOST_INITIAL_HEIGHT_PX
 
-Thin inset shadow used on canvases for subtle neon depth.
+Initial network panel height before topology-driven resizing runs.
 
-### FLAPPY_UI_SPLIT_BRIDGE_COLOR
+### FLAPPY_UI_NETWORK_HOST_INSET_PX
 
-Vertical split guide color between stats and network panes.
+Inner host padding subtracted from measured network canvas dimensions.
+
+### FLAPPY_UI_OUTER_FRAME_BACKGROUND
+
+Outer frame background color for the browser demo host.
 
 ### FLAPPY_UI_OUTER_FRAME_MIN_SIDE_PADDING_PX
 
@@ -1678,25 +1686,17 @@ Side padding fallback for the outer frame when viewport is very narrow.
 
 Side padding offset applied to shared screen padding for frame layout.
 
-### FLAPPY_UI_CONTENT_COLUMN_TOP_PADDING_PX
-
-Top padding for the vertical content column hosting canvases and stats.
-
-### FLAPPY_UI_NETWORK_HOST_INITIAL_HEIGHT_PX
-
-Initial network panel height before topology-driven resizing runs.
-
-### FLAPPY_UI_NETWORK_HOST_FIXED_HEIGHT_PX
+### FLAPPY_UI_SPLIT_BRIDGE_COLOR
 
-Fixed network panel height used by responsive browser layout.
+Vertical split guide color between stats and network panes.
 
-### FLAPPY_UI_NETWORK_HOST_INSET_PX
+### FLAPPY_UI_UNIFIED_INSET_SHADOW
 
-Inner host padding subtracted from measured network canvas dimensions.
+Shared inset glow shadow used by neon HUD panels.
 
-### FLAPPY_VIEWPORT_MINIMUM_STATS_HEIGHT_PX
+### FLAPPY_VIEWPORT_MIN_NETWORK_HEIGHT_BUDGET_PX
 
-Minimum stats panel height used by responsive viewport sizing.
+Minimum network panel height budget for responsive viewport sizing.
 
 ### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_PX
 
@@ -1706,17 +1706,16 @@ Minimum simulation canvas height floor in responsive viewport sizing.
 
 Minimum simulation height ratio relative to window height.
 
-### FLAPPY_VIEWPORT_VERTICAL_LAYOUT_GUTTER_PX
-
-Vertical layout gutter between stats panel and simulation canvas.
+### FLAPPY_VIEWPORT_MINIMUM_STATS_HEIGHT_PX
 
-### FLAPPY_VIEWPORT_SIMULATION_BOTTOM_MARGIN_PX
+Minimum stats panel height used by responsive viewport sizing.
 
-Additional bottom margin reserved during simulation canvas sizing.
+### FLAPPY_VIEWPORT_MOBILE_MINIMAL_UI_BREAKPOINT_PX
 
-### FLAPPY_VIEWPORT_MIN_NETWORK_HEIGHT_BUDGET_PX
+Width breakpoint below which only title + main simulation canvas are shown.
 
-Minimum network panel height budget for responsive viewport sizing.
+In this minimal mobile layout, stats and network-visualization panels are
+hidden to maximize readable gameplay area.
 
 ### FLAPPY_VIEWPORT_NETWORK_ONLY_BREAKPOINT_PX
 
@@ -1726,12 +1725,13 @@ Width breakpoint below which stats pane is hidden and network gets full width.
 
 Width breakpoint below which network legend and architecture text are hidden.
 
-### FLAPPY_VIEWPORT_MOBILE_MINIMAL_UI_BREAKPOINT_PX
+### FLAPPY_VIEWPORT_SIMULATION_BOTTOM_MARGIN_PX
 
-Width breakpoint below which only title + main simulation canvas are shown.
+Additional bottom margin reserved during simulation canvas sizing.
 
-In this minimal mobile layout, stats and network-visualization panels are
-hidden to maximize readable gameplay area.
+### FLAPPY_VIEWPORT_VERTICAL_LAYOUT_GUTTER_PX
+
+Vertical layout gutter between stats panel and simulation canvas.
 
 ## constants/constants.stats.ts
 
@@ -1740,6 +1740,18 @@ Browser HUD stats table constants.
 This module defines table ordering, hidden groups, and row metadata for the
 runtime status panel shown during playback.
 
+### FLAPPY_INSTRUMENTATION_STATS_KEYS
+
+Stats keys that are hidden when runtime instrumentation is disabled.
+
+### FLAPPY_NETWORK_LEGEND_HEADER_COLOR
+
+Legend header color.
+
+### FLAPPY_STATS_ARCHITECTURE_KEYS
+
+Stats keys whose values should render multi-line architecture content.
+
 ### FLAPPY_STATS_KEYS
 
 Ordered keys for the runtime stats table.
@@ -1748,18 +1760,10 @@ Ordered keys for the runtime stats table.
 
 Ordered row descriptors rendered into the runtime stats table.
 
-### FLAPPY_INSTRUMENTATION_STATS_KEYS
-
-Stats keys that are hidden when runtime instrumentation is disabled.
-
 ### FLAPPY_STATS_SECTION_KEYS
 
 Stats keys rendered as section headers rather than key/value rows.
 
-### FLAPPY_STATS_ARCHITECTURE_KEYS
-
-Stats keys whose values should render multi-line architecture content.
-
 ### FLAPPY_UI_STATS_ROW_BORDER
 
 Border style for regular stats rows.
@@ -1768,10 +1772,6 @@ Border style for regular stats rows.
 
 Border style for stats section headers.
 
-### FLAPPY_NETWORK_LEGEND_HEADER_COLOR
-
-Legend header color.
-
 ## constants/constants.frame.ts
 
 Glyph frame and text-layout constants for browser HUD rendering.
@@ -1779,93 +1779,93 @@ Glyph frame and text-layout constants for browser HUD rendering.
 These values keep the box-drawing title/header and text frame deterministic
 across browsers with slightly different font metrics.
 
-### FLAPPY_FRAME_MONOSPACE_FONT
-
-Reusable monospaced HUD font for glyph-based frame rendering.
-
-### FLAPPY_MONOSPACE_FONT_FAMILY
-
-Shared monospace font stack used by all HUD and visualization text.
-
-### FLAPPY_HEADER_TITLE_TEXT
+### FLAPPY_BOX_MIN_COLUMNS
 
-Title rendered inside the standalone header box.
+Minimum safe columns for box-drawing helper output.
 
-### FLAPPY_HEADER_CANVAS_HEIGHT_PX
+### FLAPPY_BOX_MIN_ROWS
 
-Header canvas fixed height (pixels).
+Minimum safe rows for box-drawing helper output.
 
 ### FLAPPY_FRAME_GLYPH_ROW_HEIGHT_PX
 
 Glyph-row height used for box-drawing rows (pixels).
 
+### FLAPPY_FRAME_MIN_COLUMNS
+
+Minimum glyph columns to keep frame readable on narrow widths.
+
 ### FLAPPY_FRAME_MIN_GLYPH_WIDTH_PX
 
 Minimum measured glyph width fallback (pixels).
 
-### FLAPPY_FRAME_MIN_COLUMNS
+### FLAPPY_FRAME_MONOSPACE_FONT
 
-Minimum glyph columns to keep frame readable on narrow widths.
+Reusable monospaced HUD font for glyph-based frame rendering.
 
 ### FLAPPY_FRAME_RESERVED_COLUMNS
 
 Reserved columns to keep right edge in bounds during metrics fit.
 
-### FLAPPY_TITLE_BOX_MIN_WIDTH
+### FLAPPY_GLYPH_BOTTOM_LEFT
 
-Minimum box width when building standalone title frame.
+Glyph character for bottom-left box corner.
 
-### FLAPPY_TITLE_BOX_MARGIN_COLUMNS
+### FLAPPY_GLYPH_BOTTOM_RIGHT
 
-Total side margin columns reserved around centered title box.
+Glyph character for bottom-right box corner.
 
-### FLAPPY_TITLE_BOX_WIDTH_RATIO
+### FLAPPY_GLYPH_HORIZONTAL
 
-Preferred title width relative to available frame width.
+Glyph character for horizontal box segment.
 
-### FLAPPY_TITLE_BOX_MIN_HALF_SPAN
+### FLAPPY_GLYPH_SPACE
 
-Minimum half-span when clamping centered title extents.
+Glyph character for interior spacing.
 
-### FLAPPY_TITLE_BOX_MIN_OUTER_GAP_COLUMNS
+### FLAPPY_GLYPH_TOP_LEFT
 
-Minimum columns between title box and outer rails.
+Glyph character for top-left box corner.
 
-### FLAPPY_BOX_MIN_COLUMNS
+### FLAPPY_GLYPH_TOP_RIGHT
 
-Minimum safe columns for box-drawing helper output.
+Glyph character for top-right box corner.
 
-### FLAPPY_BOX_MIN_ROWS
+### FLAPPY_GLYPH_VERTICAL
 
-Minimum safe rows for box-drawing helper output.
+Glyph character for vertical box segment.
 
-### FLAPPY_GLYPH_TOP_LEFT
+### FLAPPY_HEADER_CANVAS_HEIGHT_PX
 
-Glyph character for top-left box corner.
+Header canvas fixed height (pixels).
 
-### FLAPPY_GLYPH_TOP_RIGHT
+### FLAPPY_HEADER_TITLE_TEXT
 
-Glyph character for top-right box corner.
+Title rendered inside the standalone header box.
 
-### FLAPPY_GLYPH_BOTTOM_LEFT
+### FLAPPY_MONOSPACE_FONT_FAMILY
 
-Glyph character for bottom-left box corner.
+Shared monospace font stack used by all HUD and visualization text.
 
-### FLAPPY_GLYPH_BOTTOM_RIGHT
+### FLAPPY_TITLE_BOX_MARGIN_COLUMNS
 
-Glyph character for bottom-right box corner.
+Total side margin columns reserved around centered title box.
 
-### FLAPPY_GLYPH_HORIZONTAL
+### FLAPPY_TITLE_BOX_MIN_HALF_SPAN
+
+Minimum half-span when clamping centered title extents.
+
+### FLAPPY_TITLE_BOX_MIN_OUTER_GAP_COLUMNS
 
-Glyph character for horizontal box segment.
+Minimum columns between title box and outer rails.
 
-### FLAPPY_GLYPH_VERTICAL
+### FLAPPY_TITLE_BOX_MIN_WIDTH
 
-Glyph character for vertical box segment.
+Minimum box width when building standalone title frame.
 
-### FLAPPY_GLYPH_SPACE
+### FLAPPY_TITLE_BOX_WIDTH_RATIO
 
-Glyph character for interior spacing.
+Preferred title width relative to available frame width.
 
 ## constants/constants.rendering.ts
 
@@ -1887,56 +1887,56 @@ Bird, trail, and champion-highlight rendering constants.
 This module centralizes all per-bird visual treatments so appearance tuning
 stays decoupled from simulation and UI layout logic.
 
-### FLAPPY_TRAIL_MAX_POINTS
+### FLAPPY_BIRD_AURA_ALPHA
 
-Maximum number of trail points retained per bird trail polyline.
+Opacity used for the extra Radiant-style aura around each bird.
 
-### FLAPPY_CHAMPION_TRAIL_MAX_POINTS
+This is intentionally subtle: it should read as a soft bloom that lifts the
+bird off the background, without turning the bird into a big glowing blob.
 
-Maximum number of trail points retained for the champion-only short trail.
+### FLAPPY_BIRD_AURA_BLUR_MULTIPLIER
 
-### FLAPPY_TRAIL_LINE_WIDTH_PX
+Blur multiplier used for the Radiant-style bird aura plate.
 
-Stroke width used for per-bird trail line rendering.
+### FLAPPY_BIRD_AURA_EXPAND_PX
 
-### FLAPPY_TRAIL_EDGE_FADE_DISTANCE_PX
+Pixel expansion used for the Radiant-style bird aura plate.
 
-Distance from world edge over which trails fade to transparent (pixels).
+### FLAPPY_BIRD_BODY_GLOW_BLUR_PX
 
-### FLAPPY_NON_CHAMPION_OPACITY
+Base neon blur radius used for bird body glow.
 
-Opacity used for non-champion bird fills and trails.
+### FLAPPY_BIRD_CHAMPION_EXTRA_GLOW_BLUR_PX
 
-### FLAPPY_BIRD_BODY_GLOW_BLUR_PX
+Additional blur radius applied to the champion red body glow.
 
-Base neon blur radius used for bird body glow.
+This keeps the champion body bloom aligned with the same neon blur
+intensity used by the pipe outline glow, so the leader reads with
+comparable visual weight.
 
-### FLAPPY_NON_CHAMPION_BODY_GLOW_BLUR_PX
+### FLAPPY_CHAMPION_TRAIL_MAX_POINTS
 
-Glow blur radius used for simplified non-champion bird bodies.
+Maximum number of trail points retained for the champion-only short trail.
 
-### FLAPPY_BIRD_AURA_ALPHA
+### FLAPPY_NON_CHAMPION_BODY_GLOW_BLUR_PX
 
-Opacity used for the extra Radiant-style aura around each bird.
+Glow blur radius used for simplified non-champion bird bodies.
 
-This is intentionally subtle: it should read as a soft bloom that lifts the
-bird off the background, without turning the bird into a big glowing blob.
+### FLAPPY_NON_CHAMPION_OPACITY
 
-### FLAPPY_BIRD_AURA_EXPAND_PX
+Opacity used for non-champion bird fills and trails.
 
-Pixel expansion used for the Radiant-style bird aura plate.
+### FLAPPY_TRAIL_EDGE_FADE_DISTANCE_PX
 
-### FLAPPY_BIRD_AURA_BLUR_MULTIPLIER
+Distance from world edge over which trails fade to transparent (pixels).
 
-Blur multiplier used for the Radiant-style bird aura plate.
+### FLAPPY_TRAIL_LINE_WIDTH_PX
 
-### FLAPPY_BIRD_CHAMPION_EXTRA_GLOW_BLUR_PX
+Stroke width used for per-bird trail line rendering.
 
-Additional blur radius applied to the champion red body glow.
+### FLAPPY_TRAIL_MAX_POINTS
 
-This keeps the champion body bloom aligned with the same neon blur
-intensity used by the pipe outline glow, so the leader reads with
-comparable visual weight.
+Maximum number of trail points retained per bird trail polyline.
 
 ### FLAPPY_TRAIL_MIN_HORIZONTAL_SEGMENT_PX
 
@@ -1953,17 +1953,24 @@ Browser-only pipe rendering constants.
 This module bridges simulation pipe geometry with visual glow/outline passes
 used by the canvas renderer.
 
-### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
+### FLAPPY_PIPE_ENTRY_RIM_INSET_PX
 
-Visual gap between the pipe body and its outline on the sides (pixels).
+Inset used for the pipe entrance rim line measured from the gap-facing edge.
 
-### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_BLUR_PX
 
-Visual gap between the pipe body and its outline at the pipe entrance rim (pixels).
+Blur radius used for the cyan pipe outline glow (pixels).
 
-### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_COLOR
 
-Stroke width used for the pipe outline (pixels).
+Cyan neon glow used for pipe outline shadow.
+
+This intentionally matches the asciiMaze `neonCyan` ANSI color (`\x1b[38;5;87m`)
+which maps to xterm color 87 ~= rgb(95, 255, 255) / hex `#5fffff`.
+
+### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
+
+Visual gap between the pipe body and its outline at the pipe entrance rim (pixels).
 
 ### FLAPPY_PIPE_OUTLINE_GLOW_ALPHA
 
@@ -1973,20 +1980,13 @@ Opacity used for the soft pipe glow stroke pass.
 
 Stroke width used for the soft pipe glow stroke pass (pixels).
 
-### FLAPPY_PIPE_ENTRY_RIM_INSET_PX
-
-Inset used for the pipe entrance rim line measured from the gap-facing edge.
-
-### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_COLOR
-
-Cyan neon glow used for pipe outline shadow.
+### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
 
-This intentionally matches the asciiMaze `neonCyan` ANSI color (`\x1b[38;5;87m`)
-which maps to xterm color 87 ~= rgb(95, 255, 255) / hex `#5fffff`.
+Visual gap between the pipe body and its outline on the sides (pixels).
 
-### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_BLUR_PX
+### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
 
-Blur radius used for the cyan pipe outline glow (pixels).
+Stroke width used for the pipe outline (pixels).
 
 ## constants/constants.starfield.ts
 
@@ -1995,18 +1995,6 @@ Parallax starfield rendering constants.
 These values tune tile sizing, cyan star tint, and per-layer scroll ratios
 for the Radiant-style background drawn behind the gameplay world.
 
-### FLAPPY_STARFIELD_TILE_WIDTH_PX
-
-Width of one repeated starfield tile (pixels).
-
-### FLAPPY_STARFIELD_MIN_DIMENSION_PX
-
-Minimum positive dimension allowed for generated starfield canvases.
-
-### FLAPPY_STARFIELD_ORIGIN_PX
-
-Zero pixel origin used for starfield canvas clears and draws.
-
 ### FLAPPY_STARFIELD_CANVAS_CONTEXT_ID
 
 Canvas rendering context identifier used for starfield tile generation.
@@ -2015,64 +2003,76 @@ Canvas rendering context identifier used for starfield tile generation.
 
 Composite mode used for normal starfield canvas drawing passes.
 
-### FLAPPY_STARFIELD_TRANSPARENT_SHADOW_COLOR
+### FLAPPY_STARFIELD_CYAN_FILL_STYLE
 
-Transparent shadow reset value used after glow drawing.
+Fill color used for cyan stars and glow dots in the generated tile.
 
-### FLAPPY_STARFIELD_FULL_ALPHA
+### FLAPPY_STARFIELD_FAR_SCROLL_RATIO
 
-Default fully opaque alpha restored after tile generation.
+Horizontal scroll ratio for the farthest parallax layer.
 
-### FLAPPY_STARFIELD_NO_BLUR_PX
+### FLAPPY_STARFIELD_FULL_ALPHA
 
-Blur reset value used after the star glow pass.
+Default fully opaque alpha restored after tile generation.
 
 ### FLAPPY_STARFIELD_INCLUSIVE_RANGE_OFFSET
 
 Inclusive range offset used when converting size bounds into random spans.
 
-### FLAPPY_STARFIELD_UNSIGNED_NORMALIZATION_DIVISOR
+### FLAPPY_STARFIELD_LAYER_SPECS
 
-Divisor that normalizes unsigned 32-bit RNG state into the unit interval.
+Declarative layer specs for the default starfield parallax bands.
 
-### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_PRIMARY
+Keeping the layer recipe in data form makes it easier to swap the lower
+segment to a different parallax family without changing the tile builder.
 
-Primary left-shift used by the xorshift32 random transition.
+### FLAPPY_STARFIELD_MID_SCROLL_RATIO
 
-### FLAPPY_STARFIELD_XORSHIFT_RIGHT_SHIFT
+Horizontal scroll ratio for the middle parallax layer.
 
-Middle right-shift used by the xorshift32 random transition.
+### FLAPPY_STARFIELD_MIN_DIMENSION_PX
 
-### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_FINAL
+Minimum positive dimension allowed for generated starfield canvases.
 
-Final left-shift used by the xorshift32 random transition.
+### FLAPPY_STARFIELD_NEAR_SCROLL_RATIO
+
+Horizontal scroll ratio for the nearest parallax layer.
+
+### FLAPPY_STARFIELD_NO_BLUR_PX
+
+Blur reset value used after the star glow pass.
+
+### FLAPPY_STARFIELD_ORIGIN_PX
+
+Zero pixel origin used for starfield canvas clears and draws.
 
 ### FLAPPY_STARFIELD_TILE_HEIGHT_PX
 
 Height of one repeated starfield tile (pixels).
 
-### FLAPPY_STARFIELD_CYAN_FILL_STYLE
+### FLAPPY_STARFIELD_TILE_WIDTH_PX
 
-Fill color used for cyan stars and glow dots in the generated tile.
+Width of one repeated starfield tile (pixels).
 
-### FLAPPY_STARFIELD_FAR_SCROLL_RATIO
+### FLAPPY_STARFIELD_TRANSPARENT_SHADOW_COLOR
 
-Horizontal scroll ratio for the farthest parallax layer.
+Transparent shadow reset value used after glow drawing.
 
-### FLAPPY_STARFIELD_MID_SCROLL_RATIO
+### FLAPPY_STARFIELD_UNSIGNED_NORMALIZATION_DIVISOR
 
-Horizontal scroll ratio for the middle parallax layer.
+Divisor that normalizes unsigned 32-bit RNG state into the unit interval.
 
-### FLAPPY_STARFIELD_NEAR_SCROLL_RATIO
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_FINAL
 
-Horizontal scroll ratio for the nearest parallax layer.
+Final left-shift used by the xorshift32 random transition.
 
-### FLAPPY_STARFIELD_LAYER_SPECS
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_PRIMARY
 
-Declarative layer specs for the default starfield parallax bands.
+Primary left-shift used by the xorshift32 random transition.
 
-Keeping the layer recipe in data form makes it easier to swap the lower
-segment to a different parallax family without changing the tile builder.
+### FLAPPY_STARFIELD_XORSHIFT_RIGHT_SHIFT
+
+Middle right-shift used by the xorshift32 random transition.
 
 ## constants/constants.network-view.ts
 
@@ -2081,315 +2081,315 @@ Network visualization layout and tier-mapping constants.
 These values define graph padding, node sizing, legend geometry, and tier
 thresholds used to map connection and bias magnitudes to color ramps.
 
-### FLAPPY_CONNECTION_TIER_MAX_ABS_VALUE
-
-Connection-tier max absolute magnitude used by diverging color tiers.
-
-### FLAPPY_CONNECTION_TIER_CENTER_THRESHOLD
+### FLAPPY_BIAS_TIER_CENTER_THRESHOLD
 
-Connection-tier center threshold around zero.
+Bias-tier center threshold around zero.
 
-### FLAPPY_CONNECTION_TIER_EDGE_START_ABS_VALUE
+### FLAPPY_BIAS_TIER_EDGE_START_ABS_VALUE
 
-Connection-tier edge region start magnitude.
+Bias-tier edge region start magnitude.
 
 ### FLAPPY_BIAS_TIER_MAX_ABS_VALUE
 
 Bias-tier max absolute magnitude used by diverging color tiers.
 
-### FLAPPY_BIAS_TIER_CENTER_THRESHOLD
+### FLAPPY_CONNECTION_TIER_CENTER_THRESHOLD
 
-Bias-tier center threshold around zero.
+Connection-tier center threshold around zero.
 
-### FLAPPY_BIAS_TIER_EDGE_START_ABS_VALUE
+### FLAPPY_CONNECTION_TIER_EDGE_START_ABS_VALUE
 
-Bias-tier edge region start magnitude.
+Connection-tier edge region start magnitude.
 
-### FLAPPY_TIER_LOGARITHMIC_STEEPNESS
+### FLAPPY_CONNECTION_TIER_MAX_ABS_VALUE
 
-Shared logarithmic steepness for diverging color tier mapping.
+Connection-tier max absolute magnitude used by diverging color tiers.
 
-### FLAPPY_TIER_EDGE_COUNT
+### FLAPPY_NETWORK_ARCHITECTURE_COLUMN_SEPARATOR
 
-Number of linearly distributed edge tiers near maximum magnitudes.
+Separator used between architecture columns in the compact header label.
 
-### FLAPPY_NETWORK_GRAPH_LEFT_PADDING_PX
+### FLAPPY_NETWORK_ARCHITECTURE_LINE_SEPARATOR
 
-Graph-left padding for network visualization content.
+Line separator used by the two-line architecture label block.
 
-### FLAPPY_NETWORK_GRAPH_TOP_PADDING_PX
+### FLAPPY_NETWORK_BASELINE_HEIGHT_PX
 
-Graph-top padding for network visualization content.
+Baseline network panel height before complexity adjustments.
 
-### FLAPPY_NETWORK_GRAPH_RIGHT_PADDING_PX
+### FLAPPY_NETWORK_EMPTY_HIDDEN_LAYER_LABEL
 
-Graph-right padding for network visualization content.
+Placeholder label used when the network has no hidden layers.
 
 ### FLAPPY_NETWORK_GRAPH_BOTTOM_PADDING_PX
 
 Graph-bottom padding for network visualization content.
 
-### FLAPPY_NETWORK_MIN_DRAWABLE_SIZE_PX
-
-Minimum drawable graph dimension after padding is removed.
-
-### FLAPPY_NETWORK_LEGEND_GRAPH_GAP_PX
+### FLAPPY_NETWORK_GRAPH_INNER_PADDING_PX
 
-Gap between graph body and floating legend panel.
+Extra inner graph padding for topology-driven sizing.
 
-### FLAPPY_NETWORK_LEGEND_RIGHT_SIDE_THRESHOLD_RATIO
+### FLAPPY_NETWORK_GRAPH_LEFT_PADDING_PX
 
-Ratio used to decide whether the legend occupies the right half of the canvas.
+Graph-left padding for network visualization content.
 
-### FLAPPY_NETWORK_NODE_LAYOUT_PADDING_PX
+### FLAPPY_NETWORK_GRAPH_RIGHT_PADDING_PX
 
-Inner node-layout padding inside drawable network region.
+Graph-right padding for network visualization content.
 
-### FLAPPY_NETWORK_MIN_LABEL_HEIGHT_PX
+### FLAPPY_NETWORK_GRAPH_TOP_PADDING_PX
 
-Minimum node label height in pixels.
+Graph-top padding for network visualization content.
 
-### FLAPPY_NETWORK_MIN_NODE_INNER_PADDING_PX
+### FLAPPY_NETWORK_HEADER_FONT_SIZE_PX
 
-Minimum inner padding for node labels.
+Header font size for architecture label lines.
 
-### FLAPPY_NETWORK_INPUT_LAYER_TARGET_GAP_PX
+### FLAPPY_NETWORK_HIDDEN_LAYER_SEPARATOR
 
-Preferred vertical spacing between input-layer nodes.
+Separator used between hidden-layer sizes inside architecture labels.
 
-### FLAPPY_NETWORK_NODE_TOP_MARGIN_PX
+### FLAPPY_NETWORK_INFERRED_HIDDEN_LAYER_PREFIX
 
-Fixed top margin for node stacks inside the network drawable area.
+Prefix used when hidden-layer counts are inferred rather than declared.
 
-### FLAPPY_NETWORK_NODE_LABEL_SIZE_RATIO
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_GAP_PX
 
-Relative label-height ratio used when rendering node bias values.
+Horizontal gap between input-node column and vertical group label band.
 
-### FLAPPY_NETWORK_NODE_LABEL_FONT_WEIGHT
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_WIDTH_PX
 
-Font-weight used when rendering node bias values.
+Width of the vertical input-group label band.
 
-### FLAPPY_NETWORK_MIN_NODE_WIDTH_PX
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_SIZE_PX
 
-Minimum node width in network visualization.
+Font size used for vertical input-group label text.
 
-### FLAPPY_NETWORK_MAX_NODE_HEIGHT_PX
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_WEIGHT
 
-Maximum node height in network visualization.
+Font weight used for vertical input-group label text.
 
-### FLAPPY_NETWORK_MAX_NODE_WIDTH_PX
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_MIN_HEIGHT_PX
 
-Maximum node width in network visualization.
+Minimum visual height for any input-group label band.
 
-### FLAPPY_NETWORK_MIN_INTER_NODE_GAP_PX
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_RADIUS_PX
 
-Minimum inter-node vertical gap for topology-driven sizing.
+Corner radius used by input-group label band backgrounds.
 
-### FLAPPY_NETWORK_GRAPH_INNER_PADDING_PX
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_TEXT_COLOR
 
-Extra inner graph padding for topology-driven sizing.
+Text color for vertical input-group labels on neon backgrounds.
 
-### FLAPPY_NETWORK_BASELINE_HEIGHT_PX
+### FLAPPY_NETWORK_INPUT_LAYER_TARGET_GAP_PX
 
-Baseline network panel height before complexity adjustments.
+Preferred vertical spacing between input-layer nodes.
 
-### FLAPPY_NETWORK_NODE_DENSITY_HEIGHT_STEP_PX
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_BASELINE_COUNT
 
-Additional height increment per node above baseline density.
+Baseline layer-count threshold before layer-complexity height increments apply.
 
 ### FLAPPY_NETWORK_LAYER_COMPLEXITY_HEIGHT_STEP_PX
 
 Additional height increment per extra layer above baseline.
 
-### FLAPPY_NETWORK_MIN_HEIGHT_PX
+### FLAPPY_NETWORK_LEGEND_BACKGROUND
 
-Minimum clamped network panel height.
+Legend panel background fill color.
 
-### FLAPPY_NETWORK_MAX_HEIGHT_PX
+### FLAPPY_NETWORK_LEGEND_BOTTOM_PADDING_PX
 
-Maximum clamped network panel height.
+Legend bottom padding in compact/regular layouts.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_THRESHOLD_PX
+### FLAPPY_NETWORK_LEGEND_COMPACT_FONT_SIZE_PX
 
-Compact legend width threshold for network visualization.
+Legend font size for compact mode.
 
 ### FLAPPY_NETWORK_LEGEND_COMPACT_HEIGHT_THRESHOLD_PX
 
 Compact legend height threshold for network visualization.
 
+### FLAPPY_NETWORK_LEGEND_COMPACT_ROW_HEIGHT_PX
+
+Legend row height in compact mode.
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_GAP_PX
+
+Legend section gap in compact mode.
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_TITLE_HEIGHT_PX
+
+Legend section title height in compact mode.
+
 ### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_PX
 
 Compact legend panel width.
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_WIDTH_PX
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_THRESHOLD_PX
 
-Regular legend panel width.
+Compact legend width threshold for network visualization.
+
+### FLAPPY_NETWORK_LEGEND_CONNECTION_LINE_WIDTH_PX
+
+Connection row stroke line width in legend.
+
+### FLAPPY_NETWORK_LEGEND_GRAPH_GAP_PX
+
+Gap between graph body and floating legend panel.
 
 ### FLAPPY_NETWORK_LEGEND_HEADER_HEIGHT_PX
 
 Legend header row height.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_TITLE_HEIGHT_PX
+### FLAPPY_NETWORK_LEGEND_MARGIN_PX
 
-Legend section title height in compact mode.
+Legend panel outer margin.
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_TITLE_HEIGHT_PX
+### FLAPPY_NETWORK_LEGEND_MIN_TOP_PX
 
-Legend section title height in regular mode.
+Minimum top clamp for legend placement.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_ROW_HEIGHT_PX
+### FLAPPY_NETWORK_LEGEND_REGULAR_FONT_SIZE_PX
 
-Legend row height in compact mode.
+Legend font size for regular mode.
 
 ### FLAPPY_NETWORK_LEGEND_REGULAR_ROW_HEIGHT_PX
 
 Legend row height in regular mode.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_GAP_PX
-
-Legend section gap in compact mode.
-
 ### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_GAP_PX
 
 Legend section gap in regular mode.
 
-### FLAPPY_NETWORK_LEGEND_BOTTOM_PADDING_PX
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_TITLE_HEIGHT_PX
 
-Legend bottom padding in compact/regular layouts.
+Legend section title height in regular mode.
 
-### FLAPPY_NETWORK_LEGEND_MARGIN_PX
+### FLAPPY_NETWORK_LEGEND_REGULAR_WIDTH_PX
 
-Legend panel outer margin.
+Regular legend panel width.
 
-### FLAPPY_NETWORK_LEGEND_TOP_LEFT_THRESHOLD_PX
+### FLAPPY_NETWORK_LEGEND_RIGHT_SIDE_THRESHOLD_RATIO
 
-Canvas width threshold to prefer top-left legend placement.
+Ratio used to decide whether the legend occupies the right half of the canvas.
 
 ### FLAPPY_NETWORK_LEGEND_TARGET_TOP_PX
 
 Target top offset used for legend placement.
 
-### FLAPPY_NETWORK_LEGEND_MIN_TOP_PX
-
-Minimum top clamp for legend placement.
-
-### FLAPPY_NETWORK_LEGEND_BACKGROUND
-
-Legend panel background fill color.
-
-### FLAPPY_NETWORK_LEGEND_CONNECTION_LINE_WIDTH_PX
+### FLAPPY_NETWORK_LEGEND_TOP_LEFT_THRESHOLD_PX
 
-Connection row stroke line width in legend.
+Canvas width threshold to prefer top-left legend placement.
 
-### FLAPPY_NETWORK_LEGEND_COMPACT_FONT_SIZE_PX
+### FLAPPY_NETWORK_MAX_HEIGHT_PX
 
-Legend font size for compact mode.
+Maximum clamped network panel height.
 
-### FLAPPY_NETWORK_LEGEND_REGULAR_FONT_SIZE_PX
+### FLAPPY_NETWORK_MAX_NODE_HEIGHT_PX
 
-Legend font size for regular mode.
+Maximum node height in network visualization.
 
-### FLAPPY_NETWORK_HEADER_FONT_SIZE_PX
+### FLAPPY_NETWORK_MAX_NODE_WIDTH_PX
 
-Header font size for architecture label lines.
+Maximum node width in network visualization.
 
-### FLAPPY_NETWORK_MIN_NODE_HEIGHT_LABEL_EXTRA_PX
+### FLAPPY_NETWORK_MIN_DRAWABLE_SIZE_PX
 
-Extra pixel allowance above label baseline for minimum node-height readability.
+Minimum drawable graph dimension after padding is removed.
 
-### FLAPPY_NETWORK_MIN_NODE_FIT_HEIGHT_PX
+### FLAPPY_NETWORK_MIN_HEIGHT_PX
 
-Minimum fit-based node height before width and label constraints are applied.
+Minimum clamped network panel height.
 
-### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_DIVISOR
+### FLAPPY_NETWORK_MIN_INTER_NODE_GAP_PX
 
-Layer-fit divisor used when deriving max node height from dense layer stacks.
+Minimum inter-node vertical gap for topology-driven sizing.
 
-Larger values keep nodes shorter in dense topologies so labels remain legible.
+### FLAPPY_NETWORK_MIN_LABEL_HEIGHT_PX
 
-### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_MIN_DENOMINATOR
+Minimum node label height in pixels.
 
-Minimum denominator clamp for dense-layer node-height derivation.
+### FLAPPY_NETWORK_MIN_NODE_FIT_HEIGHT_PX
 
-### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_DIVISOR
+Minimum fit-based node height before width and label constraints are applied.
 
-Width-fit divisor used when deriving node height from layer count.
+### FLAPPY_NETWORK_MIN_NODE_HEIGHT_LABEL_EXTRA_PX
 
-### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_MIN_DENOMINATOR
+Extra pixel allowance above label baseline for minimum node-height readability.
 
-Minimum denominator clamp for layer-width node-height derivation.
+### FLAPPY_NETWORK_MIN_NODE_INNER_PADDING_PX
 
-### FLAPPY_NETWORK_NODE_WIDTH_TO_HEIGHT_RATIO
+Minimum inner padding for node labels.
 
-Width-to-height ratio used for node rectangle proportions.
+### FLAPPY_NETWORK_MIN_NODE_WIDTH_PX
 
-### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_DIVISOR
+Minimum node width in network visualization.
 
-Width-fit divisor used when deriving node width from layer count.
+### FLAPPY_NETWORK_NODE_DENSITY_BASELINE_COUNT
 
-### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_MIN_DENOMINATOR
+Baseline node-count threshold before node-density height increments apply.
 
-Minimum denominator clamp for layer-width node-width derivation.
+### FLAPPY_NETWORK_NODE_DENSITY_HEIGHT_STEP_PX
 
-### FLAPPY_NETWORK_NODE_DENSITY_BASELINE_COUNT
+Additional height increment per node above baseline density.
 
-Baseline node-count threshold before node-density height increments apply.
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_DIVISOR
 
-### FLAPPY_NETWORK_LAYER_COMPLEXITY_BASELINE_COUNT
+Layer-fit divisor used when deriving max node height from dense layer stacks.
 
-Baseline layer-count threshold before layer-complexity height increments apply.
+Larger values keep nodes shorter in dense topologies so labels remain legible.
 
-### FLAPPY_NETWORK_TOPOLOGY_HEIGHT_MULTIPLIER
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_MIN_DENOMINATOR
 
-Additional multiplier used for topology-driven minimum host-height recommendation.
+Minimum denominator clamp for dense-layer node-height derivation.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_GAP_PX
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_DIVISOR
 
-Horizontal gap between input-node column and vertical group label band.
+Width-fit divisor used when deriving node height from layer count.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_WIDTH_PX
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_MIN_DENOMINATOR
 
-Width of the vertical input-group label band.
+Minimum denominator clamp for layer-width node-height derivation.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_MIN_HEIGHT_PX
+### FLAPPY_NETWORK_NODE_LABEL_FONT_WEIGHT
 
-Minimum visual height for any input-group label band.
+Font-weight used when rendering node bias values.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_RADIUS_PX
+### FLAPPY_NETWORK_NODE_LABEL_SIZE_RATIO
 
-Corner radius used by input-group label band backgrounds.
+Relative label-height ratio used when rendering node bias values.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_SIZE_PX
+### FLAPPY_NETWORK_NODE_LAYOUT_PADDING_PX
 
-Font size used for vertical input-group label text.
+Inner node-layout padding inside drawable network region.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_WEIGHT
+### FLAPPY_NETWORK_NODE_TOP_MARGIN_PX
 
-Font weight used for vertical input-group label text.
+Fixed top margin for node stacks inside the network drawable area.
 
-### FLAPPY_NETWORK_INPUT_GROUP_LABEL_TEXT_COLOR
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_DIVISOR
 
-Text color for vertical input-group labels on neon backgrounds.
+Width-fit divisor used when deriving node width from layer count.
 
-### FLAPPY_NETWORK_EMPTY_HIDDEN_LAYER_LABEL
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_MIN_DENOMINATOR
 
-Placeholder label used when the network has no hidden layers.
+Minimum denominator clamp for layer-width node-width derivation.
 
-### FLAPPY_NETWORK_INFERRED_HIDDEN_LAYER_PREFIX
+### FLAPPY_NETWORK_NODE_WIDTH_TO_HEIGHT_RATIO
 
-Prefix used when hidden-layer counts are inferred rather than declared.
+Width-to-height ratio used for node rectangle proportions.
 
-### FLAPPY_NETWORK_HIDDEN_LAYER_SEPARATOR
+### FLAPPY_NETWORK_TOPOLOGY_HEIGHT_MULTIPLIER
 
-Separator used between hidden-layer sizes inside architecture labels.
+Additional multiplier used for topology-driven minimum host-height recommendation.
 
-### FLAPPY_NETWORK_ARCHITECTURE_COLUMN_SEPARATOR
+### FLAPPY_TIER_EDGE_COUNT
 
-Separator used between architecture columns in the compact header label.
+Number of linearly distributed edge tiers near maximum magnitudes.
 
-### FLAPPY_NETWORK_ARCHITECTURE_LINE_SEPARATOR
+### FLAPPY_TIER_LOGARITHMIC_STEEPNESS
 
-Line separator used by the two-line architecture label block.
+Shared logarithmic steepness for diverging color tier mapping.
 
 ## constants/constants.palette.ts
 
@@ -2398,58 +2398,58 @@ Browser visual palette constants for the Flappy demo.
 This module centralizes theme colors and diverging ramps so visual tuning is
 easy to find and consistent across HUD, birds, pipes, and network overlays.
 
-### FLAPPY_NEON_PALETTE
+### FLAPPY_CENTER_BLUE_RAMP
 
-TRON-like neon palette matching asciiMaze style.
+Neutral-center blue ramp for near-zero diverging tiers.
+
+### FLAPPY_LIGHT_NEON_RAMP
+
+Light neon ramp used for high-contrast negative scales.
 
 ### FLAPPY_NEON_BIRD_PALETTE
 
 Neon bird palette for per-agent render color assignment.
 
-### FLAPPY_REGULAR_NEON_RAMP
+### FLAPPY_NEON_PALETTE
 
-Regular neon ramp used for strong positive/baseline scales.
+TRON-like neon palette matching asciiMaze style.
 
-### FLAPPY_LIGHT_NEON_RAMP
+### FLAPPY_NETWORK_HEADER_TEXT_COLOR
 
-Light neon ramp used for high-contrast negative scales.
+Header text color for architecture label in visualization.
 
-### FLAPPY_CENTER_BLUE_RAMP
+### FLAPPY_NETWORK_HIDDEN_NODE_STROKE_COLOR
 
-Neutral-center blue ramp for near-zero diverging tiers.
+Hidden-node stroke color.
 
-### FLAPPY_TIER_ABOVE_COLOR
+### FLAPPY_NETWORK_LEGEND_BIAS_TITLE_COLOR
 
-Fallback color when a value exceeds all configured tiers.
+Legend section title color for node bias rows.
 
 ### FLAPPY_NETWORK_LEGEND_CONNECTION_TITLE_COLOR
 
 Legend section title color for connection weight rows.
 
-### FLAPPY_NETWORK_LEGEND_BIAS_TITLE_COLOR
-
-Legend section title color for node bias rows.
-
 ### FLAPPY_NETWORK_LEGEND_ROW_TEXT_COLOR
 
 Legend row text color.
 
-### FLAPPY_NETWORK_HEADER_TEXT_COLOR
-
-Header text color for architecture label in visualization.
-
 ### FLAPPY_NETWORK_NODE_LABEL_FILL_COLOR
 
 Dark fill color used for node bias labels.
 
+### FLAPPY_NETWORK_OUTPUT_NODE_GLOW_COLOR
+
+Output-node glow color.
+
 ### FLAPPY_NETWORK_OUTPUT_NODE_STROKE_COLOR
 
 Output-node stroke color.
 
-### FLAPPY_NETWORK_HIDDEN_NODE_STROKE_COLOR
+### FLAPPY_REGULAR_NEON_RAMP
 
-Hidden-node stroke color.
+Regular neon ramp used for strong positive/baseline scales.
 
-### FLAPPY_NETWORK_OUTPUT_NODE_GLOW_COLOR
+### FLAPPY_TIER_ABOVE_COLOR
 
-Output-node glow color.
+Fallback color when a value exceeds all configured tiers.