Add narration prefetch API for cache warming.
Shipped as 134edfd.
What Changed
This pass makes NPC narration more usable in the browser by adding cache-aware behavior, cache warming, and bounded live calls so the page remains responsive.
- Worked in job board and contract flow.
- Worked in Letta narration.
Why It Matters
LLM-backed flavor is valuable only if it does not stall play. The cache and prefetch work keeps the experience responsive while still supporting richer NPC beats.
Implementation Notes
The commit message for this slice was:
Introduces /api/narrate-prefetch.php to hydrate Letta beat cache for a seed/job/crew and adds a play-page action to trigger warm-up before interactive narrated runs.
Files touched in this slice included:
public/api/narrate-prefetch.phppublic/play.php
Verification
- The change was committed to
mainand included in the running devlog timeline. - The current archive test suite verifies devlog posts render with substantive body content, illustrations, screenshots, and valid asset references.
- For browser-facing slices, Playwright smoke checks in this build cycle covered the active game surfaces and devlog pages.
Visuals
