Port: graph page from playground

forgejo_admin commented

2026-03-27 21:14:52 +00:00

Owner

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

forgejo_admin referenced this issue

2026-03-27 21:29:34 +00:00

feat: replace app.css with playground design system + sidebar layout #75

forgejo_admin referenced this issue from a commit

2026-03-27 21:40:28 +00:00

feat: port graph page from playground with force-directed SVG layout

forgejo_admin referenced this issue from a pull request that will close it,

2026-03-27 21:40:59 +00:00

feat: port graph page from playground #78

forgejo_admin closed this issue

2026-03-27 21:55:06 +00:00

forgejo_admin commented

2026-03-27 21:56:29 +00:00

Author

Owner

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).

forgejo_admin commented

2026-03-27 22:06:11 +00:00

Author

Owner

Issue body updated per scope review corrections.

forgejo_admin reopened this issue

2026-03-27 22:09:13 +00:00

forgejo_admin referenced this issue from a commit

2026-03-28 05:06:20 +00:00

feat: wire note-links API into graph page for cross-reference edges

forgejo_admin referenced this issue from a pull request that will close it,

2026-03-28 05:06:59 +00:00