@openagt/skill-branches 0.1.0 → 0.1.2

package/dist/git.js

@@ -1,164 +0,0 @@
-/**
- * Running git: one `execFile`-backed runner with a per-subcommand timeout, and the two readings
- * of a failed invocation every caller wants — was it a timeout kill, and which line is worth
- * showing.
- */
-/**
- * A local read: the index, a ref, or objects already on disk. Kept at the budget that used to
- * cover everything, so a hung read still fails fast instead of holding the caller longer (#997).
- */
-export const GIT_READ_TIMEOUT_MS = 10_000;
-/** A local mutation. Bounded by disk, but an index write on a large repo outlives a read. */
-export const GIT_WRITE_TIMEOUT_MS = 30_000;
-/**
- * The network, or a whole checkout. `git worktree add` writes every tracked file and `git push`
- * uploads a packfile; on a large repo both routinely pass 10s, which is what #997 is about.
- */
-export const GIT_SLOW_TIMEOUT_MS = 120_000;
-/** Subcommands that only read. Everything unlisted is treated as a mutation. */
-const GIT_READ_OPS = new Set([
-    'branch',
-    'cat-file',
-    'diff',
-    'for-each-ref',
-    'log',
-    'ls-files',
-    'merge-base',
-    'remote',
-    'rev-list',
-    'rev-parse',
-    'show',
-    'show-ref',
-    'status',
-    'symbolic-ref',
-]);
-/** Subcommands bounded by the network rather than by this machine. */
-const GIT_SLOW_OPS = new Set(['clone', 'fetch', 'pull', 'push', 'ls-remote']);
-/** `git branch` flags that only list or query; any other `branch` invocation writes a ref. */
-const GIT_BRANCH_READ_FLAGS = new Set(['--list', '-l', '--contains', '--no-contains', '--merged', '--no-merged', '--points-at', '--show-current', '-r', '--remotes', '-a', '--all', '-v', '-vv', '--verbose']);
-/** Global options whose value is the next word, so that word is not the subcommand. */
-const GIT_GLOBAL_VALUE_OPTIONS = new Set(['-C', '-c', '--git-dir', '--work-tree', '--namespace', '--exec-path']);
-/**
- * The subcommand and its own words, with the leading global options dropped. A bare flag filter
- * would read `git -C /repo push` as the subcommand `/repo`, costing `push` its slow budget.
- */
-function gitWords(args) {
-    let i = 0;
-    while (i < args.length) {
-        const arg = args[i] ?? '';
-        if (!arg.startsWith('-'))
-            break;
-        // The `--opt=value` form carries its value inline; the separate form eats the next word.
-        i += GIT_GLOBAL_VALUE_OPTIONS.has(arg) ? 2 : 1;
-    }
-    return args.slice(i).filter(arg => !arg.startsWith('-'));
-}
-/**
- * The timeout for one git invocation, chosen by subcommand (#997). One flat 10s budget once
- * covered every call site, so the slowest two ran under what is really a read's budget: a
- * SIGTERM'd `worktree add` drops an agent into the user's main checkout, a SIGTERM'd `push` may
- * have half-landed.
- */
-export function gitTimeoutMs(args) {
-    const words = gitWords(args);
-    const op = words[0] ?? '';
-    if (GIT_SLOW_OPS.has(op))
-        return GIT_SLOW_TIMEOUT_MS;
-    if (op === 'worktree') {
-        // Only `add` writes a checkout; `list` is a read, and remove/prune are ordinary mutations.
-        if (words[1] === 'add')
-            return GIT_SLOW_TIMEOUT_MS;
-        return words[1] === 'list' ? GIT_READ_TIMEOUT_MS : GIT_WRITE_TIMEOUT_MS;
-    }
-    if (op === 'branch') {
-        // A bare `branch` or one carrying a listing flag reads; `-D`, `-m`, or `branch <new> [start]` writes a ref.
-        const flags = args.filter(arg => arg.startsWith('-'));
-        const reads = words.length === 1 || flags.some(flag => GIT_BRANCH_READ_FLAGS.has(flag));
-        return reads && !flags.some(flag => !GIT_BRANCH_READ_FLAGS.has(flag) && !flag.startsWith('--format')) ? GIT_READ_TIMEOUT_MS : GIT_WRITE_TIMEOUT_MS;
-    }
-    return GIT_READ_OPS.has(op) ? GIT_READ_TIMEOUT_MS : GIT_WRITE_TIMEOUT_MS;
-}
-/**
- * A git killed for outrunning its timeout, as opposed to one git itself rejected (#997).
- *
- * `execFile` SIGTERMs on timeout, and a killed `git push` usually writes nothing to stderr, so
- * without this the failure surfaces as a bare "Command failed: git push ..." that reads like a
- * rejected push. The `timedOut` brand is what a caller across a package boundary checks.
- */
-export class GitTimeoutError extends Error {
-    args;
-    timeoutMs;
-    timedOut = true;
-    constructor(args, timeoutMs) {
-        super(`git ${args.join(' ')} timed out after ${timeoutMs}ms`);
-        this.args = args;
-        this.timeoutMs = timeoutMs;
-        this.name = 'GitTimeoutError';
-    }
-}
-/** True when a {@link GitRunner} rejection is a timeout kill rather than a non-zero exit. */
-export function isGitTimeout(err) {
-    return err instanceof Error && err.timedOut === true;
-}
-/**
- * A {@link GitRunner} backed by `execFile('git', ...)`. Rejects on any git error, and with a
- * {@link GitTimeoutError} when the operation outran its {@link gitTimeoutMs} budget.
- *
- * The buffer is raised well past the default because a repo crawl (`git ls-files`) prints a
- * line per file, and a large checkout overruns it.
- */
-export function nodeGitRunner() {
-    return async (args, cwd) => {
-        const { execFile } = await import('node:child_process');
-        const timeoutMs = gitTimeoutMs(args);
-        return new Promise((resolvePromise, rejectPromise) => {
-            execFile('git', args, { cwd, timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024 }, (err, stdout) => {
-                if (!err)
-                    return resolvePromise(String(stdout));
-                // execFile kills on both timeout and a maxBuffer overrun; only the latter carries ENOBUFS.
-                const killed = err.killed === true;
-                if (killed && err.code !== 'ENOBUFS') {
-                    return rejectPromise(new GitTimeoutError(args, timeoutMs));
-                }
-                rejectPromise(err);
-            });
-        });
-    };
-}
-/**
- * Whether `cwd` sits inside a git working tree (#997). Lets a caller tell "this project cannot
- * host a worktree at all" from "git was there and the operation failed", which are the same
- * rejection out of `git worktree add` but call for opposite handling.
- *
- * Forgiving in one direction only: an unreadable / missing git reads as "no repo", which is the
- * conservative answer for the caller that treats a repo's failure as fatal.
- */
-export async function isGitRepo(cwd, git = nodeGitRunner()) {
-    return git(['rev-parse', '--is-inside-work-tree'], cwd)
-        .then(out => out.trim() === 'true')
-        .catch(() => false);
-}
-/** The root of the checkout `cwd` is in — an agent's own, from anywhere under it. Rejects outside a repo. */
-export async function checkoutRoot(cwd, git = nodeGitRunner()) {
-    return (await git(['rev-parse', '--show-toplevel'], cwd)).trim();
-}
-/**
- * The line of a failed git invocation worth showing: git's own `fatal:` / `error:` / `remote:`
- * line when there is one, else the first line, else a placeholder.
- */
-export function gitReason(err) {
-    const message = err instanceof Error ? err.message : String(err);
-    const lines = message.split('\n').map(line => line.trim()).filter(Boolean);
-    return lines.find(line => /^(fatal|error|remote):/i.test(line)) ?? lines[0] ?? 'git failed';
-}
-/** Push a branch to `origin`, setting its upstream. The failure is git's own line, not a stack. */
-export async function pushBranch(repo, branch, git = nodeGitRunner()) {
-    try {
-        await git(['push', '--set-upstream', 'origin', branch], repo);
-        return { ok: true };
-    }
-    catch (err) {
-        return { ok: false, error: gitReason(err) };
-    }
-}
-//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/merge-hold.d.ts

@@ -1,20 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-/** Under `.branches/`: one file per pull request whose merge is wanted and held. Not a checkout name, so nothing lists it. */
-export declare const HELD_DIR = "merge-held";
-/** The line a held pull request's body carries, for the person who reads it; the release takes it out. */
-export declare const MERGE_HELD_NOTE = "**Merge held:** more work comes on this branch first; the merge is armed once it is done.";
-/** Put the hold on a checkout: a publish from it asked to merge arms nothing until the release. */
-export declare function holdMerge(checkout: string, git: GitRunner): Promise<void>;
-/** Whether a checkout is under a hold. */
-export declare function mergeHeld(checkout: string, git: GitRunner): Promise<boolean>;
-/** Record that a pull request's merge is wanted and held. */
-export declare function recordHeldMerge(repo: string, number: number): Promise<void>;
-/** Whether a pull request's merge is recorded as wanted and held. */
-export declare function heldMergeRecorded(repo: string, number: number): Promise<boolean>;
-/** Drop the record: the merge was armed, or the pull request is no longer open. */
-export declare function dropHeldMerge(repo: string, number: number): Promise<void>;
-/** A body with the held note at its end, once. */
-export declare function withHeldNote(body: string): string;
-/** A body without the held note. */
-export declare function withoutHeldNote(body: string): string;
-//# sourceMappingURL=merge-hold.d.ts.map

package/dist/merge-hold.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-hold.d.ts","sourceRoot":"","sources":["../src/merge-hold.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAkBnE,8HAA8H;AAC9H,eAAO,MAAM,QAAQ,eAAe,CAAA;AAEpC,0GAA0G;AAC1G,eAAO,MAAM,eAAe,8FAA8F,CAAA;AAE1H,mGAAmG;AACnG,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED,0CAA0C;AAC1C,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAElF;AAED,6DAA6D;AAC7D,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,qEAAqE;AACrE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEtF;AAED,mFAAmF;AACnF,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,oCAAoC;AACpC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD"}

package/dist/merge-hold.js

@@ -1,64 +0,0 @@
-import { mkdir, rm, stat, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { BRANCHES_DIR } from '@gemstack/agent-data';
-/**
- * A held merge: whoever started the agent has more work coming on its branch after it, so the
- * merge its publish asks for waits until the last of it is done. The caller puts the hold on the
- * checkout before the agent starts; a publish asked to merge under it opens the pull request as
- * always, arms nothing, and records that the merge is wanted; the caller releases it once the rest
- * is done. Names no command and no caller: a hold is only "not yet".
- *
- * Two files, both out of git's sight. The hold is the checkout's own, in its private git
- * directory, so it goes with the checkout. The record of a wanted merge is the pull request's,
- * under `.branches/` beside the merge watcher's logs, so it outlives the checkout: the caller
- * releases it after the checkout the agent published from is gone.
- */
-/** The hold's file, in the checkout's private git directory. */
-const HOLD_FILE = 'branches-merge-hold';
-/** Under `.branches/`: one file per pull request whose merge is wanted and held. Not a checkout name, so nothing lists it. */
-export const HELD_DIR = 'merge-held';
-/** The line a held pull request's body carries, for the person who reads it; the release takes it out. */
-export const MERGE_HELD_NOTE = '**Merge held:** more work comes on this branch first; the merge is armed once it is done.';
-/** Put the hold on a checkout: a publish from it asked to merge arms nothing until the release. */
-export async function holdMerge(checkout, git) {
-    await writeFile(await holdPath(checkout, git), '');
-}
-/** Whether a checkout is under a hold. */
-export async function mergeHeld(checkout, git) {
-    return stat(await holdPath(checkout, git)).then(() => true, () => false);
-}
-/** Record that a pull request's merge is wanted and held. */
-export async function recordHeldMerge(repo, number) {
-    await mkdir(join(repo, BRANCHES_DIR, HELD_DIR), { recursive: true });
-    await writeFile(heldPath(repo, number), '');
-}
-/** Whether a pull request's merge is recorded as wanted and held. */
-export async function heldMergeRecorded(repo, number) {
-    return stat(heldPath(repo, number)).then(() => true, () => false);
-}
-/** Drop the record: the merge was armed, or the pull request is no longer open. */
-export async function dropHeldMerge(repo, number) {
-    await rm(heldPath(repo, number), { force: true });
-}
-/** A body with the held note at its end, once. */
-export function withHeldNote(body) {
-    if (body.split('\n').some(line => line.trim() === MERGE_HELD_NOTE))
-        return body;
-    return body.trim() === '' ? MERGE_HELD_NOTE : `${body.trimEnd()}\n\n${MERGE_HELD_NOTE}`;
-}
-/** A body without the held note. */
-export function withoutHeldNote(body) {
-    return body
-        .split('\n')
-        .filter(line => line.trim() !== MERGE_HELD_NOTE)
-        .join('\n')
-        .replace(/\n{3,}/g, '\n\n')
-        .trimEnd();
-}
-async function holdPath(checkout, git) {
-    return join((await git(['rev-parse', '--absolute-git-dir'], checkout)).trim(), HOLD_FILE);
-}
-function heldPath(repo, number) {
-    return join(repo, BRANCHES_DIR, HELD_DIR, String(number));
-}
-//# sourceMappingURL=merge-hold.js.map

package/dist/merge-hold.js.map

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

package/dist/merge-watch.d.ts

@@ -1,68 +0,0 @@
-import type { GhRunner } from './publish.js';
-/**
- * Merge on green where the repository does not allow GitHub auto-merge: a small process of this
- * tool's own that waits for one pull request's checks and merges it once they pass. It holds
- * nothing but the number: the pull request on GitHub is the whole state, so a watcher that dies
- * (a reboot) leaves an open request a person can merge, never a wrong merge.
- */
-/** Where a pull request's checks stand, summarised to the question the merge asks. */
-export type ChecksState = 'passing' | 'failing' | 'pending' | 'none';
-/** How long a pull request with no checks waits for its checks to attach before it counts as green. */
-export declare const NO_CHECKS_GRACE_MS: number;
-/** How often the checks are read. */
-export declare const WATCH_EVERY_MS = 60000;
-/** How long a watcher waits at most: a suite still pending after this is left to a person. */
-export declare const WATCH_FOR_MS: number;
-/** Under `.branches/`: one log per watched pull request. Not a checkout name, so nothing lists it. */
-export declare const WATCH_LOG_DIR = "merge-on-green";
-export type WatchOutcome = {
-    outcome: 'merged';
-}
-/** Merged or closed by someone else meanwhile. */
- | {
-    outcome: 'closed';
-    state: string;
-} | {
-    outcome: 'checks-failed';
-    failed: string[];
-} | {
-    outcome: 'timed-out';
-} | {
-    outcome: 'failed';
-    error: string;
-};
-interface PrView {
-    state: string;
-    checks: ChecksState;
-    failed: string[];
-}
-/**
- * One read of the pull request: its state and its checks, GitHub Actions check runs and classic
- * commit statuses alike. Skipped and neutral count as passing, as GitHub's own merge box counts
- * them; a cancelled or timed-out check is not evidence the work is good, so it counts as failed.
- * A read gh cannot answer is `pending`: acting on an unreadable status must never merge.
- */
-export declare function readPr(repo: string, number: number, gh: GhRunner): Promise<PrView>;
-export interface WatchOptions {
-    gh: GhRunner;
-    now?: () => number;
-    sleep?: (ms: number) => Promise<void>;
-    everyMs?: number;
-    forMs?: number;
-    graceMs?: number;
-    log?: (line: string) => void;
-}
-/**
- * Wait for the pull request's checks, then merge it (squash). Red ends the watch with the request
- * left open for a person; a request merged or closed meanwhile ends it too. No checks at all is
- * green once the grace has passed: a repository without CI has nothing to wait for.
- */
-export declare function watchAndMerge(repo: string, number: number, opts: WatchOptions): Promise<WatchOutcome>;
-/**
- * Start the watcher for one pull request as its own process, detached, so it outlives the agent
- * that published: `branches merge-on-green <number>` at the project root, its log under
- * `.branches/merge-on-green/<number>.log`. Resolves once the process exists.
- */
-export declare function spawnMergeWatch(repo: string, number: number): Promise<void>;
-export {};
-//# sourceMappingURL=merge-watch.d.ts.map

package/dist/merge-watch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-watch.d.ts","sourceRoot":"","sources":["../src/merge-watch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;GAKG;AAEH,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;AAEpE,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,QAAa,CAAA;AAC5C,qCAAqC;AACrC,eAAO,MAAM,cAAc,QAAS,CAAA;AACpC,8FAA8F;AAC9F,eAAO,MAAM,YAAY,QAAkB,CAAA;AAE3C,sGAAsG;AACtG,eAAO,MAAM,aAAa,mBAAmB,CAAA;AAE7C,MAAM,MAAM,YAAY,GACpB;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE;AACvB,kDAAkD;GAChD;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAC9C;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GACxB;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,UAAU,MAAM;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BxF;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAsB3G;AAKD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWjF"}

package/dist/merge-watch.js

@@ -1,97 +0,0 @@
-import { spawn } from 'node:child_process';
-import { closeSync, mkdirSync, openSync } from 'node:fs';
-import { join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { BRANCHES_DIR } from '@gemstack/agent-data';
-/** How long a pull request with no checks waits for its checks to attach before it counts as green. */
-export const NO_CHECKS_GRACE_MS = 2 * 60_000;
-/** How often the checks are read. */
-export const WATCH_EVERY_MS = 60_000;
-/** How long a watcher waits at most: a suite still pending after this is left to a person. */
-export const WATCH_FOR_MS = 6 * 60 * 60_000;
-/** Under `.branches/`: one log per watched pull request. Not a checkout name, so nothing lists it. */
-export const WATCH_LOG_DIR = 'merge-on-green';
-/**
- * One read of the pull request: its state and its checks, GitHub Actions check runs and classic
- * commit statuses alike. Skipped and neutral count as passing, as GitHub's own merge box counts
- * them; a cancelled or timed-out check is not evidence the work is good, so it counts as failed.
- * A read gh cannot answer is `pending`: acting on an unreadable status must never merge.
- */
-export async function readPr(repo, number, gh) {
-    let parsed;
-    try {
-        parsed = JSON.parse(await gh(['pr', 'view', String(number), '--json', 'state,statusCheckRollup'], repo));
-    }
-    catch {
-        return { state: 'OPEN', checks: 'pending', failed: [] };
-    }
-    const state = typeof parsed.state === 'string' ? parsed.state : 'OPEN';
-    const rollup = Array.isArray(parsed.statusCheckRollup) ? parsed.statusCheckRollup : [];
-    if (rollup.length === 0)
-        return { state, checks: 'none', failed: [] };
-    const passing = /^(SUCCESS|NEUTRAL|SKIPPED)$/;
-    let pending = false;
-    const failed = [];
-    for (const entry of rollup) {
-        // A classic status has no `status` field: its `state` is both progress and verdict.
-        const verdict = entry.conclusion ?? entry.state ?? '';
-        const done = entry.status ? entry.status === 'COMPLETED' : verdict !== 'PENDING' && verdict !== 'EXPECTED';
-        if (!done)
-            pending = true;
-        else if (!passing.test(verdict))
-            failed.push(entry.name ?? entry.context ?? 'unnamed check');
-    }
-    return { state, checks: failed.length > 0 ? 'failing' : pending ? 'pending' : 'passing', failed };
-}
-/**
- * Wait for the pull request's checks, then merge it (squash). Red ends the watch with the request
- * left open for a person; a request merged or closed meanwhile ends it too. No checks at all is
- * green once the grace has passed: a repository without CI has nothing to wait for.
- */
-export async function watchAndMerge(repo, number, opts) {
-    const now = opts.now ?? Date.now;
-    const sleep = opts.sleep ?? (ms => new Promise(resolve => setTimeout(resolve, ms)));
-    const log = opts.log ?? (() => { });
-    const started = now();
-    for (;;) {
-        const pr = await readPr(repo, number, opts.gh);
-        const elapsed = now() - started;
-        log(`[branches] #${number}: ${pr.state}, checks ${pr.checks}`);
-        if (pr.state !== 'OPEN')
-            return { outcome: 'closed', state: pr.state };
-        if (pr.checks === 'failing')
-            return { outcome: 'checks-failed', failed: pr.failed };
-        if (pr.checks === 'passing' || (pr.checks === 'none' && elapsed >= (opts.graceMs ?? NO_CHECKS_GRACE_MS))) {
-            try {
-                await opts.gh(['pr', 'merge', String(number), '--squash'], repo);
-                return { outcome: 'merged' };
-            }
-            catch (err) {
-                return { outcome: 'failed', error: err instanceof Error ? err.message : String(err) };
-            }
-        }
-        if (elapsed >= (opts.forMs ?? WATCH_FOR_MS))
-            return { outcome: 'timed-out' };
-        await sleep(opts.everyMs ?? WATCH_EVERY_MS);
-    }
-}
-/** This package's executable, beside `dist/`. */
-const BIN = fileURLToPath(new URL('../bin/branches', import.meta.url));
-/**
- * Start the watcher for one pull request as its own process, detached, so it outlives the agent
- * that published: `branches merge-on-green <number>` at the project root, its log under
- * `.branches/merge-on-green/<number>.log`. Resolves once the process exists.
- */
-export async function spawnMergeWatch(repo, number) {
-    const dir = join(repo, BRANCHES_DIR, WATCH_LOG_DIR);
-    mkdirSync(dir, { recursive: true });
-    const fd = openSync(join(dir, `${number}.log`), 'a');
-    const child = spawn(process.execPath, [BIN, 'merge-on-green', String(number)], { cwd: repo, detached: true, stdio: ['ignore', fd, fd] });
-    closeSync(fd);
-    child.unref();
-    await new Promise((resolve, reject) => {
-        child.once('spawn', resolve);
-        child.once('error', reject);
-    });
-}
-//# sourceMappingURL=merge-watch.js.map

package/dist/merge-watch.js.map

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

package/dist/publish.d.ts

@@ -1,138 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-/**
- * Publishing a checkout (#1774): the agent's own last step. Push the branch, open its pull
- * request with the title and body the agent wrote, and arm the merge when the agent was told
- * the work may land on its own. One rule before any of it: the tree is clean, since what is
- * published is what is committed, and nothing is committed on the agent's behalf.
- *
- * A branch that already has an open pull request gets no second one: the request is reported as
- * it is, and only the push and the merge arming happen.
- *
- * The merge is GitHub's auto-merge where the repository allows it. Where it does not, this tool's
- * own watcher waits for the checks and merges (`merge-watch.ts`); where the request is already
- * green, GitHub will not arm anything and the request is merged at once.
- *
- * A checkout under a hold (`merge-hold.ts`) arms nothing: the merge is recorded as wanted, the
- * request's body says it is held, and the caller who put the hold releases it (`releaseMerge`).
- *
- * A person publishes a finished agent's work through the same door (#1774), by branch
- * (`publishBranch`): the agent's checkout when one is still on the branch, under the same clean
- * rule; else the branch itself, pushed when this machine has it, as it is when only the remote
- * does. And lands its request (`mergePr`): a draft is marked ready first, then the merge is
- * armed exactly as `--merge` arms it.
- */
-/** A `gh` runner: the standard output of one invocation; rejects with gh's own line on failure. */
-export type GhRunner = (args: string[], cwd: string) => Promise<string>;
-/** `gh` on PATH, one minute per call: these talk to the network. */
-export declare function nodeGhRunner(): GhRunner;
-export interface PublishOptions {
-    /** The pull request's title: one line naming what the change does. */
-    title: string;
-    /** The pull request's body: what changed and why. */
-    body?: string;
-    /** Arm the merge: the request lands on its own once its checks pass. */
-    merge?: boolean;
-    /** Start the merge watcher for a request (default {@link spawnMergeWatch}). For tests. */
-    watch?: (repo: string, number: number) => Promise<void>;
-    /** Open the request as a draft. Not with `merge`: a draft cannot be merged. */
-    draft?: boolean;
-    git?: GitRunner;
-    gh?: GhRunner;
-}
-/** Why a checkout was not published. */
-export type PublishRefusal = 
-/** The directory is not a git worktree root. */
-'not-a-worktree'
-/** The checkout is on no branch. */
- | 'no-branch'
-/** The tree holds uncommitted work: commit or delete it first. */
- | 'dirty'
-/** The branch could not be pushed. */
- | 'push-failed'
-/** The pull request could not be opened. */
- | 'pr-failed';
-export type PublishOutcome = {
-    ok: true;
-    branch: string;
-    pr: {
-        number: number;
-        url: string;
-    };
-    /** Whether the request was open already. */
-    existing: boolean;
-    /**
-     * How the merge arming went, when asked for: GitHub's auto-merge armed, merged at once (the
-     * request was already green), this tool's watcher started (the repository does not allow
-     * auto-merge), or held (the checkout is under a hold; armed at its release).
-     */
-    merge?: MergeArming | {
-        outcome: 'held';
-    };
-} | {
-    ok: false;
-    reason: 'not-a-worktree';
-}
-/** The checkout is on no branch; or, published by name, neither this machine nor the remote has the branch. */
- | {
-    ok: false;
-    reason: 'no-branch';
-    branch?: string;
-} | {
-    ok: false;
-    reason: 'dirty' | 'push-failed' | 'pr-failed';
-    branch: string;
-    detail?: string;
-};
-/** How arming a merge went. */
-export type MergeArming = {
-    outcome: 'auto-armed' | 'merged' | 'watching';
-} | {
-    outcome: 'failed';
-    error: string;
-};
-export declare function publishCheckout(path: string, opts: PublishOptions): Promise<PublishOutcome>;
-/**
- * Publish a branch by name, from the project (#1774): the caller's form, for a person landing a
- * finished agent's work. The checkout under `.branches/` that is on the branch, when one is,
- * is published as the agent would publish it, its clean rule included. Without one, the branch
- * itself: pushed when this machine has it; left as it is when only `origin` has it (a branch
- * pushed from elsewhere, with nothing here to push). Neither: `no-branch`. No hold applies
- * without a checkout: a hold is a checkout's.
- */
-export declare function publishBranch(repo: string, branch: string, opts: PublishOptions): Promise<PublishOutcome>;
-/** What landing a request for a person did: armed as `--merge` arms, or why not. */
-export type MergePrOutcome = MergeArming | {
-    outcome: 'not-open';
-    state: string;
-};
-export interface MergePrOptions {
-    gh?: GhRunner;
-    /** Start the merge watcher for a request (default {@link spawnMergeWatch}). For tests. */
-    watch?: (repo: string, number: number) => Promise<void>;
-}
-/**
- * Land a pull request for a person (#1774): "it is good, land it". A draft is marked ready
- * first, since asking for the merge is the statement that its review happened; then the merge
- * is armed exactly as `publish --merge` arms it. A request that is not open is `not-open` with
- * its state: already merged is an answer, not an action.
- */
-export declare function mergePr(repo: string, number: number, opts?: MergePrOptions): Promise<MergePrOutcome>;
-export type ReleaseOutcome = MergeArming | {
-    outcome: 'not-held';
-} | {
-    outcome: 'closed';
-    state: string;
-};
-export interface ReleaseOptions {
-    gh?: GhRunner;
-    /** Start the merge watcher for a request (default {@link spawnMergeWatch}). For tests. */
-    watch?: (repo: string, number: number) => Promise<void>;
-}
-/**
- * Release a held merge: the request's merge is armed the way `publish --merge` arms it, and then
- * the held note leaves its body. A request with no held merge is `not-held` (its publish never asked
- * to merge), one no longer open is `closed` and its record dropped. A failed arming keeps the
- * record and the note, so the release can be tried again and the request still says it is held.
- */
-export declare function releaseMerge(repo: string, number: number, opts?: ReleaseOptions): Promise<ReleaseOutcome>;
-//# sourceMappingURL=publish.d.ts.map

package/dist/publish.d.ts.map

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