simulate: hyperlink the <ref> tags and add jump hotkeys - #939
Merged
Conversation
…turn The summarization model cites the conversation turns behind a finding with <ref job="..." item="...">quoted text</ref>. In the TUI those become OSC 8 hyperlinks to the item in the dashboard; in reports and CI logs, which cannot carry a link, the tag is reduced to the quoted text.
u9g
changed the title
A summary citation could only be followed out of the terminal, by ctrl+clicking its OSC 8 link into the dashboard. The turn it cites is already in the run, so the TUI can open it directly. Each citation now carries a number, and pressing that digit on the list view opens the cited job. Numbering follows render order through one index shared by every block of the summary, so the digit a reader presses selects the citation whose label shows it. Only the first nine are numbered: a number is an invitation to press that digit, and there is no tenth digit. A jump lands at the top of the printed job, which scrollback cannot be scrolled past, so the cited turn is marked where it prints. The mark rides the message text rather than the speaker header, which a message continuing an open agent block never prints. Numbering keys off a citation naming a job, not off a dashboard URL resolving: the jump is local, so it works where the link does not.
… there Marking only ran over chat messages, so a citation naming a tool call went to a transcript with nothing marked in it. A function call carries an id like the messages do, so it marks the same way; the mark rides outside writeToolItem's dimming, which the payload it annotates is under. A summary also cites items that are not in the history it summarized. The jump still lands on the job it named, so the transcript now says the cited turn is not in it rather than leaving a reader scanning for a mark that was never coming.
u9g
force-pushed
the
jason/simulate-refs-dev-mode
branch
from
August 14, 2026 15:26
17b310f to
89a2965
Compare
u9g
changed the title
u9g
changed the title
theomonnom
approved these changes
Aug 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A run summary cites the conversation turns behind each finding, but the raw
<ref>tags printed verbatim and led nowhere. Each citation now reads as itsquoted text — hyperlinked to the dashboard, and numbered so pressing that digit
opens the cited turn in the TUI.