onadit 0.0.1 → 0.1.0-beta.45

package/dist/src/diagnostics/doctor.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Pure diagnosis layer shared by `onadit doctor`, the repair-prompt
+ * generator, and the daemon's failure notifier.
+ *
+ * It consumes exactly what `onadit status` already consumes — the
+ * `/status/friend` payload plus the friend's local signals (Voyage key
+ * last-4, MCP-client install presence) — and folds them into a small,
+ * severity-ordered list of issues. Each issue carries plain-language
+ * copy and one next action, so every surface (CLI, prompt, notification)
+ * tells the same story.
+ *
+ * Issue ordering follows `decideNextLine` in `friend-header.ts` so the
+ * two surfaces tell the same story, with one deliberate policy on top:
+ * `primary` (the "do this first" action) is always the highest-SEVERITY
+ * issue — a `broken` failure outranks any `warning`, regardless of
+ * positional order. This is why `onadit doctor` can lead with a broken
+ * capture failure where `onadit status`'s flat, positional Next: line
+ * might surface a warning-level inbox rejection first. The lists never
+ * contradict each other; `doctor` simply elevates "what is actually
+ * broken" to the lead, which is its whole job.
+ *
+ * This module is intentionally side-effect free: no IO, no clock except
+ * the injected `now`, no daemon access. Callers fetch the payload and
+ * pass it in.
+ */
+import type { FriendStatusPayload } from "../server/routes/friend-status.js";
+/** Stable identifiers for each diagnosable condition. */
+export type DoctorIssueKind = "daemon_unreachable" | "daemon_auth_failed" | "config_missing" | "voyage_key_missing" | "semantic_search_off" | "codex_auth_expired" | "codex_preflight_failed" | "claude_auth_expired" | "claude_preflight_failed" | "voyage_embed_errors" | "index_write_errors" | "inbox_import_errors" | "capture_failed" | "capture_daemon_stale" | "mcp_not_installed" | "earlier_names_left" | "menu_bar_unavailable" | "menu_bar_broken" | "capture_quarantined" | "capture_repairing" | "update_available";
+/**
+ * `broken` blocks Onadit from doing its job (no capture, no search, no
+ * memory). `warning` is degraded-but-working or user-side (a rejected
+ * import, a missing optional client, an available update).
+ */
+export type DoctorSeverity = "broken" | "warning";
+export interface DoctorIssue {
+    kind: DoctorIssueKind;
+    severity: DoctorSeverity;
+    /** One-line plain-language headline a friend can read. */
+    title: string;
+    /** Plain-language explanation of what is wrong and why it matters. */
+    detail: string;
+    /** Exactly one next action — a command or a concrete step. */
+    nextAction: string;
+    /**
+     * Stable identity of the *cause*, not just the subsystem. For most
+     * issues this is the kind, but error-bearing issues fold in the error
+     * class (e.g. `voyage_embed_errors:provider_400`) so the notifier can
+     * tell "same subsystem, new cause" apart from a still-unresolved
+     * repeat. Optional so hand-built issues fall back to `kind`.
+     */
+    fingerprint?: string;
+    /**
+     * True when a *running* daemon can observe this failure and is
+     * therefore allowed to raise a native notification about it. A fully
+     * dead daemon cannot observe anything, so `daemon_unreachable` is
+     * false here — that case needs the Slice D watchdog, not this path.
+     */
+    daemonObservable: boolean;
+}
+/** Local-only signals the friend's machine answers without the daemon. */
+export interface DoctorLocalSignals {
+    voyageLast4: string | null;
+    mcpClients: Array<{
+        client: string;
+        installed: boolean;
+    }>;
+    /**
+     * SwiftBar presence + plugin health — null when not applicable (non-macOS, or
+     * a caller that does not probe it, e.g. the daemon notifier). `installed:
+     * false` raises the menu-bar advisory; `pluginDangling: true` raises the
+     * "plugin is broken — reinstall" advisory. `pluginDangling` is optional so a
+     * caller that only knows app presence still type-checks (undefined → silent).
+     */
+    swiftBar?: {
+        installed: boolean;
+        pluginDangling?: boolean;
+    } | null;
+    /**
+     * The person's own rule and settings files that still name the earlier
+     * tools, for a connection they moved to the current names. Optional so a
+     * caller that does not probe it stays silent.
+     */
+    earlierNames?: {
+        files: string[];
+    };
+}
+/**
+ * Why `/status/friend` could not be read. A null status is NOT always
+ * "the daemon is down" — the request can fail because there is no config,
+ * no token has been issued, or the daemon rejected our auth. Each needs a
+ * different next action, so the caller classifies the failure and the
+ * diagnosis turns it into the right issue. Defaults to `connection_refused`
+ * (the in-process daemon caller never passes null, so this only matters
+ * for the CLI).
+ */
+export type DoctorUnreachableReason = "connection_refused" | "auth_failed" | "not_authenticated" | "config_missing" | "unknown";
+export interface DoctorInput {
+    /** `/status/friend` payload, or null when it could not be read. */
+    status: FriendStatusPayload | null;
+    /**
+     * When `status` is null, why. Lets the diagnosis distinguish "daemon
+     * down" from "cannot authenticate to the daemon" from "no config yet".
+     */
+    unreachableReason?: DoctorUnreachableReason;
+    localSignals: DoctorLocalSignals;
+    /** Injected clock; defaults to Date.now() at the call site. */
+    now: number;
+}
+export interface DoctorReport {
+    /** True when no `broken` issue is present. Warnings do not flip this. */
+    healthy: boolean;
+    /**
+     * The single most important issue — the one whose `nextAction` a
+     * surface should lead with. Null only when there are no issues at all.
+     */
+    primary: DoctorIssue | null;
+    /** All detected issues, highest priority first. */
+    issues: DoctorIssue[];
+}
+/**
+ * Diagnose Onadit health from the same inputs `onadit status` uses. Pure:
+ * given identical inputs it always returns the same report.
+ */
+export declare function diagnose(input: DoctorInput): DoctorReport;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/src/diagnostics/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAS7E,yDAAyD;AACzD,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,gBAAgB,GAChB,sBAAsB,GACtB,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE;;;;OAIG;IACH,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B,oBAAoB,GACpB,aAAa,GACb,mBAAmB,GACnB,gBAAgB,GAChB,SAAS,CAAC;AAEd,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,YAAY,EAAE,kBAAkB,CAAC;IACjC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAmHD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAsYzD"}

package/dist/src/diagnostics/doctor.js

@@ -0,0 +1,450 @@
+import { REINSTALL_COMMAND, RIFT_DOWNLOAD_URL } from "./install-layout.js";
+import { PREVIOUS_SERVER_NAME, SERVER_NAME } from "../mcp/names.js";
+import { claudePreflightNextAction, } from "./claude-preflight.js";
+/**
+ * True only when `iso` parses to a timestamp at/after the daemon's
+ * current start. Historical errors that predate the running process are
+ * not current and must not be reported as live failures — a healthy
+ * respawn should clear them. Mirrors `friend-header.isCurrentUptime`.
+ */
+function isCurrentUptime(iso, daemonStartMs) {
+    if (!iso)
+        return false;
+    const ts = Date.parse(iso);
+    if (Number.isNaN(ts))
+        return false;
+    return ts >= daemonStartMs;
+}
+/**
+ * Translate internal error-class names into copy a friend can act on.
+ * Falls back to the raw class so a new/unknown value still surfaces.
+ * Kept in sync with `friend-header.humanizeErrorClass`.
+ */
+/** Next action for a non-auth codex preflight failure, by class. */
+function codexPreflightNextAction(cls) {
+    switch (cls) {
+        case "model":
+            return "Set codex_cli.model in your Onadit config to a model your Codex plan supports; Onadit retries automatically on its next pass.";
+        case "cli_incompatible":
+            return "Codex CLI is too old. Upgrade Codex (e.g. brew upgrade codex, or reinstall); Onadit retries automatically on its next pass.";
+        case "binary":
+            return "Codex CLI could not be launched — check it is installed and on PATH (e.g. brew upgrade codex, or reinstall); Onadit retries automatically on its next pass.";
+        case "rate_limit":
+            return "Codex is rate-limited or out of credits — top up your OpenAI balance or wait for the limit to reset; Onadit retries automatically on its next pass.";
+        case "timeout":
+        case "backend":
+            return "Usually transient — Onadit retries automatically on its next pass.";
+        default:
+            return "Onadit retries automatically on its next pass; check onadit status if it persists.";
+    }
+}
+function humanizeErrorClass(reason) {
+    if (!reason)
+        return "unknown";
+    switch (reason) {
+        case "schema_mismatch":
+            return "index format changed by an update";
+        case "lock_conflict":
+            return "index busy (a concurrent write held the lock)";
+        case "provider_400":
+            return "Voyage rejected the request (often an invalid or revoked key)";
+        case "network":
+            return "a network error reaching Voyage";
+        default:
+            return reason;
+    }
+}
+/**
+ * Build the single issue for a null `/status/friend`, tailored to *why*
+ * the read failed so the next action actually fixes the problem.
+ */
+function unreachableIssue(reason) {
+    switch (reason) {
+        case "config_missing":
+            return {
+                kind: "config_missing",
+                severity: "broken",
+                title: "Onadit is not set up on this Mac yet",
+                detail: "Onadit has no config file, so the command does not know how to " +
+                    "reach the daemon. This usually means onboarding never finished.",
+                nextAction: "Set it up: onadit onboard",
+                daemonObservable: false,
+            };
+        case "not_authenticated":
+            return {
+                kind: "daemon_auth_failed",
+                severity: "broken",
+                title: "Onadit has no access token on this Mac",
+                detail: "The daemon may be running, but this command has no token to " +
+                    "authenticate with it, so it cannot read Onadit's status.",
+                nextAction: "Issue a token: onadit token issue",
+                daemonObservable: false,
+            };
+        case "auth_failed":
+            return {
+                kind: "daemon_auth_failed",
+                severity: "broken",
+                title: "Onadit's daemon rejected this command's token",
+                detail: "The daemon is reachable but refused the token (it may be stale " +
+                    "or from a different install). This is an authentication problem, " +
+                    "not a crashed daemon — restarting will not fix it.",
+                nextAction: "Re-issue a token: onadit token issue",
+                daemonObservable: false,
+            };
+        case "connection_refused":
+        case "unknown":
+        default:
+            return {
+                kind: "daemon_unreachable",
+                severity: "broken",
+                title: "Onadit's background engine is not responding",
+                detail: "The Onadit daemon is the always-on process that captures sessions, " +
+                    "keeps the search index fresh, and answers your AI tools. Right now " +
+                    "nothing can reach it, so capture and memory are paused.",
+                nextAction: "Restart it: launchctl kickstart -k gui/$UID/com.getrift.daemon",
+                daemonObservable: false,
+            };
+    }
+}
+/**
+ * Diagnose Onadit health from the same inputs `onadit status` uses. Pure:
+ * given identical inputs it always returns the same report.
+ */
+export function diagnose(input) {
+    const { status, localSignals, now } = input;
+    const issues = [];
+    // No payload is a root failure, but the *reason* changes the fix:
+    // a down daemon needs a restart, an auth failure needs a fresh token,
+    // and a missing config needs onboarding. Reporting all three as
+    // "restart the daemon" is exactly the misdirection Slice B removes.
+    // All are CLI-side diagnoses (the in-process daemon caller always has a
+    // payload), so none are daemon-observable — a dead/unauthable daemon
+    // cannot notify about itself; that is the Slice D watchdog's job.
+    if (!status) {
+        const issue = unreachableIssue(input.unreachableReason ?? "connection_refused");
+        return { healthy: false, primary: issue, issues: [issue] };
+    }
+    const daemonStartMs = now - status.daemon.uptime_seconds * 1000;
+    // 1. No Voyage key. Import, keyword search and recall work without one,
+    //    so on its own it is a choice, not a fault (as `onadit status` says):
+    //    an advisory that never turns the menu red or raises a banner. Auto-
+    //    capture embeds every conversation it saves, so with capture on a
+    //    missing key is broken: nothing new is being saved.
+    if (!status.daemon.voyage_key_present) {
+        issues.push(status.daemon.capture_enabled
+            ? {
+                kind: "voyage_key_missing",
+                severity: "broken",
+                title: "Capture needs a Voyage key",
+                detail: "Capture saves each conversation with its meaning, which needs a Voyage key, " +
+                    "so nothing new is being saved. Keyword search still works.",
+                nextAction: "Turn on Search by Meaning in Onadit’s Privacy settings, or add your own key: onadit onboard --reconfigure-voyage",
+                daemonObservable: true,
+            }
+            : {
+                kind: "semantic_search_off",
+                severity: "warning",
+                title: "Search by meaning is off",
+                detail: "Keyword search works. Search by meaning also finds conversations that use different words.",
+                nextAction: "Turn it on in Onadit’s Privacy settings, or add your own key: onadit onboard --reconfigure-voyage",
+                daemonObservable: false,
+            });
+    }
+    // 2. Codex preflight failed — auto-capture triage runs through the
+    //    locally-authenticated codex CLI. A failed preflight halts capture, but
+    //    the CAUSE matters: only an actual auth signal warrants "run codex
+    //    login". Everything else (a rejected model, a backend timeout, MCP
+    //    noise) gets a neutral, honest message — never a false login nag.
+    if (status.codex.last_preflight_ok === false) {
+        if (status.codex.last_preflight_worker === "claude") {
+            // Triage runs through the `claude` CLI on this install — every remedy is
+            // Claude-shaped (sign into claude / upgrade / point past a wrapper), never
+            // "codex login". The summary is already the leak-free Claude phrasing.
+            const claudeClass = status.codex.last_preflight_error_class ?? "unknown";
+            if (claudeClass === "auth") {
+                issues.push({
+                    kind: "claude_auth_expired",
+                    severity: "broken",
+                    title: "Claude Code couldn't authenticate",
+                    detail: "Onadit triages your new Claude Code / Codex sessions through the " +
+                        "`claude` CLI on this install, and couldn't authenticate to it, so " +
+                        "automatic capture is paused. Onadit keeps retrying on its own.",
+                    nextAction: "Often clears on its own. If it persists, sign in: run claude and log in",
+                    daemonObservable: true,
+                });
+            }
+            else {
+                issues.push({
+                    kind: "claude_preflight_failed",
+                    severity: "broken",
+                    fingerprint: `claude_preflight_failed:${claudeClass}`,
+                    title: "Claude Code capture probe is failing",
+                    detail: `${status.codex.last_preflight_error_summary ?? "Claude preflight failed."} ` +
+                        "Automatic capture is paused until a probe succeeds; recent " +
+                        "conversations are safe on disk and will be captured once it clears.",
+                    nextAction: claudePreflightNextAction(claudeClass),
+                    daemonObservable: true,
+                });
+            }
+        }
+        else if (status.codex.last_preflight_error_class === "auth") {
+            issues.push({
+                kind: "codex_auth_expired",
+                severity: "broken",
+                title: "Codex couldn't authenticate",
+                detail: "Onadit reads your new Claude Code / Codex sessions through the codex " +
+                    "CLI, and couldn't authenticate to it, so automatic capture is " +
+                    "paused. Onadit keeps retrying on its own.",
+                nextAction: "Often clears on its own. If it persists, sign in: codex login",
+                daemonObservable: true,
+            });
+        }
+        else {
+            issues.push({
+                kind: "codex_preflight_failed",
+                severity: "broken",
+                fingerprint: `codex_preflight_failed:${status.codex.last_preflight_error_class ?? "unknown"}`,
+                title: "Codex capture probe is failing",
+                detail: `${status.codex.last_preflight_error_summary ?? "Codex preflight failed."} ` +
+                    "Your codex login looks fine — this is not an auth problem. " +
+                    "Automatic capture is paused until a probe succeeds; recent " +
+                    "conversations are safe on disk and will be captured once it clears.",
+                nextAction: codexPreflightNextAction(
+                // This branch only runs for the Codex worker, so the class is a
+                // Codex class; narrow the worker-union field back for the helper.
+                status.codex.last_preflight_error_class ?? null),
+                daemonObservable: true,
+            });
+        }
+    }
+    // 3. Voyage embedding errors during this uptime — the key is present
+    //    but Voyage is rejecting/dropping calls (often an invalid key or
+    //    a network problem). Recency-gated so a prior process's error
+    //    does not haunt a healthy respawn.
+    if (isCurrentUptime(status.voyage.last_error_at, daemonStartMs)) {
+        issues.push({
+            kind: "voyage_embed_errors",
+            severity: "broken",
+            fingerprint: `voyage_embed_errors:${status.voyage.last_error_reason ?? "unknown"}`,
+            title: "Search indexing is failing at the Voyage step",
+            detail: "Onadit could not turn recent text into searchable meaning: " +
+                `${humanizeErrorClass(status.voyage.last_error_reason)}. New content ` +
+                "may not be findable until this clears.",
+            nextAction: "Inspect with onadit status, then check the Voyage key with " +
+                "onadit onboard --reconfigure-voyage if errors mention the key",
+            daemonObservable: true,
+        });
+    }
+    // 4. Index write errors during this uptime — text embedded fine, but
+    //    the LanceDB write failed (schema mismatch, lock, IO). Distinct
+    //    from Voyage: "embedded" does not imply "searchable".
+    if (isCurrentUptime(status.index.last_error_at, daemonStartMs)) {
+        issues.push({
+            kind: "index_write_errors",
+            severity: "broken",
+            fingerprint: `index_write_errors:${status.index.last_error_reason ?? "unknown"}`,
+            title: "Search index writes are failing",
+            detail: "Onadit embedded recent text but could not write it to the search " +
+                `index: ${humanizeErrorClass(status.index.last_error_reason)}. ` +
+                "Recently captured items may not be searchable yet.",
+            nextAction: "Inspect with onadit status, then try: onadit reindex",
+            daemonObservable: true,
+        });
+    }
+    // 5. Capture run failed during this uptime — the auto-capture loop
+    //    itself threw (distinct from a Codex preflight failure, which is
+    //    reported above with a more specific action).
+    if (status.capture.last_errors > 0 &&
+        isCurrentUptime(status.capture.last_run_at, daemonStartMs)) {
+        issues.push({
+            kind: "capture_failed",
+            severity: "broken",
+            title: "The last capture run reported errors",
+            detail: "Onadit's automatic capture ran but hit errors while saving sessions, " +
+                "so some recent conversations may not have been stored.",
+            nextAction: "Onadit retries the failed sessions automatically on its next pass; check onadit status if it persists.",
+            daemonObservable: true,
+        });
+    }
+    // 5b. Scheduled capture is failing, but a more recent manual `rift
+    //     capture` succeeded. The honest middle state: capture works right
+    //     now (so this is NOT broken), but the daemon's own loop is still
+    //     failing and must not be laundered green by the manual success. It
+    //     clears itself once the daemon records a healthy run. CLI-side
+    //     reconciliation, so not daemon-observable — the daemon never sees
+    //     the manual run, and its own failures already notify via
+    //     capture_failed/codex_auth_expired while they are the newest row.
+    if (status.capture.last_daemon_failed === true &&
+        isCurrentUptime(status.capture.last_daemon_run_at ?? null, daemonStartMs) &&
+        status.capture.last_run_trigger != null &&
+        status.capture.last_run_trigger !== "daemon" &&
+        status.capture.last_run_ok === true &&
+        status.capture.last_errors === 0) {
+        issues.push({
+            kind: "capture_daemon_stale",
+            severity: "warning",
+            title: "Automatic capture last failed — recent capture is working",
+            detail: "Your most recent capture ran fine, but the daemon's last scheduled " +
+                "capture failed. Capture works right now; the automatic loop will " +
+                "re-check on its next scheduled run.",
+            // Capture is working, so the calm, friend-facing action is to do
+            // nothing: the next scheduled tick re-checks and clears this on its
+            // own. Deliberately NO `launchctl kickstart` here — that operator
+            // machinery is too scary for a recovery path where nothing is broken
+            // right now. (A friend-safe `rift daemon restart` is a future affordance.)
+            nextAction: "Nothing to do — the next automatic capture will re-check and clear " +
+                "this on its own.",
+            daemonObservable: false,
+        });
+    }
+    // 6. Inbox import errors — user-side: a dropped export was rejected
+    //    (malformed JSON, corrupt zip, unsupported source). The fix is to
+    //    re-drop a fresh export, not to repair the engine. Warning.
+    if (status.inbox &&
+        isCurrentUptime(status.inbox.last_error_at, daemonStartMs)) {
+        issues.push({
+            kind: "inbox_import_errors",
+            severity: "warning",
+            title: "A dropped import could not be read",
+            detail: "Onadit tried to import a file from your inbox folder but could not " +
+                `read it (${status.inbox.last_error_reason ?? "unknown reason"}). ` +
+                "This is usually a corrupt or unsupported export, not an Onadit fault.",
+            nextAction: "Re-export and drop a fresh archive under data/inbox/",
+            // User-side; the daemon observes it but the plan scopes
+            // notifications to engine failures, not rejected user input.
+            daemonObservable: false,
+        });
+    }
+    // 7. MCP not installed for one or more clients — degraded reach, not a
+    //    broken engine. Warning.
+    const missing = localSignals.mcpClients
+        .filter((c) => !c.installed)
+        .map((c) => c.client);
+    if (missing.length > 0) {
+        issues.push({
+            kind: "mcp_not_installed",
+            severity: "warning",
+            title: `Onadit is not connected to ${missing.join(", ")}`,
+            detail: "MCP is the connection that lets your AI tools ask Onadit for memory. " +
+                `These tools are not wired up yet: ${missing.join(", ")}.`,
+            nextAction: `Connect one: onadit mcp install --client=${missing[0]}`,
+            daemonObservable: false,
+        });
+    }
+    // 7a. Rules left on the earlier names. A connection only changes names when
+    //     the person moves it; a rule of their own that still names an earlier
+    //     tool then quietly stops matching.
+    const earlier = localSignals.earlierNames;
+    if (earlier && earlier.files.length > 0) {
+        issues.push({
+            kind: "earlier_names_left",
+            severity: "warning",
+            title: "Some of your rules still use Onadit's earlier tool names",
+            detail: `These files of yours still name the earlier tools: ${earlier.files.join(", ")}. ` +
+                "The connection now uses the new names, so those lines no longer match. Onadit does not edit them. " +
+                `Replace ${PREVIOUS_SERVER_NAME}_ with ${SERVER_NAME}_ and mcp__${PREVIOUS_SERVER_NAME}__ with mcp__${SERVER_NAME}__.`,
+            nextAction: `Edit ${earlier.files[0]}`,
+            daemonObservable: false,
+        });
+    }
+    // 7b. SwiftBar missing — the menu plugin is installed but the app that
+    //     draws it is not, so the Onadit menu bar icon will never appear. Degraded
+    //     surface, not a broken engine (capture/search/memory all work headless),
+    //     so it is a warning. Only fires when we actually probed it on macOS and
+    //     found it absent; null (non-macOS / unprobed) stays silent.
+    if (localSignals.swiftBar && localSignals.swiftBar.installed === false) {
+        issues.push({
+            kind: "menu_bar_unavailable",
+            severity: "warning",
+            title: "Onadit's menu bar icon can't show — SwiftBar isn't installed",
+            detail: "Onadit installed its menu plugin, but SwiftBar — the free app that " +
+                "draws the icon in your menu bar — is not present, so the icon will " +
+                "not appear. Onadit still captures and searches in the background.",
+            nextAction: "Install SwiftBar from swiftbar.app (or brew install --cask swiftbar if " +
+                "you use Homebrew), then: onadit menubar install",
+            daemonObservable: false,
+        });
+    }
+    // 7c. Menu plugin is a DANGLING symlink — a legacy install symlinked
+    //     `rift.10s.sh` into the package root, which npm/Homebrew later moved or
+    //     deleted, so SwiftBar now runs a broken link and the icon misbehaves.
+    //     Reinstalling lays down a self-contained copy. Degraded surface, not a
+    //     broken engine → warning. ONLY when SwiftBar is installed: with the app
+    //     absent, 7b already says "install SwiftBar" and "reinstall the plugin"
+    //     would be the wrong next step (the plugin can't show regardless).
+    if (localSignals.swiftBar?.installed && localSignals.swiftBar.pluginDangling) {
+        issues.push({
+            kind: "menu_bar_broken",
+            severity: "warning",
+            title: "Onadit's menu bar plugin is broken — it points at a file that's gone",
+            detail: "Onadit's menu plugin is a stale shortcut into an old install location " +
+                "that has since moved, so SwiftBar can't run it and the icon won't " +
+                "update. Reinstalling replaces it with a self-contained copy. Onadit " +
+                "still captures and searches in the background.",
+            nextAction: "Reinstall the menu plugin: onadit menubar install",
+            daemonObservable: false,
+        });
+    }
+    // 8. Oversized sessions parked in quarantine — not in memory yet, but a
+    //    graceful skip rather than an error, and one that now SELF-REPAIRS in
+    //    the background. So the copy follows the repair state, not a bare count:
+    //    - still within the retry budget → "Onadit is saving these", no command;
+    //    - retries exhausted → the honest manual fallback (and only then does
+    //      the obscure repair command appear).
+    //    Counts distinct sessions whose latest version is still un-recovered
+    //    (state of the world), not the most recent run's quarantine count.
+    const parked = status.capture.oversized_parked ?? 0;
+    const repairFailed = status.capture.oversized_repair_failed ?? 0;
+    const repairing = status.capture.oversized_repairing ?? Math.max(parked - repairFailed, 0);
+    if (repairFailed > 0) {
+        issues.push({
+            kind: "capture_quarantined",
+            severity: "warning",
+            title: `${repairFailed} large Codex session${repairFailed === 1 ? "" : "s"} could not be saved automatically`,
+            detail: "Onadit tried several times to save these large sessions in the " +
+                "background and could not. They are safe on disk, just not searchable " +
+                "yet — a manual run will summarize and save them.",
+            nextAction: "Save them now: onadit doctor repair capture-large-sessions",
+            daemonObservable: false,
+        });
+    }
+    if (repairing > 0) {
+        issues.push({
+            kind: "capture_repairing",
+            severity: "warning",
+            title: `Onadit is saving ${repairing} large Codex session${repairing === 1 ? "" : "s"} to memory`,
+            detail: "These sessions were too large to capture in one pass, so Onadit is " +
+                "recovering them in the background. They are safe on disk and will " +
+                "become searchable once recovery finishes — no action needed.",
+            nextAction: "Nothing to do — Onadit is saving these in the background and will keep retrying.",
+            daemonObservable: false,
+        });
+    }
+    // 9. Update available — informational nudge, lowest priority.
+    if (status.update.available && status.update.latest_beta) {
+        // A packaged (.pkg) install cannot self-update — `onadit update` refuses it
+        // — so the action must be the .pkg download, never `onadit update`. Only an
+        // explicit `false` flips it: an older daemon that predates the field
+        // (`undefined`) keeps the historical `onadit update` nudge.
+        const canSelfUpdate = status.update.self_update_supported !== false;
+        issues.push({
+            kind: "update_available",
+            severity: "warning",
+            title: `A newer Onadit is available (${status.update.installed} → ${status.update.latest_beta})`,
+            detail: "A newer beta build is published.",
+            nextAction: status.update.reinstall_needed
+                ? `Run the installer again: ${REINSTALL_COMMAND}`
+                : canSelfUpdate
+                    ? "Update now: onadit update"
+                    : `Download the latest .pkg: ${RIFT_DOWNLOAD_URL}`,
+            daemonObservable: false,
+        });
+    }
+    const healthy = !issues.some((i) => i.severity === "broken");
+    // Lead with the most severe issue: the first `broken` if any, else the
+    // first issue. Broken issues are already pushed ahead of warnings, so
+    // this also keeps `primary` stable if the positional order ever shifts.
+    const primary = issues.find((i) => i.severity === "broken") ?? issues[0] ?? null;
+    return { healthy, primary, issues };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/diagnostics/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/diagnostics/doctor.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EACL,yBAAyB,GAE1B,MAAM,uBAAuB,CAAC;AAwH/B;;;;;GAKG;AACH,SAAS,eAAe,CAAC,GAAkB,EAAE,aAAqB;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,EAAE,IAAI,aAAa,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,oEAAoE;AACpE,SAAS,wBAAwB,CAC/B,GAAoC;IAEpC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,+HAA+H,CAAC;QACzI,KAAK,kBAAkB;YACrB,OAAO,6HAA6H,CAAC;QACvI,KAAK,QAAQ;YACX,OAAO,6JAA6J,CAAC;QACvK,KAAK,YAAY;YACf,OAAO,qJAAqJ,CAAC;QAC/J,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,oEAAoE,CAAC;QAC9E;YACE,OAAO,oFAAoF,CAAC;IAChG,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAqB;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,iBAAiB;YACpB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,eAAe;YAClB,OAAO,+CAA+C,CAAC;QACzD,KAAK,cAAc;YACjB,OAAO,+DAA+D,CAAC;QACzE,KAAK,SAAS;YACZ,OAAO,iCAAiC,CAAC;QAC3C;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,MAA+B;IACvD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB;YACnB,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,sCAAsC;gBAC7C,MAAM,EACJ,iEAAiE;oBACjE,iEAAiE;gBACnE,UAAU,EAAE,2BAA2B;gBACvC,gBAAgB,EAAE,KAAK;aACxB,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,wCAAwC;gBAC/C,MAAM,EACJ,8DAA8D;oBAC9D,0DAA0D;gBAC5D,UAAU,EAAE,mCAAmC;gBAC/C,gBAAgB,EAAE,KAAK;aACxB,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,+CAA+C;gBACtD,MAAM,EACJ,iEAAiE;oBACjE,mEAAmE;oBACnE,oDAAoD;gBACtD,UAAU,EAAE,sCAAsC;gBAClD,gBAAgB,EAAE,KAAK;aACxB,CAAC;QACJ,KAAK,oBAAoB,CAAC;QAC1B,KAAK,SAAS,CAAC;QACf;YACE,OAAO;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,8CAA8C;gBACrD,MAAM,EACJ,qEAAqE;oBACrE,qEAAqE;oBACrE,yDAAyD;gBAC3D,UAAU,EACR,gEAAgE;gBAClE,gBAAgB,EAAE,KAAK;aACxB,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAkB;IACzC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,kEAAkE;IAClE,sEAAsE;IACtE,gEAAgE;IAChE,oEAAoE;IACpE,wEAAwE;IACxE,qEAAqE;IACrE,kEAAkE;IAClE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,iBAAiB,IAAI,oBAAoB,CAAC,CAAC;QAChF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,aAAa,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAEhE,wEAAwE;IACxE,0EAA0E;IAC1E,yEAAyE;IACzE,sEAAsE;IACtE,wDAAwD;IACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,MAAM,CAAC,eAAe;YAC3B,CAAC,CAAC;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,4BAA4B;gBACnC,MAAM,EACJ,8EAA8E;oBAC9E,4DAA4D;gBAC9D,UAAU,EACR,kHAAkH;gBACpH,gBAAgB,EAAE,IAAI;aACvB;YACH,CAAC,CAAC;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,SAAS;gBACnB,KAAK,EAAE,0BAA0B;gBACjC,MAAM,EACJ,4FAA4F;gBAC9F,UAAU,EACR,mGAAmG;gBACrG,gBAAgB,EAAE,KAAK;aACxB,CACN,CAAC;IACJ,CAAC;IAED,mEAAmE;IACnE,4EAA4E;IAC5E,uEAAuE;IACvE,uEAAuE;IACvE,sEAAsE;IACtE,IAAI,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,KAAK,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,QAAQ,EAAE,CAAC;YACpD,yEAAyE;YACzE,2EAA2E;YAC3E,uEAAuE;YACvE,MAAM,WAAW,GACd,MAAM,CAAC,KAAK,CAAC,0BAEL,IAAI,SAAS,CAAC;YACzB,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,qBAAqB;oBAC3B,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,mCAAmC;oBAC1C,MAAM,EACJ,mEAAmE;wBACnE,oEAAoE;wBACpE,gEAAgE;oBAClE,UAAU,EACR,yEAAyE;oBAC3E,gBAAgB,EAAE,IAAI;iBACvB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,yBAAyB;oBAC/B,QAAQ,EAAE,QAAQ;oBAClB,WAAW,EAAE,2BAA2B,WAAW,EAAE;oBACrD,KAAK,EAAE,sCAAsC;oBAC7C,MAAM,EACJ,GAAG,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,0BAA0B,GAAG;wBAC7E,6DAA6D;wBAC7D,qEAAqE;oBACvE,UAAU,EAAE,yBAAyB,CAAC,WAAW,CAAC;oBAClD,gBAAgB,EAAE,IAAI;iBACvB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,MAAM,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,6BAA6B;gBACpC,MAAM,EACJ,uEAAuE;oBACvE,gEAAgE;oBAChE,2CAA2C;gBAC7C,UAAU,EAAE,+DAA+D;gBAC3E,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,wBAAwB;gBAC9B,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE,0BAA0B,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,SAAS,EAAE;gBAC7F,KAAK,EAAE,gCAAgC;gBACvC,MAAM,EACJ,GAAG,MAAM,CAAC,KAAK,CAAC,4BAA4B,IAAI,yBAAyB,GAAG;oBAC5E,6DAA6D;oBAC7D,6DAA6D;oBAC7D,qEAAqE;gBACvE,UAAU,EAAE,wBAAwB;gBAClC,gEAAgE;gBAChE,kEAAkE;gBACjE,MAAM,CAAC,KAAK,CAAC,0BAEL,IAAI,IAAI,CAClB;gBACD,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,qEAAqE;IACrE,kEAAkE;IAClE,uCAAuC;IACvC,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,uBAAuB,MAAM,CAAC,MAAM,CAAC,iBAAiB,IAAI,SAAS,EAAE;YAClF,KAAK,EAAE,+CAA+C;YACtD,MAAM,EACJ,6DAA6D;gBAC7D,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,gBAAgB;gBACtE,wCAAwC;YAC1C,UAAU,EACR,6DAA6D;gBAC7D,+DAA+D;YACjE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IACrE,oEAAoE;IACpE,0DAA0D;IAC1D,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,sBAAsB,MAAM,CAAC,KAAK,CAAC,iBAAiB,IAAI,SAAS,EAAE;YAChF,KAAK,EAAE,iCAAiC;YACxC,MAAM,EACJ,mEAAmE;gBACnE,UAAU,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI;gBAChE,oDAAoD;YACtD,UAAU,EAAE,sDAAsD;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,qEAAqE;IACrE,kDAAkD;IAClD,IACE,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,CAAC;QAC9B,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,EAC1D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,sCAAsC;YAC7C,MAAM,EACJ,uEAAuE;gBACvE,wDAAwD;YAC1D,UAAU,EACR,wGAAwG;YAC1G,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,oEAAoE;IACpE,uEAAuE;IACvE,8DAA8D;IAC9D,uEAAuE;IACvE,IACE,MAAM,CAAC,OAAO,CAAC,kBAAkB,KAAK,IAAI;QAC1C,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,IAAI,IAAI,EAAE,aAAa,CAAC;QACzE,MAAM,CAAC,OAAO,CAAC,gBAAgB,IAAI,IAAI;QACvC,MAAM,CAAC,OAAO,CAAC,gBAAgB,KAAK,QAAQ;QAC5C,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI;QACnC,MAAM,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,EAChC,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,2DAA2D;YAClE,MAAM,EACJ,qEAAqE;gBACrE,mEAAmE;gBACnE,qCAAqC;YACvC,iEAAiE;YACjE,oEAAoE;YACpE,kEAAkE;YAClE,qEAAqE;YACrE,2EAA2E;YAC3E,UAAU,EACR,qEAAqE;gBACrE,kBAAkB;YACpB,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,sEAAsE;IACtE,gEAAgE;IAChE,IACE,MAAM,CAAC,KAAK;QACZ,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,aAAa,CAAC,EAC1D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,oCAAoC;YAC3C,MAAM,EACJ,qEAAqE;gBACrE,YAAY,MAAM,CAAC,KAAK,CAAC,iBAAiB,IAAI,gBAAgB,KAAK;gBACnE,uEAAuE;YACzE,UAAU,EAAE,sDAAsD;YAClE,wDAAwD;YACxD,6DAA6D;YAC7D,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,6BAA6B;IAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACzD,MAAM,EACJ,uEAAuE;gBACvE,qCAAqC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC5D,UAAU,EAAE,4CAA4C,OAAO,CAAC,CAAC,CAAC,EAAE;YACpE,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,wCAAwC;IACxC,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC;IAC1C,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,oBAAoB;YAC1B,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,0DAA0D;YACjE,MAAM,EACJ,sDAAsD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAClF,oGAAoG;gBACpG,WAAW,oBAAoB,UAAU,WAAW,cAAc,oBAAoB,gBAAgB,WAAW,KAAK;YACxH,UAAU,EAAE,QAAQ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACtC,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,+EAA+E;IAC/E,8EAA8E;IAC9E,6EAA6E;IAC7E,iEAAiE;IACjE,IAAI,YAAY,CAAC,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,8DAA8D;YACrE,MAAM,EACJ,qEAAqE;gBACrE,qEAAqE;gBACrE,mEAAmE;YACrE,UAAU,EACR,yEAAyE;gBACzE,iDAAiD;YACnD,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,qEAAqE;IACrE,6EAA6E;IAC7E,2EAA2E;IAC3E,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,uEAAuE;IACvE,IAAI,YAAY,CAAC,QAAQ,EAAE,SAAS,IAAI,YAAY,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,sEAAsE;YAC7E,MAAM,EACJ,wEAAwE;gBACxE,oEAAoE;gBACpE,sEAAsE;gBACtE,gDAAgD;YAClD,UAAU,EAAE,mDAAmD;YAC/D,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,0EAA0E;IAC1E,6EAA6E;IAC7E,6EAA6E;IAC7E,0EAA0E;IAC1E,2CAA2C;IAC3C,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,IAAI,CAAC,CAAC;IACjE,MAAM,SAAS,GACb,MAAM,CAAC,OAAO,CAAC,mBAAmB,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC;IAC3E,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,GAAG,YAAY,uBAAuB,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mCAAmC;YAC7G,MAAM,EACJ,iEAAiE;gBACjE,uEAAuE;gBACvE,kDAAkD;YACpD,UAAU,EAAE,4DAA4D;YACxE,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,oBAAoB,SAAS,uBAAuB,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY;YACjG,MAAM,EACJ,qEAAqE;gBACrE,oEAAoE;gBACpE,8DAA8D;YAChE,UAAU,EACR,kFAAkF;YACpF,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACzD,4EAA4E;QAC5E,4EAA4E;QAC5E,qEAAqE;QACrE,4DAA4D;QAC5D,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,KAAK,KAAK,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,kBAAkB;YACxB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,gCAAgC,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,GAAG;YAChG,MAAM,EAAE,kCAAkC;YAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB;gBACxC,CAAC,CAAC,4BAA4B,iBAAiB,EAAE;gBACjD,CAAC,CAAC,aAAa;oBACb,CAAC,CAAC,2BAA2B;oBAC7B,CAAC,CAAC,6BAA6B,iBAAiB,EAAE;YACtD,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC7D,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACnE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/src/diagnostics/install-layout.d.ts

@@ -0,0 +1,40 @@
+/** Which install shape the daemon launches from. */
+export type DaemonLayout = "packaged" | "npm" | "unknown";
+/**
+ * The packaged (.pkg) install lays the daemon down under this home-relative
+ * path (build-installer.sh's `INSTALL_LOCATION`); the bundled node + app JS
+ * live inside it. A daemon `main.js` under this segment is therefore a
+ * packaged install that `npm install -g` cannot upgrade.
+ */
+export declare const PACKAGED_PATH_MARKER: string;
+/**
+ * Classify the install from the daemon's entrypoint path:
+ *   - null path (unreadable) → "unknown": treat as npm-shaped so the update
+ *     flow proceeds and the daemon /version check catches a non-update honestly.
+ *   - path under the packaged app-support bundle → "packaged": npm can't
+ *     upgrade it.
+ *   - anything else (npm global module dir, dev checkout) → "npm".
+ */
+export declare function classifyDaemonLayout(mainPath: string | null): DaemonLayout;
+/**
+ * Whether `onadit update`'s npm self-upgrade can actually replace what this
+ * entrypoint runs. A packaged (.pkg) daemon runs from a bundled app `npm
+ * install -g` never touches, so it is NOT self-updatable — every "update"
+ * surface must point at the .pkg download instead of `onadit update`. An
+ * unknown/empty path is treated as self-updatable (the optimistic npm default
+ * that `onadit update` itself uses).
+ */
+export declare function selfUpdateSupported(entrypoint: string | null): boolean;
+/** Where friends download the latest signed .pkg when self-update can't run. */
+export declare const RIFT_DOWNLOAD_URL = "https://onadit.com/download";
+/** The npm name the package had before the product was renamed. */
+export declare const PREVIOUS_PACKAGE_NAME = "@getrift/rift";
+/**
+ * Moves a copy installed under the earlier npm name to the current package.
+ * npm cannot rename an installed package, and both names own the same
+ * commands, so the installer removes one and installs the other.
+ */
+export declare const REINSTALL_COMMAND = "curl -fsSL https://onadit.com/install | bash";
+/** True when a copy runs from the package under its earlier npm name: `onadit update` cannot upgrade it. */
+export declare function installedAsPreviousPackage(packageName: string): boolean;
+//# sourceMappingURL=install-layout.d.ts.map

package/dist/src/diagnostics/install-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-layout.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/install-layout.ts"],"names":[],"mappings":"AAUA,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAA+E,CAAC;AAEjH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAG1E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEtE;AAED,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAE/D,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,iDAAiD,CAAC;AAEhF,4GAA4G;AAC5G,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvE"}