Skip to content

feat(cli): Add . and +live conversation target keywords - #937

Merged
JeanMertz merged 4 commits into
mainfrom
grep-current
Aug 5, 2026
Merged

feat(cli): Add . and +live conversation target keywords#937
JeanMertz merged 4 commits into
mainfrom
grep-current

Conversation

@JeanMertz

Copy link
Copy Markdown
Collaborator

The session's active conversation is what jp query, jp c print, and most other conversation commands resolve to when given no target, but it had no name in the target grammar. Reaching it explicitly meant looking up its ID by hand:

jp c grep --id jp-c17761673600 branch

. (long form active) names it, so the same search becomes:

jp c grep -i. branch

+l (long form +live) names the whole live corpus, filling the other hole in the grammar: +pinned and +session could each say "all of this partition", but nothing said "all of them". Bare + is left unbound on purpose, reserved for a future keyword spanning both the live and archive partitions, so +l and a later +all can mean different things.

latest is renamed to recent, and its short form l to r. English carries the distinction the pair needs: recent is what was last used, newest is what was last created. latest and newest both read as "most recent", leaving the activated-versus-created difference to the help text alone. The rename also frees l, so +l no longer sits beside an unrelated l. RFD 087's workspace targeting table, which reuses these keywords, is updated to match.

The session's active conversation is what `jp query`, `jp c print`, and
most other conversation commands resolve to when given no target, but it
had no name in the target grammar. Reaching it explicitly meant looking
up its ID by hand:

    jp c grep --id jp-c17761673600 branch

`.` (long form `active`) names it, so the same search becomes:

    jp c grep -i. branch

`+l` (long form `+live`) names the whole live corpus, filling the other
hole in the grammar: `+pinned` and `+session` could each say "all of
this partition", but nothing said "all of them". Bare `+` is left
unbound on purpose, reserved for a future keyword spanning both the
live and archive partitions, so `+l` and a later `+all` can mean
different things.

`latest` is renamed to `recent`, and its short form `l` to `r`. English
carries the distinction the pair needs: `recent` is what was last used,
`newest` is what was last created. `latest` and `newest` both read as
"most recent", leaving the activated-versus-created difference to the
help text alone. The rename also frees `l`, so `+l` no longer sits
beside an unrelated `l`. RFD 087's workspace targeting table, which
reuses these keywords, is updated to match.

Signed-off-by: Jean Mertz <git@jeanmertz.com>
Signed-off-by: Jean Mertz <git@jeanmertz.com>
Signed-off-by: Jean Mertz <git@jeanmertz.com>
Signed-off-by: Jean Mertz <git@jeanmertz.com>
@JeanMertz
JeanMertz merged commit 6786bd7 into main Aug 5, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant