agent-merge-broker 0.3.0

package/dist/config.js

@@ -0,0 +1,312 @@
+import path from "node:path";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { constants } from "node:fs";
+import { BrokerError } from "./errors.js";
+import { CONFIG_VERSION } from "./types.js";
+export const CONFIG_DIRECTORY = ".merge-broker";
+export const CONFIG_FILENAME = "config.json";
+export const AGENT_INSTRUCTIONS_FILENAME = "agent-instructions.md";
+const AGENT_INSTRUCTIONS = `# Merge Broker agent contract
+
+This repository coordinates parallel work with Agent Merge Broker.
+
+1. Claim a task and declare the smallest accurate path scope before editing:
+   \`merge-broker task claim <task-id> --holder <agent> --path 'src/area/**'\`
+2. Heartbeat long-running work with \`merge-broker task heartbeat <task-id>\`. The broker holds the
+   lease token for you; pass \`--token\` only when working from another machine.
+3. Work only inside the declared scope. Coordinate a new claim before expanding it.
+4. Commit the completed, focused change. Agents do not merge, rebase, push, or administer branches.
+5. Submit immutable commits to the broker:
+   \`merge-broker task submit <task-id> --since-base\`
+6. Report the task ID, commit SHA, changed paths, and validation performed.
+
+The broker owns integration ordering, conflict resolution requests, validation, batching, and publication.
+`;
+export function defaultConfig(baseBranch = "main", remote = "origin", baseRef = baseBranch) {
+    return {
+        version: CONFIG_VERSION,
+        baseBranch,
+        baseRef,
+        remote,
+        stateDirectory: "merge-broker",
+        leases: {
+            ttlSeconds: 1_800,
+            lockTimeoutSeconds: 15,
+            serializedPatterns: [
+                "package-lock.json",
+                "pnpm-lock.yaml",
+                "yarn.lock",
+            ],
+        },
+        policies: {
+            unexpectedPaths: "error",
+            requireCleanWorktree: false,
+            requireDependencies: true,
+        },
+        scheduling: {
+            maxTasks: 6,
+            maxCommits: 12,
+            maxWaitSeconds: 600,
+            allowPathOverlap: false,
+        },
+        integration: {
+            branchPrefix: "merge-broker/",
+            history: "preserve",
+            keepFailedWorktrees: false,
+            refreshBase: true,
+            maxAttempts: 3,
+            provenance: {
+                enabled: true,
+                directory: ".merge-broker/attestations",
+            },
+        },
+        validation: {
+            focused: [],
+            authoritative: [],
+        },
+        publish: {
+            mode: "none",
+            draft: false,
+            autoMerge: true,
+            mergeMethod: "squash",
+            labels: [],
+            titleTemplate: "Integration batch {batchId}",
+        },
+    };
+}
+async function exists(file) {
+    try {
+        await access(file, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function configPath(repoRoot) {
+    return path.join(repoRoot, CONFIG_DIRECTORY, CONFIG_FILENAME);
+}
+export async function initializeConfig(repoRoot, options = {}) {
+    const target = configPath(repoRoot);
+    if ((await exists(target)) && !options.force) {
+        const instructions = path.join(path.dirname(target), AGENT_INSTRUCTIONS_FILENAME);
+        if (!(await exists(instructions)))
+            await writeFile(instructions, AGENT_INSTRUCTIONS, "utf8");
+        return { path: target, config: await loadConfig(repoRoot), created: false };
+    }
+    const config = defaultConfig(options.baseBranch, options.remote, options.baseRef);
+    await mkdir(path.dirname(target), { recursive: true });
+    await writeFile(target, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    const instructions = path.join(path.dirname(target), AGENT_INSTRUCTIONS_FILENAME);
+    if (!(await exists(instructions)))
+        await writeFile(instructions, AGENT_INSTRUCTIONS, "utf8");
+    return { path: target, config, created: true };
+}
+function assertString(value, key) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new BrokerError("INVALID_CONFIG", `Configuration field ${key} must be a non-empty string.`);
+    }
+}
+function assertPositiveInteger(value, key) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new BrokerError("INVALID_CONFIG", `Configuration field ${key} must be a positive integer.`);
+    }
+}
+function assertBoolean(value, key) {
+    if (typeof value !== "boolean") {
+        throw new BrokerError("INVALID_CONFIG", `Configuration field ${key} must be a boolean.`);
+    }
+}
+function assertStringArray(value, key) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item.trim() === "")) {
+        throw new BrokerError("INVALID_CONFIG", `Configuration field ${key} must be an array of non-empty strings.`);
+    }
+}
+function assertAllowedKeys(value, key, allowed) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new BrokerError("INVALID_CONFIG", `Configuration field ${key} must be an object.`);
+    }
+    const unexpected = Object.keys(value).filter((item) => !allowed.includes(item));
+    if (unexpected.length > 0) {
+        throw new BrokerError("INVALID_CONFIG", `Unknown configuration field(s) in ${key}: ${unexpected.join(", ")}.`);
+    }
+}
+function assertSafeGitName(value, key, allowTrailingSlash = false) {
+    const candidate = allowTrailingSlash ? value.replace(/\/+$/u, "") : value;
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9._/-]*$/u.test(candidate) ||
+        candidate.includes("..") ||
+        candidate.includes("//") ||
+        candidate.endsWith(".") ||
+        (!allowTrailingSlash && candidate.endsWith("/"))) {
+        throw new BrokerError("INVALID_CONFIG", `Configuration field ${key} is not a safe Git name.`);
+    }
+}
+export function validateConfig(value) {
+    if (!value || typeof value !== "object") {
+        throw new BrokerError("INVALID_CONFIG", "Configuration must be a JSON object.");
+    }
+    const config = value;
+    assertAllowedKeys(config, "root", [
+        "version",
+        "baseBranch",
+        "baseRef",
+        "remote",
+        "stateDirectory",
+        "leases",
+        "policies",
+        "scheduling",
+        "integration",
+        "validation",
+        "publish",
+    ]);
+    if (config.version !== CONFIG_VERSION) {
+        throw new BrokerError("INVALID_CONFIG", `Unsupported configuration version: ${String(config.version)}`);
+    }
+    assertString(config.baseBranch, "baseBranch");
+    assertString(config.baseRef, "baseRef");
+    assertString(config.remote, "remote");
+    assertSafeGitName(config.baseBranch, "baseBranch");
+    assertSafeGitName(config.baseRef, "baseRef");
+    assertSafeGitName(config.remote, "remote");
+    assertString(config.stateDirectory, "stateDirectory");
+    if (path.isAbsolute(config.stateDirectory) ||
+        config.stateDirectory === "." ||
+        config.stateDirectory.split(/[\\/]/u).some((part) => part === "..") ||
+        new Set(["branches", "hooks", "info", "logs", "objects", "refs", "worktrees"]).has(config.stateDirectory.split(/[\\/]/u)[0] ?? "")) {
+        throw new BrokerError("INVALID_CONFIG", "stateDirectory must stay inside Git's common directory.");
+    }
+    assertAllowedKeys(config.leases, "leases", ["ttlSeconds", "lockTimeoutSeconds", "serializedPatterns"]);
+    assertPositiveInteger(config.leases?.ttlSeconds, "leases.ttlSeconds");
+    assertPositiveInteger(config.leases?.lockTimeoutSeconds, "leases.lockTimeoutSeconds");
+    assertStringArray(config.leases?.serializedPatterns, "leases.serializedPatterns");
+    assertAllowedKeys(config.policies, "policies", [
+        "unexpectedPaths",
+        "requireCleanWorktree",
+        "requireDependencies",
+    ]);
+    if (config.policies?.unexpectedPaths !== "error" &&
+        config.policies?.unexpectedPaths !== "warn" &&
+        config.policies?.unexpectedPaths !== "allow") {
+        throw new BrokerError("INVALID_CONFIG", "policies.unexpectedPaths must be error, warn, or allow.");
+    }
+    assertBoolean(config.policies?.requireCleanWorktree, "policies.requireCleanWorktree");
+    assertBoolean(config.policies?.requireDependencies, "policies.requireDependencies");
+    assertAllowedKeys(config.scheduling, "scheduling", [
+        "maxTasks",
+        "maxCommits",
+        "maxWaitSeconds",
+        "allowPathOverlap",
+    ]);
+    assertPositiveInteger(config.scheduling?.maxTasks, "scheduling.maxTasks");
+    assertPositiveInteger(config.scheduling?.maxCommits, "scheduling.maxCommits");
+    assertPositiveInteger(config.scheduling?.maxWaitSeconds, "scheduling.maxWaitSeconds");
+    assertBoolean(config.scheduling?.allowPathOverlap, "scheduling.allowPathOverlap");
+    assertAllowedKeys(config.integration, "integration", [
+        "branchPrefix",
+        "history",
+        "keepFailedWorktrees",
+        "refreshBase",
+        "maxAttempts",
+        "provenance",
+    ]);
+    assertString(config.integration?.branchPrefix, "integration.branchPrefix");
+    assertSafeGitName(config.integration.branchPrefix, "integration.branchPrefix", true);
+    if (!["preserve", "squash"].includes(config.integration?.history)) {
+        throw new BrokerError("INVALID_CONFIG", "integration.history must be preserve or squash.");
+    }
+    assertBoolean(config.integration?.keepFailedWorktrees, "integration.keepFailedWorktrees");
+    config.integration.refreshBase ??= true;
+    config.integration.maxAttempts ??= 3;
+    assertBoolean(config.integration.refreshBase, "integration.refreshBase");
+    assertPositiveInteger(config.integration.maxAttempts, "integration.maxAttempts");
+    if (config.integration.provenance !== undefined) {
+        assertAllowedKeys(config.integration.provenance, "integration.provenance", ["enabled", "directory"]);
+        assertBoolean(config.integration.provenance.enabled, "integration.provenance.enabled");
+        assertString(config.integration.provenance.directory, "integration.provenance.directory");
+        const directory = config.integration.provenance.directory.replaceAll("\\", "/");
+        if (path.isAbsolute(directory) ||
+            directory === "." ||
+            directory.split("/").some((part) => part === ".." || part === ".git")) {
+            throw new BrokerError("INVALID_CONFIG", "integration.provenance.directory must be a safe repository-relative directory.");
+        }
+    }
+    assertAllowedKeys(config.validation, "validation", ["shell", "focused", "authoritative"]);
+    if (!Array.isArray(config.validation.focused) || !Array.isArray(config.validation.authoritative)) {
+        throw new BrokerError("INVALID_CONFIG", "validation.focused and validation.authoritative must be arrays.");
+    }
+    if (config.validation.shell !== undefined)
+        assertString(config.validation.shell, "validation.shell");
+    assertAllowedKeys(config.publish, "publish", [
+        "mode",
+        "draft",
+        "autoMerge",
+        "mergeMethod",
+        "labels",
+        "titleTemplate",
+    ]);
+    if (!["none", "branch", "pull-request"].includes(config.publish?.mode)) {
+        throw new BrokerError("INVALID_CONFIG", "publish.mode must be none, branch, or pull-request.");
+    }
+    assertBoolean(config.publish?.draft, "publish.draft");
+    // Absent on configurations written before auto-merge existed. Defaulting to false keeps an
+    // upgrade from silently starting to land agent work on the base branch.
+    config.publish.autoMerge ??= false;
+    config.publish.mergeMethod ??= "squash";
+    assertBoolean(config.publish.autoMerge, "publish.autoMerge");
+    if (!["squash", "merge", "rebase"].includes(config.publish.mergeMethod)) {
+        throw new BrokerError("INVALID_CONFIG", "publish.mergeMethod must be squash, merge, or rebase.");
+    }
+    if (config.publish.autoMerge && config.publish.draft) {
+        throw new BrokerError("INVALID_CONFIG", "publish.autoMerge cannot be combined with publish.draft: GitHub refuses to merge a draft pull request.");
+    }
+    // "none" is the generated default and simply means publishing is not enabled yet, so auto-merge
+    // is allowed to sit there as declared intent. "branch" mode has no pull request to merge.
+    if (config.publish.autoMerge && config.publish.mode === "branch") {
+        throw new BrokerError("INVALID_CONFIG", "publish.autoMerge has no effect in branch mode: set publish.mode to pull-request.");
+    }
+    assertStringArray(config.publish?.labels, "publish.labels");
+    assertString(config.publish?.titleTemplate, "publish.titleTemplate");
+    for (const [scope, validators] of Object.entries(config.validation ?? {})) {
+        if (scope === "shell")
+            continue;
+        if (!Array.isArray(validators)) {
+            throw new BrokerError("INVALID_CONFIG", `validation.${scope} must be an array.`);
+        }
+        for (const validator of validators) {
+            assertAllowedKeys(validator, `validation.${scope}[]`, ["name", "command", "paths", "timeoutSeconds", "env"]);
+            assertString(validator.name, `validation.${scope}.name`);
+            assertString(validator.command, `validation.${scope}.command`);
+            if (validator.paths !== undefined)
+                assertStringArray(validator.paths, `validation.${scope}.paths`);
+            if (validator.timeoutSeconds !== undefined) {
+                assertPositiveInteger(validator.timeoutSeconds, `validation.${scope}.timeoutSeconds`);
+            }
+            if (validator.env !== undefined &&
+                (typeof validator.env !== "object" ||
+                    validator.env === null ||
+                    Object.values(validator.env).some((item) => typeof item !== "string"))) {
+                throw new BrokerError("INVALID_CONFIG", `validation.${scope}.env must contain only string values.`);
+            }
+        }
+    }
+    return config;
+}
+export async function loadConfig(repoRoot) {
+    const target = configPath(repoRoot);
+    let source;
+    try {
+        source = await readFile(target, "utf8");
+    }
+    catch (error) {
+        throw new BrokerError("NOT_INITIALIZED", `Merge Broker is not initialized. Run \"merge-broker init\" in ${repoRoot}.`, { cause: error instanceof Error ? error.message : String(error) });
+    }
+    try {
+        return validateConfig(JSON.parse(source));
+    }
+    catch (error) {
+        if (error instanceof BrokerError)
+            throw error;
+        throw new BrokerError("INVALID_CONFIG", `Could not parse ${target}: ${String(error)}`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class BrokerError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+export declare class CommandError extends BrokerError {
+    readonly command: string;
+    readonly exitCode: number;
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(command: string, exitCode: number, stdout: string, stderr: string);
+}
+export declare class ValidationError extends BrokerError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAE1C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM7E;AAED,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAa9E;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D"}

package/dist/errors.js

@@ -0,0 +1,36 @@
+export class BrokerError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "BrokerError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export class CommandError extends BrokerError {
+    command;
+    exitCode;
+    stdout;
+    stderr;
+    constructor(command, exitCode, stdout, stderr) {
+        super("COMMAND_FAILED", `Command failed (${exitCode}): ${command}`, {
+            command,
+            exitCode,
+            stdout,
+            stderr,
+        });
+        this.name = "CommandError";
+        this.command = command;
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+export class ValidationError extends BrokerError {
+    constructor(message, details) {
+        super("VALIDATION_FAILED", message, details);
+        this.name = "ValidationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAS;IACb,OAAO,CAAsC;IAEtD,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiC;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,WAAW;IAClC,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,MAAM,CAAS;IACf,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc,EAAE,MAAc;QAC3E,KAAK,CAAC,gBAAgB,EAAE,mBAAmB,QAAQ,MAAM,OAAO,EAAE,EAAE;YAClE,OAAO;YACP,QAAQ;YACR,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,mBAAmB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/git.d.ts

@@ -0,0 +1,46 @@
+import { type CommandResult } from "./process.js";
+export interface WorktreeInfo {
+    path: string;
+    head: string;
+    branch?: string;
+    bare: boolean;
+    detached: boolean;
+    prunable: boolean;
+}
+export declare class GitRepository {
+    readonly root: string;
+    readonly commonGitDir: string;
+    private constructor();
+    static discover(cwd?: string): Promise<GitRepository>;
+    git(args: string[], cwd?: string, allowFailure?: boolean): Promise<CommandResult>;
+    resolveCommit(revision: string): Promise<string>;
+    currentHead(cwd?: string): Promise<string>;
+    resolveCommitAt(revision: string, cwd: string): Promise<string>;
+    changedFiles(commit: string): Promise<string[]>;
+    changedFilesForCommits(commits: string[]): Promise<string[]>;
+    changedFilesBetween(base: string, head: string): Promise<string[]>;
+    /**
+     * Linear commits on HEAD after `base`, oldest first. `git cherry` compares patch identities, so a
+     * change already contained in the base under a different SHA -- the ordinary result of a rebase --
+     * is not submitted a second time.
+     */
+    commitsSinceBase(cwd: string, base: string): Promise<string[]>;
+    parentCount(commit: string): Promise<number>;
+    isClean(cwd?: string): Promise<boolean>;
+    addDetachedWorktree(destination: string, startPoint: string): Promise<void>;
+    removeWorktree(destination: string): Promise<void>;
+    cherryPick(cwd: string, commit: string): Promise<CommandResult>;
+    abortCherryPick(cwd: string): Promise<void>;
+    createBranch(name: string, commit: string): Promise<void>;
+    deleteBranch(name: string): Promise<void>;
+    squash(cwd: string, baseSha: string, message: string): Promise<string>;
+    /**
+     * Best-effort refresh of the remote-tracking base. Integration must still work in a repository
+     * with no remote or no network, so a failed fetch is reported rather than thrown.
+     */
+    fetchBranch(remote: string, branch: string): Promise<boolean>;
+    commitGeneratedFile(cwd: string, relativePath: string, contents: string, message: string): Promise<string>;
+    push(remote: string, branch: string): Promise<void>;
+    listWorktrees(): Promise<WorktreeInfo[]>;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,OAAO;WAKM,QAAQ,CAAC,GAAG,SAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAS5D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAY,EAAE,YAAY,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAIlF,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAehD,WAAW,CAAC,GAAG,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY/D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO/C,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ5D,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUxE;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe9D,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5C,OAAO,CAAC,GAAG,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAK1C,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3E,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5E;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7D,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAaZ,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;CAoC/C"}

package/dist/git.js

@@ -0,0 +1,195 @@
+import path from "node:path";
+import { mkdir, writeFile } from "node:fs/promises";
+import { BrokerError } from "./errors.js";
+import { runCommand } from "./process.js";
+function splitNull(value) {
+    return value.split("\0").map((part) => part.trim()).filter(Boolean);
+}
+export class GitRepository {
+    root;
+    commonGitDir;
+    constructor(root, commonGitDir) {
+        this.root = root;
+        this.commonGitDir = commonGitDir;
+    }
+    static async discover(cwd = process.cwd()) {
+        const top = await runCommand("git", ["rev-parse", "--show-toplevel"], { cwd });
+        const root = path.resolve(top.stdout.trim());
+        const common = await runCommand("git", ["rev-parse", "--path-format=absolute", "--git-common-dir"], {
+            cwd: root,
+        });
+        return new GitRepository(root, path.resolve(common.stdout.trim()));
+    }
+    async git(args, cwd = this.root, allowFailure = false) {
+        return await runCommand("git", args, { cwd, allowFailure });
+    }
+    async resolveCommit(revision) {
+        const result = await this.git(["rev-parse", "--verify", "--end-of-options", `${revision}^{commit}`], this.root, true);
+        if (result.exitCode !== 0) {
+            throw new BrokerError("UNKNOWN_COMMIT", `Git revision is not a commit: ${revision}`, {
+                revision,
+                stderr: result.stderr,
+            });
+        }
+        return result.stdout.trim();
+    }
+    async currentHead(cwd = this.root) {
+        return await this.resolveCommitAt("HEAD", cwd);
+    }
+    async resolveCommitAt(revision, cwd) {
+        const result = await this.git(["rev-parse", "--verify", "--end-of-options", `${revision}^{commit}`], cwd, true);
+        if (result.exitCode !== 0) {
+            throw new BrokerError("UNKNOWN_COMMIT", `Git revision is not a commit: ${revision}`, {
+                revision,
+                cwd,
+                stderr: result.stderr,
+            });
+        }
+        return result.stdout.trim();
+    }
+    async changedFiles(commit) {
+        const result = await this.git(["diff-tree", "--root", "--no-commit-id", "--name-only", "-r", "-z", commit]);
+        return [...new Set(splitNull(result.stdout))].sort();
+    }
+    async changedFilesForCommits(commits) {
+        const files = new Set();
+        for (const commit of commits) {
+            for (const file of await this.changedFiles(commit))
+                files.add(file);
+        }
+        return [...files].sort();
+    }
+    async changedFilesBetween(base, head) {
+        const result = await this.git([
+            "diff",
+            "--name-only",
+            "-z",
+            `${base}..${head}`,
+        ]);
+        return [...new Set(splitNull(result.stdout))].sort();
+    }
+    /**
+     * Linear commits on HEAD after `base`, oldest first. `git cherry` compares patch identities, so a
+     * change already contained in the base under a different SHA -- the ordinary result of a rebase --
+     * is not submitted a second time.
+     */
+    async commitsSinceBase(cwd, base) {
+        const cherry = await this.git(["cherry", base, "HEAD"], cwd);
+        const notUpstream = new Set(cherry.stdout
+            .split("\n")
+            .filter((line) => line.startsWith("+ "))
+            .map((line) => line.slice(2).trim()));
+        const listed = await this.git(["rev-list", "--reverse", "--no-merges", `${base}..HEAD`], cwd);
+        return listed.stdout
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((commit) => commit !== "" && notUpstream.has(commit));
+    }
+    async parentCount(commit) {
+        const result = await this.git(["rev-list", "--parents", "-n", "1", commit]);
+        return Math.max(0, result.stdout.trim().split(/\s+/u).length - 1);
+    }
+    async isClean(cwd = this.root) {
+        const result = await this.git(["status", "--porcelain=v1", "-z"], cwd);
+        return result.stdout.length === 0;
+    }
+    async addDetachedWorktree(destination, startPoint) {
+        await mkdir(path.dirname(destination), { recursive: true });
+        await this.git(["worktree", "add", "--detach", destination, startPoint]);
+    }
+    async removeWorktree(destination) {
+        const result = await this.git(["worktree", "remove", "--force", destination], this.root, true);
+        if (result.exitCode !== 0) {
+            await this.git(["worktree", "prune"], this.root, true);
+            throw new BrokerError("WORKTREE_REMOVE_FAILED", `Could not remove integration worktree: ${destination}`, {
+                stderr: result.stderr,
+            });
+        }
+    }
+    async cherryPick(cwd, commit) {
+        return await this.git(["cherry-pick", "-x", commit], cwd, true);
+    }
+    async abortCherryPick(cwd) {
+        await this.git(["cherry-pick", "--abort"], cwd, true);
+    }
+    async createBranch(name, commit) {
+        const exists = await this.git(["show-ref", "--verify", "--quiet", `refs/heads/${name}`], this.root, true);
+        if (exists.exitCode === 0) {
+            throw new BrokerError("BRANCH_EXISTS", `Integration branch already exists: ${name}`);
+        }
+        await this.git(["branch", "--", name, commit]);
+    }
+    async deleteBranch(name) {
+        await this.git(["branch", "-D", "--", name], this.root, true);
+    }
+    async squash(cwd, baseSha, message) {
+        await this.git(["reset", "--soft", baseSha], cwd);
+        await this.git(["commit", "-m", message], cwd);
+        return await this.currentHead(cwd);
+    }
+    /**
+     * Best-effort refresh of the remote-tracking base. Integration must still work in a repository
+     * with no remote or no network, so a failed fetch is reported rather than thrown.
+     */
+    async fetchBranch(remote, branch) {
+        const result = await this.git(["fetch", "--quiet", "--", remote, branch], this.root, true);
+        return result.exitCode === 0;
+    }
+    async commitGeneratedFile(cwd, relativePath, contents, message) {
+        const target = path.resolve(cwd, relativePath);
+        const relative = path.relative(cwd, target);
+        if (relative.startsWith("..") || path.isAbsolute(relative)) {
+            throw new BrokerError("UNSAFE_PATH", `Generated file escapes the integration worktree: ${relativePath}`);
+        }
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, contents, "utf8");
+        await this.git(["add", "--", relativePath], cwd);
+        await this.git(["commit", "-m", message], cwd);
+        return await this.currentHead(cwd);
+    }
+    async push(remote, branch) {
+        await this.git(["push", "--set-upstream", "--", remote, `refs/heads/${branch}:refs/heads/${branch}`], this.root);
+    }
+    async listWorktrees() {
+        const result = await this.git(["worktree", "list", "--porcelain"]);
+        const records = [];
+        let current = {};
+        const flush = () => {
+            if (current.path && current.head) {
+                records.push({
+                    path: current.path,
+                    head: current.head,
+                    ...(current.branch ? { branch: current.branch } : {}),
+                    bare: current.bare ?? false,
+                    detached: current.detached ?? false,
+                    prunable: current.prunable ?? false,
+                });
+            }
+            current = {};
+        };
+        for (const line of result.stdout.split("\n")) {
+            if (!line) {
+                flush();
+                continue;
+            }
+            const separator = line.indexOf(" ");
+            const key = separator === -1 ? line : line.slice(0, separator);
+            const value = separator === -1 ? "" : line.slice(separator + 1);
+            if (key === "worktree")
+                current.path = value;
+            else if (key === "HEAD")
+                current.head = value;
+            else if (key === "branch")
+                current.branch = value.replace(/^refs\/heads\//u, "");
+            else if (key === "bare")
+                current.bare = true;
+            else if (key === "detached")
+                current.detached = true;
+            else if (key === "prunable")
+                current.prunable = true;
+        }
+        flush();
+        return records;
+    }
+}
+//# sourceMappingURL=git.js.map