docs: harden defense presentation rehearsal
This commit is contained in:
@@ -106,6 +106,34 @@ Open the presentation:
|
|||||||
http://127.0.0.1:5173/present
|
http://127.0.0.1:5173/present
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Select Live Or Replay
|
||||||
|
|
||||||
|
The presentation defaults to the loopback live target when an HTTP target is
|
||||||
|
configured. The footer badge reports the current evidence mode:
|
||||||
|
|
||||||
|
- `Live target ready`: the health probe succeeded and the prepared live action
|
||||||
|
is available.
|
||||||
|
- `Replay evidence`: deterministic replay is selected explicitly.
|
||||||
|
- `Replay fallback`: the configured live target failed its health probe, so the
|
||||||
|
presentation is continuing from the committed recording.
|
||||||
|
|
||||||
|
To force deterministic replay before opening `/present`, run this in the
|
||||||
|
browser DevTools console:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// Force deterministic replay before opening /present.
|
||||||
|
sessionStorage.setItem("lda.workflowConsole.target", "file:///presentation-replay");
|
||||||
|
location.reload();
|
||||||
|
```
|
||||||
|
|
||||||
|
To restore the normal loopback live target:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// Restore the normal loopback live target.
|
||||||
|
sessionStorage.removeItem("lda.workflowConsole.target");
|
||||||
|
location.reload();
|
||||||
|
```
|
||||||
|
|
||||||
## Useful Deep Links
|
## Useful Deep Links
|
||||||
|
|
||||||
- Title: `http://127.0.0.1:5173/present#scene/thesis/title`
|
- Title: `http://127.0.0.1:5173/present#scene/thesis/title`
|
||||||
@@ -115,16 +143,20 @@ http://127.0.0.1:5173/present
|
|||||||
`http://127.0.0.1:5173/present#scene/architecture/runtime/focus/runtime-providers`
|
`http://127.0.0.1:5173/present#scene/architecture/runtime/focus/runtime-providers`
|
||||||
- NodeUse:
|
- NodeUse:
|
||||||
`http://127.0.0.1:5173/present#scene/architecture/node-use/focus/node-use`
|
`http://127.0.0.1:5173/present#scene/architecture/node-use/focus/node-use`
|
||||||
- Demo operation:
|
- Agent handoff:
|
||||||
`http://127.0.0.1:5173/present#scene/workflow-demo/operation`
|
`http://127.0.0.1:5173/present#scene/agent-handoff/request`
|
||||||
- Demo graph:
|
- Prepared lifecycle:
|
||||||
`http://127.0.0.1:5173/present#scene/workflow-demo/graph`
|
`http://127.0.0.1:5173/present#scene/prepared-lifecycle/discover`
|
||||||
- Interrupt preview:
|
- Run operation:
|
||||||
`http://127.0.0.1:5173/present#scene/workflow-demo/interrupt`
|
`http://127.0.0.1:5173/present#scene/run-from-deployment/operation`
|
||||||
- Approval:
|
- Typed approval:
|
||||||
`http://127.0.0.1:5173/present#scene/interrupt-evidence/approval`
|
`http://127.0.0.1:5173/present#scene/typed-human-boundary/approval`
|
||||||
- Trace/evidence:
|
- Resume proof:
|
||||||
`http://127.0.0.1:5173/present#scene/interrupt-evidence/trace`
|
`http://127.0.0.1:5173/present#scene/resume-output-evidence/resume`
|
||||||
|
- Output proof:
|
||||||
|
`http://127.0.0.1:5173/present#scene/resume-output-evidence/output`
|
||||||
|
- Trace proof:
|
||||||
|
`http://127.0.0.1:5173/present#scene/resume-output-evidence/trace`
|
||||||
- Evaluation:
|
- Evaluation:
|
||||||
`http://127.0.0.1:5173/present#scene/evaluation/cohort`
|
`http://127.0.0.1:5173/present#scene/evaluation/cohort`
|
||||||
|
|
||||||
@@ -173,6 +205,18 @@ Say:
|
|||||||
|
|
||||||
Then switch back to replay/deep-linked states.
|
Then switch back to replay/deep-linked states.
|
||||||
|
|
||||||
|
## Rehearsal Paths
|
||||||
|
|
||||||
|
| Path | Operator action | Expected evidence |
|
||||||
|
|---|---|---|
|
||||||
|
| Submitted | Select issue rows, enter a comment, choose `Submit`. | The same run ID reaches `submitted`, report Markdown, created issues, and a completed trace. |
|
||||||
|
| Revision requested | Enter a revision comment, choose `Request revision`. | The same run ID shows `Revision requested` in the UI, protocol evidence remains `cancelled`, the report says `Revision Requested`, no issues are created, and the trace contains `revision_requested` followed by `end_cancelled`. |
|
||||||
|
| Replay fallback | Stop the server or force replay before loading the presentation. | The replay badge and canonical operation, output, and trace evidence remain available without port debugging. |
|
||||||
|
|
||||||
|
`Request revision` is an intentional negative branch, not a terminal UI stop
|
||||||
|
action. It resumes the same persisted run with an explicit negative decision
|
||||||
|
and demonstrates the workflow's negative outcome.
|
||||||
|
|
||||||
### If asked why the demo is prepared
|
### If asked why the demo is prepared
|
||||||
|
|
||||||
Say:
|
Say:
|
||||||
@@ -242,10 +286,16 @@ Answer:
|
|||||||
|
|
||||||
## Pre-Defense Checklist
|
## Pre-Defense Checklist
|
||||||
|
|
||||||
- Start `/present` once and walk through all main beats.
|
1. Start `/present` with the intended target and verify the Scene 8 `Run
|
||||||
- Open Scene 6 root, runtime providers, and NodeUse deep links.
|
prepared workflow` action is enabled when the live badge is ready.
|
||||||
- Open Scene 9/10 demo deep links and verify evidence receipt/inspector.
|
2. Complete one submitted branch and confirm the same run reaches output and
|
||||||
- Confirm `Escape` closes overlays.
|
trace.
|
||||||
- Confirm the browser is at the intended zoom level and projector resolution.
|
3. Reload, complete one revision-requested branch, and confirm no issues plus
|
||||||
- Keep the PDF available as a fallback.
|
the `revision_requested` and `end_cancelled` trace frames.
|
||||||
- Keep the commands in this runbook available in a terminal or notes file.
|
4. Force replay, reload, and confirm the replay badge plus the direct approval
|
||||||
|
and trace hashes still render.
|
||||||
|
5. Restore the normal loopback target only if the live path will be shown.
|
||||||
|
6. Walk through Scene 6 root, runtime providers, and NodeUse deep links.
|
||||||
|
7. Confirm `Escape` closes overlays and the browser is at the intended zoom
|
||||||
|
level and projector resolution.
|
||||||
|
8. Keep the PDF and this runbook available as fallbacks.
|
||||||
|
|||||||
Reference in New Issue
Block a user