ViteHub is still experimental. Expect bugs and breaking changes.

Verification

Choose the right proof tier for ViteHub primitives and provider behavior.

Verification proves that ViteHub primitives keep working across generated output, local provider execution, and live providers. Use the narrowest tier that covers the risk introduced by the change.

Verification tiers

TierRuns whereProves
Unit or package testPackage test suitePure runtime behavior, config normalization, and error branches.
Provider Output ContractPull request checkGenerated Provider Output shape without cloud execution.
Local Provider RunPull request checkBuilt Provider Output can execute the Primitive Suite locally.
Live SmokeScheduled provider deploymentThin real-provider coverage for the same Primitive Suite.
Agent EvalLocal or CI behavior checkAgent Definition behavior and scored Agent Invocations.

Run package checks

Run checks from the owning package first. The package owns its primitive contracts and test fixtures.

Terminal
pnpm --filter @vite-hub/workspace test
pnpm --filter @vite-hub/workspace typecheck

When a change affects shared generated Provider Output, run the package build too.

Terminal
pnpm --filter @vite-hub/workspace build

Verify Provider Output

Provider Output Contracts inspect generated files rather than cloud state. Use them when the change affects bindings, worker bundles, Vercel Build Output, generated functions, cron entries, or runtime imports.

Terminal
pnpm --filter @vite-hub/database test
pnpm --filter @vite-hub/workflow test

Keep Live Smoke thin

Live Smoke should execute the same Primitive Suite against a real provider deployment. Do not put deep assertions only in scheduled provider workflows; add them to the Primitive Suite so local and pull request tiers gain the same coverage.

Next steps

Copyright © 2026