@forgecart/cli 2.202610102045.0 → 2.202610110825.0

package/dist/src/sync/sync-repository.js

@@ -0,0 +1,396 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { access, mkdir, readdir, readFile, rm, rmdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { CliExitLadder, CliRefusal } from '../exit-ladder.js';
+import { SyncChangeKind } from './type/sync.types.js';
+/** Where sync keeps its private state, under the storefront's `.forgecart/` — which never travels. */
+export const SYNC_STATE_PATH = ['.forgecart', 'sync'];
+/** The private repository, and the index the laptop's tree is snapshotted into. */
+const REPOSITORY_DIR = 'board.git';
+const INDEX_FILE = 'sync.index';
+/**
+ * The global config every git run reads: a file that is never written, so the
+ * merchant's own `~/.gitconfig` — an `autocrlf`, a global excludes file — can
+ * never change what travels.
+ */
+const NO_GLOBAL_CONFIG_FILE = 'no-global.config';
+/** The ref the serving branch is fetched into, and the ref keeping the recorded base reachable. */
+const FETCHED_SERVING_REF = 'refs/sync/serving';
+const BASE_REF = 'refs/sync/base';
+/** The one ref a push bundle carries — the name the pod admits. */
+const PUSH_REF = 'refs/heads/serving';
+/** The carrier commit's message: the pod mints the landed commit itself. */
+const PUSH_MESSAGE = 'forgecart sync';
+/** The top-level entry of the serving tree that never travels: the platform's `.forgecart/`. */
+const PLATFORM_DIR = '.forgecart';
+/**
+ * What never travels: the laptop's `.forgecart/`, and every path the board's
+ * runtime ignore authority keeps out of serving history (the pod's
+ * `info/exclude`) — installed and generated trees, the platform's islands and
+ * every `.env`.
+ */
+const EXCLUDE_PATTERNS = [
+    `/${PLATFORM_DIR}/`,
+    '.forge/',
+    'node_modules/',
+    '.next/',
+    '.git/',
+    'repos/',
+    '.env',
+    '.env.*',
+    '*.tsbuildinfo',
+    'next-env.d.ts',
+    '.npm/',
+    '.worktrees/',
+];
+/** The private state directory's own ignore file: a merchant's repository never tracks any of it. */
+const STATE_DIR_GITIGNORE = '*\n';
+/** The status letters `git diff-tree` names a change with, as the change kinds sync reads. */
+const CHANGE_KINDS = new Map(Object.values(SyncChangeKind).map((kind) => [kind, kind]));
+/** The largest output one git run may hand back — a tree listing or a bundle path list. */
+const GIT_OUTPUT_LIMIT_BYTES = 256 * 1024 * 1024;
+/**
+ * The laptop's side of `forgecart sync` (#2781): a private bare git repository
+ * under `.forgecart/sync/`, its work tree the storefront. It snapshots the
+ * laptop's tree into its own index — the paths the board would carry, nothing
+ * the runtime keeps out of serving history — holds the serving commits the
+ * pulled bundles bring, writes a serving tree onto the laptop, and cuts the ONE
+ * commit a push sends as a git bundle on the serving tip.
+ *
+ * Every git run reads no system and no global config, and no `GIT_*` variable
+ * of the caller's: what travels never depends on the machine it runs on. The
+ * merchant's own repository, if the storefront is one, is never read or
+ * written.
+ */
+export class SyncRepository {
+    storefront;
+    stateDir;
+    gitDir;
+    constructor(storefront) {
+        this.storefront = storefront;
+        this.stateDir = join(storefront, ...SYNC_STATE_PATH);
+        this.gitDir = join(this.stateDir, REPOSITORY_DIR);
+    }
+    /**
+     * `git` must be on the PATH: sync keeps the laptop's tree in a git repository
+     * and moves it as git bundles. Refused by name, on exit 1.
+     */
+    static async assertGitOnPath() {
+        const found = await new Promise((resolve) => {
+            // eslint-disable-next-line sonarjs/no-os-command-from-path -- the merchant's own `git`, resolved from the PATH of the machine sync runs on; its install path is not portable
+            const child = spawn('git', ['--version'], { stdio: 'ignore' });
+            child.on('error', () => {
+                resolve(false);
+            });
+            child.on('close', (status) => {
+                resolve(status === 0);
+            });
+        });
+        if (found)
+            return;
+        throw new CliRefusal(CliExitLadder.error, [
+            'git is not on the PATH: sync keeps this storefront in a private git repository under .forgecart/sync and moves it as git bundles. Install git and re-run.',
+        ]);
+    }
+    /**
+     * Create the private repository on first use, and (re)write the paths that
+     * never travel. `git init --bare` refuses a work tree, so it alone runs
+     * without the repository's own environment.
+     */
+    async prepare() {
+        await mkdir(this.stateDir, { recursive: true });
+        await writeFile(join(this.stateDir, '.gitignore'), STATE_DIR_GITIGNORE, 'utf8');
+        if (!(await this.exists(join(this.gitDir, 'HEAD')))) {
+            const args = ['init', '--bare', '--quiet', this.gitDir];
+            this.assertSucceeded(args, await this.spawnGit(args, this.isolatedEnv(), {}));
+        }
+        await mkdir(join(this.gitDir, 'info'), { recursive: true });
+        await writeFile(this.excludeFile(), `${EXCLUDE_PATTERNS.join('\n')}\n`, 'utf8');
+    }
+    /** The laptop's tree as it stands — every path that travels — written into the private index. */
+    async snapshot() {
+        await this.git(['add', '--all', '--', '.']);
+        return this.line(await this.git(['write-tree']));
+    }
+    /** Whether the private repository holds `sha` as a commit. */
+    async hasCommit(sha) {
+        const run = await this.git(['cat-file', '-e', `${sha}^{commit}`], { allowFailure: true });
+        return run.status === 0;
+    }
+    /** The tree with no entry — the base of a first sync. */
+    async emptyTree() {
+        return this.line(await this.git(['mktree', '-z'], { input: '' }));
+    }
+    /**
+     * Take a pulled bundle's serving branch into the private repository — git's
+     * own fetch from the bundle file, which checks every object it admits — and
+     * answer the serving commit it carried. The bundle file lives only as long
+     * as the fetch.
+     */
+    async fetchBundle(bytes) {
+        const bundlePath = this.spoolPath('pull');
+        await writeFile(bundlePath, bytes);
+        try {
+            await this.git([
+                '-c',
+                'fetch.fsckObjects=true',
+                'fetch',
+                '--quiet',
+                '--no-tags',
+                bundlePath,
+                `+refs/heads/serving:${FETCHED_SERVING_REF}`,
+            ]);
+            return this.line(await this.git(['rev-parse', '--verify', `${FETCHED_SERVING_REF}^{commit}`]));
+        }
+        finally {
+            await rm(bundlePath, { force: true });
+        }
+    }
+    /** Keep `sha` — the recorded base — reachable whatever the serving branch does next. */
+    async keepBase(sha) {
+        await this.git(['update-ref', BASE_REF, sha]);
+    }
+    /** The tree of `commit` that travels: its own, without the platform's `.forgecart/`. */
+    async travellingTree(commit) {
+        const entries = await this.topLevelEntries(`${commit}^{tree}`);
+        return this.makeTree(entries.filter((entry) => this.entryName(entry) !== PLATFORM_DIR));
+    }
+    /** The paths `to` changes against `from`, path by path. */
+    async changes(from, to) {
+        const run = await this.git(['diff-tree', '-r', '-z', '--no-renames', from, to]);
+        const fields = run.stdout.split('\0');
+        const changes = [];
+        for (let index = 0; index + 1 < fields.length; index += 2) {
+            changes.push({ kind: this.changeKind(fields[index]), path: fields[index + 1] });
+        }
+        return changes;
+    }
+    /**
+     * Write the tree `to` onto the laptop, standing at `from`: every path `from`
+     * holds and `to` does not is removed, every path `to` adds or changes is
+     * written, and nothing else on the laptop — no ignored file, nothing that
+     * never travels — is touched. The private index then holds `to`, so every
+     * path of it stays tracked whatever the laptop's ignore rules say.
+     */
+    async materialize(from, to) {
+        const changes = await this.changes(from, to);
+        const removed = changes.filter((change) => change.kind === SyncChangeKind.DELETED);
+        const written = changes.filter((change) => change.kind !== SyncChangeKind.DELETED);
+        for (const change of removed) {
+            await this.removePath(change.path);
+        }
+        await this.checkOut(to, written.map((change) => change.path));
+        await this.git(['read-tree', to]);
+        return { written: written.length, removed: removed.length };
+    }
+    /**
+     * The ONE commit a push sends: the laptop's tree on the serving tip `serving`,
+     * keeping the platform's `.forgecart/` the serving tree carries — the laptop's
+     * own never travels.
+     */
+    async pushCommit(localTree, serving) {
+        const local = await this.topLevelEntries(localTree);
+        const platform = (await this.topLevelEntries(`${serving}^{tree}`)).filter((entry) => this.entryName(entry) === PLATFORM_DIR);
+        const tree = await this.makeTree([...local, ...platform]);
+        return this.line(await this.git(['commit-tree', tree, '-p', serving, '-m', PUSH_MESSAGE]));
+    }
+    /**
+     * `commit` as the git bundle a push sends: its one ref `refs/heads/serving`,
+     * its one prerequisite the serving tip `serving` it was cut on.
+     */
+    async pushBundle(commit, serving) {
+        await this.git(['update-ref', PUSH_REF, commit]);
+        const bundlePath = this.spoolPath('push');
+        try {
+            await this.git(['bundle', 'create', bundlePath, PUSH_REF, `^${serving}`]);
+            return await readFile(bundlePath);
+        }
+        finally {
+            await rm(bundlePath, { force: true });
+        }
+    }
+    /** The top-level entries of `tree`, in `ls-tree -z` form — the form `mktree -z` reads back. */
+    async topLevelEntries(tree) {
+        const run = await this.git(['ls-tree', '-z', tree]);
+        return run.stdout.split('\0').filter((entry) => entry !== '');
+    }
+    async makeTree(entries) {
+        const input = entries.map((entry) => `${entry}\0`).join('');
+        return this.line(await this.git(['mktree', '-z'], { input }));
+    }
+    /** An `ls-tree` entry's name: everything after its tab. */
+    entryName(entry) {
+        return entry.slice(entry.indexOf('\t') + 1);
+    }
+    /** A `diff-tree -z` record's status letter — the last word of its metadata. */
+    changeKind(metadata) {
+        const status = metadata.slice(metadata.lastIndexOf(' ') + 1);
+        const kind = CHANGE_KINDS.get(status);
+        if (kind === undefined) {
+            throw new Error(`git diff-tree answered a change sync cannot read: "${metadata}".`);
+        }
+        return kind;
+    }
+    /** Write `paths` of `tree` onto the laptop, replacing what stands there — through an index of its own. */
+    async checkOut(tree, paths) {
+        if (paths.length === 0)
+            return;
+        const indexFile = join(this.gitDir, `checkout-${randomUUID()}.index`);
+        try {
+            await this.git(['read-tree', tree], { indexFile });
+            await this.git(['checkout-index', '--force', '-z', '--stdin'], {
+                indexFile,
+                input: paths.map((path) => `${path}\0`).join(''),
+            });
+        }
+        finally {
+            await rm(indexFile, { force: true });
+        }
+    }
+    /** Remove one file the laptop holds, and every directory the removal leaves empty. */
+    async removePath(relativePath) {
+        await rm(join(this.storefront, relativePath), { force: true });
+        for (let parent = dirname(relativePath); parent !== '.'; parent = dirname(parent)) {
+            const directory = join(this.storefront, parent);
+            const entries = await this.entriesOf(directory);
+            if (entries === null || entries.length > 0)
+                return;
+            await rmdir(directory);
+        }
+    }
+    /** A directory's entries — null when it is gone. */
+    async entriesOf(directory) {
+        try {
+            return await readdir(directory);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+    async exists(path) {
+        try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** A fresh bundle path in the private state directory, alive for one transfer. */
+    spoolPath(purpose) {
+        return join(this.stateDir, `${purpose}-${randomUUID()}.bundle`);
+    }
+    excludeFile() {
+        return join(this.gitDir, 'info', 'exclude');
+    }
+    /** A one-line answer — an object id — without its newline. */
+    line(run) {
+        return run.stdout.trim();
+    }
+    /**
+     * Run git on the private repository, the storefront its work tree. A non-zero
+     * exit is an error naming the command and git's own words — unless the
+     * caller reads it as an answer.
+     */
+    async git(args, options = {}) {
+        const env = this.repositoryEnv(options.indexFile ?? join(this.gitDir, INDEX_FILE));
+        const run = await this.spawnGit([...this.gitFlags(), ...args], env, options);
+        if (options.allowFailure !== true)
+            this.assertSucceeded(args, run);
+        return run;
+    }
+    /** A git run that exited non-zero is an error naming the command and git's own words. */
+    assertSucceeded(args, run) {
+        if (run.status === 0)
+            return;
+        throw new Error(`git ${args.join(' ')} failed in ${this.storefront} (exit ${String(run.status)}): ${run.stderr.trim()}`);
+    }
+    async spawnGit(args, env, options) {
+        return new Promise((resolve, reject) => {
+            // eslint-disable-next-line sonarjs/no-os-command-from-path -- the merchant's own `git`, resolved from the PATH of the machine sync runs on; its install path is not portable
+            const child = spawn('git', args, {
+                cwd: this.storefront,
+                env,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            const stdout = [];
+            const stderr = [];
+            let size = 0;
+            child.stdout.on('data', (chunk) => {
+                size += chunk.length;
+                if (size > GIT_OUTPUT_LIMIT_BYTES) {
+                    child.kill();
+                    return;
+                }
+                stdout.push(chunk);
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr.push(chunk);
+            });
+            child.on('error', reject);
+            child.on('close', (status) => {
+                resolve({
+                    status: status ?? -1,
+                    stdout: Buffer.concat(stdout).toString('utf8'),
+                    stderr: Buffer.concat(stderr).toString('utf8'),
+                });
+            });
+            child.stdin.on('error', () => {
+                // A git that stops reading its input has exited: its status and its
+                // stderr, read on `close`, say why.
+            });
+            child.stdin.end(options.input ?? '');
+        });
+    }
+    /**
+     * The flags every run carries: byte-exact content, the work tree the bare
+     * repository is given, the paths that never travel as the only excludes
+     * besides the storefront's own `.gitignore`, and an identity for the carrier
+     * commit.
+     */
+    gitFlags() {
+        return [
+            '-c',
+            'core.autocrlf=false',
+            '-c',
+            'core.safecrlf=false',
+            '-c',
+            'core.quotepath=false',
+            '-c',
+            'core.bare=false',
+            '-c',
+            `core.excludesFile=${this.excludeFile()}`,
+            '-c',
+            'gc.auto=0',
+            '-c',
+            'commit.gpgsign=false',
+            '-c',
+            'user.name=forgecart sync',
+            '-c',
+            'user.email=sync@forgecart.local',
+        ];
+    }
+    /** The repository's environment: the private repository, the storefront as its work tree, and `indexFile`. */
+    repositoryEnv(indexFile) {
+        return {
+            ...this.isolatedEnv(),
+            GIT_DIR: this.gitDir,
+            GIT_WORK_TREE: this.storefront,
+            GIT_INDEX_FILE: indexFile,
+        };
+    }
+    /** The caller's environment without any `GIT_*` variable, reading no system and no global config. */
+    isolatedEnv() {
+        const inherited = Object.entries(process.env).filter(([key]) => !key.startsWith('GIT_'));
+        return {
+            ...Object.fromEntries(inherited),
+            GIT_CONFIG_NOSYSTEM: '1',
+            GIT_CONFIG_GLOBAL: join(this.stateDir, NO_GLOBAL_CONFIG_FILE),
+            GIT_TERMINAL_PROMPT: '0',
+        };
+    }
+}
+//# sourceMappingURL=sync-repository.js.map

package/dist/src/sync/sync-repository.js.map

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

package/dist/src/sync/sync-round.d.ts

@@ -0,0 +1,95 @@
+import type { CliCredentials } from '../authorization/type/cli-authorization.types.js';
+import { type SyncDivergenceSelection } from './sync-divergence.js';
+import type { SyncDotenvFile } from './sync-dotenv.file.js';
+import type { SyncRecordFile } from './sync-record.file.js';
+import type { SyncRepository } from './sync-repository.js';
+import { type SyncRoundEnd, type SyncRoundOptions } from './type/sync.types.js';
+import type { WorkspaceSyncClient } from './workspace-sync.client.js';
+/**
+ * One round of `forgecart sync` (#2781): read the board's serving commit,
+ * snapshot the laptop's tree, hold the serving tree locally, print the plan
+ * ONCE, and move what it says — the laptop's tree and the serving tree are the
+ * same tree when it ends, or nothing moved.
+ *
+ * Both sides are compared against the base — the serving commit the laptop
+ * last matched. Only the workspace changed: its tree is written onto the
+ * laptop. Only the laptop changed: its tree is committed on the serving tip and
+ * pushed as ONE git bundle, which the pod lands through its promote pipeline or
+ * rejects with the gates' diagnostics (exit 1). Both changed: ONE selection —
+ * local overrides workspace, workspace overrides local, or Abort — never a
+ * merge; an abort or an unanswered selection ends the run on exit 4. The
+ * merchant lines of `.env` travel with the tree; the platform's keys never do.
+ */
+export declare class SyncRound {
+    private readonly options;
+    private readonly credentials;
+    private readonly client;
+    private readonly repository;
+    private readonly records;
+    private readonly dotenv;
+    private readonly selection;
+    constructor(options: SyncRoundOptions, credentials: CliCredentials, client: WorkspaceSyncClient, repository: SyncRepository, records: SyncRecordFile, dotenv: SyncDotenvFile, selection: SyncDivergenceSelection);
+    /** Run the round; a board that moves under its push is read again, a bounded number of times. */
+    run(): Promise<SyncRoundEnd>;
+    private attempt;
+    /** Decide, print the plan once, and move what it says. */
+    private settle;
+    private verdictOf;
+    /** The two trees agree: record where they stand, and send `.env` lines the laptop changed. */
+    private inSync;
+    /** Only the workspace changed — or it overrides the laptop: its tree and its `.env` lines land on the laptop. */
+    private pull;
+    /** Only the laptop changed, and the run never pushes: nothing moves. */
+    private keepLocal;
+    /**
+     * Push the laptop's tree onto the serving tip — or over it, when local
+     * overrides workspace — as ONE commit in ONE bundle, with the changed `.env`
+     * lines. A tree the gates reject ends the run on exit 1 with their
+     * diagnostics; a board that moved before the push landed is read again.
+     */
+    private land;
+    /** Both sides changed: the selection decides which tree wins, or the run stops with nothing moved. */
+    private diverged;
+    /** The divergence in words, as its refusal prints it. */
+    private divergenceLines;
+    /**
+     * `--dry-run`: the plan, and every path a push would send — from the record
+     * and the serving commit alone, so the one read of the serving commit is all
+     * that leaves the machine. Nothing moves on either side.
+     */
+    private dryRun;
+    private dryVerdict;
+    /** The plan, printed once per round before anything moves. */
+    private printPlan;
+    /** The `.env` keys the plan carries, as a count. */
+    private envPlan;
+    private printChanges;
+    /** The record — when the private repository still holds its base; else a first sync. */
+    private heldRecord;
+    /** The serving commit, held in the private repository — fetched as a bundle unless it already is. */
+    private holdServing;
+    /**
+     * The bundle a pull reads: the serving commits since the recorded base when
+     * there is one, the whole board otherwise — or when the workspace cannot cut
+     * that delta. Which one is printed.
+     */
+    private pulledBundle;
+    /** The commit a push landed, held locally so the next round compares against it. */
+    private holdLanded;
+    /** The push, or null when the board moved past the commit it was cut on before it landed. */
+    private sendPush;
+    /** A push the workspace did not take: exit 1, with what refused it. */
+    private rejection;
+    /** The `.env` lines a round in sync sends alone — none for a run that never pushes. */
+    private sendEnvAlone;
+    /** The workspace's `.env` lines, taken — none when no bundle was read this round. */
+    private takeEnv;
+    private viewOf;
+    /** The travelling tree of the recorded base — the empty tree before a first sync. */
+    private baseOf;
+    /** Record that the laptop stands on `servingSha`, and keep that commit held. */
+    private record;
+    private settled;
+    private lastSync;
+    private short;
+}