@openagt/skill-branches 0.0.1

package/dist/worktree.js

@@ -0,0 +1,397 @@
+import { basename, dirname, join } from 'node:path';
+import { realpath, stat } from 'node:fs/promises';
+import { nodeGitRunner, checkoutRoot, originDefaultBranch, BRANCHES_DIR } from '@openagt/agent-data';
+import { AGENT_BRANCH_PREFIX, isSafeAgentId, isAgentBranch, agentBranchName, agentIdFromWorktreeDir } from './branch-names.js';
+import { DATA_BRANCH } from '@openagt/agent-data/names';
+/**
+ * Git-worktree lifecycle for concurrent agents (#453/#735): give each agent its own
+ * checkout so N agents on one repo never fight over the working tree. Pure plumbing
+ * over the {@link GitRunner} seam: this module only knows how to add, list, name,
+ * remove, and prune worktrees, and to read what a retention decision needs.
+ */
+/** The path an agent's worktree gets (#1580): `<repo>/.branches/<agent branch>`. */
+export function worktreePath(repo, agentId) {
+    return join(repo, BRANCHES_DIR, agentBranchName(agentId));
+}
+async function nodeReaddir(path) {
+    const { readdir } = await import('node:fs/promises');
+    const entries = await readdir(path, { withFileTypes: true }).catch(() => []);
+    return entries.filter(entry => entry.isDirectory()).map(entry => entry.name);
+}
+/**
+ * Every checkout directory on disk (#1580): a directory under `.branches/` named as an agent
+ * branch. Only directories count — the same place holds the rename links (#1589), symlinks named
+ * as agent branches too, which are views, not checkouts. Forgiving: a missing root yields nothing.
+ */
+export async function worktreeDirEntries(repo, readdir = nodeReaddir) {
+    const root = join(repo, BRANCHES_DIR);
+    const entries = [];
+    for (const name of await readdir(root).catch(() => [])) {
+        const agentId = agentIdFromWorktreeDir(name);
+        if (isAgentBranch(name) && isSafeAgentId(agentId))
+            entries.push({ path: join(root, name), agentId });
+    }
+    return entries;
+}
+/**
+ * The agent ids that have a worktree directory (#737/#1580). Forgiving — a project that never ran
+ * concurrently has no such dir and yields `[]`.
+ */
+export async function listWorktreeDirs(repo, readdir = nodeReaddir) {
+    return [...new Set((await worktreeDirEntries(repo, readdir)).map(entry => entry.agentId))];
+}
+/** How long a new agent branch waits for origin's default branch to be fetched: Claude Code's own cap. */
+export const FRESH_START_FETCH_MS = 5_000;
+/**
+ * Where a new agent branch starts: origin's default branch, fetched first so it is current. Never
+ * the project's HEAD: that is whatever the user has checked out, unpushed work included, and a
+ * branch started there publishes that work when the agent's branch is pushed. The fetch is waited
+ * for {@link FRESH_START_FETCH_MS} at most, and one that fails (offline) or runs longer leaves the
+ * copy this clone already has; a fetch still running finishes on its own. A repository with no
+ * remote has no such branch: undefined, and git starts from HEAD, the only commit there is.
+ */
+async function freshStart(repo, git) {
+    const start = await originDefaultBranch(repo, git);
+    if (!start)
+        return undefined;
+    const fetched = git(['fetch', '--quiet', '--no-write-fetch-head', 'origin', start.slice('origin/'.length)], repo).catch(() => { });
+    let timer;
+    const capped = new Promise(resolve => {
+        timer = setTimeout(resolve, FRESH_START_FETCH_MS);
+        timer.unref();
+    });
+    await Promise.race([fetched, capped]);
+    clearTimeout(timer);
+    return start;
+}
+/**
+ * Create a worktree for an agent on a fresh branch: `git worktree add --no-track -b <branch>
+ * <path> <base>`, the base origin's default branch unless the caller names one. No upstream:
+ * tracking writes the repository's shared `.git/config`, whose lock a running agent's own git
+ * command in another checkout may hold. Git makes the leaf dir (and any missing parents) itself. The
+ * `agentId` is validated as path-safe first so a caller can never traverse out of
+ * `.branches/`. Rejects on any git failure (a caller that wants a
+ * run needs its checkout, so failure must surface, not be swallowed).
+ */
+export async function addWorktree(repo, opts, git = nodeGitRunner()) {
+    if (!isSafeAgentId(opts.agentId))
+        throw new Error(`unsafe agent id: ${opts.agentId}`);
+    const path = worktreePath(repo, opts.agentId);
+    const base = opts.base ?? (await freshStart(repo, git));
+    await git(['worktree', 'add', '--no-track', '-b', opts.branch, path, ...(base ? [base] : [])], repo);
+    return { path, branch: opts.branch };
+}
+/**
+ * Check an *existing* branch out into an agent's worktree (#762). Continuing an agent puts it back
+ * on the branch its work is already on, rather than branching again and stranding what it did
+ * last time. The branch as this clone has it; else origin's copy, as a new local branch with no
+ * upstream set, as in {@link addWorktree}; else, gone everywhere, a new branch where the agent's
+ * first one started: the base the caller names, as this clone has it or else as origin does, and
+ * with none, or one that is gone too, where a new agent branch starts ({@link freshStart}); the
+ * answer then says the branch was made again. The
+ * only branch the package deletes is one that held nothing past a commit the remote already had,
+ * so nothing of the agent's is lost. Anything git refuses — the branch checked out elsewhere, say —
+ * rejects, like {@link addWorktree}: a continued agent needs its checkout.
+ */
+export async function attachWorktree(repo, opts, git = nodeGitRunner()) {
+    if (!isSafeAgentId(opts.agentId))
+        throw new Error(`unsafe agent id: ${opts.agentId}`);
+    const path = worktreePath(repo, opts.agentId);
+    const has = (ref) => git(['rev-parse', '--verify', '--quiet', `${ref}^{commit}`], repo).then(out => out.trim() !== '', () => false);
+    if (await has(`refs/heads/${opts.branch}`)) {
+        await git(['worktree', 'add', path, opts.branch], repo);
+        return { path, branch: opts.branch };
+    }
+    const theirs = `refs/remotes/origin/${opts.branch}`;
+    const starts = [theirs, ...(opts.base !== undefined ? [opts.base, `refs/remotes/origin/${opts.base}`] : [])];
+    let start;
+    for (const ref of starts)
+        if (start === undefined && (await has(ref)))
+            start = ref;
+    const again = start !== theirs;
+    start ??= await freshStart(repo, git);
+    await git(['worktree', 'add', '--no-track', '-b', opts.branch, path, ...(start ? [start] : [])], repo);
+    return { path, branch: opts.branch, ...(again ? { again: true } : {}) };
+}
+/**
+ * Every worktree registered for the repo (the main checkout included). Forgiving:
+ * a non-repo / git failure yields `[]` so a reconcile scan never throws.
+ */
+export async function listWorktrees(repo, git = nodeGitRunner()) {
+    try {
+        return parseWorktreeList(await git(['worktree', 'list', '--porcelain'], repo));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse `git worktree list --porcelain`: blank-line-separated records, each with
+ * a `worktree <path>` line, a `HEAD <sha>` line, and either `branch refs/heads/...`
+ * or `detached`. Extra attributes (bare/locked/prunable) are ignored. Exported so
+ * the parsing is unit-testable without a real repo.
+ */
+export function parseWorktreeList(porcelain) {
+    const entries = [];
+    for (const block of porcelain.split(/\n\s*\n/)) {
+        let path;
+        let head = '';
+        let branch;
+        for (const line of block.split('\n')) {
+            if (line.startsWith('worktree '))
+                path = line.slice('worktree '.length).trim();
+            else if (line.startsWith('HEAD '))
+                head = line.slice('HEAD '.length).trim();
+            else if (line.startsWith('branch '))
+                branch = line.slice('branch '.length).trim().replace(/^refs\/heads\//, '');
+        }
+        if (path)
+            entries.push({ path, head, ...(branch ? { branch } : {}) });
+    }
+    return entries;
+}
+/**
+ * Remove an agent's worktree. Tolerant of an already-gone / never-registered path so
+ * teardown stays idempotent (a caller may run it twice).
+ *
+ * Plain removal first: it refuses a checkout git considers unclean, which after the
+ * caller's {@link worktreeClean} check means a state we did not anticipate. Falling back to
+ * `--force` keeps teardown working (an ignored build artifact must not strand a
+ * worktree forever), but it says so, because forcing past unknown state is exactly
+ * how uncommitted work got deleted in the first place.
+ */
+export async function removeWorktree(repo, path, git = nodeGitRunner()) {
+    try {
+        await git(['worktree', 'remove', path], repo);
+        return;
+    }
+    catch {
+        // Unclean by git's reckoning, already removed, or never registered: try forcing.
+    }
+    try {
+        await git(['worktree', 'remove', '--force', path], repo);
+        // stderr: on a CLI run stdout carries the JSON result, and this line would corrupt it.
+        console.error(`[branches] forced removal of worktree ${path} (git called it unclean)`);
+    }
+    catch (err) {
+        // Already removed, or never registered: nothing to do. A checkout still on disk is another
+        // matter (#1757): a caller told "removed" while it stands would drop its branch next.
+        if (await stat(path).then(() => true, () => false))
+            throw err;
+    }
+}
+/**
+ * Delete a branch that holds nothing (#1650). `-D`, because "merged" in git's eyes is the wrong
+ * test: the caller proved the tip is a commit the remote already has, which is the stronger fact.
+ * Forgiving: the checkout is already gone by the time this runs, and a branch that would not
+ * delete is a leftover name, not lost work. Says whether it went, so a caller names only the
+ * branches that are actually gone (#1757).
+ */
+export async function deleteBranch(repo, branch, git = nodeGitRunner()) {
+    return git(['branch', '-D', branch], repo).then(() => true, () => false);
+}
+/**
+ * Whether `path` is the root of a git worktree — the main checkout's or a linked one (#1654).
+ *
+ * Git answers for any directory *inside* a repository, so a `.branches/<agent>` directory that is
+ * no longer a worktree (a checkout removed by hand, a marker written after teardown) makes every
+ * git command run in it act on the enclosing repo: the user's own checkout, on the user's own
+ * branch. The one question that tells the two apart is whether git's top level is this very
+ * directory. False on any failure, and the caller leaves the directory alone.
+ */
+export async function isWorktreeRoot(path, git = nodeGitRunner()) {
+    try {
+        const top = (await git(['rev-parse', '--show-toplevel'], path)).trim();
+        if (!top)
+            return false;
+        // Both sides resolved: macOS's tmpdir sits behind the /var -> /private/var link, and git
+        // reports the resolved path.
+        return (await realpath(top)) === (await realpath(path));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The branch checked out at `path` when `path` is a worktree root (#1654), else `undefined` —
+ * the read every consumer of a `.branches/<agent>` directory wants, so none of them can take the
+ * enclosing repo's branch for the run's.
+ */
+export async function worktreeBranch(path, git = nodeGitRunner()) {
+    return (await isWorktreeRoot(path, git)) ? currentBranch(path, git) : undefined;
+}
+/**
+ * The branch checked out at `path`, or `undefined` when detached / not a repo.
+ * Forgiving, like {@link listWorktrees}: callers use it to decide, not to fail.
+ */
+export async function currentBranch(path, git = nodeGitRunner()) {
+    try {
+        const name = (await git(['rev-parse', '--abbrev-ref', 'HEAD'], path)).trim();
+        return name && name !== 'HEAD' ? name : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The project a directory belongs to (#1725): the checkout whose `.branches/` holds the agent
+ * checkouts. From inside an agent's checkout that is two levels up, by the layout every checkout
+ * is created with; from anywhere else it is the checkout itself. Read from the layout rather than
+ * from git's common dir, so a project that is itself a linked worktree, or a submodule, answers
+ * with the directory the caller registered. Rejects outside a repo.
+ */
+export async function projectRoot(cwd, git = nodeGitRunner()) {
+    const checkout = await checkoutRoot(cwd, git);
+    const parent = dirname(checkout);
+    return basename(parent) === BRANCHES_DIR ? dirname(parent) : checkout;
+}
+/** A session name as the agent picks it: the charset the skill asks for. */
+export function isSessionName(name) {
+    return /^[a-z0-9-]+$/.test(name);
+}
+/** How often a rename lost to a sibling naming the same thing at the same moment is retried. */
+const NAME_ATTEMPTS = 3;
+/**
+ * Name the session (#1725): rename the checkout's branch to `agent-<name>`. A rename, not a new
+ * branch, so the branch the checkout was born on is the branch it ends on and nothing is left
+ * behind to clean up. Only a branch the package minted is ever renamed: an agent that somehow
+ * runs in the user's own checkout must not rename `main`.
+ *
+ * A taken name gets a numeric suffix (`agent-<name>-2`, `-3`, …) rather than a refusal: the agent
+ * asked for a name, and the caller reads back the one it got. Taken means any local branch or
+ * any remote-tracking branch, so the later push does not land on someone else's branch — except
+ * the checkout's own branch, pushed or not, which is why asking again for the name the checkout
+ * already carries (suffixed or not) changes nothing. Two checkouts naming the same thing at the
+ * same moment race on the rename itself; the loser reads the branches again and takes the next
+ * free suffix.
+ */
+export async function nameBranch(path, name, git = nodeGitRunner()) {
+    if (!isSessionName(name))
+        return { ok: false, reason: 'invalid-name' };
+    const wanted = `${AGENT_BRANCH_PREFIX}${name}`;
+    if (!(await isWorktreeRoot(path, git)))
+        return { ok: false, reason: 'not-a-worktree' };
+    const current = await currentBranch(path, git);
+    if (!current)
+        return { ok: false, reason: 'no-branch' };
+    if (!isAgentBranch(current))
+        return { ok: false, reason: 'not-an-agent-branch' };
+    for (let attempt = 1;; attempt++) {
+        const taken = await branchNames(path, git);
+        taken.delete(current);
+        // The data branch is nobody's session, whether or not this repo has it yet: `name data` gets `-2`.
+        taken.add(DATA_BRANCH);
+        let branch = wanted;
+        for (let n = 2; taken.has(branch); n++)
+            branch = `${wanted}-${n}`;
+        if (branch === current)
+            return { ok: true, branch };
+        try {
+            await git(['branch', '-m', current, branch], path);
+            return { ok: true, branch };
+        }
+        catch (err) {
+            if (attempt >= NAME_ATTEMPTS || !/already exists/.test(err instanceof Error ? err.message : String(err)))
+                throw err;
+        }
+    }
+}
+/** Every branch name the repo knows, local and remote-tracking, without the remote's prefix. */
+async function branchNames(path, git) {
+    const out = await git(['for-each-ref', '--format=%(refname)', 'refs/heads/', 'refs/remotes/'], path);
+    const names = new Set();
+    for (const ref of out.split('\n')) {
+        const heads = ref.match(/^refs\/heads\/(.+)$/);
+        if (heads?.[1])
+            names.add(heads[1]);
+        const remotes = ref.match(/^refs\/remotes\/[^/]+\/(.+)$/);
+        if (remotes?.[1])
+            names.add(remotes[1]);
+    }
+    return names;
+}
+/**
+ * `git worktree prune`: drop administrative entries for worktree dirs a crash left
+ * behind. Never removes a live worktree, so it is always safe. Forgiving.
+ */
+export async function pruneWorktrees(repo, git = nodeGitRunner()) {
+    try {
+        await git(['worktree', 'prune'], repo);
+    }
+    catch {
+        // Not a repo / nothing to prune: no-op.
+    }
+}
+/** A {@link SizeRunner} over `du -sk`: one process, and it does not follow the symlinked deps (#736). */
+export function nodeSizeRunner() {
+    return path => new Promise((resolvePromise, rejectPromise) => {
+        void import('node:child_process').then(({ execFile }) => {
+            execFile('du', ['-sk', path], { timeout: 5_000 }, (err, stdout) => err ? rejectPromise(err) : resolvePromise(stdout));
+        });
+    });
+}
+/**
+ * A worktree's size on disk in bytes, or undefined when it cannot be read (#798). Best-effort by
+ * design: this only ever labels a "remove this" button, so a missing number costs nothing while a
+ * throw or a hang would cost the listing it sits in. `du` is absent on Windows, which reads as
+ * unknown like any other failure.
+ */
+export async function worktreeSize(path, size = nodeSizeRunner()) {
+    try {
+        const kb = Number.parseInt((await size(path)).trim().split(/\s+/)[0] ?? '', 10);
+        return Number.isFinite(kb) ? kb * 1024 : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Whether a branch is on the remote, with the local tip already there.
+ *
+ * What a caller asks to say whether a branch's work is published yet.
+ *
+ * `git rev-parse` of the remote-tracking ref, then a merge-base check: the ref existing is not
+ * enough, because a branch pushed and then committed to again has a tip the remote has never seen.
+ * Reads only local refs (no fetch), so it is cheap enough to ask on every poll — the remote ref
+ * is written by the push this is checking for, which is what makes that sound.
+ *
+ * Anything unreadable answers `false`, and so does a repo with no remote configured.
+ */
+export async function branchPushed(repo, branch, git = nodeGitRunner()) {
+    try {
+        const local = (await git(['rev-parse', '--verify', `refs/heads/${branch}`], repo)).trim();
+        const remote = (await git(['rev-parse', '--verify', `refs/remotes/origin/${branch}`], repo)).trim();
+        if (!local || !remote)
+            return false;
+        if (local === remote)
+            return true;
+        // The remote may be ahead (someone pushed on top): what matters is that our tip is in it.
+        await git(['merge-base', '--is-ancestor', local, remote], repo);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether the checkout has nothing uncommitted. A read, never a commit (#1638): the package
+ * commits nothing on an agent's behalf, so a checkout holding uncommitted work is one the caller
+ * keeps. Throws when git cannot answer, so the caller keeps the checkout rather than guessing.
+ */
+export async function worktreeClean(path, git = nodeGitRunner()) {
+    return !(await git(['status', '--porcelain'], path)).trim();
+}
+/**
+ * Whether the repo has any remote configured at all: with none there is nowhere to publish a
+ * branch to, and a caller offers no push. Anything unreadable answers `false`, like
+ * {@link branchPushed}.
+ */
+export async function repoHasRemote(repo, git = nodeGitRunner()) {
+    try {
+        return (await git(['remote'], repo)).trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@openagt/skill-branches",
+  "version": "0.0.1",
+  "description": "Branch management for coding agents: one git checkout per agent under .branches/, named as its branch, reclaimed once its work is on the remote.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/framework/the-framework.git",
+    "directory": "packages/skill-branches"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "bin/branches",
+    "SKILL.md"
+  ],
+  "bin": {
+    "branches": "bin/branches"
+  },
+  "framework": {
+    "branches": "branches"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./branch-names": {
+      "types": "./dist/branch-names.d.ts",
+      "default": "./dist/branch-names.js"
+    }
+  },
+  "dependencies": {
+    "@openagt/agent-data": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc -p tsconfig.test.json && node --test --test-timeout=60000 'dist-test/**/*.test.js'",
+    "clean": "rm -rf dist dist-test"
+  }
+}