Help examples, error suggestions, and test cleanup - #8

Merged

alexkroman merged 29 commits into

mainfrom

help-examples-and-error-suggestions

Jun 5, 2026

Commits on Jun 5, 2026

feat(help): add examples_epilog helper for --help examples

alexkroman-assembly
and
claude
committed
feat(help): add --help examples to transcribe and stream

alexkroman-assembly
and
claude
committed
feat(help): add --help examples to transcripts get/list

alexkroman-assembly
and
claude
committed
feat(help): add --help examples to agent and llm

alexkroman-assembly
and
claude
committed
feat(help): add --help examples to login/logout/whoami

alexkroman-assembly
and
claude
committed
feat(help): add --help examples to doctor and samples

alexkroman-assembly
and
claude
committed
feat(help): add --help examples to claude install/status/remove

alexkroman-assembly
and
claude
committed
test(help): guard that every leaf command ships --help examples

alexkroman-assembly
and
claude
committed
style(tests): drop redundant inline imports in help-examples tests

alexkroman-assembly
and
claude
committed
feat(errors): add optional suggestion field to CLIError model

alexkroman-assembly
and
claude
committed
feat(errors): render Suggestion line in human error output

alexkroman-assembly
and
claude
committed
feat(errors): split suggestion out of auth and audio error helpers

alexkroman-assembly
and
claude
committed
feat(errors): add suggestions to config profile/key errors

alexkroman-assembly
and
claude
committed
feat(errors): add suggestions to agent voice/system-prompt errors

alexkroman-assembly
and
claude
committed
feat(errors): add suggestions to samples create errors

alexkroman-assembly
and
claude
committed
feat(errors): add suggestions to llm prompt and login key errors

alexkroman-assembly
and
claude
committed
feat(errors): add suggestions to login flow errors

alexkroman-assembly
and
claude
committed
feat(errors): add suggestions to source/IO and dependency errors

alexkroman-assembly
and
claude
committed
test: fix ruff lint in B9 test files (unused imports, import order)

alexkroman-assembly
and
claude
committed
test(errors): assert suggestion on live login/audio-source paths

alexkroman-assembly
and
claude
committed
test(output): snapshot --help and error renders with syrupy

alexkroman-assembly
and
claude
committed
test(init): add install-and-boot smoke test for templates

alexkroman-assembly
and
claude
committed
chore(types): add pyright type-checker and fix all reported errors

alexkroman-assembly
and
claude
committed
test: simplify CLI tests and expand coverage

alexkroman-assembly
and
claude
committed
format fix
alexkroman-assembly
committed
ci: fix ruff format and stop whitespace hooks corrupting snapshots

alexkroman-assembly
and
claude
committed
ci: install dev extras in uv env so pyright/pytest resolve imports

alexkroman-assembly
and
claude
committed
test(snapshots): strip ANSI so --help goldens survive FORCE_COLOR on CI

alexkroman-assembly
and
claude
committed
build: adopt PEP 735 dependency-groups; require Python 3.11

alexkroman-assembly
and
claude
committed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Help examples, error suggestions, and test cleanup - #8

Help examples, error suggestions, and test cleanup#8
alexkroman merged 29 commits into
mainfrom
help-examples-and-error-suggestions

Commits on Jun 5, 2026

feat(help): add examples_epilog helper for --help examples

feat(help): add --help examples to transcribe and stream

feat(help): add --help examples to transcripts get/list

feat(help): add --help examples to agent and llm

feat(help): add --help examples to login/logout/whoami

feat(help): add --help examples to doctor and samples

feat(help): add --help examples to claude install/status/remove

test(help): guard that every leaf command ships --help examples

style(tests): drop redundant inline imports in help-examples tests

feat(errors): add optional suggestion field to CLIError model

feat(errors): render Suggestion line in human error output

feat(errors): split suggestion out of auth and audio error helpers

feat(errors): add suggestions to config profile/key errors

feat(errors): add suggestions to agent voice/system-prompt errors

feat(errors): add suggestions to samples create errors

feat(errors): add suggestions to llm prompt and login key errors

feat(errors): add suggestions to login flow errors

feat(errors): add suggestions to source/IO and dependency errors

test: fix ruff lint in B9 test files (unused imports, import order)

test(errors): assert suggestion on live login/audio-source paths

test(output): snapshot --help and error renders with syrupy

test(init): add install-and-boot smoke test for templates

chore(types): add pyright type-checker and fix all reported errors

test: simplify CLI tests and expand coverage

format fix

ci: fix ruff format and stop whitespace hooks corrupting snapshots

ci: install dev extras in uv env so pyright/pytest resolve imports

test(snapshots): strip ANSI so --help goldens survive FORCE_COLOR on CI

build: adopt PEP 735 dependency-groups; require Python 3.11