jhheider / penknife / 28775337870

76%

Build Type

push

github

Committed by web-flow

Commit Message

Add headless CLI: clap, plus the no-auth render and search verbs (#27)

First step of the v0.2.0 headless CLI, so penknife composes with
editors and scripts instead of being TUI-only. Bare `penknife` still
launches the TUI; a subcommand runs once and exits.

Adopts clap (derive), replacing the hand-rolled arg parser, and adds
the two commands that need no account, network, or config:

- `render [file|-] [--standalone]`: markdown to HTML on stdout, the
  headless form of the `p` rich-text feature. Reads a file or stdin
  (explicit `-`, or piped with no arg; it refuses to hang on an
  interactive stdin). `--standalone` wraps the fragment in a full
  document with a UTF-8 charset and an H1-derived title.
- `search <query> [path] [-l] [--json] [-q]`: grep-style substring
  search, `path:line:text` by default, exit 1 on no match.

Both follow the CLI contract: stdout is the machine payload, stderr
is for humans, and exit codes are an API (0 ok, 1 normal-negative,
2 usage, 5 operational). Because they touch no token or network,
they are exactly the surface the pkgx/Homebrew `test:` step can
exercise without credentials.

The markdown-to-HTML renderer moves out of app/files.rs into a
shared `markdown` module so the `p` clipboard path and `render` call
one function; its tests move with it, and `standalone` gains its own.

The gist verbs (push, url --clip, status --sync) land next.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Coverage Stats

90 of 204 new or added lines in 4 files covered. (44.12%)

2 existing lines in 1 file now uncovered.

2939 of 7302 relevant lines covered (40.25%)

2.16 hits per line