Graph-first landing replaces catalog home

Platform spec ADR

Graph-first landing replaces catalog home

Back to Beskid Nexus ◎ Open feature in platform map

Spec standingStandard

Owner

Piotr Mikstacki pmikstacki@cybernomad.it

Submitter

Piotr Mikstacki pmikstacki@cybernomad.it

Current document

Articles

• Contracts and edge cases Nexus REST API contracts, CodeDocRecord rules, spec link validation, auth/me ownedRepoIds, and MCP Bearer requirements. article Standard Reviewed Sat May 30
• Design model Graph-first landing, navbar shell, global registry, code-doc vs platform-spec separation, and MCP connect surface. article Standard Reviewed Sat May 30

History

0 revisions (git unavailable at build; counts may be empty)

Open full history on GitHub

No commits recorded for this path.

Completeness

OKarea · 4 SpecSection(s) · 0 H2 heading(s)

Section id	Required	Found
what-this-feature-specifies	yes	yes
implementation-anchors	yes	yes

Full tree: run pnpm verify:platform-spec-layout (writes src/generated/platform-spec-layout-report.json).

Related spec docs

• Feature
  Beskid Nexus

  Parent feature hub

Context

GitNexus shipped a CatalogHome grid, DropZone local analyze, onboarding phases, and server-connect wizards. Beskid Nexus is a hosted public explorer for pre-indexed repos — visitors arrive to browse graphs, not to analyze local folders or configure LLM providers.

Decision

1. / must load the graph explorer, selecting the first enabled catalog entry with indexed: true ordered by sortOrder.
2. Deep link ?repo=<catalog-id> selects an explicit entry when present.
3. CatalogHome, DropZone, QueryFAB, Graph RAG chat, and hosted OnboardingGuide are removed from public UI.
4. Repo switching happens via navbar <Select>, not a separate home phase.
5. When no indexed repo exists, show empty state + sign-in CTA for repo owners — not a marketing catalog grid.

Admin actions (add repo, re-index) must be overlays (dialog/sheet), not full-page route phases.

Consequences

• gitnexus-web App phases reduce to boot | setup | server-down | explorer.
• E2E tests target graph canvas visibility and repo selector — not onboarding wizards.
• Cached LadybugDB exports remain the only graph source for public visitors.

Status

Accepted — supersedes GitNexus CatalogHome as the default Nexus entry experience.