command-surface

A command file is five surfaces, not one. Add the file and stop, and the compiled binary breaks while dev-mode auto-discovery hides it from you.

The surfaces

Adding, renaming, or removing lib/commands/<name>.js means all of these:

1. Manifest — regenerate the static require graph:

   node scripts/gen-command-manifest.js          # write if changed
   node scripts/gen-command-manifest.js --check  # exit 1 if stale
   

   lib/commands/_manifest.js is generated; never hand-edit it. Drift is enforced by test/structural/command-manifest-drift.test.js. [verified 2026-08-13]