Port: graph page from playground #74

Closed
opened 2026-03-27 21:14:52 +00:00 by forgejo_admin · 2 comments
Contributor

Type

Feature

Lineage

Depends on #68 (CSS + sidebar foundation). Part of SvelteKit port pipeline.

Repo

forgejo_admin/pal-e-app

User Story

As a user, I want a knowledge graph visualization showing note relationships, so I can explore connections between documents.

Context

Port ~/pal-e-docs-playground/graph.html to the existing /graph route. The route already exists at src/routes/graph/+page.svelte. Data fetching uses client-side onMount, not SvelteKit load functions. The existing +page.ts in this route is SSR config only (ssr = false), not a data fetcher.

Verify: The graph requires a note-links REST endpoint to fetch relationships. No note-links/noteLinks/note_links reference was found in the current pal-e-app source — confirm the pal-e-api endpoint exists and wire the API client before restyling.

Scope note: Sidebar navigation link to /graph may need to be added or verified as part of this ticket.

File Targets

  • src/routes/graph/+page.svelte — restyle existing graph page to match playground graph.html

Acceptance Criteria

  • Graph page layout matches playground graph.html
  • SVG graph renders with note nodes and edges
  • Nodes are clickable (navigate to note detail)
  • Note-links API endpoint verified and wired
  • Sidebar nav includes graph link
  • App builds without errors

Test Expectations

  • Run command: cd ~/pal-e-app && npm run build

Constraints

  • Copy playground HTML literally, swap data bindings.
  • Depends on #68 being merged first.

Checklist

  • Graph restyled
  • Note-links API wired
  • Sidebar link verified
  • Build passes
  • forgejo_admin/pal-e-app#68 — foundation (dependency)
  • board-pal-e-docs — project board
### Type Feature ### Lineage Depends on #68 (CSS + sidebar foundation). Part of SvelteKit port pipeline. ### Repo `forgejo_admin/pal-e-app` ### User Story As a user, I want a knowledge graph visualization showing note relationships, so I can explore connections between documents. ### Context Port `~/pal-e-docs-playground/graph.html` to the existing `/graph` route. The route already exists at `src/routes/graph/+page.svelte`. Data fetching uses client-side `onMount`, not SvelteKit load functions. The existing `+page.ts` in this route is SSR config only (`ssr = false`), not a data fetcher. **Verify:** The graph requires a note-links REST endpoint to fetch relationships. No `note-links`/`noteLinks`/`note_links` reference was found in the current pal-e-app source — confirm the pal-e-api endpoint exists and wire the API client before restyling. **Scope note:** Sidebar navigation link to `/graph` may need to be added or verified as part of this ticket. ### File Targets - `src/routes/graph/+page.svelte` — restyle existing graph page to match playground graph.html ### Acceptance Criteria - [ ] Graph page layout matches playground graph.html - [ ] SVG graph renders with note nodes and edges - [ ] Nodes are clickable (navigate to note detail) - [ ] Note-links API endpoint verified and wired - [ ] Sidebar nav includes graph link - [ ] App builds without errors ### Test Expectations - Run command: `cd ~/pal-e-app && npm run build` ### Constraints - Copy playground HTML literally, swap data bindings. - Depends on #68 being merged first. ### Checklist - [ ] Graph restyled - [ ] Note-links API wired - [ ] Sidebar link verified - [ ] Build passes ### Related - `forgejo_admin/pal-e-app#68` — foundation (dependency) - `board-pal-e-docs` — project board
Author
Contributor

Scope Review: NEEDS_REFINEMENT

Review note: review-476-2026-03-27

Four issues found:

  • src/routes/graph/+page.ts does not exist and doesn't fit app pattern — no +page.ts files anywhere. Remove from file targets.
  • "Note links API" — need to verify REST endpoint exists in pal-e-api (MCP has get_note_links, but agent needs a REST route).
  • Sidebar nav link for /graph not mentioned — needs scope or discovered-scope issue.
  • Force-directed layout JS from playground may need Svelte adaptation (not pure copy-paste).
## Scope Review: NEEDS_REFINEMENT Review note: `review-476-2026-03-27` Four issues found: - `src/routes/graph/+page.ts` does not exist and doesn't fit app pattern — no `+page.ts` files anywhere. Remove from file targets. - "Note links API" — need to verify REST endpoint exists in pal-e-api (MCP has `get_note_links`, but agent needs a REST route). - Sidebar nav link for `/graph` not mentioned — needs scope or discovered-scope issue. - Force-directed layout JS from playground may need Svelte adaptation (not pure copy-paste).
Author
Contributor

Issue body updated per scope review corrections.

Issue body updated per scope review corrections.
Commenting is not possible because the repository is archived.
No milestone
No project
No assignees
1 participant
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ldraney/pal-e-app#74
No description provided.