open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions
ktg-plugin-marketplace/plugins/voyage/examples/01-add-verbose-flag/brief.md
Kjell Tore Guttormsen 7a90d348ad feat(voyage)!: marketplace handoff — rename plugins/ultraplan-local to plugins/voyage [skip-docs] 
Session 5 of voyage-rebrand (V6). Operator-authorized cross-plugin scope.

- git mv plugins/ultraplan-local plugins/voyage (rename detected, history preserved)
- .claude-plugin/marketplace.json: voyage entry replaces ultraplan-local
- CLAUDE.md: voyage row in plugin list, voyage in design-system consumer list
- README.md: bulk rename ultra*-local commands -> trek* commands; ultraplan-local refs -> voyage; type discriminators (type: trekbrief/trekreview); session-title pattern (voyage:<command>:<slug>); v4.0.0 release-note paragraph
- plugins/voyage/.claude-plugin/plugin.json: homepage/repository URLs point to monorepo voyage path
- plugins/voyage/verify.sh: drop URL whitelist exception (no longer needed)

Closes voyage-rebrand. bash plugins/voyage/verify.sh PASS 7/7. npm test 361/361.
2026-05-05 15:37:52 +02:00

2.1 KiB
Raw Blame History

type brief_version slug task research_topics research_status brief_quality created
trekbrief 1.0 add-verbose-flag Add a --verbose flag to the small-auth CLI parser 1 complete ready 2026-05-01

Add --verbose flag to small-auth CLI

Intent

The small-auth CLI parser has six commands (login, logout, whoami, token-refresh, users-list, users-create) and currently emits only final results — no progress, no timings, no internal step trace. Operators debugging slow token-refresh calls or mis-routed users-list queries have no signal between "started" and "finished".

We want a --verbose flag that, when passed, prints structured progress lines to stderr without changing stdout output. Stdout stays the machine-parseable contract; stderr becomes the human-readable trace.

Goal

Add a single --verbose boolean flag, recognized by all six commands, that emits one stderr line per internal step. No other behavioral changes. The default (--verbose absent) produces output byte-identical to today's CLI.

Success Criteria

  • small-auth login --verbose alice exits 0 and writes ≥ 3 stderr lines prefixed [verbose] covering: argument parse, credential lookup, session-token issue.
  • small-auth login alice (no flag) writes exactly the same stdout as before this change — verified by golden-file diff against tests/golden/login.stdout.
  • --verbose works in any position: small-auth --verbose login alice, small-auth login --verbose alice, small-auth login alice --verbose.
  • --verbose short form is -v. -vv is not recognized — only one level. Document this in --help.
  • All six commands accept the flag without rejection. Commands that have no internal steps to trace (whoami) still accept the flag silently.
  • Existing 24 tests in tests/ continue to pass. Two new tests added: one stdout-stability test, one stderr-content test for login.

Out of scope

  • Log levels beyond on/off (no --debug, --trace).
  • Structured JSON logging — stderr stays plain text in this iteration.
  • Logging configuration via env vars or config file.
  • Any command other than the six listed.