nlm-memory 0.20.1 → 0.21.12

package/dist/core/adapters/muse.js

@@ -0,0 +1,271 @@
+/**
+ * Muse adapter.
+ *
+ * Reads ${XDG_DATA_HOME:-~/.local/share}/muse/sessions/YYYY/MM/DD/<session-id>/session.jsonl
+ * files. Each line is an event-sourced record (`record_type: "event"`,
+ * microsecond `recorded_at`); conversation turns come from a small set of
+ * payloads and everything else is recall noise:
+ *
+ * Conversation extraction:
+ * - `runtime.user_intent.accepted` (`surface: "main"`, `refill_blocks[].text`)
+ *   -> [user] turn. The `run.started` event's `prompt` duplicates this text
+ *   and is skipped. Non-main surfaces are steering, not conversation.
+ * - `runtime.session` / `assistant_message_committed.text` -> [assistant] turn.
+ *
+ * Tool surface: `assistant_tool_calls_committed.tool_calls[].name` ->
+ * `[tool_use: <name>]`; `tool_result_batch_committed.results[].text` ->
+ * `[tool_result: <240-char preview>]`.
+ *
+ * Dropped: hooks, reasoning, reminders, approvals, task lifecycle,
+ * resource samples, `model_user_messages` (a skill-body bundle), and the
+ * `session.*.observed` bookkeeping events.
+ *
+ * Session id is the parent directory name; project dir comes from the
+ * `runtime.session.metadata` record's `workspace_root`.
+ *
+ * Format reference: verified against a live 11k-line session on 2026-09-27.
+ */
+import { promises as fs } from "node:fs";
+import { existsSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { durationMinutes, normalizeTimestamp, safeSessionId } from "./common.js";
+const TOOL_RESULT_PREVIEW_CHARS = 240;
+export function defaultSessionsPath() {
+    const dataHome = process.env["XDG_DATA_HOME"] || join(homedir(), ".local", "share");
+    return join(dataHome, "muse", "sessions");
+}
+/**
+ * Subagent runs live at `<parent>/subagent/<id>/session.jsonl`. They take the
+ * `<parent>/agent-<id>` shape claude-code uses, so deriveSubagentMeta links
+ * them to their parent instead of ingesting them as standalone sessions.
+ */
+export function museRuntimeSessionId(path) {
+    const sessionDir = dirname(path);
+    const container = dirname(sessionDir);
+    if (basename(container) === "subagent") {
+        return `${basename(dirname(container))}/agent-${basename(sessionDir)}`;
+    }
+    return basename(sessionDir);
+}
+/** Muse `recorded_at` is microseconds; common.normalizeTimestamp wants ms. */
+function museTimestamp(ts) {
+    if (typeof ts === "number" && Number.isFinite(ts) && ts > 0) {
+        return normalizeTimestamp(Math.trunc(ts / 1000));
+    }
+    return "";
+}
+export class MuseAdapter {
+    name = "muse";
+    runtimeVersion = "muse/1.0";
+    transcriptKind = "muse-jsonl";
+    sessionsPath;
+    idleMinutes;
+    constructor(opts = {}) {
+        this.sessionsPath = opts.sessionsPath ?? defaultSessionsPath();
+        this.idleMinutes = opts.idleMinutes ?? 15;
+    }
+    detect() {
+        const p = defaultSessionsPath();
+        if (existsSync(p) && statSync(p).isDirectory()) {
+            return { adapterName: this.name, enabled: true, path: p, hint: null };
+        }
+        return {
+            adapterName: this.name,
+            enabled: false,
+            path: null,
+            hint: "Muse not detected — no sessions directory. Sessions live under ${XDG_DATA_HOME:-~/.local/share}/muse/sessions/.",
+        };
+    }
+    async discover(options = {}) {
+        if (!existsSync(this.sessionsPath))
+            return [];
+        const found = [];
+        const seen = new Set();
+        await this.walk(this.sessionsPath, seen, found, options.since);
+        found.sort((a, b) => a.mtime - b.mtime);
+        return found.map((f) => f.path);
+    }
+    async parseSession(path) {
+        const turns = [];
+        let startedAt = "";
+        let endedAt = "";
+        let projectDir = "";
+        let model = "";
+        let totalBytes = 0;
+        let raw;
+        try {
+            raw = await fs.readFile(path, "utf8");
+        }
+        catch {
+            return null;
+        }
+        for (const line of raw.split("\n")) {
+            totalBytes += Buffer.byteLength(line, "utf8") + 1;
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let row;
+            try {
+                row = JSON.parse(trimmed);
+            }
+            catch {
+                continue;
+            }
+            const outerTs = museTimestamp(row["recorded_at"]);
+            const payload = row["payload"] ?? {};
+            const ptype = row["payload_type"];
+            if (ptype === "runtime.session.metadata") {
+                const rec = payload["record"];
+                if (rec) {
+                    if (!projectDir && typeof rec["workspace_root"] === "string") {
+                        projectDir = rec["workspace_root"];
+                    }
+                    if (!model && typeof rec["model"] === "string") {
+                        model = rec["model"];
+                    }
+                }
+                continue;
+            }
+            for (const turn of extractTurns(ptype, payload, outerTs)) {
+                if (turn.timestamp && !startedAt)
+                    startedAt = turn.timestamp;
+                if (turn.timestamp)
+                    endedAt = turn.timestamp;
+                turns.push(turn);
+            }
+        }
+        if (turns.length === 0)
+            return null;
+        const transcript = turns.map((t) => `[${t.role}] ${t.text}`).join("\n\n");
+        const duration = durationMinutes(startedAt, endedAt);
+        const label = provisionalLabel(turns);
+        const runtimeSessionId = museRuntimeSessionId(path);
+        const chunk = {
+            id: safeSessionId("muse", runtimeSessionId),
+            runtime: this.runtimeVersion,
+            runtimeSessionId,
+            sourcePath: path,
+            startedAt,
+            endedAt,
+            durationMin: duration,
+            turnCount: turns.length,
+            byteRange: [0, totalBytes],
+            projectDir,
+            gitBranch: "",
+            text: transcript,
+            label,
+        };
+        return model ? { ...chunk, model } : chunk;
+    }
+    async walk(dir, seen, out, since) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const ent of entries) {
+            const full = join(dir, ent.name);
+            if (ent.isDirectory()) {
+                await this.walk(full, seen, out, since);
+            }
+            else if (ent.isFile() && ent.name === "session.jsonl") {
+                if (seen.has(full))
+                    continue;
+                seen.add(full);
+                let st;
+                try {
+                    st = await fs.stat(full);
+                }
+                catch {
+                    continue;
+                }
+                if (st.size === 0)
+                    continue;
+                if (since && st.mtime < since)
+                    continue;
+                out.push({ mtime: st.mtimeMs, path: full });
+            }
+        }
+    }
+}
+// ── event extraction ─────────────────────────────────────────────────────
+function extractTurns(outerType, payload, outerTs) {
+    if (outerType === "runtime.user_intent.accepted") {
+        if (payload["surface"] !== "main")
+            return [];
+        const blocks = payload["refill_blocks"];
+        if (!Array.isArray(blocks))
+            return [];
+        const text = blocks
+            .filter((b) => typeof b === "object" &&
+            b !== null &&
+            b["kind"] === "text" &&
+            typeof b["text"] === "string")
+            .map((b) => b["text"])
+            .join("")
+            .trim();
+        if (!text)
+            return [];
+        return [{ role: "user", text, timestamp: outerTs }];
+    }
+    if (outerType === "runtime.session") {
+        const event = payload["event"];
+        if (typeof event !== "object" || event === null)
+            return [];
+        const ev = event;
+        if (ev["kind"] === "assistant_message_committed") {
+            const text = ev["text"];
+            if (typeof text !== "string" || !text.trim())
+                return [];
+            return [{ role: "assistant", text, timestamp: outerTs }];
+        }
+        if (ev["kind"] === "assistant_tool_calls_committed") {
+            const calls = ev["calls"] ?? ev["tool_calls"];
+            if (!Array.isArray(calls))
+                return [];
+            return calls.map((c) => {
+                const name = typeof c === "object" && c !== null && typeof c["name"] === "string"
+                    ? c["name"]
+                    : "tool";
+                return { role: "assistant", text: `[tool_use: ${name}]`, timestamp: outerTs };
+            });
+        }
+        if (ev["kind"] === "tool_result_batch_committed") {
+            const results = ev["results"];
+            if (!Array.isArray(results))
+                return [];
+            const turns = [];
+            for (const res of results) {
+                if (typeof res !== "object" || res === null)
+                    continue;
+                const text = res["text"];
+                if (typeof text !== "string" || !text.trim())
+                    continue;
+                const preview = text.slice(0, TOOL_RESULT_PREVIEW_CHARS);
+                const ellipsis = text.length > TOOL_RESULT_PREVIEW_CHARS ? "…" : "";
+                turns.push({
+                    role: "assistant",
+                    text: `[tool_result: ${preview}${ellipsis}]`,
+                    timestamp: outerTs,
+                });
+            }
+            return turns;
+        }
+        return [];
+    }
+    return [];
+}
+function provisionalLabel(turns) {
+    for (const t of turns) {
+        if (t.role !== "user")
+            continue;
+        const firstLine = t.text.split("\n", 1)[0]?.trim();
+        if (firstLine)
+            return firstLine.slice(0, 80);
+    }
+    return "Untitled session";
+}
+//# sourceMappingURL=muse.js.map

package/dist/core/adapters/muse.js.map

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

package/dist/core/adapters/opencode.d.ts

@@ -2,8 +2,8 @@
  * OpenCode adapter.
  *
  * Reads the OpenCode SQLite database at:
- *   macOS: ~/Library/Application Support/opencode/opencode.db
- *   Linux: $XDG_DATA_HOME/opencode/opencode.db (default ~/.local/share/opencode/opencode.db)
+ *   $XDG_DATA_HOME/opencode/opencode.db (default ~/.local/share/opencode/opencode.db)
+ *   macOS falls back to ~/Library/Application Support/opencode/opencode.db
  *
  * Unlike the JSONL-based adapters, OpenCode stores all sessions and messages
  * in a single SQLite file. `discover()` queries the sessions table and returns
@@ -19,7 +19,7 @@
  * Format reference: verified against sst/opencode migration
  * 20260127222353_familiar_lady_ursula and session.sql.ts, 2026-05-28.
  */
-import type { DetectionResult, DiscoverOptions, SessionChunk, TranscriptAdapter } from "../../ports/transcript-adapter.js";
+import type { DetectionResult, DiscoverOptions, SessionChunk, SourceStat, TranscriptAdapter } from "../../ports/transcript-adapter.js";
 export interface OpenCodeAdapterOptions {
     readonly dbPath?: string;
 }
@@ -32,5 +32,12 @@ export declare class OpenCodeAdapter implements TranscriptAdapter {
     constructor(opts?: OpenCodeAdapterOptions);
     detect(): DetectionResult;
     discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
-    parseSession(sessionId: string): Promise<SessionChunk | null>;
+    /**
+     * `<dbPath>::<sessionId>`, the key discover() emits and chunk.sourcePath
+     * carries, so scanOnce's adapter_state lookup matches what it recorded.
+     */
+    private sourceKey;
+    private sessionIdOf;
+    stat(source: string): SourceStat | null;
+    parseSession(source: string): Promise<SessionChunk | null>;
 }

package/dist/core/adapters/opencode.js

@@ -2,8 +2,8 @@
  * OpenCode adapter.
  *
  * Reads the OpenCode SQLite database at:
- *   macOS: ~/Library/Application Support/opencode/opencode.db
- *   Linux: $XDG_DATA_HOME/opencode/opencode.db (default ~/.local/share/opencode/opencode.db)
+ *   $XDG_DATA_HOME/opencode/opencode.db (default ~/.local/share/opencode/opencode.db)
+ *   macOS falls back to ~/Library/Application Support/opencode/opencode.db
  *
  * Unlike the JSONL-based adapters, OpenCode stores all sessions and messages
  * in a single SQLite file. `discover()` queries the sessions table and returns
@@ -28,11 +28,13 @@ const TOOL_OUTPUT_PREVIEW_CHARS = 240;
 export function defaultDbPath() {
     if (process.env["OPENCODE_DB_PATH"])
         return process.env["OPENCODE_DB_PATH"];
-    if (process.platform === "darwin") {
+    const xdg = process.env["XDG_DATA_HOME"] ?? join(homedir(), ".local", "share");
+    const xdgPath = join(xdg, "opencode", "opencode.db");
+    // OpenCode uses the XDG path on macOS too; Application Support is only a fallback.
+    if (process.platform === "darwin" && !existsSync(xdgPath)) {
         return join(homedir(), "Library", "Application Support", "opencode", "opencode.db");
     }
-    const xdg = process.env["XDG_DATA_HOME"] ?? join(homedir(), ".local", "share");
-    return join(xdg, "opencode", "opencode.db");
+    return xdgPath;
 }
 function readGitBranch(directory) {
     try {
@@ -131,7 +133,7 @@ export class OpenCodeAdapter {
                     .prepare(`SELECT id FROM session WHERE time_archived IS NULL`)
                     .all();
             }
-            return rows.map((r) => r.id);
+            return rows.map((r) => this.sourceKey(r.id));
         }
         catch {
             return [];
@@ -140,7 +142,39 @@ export class OpenCodeAdapter {
             db?.close();
         }
     }
-    async parseSession(sessionId) {
+    /**
+     * `<dbPath>::<sessionId>`, the key discover() emits and chunk.sourcePath
+     * carries, so scanOnce's adapter_state lookup matches what it recorded.
+     */
+    sourceKey(sessionId) {
+        return `${this.dbPath}::${sessionId}`;
+    }
+    sessionIdOf(source) {
+        const sep = source.lastIndexOf("::");
+        return sep === -1 ? source : source.slice(sep + 2);
+    }
+    stat(source) {
+        if (!existsSync(this.dbPath))
+            return null;
+        let db;
+        try {
+            db = new Database(this.dbPath, { readonly: true });
+            const row = db
+                .prepare("SELECT time_updated FROM session WHERE id = ?")
+                .get(this.sessionIdOf(source));
+            // time_updated moves whenever the session gains messages, so it doubles
+            // as the change marker scanOnce compares against adapter_state.
+            return row ? { mtimeMs: row.time_updated, size: row.time_updated } : null;
+        }
+        catch {
+            return null;
+        }
+        finally {
+            db?.close();
+        }
+    }
+    async parseSession(source) {
+        const sessionId = this.sessionIdOf(source);
         if (!existsSync(this.dbPath))
             return null;
         let db;

package/dist/core/adapters/opencode.js.map

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

package/dist/core/alerts/alert-state.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Persisted last-known alert state — one JSON file so restarts don't
+ * forget an in-progress drift/embedder episode and re-fire an alert
+ * that already went out. Lives beside update-check.json in ~/.nlm/,
+ * same cache-file shape/failure-mode convention as check.ts: unreadable
+ * or corrupt just means "start from a clean slate," never a throw.
+ */
+import { type DriftAlertState } from "./drift-transition.js";
+import { type EmbedderAlertState } from "./embedder-transition.js";
+export interface AlertState {
+    readonly drift: DriftAlertState;
+    readonly embedderCold: EmbedderAlertState;
+}
+export declare const DEFAULT_ALERT_STATE: AlertState;
+export declare function defaultAlertStatePath(): string;
+export declare function readAlertState(path: string): Promise<AlertState>;
+export declare function writeAlertState(path: string, state: AlertState): Promise<void>;

package/dist/core/alerts/alert-state.js

@@ -0,0 +1,45 @@
+/**
+ * Persisted last-known alert state — one JSON file so restarts don't
+ * forget an in-progress drift/embedder episode and re-fire an alert
+ * that already went out. Lives beside update-check.json in ~/.nlm/,
+ * same cache-file shape/failure-mode convention as check.ts: unreadable
+ * or corrupt just means "start from a clean slate," never a throw.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { DEFAULT_DRIFT_ALERT_STATE, } from "./drift-transition.js";
+import { DEFAULT_EMBEDDER_ALERT_STATE, } from "./embedder-transition.js";
+export const DEFAULT_ALERT_STATE = {
+    drift: DEFAULT_DRIFT_ALERT_STATE,
+    embedderCold: DEFAULT_EMBEDDER_ALERT_STATE,
+};
+export function defaultAlertStatePath() {
+    return join(homedir(), ".nlm", "alert-state.json");
+}
+export async function readAlertState(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            drift: { ...DEFAULT_DRIFT_ALERT_STATE, ...parsed.drift },
+            embedderCold: { ...DEFAULT_EMBEDDER_ALERT_STATE, ...parsed.embedderCold },
+        };
+    }
+    catch {
+        // First run, corrupt file, or unreadable — start from a clean slate;
+        // worst case is one extra false→true fire, never a crash.
+        return DEFAULT_ALERT_STATE;
+    }
+}
+export async function writeAlertState(path, state) {
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, JSON.stringify(state, null, 2), "utf8");
+    }
+    catch {
+        // Persist failure is non-fatal — the next check just re-evaluates
+        // from a clean slate instead of remembering this transition.
+    }
+}
+//# sourceMappingURL=alert-state.js.map

package/dist/core/alerts/alert-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-state.js","sourceRoot":"","sources":["../../../src/core/alerts/alert-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EACL,yBAAyB,GAE1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,4BAA4B,GAE7B,MAAM,0BAA0B,CAAC;AAOlC,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,KAAK,EAAE,yBAAyB;IAChC,YAAY,EAAE,4BAA4B;CAC3C,CAAC;AAEF,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;QACtD,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,yBAAyB,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE;YACxD,YAAY,EAAE,EAAE,GAAG,4BAA4B,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE;SAC1E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,0DAA0D;QAC1D,OAAO,mBAAmB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,KAAiB;IACnE,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;QAClE,6DAA6D;IAC/D,CAAC;AACH,CAAC"}

package/dist/core/alerts/check-and-alert.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Daemon-facing entry points: read persisted alert state, evaluate the
+ * relevant transition, fire the webhook if the transition says so, and
+ * persist the updated state. This is the only module the CLI wiring
+ * (src/cli/nlm.ts) needs to import — it doesn't touch transition logic
+ * or the webhook POST directly.
+ */
+import { type UpdateCheckDeps } from "../update-check/check.js";
+export interface CheckDriftDeps {
+    readonly currentVersion: string;
+    readonly now?: () => Date;
+    readonly fetchImpl?: typeof fetch;
+    readonly statePath?: string;
+    readonly updateCheckDeps?: Partial<UpdateCheckDeps>;
+}
+/** Refresh path: calls the real (cache-respecting) update check, then
+ *  evaluates + fires the version-drift transition. Safe to call on a
+ *  tight interval — getUpdateStatus's own 24h TTL means this is a cache
+ *  read except once a day. */
+export declare function checkDriftAndAlert(deps: CheckDriftDeps): Promise<void>;
+export interface CheckEmbedderDeps {
+    readonly now?: () => Date;
+    readonly fetchImpl?: typeof fetch;
+    readonly statePath?: string;
+}
+/** Polls the in-process warmup flag (see health/warmup-state.ts) and
+ *  evaluates + fires the embedder-cold transition. */
+export declare function checkEmbedderAndAlert(deps?: CheckEmbedderDeps): Promise<void>;

package/dist/core/alerts/check-and-alert.js

@@ -0,0 +1,53 @@
+/**
+ * Daemon-facing entry points: read persisted alert state, evaluate the
+ * relevant transition, fire the webhook if the transition says so, and
+ * persist the updated state. This is the only module the CLI wiring
+ * (src/cli/nlm.ts) needs to import — it doesn't touch transition logic
+ * or the webhook POST directly.
+ */
+import { getUpdateStatus } from "../update-check/check.js";
+import { warmupSnapshot } from "../health/warmup-state.js";
+import { readAlertState, writeAlertState, defaultAlertStatePath } from "./alert-state.js";
+import { evaluateDriftTransition } from "./drift-transition.js";
+import { evaluateEmbedderTransition } from "./embedder-transition.js";
+import { fireAlert } from "./fire-alert.js";
+/** Refresh path: calls the real (cache-respecting) update check, then
+ *  evaluates + fires the version-drift transition. Safe to call on a
+ *  tight interval — getUpdateStatus's own 24h TTL means this is a cache
+ *  read except once a day. */
+export async function checkDriftAndAlert(deps) {
+    const now = deps.now ?? (() => new Date());
+    const statePath = deps.statePath ?? defaultAlertStatePath();
+    const state = await readAlertState(statePath);
+    const status = await getUpdateStatus({
+        currentVersion: deps.currentVersion,
+        now,
+        ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+        ...deps.updateCheckDeps,
+    });
+    const result = evaluateDriftTransition(state.drift, status, now());
+    if (result.fire && result.event) {
+        await fireAlert(result.event, {
+            now,
+            ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+        });
+    }
+    await writeAlertState(statePath, { ...state, drift: result.next });
+}
+/** Polls the in-process warmup flag (see health/warmup-state.ts) and
+ *  evaluates + fires the embedder-cold transition. */
+export async function checkEmbedderAndAlert(deps = {}) {
+    const now = deps.now ?? (() => new Date());
+    const statePath = deps.statePath ?? defaultAlertStatePath();
+    const state = await readAlertState(statePath);
+    const ready = warmupSnapshot().ready;
+    const result = evaluateEmbedderTransition(state.embedderCold, ready, now());
+    if (result.fire && result.event) {
+        await fireAlert(result.event, {
+            now,
+            ...(deps.fetchImpl ? { fetchImpl: deps.fetchImpl } : {}),
+        });
+    }
+    await writeAlertState(statePath, { ...state, embedderCold: result.next });
+}
+//# sourceMappingURL=check-and-alert.js.map

package/dist/core/alerts/check-and-alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-and-alert.js","sourceRoot":"","sources":["../../../src/core/alerts/check-and-alert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C;;;8BAG8B;AAC9B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAoB;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,qBAAqB,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,GAAG;QACH,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,IAAI,CAAC,eAAe;KACxB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE;YAC5B,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,eAAe,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAQD;sDACsD;AACtD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAA0B,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,qBAAqB,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAE9C,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,KAAK,CAAC;IACrC,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE;YAC5B,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,eAAe,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/core/alerts/drift-transition.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Version-drift alert transition logic — decides WHEN to fire, not
+ * whether to fire on every poll. Firing on every `behind: true` read
+ * would spam the webhook on every scheduled check; instead this tracks
+ * the false→true edge (fire once) and a daily re-fire while the daemon
+ * stays behind past a 48h grace window (so a long-ignored update still
+ * resurfaces, but not hourly).
+ *
+ * Pure and clock-injected — no fs/network here. Callers (see
+ * check-and-alert.ts) own reading/writing the persisted state and
+ * calling fireAlert with the returned event.
+ */
+import type { UpdateStatus } from "../update-check/check.js";
+import type { DriftAlertEvent } from "./types.js";
+export interface DriftAlertState {
+    /** ISO timestamp of when `behind` first became true, or null when not behind. */
+    readonly behindSince: string | null;
+    /** ISO timestamp of the last fired alert (initial or daily re-fire). */
+    readonly lastFiredAt: string | null;
+}
+export declare const DEFAULT_DRIFT_ALERT_STATE: DriftAlertState;
+export interface DriftTransitionResult {
+    readonly fire: boolean;
+    readonly event: DriftAlertEvent | null;
+    readonly next: DriftAlertState;
+}
+export declare function evaluateDriftTransition(state: DriftAlertState, status: Pick<UpdateStatus, "current" | "latest" | "behind">, now: Date): DriftTransitionResult;