@pat-lewczuk/cezar 0.1.3 → 0.1.4

package/dist/server/git-changes.d.ts

@@ -0,0 +1,182 @@
+export interface ChangedFile {
+    path: string;
+    /** Rename/copy source — present only when `status` is renamed/copied. */
+    oldPath?: string;
+    status: 'added' | 'modified' | 'deleted' | 'renamed' | 'copied';
+    adds: number;
+    dels: number;
+    binary: boolean;
+    patch: string;
+}
+export interface ChangesPayload {
+    files: ChangedFile[];
+    stat: {
+        adds: number;
+        dels: number;
+        files: number;
+    };
+}
+export type ChangesResult = {
+    ok: true;
+    changes: ChangesPayload;
+} | {
+    ok: false;
+    error: string;
+};
+interface NumstatEntry {
+    adds: number;
+    dels: number;
+    binary: boolean;
+    path: string;
+    oldPath?: string;
+}
+/** Parse `git diff --numstat -z -M`: `adds TAB dels TAB path NUL`, or for a
+ *  rename/copy `adds TAB dels TAB NUL old NUL new NUL`. Binary files report
+ *  `-` for both counters. Exported for tests. */
+export declare function parseNumstatZ(out: string): NumstatEntry[];
+interface NameStatusEntry {
+    status: string;
+    path: string;
+    oldPath?: string;
+}
+/** Parse `git diff --name-status -z -M`: `X NUL path NUL`, renames/copies
+ *  `Rnnn NUL old NUL new NUL`. Exported for tests. */
+export declare function parseNameStatusZ(out: string): NameStatusEntry[];
+/** Split one `git diff --patch` blob into per-file sections, in git's file
+ *  order (the same order `--numstat`/`--name-status` use). Exported for tests. */
+export declare function splitPatch(patch: string): string[];
+/**
+ * Structured "what changed here" for a directory vs its base branch:
+ * committed + uncommitted + untracked (via `add -N`), anchored at the
+ * merge-base so the diff stays *this task's* changes even after the base
+ * moves on — the exact resolution `worktreeDiff` (src/git-worktree.ts) uses
+ * for the text-blob `/diff` endpoint, which stays untouched.
+ */
+export declare function collectChanges(dir: string, baseBranch: string, opts?: {
+    patchCap?: number;
+    intentToAdd?: boolean;
+}): Promise<ChangesResult>;
+export interface RunCommit {
+    sha: string;
+    subject: string;
+    author: string;
+    /** Relative time ("3 hours ago"), git's `%cr`. */
+    when: string;
+}
+export type RunCommitsResult = {
+    ok: true;
+    commits: RunCommit[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * The commits a run made on its worktree branch: `<merge-base>..HEAD`, newest first — the same
+ * range `collectChanges` diffs, so the commit list and the aggregate Changes tab always agree on
+ * what "this task's work" means. Empty (not an error) when the branch has no commits past base.
+ */
+export declare function collectRunCommits(dir: string, baseBranch: string): Promise<RunCommitsResult>;
+/** `GET /api/repo/commit/:sha?structured=1` — one commit's metadata plus the same
+ *  structured `{files, stat}` shape the working-tree routes serve (R5 Step 1.7). The
+ *  legacy text-blob answer of that route is a protected surface and stays untouched. */
+export interface CommitPayload {
+    sha: string;
+    subject: string;
+    author: string;
+    /** Relative time ("3 hours ago") — same `%cr` format the /api/repo log uses. */
+    when: string;
+    files: ChangedFile[];
+    stat: {
+        adds: number;
+        dels: number;
+        files: number;
+    };
+}
+export type CommitChangesResult = {
+    ok: true;
+    commit: CommitPayload;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Structured diff of ONE commit vs its first parent (`--root` covers the initial commit).
+ * A merge commit honestly answers zero files — `git diff-tree` shows no diff for merges
+ * without `-m`/`-c`, and inventing one side's diff would misattribute the changes.
+ * Unknown/invalid shas degrade to `{ ok:false, error }` for the route's 409.
+ */
+export declare function collectCommitChanges(dir: string, sha: string, patchCap?: number): Promise<CommitChangesResult>;
+/** Max file content served to the Files tab — past this the GUI shows an
+ *  honest "too large" state instead of the bytes. */
+export declare const FILE_CONTENT_CAP = 512000;
+export interface DirEntry {
+    name: string;
+    type: 'dir' | 'file';
+    size?: number;
+}
+export type FilesResult = {
+    kind: 'dir';
+    path: string;
+    entries: DirEntry[];
+} | {
+    kind: 'file';
+    path: string;
+    size: number;
+    binary: boolean;
+    tooLarge: boolean;
+    content?: string;
+} | {
+    kind: 'invalid';
+    error: string;
+} | {
+    kind: 'missing';
+    error: string;
+};
+/** The image MIME type for a path, or null when it is not an image we serve raw. */
+export declare function imageMimeType(path: string): string | null;
+/**
+ * Directory listing or file content from inside `root`, traversal-safe:
+ * anything resolving outside the root (dot-segments, absolute paths, NUL) is
+ * rejected — same "not a file we serve" stance as `isSafeAssetFilename` in
+ * src/server/static-ui.ts. `.git` and symlinks are off-limits too.
+ */
+export declare function readWorktreePath(root: string, relPath: string, contentCap?: number): Promise<FilesResult>;
+export type BranchResult = {
+    ok: true;
+    branch: string;
+    created: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Repo-view branch action (`POST /api/repo/branch`): switch to `name` when it
+ * already exists locally, otherwise create it from `from` (or HEAD) and switch.
+ * Name validation is delegated to `git check-ref-format --branch` — git's own
+ * rules, not a reimplementation. Predictable failures (invalid name, unknown
+ * `from`, dirty-tree checkout conflict) come back as `{ ok:false, error }`.
+ */
+export declare function createOrSwitchBranch(dir: string, name: string, from?: string): Promise<BranchResult>;
+export type CommitResult = {
+    ok: true;
+    sha: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** `git add -A && git commit -m <message>` in `dir`. A clean tree, a failing
+ *  hook or missing identity all come back as `{ ok:false, error }`. */
+export declare function commitAll(dir: string, message: string): Promise<CommitResult>;
+export type PushResult = {
+    ok: true;
+    branch: string;
+    remote: string;
+    upstreamSet: boolean;
+} | {
+    ok: false;
+    error: string;
+};
+/** Push the current branch, setting upstream when it has none. No remote,
+ *  detached HEAD and rejected pushes all degrade to `{ ok:false, error }`. */
+export declare function pushCurrentBranch(dir: string): Promise<PushResult>;
+export {};

package/dist/server/git-changes.js

@@ -0,0 +1,424 @@
+import { execFile } from 'node:child_process';
+import { rmSync } from 'node:fs';
+import { lstat, open, readFile, readdir, realpath, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve, sep } from 'node:path';
+/** Run git, never throw — degradation is the caller's policy. `env` overrides (e.g. a scratch
+ *  `GIT_INDEX_FILE`) merge over the process env. */
+function git(cwd, args, env) {
+    return new Promise((resolvePromise) => {
+        execFile('git', args, {
+            cwd,
+            maxBuffer: 32 * 1024 * 1024,
+            encoding: 'utf8',
+            ...(env ? { env: { ...process.env, ...env } } : {}),
+        }, (err, stdout, stderr) => resolvePromise({ ok: !err, stdout: stdout ?? '', stderr: stderr ?? '' }));
+    });
+}
+/** First line of git's stderr (or stdout) as a one-line human reason. */
+function gitReason(res, fallback) {
+    const text = (res.stderr.trim() || res.stdout.trim()).split('\n')[0]?.trim();
+    return text || fallback;
+}
+// ---- structured changes -----------------------------------------------------
+/** Per-file patch cap — the GUI shows a "truncated" note past this. */
+const PATCH_CAP = 200_000;
+/** Parse `git diff --numstat -z -M`: `adds TAB dels TAB path NUL`, or for a
+ *  rename/copy `adds TAB dels TAB NUL old NUL new NUL`. Binary files report
+ *  `-` for both counters. Exported for tests. */
+export function parseNumstatZ(out) {
+    const tokens = out.split('\0');
+    const entries = [];
+    let i = 0;
+    while (i < tokens.length) {
+        const head = tokens[i] ?? '';
+        if (!head) {
+            i += 1;
+            continue;
+        }
+        const m = /^(\d+|-)\t(\d+|-)\t([\s\S]*)$/.exec(head);
+        if (!m) {
+            i += 1;
+            continue;
+        }
+        const binary = m[1] === '-';
+        const adds = binary ? 0 : Number(m[1]);
+        const dels = m[2] === '-' ? 0 : Number(m[2]);
+        if (m[3]) {
+            entries.push({ adds, dels, binary, path: m[3] });
+            i += 1;
+        }
+        else {
+            entries.push({ adds, dels, binary, oldPath: tokens[i + 1] ?? '', path: tokens[i + 2] ?? '' });
+            i += 3;
+        }
+    }
+    return entries;
+}
+/** Parse `git diff --name-status -z -M`: `X NUL path NUL`, renames/copies
+ *  `Rnnn NUL old NUL new NUL`. Exported for tests. */
+export function parseNameStatusZ(out) {
+    const tokens = out.split('\0');
+    const entries = [];
+    let i = 0;
+    while (i < tokens.length) {
+        const status = tokens[i] ?? '';
+        if (!status) {
+            i += 1;
+            continue;
+        }
+        if (/^[RC]/.test(status)) {
+            entries.push({ status, oldPath: tokens[i + 1] ?? '', path: tokens[i + 2] ?? '' });
+            i += 3;
+        }
+        else {
+            entries.push({ status, path: tokens[i + 1] ?? '' });
+            i += 2;
+        }
+    }
+    return entries;
+}
+/** Split one `git diff --patch` blob into per-file sections, in git's file
+ *  order (the same order `--numstat`/`--name-status` use). Exported for tests. */
+export function splitPatch(patch) {
+    if (!patch.trim())
+        return [];
+    const starts = [];
+    const re = /^diff --git /gm;
+    for (let m = re.exec(patch); m; m = re.exec(patch))
+        starts.push(m.index);
+    return starts.map((start, idx) => patch.slice(start, starts[idx + 1] ?? patch.length));
+}
+function statusWord(letter) {
+    switch (letter[0]) {
+        case 'A':
+            return 'added';
+        case 'D':
+            return 'deleted';
+        case 'R':
+            return 'renamed';
+        case 'C':
+            return 'copied';
+        default:
+            // M, T (typechange), U — the GUI treats them all as "modified".
+            return 'modified';
+    }
+}
+/**
+ * Structured "what changed here" for a directory vs its base branch:
+ * committed + uncommitted + untracked (via `add -N`), anchored at the
+ * merge-base so the diff stays *this task's* changes even after the base
+ * moves on — the exact resolution `worktreeDiff` (src/git-worktree.ts) uses
+ * for the text-blob `/diff` endpoint, which stays untouched.
+ */
+export async function collectChanges(dir, baseBranch, opts = {}) {
+    const patchCap = opts.patchCap ?? PATCH_CAP;
+    // `git add -N .` (intent-to-add) makes untracked files appear in the diff, but it MUTATES the
+    // index — fine in a task worktree cezar owns, but forbidden on the user's real main tree (a
+    // read-only GET must never stage files, #major-index-mutation). When `intentToAdd` is false we
+    // build a SCRATCH index (GIT_INDEX_FILE) seeded from HEAD + intent-to-add, so untracked files
+    // still show WITHOUT touching the user's real index.
+    let env;
+    let scratchIndex;
+    try {
+        if (opts.intentToAdd === false) {
+            scratchIndex = join(tmpdir(), `cez-scratch-index-${process.pid}-${scratchSeq++}`);
+            env = { GIT_INDEX_FILE: scratchIndex };
+            await git(dir, ['read-tree', 'HEAD'], env); // seed with tracked files; harmless if no HEAD
+            await git(dir, ['add', '-N', '.'], env);
+        }
+        else {
+            await git(dir, ['add', '-N', '.']);
+        }
+        const mergeBase = await git(dir, ['merge-base', baseBranch, 'HEAD']);
+        const base = mergeBase.ok && mergeBase.stdout.trim() ? mergeBase.stdout.trim() : baseBranch;
+        const nameStatus = await git(dir, ['diff', '--name-status', '-z', '-M', base], env);
+        if (!nameStatus.ok)
+            return { ok: false, error: gitReason(nameStatus, 'git diff failed') };
+        const numstat = await git(dir, ['diff', '--numstat', '-z', '-M', base], env);
+        if (!numstat.ok)
+            return { ok: false, error: gitReason(numstat, 'git diff failed') };
+        const patchOut = await git(dir, ['diff', '--patch', '-M', '--no-color', base], env);
+        if (!patchOut.ok)
+            return { ok: false, error: gitReason(patchOut, 'git diff failed') };
+        return { ok: true, changes: assemblePayload(nameStatus.stdout, numstat.stdout, patchOut.stdout, patchCap) };
+    }
+    finally {
+        if (scratchIndex)
+            rmSync(scratchIndex, { force: true });
+    }
+}
+/** Monotonic suffix for scratch index files, so concurrent /api/repo/changes calls never share
+ *  one (each is cleaned up in the finally above). */
+let scratchSeq = 0;
+/** The three raw `git diff` listings (name-status, numstat, patch) → the `{files, stat}`
+ *  payload. Shared by the working-tree diff above and the commit diff below — the listings
+ *  come out in git's path order either way, so index-matching the patch sections is safe;
+ *  a length mismatch degrades to "no patch". */
+function assemblePayload(nameStatusOut, numstatOut, patchOut, patchCap) {
+    const statuses = parseNameStatusZ(nameStatusOut);
+    const counts = parseNumstatZ(numstatOut);
+    const patches = splitPatch(patchOut);
+    const countByPath = new Map(counts.map((entry) => [entry.path, entry]));
+    const files = statuses.map((entry, idx) => {
+        const count = countByPath.get(entry.path);
+        let patch = patches.length === statuses.length ? (patches[idx] ?? '') : '';
+        if (patch.length > patchCap)
+            patch = `${patch.slice(0, patchCap)}\n… (patch truncated)`;
+        return {
+            path: entry.path,
+            ...(entry.oldPath ? { oldPath: entry.oldPath } : {}),
+            status: statusWord(entry.status),
+            adds: count?.adds ?? 0,
+            dels: count?.dels ?? 0,
+            binary: count?.binary ?? false,
+            patch,
+        };
+    });
+    return {
+        files,
+        stat: {
+            adds: files.reduce((sum, f) => sum + f.adds, 0),
+            dels: files.reduce((sum, f) => sum + f.dels, 0),
+            files: files.length,
+        },
+    };
+}
+/**
+ * The commits a run made on its worktree branch: `<merge-base>..HEAD`, newest first — the same
+ * range `collectChanges` diffs, so the commit list and the aggregate Changes tab always agree on
+ * what "this task's work" means. Empty (not an error) when the branch has no commits past base.
+ */
+export async function collectRunCommits(dir, baseBranch) {
+    const mergeBase = await git(dir, ['merge-base', baseBranch, 'HEAD']);
+    const base = mergeBase.ok && mergeBase.stdout.trim() ? mergeBase.stdout.trim() : baseBranch;
+    const log = await git(dir, ['log', '--pretty=format:%H%x1f%s%x1f%an%x1f%cr', `${base}..HEAD`]);
+    if (!log.ok)
+        return { ok: false, error: gitReason(log, 'git log failed') };
+    const commits = log.stdout
+        .split('\n')
+        .filter(Boolean)
+        .map((line) => {
+        const [sha = '', subject = '', author = '', when = ''] = line.split('\x1f');
+        return { sha, subject, author, when };
+    });
+    return { ok: true, commits };
+}
+/**
+ * Structured diff of ONE commit vs its first parent (`--root` covers the initial commit).
+ * A merge commit honestly answers zero files — `git diff-tree` shows no diff for merges
+ * without `-m`/`-c`, and inventing one side's diff would misattribute the changes.
+ * Unknown/invalid shas degrade to `{ ok:false, error }` for the route's 409.
+ */
+export async function collectCommitChanges(dir, sha, patchCap = PATCH_CAP) {
+    if (!/^[0-9a-f]{4,40}$/i.test(sha))
+        return { ok: false, error: `not a commit hash: ${sha}` };
+    const meta = await git(dir, ['show', '-s', '--format=%H%x1f%s%x1f%an%x1f%cr', `${sha}^{commit}`]);
+    if (!meta.ok)
+        return { ok: false, error: gitReason(meta, `unknown commit: ${sha}`) };
+    const [fullSha = '', subject = '', author = '', when = ''] = meta.stdout.trim().split('\x1f');
+    const common = ['diff-tree', '--no-commit-id', '--root', '-r', '-M'];
+    const nameStatus = await git(dir, [...common, '--name-status', '-z', fullSha]);
+    if (!nameStatus.ok)
+        return { ok: false, error: gitReason(nameStatus, 'git diff-tree failed') };
+    const numstat = await git(dir, [...common, '--numstat', '-z', fullSha]);
+    if (!numstat.ok)
+        return { ok: false, error: gitReason(numstat, 'git diff-tree failed') };
+    const patchOut = await git(dir, [...common, '--patch', '--no-color', fullSha]);
+    if (!patchOut.ok)
+        return { ok: false, error: gitReason(patchOut, 'git diff-tree failed') };
+    const payload = assemblePayload(nameStatus.stdout, numstat.stdout, patchOut.stdout, patchCap);
+    return { ok: true, commit: { sha: fullSha, subject, author, when, ...payload } };
+}
+// ---- worktree file browsing ---------------------------------------------------
+/** Max file content served to the Files tab — past this the GUI shows an
+ *  honest "too large" state instead of the bytes. */
+export const FILE_CONTENT_CAP = 512_000;
+/**
+ * Extensions the Files tab renders inline as `<img>` — the only kinds the
+ * `/files?raw=1` mode will ever serve as bytes (anything else stays JSON, so a
+ * worktree HTML file can never become a same-origin document). SVG is included:
+ * inert inside `<img>`, and the raw response carries a no-script CSP for the
+ * "opened the URL directly" case. Keep in sync with IMAGE_EXTENSIONS in
+ * web/app/src/routes/task-git/file-preview.tsx.
+ */
+const IMAGE_MIME = {
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    svg: 'image/svg+xml',
+    bmp: 'image/bmp',
+    ico: 'image/x-icon',
+    avif: 'image/avif',
+};
+/** The image MIME type for a path, or null when it is not an image we serve raw. */
+export function imageMimeType(path) {
+    const name = path.slice(path.lastIndexOf('/') + 1);
+    const dot = name.lastIndexOf('.');
+    if (dot <= 0)
+        return null;
+    return IMAGE_MIME[name.slice(dot + 1).toLowerCase()] ?? null;
+}
+/** True when the first 8 KB contain a NUL byte — good enough for a viewer flag. */
+async function sniffBinary(path, size) {
+    const handle = await open(path, 'r');
+    try {
+        const len = Math.min(size, 8192);
+        if (len === 0)
+            return false;
+        const buf = Buffer.alloc(len);
+        await handle.read(buf, 0, len, 0);
+        return buf.includes(0);
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Directory listing or file content from inside `root`, traversal-safe:
+ * anything resolving outside the root (dot-segments, absolute paths, NUL) is
+ * rejected — same "not a file we serve" stance as `isSafeAssetFilename` in
+ * src/server/static-ui.ts. `.git` and symlinks are off-limits too.
+ */
+export async function readWorktreePath(root, relPath, contentCap = FILE_CONTENT_CAP) {
+    if (relPath.includes('\0'))
+        return { kind: 'invalid', error: 'invalid path' };
+    const rootAbs = resolve(root);
+    const target = resolve(rootAbs, relPath);
+    if (target !== rootAbs && !target.startsWith(rootAbs + sep)) {
+        return { kind: 'invalid', error: `path escapes the worktree: ${relPath}` };
+    }
+    const gitDir = join(rootAbs, '.git');
+    if (target === gitDir || target.startsWith(gitDir + sep)) {
+        return { kind: 'invalid', error: '.git internals are not browsable' };
+    }
+    const display = target === rootAbs ? '' : target.slice(rootAbs.length + 1).split(sep).join('/');
+    let info;
+    try {
+        info = await lstat(target);
+    }
+    catch {
+        return { kind: 'missing', error: `no such file or directory in the worktree: ${relPath || '/'}` };
+    }
+    if (info.isSymbolicLink()) {
+        return { kind: 'invalid', error: `symlinks are not served: ${display}` };
+    }
+    // Intermediate symlinked DIRECTORIES: `resolve()` never follows links and the `lstat` above
+    // only guards the final component, so a path through a symlinked dir (e.g. `link/secret.txt`
+    // where `link -> /etc`) would otherwise be served. Resolve the whole chain and re-check
+    // containment against the real root (#blocker-symlink-traversal).
+    let realTarget;
+    let realRoot;
+    try {
+        realTarget = await realpath(target);
+        realRoot = await realpath(rootAbs);
+    }
+    catch {
+        return { kind: 'missing', error: `no such file or directory in the worktree: ${relPath || '/'}` };
+    }
+    if (realTarget !== realRoot && !realTarget.startsWith(realRoot + sep)) {
+        return { kind: 'invalid', error: `path escapes the worktree: ${relPath}` };
+    }
+    if (info.isDirectory()) {
+        const dirents = await readdir(target, { withFileTypes: true });
+        const entries = [];
+        for (const d of dirents) {
+            if (d.name === '.git')
+                continue;
+            if (d.isDirectory()) {
+                entries.push({ name: d.name, type: 'dir' });
+            }
+            else if (d.isFile()) {
+                const size = await stat(join(target, d.name))
+                    .then((s) => s.size)
+                    .catch(() => undefined);
+                entries.push({ name: d.name, type: 'file', ...(size !== undefined ? { size } : {}) });
+            }
+            // Symlinks, sockets, … deliberately omitted from the listing.
+        }
+        entries.sort((a, b) => (a.type === b.type ? a.name.localeCompare(b.name) : a.type === 'dir' ? -1 : 1));
+        return { kind: 'dir', path: display, entries };
+    }
+    if (!info.isFile())
+        return { kind: 'invalid', error: `not a regular file: ${display}` };
+    const binary = await sniffBinary(target, info.size).catch(() => true);
+    const tooLarge = info.size > contentCap;
+    if (binary || tooLarge) {
+        return { kind: 'file', path: display, size: info.size, binary, tooLarge };
+    }
+    const content = await readFile(target, 'utf8');
+    return { kind: 'file', path: display, size: info.size, binary: false, tooLarge: false, content };
+}
+/**
+ * Repo-view branch action (`POST /api/repo/branch`): switch to `name` when it
+ * already exists locally, otherwise create it from `from` (or HEAD) and switch.
+ * Name validation is delegated to `git check-ref-format --branch` — git's own
+ * rules, not a reimplementation. Predictable failures (invalid name, unknown
+ * `from`, dirty-tree checkout conflict) come back as `{ ok:false, error }`.
+ */
+export async function createOrSwitchBranch(dir, name, from) {
+    const check = await git(dir, ['check-ref-format', '--branch', name]);
+    if (!check.ok)
+        return { ok: false, error: `invalid branch name: ${name}` };
+    const exists = await git(dir, ['rev-parse', '--verify', '--quiet', `refs/heads/${name}`]);
+    if (exists.ok) {
+        const sw = await git(dir, ['checkout', name]);
+        if (!sw.ok)
+            return { ok: false, error: gitReason(sw, `git checkout ${name} failed`) };
+        return { ok: true, branch: name, created: false };
+    }
+    if (from) {
+        // `--quiet` keeps git silent on failure, so supply our own reason.
+        const start = await git(dir, ['rev-parse', '--verify', '--quiet', `${from}^{commit}`]);
+        if (!start.ok)
+            return { ok: false, error: `unknown start point: ${from}` };
+    }
+    const create = await git(dir, from ? ['checkout', '-b', name, from] : ['checkout', '-b', name]);
+    if (!create.ok)
+        return { ok: false, error: gitReason(create, `git checkout -b ${name} failed`) };
+    return { ok: true, branch: name, created: true };
+}
+/** `git add -A && git commit -m <message>` in `dir`. A clean tree, a failing
+ *  hook or missing identity all come back as `{ ok:false, error }`. */
+export async function commitAll(dir, message) {
+    const status = await git(dir, ['status', '--porcelain']);
+    if (!status.ok)
+        return { ok: false, error: gitReason(status, 'git status failed') };
+    if (!status.stdout.trim()) {
+        return { ok: false, error: 'nothing to commit — the working tree is clean' };
+    }
+    const add = await git(dir, ['add', '-A']);
+    if (!add.ok)
+        return { ok: false, error: gitReason(add, 'git add failed') };
+    const commit = await git(dir, ['commit', '-m', message]);
+    if (!commit.ok)
+        return { ok: false, error: gitReason(commit, 'git commit failed') };
+    const head = await git(dir, ['rev-parse', 'HEAD']);
+    return { ok: true, sha: head.ok ? head.stdout.trim() : '' };
+}
+/** Push the current branch, setting upstream when it has none. No remote,
+ *  detached HEAD and rejected pushes all degrade to `{ ok:false, error }`. */
+export async function pushCurrentBranch(dir) {
+    const branchRes = await git(dir, ['rev-parse', '--abbrev-ref', 'HEAD']);
+    if (!branchRes.ok)
+        return { ok: false, error: gitReason(branchRes, 'not a git repository') };
+    const branch = branchRes.stdout.trim();
+    if (!branch || branch === 'HEAD') {
+        return { ok: false, error: 'detached HEAD — check out a branch before pushing' };
+    }
+    const remotesRes = await git(dir, ['remote']);
+    const remotes = remotesRes.stdout.split('\n').map((r) => r.trim()).filter(Boolean);
+    if (remotes.length === 0) {
+        return { ok: false, error: 'no remote configured — add one with `git remote add origin <url>`' };
+    }
+    const remote = remotes.includes('origin') ? 'origin' : remotes[0];
+    const upstream = await git(dir, ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}']);
+    const args = upstream.ok ? ['push'] : ['push', '-u', remote, branch];
+    const push = await git(dir, args);
+    if (!push.ok)
+        return { ok: false, error: gitReason(push, 'git push failed') };
+    return { ok: true, branch, remote, upstreamSet: !upstream.ok };
+}
+//# sourceMappingURL=git-changes.js.map

package/dist/server/git-changes.js.map

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

package/dist/server/open-in-app.d.ts

@@ -0,0 +1,19 @@
+/**
+ * "Open in…" session takeover (#open-in): detect the editors / file managers / terminals on THIS
+ * machine, and open a run's worktree in the one the user picks — the desktop-app equivalent of
+ * the "cd <path>" hint. Local-only; the server gates these behind `localHandoff` (CEZ_REMOTE).
+ *
+ * Detection is best-effort and cross-platform: an editor counts as present if its CLI is on PATH
+ * or (macOS) its .app bundle is installed. Finder/file-manager and Terminal are always offered.
+ */
+export interface OpenTarget {
+    id: string;
+    label: string;
+}
+/** The runner behind a `cli:<runner>` open target, or null when the id isn't a CLI handoff. */
+export declare function agentCliRunner(targetId: string): 'claude' | 'codex' | 'opencode' | null;
+/** The open targets available on this machine: the file manager, a terminal, every detected
+ *  editor, and every installed coding-agent CLI. Order is stable so the menu never reshuffles. */
+export declare function detectOpenTargets(): OpenTarget[];
+/** Open `dir` in the given target. Unknown/unavailable target → false (the caller 409s). */
+export declare function openInApp(targetId: string, dir: string): Promise<boolean>;