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

Redesign graph nodes around semantic contributors

Browse source
This commit is contained in:
Andraxion 2026-07-25 18:12:26 -04:00
parent cb4353fe8c
commit 252033e30a
14 changed files with 447 additions and 137 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/CONTRACT.md
View file

@ -19,7 +19,7 @@ commit when Git is available; it cannot change repository state.
- Result envelope: `schemas/result.schema.json`, version 1.
- Changeset schema: `schemas/changeset.schema.json`, version 1.
- Index schema: version 1, disposable and reproducible.
- Core, CLI, and MCP server: version 0.14.0.
- Core, CLI, and MCP server: version 0.15.0.
Schema files describe the generic interchange contract. Runtime validation remains responsible for
path confinement, source hashing, relationship resolution, dependency cycles, project limits, stale
@ -105,7 +105,7 @@ Descriptor filtering accepts only
family, authority, status, or tag plus one exact value. There is no write endpoint, arbitrary query
endpoint, static filesystem handler, external asset, or project-selection control.
The `graph-browser@14` template provides mouse-wheel zoom centered on the pointer, left-button drag
The `graph-browser@15` template provides mouse-wheel zoom centered on the pointer, left-button drag
pan, explicit zoom-in and zoom-out buttons, a reset-view button, and a live zoom percentage. A
four-pixel drag threshold defers pointer capture and preserves node activation for ordinary clicks.
Loading another root node fits the viewport to the returned neighborhood, including a useful
@ -116,6 +116,12 @@ whenever a neighborhood is rendered. The page is fixed to the browser viewport.
filter results fill the left panel, neighborhood traversal fills the right panel, and only the
center SVG canvas pans or zooms.
Canvas nodes are semantic cards. The focus and relation-derived Structure, Behavior, Dependency,
Execution, Data, Evidence, Context, and Related categories have distinct rails and badges. Cards
display the readable leaf title and node kind. Long titles wrap instead of being clipped. The
complete qualified title and stable node identifier remain available in the SVG tooltip and node
inspectors. This display shortening is presentation-only and never changes indexed identity.
Left-clicking or pressing Enter on a graph node opens a compact descriptor card containing the
validated metadata and content previously shown in the details panel. Its family, authority,
status, and tag pills are buttons that replace the left result list with exact matching nodes.