@procedures/snapshot 0.0.0-stage → 0.2.0

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"}

package/dist/procedures/snapshot/list.js

@@ -0,0 +1,57 @@
+/**
+ * snapshot.list procedure
+ *
+ * List available snapshots in S3 bucket.
+ */
+import { listAllObjects } from "./s3-lookup.js";
+/**
+ * List snapshots in S3 bucket
+ */
+export async function snapshotList(input, ctx) {
+    const prefix = input.prefix
+        ? `snapshots/${input.prefix}`
+        : "snapshots/";
+    // List the metadata files of all pages. Sort them by the time of the write (newest first),
+    // then cut. Before, the procedure read one page (S3 lists by key, not by time) and cut it
+    // before the sort, so it returned the oldest snapshots (deep dive DATA-16).
+    const objects = await listAllObjects(ctx, input.bucket, prefix);
+    const metadataKeys = objects
+        .filter((obj) => obj.key.endsWith(".metadata.json"))
+        .sort((a, b) => timeOf(b.lastModified) - timeOf(a.lastModified))
+        .slice(0, input.maxResults);
+    // Fetch metadata for each snapshot
+    const snapshots = [];
+    for (const obj of metadataKeys) {
+        try {
+            const downloadResult = await ctx.client.call(["s3", "download"], {
+                bucket: input.bucket,
+                key: obj.key,
+                encoding: "utf8",
+            });
+            const metadata = JSON.parse(downloadResult.body);
+            snapshots.push({
+                id: metadata.id,
+                name: metadata.name,
+                preset: metadata.preset,
+                createdAt: metadata.createdAt,
+                size: metadata.archiveSize,
+                os: metadata.environment.os,
+            });
+        }
+        catch {
+            // Skip invalid metadata
+        }
+    }
+    // Sort by creation date (newest first)
+    snapshots.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    return {
+        snapshots,
+        count: snapshots.length,
+    };
+}
+/** A time in milliseconds. A missing or invalid time is 0, so it sorts last. */
+function timeOf(iso) {
+    const time = iso ? Date.parse(iso) : NaN;
+    return Number.isNaN(time) ? 0 : time;
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,GAAqB;IAErB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM;QACzB,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE;QAC7B,CAAC,CAAC,YAAY,CAAC;IAEjB,2FAA2F;IAC3F,0FAA0F;IAC1F,4EAA4E;IAC5E,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,OAAO;SACzB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;SACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;SAC/D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE9B,mCAAmC;IACnC,MAAM,SAAS,GAAwB,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAG1C,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE;gBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,QAAQ,EAAE,MAAM;aACjB,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAqB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAEnE,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,IAAI,EAAE,QAAQ,CAAC,WAAW;gBAC1B,EAAE,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtB,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAClE,CAAC;IAEF,OAAO;QACL,SAAS;QACT,KAAK,EAAE,SAAS,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,MAAM,CAAC,GAAuB;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Names and exclusion rules of snapshots.
+ */
+export declare function assertSnapshotName(field: string, value: string): void;
+/**
+ * True when an archive entry is excluded: a pattern matches a whole path segment ("dist"
+ * excludes `dist/` but not `src/distance.ts`), or, for "*.ext", the end of the file name.
+ */
+export declare function isExcluded(entryPath: string, patterns: readonly string[]): boolean;
+//# sourceMappingURL=names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/names.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAMlF"}

package/dist/procedures/snapshot/names.js

@@ -0,0 +1,20 @@
+/**
+ * Names and exclusion rules of snapshots.
+ */
+/** A snapshot name or id: letters, digits, ".", "_" and "-", and not ".." (it goes into paths and S3 keys). */
+const SNAPSHOT_NAME = /^[A-Za-z0-9._-]+$/;
+export function assertSnapshotName(field, value) {
+    if (!SNAPSHOT_NAME.test(value) || value.includes("..")) {
+        throw new Error(`Invalid snapshot ${field}: ${JSON.stringify(value)} (use letters, digits, ".", "_" and "-")`);
+    }
+}
+/**
+ * True when an archive entry is excluded: a pattern matches a whole path segment ("dist"
+ * excludes `dist/` but not `src/distance.ts`), or, for "*.ext", the end of the file name.
+ */
+export function isExcluded(entryPath, patterns) {
+    const segments = entryPath.split(/[\\/]/).filter((segment) => segment.length > 0);
+    const last = segments[segments.length - 1] ?? "";
+    return patterns.some((pattern) => pattern.startsWith("*.") ? last.endsWith(pattern.slice(1)) : segments.includes(pattern));
+}
+//# sourceMappingURL=names.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/names.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+GAA+G;AAC/G,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAE1C,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAa;IAC7D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACjH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,QAA2B;IACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC/B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CACxF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * snapshot.restore procedure
+ *
+ * Restore an environment snapshot from S3.
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { SnapshotRestoreInput, SnapshotRestoreOutput } from "../../types.js";
+/**
+ * Restore a snapshot from S3
+ */
+export declare function snapshotRestore(input: SnapshotRestoreInput, ctx: ProcedureContext): Promise<SnapshotRestoreOutput>;
+//# sourceMappingURL=restore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/restore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,gBAAgB,CAAC;AAKxB;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,EAC3B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,qBAAqB,CAAC,CA2IhC"}

package/dist/procedures/snapshot/restore.js

@@ -0,0 +1,131 @@
+/**
+ * snapshot.restore procedure
+ *
+ * Restore an environment snapshot from S3.
+ */
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, renameSync, rmSync } from "node:fs";
+import { basename, join } from "node:path";
+import { tmpdir } from "node:os";
+import * as tar from "tar";
+import { listAllObjects, findSnapshotKey } from "./s3-lookup.js";
+import { assertSnapshotName } from "./names.js";
+import { sha256File } from "./archive-io.js";
+/**
+ * Restore a snapshot from S3
+ */
+export async function snapshotRestore(input, ctx) {
+    // Scratch directory used solely to hold the downloaded archive; it is always
+    // safe to delete. The extraction target is `input.targetPath` (required) and
+    // is never removed — that is the fix for the self-deleting-restore bug where
+    // targetPath defaulted to workDir and the `finally` then wiped it.
+    //
+    // The id must be a plain name, and the scratch folder is a new unique folder: before, the id
+    // went into the path, so `x/../../<dir>` made the `finally` delete <dir>, even when the S3
+    // lookup failed (deep dive DATA-1).
+    assertSnapshotName("id", input.id);
+    const workDir = mkdtempSync(join(tmpdir(), "restore-"));
+    try {
+        // First, download metadata to get archive location
+        const downloadStart = Date.now();
+        // Find the snapshot by ID (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}`);
+        }
+        // Download metadata
+        const metadataResult = await ctx.client.call(["s3", "download"], {
+            bucket: input.bucket,
+            key: metadataKey,
+            encoding: "utf8",
+        });
+        const metadata = JSON.parse(metadataResult.body);
+        // Download archive
+        const archiveKey = metadataKey.replace(".metadata.json", ".tar.gz");
+        const archivePath = join(workDir, `${input.id}.tar.gz`);
+        // Stream the archive to disk: an archive can be large, and loading it into memory as
+        // base64 was a third larger again (BUGS-2026-07 M22)
+        await ctx.client.call(["s3", "download"], {
+            bucket: input.bucket,
+            key: archiveKey,
+            destPath: archivePath,
+        });
+        // Verify the downloaded archive against the checksum recorded at snapshot
+        // creation time. Do this before extracting so a corrupted or tampered
+        // archive never reaches the target directory.
+        if (metadata.checksum) {
+            const actualChecksum = await sha256File(archivePath);
+            if (actualChecksum !== metadata.checksum) {
+                throw new Error(`Checksum mismatch for snapshot ${input.id}: expected ${metadata.checksum}, got ${actualChecksum}`);
+            }
+        }
+        const downloadDuration = Date.now() - downloadStart;
+        // Extract archive into the caller-provided target directory.
+        const extractStart = Date.now();
+        const targetPath = input.targetPath;
+        if (!existsSync(targetPath)) {
+            mkdirSync(targetPath, { recursive: true });
+        }
+        // Check for existing files if not overwriting
+        if (!input.overwrite) {
+            // The archive stores each repository under the base name of its path (createArchive), not
+            // under its package name: before, the guard checked the package name, so an existing working
+            // copy was overwritten with overwrite: false (deep dive DATA-2)
+            for (const repo of metadata.repositories) {
+                const repoPath = join(targetPath, basename(repo.path));
+                if (existsSync(repoPath)) {
+                    throw new Error(`Target path already exists: ${repoPath}. Use overwrite: true to replace.`);
+                }
+            }
+        }
+        // Extract into a staging folder in the target, then move each top-level folder into place.
+        // With overwrite: true, a restored folder replaces the existing one: before, the archive
+        // was extracted over it, and files that the snapshot does not hold stayed. A failed
+        // extraction leaves the target as it was.
+        const staging = mkdtempSync(join(targetPath, ".snapshot-restore-"));
+        try {
+            await tar.extract({
+                file: archivePath,
+                cwd: staging,
+            });
+            for (const entry of readdirSync(staging)) {
+                const destination = join(targetPath, entry);
+                if (existsSync(destination)) {
+                    if (!input.overwrite) {
+                        throw new Error(`Target path already exists: ${destination}. Use overwrite: true to replace.`);
+                    }
+                    rmSync(destination, { recursive: true, force: true });
+                }
+                renameSync(join(staging, entry), destination);
+            }
+        }
+        finally {
+            rmSync(staging, { recursive: true, force: true });
+        }
+        const extractDuration = Date.now() - extractStart;
+        // Restore stashes if available
+        const restoredPaths = [];
+        for (const repo of metadata.repositories) {
+            const repoPath = join(targetPath, basename(repo.path));
+            if (existsSync(repoPath)) {
+                restoredPaths.push(repoPath);
+            }
+        }
+        return {
+            success: true,
+            metadata,
+            restoredPaths,
+            downloadDuration,
+            extractDuration,
+        };
+    }
+    finally {
+        // Only ever remove the scratch download directory — never the extraction
+        // target. The `workDir !== input.targetPath` guard is belt-and-suspenders:
+        // targetPath is required and distinct from the temp scratch dir.
+        if (existsSync(workDir) && workDir !== input.targetPath) {
+            rmSync(workDir, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=restore.js.map

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

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

package/dist/procedures/snapshot/s3-lookup.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared S3 lookup helpers for snapshot procedures.
+ *
+ * Snapshot objects are stored under keys of the form
+ *   snapshots/<name>/<id>.tar.gz
+ *   snapshots/<name>/<id>.metadata.json
+ * where <id> already embeds <name>, a timestamp and a random suffix, so the
+ * final path segment (basename) of a key uniquely identifies a snapshot file.
+ *
+ * These helpers replace the previous "single s3.list + key.includes(id)"
+ * approach, which (a) missed snapshots once a bucket held more than 1000
+ * objects (S3 truncates and requires continuation), and (b) matched by
+ * substring, so an id that is a substring of a different snapshot's id could
+ * resolve to — and, for delete, remove — the wrong files.
+ */
+import type { ProcedureContext } from "@procedures/client";
+export interface S3ListedObject {
+    key: string;
+    /** The time of the last write (ISO 8601), as s3.list gives it */
+    lastModified?: string;
+}
+/**
+ * List every object under `prefix`, following S3 pagination via
+ * continuationToken until the listing is no longer truncated.
+ */
+export declare function listAllObjects(ctx: ProcedureContext, bucket: string, prefix: string): Promise<S3ListedObject[]>;
+/**
+ * Find the single object whose basename is exactly `${id}${suffix}`.
+ *
+ * Matching is by exact basename equality, never substring, so an id that is a
+ * substring of a different snapshot's id can never resolve to the wrong file.
+ */
+export declare function findSnapshotKey(objects: S3ListedObject[], id: string, suffix: string): string | undefined;
+/**
+ * All object keys belonging to snapshot `id` (archive + metadata), matched by
+ * exact basename so delete can never remove a different snapshot's files.
+ */
+export declare function findSnapshotKeys(objects: S3ListedObject[], id: string): string[];
+//# sourceMappingURL=s3-lookup.d.ts.map

package/dist/procedures/snapshot/s3-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-lookup.d.ts","sourceRoot":"","sources":["../../../src/procedures/snapshot/s3-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC,CAmB3B;AAQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EAAE,EACzB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAGpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAGhF"}

package/dist/procedures/snapshot/s3-lookup.js

@@ -0,0 +1,57 @@
+/**
+ * Shared S3 lookup helpers for snapshot procedures.
+ *
+ * Snapshot objects are stored under keys of the form
+ *   snapshots/<name>/<id>.tar.gz
+ *   snapshots/<name>/<id>.metadata.json
+ * where <id> already embeds <name>, a timestamp and a random suffix, so the
+ * final path segment (basename) of a key uniquely identifies a snapshot file.
+ *
+ * These helpers replace the previous "single s3.list + key.includes(id)"
+ * approach, which (a) missed snapshots once a bucket held more than 1000
+ * objects (S3 truncates and requires continuation), and (b) matched by
+ * substring, so an id that is a substring of a different snapshot's id could
+ * resolve to — and, for delete, remove — the wrong files.
+ */
+/**
+ * List every object under `prefix`, following S3 pagination via
+ * continuationToken until the listing is no longer truncated.
+ */
+export async function listAllObjects(ctx, bucket, prefix) {
+    const all = [];
+    let continuationToken;
+    do {
+        const result = await ctx.client.call(["s3", "list"], {
+            bucket,
+            prefix,
+            ...(continuationToken ? { continuationToken } : {}),
+        });
+        all.push(...result.contents);
+        continuationToken = result.isTruncated ? result.nextContinuationToken : undefined;
+    } while (continuationToken);
+    return all;
+}
+/** Final path segment of an S3 key. */
+function basenameOf(key) {
+    const idx = key.lastIndexOf("/");
+    return idx === -1 ? key : key.slice(idx + 1);
+}
+/**
+ * Find the single object whose basename is exactly `${id}${suffix}`.
+ *
+ * Matching is by exact basename equality, never substring, so an id that is a
+ * substring of a different snapshot's id can never resolve to the wrong file.
+ */
+export function findSnapshotKey(objects, id, suffix) {
+    const target = `${id}${suffix}`;
+    return objects.find((obj) => basenameOf(obj.key) === target)?.key;
+}
+/**
+ * All object keys belonging to snapshot `id` (archive + metadata), matched by
+ * exact basename so delete can never remove a different snapshot's files.
+ */
+export function findSnapshotKeys(objects, id) {
+    const targets = new Set([`${id}.tar.gz`, `${id}.metadata.json`]);
+    return objects.filter((obj) => targets.has(basenameOf(obj.key))).map((obj) => obj.key);
+}
+//# sourceMappingURL=s3-lookup.js.map

package/dist/procedures/snapshot/s3-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-lookup.js","sourceRoot":"","sources":["../../../src/procedures/snapshot/s3-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAqB,EACrB,MAAc,EACd,MAAc;IAEd,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,IAAI,iBAAqC,CAAC;IAE1C,GAAG,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAGlC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;YAChB,MAAM;YACN,MAAM;YACN,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD,CAAC,CAAC;QAEH,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,CAAC,QAAQ,iBAAiB,EAAE;IAE5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uCAAuC;AACvC,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAyB,EACzB,EAAU,EACV,MAAc;IAEd,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAChC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAyB,EAAE,EAAU;IACpE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzF,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Importing this file registers the procedures of @procedures/snapshot, and of the modules that it
+ * requires, in the global registry: `import "@procedures/snapshot/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,9 @@
+/**
+ * Importing this file registers the procedures of @procedures/snapshot, and of the modules that it
+ * requires, in the global registry: `import "@procedures/snapshot/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+import { registerSnapshotProcedures } from "./module.js";
+export * from "./module.js";
+registerSnapshotProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD,cAAc,aAAa,CAAC;AAE5B,0BAA0B,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Type definitions for client-snapshot procedures
+ *
+ * Environment snapshot/restore for testing and recovery.
+ * Supports light/medium/heavy presets for different capture levels.
+ */
+import { z } from "zod";
+export type SnapshotPreset = "light" | "medium" | "heavy";
+export declare const SnapshotPresetSchema: z.ZodEnum<{
+    light: "light";
+    medium: "medium";
+    heavy: "heavy";
+}>;
+/**
+ * Preset descriptions:
+ * - light: Git repos only (.git, working tree, branches, stashes) ~500MB
+ * - medium: + node_modules + pnpm lockfiles ~2GB
+ * - heavy: + pnpm store + global installs + configs ~10GB+
+ */
+export interface RepositoryInfo {
+    /** Repository path relative to snapshot root */
+    path: string;
+    /** Package name from package.json */
+    name: string;
+    /** Current branch */
+    branch: string;
+    /** HEAD commit hash */
+    commit: string;
+    /** Whether working tree is dirty */
+    dirty: boolean;
+    /** Number of stashes */
+    stashCount: number;
+    /** Remote URL */
+    remoteUrl?: string | undefined;
+    /** Commits ahead of remote */
+    ahead: number;
+    /** Commits behind remote */
+    behind: number;
+}
+export interface SnapshotMetadata {
+    /** Unique snapshot ID */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Snapshot preset used */
+    preset: SnapshotPreset;
+    /** Creation timestamp (ISO string) */
+    createdAt: string;
+    /** Environment info */
+    environment: {
+        /** Operating system (win32, darwin, linux) */
+        os: string;
+        /** Node.js version */
+        nodeVersion: string;
+        /** pnpm version */
+        pnpmVersion: string;
+        /** Username who created snapshot */
+        username: string;
+        /** Hostname */
+        hostname: string;
+    };
+    /** List of repositories in snapshot */
+    repositories: RepositoryInfo[];
+    /** Archive checksum (SHA-256) */
+    checksum: string;
+    /** Compressed archive size in bytes */
+    archiveSize: number;
+    /** Optional description */
+    description?: string | undefined;
+}
+export declare const SnapshotCreateInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    preset: z.ZodDefault<z.ZodEnum<{
+        light: "light";
+        medium: "medium";
+        heavy: "heavy";
+    }>>;
+    bucket: z.ZodString;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    description: z.ZodOptional<z.ZodString>;
+}>;
+export type SnapshotCreateInput = z.infer<typeof SnapshotCreateInputSchema>;
+export interface SnapshotCreateOutput {
+    /** Snapshot ID */
+    id: string;
+    /** S3 location */
+    location: string;
+    /** Metadata */
+    metadata: SnapshotMetadata;
+    /** Upload duration in ms */
+    uploadDuration: number;
+}
+export declare const SnapshotRestoreInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bucket: z.ZodString;
+    targetPath: z.ZodString;
+    overwrite: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}>;
+export type SnapshotRestoreInput = z.infer<typeof SnapshotRestoreInputSchema>;
+export interface SnapshotRestoreOutput {
+    /** Whether restore succeeded */
+    success: boolean;
+    /** Restored snapshot metadata */
+    metadata: SnapshotMetadata;
+    /** Paths that were restored */
+    restoredPaths: string[];
+    /** Download duration in ms */
+    downloadDuration: number;
+    /** Extract duration in ms */
+    extractDuration: number;
+}
+export declare const SnapshotListInputSchema: z.ZodObject<{
+    bucket: z.ZodString;
+    prefix: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}>;
+export type SnapshotListInput = z.infer<typeof SnapshotListInputSchema>;
+export interface SnapshotListEntry {
+    /** Snapshot ID */
+    id: string;
+    /** Snapshot name */
+    name: string;
+    /** Preset used */
+    preset: SnapshotPreset;
+    /** Creation date */
+    createdAt: string;
+    /** Archive size in bytes */
+    size: number;
+    /** OS it was created on */
+    os: string;
+}
+export interface SnapshotListOutput {
+    /** List of snapshots */
+    snapshots: SnapshotListEntry[];
+    /** Total count */
+    count: number;
+}
+export declare const SnapshotDiffInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bucket: z.ZodString;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}>;
+export type SnapshotDiffInput = z.infer<typeof SnapshotDiffInputSchema>;
+export interface SnapshotDiffRepository {
+    /** Repository path */
+    path: string;
+    /** Branch difference (current vs snapshot) */
+    branchDiff?: {
+        current: string;
+        snapshot: string;
+    } | undefined;
+    /** Commit difference */
+    commitDiff?: {
+        current: string;
+        snapshot: string;
+    } | undefined;
+    /** Files changed since snapshot */
+    filesChanged: number;
+    /** New stashes since snapshot */
+    newStashes: number;
+}
+export interface SnapshotDiffOutput {
+    /** Snapshot metadata for comparison */
+    snapshotMetadata: SnapshotMetadata;
+    /** Per-repository differences */
+    repositories: SnapshotDiffRepository[];
+    /** Overall summary */
+    summary: {
+        /** Total repos with differences */
+        reposChanged: number;
+        /** Total files changed */
+        totalFilesChanged: number;
+        /** Whether current state matches snapshot */
+        isMatch: boolean;
+    };
+}
+export declare const SnapshotDeleteInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    bucket: z.ZodString;
+}>;
+export type SnapshotDeleteInput = z.infer<typeof SnapshotDeleteInputSchema>;
+export interface SnapshotDeleteOutput {
+    /** Whether deletion succeeded */
+    deleted: boolean;
+    /** Deleted snapshot ID */
+    id: string;
+}
+export declare const SnapshotCreateOutputSchema: z.ZodType<SnapshotCreateOutput>;
+export declare const SnapshotRestoreOutputSchema: z.ZodType<SnapshotRestoreOutput>;
+export declare const SnapshotListOutputSchema: z.ZodType<SnapshotListOutput>;
+export declare const SnapshotDiffOutputSchema: z.ZodType<SnapshotDiffOutput>;
+export declare const SnapshotDeleteOutputSchema: z.ZodType<SnapshotDeleteOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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