@getrift/rift 0.1.0-beta.21 → 0.1.0-beta.23

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: rift 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. rift onboard --enable-codex-enrichment, then run rift 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: rift 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: rift 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: rift status --json",
+        };
+    }
+    // Healthy steady state: documents are already indexed, so we owe no
+    // explanation and skip the probe entirely. `rift 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 Rift config, then run rift 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 Rift 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: rift 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: rift 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: rift 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

@@ -1,6 +1,18 @@
 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
+ * `rift doctor` / `rift status` and the logs, never a banner, because a
+ * non-technical friend cannot act on it and Rift 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;
@@ -53,9 +65,14 @@ export declare function buildNotificationPayload(issue: DoctorIssue): Notificati
  * Decide which notifications to send this tick and what state to persist.
  * Pure: no IO, no clock except the injected `now`.
  *
- * Only `daemonObservable` issues are eligible — the daemon must not
- * notify about things it cannot itself observe (e.g. a dead daemon, or
- * user-side rejected imports).
+ * 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. */

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

@@ -1 +1 @@
-{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/notify.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,QAAsB,CAAC;AAExD,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;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,CA+CzB;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"}
+{"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"}

package/dist/src/diagnostics/notify.js

@@ -11,10 +11,15 @@
  * about itself. That needs a separate watchdog and is explicitly Slice D
  * (see docs/feedback/2026-05-20-friend-onboarding-status-surface.md).
  *
- * Rate-limiting rules (from the status-surface plan):
+ * Rate-limiting rules (status-surface plan + the 2026-06 flood fix):
+ *   - Only user-ACTIONABLE kinds (FRIEND_NOTIFY_KINDS) ever reach a friend;
+ *     transient/infra failures (probe timeouts, index/save errors) are
+ *     operator-only — visible in `rift doctor`/`status`, never a banner.
  *   - Notify on state transition, not every poll.
- *   - Do not repeat the same unresolved issue more than once per day.
- *   - Notify again after the issue resolves and later recurs.
+ *   - Do not repeat the same unresolved issue more than once per day — and the
+ *     dedup memory SURVIVES a healthy run, so an intermittent failure
+ *     (fail → heal → fail within 24h) notifies once, not on every recurrence.
+ *   - After the cooldown elapses, a genuine later recurrence notifies fresh.
  *
  * The planning logic (`planNotifications`) is pure and fully tested; the
  * IO (reading/writing dedup state, sending via osascript) is thin and
@@ -25,6 +30,26 @@ import fs from "node:fs";
 import path from "node:path";
 /** Re-notify cadence for an issue that stays unresolved. */
 export const RENOTIFY_INTERVAL_MS = 24 * 60 * 60 * 1000;
+/**
+ * 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
+ * `rift doctor` / `rift status` and the logs, never a banner, because a
+ * non-technical friend cannot act on it and Rift 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 const FRIEND_NOTIFY_KINDS = new Set([
+    "codex_auth_expired",
+    "claude_auth_expired",
+    "voyage_key_missing",
+    // NOT voyage_embed_errors: "key present but embedding failed" is not cleanly
+    // friend-actionable — it spans an invalid key AND a network/provider flake.
+    // It stays operator-only until the cause is split into its own kind
+    // (voyage_key_invalid → friend banner, voyage_embed_errors → operator).
+]);
 /** Cause identity for an issue: explicit fingerprint, else its kind. */
 function issueFingerprint(issue) {
     return issue.fingerprint ?? issue.kind;
@@ -45,16 +70,34 @@ export function buildNotificationPayload(issue) {
  * Decide which notifications to send this tick and what state to persist.
  * Pure: no IO, no clock except the injected `now`.
  *
- * Only `daemonObservable` issues are eligible — the daemon must not
- * notify about things it cannot itself observe (e.g. a dead daemon, or
- * user-side rejected imports).
+ * 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 function planNotifications(input) {
     const { issues, state, now } = input;
-    const eligible = issues.filter((i) => i.daemonObservable);
-    const eligibleKinds = new Set(eligible.map((i) => i.kind));
-    const nextActive = {};
+    const eligible = issues.filter((i) => i.daemonObservable && FRIEND_NOTIFY_KINDS.has(i.kind));
+    const presentKinds = new Set(eligible.map((i) => i.kind));
     const notifications = [];
+    const nextActive = {};
+    // Carry over prior records for kinds NOT failing this tick, as long as their
+    // cooldown window has not elapsed. This keeps the "already warned" memory
+    // alive across a healthy run, so an intermittent failure notifies once per
+    // day rather than on every recurrence. Expired records are dropped, so a
+    // genuine later recurrence notifies fresh.
+    for (const [kind, record] of Object.entries(state.active)) {
+        if (presentKinds.has(kind))
+            continue;
+        const lastMs = Date.parse(record.last_notified_at);
+        const fresh = !Number.isNaN(lastMs) && now - lastMs < RENOTIFY_INTERVAL_MS;
+        if (fresh)
+            nextActive[kind] = record;
+    }
     for (const issue of eligible) {
         const prior = state.active[issue.kind];
         const fingerprint = issueFingerprint(issue);
@@ -66,7 +109,7 @@ export function planNotifications(input) {
             };
         };
         if (!prior) {
-            // New transition into failure → notify.
+            // First transition into failure → notify.
             notify();
             continue;
         }
@@ -84,13 +127,10 @@ export function planNotifications(input) {
             notify();
         }
         else {
-            // Already notified within the window → stay quiet, keep record.
+            // Already notified within the window → stay quiet, keep the record.
             nextActive[issue.kind] = prior;
         }
     }
-    // Anything previously active but no longer present has resolved; it is
-    // simply absent from `nextActive`, so a later recurrence notifies fresh.
-    void eligibleKinds;
     return { notifications, nextState: { active: nextActive } };
 }
 /** Absolute path to the dedup-state file under the data dir. */

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

@@ -1 +1 @@
-{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../src/diagnostics/notify.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../src/diagnostics/notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAExD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiC,IAAI,GAAG,CAAC;IACvE,oBAAoB;IACpB,qBAAqB;IACrB,oBAAoB;IACpB,6EAA6E;IAC7E,4EAA4E;IAC5E,oEAAoE;IACpE,wEAAwE;CACzE,CAAC,CAAC;AAkCH,wEAAwE;AACxE,SAAS,gBAAgB,CAAC,KAAkB;IAC1C,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC;AACzC,CAAC;AAiBD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAkB;IAElB,OAAO;QACL,KAAK,EAAE,sBAAsB;QAC7B,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,OAAO,EAAE,KAAK,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA6B;IAE7B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAC7D,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1D,MAAM,aAAa,GAA0B,EAAE,CAAC;IAChD,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,6EAA6E;IAC7E,0EAA0E;IAC1E,2EAA2E;IAC3E,yEAAyE;IACzE,2CAA2C;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAEvD,EAAE,CAAC;QACF,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,MAAM,GAAG,oBAAoB,CAAC;QAC3E,IAAI,KAAK;YAAE,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,aAAa,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBACvB,gBAAgB,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;gBAC7C,WAAW;aACZ,CAAC;QACJ,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,0CAA0C;YAC1C,MAAM,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QACD,oEAAoE;QACpE,oEAAoE;QACpE,qEAAqE;QACrE,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YACtD,MAAM,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,OAAO,IAAI,oBAAoB,CAAC;QACjE,IAAI,KAAK,EAAE,CAAC;YACV,2DAA2D;YAC3D,MAAM,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACN,oEAAoE;YACpE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC;AAC9D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,oBAAoB,CAAC,CAAC;AACnE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACvD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,KAAkB;IAClE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA4B,EAC5B,OAAuC,EAAE;IAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAClC,MAAM,MAAM,GACV,wBAAwB,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG;QAC/D,cAAc,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QACnD,YAAY,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACtD,IAAI,CAAC;QACH,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE;YACzC,2CAA2C;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,MAAqB,EACrB,OAAqD,EAAE;IAEvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC;YACrD,MAAM;YACN,KAAK;YACL,GAAG;SACJ,CAAC,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,gBAAgB,CACd,OAAO,EACP,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CACjD,CAAC;QACJ,CAAC;QACD,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;IAChE,CAAC;AACH,CAAC"}

package/dist/src/ingestion/chunk-meta.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The single source of truth for chunk MARKERS — how a row declares it is one
+ * piece of a larger logical document/conversation, and how readers recover the
+ * parent grouping. Every producer (indexer, save, ingest, rebuild) and every
+ * consumer (retrieval grouping, reconcile, dedup) imports from here, so there is
+ * exactly one marker contract.
+ *
+ * Representation:
+ *   - Conversations carry explicit columns `parent_id`, `chunk_index`,
+ *     `chunk_count` (all strings; empty = legacy/unchunked).
+ *   - Documents carry `chunk_index` / `chunk_count` inside the existing
+ *     `metadata` JSON; the parent key is the already-indexed `source_path`.
+ *
+ * The explicit `chunk_count` IS the marker: `chunk_count > 1` means "this row is
+ * part of a chunk set". A row WITHOUT that marker is never grouped — sharing a
+ * `source_path` or `idempotency_key` alone must not cause a collapse. Ordinals
+ * are stored explicitly (not parsed out of the row id), so completeness checks
+ * and honest "section k of N" display never treat the id as the source of truth.
+ */
+import type { TableName } from "../storage/tables.js";
+export interface ChunkMarker {
+    /** Parent key value: `source_path` for docs, `parent_id` for conversations. */
+    parentId: string;
+    /** 0-based ordinal within the set. */
+    index: number;
+    /** Total chunks in the set (> 1 when this is genuinely chunked). */
+    count: number;
+}
+/** Separators for chunk row ids. Distinct per family for readability; ids are
+ *  unique either way and are NOT load-bearing for ordering (use chunk_index). */
+export declare const DOC_CHUNK_SEP = ":";
+export declare const CONV_CHUNK_SEP = "::";
+/** Read the chunk marker from a conversation row, or null if unchunked/legacy. */
+export declare function readConversationChunkMarker(row: Record<string, unknown>): ChunkMarker | null;
+/** Read the chunk marker from a structured-doc row, or null if unchunked/legacy. */
+export declare function readDocChunkMarker(row: Record<string, unknown>): ChunkMarker | null;
+/**
+ * Namespaced parent key for retrieval grouping, or `null` when the row carries
+ * NO explicit chunk marker (the flag-off / legacy case — never grouped).
+ *
+ * Namespacing guarantees mixed-vintage / cross-table rows can never collapse:
+ *   - docs  → `doc|<source_table>|<source_path>`  (so `structured_docs` vs
+ *     `structured_docs_local` with the same path stay separate)
+ *   - convs → `conv|<source>|<parent_id>`
+ */
+export declare function parentKeyForRow(sourceTable: TableName, row: Record<string, unknown>): string | null;
+/** True iff the row is part of a genuine chunk set (`chunk_count > 1`). */
+export declare function isChunked(sourceTable: TableName, row: Record<string, unknown>): boolean;
+/**
+ * Unified chunk-marker reader across the conversation and document families,
+ * or `null` for an unchunked/legacy row (no marker / `chunk_count <= 1`) and for
+ * digests (which never chunk). Lets the read-side (expand stitching) inspect a
+ * row's position in its set without re-deriving the per-family column vs metadata
+ * split. `parentId` is the raw column value (`parent_id` / `source_path`), not the
+ * namespaced retrieval key.
+ */
+export declare function readChunkMarker(sourceTable: TableName, row: Record<string, unknown>): ChunkMarker | null;
+/** Conversation chunk columns. count <= 1 → empty markers (matches seed/legacy). */
+export declare function conversationChunkColumns(parentId: string, index: number, count: number): {
+    parent_id: string;
+    chunk_index: string;
+    chunk_count: string;
+};
+/** Merge chunk ordinals into a doc metadata object. count <= 1 → unchanged
+ *  (NO `chunk_*` keys), so a single/legacy doc stays byte-identical. */
+export declare function docChunkMetadata(base: Record<string, unknown>, index: number, count: number): Record<string, unknown>;
+export declare function convChunkId(parentId: string, index: number): string;
+export declare function docChunkId(fileId: string, index: number): string;
+/** The largest declared `chunk_count` across a set of rows (≥ 1). */
+export declare function expectedChunkCount(rows: Record<string, unknown>[]): number;
+/**
+ * True iff the rows already indexed for a parent form a COMPLETE set. Used by
+ * save/ingest/reconcile dedup so a partially-written set (crash mid-append) is
+ * repaired rather than mistaken for "already indexed".
+ *
+ * Completeness is stricter than a row count: a chunked set is complete only when
+ * every chunk index `0 .. count-1` is present EXACTLY once and every row agrees
+ * on the same `chunk_count`. This rejects the degenerate set that a bare
+ * `rows.length >= count` check would wave through — e.g. a duplicated chunk 0
+ * with a missing chunk 1 (length 2, count 2, but broken). An unchunked set
+ * (`count <= 1`, all legacy/`/ingest`-job rows) keeps the legacy semantics: any
+ * existing row counts as complete, so this never changes flag-off behavior.
+ */
+export declare function chunkSetComplete(rows: Record<string, unknown>[]): boolean;
+//# sourceMappingURL=chunk-meta.d.ts.map

package/dist/src/ingestion/chunk-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-meta.d.ts","sourceRoot":"","sources":["../../../src/ingestion/chunk-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;iFACiF;AACjF,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,cAAc,OAAO,CAAC;AAgCnC,kFAAkF;AAClF,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,WAAW,GAAG,IAAI,CAMpB;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,WAAW,GAAG,IAAI,CAQpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,SAAS,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,GAAG,IAAI,CAaf;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CACvB,WAAW,EAAE,SAAS,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,SAAS,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,WAAW,GAAG,IAAI,CAQpB;AAID,oFAAoF;AACpF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAOjE;AAED;wEACwE;AACxE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAID,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAI1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAczE"}