Überblick

Stack

• TypeScript
• React 18
• Vite 6
• Vitest
• WebExtension API über webextension-polyfill

Wichtige Einstiegspunkte

• src/background/index.ts: zentrale Laufzeitlogik und Message-Handling
• src/content/index.ts: Extraktion von Seitentext aus offenen Tabs
• src/popup/main.tsx: kompaktes Browser-Popup
• src/options/main.tsx: Dashboard-Entrypoint
• src/ui/app.tsx: gesamte Dashboard-Oberfläche
• src/lib/: Pipeline, Provider, Storage, Queue und Bookmark-Helfer
• src/lib/bookmark-tree.ts, src/lib/bookmark-resolver.ts, src/lib/bookmark-roots.ts: Normalisierung, Root-Klassifikation und robuste Zielordner-Auflösung

Ziel des Projekts

Die Erweiterung soll Bookmark-Sortierung automatisieren, ohne blinde AI-Entscheidungen zu erzwingen. Unsichere Resultate werden bewusst in eine Review-Queue überführt.

Architektur in Kurzform

1. Browser-Events oder UI-Nachrichten lösen eine Verarbeitung aus.
2. Die Pipeline sammelt Bookmark-, Struktur- und Seitenkontext.
3. Ein Provider klassifiziert das Lesezeichen.
4. Die Entscheidung wird entweder direkt angewendet oder als Review gespeichert.
5. Dashboard und Popup lesen den Zustand über Runtime-Messages aus.