Skip to content

chore: pause Vercel auto-deploy mid-term after 2 undiagnosed build failures - #289

Merged
qnbs merged 3 commits into
mainfrom
chore/pause-vercel-deployments
Jul 30, 2026
Merged

chore: pause Vercel auto-deploy mid-term after 2 undiagnosed build failures#289
qnbs merged 3 commits into
mainfrom
chore/pause-vercel-deployments

Conversation

@qnbs

@qnbs qnbs commented Jul 29, 2026

Copy link
Copy Markdown
Owner

Summary

  • vercel.json: added git.deploymentEnabled: false — the documented, reversible, dashboard-free way to pause git-triggered Vercel deployments.
  • README.md / CLAUDE.md: promoted GitHub Pages to primary live target for the duration; noted Vercel is paused and why.
  • TODO.md: tracked entry to re-enable once someone with Vercel dashboard/CLI access diagnoses the root cause.

Why: two consecutive Vercel preview deployments failed (different deployment IDs, different commits — see PR #288) with only a generic "Deployment has failed" message. The exact same commits build cleanly locally via pnpm run build, and neither the GitHub Checks API nor npx vercel inspect --logs (needs an interactive account login I don't have here) surfaced further detail — this looks platform-side rather than a code regression.

Vercel is not a required branch-protection check (confirmed: only Security Audit, Build, Quality Gate ×2 are required), so this doesn't unblock any merge gate — it was purely to stop a noisy, undiagnosable failure status from showing up on every PR. GitHub Pages is already documented as the always-on fallback mirror, so live availability is unaffected.

Test plan

  • vercel.json validated as well-formed JSON
  • pnpm exec vitest run tests/unit/checkDocMetrics.test.ts — 21/21 passing (canonical-Vercel-URL drift gate unaffected, since the URL itself didn't change)
  • Confirmed via gh api .../branches/main/protection that Vercel is not in required_status_checks.contexts
  • CI quality gate green

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation

    • Updated live deployment guidance to identify GitHub Pages as the primary, always-on destination.
    • Clarified that Vercel automatic deployments are paused following build issues.
    • Added a follow-up note documenting the deployment status and investigation requirements.
  • Infrastructure

    • Disabled Vercel Git-based automatic deployments while GitHub Pages remains available as the active mirror.

…ilures

Two consecutive Vercel preview deployments failed (different
deployment IDs, different commits) with only a generic "Deployment
has failed" message. The exact same commits build cleanly via
`pnpm run build` locally, and neither the GitHub Checks API nor
`npx vercel inspect --logs` (requires an interactive account login not
available here) surfaced any further detail — this looks
platform-side, not a code regression.

Vercel is not a required branch-protection check, so this was purely
about stopping a noisy, undiagnosable failure status rather than
unblocking anything. Disabled via vercel.json's documented
`git.deploymentEnabled: false` (the standard, reversible, dashboard-
free way to pause git-triggered deployments). GitHub Pages — already
documented as the always-on fallback mirror — is promoted to primary
in README.md/CLAUDE.md for the duration. TODO.md tracks re-enabling
once someone with Vercel dashboard/CLI access diagnoses the cause.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 29, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 35 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9c3d2271-cd8a-403e-9938-cd4d82ff8037

📥 Commits

Reviewing files that changed from the base of the PR and between 66cb985 and d190d5c.

📒 Files selected for processing (1)
  • TODO.md
📝 Walkthrough

Walkthrough

The change disables Vercel Git deployments, makes GitHub Pages the primary always-on deployment, and documents the pause, its triggering failures, and conditions for re-enabling Vercel deployments.

Changes

Vercel deployment pause

Layer / File(s) Summary
Disable Vercel Git deployments
vercel.json
Adds git.deploymentEnabled: false to disable Vercel Git-based deployments.
Update deployment guidance
CLAUDE.md, README.md, TODO.md
Identifies GitHub Pages as the primary always-on mirror and documents the paused Vercel deployments and re-enablement conditions.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: pausing Vercel auto-deploys after repeated build failures.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/pause-vercel-deployments

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

@codeant-ai

codeant-ai Bot commented Jul 29, 2026

Copy link
Copy Markdown

🏁 CodeAnt Quality Gate Results

Commit: 66cb985b
Scan Time: 2026-07-29 20:14:29 UTC

✅ Overall Status: PASSED

Quality Gate Details

Quality Gate Status Details
Secrets ✅ PASSED 0 secrets found
Duplicate Code ✅ PASSED 0.0% duplicated
SAST ✅ PASSED No security issues
Bugs ✅ PASSED Rating S: No bugs
IAC ✅ PASSED Rating S: No issues

View Full Results

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 38-41: Update the surrounding README introduction to remove the
claim that both hosted builds auto-deploy from main, keeping the GitHub Pages
primary deployment statement and Vercel paused status consistent with the
deployment table and tip.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: be6e4aa7-c02a-47e6-97fd-f6d53f91801e

📥 Commits

Reviewing files that changed from the base of the PR and between ea879e4 and 66cb985.

📒 Files selected for processing (4)
  • CLAUDE.md
  • README.md
  • TODO.md
  • vercel.json

Comment thread README.md Outdated
@codecov

codecov Bot commented Jul 29, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Root-caused the 2 Vercel build failures that prompted the mid-term
pause: not a platform issue, but a real missing-export bug
(services/ai/localEmbeddingService.ts imported ensureInferencePool()
from workerBusManager.ts, which never actually defined it — invisible
to Vitest because the consumer test mocks the whole module). The fix
landed in the worker-generation-consolidation PR chain (PR #288).

Reverts git.deploymentEnabled to the default (enabled) now that the
actual cause is fixed and verified via a clean local `build:edge`
reproduction of Vercel's exact build command. TODO.md's entry updated
from "paused, cause unknown" to a resolved write-up, including the
`pnpm run build` vs `pnpm run build:edge` command-mismatch lesson that
delayed finding this.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 29, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
worldscript-studio Ready Ready Preview Jul 29, 2026 8:37pm

…EAD, not main)

The previous commit's `git checkout -- README.md CLAUDE.md` restored
from this branch's own HEAD (which still had the "paused" wording from
the first commit), not from main — so the pause note survived
uncommitted. Re-applied via `git checkout main -- ...` this time.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@qnbs
qnbs merged commit 71ac74c into main Jul 30, 2026
21 checks passed
@qnbs
qnbs deleted the chore/pause-vercel-deployments branch July 30, 2026 04:22
@qnbs qnbs mentioned this pull request Jul 30, 2026
4 tasks
qnbs added a commit that referenced this pull request Jul 30, 2026
package.json bumped; src-tauri/tauri.conf.json, src-tauri/Cargo.toml,
src-tauri/Cargo.lock (workspace-member entry, no checksum to break), and
public/sw.js's APP_VERSION synced via the existing sync-tauri-version.mjs /
sync-sw-version.mjs scripts plus one direct lockfile edit. README version
badge updated.

New CHANGELOG.md [1.24.3] entry finalizes the Unreleased worker-generation
consolidation section: corrects the stacked-PR count (4 -> 5, #286-288 +
#290-291), folds in independent #289 (Vercel auto-deploy pause), and adds
two additional fixes from this session's merge-queue recovery (abort-listener
leak in duckdbClient.ts, pool re-registration failure guards in
workerBusManager.ts) that weren't yet documented.

Tag creation and GitHub Release publishing follow in a separate step, per
explicit maintainer authorization for this recovery.

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
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