security-game/TODO.md

TODO

Work is grouped by theme. Each item should be small enough to complete and verify on its own; see AGENTS.md for the workflow and MEMORY.md for the decisions behind these plans.

Venue geometry and the committed gallery (v0.6.1)

Today all three venues share the Hollywood WorldBuilder geometry, so the Joke Shop and studio concepts are only compared on lighting (noted in tools/scene_concepts.py SHOTS). They also have no stage in the committed docs/screenshots/ gallery, only in capture_realism.gd.

• Extract a geometry spec per venue instead of branching inline: a scenario. (or WorldBuilder) table of facade width/height, door style, window rows, awning/marquee flags, street furniture set, palette and props, defaulting to the Hollywood values so nothing regresses.
• Joke Shop: narrow brick alley (10–12 m wide), one warm wall lantern as the key light, recessed door with a step, shuttered window, dumpster/AC clutter, no skyline ring — the alley concept has depth, not a horizon.
• TV Studio: granite/stone facade, bulb canopy instead of the marquee, glossy black car on the curb, stanchions and barrier line at the door, no palm trees.
• Keep navigation working: regenerate/verify the NavigationRegion3D bake per venue, update sidewalk/steps/door waypoints (Joke Shop and Studio already have sidewalk and steps_end), and confirm NPCs still reach the door (smoke + test_venue_*).
• Split the concept mapping so each venue is judged on its own frame (joke_shop_*, studio_*) and drop the "shared geometry" caveat in tools/scene_concepts.py.
• Add both venues to the committed gallery: two new stages in src/test/capture_screenshots.gd (12-joke-shop.png, 13-studio-arrival.png) reusing the existing joke_shop_queue / studio_arrival designs, then check_screenshots.sh and a fresh judge run.
• Update docs/architecture.md (venue geometry), README.md (gallery) and the screenshot table when the stages land.

Forward+ desktop preset and a volumetric flashlight (v0.7.0)

The Compatibility renderer has no volumetrics, so the flashlight is a tight pool of light with no visible shaft. A second desktop build can render it properly without touching the CI/default path.

• Write the preset as an override.cfg (Godot reads it beside the binary/project) that sets rendering/renderer/rendering_method="forward_plus", enables volumetric_fog_* and SDFGI, and keeps the Compatibility build as the default (project.godot unchanged).
• Gate the effect in code: only give the flashlight a volumetric component when the renderer is Forward+ (RenderingServer.get_rendering_device() != null), so Web/CI builds are untouched and the existing headless tests keep passing.
• Tune light_volumetric_fog_energy/fog_density for the LATE phase and re-check the entrance so the shaft does not wash the facade again (the reason the wide cone was cut).
• A/B the two renderers with capture_realism.gd (same stages, two --out dirs) and record the diff + judge scores in docs/screens/realism/<date>-forward-plus/.
• Add the preset to tools/build_releases.sh and docs/RELEASING.md as an optional "desktop HQ" artifact, and note the runtime requirement (Vulkan driver) in README.md.
• Test: a headless run must still boot when Forward+ is unavailable (the preset must degrade to Compatibility instead of failing to start).

Realism follow-ups (deferred)

• Capture a hooded/winter NPC close-up once a scenario spawns types 5-7 (the explicit --portrait-type override is already in capture_realism.gd).
• Human-authored tree/hedge silhouettes: the whole scene now reads well except the foliage, which is still flat-shaded clumps (_shrub()/_tree() in tools/blender_assets.py). Only worth doing if a higher-poly organic builder is added to the library.
• Camera height: the concept frames are shot at ~1.55 m with a slightly wider lens; the game camera sits at 1.7 m. Decide whether the first-person height should match the art direction or stay at the current gameplay value.

Future ideas (optional, not scheduled)

• Live 3D body-camera replay (the timeline is text-only today).
• Additional venues or seasonal events authored from the new .tres files.
• Real voice/dialogue audio (the crowd bed and radio crackle are procedural).
• Swap the primitive prop builder for an image-to-mesh model API behind the same assets/models/generated/<prop>.glb contract.