docs(Table): compact contracts

[cixzhang]

Status: benchmark blocked

This draft is not ready for approval. A two-attempt reviewer benchmark at frozen authority 701fd39b found that the compact Table contracts reduced contract context by 44.1%, but did not preserve review quality on #5420:

• objective blocker recall fell from 0.75 under the current contract to 0.50;
• objective precision fell from 1.00 to 0.75;
• both compact attempts found the unapproved-target boundary but missed the exact sort-color reachability blocker.

Reviewer output was slightly smaller, 1,240 to 1,170 estimated tokens, and settled/no-reask discipline remained correct. That is not enough: the compact record must retain 100% of the release-relevant objective blockers. Keep this PR draft until the structure restores that signal and passes the repeatable benchmark.

Why

The current Table contracts repeat source facts and plugin implementation detail, making the approved parent/module ownership boundary harder to scan and maintain.

What

• keeps the parent contract focused on aggregate Table anatomy, its current target map, and the shared TablePlugin protocol
• keeps row-status API, compatibility, precedence, accessibility, theming boundary, decisions, and pending evidence in the module contract
• links shared AST-002, Icon, theming, accessibility, platform, and knowledge owners instead of copying their rules

Risk

Documentation-only compaction. No runtime, public API, consumer-doc, target, or release behavior changes.

The reviewer benchmark identifies a separate risk: semantic parity does not guarantee equal blocker detection.

Testing

• Prettier on both contracts
• pnpm check:knowledge -- --base origin/main
• focused knowledge and row-status module tests
• strict TypeScript contract probe
• pnpm check:repo
• changed-file and public-hygiene scans
• private repeatable reviewer benchmark: failed strict gate on objective recall and precision

No Changeset: specifications only; no published package behavior changes.

[vercel]

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

Project	Deployment	Actions	Updated
astryx	Ready	Preview	Sep 2, 2026 2:29am UTC