Kjell Tore Guttormsen
14ecda886c
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>
55 lines
2.1 KiB
Markdown
55 lines
2.1 KiB
Markdown
---
|
|
type: trekbrief
|
|
brief_version: 1.0
|
|
slug: add-verbose-flag
|
|
task: Add a --verbose flag to the small-auth CLI parser
|
|
research_topics: 1
|
|
research_status: complete
|
|
brief_quality: ready
|
|
created: 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.
|