Kjell Tore Guttormsen 9ecd225018 feat(ultraplan-local): Spor 3 — semantic plan-critic, examples, CC features, security docs

- agents/plan-critic.md: rule #7 split into literal blockers (TBD/TODO/FIXME)
  + semantic rubric with 8 deferred-decision tests; calibrated against the
  5-phrase corpus from the v3.1.0 quality brief
- hooks/hooks.json: rebuilt from corrupted state; valid JSON, registers
  PreToolUse(Bash,Write), UserPromptSubmit, PostToolUse(Bash), PreCompact
- hooks/scripts/session-title.mjs: NEW — sets ultra:<cmd>:<slug> session
  title for ultra commands (CC v2.1.94+)
- hooks/scripts/post-bash-stats.mjs: NEW — appends duration_ms per Bash
  call to ultraexecute-stats.jsonl (CC v2.1.97+)
- SECURITY.md: NEW — Forgejo private-issue reporting, supported = current
  minor only, scope = 4 hooks + denylist, hardening recommendations
- docs/architect-bridge-test.md: NEW — manual smoke checklist for the
  ultraplan ↔ ultra-cc-architect bridge
- examples/01-add-verbose-flag/: NEW — calibrated end-to-end (brief +
  research + plan + progress.json) for fork-er onramp; all four artifacts
  pass their validators
- README.md: + Extending the plugin, + Headless multi-session tuning
  (MCP_CONNECTION_NONBLOCKING), + Session titles, + Per-step timing,
  + disableSkillShellExecution recommendation
- CLAUDE.md: documents session-title.mjs and post-bash-stats.mjs
- root README.md: v3.1.0 entry expanded with Spor 2+3 deliverables

CC features adopted: F8, F9, F12 implemented; F3 implemented as Bash
PostToolUse logger; F2 (hook 'if'-field scoping) deferred — universal
protection beats reduced-scope protection for blocked commands.

Tests: 109/109 green.

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

2026-05-01 06:28:44 +02:00

2.1 KiB

Raw Blame History

type	brief_version	slug	task	research_topics	research_status	brief_quality	created
ultrabrief	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