Skip to content

Add snapshot graph API and cluster-first graph explorer UI#92

Merged
saurabhsharma2u merged 2 commits into
codex/add-interactive-structural-graph-pagefrom
codex/add-interactive-structural-graph-page-piyuia
Mar 4, 2026
Merged

Add snapshot graph API and cluster-first graph explorer UI#92
saurabhsharma2u merged 2 commits into
codex/add-interactive-structural-graph-pagefrom
codex/add-interactive-structural-graph-page-piyuia

Conversation

@saurabhsharma2u

Copy link
Copy Markdown
Contributor

Motivation

  • Provide a scalable, cluster-first graph projection for snapshots so the UI can visualize site structure at multiple levels without overwhelming the client.
  • Allow on-demand edge rendering and 1-hop neighbor queries to keep initial graph payloads small and interactive.

Description

  • Add server endpoints GET /api/graph/snapshot and GET /api/graph/neighbors that expose hierarchical node projections (sections → clusters → urls) and optional internal edges, with filtering options like level, minPageRank, minInlinks, minOutlinks, maxNodes, maxEdges, search, and includeEdges.
  • Introduce lightweight SnapshotGraphNode and SnapshotGraphEdge payload shapes on the server and client, and return metadata about truncation and counts.
  • Implement client-side API functions fetchSnapshotGraph and fetchGraphNeighbors and extend api.ts types to include SnapshotGraphResponse and query options.
  • Add a new GraphPage component implementing a cluster-first radial layout with progressive LOD (three zoom levels), heat rings, interaction-driven neighbor/edge fetch, canvas rendering, and controls for filtering and node selection.
  • Wire the new page into the router in App.tsx (route /graph).

Testing

  • Ran a TypeScript build to validate types across packages/server and packages/web which completed successfully (yarn build / npm run build).
  • Executed the web dev build and loaded the app locally to exercise the new /graph page and the new endpoints, confirming responses and canvas rendering (no automated unit tests were added for the new features).

Codex Task

@saurabhsharma2u
saurabhsharma2u changed the base branch from main to codex/add-interactive-structural-graph-page March 4, 2026 18:22
…/add-interactive-structural-graph-page-piyuia
@saurabhsharma2u
saurabhsharma2u merged commit dc875d6 into codex/add-interactive-structural-graph-page Mar 4, 2026
0 of 6 checks passed
@saurabhsharma2u
saurabhsharma2u deleted the codex/add-interactive-structural-graph-page-piyuia branch March 4, 2026 18:26
saurabhsharma2u added a commit that referenced this pull request Mar 4, 2026
…rver) (#90)

* feat(web): add high-performance snapshot structure graph page

* feat(graph): redesign explorer with cluster-first LOD model (#92)

* feat: implement internal page classification, fix thin content reporting, and optimize dashboard filtering

* fix: refine snapshot behavior, trap detection, and health scoring

* feat: blend core health score with plugin scores and cleanup redundant scoring logic

* fix: drop legacy type column from snapshots table in migration

* fix: isolate single page snapshots to only load metrics for the targeted page

* tired...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant