What to build
Add ergonomics on top of the base @file reference mechanism:
- Quoted paths:
@"path with spaces.md" accepts paths containing whitespace or shell-special characters. Unmatched quotes error clearly.
- Literal escape:
\@foo sends a literal @foo in the message rather than resolving it. user@example.com, @ followed by whitespace, and @ at end of prompt remain non-special without an escape.
- Multi-ref failure aggregation: when a prompt contains multiple
@refs and one or more fail to resolve, the error output lists all failures at once. The prompt is not sent to ask_adapt. The REPL input line is preserved so the user can edit rather than retype.
Acceptance criteria
Blocked by
What to build
Add ergonomics on top of the base
@filereference mechanism:@"path with spaces.md"accepts paths containing whitespace or shell-special characters. Unmatched quotes error clearly.\@foosends a literal@fooin the message rather than resolving it.user@example.com,@followed by whitespace, and@at end of prompt remain non-special without an escape.@refsand one or more fail to resolve, the error output lists all failures at once. The prompt is not sent toask_adapt. The REPL input line is preserved so the user can edit rather than retype.Acceptance criteria
@"my notes.md"in a prompt resolves the space-containing path correctly@"...produces a clear parse error and prevents sending\@foosends a literal@footoask_adapt; the parser does not attempt to resolve ituser@example.comin a prompt is unaffected (no attempted resolution)@with no following token is unaffected@refsproduces one error listing all three, not three separate turns\@escape, mid-word@, trailing@, and multi-failure aggregation with 2+ refsBlocked by