@getrift/rift 0.1.0-beta.0 → 0.1.0-beta.10

package/README.md

@@ -1,6 +1,8 @@
 # Rift
 
-**Mémoire personnelle locale pour tes IA.** Rift 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.
+**Mémoire personnelle locale pour tes IA.**
+
+Rift 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).
 
@@ -11,33 +13,42 @@ Tout reste sur ta machine, sauf les *embeddings* (envoyés à Voyage AI sous une
 > **La capture démarre maintenant.**
 > Au premier lancement, Rift 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 tes conversations historiques (sessions Claude Code locales antérieures, exports `.zip` de claude.ai / chatgpt.com / gemini.google.com / grok.com) soient *aussi* indexées, c'est une **prestation séparée** — voir la section [Backfill historique (payant)](#backfill-historique-payant) plus bas.
+> 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
 
-- macOS 12.3 ou plus récent.
-- Node.js 20.19+ (vérifie avec `node --version`).
-- npm (livré avec Node).
-- [Codex CLI](https://github.com/openai/codex) installé et authentifié (`codex login`). Rift fait passer le triage et l'extraction de métadonnées par ton CLI Codex local — pas besoin de clé OpenAI séparée.
-- Une clé Voyage AI (création gratuite sur [voyageai.com](https://www.voyageai.com/)). Sert *uniquement* aux embeddings ; chaque user a sa propre clé.
+À 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é** | `codex --version`, puis `codex login` si tu n'as jamais loggé |
+| 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 |
+
+Codex CLI fait tourner le triage et l'extraction de métadonnées — pas besoin de clé OpenAI séparée. La clé Voyage sert *uniquement* aux embeddings.
 
 ## Installation (1 commande)
 
+Dans Ghostty, tape :
+
 ```sh
 curl -fsSL https://getrift.dev/install | bash
 ```
 
 Ce que fait le script :
 
-- vérifie les prérequis (macOS, Node, codex CLI…),
-- installe globalement le paquet npm `@getrift/rift@beta`,
-- crée les dossiers de données (`~/Library/Application Support/Rift/`),
-- pose un agent launchd (`com.getrift.daemon`) qui démarre Rift à la session,
-- attend que `/health` réponde sur `127.0.0.1:3577`.
+- vérifie les prérequis ;
+- installe le paquet npm `@getrift/rift@beta` globalement ;
+- crée tes dossiers de données sous `~/Library/Application Support/Rift/` ;
+- pose un agent launchd qui lance Rift à chaque session ;
+- 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 `rift` disponible partout. Tape ton mot de passe (rien ne s'affiche pendant la frappe — c'est normal sur Unix), `Entrée`.
 
-Si l'installation échoue, le script restaure ton état précédent et imprime un identifiant de backup pour le diagnostic.
+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
 
@@ -45,15 +56,20 @@ Si l'installation échoue, le script restaure ton état précédent et imprime u
 rift onboard
 ```
 
-L'assistant va :
+L'assistant va te poser **5 ou 6 questions**, dans cet ordre :
 
-1. te demander ta clé Voyage AI (collée depuis ton 1Password — elle ne s'affiche pas) ;
-2. valider la clé en faisant un embed test ;
-3. faire un *preflight* sur ton Codex CLI (vérifie qu'il est authentifié) ;
-4. lancer une première passe de capture (les sessions existantes sont watermarkées, pas ingérées) ;
-5. proposer de brancher Rift comme serveur MCP dans Claude Desktop / Claude Code / Codex / Cursor.
+1. **La clé Voyage que je t'ai envoyée.** Colle-la depuis 1Password. Elle ne s'affiche pas pendant la frappe.
+2. **Validation.** Rift fait un embed test pour vérifier la clé.
+3. **Vérifie que Codex est authentifié.** Si ça échoue, lance `codex login` et relance `rift onboard`. Ou demande à Claude.
+4. **Première passe de capture.** Watermarke tes sessions existantes (ne les ingère pas).
+5. **Branchement MCP.** Te demande dans quels clients tu veux Rift comme serveur MCP — Claude Desktop, Claude Code, Codex, Cursor. **Réponds `oui` à tous ceux que tu utilises.**
+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 Rift à commencer par `rift_context_pack` (compact, budgété) avant tout `rift_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`.
 
-Tu peux importer un export ChatGPT ou Claude.ai pendant l'onboarding (optionnel — voir la section backfill).
+À la fin, l'assistant te dit "Onboarding terminé" et te suggère ta première recherche.
+
+> Si tu veux importer un export ChatGPT ou Claude.ai, l'assistant te le proposera. **Pour la beta : décline** — c'est de la backfill historique, voir la section payante plus bas.
+
+> Si tu as déjà fait `rift onboard` avant cette beta, tu peux poser le hook après coup avec `rift hooks install --client claude-code`.
 
 ## Vérifier que ça tourne
 
@@ -61,10 +77,10 @@ Tu peux importer un export ChatGPT ou Claude.ai pendant l'onboarding (optionnel
 rift status
 ```
 
-Tu dois voir quelque chose comme :
+Tu dois voir une sortie qui ressemble à ça (en anglais — le binaire est anglophone) :
 
 ```
-Rift v0.1.0-beta.0  ·  daemon: running (uptime 5m)  ·  port 3577 ✓
+Rift 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:     last run 8m ago — 3 saved · 0 review · 0 failed
@@ -74,56 +90,64 @@ Feedback:    relay off (local JSONL only)
 Next:        nothing broken. Try rift 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.
+
 ## Usage quotidien
 
 - **Rien à faire.** Le daemon tourne en tâche de fond, ingère tes nouvelles sessions Claude Code / Codex CLI toutes les heures, et expose la mémoire via MCP.
-- **Rechercher en CLI :** `rift search "comment on a structuré le pricing"`
-- **Forcer une passe maintenant :** `rift capture`
-- **Ouvrir une conversation MCP** (Claude Desktop, Cursor, etc.) — Rift apparaît dans la liste des outils. Tape *"recall what we decided about X"* et l'agent appellera `rift_search` / `rift_context_pack` automatiquement.
+- **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 Rift"* — Claude/Cursor appellera `rift_search` ou `rift_context_pack` automatiquement et t'affichera ce qu'il trouve.
+- **Rechercher en ligne de commande :** `rift search "comment on a structuré le pricing"`
+- **Forcer une passe de capture maintenant :** `rift capture`
 
 ## 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.
-- **Aucune télémétrie de contenu.** Rift n'envoie rien chez moi, sauf si tu actives explicitement le *feedback relay* (`rift feedback --kind=...`) — et même là, c'est uniquement la note que tu écris, pas tes conversations.
-- **Désinstallation propre :** `rift uninstall` enlève le daemon, les entrées MCP, et (avec `--purge-data`) les données.
+- **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.** Rift ne m'envoie rien, sauf si tu actives explicitement le *feedback relay* (`rift feedback --kind=...`). Et même là, c'est juste la note que tu écris, pas tes conversations.
+- **Désinstallation propre.** `rift uninstall` enlève le daemon et les entrées MCP. `rift uninstall --purge-data` supprime aussi les données locales.
 
-Le contrat de vie privée détaillé arrive avec le paquet : `docs/feedback/PRIVACY.md`.
+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 : Rift 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é — sessions Claude Code locales antérieures, exports `.zip` claude.ai, chatgpt.com, gemini.google.com, grok.com — c'est faisable, mais ça représente plusieurs heures de tri et de QA pour calibrer les filtres à ton usage.
+Le watermark protège ton historique pré-installation : Rift 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 :
 
-**Tarif : 500 € HT, prestation ponctuelle.**
+- 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é.
 
-Ce que ça inclut :
+**Tarifs (HT, prestation ponctuelle) :**
 
-- import de tes exports web (`rift import <export.zip>`) avec audit du contenu,
-- déwatermark ciblé des sessions Claude Code / Codex CLI valant le coup (filtré par date, projet, ou heuristique),
-- tuning des règles de triage à ton usage réel pendant une semaine,
-- une session de 60 min en visio pour valider ce qui est dans la mémoire vs ce qui a été écarté.
+| 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.
+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
 
-- **Le daemon ne répond pas :**
-  ```sh
-  launchctl kickstart -k gui/$UID/com.getrift.daemon
-  ```
-- **Codex CLI auth périmé :** `codex login`
-- **Clé Voyage révoquée / changée :** `rift onboard --reconfigure-voyage`
-- **MCP pas branché dans un client :** `rift mcp install --client=claude-desktop` (ou `codex`, `claude-code`, `cursor`)
-- **Donner du feedback (utile) :** `rift feedback --kind=broke --with-status` — capture l'état du daemon et l'envoie en local (et en relay si tu l'as activé pendant l'onboard).
+| Symptôme | Solution |
+|---|---|
+| `rift 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 | `rift onboard --reconfigure-voyage` |
+| Rift n'apparaît pas dans Claude Desktop / Cursor | `rift 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 | `rift feedback --kind=broke --with-status` — capture l'état actuel et envoie le tout en local (+ chez moi si tu as activé le relay pendant l'onboard) |
 
 ## Désinstaller
 
 ```sh
-rift uninstall              # enlève daemon + MCP
+rift uninstall              # enlève daemon + entrées MCP
 rift uninstall --purge-data # + supprime les données locales
 ```
 
-La clé Voyage reste dans `~/.rift.env` même après `--purge-data` — la commande affiche le `rm` exact pour la supprimer (ou tu peux la révoquer côté Voyage).
+La clé Voyage reste dans `~/.rift.env` même après `--purge-data` — la commande affiche le `rm` exact pour la nettoyer, ou tu peux la révoquer côté Voyage.
 
 ## License
 

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

@@ -1,3 +1,12 @@
+/**
+ * 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.
  *

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

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

package/dist/src/auth/keychain.js

@@ -8,6 +8,37 @@ const SERVICE = "com.getrift.daemon";
  * 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}`;
 }
@@ -48,6 +79,9 @@ export const macKeychain = {
         catch (err) {
             if (isItemNotFound(err))
                 return null;
+            if (isLockedKeychain(err)) {
+                throw new LockedKeychainError(err instanceof Error ? err.message : String(err));
+            }
             throw err;
         }
     },
@@ -106,6 +140,9 @@ export const macKeychain = {
         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;
         }
     },

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

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

package/dist/src/capture/recover-quarantine.d.ts

@@ -0,0 +1,221 @@
+import { z } from "zod";
+/**
+ * Default byte budget per summarization chunk. Sits well below the
+ * 8 MB auto-capture threshold so the Codex CLI input never hits the
+ * same wall that caused the quarantine in the first place. 512 KB
+ * fits comfortably in stdin and leaves room for the prompt.
+ */
+export declare const DEFAULT_RECOVERY_CHUNK_BYTES: number;
+/** Minimum chunk size we allow — anything smaller risks turn-truncation. */
+export declare const MIN_RECOVERY_CHUNK_BYTES: number;
+export declare const PROVENANCE_TOPIC = "recovered_oversized_quarantine";
+declare const QuarantineRecordSchema: z.ZodObject<{
+    source: z.ZodLiteral<"codex_cli">;
+    session_id: z.ZodString;
+    session_path: z.ZodString;
+    size_bytes: z.ZodNumber;
+    threshold_bytes: z.ZodNumber;
+    fingerprint: z.ZodString;
+    reason: z.ZodString;
+    quarantined_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: "codex_cli";
+    size_bytes: number;
+    quarantined_at: string;
+    reason: string;
+    fingerprint: string;
+    session_id: string;
+    session_path: string;
+    threshold_bytes: number;
+}, {
+    source: "codex_cli";
+    size_bytes: number;
+    quarantined_at: string;
+    reason: string;
+    fingerprint: string;
+    session_id: string;
+    session_path: string;
+    threshold_bytes: number;
+}>;
+export type QuarantineRecord = z.infer<typeof QuarantineRecordSchema> & {
+    /** Path to the quarantine record file itself. */
+    record_path: string;
+};
+declare const RecoveredEntrySchema: z.ZodObject<{
+    recovered_at: z.ZodString;
+    fingerprint: z.ZodString;
+    idempotency_key: z.ZodString;
+    chunks: z.ZodNumber;
+    session_path: z.ZodString;
+    size_bytes: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    idempotency_key: string;
+    size_bytes: number;
+    fingerprint: string;
+    session_path: string;
+    recovered_at: string;
+    chunks: number;
+}, {
+    idempotency_key: string;
+    size_bytes: number;
+    fingerprint: string;
+    session_path: string;
+    recovered_at: string;
+    chunks: number;
+}>;
+export type RecoveredEntry = z.infer<typeof RecoveredEntrySchema>;
+declare const RecoveryStateSchema: z.ZodObject<{
+    recovered: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        recovered_at: z.ZodString;
+        fingerprint: z.ZodString;
+        idempotency_key: z.ZodString;
+        chunks: z.ZodNumber;
+        session_path: z.ZodString;
+        size_bytes: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        idempotency_key: string;
+        size_bytes: number;
+        fingerprint: string;
+        session_path: string;
+        recovered_at: string;
+        chunks: number;
+    }, {
+        idempotency_key: string;
+        size_bytes: number;
+        fingerprint: string;
+        session_path: string;
+        recovered_at: string;
+        chunks: number;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    recovered: Record<string, {
+        idempotency_key: string;
+        size_bytes: number;
+        fingerprint: string;
+        session_path: string;
+        recovered_at: string;
+        chunks: number;
+    }>;
+}, {
+    recovered?: Record<string, {
+        idempotency_key: string;
+        size_bytes: number;
+        fingerprint: string;
+        session_path: string;
+        recovered_at: string;
+        chunks: number;
+    }> | undefined;
+}>;
+export type RecoveryState = z.infer<typeof RecoveryStateSchema>;
+export type SkipReason = "already_recovered" | "missing_source" | "empty_session" | "summarize_failed" | "save_failed";
+export interface RecoveryResult {
+    session_id: string;
+    fingerprint: string;
+    outcome: "recovered" | "skipped" | "failed";
+    reason?: SkipReason;
+    chunks?: number;
+    idempotency_key?: string;
+    error?: string;
+}
+export interface RecoveryReport {
+    total_records: number;
+    total_sessions: number;
+    recovered: number;
+    skipped: number;
+    missing_source: number;
+    failed: number;
+    results: RecoveryResult[];
+}
+export interface ChunkSummary {
+    summary: string;
+    topics: string[];
+}
+export interface ChunkSummarizer {
+    summarize(opts: {
+        chunk: string;
+        index: number;
+        total: number;
+        sessionId: string;
+    }): Promise<ChunkSummary>;
+}
+export interface RecoverQuarantineSaveInput {
+    sessionId: string;
+    fingerprint: string;
+    sessionPath: string;
+    sizeBytes: number;
+    thresholdBytes: number;
+    chunks: ChunkSummary[];
+    content: string;
+    summary: string;
+    topics: string[];
+    idempotencyKey: string;
+}
+export interface RecoverQuarantineDeps {
+    dataDir: string;
+    /** Override quarantine directory (defaults to `<dataDir>/quarantine`). */
+    quarantineDir?: string;
+    /**
+     * Chunk byte budget. Clamped to at least `MIN_RECOVERY_CHUNK_BYTES`.
+     * Defaults to `DEFAULT_RECOVERY_CHUNK_BYTES`.
+     */
+    chunkBytes?: number;
+    summarizer: ChunkSummarizer;
+    /**
+     * Save the recovered artifact through the daemon. Implementations
+     * should be idempotent w.r.t. `idempotencyKey` so a partial failure
+     * mid-batch doesn't double-insert when the recovery state write
+     * happened after a successful save (it doesn't here — state is
+     * persisted on success only — but the contract still holds).
+     */
+    saveFn: (input: RecoverQuarantineSaveInput) => Promise<void>;
+    /**
+     * Dry-run: discover, parse, and chunk only. The Codex CLI summarizer
+     * is NOT invoked (each chunk call costs real time/quota on real data),
+     * and saving + state persistence are skipped. Use this to plan a real
+     * run cheaply; the report's `chunks` count reflects what a real run
+     * would summarize.
+     */
+    dryRun?: boolean;
+    /** Optional clock for deterministic tests. */
+    now?: () => Date;
+}
+/**
+ * Read all Codex-CLI quarantine records under the configured directory.
+ * Malformed JSON / schema mismatches are skipped silently with a stderr
+ * note so one corrupt record can never block the rest of the batch.
+ */
+export declare function loadQuarantineRecords(deps: Pick<RecoverQuarantineDeps, "dataDir" | "quarantineDir">): QuarantineRecord[];
+/**
+ * Collapse multiple quarantine records that point at the same session
+ * (the same jsonl that hit the threshold at different sizes as it grew)
+ * down to one: the latest `quarantined_at`. The collapsed record still
+ * carries the recovery key, so reruns can mark every related record as
+ * already-recovered for that session.
+ */
+export declare function groupBySession(records: QuarantineRecord[]): QuarantineRecord[];
+export declare function loadRecoveryState(deps: Pick<RecoverQuarantineDeps, "dataDir">): RecoveryState;
+export declare function saveRecoveryState(deps: Pick<RecoverQuarantineDeps, "dataDir">, state: RecoveryState): Promise<void>;
+/**
+ * Split parser-emitted Codex content into byte-budgeted chunks at turn
+ * boundaries. The parser format is `User: …\n\nAssistant: …\n\n…`, so
+ * we split on `\n\n` immediately preceding a `User:` or `Assistant:`
+ * marker. A single turn larger than `maxBytes` becomes its own chunk
+ * (oversized but preserved — better than dropping signal).
+ */
+export declare function chunkByTurns(content: string, maxBytes: number): string[];
+export declare function runRecoverQuarantine(deps: RecoverQuarantineDeps): Promise<RecoveryReport>;
+export declare class CodexCliChunkSummarizer implements ChunkSummarizer {
+    private readonly options;
+    constructor(options?: {
+        cwd?: string;
+        timeoutMs?: number;
+    });
+    summarize(opts: {
+        chunk: string;
+        index: number;
+        total: number;
+        sessionId: string;
+    }): Promise<ChunkSummary>;
+}
+export {};
+//# sourceMappingURL=recover-quarantine.d.ts.map

package/dist/src/capture/recover-quarantine.d.ts.map

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