mitcheman/doctor

Bodega: Doctor

A single-command environment check. Run before starting setup to know what's missing, or standalone any time you want to verify the machine is still good.

What it checks

Critical (Bodega can't run at all without these):

• Node.js ≥ 20
• A package manager (npm, pnpm, yarn, or bun)

Needed for deploy (warn but don't block here — the hosting skill will install Vercel CLI if missing):

• Vercel CLI (vercel)

Optional (depending on features the user wants):

• gh CLI (only for {{command_prefix}}bodega:backup)
• git (bundled on most systems; required for backup)
• Stripe CLI (nice for webhook testing; not required)

Project-specific (only if a project is already present):

• package.json — is this a Node project at all?
• Framework → Next.js 16 preferred. Others: best-effort.
• .impeccable.md — design context available? (If absent, the commerce SDK falls back to built-in tokens.)
• .bodega.md — already set up? (setup won't clobber; reconfigure will.)

Workspace-parent detection: if cwd has 2+ subdirectories that contain package.json files, the cwd is a workspace parent (e.g., ~/Developer/). Doctor reports this as a warning so the user knows they're probably in the wrong directory before setup tries to greenfield-scaffold over it.

Version floors (when a tool is present, doctor checks the major version too):

• vercel CLI: floor 50.0.0. Stale CLIs miss commands and have known auth bugs. Warn (don't block) if older.
• gh CLI: floor 2.40.0. Older versions miss repo create flags bodega's backup skill uses.

How to run

node {{scripts_path}}/check.mjs

(Or just invoke this skill — {{command_prefix}}bodega:doctor — and the runtime handles the dispatch.)

Output

The check script prints a table and exits 0 if all critical checks pass, exits 1 otherwise. Example output:

✓ Node 22.1.0              (>= 20 required)
✓ pnpm 9.12.0              (package manager)
✓ git 2.45.0
✗ Vercel CLI not installed → Run: npm i -g vercel
✓ gh CLI 2.60.0            (optional — for backup)
✓ Next.js 16.2.4 detected
✓ .impeccable.md present   (design context available)

1 issue. Install missing tools and re-run /bodega:doctor.

Voice adaptation

If .bodega.md exists and sets mode: simple, soften the output:

Looking at your computer to make sure everything is ready...

✓ Node is installed (version 22.1, good)
✓ You have a package manager (pnpm 9.12)
✗ Vercel is not installed yet — I'll install it for you when we get to
  the hosting step, or you can install it now with:
  npm i -g vercel

Otherwise you're good to go. Run /bodega:setup when ready.

If .bodega.md is absent (first run), default to a neutral voice.

Auto-invocation

The {{command_prefix}}bodega:setup skill invokes doctor as its very first step. If doctor reports any critical failures, setup halts and tells the user to fix them first. Non-critical warnings are shown but don't block.

The doctor script must always exit 0 on "warnings only" (e.g., Vercel CLI missing is a warning, not a failure) so setup can continue and let the hosting skill handle the install.

What counts as critical vs. warning

| Check | Critical if missing? | |---|---| | Node >= 20 | ✅ critical — halt | | Any package manager | ✅ critical — halt | | package.json in adapt mode | ⚠️ warning — mode may shift to greenfield | | package.json in greenfield mode | — expected absent | | Vercel CLI | ⚠️ warning — hosting skill installs | | gh CLI | ⚠️ warning — only needed for backup | | git | ⚠️ warning — only needed for backup | | Stripe CLI | informational — never blocks |

Rules

• Never auto-install anything from doctor. It's read-only. Install happens in the skill that actually uses the tool.
• Don't cache results. Every invocation re-checks. Environments change.
• Respect .bodega.md voice if present. Default to neutral if absent.
• Keep the output under 15 lines in typical (healthy) case. If everything passes, the entire output fits on a phone screen.