@namzu/cli 29.0.1 → 29.1.0

package/dist/schedule/store/history.js

@@ -0,0 +1,114 @@
+/**
+ * `schedule/history/<job-id>.jsonl`: one JSON record per line, appended with
+ * a single `write` on an `O_APPEND` descriptor. Lines stay under 4 KiB, so an
+ * append is atomic on a local POSIX file system and two writers never
+ * interleave inside a line. A run's later status is a NEW record with the
+ * same `runId`; the last one wins, and nothing is rewritten in place except by
+ * compaction.
+ */
+import { closeSync, openSync, readFileSync, renameSync, statSync, writeSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { PRIVATE_FILE_MODE, ensureDir } from './atomic.js';
+const MAX_LINE = 4_000;
+const KEEP_RECORDS = 500;
+const KEEP_MS = 180 * 24 * 60 * 60 * 1000;
+/** A model-produced string trimmed so a record fits one atomic line. */
+function fit(record) {
+    let line = JSON.stringify(record);
+    if (line.length <= MAX_LINE)
+        return line;
+    if (record.kind === 'run') {
+        const trimmed = {
+            ...record,
+            ...(record.summary ? { summary: record.summary.slice(0, 200) } : {}),
+            ...(record.reason ? { reason: record.reason.slice(0, 1_000) } : {}),
+            ...(record.warnings
+                ? { warnings: record.warnings.slice(0, 3).map((w) => w.slice(0, 300)) }
+                : {}),
+        };
+        line = JSON.stringify(trimmed);
+    }
+    return line.length <= MAX_LINE
+        ? line
+        : JSON.stringify({ ...record, detail: undefined, reason: 'record too long' });
+}
+export function appendHistory(paths, jobId, record) {
+    const path = paths.historyOf(jobId);
+    ensureDir(dirname(path));
+    const fd = openSync(path, 'a', PRIVATE_FILE_MODE);
+    try {
+        writeSync(fd, `${fit(record)}\n`);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Every readable record, oldest first. A torn or foreign line is skipped. */
+export function readHistory(paths, jobId) {
+    let text;
+    try {
+        text = readFileSync(paths.historyOf(jobId), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of text.split('\n')) {
+        if (!line.trim())
+            continue;
+        try {
+            const record = JSON.parse(line);
+            if (record && record.v === 1 && typeof record.kind === 'string')
+                out.push(record);
+        }
+        catch { }
+    }
+    return out;
+}
+/**
+ * Runs folded by `runId` (the last record of each wins), plus the other
+ * records, newest first.
+ */
+export function foldHistory(records) {
+    const runs = new Map();
+    const out = [];
+    for (const record of records) {
+        if (record.kind === 'run') {
+            const at = runs.get(record.runId);
+            if (at !== undefined) {
+                out[at] = record;
+                continue;
+            }
+            runs.set(record.runId, out.length);
+        }
+        out.push(record);
+    }
+    return out.reverse();
+}
+/** Keep the last 500 records or 180 days, whichever is more. Returns how many were dropped. */
+export function compactHistory(paths, jobId, now = Date.now()) {
+    const path = paths.historyOf(jobId);
+    try {
+        if (statSync(path).size < 256 * 1024)
+            return 0;
+    }
+    catch {
+        return 0;
+    }
+    const records = readHistory(paths, jobId);
+    const keepFrom = Math.max(0, records.length - KEEP_RECORDS);
+    const kept = records.filter((r, i) => i >= keepFrom || now - Date.parse(r.at) <= KEEP_MS);
+    if (kept.length === records.length)
+        return 0;
+    const temporary = `${path}.${process.pid}.compact`;
+    const fd = openSync(temporary, 'w', PRIVATE_FILE_MODE);
+    try {
+        writeSync(fd, kept.map((r) => `${JSON.stringify(r)}\n`).join(''));
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(temporary, path);
+    return records.length - kept.length;
+}
+//# sourceMappingURL=history.js.map

package/dist/schedule/store/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/schedule/store/history.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE1D,MAAM,QAAQ,GAAG,KAAK,CAAA;AACtB,MAAM,YAAY,GAAG,GAAG,CAAA;AACxB,MAAM,OAAO,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAEzC,wEAAwE;AACxE,SAAS,GAAG,CAAC,MAA6B;IACzC,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACjC,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAA;IACxC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG;YACf,GAAG,MAAM;YACT,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,MAAM,CAAC,QAAQ;gBAClB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;gBACvE,CAAC,CAAC,EAAE,CAAC;SACN,CAAA;QACD,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC7B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAA;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,KAAoB,EACpB,KAAa,EACb,MAA6B;IAE7B,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACnC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IACxB,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAA;IACjD,IAAI,CAAC;QACJ,SAAS,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,EAAE,CAAC,CAAA;IACd,CAAC;AACF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,KAAa;IAC9D,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACJ,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAA;IACV,CAAC;IACD,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAQ;QAC1B,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0B,CAAA;YACxD,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClF,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAyC;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAA;IACtC,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACjC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;gBACtB,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAA;gBAChB,SAAQ;YACT,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QACnC,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,EAAE,CAAA;AACrB,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,KAAoB,EAAE,KAAa,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACnF,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,CAAC;QACJ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI;YAAE,OAAO,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAA;IACT,CAAC;IACD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,CAAA;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,CAAA;IACzF,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,CAAA;IAC5C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,UAAU,CAAA;IAClD,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAA;IACtD,IAAI,CAAC;QACJ,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;IAClE,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,EAAE,CAAC,CAAA;IACd,CAAC;IACD,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;AACpC,CAAC"}

package/dist/schedule/store/jobs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Job definitions: `schedule/jobs/<job-id>.json`.
+ *
+ * A job changes only by an operator action — the CLI, the TUI, a confirmed
+ * tool call — or by the daemon's own lifecycle transitions (completed,
+ * expired, paused after failures, held after an edit it did not make). Every
+ * write is a compare-and-set on `revision`: the writer first publishes a
+ * revision marker `jobs/.revisions/<job-id>/<n>` with `link`, and only the one
+ * writer that published marker `n` writes revision `n`. Two writers that read
+ * the same revision cannot both win; the loser gets
+ * {@link ScheduleConflictError} and re-reads.
+ *
+ * A hand edit of the JSON skips all of this. That is not prevented — the file
+ * is the operator's — but it is caught: the job's confirmation digest no
+ * longer matches, and the daemon holds the job until someone confirms it.
+ */
+import type { SchedulePaths } from '../paths.js';
+import type { ScheduleJob } from '../types.js';
+export declare const JOB_NAME: RegExp;
+export declare class ScheduleConflictError extends Error {
+    readonly jobId: string;
+    readonly name = "ScheduleConflictError";
+    constructor(jobId: string);
+}
+export declare class ScheduleJobNotFoundError extends Error {
+    readonly ref: string;
+    readonly name = "ScheduleJobNotFoundError";
+    constructor(ref: string);
+}
+/** JSON with object keys sorted, so a digest does not depend on write order. */
+export declare function stableStringify(value: unknown): string;
+/**
+ * The digest of what a confirmation vouches for: the prompt, the folder and
+ * its trust, the permissions, the schedule, the model, the budget, the
+ * approval window and the pinned project config. Not a secret — a tripwire.
+ */
+export declare function jobSecurityDigest(job: ScheduleJob): string;
+/** Whether a job's confirmation still vouches for what the file says. */
+export declare function confirmationHolds(job: ScheduleJob): boolean;
+export declare function readJob(paths: SchedulePaths, id: string): ScheduleJob | undefined;
+export interface JobListing {
+    readonly jobs: ScheduleJob[];
+    /** Files that could not be read, with why. Never silently dropped. */
+    readonly errors: {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+export declare function listJobs(paths: SchedulePaths): JobListing;
+/** A job by exact name or by an unambiguous id prefix (four characters at least). */
+export declare function findJob(paths: SchedulePaths, ref: string): ScheduleJob;
+/** Write a new job. Refuses a name another job has. */
+export declare function createJob(paths: SchedulePaths, job: ScheduleJob): ScheduleJob;
+/**
+ * Change a job, compare-and-set on the revision read. `mutate` returns the
+ * new body; revision and `updatedAt` are set here.
+ */
+export declare function updateJob(paths: SchedulePaths, id: string, expectedRevision: number, mutate: (job: ScheduleJob) => ScheduleJob, now?: Date): ScheduleJob;
+/** Remove a job's definition, markers, state and claims. History is kept. */
+export declare function deleteJob(paths: SchedulePaths, id: string): void;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/schedule/store/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/schedule/store/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAS9C,eAAO,MAAM,QAAQ,QAA8B,CAAA;AAMnD,qBAAa,qBAAsB,SAAQ,KAAK;IAEnC,QAAQ,CAAC,KAAK,EAAE,MAAM;IADlC,SAAkB,IAAI,2BAA0B;gBAC3B,KAAK,EAAE,MAAM;CAGlC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,GAAG,EAAE,MAAM;IADhC,SAAkB,IAAI,8BAA6B;gBAC9B,GAAG,EAAE,MAAM;CAGhC;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAStD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAgB1D;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAE3D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjF;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,CAAA;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACtE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAuBzD;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CActE;AA4CD,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,WAAW,CAe7E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACxB,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,MAAM,EACV,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,EACzC,GAAG,GAAE,IAAiB,GACpB,WAAW,CAgBb;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAKhE"}

package/dist/schedule/store/jobs.js

@@ -0,0 +1,210 @@
+/**
+ * Job definitions: `schedule/jobs/<job-id>.json`.
+ *
+ * A job changes only by an operator action — the CLI, the TUI, a confirmed
+ * tool call — or by the daemon's own lifecycle transitions (completed,
+ * expired, paused after failures, held after an edit it did not make). Every
+ * write is a compare-and-set on `revision`: the writer first publishes a
+ * revision marker `jobs/.revisions/<job-id>/<n>` with `link`, and only the one
+ * writer that published marker `n` writes revision `n`. Two writers that read
+ * the same revision cannot both win; the loser gets
+ * {@link ScheduleConflictError} and re-reads.
+ *
+ * A hand edit of the JSON skips all of this. That is not prevented — the file
+ * is the operator's — but it is caught: the job's confirmation digest no
+ * longer matches, and the daemon holds the job until someone confirms it.
+ */
+import { createHash } from 'node:crypto';
+import { readdirSync, rmSync, statSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { ScheduleFormatError, ensureDir, publishExclusive, readVersioned, writeJsonAtomic, } from './atomic.js';
+export const JOB_NAME = /^[a-z0-9][a-z0-9-]{0,62}$/;
+/** A revision marker older than this whose revision never landed was abandoned by a crashed writer. */
+const ABANDONED_MARKER_MS = 60_000;
+const KEEP_MARKERS = 8;
+export class ScheduleConflictError extends Error {
+    jobId;
+    name = 'ScheduleConflictError';
+    constructor(jobId) {
+        super(`Job ${jobId} changed while it was being edited; read it again and retry.`);
+        this.jobId = jobId;
+    }
+}
+export class ScheduleJobNotFoundError extends Error {
+    ref;
+    name = 'ScheduleJobNotFoundError';
+    constructor(ref) {
+        super(`No scheduled job is named or starts with "${ref}".`);
+        this.ref = ref;
+    }
+}
+/** JSON with object keys sorted, so a digest does not depend on write order. */
+export function stableStringify(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(',')}]`;
+    if (value && typeof value === 'object') {
+        const entries = Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+        return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * The digest of what a confirmation vouches for: the prompt, the folder and
+ * its trust, the permissions, the schedule, the model, the budget, the
+ * approval window and the pinned project config. Not a secret — a tripwire.
+ */
+export function jobSecurityDigest(job) {
+    return createHash('sha256')
+        .update(stableStringify({
+        prompt: job.prompt,
+        folder: job.folder.canonical,
+        trust: job.trust?.canonical ?? null,
+        permissions: job.permissions,
+        schedule: job.schedule,
+        model: job.model,
+        budget: job.budget,
+        approvalTtlMs: job.approvalTtlMs,
+        projectDigest: job.projectDigest,
+    }))
+        .digest('hex');
+}
+/** Whether a job's confirmation still vouches for what the file says. */
+export function confirmationHolds(job) {
+    return job.confirmation !== null && job.confirmation.digest === jobSecurityDigest(job);
+}
+export function readJob(paths, id) {
+    return readVersioned(paths.job(id), 'schedule-job');
+}
+export function listJobs(paths) {
+    let names;
+    try {
+        names = readdirSync(paths.jobs);
+    }
+    catch {
+        return { jobs: [], errors: [] };
+    }
+    const jobs = [];
+    const errors = [];
+    for (const name of names.sort()) {
+        if (!name.endsWith('.json') || name.startsWith('.'))
+            continue;
+        const path = join(paths.jobs, name);
+        try {
+            const job = readVersioned(path, 'schedule-job');
+            if (job)
+                jobs.push(job);
+        }
+        catch (error) {
+            errors.push({
+                path,
+                message: error instanceof ScheduleFormatError ? error.message : String(error),
+            });
+        }
+    }
+    return { jobs: jobs.sort((a, b) => a.name.localeCompare(b.name)), errors };
+}
+/** A job by exact name or by an unambiguous id prefix (four characters at least). */
+export function findJob(paths, ref) {
+    const { jobs } = listJobs(paths);
+    const byName = jobs.find((j) => j.name === ref);
+    if (byName)
+        return byName;
+    if (ref.length >= 4) {
+        const matches = jobs.filter((j) => j.id.startsWith(ref.toLowerCase()));
+        if (matches.length === 1)
+            return matches[0];
+        if (matches.length > 1) {
+            throw new Error(`"${ref}" matches ${matches.length} jobs (${matches.map((j) => j.name).join(', ')}); use the name.`);
+        }
+    }
+    throw new ScheduleJobNotFoundError(ref);
+}
+function markerDir(paths, id) {
+    return join(paths.jobs, '.revisions', id);
+}
+/** Win revision `n` of a job, or learn that someone else did. */
+function claimRevision(paths, id, current) {
+    const dir = markerDir(paths, id);
+    ensureDir(dir);
+    let target = current + 1;
+    for (let attempt = 0; attempt < 16; attempt++) {
+        if (publishExclusive(join(dir, String(target)), {
+            at: new Date().toISOString(),
+            pid: process.pid,
+        }))
+            return target;
+        // Somebody holds `target`. If it never landed and is old, its writer
+        // crashed between the marker and the document; step over it.
+        let age = 0;
+        try {
+            age = Date.now() - statSync(join(dir, String(target))).mtimeMs;
+        }
+        catch {
+            age = 0;
+        }
+        const landed = (readJob(paths, id)?.revision ?? 0) >= target;
+        if (landed || age < ABANDONED_MARKER_MS)
+            throw new ScheduleConflictError(id);
+        target += 1;
+    }
+    throw new ScheduleConflictError(id);
+}
+function pruneMarkers(paths, id, latest) {
+    const dir = markerDir(paths, id);
+    try {
+        for (const name of readdirSync(dir)) {
+            const n = Number(name);
+            if (Number.isSafeInteger(n) && n < latest - KEEP_MARKERS)
+                unlinkSync(join(dir, name));
+        }
+    }
+    catch { }
+}
+/** Write a new job. Refuses a name another job has. */
+export function createJob(paths, job) {
+    if (!JOB_NAME.test(job.name)) {
+        throw new Error(`"${job.name}" is not a job name: lowercase letters, digits and dashes, starting with a letter or digit.`);
+    }
+    const { jobs } = listJobs(paths);
+    if (jobs.some((j) => j.name === job.name)) {
+        throw new Error(`A job named "${job.name}" already exists.`);
+    }
+    ensureDir(paths.jobs);
+    claimRevision(paths, job.id, 0);
+    const created = { ...job, revision: 1 };
+    writeJsonAtomic(paths.job(job.id), created);
+    return created;
+}
+/**
+ * Change a job, compare-and-set on the revision read. `mutate` returns the
+ * new body; revision and `updatedAt` are set here.
+ */
+export function updateJob(paths, id, expectedRevision, mutate, now = new Date()) {
+    const current = readJob(paths, id);
+    if (!current)
+        throw new ScheduleJobNotFoundError(id);
+    if (current.revision !== expectedRevision)
+        throw new ScheduleConflictError(id);
+    const revision = claimRevision(paths, id, current.revision);
+    const next = {
+        ...mutate(current),
+        id: current.id,
+        v: 1,
+        kind: 'schedule-job',
+        revision,
+        updatedAt: now.toISOString(),
+    };
+    writeJsonAtomic(paths.job(id), next);
+    pruneMarkers(paths, id, revision);
+    return next;
+}
+/** Remove a job's definition, markers, state and claims. History is kept. */
+export function deleteJob(paths, id) {
+    rmSync(paths.job(id), { force: true });
+    rmSync(markerDir(paths, id), { recursive: true, force: true });
+    rmSync(paths.stateOf(id), { force: true });
+    rmSync(paths.claimsOf(id), { recursive: true, force: true });
+}
+//# sourceMappingURL=jobs.js.map

package/dist/schedule/store/jobs.js.map

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

package/dist/schedule/store/state.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `schedule/state/<job-id>.json`: what the daemon remembers about a job
+ * between evaluations. The daemon is its only writer (one daemon owns a home
+ * at a time, by lease), so a plain replace is enough.
+ */
+import type { SchedulePaths } from '../paths.js';
+import type { ScheduleJob, ScheduleJobState } from '../types.js';
+export declare function emptyState(jobId: string): ScheduleJobState;
+export declare function readState(paths: SchedulePaths, jobId: string): ScheduleJobState;
+export declare function writeState(paths: SchedulePaths, state: ScheduleJobState): void;
+/**
+ * When an active job fires next: what the scheduler last computed, or — before
+ * it has looked at the job — the spec's own next time. Undefined for a job
+ * that is not active.
+ */
+export declare function nextFireOf(job: Pick<ScheduleJob, 'state' | 'schedule'>, state: Pick<ScheduleJobState, 'nextFireAt'>, now?: Date): string | undefined;
+/** Drop optional keys whose value is undefined, so a spread can remove a field. */
+export declare function withoutUndefined<T extends object>(value: T): T;
+//# sourceMappingURL=state.d.ts.map

package/dist/schedule/store/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/schedule/store/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGhE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAO1D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAI/E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,CAAC,EAC5C,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,EAC3C,GAAG,OAAa,GACd,MAAM,GAAG,SAAS,CAIpB;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE9D"}

package/dist/schedule/store/state.js

@@ -0,0 +1,38 @@
+/**
+ * `schedule/state/<job-id>.json`: what the daemon remembers about a job
+ * between evaluations. The daemon is its only writer (one daemon owns a home
+ * at a time, by lease), so a plain replace is enough.
+ */
+import { nextFireTime } from '@namzu/sdk';
+import { readVersioned, writeJsonAtomic } from './atomic.js';
+export function emptyState(jobId) {
+    return {
+        v: 1,
+        kind: 'schedule-state',
+        jobId,
+        counters: { runs: 0, failures: 0, failureStreak: 0 },
+    };
+}
+export function readState(paths, jobId) {
+    return (readVersioned(paths.stateOf(jobId), 'schedule-state') ?? emptyState(jobId));
+}
+export function writeState(paths, state) {
+    writeJsonAtomic(paths.stateOf(state.jobId), state);
+}
+/**
+ * When an active job fires next: what the scheduler last computed, or — before
+ * it has looked at the job — the spec's own next time. Undefined for a job
+ * that is not active.
+ */
+export function nextFireOf(job, state, now = new Date()) {
+    if (job.state !== 'active')
+        return undefined;
+    if (state.nextFireAt && Date.parse(state.nextFireAt) > now.getTime())
+        return state.nextFireAt;
+    return nextFireTime(job.schedule, now)?.toISOString();
+}
+/** Drop optional keys whose value is undefined, so a spread can remove a field. */
+export function withoutUndefined(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, v]) => v !== undefined));
+}
+//# sourceMappingURL=state.js.map

package/dist/schedule/store/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/schedule/store/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAGzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO;QACN,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,gBAAgB;QACtB,KAAK;QACL,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE;KACpD,CAAA;AACF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAoB,EAAE,KAAa;IAC5D,OAAO,CACN,aAAa,CAAmB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAC5F,CAAA;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoB,EAAE,KAAuB;IACvE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACzB,GAA4C,EAC5C,KAA2C,EAC3C,GAAG,GAAG,IAAI,IAAI,EAAE;IAEhB,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC5C,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE;QAAE,OAAO,KAAK,CAAC,UAAU,CAAA;IAC7F,OAAO,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,CAAA;AACtD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAmB,KAAQ;IAC1D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAM,CAAA;AACzF,CAAC"}