praxis-agent 0.1.0

package/dist/persistence/claude-job-store.d.ts

@@ -0,0 +1,68 @@
+export type ClaudeJobLifecycleState = 'working' | 'stopped' | 'failed';
+export type ClaudeJobTempo = 'active' | 'idle';
+export interface ClaudeJobState {
+    state: ClaudeJobLifecycleState;
+    detail: string;
+    tempo: ClaudeJobTempo;
+    inFlight?: {
+        tasks: number;
+        queued: number;
+        kinds: string[];
+    } | undefined;
+    tokens: number;
+    output: null;
+    children: null;
+    template: 'bg';
+    respawnFlags: string[];
+    intent: string;
+    sessionId: string;
+    resumeSessionId: string;
+    daemonShort: string;
+    cliVersion: string;
+    cwd: string;
+    backend: 'daemon';
+    praxisOwner: 1;
+    createdAt: string;
+    updatedAt: string;
+    firstTerminalAt: string | null;
+    pid?: number;
+    socketPath?: string;
+    controlToken?: string;
+}
+export interface ClaudeJobTimelineEntry {
+    at: string;
+    state: ClaudeJobLifecycleState;
+    detail: string;
+    text: string;
+}
+export interface ClaudeJobDispatch {
+    version: 1;
+    argv: string[];
+    resume: boolean;
+}
+export declare class ClaudeJobStore {
+    private readonly configRoot;
+    constructor(configRoot: string);
+    create(state: ClaudeJobState, dispatch: ClaudeJobDispatch): Promise<boolean>;
+    read(id: string): Promise<ClaudeJobState>;
+    readDispatch(id: string): Promise<ClaudeJobDispatch>;
+    list(): Promise<ClaudeJobState[]>;
+    update(id: string, mutate: (state: ClaudeJobState) => ClaudeJobState): Promise<ClaudeJobState>;
+    appendTimeline(id: string, entry: ClaudeJobTimelineEntry): Promise<void>;
+    timeline(id: string): Promise<ClaudeJobTimelineEntry[]>;
+    appendOutput(id: string, text: string): Promise<void>;
+    output(id: string): Promise<string>;
+    trimOutput(id: string, maxBytes: number): Promise<void>;
+    private withLock;
+    private jobDirectory;
+    private statePath;
+    private dispatchPath;
+    private timelinePath;
+    private outputPath;
+}
+export declare function newClaudeJobIdentity(): {
+    id: string;
+    sessionId: string;
+};
+export declare function isProcessAlive(pid: number): boolean;
+//# sourceMappingURL=claude-job-store.d.ts.map

package/dist/persistence/claude-job-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-job-store.d.ts","sourceRoot":"","sources":["../../src/persistence/claude-job-store.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AACtE,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,uBAAuB,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,cAAc,CAAA;IACrB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAA;IACzE,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,IAAI,CAAA;IACZ,QAAQ,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,IAAI,CAAA;IACd,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,QAAQ,CAAA;IACjB,WAAW,EAAE,CAAC,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,uBAAuB,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;CAChB;AA0FD,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAEzC,MAAM,CACV,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC;IA0Bb,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAezC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAepD,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAsBjC,MAAM,CACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,cAAc,GAChD,OAAO,CAAC,cAAc,CAAC;IASpB,cAAc,CAClB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAeV,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IA8BvD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAarD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUnC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAyB/C,QAAQ;IAsBtB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;CAGnB;AAED,wBAAgB,oBAAoB,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAGxE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD"}

package/dist/persistence/claude-job-store.js

@@ -0,0 +1,311 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, open, readFile, readdir, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { writeFileAtomically } from '../platform/atomic-write.js';
+import { ExclusiveFileLease } from '../platform/exclusive-file-lease.js';
+const JOB_ID_PATTERN = /^[0-9a-f]{8}$/u;
+const SESSION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+const LOCK_WAIT_MS = 5_000;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertJobId(id) {
+    if (!JOB_ID_PATTERN.test(id))
+        throw new Error(`Invalid agent ID: ${id}`);
+}
+function stringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function parseState(source, filePath) {
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch (error) {
+        throw new Error(`Invalid Claude job JSON: ${filePath}`, { cause: error });
+    }
+    if (!isRecord(value))
+        throw new Error(`Invalid Claude job: ${filePath}`);
+    const state = value;
+    const inFlight = state.inFlight;
+    if (!['working', 'stopped', 'failed'].includes(String(state.state)) ||
+        typeof state.detail !== 'string' ||
+        !['active', 'idle'].includes(String(state.tempo)) ||
+        !Number.isSafeInteger(state.tokens) ||
+        Number(state.tokens) < 0 ||
+        state.output !== null ||
+        state.children !== null ||
+        state.template !== 'bg' ||
+        !stringArray(state.respawnFlags) ||
+        typeof state.intent !== 'string' ||
+        typeof state.sessionId !== 'string' ||
+        !SESSION_ID_PATTERN.test(state.sessionId) ||
+        typeof state.resumeSessionId !== 'string' ||
+        !SESSION_ID_PATTERN.test(state.resumeSessionId) ||
+        typeof state.daemonShort !== 'string' ||
+        !JOB_ID_PATTERN.test(state.daemonShort) ||
+        typeof state.cliVersion !== 'string' ||
+        typeof state.cwd !== 'string' ||
+        state.backend !== 'daemon' ||
+        state.praxisOwner !== 1 ||
+        typeof state.createdAt !== 'string' ||
+        typeof state.updatedAt !== 'string' ||
+        (state.firstTerminalAt !== null &&
+            typeof state.firstTerminalAt !== 'string') ||
+        (state.pid !== undefined &&
+            (!Number.isSafeInteger(state.pid) || Number(state.pid) <= 0)) ||
+        (state.socketPath !== undefined && typeof state.socketPath !== 'string') ||
+        (state.controlToken !== undefined &&
+            typeof state.controlToken !== 'string') ||
+        (inFlight !== undefined &&
+            (!isRecord(inFlight) ||
+                !Number.isSafeInteger(inFlight.tasks) ||
+                !Number.isSafeInteger(inFlight.queued) ||
+                !stringArray(inFlight.kinds)))) {
+        throw new Error(`Invalid Claude job: ${filePath}`);
+    }
+    return state;
+}
+function parseDispatch(source, filePath) {
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch (error) {
+        throw new Error(`Invalid Praxis job dispatch JSON: ${filePath}`, {
+            cause: error,
+        });
+    }
+    if (!isRecord(value) ||
+        value.version !== 1 ||
+        !stringArray(value.argv) ||
+        typeof value.resume !== 'boolean') {
+        throw new Error(`Invalid Praxis job dispatch: ${filePath}`);
+    }
+    return value;
+}
+export class ClaudeJobStore {
+    configRoot;
+    constructor(configRoot) {
+        this.configRoot = configRoot;
+    }
+    async create(state, dispatch) {
+        assertJobId(state.daemonShort);
+        const directory = this.jobDirectory(state.daemonShort);
+        await mkdir(dirname(directory), { recursive: true });
+        try {
+            await mkdir(directory);
+        }
+        catch (error) {
+            if (error.code === 'EEXIST')
+                return false;
+            throw error;
+        }
+        try {
+            await writeFileAtomically(this.statePath(state.daemonShort), `${JSON.stringify(state)}\n`);
+            await writeFileAtomically(this.dispatchPath(state.daemonShort), `${JSON.stringify(dispatch)}\n`);
+            return true;
+        }
+        catch (error) {
+            await rm(directory, { recursive: true, force: true });
+            throw error;
+        }
+    }
+    async read(id) {
+        assertJobId(id);
+        try {
+            return parseState(await readFile(this.statePath(id), 'utf8'), this.statePath(id));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`No agent found with ID: ${id}`);
+            }
+            throw error;
+        }
+    }
+    async readDispatch(id) {
+        assertJobId(id);
+        try {
+            return parseDispatch(await readFile(this.dispatchPath(id), 'utf8'), this.dispatchPath(id));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`No agent dispatch found with ID: ${id}`);
+            }
+            throw error;
+        }
+    }
+    async list() {
+        let names;
+        try {
+            names = await readdir(join(this.configRoot, 'jobs'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const states = await Promise.all(names
+            .filter((name) => JOB_ID_PATTERN.test(name))
+            .map(async (id) => {
+            try {
+                return await this.read(id);
+            }
+            catch {
+                return null;
+            }
+        }));
+        return states.filter((state) => state !== null);
+    }
+    async update(id, mutate) {
+        return this.withLock(id, async () => {
+            const next = mutate(await this.read(id));
+            if (next.daemonShort !== id)
+                throw new Error('Agent ID cannot change');
+            await writeFileAtomically(this.statePath(id), `${JSON.stringify(next)}\n`);
+            return next;
+        });
+    }
+    async appendTimeline(id, entry) {
+        assertJobId(id);
+        await this.withLock(id, async () => {
+            const path = this.timelinePath(id);
+            await mkdir(dirname(path), { recursive: true });
+            const handle = await open(path, 'a', 0o600);
+            try {
+                await handle.writeFile(`${JSON.stringify(entry)}\n`);
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+        });
+    }
+    async timeline(id) {
+        assertJobId(id);
+        let source;
+        try {
+            source = await readFile(this.timelinePath(id), 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        const entries = [];
+        for (const line of source.split('\n')) {
+            if (line.length === 0)
+                continue;
+            try {
+                const value = JSON.parse(line);
+                if (isRecord(value) &&
+                    typeof value.at === 'string' &&
+                    ['working', 'stopped', 'failed'].includes(String(value.state)) &&
+                    typeof value.detail === 'string' &&
+                    typeof value.text === 'string') {
+                    entries.push(value);
+                }
+            }
+            catch {
+                // Preserve earlier durable output if a process died during its last append.
+            }
+        }
+        return entries;
+    }
+    async appendOutput(id, text) {
+        assertJobId(id);
+        if (text.length === 0)
+            return;
+        const path = this.outputPath(id);
+        await mkdir(dirname(path), { recursive: true });
+        const handle = await open(path, 'a', 0o600);
+        try {
+            await handle.writeFile(text);
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async output(id) {
+        assertJobId(id);
+        try {
+            return await readFile(this.outputPath(id), 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return '';
+            throw error;
+        }
+    }
+    async trimOutput(id, maxBytes) {
+        assertJobId(id);
+        if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+            throw new Error('maxBytes must be a positive integer');
+        }
+        let content;
+        try {
+            content = await readFile(this.outputPath(id));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            throw error;
+        }
+        if (content.byteLength <= maxBytes)
+            return;
+        let start = content.byteLength - maxBytes;
+        let byte = content[start];
+        while (byte !== undefined && (byte & 0xc0) === 0x80) {
+            start += 1;
+            byte = content[start];
+        }
+        await writeFileAtomically(this.outputPath(id), content.subarray(start).toString('utf8'));
+    }
+    async withLock(id, operation) {
+        const lease = new ExclusiveFileLease(join(this.configRoot, 'praxis', 'locks', `job-${id}.lock`));
+        const deadline = Date.now() + LOCK_WAIT_MS;
+        while (true) {
+            const handle = await lease.tryAcquire();
+            if (handle) {
+                try {
+                    return await operation();
+                }
+                finally {
+                    await handle.release();
+                }
+            }
+            if (Date.now() >= deadline)
+                throw new Error(`Agent ${id} is busy`);
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    jobDirectory(id) {
+        return join(this.configRoot, 'jobs', id);
+    }
+    statePath(id) {
+        return join(this.jobDirectory(id), 'state.json');
+    }
+    dispatchPath(id) {
+        return join(this.jobDirectory(id), 'dispatch.json');
+    }
+    timelinePath(id) {
+        return join(this.jobDirectory(id), 'timeline.jsonl');
+    }
+    outputPath(id) {
+        return join(this.jobDirectory(id), 'output.log');
+    }
+}
+export function newClaudeJobIdentity() {
+    const sessionId = randomUUID();
+    return { id: sessionId.slice(0, 8), sessionId };
+}
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=claude-job-store.js.map

package/dist/persistence/claude-job-store.js.map

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

package/dist/persistence/claude-scheduled-task-store.d.ts

@@ -0,0 +1,29 @@
+export interface ClaudeScheduledTask {
+    id: string;
+    cron: string;
+    prompt: string;
+    createdAt: number;
+    recurring: boolean;
+    createdBySessionId: string;
+    createdByPid: number;
+    createdByProcStart: string;
+    [key: string]: unknown;
+}
+export interface ClaudeScheduledTaskStoreOptions {
+    filePath: string;
+    lockFile?: string;
+}
+export type ClaudeScheduledTaskCreateInput = Pick<ClaudeScheduledTask, 'cron' | 'prompt' | 'createdAt' | 'recurring' | 'createdBySessionId' | 'createdByPid' | 'createdByProcStart'>;
+export declare class ClaudeScheduledTaskStore {
+    private readonly filePath;
+    private readonly lease;
+    constructor(options: ClaudeScheduledTaskStoreOptions);
+    list(): Promise<ClaudeScheduledTask[]>;
+    create(input: ClaudeScheduledTaskCreateInput): Promise<ClaudeScheduledTask>;
+    delete(id: string): Promise<boolean>;
+    private readRecord;
+    private writeDocument;
+    private matchesFingerprint;
+    private withLock;
+}
+//# sourceMappingURL=claude-scheduled-task-store.d.ts.map

package/dist/persistence/claude-scheduled-task-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-scheduled-task-store.d.ts","sourceRoot":"","sources":["../../src/persistence/claude-scheduled-task-store.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAOD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAC/C,mBAAmB,EACjB,MAAM,GACN,QAAQ,GACR,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,cAAc,GACd,oBAAoB,CACvB,CAAA;AAsFD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAE9B,OAAO,EAAE,+BAA+B;IAQ9C,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAItC,MAAM,CACV,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAqBzB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAe5B,UAAU;IAqBxB,OAAO,CAAC,aAAa;YAWP,kBAAkB;YAclB,QAAQ;CAkBvB"}

package/dist/persistence/claude-scheduled-task-store.js

@@ -0,0 +1,163 @@
+import { randomBytes } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { writeFileAtomically } from '../platform/atomic-write.js';
+import { ExclusiveFileLease } from '../platform/exclusive-file-lease.js';
+const JOB_ID_PATTERN = /^[0-9a-f]{8}$/u;
+const LOCK_WAIT_MS = 5_000;
+const MAX_MUTATION_RETRIES = 16;
+function fingerprint(metadata) {
+    return {
+        device: metadata.dev,
+        inode: metadata.ino,
+        size: metadata.size,
+        modified: metadata.mtimeNs,
+        changed: metadata.ctimeNs,
+    };
+}
+function sameFingerprint(left, right) {
+    return (left.device === right.device &&
+        left.inode === right.inode &&
+        left.size === right.size &&
+        left.modified === right.modified &&
+        left.changed === right.changed);
+}
+function parseTask(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Claude scheduled task');
+    }
+    const task = value;
+    if (typeof task.id !== 'string' ||
+        !JOB_ID_PATTERN.test(task.id) ||
+        typeof task.cron !== 'string' ||
+        typeof task.prompt !== 'string' ||
+        !Number.isSafeInteger(task.createdAt) ||
+        Number(task.createdAt) < 0 ||
+        typeof task.recurring !== 'boolean' ||
+        typeof task.createdBySessionId !== 'string' ||
+        !Number.isSafeInteger(task.createdByPid) ||
+        Number(task.createdByPid) <= 0 ||
+        typeof task.createdByProcStart !== 'string') {
+        throw new Error('Invalid Claude scheduled task');
+    }
+    return { ...task };
+}
+function parseDocument(source, filePath) {
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch (error) {
+        throw new Error(`Invalid Claude scheduled task JSON: ${filePath}`, {
+            cause: error,
+        });
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid Claude scheduled task document: ${filePath}`);
+    }
+    const document = value;
+    if (!Array.isArray(document.tasks)) {
+        throw new Error(`Invalid Claude scheduled task document: ${filePath}`);
+    }
+    const tasks = document.tasks.map(parseTask);
+    if (new Set(tasks.map(({ id }) => id)).size !== tasks.length) {
+        throw new Error(`Duplicate Claude scheduled task ID: ${filePath}`);
+    }
+    return { ...document, tasks };
+}
+export class ClaudeScheduledTaskStore {
+    filePath;
+    lease;
+    constructor(options) {
+        this.filePath = options.filePath;
+        this.lease = new ExclusiveFileLease(options.lockFile ??
+            join(dirname(dirname(this.filePath)), 'praxis', 'locks', 'cron.lock'));
+    }
+    async list() {
+        return (await this.readRecord()).document.tasks.map((task) => ({ ...task }));
+    }
+    async create(input) {
+        return this.withLock(async () => {
+            for (let attempt = 0; attempt < MAX_MUTATION_RETRIES; attempt += 1) {
+                const { document, fingerprint: expected } = await this.readRecord();
+                const ids = new Set(document.tasks.map(({ id }) => id));
+                let id = randomBytes(4).toString('hex');
+                while (ids.has(id))
+                    id = randomBytes(4).toString('hex');
+                const task = { id, ...input };
+                if (await this.writeDocument({ ...document, tasks: [...document.tasks, task] }, expected)) {
+                    return { ...task };
+                }
+            }
+            throw new Error(`Claude scheduled task file changed too frequently`);
+        });
+    }
+    async delete(id) {
+        if (!JOB_ID_PATTERN.test(id))
+            return false;
+        return this.withLock(async () => {
+            for (let attempt = 0; attempt < MAX_MUTATION_RETRIES; attempt += 1) {
+                const { document, fingerprint: expected } = await this.readRecord();
+                const tasks = document.tasks.filter((task) => task.id !== id);
+                if (tasks.length === document.tasks.length)
+                    return false;
+                if (await this.writeDocument({ ...document, tasks }, expected)) {
+                    return true;
+                }
+            }
+            throw new Error(`Claude scheduled task file changed too frequently`);
+        });
+    }
+    async readRecord() {
+        try {
+            const before = fingerprint(await stat(this.filePath, { bigint: true }));
+            const source = await readFile(this.filePath, 'utf8');
+            const after = fingerprint(await stat(this.filePath, { bigint: true }));
+            if (!sameFingerprint(before, after))
+                return this.readRecord();
+            return {
+                document: parseDocument(source, this.filePath),
+                fingerprint: after,
+            };
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return { document: { tasks: [] }, fingerprint: null };
+            }
+            throw error;
+        }
+    }
+    writeDocument(document, expected) {
+        return writeFileAtomically(this.filePath, `${JSON.stringify(document, null, 2)}\n`, { beforeCommit: () => this.matchesFingerprint(expected) });
+    }
+    async matchesFingerprint(expected) {
+        try {
+            const current = fingerprint(await stat(this.filePath, { bigint: true }));
+            return expected !== null && sameFingerprint(current, expected);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return expected === null;
+            }
+            throw error;
+        }
+    }
+    async withLock(operation) {
+        const started = Date.now();
+        let lock = await this.lease.tryAcquire();
+        while (!lock) {
+            if (Date.now() - started >= LOCK_WAIT_MS) {
+                throw new Error(`Claude scheduled task store is locked: ${this.filePath}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            lock = await this.lease.tryAcquire();
+        }
+        try {
+            return await operation();
+        }
+        finally {
+            await lock.release();
+        }
+    }
+}
+//# sourceMappingURL=claude-scheduled-task-store.js.map

package/dist/persistence/claude-scheduled-task-store.js.map

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

package/dist/persistence/claude-sidechain-store.d.ts

@@ -0,0 +1,18 @@
+import type { ClaudeSchemaAdapter, ClaudeTranscriptEntry } from '../compatibility/claude/schema.js';
+import type { ClaudeSidechainMetadata, ClaudeSidechainPaths } from '../compatibility/claude/sidechain.js';
+import { type ClaudeTranscriptLease, type TranscriptSnapshot } from './claude-transcript-store.js';
+export declare class ClaudeSidechainStore {
+    private readonly paths;
+    private readonly transcript;
+    constructor(paths: ClaudeSidechainPaths, lockFile: string, schema: ClaudeSchemaAdapter);
+    create(root: ClaudeTranscriptEntry, metadata: ClaudeSidechainMetadata): Promise<void>;
+    createWorkflow(root: ClaudeTranscriptEntry, metadata: {
+        agentType: string;
+        spawnDepth: 1;
+    }): Promise<void>;
+    private createWithMetadata;
+    withLease<T>(operation: (lease: ClaudeTranscriptLease) => Promise<T>): Promise<T>;
+    loadReadOnly(): Promise<TranscriptSnapshot>;
+    metadata(): Promise<ClaudeSidechainMetadata>;
+}
+//# sourceMappingURL=claude-sidechain-store.d.ts.map

package/dist/persistence/claude-sidechain-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sidechain-store.d.ts","sourceRoot":"","sources":["../../src/persistence/claude-sidechain-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACxB,MAAM,8BAA8B,CAAA;AAErC,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;gBAG/B,KAAK,EAAE,oBAAoB,EAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB;IAUvB,MAAM,CACV,IAAI,EAAE,qBAAqB,EAC3B,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC;IAIV,cAAc,CAClB,IAAI,EAAE,qBAAqB,EAC3B,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,CAAC,CAAA;KAAE,GAC7C,OAAO,CAAC,IAAI,CAAC;YAIF,kBAAkB;IAqC1B,SAAS,CAAC,CAAC,EACf,SAAS,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,CAAC,CAAC;IAQP,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI3C,QAAQ,IAAI,OAAO,CAAC,uBAAuB,CAAC;CAiDnD"}