onadit 0.0.1 → 0.1.0-beta.45

package/dist/src/diagnostics/install-layout.js

@@ -0,0 +1,55 @@
+/**
+ * How the Onadit daemon was installed, derived from the entrypoint path it
+ * launches from. The single source of truth for one product question:
+ * "can `onadit update` upgrade this install in place, or must the friend
+ * reinstall the .pkg?" Every update-facing surface (the `onadit update`
+ * command, `onadit status`, `onadit doctor`, the SwiftBar menu) must agree on
+ * the answer, so the classification lives here and nowhere else.
+ */
+import path from "node:path";
+/**
+ * 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 const PACKAGED_PATH_MARKER = `${path.sep}Library${path.sep}Application Support${path.sep}Rift${path.sep}`; // rename:keep data folder name; a packaged install is recognised by it
+/**
+ * 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 function classifyDaemonLayout(mainPath) {
+    if (!mainPath)
+        return "unknown";
+    return mainPath.includes(PACKAGED_PATH_MARKER) ? "packaged" : "npm";
+}
+/**
+ * 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 function selfUpdateSupported(entrypoint) {
+    return classifyDaemonLayout(entrypoint) !== "packaged";
+}
+/** Where friends download the latest signed .pkg when self-update can't run. */
+export const RIFT_DOWNLOAD_URL = "https://onadit.com/download";
+/** The npm name the package had before the product was renamed. */
+export const PREVIOUS_PACKAGE_NAME = "@getrift/rift"; // rename:keep the package's earlier npm name
+/**
+ * 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 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 function installedAsPreviousPackage(packageName) {
+    return packageName === PREVIOUS_PACKAGE_NAME;
+}
+//# sourceMappingURL=install-layout.js.map

package/dist/src/diagnostics/install-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-layout.js","sourceRoot":"","sources":["../../../src/diagnostics/install-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,IAAI,CAAC,GAAG,UAAU,IAAI,CAAC,GAAG,sBAAsB,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,uEAAuE;AAEzL;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAyB;IAC3D,OAAO,oBAAoB,CAAC,UAAU,CAAC,KAAK,UAAU,CAAC;AACzD,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AAE/D,mEAAmE;AACnE,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,CAAC,6CAA6C;AAEnG;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,8CAA8C,CAAC;AAEhF,4GAA4G;AAC5G,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,OAAO,WAAW,KAAK,qBAAqB,CAAC;AAC/C,CAAC"}

package/dist/src/diagnostics/memory-coverage.d.ts

@@ -0,0 +1,54 @@
+import type { Config } from "../config/schema.js";
+import type { CapabilityCounts } from "../observability/rift-context.js";
+import type { SelectedMetadataProvider } from "../providers/conversation-generation.js";
+export type DocumentCoverageStatus = "indexed" | "not_configured" | "source_missing" | "source_empty" | "embedding_unavailable" | "backfill_needed" | "unknown";
+export type DigestCoverageStatus = "indexed" | "unavailable_basic" | "unavailable_claude" | "unavailable_worker" | "available_not_run" | "unknown";
+export interface MemoryCoverageCounts {
+    conversations: number;
+    digests: number;
+    structured_docs: number;
+}
+export interface DocumentCoverageDiagnostics {
+    status: DocumentCoverageStatus;
+    /**
+     * True only when the filesystem source probe actually ran (i.e. docs == 0 and
+     * we owed the user a reason). When false — the healthy `indexed` steady state
+     * or a counts-unavailable `unknown` — the source/file fields below are
+     * placeholders, not measurements, and renderers must not present them as such.
+     */
+    probed: boolean;
+    configured_sources: number;
+    existing_sources: number;
+    cloud_sources: number;
+    local_sources: number;
+    sources_with_supported_files: number;
+    supported_files_seen: number;
+    cloud_supported_files_seen: number;
+    local_supported_files_seen: number;
+    scan_limit: number;
+    scan_limited: boolean;
+    cloud_embedding_ready: boolean;
+    summary: string;
+    next_action: string | null;
+}
+export interface DigestCoverageDiagnostics {
+    status: DigestCoverageStatus;
+    metadata_provider: SelectedMetadataProvider;
+    compact_available: boolean;
+    summary: string;
+    next_action: string | null;
+}
+export interface MemoryCoverageDiagnostics {
+    counts: MemoryCoverageCounts | null;
+    digests: DigestCoverageDiagnostics;
+    documents: DocumentCoverageDiagnostics;
+}
+export interface BuildMemoryCoverageInput {
+    config: Config;
+    counts: CapabilityCounts | null;
+    voyageKeyPresent: boolean;
+    compactAvailable: boolean;
+    supportedFileScanLimit?: number;
+}
+export declare function buildMemoryCoverageDiagnostics(input: BuildMemoryCoverageInput): MemoryCoverageDiagnostics;
+//# sourceMappingURL=memory-coverage.d.ts.map

package/dist/src/diagnostics/memory-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-coverage.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/memory-coverage.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAKxF,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,uBAAuB,GACvB,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,mBAAmB,GACnB,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;;;OAKG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B,EAAE,MAAM,CAAC;IACrC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,0BAA0B,EAAE,MAAM,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,yBAAyB,CAAC;IACnC,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAQD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,CAyB3B"}

package/dist/src/diagnostics/memory-coverage.js

@@ -0,0 +1,272 @@
+/**
+ * Memory coverage diagnostics for status surfaces.
+ *
+ * Counts alone are not enough: "0 digests" can mean AI enrichment is off,
+ * Claude was selected (no digest worker yet), or compaction simply has not run.
+ * "0 structured docs" can mean no sources, empty sources, missing embeddings,
+ * or a watch-mode backfill gap. This module turns config + cheap filesystem
+ * probes + table counts into explicit, leak-safe reasons.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { buildIgnoredPaths } from "../ingestion/ignored-paths.js";
+import { isSupported } from "../ingestion/extractor.js";
+import { isWatcherPathIgnored } from "../ingestion/watcher.js";
+const DEFAULT_SUPPORTED_FILE_SCAN_LIMIT = 100;
+const DEFAULT_SOURCE_ENTRY_SCAN_LIMIT = 1_000;
+export function buildMemoryCoverageDiagnostics(input) {
+    const counts = input.counts
+        ? {
+            conversations: input.counts.conversations_hot + input.counts.conversations_cold,
+            digests: input.counts.digests,
+            structured_docs: input.counts.structured_docs,
+        }
+        : null;
+    return {
+        counts,
+        digests: buildDigestCoverage({
+            config: input.config,
+            counts,
+            compactAvailable: input.compactAvailable,
+        }),
+        documents: buildDocumentCoverage({
+            config: input.config,
+            counts,
+            voyageKeyPresent: input.voyageKeyPresent,
+            supportedFileScanLimit: input.supportedFileScanLimit ?? DEFAULT_SUPPORTED_FILE_SCAN_LIMIT,
+        }),
+    };
+}
+function selectedMetadataProvider(config) {
+    if (config.local_generation?.enabled === true)
+        return "ollama";
+    if (config.enrichment?.ai_metadata !== true)
+        return "basic";
+    return config.enrichment.metadata?.provider ?? "codex_cli";
+}
+function buildDigestCoverage(input) {
+    const provider = selectedMetadataProvider(input.config);
+    if (!input.counts) {
+        return {
+            status: "unknown",
+            metadata_provider: provider,
+            compact_available: input.compactAvailable,
+            summary: "Digest coverage could not be counted.",
+            next_action: "Run: onadit status --json",
+        };
+    }
+    if (input.counts.digests > 0) {
+        return {
+            status: "indexed",
+            metadata_provider: provider,
+            compact_available: input.compactAvailable,
+            summary: `${input.counts.digests} digest${input.counts.digests === 1 ? "" : "s"} indexed.`,
+            next_action: null,
+        };
+    }
+    if (provider === "basic") {
+        return {
+            status: "unavailable_basic",
+            metadata_provider: provider,
+            compact_available: input.compactAvailable,
+            summary: "No digests because AI enrichment is off, so no digest worker is registered.",
+            next_action: "Enable a digest worker, e.g. onadit onboard --enable-codex-enrichment, then run onadit compact.",
+        };
+    }
+    if (provider === "claude_code") {
+        return {
+            status: "unavailable_claude",
+            metadata_provider: provider,
+            compact_available: input.compactAvailable,
+            summary: "No digests because Claude Code metadata is selected, but Claude digest support has not shipped yet.",
+            next_action: "Use Codex or Ollama for digest generation for now; keep Claude metadata if you do not need digests.",
+        };
+    }
+    if (!input.compactAvailable) {
+        return {
+            status: "unavailable_worker",
+            metadata_provider: provider,
+            compact_available: input.compactAvailable,
+            summary: "No digests because the compact/digest worker is not available in this daemon.",
+            next_action: "Run: onadit doctor",
+        };
+    }
+    // We know only that a digest-capable worker is registered and the digest
+    // count is zero — NOT that compaction never ran. A corpus younger than the
+    // compaction age threshold legitimately has a working worker, compaction
+    // having run repeatedly, and still zero digests. Stay honest about that.
+    return {
+        status: "available_not_run",
+        metadata_provider: provider,
+        compact_available: input.compactAvailable,
+        summary: "No digests yet. A digest worker is available, but nothing has been compacted into a digest — either no conversation has reached the compaction age threshold, or compaction has not run.",
+        next_action: "Run: onadit compact --dry-run to see what would be compacted.",
+    };
+}
+function buildDocumentCoverage(input) {
+    const sources = input.config.sources ?? [];
+    // Config-derived fields only (no filesystem touch). The probe-derived fields
+    // stay zeroed and `probed` stays false until we actually walk the sources.
+    const configDerived = {
+        probed: false,
+        configured_sources: sources.length,
+        existing_sources: 0,
+        cloud_sources: sources.filter((s) => s.extraction === "cloud").length,
+        local_sources: sources.filter((s) => s.extraction === "local").length,
+        sources_with_supported_files: 0,
+        supported_files_seen: 0,
+        cloud_supported_files_seen: 0,
+        local_supported_files_seen: 0,
+        scan_limit: input.supportedFileScanLimit,
+        scan_limited: false,
+        cloud_embedding_ready: input.voyageKeyPresent,
+    };
+    // Counts unavailable: nothing to conclude, and probing can't diagnose without
+    // a baseline count. Degrade to "unknown" without touching the filesystem.
+    if (!input.counts) {
+        return {
+            ...configDerived,
+            status: "unknown",
+            summary: "Structured-document coverage could not be counted.",
+            next_action: "Run: onadit status --json",
+        };
+    }
+    // Healthy steady state: documents are already indexed, so we owe no
+    // explanation and skip the probe entirely. `onadit status --json` is polled
+    // ~every 10s by the menu bar; walking every configured source tree on each
+    // poll once docs exist is pure waste — the probe only earns its cost when
+    // docs == 0.
+    if (input.counts.structured_docs > 0) {
+        return {
+            ...configDerived,
+            status: "indexed",
+            summary: `${input.counts.structured_docs} structured document${input.counts.structured_docs === 1 ? "" : "s"} indexed.`,
+            next_action: null,
+        };
+    }
+    // Zero docs: probe the sources to explain why.
+    const probes = sources.map((source) => probeSource(source, input.config, input.supportedFileScanLimit));
+    const existingSources = probes.filter((p) => p.exists).length;
+    const supportedFilesSeen = sum(probes.map((p) => p.supportedFilesSeen));
+    const scanLimited = probes.some((p) => p.scanLimited);
+    const sourcesWithSupportedFiles = probes.filter((p) => p.supportedFilesSeen > 0).length;
+    const cloudSupportedFilesSeen = sum(probes.map((p, i) => sources[i]?.extraction === "cloud" ? p.supportedFilesSeen : 0));
+    const localSupportedFilesSeen = sum(probes.map((p, i) => sources[i]?.extraction === "local" ? p.supportedFilesSeen : 0));
+    const base = {
+        ...configDerived,
+        probed: true,
+        existing_sources: existingSources,
+        sources_with_supported_files: sourcesWithSupportedFiles,
+        supported_files_seen: supportedFilesSeen,
+        cloud_supported_files_seen: cloudSupportedFilesSeen,
+        local_supported_files_seen: localSupportedFilesSeen,
+        scan_limited: scanLimited,
+    };
+    if (configDerived.configured_sources === 0) {
+        return {
+            ...base,
+            status: "not_configured",
+            summary: "No structured documents because no document sources are configured.",
+            next_action: "Add a source to the active Onadit config, then run onadit reconcile.",
+        };
+    }
+    if (existingSources === 0) {
+        return {
+            ...base,
+            status: "source_missing",
+            summary: "No structured documents because the configured source paths are missing on disk.",
+            next_action: "Fix or remove the missing source paths in the active Onadit config.",
+        };
+    }
+    if (supportedFilesSeen === 0 && scanLimited) {
+        return {
+            ...base,
+            status: "unknown",
+            summary: "No structured documents, and the source probe hit its scan limit before finding supported files.",
+            next_action: "Run: onadit reconcile",
+        };
+    }
+    if (supportedFilesSeen === 0) {
+        return {
+            ...base,
+            status: "source_empty",
+            summary: "No structured documents because the active sources contain no supported files.",
+            next_action: "Add supported files to an active source, or point the active config at the folders you want indexed.",
+        };
+    }
+    if (cloudSupportedFilesSeen > 0 && !input.voyageKeyPresent) {
+        return {
+            ...base,
+            status: "embedding_unavailable",
+            summary: "No structured documents because cloud sources contain supported files, but no Voyage key is loaded.",
+            next_action: "Run: onadit onboard --reconfigure-voyage",
+        };
+    }
+    return {
+        ...base,
+        status: "backfill_needed",
+        summary: "No structured documents even though active sources contain supported files; existing files likely need a reconcile/backfill pass.",
+        next_action: "Run: onadit reconcile",
+    };
+}
+function probeSource(source, config, limit) {
+    let stat;
+    try {
+        stat = fs.statSync(source.path);
+    }
+    catch {
+        return { exists: false, supportedFilesSeen: 0, scanLimited: false };
+    }
+    if (!stat.isDirectory()) {
+        return { exists: false, supportedFilesSeen: 0, scanLimited: false };
+    }
+    const ignoredPaths = buildIgnoredPaths(source, config.data_paths);
+    const result = countSupportedFiles(source.path, ignoredPaths, limit, DEFAULT_SOURCE_ENTRY_SCAN_LIMIT);
+    return {
+        exists: true,
+        supportedFilesSeen: result.count,
+        scanLimited: result.limited,
+    };
+}
+function countSupportedFiles(dir, ignoredPaths, supportedFileLimit, entryLimit) {
+    let count = 0;
+    let entriesSeen = 0;
+    let limited = false;
+    const visit = (current) => {
+        if (count >= supportedFileLimit || entriesSeen >= entryLimit) {
+            limited = true;
+            return;
+        }
+        if (isWatcherPathIgnored(current, ignoredPaths))
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (count >= supportedFileLimit || entriesSeen >= entryLimit) {
+                limited = true;
+                return;
+            }
+            entriesSeen++;
+            const fullPath = path.join(current, entry.name);
+            if (isWatcherPathIgnored(fullPath, ignoredPaths))
+                continue;
+            if (entry.isDirectory() && !entry.isSymbolicLink()) {
+                visit(fullPath);
+            }
+            else if (entry.isFile() && isSupported(fullPath)) {
+                count++;
+            }
+        }
+    };
+    visit(dir);
+    return { count, limited };
+}
+function sum(values) {
+    return values.reduce((acc, n) => acc + n, 0);
+}
+//# sourceMappingURL=memory-coverage.js.map

package/dist/src/diagnostics/memory-coverage.js.map

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

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

@@ -0,0 +1,107 @@
+import type { DoctorIssue, DoctorIssueKind } from "./doctor.js";
+/** Re-notify cadence for an issue that stays unresolved. */
+export declare const RENOTIFY_INTERVAL_MS: number;
+/**
+ * The only issue kinds that ever raise a friend-facing macOS banner — the
+ * user-ACTIONABLE failures, where the friend can sign in or add a key and the
+ * problem clears. Everything else (a transient codex/claude probe failure, an
+ * index-write or save error, a backend timeout) is operator-only: surfaced in
+ * `onadit doctor` / `onadit status` and the logs, never a banner, because a
+ * non-technical friend cannot act on it and Onadit retries it on its own.
+ *
+ * New kinds default to operator-only (fail-closed): add a kind here only when
+ * there is a safe, concrete action the friend can take.
+ */
+export declare const FRIEND_NOTIFY_KINDS: ReadonlySet<DoctorIssueKind>;
+export interface NotificationPayload {
+    /** macOS notification title — always the same friend-facing banner. */
+    title: string;
+    /** One-line subtitle naming the failing subsystem. */
+    subtitle: string;
+    /** Body: the issue's next action, so the notification is actionable. */
+    message: string;
+}
+/** Per-subsystem dedup record. */
+export interface NotifyRecord {
+    last_notified_at: string;
+    /**
+     * The cause fingerprint last notified for this kind (e.g.
+     * `voyage_embed_errors:provider_400`). When the live issue's
+     * fingerprint differs, the cause changed and the friend should be
+     * re-notified immediately — the repair action/risk is now different —
+     * rather than staying silent for the rest of the 24h window. Optional
+     * for backward compatibility with state written before fingerprinting.
+     */
+    fingerprint?: string;
+}
+/**
+ * Persisted dedup state. Presence of a kind means it is currently in a
+ * failing state and was last notified at `last_notified_at`. Absence
+ * means resolved-or-never — so the next occurrence notifies fresh.
+ */
+export interface NotifyState {
+    active: Partial<Record<DoctorIssueKind, NotifyRecord>>;
+}
+export interface PlanNotificationsInput {
+    /** All diagnosed issues (the full report list, any severity). */
+    issues: DoctorIssue[];
+    /** Previously persisted dedup state. */
+    state: NotifyState;
+    now: number;
+}
+export interface PlanNotificationsResult {
+    /** Payloads to actually send this tick (already rate-limited). */
+    notifications: NotificationPayload[];
+    /** State to persist after sending. */
+    nextState: NotifyState;
+}
+/**
+ * Build the friend-facing notification for an issue. Pure. The title is
+ * intentionally constant ("Onadit needs attention") so the friend learns
+ * to recognise it; the subtitle and body carry the specifics.
+ */
+export declare function buildNotificationPayload(issue: DoctorIssue): NotificationPayload;
+/**
+ * Decide which notifications to send this tick and what state to persist.
+ * Pure: no IO, no clock except the injected `now`.
+ *
+ * Eligible issues are the intersection of `daemonObservable` (the daemon can
+ * see them) and `FRIEND_NOTIFY_KINDS` (the friend can act on them) — so a
+ * transient probe/index/save failure never reaches a banner.
+ *
+ * The dedup memory survives a healthy run: a record is retained until its 24h
+ * cooldown elapses, even on ticks where the issue is absent. That is the flood
+ * fix — without it, one healthy poll wiped the "already warned you" memory and
+ * the next recurrence re-notified, defeating the daily limit.
+ */
+export declare function planNotifications(input: PlanNotificationsInput): PlanNotificationsResult;
+/** Absolute path to the dedup-state file under the data dir. */
+export declare function notifyStatePath(dataDir: string): string;
+/** Read dedup state; returns empty state on any read/parse failure. */
+export declare function readNotifyState(dataDir: string): NotifyState;
+/** Persist dedup state best-effort; swallows IO errors. */
+export declare function writeNotifyState(dataDir: string, state: NotifyState): void;
+/**
+ * Send a single notification via macOS `osascript`. Best-effort and
+ * fire-and-forget — any failure (non-macOS, osascript missing, user has
+ * notifications disabled) is swallowed so capture is never affected.
+ *
+ * Strings are passed as argv to `execFile` (not interpolated into a
+ * shell), and AppleScript string literals are escaped, so notification
+ * text cannot inject shell or AppleScript.
+ */
+export declare function sendNotification(payload: NotificationPayload, opts?: {
+    platform?: NodeJS.Platform;
+}): void;
+/** Escape a string into an AppleScript double-quoted literal. */
+export declare function asAppleScriptString(value: string): string;
+/**
+ * End-to-end daemon helper: given the diagnosed issues, send any due
+ * notifications and persist updated dedup state. Best-effort throughout
+ * — wired into the capture loop, so it must never throw.
+ */
+export declare function notifyDaemonFailures(dataDir: string, issues: DoctorIssue[], opts?: {
+    now?: number;
+    platform?: NodeJS.Platform;
+}): void;
+//# sourceMappingURL=notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/notify.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AAExD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,eAAe,CAQ3D,CAAC;AAEH,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;CACxD;AAOD,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,wCAAwC;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,sCAAsC;IACtC,SAAS,EAAE,WAAW,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,GACjB,mBAAmB,CAMrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,CA2DzB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAW5D;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAQ1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,mBAAmB,EAC5B,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAAO,GACxC,IAAI,CAcN;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAAO,GACtD,IAAI,CAmBN"}