snippet-cli

A small in-process snippet manager. No external dependencies; Node.js standard library only.

Contract

src/cli.js is CommonJS and exports run(argv, state):

argv: array of command-line words (already split, no program name).
state: any plain object, created by the caller as {}. The CLI keeps its data in it and mutates it in place; it survives across calls.
Returns synchronously: { code, stdout, stderr } — a number and two strings (empty string when there is nothing to print). run must never throw, on any input.
All printed lines end with \n.

add <name> [--tags a,b] <text...> — creates a snippet from the remaining words joined by single spaces. Prints created <name>, code 0.
Adding an existing name: code 1, stderr error: snippet '<name>' already exists, state unchanged.
add with a missing name or missing text: code 2, stderr usage: add <name> [--tags t1,t2] <text...>.
Names must match ^[a-z0-9][a-z0-9-]*$; otherwise code 2, stderr error: invalid snippet name '<name>'.
get <name> — prints the exact text, code 0. Unknown name: code 2, stderr error: no snippet named '<name>'.
remove <name> — prints removed <name>, code 0. Unknown name: same as get.
list — every snippet name, sorted ascending, one per line. With no snippets: prints no snippets. Always code 0.
list --tag <t> — only snippets whose tags include t.
search <term> — case-insensitive substring match over name and text; prints matching names sorted, one per line; prints no matches when empty. Code 0.
export — prints JSON.stringify of { snippets: { <name>: { text, tags } } } with names sorted and each tags array sorted. Code 0.
import <json> — merges an exported document: names not already present are added, existing names are skipped. Prints imported <N>, skipped <M>, code 0. Malformed JSON: code 1, stderr error: invalid JSON, state unchanged.
No command or an unknown command: code 2, stderr usage: snippet <add|get|list|remove|search|export|import>.

Run the tests with npm test.