@justfortytwo/scheduler 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Enrico Deleo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# @justfortytwo/scheduler
+
+Durable job scheduler daemon for justfortytwo. Drains a `jobs` queue stored in `@justfortytwo/memory` and fires LLM turns only behind a cheap "is there work?" gate.
+
+## Overview
+
+- **Handler registry** — maps job kinds to handlers
+- **`tick()`** — pure, fully injectable function: claim due jobs, gate check, enqueue run, notify, reschedule/complete, backoff on error
+- **Daemon** (Phase 3) — croner + p-queue wiring around `tick()`
+
+## Usage
+
+```ts
+import { createRegistry, tick } from '@justfortytwo/scheduler';
+
+const registry = createRegistry([myHandler]);
+
+await tick({
+  claimDue,
+  complete,
+  fail,
+  registry,
+  recurrenceNext,
+  enqueueRun,
+  notify,
+}, new Date().toISOString());
+```
+
+## Run
+
+The scheduler daemon is a long-running process — run it under a restart loop.
+
+### tmux (development / quick start)
+
+```sh
+while true; do
+  DB_PATH=/path/to/fortytwo.db \
+  EMBED_MODEL=qwen3-embedding:0.6b \
+  OLLAMA_BASE_URL=http://localhost:11434 \
+  CLAUDE_BIN=$(which claude) \
+  FORTYTWO_TURN_TIMEOUT=300 \
+  npx fortytwo-scheduler
+  echo "scheduler exited ($?); restarting in 3 s …"
+  sleep 3
+done
+```
+
+### systemd (production)
+
+Create `/etc/systemd/system/fortytwo-scheduler.service`:
+
+```ini
+[Unit]
+Description=fortytwo scheduler daemon
+After=network.target
+
+[Service]
+Type=simple
+Restart=always
+RestartSec=3s
+Environment=DB_PATH=/path/to/fortytwo/db/fortytwo.db
+Environment=EMBED_MODEL=qwen3-embedding:0.6b
+Environment=OLLAMA_BASE_URL=http://localhost:11434
+Environment=CLAUDE_BIN=/usr/local/bin/claude
+Environment=FORTYTWO_TURN_TIMEOUT=300
+ExecStart=npx fortytwo-scheduler
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Then: `systemctl enable --now fortytwo-scheduler`
+
+### Environment variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `DB_PATH` | yes | Absolute path to `fortytwo.db` |
+| `EMBED_MODEL` | recommended | Ollama model name for semantic embeddings (falls back to FakeEmbedder) |
+| `OLLAMA_BASE_URL` | no | Ollama API base URL (default: `http://localhost:11434`) |
+| `CLAUDE_BIN` | no | Path to the `claude` CLI binary the runner spawns (default: `claude` on `PATH`) |
+| `FORTYTWO_TURN_TIMEOUT` | no | Per-turn timeout in seconds for a spawned `claude` run (default: `300`) |
+| `TELEGRAM_BOT_TOKEN` | optional | Telegram bot token — enables push notifications to Telegram |
+| `ALLOWED_CHAT_IDS` | optional | Comma-separated Telegram chat IDs to push notifications to |
+
+### Liveness / `fortytwo doctor`
+
+On boot and on every 30-second poll tick — even while a previous tick is still in flight — the daemon writes a heartbeat file at `$(dirname $DB_PATH)/scheduler.heartbeat` containing `{ "pid": <number>, "ts": "<ISO>" }`. The write is outside the poll's overlap guard so a long-running turn never starves it. `fortytwo doctor` reads this file and warns (non-fatal) if it is missing or older than 90 seconds.
+
+## License
+
+MIT © 2026 Enrico Deleo

package/dist/daemon.d.ts

@@ -0,0 +1,65 @@
+import type { Notifier, Registry } from './types.js';
+/** Poll interval: how often `tick` is invoked to drain due jobs. */
+export declare const POLL_MS = 30000;
+/**
+ * Stale-running threshold: jobs stuck in 'running' for longer than this are
+ * reset to 'pending' on boot (crash recovery).
+ */
+export declare const STALE_RUNNING_MS: number;
+/**
+ * Returns the next ISO run time for a cron expression, given an ISO `now`.
+ *
+ * Called by `tick` OUTSIDE its per-job try/catch for recurrence calculation.
+ * Built-in crons are validated at seed time (Phase 4), so a malformed
+ * expression here is a programming error that surfaces correctly at seed time.
+ * If `new Cron` throws on a malformed expression, that is acceptable — it is
+ * the seed step's responsibility to validate cron strings before persisting them.
+ */
+export declare function recurrenceNext(cron: string, now: string): string;
+/**
+ * Returns a `{ poll, isRunning }` pair. `poll()` calls `tickFn()` at most once
+ * at a time — a second concurrent call returns immediately without running
+ * `tickFn` again. This prevents tick() pileup if a slow job causes a poll
+ * interval to fire before the previous one completes.
+ */
+export declare function makePoll(tickFn: () => Promise<void>): {
+    poll: () => Promise<void>;
+    isRunning: () => boolean;
+};
+export interface DaemonOptions {
+    /** Absolute path to the SQLite database file. */
+    dbPath: string;
+    /**
+     * Handler registry. Phase 4 supplies the real registry with job handlers.
+     * Defaults to an empty registry so Phase 3 builds + runs standalone.
+     */
+    registry?: Registry;
+    /**
+     * Additional notifiers beyond the journal (e.g. Telegram). Phase 5 wires
+     * these in. Defaults to [] so only the journal notifier is active.
+     */
+    extraNotifiers?: Notifier[];
+}
+/**
+ * Boot the scheduler daemon.
+ *
+ * 1. Opens the SQLite DB and runs pending migrations.
+ * 2. Requeues any stale 'running' jobs (crash recovery).
+ * 3. Builds the TickDeps: claimDue / complete / fail bound to the DB handle,
+ *    recurrenceNext (croner), enqueueRun (PQueue concurrency-1),
+ *    notify (fanout: journal + optional extras), and the injected registry.
+ * 4. Starts a 30-second setInterval poll loop with an overlap guard.
+ *
+ * Journal write: each notification is stored via memory's generic `store` fn
+ * with source='scheduler:wake'. The embedder is OllamaEmbedder when
+ * EMBED_MODEL is set, else FakeEmbedder (same pattern as telegram/bridge.ts).
+ *
+ * CONCERN: using FakeEmbedder in production means scheduler-emitted journal
+ * entries are not semantically searchable (fake vectors). This matches the
+ * bridge's current pattern for channel events and is acceptable for Phase 3.
+ * It should be revisited when a persistent embedder is always available (e.g.
+ * Phase 4+ where EMBED_MODEL is part of the required env).
+ *
+ * @returns A dispose fn that clears the poll interval.
+ */
+export declare function startDaemon(opts: DaemonOptions): Promise<() => void>;

package/dist/daemon.js

@@ -0,0 +1,156 @@
+import { Cron } from 'croner';
+import PQueue from 'p-queue';
+import { openDb, runMigrations, claimDue, complete, fail, requeueStale, FakeEmbedder, OllamaEmbedder, store, query, reembed, listActive, enqueue, setRecurrence, countPendingApprovals, } from '@justfortytwo/memory';
+import { createRunner } from '@justfortytwo/runner';
+import { tick } from './tick.js';
+import { heartbeatPath, writeHeartbeat } from './heartbeat.js';
+import { createJournalNotifier, createFanoutNotifier } from './notifier.js';
+import { buildRegistry, RECURRING_DEFS } from './handlers/index.js';
+import { seedRecurring } from './seed.js';
+/** Poll interval: how often `tick` is invoked to drain due jobs. */
+export const POLL_MS = 30_000;
+/**
+ * Stale-running threshold: jobs stuck in 'running' for longer than this are
+ * reset to 'pending' on boot (crash recovery).
+ */
+export const STALE_RUNNING_MS = 15 * 60_000; // 15 minutes
+// ---------------------------------------------------------------------------
+// recurrenceNext
+// ---------------------------------------------------------------------------
+/**
+ * Returns the next ISO run time for a cron expression, given an ISO `now`.
+ *
+ * Called by `tick` OUTSIDE its per-job try/catch for recurrence calculation.
+ * Built-in crons are validated at seed time (Phase 4), so a malformed
+ * expression here is a programming error that surfaces correctly at seed time.
+ * If `new Cron` throws on a malformed expression, that is acceptable — it is
+ * the seed step's responsibility to validate cron strings before persisting them.
+ */
+export function recurrenceNext(cron, now) {
+    // timezone: 'UTC' ensures cron expressions are always interpreted in UTC,
+    // matching the ISO-string run_at values stored in the jobs table.
+    const next = new Cron(cron, { timezone: 'UTC' }).nextRun(new Date(now));
+    if (!next)
+        throw new Error(`recurrenceNext: no next run for cron '${cron}' after ${now}`);
+    return next.toISOString();
+}
+// ---------------------------------------------------------------------------
+// makePoll — overlap-guarded poll factory (exported for tests)
+// ---------------------------------------------------------------------------
+/**
+ * Returns a `{ poll, isRunning }` pair. `poll()` calls `tickFn()` at most once
+ * at a time — a second concurrent call returns immediately without running
+ * `tickFn` again. This prevents tick() pileup if a slow job causes a poll
+ * interval to fire before the previous one completes.
+ */
+export function makePoll(tickFn) {
+    let running = false;
+    const poll = async () => {
+        if (running)
+            return;
+        running = true;
+        try {
+            await tickFn();
+        }
+        finally {
+            running = false;
+        }
+    };
+    return { poll, isRunning: () => running };
+}
+// ---------------------------------------------------------------------------
+// startDaemon
+// ---------------------------------------------------------------------------
+/**
+ * Boot the scheduler daemon.
+ *
+ * 1. Opens the SQLite DB and runs pending migrations.
+ * 2. Requeues any stale 'running' jobs (crash recovery).
+ * 3. Builds the TickDeps: claimDue / complete / fail bound to the DB handle,
+ *    recurrenceNext (croner), enqueueRun (PQueue concurrency-1),
+ *    notify (fanout: journal + optional extras), and the injected registry.
+ * 4. Starts a 30-second setInterval poll loop with an overlap guard.
+ *
+ * Journal write: each notification is stored via memory's generic `store` fn
+ * with source='scheduler:wake'. The embedder is OllamaEmbedder when
+ * EMBED_MODEL is set, else FakeEmbedder (same pattern as telegram/bridge.ts).
+ *
+ * CONCERN: using FakeEmbedder in production means scheduler-emitted journal
+ * entries are not semantically searchable (fake vectors). This matches the
+ * bridge's current pattern for channel events and is acceptable for Phase 3.
+ * It should be revisited when a persistent embedder is always available (e.g.
+ * Phase 4+ where EMBED_MODEL is part of the required env).
+ *
+ * @returns A dispose fn that clears the poll interval.
+ */
+export async function startDaemon(opts) {
+    const h = openDb(opts.dbPath);
+    await runMigrations(h.k);
+    // Crash recovery: reset jobs stuck in 'running' for > 15 minutes.
+    const staleThreshold = new Date(Date.now() - STALE_RUNNING_MS).toISOString();
+    requeueStale(h, staleThreshold);
+    // Embedder: real Ollama when EMBED_MODEL is present, deterministic fake otherwise.
+    const embedder = process.env['EMBED_MODEL']
+        ? new OllamaEmbedder(process.env['EMBED_MODEL'], process.env['OLLAMA_BASE_URL'])
+        : new FakeEmbedder();
+    // Journal notifier: persists each Notification as a memory entry.
+    const journalWrite = async (n) => {
+        await store(h, embedder, {
+            content: `[scheduler:${n.kind}] ${n.text}`,
+            source: 'scheduler:wake',
+            observed: 'internal',
+            tags: ['scheduler', n.kind],
+        });
+    };
+    const journalNotifier = createJournalNotifier(journalWrite);
+    const allNotifiers = [journalNotifier, ...(opts.extraNotifiers ?? [])];
+    const fanout = createFanoutNotifier(allNotifiers);
+    // Build the real handler registry (or accept the injected one for tests).
+    const registry = opts.registry ?? (() => {
+        const runner = createRunner();
+        const reembedOne = (id) => reembed(h, embedder, id);
+        return buildRegistry({
+            runner,
+            countPendingApprovals: () => countPendingApprovals(h),
+            // Compute the 7-day lookback per call so a long-running daemon's window
+            // does not drift forward from the boot-time instant.
+            recentCount: async () => (await query(h, { since: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString() })).length,
+            reembedOne,
+        });
+    })();
+    // Seed recurring job rows from the in-code definitions (idempotent on every boot).
+    seedRecurring({
+        listActive: () => listActive(h),
+        enqueue: (j) => enqueue(h, j),
+        setRecurrence: (id, rec, at) => setRecurrence(h, id, rec, at),
+    }, RECURRING_DEFS, new Date().toISOString(), recurrenceNext);
+    // Write liveness heartbeat on boot.
+    const hbPath = heartbeatPath(opts.dbPath);
+    writeHeartbeat(hbPath, process.pid, new Date().toISOString());
+    // Concurrency-1 PQueue: at most one handler run at a time.
+    const queue = new PQueue({ concurrency: 1 });
+    const deps = {
+        claimDue: (now) => claimDue(h, now),
+        complete: (id, rescheduleOpts) => complete(h, id, rescheduleOpts),
+        fail: (id, error, retryOpts) => fail(h, id, error, retryOpts),
+        recurrenceNext,
+        enqueueRun: (fn) => queue.add(fn),
+        notify: (notification) => fanout.notify(notification),
+        registry,
+    };
+    const { poll } = makePoll(async () => {
+        await tick(deps, new Date().toISOString());
+    });
+    // Refresh the heartbeat on EVERY poll tick — outside the overlap guard — so a
+    // long-running `tick` (e.g. a multi-minute `claude` turn) does not starve the
+    // heartbeat. If the write were inside `tickFn`, a tick exceeding the poll
+    // interval would make every subsequent poll hit `if (running) return` and skip
+    // the refresh, and `fortytwo doctor` would falsely report the daemon stale.
+    const interval = setInterval(() => {
+        writeHeartbeat(hbPath, process.pid, new Date().toISOString());
+        void poll();
+    }, POLL_MS);
+    // Return dispose function so callers (tests, signal handlers) can clean up.
+    return () => clearInterval(interval);
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/handlers/index.d.ts

@@ -0,0 +1,33 @@
+import type { Registry } from '../types.js';
+import type { RunnerFn } from './recurring.js';
+import type { ReembedOneFn } from './reembed.js';
+export interface RecurringDef {
+    kind: string;
+    /** UTC cron expression (croner format). */
+    cron: string;
+    /** Prompt sent to the runner when the job fires and hasWork is true. */
+    trigger: string;
+}
+/**
+ * Canonical set of recurring jobs. Seeds are idempotent: the daemon calls
+ * `seedRecurring(store, RECURRING_DEFS, ...)` on every boot and only inserts
+ * or updates rows when the definition changes.
+ */
+export declare const RECURRING_DEFS: RecurringDef[];
+export interface RegistryDeps {
+    /** Bound `createRunner()` return value. */
+    runner: RunnerFn;
+    /** Returns the count of pending approvals (injected so tests can fake it). */
+    countPendingApprovals: () => number;
+    /**
+     * Returns the count of memories written in the last 7 days
+     * (injected so tests can fake it).
+     */
+    recentCount: () => Promise<number>;
+    /** Re-embeds one memory by id in-place (no LLM). */
+    reembedOne: ReembedOneFn;
+}
+export declare function buildRegistry(deps: RegistryDeps): Registry;
+export { makeRecurringHandler } from './recurring.js';
+export { makeNotifyPendingHandler, makeReplyHandler, makeReminderHandler } from './oneoff.js';
+export { makeReembedHandler } from './reembed.js';

package/dist/handlers/index.js

@@ -0,0 +1,61 @@
+import { createRegistry } from '../registry.js';
+import { makeRecurringHandler } from './recurring.js';
+import { makeNotifyPendingHandler, makeReplyHandler, makeReminderHandler } from './oneoff.js';
+import { makeReembedHandler } from './reembed.js';
+/**
+ * Canonical set of recurring jobs. Seeds are idempotent: the daemon calls
+ * `seedRecurring(store, RECURRING_DEFS, ...)` on every boot and only inserts
+ * or updates rows when the definition changes.
+ */
+export const RECURRING_DEFS = [
+    {
+        kind: 'daily_briefing',
+        cron: '57 7 * * *',
+        trigger: 'Run the daily-briefing skill and send me the rundown for today.',
+    },
+    {
+        kind: 'sweep',
+        cron: '3 13,18 * * *',
+        trigger: 'Open-thread sweep: check pending approvals and threads awaiting a reply; give me a one-line status.',
+    },
+    {
+        kind: 'learn_review',
+        cron: '17 9 * * 0',
+        trigger: 'Run the learn-review skill: scan the recent Journal for patterns worth promoting. Propose-only — nothing installed.',
+    },
+];
+export function buildRegistry(deps) {
+    const { runner, countPendingApprovals, recentCount, reembedOne } = deps;
+    return createRegistry([
+        // --- Recurring: ungated ---
+        makeRecurringHandler({
+            kind: 'daily_briefing',
+            trigger: RECURRING_DEFS.find((d) => d.kind === 'daily_briefing').trigger,
+            runner,
+        }),
+        // --- Recurring: gated on pending approvals > 0 ---
+        makeRecurringHandler({
+            kind: 'sweep',
+            trigger: RECURRING_DEFS.find((d) => d.kind === 'sweep').trigger,
+            runner,
+            hasWork: async () => countPendingApprovals() > 0,
+        }),
+        // --- Recurring: gated on recent memories > 0 ---
+        makeRecurringHandler({
+            kind: 'learn_review',
+            trigger: RECURRING_DEFS.find((d) => d.kind === 'learn_review').trigger,
+            runner,
+            hasWork: async () => (await recentCount()) > 0,
+        }),
+        // --- One-off: no gate ---
+        makeNotifyPendingHandler(runner),
+        makeReplyHandler(runner),
+        makeReminderHandler(runner),
+        // --- Maintenance: no LLM, no notification ---
+        makeReembedHandler(reembedOne),
+    ]);
+}
+export { makeRecurringHandler } from './recurring.js';
+export { makeNotifyPendingHandler, makeReplyHandler, makeReminderHandler } from './oneoff.js';
+export { makeReembedHandler } from './reembed.js';
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAclD;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,iEAAiE;KAC3E;IACD;QACE,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,qGAAqG;KAC/G;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,qHAAqH;KAC/H;CACF,CAAC;AAoBF,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAExE,OAAO,cAAc,CAAC;QACpB,6BAA6B;QAC7B,oBAAoB,CAAC;YACnB,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAE,CAAC,OAAO;YACzE,MAAM;SACP,CAAC;QAEF,oDAAoD;QACpD,oBAAoB,CAAC;YACnB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAE,CAAC,OAAO;YAChE,MAAM;YACN,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,qBAAqB,EAAE,GAAG,CAAC;SACjD,CAAC;QAEF,kDAAkD;QAClD,oBAAoB,CAAC;YACnB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAE,CAAC,OAAO;YACvE,MAAM;YACN,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC,GAAG,CAAC;SAC/C,CAAC;QAEF,2BAA2B;QAC3B,wBAAwB,CAAC,MAAM,CAAC;QAChC,gBAAgB,CAAC,MAAM,CAAC;QACxB,mBAAmB,CAAC,MAAM,CAAC;QAE3B,+CAA+C;QAC/C,kBAAkB,CAAC,UAAU,CAAC;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/handlers/oneoff.d.ts

@@ -0,0 +1,17 @@
+import type { Handler } from '../types.js';
+import type { RunnerFn } from './recurring.js';
+/**
+ * `notify_pending` — fires when a tool-call approval is staged and awaiting
+ * the owner's decision. Summarises the pending approval(s) via LLM.
+ */
+export declare function makeNotifyPendingHandler(runner: RunnerFn): Handler;
+/**
+ * `reply` — fires when an inbound message needs a reply. Prompt is constructed
+ * from `ctx.payload.text`.
+ */
+export declare function makeReplyHandler(runner: RunnerFn): Handler;
+/**
+ * `reminder` — fires at a scheduled reminder time. Prompt is constructed from
+ * `ctx.payload.text`.
+ */
+export declare function makeReminderHandler(runner: RunnerFn): Handler;

package/dist/handlers/oneoff.js

@@ -0,0 +1,50 @@
+function textPayload(ctx) {
+    if (ctx.payload && typeof ctx.payload === 'object') {
+        return ctx.payload;
+    }
+    return {};
+}
+/**
+ * `notify_pending` — fires when a tool-call approval is staged and awaiting
+ * the owner's decision. Summarises the pending approval(s) via LLM.
+ */
+export function makeNotifyPendingHandler(runner) {
+    return {
+        kind: 'notify_pending',
+        async run(ctx) {
+            const { id } = textPayload(ctx);
+            const idClause = id != null ? ` (approval id: ${id})` : '';
+            const r = await runner(`A tool call is awaiting your approval${idClause}. Summarize the pending approval(s) and ask me to approve or deny.`);
+            return { ok: r.ok, text: r.text };
+        },
+    };
+}
+/**
+ * `reply` — fires when an inbound message needs a reply. Prompt is constructed
+ * from `ctx.payload.text`.
+ */
+export function makeReplyHandler(runner) {
+    return {
+        kind: 'reply',
+        async run(ctx) {
+            const { text = '' } = textPayload(ctx);
+            const r = await runner(`Handle this pending message: ${text}`);
+            return { ok: r.ok, text: r.text };
+        },
+    };
+}
+/**
+ * `reminder` — fires at a scheduled reminder time. Prompt is constructed from
+ * `ctx.payload.text`.
+ */
+export function makeReminderHandler(runner) {
+    return {
+        kind: 'reminder',
+        async run(ctx) {
+            const { text = '' } = textPayload(ctx);
+            const r = await runner(`Reminder: ${text}`);
+            return { ok: r.ok, text: r.text };
+        },
+    };
+}
+//# sourceMappingURL=oneoff.js.map

package/dist/handlers/oneoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oneoff.js","sourceRoot":"","sources":["../../src/handlers/oneoff.ts"],"names":[],"mappings":"AASA,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,GAAG,CAAC,OAAsB,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAgB;IACvD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,GAAG,MAAM,MAAM,CACpB,wCAAwC,QAAQ,oEAAoE,CACrH,CAAC;YACF,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAC/C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;YAC/D,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAClD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/handlers/recurring.d.ts

@@ -0,0 +1,18 @@
+import type { Handler } from '../types.js';
+export interface RunnerFn {
+    (prompt: string): Promise<{
+        ok: boolean;
+        text: string;
+    }>;
+}
+/**
+ * Factory for recurring LLM-backed handlers. Optionally gated by a `hasWork`
+ * predicate — if the gate returns false the tick skips the run (job is
+ * rescheduled without consuming LLM quota).
+ */
+export declare function makeRecurringHandler(opts: {
+    kind: string;
+    trigger: string;
+    runner: RunnerFn;
+    hasWork?: () => Promise<boolean>;
+}): Handler;

package/dist/handlers/recurring.js

@@ -0,0 +1,20 @@
+/**
+ * Factory for recurring LLM-backed handlers. Optionally gated by a `hasWork`
+ * predicate — if the gate returns false the tick skips the run (job is
+ * rescheduled without consuming LLM quota).
+ */
+export function makeRecurringHandler(opts) {
+    return {
+        kind: opts.kind,
+        async hasWork(_ctx) {
+            if (!opts.hasWork)
+                return true;
+            return opts.hasWork();
+        },
+        async run(_ctx) {
+            const r = await opts.runner(opts.trigger);
+            return { ok: r.ok, text: r.text };
+        },
+    };
+}
+//# sourceMappingURL=recurring.js.map

package/dist/handlers/recurring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurring.js","sourceRoot":"","sources":["../../src/handlers/recurring.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAKpC;IACC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,CAAC,OAAO,CAAC,IAAY;YACxB,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAY;YACpB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/handlers/reembed.d.ts

@@ -0,0 +1,10 @@
+import type { Handler } from '../types.js';
+export interface ReembedOneFn {
+    (id: number): Promise<boolean>;
+}
+/**
+ * `reembed_memory` — re-embeds a stored memory in-place after an
+ * embedder/model change. Enqueued by `memory.store()` on every write;
+ * consumed here with no LLM call (no notify — returns null).
+ */
+export declare function makeReembedHandler(reembedOne: ReembedOneFn): Handler;

package/dist/handlers/reembed.js

@@ -0,0 +1,19 @@
+/**
+ * `reembed_memory` — re-embeds a stored memory in-place after an
+ * embedder/model change. Enqueued by `memory.store()` on every write;
+ * consumed here with no LLM call (no notify — returns null).
+ */
+export function makeReembedHandler(reembedOne) {
+    return {
+        kind: 'reembed_memory',
+        async run(ctx) {
+            const payload = ctx.payload;
+            const id = typeof payload?.id === 'number' ? payload.id : undefined;
+            if (id == null)
+                return null; // malformed payload — skip silently
+            await reembedOne(id);
+            return null; // no notification: pure background maintenance
+        },
+    };
+}
+//# sourceMappingURL=reembed.js.map

package/dist/handlers/reembed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reembed.js","sourceRoot":"","sources":["../../src/handlers/reembed.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAwB;IACzD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,OAAO,GAAG,GAAG,CAAC,OAA2B,CAAC;YAChD,MAAM,EAAE,GAAG,OAAO,OAAO,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACpE,IAAI,EAAE,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,CAAC,oCAAoC;YACjE,MAAM,UAAU,CAAC,EAAE,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC,CAAC,+CAA+C;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/heartbeat.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the heartbeat file path for a given dbPath.
+ * Convention: sibling of the DB file, named `scheduler.heartbeat`.
+ * Both the daemon (writer) and `fortytwo doctor` (reader) derive the path
+ * from the same dbPath / DB_PATH env var using this function.
+ */
+export declare function heartbeatPath(dbPath: string): string;
+/**
+ * Write a liveness heartbeat JSON file `{ pid, ts }` at `path`.
+ * Best-effort: a write failure NEVER crashes the daemon — errors are swallowed.
+ */
+export declare function writeHeartbeat(path: string, pid: number, nowIso: string): void;

package/dist/heartbeat.js

@@ -0,0 +1,25 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * Returns the heartbeat file path for a given dbPath.
+ * Convention: sibling of the DB file, named `scheduler.heartbeat`.
+ * Both the daemon (writer) and `fortytwo doctor` (reader) derive the path
+ * from the same dbPath / DB_PATH env var using this function.
+ */
+export function heartbeatPath(dbPath) {
+    return join(dirname(dbPath), 'scheduler.heartbeat');
+}
+/**
+ * Write a liveness heartbeat JSON file `{ pid, ts }` at `path`.
+ * Best-effort: a write failure NEVER crashes the daemon — errors are swallowed.
+ */
+export function writeHeartbeat(path, pid, nowIso) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify({ pid, ts: nowIso }), 'utf-8');
+    }
+    catch {
+        // Best-effort — never crash the daemon on a heartbeat write failure.
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW,EAAE,MAAc;IACtE,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+export type { Job, RunCtx, RunResult, Handler, Notification, Notifier, Registry, } from './types.js';
+export { createRegistry } from './registry.js';
+export { tick, backoffAt, RETRY_BACKOFF_MIN } from './tick.js';
+export type { TickDeps } from './tick.js';
+export { createJournalNotifier, createFanoutNotifier } from './notifier.js';
+export { startDaemon, recurrenceNext, makePoll, POLL_MS, STALE_RUNNING_MS } from './daemon.js';
+export type { DaemonOptions } from './daemon.js';
+export { RECURRING_DEFS, buildRegistry } from './handlers/index.js';
+export type { RecurringDef, RegistryDeps } from './handlers/index.js';
+export { seedRecurring } from './seed.js';
+export type { SeedStore } from './seed.js';
+export { heartbeatPath, writeHeartbeat } from './heartbeat.js';

package/dist/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+export { createRegistry } from './registry.js';
+export { tick, backoffAt, RETRY_BACKOFF_MIN } from './tick.js';
+// Phase 3 re-exports.
+export { createJournalNotifier, createFanoutNotifier } from './notifier.js';
+export { startDaemon, recurrenceNext, makePoll, POLL_MS, STALE_RUNNING_MS } from './daemon.js';
+// Phase 4 re-exports.
+export { RECURRING_DEFS, buildRegistry } from './handlers/index.js';
+export { seedRecurring } from './seed.js';
+// Phase 6 re-exports.
+export { heartbeatPath, writeHeartbeat } from './heartbeat.js';
+// ---------------------------------------------------------------------------
+// Bin guard — boot the daemon ONLY when this file is the direct entrypoint.
+// Mirrors telegram/src/bridge.ts `invokedAsBin()` exactly so importing this
+// package as a library does not open a DB, run migrations, or start an interval.
+// ---------------------------------------------------------------------------
+function invokedAsBin() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    try {
+        return realpathSync(argv1) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (invokedAsBin()) {
+    const { startDaemon: boot } = await import('./daemon.js');
+    const dbPath = process.env['DB_PATH'] ?? 'fortytwo.db';
+    // Optional Telegram push: when TELEGRAM_BOT_TOKEN + ALLOWED_CHAT_IDS are
+    // set, construct a Telegram sender and wire it as an extra notifier so the
+    // scheduler daemon can push notifications to Telegram in addition to the
+    // journal write.
+    //
+    // FLAG: ALLOWED_CHAT_IDS is expected to be a comma-separated list of chat
+    // ids (same format as the bridge); we use the first id as the target chat.
+    // If neither env var is set, extraNotifiers defaults to [] and only the
+    // journal notifier is active.
+    const extraNotifiers = await (async () => {
+        const token = process.env['TELEGRAM_BOT_TOKEN'];
+        const chatIdsRaw = process.env['ALLOWED_CHAT_IDS'];
+        if (!token || !chatIdsRaw)
+            return [];
+        try {
+            // Lazy import so scheduler can run without @justfortytwo/telegram installed.
+            const { Telegram, parseAllowed, telegramNotifier } = await import('@justfortytwo/telegram');
+            const chatIds = parseAllowed(chatIdsRaw);
+            if (chatIds.size === 0)
+                return [];
+            const chatId = [...chatIds][0];
+            const tg = new Telegram(token, chatIds);
+            return [telegramNotifier({ chatId, send: (id, text) => tg.sendMessage(id, text).then(() => undefined) })];
+        }
+        catch (e) {
+            process.stderr.write(`fortytwo-scheduler: Telegram notifier wiring failed: ${e?.message ?? e} — journal-only\n`);
+            return [];
+        }
+    })();
+    boot({ dbPath, extraNotifiers }).catch((err) => {
+        process.stderr.write(`fortytwo-scheduler: ${err?.stack ?? err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/notifier.d.ts

@@ -0,0 +1,15 @@
+import type { Notification, Notifier } from './types.js';
+/**
+ * Creates a notifier that forwards every notification to the injected `write`
+ * callback. The daemon supplies the real write that persists entries to the
+ * memory journal. Using DI keeps the journalling logic testable without
+ * opening a real database.
+ */
+export declare function createJournalNotifier(write: (n: Notification) => Promise<void>): Notifier;
+/**
+ * Creates a notifier that fans out to every notifier in the list. Each
+ * notifier is wrapped in its own try/catch so a failing notifier (e.g. a
+ * Telegram push) does NOT prevent the others (e.g. the journal write) from
+ * running. The returned promise always resolves.
+ */
+export declare function createFanoutNotifier(notifiers: Notifier[]): Notifier;

package/dist/notifier.js

@@ -0,0 +1,34 @@
+/**
+ * Creates a notifier that forwards every notification to the injected `write`
+ * callback. The daemon supplies the real write that persists entries to the
+ * memory journal. Using DI keeps the journalling logic testable without
+ * opening a real database.
+ */
+export function createJournalNotifier(write) {
+    return {
+        async notify(n) {
+            await write(n);
+        },
+    };
+}
+/**
+ * Creates a notifier that fans out to every notifier in the list. Each
+ * notifier is wrapped in its own try/catch so a failing notifier (e.g. a
+ * Telegram push) does NOT prevent the others (e.g. the journal write) from
+ * running. The returned promise always resolves.
+ */
+export function createFanoutNotifier(notifiers) {
+    return {
+        async notify(n) {
+            for (const notifier of notifiers) {
+                try {
+                    await notifier.notify(n);
+                }
+                catch {
+                    // Intentionally swallowed: one failing notifier must not block others.
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=notifier.js.map

package/dist/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../src/notifier.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAyC;IAEzC,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,CAAe;YAC1B,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAqB;IACxD,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,CAAe;YAC1B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,uEAAuE;gBACzE,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,2 @@
+import type { Handler, Registry } from './types.js';
+export declare function createRegistry(handlers: Handler[]): Registry;

package/dist/registry.js

@@ -0,0 +1,15 @@
+export function createRegistry(handlers) {
+    const map = new Map();
+    for (const handler of handlers) {
+        if (map.has(handler.kind)) {
+            throw new Error(`Duplicate handler kind: '${handler.kind}'`);
+        }
+        map.set(handler.kind, handler);
+    }
+    return {
+        get(kind) {
+            return map.get(kind);
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,QAAmB;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/D,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO;QACL,GAAG,CAAC,IAAY;YACd,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/seed.d.ts

@@ -0,0 +1,25 @@
+import type { RecurringDef } from './handlers/index.js';
+export interface SeedStore {
+    listActive(): Array<{
+        id: number;
+        kind: string;
+        recurrence: string | null;
+    }>;
+    enqueue(j: {
+        kind: string;
+        run_at: string;
+        recurrence: string;
+    }): number;
+    setRecurrence(id: number, recurrence: string, runAt: string): void;
+}
+/**
+ * Seeds recurring job rows from the authoritative in-code definitions.
+ *
+ * For each def:
+ * - If no active row with that kind + a recurrence exists → INSERT (first boot).
+ * - If the existing row's cron differs from the def → UPDATE (cron changed in code).
+ * - Otherwise → leave it alone (idempotent on subsequent boots).
+ *
+ * `recurrenceNext` is injected so seed is testable without croner.
+ */
+export declare function seedRecurring(store: SeedStore, defs: RecurringDef[], now: string, recurrenceNext: (cron: string, now: string) => string): void;

package/dist/seed.js

@@ -0,0 +1,28 @@
+/**
+ * Seeds recurring job rows from the authoritative in-code definitions.
+ *
+ * For each def:
+ * - If no active row with that kind + a recurrence exists → INSERT (first boot).
+ * - If the existing row's cron differs from the def → UPDATE (cron changed in code).
+ * - Otherwise → leave it alone (idempotent on subsequent boots).
+ *
+ * `recurrenceNext` is injected so seed is testable without croner.
+ */
+export function seedRecurring(store, defs, now, recurrenceNext) {
+    const active = store.listActive();
+    for (const def of defs) {
+        const existing = active.find((j) => j.kind === def.kind && j.recurrence != null);
+        if (!existing) {
+            store.enqueue({
+                kind: def.kind,
+                run_at: recurrenceNext(def.cron, now),
+                recurrence: def.cron,
+            });
+        }
+        else if (existing.recurrence !== def.cron) {
+            store.setRecurrence(existing.id, def.cron, recurrenceNext(def.cron, now));
+        }
+        // else: unchanged — leave the existing row as-is
+    }
+}
+//# sourceMappingURL=seed.js.map

package/dist/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../src/seed.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAgB,EAChB,IAAoB,EACpB,GAAW,EACX,cAAqD;IAErD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,CACnD,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,OAAO,CAAC;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;gBACrC,UAAU,EAAE,GAAG,CAAC,IAAI;aACrB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YAC5C,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,iDAAiD;IACnD,CAAC;AACH,CAAC"}

package/dist/tick.d.ts

@@ -0,0 +1,17 @@
+import type { Job, Notification, Registry } from './types.js';
+export interface TickDeps {
+    claimDue(now: string): Job[];
+    complete(id: number, opts: {
+        reschedule?: string;
+    }): void;
+    fail(id: number, error: string, opts?: {
+        retryAt?: string;
+    }): void;
+    registry: Registry;
+    recurrenceNext(cron: string, now: string): string;
+    enqueueRun(fn: () => Promise<void>): Promise<void>;
+    notify(n: Notification): Promise<void>;
+}
+export declare const RETRY_BACKOFF_MIN: readonly [1, 5, 30];
+export declare function backoffAt(now: string, attempts: number): string;
+export declare function tick(deps: TickDeps, now: string): Promise<void>;

package/dist/tick.js

@@ -0,0 +1,41 @@
+export const RETRY_BACKOFF_MIN = [1, 5, 30];
+export function backoffAt(now, attempts) {
+    const mins = RETRY_BACKOFF_MIN[Math.min(attempts, RETRY_BACKOFF_MIN.length - 1)];
+    return new Date(Date.parse(now) + mins * 60_000).toISOString();
+}
+export async function tick(deps, now) {
+    for (const job of deps.claimDue(now)) {
+        const handler = deps.registry.get(job.kind);
+        if (!handler) {
+            deps.fail(job.id, `no handler for kind '${job.kind}'`);
+            continue;
+        }
+        const reschedule = job.recurrence
+            ? { reschedule: deps.recurrenceNext(job.recurrence, now) }
+            : {};
+        let ctx;
+        try {
+            ctx = { now, payload: job.payload ? JSON.parse(job.payload) : undefined };
+            if (handler.hasWork && !(await handler.hasWork(ctx))) {
+                deps.complete(job.id, reschedule);
+                continue;
+            }
+        }
+        catch (e) {
+            deps.fail(job.id, e instanceof Error ? e.message : String(e), { retryAt: backoffAt(now, job.attempts) });
+            continue;
+        }
+        await deps.enqueueRun(async () => {
+            try {
+                const res = await handler.run(ctx);
+                if (res && res.text)
+                    await deps.notify({ kind: job.kind, text: res.text });
+                deps.complete(job.id, reschedule);
+            }
+            catch (e) {
+                deps.fail(job.id, e instanceof Error ? e.message : String(e), { retryAt: backoffAt(now, job.attempts) });
+            }
+        });
+    }
+}
+//# sourceMappingURL=tick.js.map

package/dist/tick.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export interface Job {
+    id: number;
+    kind: string;
+    payload: string | null;
+    run_at: string;
+    recurrence: string | null;
+    status: string;
+    attempts: number;
+}
+export interface RunCtx {
+    now: string;
+    payload: unknown;
+}
+export interface RunResult {
+    ok: boolean;
+    text: string;
+}
+export interface Handler {
+    kind: string;
+    hasWork?(ctx: RunCtx): Promise<boolean>;
+    run(ctx: RunCtx): Promise<RunResult | null>;
+}
+export interface Notification {
+    kind: string;
+    text: string;
+}
+export interface Notifier {
+    notify(n: Notification): Promise<void>;
+}
+export interface Registry {
+    get(kind: string): Handler | undefined;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@justfortytwo/scheduler",
+  "version": "0.1.0",
+  "description": "Durable job scheduler daemon for justfortytwo — drains a jobs queue and fires LLM turns behind a cheap gate.",
+  "license": "MIT",
+  "author": {
+    "name": "Enrico Deleo",
+    "url": "https://enricodeleo.com"
+  },
+  "homepage": "https://forty-two.it",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justfortytwo/scheduler.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "bin": {
+    "fortytwo-scheduler": "dist/index.js"
+  },
+  "dependencies": {
+    "@justfortytwo/memory": "^0.1.5",
+    "@justfortytwo/runner": "^0.1.0",
+    "croner": "^10.0.0",
+    "p-queue": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@justfortytwo/telegram": "^0.1.5"
+  },
+  "peerDependenciesMeta": {
+    "@justfortytwo/telegram": {
+      "optional": true
+    }
+  }
+}