feat: package pantry crisis demo

docs/BUILD_IN_PUBLIC_PLAN.md

@@ -503,6 +503,15 @@ Jasmin—rather than an unnamed cinematic extra.
 The clip has an understandable beginning, decision, and consequence. It does not
 depend on a voiceover to prove that the simulation is real.
 
+**Status: complete.** `F11` reloads the fixed authored start and runs one
+cinematic pantry-crisis story: a brief valley establishment, the empty pantry
+and worried villager, a trusted helper's real finite-resource trip, visible
+carrying, deposit, and physical recovery. Four short cardless captions fade over
+the world while the camera hands off from the pantry to the helper. The same
+withdrawal, consumption, extraction, and deposit records drive the need and its
+resolution. `tools/validate_pantry_crisis_demo.gd` verifies that the unassisted
+route completes inside the 20–30 second budget.
+
 ## Build-in-public content pillars
 
 Rotate between four types of updates.
@@ -720,11 +729,9 @@ Completed:
 
 Next:
 
-1. Package one 20–30 second, repeatable pantry-crisis sequence that communicates
-   shortage, purposeful gathering, visible carrying, deposit, and recovery
-   without debug UI. Treat any art or timing work as support for that single
-   readable cause-and-effect loop. Resume the second missing-wood opportunity
-   proof after this public-demo exit test, as sequenced in
+1. Resume the second bounded opportunity proof from a real missing-wood
+   `task_blocked` fact. Include deterministic interested-party death/staleness
+   handling before extracting shared opportunity machinery, as sequenced in
    `LEARNING_ROADMAP.md`.
 
 Do not start with GIS data, a full city, a large asset pack, or more NPC

docs/LEARNING_ROADMAP.md

@@ -742,14 +742,26 @@ complete:
 - the repeatable runtime capture now includes an empty/restocked close pair in
   the established elevated third-person visual language.
 
-Milestone 7 is not complete. The immediate outcome-defined slice is now one
-short, repeatable pantry-crisis sequence that reads without debug UI: shortage,
-interested villager, finite-resource trip, visible carrying, deposit, and
-physical recovery. Improve route timing, work feedback, and village composition
-only where that sequence exposes a readability problem. Once that public-demo
-loop passes, prove a second bounded unresolved-condition consumer from a real
-missing-wood `task_blocked` fact, include deterministic interested-party
-death/staleness handling, and only then extract shared opportunity machinery.
+The outcome-defined pantry-crisis demo loop is complete:
+
+- `F11` reloads the authored seed and runs a measured 20–30 second cinematic
+  sequence with the development UI hidden;
+- a real final-food withdrawal and consumption leave the physical pantry empty
+  and open the knowledge-gated need for its worried witness;
+- a trusted acquaintance selects ordinary `gather_food`, reserves and visits a
+  finite berry source, visibly carries its yield home, and autonomously selects
+  the real pantry deposit;
+- that exact deposit resolves the opportunity, restores the physical stock,
+  clears concern, and triggers the existing refill response;
+- restrained captions and a camera handoff clarify the three beats without
+  replacing state-driven world cues, while a runtime validator measures the
+  unassisted route and a headless scenario verifies its full event chain.
+
+Milestone 7 is not complete. The immediate next slice is the second bounded
+unresolved-condition consumer from a real missing-wood `task_blocked` fact,
+including deterministic interested-party death/staleness handling. Extract
+shared opportunity machinery only after that second consumer proves the common
+contract.
 
 Recently completed:
 

docs/PROJECT_CONTEXT.md

@@ -882,11 +882,18 @@ facts now have a cardless world expression: empty/low/stocked pantry props, one
 interested-villager concern cue, and a brief refill response. Save/load rebuilds
 the stable state without replaying the response.
 
-Milestone 7 remains in progress. The immediate next slice is an outcome-defined
-20–30 second pantry-crisis demo loop—shortage, finite-resource travel, visible
-carrying, deposit, and physical recovery—without debug UI. The second
-missing-wood consumer and deterministic interested-party death/staleness rules
-follow that visual exit test, before common opportunity machinery is extracted.
+The outcome-defined pantry-crisis demo loop is complete. `F11` reloads a fixed
+authored start and packages a measured 20–30 second cinematic story with brief
+captions: real withdrawal and consumption expose the shortage, a worried
+informed villager remains at the empty pantry, and a trusted helper selects a
+finite berry source, visibly carries its yield, deposits it, and causes the
+physical recovery. A headless lifecycle scenario and an unassisted runtime
+timing validator cover the complete path.
+
+Milestone 7 remains in progress. The immediate next slice is the second
+missing-wood consumer from a real `task_blocked` fact, including deterministic
+interested-party death/staleness handling before common opportunity machinery
+is extracted.
 
 The remaining simulation-garden target still aims for: