[Alex-lop]

What

• Adds the recording-ready North Star console, one-command demo runner, presenter output, and submission runbook.
• Integrates all completed UI-demo sprint branches into one reviewed branch.

Verification

• 70/70 focused checks passed.
• Full locked suite: 420 cases (408 passed, 12 expected live/provider skips).
• Full demo: 22/22 proven, HTTP 200/200/200, restoration and server cleanup verified.
• Ctrl-C capture path: exit 130 with evidence, interruption marker, restoration, and cleanup verified.
• 21 MCP tools exposed; presenter output stays within 129 columns with no ANSI.

Truth limit

• Automated direct viewport testing was blocked because the review environment exposed no browser engine; manual recording is the remaining visual check.

Summary by CodeRabbit

• New Features

  • Added a canonical NYC Taxi UI demo runbook and detailed 22-step recording script.
  • Added an interactive evidence console with workflow status, governance gates, repairs, publication details, and restoration evidence.
  • Added optional human-readable demo and watcher output, including color controls and failure guidance.
  • Improved responsive layouts, accessibility, keyboard navigation, connection status, and browser refresh behavior.

• Documentation

  • Updated submission materials with current evidence, verification status, capture requirements, and limitations.
  • Marked older demo runbooks and shot lists as superseded.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 500fd543-7073-499a-9a48-8f0163738f0f

📥 Commits

Reviewing files that changed from the base of the PR and between 9324bb1 and 31068fa.

📒 Files selected for processing (22)

• README.md
• docs/phase-2c/demo-runbook.md
• docs/phase-3a/demo-runbook.md
• docs/phase-3a/video-shot-list.md
• docs/submission/UI_DEMO_RUNBOOK.md
• docs/submission/devpost.md
• docs/submission/judge-checklist.md
• docs/submission/shot-script.md
• src/reglineage/agent/static/app.css
• src/reglineage/agent/static/app.js
• src/reglineage/agent/static/index.html
• src/reglineage/cli.py
• src/reglineage/demo_presenter.py
• src/reglineage/demo_runner.py
• src/reglineage/north_star_console.py
• src/reglineage/rehearsal.py
• tests/integration/test_north_star_console.py
• tests/integration/test_north_star_vertical_slice.py
• tests/integration/test_taxi_cli.py
• tests/unit/test_demo_presenter.py
• tests/unit/test_demo_runner.py
• tests/unit/test_ui_console_refresh.py

---

📝 Walkthrough

Walkthrough

The PR adds a terminal-first NYC Taxi demo with offline preparation, a loopback Evidence Console, 22-step rehearsal capture, structured readiness and evidence projections, rendered CLI output, refreshed browser UI behavior, and updated submission runbooks.

Changes

NYC Taxi demo workflow

Layer / File(s)	Summary
Durable console projection src/reglineage/north_star_console.py, tests/integration/test_north_star_console.py	NorthStarConsole validates durable stores and identity, then exposes readiness, governance, repair, publication, attribution, chronology, hashes, and restoration state.
Rehearsal and demo orchestration src/reglineage/rehearsal.py, src/reglineage/demo_runner.py, tests/integration/test_north_star_vertical_slice.py, tests/unit/test_demo_runner.py	The demo validates isolated paths and cache state, runs the 22-step rehearsal, manages the console lifecycle, pauses before restoration, persists evidence, and handles interruption with status 130.
Terminal presentation and CLI wiring src/reglineage/demo_presenter.py, src/reglineage/cli.py, tests/unit/test_demo_presenter.py, tests/integration/test_taxi_cli.py	The CLI supports rendered demo, rehearsal, and watcher output. The presenter formats step states, watcher records, failures, recovery commands, colors, identifiers, and redacted values.
Browser console rendering and refresh src/reglineage/agent/static/app.js, src/reglineage/agent/static/index.html, src/reglineage/agent/static/app.css, tests/unit/test_ui_console_refresh.py	The UI renders structured workflow and evidence data with accessible navigation, responsive layouts, connection status, abortable polling, retries, revision tracking, and guarded decision submission.
Demo runbooks and evidence records README.md, docs/submission/*, docs/phase-2c/demo-runbook.md, docs/phase-3a/*	Documentation now points to the canonical NYC Taxi UI runbook, defines capture and evidence boundaries, updates current proof status, and marks legacy demo material as superseded.

Estimated code review effort: 5 (Critical) | ~120 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Operator
  participant DemoCommand
  participant DemoRunner
  participant Rehearsal
  participant EvidenceConsole
  Operator->>DemoCommand: start offline NYC Taxi demo
  DemoCommand->>DemoRunner: pass cache, work, evidence, and loopback settings
  DemoRunner->>EvidenceConsole: start console before capture
  DemoRunner->>Rehearsal: run 22 observed rehearsal steps
  Rehearsal->>DemoRunner: pause before restoration with evidence snapshot
  Operator->>EvidenceConsole: review browser console during pause
  EvidenceConsole-->>DemoRunner: submit decision and updated revision
  DemoRunner->>EvidenceConsole: stop console
  DemoRunner->>Rehearsal: restore state and persist receipt

Loading

Possibly related PRs

• Alex-lop/RegLineage#2: This PR extends the earlier workflow, CLI, rehearsal, console, and UI components.
• Alex-lop/RegLineage#4: This PR builds on the earlier taxi repair, watcher, rehearsal, CLI, and console workflows.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release-proof/ui-demo-sprint

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}