Add function-scoped Logic visualization
This commit is contained in:
parent
9fcafc290c
commit
9b4258c852
22 changed files with 1420 additions and 62 deletions
14
README.md
14
README.md
|
|
@ -15,7 +15,7 @@ declared manuals, visualizes project structure, and manages reviewable documenta
|
|||
equivalence checks.
|
||||
- Keeps function-scoped control-flow projections separate from the primary architecture graph.
|
||||
- Runs a managed loopback graph browser with neighborhood, semantic Flow, convergence Web,
|
||||
source inspection, and branch-aware node hiding.
|
||||
function-scoped Logic, source inspection, and branch-aware node hiding.
|
||||
- Supports generic documentation projects and project-owned source adapters.
|
||||
|
||||
DocForge never treats indexed text as instructions. It does not run shell commands, mutate Git,
|
||||
|
|
@ -35,7 +35,8 @@ implement the source manifest and extraction methods. Incremental adapters must
|
|||
|
||||
## Graph views
|
||||
|
||||
The browser presents the same indexed graph through three complementary views:
|
||||
The browser presents the primary architecture graph through three complementary views and loads a
|
||||
fourth function-scoped view only when requested:
|
||||
|
||||
- **Nodes** shows a bounded, relation-neutral neighborhood around the focus. It is the broad
|
||||
inspection view for seeing stored incoming and outgoing relationships without changing their
|
||||
|
|
@ -46,14 +47,19 @@ The browser presents the same indexed graph through three complementary views:
|
|||
inheritance, definitions, and tests flow toward the thing they help create or exercise.
|
||||
- **Web** shows the larger convergence picture: Flow contributors plus contextual relationships,
|
||||
callers, containers, and direct members or execution dependencies owned by the focus.
|
||||
- **Logic** shows the possible static control paths inside a focused Python function or method.
|
||||
Entry, decisions, actions, loops, merges, returns, and exceptions connect through explicit
|
||||
`TRUE`, `FALSE`, `NEXT`, `CASE`, `LOOP`, `RETURN`, and `RAISE` paths. Logic is stored separately
|
||||
and does not add statement-level noise to Nodes, Flow, Web, or search.
|
||||
|
||||
Graph cards show the node's readable leaf name and kind without clipping either value. The full
|
||||
qualified identity remains available in the tooltip, compact descriptor, and full inspector.
|
||||
|
||||
**Hide node** removes noise without changing the index. In Flow and Web, hiding a contributor also
|
||||
removes upstream ancestors that no longer have a path to the focus. Nodes between the hidden
|
||||
contributor and the focus stay visible, and alternate ancestor paths remain intact. **Restore
|
||||
hidden** restores the presentation.
|
||||
contributor and the focus stay visible, and alternate ancestor paths remain intact. In Logic,
|
||||
hiding a step inserts an explicit omitted-path bridge so downstream control flow remains readable.
|
||||
**Restore hidden** restores the presentation.
|
||||
|
||||
## Five-minute start
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue