onadit 0.0.0-stage → 0.1.0-beta.45

package/README.dev.md

@@ -0,0 +1,124 @@
+# Onadit (`onadit`)
+
+Local-first personal memory + reasoning infrastructure. Captures local CLI sessions, web conversation exports, and project documents; routes them through triage, metadata extraction, and embedding; persists into LanceDB; exposes retrieval through a small MCP surface so agents can pull *capability, not payload*.
+
+Designed to feel like a built-in capability for whatever assistant is in front of it, not like a giant preloaded briefing.
+
+---
+
+## Architecture at a glance
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  Live capture (claude_code, codex_cli session JSONLs)   │
+│  Web exports (chatgpt_web, claude_web, gemini, grok)    │
+│  Project docs (filesystem watchers / scheduled scans)   │
+└────────────────────┬────────────────────────────────────┘
+                     │
+                ┌────▼────┐
+                │ Triage  │   ← Codex CLI (default)
+                │  loop   │
+                └────┬────┘
+                     │ save / review / discard
+                     │
+                ┌────▼─────────────┐
+                │ Metadata extract │   ← Codex CLI (web/ingest path)
+                │  (POST /ingest)  │
+                └────┬─────────────┘
+                     │
+                ┌────▼──────────────────────────────────┐
+                │ Voyage AI embedding (voyage-3-lite)   │
+                └────┬──────────────────────────────────┘
+                     │
+                ┌────▼─────────────────────────────────┐
+                │ LanceDB                              │
+                │   conversations_hot / cold           │
+                │   structured_docs                    │
+                │   digests   ← Codex CLI digest job   │
+                └────┬─────────────────────────────────┘
+                     │
+                ┌────▼──────────────────────────┐
+                │ MCP server (life_*)           │
+                │ HTTP daemon on 127.0.0.1:3577 │
+                └───────────────────────────────┘
+```
+
+## Models & runtimes in use
+
+| Stage | Runtime | Model |
+|---|---|---|
+| Triage (decide save/review/discard) | local `codex` CLI | CLI default |
+| Metadata extraction (web/ingest path) | local `codex` CLI | CLI default |
+| Digest summarization (compact job) | local `codex` CLI | CLI default |
+| Embeddings | Voyage AI (cloud) | `voyage-3-lite` |
+| Local-LLM override (optional) | Ollama at `localhost:11434` | configurable (`metadata_model`, `digest_model`) |
+
+**Cloud mode (default)** — set `local_generation.enabled: false` in `config.json`. All LLM calls go through the operator's already-authenticated `codex` CLI. No Anthropic / OpenAI API key required.
+
+**Local-LLM override** — set `local_generation.enabled: true`. Metadata + digest go through the configured Ollama models. Triage still uses Codex CLI.
+
+The two modes are mutually exclusive — exactly one runtime owns LLM calls at a time.
+
+## CLI vs API surface
+
+**Local-only (no network)**:
+- `codex` CLI subprocess (every triage / metadata / digest call).
+- Filesystem watchers for project sources.
+- LanceDB on disk under `data/lancedb/`.
+- Daemon HTTP listens on `127.0.0.1:3577` (loopback only).
+- MCP server speaks JSON-RPC over stdio.
+
+**Network**:
+- Voyage embedding API (`api.voyageai.com`) — only consumer.
+
+**Provider classes preserved but not in the live default path** (kept for explicit batch/historical use): `OpenAITriageProvider`, `OpenAIMetadataExtractor`, `AnthropicDigestSummarizer`, `CliMetadataExtractor` (legacy Claude CLI subprocess).
+
+## Main commands
+
+```bash
+# Live capture (Claude Code + Codex CLI session files)
+onadit capture                       # both sources
+onadit capture --source codex_cli    # one source
+onadit capture --dry-run             # preflight + triage, no saves
+
+# Status + telemetry
+onadit status                        # daemon briefing + auto-capture summary
+onadit stats                         # table counts, source coverage
+
+# Search
+onadit search "..."
+
+# Daemon (managed by launchd)
+launchctl kickstart -k gui/$UID/com.rift.daemon
+launchctl print gui/$UID/com.rift.daemon
+```
+
+The macOS menu bar (SwiftBar plugin at `operator/swiftbar/rift.10s.sh`) answers "Is Onadit working?": a verdict, one line with the last capture and today's recalls, and Open Onadit. Other rows appear only when they need action (an update, a fix). It hides SwiftBar's own items; Option-click shows them.
+
+## Onadit.app (macOS)
+
+`macos/Rift` is the native setup and status window, in SwiftUI. It holds no engine code. It talks to the daemon above with a scoped setup session that it gets from `onadit setup --app-session` over a pipe. It reads progress from `GET /setup/state`, recalls per day from `GET /setup/activity?days=N` and conversations per source from `GET /setup/memory`. All three need the session token.
+
+Privacy → "Search by Meaning…" calls `POST /setup/search-by-meaning` (session token), after the user agrees to send chat text to Voyage. The engine asks the relay Worker (`operator/relay-worker`, `POST /v1/voyage-key`) for a MongoDB Atlas model key that Onadit pays for, sending only a random install ID kept in `search-key.json` beside the config. It checks the key with a one-line embedding of Onadit's 512-dimension size, writes `embedding.base_url` (and `model`, `output_dimension` when the relay sets them) to config.json, then `VOYAGE_API_KEY` to `~/.rift.env`, and restarts itself (SIGTERM; launchd's KeepAlive starts it again). On that boot it queues one `reindex` job (`scope: all`) so rows saved in keyword-only mode get real vectors. `RIFT_KEY_RELAY_URL` points the engine at another relay for tests
+
+The Connect step's "Start each session with your context" block calls `POST /setup/session-hooks` (`{client, enabled}`, session token) to install or remove the session-start hooks for Claude Code and Codex. `/setup/state` reports each tool's `session_hooks`: `off`, `on`, or `needs_review` while Codex waits for the person's `/hooks` review, which Onadit reads from Codex's `config.toml` and never writes
+
+- Build the app: `bash scripts/build-app.sh` → `build/app/Onadit.app`. Set `RIFT_CODESIGN_IDENTITY` for a Developer ID signature; without it the app is ad-hoc signed
+- Test the Swift core: `cd macos/Rift && swift test`
+- Installer: `scripts/build-installer.sh` builds the app and ships it in the `.pkg`. Postinstall moves it to `~/Applications/Onadit.app` and opens it
+- `onadit setup` opens or focuses Onadit.app, and the menu bar's "Open Onadit…" uses it. `onadit setup --browser` opens the older browser page
+- Against another engine (tests, development): `RIFT_APP_NODE`, `RIFT_APP_CLI`, `RIFT_APP_CONFIG`, `RIFT_APP_HOME`, `RIFT_APP_LAUNCHD_LABEL=none` and `RIFT_APP_DEFAULTS_SUITE`. `RIFT_APP_TEST_DIR` turns on the test hooks in `TestHooks.swift`. The installer sets none of these
+
+## Pointers
+
+- [`TODO.md`](./TODO.md) — current/next/later tracker (updated end of every session).
+- [`PROJECT_STATE.md`](./PROJECT_STATE.md) — what's currently in flight.
+- [`CLAUDE.md`](./CLAUDE.md) — instructions for AI agents working in this repo.
+- [`docs/`](./docs/) — design docs (current system, API/MCP spec, capture contract, intelligence direction, etc.).
+
+## Conventions
+
+- TypeScript strict; `pnpm check` (or `npm run check`) before ship.
+- Vitest. Pretest generates fixtures.
+- Local-first, file-native storage under `data/`, `jobs/`, `reports/`.
+- Auto-capture triage depends on a working, authenticated `codex` CLI. Preflight failures here mean CLI auth/install/runtime issues (`codex login`, CLI upgrade/reinstall, or launchd PATH), not a missing `rift.openai` Keychain secret — that path was retired.

package/README.md

@@ -1,3 +1,195 @@
-# Temporary Holding Version
+# Onadit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Mémoire personnelle locale pour tes IA.**
+
+Onadit capture en local tes sessions Claude Code et Codex CLI, les triage, les indexe, et expose une mémoire interrogeable via MCP — pour que Claude Desktop, Claude Code, Codex et Cursor retrouvent ce que tu leur as déjà dit.
+
+Tout reste sur ta machine, sauf les *embeddings* (envoyés à Voyage AI sous une clé qui t'appartient).
+
+---
+
+## À lire avant d'installer
+
+> **La capture démarre maintenant.**
+> Au premier lancement, Onadit pose un *watermark* sur tes sessions Claude Code et Codex CLI existantes : **elles ne sont pas réingérées rétroactivement**. Seules les sessions à partir de l'installation comptent.
+>
+> Si tu veux que ton corpus passé soit *aussi* indexé (sessions Claude Code locales antérieures + exports `.zip` claude.ai / chatgpt.com / gemini.google.com / grok.com), c'est une **prestation séparée** — voir [Backfill historique (payant)](#backfill-historique-payant) plus bas.
+
+---
+
+## Prérequis
+
+À avoir sur ton Mac avant l'install :
+
+| | Quoi | Comment |
+|---|---|---|
+| 1 | **macOS 12.3+** | Pomme → "À propos de ce Mac" |
+| 2 | **Node.js 20.19+** | `node --version` dans Ghostty. Si manquant : [nodejs.org](https://nodejs.org/en/download) (LTS) |
+| 3 | **Codex CLI authentifié** *(worker de triage par défaut)* | `codex --version`, puis `codex login` si tu n'as jamais loggé. *Alternative : Claude Code — voir la note sous le tableau.* |
+| 4 | **Une clé Voyage AI** | Je te l'envoie en DM (c'est un projet dédié sur mon compte Voyage). Range-la dans 1Password, on la collera pendant l'onboard |
+| 5 | **SwiftBar** | Optionnel mais recommandé pour voir l'état Onadit dans la barre de menu. Le script installe le plugin Onadit automatiquement ; si l'app manque, ouvre [swiftbar.app](https://swiftbar.app) puis relance `onadit menubar install`. |
+
+Codex CLI fait tourner le triage (par défaut) et l'extraction de métadonnées — pas besoin de clé OpenAI séparée. Deux capacités peuvent basculer sur **Claude Code** (`claude`) au lieu de Codex, chacune via son propre réglage (même principe : ça utilise ton propre abonnement, Onadit ne stocke aucune clé API) :
+- **Triage** : `capture.triage.provider = claude_code`.
+- **Métadonnées** : `enrichment.metadata.provider = claude_code` (`onadit onboard --enable-claude-enrichment`). À noter : les **digests/compaction restent off** avec les métadonnées Claude (pas encore de worker digest Claude, et Onadit n'emprunte pas Codex en douce) — passe sur Codex ou Ollama pour les réactiver.
+
+La clé Voyage sert *uniquement* aux embeddings.
+
+## Installation (1 commande)
+
+Dans Ghostty, tape :
+
+```sh
+curl -fsSL https://onadit.com/install | bash
+```
+
+Ce que fait le script :
+
+- vérifie les prérequis ;
+- installe le paquet npm `onadit@beta` globalement ;
+- crée tes dossiers de données sous `~/Library/Application Support/Rift/` ;
+- pose un agent launchd qui lance Onadit à chaque session ;
+- installe le plugin Onadit pour SwiftBar (menu bar) quand possible ;
+- attend que le daemon réponde sur le port local.
+
+**Si on te demande ton mot de passe Mac (`Password:`)**, c'est normal — il faut écrire dans un dossier système pour rendre la commande `onadit` disponible partout. Tape ton mot de passe (rien ne s'affiche pendant la frappe — c'est normal sur Unix), `Entrée`.
+
+Si ça plante en cours de route, le script restaure ton état précédent et imprime un identifiant de backup. Tu peux me l'envoyer.
+
+## Premier paramétrage
+
+```sh
+onadit onboard
+```
+
+Le parcours par défaut comporte trois étapes :
+
+1. Ajouter un export de conversations, ou retrouver les données déjà présentes
+2. Chercher un sujet que tu as réellement abordé et lire les extraits
+3. Choisir Claude Desktop, Claude Code, Codex ou Cursor pour enregistrer la connexion
+
+Aucune clé API, option cloud ou inscription n’est demandée. Tu peux aussi lancer le parcours sans interaction avec `onadit onboard --yes --import-export ~/Downloads/export.json --query "mon sujet" --client codex`. La source est détectée quand c’est possible. `--source claude_web` permet de la préciser. Gemini nécessite un JSON de conversations converti, les archives Takeout brutes ne sont pas prises en charge.
+
+### Réglages avancés
+
+Avec `onadit onboard --advanced`, tu retrouves les réglages facultatifs. L'ordre réel du wizard avancé reste le suivant :
+
+1. **La clé Voyage que je t'ai envoyée.** L'assistant rappelle à quoi elle sert avant de la demander. Colle-la depuis 1Password — elle ne s'affiche pas pendant la frappe.
+2. **Validation.** Onadit fait un embed test pour vérifier la clé, la stocke localement, puis redémarre le service.
+3. **Vérifie que le worker de triage est authentifié** (Codex par défaut ; Claude Code si tu as mis `capture.triage.provider = claude_code`). Si ça échoue, lance `codex login` (ou connecte `claude` selon le worker) et relance `onadit onboard`. Ou demande à Claude.
+4. **Sessions détectées.** Onadit compte tes sessions Claude Code et Codex CLI existantes.
+5. **Feedback.** Par défaut, les notes restent dans un fichier local JSONL ; le relais n'est activé que via un flag opérateur.
+6. **Garde-fou Claude Code (optionnel).** Si Claude Code est détecté, l'assistant te propose d'installer un *PreToolUse hook* qui force la récupération Onadit à commencer par `onadit_context_pack` (compact, budgété) avant tout `onadit_search`. Évite que l'agent crame ton contexte avec des recherches larges. **Réponds `y`** si tu utilises Claude Code. Désactivable à tout moment via `RIFT_POLICY_DISABLED=1` ou en supprimant l'entrée de `~/.claude/settings.json`.
+7. **Première passe de capture.** Watermarke tes sessions existantes (ne les ingère pas).
+8. **Import optionnel.** L'assistant te propose de déposer un export ChatGPT à importer maintenant (ou `skip`). Tu peux importer ton historique sans clé API.
+
+
+### Brancher Onadit à tes apps (MCP)
+
+Tu peux connecter un autre outil à tout moment, ou reprendre la connexion si tu l’as passée pendant l’onboarding :
+
+```sh
+onadit mcp install --client=claude-desktop
+```
+
+Clients supportés (`--client <id>`) :
+
+- `claude-desktop` — l'app Claude pour Mac
+- `claude-code` — l'outil Claude Code en terminal
+- `cursor` — l'éditeur Cursor
+- `codex` — l'outil Codex en terminal
+
+Pour tout brancher d'un coup : `onadit mcp install --all`. Il faut passer `--client <id>` ou `--all` — sans l'un des deux, la commande s'arrête.
+
+> Pour Claude Code et Codex, la connexion te propose en plus les hooks de début de session : une courte note Onadit sur le projet à chaque nouvelle session (elle part chez le fournisseur d'IA de l'outil avec le reste de la session), et la consigne d'interroger Onadit avant une tâche. Rien n'est posé sans ton accord : réponds `y` à la question, passe `--with-hooks`, ou lance plus tard `onadit hooks install --client <id>`. `--no-hooks` saute la question. Dans l'app Onadit, la même offre est sous la liste des outils (« Turn On »).
+>
+> Pour Codex, il reste une étape que Onadit ne peut pas faire à ta place : ouvre Codex et lance `/hooks` une fois pour valider les deux entrées Onadit (elles sont dans `~/.codex/hooks.json`). Codex les ignore tant que tu ne l'as pas fait.
+>
+> Pour les retirer : `onadit hooks remove --client <id>`. `onadit uninstall` les retire aussi.
+
+## Vérifier que ça tourne
+
+```sh
+onadit status
+```
+
+Tu dois voir une sortie qui ressemble à ça (en anglais — le binaire est anglophone) :
+
+```
+Onadit v0.1.0-beta.2  ·  daemon: running (uptime 5m)  ·  port 3577 ✓
+Voyage:      key valid (last 4 …xxxx, last embed 2m ago)
+Codex CLI:   authed ✓
+Capture:     working — last run 8m ago: 3 saved
+MCP:         claude-desktop ✓  ·  codex ✓  ·  claude-code ✓  ·  cursor ✓
+Feedback:    relay off (local JSONL only)
+
+Next:        nothing broken. Try onadit search "<topic>".
+```
+
+Les ✓ partout = tout va bien. Si une ligne montre ✗ ou un *Next:* différent de "nothing broken", suis l'instruction qu'il imprime. La ligne *Capture:* commence par son état : `working` (ça tourne, même s'il n'y a rien de nouveau), `off` (désactivée, avec la commande pour l'activer) ou `failed` (avec la cause).
+
+> La ligne `MCP:` reflète les clients que **tu** as branchés avec `onadit mcp install` — l'onboarding n'en connecte aucun automatiquement. Juste après l'onboarding, tu peux n'avoir aucun ✓ ici tant que tu n'as pas lancé cette commande.
+
+## Usage quotidien
+
+- **Rien à faire.** Le daemon tourne en tâche de fond, ingère tes nouvelles sessions Claude Code / Codex CLI toutes les heures, expose la mémoire via MCP, et le menu bar Onadit te montre si tout va bien.
+- **Tester depuis Claude Desktop ou Cursor.** Ouvre une conversation, demande par exemple : *"Rappelle-toi ce qu'on a discuté sur le pricing la semaine dernière, va voir dans Onadit"* — Claude/Cursor appellera `onadit_search` ou `onadit_context_pack` automatiquement et t'affichera ce qu'il trouve.
+- **Rechercher en ligne de commande :** `onadit search "comment on a structuré le pricing"`
+- **Forcer une passe de capture maintenant :** `onadit capture`
+- **Mettre à jour :** Onadit vérifie le tag beta toutes les heures. Si une nouvelle version existe, `onadit status`, `onadit doctor` et le menu bar affichent `onadit update` ; dans le menu bar, clique **Update Onadit**.
+
+## Vie privée
+
+- **Local par défaut.** Tes sessions, métadonnées et la base vectorielle (LanceDB) restent sur ta machine.
+- **Voyage AI.** Seuls les *snippets* envoyés pour embedding partent vers Voyage. Ta clé t'appartient — tu peux la révoquer côté Voyage à tout moment, ce qui coupe l'envoi.
+- **Aucune télémétrie de contenu.** Onadit ne m'envoie rien. La commande `onadit feedback --kind=...` écrit ta note dans un JSONL local — elle ne part nulle part. Le *feedback relay* (envoi de la note à Clem) n'existe pas par défaut : il faut le configurer explicitement pendant l'onboarding via `onadit onboard --enable-feedback-relay <url>`, et même activé, il ne transmet que la note que tu écris, jamais tes conversations.
+- **Désinstallation propre.** `onadit uninstall` enlève le daemon et les entrées MCP. `onadit uninstall --purge-data` supprime aussi les données locales.
+
+Le contrat de vie privée détaillé est dans `docs/feedback/PRIVACY.md` (livré avec le paquet).
+
+## Backfill historique (payant)
+
+Le watermark protège ton historique pré-installation : Onadit ne va pas inonder ta mémoire avec deux ans de conversations dont la moitié sont du débogage jetable.
+
+Mais si tu veux *vraiment* que ton corpus passé soit indexé, c'est faisable. Ce que ça représente côté boulot :
+
+- import + audit de tes exports web (claude.ai, chatgpt.com, gemini.google.com, grok.com) ;
+- déwatermark ciblé des sessions Claude Code / Codex CLI qui valent le coup (filtré par date, projet, heuristique) ;
+- tuning des règles de triage à ton usage réel sur ~1 semaine ;
+- session de 60 min en visio pour valider ce qui est entré dans la mémoire et ce qui a été écarté.
+
+**Tarifs (HT, prestation ponctuelle) :**
+
+| Profondeur | Tarif |
+|---|---|
+| 1 mois de données | **1 000 €** |
+| 6 mois de données | **3 000 €** |
+| 1 an de données | **5 000 €** |
+
+Pour déclencher : il me faut un **bon de commande / facture HT signée** par ton boss. Une fois validé, on cale 1h de kickoff. Tu m'envoies un message quand tu es prêt.
+
+## En cas de pépin
+
+| Symptôme | Solution |
+|---|---|
+| `onadit status` dit "daemon: unreachable" | `launchctl kickstart -k gui/$UID/com.getrift.daemon` |
+| Codex CLI auth périmé | `codex login` |
+| Clé Voyage révoquée ou changée | `onadit onboard --reconfigure-voyage` |
+| Le menu bar Onadit n'apparaît pas | Ouvre SwiftBar, puis lance `onadit menubar install` |
+| Une mise à jour est disponible | `onadit update` |
+| Onadit n'apparaît pas dans Claude Desktop / Cursor | `onadit mcp install --client=claude-desktop` (remplace par `codex`, `claude-code`, `cursor` selon le besoin) |
+| Le garde-fou Claude Code te bloque trop souvent | `export RIFT_POLICY_DISABLED=1` dans le shell (désactive le hook le temps de la session), ou enlève l'entrée `rift-policy.mjs` de `~/.claude/settings.json` |
+| Truc bizarre, tu veux me prévenir | `onadit feedback --kind=broke --with-status` — capture l'état actuel et l'écrit en local (JSONL). Envoie-moi le fichier, ou copie-colle. |
+
+## Désinstaller
+
+```sh
+onadit uninstall              # enlève daemon + entrées MCP
+onadit uninstall --purge-data # + supprime les données locales
+```
+
+Avec `--purge-data`, Onadit retire aussi ses identifiants et ses lanceurs. Les exports originaux et les connexions de tes autres outils sont conservés. Le paquet macOS peut également être retiré depuis le bouton Remove Onadit de sa page locale.
+
+## License
+
+Beta privée. Pas de redistribution.

package/dist/src/auth/keychain.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Typed error thrown when the macOS Keychain is locked. Caught by
+ * `readToken` (CLI read path) and `ensureToken` (CLI write path) to
+ * surface the `security unlock-keychain ~/Library/Keychains/login.keychain-db`
+ * recovery copy instead of the raw `security` CLI failure.
+ */
+export declare class LockedKeychainError extends Error {
+    constructor(message: string);
+}
+/**
+ * Low-level Keychain operations.
+ *
+ * Abstracted as an interface so rotation.ts can be tested with an
+ * in-memory implementation that never touches the real Keychain.
+ */
+export interface KeychainOps {
+    read(version: number): Promise<string | null>;
+    write(version: number, token: string): Promise<void>;
+    delete(version: number): Promise<void>;
+    findLatestVersion(): Promise<number>;
+}
+/**
+ * Production Keychain backend using the macOS `security` CLI.
+ *
+ * Token versioning: each version is stored as a separate generic-password
+ * entry. A metadata entry (`AUTH_TOKEN_CURRENT_VERSION`) tracks the
+ * latest version number so we avoid scanning the entire keychain.
+ *
+ * Error policy: only "item not found" (exit 44) is swallowed where
+ * appropriate. All other errors (locked keychain, permission denied,
+ * missing binary) propagate as thrown exceptions.
+ */
+export declare const macKeychain: KeychainOps;
+/**
+ * Remove the non-secret pointer left after all versioned tokens are deleted.
+ *
+ * macOS only. This release is macOS-only, so the guard is belt and braces
+ * here; it is kept so the file stays aligned with trunk, where a libsecret
+ * backend exists that deliberately has no such counter.
+ */
+export declare function deleteTokenVersionMetadata(): Promise<void>;
+//# sourceMappingURL=keychain.d.ts.map

package/dist/src/auth/keychain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.d.ts","sourceRoot":"","sources":["../../../src/auth/keychain.ts"],"names":[],"mappings":"AAuBA;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAWD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAgBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,WAoFzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAehE"}

package/dist/src/auth/keychain.js

@@ -0,0 +1,177 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const SERVICE = "com.getrift.daemon";
+/**
+ * macOS `security` CLI exit code for errSecItemNotFound.
+ * This is the only error we treat as "success with empty result".
+ * All other non-zero exits are real failures that must propagate.
+ */
+const ERR_SEC_ITEM_NOT_FOUND = 44;
+/**
+ * Substring emitted by the macOS `security` CLI when the login keychain
+ * is locked (typical over SSH or in CI without a GUI session). Locked-
+ * keychain failures are a distinct *class* — they're recoverable with
+ * `security unlock-keychain`, unlike permission denials or missing
+ * binaries — so callers benefit from a typed error to render a precise
+ * recovery hint.
+ */
+const LOCKED_KEYCHAIN_SUBSTRING = "User interaction is not allowed";
+/**
+ * Typed error thrown when the macOS Keychain is locked. Caught by
+ * `readToken` (CLI read path) and `ensureToken` (CLI write path) to
+ * surface the `security unlock-keychain ~/Library/Keychains/login.keychain-db`
+ * recovery copy instead of the raw `security` CLI failure.
+ */
+export class LockedKeychainError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "LockedKeychainError";
+    }
+}
+function isLockedKeychain(err) {
+    if (!(err instanceof Error))
+        return false;
+    if (err.message.includes(LOCKED_KEYCHAIN_SUBSTRING))
+        return true;
+    // The substring lands on stderr, which `execFile` attaches to the
+    // error object as `stderr`. Belt + braces: check both surfaces.
+    const stderr = err.stderr;
+    return typeof stderr === "string" && stderr.includes(LOCKED_KEYCHAIN_SUBSTRING);
+}
+function accountName(version) {
+    return `AUTH_TOKEN_v${version}`;
+}
+/**
+ * Returns true only for the specific "item not found" error from
+ * the macOS `security` CLI. All other errors are real failures.
+ */
+function isItemNotFound(err) {
+    if (!(err instanceof Error))
+        return false;
+    const execErr = err;
+    return execErr.code === ERR_SEC_ITEM_NOT_FOUND;
+}
+/**
+ * Production Keychain backend using the macOS `security` CLI.
+ *
+ * Token versioning: each version is stored as a separate generic-password
+ * entry. A metadata entry (`AUTH_TOKEN_CURRENT_VERSION`) tracks the
+ * latest version number so we avoid scanning the entire keychain.
+ *
+ * Error policy: only "item not found" (exit 44) is swallowed where
+ * appropriate. All other errors (locked keychain, permission denied,
+ * missing binary) propagate as thrown exceptions.
+ */
+export const macKeychain = {
+    async read(version) {
+        try {
+            const { stdout } = await execFileAsync("security", [
+                "find-generic-password",
+                "-a",
+                accountName(version),
+                "-s",
+                SERVICE,
+                "-w",
+            ]);
+            return stdout.trim() || null;
+        }
+        catch (err) {
+            if (isItemNotFound(err))
+                return null;
+            if (isLockedKeychain(err)) {
+                throw new LockedKeychainError(err instanceof Error ? err.message : String(err));
+            }
+            throw err;
+        }
+    },
+    async write(version, token) {
+        await execFileAsync("security", [
+            "add-generic-password",
+            "-a",
+            accountName(version),
+            "-s",
+            SERVICE,
+            "-w",
+            token,
+            "-U",
+        ]);
+        // Update version counter
+        await execFileAsync("security", [
+            "add-generic-password",
+            "-a",
+            "AUTH_TOKEN_CURRENT_VERSION",
+            "-s",
+            SERVICE,
+            "-w",
+            String(version),
+            "-U",
+        ]);
+    },
+    async delete(version) {
+        try {
+            await execFileAsync("security", [
+                "delete-generic-password",
+                "-a",
+                accountName(version),
+                "-s",
+                SERVICE,
+            ]);
+        }
+        catch (err) {
+            if (isItemNotFound(err))
+                return; // Already gone — fine.
+            throw err;
+        }
+    },
+    async findLatestVersion() {
+        try {
+            const { stdout } = await execFileAsync("security", [
+                "find-generic-password",
+                "-a",
+                "AUTH_TOKEN_CURRENT_VERSION",
+                "-s",
+                SERVICE,
+                "-w",
+            ]);
+            const version = Number(stdout.trim());
+            return Number.isNaN(version) ? 0 : version;
+        }
+        catch (err) {
+            if (isItemNotFound(err))
+                return 0; // No tokens issued yet.
+            if (isLockedKeychain(err)) {
+                throw new LockedKeychainError(err instanceof Error ? err.message : String(err));
+            }
+            throw err;
+        }
+    },
+};
+/**
+ * Remove the non-secret pointer left after all versioned tokens are deleted.
+ *
+ * macOS only. This release is macOS-only, so the guard is belt and braces
+ * here; it is kept so the file stays aligned with trunk, where a libsecret
+ * backend exists that deliberately has no such counter.
+ */
+export async function deleteTokenVersionMetadata() {
+    if (process.platform !== "darwin")
+        return;
+    if (process.platform !== "darwin")
+        return;
+    try {
+        await execFileAsync("security", [
+            "delete-generic-password",
+            "-a",
+            "AUTH_TOKEN_CURRENT_VERSION",
+            "-s",
+            SERVICE,
+        ]);
+    }
+    catch (err) {
+        if (isItemNotFound(err))
+            return;
+        throw err;
+    }
+}
+//# sourceMappingURL=keychain.js.map

package/dist/src/auth/keychain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keychain.js","sourceRoot":"","sources":["../../../src/auth/keychain.ts"],"names":[],"mappings":"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"}

package/dist/src/auth/middleware.d.ts

@@ -0,0 +1,21 @@
+import type { FastifyInstance } from "fastify";
+import type { Config } from "../config/schema.js";
+import type { TokenManager } from "./rotation.js";
+import type { RateLimiter } from "./rate-limit.js";
+import type { SetupSessionManager } from "../onboarding/setup-session.js";
+/**
+ * Register the bearer-token auth hook and per-token rate limiter.
+ *
+ * Auth is skipped for /health, /ready, /version, and /stats/mcp-usage
+ * (unauthenticated probes used by health/operator surfaces).
+ *
+ * Test-only bypass: when `NODE_ENV=test` AND `config.auth.test_token`
+ * is set AND the bearer matches it, the request is allowed without
+ * consulting the TokenManager. This is the ONLY way to bypass Keychain
+ * in tests — it is never active in production config.
+ *
+ * Rate limiting is skipped for `DELETE /auth/token` so a leaked token
+ * that has hit the rate-limit cap can still revoke itself.
+ */
+export declare function registerAuth(server: FastifyInstance, config: Config, tokenManager: TokenManager | null, rateLimiter: RateLimiter, setupSessions?: SetupSessionManager): void;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/src/auth/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/auth/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAwB1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,mBAAmB,GAClC,IAAI,CA2EN"}