@yefengr/remote-pi 0.7.4 → 0.7.6

package/dist/daemon/control_protocol.d.ts

@@ -1,30 +1,50 @@
-/**
- * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
- *
- * Framing: one JSON object per line, newline-terminated. The CLI sends a
- * single `ControlRequest`, the supervisor sends a single `ControlReply`,
- * both close the connection. No multiplexing, no streaming — each command
- * is a short round-trip.
- *
- * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
- * children themselves is a separate contract — see
- * `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";
+/** Legacy CLI summary; new callers should use the orthogonal fields on DaemonInfo. */
+export type DaemonState = "stopped" | "starting" | "running" | "crashed" | "blocked";
+export type RegistrationState = "registered" | "missing";
+export type DesiredState = "running" | "stopped";
+export type ProcessState = "absent" | "spawning" | "running" | "exited";
+export type RuntimeState = "pending" | "ready" | "failed";
+export type RelayState = "disconnected" | "connecting" | "connected" | "reconnecting";
+export type HealthState = "stopped" | "starting" | "healthy" | "degraded" | "failed" | "blocked";
+/**
+ * Status output keeps registration, desired lifecycle, OS process, RPC runtime,
+ * relay connectivity and derived health separate. `id` / `state` are retained
+ * only for the current CLI consumers while they are migrated.
+ */
 export interface DaemonInfo {
+    daemon_id: string;
+    /** Compatibility alias for daemon_id. */
     id: string;
+    endpoint_id: string;
+    runtime_instance_id?: string;
+    registration: RegistrationState;
+    desired: DesiredState;
+    process: ProcessState;
+    runtime: RuntimeState;
+    relay: RelayState;
+    health: HealthState;
+    /** Compatibility summary; never use it to infer health. */
+    state: DaemonState;
     cwd: string;
     name: string;
-    state: DaemonState;
+    kind: "daemon";
     pid?: number;
+    started_at?: number;
+    uptime?: number;
+    /** Compatibility alias for uptime (seconds). */
     uptime_s?: number;
-    restart_count?: number;
+    restart_count: number;
+    startup_stage: string;
+    last_error_code?: string;
+    last_error_message?: string;
+    last_error_at?: number;
+    retrying: boolean;
+    next_retry_at?: number;
+    /** Compatibility alias for relay. */
+    relay_state: RelayState;
 }
-/** Requests sent CLI → supervisor. */
 export type ControlRequest = {
     op: "list";
 } | {
@@ -54,6 +74,9 @@ export type ControlRequest = {
 } | {
     op: "unregister";
     id: string;
+} | {
+    op: "unregister_cwd";
+    cwd: string;
 } | {
     op: "cron_add";
     daemon_id: string;
@@ -61,7 +84,6 @@ export type ControlRequest = {
     prompt: string;
     tz?: string;
     skip_if_busy?: boolean;
-    wake?: boolean;
     catchup?: boolean;
 } | {
     op: "cron_list";
@@ -80,7 +102,6 @@ export type ControlRequest = {
     job_id?: string;
     tail?: number;
 };
-/** Replies sent supervisor → CLI. Tagged by `ok` boolean. */
 export type ControlReply<T = unknown> = {
     ok: true;
     data?: T;
@@ -88,10 +109,6 @@ export type ControlReply<T = unknown> = {
     ok: false;
     error: string;
 };
-/**
- * Response shapes per op. Keep in sync with the supervisor handlers in
- * `daemon/supervisor.ts`. Used for typed client calls.
- */
 export interface ControlReplyShapes {
     list: {
         daemons: DaemonInfo[];
@@ -107,6 +124,7 @@ export interface ControlReplyShapes {
         id: string;
         state: DaemonState;
         started: boolean;
+        desired_state: DesiredState;
     };
     stop_all: {
         stopped: string[];
@@ -116,6 +134,7 @@ export interface ControlReplyShapes {
         id: string;
         state: DaemonState;
         stopped: boolean;
+        desired_state: DesiredState;
     };
     restart_all: {
         restarted: string[];
@@ -124,19 +143,29 @@ export interface ControlReplyShapes {
         id: string;
         state: DaemonState;
         restarted: boolean;
+        desired_state: DesiredState;
     };
     send: {
         id: string;
+        accepted: boolean;
         delivered: boolean;
+        code?: string;
+        error?: string;
     };
     register: {
         id: string;
         cwd: string;
+        name: string;
+        desired_state: DesiredState;
     };
     unregister: {
         removed: boolean;
         cwd?: string;
     };
+    unregister_cwd: {
+        removed: boolean;
+        cwd?: string;
+    };
     cron_add: {
         job: CronJobView;
     };
@@ -159,18 +188,11 @@ export interface ControlReplyShapes {
         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;
 export declare function encodeReply<T>(reply: ControlReply<T>): string;
-/**
- * Parses a single JSON line into a request. Throws on malformed input —
- * the supervisor catches and replies `{ok:false, error}` so the client
- * gets a clean error rather than an unframed disconnect.
- */
 export declare function parseRequest(line: string): ControlRequest;
 export declare function parseReply(line: string): ControlReply<unknown>;

package/dist/daemon/control_protocol.js

@@ -1,17 +1,3 @@
-/**
- * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
- *
- * Framing: one JSON object per line, newline-terminated. The CLI sends a
- * single `ControlRequest`, the supervisor sends a single `ControlReply`,
- * both close the connection. No multiplexing, no streaming — each command
- * is a short round-trip.
- *
- * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
- * children themselves is a separate contract — see
- * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
- * This file is strictly the supervisor's own control plane.
- */
-// ── Serialization helpers ────────────────────────────────────────────────────
 const TRAILING_NEWLINE = "\n";
 export function encodeRequest(req) {
     return JSON.stringify(req) + TRAILING_NEWLINE;
@@ -19,28 +5,20 @@ export function encodeRequest(req) {
 export function encodeReply(reply) {
     return JSON.stringify(reply) + TRAILING_NEWLINE;
 }
-/**
- * Parses a single JSON line into a request. Throws on malformed input —
- * the supervisor catches and replies `{ok:false, error}` so the client
- * gets a clean error rather than an unframed disconnect.
- */
 export function parseRequest(line) {
     let obj;
     try {
         obj = JSON.parse(line);
     }
-    catch (e) {
-        throw new Error(`malformed control request: ${e.message}`);
+    catch (error) {
+        throw new Error(`malformed control request: ${error.message}`);
     }
-    if (!obj || typeof obj !== "object") {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
         throw new Error("control request must be a JSON object");
     }
-    const op = obj.op;
-    if (typeof op !== "string") {
+    if (typeof obj.op !== "string") {
         throw new Error("control request missing string `op` field");
     }
-    // We don't validate every field shape here — supervisor handlers do it
-    // per-op since the error messages are more specific that way.
     return obj;
 }
 export function parseReply(line) {
@@ -48,14 +26,13 @@ export function parseReply(line) {
     try {
         obj = JSON.parse(line);
     }
-    catch (e) {
-        throw new Error(`malformed control reply: ${e.message}`);
+    catch (error) {
+        throw new Error(`malformed control reply: ${error.message}`);
     }
-    if (!obj || typeof obj !== "object") {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
         throw new Error("control reply must be a JSON object");
     }
-    const ok = obj.ok;
-    if (typeof ok !== "boolean") {
+    if (typeof obj.ok !== "boolean") {
         throw new Error("control reply missing boolean `ok` field");
     }
     return obj;

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;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"}
+{"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAmGA,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,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,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,8BAA+B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAC5F,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAQ,GAAwB,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,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,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,4BAA6B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAC1F,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,OAAQ,GAAwB,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAA4B,CAAC;AACtC,CAAC"}

package/dist/daemon/cron_log.d.ts

@@ -1,33 +1,16 @@
-/**
- * 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";
+/** Every result documents a gate decision or the RPC acceptance outcome. */
+export type CronResult = "accepted" | "rejected" | "skipped_busy" | "skipped_disabled" | "skipped_missing" | "skipped_desired_stopped" | "skipped_starting" | "skipped_retrying" | "skipped_failed" | "skipped_blocked";
 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;
@@ -35,10 +18,6 @@ export declare function appendCronLog(entry: {
     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;

package/dist/daemon/cron_log.js

@@ -6,18 +6,8 @@ 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 cronLogPath() { return logPath(); }
+export function firedFor(result) { return result === "accepted"; }
 export function appendCronLog(entry) {
     const line = JSON.stringify({
         ts: Date.now(),
@@ -33,13 +23,9 @@ export function appendCronLog(entry) {
         appendFileSync(logPath(), line, "utf8");
     }
     catch {
-        /* audit is best-effort — don't break the scheduler on a write error */
+        // Auditing must not turn an already-completed scheduler decision into a retry.
     }
 }
-/**
- * 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 [];
@@ -55,18 +41,17 @@ export function readCronLog(opts = {}) {
         if (!line.trim())
             continue;
         try {
-            const e = JSON.parse(line);
-            if (opts.jobId && e.job_id !== opts.jobId)
+            const entry = JSON.parse(line);
+            if (opts.jobId && entry.job_id !== opts.jobId)
                 continue;
-            entries.push(e);
+            entries.push(entry);
         }
         catch {
-            /* skip malformed */
+            // Skip malformed historical lines.
         }
     }
-    if (opts.tail !== undefined && opts.tail >= 0 && entries.length > opts.tail) {
-        return entries.slice(entries.length - opts.tail);
-    }
-    return entries;
+    return opts.tail !== undefined && opts.tail >= 0 && entries.length > opts.tail
+        ? entries.slice(entries.length - opts.tail)
+        : entries;
 }
 //# sourceMappingURL=cron_log.js.map

package/dist/daemon/cron_log.js.map

@@ -1 +1 @@
-{"version":3,"file":"cron_log.js","sourceRoot":"","sources":["../../src/daemon/cron_log.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cron_log.js","sourceRoot":"","sources":["../../src/daemon/cron_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAyB1C,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,SAAS,OAAO;IACd,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,EAAE,CAAC;IACxD,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW,KAAa,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3D,MAAM,UAAU,QAAQ,CAAC,MAAkB,IAAa,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC;AAEvF,MAAM,UAAU,aAAa,CAAC,KAM7B;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;KAC5B,CAAC,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,cAAc,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;IACjF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA0C,EAAE;IACtE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QAAC,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;IACnE,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;YAC/C,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK;gBAAE,SAAS;YACxD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI;QAC5E,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC;AACd,CAAC"}

package/dist/daemon/cron_registry.d.ts

@@ -1,80 +1,43 @@
-/**
- * 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. */
+/** A scheduled prompt. Cron never owns a daemon's lifecycle. */
 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. */
+/** Old wake-bearing jobs are intentionally not carried into the new contract. */
 export declare function loadCronRegistry(): CronRegistry;
-export declare function saveCronRegistry(reg: CronRegistry): void;
+export declare function saveCronRegistry(registry: 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;