docs: extend demo chrome through scene twelve

This commit is contained in:
lda
2026-07-12 14:37:56 +07:00 Verified
parent 46f25b453b
commit f920c7f3d9
@@ -24,8 +24,11 @@ paths, not file contents or a read operation.
3. Make footer content derive from the current scene and beat, so backtracking 3. Make footer content derive from the current scene and beat, so backtracking
cannot retain a previous beat's status or copy. cannot retain a previous beat's status or copy.
4. Separate target health from demo playback mode. 4. Separate target health from demo playback mode.
5. Keep the footer slot geometrically stable while target health is checking. 5. Keep the footer slot geometrically stable while target health is checking or
6. Replace unsupported file claims with factual input-manifest language. the run changes phase.
6. Make the prepared-run control available throughout the demo arc without
repeating large buttons inside individual scenes.
7. Replace unsupported file claims with factual input-manifest language.
## Non-goals ## Non-goals
@@ -33,21 +36,23 @@ paths, not file contents or a read operation.
slice. Those require content-backed fixtures or a source-read operation. slice. Those require content-backed fixtures or a source-read operation.
- Do not change the workflow graph, trace facts, approval form, or live RPC - Do not change the workflow graph, trace facts, approval form, or live RPC
protocol. protocol.
- Do not show target-health chrome on Scene 8's scripted agent handoff.
- Do not make the presentation footer a second application navigation system. - Do not make the presentation footer a second application navigation system.
## Demo scope ## Demo scope
Target chrome is visible only for the prepared workflow demo scenes: The demo control rail is visible only for the prepared workflow arc:
- Scene 8: `agent-handoff`
- Scene 9: `prepared-lifecycle` - Scene 9: `prepared-lifecycle`
- Scene 10: `run-from-deployment` - Scene 10: `run-from-deployment`
- Scene 11: `typed-human-boundary` - Scene 11: `typed-human-boundary`
- Scene 12: `resume-output-evidence` - Scene 12: `resume-output-evidence`
Scene 8 (`agent-handoff`) remains a target-free scripted conversation. All Scene 8 (`agent-handoff`) remains a scripted conversation, but gains the same
narrative, architecture, evaluation, conclusion, and discussion locations hide small footer control rail so the presenter can start the prepared run without
the target badge and demo actions. adding another large button to the chat composition. All narrative,
architecture, evaluation, conclusion, and discussion locations hide the target
badge and demo actions.
## State model ## State model
@@ -76,25 +81,28 @@ target-health badge.
## Footer composition ## Footer composition
`PresentationFooter` owns one stable demo slot between scene progress and the `PresentationFooter` owns one stable demo slot between scene progress and the
evidence receipt. evidence receipt. The slot is reserved for every Scene 812 location and is
empty elsewhere.
For non-demo scenes, the slot is absent and no target-health copy is rendered. For non-demo scenes, the slot is absent and no target-health copy is rendered.
For demo scenes, the slot is always present with a stable minimum width and For the demo arc, the slot is always present with a stable minimum width and
height: height. It shows exactly one of these states:
- Non-launch beats render a compact target badge: - Before execution: a compact primary action, `Run prepared workflow` when the
- healthy: `Live target ready` / `127.0.0.1:8765` live target is healthy or `Play replay walkthrough` when it is unavailable.
- unavailable: `Replay fallback` / the failure reason - While checking: a compact `Checking live service` state with the same
- checking: a compact checking state with the same footprint footprint.
- The launch beat (`run-from-deployment` / `operation`) replaces the badge with - While running: a non-interactive `Running workflow...` information label,
compact actions in the same slot: not a disabled button.
- primary action: run live when healthy, otherwise play replay walkthrough - While paused at the typed boundary: `Run paused - review required`.
- secondary action: retry live service when retry is meaningful - After completion: `Run complete`.
- Active or in-flight states keep the same slot and disable the relevant - When retry is meaningful: a compact secondary `Retry live service` action may
actions rather than inserting a new panel. sit beside the primary action without changing the slot's size.
The large `DemoRunLaunchControl` section is removed from the Scene 10 content The large `DemoRunLaunchControl` section is removed from scene content layouts.
layout. Its behavior is preserved through the footer slot. Its behavior is preserved through this footer rail. There is only one actual
prepared-run action; chat remains explanatory and does not gain a duplicate
run button.
## Input manifest language ## Input manifest language
@@ -112,12 +120,16 @@ current static rows.
The implementation must test: The implementation must test:
- title and non-demo scenes render no target badge or demo controls; - title and non-demo scenes render no target badge or demo controls;
- Scene 8 renders no target badge or demo controls; - every Scene 812 beat renders exactly one compact demo rail;
- demo input/graph/approval/output beats render the compact target badge; - the pre-run demo rail renders the run action without an in-scene launch panel;
- the launch beat renders footer actions and no in-scene launch panel; - a running demo renders an information label instead of a disabled run button;
- a paused demo renders the review-required information label;
- a completed demo renders the terminal information label;
- a healthy target remains `Live target ready` while the timeline is replaying; - a healthy target remains `Live target ready` while the timeline is replaying;
- failed health renders replay fallback only inside demo scope; - failed health renders replay fallback only inside demo scope;
- backtracking from launch to graph to title removes launch copy immediately; - backtracking between Scene 812 updates the rail from current state without
retaining stale copy;
- backtracking from the demo arc to title removes the rail immediately;
- checking does not change footer dimensions or mount a stale replay label; - checking does not change footer dimensions or mount a stale replay label;
- input rows use `included in prepared run` and expose no unsupported button or - input rows use `included in prepared run` and expose no unsupported button or
preview affordance. preview affordance.