Kjell Tore Guttormsen 14ecda886c feat(voyage)!: bulk content rewrite ultra -> voyage/trek prose [skip-docs]

Sed-pipeline (16 patterns, longest-match-first) sweeper residuelle ultra*-treff
i prose, command-narrativ, agent-prompts, hook-kommentarer, doc-prosa.

Pipeline-utvidelser fra V4-prompten:
- BSD-syntax [[:<:]]ultra[[:>:]] istedenfor \bultra\b (BSD sed mangler \b)
- 6 compound-patterns for ultraplan/ultraexecute/ultraresearch/ultrabrief/
  ultrareview/ultracontinue uten -local-suffiks
- ultra*-stats glob -> trek*-stats glob
- Linje-eksklusjon redusert til ultra-cc-architect (Q8); session-state-
  eksklusjonen var over-protektiv
- File-eksklusjon utvidet til settings.json, package.json, plugin.json,
  hele .claude/-treet (gitignored + V5-territorium)

Q8-undantak holdt: architecture-discovery.mjs + project-discovery.mjs urort.
Filnavn-konvensjon holdt: .session-state.local.json + *.local.* preservert.

Manuell narrative-fix: tests/lib/agent-frontmatter.test.mjs linje 10
mangled "/ultra*-local" til "/voyage*-local" (ingen slik kommando finnes);
korrigert til "/trek*".

Residualer utenfor scope (V5 handterer): package.json + .claude-plugin/
plugin.json (Step 12-14 versjons-bump). .claude/* er gitignored
spec-historikk med tilsiktet BEFORE/AFTER-narrativ.

Part of voyage-rebrand session 3 (Wave 4 / Step 10).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-05 15:08:20 +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.

2.1 KiB Raw Blame History

Add --verbose flag to small-auth CLI