Problem
After showing word forms, there's no hint that more data is available. An agent has to already know the flags exist.
Current output (e.g. sonaveeb-cli puu):
puu (noun, type 22)
English: tree, wood
ainsuse nimetav: puu
ainsuse omastav: puu
ainsuse osastav: puud
mitmuse osastav: puid
The agent doesn't know:
- There are many more forms available via
--all
- Whether other homonyms exist (the header mentions it if there are multiple, but not when there's only one meaning)
Fix
Append a small hints block after the main output (omit in --quiet mode):
# Run 'sonaveeb-cli puu --all' to see all 28 forms
If multiple homonyms exist, the existing header note is good — but could also appear as a hint:
# Run 'sonaveeb-cli puu --homonym=2' for the next meaning
Omit hints in --quiet and --json modes.
Reference
AXI Principle 9 — Contextual disclosure
Problem
After showing word forms, there's no hint that more data is available. An agent has to already know the flags exist.
Current output (e.g.
sonaveeb-cli puu):The agent doesn't know:
--allFix
Append a small hints block after the main output (omit in
--quietmode):If multiple homonyms exist, the existing header note is good — but could also appear as a hint:
Omit hints in
--quietand--jsonmodes.Reference
AXI Principle 9 — Contextual disclosure