remote-pi 0.4.3 → 0.5.0

package/README.md

@@ -384,6 +384,12 @@ real name to the peer.
 | `/remote-pi daemon restart` | Stop + start all daemons |
 | `/remote-pi daemon status` | Detailed runtime status (pid, uptime, restart count) |
 | `/remote-pi daemon send <id> "<text>"` | Send a prompt to a specific daemon |
+| `/remote-pi cron add <id> "<expr>" "<prompt>"` | Schedule a recurring prompt (`--tz`, `--wake`, `--no-skip-busy`, `--catchup`) |
+| `/remote-pi cron list` | List scheduled jobs (schedule, enabled, next run, last status) |
+| `/remote-pi cron run <jobId>` | Fire a job now (ignores its schedule) |
+| `/remote-pi cron enable\|disable <jobId>` | Toggle a job on/off |
+| `/remote-pi cron remove <jobId>` | Delete a job |
+| `/remote-pi cron log [<jobId>] [--tail N]` | Read the fire/skip audit log |
 | `/remote-pi install` | Install `pi-supervisord` as a system service |
 | `/remote-pi uninstall` | Remove the system service (registry preserved) |
 
@@ -391,6 +397,33 @@ All commands above work both as Pi slash commands (interactive) and as
 shell-level `remote-pi <subcommand>` when the package is installed
 globally (`npm install -g remote-pi`).
 
+### Scheduled prompts (`cron`)
+
+`remote-pi cron` schedules **recurring prompts** to daemons through the
+supervisor — e.g. a daily "summarise new PRs". Output flows fire-and-forget to
+the mesh/app like any prompt; the cron layer only audits the dispatch.
+
+- **Schedule** is a cron expression (croner syntax; an optional 6th *seconds*
+  field is supported), with an optional IANA timezone via `--tz`:
+
+  ```sh
+  remote-pi cron add a1b2c3d4 "0 9 * * *" "Summarise new PRs" --tz America/Sao_Paulo
+  ```
+
+- **Minimum interval is 60s** — more frequent schedules are rejected (guards
+  token cost + pileup). A fire is **skipped when the daemon is mid-turn**
+  (`--no-skip-busy` to override); `--wake` starts a stopped daemon first;
+  `--catchup` runs once on supervisor start if the previous run was missed.
+- **Prerequisite**: the supervisor must run as a service (`remote-pi install`).
+  Without it there is no scheduler, and `cron` commands say so instead of
+  silently pretending to schedule.
+- **Audit**: every fire **and** every skip appends one line to
+  `~/.pi/remote/cron.jsonl` with a `result` of `delivered`,
+  `woke_and_delivered`, `deliver_failed`, `skipped_busy`, `skipped_down`, or
+  `skipped_disabled` — read it with `remote-pi cron log`.
+
+Step-by-step walkthrough: the [daemon tutorial](https://remote-pi.jacobmoura.work/tutorials/daemon).
+
 ### Footer + title
 
 - `📡 local (N)` — current agent session and peer count (local mesh)

package/dist/daemon/client.js

@@ -2,6 +2,7 @@ import { existsSync } from "node:fs";
 import { createConnection } from "node:net";
 import { encodeRequest, parseReply, } from "./control_protocol.js";
 import { getSupervisorSockPath } from "./supervisor.js";
+import { usesNamedPipe } from "../session/ipc.js";
 /**
  * Tiny client for the `remote-pi` CLI to call the supervisor over the
  * `~/.pi/remote/supervisor.sock` UDS.
@@ -35,7 +36,9 @@ export class SupervisorOfflineError extends Error {
  */
 export async function callSupervisor(req) {
     const sockPath = getSupervisorSockPath();
-    if (!existsSync(sockPath))
+    // POSIX fast-fail on a missing socket file. Windows pipes have no file —
+    // skip the check and let `_connect` fail fast if the pipe isn't there.
+    if (!usesNamedPipe() && !existsSync(sockPath))
         throw new SupervisorOfflineError(sockPath);
     const sock = await _connect(sockPath);
     try {
@@ -55,7 +58,7 @@ export async function callSupervisor(req) {
  *  registry-only listing. */
 export async function supervisorOnline() {
     const sockPath = getSupervisorSockPath();
-    if (!existsSync(sockPath))
+    if (!usesNamedPipe() && !existsSync(sockPath))
         return false;
     try {
         const sock = await _connect(sockPath);

package/dist/daemon/client.js.map

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

package/dist/daemon/control_protocol.d.ts

@@ -11,6 +11,8 @@
  * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
  * This file is strictly the supervisor's own control plane.
  */
+import type { CronJob } from "./cron_registry.js";
+import type { CronLogEntry } from "./cron_log.js";
 /** Per-daemon runtime state observable through the supervisor. */
 export type DaemonState = "running" | "stopped" | "starting" | "crashed";
 export interface DaemonInfo {
@@ -34,8 +36,14 @@ export type ControlRequest = {
     id: string;
 } | {
     op: "stop_all";
+} | {
+    op: "stop";
+    id: string;
 } | {
     op: "restart_all";
+} | {
+    op: "restart";
+    id: string;
 } | {
     op: "send";
     id: string;
@@ -46,6 +54,31 @@ export type ControlRequest = {
 } | {
     op: "unregister";
     id: string;
+} | {
+    op: "cron_add";
+    daemon_id: string;
+    schedule: string;
+    prompt: string;
+    tz?: string;
+    skip_if_busy?: boolean;
+    wake?: boolean;
+    catchup?: boolean;
+} | {
+    op: "cron_list";
+} | {
+    op: "cron_remove";
+    job_id: string;
+} | {
+    op: "cron_enable";
+    job_id: string;
+    enabled: boolean;
+} | {
+    op: "cron_run";
+    job_id: string;
+} | {
+    op: "cron_log";
+    job_id?: string;
+    tail?: number;
 };
 /** Replies sent supervisor → CLI. Tagged by `ok` boolean. */
 export type ControlReply<T = unknown> = {
@@ -79,9 +112,19 @@ export interface ControlReplyShapes {
         stopped: string[];
         already_stopped: string[];
     };
+    stop: {
+        id: string;
+        state: DaemonState;
+        stopped: boolean;
+    };
     restart_all: {
         restarted: string[];
     };
+    restart: {
+        id: string;
+        state: DaemonState;
+        restarted: boolean;
+    };
     send: {
         id: string;
         delivered: boolean;
@@ -94,7 +137,32 @@ export interface ControlReplyShapes {
         removed: boolean;
         cwd?: string;
     };
+    cron_add: {
+        job: CronJobView;
+    };
+    cron_list: {
+        jobs: CronJobView[];
+    };
+    cron_remove: {
+        removed: boolean;
+    };
+    cron_enable: {
+        job_id: string;
+        enabled: boolean;
+        updated: boolean;
+    };
+    cron_run: {
+        job_id: string;
+        result: string;
+    };
+    cron_log: {
+        entries: CronLogEntry[];
+    };
 }
+/** A cron job plus its computed `next_run` (ISO), for `cron list`. */
+export type CronJobView = CronJob & {
+    next_run?: string | null;
+};
 /** Convenience for typed `Client.request<...>("op")` calls. */
 export type ControlReplyFor<Op extends ControlRequest["op"]> = Op extends keyof ControlReplyShapes ? ControlReplyShapes[Op] : never;
 export declare function encodeRequest(req: ControlRequest): string;

package/dist/daemon/control_protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoDH,gFAAgF;AAEhF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAsB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IACpF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,GAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAClF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAA4B,CAAC;AACtC,CAAC"}
+{"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4EH,gFAAgF;AAEhF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAsB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IACpF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,GAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAClF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAA4B,CAAC;AACtC,CAAC"}

package/dist/daemon/cron_log.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Append-only audit trail for cron fires at `~/.pi/remote/cron.jsonl`.
+ *
+ * One JSON line per scheduler decision — **every fire AND every skip** — so an
+ * operator can see exactly what ran and what didn't (the agent's output goes
+ * fire-and-forget to the relay/mesh, so the dispatch itself needs its own
+ * trail). Plan/39 decision E.
+ */
+/** Outcome of a single `fireJob` decision. */
+export type CronResult = "delivered" | "deliver_failed" | "woke_and_delivered" | "skipped_busy" | "skipped_down" | "skipped_disabled";
+export interface CronLogEntry {
+    /** epoch ms */
+    ts: number;
+    job_id: string;
+    daemon_id: string;
+    schedule: string;
+    /** true when a prompt was actually sent (delivered / woke_and_delivered). */
+    fired: boolean;
+    result: CronResult;
+    /** First chars of the prompt, for at-a-glance log reading. */
+    prompt_preview: string;
+}
+/** Test/diag-only: the on-disk path. */
+export declare function cronLogPath(): string;
+/** Maps a result to whether a prompt was actually delivered. */
+export declare function firedFor(result: CronResult): boolean;
+/**
+ * Appends one entry. Best-effort: creates the parent dir + file when absent;
+ * never throws into the scheduler (a logging failure must not abort a fire).
+ */
+export declare function appendCronLog(entry: {
+    job_id: string;
+    daemon_id: string;
+    schedule: string;
+    result: CronResult;
+    prompt: string;
+}): void;
+/**
+ * Reads the log, newest-last. Optional `jobId` filter and `tail` (last N).
+ * Missing file → []. Malformed lines are skipped.
+ */
+export declare function readCronLog(opts?: {
+    jobId?: string;
+    tail?: number;
+}): CronLogEntry[];

package/dist/daemon/cron_log.js

@@ -0,0 +1,72 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const PREVIEW_LEN = 80;
+function logPath() {
+    const root = process.env["REMOTE_PI_HOME"] || homedir();
+    return join(root, ".pi", "remote", "cron.jsonl");
+}
+/** Test/diag-only: the on-disk path. */
+export function cronLogPath() {
+    return logPath();
+}
+/** Maps a result to whether a prompt was actually delivered. */
+export function firedFor(result) {
+    return result === "delivered" || result === "woke_and_delivered";
+}
+/**
+ * Appends one entry. Best-effort: creates the parent dir + file when absent;
+ * never throws into the scheduler (a logging failure must not abort a fire).
+ */
+export function appendCronLog(entry) {
+    const line = JSON.stringify({
+        ts: Date.now(),
+        job_id: entry.job_id,
+        daemon_id: entry.daemon_id,
+        schedule: entry.schedule,
+        fired: firedFor(entry.result),
+        result: entry.result,
+        prompt_preview: entry.prompt.slice(0, PREVIEW_LEN),
+    }) + "\n";
+    try {
+        mkdirSync(dirname(logPath()), { recursive: true });
+        appendFileSync(logPath(), line, "utf8");
+    }
+    catch {
+        /* audit is best-effort — don't break the scheduler on a write error */
+    }
+}
+/**
+ * Reads the log, newest-last. Optional `jobId` filter and `tail` (last N).
+ * Missing file → []. Malformed lines are skipped.
+ */
+export function readCronLog(opts = {}) {
+    if (!existsSync(logPath()))
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(logPath(), "utf8");
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const e = JSON.parse(line);
+            if (opts.jobId && e.job_id !== opts.jobId)
+                continue;
+            entries.push(e);
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    if (opts.tail !== undefined && opts.tail >= 0 && entries.length > opts.tail) {
+        return entries.slice(entries.length - opts.tail);
+    }
+    return entries;
+}
+//# sourceMappingURL=cron_log.js.map

package/dist/daemon/cron_log.js.map

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

package/dist/daemon/cron_registry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Cron registry: scheduled prompts for daemons, persisted at
+ * `~/.pi/remote/cron.json`. Mirrors `registry.ts` (`daemons.json`) — tolerant
+ * load (missing/corrupt → empty), atomic-ish full-file save.
+ *
+ * Each job targets a daemon by its `daemon_id` (the 8-hex id from
+ * `daemonIdForCwd`) and fires `prompt` on `schedule` (a cron expression, run
+ * by croner in the supervisor). The scheduler engine + `fireJob` live in
+ * `supervisor.ts`; this module only owns persistence + schedule validation.
+ *
+ * Plan/39. Decisions B (croner), C (min-interval 60s), E (audit via cron_log).
+ */
+/** Minimum allowed interval between two consecutive runs of a schedule. */
+export declare const MIN_INTERVAL_MS = 60000;
+/** A scheduled prompt. */
+export interface CronJob {
+    /** `j_<hex>` — random, stable across restarts. */
+    id: string;
+    /** Target daemon id (`daemonIdForCwd`). */
+    daemon_id: string;
+    /** Cron expression (croner syntax; optional 6th seconds field supported). */
+    schedule: string;
+    /** IANA timezone for the schedule (e.g. "America/Sao_Paulo"). */
+    tz?: string;
+    /** Prompt text injected into the daemon when the job fires. */
+    prompt: string;
+    enabled: boolean;
+    /** Skip the fire when the daemon is mid-turn (default true). */
+    skip_if_busy: boolean;
+    /** Start the daemon if it's down, then fire (default false). */
+    wake: boolean;
+    /** On supervisor start, run once if the previous scheduled run was missed
+     *  while it was down (default false; at most 1×). */
+    catchup: boolean;
+    created_at: string;
+    last_run?: string;
+    /** Last fire result — see cron_log `result` values. Shortcut for `cron list`. */
+    last_status?: string;
+}
+export interface CronRegistry {
+    jobs: CronJob[];
+}
+/** Test/diag-only: the on-disk path. */
+export declare function cronRegistryPath(): string;
+/** Reads the registry; returns empty on missing/corrupt file. */
+export declare function loadCronRegistry(): CronRegistry;
+export declare function saveCronRegistry(reg: CronRegistry): void;
+export declare function listJobs(): CronJob[];
+export declare function getJob(id: string): CronJob | undefined;
+/** Fields a caller supplies when creating a job. Flags default sensibly. */
+export interface NewJobInput {
+    daemon_id: string;
+    schedule: string;
+    prompt: string;
+    tz?: string;
+    skip_if_busy?: boolean;
+    wake?: boolean;
+    catchup?: boolean;
+}
+/** Adds a job with a fresh `j_<hex>` id. Pure persistence — call
+ *  `validateSchedule` first at the op/CLI boundary. */
+export declare function addJob(input: NewJobInput): CronJob;
+export declare function removeJob(id: string): boolean;
+export declare function setJobEnabled(id: string, enabled: boolean): boolean;
+/** Records the outcome of a fire on the job (the `cron list` shortcut). */
+export declare function recordRun(id: string, at: string, status: string): void;
+export interface ScheduleValidation {
+    ok: boolean;
+    error?: string;
+    /** Interval (ms) between the next two runs, when computable. */
+    intervalMs?: number;
+}
+/**
+ * Validates a cron expression via croner and enforces the ≥60s min-interval
+ * (decision C — guards against pileup + token burn). Returns `ok:false` with a
+ * user-facing message on a bad expression or a too-frequent schedule.
+ */
+export declare function validateSchedule(schedule: string, tz?: string): ScheduleValidation;
+/** Returns the next scheduled run for a job, or null. Used by `cron list`. */
+export declare function nextRunFor(job: CronJob): Date | null;

package/dist/daemon/cron_registry.js

@@ -0,0 +1,194 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { randomBytes } from "node:crypto";
+import { dirname, join } from "node:path";
+import { Cron } from "croner";
+/**
+ * Cron registry: scheduled prompts for daemons, persisted at
+ * `~/.pi/remote/cron.json`. Mirrors `registry.ts` (`daemons.json`) — tolerant
+ * load (missing/corrupt → empty), atomic-ish full-file save.
+ *
+ * Each job targets a daemon by its `daemon_id` (the 8-hex id from
+ * `daemonIdForCwd`) and fires `prompt` on `schedule` (a cron expression, run
+ * by croner in the supervisor). The scheduler engine + `fireJob` live in
+ * `supervisor.ts`; this module only owns persistence + schedule validation.
+ *
+ * Plan/39. Decisions B (croner), C (min-interval 60s), E (audit via cron_log).
+ */
+/** Minimum allowed interval between two consecutive runs of a schedule. */
+export const MIN_INTERVAL_MS = 60_000;
+function cronPath() {
+    const root = process.env["REMOTE_PI_HOME"] || homedir();
+    return join(root, ".pi", "remote", "cron.json");
+}
+/** Test/diag-only: the on-disk path. */
+export function cronRegistryPath() {
+    return cronPath();
+}
+/** Reads the registry; returns empty on missing/corrupt file. */
+export function loadCronRegistry() {
+    if (!existsSync(cronPath()))
+        return { jobs: [] };
+    try {
+        const parsed = JSON.parse(readFileSync(cronPath(), "utf8"));
+        if (!parsed || typeof parsed !== "object")
+            return { jobs: [] };
+        const arr = parsed.jobs;
+        if (!Array.isArray(arr))
+            return { jobs: [] };
+        const jobs = [];
+        for (const item of arr) {
+            const job = _coerceJob(item);
+            if (job)
+                jobs.push(job);
+        }
+        return { jobs };
+    }
+    catch {
+        return { jobs: [] };
+    }
+}
+export function saveCronRegistry(reg) {
+    mkdirSync(dirname(cronPath()), { recursive: true });
+    writeFileSync(cronPath(), JSON.stringify(reg, null, 2) + "\n");
+}
+export function listJobs() {
+    return loadCronRegistry().jobs;
+}
+export function getJob(id) {
+    return loadCronRegistry().jobs.find((j) => j.id === id);
+}
+/** Adds a job with a fresh `j_<hex>` id. Pure persistence — call
+ *  `validateSchedule` first at the op/CLI boundary. */
+export function addJob(input) {
+    const reg = loadCronRegistry();
+    const job = {
+        id: _freshId(reg.jobs),
+        daemon_id: input.daemon_id,
+        schedule: input.schedule,
+        prompt: input.prompt,
+        enabled: true,
+        skip_if_busy: input.skip_if_busy ?? true,
+        wake: input.wake ?? false,
+        catchup: input.catchup ?? false,
+        created_at: new Date().toISOString(),
+    };
+    if (input.tz)
+        job.tz = input.tz;
+    reg.jobs.push(job);
+    saveCronRegistry(reg);
+    return job;
+}
+export function removeJob(id) {
+    const reg = loadCronRegistry();
+    const idx = reg.jobs.findIndex((j) => j.id === id);
+    if (idx === -1)
+        return false;
+    reg.jobs.splice(idx, 1);
+    saveCronRegistry(reg);
+    return true;
+}
+export function setJobEnabled(id, enabled) {
+    const reg = loadCronRegistry();
+    const job = reg.jobs.find((j) => j.id === id);
+    if (!job)
+        return false;
+    job.enabled = enabled;
+    saveCronRegistry(reg);
+    return true;
+}
+/** Records the outcome of a fire on the job (the `cron list` shortcut). */
+export function recordRun(id, at, status) {
+    const reg = loadCronRegistry();
+    const job = reg.jobs.find((j) => j.id === id);
+    if (!job)
+        return;
+    job.last_run = at;
+    job.last_status = status;
+    saveCronRegistry(reg);
+}
+/**
+ * Validates a cron expression via croner and enforces the ≥60s min-interval
+ * (decision C — guards against pileup + token burn). Returns `ok:false` with a
+ * user-facing message on a bad expression or a too-frequent schedule.
+ */
+export function validateSchedule(schedule, tz) {
+    let cron;
+    try {
+        cron = new Cron(schedule, tz ? { timezone: tz } : {});
+    }
+    catch (e) {
+        return { ok: false, error: `invalid cron expression: ${e.message}` };
+    }
+    try {
+        const n1 = cron.nextRun();
+        const n2 = n1 ? cron.nextRun(n1) : null;
+        if (!n1 || !n2)
+            return { ok: false, error: "schedule has no upcoming runs" };
+        const intervalMs = n2.getTime() - n1.getTime();
+        if (intervalMs < MIN_INTERVAL_MS) {
+            return {
+                ok: false,
+                intervalMs,
+                error: `schedule too frequent: ~${Math.round(intervalMs / 1000)}s between runs (minimum is 60s)`,
+            };
+        }
+        return { ok: true, intervalMs };
+    }
+    finally {
+        cron.stop();
+    }
+}
+/** Returns the next scheduled run for a job, or null. Used by `cron list`. */
+export function nextRunFor(job) {
+    try {
+        const cron = new Cron(job.schedule, job.tz ? { timezone: job.tz } : {});
+        const n = cron.nextRun();
+        cron.stop();
+        return n;
+    }
+    catch {
+        return null;
+    }
+}
+// ── internals ───────────────────────────────────────────────────────────────
+function _freshId(existing) {
+    for (let i = 0; i < 1000; i++) {
+        const id = `j_${randomBytes(4).toString("hex")}`;
+        if (!existing.some((j) => j.id === id))
+            return id;
+    }
+    throw new Error("cron id space exhausted");
+}
+function _coerceJob(item) {
+    if (!item || typeof item !== "object")
+        return null;
+    const o = item;
+    if (typeof o["id"] !== "string")
+        return null;
+    if (typeof o["daemon_id"] !== "string")
+        return null;
+    if (typeof o["schedule"] !== "string")
+        return null;
+    if (typeof o["prompt"] !== "string")
+        return null;
+    const job = {
+        id: o["id"],
+        daemon_id: o["daemon_id"],
+        schedule: o["schedule"],
+        prompt: o["prompt"],
+        enabled: o["enabled"] !== false,
+        skip_if_busy: o["skip_if_busy"] !== false,
+        wake: o["wake"] === true,
+        catchup: o["catchup"] === true,
+        created_at: typeof o["created_at"] === "string" ? o["created_at"] : new Date(0).toISOString(),
+    };
+    if (typeof o["tz"] === "string")
+        job.tz = o["tz"];
+    if (typeof o["last_run"] === "string")
+        job.last_run = o["last_run"];
+    if (typeof o["last_status"] === "string")
+        job.last_status = o["last_status"];
+    return job;
+}
+//# sourceMappingURL=cron_registry.js.map

package/dist/daemon/cron_registry.js.map

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

package/dist/daemon/id.d.ts

@@ -14,5 +14,11 @@
  * `/Users/x/Movies` and `/Users/x/link-to-Movies` map to the same daemon.
  * Falls back to the raw path when realpath fails (cwd doesn't exist —
  * shouldn't happen in production but covers test sandboxes).
+ *
+ * plan/41 audit (2026-06-08): this stays **per-cwd** (no name axis). The
+ * multiagent-per-folder model (plan/38/41) applies to the App↔Pi room and the
+ * mesh address; a *supervisor daemon* is **one per cwd** by design — the
+ * registry keys exactly one entry per cwd (`registry.ts`), so a daemon id never
+ * needs the name to disambiguate. Decision: leave `daemonIdForCwd` cwd-only.
  */
 export declare function daemonIdForCwd(cwd: string): string;

package/dist/daemon/id.js

@@ -16,6 +16,12 @@ import { realpathSync } from "node:fs";
  * `/Users/x/Movies` and `/Users/x/link-to-Movies` map to the same daemon.
  * Falls back to the raw path when realpath fails (cwd doesn't exist —
  * shouldn't happen in production but covers test sandboxes).
+ *
+ * plan/41 audit (2026-06-08): this stays **per-cwd** (no name axis). The
+ * multiagent-per-folder model (plan/38/41) applies to the App↔Pi room and the
+ * mesh address; a *supervisor daemon* is **one per cwd** by design — the
+ * registry keys exactly one entry per cwd (`registry.ts`), so a daemon id never
+ * needs the name to disambiguate. Decision: leave `daemonIdForCwd` cwd-only.
  */
 export function daemonIdForCwd(cwd) {
     let target;

package/dist/daemon/id.js.map

@@ -1 +1 @@
-{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/daemon/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/daemon/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}