Rituals pattern: disambiguation (did you mean…?) #184

New issue

Open

opened 2026-10-04 20:20:34 +00:00 by peterswimm · 0 comments

peterswimm commented

2026-10-04 20:20:34 +00:00

Owner

Part of #177.

What it's for: the person said something and the Forge isn't sure what they meant. Show the likely matches and let them pick, or file what they said as a wish.

Where it shows up today

ritual start (the interactive session) prints a ranked list of candidate intents with confidence scores, sometimes web search results, then waits for the person to retype. If the local model is available, it may answer conversationally instead. If the person repeats a phrase, it's learned as an alias.
ritual run --capture files an unrecognised request as a wish.
The apps have nothing for this.

Please design

The candidate list: name, what it does, and how confidence is shown (or whether it's shown at all)
"None of these", leading to "file this as a wish" (using the wish compose pattern)
A clear notice when the answer comes from a local model instead of a matched ritual
Telling the person a phrase was learned ("next time, 'email Mark' will go straight to Send Email")

Acceptance criteria

Spec covers the candidate list, none-of-these, model-fallback notice and alias-learned notice.
CLI version (numbered choices).

Part of #177. **What it's for:** the person said something and the Forge isn't sure what they meant. Show the likely matches and let them pick, or file what they said as a wish. ## Where it shows up today - `ritual start` (the interactive session) prints a ranked list of candidate intents with confidence scores, sometimes web search results, then waits for the person to retype. If the local model is available, it may answer conversationally instead. If the person repeats a phrase, it's learned as an alias. - `ritual run --capture` files an unrecognised request as a wish. - The apps have nothing for this. ## Please design - The candidate list: name, what it does, and how confidence is shown (or whether it's shown at all) - **"None of these"**, leading to "file this as a wish" (using the wish compose pattern) - A clear notice when the answer comes from a local model instead of a matched ritual - Telling the person a phrase was learned ("next time, 'email Mark' will go straight to Send Email") ## Acceptance criteria - [ ] Spec covers the candidate list, none-of-these, model-fallback notice and alias-learned notice. - [ ] CLI version (numbered choices).