CLI

The operational CLI: inspect and maintain a disk-backed stash from the shell without writing a Node program. It ships as the stashjs command (npx @blamejs/stash <subcommand>), and it composes ONLY the shipped query and maintenance verbs -- verify, stats, prune, list, tombstones, has. It never moves bytes: push / apply / pop / store mint or stream capabilities and blobs, and drop / clear destroy by ref, so they belong to the embedding application, not a maintenance tool. The CLI hands out no capability and streams no blob.

The root comes from --root <dir>, else STASH_ROOT, else ./.stash. It must already exist as a disk backend layout: the CLI refuses a missing root rather than conjuring an empty store from a typo. Add --json to any subcommand for a machine-readable document instead of the human table.

Single-writer-per-root is the store's operating constraint (SPEC.md 6): every subcommand except verify runs the crash-recovery scan first, which can reclaim a stale claim -- so point the CLI at a stash whose owning process is stopped, or at a cold-standby replica, never at a root a live app is serving.

Errors fail closed with stable exit codes and never echo a ref, a meta value, or a filesystem path. Run under node --permission with read/write scoped to the root (plus read on the install dir) exactly as the library requires.