Cursor rule

1---
2description: Release batching, gitignore policy, and pre-tag checks
3alwaysApply: true
4---
5 
6# Release discipline
7 
8## One feature, one release
9 
10- **One user-facing feature → one minor.** Stack review fixes (tz, dates, guards) into the **same PR** before merge when they belong to the same feature.
11- Do **not** tag npm until CI is green **and** `pnpm release:qa` passes (tripwires at the end must be 0 failed).
12- Before tagging: `git diff main` must not include accidental private paths (`docs/`, `CLAUDE.local.md`, `.env`).
13 
14## Commit attribution
15 
16Every commit produced with an AI agent: follow **`AGENTS.md` § Commit attribution** — trailer names the agent **and** model in use (e.g. `Co-Authored-By: Cursor (Composer 2.5) <cursoragent@cursor.com>`).
17 
18## Public vs private docs
19 
20**Tracked (public engineering guides):** `AGENTS.md`, `CLAUDE.md`, `.cursor/rules/`, README, MCP tool descriptions.
21 
22**Gitignored (maintainer-local):** `docs/` (e.g. `docs/AGENTS.internal.md` notebook), `CLAUDE.local.md`.
23 
24- Engineering process → update the **public** guides above.
25- Candid history, strategy, or release post-mortems → `docs/` notebook only.
26- **Never** add `!docs/…` exceptions to `.gitignore` without explicit maintainer approval.
27 
28## Bracket / live-formatting ship checklist
29 
30Before merge **or** release of bracket or kickoff-formatting work:
31 
321. Adversarial tests: 0 games, mid-tournament (2/3 played), degraded standings.
332. **Surface parity:** CLI `bracket` + MCP `get_bracket` + `share bracket` all pass `tz` and show calendar dates on multi-week knockouts.
343. **Statusline knockouts (if touched):** indirect-resolve via cached `getKnockoutFixtures` — hot path fail-closed (no 🏳️ on countdown or `live · syncing…`); empty-cache short TTL; `knockout-surface-coverage.test.ts` + `statusline.test.ts` / `refresh.test.ts` green. See `.cursor/rules/surface-parity.mdc`.
354. After `pnpm -r build`, run **`pnpm release:qa`** and eyeball the rendered sections; keep `packages/mcp/test/tools.test.ts` green for MCP arg threading.
36