@procedures/snapshot 0.0.0-stage → 0.1.0

package/dist/procedures/snapshot/archive-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-io.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/archive-io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,+CAA+C;AAC/C,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9D;AAED,yDAAyD;AACzD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9F"}

package/dist/procedures/snapshot/archive-io.js

@@ -0,0 +1,29 @@
+/**
+ * File access for snapshot archives without the whole archive in memory.
+ *
+ * Before, create and restore read each archive into memory (for the checksum and the upload).
+ * An archive over 2 GiB failed, and the peak was about 2.3 times the archive (deep dive DATA-19).
+ */
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+/** The SHA-256 of a file, read as a stream. */
+export async function sha256File(path) {
+    const hash = createHash("sha256");
+    for await (const chunk of createReadStream(path)) {
+        hash.update(chunk);
+    }
+    return hash.digest("hex");
+}
+/** The bytes of a file from `offset`, at most `size`. */
+export async function readPart(file, offset, size) {
+    const buffer = Buffer.alloc(size);
+    let filled = 0;
+    while (filled < size) {
+        const { bytesRead } = await file.read(buffer, filled, size - filled, offset + filled);
+        if (bytesRead === 0)
+            break;
+        filled += bytesRead;
+    }
+    return buffer.subarray(0, filled);
+}
+//# sourceMappingURL=archive-io.js.map

package/dist/procedures/snapshot/archive-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-io.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/archive-io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAgB,EAAE,MAAc,EAAE,IAAY;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,IAAI,EAAE,CAAC;QACrB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QACtF,IAAI,SAAS,KAAK,CAAC;YAAE,MAAM;QAC3B,MAAM,IAAI,SAAS,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/procedures/snapshot/commands.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The programs that the snapshot procedures run: git and pnpm, through `runCommand`.
+ *
+ * `runCommand` is async, kills the process tree when the signal aborts, and runs no shell.
+ * Before, the procedures used `execSync`: it blocked the event loop of the host for each call,
+ * ignored the signal, and passed the command line to a shell.
+ */
+/**
+ * This function runs `git <args>` in `cwd` and gives its trimmed output. It gives `undefined`
+ * when git fails, when it cannot start, or when the signal aborts.
+ */
+export declare function gitText(args: readonly string[], cwd: string, signal?: AbortSignal): Promise<string | undefined>;
+/** This function gives the version of pnpm, or "unknown" when pnpm cannot run. */
+export declare function pnpmVersion(signal?: AbortSignal): Promise<string>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/procedures/snapshot/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGrH;AAED,kFAAkF;AAClF,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CASvE"}

package/dist/procedures/snapshot/commands.js

@@ -0,0 +1,32 @@
+/**
+ * The programs that the snapshot procedures run: git and pnpm, through `runCommand`.
+ *
+ * `runCommand` is async, kills the process tree when the signal aborts, and runs no shell.
+ * Before, the procedures used `execSync`: it blocked the event loop of the host for each call,
+ * ignored the signal, and passed the command line to a shell.
+ */
+import { runCommand } from "@procedures/shell/command";
+import { resolvePnpm } from "@procedures/pnpm";
+/** The longest time of one git or pnpm query, in milliseconds. */
+const QUERY_TIMEOUT_MS = 30_000;
+/**
+ * This function runs `git <args>` in `cwd` and gives its trimmed output. It gives `undefined`
+ * when git fails, when it cannot start, or when the signal aborts.
+ */
+export async function gitText(args, cwd, signal) {
+    const result = await runCommand("git", { args, cwd, signal, timeout: QUERY_TIMEOUT_MS });
+    return result.success ? result.stdout.trim() : undefined;
+}
+/** This function gives the version of pnpm, or "unknown" when pnpm cannot run. */
+export async function pnpmVersion(signal) {
+    let pnpm;
+    try {
+        pnpm = resolvePnpm();
+    }
+    catch {
+        return "unknown";
+    }
+    const result = await runCommand(pnpm.command, { args: [...pnpm.prefix, "--version"], signal, timeout: QUERY_TIMEOUT_MS });
+    return result.success ? result.stdout.trim() : "unknown";
+}
+//# sourceMappingURL=commands.js.map

package/dist/procedures/snapshot/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,kEAAkE;AAClE,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAuB,EAAE,GAAW,EAAE,MAAoB;IACtF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACzF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAoB;IACpD,IAAI,IAA2C,CAAC;IAChD,IAAI,CAAC;QACH,IAAI,GAAG,WAAW,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1H,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC"}

package/dist/procedures/snapshot/create.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snapshot.create procedure
+ *
+ * Create an environment snapshot and upload to S3.
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { SnapshotCreateInput, SnapshotCreateOutput } from "../../types.js";
+/**
+ * Create a snapshot of the environment
+ */
+export declare function snapshotCreate(input: SnapshotCreateInput, ctx: ProcedureContext): Promise<SnapshotCreateOutput>;
+//# sourceMappingURL=create.d.ts.map

package/dist/procedures/snapshot/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAIrB,MAAM,gBAAgB,CAAC;AAKxB;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAgG/B"}

package/dist/procedures/snapshot/create.js

@@ -0,0 +1,279 @@
+/**
+ * snapshot.create procedure
+ *
+ * Create an environment snapshot and upload to S3.
+ */
+import { existsSync, mkdtempSync, rmSync, readFileSync, writeFileSync, statSync } from "node:fs";
+import { open } from "node:fs/promises";
+import { join, basename, dirname, resolve } from "node:path";
+import { tmpdir, hostname } from "node:os";
+import { randomUUID } from "node:crypto";
+import * as tar from "tar";
+import { assertSnapshotName, isExcluded } from "./names.js";
+import { readPart, sha256File } from "./archive-io.js";
+import { gitText, pnpmVersion } from "./commands.js";
+/** The size of each part of a multipart upload (the S3 minimum) */
+const PART_SIZE = 5 * 1024 * 1024;
+/**
+ * Create a snapshot of the environment
+ */
+export async function snapshotCreate(input, ctx) {
+    // A plain name: it goes into S3 keys and the snapshot id (a "/" made ids that restore,
+    // diff and delete never found: deep dive DATA-1, DATA-16)
+    assertSnapshotName("name", input.name);
+    const id = `${input.name}-${Date.now()}-${randomUUID().slice(0, 8)}`;
+    const workDir = mkdtempSync(join(tmpdir(), "snapshot-"));
+    try {
+        // Get repository paths to snapshot
+        const repoPaths = input.paths || (await getEcosystemPaths(ctx));
+        // Gather repository info
+        const repositories = await Promise.all(repoPaths.map((path) => getRepositoryInfo(path, ctx)));
+        // Get environment info
+        const environment = await getEnvironmentInfo(ctx.signal);
+        // Create metadata
+        const metadata = {
+            id,
+            name: input.name,
+            preset: input.preset,
+            createdAt: new Date().toISOString(),
+            environment,
+            repositories,
+            checksum: "", // Will be calculated after archive creation
+            archiveSize: 0,
+            description: input.description,
+        };
+        // Write metadata to work directory
+        const metadataPath = join(workDir, "metadata.json");
+        writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+        // Create archive based on preset
+        const archivePath = join(workDir, `${id}.tar.gz`);
+        await createArchive(archivePath, repoPaths, input.preset, workDir);
+        // Calculate checksum (a stream: the archive is never in memory as a whole)
+        const checksum = await sha256File(archivePath);
+        const archiveSize = statSync(archivePath).size;
+        // Update metadata with checksum
+        metadata.checksum = checksum;
+        metadata.archiveSize = archiveSize;
+        writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+        // Upload to S3
+        const uploadStart = Date.now();
+        const s3Key = `snapshots/${input.name}/${id}.tar.gz`;
+        // Use multipart upload for large files (> 5MB). The parts are read from the file, one at a
+        // time (deep dive DATA-19).
+        if (archiveSize > PART_SIZE) {
+            await multipartUpload(ctx, input.bucket, s3Key, archivePath, archiveSize);
+        }
+        else {
+            await ctx.client.call(["s3", "upload"], {
+                bucket: input.bucket,
+                key: s3Key,
+                body: readFileSync(archivePath).toString("base64"),
+                base64: true,
+                contentType: "application/gzip",
+                metadata: {
+                    snapshotId: id,
+                    snapshotName: input.name,
+                    preset: input.preset,
+                    checksum,
+                },
+            });
+        }
+        // Also upload metadata separately for quick listing
+        await ctx.client.call(["s3", "upload"], {
+            bucket: input.bucket,
+            key: `snapshots/${input.name}/${id}.metadata.json`,
+            body: JSON.stringify(metadata, null, 2),
+            contentType: "application/json",
+        });
+        const uploadDuration = Date.now() - uploadStart;
+        return {
+            id,
+            location: `s3://${input.bucket}/${s3Key}`,
+            metadata,
+            uploadDuration,
+        };
+    }
+    finally {
+        // Cleanup work directory
+        if (existsSync(workDir)) {
+            rmSync(workDir, { recursive: true, force: true });
+        }
+    }
+}
+/**
+ * Get ecosystem repository paths from manifest
+ */
+async function getEcosystemPaths(_ctx) {
+    // TODO: Read from ecosystem manifest
+    // For now, return current working directory
+    return [process.cwd()];
+}
+/**
+ * Get repository info for a path
+ */
+async function getRepositoryInfo(repoPath, ctx) {
+    try {
+        const result = await ctx.client.call(["git", "status"], { cwd: repoPath });
+        // The commit hash ("" for a repository with no commit) and the remote URL (none without "origin")
+        const commit = (await gitText(["rev-parse", "HEAD"], repoPath, ctx.signal)) ?? "";
+        const remoteUrl = await gitText(["remote", "get-url", "origin"], repoPath, ctx.signal);
+        // Get stash count
+        let stashCount = 0;
+        try {
+            const stashList = await ctx.client.call(["git", "stash", "list"], { cwd: repoPath });
+            stashCount = stashList.count;
+        }
+        catch {
+            // No stashes
+        }
+        // Get package name from package.json
+        let name = basename(repoPath);
+        try {
+            const pkgPath = join(repoPath, "package.json");
+            if (existsSync(pkgPath)) {
+                const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+                name = pkg.name || name;
+            }
+        }
+        catch {
+            // Use directory name
+        }
+        return {
+            path: repoPath,
+            name,
+            branch: result.branch,
+            commit,
+            dirty: !result.clean,
+            stashCount,
+            remoteUrl,
+            ahead: result.ahead,
+            behind: result.behind,
+        };
+    }
+    catch (error) {
+        // Not a git repo or error
+        return {
+            path: repoPath,
+            name: basename(repoPath),
+            branch: "",
+            commit: "",
+            dirty: false,
+            stashCount: 0,
+            ahead: 0,
+            behind: 0,
+        };
+    }
+}
+/**
+ * Get environment info
+ */
+async function getEnvironmentInfo(signal) {
+    return {
+        os: process.platform,
+        nodeVersion: process.version,
+        pnpmVersion: await pnpmVersion(signal),
+        username: process.env["USER"] || process.env["USERNAME"] || "unknown",
+        hostname: hostname(),
+    };
+}
+/**
+ * Create tar archive based on preset
+ */
+async function createArchive(archivePath, repoPaths, preset, workDir) {
+    // Only archive repositories that actually exist on disk.
+    const existingRepos = repoPaths.filter((p) => existsSync(p));
+    // tar.create accepts a single `cwd`, and each entry is stored relative to it.
+    // To store each repository as a top-level `<basename>/...` entry we must run
+    // with `cwd` set to the directory that contains the repositories (the
+    // ecosystem root), not the fresh temp `workDir` the repos are not inside.
+    const parents = new Set(existingRepos.map((p) => resolve(dirname(p))));
+    if (parents.size > 1) {
+        throw new Error(`snapshot.create requires all repositories to share a parent directory; got multiple roots: ${[
+            ...parents,
+        ].join(", ")}`);
+    }
+    const cwd = existingRepos.length > 0 ? resolve(dirname(existingRepos[0])) : workDir;
+    // Create gzip options based on preset
+    const gzipOpts = { level: preset === "heavy" ? 6 : 9 };
+    // Build exclude patterns based on preset
+    const excludePatterns = [];
+    if (preset === "light") {
+        // Exclude node_modules and pnpm store
+        excludePatterns.push("node_modules", ".pnpm-store", "dist", "*.log");
+    }
+    else if (preset === "medium") {
+        // Include node_modules but exclude pnpm store
+        excludePatterns.push(".pnpm-store", "*.log");
+    }
+    // heavy preset includes everything
+    await tar.create({
+        gzip: gzipOpts,
+        file: archivePath,
+        cwd,
+        // Whole path segments, and "*.ext" for file endings. (Before, `path.includes("dist")`
+        // left out src/distance.ts, and "*.log" matched nothing: deep dive DATA-3.)
+        filter: (path) => !isExcluded(path, excludePatterns),
+    }, existingRepos.map((p) => basename(p)));
+}
+/**
+ * Multipart upload for large files. Each part is read from the file when it goes up.
+ */
+async function multipartUpload(ctx, bucket, key, archivePath, archiveSize) {
+    // Initialize multipart upload
+    const initResult = await ctx.client.call(["s3", "multipart", "init"], {
+        bucket,
+        key,
+        contentType: "application/gzip",
+    });
+    const uploadId = initResult.uploadId;
+    const parts = [];
+    const file = await open(archivePath, "r");
+    try {
+        // Upload parts
+        let partNumber = 1;
+        for (let offset = 0; offset < archiveSize; offset += PART_SIZE) {
+            const chunk = await readPart(file, offset, PART_SIZE);
+            const partResult = await ctx.client.call(["s3", "multipart", "upload"], {
+                bucket,
+                key,
+                uploadId,
+                partNumber,
+                body: chunk.toString("base64"),
+            });
+            parts.push({
+                etag: partResult.etag,
+                partNumber: partResult.partNumber,
+            });
+            partNumber++;
+        }
+        // Complete multipart upload
+        await ctx.client.call(["s3", "multipart", "complete"], {
+            bucket,
+            key,
+            uploadId,
+            parts,
+        });
+    }
+    catch (error) {
+        // Abort on failure. The error of the upload stays the error: before, a failed abort
+        // replaced it.
+        try {
+            await ctx.client.call(["s3", "multipart", "abort"], {
+                bucket,
+                key,
+                uploadId,
+            });
+        }
+        catch (abortError) {
+            throw new Error(`${messageOf(error)} (the abort of upload ${uploadId} also failed: ${messageOf(abortError)})`, { cause: error });
+        }
+        throw error;
+    }
+    finally {
+        await file.close();
+    }
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=create.js.map

package/dist/procedures/snapshot/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/create.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAE3B,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AASrD,mEAAmE;AACnE,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA0B,EAC1B,GAAqB;IAErB,uFAAuF;IACvF,0DAA0D;IAC1D,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAEzD,IAAI,CAAC;QAEH,mCAAmC;QACnC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhE,yBAAyB;QACzB,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CACtD,CAAC;QAEF,uBAAuB;QACvB,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzD,kBAAkB;QAClB,MAAM,QAAQ,GAAqB;YACjC,EAAE;YACF,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW;YACX,YAAY;YACZ,QAAQ,EAAE,EAAE,EAAE,4CAA4C;YAC1D,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC;QAEF,mCAAmC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QACpD,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEnE,2EAA2E;QAC3E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;QAE/C,gCAAgC;QAChC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC7B,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;QACnC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,eAAe;QACf,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,aAAa,KAAK,CAAC,IAAI,IAAI,EAAE,SAAS,CAAC;QAErD,2FAA2F;QAC3F,4BAA4B;QAC5B,IAAI,WAAW,GAAG,SAAS,EAAE,CAAC;YAC5B,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;gBACtC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,EAAE,KAAK;gBACV,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAClD,MAAM,EAAE,IAAI;gBACZ,WAAW,EAAE,kBAAkB;gBAC/B,QAAQ,EAAE;oBACR,UAAU,EAAE,EAAE;oBACd,YAAY,EAAE,KAAK,CAAC,IAAI;oBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,QAAQ;iBACT;aACF,CAAC,CAAC;QACL,CAAC;QAED,oDAAoD;QACpD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;YACtC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,EAAE,aAAa,KAAK,CAAC,IAAI,IAAI,EAAE,gBAAgB;YAClD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,WAAW,EAAE,kBAAkB;SAChC,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;QAEhD,OAAO;YACL,EAAE;YACF,QAAQ,EAAE,QAAQ,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE;YACzC,QAAQ;YACR,cAAc;SACf,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,yBAAyB;QACzB,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,IAAsB;IACrD,qCAAqC;IACrC,4CAA4C;IAC5C,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC9B,QAAgB,EAChB,GAAqB;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAGlC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExC,kGAAkG;QAClG,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAClF,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAEvF,kBAAkB;QAClB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAGrC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/C,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;QAED,qCAAqC;QACrC,IAAI,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC/C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;gBACtD,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM;YACN,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK;YACpB,UAAU;YACV,SAAS;YACT,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0BAA0B;QAC1B,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;YACxB,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,KAAK;YACZ,UAAU,EAAE,CAAC;YACb,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,kBAAkB,CAAC,MAAoB;IACpD,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,QAAQ;QACpB,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,WAAW,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC;QACtC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS;QACrE,QAAQ,EAAE,QAAQ,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,WAAmB,EACnB,SAAmB,EACnB,MAAsB,EACtB,OAAe;IAEf,yDAAyD;IACzD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,8EAA8E;IAC9E,6EAA6E;IAC7E,sEAAsE;IACtE,0EAA0E;IAC1E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,8FAA8F;YAC5F,GAAG,OAAO;SACX,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACf,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAErF,sCAAsC;IACtC,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvD,yCAAyC;IACzC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,sCAAsC;QACtC,eAAe,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;SAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,8CAA8C;QAC9C,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,mCAAmC;IAEnC,MAAM,GAAG,CAAC,MAAM,CACd;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,WAAW;QACjB,GAAG;QACH,sFAAsF;QACtF,4EAA4E;QAC5E,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,eAAe,CAAC;KACrD,EACD,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CACtC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,GAAqB,EACrB,MAAc,EACd,GAAW,EACX,WAAmB,EACnB,WAAmB;IAEnB,8BAA8B;IAC9B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAGtC,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;QAC7B,MAAM;QACN,GAAG;QACH,WAAW,EAAE,kBAAkB;KAChC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IACrC,MAAM,KAAK,GAAgD,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,eAAe;QACf,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;YAEtD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAGtC,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;gBAC/B,MAAM;gBACN,GAAG;gBACH,QAAQ;gBACR,UAAU;gBACV,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;aAC/B,CAAC,CAAC;YAEH,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,UAAU,EAAE,UAAU,CAAC,UAAU;aAClC,CAAC,CAAC;YAEH,UAAU,EAAE,CAAC;QACf,CAAC;QAED,4BAA4B;QAC5B,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE;YACrD,MAAM;YACN,GAAG;YACH,QAAQ;YACR,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oFAAoF;QACpF,eAAe;QACf,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;gBAClD,MAAM;gBACN,GAAG;gBACH,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,KAAK,CAAC,yBAAyB,QAAQ,iBAAiB,SAAS,CAAC,UAAU,CAAC,GAAG,EAC7F,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/procedures/snapshot/delete.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snapshot.delete procedure
+ *
+ * Delete a snapshot from S3.
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { SnapshotDeleteInput, SnapshotDeleteOutput } from "../../types.js";
+/**
+ * Delete a snapshot from S3
+ */
+export declare function snapshotDelete(input: SnapshotDeleteInput, ctx: ProcedureContext): Promise<SnapshotDeleteOutput>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/procedures/snapshot/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGhF;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,oBAAoB,CAAC,CAuB/B"}

package/dist/procedures/snapshot/delete.js

@@ -0,0 +1,31 @@
+/**
+ * snapshot.delete procedure
+ *
+ * Delete a snapshot from S3.
+ */
+import { listAllObjects, findSnapshotKeys } from "./s3-lookup.js";
+/**
+ * Delete a snapshot from S3
+ */
+export async function snapshotDelete(input, ctx) {
+    // Find all files for this snapshot ID (paginated listing, exact basename
+    // match). Exact matching is critical here: a substring match could delete a
+    // different snapshot whose id contains this id as a substring.
+    const objects = await listAllObjects(ctx, input.bucket, "snapshots/");
+    const snapshotKeys = findSnapshotKeys(objects, input.id);
+    if (snapshotKeys.length === 0) {
+        throw new Error(`Snapshot not found: ${input.id}`);
+    }
+    // Delete each file
+    for (const key of snapshotKeys) {
+        await ctx.client.call(["s3", "delete"], {
+            bucket: input.bucket,
+            key,
+        });
+    }
+    return {
+        deleted: true,
+        id: input.id,
+    };
+}
+//# sourceMappingURL=delete.js.map

package/dist/procedures/snapshot/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA0B,EAC1B,GAAqB;IAErB,yEAAyE;IACzE,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAEzD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;YACtC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,EAAE,EAAE,KAAK,CAAC,EAAE;KACb,CAAC;AACJ,CAAC"}

package/dist/procedures/snapshot/diff.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snapshot.diff procedure
+ *
+ * Compare current state against a snapshot.
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { SnapshotDiffInput, SnapshotDiffOutput } from "../../types.js";
+/**
+ * Compare current state against a snapshot
+ */
+export declare function snapshotDiff(input: SnapshotDiffInput, ctx: ProcedureContext): Promise<SnapshotDiffOutput>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/procedures/snapshot/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAGnB,MAAM,gBAAgB,CAAC;AAGxB;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,kBAAkB,CAAC,CA0H7B"}

package/dist/procedures/snapshot/diff.js

@@ -0,0 +1,113 @@
+/**
+ * snapshot.diff procedure
+ *
+ * Compare current state against a snapshot.
+ */
+import { existsSync } from "node:fs";
+import { basename } from "node:path";
+import { gitText } from "./commands.js";
+import { listAllObjects, findSnapshotKey } from "./s3-lookup.js";
+/**
+ * Compare current state against a snapshot
+ */
+export async function snapshotDiff(input, ctx) {
+    // Download snapshot metadata (paginated listing, exact basename match).
+    const objects = await listAllObjects(ctx, input.bucket, "snapshots/");
+    const metadataKey = findSnapshotKey(objects, input.id, ".metadata.json");
+    if (!metadataKey) {
+        throw new Error(`Snapshot not found: ${input.id}`);
+    }
+    const metadataResult = await ctx.client.call(["s3", "download"], {
+        bucket: input.bucket,
+        key: metadataKey,
+        encoding: "utf8",
+    });
+    const snapshotMetadata = JSON.parse(metadataResult.body);
+    // Compare each repository
+    const repositories = [];
+    let totalFilesChanged = 0;
+    let reposChanged = 0;
+    const pathsToCheck = input.paths || snapshotMetadata.repositories.map((r) => r.path);
+    for (const repoPath of pathsToCheck) {
+        const snapshotRepo = snapshotMetadata.repositories.find((r) => r.path === repoPath || r.name === basename(repoPath));
+        if (!snapshotRepo)
+            continue;
+        const diff = {
+            path: repoPath,
+            filesChanged: 0,
+            newStashes: 0,
+        };
+        if (!existsSync(repoPath)) {
+            // Repository was deleted
+            diff.filesChanged = -1; // Indicates missing
+            repositories.push(diff);
+            reposChanged++;
+            continue;
+        }
+        try {
+            // Get current branch (a failure is an error of this repository: the catch below)
+            const currentBranch = await gitText(["rev-parse", "--abbrev-ref", "HEAD"], repoPath, ctx.signal);
+            if (currentBranch === undefined)
+                throw new Error(`git cannot read the branch of ${repoPath}`);
+            if (currentBranch !== snapshotRepo.branch) {
+                diff.branchDiff = {
+                    current: currentBranch,
+                    snapshot: snapshotRepo.branch,
+                };
+            }
+            // Get current commit
+            const currentCommit = await gitText(["rev-parse", "HEAD"], repoPath, ctx.signal);
+            if (currentCommit === undefined)
+                throw new Error(`git cannot read the commit of ${repoPath}`);
+            if (currentCommit !== snapshotRepo.commit) {
+                diff.commitDiff = {
+                    current: currentCommit,
+                    snapshot: snapshotRepo.commit,
+                };
+                // Count files changed since snapshot commit.
+                // The commit comes from snapshot metadata downloaded from S3: accept only a hex
+                // object name, and pass it as an argument (no shell), so it cannot inject a command.
+                try {
+                    if (!/^[0-9a-f]{7,64}$/i.test(snapshotRepo.commit)) {
+                        throw new Error(`Not a commit hash: ${snapshotRepo.commit}`);
+                    }
+                    const diffStat = await gitText(["diff", "--stat", `${snapshotRepo.commit}..HEAD`], repoPath, ctx.signal);
+                    if (diffStat === undefined)
+                        throw new Error(`git cannot compare ${snapshotRepo.commit} with HEAD`);
+                    // Count lines that represent files (contain |)
+                    diff.filesChanged = diffStat.split("\n").filter((l) => l.includes("|")).length;
+                    totalFilesChanged += diff.filesChanged;
+                }
+                catch {
+                    // Snapshot commit may not exist locally
+                    diff.filesChanged = -1;
+                }
+            }
+            // Check for new stashes
+            const stashResult = await ctx.client.call(["git", "stash", "list"], { cwd: repoPath });
+            diff.newStashes = stashResult.count - snapshotRepo.stashCount;
+            if (diff.branchDiff ||
+                diff.commitDiff ||
+                diff.filesChanged > 0 ||
+                diff.newStashes > 0) {
+                reposChanged++;
+            }
+        }
+        catch {
+            // Not a git repo or error
+            diff.filesChanged = -1;
+            reposChanged++;
+        }
+        repositories.push(diff);
+    }
+    return {
+        snapshotMetadata,
+        repositories,
+        summary: {
+            reposChanged,
+            totalFilesChanged,
+            isMatch: reposChanged === 0,
+        },
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/procedures/snapshot/diff.js.map

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

package/dist/procedures/snapshot/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Snapshot Procedures Index
+ */
+export { snapshotCreate } from "./create.js";
+export { snapshotList } from "./list.js";
+export { snapshotRestore } from "./restore.js";
+export { snapshotDiff } from "./diff.js";
+export { snapshotDelete } from "./delete.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/procedures/snapshot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/snapshot/index.js

@@ -0,0 +1,9 @@
+/**
+ * Snapshot Procedures Index
+ */
+export { snapshotCreate } from "./create.js";
+export { snapshotList } from "./list.js";
+export { snapshotRestore } from "./restore.js";
+export { snapshotDiff } from "./diff.js";
+export { snapshotDelete } from "./delete.js";
+//# sourceMappingURL=index.js.map

package/dist/procedures/snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/snapshot/list.d.ts

@@ -0,0 +1,12 @@
+/**
+ * snapshot.list procedure
+ *
+ * List available snapshots in S3 bucket.
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { SnapshotListInput, SnapshotListOutput } from "../../types.js";
+/**
+ * List snapshots in S3 bucket
+ */
+export declare function snapshotList(input: SnapshotListInput, ctx: ProcedureContext): Promise<SnapshotListOutput>;
+//# sourceMappingURL=list.d.ts.map

package/dist/procedures/snapshot/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAGnB,MAAM,gBAAgB,CAAC;AAGxB;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAoD7B"}