@aitne/daemon 0.1.0

package/dist/observers/mail-reconciliation.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Mail reconciliation observer (Phase 7, §3.1.1).
+ *
+ * Two responsibilities, both run on a daily cadence and both kept out of the
+ * real-time {@link MailPoller} path so their slower failure modes don't
+ * contaminate delta polling:
+ *
+ * 1. IMAP deletion reconciliation. The poll path cannot detect deletions
+ *    without QRESYNC because `pollSince()` only walks UIDs above the cursor
+ *    watermark. We periodically re-list UIDs in each indexed folder and diff
+ *    against the local index to soft-delete rows for messages the user moved
+ *    or purged outside our sight.
+ *
+ * 2. Cross-provider purge of rows soft-deleted more than
+ *    {@link MAIL_PURGE_DAYS} ago, so `mail_messages_index` does not grow
+ *    unbounded.
+ *
+ * Per-account isolation matches the mail poller: one IMAP account's failure
+ * (auth lapse, server unreachable) never blocks the others. The job also
+ * honors daemon shutdown — a reconcile pass in flight when `stop()` is
+ * called completes its current folder before returning.
+ *
+ * **QRESYNC status.** Each tick reads `provider.getCapabilities()` and logs
+ * whether QRESYNC is advertised on the account. Today both branches use
+ * UID SEARCH + local diff (see {@link planImapReconcile}). Flipping the
+ * QRESYNC branch to a `SELECT ... (QRESYNC ...)` with VANISHED-response
+ * collection requires extending the IMAP poll cursor with `modSeq`, which is
+ * a schema change deferred to a follow-up phase. Structuring the branch
+ * here now keeps the capabilities pipeline alive and makes the upgrade a
+ * one-file change when the cursor format ships.
+ */
+import type Database from "better-sqlite3";
+import type { Observer } from "./manager.js";
+import type { MailAccountRegistry } from "../services/mail/account-registry.js";
+/** Age threshold for the cross-provider purge of soft-deleted rows. */
+export declare const MAIL_PURGE_DAYS = 90;
+/**
+ * Upper bound on how many UIDs back from the cursor's `lastUid` a single
+ * reconcile pass walks. Caps IMAP SEARCH cost on multi-100k-message folders
+ * (§12 open-question #3). Older rows stay in the index and only disappear
+ * via the purge step once the owner explicitly deletes them upstream.
+ */
+export declare const MAIL_RECONCILE_UID_WINDOW = 5000;
+/**
+ * Delay before the first tick runs after `start()`. Non-zero so a daemon
+ * reboot doesn't race with the initial poller pass; not the full interval
+ * so a crashloop doesn't leave days of drift. Ten minutes balances those.
+ */
+export declare const MAIL_RECONCILE_INITIAL_DELAY_MS: number;
+export interface MailReconciliationOptions {
+    registry: MailAccountRegistry;
+    db: Database.Database;
+    /** Interval in ms. Defaults to once per 24 hours. */
+    intervalMs?: number;
+    /** First-tick delay in ms. Defaults to {@link MAIL_RECONCILE_INITIAL_DELAY_MS}. */
+    initialDelayMs?: number;
+    /** Age threshold in days for the purge step. Defaults to {@link MAIL_PURGE_DAYS}. */
+    purgeDays?: number;
+    /** Injected clock for tests. */
+    now?: () => Date;
+}
+export declare class MailReconciliationJob implements Observer {
+    readonly name = "mail-reconciliation";
+    private readonly registry;
+    private readonly db;
+    private readonly intervalMs;
+    private readonly initialDelayMs;
+    private readonly purgeDays;
+    private readonly now;
+    private timer;
+    private initialTimer;
+    private inFlight;
+    private stopped;
+    constructor(opts: MailReconciliationOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    tick(): Promise<void>;
+    private runImapReconcile;
+    private reconcileAccount;
+    private reconcileFolder;
+    private listIndexedFolders;
+    private hasCursorEntryForFolder;
+    private computeWindowStart;
+    private loadLocalMessages;
+    private runPurge;
+}
+//# sourceMappingURL=mail-reconciliation.d.ts.map

package/dist/observers/mail-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-reconciliation.d.ts","sourceRoot":"","sources":["../../src/observers/mail-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAchF,uEAAuE;AACvE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAAiB,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,qBAAa,qBAAsB,YAAW,QAAQ;IACpD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,yBAAyB;IAUrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAYrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAab,gBAAgB;YAmBhB,gBAAgB;YA4ChB,eAAe;IA2C7B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,QAAQ;CAkBjB"}

package/dist/observers/mail-reconciliation.js

@@ -0,0 +1,241 @@
+/**
+ * Mail reconciliation observer (Phase 7, §3.1.1).
+ *
+ * Two responsibilities, both run on a daily cadence and both kept out of the
+ * real-time {@link MailPoller} path so their slower failure modes don't
+ * contaminate delta polling:
+ *
+ * 1. IMAP deletion reconciliation. The poll path cannot detect deletions
+ *    without QRESYNC because `pollSince()` only walks UIDs above the cursor
+ *    watermark. We periodically re-list UIDs in each indexed folder and diff
+ *    against the local index to soft-delete rows for messages the user moved
+ *    or purged outside our sight.
+ *
+ * 2. Cross-provider purge of rows soft-deleted more than
+ *    {@link MAIL_PURGE_DAYS} ago, so `mail_messages_index` does not grow
+ *    unbounded.
+ *
+ * Per-account isolation matches the mail poller: one IMAP account's failure
+ * (auth lapse, server unreachable) never blocks the others. The job also
+ * honors daemon shutdown — a reconcile pass in flight when `stop()` is
+ * called completes its current folder before returning.
+ *
+ * **QRESYNC status.** Each tick reads `provider.getCapabilities()` and logs
+ * whether QRESYNC is advertised on the account. Today both branches use
+ * UID SEARCH + local diff (see {@link planImapReconcile}). Flipping the
+ * QRESYNC branch to a `SELECT ... (QRESYNC ...)` with VANISHED-response
+ * collection requires extending the IMAP poll cursor with `modSeq`, which is
+ * a schema change deferred to a follow-up phase. Structuring the branch
+ * here now keeps the capabilities pipeline alive and makes the upgrade a
+ * one-file change when the cursor format ships.
+ */
+import { isImapReconcileSource, } from "../services/mail/imap/imap-provider-base.js";
+import { planImapReconcile, } from "../services/mail/imap/reconcile-planner.js";
+import { createLogger } from "../logging.js";
+const logger = createLogger("mail-reconciliation");
+/** Age threshold for the cross-provider purge of soft-deleted rows. */
+export const MAIL_PURGE_DAYS = 90;
+/**
+ * Upper bound on how many UIDs back from the cursor's `lastUid` a single
+ * reconcile pass walks. Caps IMAP SEARCH cost on multi-100k-message folders
+ * (§12 open-question #3). Older rows stay in the index and only disappear
+ * via the purge step once the owner explicitly deletes them upstream.
+ */
+export const MAIL_RECONCILE_UID_WINDOW = 5000;
+/**
+ * Delay before the first tick runs after `start()`. Non-zero so a daemon
+ * reboot doesn't race with the initial poller pass; not the full interval
+ * so a crashloop doesn't leave days of drift. Ten minutes balances those.
+ */
+export const MAIL_RECONCILE_INITIAL_DELAY_MS = 10 * 60 * 1000;
+export class MailReconciliationJob {
+    name = "mail-reconciliation";
+    registry;
+    db;
+    intervalMs;
+    initialDelayMs;
+    purgeDays;
+    now;
+    timer = null;
+    initialTimer = null;
+    inFlight = false;
+    stopped = false;
+    constructor(opts) {
+        this.registry = opts.registry;
+        this.db = opts.db;
+        this.intervalMs = opts.intervalMs ?? 24 * 3600 * 1000;
+        this.initialDelayMs =
+            opts.initialDelayMs ?? MAIL_RECONCILE_INITIAL_DELAY_MS;
+        this.purgeDays = opts.purgeDays ?? MAIL_PURGE_DAYS;
+        this.now = opts.now ?? (() => new Date());
+    }
+    async start() {
+        if (this.initialDelayMs > 0) {
+            this.initialTimer = setTimeout(() => {
+                this.initialTimer = null;
+                void this.tick();
+            }, this.initialDelayMs);
+        }
+        this.timer = setInterval(() => void this.tick(), this.intervalMs);
+        logger.info({ intervalMs: this.intervalMs, initialDelayMs: this.initialDelayMs }, "Mail reconciliation started");
+    }
+    async stop() {
+        this.stopped = true;
+        if (this.initialTimer) {
+            clearTimeout(this.initialTimer);
+            this.initialTimer = null;
+        }
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async tick() {
+        if (this.inFlight || this.stopped)
+            return;
+        this.inFlight = true;
+        try {
+            await this.runImapReconcile();
+            this.runPurge();
+        }
+        catch (err) {
+            logger.error({ err }, "Mail reconciliation tick failed");
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+    async runImapReconcile() {
+        // No kind filter — the provider's own shape decides eligibility
+        // (duck-typed via `isImapReconcileSource`). This keeps us open to
+        // hypothetical third IMAP subclasses without editing this file.
+        const accounts = this.registry.listActiveAccounts();
+        for (const account of accounts) {
+            if (this.stopped)
+                break;
+            try {
+                await this.reconcileAccount(account);
+            }
+            catch (err) {
+                logger.error({ err, accountId: account.id }, "IMAP reconciliation failed");
+            }
+        }
+    }
+    async reconcileAccount(account) {
+        const provider = await this.registry.getProvider(account.id);
+        if (!isImapReconcileSource(provider))
+            return;
+        const caps = provider.getCapabilities();
+        // Record the strategy the pass *would* take. Both branches currently use
+        // UID SEARCH; see class-level docstring for the QRESYNC upgrade path.
+        const strategy = caps?.qresync ? "uid-search (qresync-eligible)" : "uid-search";
+        const folders = this.listIndexedFolders(account.id);
+        if (folders.length === 0)
+            return;
+        let totalMissing = 0;
+        let totalSkipped = 0;
+        for (const folder of folders) {
+            if (this.stopped)
+                break;
+            // Per-folder isolation: a single bad folder must not abort the rest of
+            // the account's reconcile pass. Log + continue so the next folder runs.
+            try {
+                const counts = await this.reconcileFolder(provider, account.id, folder);
+                totalMissing += counts.missing;
+                totalSkipped += counts.skipped;
+            }
+            catch (err) {
+                logger.error({ err, accountId: account.id, folder }, "IMAP folder reconciliation failed");
+            }
+        }
+        if (totalMissing > 0 || totalSkipped > 0) {
+            logger.info({
+                accountId: account.id,
+                folderCount: folders.length,
+                missingCount: totalMissing,
+                skippedCount: totalSkipped,
+                strategy,
+            }, "IMAP reconciliation completed");
+        }
+    }
+    async reconcileFolder(provider, accountId, folder) {
+        // Without a cursor entry for this folder we have no upper bound for the
+        // SEARCH, which on a multi-100k-message folder would translate to
+        // `SEARCH ALL`. Defer until the poll path establishes a cursor; the next
+        // reconcile tick after a successful poll will pick it up. (A small
+        // lastUid is still fine — `computeWindowStart` clamps the floor at 0
+        // and we walk from UID 1.)
+        if (!this.hasCursorEntryForFolder(accountId, folder)) {
+            return { missing: 0, skipped: 0 };
+        }
+        const windowStart = this.computeWindowStart(accountId, folder);
+        const { uidValidity, uids } = await provider.listExistingUids(folder, {
+            sinceUid: windowStart,
+        });
+        const local = this.loadLocalMessages(accountId, folder);
+        const plan = planImapReconcile({
+            serverUidValidity: uidValidity,
+            serverUids: uids,
+            localMessages: local,
+            minUidWalked: windowStart,
+        });
+        if (plan.missingIds.length > 0) {
+            const nowIso = this.now().toISOString();
+            const update = this.db.prepare(`UPDATE mail_messages_index
+            SET deleted_at_utc = ?
+          WHERE account_id = ? AND provider_msg_id = ? AND deleted_at_utc IS NULL`);
+            const tx = this.db.transaction((ids) => {
+                for (const id of ids)
+                    update.run(nowIso, accountId, id);
+            });
+            tx(plan.missingIds);
+        }
+        return { missing: plan.missingIds.length, skipped: plan.skippedIds.length };
+    }
+    listIndexedFolders(accountId) {
+        const rows = this.db
+            .prepare(`SELECT DISTINCT folder
+           FROM mail_messages_index
+          WHERE account_id = ? AND deleted_at_utc IS NULL`)
+            .all(accountId);
+        return rows.map((r) => r.folder);
+    }
+    hasCursorEntryForFolder(accountId, folder) {
+        const cursor = this.registry.loadPollCursor(accountId);
+        if (!cursor || cursor.kind !== "imap")
+            return false;
+        return cursor.folders[folder] !== undefined;
+    }
+    computeWindowStart(accountId, folder) {
+        const cursor = this.registry.loadPollCursor(accountId);
+        if (!cursor || cursor.kind !== "imap")
+            return 0;
+        const entry = cursor.folders[folder];
+        if (!entry)
+            return 0;
+        return Math.max(entry.lastUid - MAIL_RECONCILE_UID_WINDOW, 0);
+    }
+    loadLocalMessages(accountId, folder) {
+        const rows = this.db
+            .prepare(`SELECT provider_msg_id AS providerMsgId,
+                received_at_utc  AS receivedAtUtc
+           FROM mail_messages_index
+          WHERE account_id = ?
+            AND folder = ?
+            AND deleted_at_utc IS NULL`)
+            .all(accountId, folder);
+        return rows;
+    }
+    runPurge() {
+        const cutoff = new Date(this.now().getTime() - this.purgeDays * 24 * 3600 * 1000).toISOString();
+        const result = this.db
+            .prepare(`DELETE FROM mail_messages_index
+          WHERE deleted_at_utc IS NOT NULL
+            AND deleted_at_utc < ?`)
+            .run(cutoff);
+        if (result.changes > 0) {
+            logger.info({ purgedCount: result.changes, cutoff }, "Purged expired soft-deleted mail index rows");
+        }
+    }
+}
+//# sourceMappingURL=mail-reconciliation.js.map

package/dist/observers/mail-reconciliation.js.map

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

package/dist/observers/manager.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Observer — anything that detects external changes and emits events.
+ */
+export interface Observer {
+    readonly name: string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * ObserverManager — central registry for all change-detection observers.
+ *
+ * Manages lifecycle (start/stop) for:
+ * - ObsidianWatcher (chokidar file system events)
+ * - GitWatcher (git log polling)
+ * - CalendarPoller (Google Calendar API polling)
+ * - NotionPoller (Notion API polling, Phase 3)
+ */
+export declare class ObserverManager {
+    private readonly observers;
+    /**
+     * Management Mode Phase 2: pause-state tracks which observers were
+     * running at the moment `pauseAll()` was invoked so `resumeAll()` only
+     * restarts the ones it stopped — not observers that the user had
+     * already disabled or that failed to start in the first place. A set
+     * of names is enough because each observer's identity is its name.
+     */
+    private pausedNames;
+    register(observer: Observer): void;
+    startAll(): Promise<void>;
+    stopAll(): Promise<void>;
+    /**
+     * Management Mode Phase 2 migration hook — stops every registered
+     * observer and remembers the set so `resumeAll()` can restart exactly
+     * those observers once the migration commits or rolls back.
+     *
+     * Idempotent: a second `pauseAll()` before `resumeAll()` is a no-op
+     * and preserves the original paused set. The migration endpoint uses
+     * this pattern to guarantee `finally { resumeAll() }` works even when
+     * an early-abort path retries pause.
+     */
+    pauseAll(): Promise<void>;
+    /**
+     * Restart observers that were running at `pauseAll()` time. If
+     * `pauseAll()` was never called, this is a no-op — callers that always
+     * pair pause/resume in a `try/finally` get safe behavior either way.
+     */
+    resumeAll(): Promise<void>;
+    isPaused(): boolean;
+    has(name: string): boolean;
+    getObservers(): readonly Observer[];
+    /**
+     * Hot-add path used by the integration delegation framework (§4.10
+     * lifecycle): when `direct → delegated → direct` flips at runtime, we
+     * register the observer AND start it without requiring a daemon
+     * restart. Idempotent — re-registering a same-named observer is a no-op
+     * so repeated PATCH calls don't pile duplicates.
+     */
+    registerAndStart(observer: Observer): Promise<void>;
+    /**
+     * Hot-remove path used by §4.10. Stops the named observer and removes it
+     * from the registry. Returns true when the observer was found, false
+     * otherwise — callers can rely on the boolean for audit logging without
+     * a separate `has()` round-trip.
+     */
+    stopAndUnregister(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/observers/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/observers/manager.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C;;;;;;OAMG;IACH,OAAO,CAAC,WAAW,CAA4B;IAE/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;;;;;;;;OASG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAa/B;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBhC,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,YAAY,IAAI,SAAS,QAAQ,EAAE;IAInC;;;;;;OAMG;IACG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzD;;;;;OAKG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAexD"}

package/dist/observers/manager.js

@@ -0,0 +1,136 @@
+import { createLogger } from "../logging.js";
+const logger = createLogger("observer-manager");
+/**
+ * ObserverManager — central registry for all change-detection observers.
+ *
+ * Manages lifecycle (start/stop) for:
+ * - ObsidianWatcher (chokidar file system events)
+ * - GitWatcher (git log polling)
+ * - CalendarPoller (Google Calendar API polling)
+ * - NotionPoller (Notion API polling, Phase 3)
+ */
+export class ObserverManager {
+    observers = [];
+    /**
+     * Management Mode Phase 2: pause-state tracks which observers were
+     * running at the moment `pauseAll()` was invoked so `resumeAll()` only
+     * restarts the ones it stopped — not observers that the user had
+     * already disabled or that failed to start in the first place. A set
+     * of names is enough because each observer's identity is its name.
+     */
+    pausedNames = null;
+    register(observer) {
+        this.observers.push(observer);
+        logger.info({ observer: observer.name }, "Observer registered");
+    }
+    async startAll() {
+        const results = await Promise.allSettled(this.observers.map((o) => o.start()));
+        for (const [i, result] of results.entries()) {
+            if (result.status === "rejected") {
+                logger.error({ observer: this.observers[i].name, error: result.reason }, "Failed to start observer");
+            }
+            else {
+                logger.info({ observer: this.observers[i].name }, "Observer started");
+            }
+        }
+    }
+    async stopAll() {
+        const results = await Promise.allSettled(this.observers.map((o) => o.stop()));
+        for (const [i, result] of results.entries()) {
+            if (result.status === "rejected") {
+                logger.error({ observer: this.observers[i].name, error: result.reason }, "Failed to stop observer");
+            }
+        }
+    }
+    /**
+     * Management Mode Phase 2 migration hook — stops every registered
+     * observer and remembers the set so `resumeAll()` can restart exactly
+     * those observers once the migration commits or rolls back.
+     *
+     * Idempotent: a second `pauseAll()` before `resumeAll()` is a no-op
+     * and preserves the original paused set. The migration endpoint uses
+     * this pattern to guarantee `finally { resumeAll() }` works even when
+     * an early-abort path retries pause.
+     */
+    async pauseAll() {
+        if (this.pausedNames !== null) {
+            logger.debug({ count: this.pausedNames.size }, "ObserverManager already paused — skipping re-pause");
+            return;
+        }
+        this.pausedNames = new Set(this.observers.map((o) => o.name));
+        await this.stopAll();
+        logger.info({ count: this.pausedNames.size }, "Observers paused");
+    }
+    /**
+     * Restart observers that were running at `pauseAll()` time. If
+     * `pauseAll()` was never called, this is a no-op — callers that always
+     * pair pause/resume in a `try/finally` get safe behavior either way.
+     */
+    async resumeAll() {
+        if (this.pausedNames === null) {
+            logger.debug("ObserverManager not paused — nothing to resume");
+            return;
+        }
+        const toResume = this.observers.filter((o) => this.pausedNames.has(o.name));
+        this.pausedNames = null;
+        const results = await Promise.allSettled(toResume.map((o) => o.start()));
+        for (const [i, result] of results.entries()) {
+            if (result.status === "rejected") {
+                logger.error({ observer: toResume[i].name, error: result.reason }, "Failed to resume observer after pause");
+            }
+        }
+        logger.info({ count: toResume.length }, "Observers resumed");
+    }
+    isPaused() {
+        return this.pausedNames !== null;
+    }
+    has(name) {
+        return this.observers.some((o) => o.name === name);
+    }
+    getObservers() {
+        return this.observers;
+    }
+    /**
+     * Hot-add path used by the integration delegation framework (§4.10
+     * lifecycle): when `direct → delegated → direct` flips at runtime, we
+     * register the observer AND start it without requiring a daemon
+     * restart. Idempotent — re-registering a same-named observer is a no-op
+     * so repeated PATCH calls don't pile duplicates.
+     */
+    async registerAndStart(observer) {
+        if (this.has(observer.name)) {
+            logger.debug({ observer: observer.name }, "Observer already registered — skipping registerAndStart");
+            return;
+        }
+        this.register(observer);
+        try {
+            await observer.start();
+            logger.info({ observer: observer.name }, "Observer started (hot-add)");
+        }
+        catch (err) {
+            logger.error({ observer: observer.name, err }, "Hot-add observer.start failed");
+            throw err;
+        }
+    }
+    /**
+     * Hot-remove path used by §4.10. Stops the named observer and removes it
+     * from the registry. Returns true when the observer was found, false
+     * otherwise — callers can rely on the boolean for audit logging without
+     * a separate `has()` round-trip.
+     */
+    async stopAndUnregister(name) {
+        const idx = this.observers.findIndex((o) => o.name === name);
+        if (idx < 0)
+            return false;
+        const [removed] = this.observers.splice(idx, 1);
+        try {
+            await removed.stop();
+            logger.info({ observer: name }, "Observer stopped (hot-remove)");
+        }
+        catch (err) {
+            logger.error({ observer: name, err }, "Hot-remove observer.stop failed — observer already unregistered");
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/observers/manager.js.map

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

package/dist/observers/notion-poller.d.ts

@@ -0,0 +1,43 @@
+import type Database from "better-sqlite3";
+import type { Observer } from "./manager.js";
+import type { NotionService } from "../services/notion.js";
+import type { AgentWriteTracker } from "../safety/agent-write-tracker.js";
+export interface NotionPollerOptions {
+    notionService: NotionService;
+    databaseIds: Record<string, string>;
+    pollIntervalSeconds: number;
+    db: Database.Database;
+    writeTracker?: AgentWriteTracker;
+}
+/**
+ * NotionPoller — polls Notion data sources for changes via NotionService.
+ *
+ * - Paginates through `has_more`/`next_cursor` so large batches don't drop rows
+ * - Persists `lastEditedTime` + trashed-IDs in `runtime_state` across restarts
+ *   (daemon downtime no longer silently discards changes)
+ * - Queries `in_trash: true` as a second pass to detect archive transitions
+ *   and records them as `change_type: 'deleted'`
+ * - Consults `AgentWriteTracker` so pages the daemon API just wrote are
+ *   attributed to `actor='agent'` instead of triggering another hourly loop
+ */
+export declare class NotionPoller implements Observer {
+    readonly name = "notion-poller";
+    private readonly notionService;
+    private readonly databaseIds;
+    private readonly pollIntervalMs;
+    private readonly db;
+    private readonly writeTracker?;
+    private timer;
+    constructor(opts: NotionPollerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private pollAll;
+    /** Poll one data source: active pages (by last_edited_time), then trashed pages. */
+    private pollDatabase;
+    private recordPageObservation;
+}
+/** Short human-readable summary of status/select/date properties. */
+export declare function extractPropertySummary(page: {
+    properties?: Record<string, Record<string, unknown>>;
+}): string;
+//# sourceMappingURL=notion-poller.d.ts.map

package/dist/observers/notion-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion-poller.d.ts","sourceRoot":"","sources":["../../src/observers/notion-poller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAK1E,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAyBD;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,mBAAmB;IAEhC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAoB;IAElD,OAAO,CAAC,KAAK,CAA+C;gBAEhD,IAAI,EAAE,mBAAmB;IAQ/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAQb,OAAO;IAUrB,oFAAoF;YACtE,YAAY;IA8D1B,OAAO,CAAC,qBAAqB;CA2B9B;AAkBD,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD,GAAG,MAAM,CAaT"}