administrator/DocForge2
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions Pages

Polish sparse graph navigation

Browse source
This commit is contained in:
Andraxion 2026-07-24 22:54:19 -04:00
parent 5ccb336e84
commit 7834461eb9
8 changed files with 148 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

15
docs/MCP_CONTRACT.md
View file

@ -61,7 +61,7 @@ only through the explicit local CLI integration command.
## Visualization boundary
`docforge_visualize` starts the fixed built-in `graph-browser@5` template against the currently
`docforge_visualize` starts the fixed built-in `graph-browser@6` template against the currently
validated derived index. It may focus one stable node, run one bounded lexical query, or open the
project overview. The tool returns a loopback URL and exact snapshot identity.
@ -70,12 +70,13 @@ expression. Its HTTP surface is token-bound, read-only, same-origin, and limited
search/filter, node-neighborhood JSON, and a read-only browser-lease heartbeat. The browser exposes
an exact validated index snapshot. It rejects index replacement or alteration and requires another
MCP invocation to refresh.
Viewport interaction is entirely client-side: wheel zoom, left-button drag pan, explicit zoom
buttons, and reset never request or mutate project data. Graph-node activation fetches exact node
data from the same bounded read endpoint and opens a client-side modal inspector. Replacing the
current root requires the modal's explicit Explore neighborhood action. The open browser renews a
bounded lease in a detached local worker, so standard-input transaction completion does not close
the listener. The worker tracks the longer-lived MCP client host and closes when that owner exits.
Viewport interaction is entirely client-side: fitted neighborhood framing, wheel zoom, left-button
drag pan, explicit zoom buttons, reset, and Space-to-center selection never request or mutate
project data. Graph-node activation visibly selects the node, fetches exact node data from the same
bounded read endpoint, and opens a client-side modal inspector. Replacing the current root requires
the modal's explicit Explore neighborhood action. The open browser renews a bounded lease in a
detached local worker, so standard-input transaction completion does not close the listener. The
worker tracks the longer-lived MCP client host and closes when that owner exits.
Explicit service shutdown closes its tracked worker, and abandoned pages expire.
## Excluded tools