Skip to content

docs: add evidence-bounded sprint demo agenda - #1992

Open
groupthinking wants to merge 2 commits into
mainfrom
docs/sprint-demo-agenda
Open

groupthinking wants to merge 2 commits into
mainfrom
docs/sprint-demo-agenda

Conversation

@groupthinking

@groupthinking groupthinking commented Sep 17, 2026

Copy link
Copy Markdown
Owner

Canonical issue

Fixes #2040.

Also tracked as Notion “Confirm sprint demo agenda”.

Outcome

This pull request adds a concise internal sprint-demo agenda that distinguishes test-backed Home-to-Studio behavior from draft pull-request and production-readiness claims.

Scope

  • Included: docs/SPRINT_DEMO_AGENDA.md, with a timed run sheet, owner placeholders, observable outcomes, fallbacks, evidence references, and verified limitations.
  • Explicitly excluded: application behavior, authentication, billing, checkout, deployment, production configuration, access, and Notion status changes.

Risk

  • Risk level: low
  • Failure mode: status snapshots in the agenda can become stale before the meeting.
  • Rollback: revert 0c020764c.

Verification

  • Focused evidence suite: studio-handoff.test.ts, home-sell-surface.test.ts, and landing-style-safety.test.ts — 3 files and 23 tests passed.
  • Frontend lint completed with no errors; it reported three known base-branch Studio navigation warnings outside this documentation-only diff.
  • Type check: npm --workspace eventrelay-web run type-check.
  • Production web build: npm run build:web.
  • git diff --check, repository reference existence check, and sensitive-data diff scan.
  • Required CI is pending on this draft PR head.
  • No review threads exist on this new draft.

Production evidence

Not applicable. This documentation-only change does not deploy, publish, initiate payment, modify production configuration, or change access.

Agent handoff

  • One canonical issue is linked — this task is sourced from Notion rather than a GitHub issue.
  • No competing pull request implements this agenda document.
  • Acceptance criteria are addressed with qualified, traceable evidence and explicit local/test versus production boundaries.
  • Required checks pass on the current head — CI is pending.
  • No product, security, irreversible infrastructure, or production approval decision is requested.

@vercel

vercel Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
v0-uvai Ready Ready Preview, v0 Sep 18, 2026 9:55pm UTC

@coderabbitai

coderabbitai Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Repository: groupthinking/EventRelay/.coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: b6593ec8-06a5-4756-aa58-c10c9aa06af9


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

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

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Sep 17, 2026
@github-actions

github-actions Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Dependency Review Summary

The full dependency review summary was too large to display here (13153KB, limit is 1024KB).

Please download the artifact named "dependency-review-summary" to view the complete report.

View full job summary

@groupthinking
groupthinking marked this pull request as ready for review September 18, 2026 20:57
Copilot AI balanced review requested due to automatic review settings September 18, 2026 20:57
@groupthinking

Copy link
Copy Markdown
Owner Author

@copilot resolve the merge conflicts in this pull request

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Warning

Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.

Pull request overview

Adds an internal sprint demo agenda document that clearly separates local/test-backed behavior from draft PR status and production-readiness claims.

Changes:

  • Introduces a timed run sheet with expected outcomes, evidence links, and fallback steps.
  • Adds an “evidence status” section that qualifies what can/can’t be claimed during the demo.
  • Documents verification commands and known limitations/blockers for the walkthrough.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/SPRINT_DEMO_AGENDA.md Outdated
Comment on lines +11 to +17
| Area | Evidence | Qualification for the demo |
|---|---|---|
| Public Home-to-Studio handoff | [`HomePasteForm`](../apps/web/src/components/home/HomePasteForm.tsx), [`studio-handoff`](../apps/web/src/lib/studio-handoff.ts), and [`studio-handoff.test.ts`](../apps/web/src/lib/__tests__/studio-handoff.test.ts) | Demonstrate locally or describe through test evidence. The path validates a YouTube source, requests a Video Pack, and routes to `/studio?video=...`; no production result is implied. |
| Public Home sell surface | [`page.tsx`](../apps/web/src/app/page.tsx), [`home-sell-surface.test.ts`](../apps/web/src/lib/__tests__/home-sell-surface.test.ts), and [`landing-style-safety.test.ts`](../apps/web/src/lib/__tests__/landing-style-safety.test.ts) | Source and automated-test evidence from the current base branch. |
| Landing-page refinement | [Draft PR #1981](https://github.com/groupthinking/EventRelay/pull/1981) | Draft only. At preparation, `test-frontend` and `test` are successful, while `E2E Pipeline Tests`, `report`, and `Vercel` are failing. Do not present the refinement as reviewed, deployed, or production-ready. |
| Google sign-in retry | [Draft PR #1971](https://github.com/groupthinking/EventRelay/pull/1971) | Do **not** demonstrate. The PR is draft with no review decision, a failed Vercel check, a canceled report, and pending checks at preparation. |
| Production readiness | [`LAUNCH_CHECKLIST.md`](LAUNCH_CHECKLIST.md) and [`RUNBOOK.md`](guides/RUNBOOK.md) | These documents identify configuration and backend prerequisites; they do not prove that the demonstrated behavior is deployed. |
Comment thread docs/SPRINT_DEMO_AGENDA.md Outdated
Comment on lines +21 to +28
| Minutes | Segment owner | Demo action | Expected visible result | Evidence | Fallback |
|---:|---|---|---|---|---|
| 0–2 | `Assign owner` | State the demo boundary and explain the UVAI YouTube URL-to-Studio goal. | The audience understands that the session is a local/test walkthrough, not a production launch or checkout demonstration. | This boundary; [`page.tsx`](../apps/web/src/app/page.tsx) | Read this opening statement and proceed to the evidence table. Do not make a live service claim. |
| 2–6 | `Assign owner` | In a local environment, enter the fixture URL `https://www.youtube.com/watch?v=auJzb1D-fag` on `/` and submit the public form. | The form builds a canonical YouTube watch URL, initiates the Video Pack request, and routes to `/studio?video=...`. | [`HomePasteForm`](../apps/web/src/components/home/HomePasteForm.tsx); [`studio-handoff`](../apps/web/src/lib/studio-handoff.ts); [`studio-handoff.test.ts`](../apps/web/src/lib/__tests__/studio-handoff.test.ts) | Show the focused test output and source links. Do not claim that an external backend analysis or deployment completed. |
| 6–8 | `Assign owner` | Enter a non-YouTube value in the same form. | The form keeps the visitor on Home and exposes the accessible message “Need a valid YouTube URL.”; no pack request should be initiated. | [`HomePasteForm`](../apps/web/src/components/home/HomePasteForm.tsx); [`studio-handoff.test.ts`](../apps/web/src/lib/__tests__/studio-handoff.test.ts) | Read the invalid-input test assertion. Do not bypass validation or invent a destination. |
| 8–10 | `Assign owner` | Review the evidence for the public Home surface and its boundaries. Do not invoke checkout. | The audience can see that Home is the sell surface and Studio is the workbench, with no claim of a guaranteed transcript or arbitrary-video production E2E behavior. | [`home-sell-surface.test.ts`](../apps/web/src/lib/__tests__/home-sell-surface.test.ts); [`landing-style-safety.test.ts`](../apps/web/src/lib/__tests__/landing-style-safety.test.ts) | Read the recorded focused test results. Keep billing controls visible only; do not begin a checkout session. |
| 10–12 | `Assign owner` | State the authentication resilience status. | No sign-in retry interaction is shown. The audience sees that it remains a draft, pending-review item with incomplete checks. | [Draft PR #1971](https://github.com/groupthinking/EventRelay/pull/1971) | Record “authentication retry deferred pending passing checks and review” as a blocker. Do not represent the feature as complete. |
| 12–15 | `Assign owner` | Close with current draft PR status, limitations, and required decisions. | The audience leaves with the exact distinction between local/test evidence, draft changes, and production readiness prerequisites. | [Draft PR #1981](https://github.com/groupthinking/EventRelay/pull/1981); [`LAUNCH_CHECKLIST.md`](LAUNCH_CHECKLIST.md); [`RUNBOOK.md`](guides/RUNBOOK.md) | End the walkthrough without deploying, publishing, modifying configuration, changing access, or charging a payment method. |
Comment thread docs/SPRINT_DEMO_AGENDA.md Outdated
Comment on lines +50 to +56
| Item | Current status | Required handling |
|---|---|---|
| Landing-page refinement | [PR #1981](https://github.com/groupthinking/EventRelay/pull/1981) is an open draft with no review decision. Its `test-frontend` and `test` checks are successful, but `E2E Pipeline Tests`, `report`, and `Vercel` are failing. | Reference it as draft evidence only. Do not demonstrate it as reviewed or deployed. |
| Google sign-in retry | [PR #1971](https://github.com/groupthinking/EventRelay/pull/1971) is an open draft with no review decision, a failed Vercel check, a canceled report, and pending checks. | Omit the interaction. Record the work as deferred until review and verification are complete. |
| Vercel deployment evidence | The separate Vercel deployment integration can succeed while the `v0-uvai` Vercel check fails or is canceled. | Treat neither status by itself as proof of a production deployment. Do not deploy during this agenda. |
| Durable backend and production configuration | The launch checklist identifies environment, entitlement durability, provider, and backend prerequisites. The runbook describes local backend operation and troubleshooting. | Do not change configuration or start an external deployment as part of the demo. |
| Billing | The Home surface may display Workflow Pro information. | Keep checkout out of scope; do not create a checkout session, charge a card, or modify billing configuration. |
Comment thread docs/SPRINT_DEMO_AGENDA.md Outdated
|---:|---|---|---|---|---|
| 0–2 | `Assign owner` | State the demo boundary and explain the UVAI YouTube URL-to-Studio goal. | The audience understands that the session is a local/test walkthrough, not a production launch or checkout demonstration. | This boundary; [`page.tsx`](../apps/web/src/app/page.tsx) | Read this opening statement and proceed to the evidence table. Do not make a live service claim. |
| 2–6 | `Assign owner` | In a local environment, enter the fixture URL `https://www.youtube.com/watch?v=auJzb1D-fag` on `/` and submit the public form. | The form builds a canonical YouTube watch URL, initiates the Video Pack request, and routes to `/studio?video=...`. | [`HomePasteForm`](../apps/web/src/components/home/HomePasteForm.tsx); [`studio-handoff`](../apps/web/src/lib/studio-handoff.ts); [`studio-handoff.test.ts`](../apps/web/src/lib/__tests__/studio-handoff.test.ts) | Show the focused test output and source links. Do not claim that an external backend analysis or deployment completed. |
| 6–8 | `Assign owner` | Enter a non-YouTube value in the same form. | The form keeps the visitor on Home and exposes the accessible message “Need a valid YouTube URL.”; no pack request should be initiated. | [`HomePasteForm`](../apps/web/src/components/home/HomePasteForm.tsx); [`studio-handoff.test.ts`](../apps/web/src/lib/__tests__/studio-handoff.test.ts) | Read the invalid-input test assertion. Do not bypass validation or invent a destination. |
# Conflicts:
#	docs/SPRINT_DEMO_AGENDA.md

Co-authored-by: groupthinking <154503486+groupthinking@users.noreply.github.com>
auto-merge was automatically disabled September 18, 2026 21:53

Head branch was pushed to by a user without write access

Copilot AI commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Addressed in 34fd7f4. I merged main into this branch, resolved the docs/SPRINT_DEMO_AGENDA.md add/add conflict, and finalized the merge commit.

@github-actions

Copy link
Copy Markdown
Contributor

✅ E2E Test Results: ALL TESTS PASSED

Metric Value
Status 🟢 GREEN
Total Tests
Passed 19
Failed
Deployment https://v0-uvai-978wbl2cj-garv1.vercel.app
Test Output
�[2m | tests/e2e/pipeline.test.ts�[2m > �[22m�[2mEventRelay E2E — Live Deployment�[2m > �[22m�[2mSSE Pipeline Stream�[2m > �[22m�[2mSSE stream emits at least a pipeline_status:running event
�[22m�[39m[E2E] last pipeline_status: complete

 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mSSE Pipeline Stream�[2m > �[22mSSE stream emits at least a pipeline_status:running event�[33m 14040�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mSSE Pipeline Stream�[2m > �[22mSSE stream closes within 90 seconds (no 95% hang)�[33m 20030�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mSSE Pipeline Stream�[2m > �[22mSSE events fire in correct agent order�[33m 21208�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mCloudEvent Schema�[2m > �[22mSSE events contain valid timestamps�[33m 18757�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mCloudEvent Schema�[2m > �[22mterminal pipeline_status includes duration and stage progress�[33m 16685�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mError Handling�[2m > �[22mmissing URL returns 400, not a hang�[32m 202�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mError Handling�[2m > �[22minvalid URL returns error event or completes quickly, not a hang�[33m 11488�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mDashboard�[2m > �[22m/dashboard returns 200�[33m 1644�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mDashboard�[2m > �[22m/dashboard contains agent or pipeline visualization markup�[32m 165�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mAPI Health�[2m > �[22mGET /api returns a response (not 404)�[33m 1240�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mAPI Health�[2m > �[22mPOST /api/pipeline/stream with no body returns 400�[32m 126�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mStatic Assets�[2m > �[22mhomepage has proper meta tags�[32m 124�[2mms�[22m�[39m
 �[32m✓�[39m tests/e2e/pipeline.test.ts�[2m > �[22mEventRelay E2E — Live Deployment�[2m > �[22mStatic Assets�[2m > �[22m/features page returns 200�[32m 147�[2mms�[22m�[39m

�[2m Test Files �[22m �[1m�[32m1 passed�[39m�[22m�[90m (1)�[39m
�[2m      Tests �[22m �[1m�[32m19 passed�[39m�[22m�[90m (19)�[39m
�[2m   Start at �[22m 22:49:37
�[2m   Duration �[22m 111.37s�[2m (transform 48ms, setup 0ms, import 59ms, tests 111.20s, environment 0ms)�[22m


Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add evidence-gated sprint demo agenda with owners and results

3 participants