@claudexor/daemon 1.0.0 → 2.1.2

package/dist/journal-recovery-files.js

@@ -0,0 +1,209 @@
+import { createHash, randomUUID } from "node:crypto";
+import { closeSync, constants, existsSync, fchmodSync, fstatSync, fsyncSync, lstatSync, openSync, readFileSync, readdirSync, readlinkSync, readSync, renameSync, rmSync, writeSync, } from "node:fs";
+import { dirname, join } from "node:path";
+import { JournalRecoveryRequiredError } from "@claudexor/journal";
+import { ensureCanonicalPrivateDirectory } from "@claudexor/util";
+export function recoveryFrom(error, fallback) {
+    if (error instanceof JournalRecoveryRequiredError)
+        return cloneRecovery(error.recovery);
+    return recoveryAt(0, `${fallback}: ${safeMessage(error)}`);
+}
+export function recoveryAt(byteOffset, reason) {
+    return {
+        status: "recovery_required",
+        location: { kind: "byte", byteOffset },
+        reason,
+        discardedTailBytes: 0,
+    };
+}
+export function cloneRecovery(value) {
+    return value.status === "ready" ? { ...value } : { ...value, location: { ...value.location } };
+}
+export function safeMessage(value) {
+    return value instanceof Error ? value.message : String(value);
+}
+export function fingerprintPartition(path) {
+    const hash = createHash("sha256");
+    if (!existsSync(path))
+        return hash.update("missing\0").digest("hex");
+    const root = lstatSync(path, { bigint: true });
+    if (root.isSymbolicLink()) {
+        hash.update(`symlink\0${readlinkSync(path)}\0`);
+        return hash.digest("hex");
+    }
+    if (!root.isDirectory())
+        return hash.update(`other\0${metadata(root)}\0`).digest("hex");
+    // Deliberately exclude the root inode/timestamps: this content fingerprint
+    // must remain stable when the owned partition is atomically quarantined.
+    hash.update("directory\0");
+    for (const name of readdirSync(path).sort()) {
+        const entryPath = join(path, name);
+        const stat = lstatSync(entryPath, { bigint: true });
+        hash.update(`entry\0${name}\0${metadata(stat)}\0`);
+        if (stat.isSymbolicLink())
+            hash.update(`target\0${readlinkSync(entryPath)}\0`);
+        else if (stat.isFile() && stat.nlink === 1n)
+            hash.update(hashOwnedFile(entryPath));
+    }
+    return hash.digest("hex");
+}
+export function exportPartitionEntries(source, destination) {
+    if (!existsSync(source))
+        return [
+            { name: ".", type: "missing", mode: 0, size: 0, nlink: 0, sha256: null, copiedAs: null },
+        ];
+    const root = lstatSync(source, { bigint: true });
+    if (!root.isDirectory() || root.isSymbolicLink()) {
+        return [
+            {
+                name: ".",
+                type: root.isSymbolicLink() ? "symlink" : "other",
+                mode: Number(root.mode & 511n),
+                size: Number(root.size),
+                nlink: Number(root.nlink),
+                sha256: null,
+                copiedAs: null,
+                ...(root.isSymbolicLink() ? { linkTarget: readlinkSync(source) } : {}),
+            },
+        ];
+    }
+    return readdirSync(source)
+        .sort()
+        .map((name) => {
+        const path = join(source, name);
+        const stat = lstatSync(path, { bigint: true });
+        const type = stat.isFile()
+            ? "file"
+            : stat.isDirectory()
+                ? "directory"
+                : stat.isSymbolicLink()
+                    ? "symlink"
+                    : "other";
+        let digest = null;
+        let copiedAs = null;
+        if (stat.isFile() && stat.nlink === 1n) {
+            const bytes = readOwnedFile(path);
+            digest = sha256(bytes);
+            copiedAs = name;
+            writeExclusiveFile(join(destination, name), bytes, 0o400);
+        }
+        return {
+            name,
+            type,
+            mode: Number(stat.mode & 511n),
+            size: Number(stat.size),
+            nlink: Number(stat.nlink),
+            sha256: digest,
+            copiedAs,
+            ...(stat.isSymbolicLink() ? { linkTarget: readlinkSync(path) } : {}),
+        };
+    });
+}
+export function readOwnedFile(path) {
+    const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const before = fstatSync(fd, { bigint: true });
+        assertOwnedRegular(path, before);
+        const bytes = readFileSync(fd);
+        const after = fstatSync(fd, { bigint: true });
+        if (metadata(before) !== metadata(after))
+            throw new Error(`journal file changed while exporting: ${path}`);
+        assertOwnedRegular(path, after);
+        return bytes;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function writeAtomicPrivateJson(path, value, exclusive) {
+    ensureCanonicalPrivateDirectory(dirname(path));
+    if (exclusive && existsSync(path)) {
+        throw Object.assign(new Error("recovery idempotency record already exists"), {
+            code: "idempotency_conflict",
+            status: 409,
+        });
+    }
+    const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    try {
+        writeExclusiveFile(tmp, Buffer.from(`${JSON.stringify(value, null, 2)}\n`), 0o600);
+        renameSync(tmp, path);
+        fsyncDirectory(dirname(path));
+    }
+    finally {
+        try {
+            rmSync(tmp, { force: true });
+        }
+        catch {
+            /* renamed or absent */
+        }
+    }
+}
+export function fsyncDirectory(path) {
+    const fd = openSync(path, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+    try {
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function sha256(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+export function sha256File(path) {
+    return hashOwnedFile(path).toString("hex");
+}
+function hashOwnedFile(path) {
+    const fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const before = fstatSync(fd, { bigint: true });
+        assertOwnedRegular(path, before);
+        const hash = createHash("sha256");
+        const buffer = Buffer.allocUnsafe(64 * 1024);
+        let offset = 0;
+        for (;;) {
+            const count = readSync(fd, buffer, 0, buffer.length, offset);
+            if (count === 0)
+                break;
+            hash.update(buffer.subarray(0, count));
+            offset += count;
+        }
+        const after = fstatSync(fd, { bigint: true });
+        if (metadata(before) !== metadata(after))
+            throw new Error(`journal file changed while hashing: ${path}`);
+        assertOwnedRegular(path, after);
+        return hash.digest();
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function assertOwnedRegular(path, opened) {
+    const named = lstatSync(path, { bigint: true });
+    if (!opened.isFile() ||
+        opened.nlink !== 1n ||
+        named.isSymbolicLink() ||
+        !named.isFile() ||
+        named.nlink !== 1n ||
+        opened.dev !== named.dev ||
+        opened.ino !== named.ino)
+        throw new Error(`journal recovery file is not a singly-linked owned regular file: ${path}`);
+}
+function metadata(stat) {
+    return [stat.dev, stat.ino, stat.mode, stat.nlink, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
+}
+export function writeExclusiveFile(path, bytes, mode) {
+    const fd = openSync(path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+    try {
+        let offset = 0;
+        while (offset < bytes.length)
+            offset += writeSync(fd, bytes, offset, bytes.length - offset);
+        fsyncSync(fd);
+        fchmodSync(fd, mode);
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=journal-recovery-files.js.map

package/dist/journal-recovery-files.js.map

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

package/dist/operator-decisions.d.ts

@@ -0,0 +1,30 @@
+import type { DurableJournal } from "@claudexor/journal";
+export interface OperatorDecisionRecord {
+    runId: string;
+    action: "accept_risk" | "override_needs_human";
+    findingIds: string[];
+    acceptedRisks: string[];
+    patchSha256: string;
+    decidedAt: string;
+}
+/** Journal authority for the human decision that may unblock one exact run patch. */
+export declare class OperatorDecisionStore {
+    private readonly journal;
+    private readonly byRun;
+    private readonly byKey;
+    constructor(journal: DurableJournal);
+    get(runId: string): OperatorDecisionRecord | null;
+    record(input: OperatorDecisionRecord, idempotency?: {
+        key: string;
+        client: string;
+        request: unknown;
+    }): OperatorDecisionRecord;
+    validateProjection(): void;
+    private apply;
+}
+export declare function operatorDecisionProjection(): {
+    name: string;
+    create: (journal: DurableJournal) => OperatorDecisionStore;
+    validate: (store: OperatorDecisionStore) => void;
+};
+//# sourceMappingURL=operator-decisions.d.ts.map

package/dist/operator-decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-decisions.d.ts","sourceRoot":"","sources":["../src/operator-decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,sBAAsB,CAAC;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD,qFAAqF;AACrF,qBAAa,qBAAqB;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IACnE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+D;gBAExD,OAAO,EAAE,cAAc;IAQpD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAKjD,MAAM,CACJ,KAAK,EAAE,sBAAsB,EAC7B,WAAW,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAC9D,sBAAsB;IAkBzB,kBAAkB,IAAI,IAAI;IAQ1B,OAAO,CAAC,KAAK;CAWd;AAED,wBAAgB,0BAA0B;;sBAGpB,cAAc;sBACd,qBAAqB;EAE1C"}

package/dist/operator-decisions.js

@@ -0,0 +1,137 @@
+import { hashJson } from "@claudexor/util";
+const RECORDED = "operator.decision_recorded";
+/** Journal authority for the human decision that may unblock one exact run patch. */
+export class OperatorDecisionStore {
+    journal;
+    byRun = new Map();
+    byKey = new Map();
+    constructor(journal) {
+        this.journal = journal;
+        for (const entry of journal.records()) {
+            if (entry.type !== RECORDED)
+                continue;
+            const mutation = parseMutation(entry.payload);
+            this.apply(mutation);
+        }
+    }
+    get(runId) {
+        const decision = this.byRun.get(runId);
+        return decision ? structuredClone(decision) : null;
+    }
+    record(input, idempotency) {
+        const decision = parseDecision(input);
+        const binding = decisionBinding(this.journal.options.partition, decision.runId, idempotency);
+        if (binding) {
+            const prior = this.byKey.get(binding.keyDigest);
+            if (prior) {
+                if (prior.requestDigest !== binding.requestDigest)
+                    throw conflict();
+                const existing = this.byRun.get(prior.runId);
+                if (!existing)
+                    throw new Error("operator decision idempotency index is dangling");
+                return structuredClone(existing);
+            }
+        }
+        const mutation = { decision, ...(binding ? { idempotency: binding } : {}) };
+        this.journal.append(RECORDED, mutation);
+        this.apply(mutation);
+        return structuredClone(decision);
+    }
+    validateProjection() {
+        for (const decision of this.byRun.values())
+            parseDecision(decision);
+        for (const binding of this.byKey.values()) {
+            if (!this.byRun.has(binding.runId))
+                throw new Error("operator decision idempotency index is dangling");
+        }
+    }
+    apply(mutation) {
+        this.byRun.set(mutation.decision.runId, structuredClone(mutation.decision));
+        if (mutation.idempotency) {
+            const { keyDigest, requestDigest, runId } = mutation.idempotency;
+            const prior = this.byKey.get(keyDigest);
+            if (prior && (prior.requestDigest !== requestDigest || prior.runId !== runId)) {
+                throw new Error("conflicting operator decision idempotency history");
+            }
+            this.byKey.set(keyDigest, { requestDigest, runId });
+        }
+    }
+}
+export function operatorDecisionProjection() {
+    return {
+        name: "operator-decisions",
+        create: (journal) => new OperatorDecisionStore(journal),
+        validate: (store) => store.validateProjection(),
+    };
+}
+function parseDecision(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("invalid operator decision record");
+    }
+    const input = value;
+    if (typeof input.runId !== "string" ||
+        !input.runId ||
+        (input.action !== "accept_risk" && input.action !== "override_needs_human") ||
+        !stringArray(input.findingIds) ||
+        !stringArray(input.acceptedRisks) ||
+        typeof input.patchSha256 !== "string" ||
+        !/^sha256:[a-f0-9]{64}$/.test(input.patchSha256) ||
+        typeof input.decidedAt !== "string" ||
+        !input.decidedAt) {
+        throw new Error("invalid operator decision record");
+    }
+    return structuredClone(input);
+}
+function parseMutation(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("invalid operator decision mutation");
+    }
+    const input = value;
+    // Accept the pre-idempotency v2 record shape while the release candidate is local-only.
+    if (!("decision" in input))
+        return { decision: parseDecision(value) };
+    const idempotency = input["idempotency"];
+    if (idempotency !== undefined &&
+        (!idempotency ||
+            typeof idempotency !== "object" ||
+            Array.isArray(idempotency) ||
+            typeof idempotency.keyDigest !== "string" ||
+            typeof idempotency.requestDigest !== "string" ||
+            typeof idempotency.runId !== "string")) {
+        throw new Error("invalid operator decision idempotency binding");
+    }
+    return {
+        decision: parseDecision(input["decision"]),
+        ...(idempotency ? { idempotency: { ...idempotency } } : {}),
+    };
+}
+function decisionBinding(partition, runId, input) {
+    if (!input)
+        return undefined;
+    if (!input.key || input.key.length > 256) {
+        throw Object.assign(new Error("Idempotency-Key must contain 1-256 characters"), {
+            code: "invalid_idempotency_key",
+            status: 400,
+        });
+    }
+    return {
+        keyDigest: hashJson({
+            client: input.client,
+            partition,
+            operation: "run.decision",
+            key: input.key,
+        }),
+        requestDigest: hashJson(input.request),
+        runId,
+    };
+}
+function conflict() {
+    return Object.assign(new Error("idempotency key was already used with a different request"), {
+        code: "idempotency_conflict",
+        status: 409,
+    });
+}
+function stringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+//# sourceMappingURL=operator-decisions.js.map

package/dist/operator-decisions.js.map

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

package/dist/project-partitions.d.ts

@@ -0,0 +1,167 @@
+import type { Project, RunEvent, Thread, ThreadTurn } from "@claudexor/schema";
+import { type CommandStore } from "./command-store.js";
+import { JournalManager, type JournalProjectionSlot } from "./journal-manager.js";
+import { type InteractionStore } from "./interactions.js";
+import { type OperatorDecisionRecord, type OperatorDecisionStore } from "./operator-decisions.js";
+import { type RunEventStore } from "./run-events.js";
+import { type SpecSessionStore } from "./spec-sessions.js";
+import type { ProjectStore } from "./projects.js";
+import { type CreateThreadInput, type CreateTurnInput, type ThreadHeadPingSink, type ThreadStore, type UpdateThreadInput } from "./threads.js";
+import type { CommandAuthority } from "./command-authority.js";
+export declare class ProjectPartitions implements CommandAuthority {
+    private readonly rootDir;
+    private readonly projects;
+    private readonly globalCommands;
+    private readonly globalInteractions;
+    private readonly globalDecisions;
+    private readonly globalRunEvents;
+    private readonly globalThreads;
+    /** Global-partition `thread.head.updated` sink, threaded into every project ThreadStore. */
+    private readonly headPing?;
+    private readonly partitions;
+    constructor(rootDir: string, projects: JournalProjectionSlot<ProjectStore>, globalCommands: JournalProjectionSlot<CommandStore>, globalInteractions: JournalProjectionSlot<InteractionStore>, globalDecisions: JournalProjectionSlot<OperatorDecisionStore>, globalRunEvents: JournalProjectionSlot<RunEventStore>, globalThreads: JournalProjectionSlot<ThreadStore>, 
+    /** Global-partition `thread.head.updated` sink, threaded into every project ThreadStore. */
+    headPing?: ThreadHeadPingSink | undefined);
+    all(): CommandStore[];
+    interactionStores(): InteractionStore[];
+    interactionsForRequest(params: unknown): InteractionStore;
+    operatorDecision(params: unknown, runId: string): OperatorDecisionRecord | null;
+    recordOperatorDecision(params: unknown, decision: OperatorDecisionRecord, idempotency?: {
+        key: string;
+        client: string;
+        request: unknown;
+    }): OperatorDecisionRecord;
+    recordRunEvent(params: unknown, event: RunEvent): RunEvent;
+    specsForRequest(params: unknown): SpecSessionStore;
+    specStoreForSession(id: string): SpecSessionStore | undefined;
+    listSpecSessions(): {
+        state: "failed" | "cancelled" | "interrupted_unknown" | "questions" | "frozen" | "grounding" | "answered" | "freezing";
+        error: string | null;
+        createdAt: string;
+        prompt: string;
+        questions: {
+            options: {
+                id: string;
+                label: string;
+            }[];
+            kind: "text" | "single" | "multi";
+            id: string;
+            prompt: string;
+            tier: number;
+            allow_text: boolean;
+            rationale?: string | undefined;
+        }[];
+        answers: {
+            question_id: string;
+            text: string | null;
+            option_ids: string[];
+        }[];
+        planRunId: string | null;
+        scope: {
+            kind: "project";
+            root: string;
+            context: "auto";
+        };
+        specPath: string | null;
+        specId: string | null;
+        specHash: string | null;
+        sessionId: string;
+        updatedAt: string;
+        priorDecisions: {
+            question: string;
+            answer: string;
+        }[];
+        specDir: string | null;
+    }[];
+    forRequest(params: unknown): CommandStore;
+    findById(id: string): CommandStore | undefined;
+    beginDelivery(params: unknown, input: {
+        key: string;
+        client: string;
+        operation: string;
+        request: unknown;
+    }): {
+        reused: boolean;
+        id: string;
+        state: import("./server.js").JobState;
+        params: unknown;
+        result?: unknown;
+        error?: string;
+        errorCode?: string;
+        errorStatus?: number;
+        createdAt: string;
+        runId?: string;
+        taskId?: string;
+        runDir?: string;
+        startedAt?: string;
+        finishedAt?: string;
+    };
+    completeDelivery(id: string, result: unknown): void;
+    failDelivery(id: string, error: unknown): void;
+    registerProject(input: Parameters<ProjectStore["register"]>[0]): Project;
+    relinkProject(id: string, root: string): Project;
+    journal(partition: string): JournalManager;
+    createThread(input: CreateThreadInput): Thread;
+    listThreads(): Thread[];
+    getThread(id: string): Thread | undefined;
+    turnsFor(id: string): ThreadTurn[];
+    sessionsForThread(id: string): {
+        state: "live" | "stale" | "rebound";
+        profile_id: string | null;
+        harness_id: string;
+        created_at: string;
+        id: string;
+        updated_at: string;
+        thread_id: string;
+        native_session_id: string | null;
+        resume_kind: "none" | "resume_by_id";
+        last_observed_model: string | null;
+    }[];
+    createTurn(id: string, prompt: string, input?: CreateTurnInput): ThreadTurn;
+    updateThread(id: string, patch: UpdateThreadInput): Thread;
+    trashThread(id: string): Thread;
+    restoreThread(id: string): Thread;
+    purgeThread(id: string): Thread;
+    setThreadWorktree(id: string, path: string, baseSha: string, deliveredThroughRunId?: string): void;
+    assertKnownIds(threadId: unknown, turnId: unknown): {
+        threadId?: string;
+        turnId?: string;
+    };
+    getTurn(id: string): ThreadTurn | undefined;
+    bindTurnRun(id: string, runId: string): void;
+    setTurnEnqueueError(id: string, message: string, code?: string | null, retryable?: boolean): void;
+    resumeMap(id: string, profileId?: string | null): Record<string, {
+        sessionId: string;
+        profileId: string | null;
+    }>;
+    recordSession(id: string, harnessId: string, nativeSessionId: string, observedModel?: string | null, profileId?: string | null): void;
+    /**
+     * Run-terminal invalidation (the W12 path with no store mutation to ride):
+     * a terminal changes the thread's presented state (needs-me, outcome), so
+     * the daemon pings the owning store's head directly.
+     */
+    pingThreadHead(id: string): void;
+    close(): void;
+    private sync;
+    private ensure;
+    private healthy;
+    /**
+     * Canonical roots whose partition journal is READY — the set whose thread
+     * lineage / job records are trustworthy. Retention (W3.6) fails CLOSED on a
+     * quarantined partition: its runs are protected, never GC'd against an empty
+     * reference set (a non-ready partition contributes nothing to listThreads,
+     * so its referenced runs would otherwise look unreferenced).
+     */
+    healthyProjectRoots(): string[];
+    private partitionForRoot;
+    private threadStores;
+    private threadStoreForRoot;
+    private threadStoreForThread;
+    private threadStoreForTurn;
+    private requireThreadStore;
+    private requireTurnStore;
+    private commandStoreForThreadStore;
+    private decisionStoreForRequest;
+    private runEventStoreForRequest;
+}
+//# sourceMappingURL=project-partitions.d.ts.map

package/dist/project-partitions.d.ts.map

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