light-plan 0.0.0-stage → 0.1.0

package/dist/core/gitsync/hosts.js

@@ -0,0 +1,115 @@
+/**
+ * The git hosts setup knows how to talk somebody through.
+ *
+ * Knowing a host is *help*, never a requirement: any URL git can push to works,
+ * and an unrecognised one is "a git server". What a host entry adds is what a
+ * person setting this up for the first time actually needs — what a URL to
+ * that host looks like, where an empty repository is created, and how git will
+ * find the credential — because the commonest way setup fails is a URL pasted
+ * from the wrong page, or a token git was never told about.
+ *
+ * light-plan stores no git credential. It runs git, and git asks its own
+ * credential helper (Git Credential Manager, the macOS keychain, an SSH key) —
+ * the same thing that answers when the person pushes their code. That is why
+ * every hint below points at git's configuration rather than at a light-plan
+ * command.
+ *
+ * Data only; the CLI prints it and the web serves it.
+ */
+export const GIT_HOSTS = [
+    {
+        id: 'github',
+        label: 'GitHub',
+        examples: ['https://github.com/<owner>/<repo>.git', 'git@github.com:<owner>/<repo>.git'],
+        create: 'https://github.com/new — leave it empty (no README, no licence).',
+        credentials: 'HTTPS: Git Credential Manager signs in through the browser, or use a personal access token with "Contents: read and write". SSH: add your public key at https://github.com/settings/keys.',
+    },
+    {
+        id: 'gitlab',
+        label: 'GitLab',
+        examples: ['https://gitlab.com/<group>/<project>.git', 'git@gitlab.com:<group>/<project>.git'],
+        create: 'New project → "Create blank project", with "Initialize repository with a README" unticked.',
+        credentials: 'HTTPS: a personal or project access token with write_repository (use it as the password). SSH: add your key under Preferences → SSH Keys.',
+    },
+    {
+        id: 'bitbucket',
+        label: 'Bitbucket',
+        examples: [
+            'https://<user>@bitbucket.org/<workspace>/<repo>.git',
+            'git@bitbucket.org:<workspace>/<repo>.git',
+        ],
+        create: 'Create → Repository, with "Include a README?" set to No.',
+        credentials: 'HTTPS: an app password or API token with repository write access (Git Credential Manager can store it). SSH: add your key under Personal settings → SSH keys.',
+    },
+    {
+        id: 'azure',
+        label: 'Azure DevOps',
+        examples: [
+            'https://dev.azure.com/<organization>/<project>/_git/<repo>',
+            'git@ssh.dev.azure.com:v3/<organization>/<project>/<repo>',
+        ],
+        create: 'Repos → "New repository", with "Add a README" unticked.',
+        credentials: 'HTTPS: Git Credential Manager signs in with your Microsoft account, or use a personal access token with Code (Read & write). SSH: add your key under User settings → SSH public keys.',
+    },
+    {
+        id: 'other',
+        label: 'Git server',
+        examples: ['https://<server>/<path>.git', 'ssh://<user>@<server>/<path>.git', '/path/to/shared/board.git'],
+        create: 'An empty (bare) repository: `git init --bare board.git` on the server or a shared drive.',
+        credentials: 'Whatever your git is already configured with for this server: a credential helper, or an SSH key.',
+    },
+];
+function hostOf(id) {
+    return GIT_HOSTS.find((host) => host.id === id);
+}
+/** The host name a URL points at, for HTTPS, `ssh://` and `user@host:path` forms. */
+function hostname(url) {
+    const trimmed = url.trim();
+    const scheme = trimmed.match(/^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]*@)?([^/:]+)/i);
+    if (scheme)
+        return scheme[1].toLowerCase();
+    const scp = trimmed.match(/^(?:[^@/]+@)?([^/:]+):(?!\/)/);
+    // A Windows drive letter ("C:\boards") is a path, not a host.
+    if (scp && scp[1].length > 1)
+        return scp[1].toLowerCase();
+    return '';
+}
+/** Which host a URL belongs to; `other` for anything unrecognised. */
+export function recognizeHost(url) {
+    const host = hostname(url);
+    if (host === 'github.com' || host.endsWith('.github.com'))
+        return hostOf('github');
+    if (host === 'bitbucket.org')
+        return hostOf('bitbucket');
+    if (host === 'dev.azure.com' || host === 'ssh.dev.azure.com' || host.endsWith('visualstudio.com')) {
+        return hostOf('azure');
+    }
+    if (host === 'gitlab.com' || host.startsWith('gitlab.'))
+        return hostOf('gitlab');
+    return hostOf('other');
+}
+/**
+ * Why a string cannot be a git URL, or null when git may as well try it. Loose
+ * on purpose — git is the judge — but a leading dash would be read as an
+ * option, and an empty string is a form somebody has not filled in.
+ */
+export function urlProblem(url) {
+    const trimmed = url.trim();
+    if (!trimmed)
+        return 'Give the URL of the repository the board should live in.';
+    // Spaces are allowed: a path to a bare repository on a shared drive may
+    // well have one, and git is passed the URL as one argument, never a shell.
+    if (trimmed.startsWith('-'))
+        return 'A repository URL cannot start with "-".';
+    return null;
+}
+/** Two URLs naming the same repository, ignoring a trailing `.git`, a slash and case. */
+export function sameRepositoryUrl(a, b) {
+    const norm = (url) => url
+        .trim()
+        .replace(/\/+$/, '')
+        .replace(/\.git$/i, '')
+        .toLowerCase();
+    return norm(a) === norm(b);
+}
+//# sourceMappingURL=hosts.js.map

package/dist/core/gitsync/hosts.js.map

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

package/dist/core/gitsync/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Sharing a board through its own git repository: the mechanism.
+ *
+ * `run` is the only way git is run (never waiting for a person), `repo` asks
+ * the repository questions and makes the few writes this layer needs,
+ * `integrate` brings fetched work into the board — fast-forward, or local work
+ * laid over upstream when the two touched different files, or a conflict when
+ * they touched the same one — `sync` is the network half and the write
+ * transaction, `status` the report, `hosts` the help a person setting this up
+ * is shown.
+ *
+ * The contract: when `git_sync` is configured, every operation that writes the
+ * board runs inside `sharedWrite` (operations/shared.ts makes that structural),
+ * so a write is either committed and pushed, or undone and refused. Nothing is
+ * ever merged inside a document. Front ends call `pullBoard` before they load,
+ * which keeps refusals rare; correctness does not depend on it.
+ *
+ * Sits between `board/` and `operations/`: it may read config and storage, and
+ * the operations that set sharing up (`operations/git-sync.ts`) are built on it.
+ */
+export * from './hosts.js';
+export type { IntegrateResult, Resolution } from './integrate.js';
+export { GIT_TIMEOUT_ENV } from './run.js';
+export * from './status.js';
+export { GIT_OFFLINE_ENV, describeFiles, fetchBoardAsync, isOffline, lastFetchOf, type FetchResult, type PullOutcome, } from './sync.js';

package/dist/core/gitsync/index.js

@@ -0,0 +1,25 @@
+/**
+ * Sharing a board through its own git repository: the mechanism.
+ *
+ * `run` is the only way git is run (never waiting for a person), `repo` asks
+ * the repository questions and makes the few writes this layer needs,
+ * `integrate` brings fetched work into the board — fast-forward, or local work
+ * laid over upstream when the two touched different files, or a conflict when
+ * they touched the same one — `sync` is the network half and the write
+ * transaction, `status` the report, `hosts` the help a person setting this up
+ * is shown.
+ *
+ * The contract: when `git_sync` is configured, every operation that writes the
+ * board runs inside `sharedWrite` (operations/shared.ts makes that structural),
+ * so a write is either committed and pushed, or undone and refused. Nothing is
+ * ever merged inside a document. Front ends call `pullBoard` before they load,
+ * which keeps refusals rare; correctness does not depend on it.
+ *
+ * Sits between `board/` and `operations/`: it may read config and storage, and
+ * the operations that set sharing up (`operations/git-sync.ts`) are built on it.
+ */
+export * from './hosts.js';
+export { GIT_TIMEOUT_ENV } from './run.js';
+export * from './status.js';
+export { GIT_OFFLINE_ENV, describeFiles, fetchBoardAsync, isOffline, lastFetchOf, } from './sync.js';
+//# sourceMappingURL=index.js.map

package/dist/core/gitsync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/gitsync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,GAGZ,MAAM,WAAW,CAAC"}

package/dist/core/gitsync/integrate.d.ts

@@ -0,0 +1,72 @@
+import type { GitSyncConfig } from '../model/types.js';
+/**
+ * Bringing what was fetched into the board.
+ *
+ * Three shapes, and the rule that separates the last two is the whole design:
+ *
+ *   - **behind** — fast-forward. Somebody else wrote; nothing here did.
+ *   - **diverged, different files** — what this checkout committed is laid on
+ *     top of upstream as one commit, and both changes stand. Two people
+ *     editing two stories is not a conflict, and refusing it would make a
+ *     shared board unusable.
+ *   - **diverged, the same file** — a conflict, and nothing moves. light-plan
+ *     cannot know whether your title and their status change belong together,
+ *     any more than `requireUnchanged` can, so it says so instead of merging
+ *     lines inside a document. A claim is exactly this case: two people wrote
+ *     the same `_issue.md`, and the second must be told rather than win.
+ *
+ * Two files are exempt from "the same file", because neither is anybody's
+ * writing: `INDEX.md` is derived and is rendered again from the result, and
+ * `state.json` holds counters, which merge by taking the larger of each. Two
+ * people creating an issue at the same moment still collide — on the folder
+ * both allocated, which *is* a document — but an issue here and a sprint there
+ * do not.
+ *
+ * Works through plumbing (`checkout <commit> -- <paths>`, `update-ref`) rather
+ * than `merge` or `rebase`, so it touches exactly the files it names and never
+ * leaves conflict markers, a half-finished rebase, or a stash behind in a
+ * folder people open in an editor.
+ */
+export type Resolution = 'ours' | 'theirs';
+export type IntegrateResult = 
+/** The branch does not exist on the remote yet; the first push creates it. */
+{
+    kind: 'no-upstream';
+} | {
+    kind: 'current';
+}
+/** Only local commits — nothing to bring in, something to push. */
+ | {
+    kind: 'ahead';
+    ahead: number;
+} | {
+    kind: 'fast-forward';
+    files: string[];
+}
+/** Local work laid over upstream. */
+ | {
+    kind: 'rebased';
+    files: string[];
+} | {
+    kind: 'conflict';
+    /**
+     * `diverged`: committed work here and upstream changed the same files.
+     * `uncommitted`: incoming work would overwrite edits nobody committed.
+     */
+    reason: 'diverged' | 'uncommitted';
+    paths: string[];
+};
+export interface IntegrateOptions {
+    /**
+     * Settle a `diverged` conflict instead of reporting it: `ours` keeps this
+     * checkout's version of every contested file, `theirs` takes upstream's.
+     */
+    resolve?: Resolution;
+    /** The board's index rendered from what is on disk now, or null if it cannot be. */
+    renderIndex?: () => string | null;
+    /** Say what would happen, and change nothing. */
+    dryRun?: boolean;
+}
+/** Make the working tree hold `commit`'s version of `files` (absent ones deleted). */
+export declare function materialize(dir: string, commit: string, files: readonly string[]): void;
+export declare function integrate(dir: string, sync: GitSyncConfig, options?: IntegrateOptions): IntegrateResult;

package/dist/core/gitsync/integrate.js

@@ -0,0 +1,115 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { BoardError } from '../errors.js';
+import { INDEX_FILE, STATE_FILE } from '../storage/paths.js';
+import { changedBetween, commitFiles, dirtyPaths, fileAt, filesAt, headOf, mergeBase, moveHead, countBetween, resolveRef, subjectsBetween, syncIndex, trackingRef, writeWorkingFile, } from './repo.js';
+import { firstLine, git } from './run.js';
+/** Files nobody writes by hand, which therefore never count as contested. */
+const DERIVED = new Set([INDEX_FILE, STATE_FILE]);
+/** Make the working tree hold `commit`'s version of `files` (absent ones deleted). */
+export function materialize(dir, commit, files) {
+    if (!files.length)
+        return;
+    const present = filesAt(dir, commit);
+    const there = files.filter((file) => present.has(file));
+    const gone = files.filter((file) => !present.has(file));
+    if (there.length) {
+        const result = git(dir, ['checkout', commit, '--pathspec-from-file=-', '--pathspec-file-nul'], {
+            input: there.join('\0'),
+        });
+        if (!result.ok)
+            throw new BoardError('Could not update the board from git', [firstLine(result.stderr)]);
+    }
+    for (const file of gone) {
+        if (existsSync(path.join(dir, file)))
+            writeWorkingFile(dir, file, null);
+    }
+}
+/** `state.json` from both sides, keeping the higher of every counter. */
+function mergedState(dir, ours, theirs) {
+    const read = (commit) => {
+        const bytes = fileAt(dir, commit, STATE_FILE);
+        if (!bytes)
+            return {};
+        try {
+            return JSON.parse(bytes.toString('utf8'));
+        }
+        catch {
+            return {};
+        }
+    };
+    const a = read(ours);
+    const b = read(theirs);
+    const merged = { ...b, ...a };
+    for (const key of new Set([...Object.keys(a), ...Object.keys(b)])) {
+        const left = a[key];
+        const right = b[key];
+        if (typeof left === 'number' && typeof right === 'number')
+            merged[key] = Math.max(left, right);
+    }
+    return Object.keys(merged).length ? Buffer.from(`${JSON.stringify(merged, null, 2)}\n`, 'utf8') : null;
+}
+export function integrate(dir, sync, options = {}) {
+    const upstream = resolveRef(dir, trackingRef(sync.remote, sync.branch));
+    if (!upstream)
+        return { kind: 'no-upstream' };
+    const head = headOf(dir);
+    if (!head) {
+        throw new BoardError('The board repository has no commits yet', ['Run `lpm git setup` to share it.']);
+    }
+    if (head === upstream)
+        return { kind: 'current' };
+    const base = mergeBase(dir, head, upstream);
+    if (base === upstream)
+        return { kind: 'ahead', ahead: countBetween(dir, upstream, head) };
+    if (!base) {
+        throw new BoardError(`The board and ${sync.remote}/${sync.branch} share no history`, [
+            'They are two different boards. Run `lpm git status` for the remote this one points at,',
+            'or move this .lpm aside and run `lpm git join` to work on the shared one.',
+        ]);
+    }
+    const incoming = changedBetween(dir, base, upstream);
+    const ours = base === head ? [] : changedBetween(dir, base, head);
+    const touched = new Set([...incoming, ...ours]);
+    // Uncommitted edits in the way. The index is derived, so a local copy of it
+    // is simply dropped and taken from whichever side wins.
+    const dirty = dirtyPaths(dir);
+    const blocked = dirty.filter((file) => touched.has(file) && file !== INDEX_FILE);
+    if (blocked.length)
+        return { kind: 'conflict', reason: 'uncommitted', paths: blocked.sort() };
+    if (base === head) {
+        if (options.dryRun)
+            return { kind: 'fast-forward', files: incoming };
+        materialize(dir, upstream, incoming);
+        moveHead(dir, upstream, `lpm: fast-forward to ${sync.remote}/${sync.branch}`);
+        syncIndex(dir, incoming);
+        return { kind: 'fast-forward', files: incoming };
+    }
+    const incomingSet = new Set(incoming);
+    const contested = ours.filter((file) => incomingSet.has(file) && !DERIVED.has(file)).sort();
+    if (contested.length && !options.resolve) {
+        return { kind: 'conflict', reason: 'diverged', paths: contested };
+    }
+    if (options.dryRun)
+        return { kind: 'rebased', files: [...touched].sort() };
+    const subjects = subjectsBetween(dir, base, head);
+    const contestedSet = new Set(contested);
+    const keep = ours.filter((file) => !DERIVED.has(file) && (options.resolve === 'ours' || !contestedSet.has(file)));
+    // Stand on upstream for everything either side changed, then lay our files
+    // back over it. The commit `head` stays in the object store, so nothing of
+    // ours is lost even if a step below fails.
+    materialize(dir, upstream, [...touched]);
+    moveHead(dir, upstream, `lpm: re-apply local work on ${sync.remote}/${sync.branch}`);
+    syncIndex(dir, [...touched]);
+    materialize(dir, head, keep);
+    const state = mergedState(dir, head, upstream);
+    if (state)
+        writeWorkingFile(dir, STATE_FILE, state);
+    const index = options.renderIndex?.();
+    if (index)
+        writeWorkingFile(dir, INDEX_FILE, Buffer.from(index, 'utf8'));
+    const message = subjects.length === 1 ? subjects[0] : `lpm: ${subjects.length} board changes\n\n${subjects.map((s) => `- ${s}`).join('\n')}`;
+    commitFiles(dir, [...keep, STATE_FILE, INDEX_FILE], message);
+    return { kind: 'rebased', files: [...touched].sort() };
+}
+//# sourceMappingURL=integrate.js.map

package/dist/core/gitsync/integrate.js.map

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

package/dist/core/gitsync/repo.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Questions about the `.lpm` repository, and the handful of writes the sync
+ * layer makes to it. Every path in and out of here is relative to the
+ * repository root (the board folder), with forward slashes — git's spelling.
+ */
+/** True when `dir` is the root of a git repository of its own. */
+export declare function isOwnRepo(dir: string): boolean;
+/** The commit a ref names, or null when it names nothing. */
+export declare function resolveRef(dir: string, ref: string): string | null;
+export declare function headOf(dir: string): string | null;
+/** The remote-tracking ref this board's branch is fetched into. */
+export declare function trackingRef(remote: string, branch: string): string;
+export declare function remoteUrl(dir: string, remote: string): string | null;
+/** The name of the checked-out branch, or null on a detached HEAD. */
+export declare function currentBranch(dir: string): string | null;
+export declare function mergeBase(dir: string, a: string, b: string): string | null;
+/** How many commits `from` has that `to` does not. */
+export declare function countBetween(dir: string, to: string, from: string): number;
+/** Files that differ between two commits. */
+export declare function changedBetween(dir: string, from: string, to: string): string[];
+/**
+ * Paths with uncommitted changes, untracked files included and ignored ones not.
+ * `--no-optional-locks` because this runs on every write, and a status that
+ * takes the index lock to refresh stat data collides with whatever git command
+ * the person is running in another window.
+ */
+export declare function dirtyPaths(dir: string): string[];
+/** Every path the commit holds. */
+export declare function filesAt(dir: string, commit: string): Set<string>;
+/** A file as one commit holds it, or null when it does not. */
+export declare function fileAt(dir: string, commit: string, file: string): Buffer | null;
+/** Subject lines of the commits in `from..to`, oldest first. */
+export declare function subjectsBetween(dir: string, from: string, to: string): string[];
+/**
+ * The bytes of a working-tree file — the before-and-after picture a write is
+ * measured by. `null` means "not there".
+ */
+export interface FileState {
+    hash: string | null;
+    /** The content itself, kept so an undone write can put it back. */
+    bytes: Buffer | null;
+}
+export declare function fileState(dir: string, file: string): FileState;
+/** Put a working-tree file back to `bytes`, or delete it when `bytes` is null. */
+export declare function writeWorkingFile(dir: string, file: string, bytes: Buffer | null): void;
+/**
+ * Commit exactly `files` — their current working-tree state, deletions
+ * included — on top of HEAD, and nothing else.
+ *
+ * Built in a private index rather than the repository's own, so whatever the
+ * person had staged, or left dirty in another file (a view the web app keeps
+ * saving, a hand edit in progress), is neither swept into the commit nor
+ * disturbed by it. The real index is then brought level for these paths only.
+ *
+ * Returns the new commit, or null when the files already match HEAD.
+ */
+export declare function commitFiles(dir: string, files: readonly string[], message: string): string | null;
+/** Bring the repository's own index level with HEAD for these paths only. */
+export declare function syncIndex(dir: string, files: readonly string[]): void;
+/** Move the branch to `commit` without touching the working tree. */
+export declare function moveHead(dir: string, commit: string, message: string): void;

package/dist/core/gitsync/repo.js

@@ -0,0 +1,213 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { BoardError } from '../errors.js';
+import { firstLine, git, gitBytes } from './run.js';
+/**
+ * Questions about the `.lpm` repository, and the handful of writes the sync
+ * layer makes to it. Every path in and out of here is relative to the
+ * repository root (the board folder), with forward slashes — git's spelling.
+ */
+/** True when `dir` is the root of a git repository of its own. */
+export function isOwnRepo(dir) {
+    // `.git` beside the board, not merely "inside some work tree": a `.lpm` with
+    // no repository of its own sits inside the project's, and every command here
+    // would otherwise run against the code.
+    return existsSync(path.join(dir, '.git'));
+}
+/** The commit a ref names, or null when it names nothing. */
+export function resolveRef(dir, ref) {
+    const result = git(dir, ['rev-parse', '--verify', '--quiet', `${ref}^{commit}`]);
+    return result.ok ? result.stdout.trim() || null : null;
+}
+export function headOf(dir) {
+    return resolveRef(dir, 'HEAD');
+}
+/** The remote-tracking ref this board's branch is fetched into. */
+export function trackingRef(remote, branch) {
+    return `refs/remotes/${remote}/${branch}`;
+}
+export function remoteUrl(dir, remote) {
+    const result = git(dir, ['remote', 'get-url', remote]);
+    return result.ok ? result.stdout.trim() || null : null;
+}
+/** The name of the checked-out branch, or null on a detached HEAD. */
+export function currentBranch(dir) {
+    const result = git(dir, ['symbolic-ref', '--quiet', '--short', 'HEAD']);
+    return result.ok ? result.stdout.trim() || null : null;
+}
+export function mergeBase(dir, a, b) {
+    const result = git(dir, ['merge-base', a, b]);
+    return result.ok ? result.stdout.trim() || null : null;
+}
+/** How many commits `from` has that `to` does not. */
+export function countBetween(dir, to, from) {
+    const result = git(dir, ['rev-list', '--count', `${to}..${from}`]);
+    return result.ok ? Number(result.stdout.trim()) || 0 : 0;
+}
+function splitZ(text) {
+    return text.split('\0').filter(Boolean);
+}
+/** Files that differ between two commits. */
+export function changedBetween(dir, from, to) {
+    const result = git(dir, ['diff', '--name-only', '-z', '--no-renames', from, to]);
+    if (!result.ok)
+        throw new BoardError('Could not compare two versions of the board', [firstLine(result.stderr)]);
+    return splitZ(result.stdout);
+}
+/**
+ * Paths with uncommitted changes, untracked files included and ignored ones not.
+ * `--no-optional-locks` because this runs on every write, and a status that
+ * takes the index lock to refresh stat data collides with whatever git command
+ * the person is running in another window.
+ */
+export function dirtyPaths(dir) {
+    const result = git(dir, [
+        '--no-optional-locks',
+        'status',
+        '--porcelain=v1',
+        '-z',
+        '--untracked-files=all',
+        '--no-renames',
+    ]);
+    if (!result.ok)
+        throw new BoardError('Could not read the state of the board repository', [firstLine(result.stderr)]);
+    return splitZ(result.stdout).map((entry) => entry.slice(3));
+}
+/** Every path the commit holds. */
+export function filesAt(dir, commit) {
+    const result = git(dir, ['ls-tree', '-r', '-z', '--name-only', commit]);
+    return new Set(result.ok ? splitZ(result.stdout) : []);
+}
+/** A file as one commit holds it, or null when it does not. */
+export function fileAt(dir, commit, file) {
+    return gitBytes(dir, ['cat-file', 'blob', `${commit}:${file}`]);
+}
+/** Subject lines of the commits in `from..to`, oldest first. */
+export function subjectsBetween(dir, from, to) {
+    const result = git(dir, ['log', '--reverse', '--format=%s', `${from}..${to}`]);
+    return result.ok ? result.stdout.split('\n').map((line) => line.trim()).filter(Boolean) : [];
+}
+/** Files above this size are compared by hash only and never restored from memory. */
+const KEEP_BYTES_LIMIT = 4 * 1024 * 1024;
+export function fileState(dir, file) {
+    const full = path.join(dir, file);
+    try {
+        if (!statSync(full).isFile())
+            return { hash: null, bytes: null };
+        const bytes = readFileSync(full);
+        const hash = createHash('sha1').update(bytes).digest('hex');
+        return { hash, bytes: bytes.length <= KEEP_BYTES_LIMIT ? bytes : null };
+    }
+    catch {
+        return { hash: null, bytes: null };
+    }
+}
+/** Put a working-tree file back to `bytes`, or delete it when `bytes` is null. */
+export function writeWorkingFile(dir, file, bytes) {
+    const full = path.join(dir, file);
+    if (bytes === null) {
+        rmSync(full, { force: true });
+        return;
+    }
+    mkdirSync(path.dirname(full), { recursive: true });
+    writeFileSync(full, bytes);
+}
+/**
+ * Who a commit is signed by when git has not been told. A board written from a
+ * web page has nobody at a terminal to run `git config user.name`, and failing
+ * every write over a missing name would be a strange way to find out.
+ */
+function identityEnv(dir) {
+    const name = git(dir, ['config', 'user.name']).stdout.trim();
+    const email = git(dir, ['config', 'user.email']).stdout.trim();
+    if (name && email)
+        return {};
+    let user = 'light-plan';
+    try {
+        user = os.userInfo().username || user;
+    }
+    catch {
+        // Keep the fallback.
+    }
+    const fallbackName = name || user;
+    const fallbackEmail = email || `${user}@${os.hostname() || 'localhost'}`;
+    return {
+        GIT_AUTHOR_NAME: fallbackName,
+        GIT_AUTHOR_EMAIL: fallbackEmail,
+        GIT_COMMITTER_NAME: fallbackName,
+        GIT_COMMITTER_EMAIL: fallbackEmail,
+    };
+}
+/**
+ * Commit exactly `files` — their current working-tree state, deletions
+ * included — on top of HEAD, and nothing else.
+ *
+ * Built in a private index rather than the repository's own, so whatever the
+ * person had staged, or left dirty in another file (a view the web app keeps
+ * saving, a hand edit in progress), is neither swept into the commit nor
+ * disturbed by it. The real index is then brought level for these paths only.
+ *
+ * Returns the new commit, or null when the files already match HEAD.
+ */
+export function commitFiles(dir, files, message) {
+    if (!files.length)
+        return null;
+    const head = headOf(dir);
+    const gitDir = path.resolve(dir, git(dir, ['rev-parse', '--git-dir']).stdout.trim() || '.git');
+    const indexFile = path.join(gitDir, `lpm-index-${process.pid}-${Date.now()}`);
+    const env = { GIT_INDEX_FILE: indexFile, ...identityEnv(dir) };
+    try {
+        const read = git(dir, head ? ['read-tree', head] : ['read-tree', '--empty'], { env });
+        if (!read.ok)
+            throw new BoardError('Could not prepare a commit of the board', [firstLine(read.stderr)]);
+        // A path that is neither on disk nor in HEAD (created and deleted again
+        // within one write) is not a change git can name; leave it out rather than
+        // fail the whole commit on it.
+        const tracked = head ? filesAt(dir, head) : new Set();
+        const wanted = files.filter((file) => tracked.has(file) || existsSync(path.join(dir, file)));
+        if (!wanted.length)
+            return null;
+        const add = git(dir, ['add', '-A', '--pathspec-from-file=-', '--pathspec-file-nul'], {
+            env,
+            input: wanted.join('\0'),
+        });
+        if (!add.ok)
+            throw new BoardError('Could not stage the board change', [firstLine(add.stderr)]);
+        const tree = git(dir, ['write-tree'], { env }).stdout.trim();
+        if (!tree)
+            throw new BoardError('Could not write the board change to git');
+        if (head && git(dir, ['rev-parse', `${head}^{tree}`]).stdout.trim() === tree)
+            return null;
+        const commit = git(dir, ['commit-tree', tree, ...(head ? ['-p', head] : []), '-m', message], { env });
+        if (!commit.ok)
+            throw new BoardError('Could not commit the board change', [firstLine(commit.stderr)]);
+        const sha = commit.stdout.trim();
+        // Compare-and-swap: if something else moved HEAD while this was being
+        // built, refuse rather than write over it.
+        const update = git(dir, ['update-ref', '-m', message, 'HEAD', sha, ...(head ? [head] : [])]);
+        if (!update.ok)
+            throw new BoardError('The board repository moved while a change was being committed', [firstLine(update.stderr)]);
+    }
+    finally {
+        rmSync(indexFile, { force: true });
+    }
+    syncIndex(dir, files);
+    return headOf(dir);
+}
+/** Bring the repository's own index level with HEAD for these paths only. */
+export function syncIndex(dir, files) {
+    if (!files.length || !headOf(dir))
+        return;
+    git(dir, ['reset', '-q', 'HEAD', '--pathspec-from-file=-', '--pathspec-file-nul'], {
+        input: files.join('\0'),
+    });
+}
+/** Move the branch to `commit` without touching the working tree. */
+export function moveHead(dir, commit, message) {
+    const result = git(dir, ['update-ref', '-m', message, 'HEAD', commit]);
+    if (!result.ok)
+        throw new BoardError('Could not move the board branch', [firstLine(result.stderr)]);
+}
+//# sourceMappingURL=repo.js.map