memkin 0.4.0

package/dist/daemon/run-history.js

@@ -0,0 +1,54 @@
+import { appendFileSync, existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
+const MS_24H = 24 * 3600 * 1000;
+export class RunHistory {
+    filePath;
+    maxBytes;
+    constructor(stateDir, maxBytes = DEFAULT_MAX_BYTES) {
+        this.filePath = join(stateDir, "scheduler-runs.jsonl");
+        this.maxBytes = maxBytes;
+    }
+    append(record) {
+        appendFileSync(this.filePath, `${JSON.stringify(record)}\n`);
+        this.rotateIfNeeded();
+    }
+    stats24h(now = Date.now()) {
+        const cutoff = now - MS_24H;
+        const records = this.readRecords().filter((r) => r.ts >= cutoff);
+        return {
+            total_runs: records.length,
+            total_msgs: records.reduce((sum, r) => sum + r.msgs, 0),
+            total_blocks: records.reduce((sum, r) => sum + r.blocks, 0),
+            ok_blocks: records.reduce((sum, r) => sum + r.ok, 0),
+            skipped_blocks: records.reduce((sum, r) => sum + r.skipped, 0),
+            failed_blocks: records.reduce((sum, r) => sum + r.failed, 0),
+        };
+    }
+    readRecords() {
+        if (!existsSync(this.filePath))
+            return [];
+        const lines = readFileSync(this.filePath, "utf-8").trim().split("\n").filter(Boolean);
+        const records = [];
+        for (const line of lines) {
+            try {
+                records.push(JSON.parse(line));
+            }
+            catch {
+                // skip malformed lines
+            }
+        }
+        return records;
+    }
+    rotateIfNeeded() {
+        if (!existsSync(this.filePath))
+            return;
+        const size = statSync(this.filePath).size;
+        if (size <= this.maxBytes)
+            return;
+        const lines = readFileSync(this.filePath, "utf-8").trim().split("\n");
+        const keep = lines.slice(Math.floor(lines.length / 2));
+        writeFileSync(this.filePath, `${keep.join("\n")}\n`);
+    }
+}
+//# sourceMappingURL=run-history.js.map

package/dist/daemon/run-history.js.map

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

package/dist/daemon/scheduler.d.ts

@@ -0,0 +1,45 @@
+import type { SchedulerConfig } from "../core/config.js";
+import type { PipelineResult } from "../core/pipeline.js";
+import { type SourceState } from "./source-schedule.js";
+export type RunSourceFn = (sourceId: string) => Promise<PipelineResult>;
+export declare class Scheduler {
+    private schedules;
+    private timer;
+    private running;
+    private daemon_started_at;
+    private last_heartbeat_at;
+    private tick_interval_ms;
+    private readonly state_path;
+    private onTick?;
+    private runSource?;
+    private pending;
+    private tickPromise;
+    private draining;
+    private aborter;
+    constructor(config: SchedulerConfig, stateDir: string);
+    getSourceIds(): string[];
+    getSourceState(sourceId: string): (SourceState & {
+        interval_secs: number;
+    }) | undefined;
+    setRunSource(fn: RunSourceFn): void;
+    setOnTick(fn: (sourceId: string, result: PipelineResult, duration_ms: number) => void): void;
+    start(): Promise<void>;
+    stop(): void;
+    tick(): Promise<void>;
+    private fatalResult;
+    drain(): Promise<void>;
+    getHeartbeat(): {
+        daemon_started_at: number;
+        last_heartbeat_at: number;
+    };
+    getAlertSources(): string[];
+    getAlertDetails(): Array<{
+        source_id: string;
+        state: SourceState;
+    }>;
+    reconcile(config: SchedulerConfig): void;
+    private applyConfig;
+    private persistState;
+    private loadState;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/daemon/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/daemon/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQxF,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAExE,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAC,CAA0E;IACzF,OAAO,CAAC,SAAS,CAAC,CAAc;IAChC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAgC;gBAEnC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM;IA0BrD,YAAY,IAAI,MAAM,EAAE;IAIxB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS;IAMvF,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI;IAInC,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAItF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,IAAI,IAAI,IAAI;IAMN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD3B,OAAO,CAAC,WAAW;IAgBb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,YAAY,IAAI;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE;IAIxE,eAAe,IAAI,MAAM,EAAE;IAM3B,eAAe,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;IAMnE,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IASxC,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,SAAS;CAQlB"}

package/dist/daemon/scheduler.js

@@ -0,0 +1,217 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { classifyResult, SourceSchedule } from "./source-schedule.js";
+export class Scheduler {
+    schedules = new Map();
+    timer = null;
+    running = false;
+    daemon_started_at;
+    last_heartbeat_at;
+    tick_interval_ms;
+    state_path;
+    onTick;
+    runSource;
+    pending = null;
+    tickPromise = null;
+    draining = false;
+    aborter = null;
+    constructor(config, stateDir) {
+        this.tick_interval_ms = config.tick_interval_secs * 1000;
+        this.state_path = join(stateDir, "scheduler-state.json");
+        this.daemon_started_at = Date.now();
+        this.last_heartbeat_at = Date.now();
+        const saved = this.loadState();
+        for (const [sourceId, sourceConfig] of Object.entries(config.sources)) {
+            if (sourceConfig.enabled === false)
+                continue;
+            const interval = sourceConfig.interval_secs ?? config.defaults.interval_secs;
+            if (saved?.sources[sourceId]) {
+                this.schedules.set(sourceId, SourceSchedule.fromSerialized(sourceId, interval, saved.sources[sourceId]));
+            }
+            else {
+                this.schedules.set(sourceId, new SourceSchedule(sourceId, interval));
+            }
+        }
+        if (saved) {
+            this.daemon_started_at = saved.daemon_started_at;
+        }
+    }
+    getSourceIds() {
+        return Array.from(this.schedules.keys());
+    }
+    getSourceState(sourceId) {
+        const s = this.schedules.get(sourceId);
+        if (!s)
+            return undefined;
+        return { ...s.state, interval_secs: s.interval_secs };
+    }
+    setRunSource(fn) {
+        this.runSource = fn;
+    }
+    setOnTick(fn) {
+        this.onTick = fn;
+    }
+    async start() {
+        this.tick();
+        this.timer = setInterval(() => this.tick(), this.tick_interval_ms);
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = null;
+        this.persistState();
+    }
+    async tick() {
+        if (this.running)
+            return;
+        if (this.draining)
+            return;
+        this.running = true;
+        this.aborter = new AbortController();
+        const signal = this.aborter.signal;
+        const run = (async () => {
+            this.last_heartbeat_at = Date.now();
+            try {
+                // Snapshot eligible sources before applying pending so that sources
+                // newly added by applyConfig are not run in the same tick they appear.
+                const eligible = [...this.schedules.keys()];
+                if (this.pending) {
+                    this.applyConfig(this.pending);
+                    this.pending = null;
+                }
+                const now = Date.now();
+                for (const sourceId of eligible) {
+                    if (signal.aborted)
+                        break;
+                    const schedule = this.schedules.get(sourceId);
+                    if (!schedule)
+                        continue; // removed by applyConfig
+                    if (!schedule.isDue(now))
+                        continue;
+                    if (!this.runSource)
+                        continue;
+                    this.last_heartbeat_at = Date.now();
+                    const start = Date.now();
+                    try {
+                        const result = await this.runSource(sourceId);
+                        const duration_ms = Date.now() - start;
+                        schedule.recordResult(classifyResult(result), Date.now(), result.error);
+                        this.onTick?.(sourceId, result, duration_ms);
+                    }
+                    catch (err) {
+                        const duration_ms = Date.now() - start;
+                        schedule.recordResult("failed", Date.now(), err instanceof Error ? err.message : String(err));
+                        this.onTick?.(sourceId, this.fatalResult(err), duration_ms);
+                    }
+                }
+            }
+            finally {
+                this.running = false;
+                this.last_heartbeat_at = Date.now();
+                this.persistState();
+            }
+        })();
+        this.tickPromise = run;
+        await run;
+        this.tickPromise = null;
+    }
+    fatalResult(err) {
+        return {
+            fatal: true,
+            error: err instanceof Error ? err.message : String(err),
+            totalMessages: 0,
+            totalBlocks: 0,
+            okBlocks: 0,
+            skippedBlocks: 0,
+            failedBlocks: 0,
+            okMessages: [],
+            skippedMessages: [],
+            failedMessages: [],
+            warnings: [],
+        };
+    }
+    async drain() {
+        this.draining = true;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.aborter?.abort();
+        if (this.tickPromise)
+            await this.tickPromise;
+        this.persistState();
+    }
+    getHeartbeat() {
+        return { daemon_started_at: this.daemon_started_at, last_heartbeat_at: this.last_heartbeat_at };
+    }
+    getAlertSources() {
+        return Array.from(this.schedules.entries())
+            .filter(([_, s]) => s.shouldAlert())
+            .map(([id]) => id);
+    }
+    getAlertDetails() {
+        return Array.from(this.schedules.entries())
+            .filter(([_, s]) => s.shouldAlert())
+            .map(([id, s]) => ({ source_id: id, state: s.serialize() }));
+    }
+    reconcile(config) {
+        if (this.running) {
+            // most-recent wins; earlier pending superseded
+            this.pending = config;
+            return;
+        }
+        this.applyConfig(config);
+    }
+    applyConfig(config) {
+        const nextIds = new Set(Object.entries(config.sources)
+            .filter(([, c]) => c.enabled !== false)
+            .map(([id]) => id));
+        for (const id of [...this.schedules.keys()]) {
+            if (!nextIds.has(id))
+                this.schedules.delete(id);
+        }
+        for (const [id, sourceConfig] of Object.entries(config.sources)) {
+            if (sourceConfig.enabled === false)
+                continue;
+            const interval = sourceConfig.interval_secs ?? config.defaults.interval_secs;
+            const existing = this.schedules.get(id);
+            if (!existing) {
+                this.schedules.set(id, new SourceSchedule(id, interval));
+            }
+            else if (existing.interval_secs !== interval) {
+                this.schedules.set(id, SourceSchedule.fromSerialized(id, interval, existing.serialize()));
+            }
+        }
+        const newTick = config.tick_interval_secs * 1000;
+        if (newTick !== this.tick_interval_ms) {
+            this.tick_interval_ms = newTick;
+            if (this.timer) {
+                clearInterval(this.timer);
+                this.timer = setInterval(() => this.tick(), this.tick_interval_ms);
+            }
+        }
+        this.persistState();
+    }
+    persistState() {
+        const data = {
+            daemon_started_at: this.daemon_started_at,
+            last_heartbeat_at: this.last_heartbeat_at,
+            sources: {},
+        };
+        for (const [id, s] of this.schedules) {
+            data.sources[id] = s.serialize();
+        }
+        writeFileSync(this.state_path, `${JSON.stringify(data, null, 2)}\n`);
+    }
+    loadState() {
+        if (!existsSync(this.state_path))
+            return null;
+        try {
+            return JSON.parse(readFileSync(this.state_path, "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/daemon/scheduler.js.map

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

package/dist/daemon/serve-runtime.d.ts

@@ -0,0 +1,31 @@
+import type { LoadedConfig } from "../core/config.js";
+import type { DaemonStatus, StoreContext } from "../server/api.js";
+import { ChatNameRefreshJob } from "../server/chat-name-refresh-job.js";
+import { Scheduler } from "./scheduler.js";
+/** A serve session's config-derived runtime, rebuilt/replaced as a whole on reload. */
+export interface ServeRuntime {
+    scheduler: Scheduler | undefined;
+    chatNameRefreshJob: ChatNameRefreshJob | undefined;
+    getDaemonStatus: () => DaemonStatus | undefined;
+    /** Stop timers, release docsClient/docsCursor/chatNameRefreshJob and other resources. */
+    dispose: () => Promise<void>;
+}
+/** Mutable holder: route handlers read `.current` (indirection) — never capture the runtime by value. */
+export declare class ServeRuntimeHolder {
+    current: ServeRuntime;
+    constructor(initial: ServeRuntime);
+    swap(next: ServeRuntime): void;
+}
+/**
+ * Build the config-derived serve runtime (scheduler, chatNameRefreshJob,
+ * getDaemonStatus, dispose). Extracted from the `serve` command action so
+ * it can be rebuilt on config change (Task 8).
+ *
+ * NOTE: The scheduler is constructed even when `config.scheduler.enabled` is
+ * false, so the holder always has a Scheduler instance available for cold-start
+ * logic. `scheduler.start()` is NOT called here — the caller decides.
+ *
+ * Assembly is covered by the serve integration test wired in Task 8.
+ */
+export declare function buildServeRuntime(config: LoadedConfig, stores: StoreContext, stateDir: string): Promise<ServeRuntime>;
+//# sourceMappingURL=serve-runtime.d.ts.map

package/dist/daemon/serve-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-runtime.d.ts","sourceRoot":"","sources":["../../src/daemon/serve-runtime.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AAOrE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,eAAe,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;IAChD,yFAAyF;IACzF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,yGAAyG;AACzG,qBAAa,kBAAkB;IAC7B,OAAO,EAAE,YAAY,CAAC;gBACV,OAAO,EAAE,YAAY;IAGjC,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAG/B;AAiCD;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAkLvB"}

package/dist/daemon/serve-runtime.js

@@ -0,0 +1,230 @@
+import { homedir } from "node:os";
+import { isAbsolute, resolve } from "node:path";
+import { ChatNameResolver } from "../collectors/feishu/chat-name-resolver.js";
+import { normalizeDocsConfig } from "../collectors/feishu/docs/config.js";
+import { runDocSource } from "../collectors/feishu/docs/run.js";
+import { LarkCliHttpClient } from "../collectors/feishu/lark-cli-client.js";
+import { LarkCliIdentityBackend } from "../collectors/feishu/lark-cli-identity-backend.js";
+import { resolveSelfOpenId } from "../collectors/feishu/self-open-id.js";
+import { createClaudeCodeCollector, createCodexCollector, createFeishuCollector, createHermesCollector, getCollector, registerCollector, resetRegistry, } from "../collectors/index.js";
+import { CursorStore } from "../core/cursors.js";
+import { PersonIdentityStore } from "../core/person-identity.js";
+import { runPipeline } from "../core/pipeline.js";
+import { statePath } from "../core/state.js";
+import { createLLMProvider, createMockProvider } from "../extractors/providers/index.js";
+import { ChatNameRefreshJob } from "../server/chat-name-refresh-job.js";
+import { PersonBehaviorStore } from "../store/person-behavior.js";
+import { Scheduler } from "./scheduler.js";
+/** Mutable holder: route handlers read `.current` (indirection) — never capture the runtime by value. */
+export class ServeRuntimeHolder {
+    current;
+    constructor(initial) {
+        this.current = initial;
+    }
+    swap(next) {
+        this.current = next;
+    }
+}
+// ── Helpers (replicated from cli.ts; factored here for rebuildability) ───────
+function resolveProjectPath(path, projectRoot) {
+    if (!path)
+        return undefined;
+    if (path.startsWith("~/"))
+        return resolve(homedir(), path.slice(2));
+    if (path === "~")
+        return homedir();
+    if (isAbsolute(path))
+        return path;
+    return resolve(projectRoot, path);
+}
+function bootstrapCollectors(sources, projectRoot) {
+    resetRegistry();
+    const agentConfigs = {
+        "claude-code": { factory: createClaudeCodeCollector, config: sources["claude-code"] },
+        codex: { factory: createCodexCollector, config: sources.codex },
+        hermes: { factory: createHermesCollector, config: sources.hermes },
+    };
+    for (const { factory, config } of Object.values(agentConfigs)) {
+        if (config?.enabled !== false) {
+            registerCollector(factory(resolveProjectPath(config?.base_dir, projectRoot)));
+        }
+    }
+    if (sources.feishu?.enabled !== false && sources.feishu?.app_id) {
+        registerCollector(createFeishuCollector(sources.feishu));
+    }
+}
+// ── buildServeRuntime ─────────────────────────────────────────────────────────
+/**
+ * Build the config-derived serve runtime (scheduler, chatNameRefreshJob,
+ * getDaemonStatus, dispose). Extracted from the `serve` command action so
+ * it can be rebuilt on config change (Task 8).
+ *
+ * NOTE: The scheduler is constructed even when `config.scheduler.enabled` is
+ * false, so the holder always has a Scheduler instance available for cold-start
+ * logic. `scheduler.start()` is NOT called here — the caller decides.
+ *
+ * Assembly is covered by the serve integration test wired in Task 8.
+ */
+export async function buildServeRuntime(config, stores, stateDir) {
+    let scheduler;
+    // Track resources that need cleanup so dispose() can release them.
+    let docsClient;
+    let docsCursor;
+    let chatNameRefreshJob;
+    if (config.scheduler) {
+        // Always construct Scheduler when the block is present (even if enabled=false),
+        // so ServeRuntimeHolder always holds a Scheduler for future cold-start wiring.
+        scheduler = new Scheduler(config.scheduler, stateDir);
+        if (config.scheduler.enabled) {
+            bootstrapCollectors(config.sources, config.__context.projectRoot);
+            const llmConfig = { ...config.llm };
+            const envKey = llmConfig.provider === "anthropic"
+                ? process.env.ANTHROPIC_API_KEY
+                : process.env.OPENAI_API_KEY;
+            if (!llmConfig.api_key && envKey)
+                llmConfig.api_key = envKey;
+            const provider = llmConfig.api_key
+                ? createLLMProvider(llmConfig)
+                : createMockProvider(new Map());
+            const pipelineConfig = {
+                dedup_checkpoint: statePath("dedup.jsonl"),
+                cursor_checkpoint: statePath("cursors.yaml"),
+                block_gap_minutes: config.block_builder.block_gap_minutes,
+                max_block_tokens: config.block_builder.max_block_tokens,
+                max_block_messages: config.block_builder.max_block_messages,
+                privacy: config.privacy,
+                output_dir: process.cwd(),
+                block_concurrency: config.pipeline?.block_concurrency,
+            };
+            // ── Person communication profile (Spec 8): behavior-layer accumulation.
+            // No-op unless config.profile.enabled (checked inside accumulateBehavior),
+            // so it is wired unconditionally. resolveSender maps a sender open id to its
+            // canonical person slug via the identity handle table, falling back to a
+            // deterministic slug when unknown.
+            const behaviorIdentity = new PersonIdentityStore(stores.db.executor, { pages: stores.pages });
+            const behaviorDeps = {
+                store: new PersonBehaviorStore(stores.db.executor),
+                config: config.profile,
+                resolveSender: async (contact) => (await behaviorIdentity.resolveHandle("feishu_open_id", contact)) ?? `people/${contact}`,
+            };
+            // ── G2: feishu.docs special case ────────────────────────────────────────
+            // docs uses runDocSource (not runPipeline) and manages its own cursor state.
+            docsCursor = new CursorStore(statePath("cursors.yaml"));
+            const feishuCfg = config.sources.feishu;
+            docsClient =
+                feishuCfg?.enabled && feishuCfg.sources?.docs?.enabled
+                    ? new LarkCliHttpClient(feishuCfg.lark_bin)
+                    : undefined;
+            const docsResolved = feishuCfg?.sources?.docs?.enabled
+                ? normalizeDocsConfig(feishuCfg.sources.docs)
+                : undefined;
+            const runDocsAsPipelineResult = async () => {
+                if (!docsClient || !docsResolved || !docsCursor)
+                    throw new Error("feishu.docs scheduled but docs source not enabled");
+                docsCursor.load();
+                const selfOpenId = docsResolved.self_open_id ??
+                    (await resolveSelfOpenId(docsClient, feishuCfg?.sources?.dm?.self_open_id)) ??
+                    "";
+                const stats = await runDocSource({
+                    client: docsClient,
+                    stores,
+                    provider,
+                    config: docsResolved,
+                    cursor: docsCursor,
+                    selfOpenId,
+                    nowMs: Date.now(),
+                    nowIso: () => new Date().toISOString(),
+                });
+                console.log(`[scheduler] feishu.docs: scanned=${stats.candidates_scanned} pointer=${stats.pointer_saved} full=${stats.full_card_generated} refreshed=${stats.full_card_refreshed} queue=${stats.upgrade_queue_size}`);
+                return {
+                    fatal: false,
+                    error: undefined,
+                    totalMessages: stats.candidates_scanned,
+                    totalBlocks: stats.full_card_generated + stats.pointer_saved + stats.full_card_refreshed,
+                    okBlocks: stats.full_card_generated + stats.pointer_saved + stats.full_card_refreshed,
+                    skippedBlocks: stats.skipped,
+                    failedBlocks: stats.llm_failed,
+                    okMessages: [],
+                    skippedMessages: [],
+                    failedMessages: [],
+                    warnings: [],
+                };
+            };
+            // ── end feishu.docs special case ─────────────────────────────────────────
+            scheduler.setRunSource(async (sourceId) => {
+                if (sourceId === "feishu.docs") {
+                    return runDocsAsPipelineResult();
+                }
+                const collector = getCollector(sourceId);
+                if (!collector)
+                    throw new Error(`Unknown source: ${sourceId}`);
+                return runPipeline(pipelineConfig, {
+                    source: collector,
+                    provider,
+                    format: "json",
+                    adapter: "store",
+                    stores,
+                    dryRun: false,
+                    behavior: behaviorDeps,
+                });
+            });
+            scheduler.setOnTick((sourceId, result, duration_ms) => {
+                const status = result.fatal ? "failed" : "ok";
+                console.log(`[scheduler] ${sourceId}: ${status} (${duration_ms}ms)`);
+            });
+            // NOTE: scheduler.start() is NOT called here — the caller (cli.ts / ReloadManager) starts it.
+        }
+    }
+    // ── G1: getDaemonStatus closure ──────────────────────────────────────────────
+    const getDaemonStatus = scheduler
+        ? () => {
+            const hb = scheduler?.getHeartbeat();
+            const now = Date.now();
+            let lastRunAt = null;
+            let nextAt = null;
+            for (const id of scheduler?.getSourceIds() ?? []) {
+                const s = scheduler?.getSourceState(id);
+                if (!s)
+                    continue;
+                if (s.last_run_at !== null && (lastRunAt === null || s.last_run_at > lastRunAt)) {
+                    lastRunAt = s.last_run_at;
+                }
+                const next = s.last_run_at !== null ? s.last_run_at + s.interval_secs * 1000 : now;
+                if (nextAt === null || next < nextAt)
+                    nextAt = next;
+            }
+            return {
+                running: true,
+                uptime_seconds: Math.floor((now - (hb?.daemon_started_at ?? now)) / 1000),
+                last_run: lastRunAt ? new Date(lastRunAt).toISOString() : null,
+                next_scheduled: nextAt !== null ? new Date(nextAt).toISOString() : null,
+            };
+        }
+        : () => undefined;
+    // ── G1: chatNameRefreshJob (config/credential-derived; rebuilt on Tier 2 reload) ──
+    let chatNameRefreshLarkClient;
+    if (config.sources.feishu?.enabled) {
+        chatNameRefreshLarkClient = new LarkCliHttpClient(config.sources.feishu.lark_bin);
+        const selfOpenId = await resolveSelfOpenId(chatNameRefreshLarkClient, config.sources.feishu.sources?.dm?.self_open_id);
+        const backend = new LarkCliIdentityBackend(chatNameRefreshLarkClient, selfOpenId ?? undefined);
+        const resolver = new ChatNameResolver(stores.db.executor, backend);
+        chatNameRefreshJob = new ChatNameRefreshJob(stores.db.executor, resolver);
+    }
+    // ── dispose ───────────────────────────────────────────────────────────────────
+    const dispose = async () => {
+        // Stop the scheduler timer (safe to call even if never started).
+        scheduler?.stop();
+        // ChatNameRefreshJob is on-demand only (no setInterval/timer); no teardown needed.
+        // Drop docs resource references to release the lark-cli handles.
+        docsClient = undefined;
+        docsCursor = undefined;
+        chatNameRefreshLarkClient = undefined;
+    };
+    return {
+        scheduler,
+        chatNameRefreshJob,
+        getDaemonStatus,
+        dispose,
+    };
+}
+//# sourceMappingURL=serve-runtime.js.map

package/dist/daemon/serve-runtime.js.map

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

package/dist/daemon/source-schedule.d.ts

@@ -0,0 +1,25 @@
+import type { PipelineResult } from "../core/pipeline.js";
+export type RunResult = "ok" | "partial" | "failed";
+export declare function classifyResult(r: PipelineResult): RunResult;
+export declare function computeBackoff(base_interval_secs: number, consecutive_failures: number): number;
+export interface SourceState {
+    last_run_at: number | null;
+    last_result: RunResult | null;
+    last_error: string | null;
+    consecutive_failures: number;
+    consecutive_partials: number;
+}
+export declare class SourceSchedule {
+    readonly source_id: string;
+    readonly interval_secs: number;
+    state: SourceState;
+    constructor(source_id: string, interval_secs: number);
+    isDue(now: number): boolean;
+    recordResult(result: RunResult, timestamp: number, error?: string): void;
+    shouldAlert(): boolean;
+    nextRunAt(): number;
+    serialize(): SourceState;
+    static fromSerialized(source_id: string, interval_secs: number, saved: SourceState): SourceSchedule;
+    private effectiveIntervalMs;
+}
+//# sourceMappingURL=source-schedule.d.ts.map