Chrome Extension

# Chrome-Extension "Bewerbung erstellen" — Kurzbrief für Coding-Agents

WAS: Manifest-V3-Browser-Extension im Ordner extension/ (WXT + React 19 + Tailwind v4).
Eigenes Build-Artefakt, KEIN Teil des Next-Builds. Die Web-App (Next 16, Supabase-Auth)
ist Backend + Auth-Provider.

LOKAL STARTEN:
1) Web-App läuft über den Conductor "Run"-Tab (Dev). Port aus "Open :PORT" ablesen
   — pro Worktree ein eigener Port (z. B. 55150). NICHT 3001 annehmen.
2) cd extension && npm run dev  → baut nach extension/.output/chrome-mv3-dev + HMR
   (öffnet KEIN eigenes Browserfenster, webExt.disabled=true).
3) In Arc/Chrome: Erweiterungen → "Entpackte Erweiterung laden" → Ordner
   extension/.output/chrome-mv3-dev wählen. .output ist versteckt → im Dateidialog
   Cmd+Shift+G und den absoluten Pfad einfügen.

API-BASIS-URL (port-robust):
- Wird zur Laufzeit aus dem /connect-Handshake (window.location.origin) gelernt und in
  chrome.storage gespeichert (lib/session.ts → apiBase). Danach ist der Port egal.
- Erst-Verbindung / Popup-Button nutzt extension/.env.development:
  WXT_API_BASE=http://localhost:<conductor-port>  (nur Dev; Prod → Live-URL).

WICHTIGE DATEIEN:
- extension/entrypoints/background.ts        Service-Worker (Session speichern)
- extension/entrypoints/connect.content.ts   Bridge auf /connect (Session + origin lernen)
- extension/entrypoints/autofill.content.ts  Formular-Autofill (Greenhouse/Lever)
- extension/entrypoints/popup/App.tsx        4-Tab-Popup
- extension/lib/{config,session,api}.ts      API-Base, Session, API-Client
- src/app/(app)/connect/                      "Verbinden"-Seite (Web-App)
- src/app/api/extension/{session,autofill}/   Bearer-validierte Endpunkte + CORS

UNTERSTÜTZTE ATS (Auto-fill aktiv): *.greenhouse.io, jobs.lever.co.
Weitere Systeme + Status: src/data/ats-providers.ts (Matrix unten auf dieser Seite).

OFFENE TODOS: echte Profildaten in /api/extension/autofill (aktuell nur E-Mail),
Token-Refresh statt Reconnect bei 401, Handshake-Härtung (One-Time-Code),
weitere ATS/DACH-Portale (Personio, Workday, SuccessFactors ...).

Extension bauen & im Browser laden

Manifest-V3-Extension, lokal „unpacked“ geladen (Arc/Chrome) – kein Store nötig.

1. 1. Web-App starten. Conductor „Run“-Tab → Dev. Den Port aus „Open :PORT“ merken (dieser Worktree: 55150).
2. 2. Extension bauen. Im Terminal: cd extension && npm run dev – baut nach .output/chrome-mv3-dev und lädt bei Änderungen automatisch neu (HMR). Öffnet kein eigenes Fenster.
3. 3. Erweiterungen-Seite öffnen. In Arc/Chrome die Extensions-Verwaltung öffnen → „Entpackte Erweiterung laden“ (oben links). In Arc ist der Entwicklermodus schon aktiv – kein Extra-Toggle.
4. 4. Ordner wählen – der Trick. Der Zielordner .output beginnt mit einem Punkt und ist im Dateidialog versteckt. Drücke deshalb Cmd + Shift + G, füge den Pfad unten ein, Enter → „Auswählen“.
5. 5. Anpinnen & verbinden. Puzzle-Icon → Pin. Popup → „Mit Konto verbinden“ → einloggen → „Verbunden“.

Alternative statt Cmd+Shift+G: im Dialog Cmd + Shift + . blendet versteckte Ordner ein → dann extension → .output → chrome-mv3-dev.

In einem anderen Workspace (Conductor-Worktree)

Die geladene Extension lädt den Code immer aus dem Ordner …/[workspace]/extension/.output/chrome-mv3-dev und „gehört“ damit zu einem Worktree. Jeder Worktree hat einen eigenen Dev-Port.

• Nur gegen einen anderen Port verbinden (gleicher Code): Öffne localhost:[port]/connect dieses Workspaces. Das Connect-Script matcht jeden localhost-Port → die Extension lernt die URL selbst. Kein Neu-Laden nötig.
• Geänderten Extension-Code testen: Im anderen Worktree npm run dev, dann dessen .output/chrome-mv3-dev laden. Das ist ein eigener Eintrag → am besten den alten vorher „Entfernen“ (sonst füllen zwei Extensions gleichzeitig).
• Verbinden-Button korrigieren: Der „Mit Konto verbinden“-Button nutzt den Port aus extension/.env.development (WXT_API_BASE). Für einen anderen Worktree dort den neuen Port eintragen und neu bauen.

Achtung: Wird ein Worktree in Conductor gelöscht, verschwindet sein Ordner → die daraus geladene Extension bricht weg. Erst ein Chrome-Web-Store-Build ist davon unabhängig.