@forgecart/cli 2.202610101403.0 → 2.202610110611.0

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

@@ -0,0 +1,355 @@
+import { CliExitLadder, CliRefusal } from '../exit-ladder.js';
+import { print } from '../output.js';
+import { SyncApiError } from './sync-api.error.js';
+import { SYNC_DIVERGED_CODE, SyncDivergedRefusal, } from './sync-divergence.js';
+import { SyncDivergenceChoice, SyncVerdict, } from './type/sync.types.js';
+/** How many times one round reads both sides when the board moves under its push, before it stops on the divergence. */
+const ROUND_ATTEMPTS = 3;
+/** The code the admin API answers a delta the pod cannot cut with: the whole board is pulled instead. */
+const SYNC_FAILED_CODE = 'WORKSPACE_SYNC_FAILED';
+/** A commit id in print: its first twelve digits. */
+const SHORT_SHA_LENGTH = 12;
+/** How many changed paths a divergence lists per side before it counts the rest. */
+const LISTED_PATHS = 20;
+/**
+ * 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 class SyncRound {
+    options;
+    credentials;
+    client;
+    repository;
+    records;
+    dotenv;
+    selection;
+    constructor(options, credentials, client, repository, records, dotenv, selection) {
+        this.options = options;
+        this.credentials = credentials;
+        this.client = client;
+        this.repository = repository;
+        this.records = records;
+        this.dotenv = dotenv;
+        this.selection = selection;
+    }
+    /** Run the round; a board that moves under its push is read again, a bounded number of times. */
+    async run() {
+        let attempt = await this.attempt();
+        for (let tries = 1; tries < ROUND_ATTEMPTS && attempt.kind === 'moved'; tries += 1) {
+            print('  the workspace moved while the push landed: reading both sides again');
+            attempt = await this.attempt();
+        }
+        if (attempt.kind === 'settled')
+            return attempt.end;
+        throw new SyncDivergedRefusal([
+            `${SYNC_DIVERGED_CODE} — the workspace kept moving while the push landed; nothing landed. Re-run to settle it.`,
+        ], attempt.point);
+    }
+    async attempt() {
+        print(`forgecart sync ${this.options.storefront}`);
+        const state = await this.client.state();
+        await this.repository.prepare();
+        const record = await this.heldRecord();
+        const local = await this.repository.snapshot();
+        if (this.options.dryRun)
+            return this.settled(await this.dryRun(state, record, local));
+        const serving = await this.holdServing(state.servingSha, record);
+        return this.settle(await this.viewOf(record, local, serving));
+    }
+    /** Decide, print the plan once, and move what it says. */
+    async settle(view) {
+        const verdict = this.verdictOf(view);
+        await this.printPlan(view, verdict);
+        switch (verdict) {
+            case SyncVerdict.IN_SYNC:
+                return this.settled(await this.inSync(view));
+            case SyncVerdict.PULL:
+                return this.settled(await this.pull(view));
+            case SyncVerdict.KEEP_LOCAL:
+                return this.settled(this.keepLocal(view));
+            case SyncVerdict.PUSH:
+                return this.land(view);
+            case SyncVerdict.DIVERGED:
+                return this.diverged(view);
+        }
+    }
+    verdictOf(view) {
+        if (view.local === view.serving.tree)
+            return SyncVerdict.IN_SYNC;
+        if (view.localChanges.length === 0)
+            return SyncVerdict.PULL;
+        if (view.workspaceChanges.length > 0)
+            return SyncVerdict.DIVERGED;
+        return this.options.pullOnly ? SyncVerdict.KEEP_LOCAL : SyncVerdict.PUSH;
+    }
+    /** The two trees agree: record where they stand, and send `.env` lines the laptop changed. */
+    async inSync(view) {
+        const env = await this.sendEnvAlone(view.record);
+        await this.record(view.serving.sha, env.digests);
+        const summary = `in sync at serving ${this.short(view.serving.sha)}; ${String(env.merged)} .env key(s) merged into the workspace`;
+        print(summary);
+        return { localTree: view.local, servingSha: view.serving.sha, summary };
+    }
+    /** Only the workspace changed — or it overrides the laptop: its tree and its `.env` lines land on the laptop. */
+    async pull(view) {
+        const materialized = await this.repository.materialize(view.local, view.serving.tree);
+        const env = await this.takeEnv(view);
+        await this.record(view.serving.sha, env.digests);
+        const summary = `pulled serving ${this.short(view.serving.sha)}: ${String(materialized.written)} file(s) written, ${String(materialized.removed)} removed, ${String(env.taken)} .env key(s) taken`;
+        print(summary);
+        return { localTree: view.serving.tree, servingSha: view.serving.sha, summary };
+    }
+    /** Only the laptop changed, and the run never pushes: nothing moves. */
+    keepLocal(view) {
+        const summary = `kept ${String(view.localChanges.length)} local change(s) unsent: --pull never pushes`;
+        print(summary);
+        return {
+            localTree: view.local,
+            servingSha: view.record?.servingSha ?? view.serving.sha,
+            summary,
+        };
+    }
+    /**
+     * 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.
+     */
+    async land(view) {
+        const sent = await this.repository.changes(view.serving.tree, view.local);
+        const outgoing = await this.dotenv.outgoing(view.record?.env ?? null);
+        const commit = await this.repository.pushCommit(view.local, view.serving.sha);
+        const bundle = await this.repository.pushBundle(commit, view.serving.sha);
+        const result = await this.sendPush(bundle, outgoing.lines);
+        if (result === null) {
+            return { kind: 'moved', point: { localTree: view.local, servingSha: view.serving.sha } };
+        }
+        if (!result.accepted)
+            throw this.rejection(result);
+        const landed = await this.holdLanded(result.servingSha, view.serving.sha);
+        await this.record(landed, outgoing.digests);
+        const summary = `pushed ${String(sent.length)} path(s): serving is ${this.short(landed)}; ${String(result.envKeys)} .env key(s) merged into the workspace`;
+        print(summary);
+        return this.settled({ localTree: view.local, servingSha: landed, summary });
+    }
+    /** Both sides changed: the selection decides which tree wins, or the run stops with nothing moved. */
+    async diverged(view) {
+        const choice = await this.selection.settle(this.divergenceLines(view), {
+            localTree: view.local,
+            servingSha: view.serving.sha,
+        });
+        if (choice === SyncDivergenceChoice.LOCAL)
+            return this.land(view);
+        return this.settled(await this.pull(view));
+    }
+    /** The divergence in words, as its refusal prints it. */
+    divergenceLines(view) {
+        const local = String(view.localChanges.length);
+        const workspace = String(view.workspaceChanges.length);
+        return [
+            `${SYNC_DIVERGED_CODE} — the workspace moved to serving ${this.short(view.serving.sha)} since ${this.lastSync(view.record)}, and both sides changed: ${local} local and ${workspace} workspace path(s).`,
+        ];
+    }
+    /**
+     * `--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.
+     */
+    async dryRun(state, record, local) {
+        const changes = await this.repository.changes(await this.baseOf(record), local);
+        const moved = record?.servingSha !== state.servingSha;
+        const outgoing = await this.dotenv.outgoing(record?.env ?? null);
+        print(`  serving    ${this.short(state.servingSha)}, ${this.lastSync(record)}`);
+        print(`  local      ${String(changes.length)} path(s) changed since the last sync`);
+        print(`  workspace  ${moved ? 'moved' : 'unchanged'} since the last sync`);
+        print(`  .env       ${String(outgoing.lines.length)} merchant key(s) a push would send`);
+        print(`  plan       ${this.dryVerdict(changes.length > 0, moved, state.servingSha)}`);
+        print('  paths a push would send:');
+        for (const change of changes)
+            print(`    ${change.kind} ${change.path}`);
+        const summary = 'dry run: nothing moved on either side';
+        print(summary);
+        return { localTree: local, servingSha: record?.servingSha ?? state.servingSha, summary };
+    }
+    dryVerdict(localChanged, moved, servingSha) {
+        if (localChanged && moved) {
+            return 'diverged unless both sides changed alike: a run asks which tree wins';
+        }
+        if (moved)
+            return `pull serving ${this.short(servingSha)}`;
+        if (!localChanged)
+            return 'in sync';
+        if (this.options.pullOnly)
+            return 'keep the local changes: --pull never pushes';
+        return `push onto serving ${this.short(servingSha)}`;
+    }
+    /** The plan, printed once per round before anything moves. */
+    async printPlan(view, verdict) {
+        print(`  serving    ${this.short(view.serving.sha)}, ${this.lastSync(view.record)}`);
+        print(`  local      ${String(view.localChanges.length)} path(s) changed since the last sync`);
+        print(`  workspace  ${String(view.workspaceChanges.length)} path(s) changed since the last sync`);
+        print(`  .env       ${await this.envPlan(view, verdict)}`);
+        print(`  plan       ${verdict}`);
+        if (verdict !== SyncVerdict.DIVERGED)
+            return;
+        this.printChanges('changed on this laptop', view.localChanges);
+        this.printChanges('changed on the workspace', view.workspaceChanges);
+    }
+    /** The `.env` keys the plan carries, as a count. */
+    async envPlan(view, verdict) {
+        const recorded = view.record?.env ?? null;
+        if (verdict === SyncVerdict.PULL) {
+            const taken = await this.dotenv.takeable(view.serving.envLines ?? [], recorded);
+            return `${String(taken)} merchant key(s) to take`;
+        }
+        if (this.options.pullOnly)
+            return 'nothing to send: --pull never pushes';
+        const outgoing = await this.dotenv.outgoing(recorded);
+        return `${String(outgoing.lines.length)} merchant key(s) to send`;
+    }
+    printChanges(heading, changes) {
+        print(`  ${heading}:`);
+        for (const change of changes.slice(0, LISTED_PATHS))
+            print(`    ${change.kind} ${change.path}`);
+        if (changes.length > LISTED_PATHS) {
+            print(`    … and ${String(changes.length - LISTED_PATHS)} more`);
+        }
+    }
+    /** The record — when the private repository still holds its base; else a first sync. */
+    async heldRecord() {
+        const record = await this.records.read();
+        if (record === null)
+            return null;
+        if (await this.repository.hasCommit(record.servingSha))
+            return record;
+        print(`  record     the last sync's base ${this.short(record.servingSha)} is gone from .forgecart/sync: syncing as a first sync`);
+        return null;
+    }
+    /** The serving commit, held in the private repository — fetched as a bundle unless it already is. */
+    async holdServing(servingSha, record) {
+        if (await this.repository.hasCommit(servingSha)) {
+            return {
+                sha: servingSha,
+                tree: await this.repository.travellingTree(servingSha),
+                envLines: null,
+            };
+        }
+        const bundle = await this.pulledBundle(record);
+        const sha = await this.repository.fetchBundle(bundle.bytes);
+        return { sha, tree: await this.repository.travellingTree(sha), envLines: bundle.envLines };
+    }
+    /**
+     * 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.
+     */
+    async pulledBundle(record) {
+        if (record === null) {
+            print('  fetch      the whole board: no recorded base');
+            return this.client.bundle('');
+        }
+        print(`  fetch      the serving commits since ${this.short(record.servingSha)}`);
+        try {
+            return await this.client.bundle(record.servingSha);
+        }
+        catch (error) {
+            if (!(error instanceof SyncApiError) || error.code !== SYNC_FAILED_CODE)
+                throw error;
+            print(`  fetch      the workspace cut no delta (${error.code}): the whole board instead`);
+            return this.client.bundle('');
+        }
+    }
+    /** The commit a push landed, held locally so the next round compares against it. */
+    async holdLanded(landed, cutOn) {
+        if (landed === null)
+            return cutOn;
+        if (await this.repository.hasCommit(landed))
+            return landed;
+        const bundle = await this.client.bundle(cutOn);
+        await this.repository.fetchBundle(bundle.bytes);
+        return (await this.repository.hasCommit(landed)) ? landed : cutOn;
+    }
+    /** The push, or null when the board moved past the commit it was cut on before it landed. */
+    async sendPush(bundle, envLines) {
+        try {
+            return await this.client.push(bundle, envLines);
+        }
+        catch (error) {
+            if (error instanceof SyncApiError && error.code === SYNC_DIVERGED_CODE)
+                return null;
+            throw error;
+        }
+    }
+    /** A push the workspace did not take: exit 1, with what refused it. */
+    rejection(result) {
+        const indented = (text) => text.split('\n').map((line) => `  ${line}`);
+        return new CliRefusal(CliExitLadder.error, [
+            `the workspace did not take the push; serving stays at ${this.short(result.servingSha ?? '')}, and this laptop's tree as it is:`,
+            ...result.gateMessages.flatMap(indented),
+            ...(result.runtimeError === null ? [] : indented(`runtime: ${result.runtimeError}`)),
+            ...result.seoFindings.flatMap((finding) => indented(`seo: ${finding}`)),
+        ]);
+    }
+    /** The `.env` lines a round in sync sends alone — none for a run that never pushes. */
+    async sendEnvAlone(record) {
+        if (this.options.pullOnly)
+            return { merged: 0, digests: record?.env ?? {} };
+        const outgoing = await this.dotenv.outgoing(record?.env ?? null);
+        if (outgoing.lines.length === 0)
+            return { merged: 0, digests: outgoing.digests };
+        const result = await this.client.push(null, outgoing.lines);
+        return { merged: result.envKeys, digests: outgoing.digests };
+    }
+    /** The workspace's `.env` lines, taken — none when no bundle was read this round. */
+    async takeEnv(view) {
+        const recorded = view.record?.env ?? null;
+        if (view.serving.envLines === null)
+            return { taken: 0, digests: recorded ?? {} };
+        return this.dotenv.take(view.serving.envLines, this.credentials, recorded);
+    }
+    async viewOf(record, local, serving) {
+        const base = await this.baseOf(record);
+        return {
+            record,
+            base,
+            local,
+            serving,
+            localChanges: await this.repository.changes(base, local),
+            workspaceChanges: await this.repository.changes(base, serving.tree),
+        };
+    }
+    /** The travelling tree of the recorded base — the empty tree before a first sync. */
+    async baseOf(record) {
+        if (record === null)
+            return this.repository.emptyTree();
+        return this.repository.travellingTree(record.servingSha);
+    }
+    /** Record that the laptop stands on `servingSha`, and keep that commit held. */
+    async record(servingSha, env) {
+        await this.records.write(servingSha, env);
+        await this.repository.keepBase(servingSha);
+    }
+    settled(end) {
+        return { kind: 'settled', end };
+    }
+    lastSync(record) {
+        if (record === null)
+            return 'never synced';
+        return `last synced at ${this.short(record.servingSha)}`;
+    }
+    short(sha) {
+        return sha.slice(0, SHORT_SHA_LENGTH);
+    }
+}
+//# sourceMappingURL=sync-round.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { SyncRepository } from './sync-repository.js';
+import type { SyncRound } from './sync-round.js';
+import type { WorkspaceSyncClient } from './workspace-sync.client.js';
+/**
+ * `forgecart sync --watch` (#2781): one round now, then one whenever a side
+ * moves — the laptop's tree changing and holding still for a look, or the
+ * serving commit moving — until Ctrl-C, which ends the watch printing where it
+ * last stood. A round the gates reject waits for the next edit; a divergence
+ * prints its selection's end and waits for either side to move; a round that
+ * failed for any other reason is retried. Only refused credentials end the
+ * watch (exit 3).
+ */
+export declare class SyncWatch {
+    private readonly storefront;
+    private readonly round;
+    private readonly repository;
+    private readonly client;
+    /** Where the last round left both sides — empty before the first. */
+    private settled;
+    /** A local tree seen once, waiting a look to hold still. */
+    private pendingTree;
+    /** The local tree the round in flight was run for. */
+    private attemptedTree;
+    private nextStateRead;
+    private retryAfter;
+    private lastState;
+    constructor(storefront: string, round: SyncRound, repository: SyncRepository, client: WorkspaceSyncClient);
+    /** Watch until `interrupt` fires, then print the last state. */
+    run(interrupt: AbortSignal): Promise<void>;
+    /** One look: a changed local tree, else — now and then — the serving commit. */
+    private tick;
+    /** A changed local tree runs a round once it held still for a look. */
+    private onLocalChange;
+    /** With the laptop still, a serving commit that moved runs a round. */
+    private onStillTree;
+    private roundOn;
+    private guarded;
+    /**
+     * A round that did not settle: refused credentials end the watch; a
+     * divergence waits for either side to move; a push the workspace did not take
+     * waits for the next edit; anything else is retried after a pause. An
+     * interrupted round is the watch ending.
+     */
+    private absorb;
+    private report;
+    /** Wait one look's interval: true once it elapsed, false when the watch is interrupted. */
+    private pause;
+}

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

@@ -0,0 +1,144 @@
+import { CliUnauthorizedRefusal } from '../authorization/cli-unauthorized-refusal.js';
+import { CliRefusal } from '../exit-ladder.js';
+import { print, printError } from '../output.js';
+import { SyncDivergedRefusal } from './sync-divergence.js';
+/** How often the watch looks at the laptop's tree. A change runs a round once it held for one look — an editor's save settles. */
+const TICK_MS = 1000;
+/** How often the watch reads the serving commit while the laptop's tree holds still. */
+const STATE_READ_INTERVAL_MS = 3000;
+/** How long the watch waits after a round that failed before it runs another for the same change. */
+const RETRY_INTERVAL_MS = 10_000;
+/** A commit id in print: its first twelve digits. */
+const SHORT_SHA_LENGTH = 12;
+/**
+ * `forgecart sync --watch` (#2781): one round now, then one whenever a side
+ * moves — the laptop's tree changing and holding still for a look, or the
+ * serving commit moving — until Ctrl-C, which ends the watch printing where it
+ * last stood. A round the gates reject waits for the next edit; a divergence
+ * prints its selection's end and waits for either side to move; a round that
+ * failed for any other reason is retried. Only refused credentials end the
+ * watch (exit 3).
+ */
+export class SyncWatch {
+    storefront;
+    round;
+    repository;
+    client;
+    /** Where the last round left both sides — empty before the first. */
+    settled = { localTree: '', servingSha: '' };
+    /** A local tree seen once, waiting a look to hold still. */
+    pendingTree = null;
+    /** The local tree the round in flight was run for. */
+    attemptedTree = '';
+    nextStateRead = 0;
+    retryAfter = 0;
+    lastState = 'no round has settled yet';
+    constructor(storefront, round, repository, client) {
+        this.storefront = storefront;
+        this.round = round;
+        this.repository = repository;
+        this.client = client;
+    }
+    /** Watch until `interrupt` fires, then print the last state. */
+    async run(interrupt) {
+        print(`watching ${this.storefront}: local edits push and workspace landings pull — Ctrl-C to stop`);
+        await this.repository.prepare();
+        await this.guarded(async () => this.roundOn(await this.repository.snapshot()), interrupt);
+        while (await this.pause(interrupt)) {
+            await this.guarded(() => this.tick(), interrupt);
+        }
+        print(`stopped watching ${this.storefront}: ${this.lastState}`);
+    }
+    /** One look: a changed local tree, else — now and then — the serving commit. */
+    async tick() {
+        const tree = await this.repository.snapshot();
+        if (tree !== this.settled.localTree)
+            return this.onLocalChange(tree);
+        this.pendingTree = null;
+        return this.onStillTree(tree);
+    }
+    /** A changed local tree runs a round once it held still for a look. */
+    async onLocalChange(tree) {
+        if (tree !== this.pendingTree) {
+            this.pendingTree = tree;
+            return;
+        }
+        if (Date.now() < this.retryAfter)
+            return;
+        await this.roundOn(tree);
+    }
+    /** With the laptop still, a serving commit that moved runs a round. */
+    async onStillTree(tree) {
+        if (Date.now() < this.nextStateRead)
+            return;
+        this.nextStateRead = Date.now() + STATE_READ_INTERVAL_MS;
+        const { servingSha } = await this.client.state();
+        if (servingSha === this.settled.servingSha || Date.now() < this.retryAfter)
+            return;
+        await this.roundOn(tree);
+    }
+    async roundOn(tree) {
+        this.attemptedTree = tree;
+        const end = await this.round.run();
+        this.settled = { localTree: end.localTree, servingSha: end.servingSha };
+        this.pendingTree = null;
+        this.lastState = end.summary;
+    }
+    async guarded(work, interrupt) {
+        try {
+            await work();
+        }
+        catch (error) {
+            this.absorb(error, interrupt);
+        }
+    }
+    /**
+     * A round that did not settle: refused credentials end the watch; a
+     * divergence waits for either side to move; a push the workspace did not take
+     * waits for the next edit; anything else is retried after a pause. An
+     * interrupted round is the watch ending.
+     */
+    absorb(error, interrupt) {
+        if (interrupt.aborted)
+            return;
+        if (error instanceof CliUnauthorizedRefusal)
+            throw error;
+        this.retryAfter = Date.now() + RETRY_INTERVAL_MS;
+        if (error instanceof SyncDivergedRefusal) {
+            this.report(error.lines);
+            this.settled = error.point;
+            this.lastState = `diverged from serving ${error.point.servingSha.slice(0, SHORT_SHA_LENGTH)}: waiting for either side to move`;
+            return;
+        }
+        if (error instanceof CliRefusal) {
+            this.report(error.lines);
+            this.settled = { localTree: this.attemptedTree, servingSha: this.settled.servingSha };
+            this.lastState = 'the workspace did not take the last push: waiting for the next edit';
+            return;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        printError(`Error: ${message}`);
+        this.lastState = `the last round failed: ${message}`;
+    }
+    report(lines) {
+        for (const line of lines)
+            printError(`forgecart sync: ${line}`);
+    }
+    /** Wait one look's interval: true once it elapsed, false when the watch is interrupted. */
+    pause(interrupt) {
+        if (interrupt.aborted)
+            return Promise.resolve(false);
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                interrupt.removeEventListener('abort', onInterrupt);
+                resolve(true);
+            }, TICK_MS);
+            function onInterrupt() {
+                clearTimeout(timer);
+                resolve(false);
+            }
+            interrupt.addEventListener('abort', onInterrupt, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=sync-watch.js.map

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

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

package/dist/src/sync/sync.runner.d.ts

@@ -0,0 +1,37 @@
+import type { SyncOptions } from './type/sync.types.js';
+/**
+ * `forgecart sync [name]` (#2781): keep the storefront's tree and the board's
+ * serving tree the same tree. Before anything leaves the machine the run
+ * settles its four credentials — the environment, then the storefront's `.env`,
+ * then its `.forgecart/config.json`, exactly as `init` reads them; a key in no
+ * source exits 3 with nothing sent — and needs `git` on the PATH. Then it runs
+ * ONE round, or, with `--watch`, a round whenever a side moves until Ctrl-C.
+ */
+export declare class SyncRunner {
+    private readonly name;
+    private readonly options;
+    /**
+     * @param name the storefront directory as given — the current directory when absent.
+     * @param options the run's flags.
+     */
+    constructor(name: string | undefined, options: SyncOptions);
+    run(): Promise<void>;
+    /** `--dry-run` plans one round and moves nothing; it cannot watch. */
+    private assertFlags;
+    /**
+     * The four credentials, from the first source carrying each. With one in no
+     * source the run prints where it looked — key names, never values — and exits
+     * 3 before any request.
+     */
+    private settleCredentials;
+    /** The storefront must be a directory — `--pull` makes a new one to take the workspace's tree into. */
+    private assertStorefront;
+    /** Watch until Ctrl-C, which ends the run in flight and prints where it stood. */
+    private watch;
+    private assemble;
+    /** The channel a record belongs to: a digest of the admin API and the channel token — never the token. */
+    private channelOf;
+    /** The storefront as the merchant named it. */
+    private displayName;
+    private isDirectory;
+}