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

Add semantic flow and convergence web views

Browse source
This commit is contained in:
Andraxion 2026-07-25 17:34:58 -04:00
parent f9f7105983
commit 6609edc804
14 changed files with 616 additions and 128 deletions
Download patch file Download diff file Expand all files Collapse all files

22
docs/USER_MANUAL.md
View file

@ -14,8 +14,9 @@ viewer processes are derived and can be rebuilt.
- Isolated, optimistic changesets with create, update, move, delete, validation, diffs, and previews.
- Hash-bound canonical application through both CLI and an explicitly enabled MCP tool.
- Declared HTML render views. Arbitrary templates, render commands, and output paths are rejected.
- A loopback-only graph browser with Nodes and Flow views, relationship keys, source inspection,
node hiding, panel resizing, zooming, and managed idle shutdown.
- A loopback-only graph browser with Nodes, semantic Flow, and convergence Web views,
relationship keys, source inspection, branch-aware node hiding, panel resizing, zooming, and
managed idle shutdown.
- A generic Markdown/TOML adapter plus contracts for deterministic project-owned adapters.
DocForge does not run shell commands from documentation, mutate Git, build an application, deploy,
@ -219,12 +220,21 @@ URL. Use `visualization-status` and `visualization-stop` to inspect or stop the
- Use **Hide node** to remove noisy non-focus nodes from the current presentation.
- Use **Restore hidden** above the graph to bring hidden nodes back.
- Use **Explore neighborhood** to make a node the new focus.
- Switch to **Flow** to inspect bounded directed ancestry.
- Switch to **Flow** to inspect relation-aware paths from origins and prerequisites into the
focus. Imports, dependencies, reads, inheritance, and `tested_by` relationships are reversed for
presentation so prerequisites point toward their consumers. Context-only documentation
relationships stay out of this focused view.
- Switch to **Web** to inspect the broader structural and dependency makeup of the focus. DocForge
follows callers, containers, imports, dependencies, evidence, and contextual contributors into
the focus. Direct focus-owned members and execution dependencies become adjacent contributor
branches. Traversal does not fan back out through unrelated siblings.
- Use the mouse wheel or viewport buttons to zoom. Drag the canvas to pan. Press Space to center
the selected node.
Hidden nodes are a browser presentation preference. They do not alter the index or canonical graph.
The focus node cannot be hidden; focus another node first.
The focus node cannot be hidden; focus another node first. In Flow and Web, hiding a node also
prunes ancestors whose only remaining route to the focus passed through that node. Descendants
between the hidden node and the focus remain visible, as do ancestors with another valid route.
Source navigation depends on adapter evidence. Numeric anchors, line-style anchors such as `L120`,
TOML `node-N` anchors, heading slugs, and searchable text anchors are recognized. If a custom
@ -461,8 +471,8 @@ ambiguous adapter evidence.
### Full inspector content does not fit
DocForge 0.13 uses a fixed header and footer with a scrollable inspector body. If an older page is
still open, stop and reopen the visualization so it loads the current `graph-browser@12` template.
DocForge 0.14 uses a fixed header and footer with a scrollable inspector body. If an older page is
still open, stop and reopen the visualization so it loads the current `graph-browser@14` template.
### Render output is stale