Your first pull request

Read AGENTS.md first. Then read specs/framework-design.md and the one spec in specs/framework/ that covers your change. For a UI component, also read packages/headless/components/SPEC.md.

Do not commit to main.

git switch -c fix/counter-text

Add or update the closest focused test. Run it, and make sure that it fails for the reason you expect.

pnpm exec vp test packages/compiler/test/semantic-graph.test.ts

Compiler tests assert pass artifacts and diagnostics where they can. Use Vitest browser mode for component and browser behavior.

Change only what the test needs. Then run the focused test again until it passes.

This checker reads .tsrx files. Plain tsc does not.

pnpm run typecheck

This runs the agent-files, typecheck and unit jobs with the commands from ci.yml.

pnpm ci:local --fast

If you touched the bundler, router, web, runtime, compiler or demos, run the matching jobs too. For example: pnpm ci:local --job browser --job boxes-router.

The pre-commit hook runs vp lint --deny-warnings, then the fast jobs with --bail. If you staged a file in .ruler/, it also checks that the generated agent files match.

If lint fails, the hook prints the fix command: pnpm exec vp lint --fix --fix-suggestions --fix-dangerously.

Push your branch, not main. In the PR, say which ci:local mode you ran, on which commit, and the result line it printed.

Read every finding from people and from the CodeRabbit bot. Fix the ones that are right. Reply with your reason on the ones that are stale or wrong.