Make the guide state-aware and shorten the agent install prompt

[ejntaylor]

Summary

Field-tested the AI-agent install flow with two simulated vibe-platform installs (Lovable-style bun fixture, mock manifest API, agents given only the README prompt) and rebuilt guide around what they hit.

• guide is now state-aware: it inspects the project (package manager, install state, .patchstackrc.json, build hooks, widget presence, framework) and prints a live ✔/✖ checklist with tailored commands — real site UUID substituted, framework-specific widget placement — before the full AGENT-INSTALL.md reference; the widget check also flags a userToken that doesn't match the provisioned siteUuid, which would otherwise silently no-op.
• README prompt shrinks to 3 steps (verify + scan + finish-the-checklist), keeping the field-tested refusal defenses inline while delegating the tail to the checklist, and making the flow idempotent on re-runs.
• CLI trust/output fixes from the field test: endpoint overrides are surfaced loudly in scan/status/guide (both test agents read CLI source to rule out manifest redirection), the dangling duplicate-versions list (>10 printed a bare colon) is fixed, and "npm lockfile" wording is corrected for the bun node_modules walk.
• AGENT-INSTALL.md accuracy fixes: provisioned-ness keys off the siteUuid key rather than the file existing, chained-hook example, unified siteUuid/userToken naming, and the commit step includes the widget file.

Test plan

• npm run typecheck and npm test green (143 tests, 15 new in tests/guide.test.ts).
• End-to-end: two background agents completed the install unaided in the fixture — round 2 ran the checklist, did only the ✖ steps, re-ran to confirm all-green, and verified with a real build.

🤖 Generated with Claude Code

[coderbuds]

The new state-aware guide is comprehensive and backed by extensive, targeted tests.

🎯 Quality: 93% Elite · 📦 Size: Extra Large — strongly consider breaking this down

🛡️ Standards: no pre-flight fit check ran for this change — wire assess-change-fit into your coding agents to catch size before opening.

📈 This month: Your 222nd PR — above team average · Averaging Excellent

_{See how your team is trending →}