@heyditto/cli 2.4.0 → 2.5.0

package/dist/teleport/git.js

@@ -0,0 +1,41 @@
+import { spawn, spawnSync } from "node:child_process";
+/** Runs git synchronously; never throws, callers check `ok`. */
+export function git(args, cwd, input) {
+    const res = spawnSync("git", args, { cwd, encoding: "utf8", input, maxBuffer: 256 * 1024 * 1024 });
+    return { ok: res.status === 0, status: res.status, stdout: res.stdout ?? "", stderr: res.stderr ?? "" };
+}
+export function gitOrThrow(args, cwd, input) {
+    const res = git(args, cwd, input);
+    if (!res.ok)
+        throw new Error(`git ${args.join(" ")} failed in ${cwd}: ${res.stderr.trim() || res.stdout.trim()}`);
+    return res.stdout;
+}
+export function isGitRepo(dir) {
+    const res = git(["rev-parse", "--is-inside-work-tree"], dir);
+    return res.ok && res.stdout.trim() === "true";
+}
+/** Top-level directory of the repository containing `dir`. */
+export function repoRoot(dir) {
+    const res = git(["rev-parse", "--show-toplevel"], dir);
+    return res.ok ? res.stdout.trim() : undefined;
+}
+export function binaryAvailable(command) {
+    const probe = process.platform === "win32" ? "where" : "which";
+    return spawnSync(probe, [command], { stdio: "ignore" }).status === 0;
+}
+/** Runs a command asynchronously with inherited env, resolving on exit. */
+export function runAsync(command, args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { cwd: opts.cwd, stdio: [opts.input === undefined ? "ignore" : "pipe", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (c) => (stdout += c));
+        child.stderr?.on("data", (c) => (stderr += c));
+        child.on("error", reject);
+        child.on("close", (status) => resolve({ ok: status === 0, status, stdout, stderr }));
+        if (opts.input !== undefined) {
+            child.stdin?.end(opts.input);
+        }
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/teleport/git.js.map

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

package/dist/teleport/harness.d.ts

@@ -0,0 +1,29 @@
+import { type Compression, type HarnessKind } from "./types.js";
+/** Where a harness stores the session's transcript, relative to $HOME. */
+export interface HarnessLocation {
+    kind: HarnessKind;
+    sessionId: string;
+    /** Files to capture, absolute paths. */
+    files: string[];
+    /** Absolute directory the session is keyed under (Claude project dir). */
+    keyDir?: string;
+}
+/** Locates Claude Code transcript files for a session recorded under `cwd`. */
+export declare function locateClaude(sessionId: string, cwd: string): Promise<HarnessLocation | null>;
+/** Locates a Codex rollout transcript by thread id. */
+export declare function locateCodex(threadId: string): Promise<HarnessLocation | null>;
+export declare function locateHarness(kind: HarnessKind, sessionId: string | undefined, cwd: string): Promise<HarnessLocation | null>;
+export declare function pickCompression(): Compression;
+/** Tars a harness's transcript files (as $HOME-relative paths) into `outFile`. */
+export declare function captureHarness(loc: HarnessLocation, outFile: string, compression?: Compression): Promise<{
+    file: string;
+    compression: Compression;
+} | null>;
+/**
+ * Restores a Claude transcript under a (possibly different) target cwd: extract
+ * to a temp home, then rewrite the project-dir slug and any embedded absolute
+ * cwd inside the jsonl so `claude --resume <id>` finds the session at the new
+ * path. Returns the restored session id.
+ */
+export declare function restoreClaudeTranscript(tarFile: string, compression: Compression, sessionId: string, originalCwd: string, targetCwd: string): Promise<void>;
+export declare function fileSize(p: string): Promise<number>;

package/dist/teleport/harness.js

@@ -0,0 +1,121 @@
+import { spawnSync } from "node:child_process";
+import { access, mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { binaryAvailable } from "./git.js";
+import { cwdSlug } from "./types.js";
+function claudeHome() {
+    return process.env.CLAUDE_CONFIG_DIR?.trim() || path.join(os.homedir(), ".claude");
+}
+function codexHome() {
+    return process.env.CODEX_HOME?.trim() || path.join(os.homedir(), ".codex");
+}
+/** Locates Claude Code transcript files for a session recorded under `cwd`. */
+export async function locateClaude(sessionId, cwd) {
+    const projectDir = path.join(claudeHome(), "projects", cwdSlug(cwd));
+    const jsonl = path.join(projectDir, `${sessionId}.jsonl`);
+    if (!(await exists(jsonl)))
+        return null;
+    const files = [jsonl];
+    const subdir = path.join(projectDir, sessionId);
+    if (await exists(subdir)) {
+        for (const f of await walkFiles(subdir))
+            files.push(f);
+    }
+    return { kind: "claude-code", sessionId, files, keyDir: projectDir };
+}
+/** Locates a Codex rollout transcript by thread id. */
+export async function locateCodex(threadId) {
+    const sessions = path.join(codexHome(), "sessions");
+    if (!(await exists(sessions)))
+        return null;
+    const matches = (await walkFiles(sessions)).filter((f) => f.endsWith(".jsonl") && path.basename(f).includes(threadId));
+    if (matches.length === 0)
+        return null;
+    return { kind: "codex", sessionId: threadId, files: matches };
+}
+export async function locateHarness(kind, sessionId, cwd) {
+    if (!sessionId)
+        return null;
+    if (kind === "claude-code")
+        return locateClaude(sessionId, cwd);
+    if (kind === "codex")
+        return locateCodex(sessionId);
+    return null;
+}
+export function pickCompression() {
+    return binaryAvailable("zstd") ? "zstd" : "gzip";
+}
+/** Tars a harness's transcript files (as $HOME-relative paths) into `outFile`. */
+export async function captureHarness(loc, outFile, compression = pickCompression()) {
+    const home = os.homedir();
+    const rel = loc.files.map((f) => path.relative(home, f)).filter((r) => !r.startsWith(".."));
+    if (rel.length === 0)
+        return null;
+    await mkdir(path.dirname(outFile), { recursive: true });
+    const flag = compression === "zstd" ? "--zstd" : "--gzip";
+    const res = spawnSync("tar", ["-c", flag, "-f", outFile, "-C", home, "--null", "-T", "-"], {
+        input: `${rel.join("\0")}\0`,
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (res.status !== 0)
+        throw new Error(`tar failed for harness state: ${res.stderr?.toString().trim()}`);
+    return { file: outFile, compression };
+}
+/**
+ * Restores a Claude transcript under a (possibly different) target cwd: extract
+ * to a temp home, then rewrite the project-dir slug and any embedded absolute
+ * cwd inside the jsonl so `claude --resume <id>` finds the session at the new
+ * path. Returns the restored session id.
+ */
+export async function restoreClaudeTranscript(tarFile, compression, sessionId, originalCwd, targetCwd) {
+    const home = os.homedir();
+    const flag = compression === "zstd" ? "--zstd" : "--gzip";
+    const res = spawnSync("tar", ["-x", flag, "-f", tarFile, "-C", home], { maxBuffer: 64 * 1024 * 1024 });
+    if (res.status !== 0)
+        throw new Error(`tar extract failed: ${res.stderr?.toString().trim()}`);
+    if (path.resolve(originalCwd) === path.resolve(targetCwd))
+        return;
+    const fromDir = path.join(claudeHome(), "projects", cwdSlug(originalCwd));
+    const toDir = path.join(claudeHome(), "projects", cwdSlug(targetCwd));
+    await mkdir(toDir, { recursive: true });
+    const fromJsonl = path.join(fromDir, `${sessionId}.jsonl`);
+    if (await exists(fromJsonl)) {
+        const rewritten = (await readFile(fromJsonl, "utf8")).split(originalCwd).join(targetCwd);
+        await writeFile(path.join(toDir, `${sessionId}.jsonl`), rewritten);
+    }
+    const fromSub = path.join(fromDir, sessionId);
+    if (await exists(fromSub)) {
+        for (const f of await walkFiles(fromSub)) {
+            const relFromSub = path.relative(fromSub, f);
+            const dest = path.join(toDir, sessionId, relFromSub);
+            await mkdir(path.dirname(dest), { recursive: true });
+            await writeFile(dest, await readFile(f));
+        }
+    }
+}
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function walkFiles(dir) {
+    const out = [];
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const e of entries) {
+        const full = path.join(dir, e.name);
+        if (e.isDirectory())
+            out.push(...(await walkFiles(full)));
+        else if (e.isFile())
+            out.push(full);
+    }
+    return out;
+}
+export async function fileSize(p) {
+    return (await stat(p)).size;
+}
+//# sourceMappingURL=harness.js.map

package/dist/teleport/harness.js.map

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

package/dist/teleport/offload.d.ts

@@ -0,0 +1,32 @@
+import * as tapi from "./api.js";
+export interface UnpushedRepo {
+    relPath: string;
+    branch: string | null;
+    ahead: number;
+    reason: string;
+}
+/**
+ * Repositories under `root` that hold work no remote has: commits ahead of an
+ * upstream, or a branch with no upstream at all. Offload refuses on these
+ * unless the user overrides, because deleting them loses the only copy.
+ */
+export declare function unpushedRepos(root: string): Promise<UnpushedRepo[]>;
+export interface OffloadReadiness {
+    ready: boolean;
+    mirrors: tapi.MirrorStatus[];
+}
+/** Polls capsule status until every required mirror is complete + verified, or timeout. */
+export declare function waitForOffloadReady(capsuleId: string, opts?: {
+    timeoutMs?: number;
+    intervalMs?: number;
+    onPoll?: (s: tapi.CapsuleStatus) => void;
+}): Promise<OffloadReadiness>;
+/**
+ * Removes the local root once its capsule is verified. On macOS the root is
+ * moved into the user's Trash so it is trivially recoverable; elsewhere it is
+ * deleted. Never called unless `waitForOffloadReady` returned ready.
+ */
+export declare function deleteLocalRoot(root: string): Promise<{
+    method: "trash" | "rm";
+    location?: string;
+}>;

package/dist/teleport/offload.js

@@ -0,0 +1,83 @@
+import { rename, rm, stat } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { git, isGitRepo } from "./git.js";
+import * as tapi from "./api.js";
+import { discoverRepos } from "./discover.js";
+/**
+ * Repositories under `root` that hold work no remote has: commits ahead of an
+ * upstream, or a branch with no upstream at all. Offload refuses on these
+ * unless the user overrides, because deleting them loses the only copy.
+ */
+export async function unpushedRepos(root) {
+    const discovery = await discoverRepos(root);
+    const out = [];
+    for (const rel of discovery.repos) {
+        const dir = rel === "." ? discovery.root : path.join(discovery.root, rel);
+        if (!isGitRepo(dir))
+            continue;
+        const branchRes = git(["symbolic-ref", "--quiet", "--short", "HEAD"], dir);
+        const branch = branchRes.ok ? branchRes.stdout.trim() : null;
+        const upstream = branch ? git(["rev-parse", "--abbrev-ref", "@{u}"], dir) : undefined;
+        if (!branch) {
+            out.push({ relPath: rel, branch, ahead: 0, reason: "detached HEAD" });
+            continue;
+        }
+        if (!upstream?.ok) {
+            const hasCommits = git(["rev-parse", "--verify", "HEAD"], dir).ok;
+            const configured = git(["config", `branch.${branch}.merge`], dir).ok;
+            if (hasCommits && configured) {
+                // Upstream is configured but its tracking ref is absent (a capsule
+                // restored without upstream tips, or a never-fetched remote): we
+                // cannot tell what is pushed, so refuse rather than guess.
+                out.push({ relPath: rel, branch, ahead: -1, reason: "tracking state unknown; fetch first or pass --allow-unpushed" });
+            }
+            else if (hasCommits) {
+                out.push({ relPath: rel, branch, ahead: 0, reason: "branch has no upstream" });
+            }
+            continue;
+        }
+        const ahead = git(["rev-list", "--count", "@{u}..HEAD"], dir);
+        const n = ahead.ok ? Number(ahead.stdout.trim()) : 0;
+        if (n > 0)
+            out.push({ relPath: rel, branch, ahead: n, reason: `${n} commit(s) not on ${upstream.stdout.trim()}` });
+    }
+    return out;
+}
+/** Polls capsule status until every required mirror is complete + verified, or timeout. */
+export async function waitForOffloadReady(capsuleId, opts = {}) {
+    const timeout = opts.timeoutMs ?? 10 * 60_000;
+    const interval = opts.intervalMs ?? 5_000;
+    const deadline = Date.now() + timeout;
+    for (;;) {
+        const status = await tapi.capsuleStatus(capsuleId);
+        opts.onPoll?.(status);
+        if (status.offloadReady)
+            return { ready: true, mirrors: status.mirrors };
+        if (Date.now() >= deadline)
+            return { ready: false, mirrors: status.mirrors };
+        await new Promise((r) => setTimeout(r, interval));
+    }
+}
+/**
+ * Removes the local root once its capsule is verified. On macOS the root is
+ * moved into the user's Trash so it is trivially recoverable; elsewhere it is
+ * deleted. Never called unless `waitForOffloadReady` returned ready.
+ */
+export async function deleteLocalRoot(root) {
+    const resolved = path.resolve(root);
+    await stat(resolved); // throws if already gone
+    if (process.platform === "darwin") {
+        const trash = path.join(os.homedir(), ".Trash", `${path.basename(resolved)}-teleport-${Date.now()}`);
+        try {
+            await rename(resolved, trash);
+            return { method: "trash", location: trash };
+        }
+        catch {
+            // cross-device rename into Trash can fail; fall back to rm
+        }
+    }
+    await rm(resolved, { recursive: true, force: true });
+    return { method: "rm" };
+}
+//# sourceMappingURL=offload.js.map

package/dist/teleport/offload.js.map

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

package/dist/teleport/pull.d.ts

@@ -0,0 +1,12 @@
+import { type RestoreResult } from "./restore.js";
+/**
+ * Downloads a generation's chunks and rebuilds the capsule into `destRoot`.
+ * Chunks are verified by sha256 as they land; a mismatch aborts the pull.
+ */
+export declare function pullCapsule(capsuleId: string, generation: number | undefined, destRoot: string, opts?: {
+    restoreHarness?: boolean;
+}): Promise<RestoreResult>;
+/** Local record of a capsule's last generation, for thin bundles on the next push. */
+export declare function manifestCachePath(configDir: string, capsuleId: string): string;
+export declare function readCachedManifest(configDir: string, capsuleId: string): Promise<any>;
+export declare function writeCachedManifest(configDir: string, capsuleId: string, manifest: unknown): Promise<void>;

package/dist/teleport/pull.js

@@ -0,0 +1,118 @@
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import * as tapi from "./api.js";
+import { restoreCapsule } from "./restore.js";
+const GET_CONCURRENCY = 4;
+/**
+ * Downloads a generation's chunks and rebuilds the capsule into `destRoot`.
+ * Chunks are verified by sha256 as they land; a mismatch aborts the pull.
+ */
+export async function pullCapsule(capsuleId, generation, destRoot, opts = {}) {
+    const resolved = await tapi.resolveGeneration(capsuleId, generation);
+    const { manifest } = resolved;
+    const chunks = [...resolved.chunks];
+    await completePackChains(capsuleId, manifest, chunks);
+    const chunkDir = await mkdtemp(path.join(os.tmpdir(), "teleport-chunks-"));
+    try {
+        await downloadChunks(chunks, chunkDir);
+        return await restoreCapsule(manifest, (sha) => path.join(chunkDir, sha), destRoot, opts);
+    }
+    finally {
+        await rm(chunkDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Fallback for manifests whose repos carry only thin packs (older pushes did
+ * not reference their basis packs): walk `basisGeneration` back through the
+ * capsule's generations until a full pack is found, prepending each basis
+ * generation's packs and chunk URLs so the restore has complete history.
+ */
+async function completePackChains(capsuleId, manifest, chunks) {
+    const known = new Set(chunks.map((c) => c.sha256));
+    const resolvedGenerations = new Map();
+    for (const repo of manifest.repos) {
+        let guard = 0;
+        while (!repo.packs.some((p) => p.kind === "full") && repo.packs.length > 0 && guard++ < 64) {
+            const oldest = repo.packs.reduce((a, b) => ((a.basisGeneration ?? 0) <= (b.basisGeneration ?? 0) ? a : b));
+            const basisGen = oldest.basisGeneration;
+            if (!basisGen)
+                break; // thin pack with no recorded basis: nothing more to fetch
+            let basis = resolvedGenerations.get(basisGen);
+            if (!basis) {
+                basis = await tapi.resolveGeneration(capsuleId, basisGen);
+                resolvedGenerations.set(basisGen, basis);
+            }
+            const basisRepo = basis.manifest.repos.find((r) => r.relPath === repo.relPath);
+            if (!basisRepo || basisRepo.packs.length === 0)
+                break;
+            const have = new Set(repo.packs.map((p) => p.chunks.map((c) => c.sha256).join(",")));
+            for (const pack of basisRepo.packs) {
+                if (have.has(pack.chunks.map((c) => c.sha256).join(",")))
+                    continue;
+                repo.packs.unshift(pack);
+                for (const c of pack.chunks) {
+                    if (known.has(c.sha256))
+                        continue;
+                    const url = basis.chunks.find((x) => x.sha256 === c.sha256);
+                    if (url) {
+                        chunks.push(url);
+                        known.add(c.sha256);
+                    }
+                }
+            }
+        }
+    }
+}
+async function downloadChunks(chunks, dir) {
+    const { createHash } = await import("node:crypto");
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(GET_CONCURRENCY, chunks.length) }, async () => {
+        for (;;) {
+            const i = cursor++;
+            if (i >= chunks.length)
+                return;
+            const { sha256, getUrl } = chunks[i];
+            const dest = path.join(dir, sha256);
+            const buf = await getWithRetry(getUrl);
+            const got = createHash("sha256").update(buf).digest("hex");
+            if (got !== sha256)
+                throw new Error(`chunk ${sha256} failed integrity check (got ${got})`);
+            await writeFile(dest, buf);
+        }
+    });
+    await Promise.all(workers);
+}
+async function getWithRetry(url, attempts = 4) {
+    let delay = 400;
+    for (let attempt = 1;; attempt++) {
+        const res = await fetch(url);
+        if (res.ok)
+            return Buffer.from(await res.arrayBuffer());
+        if (attempt >= attempts || (res.status < 500 && res.status !== 429)) {
+            throw new Error(`chunk download failed: HTTP ${res.status}`);
+        }
+        await new Promise((r) => setTimeout(r, delay));
+        delay *= 2;
+    }
+}
+/** Local record of a capsule's last generation, for thin bundles on the next push. */
+export function manifestCachePath(configDir, capsuleId) {
+    return path.join(configDir, "teleport", `${capsuleId}.json`);
+}
+export async function readCachedManifest(configDir, capsuleId) {
+    try {
+        return JSON.parse(await readFile(manifestCachePath(configDir, capsuleId), "utf8"));
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return undefined;
+        throw err;
+    }
+}
+export async function writeCachedManifest(configDir, capsuleId, manifest) {
+    const file = manifestCachePath(configDir, capsuleId);
+    await mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    await writeFile(file, `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o600 });
+}
+//# sourceMappingURL=pull.js.map

package/dist/teleport/pull.js.map

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

package/dist/teleport/push.d.ts

@@ -0,0 +1,49 @@
+import * as tapi from "./api.js";
+import { type HarnessKind, type Manifest } from "./types.js";
+export interface PushInput {
+    root: string;
+    capsuleId: string;
+    parentGeneration: number | null;
+    /** Previous generation's manifest, for thin bundles. */
+    previousManifest?: Manifest;
+    harness: {
+        kind: HarnessKind;
+        sessionId?: string;
+        cwd?: string;
+    };
+    ignoredIncludes: string[];
+    rootName: string;
+    rootKind: "repo" | "folder";
+    /** Who is committing: the CLI on a user's machine, or the Ditto Code runner. */
+    committedBy?: tapi.CommittedBy;
+}
+export interface PushOutput {
+    generation: number;
+    bytesTotal: number;
+    dedupedBytes: number;
+    chunkCount: number;
+    uploaded: number;
+    reused: number;
+    /** Bytes actually sent to storage this push. */
+    uploadedBytes: number;
+    /** Bytes the generation references in total (every chunk, counted once per reference). */
+    logicalBytes: number;
+    /** logicalBytes − uploadedBytes: what dedup against earlier pushes saved. */
+    reusedBytes: number;
+    /** reusedBytes / logicalBytes, 0 when nothing was referenced. */
+    savingsRatio: number;
+}
+/**
+ * Builds a generation, negotiates which chunks are missing, uploads them via
+ * presigned PUTs, then commits the manifest. The manifest is content-addressed
+ * too, so a re-push with no changes uploads nothing.
+ *
+ * Every generation's manifest carries each repo's complete pack chain (the
+ * basis packs by reference plus this generation's thin pack), so a pull of any
+ * generation rebuilds full history from that one manifest. When the server no
+ * longer holds a referenced basis chunk, the affected repos are re-bundled in
+ * full and the push retried once.
+ */
+export declare function pushCapsule(input: PushInput, forceFull?: Set<string>): Promise<PushOutput>;
+/** The Ditto Code runner authenticates with a ditto_agent_ token and pins the harness session via env. */
+export declare function detectCommitter(): tapi.CommittedBy;