Skip to content

AXI P9: Add contextual next-step hints after output #4

Description

@LarsEckart

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions