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

Keep visualization worker alive until explicit stop

Browse source
This commit is contained in:
Andraxion 2026-07-24 23:55:55 -04:00
parent 440ca7510f
commit eb48ba1a51
12 changed files with 410 additions and 150 deletions
Download patch file Download diff file Expand all files Collapse all files

17
README.md
View file

@ -36,8 +36,7 @@ DFG-13 makes pointer activation reliable by delaying SVG pointer capture until a
crosses the movement threshold. It also ensures the empty-canvas instruction disappears whenever a
neighborhood is rendered.
DFG-14 makes the viewer useful as a durable project-manual navigator. An open browser page renews
the loopback listener lease across short-lived MCP transactions. Resizable side panels and a
DFG-14 makes the viewer useful as a durable project-manual navigator. Resizable side panels and a
draggable, resizable inspector support dense material. Neighborhoods are grouped generically by
topology into the focus node, outgoing paths, and incoming or lateral context, with distinct
palettes and progressive hop-distance shading.
@ -47,6 +46,10 @@ relation-specific colors, line patterns, directional symbols, and an exact visib
constructs a bounded upstream lineage with semantic direction for execution, data, and dependency
relations while excluding structural and evidence context.
DFG-18 makes the viewer a truly persistent project-bound local service. It survives MCP process
turnover and browser inactivity, reuses the current snapshot URL, and stops only when
`docforge_stop_visualization` explicitly requests it.
## Development
Install Pyright once with `npm install -g pyright`. DocForge configures it to use the repository
@ -94,11 +97,11 @@ still owns hashes, permissions, changeset storage, conflict checks, graph valida
preview confinement. The adapter owns source-format rules and may only narrow the allowed proposal
surface.
Both generic and explicit adapter MCP servers expose the same visualization tool because it reads
the validated `ProjectIndex` supplied by the project binding. Invoking it again refreshes the
browser only after a complete index check. The unguessable loopback URL remains usable while its
browser page renews the lease. Explicit process termination closes it immediately; an abandoned
page expires after a bounded inactivity grace period.
Both generic and explicit adapter MCP servers expose the same visualization tools because they read
the validated `ProjectIndex` supplied by the project binding. `docforge_visualize` reuses its
unguessable loopback URL when the current snapshot remains valid, or replaces the worker after a
complete index check when it does not. The project-bound worker remains available until
`docforge_stop_visualization` explicitly stops it.
See [`docs/NEW_PROJECT_QUICKSTART.md`](docs/NEW_PROJECT_QUICKSTART.md) for a complete generic MCP
setup, continuous-agent policy, visualization instructions, and a project-adapter checklist.