[Slice 17] Read-only graph investigation controls and stable report navigation

[EmersonBraun]

Parent PRD

#99

What to build

Add the minimum investigation controls required to understand a large architecture map: node search, focus, neighborhood tracing, fit-to-view/zoom, legend, and stable links. Keep every interaction read-only and grounded in canonical entities and relations.

Type

AFK

Scope

• Add search for entity IDs, labels, paths, relation IDs and diagnostics.
• Add keyboard-accessible focus, clear selection, upstream/downstream neighborhood tracing and fit-to-view/zoom controls.
• Add a visible legend for node kinds, relation states and diagnostic markers.
• Persist selected lens, level, scope, entity/relation/finding selection in URL fragments.
• Keep the evidence panel synchronized with the selected graph item and triage item.
• Ensure interactions work offline from the generated artifact.

Non-goals

• Do not add free-form graph editing, runtime tracing or production impact claims.
• Do not add motion, export formats or a hosted viewer in this slice.
• Do not introduce a new UI framework or dependency for controls that native HTML/SVG can provide.

Acceptance criteria

• A user can find a node or finding without scanning the full graph.
• A selected node can show only its immediate upstream/downstream authored neighborhood and can return to the full scoped view.
• Fit-to-view and zoom work for both a small fixture and the agentskit-os report without requiring an internal horizontal scroll to understand the selected scope.
• Every interactive graph element is keyboard reachable, has a meaningful accessible name, and exposes selected/expanded state.
• URL fragments restore the same level, lens, scope and selected item after reopening the offline report.
• The legend explains all visual encodings and never uses color as the only signal.
• No interaction changes canonical snapshot/report data or writes to the repository.
• Playwright smoke tests cover search, selection, keyboard activation, tracing, URL restore and reset.
• Full typecheck, tests and build pass.

Verification

Run:

pnpm typecheck
pnpm test -- --run
pnpm build

Open the generated agentskit-os report in a browser and execute the Playwright smoke flow against the offline file.

Blocked by

• Blocked by [Slice 14] Deterministic hierarchical report view and bounded architecture map #126

User stories addressed

• User stories 64, 65, 66, 67, 68, 69 and 70

Definition of done

A maintainer can start from an attention item or search query, focus the relevant topology, inspect evidence and share a stable offline link without altering the repository.

[EmersonBraun]

Implemented the first investigation/navigation pass.

• Graph levels remain read-only and can be inspected without changing repository files.
• Lens, level, selection, search, status, severity, finding group, and finding page are encoded in the URL hash.
• Opening/copying a report URL restores the same view; Escape clears selection and / focuses finding search.
• Lenses now filter graph relations using the same diagnostic semantics as the findings panel.

[EmersonBraun]

Closed as implemented. The report/navigation slice is present in the current mainline implementation and was exercised against the large consumer artifact. Remaining human visual approval and broader enterprise validation are tracked separately under #130, #139, and #147.