jhheider / penknife / 28775738666

76%

push

github

Headless CLI part 2: push, url, and status (the gist trio)

Completes the v0.2.0 headless CLI with the three GitHub-backed
verbs, so publishing and drift-checking are scriptable and
editor-bindable without opening the TUI.

- `push <file> [--force]`: publish or update the file's gist and
  print only the URL on stdout (progress on stderr, so
  `url=$(penknife push f.md)` captures clean). Honors the
  lost-update guard: a diverged remote refuses with exit 1 and
  points at --force.
- `url <file> [--clip] [--push] [--open]`: print the shareable URL.
  Already-published and no --push means the stored URL, offline and
  tokenless (it just notes if the local copy is newer). --clip
  copies (opt-in, so a scripted capture never clobbers the
  clipboard), --push updates first, --open launches the browser.
  Both side effects are non-fatal.
- `status [path] [--sync]`: per-file drift, offline by default (the
  local record, instant, safe in a prompt or pre-commit hook), with
  --sync for a live GitHub check. --porcelain gives stable
  `<code>\t<path>` lines; --json is structured; exit 1 when
  anything has drifted.

A path resolver maps a raw CLI file path to its (root, rel) store
key, erroring with the watched-folder list when a file is under no
root. Errors guide: the no-token and missing-gist-scope cases print
the exact `gh auth` command to run. Exit codes are the promised
API: 3 auth, 4 no-root, 5 operational.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

71 of 269 new or added lines in 2 files covered. (26.39%)

3016 of 7569 relevant lines covered (39.85%)

2.1 hits per line