@aitne/daemon 0.1.3 → 0.1.6

package/dist/bootstrap/adapters.js

@@ -0,0 +1,237 @@
+/**
+ * Messaging-adapter bootstrap — Discord / Slack / Telegram / WhatsApp.
+ *
+ * Extracted from the `startup()` IIFE in `index.ts` per
+ * `docs/design/appendices/file-split-plan.md` §10 (Tier 2, Pattern C).
+ *
+ * Goal: lift the four reload routines + the WhatsApp build/teardown
+ * helpers out of the startup lambda so the lambda reads as a sequence
+ * rather than a 3,000-line bag of closures.
+ *
+ * Shape: `createAdapterReloaders(deps)` is a factory that captures a
+ * `BootstrapAdapterDeps` record once and returns the closures the IIFE
+ * used to define inline. The mutable adapter references live in a
+ * shared `AdapterState` object passed in via `deps.state`, which the
+ * factory reads and writes — `index.ts` continues to inspect the same
+ * state for pairing / `/health` reporting after the reload functions
+ * complete. Captured references match the pre-extraction behavior:
+ *  - The closures register / unregister with `messageHub`.
+ *  - `onMessage` enqueues to `eventBus`.
+ *  - Discovered owner ids flow back through `recordDetectedOwner`.
+ *  - Attachment downloads use the shared `attachmentStore`.
+ *  - WhatsApp logout fires `onWhatsAppLoggedOut`, which currently
+ *    posts a fallback notification through the message hub.
+ *
+ * `whatsappQrResponseFromAdapter` is a pure projection from
+ * adapter+snapshot → wire response and is exported separately so the
+ * dashboard controls path can call it without going through the
+ * factory.
+ */
+import { join } from "node:path";
+import { DiscordAdapter } from "../adapters/discord.js";
+import { SlackAdapter } from "../adapters/slack-adapter.js";
+import { TelegramAdapter } from "../adapters/telegram-adapter.js";
+import { WhatsAppAdapter, } from "../adapters/whatsapp-adapter.js";
+import { createLogger, toSafeErrorMessage } from "../logging.js";
+const logger = createLogger("daemon-bootstrap-adapters");
+export function createAdapterReloaders(deps) {
+    const { config, secretBroker, messageHub, eventBus, attachmentStore, recordDetectedOwner, onWhatsAppLoggedOut, state, } = deps;
+    async function reloadDiscordAdapter(startNow) {
+        const botToken = await secretBroker.getDiscordBotToken();
+        const configured = !!botToken;
+        messageHub.setPlatformConfigured("discord", configured);
+        if (state.discord) {
+            try {
+                await state.discord.stop();
+            }
+            catch (err) {
+                logger.warn({ err }, "Failed to stop Discord adapter during reload");
+            }
+            messageHub.unregister("discord");
+            state.discord = null;
+        }
+        if (!botToken) {
+            return;
+        }
+        state.discord = new DiscordAdapter({
+            botToken,
+            ownerUserId: config.discordOwnerUserId,
+            onMessage: (event) => void eventBus.put(event),
+            onOwnerDetected: (userId) => recordDetectedOwner("discord", userId),
+            attachmentStore,
+        });
+        messageHub.register(state.discord);
+        if (startNow) {
+            // Mark as "connecting" while the websocket handshake is in flight so
+            // /health doesn't briefly report "ok" before the adapter actually
+            // comes up (register() defaults to "ok" to keep the notification
+            // pipeline usable in unit tests; this override is the real state).
+            messageHub.setPlatformRuntimeStatus("discord", { runtimeState: "connecting", error: null });
+            try {
+                await state.discord.start();
+                messageHub.setPlatformRuntimeStatus("discord", { runtimeState: "ok", error: null });
+            }
+            catch (err) {
+                const message = toSafeErrorMessage(err, "Discord adapter failed to start");
+                messageHub.setPlatformRuntimeStatus("discord", { runtimeState: "error", error: message });
+                logger.error({ err }, "Failed to start Discord adapter during reload");
+            }
+        }
+    }
+    async function reloadSlackAdapter(startNow) {
+        const [botToken, appToken] = await Promise.all([
+            secretBroker.getSlackBotToken(),
+            secretBroker.getSlackAppToken(),
+        ]);
+        const configured = !!(botToken && appToken);
+        messageHub.setPlatformConfigured("slack", configured);
+        if (state.slack) {
+            try {
+                await state.slack.stop();
+            }
+            catch (err) {
+                logger.warn({ err }, "Failed to stop Slack adapter during reload");
+            }
+            messageHub.unregister("slack");
+            state.slack = null;
+        }
+        if (!botToken || !appToken) {
+            return;
+        }
+        state.slack = new SlackAdapter({
+            botToken,
+            appToken,
+            ownerUserId: config.slackOwnerUserId,
+            onMessage: (event) => void eventBus.put(event),
+            onOwnerDetected: (userId) => recordDetectedOwner("slack", userId),
+            attachmentStore,
+        });
+        messageHub.register(state.slack);
+        if (startNow) {
+            messageHub.setPlatformRuntimeStatus("slack", { runtimeState: "connecting", error: null });
+            try {
+                await state.slack.start();
+                messageHub.setPlatformRuntimeStatus("slack", { runtimeState: "ok", error: null });
+            }
+            catch (err) {
+                const message = toSafeErrorMessage(err, "Slack adapter failed to start");
+                messageHub.setPlatformRuntimeStatus("slack", { runtimeState: "error", error: message });
+                logger.error({ err }, "Failed to start Slack adapter during reload");
+            }
+        }
+    }
+    async function reloadTelegramAdapter(startNow) {
+        const botToken = await secretBroker.getTelegramBotToken();
+        const configured = !!botToken;
+        messageHub.setPlatformConfigured("telegram", configured);
+        if (state.telegram) {
+            try {
+                await state.telegram.stop();
+            }
+            catch (err) {
+                logger.warn({ err }, "Failed to stop Telegram adapter during reload");
+            }
+            messageHub.unregister("telegram");
+            state.telegram = null;
+        }
+        if (!botToken) {
+            return;
+        }
+        state.telegram = new TelegramAdapter({
+            botToken,
+            ownerChatId: config.telegramOwnerChatId,
+            onMessage: (event) => void eventBus.put(event),
+            onOwnerDetected: (chatId) => recordDetectedOwner("telegram", chatId),
+            attachmentStore,
+        });
+        messageHub.register(state.telegram);
+        if (startNow) {
+            messageHub.setPlatformRuntimeStatus("telegram", { runtimeState: "connecting", error: null });
+            try {
+                await state.telegram.start();
+                messageHub.setPlatformRuntimeStatus("telegram", { runtimeState: "ok", error: null });
+            }
+            catch (err) {
+                const message = toSafeErrorMessage(err, "Telegram adapter failed to start");
+                messageHub.setPlatformRuntimeStatus("telegram", { runtimeState: "error", error: message });
+                logger.error({ err }, "Failed to start Telegram adapter during reload");
+            }
+        }
+    }
+    function buildWhatsAppAdapter() {
+        if (!config.whatsappOwnerPhone) {
+            throw new Error("Cannot enable WhatsApp: PA_WHATSAPP_OWNER_PHONE is not set");
+        }
+        const existing = messageHub.getAdapter("whatsapp");
+        if (existing && state.whatsapp && existing === state.whatsapp) {
+            return state.whatsapp;
+        }
+        const adapter = new WhatsAppAdapter({
+            ownerPhone: config.whatsappOwnerPhone,
+            authDir: config.whatsappAuthDir ?? join(config.dataDir, "whatsapp", "auth"),
+            onMessage: (event) => void eventBus.put(event),
+            attachmentStore,
+            onLoggedOut: onWhatsAppLoggedOut,
+        });
+        messageHub.register(adapter);
+        state.whatsapp = adapter;
+        return adapter;
+    }
+    async function teardownWhatsAppAdapter() {
+        if (!state.whatsapp)
+            return;
+        try {
+            await state.whatsapp.stop();
+        }
+        catch (err) {
+            logger.warn({ err }, "Error stopping WhatsApp adapter during teardown");
+        }
+        messageHub.unregister("whatsapp");
+        state.whatsapp = null;
+    }
+    async function enableWhatsAppAdapter() {
+        const adapter = buildWhatsAppAdapter();
+        if (adapter.getStatus() === "disabled") {
+            await adapter.start();
+        }
+    }
+    return {
+        reloadDiscordAdapter,
+        reloadSlackAdapter,
+        reloadTelegramAdapter,
+        buildWhatsAppAdapter,
+        teardownWhatsAppAdapter,
+        enableWhatsAppAdapter,
+    };
+}
+/**
+ * Pure projection of the WhatsApp adapter (+ optional snapshot
+ * override) into the `WhatsAppQrResponse` wire shape. Lives outside
+ * `createAdapterReloaders` because the dashboard controls path needs
+ * to call it after the factory has returned; it has no state of its
+ * own.
+ */
+export function whatsappQrResponseFromAdapter(adapter, snapshotOverride) {
+    if (!adapter) {
+        return {
+            dataUrl: null,
+            payload: null,
+            generatedAt: null,
+            expiresAt: null,
+            state: "not_initialized",
+            error: "WhatsApp adapter not enabled",
+        };
+    }
+    const snapshot = snapshotOverride !== undefined
+        ? snapshotOverride
+        : adapter.getQrSnapshot();
+    return {
+        dataUrl: snapshot?.dataUrl ?? null,
+        payload: snapshot?.payload ?? null,
+        generatedAt: snapshot?.generatedAt ?? null,
+        expiresAt: snapshot?.expiresAt ?? null,
+        state: adapter.getStatus(),
+        error: adapter.getStatusError(),
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/bootstrap/adapters.js.map

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

package/dist/bootstrap/catchup.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Boot-time catchup sequence — pure-move from `index.ts` per
+ * `docs/design/appendices/file-split-plan.md` §10. Pattern A: each function
+ * takes its dependencies (db, dispatcher, config) as arguments so the
+ * startup IIFE can compose them without going through `this`.
+ *
+ * Policy (unchanged from origin):
+ * - discard previous-agent-day pending tasks instead of replaying them
+ * - fail/skip orphaned running tasks instead of blindly retrying side effects
+ * - catch up same-agent-day routines only once
+ */
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+import type { EventDispatcher } from "../core/dispatcher.js";
+export interface StartupCatchupResult {
+    postMessagingRoadmapRefresh: boolean;
+    postMessagingRoutines: string[];
+    postMessagingHourlyCheck: boolean;
+}
+export declare function runCatchup(db: Database.Database, dispatcher: EventDispatcher, config: AgentConfig): Promise<StartupCatchupResult>;
+export declare function runPostMessagingCatchup(dispatcher: EventDispatcher, catchup: StartupCatchupResult): Promise<void>;
+export declare function processRoutineCatchup(dispatcher: EventDispatcher, routine: string): Promise<void>;
+//# sourceMappingURL=catchup.d.ts.map

package/dist/bootstrap/catchup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchup.d.ts","sourceRoot":"","sources":["../../src/bootstrap/catchup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAc7D,MAAM,WAAW,oBAAoB;IACnC,2BAA2B,EAAE,OAAO,CAAC;IACrC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,UAAU,EAAE,eAAe,EAC3B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,oBAAoB,CAAC,CAkH/B;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/bootstrap/catchup.js

@@ -0,0 +1,124 @@
+/**
+ * Boot-time catchup sequence — pure-move from `index.ts` per
+ * `docs/design/appendices/file-split-plan.md` §10. Pattern A: each function
+ * takes its dependencies (db, dispatcher, config) as arguments so the
+ * startup IIFE can compose them without going through `this`.
+ *
+ * Policy (unchanged from origin):
+ * - discard previous-agent-day pending tasks instead of replaying them
+ * - fail/skip orphaned running tasks instead of blindly retrying side effects
+ * - catch up same-agent-day routines only once
+ */
+import { join } from "node:path";
+import { createEvent, EventPriority, getAgentDayBoundsUtc, } from "@aitne/shared";
+import { getContextDir, isRoadmapStale } from "../config.js";
+import { discardStalePendingSchedules, recoverOrphanedRunningSchedules, } from "../core/schedule-maintenance.js";
+import { createLogger } from "../logging.js";
+import { getDueCatchupRoutines, hasFreshAgentDayTodayMd, shouldCatchUpHourlyCheck, } from "./schedule-helpers.js";
+const logger = createLogger("daemon-bootstrap-catchup");
+export async function runCatchup(db, dispatcher, config) {
+    // Setup gate — on first boot (before rules/management.md exists) we must
+    // NOT run the morning routine. Without user/profile.md / rules/management.md
+    // the generated today.md is meaningless AND it fires
+    // onPromptContextChanged → markActiveDmSessionsStale, which destroys the
+    // dashboard setup conversation on the user's next turn. Autonomous
+    // catchup will run on the first normal boot *after* setup completes.
+    const gateReason = dispatcher.isAutonomousAllowed();
+    if (gateReason !== null) {
+        logger.info({ reason: gateReason }, "Skipping startup catchup — autonomous work paused for setup");
+        return {
+            postMessagingRoadmapRefresh: false,
+            postMessagingRoutines: [],
+            postMessagingHourlyCheck: false,
+        };
+    }
+    const now = new Date();
+    const tz = config.timezone || undefined;
+    const contextDir = getContextDir(config);
+    const todayMdPath = join(contextDir, "today.md");
+    const { start: agentDayStartUtc, end: agentDayEndUtc } = getAgentDayBoundsUtc(tz, config.dayBoundaryHour, now);
+    const skippedPending = discardStalePendingSchedules(db, agentDayStartUtc);
+    if (skippedPending > 0) {
+        logger.warn({ count: skippedPending }, "Discarded stale pending schedules at startup");
+    }
+    const runningRecovery = recoverOrphanedRunningSchedules(db, agentDayStartUtc);
+    if (runningRecovery.skipped > 0 || runningRecovery.failed > 0) {
+        logger.warn(runningRecovery, "Recovered orphaned running schedules without replay");
+    }
+    // Pin to the same `now` so the day-boundary check sees a consistent
+    // clock across the catchup's pre / post freshness probes.
+    const needsMorning = !hasFreshAgentDayTodayMd(todayMdPath, tz, config.dayBoundaryHour, now);
+    const dueCatchupRoutines = getDueCatchupRoutines(db, config, agentDayStartUtc, agentDayEndUtc, now);
+    const needsHourlyCheckCatchup = shouldCatchUpHourlyCheck(db, config, now);
+    let ranMorningCatchup = false;
+    if (needsMorning) {
+        try {
+            await dispatcher.summarizeDmSessions();
+        }
+        catch (err) {
+            logger.error({ err }, "DM summarization catchup failed before morning routine");
+        }
+        logger.info("Stale today.md detected, running morning_routine catchup inline");
+        await dispatcher.processInline({
+            ...createEvent({
+                type: "routine.morning_routine",
+                source: "catchup",
+                priority: EventPriority.HIGH,
+                data: {
+                    postCatchupRoutines: dueCatchupRoutines,
+                    postCatchupHourlyCheck: needsHourlyCheckCatchup,
+                    deferPostMorningCatchupsUntilStartupReady: true,
+                },
+            }),
+            routine: "morning_routine",
+        });
+        ranMorningCatchup = true;
+        if (!hasFreshAgentDayTodayMd(todayMdPath, tz, config.dayBoundaryHour)) {
+            logger.warn("Startup morning catchup did not produce a fresh today.md — deferring remaining catchup work");
+            return {
+                postMessagingRoadmapRefresh: false,
+                postMessagingRoutines: [],
+                postMessagingHourlyCheck: false,
+            };
+        }
+        return {
+            postMessagingRoadmapRefresh: isRoadmapStale(contextDir),
+            postMessagingRoutines: dueCatchupRoutines,
+            postMessagingHourlyCheck: needsHourlyCheckCatchup,
+        };
+    }
+    if (!ranMorningCatchup && isRoadmapStale(contextDir)) {
+        logger.info("Roadmap stale at startup, running roadmap_refresh catchup inline");
+        await processRoutineCatchup(dispatcher, "roadmap_refresh");
+    }
+    return {
+        postMessagingRoadmapRefresh: false,
+        postMessagingRoutines: dueCatchupRoutines,
+        postMessagingHourlyCheck: needsHourlyCheckCatchup,
+    };
+}
+export async function runPostMessagingCatchup(dispatcher, catchup) {
+    if (catchup.postMessagingRoadmapRefresh) {
+        logger.info("Running roadmap_refresh catchup after messaging startup");
+        await processRoutineCatchup(dispatcher, "roadmap_refresh");
+    }
+    for (const routine of catchup.postMessagingRoutines) {
+        logger.info({ routine }, "Running same-day routine catchup after messaging startup");
+        await processRoutineCatchup(dispatcher, routine);
+    }
+    if (catchup.postMessagingHourlyCheck) {
+        logger.info("Triggering hourly_check catchup after messaging startup");
+        await dispatcher.triggerHourlyCheck("catchup_startup", { force: false });
+    }
+}
+export async function processRoutineCatchup(dispatcher, routine) {
+    await dispatcher.processInline({
+        ...createEvent({
+            type: `routine.${routine}`,
+            source: "catchup",
+            priority: routine === "hourly_check" ? EventPriority.NORMAL : EventPriority.HIGH,
+        }),
+        routine,
+    });
+}
+//# sourceMappingURL=catchup.js.map

package/dist/bootstrap/catchup.js.map

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

package/dist/bootstrap/schedule-helpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pure schedule predicates and progress math used by the boot-time catchup
+ * sequence in `bootstrap/catchup.ts` and by the inline routine-readiness
+ * check in `index.ts`. Pattern A pure-move from `index.ts` per
+ * `docs/design/appendices/file-split-plan.md` §10.
+ *
+ * No instance state, no captured closures. Every function takes its
+ * dependencies (db handle, config, clock) as arguments so the boot
+ * sequence can compose them without going through `this`.
+ */
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+export declare function getDueCatchupRoutines(db: Database.Database, config: AgentConfig, agentDayStartUtc: string, agentDayEndUtc: string, now: Date): string[];
+export declare function shouldCatchUpHourlyCheck(db: Database.Database, config: AgentConfig, now: Date): boolean;
+export declare function getProgressMinutesForHour(hour: number, dayBoundaryHour: number): number;
+export declare function hasFreshAgentDayTodayMd(todayMdPath: string, timezone: string | undefined, dayBoundaryHour: number, now?: Date): boolean;
+export declare function readSkillCurationCadence(db: Database.Database): "daily" | "weekly" | "monthly";
+//# sourceMappingURL=schedule-helpers.d.ts.map

package/dist/bootstrap/schedule-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-helpers.d.ts","sourceRoot":"","sources":["../../src/bootstrap/schedule-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAU3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,WAAW,EACnB,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,IAAI,GACR,MAAM,EAAE,CAuCV;AAED,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,IAAI,GACR,OAAO,CAsCT;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,eAAe,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CAQT;AAKD,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,OAAO,GAAG,QAAQ,GAAG,SAAS,CAWhC"}

package/dist/bootstrap/schedule-helpers.js

@@ -0,0 +1,96 @@
+/**
+ * Pure schedule predicates and progress math used by the boot-time catchup
+ * sequence in `bootstrap/catchup.ts` and by the inline routine-readiness
+ * check in `index.ts`. Pattern A pure-move from `index.ts` per
+ * `docs/design/appendices/file-split-plan.md` §10.
+ *
+ * No instance state, no captured closures. Every function takes its
+ * dependencies (db handle, config, clock) as arguments so the boot
+ * sequence can compose them without going through `this`.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { formatSqliteDatetime, getAgentDayBoundsUtc, getAgentDayDateStr, getAgentDayProgressMinutes, nowInTimezone, parseSqliteUtcMs, } from "@aitne/shared";
+import { hasActionInWindow } from "../core/schedule-maintenance.js";
+export function getDueCatchupRoutines(db, config, agentDayStartUtc, agentDayEndUtc, now) {
+    const tz = config.timezone || undefined;
+    const progressMinutes = getAgentDayProgressMinutes(tz, config.dayBoundaryHour, now);
+    const dueAt18 = getProgressMinutesForHour(18, config.dayBoundaryHour);
+    if (progressMinutes < dueAt18) {
+        return [];
+    }
+    const routines = [];
+    const agentDayStartMs = parseSqliteUtcMs(agentDayStartUtc);
+    const agentDayLocal = nowInTimezone(tz, new Date(agentDayStartMs));
+    const tomorrowLocal = nowInTimezone(tz, new Date(agentDayStartMs + 24 * 60 * 60 * 1000));
+    if (!hasActionInWindow(db, "routine.evening_review", agentDayStartUtc, agentDayEndUtc)) {
+        routines.push("evening_review");
+    }
+    if (agentDayLocal.dayOfWeek === 5 &&
+        !hasActionInWindow(db, "routine.weekly_review", agentDayStartUtc, agentDayEndUtc)) {
+        routines.push("weekly_review");
+    }
+    if (tomorrowLocal.day === 1 &&
+        !hasActionInWindow(db, "routine.monthly_review", agentDayStartUtc, agentDayEndUtc)) {
+        routines.push("monthly_review");
+    }
+    return routines;
+}
+export function shouldCatchUpHourlyCheck(db, config, now) {
+    if (!config.hourlyCheckEnabled) {
+        return false;
+    }
+    const tz = config.timezone || undefined;
+    const local = nowInTimezone(tz, now);
+    if (local.hours < config.hourlyCheckActiveStartHour ||
+        local.hours >= config.hourlyCheckActiveEndHour ||
+        local.hours === config.dayBoundaryHour) {
+        return false;
+    }
+    // Slot anchors to `activeStartHour`, mirroring shouldFireHourlyTickAt
+    // in scheduler.ts so the catch-up function picks the same slot the
+    // cron callback would have fired at. The earlier branch already
+    // returned false when local.hours < activeStartHour, so the offset is
+    // always non-negative here.
+    const anchorMinutes = config.hourlyCheckActiveStartHour * 60;
+    const offsetFromAnchor = local.hours * 60 + local.minutes - anchorMinutes;
+    const slotOffsetFromAnchor = Math.floor(offsetFromAnchor / config.hourlyCheckIntervalMinutes) *
+        config.hourlyCheckIntervalMinutes;
+    const slotMinutesSinceMidnight = anchorMinutes + slotOffsetFromAnchor;
+    const dayStartUtc = getAgentDayBoundsUtc(tz, 0, now).start;
+    const slotStartMs = parseSqliteUtcMs(dayStartUtc) + slotMinutesSinceMidnight * 60 * 1000;
+    const slotStartUtc = formatSqliteDatetime(new Date(slotStartMs));
+    return !hasActionInWindow(db, "routine.hourly_check", slotStartUtc, formatSqliteDatetime(now));
+}
+export function getProgressMinutesForHour(hour, dayBoundaryHour) {
+    const scheduledMinutes = hour * 60;
+    const boundaryMinutes = dayBoundaryHour * 60;
+    return scheduledMinutes >= boundaryMinutes
+        ? scheduledMinutes - boundaryMinutes
+        : 24 * 60 - boundaryMinutes + scheduledMinutes;
+}
+export function hasFreshAgentDayTodayMd(todayMdPath, timezone, dayBoundaryHour, now) {
+    if (!existsSync(todayMdPath)) {
+        return false;
+    }
+    const firstLine = readFileSync(todayMdPath, "utf-8").split("\n")[0] ?? "";
+    const today = getAgentDayDateStr(timezone, dayBoundaryHour, now);
+    return firstLine.includes(today);
+}
+// P22 — read the operator's chosen cadence for skill curation runs.
+// Mirrors the helper in `core/scheduler.ts` so the dispatcher hook here can
+// resolve cadence at runtime without crossing module boundaries.
+export function readSkillCurationCadence(db) {
+    const row = db
+        .prepare(`SELECT value_json FROM runtime_state WHERE key = 'skill_curation.config'`)
+        .get();
+    if (!row)
+        return "weekly";
+    try {
+        const v = JSON.parse(row.value_json);
+        return v.cadence ?? "weekly";
+    }
+    catch {
+        return "weekly";
+    }
+}
+//# sourceMappingURL=schedule-helpers.js.map

package/dist/bootstrap/schedule-helpers.js.map

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

package/dist/bootstrap/services.d.ts

@@ -0,0 +1,60 @@
+/**
+ * External-service hot-reload routines — Google (calendar/gmail), Apple
+ * Calendar, Notion, GitHub.
+ *
+ * Extracted from the `startup()` IIFE in `index.ts` per
+ * `docs/design/appendices/file-split-plan.md` §10 (Tier 2, Pattern C).
+ * Goal: lift the four reload routines and the shared
+ * `refreshGoogleSecretState` helper out of the startup lambda so the
+ * lambda reads as a sequence rather than a 3,000-line bag of closures.
+ *
+ * Shape: `createServiceReloaders(deps)` is a factory that captures a
+ * `BootstrapServiceDeps` record once and returns the reload closures.
+ * Mutable state lives in two shared holders passed in via `deps`:
+ *  - `services` — `ServiceRegistry` instance shared with every route,
+ *    observer, and the context builder. Reload routines write
+ *    `services.calendar` / `services.gmail` / ... and the corresponding
+ *    `services.errors.<key>` entries.
+ *  - `secretState` — read by `/api/health.integrations` and observer
+ *    start gates. Reload routines update the corresponding boolean +
+ *    Google credential-type field.
+ *
+ * Both holders are passed by reference; reading them after a reload
+ * completes observes the post-reload values, exactly matching the
+ * pre-extraction inlined behavior.
+ */
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../config.js";
+import type { SecretBroker } from "../secrets/secret-broker.js";
+import type { ServiceRegistry } from "../services/service-registry.js";
+import { type GoogleCredentialType } from "../services/google-auth.js";
+/**
+ * Mutable holder for the per-service "is configured" booleans + the
+ * Google credential type. Read by `/api/health.integrations` and the
+ * observer start gates; written by the reload routines.
+ */
+export interface BootstrapSecretState {
+    googleCredentialsConfigured: boolean;
+    googleTokenConfigured: boolean;
+    googleCredentialType: GoogleCredentialType | null;
+    notionConfigured: boolean;
+    githubConfigured: boolean;
+    githubWebhookConfigured: boolean;
+}
+export declare function createInitialSecretState(): BootstrapSecretState;
+export interface BootstrapServiceDeps {
+    readonly db: Database.Database;
+    readonly config: AgentConfig;
+    readonly secretBroker: SecretBroker;
+    readonly services: ServiceRegistry;
+    readonly secretState: BootstrapSecretState;
+}
+export interface ServiceReloaders {
+    refreshGoogleSecretState(): Promise<void>;
+    reloadGoogleServices(): Promise<void>;
+    reloadAppleCalendarService(): Promise<void>;
+    reloadNotionService(): Promise<void>;
+    reloadGitHubService(): Promise<void>;
+}
+export declare function createServiceReloaders(deps: BootstrapServiceDeps): ServiceReloaders;
+//# sourceMappingURL=services.d.ts.map

package/dist/bootstrap/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/bootstrap/services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIvE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAWpC;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B,EAAE,OAAO,CAAC;IACrC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oBAAoB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,wBAAwB,IAAI,oBAAoB,CAS/D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,GACzB,gBAAgB,CAyKlB"}