docs(peek): skill tool count (14→16) + docs-deploy buildCommand fix

[harry-harish]

Two small documentation/content follow-ups.

1. Skill documents all 16 tools (was 14)

The bundled Claude Code skill (packages/peek-cli/skills/peek-skill.md, installed by peek init) claimed "14 tools" but the MCP server registers 16 — it was missing the two live-page read tools. Added a "Live-page read tools (2)" subsection for get_page_view + get_element_detail, corrected the count in all four places (frontmatter, body, heading, the "entire surface" note), relabeled the existing read group "Session-forensics read tools (8)", and updated the Level-1 description to "10 read tools (8 session-forensics + 2 live-page)". Documentation only — both tools already shipped. Changeset: @peekdev/cli patch.

2. Docs-deploy buildCommand builds workspace deps first

CLAUDE.md's documented Vercel buildCommand (pnpm --filter peek-docs run build) only builds the app, so on a cache-cold runner @cubenest/docs-shared/dist is missing and the Astro build fails (Failed to resolve entry for package "@cubenest/docs-shared"). Fixed both docs sites to pnpm --filter peek-docs... run build / tracelane-docs... run build (the trailing ... builds workspace dependencies in topological order first) + documented why. (This is the command the last successful peek-docs deploy actually used.)

Test plan

• pnpm lint — clean (513 files)
• pnpm changeset status — @peekdev/cli recognized
• Markdown-only / content-only; no code or test changes

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated the skill documentation to reflect the full set of 16 available tools, including two live-page read options.
  • Clarified deployment guidance so builds include workspace dependencies, helping avoid missing artifacts during fresh builds.
  • Corrected the release note entry to match the current tool count.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: baaef195-cfcb-4fd9-be54-8b0571b4e384

📥 Commits

Reviewing files that changed from the base of the PR and between 240aa3b and c7adf0c.

📒 Files selected for processing (3)

• .changeset/peek-skill-16-tools.md
• CLAUDE.md
• packages/peek-cli/skills/peek-skill.md

---

📝 Walkthrough

Walkthrough

Updates peek-skill.md to document 16 MCP tools (adding get_page_view and get_element_detail as a new live-page read tools subsection) with matching permission model and safety floor text. Fixes CLAUDE.md Vercel build commands to use pnpm --filter <app>... run build for workspace dependency resolution, with an explanatory note. Adds a changeset for the @peekdev/cli patch.

Changes

Peek skill docs & build config

Layer / File(s)	Summary
peek-skill.md: 14→16 tool surface packages/peek-cli/skills/peek-skill.md, .changeset/peek-skill-16-tools.md	Intro, tools heading, and session-forensics count updated to 16; new "Live-page read tools (2)" subsection added for get_page_view and get_element_detail; Level 1 permission model updated to "all 10 read tools (8 session-forensics + 2 live-page)"; safety floor updated from "14 above" to "16 above"; changeset declares patch release.
CLAUDE.md: pnpm workspace build fix CLAUDE.md	buildCommand for peek-docs and tracelane-docs updated to pnpm --filter <app>... run build; new note explains the trailing ... triggers topological dependency builds to avoid missing artifacts on cold cache.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• Cubenest/rrweb-stack#94: Prior update to the same peek-skill.md tool counts and permission/safety text — direct predecessor to this 14→16 correction.
• Cubenest/rrweb-stack#120: Implemented get_element_detail with expanded fields; this PR documents it as part of the 16-tool surface.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes both main documentation changes: the Peek skill tool count update and the docs-deploy buildCommand fix.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/peek-doc-followups

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}