<feed xmlns='http://www.w3.org/2005/Atom'>
<title>ida-tui.git/docs/GRAPH_VIEW.md, branch main</title>
<subtitle>tui for headless ida</subtitle>
<id>https://git.sl0p.foo/ida-tui.git/atom/docs/GRAPH_VIEW.md?h=main</id>
<link rel='self' href='https://git.sl0p.foo/ida-tui.git/atom/docs/GRAPH_VIEW.md?h=main'/>
<link rel='alternate' type='text/html' href='https://git.sl0p.foo/ida-tui.git/'/>
<updated>2026-08-07T13:29:49Z</updated>
<entry>
<title>docs: drop two stale files, correct the two the README links, cut sharp edges</title>
<updated>2026-08-07T13:29:49Z</updated>
<author>
<name>blasty</name>
<email>blasty@local</email>
</author>
<published>2026-08-07T13:29:37Z</published>
<link rel='alternate' type='text/html' href='https://git.sl0p.foo/ida-tui.git/commit/?id=8fef561903e9501281ebcc58cdb33ee4d9116fd0'/>
<id>urn:sha1:8fef561903e9501281ebcc58cdb33ee4d9116fd0</id>
<content type='text'>
README: "Known sharp edges" removed.

docs/GRAPH_VIEW.md pointed the graph's one backend call at
server/patch_server.py, a file the port deleted. It is
idatui/codemode_client.py now. This matters because GRAPH_VIEW.md is one of
only two docs the README links -- a wrong path in a linked doc is worse than
no doc.

docs/RPC.md was missing five verbs rpc.py serves: ping/methods/quit (now a
Session table) and trace/binaries/switch (with the semantic verbs). The trace
verb drives a whole feature the README advertises, so its absence was the real
gap. Every verb in rpc.py's METHODS table is now documented, checked
mechanically -- the remainder of what looked missing turned out to be values
of the "move" verb's dir parameter, not verbs.

Deleted:

- docs/CODEMODE_PORT.md. Written mid-port, and its Result section claims the
  port covered "the complete current TUI feature set". It did not: the graph
  view was dead, the operand-format keys were dead, pseudocode comments never
  appeared, and bulk rename was broken. Keeping a doc that states the opposite
  of what we found is worse than having none, and docs/CODEMODE_UPSTREAM.md
  carries the accurate account of the API limits.
- docs/TUI_DRIVING_BLUEPRINT.md. A design sketch for generalizing the
  drive-a-TUI-over-a-socket pattern to other programs, with gdb as the main
  example -- which now exists for real in ~/dev/gdb-driver. Superseded by the
  thing it proposed.

Nothing linked either file. Both remain in git history.
</content>
</entry>
<entry>
<title>graph: navigate to blocks, not to coordinates</title>
<updated>2026-08-06T14:28:56Z</updated>
<author>
<name>blasty</name>
<email>blasty@local</email>
</author>
<published>2026-08-06T14:28:56Z</published>
<link rel='alternate' type='text/html' href='https://git.sl0p.foo/ida-tui.git/commit/?id=4408eaf2cb814e927f51cb0632e9845994abae51'/>
<id>urn:sha1:4408eaf2cb814e927f51cb0632e9845994abae51</id>
<content type='text'>
Clicking the minimap panned to the exact coordinate under the pointer and moved
the cursor only if a block happened to sit there. Since one minimap cell covers
many canvas cells, "there" was almost always padding: you got a jump into empty
space and the cursor stayed behind, so you had to click a block afterwards to
actually go anywhere.

Blocks cover a few percent of a laid-out graph -- 4.6% of an 87-block function,
0.8% of a 424-block one -- and the rest is the space that keeps edges apart. So
coordinates are the wrong thing to navigate by here. The minimap now snaps to
the nearest block and takes the cursor with it, and a drag scrubs from block to
block. Distance is measured with the column halved, because cells are twice as
tall as they are wide and otherwise "nearest" is not what looks nearest.

A drag-pan or ctrl+d/pageup that ends with no block on screen at all now eases
to the nearest one too, since an empty screen leaves nothing to navigate back
by. It only fires when nothing is visible, so a deliberate pan is never fought.
</content>
</entry>
<entry>
<title>graph: the minimap is clickable, and stops swallowing clicks</title>
<updated>2026-08-06T14:20:29Z</updated>
<author>
<name>blasty</name>
<email>blasty@local</email>
</author>
<published>2026-08-06T14:20:29Z</published>
<link rel='alternate' type='text/html' href='https://git.sl0p.foo/ida-tui.git/commit/?id=e103f6b6c2399bf46301c3c6f9f5c4cecd456ef8'/>
<id>urn:sha1:e103f6b6c2399bf46301c3c6f9f5c4cecd456ef8</id>
<content type='text'>
Click it to jump the view to that part of the graph, drag to scrub. If the
point you clicked is over a block the cursor lands in it, so the keyboard
carries on from where you pointed instead of snapping back.

This also fixes a real bug rather than only adding a feature. The minimap
FLOATS over the canvas -- it is pinned to the viewport, not drawn into the
graph -- so a click on it was being translated into canvas coordinates and
dropping the cursor into whatever block happened to lie underneath. It has to
be hit-tested before the canvas, which is what on_click now does.

_minimap_rect() is the one source of truth for where it is: the renderer and
the hit-test both take the position from it, so the two-column inset that
keeps it clear of the ScrollView's scrollbar can't drift between them.
</content>
</entry>
<entry>
<title>graph: docs, and the offline layout tools</title>
<updated>2026-08-06T13:11:54Z</updated>
<author>
<name>blasty</name>
<email>blasty@local</email>
</author>
<published>2026-08-06T13:11:54Z</published>
<link rel='alternate' type='text/html' href='https://git.sl0p.foo/ida-tui.git/commit/?id=4fbd6b61eaa3461db673b220e2376b3d1e922a9b'/>
<id>urn:sha1:4fbd6b61eaa3461db673b220e2376b3d1e922a9b</id>
<content type='text'>
cfg_dump freezes real CFGs to JSON; graph_spike renders one or --stats a
whole corpus through the shipping engine; graph_smoke is the end-to-end
tool-&gt;domain-&gt;layout check; graph_shot renders the real view headless at a
chosen size, which is the only sane way to judge it (a tiled pane is far
too narrow and the minimap sits on top of the graph).
</content>
</entry>
</feed>
