Skip to content

Non-interactive flags, deploy verifier, CI, and end-to-end deploy test - #2

Merged
irinanazarova merged 2 commits into
mainfrom
maintenance-and-e2e
Sep 7, 2026
Merged

irinanazarova merged 2 commits into
mainfrom
maintenance-and-e2e

Conversation

@irinanazarova

Copy link
Copy Markdown
Collaborator

What

Companion to anycable/slide-quiz#2. Makes the scaffolder testable for real and open to contributions.

Non-interactive mode. Every prompt has a flag (--platform, --framework, --ws-url, --broadcast-url, --no-deploy, --skills/--no-skills, --yes, --help). With --yes and both URLs the CLI runs without input, which CI and AI agents need.

verify-slide-quiz bin. Checks a deployed site without a browser: audience page served, both functions answer, and a POST to each produces a broadcast that arrives back over the AnyCable WebSocket. Each failure names the likely cause.

Real deploy test. Ran the CLI against a bare Slidev deck, deployed to Vercel, and verified. It failed twice, for reasons no unit test could see:

  • the functions' ./shared import has no extension and Node's ESM resolver rejects it in a "type": "module" project (every Slidev deck)
  • the default-export Web handler is run by Vercel as a Node (req, res) handler, so every request timed out

Both fixed in slide-quiz#2. After the fixes, all nine checks pass on Vercel and on Netlify against the public demo.

Scaffolding fixes

  • writes vercel.json for Slidev on Vercel (without it Vercel serves the source tree)
  • writes public/_redirects itself instead of copying it from the addon, which stops shipping that file
  • installs valibot explicitly, since the functions import it
  • skips the package.json that sits next to the function sources
  • copies the slide-quiz agent skills into .claude/skills/ (asked, or implied by --yes)

CI

  • unit tests on Node 20 and 22, plus a job that scaffolds a real Slidev deck with the CLI and builds it
  • an "E2E deploy" workflow (manual, weekly, and on changes to lib.mjs) that deploys to Vercel and Netlify and runs the verifier. It skips itself until these repository secrets exist: ANYCABLE_WS_URL, ANYCABLE_BROADCAST_URL, VERCEL_TOKEN, NETLIFY_AUTH_TOKEN, NETLIFY_SITE_ID

Community files. CONTRIBUTING, SECURITY, CHANGELOG, bug report template (routes runtime problems to slide-quiz), PR template.

How to verify

  • npm test (53 tests)
  • node index.mjs --help
  • node scripts/verify-deploy.mjs --site https://slide-quiz-demo.netlify.app --platform netlify

Notes

  • The skills copy is a no-op until slide-quiz 0.6.0 is published, since 0.5.2 does not ship them.
  • The e2e run used a throwaway Vercel project e2e-vercel in the maintainer's account; it can be deleted or kept as the target for the workflow.

…unity files

Every prompt now has a flag, so --yes with both AnyCable URLs runs the
whole scaffold without input. That is what lets CI run the CLI for real
and lets agents use it.

verify-slide-quiz checks a deployed site end to end: audience page,
both functions, and a broadcast round trip over the WebSocket. Running it
against a real Vercel deploy of a scaffolded Slidev deck found that the
Vercel functions never worked in an ESM project (fixed in slide-quiz).

Also: writes vercel.json for Slidev on Vercel, writes _redirects itself,
installs valibot explicitly, skips the functions' package.json when
copying, copies the slide-quiz agent skills into .claude/skills/.

Claude-Session: https://claude.ai/code/session_01M5WF6o6qv7AJEpGPYZ2b2x
…URLs

- with URLs from flags but no --yes, choosing "Change AnyCable URLs" at
  the review looped forever because the prompt stayed skipped
- --yes now skips the deploy step and prints the command, so it never
  blocks on a confirm or pushes to production on its own
- e2e workflow: rely on NETLIFY_SITE_ID from the environment instead of
  --site flags

Claude-Session: https://claude.ai/code/session_01M5WF6o6qv7AJEpGPYZ2b2x
@irinanazarova
irinanazarova merged commit 697b7da into main Sep 7, 2026
3 checks passed
@irinanazarova
irinanazarova deleted the maintenance-and-e2e branch September 7, 2026 07:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant