Shell-Architektur

Drei Schnittstellen in einer Shell

PageHeader + Gates     →  App-Schnittstelle
Command Palette        →  Nav/Aktions-Schnittstelle (xi-nav)
Chat Surface           →  KI-Schnittstelle (@addxion/ai)

Persistente Shell um wechselnden Seiteninhalt. Der Nutzer verlässt die Shell nie, nur der Inhalt darin wechselt.

Schichtenmodell im Chat

@addxion/ai        → Stream-Chunks (unter der Chat-Shell)
@addxion/behavior  → Scroll-Intent, Follow-Stream
@addxion/shell     → Chat Surface, DOM, Layout
@addxion/neon      → Tokens, Button, Input

PageHeader

Eine Komponente in @addxion/shell, konsumiert von süper und addxion.ai. Strukturell identisch, inhaltlich getrennt über manifest.ts pro App.

manifest.ts → resolveSection → PageHeader(title)

• Tab-Seiten: nur Titel, kein Untertitel
• mb-3 am Header
• Titel aus xi-nav resolveSection — nie im Consumer hardcoden
• Strukturelle Änderungen nur in addxion-ai/packages/shell, nicht in Consumer-Repos

Details, Sync-Regeln und Drift-Audit: PageHeader — Cross-App-Sync.

Command Palette in Docs

In addxion-docs bindet Shell eine Palette ein, die zwei Quellen mergen kann:

1. Content-Index (Starlight, live): Docs-Seiten suchen
2. xi-nav (federated) (optional, offen): Produkt-Routen (süper, addxion.ai)

Starlight-Sidebar bleibt Content-SSOT. Siehe Navigation.

Package-Home

addxion-ai/packages/shell — extrahiert aus süper (Referenz-Implementierung).

Export-Bereich	Inhalt
Layout	PageHeader, PageSkeleton, SiteFooter
Chat	ChatSurface, ChatShell, JumpToLatest
Command	CommandPalette
Gates	ClientAuthGate, OnboardingGate
Nav-UI	BottomNav
Adapter	adapters/next, adapters/tanstack

Extraktions-Phasen (erledigt)

Phase	Inhalt	Status
shell-0	Package-Skeleton + exports	erledigt
shell-1	PageHeader	erledigt
shell-2	ChatSurface + CommandPalette + ChatShell	erledigt
shell-3	Gates (Auth, Onboarding)	erledigt
shell-4	BottomNav, SiteFooter, PageSkeleton	erledigt
shell-3.7	süper konsumiert @addxion/shell	erledigt
shell-3.8	addxion.ai konsumiert @addxion/shell	erledigt

Framework-Adapter (adapters/next, adapters/tanstack) existieren; nicht alle Consumer-Routen nutzen sie noch einheitlich.

Behavior-Anbindung (Phase 4)

@addxion/shell Chat-Komponenten binden @addxion/behavior (useFollowStream) für Scroll während Streaming. Siehe Scroll Engineering.

Outline-Layout

Sidebar/Header trennen über shared 1px-Edges (kein Gap zwischen Spalten, strukturell eckig). Technik und Designregeln: Bordered Grid.

Truths

ID	Wahrheit
T-PKG-SHELL	Shell = UI-Schicht, nicht bash/zsh
T-PKG-BEHAVIOR	Scroll-Entscheidungen in behavior, kein DOM
T-PKG-AI	LLM-SSOT in @addxion/ai
T-NAV-MANIFEST	Nav aus manifest.ts + xi/nav
T-UI-BORDERED	Trennung über geteilte 1px-Linien, nicht Schatten/Doppelborders

Für Agents

Scope: Drei Schnittstellen in einer Shell und Extraktions-Status.

• PageHeader, Chat, Command Palette, Gates — Verantwortlichkeiten nicht vermischen
• Framework-Adapter (adapters/next, adapters/tanstack) einheitlich nutzen
• Details PageHeader: PageHeader — Cross-App-Sync
• Outline-Layout: Bordered Grid