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

package/README.md

@@ -0,0 +1,154 @@
+# 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.
+
+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, 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 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é** | `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 ;
+- 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 ç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
+rift onboard
+```
+
+L'assistant va te poser **5 ou 6 questions**, dans cet ordre :
+
+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`.
+
+À 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
+
+```sh
+rift status
+```
+
+Tu dois voir une sortie qui ressemble à ça (en anglais — le binaire est anglophone) :
+
+```
+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
+MCP:         claude-desktop ✓  ·  codex ✓  ·  claude-code ✓  ·  cursor ✓
+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.
+- **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, 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é 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é, 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 |
+|---|---|
+| `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 + 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 nettoyer, ou tu peux la révoquer côté Voyage.
+
+## License
+
+Beta privée. Pas de redistribution.

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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"}