@geohar/un-bien 0.7.0 → 0.9.0

package/dist/daemon/cron_registry.d.ts

@@ -1,80 +0,0 @@
-/**
- * Cron registry: scheduled prompts for daemons, persisted at
- * `~/.pi/un-bien/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

@@ -1,198 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { randomBytes } from "node:crypto";
-import { dirname, join } from "node:path";
-import { Cron } from "croner";
-import { unbienStateHome } from "../paths.js";
-/**
- * Cron registry: scheduled prompts for daemons, persisted at
- * `~/.pi/un-bien/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() {
-    return join(unbienStateHome(), "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

@@ -1 +0,0 @@
-{"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

@@ -1,24 +0,0 @@
-/**
- * Stable 8-character hex id for a daemon, derived from the cwd it manages.
- *
- * Derivation: `sha256(realpath(cwd))` truncated to 8 hex chars (32 bits ≈
- * 4 billion). Collision risk is negligible at fleet sizes a single user
- * will ever have (<1000 daemons), and 8 hex characters are short enough
- * to type on the CLI (`/unbien send a1b2c3d4 "..."`).
- *
- * Same scheme as `roomIdForCwd` in `src/rooms.ts` — but we use hex
- * instead of base64url so the id has no `_`/`-` (cleaner double-click
- * selection in terminals).
- *
- * Symlinks resolve to a single canonical id via `realpath`, so
- * `/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

@@ -1,36 +0,0 @@
-import { createHash } from "node:crypto";
-import { realpathSync } from "node:fs";
-/**
- * Stable 8-character hex id for a daemon, derived from the cwd it manages.
- *
- * Derivation: `sha256(realpath(cwd))` truncated to 8 hex chars (32 bits ≈
- * 4 billion). Collision risk is negligible at fleet sizes a single user
- * will ever have (<1000 daemons), and 8 hex characters are short enough
- * to type on the CLI (`/unbien send a1b2c3d4 "..."`).
- *
- * Same scheme as `roomIdForCwd` in `src/rooms.ts` — but we use hex
- * instead of base64url so the id has no `_`/`-` (cleaner double-click
- * selection in terminals).
- *
- * Symlinks resolve to a single canonical id via `realpath`, so
- * `/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;
-    try {
-        target = realpathSync(cwd);
-    }
-    catch {
-        target = cwd;
-    }
-    return createHash("sha256").update(target).digest("hex").slice(0, 8);
-}
-//# sourceMappingURL=id.js.map

package/dist/daemon/id.js.map

@@ -1 +0,0 @@
-{"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"}

package/dist/daemon/registry.d.ts

@@ -1,63 +0,0 @@
-export interface DaemonEntry {
-    /** Absolute realpath of the cwd this daemon manages. */
-    cwd: string;
-    /**
-     * Display name (mesh `agent_name`). Persisted here because the supervisor
-     * now injects the daemon's config via `UNBIEN_DIRECT_CONFIG` at spawn
-     * instead of reading a per-cwd `.pi/un-bien/config.json`. Legacy entries
-     * (cwd only) fall back to `defaultAgentName(cwd)`.
-     */
-    name?: string;
-}
-export interface DaemonRegistry {
-    daemons: DaemonEntry[];
-}
-/**
- * Normalizes a user-provided path: expands `~`/`~/...`, resolves relative
- * components against `process.cwd()`, and runs `realpath` to canonicalize
- * symlinks. Throws if the resulting path doesn't exist on disk.
- *
- * `/unbien create` always stores normalized paths so two registrations
- * of the same logical folder via different aliases produce a single entry.
- */
-export declare function normalizeCwd(input: string): string;
-/** Reads the registry, returning an empty one when the file is absent. */
-export declare function loadRegistry(): DaemonRegistry;
-export declare function saveRegistry(reg: DaemonRegistry): void;
-/**
- * Adds a daemon entry. Refuses duplicates (same normalized cwd already
- * present). Returns the derived id + normalized cwd so the caller can
- * report it back to the user.
- */
-export declare function addDaemon(rawCwd: string, name?: string): {
-    id: string;
-    cwd: string;
-    name: string;
-};
-/**
- * Removes the daemon entry whose derived id matches `id`. Returns the
- * removed cwd (if any). Does NOT touch the cwd's local config — `create`
- * the same cwd later restores the registration idempotently.
- */
-export declare function removeDaemon(id: string): {
-    removed: boolean;
-    cwd?: string;
-};
-/** Snapshot of all registered daemons with derived ids. Order matches the
- *  file's insertion order — first-registered first. */
-export declare function listDaemons(): Array<{
-    id: string;
-    cwd: string;
-    name: string;
-}>;
-/**
- * One-shot migration: backfill `name` (folder-derived) into legacy entries
- * that predate the name field, persisting the change to `daemons.json`.
- * Idempotent — writes only when something was missing. Returns how many
- * entries were backfilled. The supervisor runs this on start.
- */
-export declare function migrateRegistryNames(): number;
-/** Test/diag-only: returns the on-disk path. Exported so tests can poke
- *  at it (e.g. tmpdir override is done via env, but for now the path is
- *  hardcoded to ~/.pi/un-bien/daemons.json). */
-export declare function registryPath(): string;

package/dist/daemon/registry.js

@@ -1,153 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync, } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, isAbsolute, join, resolve as resolvePath } from "node:path";
-import { daemonIdForCwd } from "./id.js";
-import { defaultAgentName } from "../session/local_config.js";
-import { unbienStateHome } from "../paths.js";
-/**
- * The global daemon registry: which working directories are promoted to
- * always-on daemons under the supervisor.
- *
- * Schema rationale (decision Q in plan/26): the registry stores **only**
- * `cwd` per entry. Everything else (agent_name, auto_start_relay, etc.)
- * is the cwd's local config at `<cwd>/.pi/un-bien/config.json` — single
- * source of truth, no duplication. The daemon `id` is *derived* from cwd
- * via `daemonIdForCwd`, never persisted.
- *
- * Cwds are always normalized to an **absolute realpath** before storage.
- * A user typing `/unbien create ~/Movies` or `/unbien create .`
- * results in the same entry as `/unbien create /Users/x/Movies` — no
- * surprise duplicates, symlinks collapse correctly.
- */
-/** Resolved at call time so tests can override via `UNBIEN_HOME`. The
- *  prod path is always `~/.pi/un-bien/daemons.json`. */
-function registryPathInternal() {
-    return join(unbienStateHome(), "daemons.json");
-}
-/**
- * Normalizes a user-provided path: expands `~`/`~/...`, resolves relative
- * components against `process.cwd()`, and runs `realpath` to canonicalize
- * symlinks. Throws if the resulting path doesn't exist on disk.
- *
- * `/unbien create` always stores normalized paths so two registrations
- * of the same logical folder via different aliases produce a single entry.
- */
-export function normalizeCwd(input) {
-    if (!input || !input.trim()) {
-        throw new Error("cwd is required");
-    }
-    let p = input.trim();
-    // Expand `~` / `~/relative`. Shell wouldn't expand inside slash command args.
-    if (p === "~")
-        p = homedir();
-    else if (p.startsWith("~/"))
-        p = join(homedir(), p.slice(2));
-    if (!isAbsolute(p))
-        p = resolvePath(process.cwd(), p);
-    // realpath canonicalizes symlinks + throws if path doesn't exist.
-    return realpathSync(p);
-}
-/** Reads the registry, returning an empty one when the file is absent. */
-export function loadRegistry() {
-    if (!existsSync(registryPathInternal()))
-        return { daemons: [] };
-    try {
-        const raw = readFileSync(registryPathInternal(), "utf8");
-        const parsed = JSON.parse(raw);
-        if (!parsed || typeof parsed !== "object")
-            return { daemons: [] };
-        const arr = parsed.daemons;
-        if (!Array.isArray(arr))
-            return { daemons: [] };
-        const daemons = [];
-        for (const item of arr) {
-            if (!item || typeof item !== "object")
-                continue;
-            const cwd = item.cwd;
-            if (typeof cwd === "string" && cwd.length > 0) {
-                const rawName = item.name;
-                const entry = { cwd };
-                if (typeof rawName === "string" && rawName.length > 0)
-                    entry.name = rawName;
-                daemons.push(entry);
-            }
-        }
-        return { daemons };
-    }
-    catch {
-        return { daemons: [] };
-    }
-}
-export function saveRegistry(reg) {
-    mkdirSync(dirname(registryPathInternal()), { recursive: true });
-    writeFileSync(registryPathInternal(), JSON.stringify(reg, null, 2) + "\n");
-}
-/**
- * Adds a daemon entry. Refuses duplicates (same normalized cwd already
- * present). Returns the derived id + normalized cwd so the caller can
- * report it back to the user.
- */
-export function addDaemon(rawCwd, name) {
-    const cwd = normalizeCwd(rawCwd);
-    const reg = loadRegistry();
-    if (reg.daemons.some((d) => d.cwd === cwd)) {
-        throw new Error(`Daemon already registered for cwd: ${cwd}`);
-    }
-    // Always persist a name (the registry is the source of truth now that the
-    // supervisor injects config via env instead of a local config file).
-    const resolvedName = name?.trim() || defaultAgentName(cwd);
-    reg.daemons.push({ cwd, name: resolvedName });
-    saveRegistry(reg);
-    return { id: daemonIdForCwd(cwd), cwd, name: resolvedName };
-}
-/**
- * Removes the daemon entry whose derived id matches `id`. Returns the
- * removed cwd (if any). Does NOT touch the cwd's local config — `create`
- * the same cwd later restores the registration idempotently.
- */
-export function removeDaemon(id) {
-    const reg = loadRegistry();
-    const idx = reg.daemons.findIndex((d) => daemonIdForCwd(d.cwd) === id);
-    if (idx === -1)
-        return { removed: false };
-    const [removed] = reg.daemons.splice(idx, 1);
-    saveRegistry(reg);
-    return { removed: true, cwd: removed.cwd };
-}
-/** Snapshot of all registered daemons with derived ids. Order matches the
- *  file's insertion order — first-registered first. */
-export function listDaemons() {
-    return loadRegistry().daemons.map((d) => ({
-        id: daemonIdForCwd(d.cwd),
-        cwd: d.cwd,
-        // Legacy entries (cwd only) fall back to the folder-derived name so a
-        // daemon is never nameless. New entries already carry an explicit name.
-        name: d.name ?? defaultAgentName(d.cwd),
-    }));
-}
-/**
- * One-shot migration: backfill `name` (folder-derived) into legacy entries
- * that predate the name field, persisting the change to `daemons.json`.
- * Idempotent — writes only when something was missing. Returns how many
- * entries were backfilled. The supervisor runs this on start.
- */
-export function migrateRegistryNames() {
-    const reg = loadRegistry();
-    let changed = 0;
-    for (const d of reg.daemons) {
-        if (!d.name) {
-            d.name = defaultAgentName(d.cwd);
-            changed++;
-        }
-    }
-    if (changed > 0)
-        saveRegistry(reg);
-    return changed;
-}
-/** Test/diag-only: returns the on-disk path. Exported so tests can poke
- *  at it (e.g. tmpdir override is done via env, but for now the path is
- *  hardcoded to ~/.pi/un-bien/daemons.json). */
-export function registryPath() {
-    return registryPathInternal();
-}
-//# sourceMappingURL=registry.js.map

package/dist/daemon/registry.js.map

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