Package-Grenzen

Verantwortlichkeiten der Shared Packages.

Konkrete Verantwortlichkeiten der Shared Packages. Keine Überschneidungen ohne expliziten Vertrag.

Übersicht

Package	Repo (Ziel)	Enthält	Enthält nicht
`@addxion/neon`	addxion-neon	Tokens, Components, Manifest, Adapter	App-Logik, Auth, Chat-UI
`@addxion/auth`	addxion-ai/packages/auth	Schema, Permissions, Session, Avatars	Produkt-Tabellen
`@addxion/ai`	addxion-ai/packages/ai	OpenRouter, Streaming, Message-Typen	Shell, Scroll, Produkt-Prompts
`@addxion/behavior`	addxion-ai/packages/behavior	Scroll-Hooks, Haptics, Intent-Detection	React-Komponenten, DOM-Rendering
`@addxion/shell`	addxion-ai/packages/shell	PageHeader, ChatSurface, Gates, Command UI	Nav-Daten, LLM-Calls
`@addxion/xi`	addxion-ai/packages/xi	protocol, nav, runtime Subpaths	Design Tokens, Docs-Sidebar

`@addxion/neon`

Primärname für das Design System. @addxion/core bleibt interne Engine (Tokens, tw:, Manifest-Generierung), wenn nötig re-exportiert über @addxion/neon.

Export (Ziel)	Inhalt
`@addxion/neon/styles`	CSS, semantic tokens
`@addxion/neon/fonts/inter.css`	Self-hosted Inter (`@font-face`)
`@addxion/neon/components`	UI-Bausteine
`@addxion/neon/manifest`	AI-Manifest für Agents

Consumer setzen eigenes brand.css. Keine Markenwerte in addxion-neon.

`@addxion/auth`

SSOT für Identity. Alle Apps konsumieren dasselbe Schema.

"@addxion/auth": "file:../addxion-ai/packages/auth"

Nicht duplizieren: kein paralleles Better-Auth-Schema in Consumern.

`@addxion/ai`

SSOT für LLM-Anbindung. Liefert Stream-Chunks und Message-Format.

Im Package	Im Consumer
OpenRouter Client	System-Prompts (Theorie-Tutor, Dashboard)
Streaming Parser	Chat-DB (Süper-D1 vs. addxion.ai Neon)
Error Handling	RAG, Kontext-Injection

`@addxion/behavior`

Framework-agnostic Hooks für Interaktion. Entscheidet wann gescrollt wird, nicht wie es aussieht.

Hook / Modul	Verantwortung
`useFollowStream`	Follow-at-bottom während Streaming
`useProxyWheelScroll`	Wheel auf Shell-Rändern → Hauptinhalt scrollen (Desktop)
`useScrollIntent`	User-Intent erkennen (Scroll, Select, Keyboard)
`useHaptic`	Haptic Feedback (wo unterstützt)

Abhängigkeit: @addxion/ai liefert Chunks → @addxion/behavior entscheidet Scroll → @addxion/shell rendert.

Siehe Scroll Engineering.

`@addxion/shell`

Nutzer-Schnittstellen-Schicht: Layout, Chat, Command, Gates. Chat ist KI-Schnittstelle, kein Feature-Screen.

Siehe Package-Naming.

Komponente	Quelle (live)
`PageHeader`	`@addxion/shell` (extrahiert aus süper; Titel aus `manifest.ts`)
`ChatShell` / `ChatSurface`	`@addxion/shell`
`ClientAuthGate`, `OnboardingGate`	`@addxion/shell`
Command Palette	`@addxion/shell` + xi-nav in süper + addxion.ai

PageHeader: strukturell in Shell, inhaltlich pro App via manifest.ts. Keine lokalen Forks in Consumern. PageHeader — Cross-App-Sync.

Shell rendert Nav aus @addxion/xi/nav, definiert sie nicht selbst.

`@addxion/xi`

Ein Package, drei Subpath-Exports. Cross-App-Glue only.

Subpath	Verantwortung
`@addxion/xi/protocol`	Typen, Events, App-übergreifende Konventionen
`@addxion/xi/nav`	Manifest-Loader, Filter (Rolle, Grant), Command-Items
`@addxion/xi/runtime`	Port/Client → EvolutionCore (Evolutionskern); Stub bis 6.4

Jede App hat manifest.ts mit Sektionen, Rollen, Keywords. Siehe Manifests.

Konsum-Regel

Änderungen am Design System zuerst in addxion-neon, dann in Consumern. Auth, AI, Shell, Behavior und XI aus addxion-ai/packages/.

Einmal pflegen: Gleiche Logik nicht in mehreren Consumern implementieren — Shared Package erweitern. Siehe Einmal pflegen.

Status (Juli 2026)

Package	Status
`@addxion/neon`	Live (Meta-Package; Engine: `@addxion/core` intern)
`@addxion/auth`	Live (`app_registry` + `app_grant` erledigt)
`@addxion/ai`	Live
`@addxion/behavior`	Live (`useFollowStream`, `useProxyWheelScroll`, Shell-Anbindung)
`@addxion/shell`	Live (süper + addxion.ai konsumieren; Adapter next/tanstack vorhanden)
`@addxion/xi`	Live (`protocol`, `nav`; `runtime` Stub)

Ausführlicher Leitfaden: Package-Leitfaden.

Truths

ID	Wahrheit
T-PKG-BOUNDARY	Package-Grenzen nicht ohne Vertrag überschreiten
T-MAINTAIN	Einmal pflegen — keine Doppelpflege
T-TRUTHS-SSOT	Truths-Registry — referenzieren, nicht duplizieren

Für Agents

Scope: Konkrete Verantwortlichkeiten und Grenzen jedes Shared Package.

Keine Überschneidungen ohne expliziten Vertrag
Änderungen an Grenzen auch in packages-guide.md und roadmap.md
Consumer importieren Packages, duplizieren keine Logik — Einmal pflegen