agent-merge-broker 0.3.0

package/dist/store.js

@@ -0,0 +1,323 @@
+import path from "node:path";
+import { hostname } from "node:os";
+import { createHash, randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { access, appendFile, chmod, mkdir, open, readFile, rename, rm, stat, writeFile, } from "node:fs/promises";
+import { BrokerError } from "./errors.js";
+import { STATE_VERSION } from "./types.js";
+/** Most recent audit bytes scanned by a read. Older events remain in the rotated segments. */
+const AUDIT_TAIL_BYTES = 1_024 * 1_024;
+/** Size at which the active audit file is rotated into an archive segment. */
+const AUDIT_ROTATE_BYTES = 16 * 1_024 * 1_024;
+const delay = async (milliseconds) => {
+    await new Promise((resolve) => setTimeout(resolve, milliseconds));
+};
+async function exists(target) {
+    try {
+        await access(target, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class StateStore {
+    directory;
+    worktreesDirectory;
+    archiveDirectory;
+    tokensDirectory;
+    stateFile;
+    auditFile;
+    receiptsDirectory;
+    batchesDirectory;
+    lockTimeoutMs;
+    constructor(commonGitDir, stateDirectory, lockTimeoutSeconds) {
+        this.directory = path.resolve(commonGitDir, stateDirectory);
+        this.worktreesDirectory = path.join(this.directory, "worktrees");
+        this.archiveDirectory = path.join(this.directory, "archive");
+        this.tokensDirectory = path.join(this.directory, "tokens");
+        this.stateFile = path.join(this.directory, "state.json");
+        this.auditFile = path.join(this.directory, "audit.jsonl");
+        this.receiptsDirectory = path.join(this.directory, "receipts");
+        this.batchesDirectory = path.join(this.directory, "batches");
+        this.lockTimeoutMs = lockTimeoutSeconds * 1_000;
+    }
+    async initialize() {
+        await Promise.all([
+            mkdir(this.directory, { recursive: true }),
+            mkdir(this.worktreesDirectory, { recursive: true }),
+            mkdir(this.receiptsDirectory, { recursive: true }),
+            mkdir(this.batchesDirectory, { recursive: true }),
+            mkdir(this.archiveDirectory, { recursive: true }),
+            mkdir(this.tokensDirectory, { recursive: true, mode: 0o700 }),
+        ]);
+        if (!(await exists(this.stateFile))) {
+            try {
+                await writeFile(this.stateFile, `${JSON.stringify({
+                    version: STATE_VERSION,
+                    sequence: 0,
+                    tasks: {},
+                    batches: {},
+                }, null, 2)}\n`, { encoding: "utf8", flag: "wx" });
+            }
+            catch (error) {
+                if (error.code !== "EEXIST")
+                    throw error;
+            }
+        }
+    }
+    async read() {
+        await this.initialize();
+        const source = await readFile(this.stateFile, "utf8");
+        let state;
+        try {
+            state = JSON.parse(source);
+        }
+        catch (error) {
+            throw new BrokerError("STATE_CORRUPT", `Broker state is not valid JSON: ${this.stateFile}`, {
+                cause: error instanceof Error ? error.message : String(error),
+            });
+        }
+        if (state.version !== STATE_VERSION) {
+            throw new BrokerError("STATE_VERSION", `Unsupported broker state version: ${String(state.version)}`);
+        }
+        return state;
+    }
+    async transaction(mutator) {
+        return await this.withLock("state", async () => {
+            const state = await this.read();
+            const events = [];
+            const record = (event, fields = {}) => {
+                state.sequence += 1;
+                events.push({ sequence: state.sequence, at: new Date().toISOString(), event, ...fields });
+            };
+            const result = await mutator(state, record);
+            await this.atomicWrite(this.stateFile, state);
+            if (events.length > 0) {
+                await this.rotateAuditIfLarge();
+                await appendFile(this.auditFile, `${events.map((event) => JSON.stringify(event)).join("\n")}\n`, "utf8");
+            }
+            return result;
+        });
+    }
+    async withIntegrationLock(operation) {
+        return await this.withLock("integration", operation, 24 * 60 * 60 * 1_000);
+    }
+    async writeReceipt(receipt) {
+        await this.initialize();
+        const target = path.join(this.receiptsDirectory, `${safeName(receipt.taskId)}.json`);
+        await this.atomicWrite(target, receipt);
+        return target;
+    }
+    tokenPath(taskId) {
+        return path.join(this.tokensDirectory, `${safeName(taskId)}.token`);
+    }
+    /**
+     * Holds a worker's lease token for it. A token shown once and never stored forces every adopter to
+     * build a token store, and the obvious implementation puts a live credential in the working tree
+     * where `git add` and validator commands can reach it. Here it stays owner-readable, beside the
+     * state it authorizes, under a directory whose contents are already trusted.
+     */
+    async writeToken(taskId, token, target = this.tokenPath(taskId)) {
+        await mkdir(path.dirname(target), { recursive: true, mode: 0o700 });
+        await chmod(path.dirname(target), 0o700).catch(() => undefined);
+        const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
+        await writeFile(temporary, `${token}\n`, { encoding: "utf8", mode: 0o600 });
+        await chmod(temporary, 0o600).catch(() => undefined);
+        await rename(temporary, target);
+        return target;
+    }
+    async readToken(taskId) {
+        try {
+            return (await readFile(this.tokenPath(taskId), "utf8")).trim() || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async deleteToken(taskId) {
+        await rm(this.tokenPath(taskId), { force: true });
+    }
+    async writeBatchManifest(batchId, manifest) {
+        await this.initialize();
+        const target = path.join(this.batchesDirectory, `${safeName(batchId)}.json`);
+        await this.atomicWrite(target, manifest);
+        return target;
+    }
+    /**
+     * Reads the tail of the active audit stream. Deliberately tolerant: a tail read can begin
+     * mid-line, and a crash between writing and flushing can leave a truncated final line. Neither is
+     * a reason to make the whole audit trail unreadable, which is exactly when it is needed most.
+     */
+    async readAudit(limit = 100) {
+        if (!(await exists(this.auditFile)))
+            return [];
+        const handle = await open(this.auditFile, "r");
+        let text;
+        let partialStart;
+        try {
+            const { size } = await handle.stat();
+            const start = Math.max(0, size - AUDIT_TAIL_BYTES);
+            partialStart = start > 0;
+            const length = size - start;
+            if (length === 0)
+                return [];
+            const buffer = Buffer.alloc(length);
+            await handle.read(buffer, 0, length, start);
+            text = buffer.toString("utf8");
+        }
+        finally {
+            await handle.close();
+        }
+        const lines = text.split("\n").filter((line) => line.trim() !== "");
+        if (partialStart)
+            lines.shift();
+        const events = [];
+        for (const line of lines) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                continue;
+            }
+        }
+        return events.slice(-limit);
+    }
+    /**
+     * Moves the active audit file aside once it grows large enough to make reads expensive. Segments
+     * are never deleted: an audit stream that silently forgets is worse than a large one.
+     */
+    async rotateAuditIfLarge() {
+        const current = await stat(this.auditFile).catch(() => undefined);
+        if (!current || current.size < AUDIT_ROTATE_BYTES)
+            return;
+        const stamp = new Date().toISOString().replace(/[:.]/gu, "-");
+        await mkdir(this.archiveDirectory, { recursive: true });
+        await rename(this.auditFile, path.join(this.archiveDirectory, `audit-${stamp}.jsonl`));
+    }
+    /** Writes a retired slice of state to the archive directory and returns its path. */
+    async archive(name, value) {
+        await mkdir(this.archiveDirectory, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/gu, "-");
+        const label = name.replace(/[^a-zA-Z0-9._-]/gu, "-").slice(0, 32) || "archive";
+        const target = path.join(this.archiveDirectory, `${label}-${stamp}.json`);
+        await this.atomicWrite(target, value);
+        return target;
+    }
+    async inspectLock(name) {
+        const lockDirectory = path.join(this.directory, `${name}.lock`);
+        const lockStat = await stat(lockDirectory).catch(() => undefined);
+        if (!lockStat)
+            return { name, held: false, path: lockDirectory };
+        let owner;
+        try {
+            const parsed = JSON.parse(await readFile(path.join(lockDirectory, "owner.json"), "utf8"));
+            owner = {
+                ...(Number.isInteger(parsed.pid) ? { pid: parsed.pid } : {}),
+                ...(typeof parsed.host === "string" ? { host: parsed.host } : {}),
+                ...(typeof parsed.createdAt === "string" ? { createdAt: parsed.createdAt } : {}),
+            };
+        }
+        catch {
+            owner = undefined;
+        }
+        return {
+            name,
+            held: true,
+            path: lockDirectory,
+            ...(owner ? { owner } : {}),
+            ageMs: Date.now() - lockStat.mtimeMs,
+            abandoned: await this.lockOwnerCrashed(lockDirectory),
+        };
+    }
+    /**
+     * Releases a held lock. Without `force` this refuses unless the holder is provably gone, because
+     * removing a live lock allows two integrations to run against the same repository at once.
+     */
+    async releaseLock(name, options = {}) {
+        const status = await this.inspectLock(name);
+        if (!status.held)
+            return status;
+        if (!options.force && !status.abandoned) {
+            throw new BrokerError("LOCK_HELD", `The ${name} lock is held by ${status.owner?.host ?? "an unknown host"} (pid ${status.owner?.pid ?? "unknown"}) and is not provably abandoned. Re-run with --force only after confirming no integration is running.`, { lock: status });
+        }
+        await rm(status.path, { recursive: true, force: true });
+        return { ...status, held: false };
+    }
+    async withLock(name, operation, staleMs = 60_000) {
+        await this.initialize();
+        const lockDirectory = path.join(this.directory, `${name}.lock`);
+        const startedAt = Date.now();
+        while (true) {
+            try {
+                await mkdir(lockDirectory);
+                await writeFile(path.join(lockDirectory, "owner.json"), `${JSON.stringify({ pid: process.pid, host: hostname(), createdAt: new Date().toISOString() })}\n`, "utf8");
+                break;
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== "EEXIST")
+                    throw error;
+                const lockStat = await stat(lockDirectory).catch(() => undefined);
+                // A crashed holder on this machine can be detected directly, so its lock is reclaimed after a
+                // short grace period. A holder on another machine cannot be probed at all -- the state
+                // directory is shared, but process IDs are not -- so those wait out the full stale timeout
+                // rather than risk two integrations running at once.
+                const age = lockStat ? Date.now() - lockStat.mtimeMs : 0;
+                if (lockStat && (age > staleMs || (age > 2_000 && (await this.lockOwnerCrashed(lockDirectory))))) {
+                    await rm(lockDirectory, { recursive: true, force: true });
+                    continue;
+                }
+                if (Date.now() - startedAt > this.lockTimeoutMs) {
+                    throw new BrokerError("LOCK_TIMEOUT", `Timed out waiting for the ${name} lock.`, { lockDirectory });
+                }
+                await delay(50 + Math.floor(Math.random() * 100));
+            }
+        }
+        try {
+            return await operation();
+        }
+        finally {
+            await rm(lockDirectory, { recursive: true, force: true });
+        }
+    }
+    /**
+     * True only when the lock is provably abandoned: written by this machine, by a process that is
+     * gone. An unreadable owner file is not proof -- it is also what a lock looks like in the instant
+     * between creating the directory and recording its owner.
+     */
+    async lockOwnerCrashed(lockDirectory) {
+        let owner;
+        try {
+            owner = JSON.parse(await readFile(path.join(lockDirectory, "owner.json"), "utf8"));
+        }
+        catch {
+            return false;
+        }
+        // Records written before owners carried a hostname fall back to the process check. Treating them
+        // as foreign instead would strand a crashed holder's lock for the full stale timeout.
+        if (owner.host !== undefined && owner.host !== hostname())
+            return false;
+        if (!Number.isInteger(owner.pid) || owner.pid <= 0)
+            return false;
+        try {
+            process.kill(owner.pid, 0);
+            return false;
+        }
+        catch (error) {
+            return error.code !== "EPERM";
+        }
+    }
+    async atomicWrite(target, value) {
+        await mkdir(path.dirname(target), { recursive: true });
+        const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
+        await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+        await rename(temporary, target);
+    }
+}
+function safeName(value) {
+    const readable = value.replace(/[^a-zA-Z0-9._-]/gu, "-").slice(0, 96);
+    const digest = createHash("sha256").update(value).digest("hex").slice(0, 12);
+    return `${readable || "record"}-${digest}`;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,219 @@
+export declare const STATE_VERSION: 1;
+export declare const CONFIG_VERSION: 1;
+export type UnexpectedPathPolicy = "error" | "warn" | "allow";
+export type PublishMode = "none" | "branch" | "pull-request";
+export type HistoryMode = "preserve" | "squash";
+export type MergeMethod = "squash" | "merge" | "rebase";
+export type TaskStatus = "registered" | "claimed" | "submitted" | "integrating" | "batched" | "published" | "merged" | "failed" | "cancelled";
+export type BatchStatus = "running" | "verified" | "prepared" | "published" | "merged" | "closed" | "failed";
+export interface ValidatorConfig {
+    name: string;
+    command: string;
+    paths?: string[];
+    timeoutSeconds?: number;
+    env?: Record<string, string>;
+}
+export interface BrokerConfig {
+    version: typeof CONFIG_VERSION;
+    baseBranch: string;
+    baseRef: string;
+    remote: string;
+    stateDirectory: string;
+    leases: {
+        ttlSeconds: number;
+        lockTimeoutSeconds: number;
+        serializedPatterns: string[];
+    };
+    policies: {
+        unexpectedPaths: UnexpectedPathPolicy;
+        requireCleanWorktree: boolean;
+        requireDependencies: boolean;
+    };
+    scheduling: {
+        maxTasks: number;
+        maxCommits: number;
+        maxWaitSeconds: number;
+        allowPathOverlap: boolean;
+    };
+    integration: {
+        branchPrefix: string;
+        history: HistoryMode;
+        keepFailedWorktrees: boolean;
+        refreshBase: boolean;
+        maxAttempts: number;
+        provenance?: {
+            enabled: boolean;
+            directory: string;
+        };
+    };
+    validation: {
+        shell?: string;
+        focused: ValidatorConfig[];
+        authoritative: ValidatorConfig[];
+    };
+    publish: {
+        mode: PublishMode;
+        draft: boolean;
+        autoMerge: boolean;
+        mergeMethod: MergeMethod;
+        labels: string[];
+        titleTemplate: string;
+    };
+}
+export interface LeaseRecord {
+    tokenHash: string;
+    holder: string;
+    acquiredAt: string;
+    heartbeatAt: string;
+    expiresAt: string;
+}
+export interface ValidationResult {
+    name: string;
+    command: string;
+    scope: "focused" | "authoritative";
+    taskId?: string;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface TaskRecord {
+    id: string;
+    title?: string;
+    agent?: string;
+    status: TaskStatus;
+    priority: number;
+    baseSha: string;
+    expectedPaths: string[];
+    actualPaths: string[];
+    dependsOn: string[];
+    commits: string[];
+    worktree?: string;
+    lease?: LeaseRecord;
+    warnings: string[];
+    validations: ValidationResult[];
+    createdAt: string;
+    updatedAt: string;
+    submittedAt?: string;
+    batchedAt?: string;
+    publishedAt?: string;
+    mergedAt?: string;
+    batchId?: string;
+    lastError?: string;
+    attempts?: number;
+}
+export interface BatchRecord {
+    id: string;
+    status: BatchStatus;
+    taskIds: string[];
+    baseBranch: string;
+    baseSha: string;
+    branchName?: string;
+    headSha?: string;
+    integratedHeadSha?: string;
+    provenancePath?: string;
+    worktree?: string;
+    validations: ValidationResult[];
+    createdAt: string;
+    finishedAt?: string;
+    publishedAt?: string;
+    pullRequestUrl?: string;
+    autoMergeEnabled?: boolean;
+    closedAt?: string;
+    error?: string;
+}
+export interface BatchProvenance {
+    version: 1;
+    generator: "agent-merge-broker";
+    batchId: string;
+    baseBranch: string;
+    /**
+     * How the batch was assembled. Squashing replaces the cherry-pick trail, so a verifier cannot
+     * look for submitted commits in the integrated history. Absent on manifests written before this
+     * field existed, which were always assembled with preserved history.
+     */
+    history?: HistoryMode;
+    baseSha: string;
+    integratedHeadSha: string;
+    taskIds: string[];
+    tasks: Array<{
+        id: string;
+        commits: string[];
+        actualPaths: string[];
+        dependsOn: string[];
+    }>;
+    validations: Array<{
+        name: string;
+        scope: "focused" | "authoritative";
+        taskId?: string;
+        exitCode: number;
+        durationMs: number;
+    }>;
+    createdAt: string;
+}
+export interface AuditEvent {
+    sequence: number;
+    at: string;
+    event: string;
+    actor?: string;
+    taskId?: string;
+    batchId?: string;
+    details?: Record<string, unknown>;
+}
+export interface BrokerState {
+    version: typeof STATE_VERSION;
+    sequence: number;
+    tasks: Record<string, TaskRecord>;
+    batches: Record<string, BatchRecord>;
+}
+export interface CommitReceipt {
+    version: 1;
+    taskId: string;
+    agent?: string;
+    baseSha: string;
+    commits: string[];
+    expectedPaths: string[];
+    actualPaths: string[];
+    dependsOn: string[];
+    worktree?: string;
+    submittedAt: string;
+    warnings: string[];
+}
+export interface ScheduleRejection {
+    taskId: string;
+    reason: string;
+    conflictsWith?: string;
+}
+export interface SchedulePlan {
+    selected: TaskRecord[];
+    rejected: ScheduleRejection[];
+    totalCommits: number;
+}
+export interface IntegrationOptions {
+    dryRun?: boolean;
+    publish?: boolean;
+    taskIds?: string[];
+    maxTasks?: number;
+}
+export interface IntegrationResult {
+    batch: BatchRecord;
+    selected: string[];
+    rejected: ScheduleRejection[];
+    dryRun: boolean;
+}
+export interface PruneOptions {
+    olderThanDays?: number;
+    dryRun?: boolean;
+}
+export interface PruneResult {
+    tasks: string[];
+    batches: string[];
+    /** Completed tasks kept because a retained task still declares them as a dependency. */
+    retainedForDependencies: string[];
+    cutoff: string;
+    archivePath?: string;
+    dryRun: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+export const STATE_VERSION = 1;
+export const CONFIG_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,13 @@
+import type { ValidationResult, ValidatorConfig } from "./types.js";
+export declare function runValidators(options: {
+    validators: ValidatorConfig[];
+    scope: "focused" | "authoritative";
+    cwd: string;
+    taskId?: string;
+    files: string[];
+    baseSha: string;
+    headSha: string;
+    batchId: string;
+    shell?: string;
+}): Promise<ValidationResult[]>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgCpE,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,EAAE,SAAS,GAAG,eAAe,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkD9B"}