Skip to content

🍕 Add dev repair toolkit commands#243

Open
jjpaulino wants to merge 3 commits intomasterfrom
jordan/dev-repair-tooling
Open

🍕 Add dev repair toolkit commands#243
jjpaulino wants to merge 3 commits intomasterfrom
jordan/dev-repair-tooling

Conversation

@jjpaulino
Copy link
Copy Markdown
Member

Summary

  • Add new CLI commands: doctor, refs, backup, restore, and rescue for incident response and page repair workflows.
  • Add shared repair helpers for env-aware key/url resolution, missing-ref detection, safe prune/replace/reset mutations, where-used lookup, and snapshot backup/restore.
  • Wire all mutating flows to use key aliases (-k) so PUT/PATCH operations target the correct environment credentials.

Test plan

  • npm run lint
  • Run clay doctor <page-url> -k <env-key> on a known page
  • Run clay refs <page-url> --action prune -k <env-key> (dry-run and with --apply in a safe env)
  • Run clay backup <page-url> and clay restore <target-prefix> --file <snapshot> -k <env-key>
  • Run clay rescue <page-url> -k <env-key>

Made with Cursor

Add doctor/refs/backup/restore/rescue workflows to diagnose broken references, run safe dry-run-first fixes, and apply environment-keyed mutations across Clay environments.

Made-with: Cursor
@jjpaulino jjpaulino self-assigned this Apr 15, 2026
Add comprehensive JSDoc and inline clarifying comments across the new doctor/refs/backup/restore/rescue command paths, and fully document usage, flags, and environment key workflows in CLI docs.

Made-with: Cursor
Require explicit confirmation whenever --layout is enabled, including a non-interactive --yes-layout bypass, and default repair scans/mutations to skip layout refs unless layout mode is explicitly confirmed.

Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant