Summary

• Make CLI truecolor dark/light defaults resolve from the built-in OpenCode-compatible preset JSON instead of a duplicate Rust RGB palette.
• Preserve partial external OpenCode theme fallback behavior by resolving missing fields against the current base theme.
• Tighten consumed CLI preset colors after product review: light diff foregrounds and line numbers now reuse stronger existing roles, light warning uses one darker amber seed, dark diff line numbers reuse muted text, and command prompts follow primary for block/hover readability.
• Update the theme optimization document and CLI governance baseline to keep Rust/TS ownership clear: TS owns theme preset data, CLI owns terminal projection and ANSI/monochrome fallback behavior.

Metrics

User-visible CLI Color Changes

ANSI16 and monochrome paths are unchanged. Command prompt color now follows primary so it remains readable on command card block and hover backgrounds.

Review Fixes

• Independent architecture and product-design subagent review found that removing generated-widget --btn-* payload would degrade Cyber/Tokyo/light button identity inside iframe content.
• That attempted payload compression was reverted. Generated-widget payload remains at 80 keys with 18 resolved button tokens, and the document now records why those button tokens stay in the payload boundary.
• Product-design review also flagged that CLI truecolor changes affect diff/status/command/muted roles, not only primary/background/panel. This update adds role-level contrast coverage and improves the weakest consumed truecolor roles without expanding the palette.
• Final architecture review found the command prompt contrast guard was checking the wrong background; command text now derives from primary and the guard covers block and hover block backgrounds.

Verification

• pnpm run theme:color-audit:all
• pnpm run theme:color-audit:test
• pnpm run theme:visual-contract
• pnpm --dir src/web-ui run test:run -- themePayload.test.ts
• pnpm run type-check:web
• pnpm run lint:web
• cargo test -p bitfun-cli theme -- --nocapture
• cargo check -p bitfun-cli
• git diff --check

AI-assisted; locally verified as listed above. Cargo verification only reported existing rmcp deprecation warnings.