refactor(plugin): file logging, install diagnostics, and UI polish

[onlycastle]

Summary

• Plugin diagnostics: Logger now writes to ~/.betterprompt/debug.log with timestamps; native-deps captures npm output and surfaces actionable error hints
• Rate limit resilience: SKILL.md updated with longer cooldowns (60s/90s) and progressive backoff for Phase 2 analysis skills on Claude Max
• UI polish: New sketch-shadow CSS system (--shadow-sketch variables) applied across diagnosis, strengths, activity, and narrative report cards

Changes

1. refactor(plugin): add file logging and install diagnostics — logger.ts, native-deps.ts
2. docs(plugin): add rate limit strategy and troubleshooting guide — SKILL.md, README.md, .mcp.json
3. chore(plugin): rebuild dist artifacts — dist chunk rebuild
4. style: add sketch shadow system and polish report cards — 8 CSS modules + variables.css
5. chore: update next-env.d.ts for Next.js dev types path — auto-generated

Test Plan

• TypeScript compiles without errors
• All 452 tests pass
• Manual: verify plugin debug log appears at ~/.betterprompt/debug.log
• Manual: verify sketch shadow styling on report cards

---

Generated with Claude Code using /ship-it

[onlycastle]

Code Review

Found 2 issues (from 9 candidates, filtered at score ≥ 80):

1. docs/agent/PLUGIN.md not updated for logger behavior change (CLAUDE.md says: "When you add new files, change directory structure, modify the pipeline… update the relevant docs/agent/ doc in the same change")
   logger.ts now writes all messages to ~/.betterprompt/debug.log unconditionally — the PLUGIN.md description still says "Structured stderr logger" and the Local Files table doesn't mention the new log file.
   

   BetterPrompt/packages/plugin/lib/logger.ts

   Lines 1 to 10 in 68bce01

   	/**
   	* Debug Logger
   	*
   	* Logging utility for the BetterPrompt plugin.
   	* Writes to both stderr and ~/.betterprompt/debug.log.
   	* Stderr output is gated by BETTERPROMPT_DEBUG=1;
   	* the log file always receives all messages.
   	*
   	* Output format: [bp:<tag>] <message> {optional JSON}\n
   	*/

2. README references scripts/verify-plugin.sh which is not committed in this PR — users following the Troubleshooting section will get "file not found". Either commit the script or remove the reference.
   

   BetterPrompt/README.md

   Lines 73 to 76 in 68bce01

   	If the plugin isn't working, run the verification script:
   	```bash
   	bash scripts/verify-plugin.sh

---

Filtered out (score < 80):

• dirEnsured latch on failure (40) — best-effort logging by design
• dataDir vs installDir redundancy (50) — harmless, npm handles dirs
• Incomplete font alias migration (30) — pre-existing, not introduced by this PR
• Module docstring "fallback" framing (0) — pre-existing, unchanged
• README "8 components" lists 6 (70) — minor doc count mismatch
• Comment overstates stderr capture (45) — stdout IS captured

Generated with Claude Code

_{If useful, react with a thumbs-up. Otherwise, thumbs-down.}