@procedures/snapshot 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -9,7 +9,7 @@
  * - medium: + node_modules (~2GB)
  * - heavy: + pnpm store (~10GB+)
  */
-import "./register.js";
+export * from "./module.js";
 export type { SnapshotPreset, RepositoryInfo, SnapshotMetadata, SnapshotCreateInput, SnapshotCreateOutput, SnapshotRestoreInput, SnapshotRestoreOutput, SnapshotListInput, SnapshotListOutput, SnapshotListEntry, SnapshotDiffInput, SnapshotDiffOutput, SnapshotDiffRepository, SnapshotDeleteInput, SnapshotDeleteOutput, } from "./types.js";
 export { SnapshotPresetSchema, SnapshotCreateInputSchema, SnapshotRestoreInputSchema, SnapshotListInputSchema, SnapshotDiffInputSchema, SnapshotDeleteInputSchema, } from "./types.js";
 export { snapshotCreate, snapshotList, snapshotRestore, snapshotDiff, snapshotDelete, } from "./procedures/snapshot/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,eAAe,CAAC;AAGvB,YAAY,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAG5B,YAAY,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -9,8 +9,7 @@
  * - medium: + node_modules (~2GB)
  * - heavy: + pnpm store (~10GB+)
  */
-// Importing the package registers its procedures, as in the other client packages (BUGS-2026-07 H18)
-import "./register.js";
+export * from "./module.js";
 // Re-export schemas
 export { SnapshotPresetSchema, SnapshotCreateInputSchema, SnapshotRestoreInputSchema, SnapshotListInputSchema, SnapshotDiffInputSchema, SnapshotDeleteInputSchema, } from "./types.js";
 // Re-export procedure implementations

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qGAAqG;AACrG,OAAO,eAAe,CAAC;AAqBvB,oBAAoB;AACpB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,sCAAsC;AACtC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,aAAa,CAAC;AAqB5B,oBAAoB;AACpB,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,sCAAsC;AACtC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,gCAAgC,CAAC"}

package/dist/module.d.ts

@@ -5,11 +5,17 @@
  *
  * Provides snapshot.create, snapshot.list, snapshot.restore, snapshot.diff, snapshot.delete procedures.
  */
-import { type ProcedureModule } from "@procedures/client";
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
 /**
  * The module of this package, for `createRegistry()`: its procedures as data. Importing this
  * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
  */
 export declare const snapshotModule: ProcedureModule;
 export default snapshotModule;
+/**
+ * This function registers the procedures of @procedures/snapshot, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export declare function registerSnapshotProcedures(registry?: ProcedureRegistry): void;
 //# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmHrG;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,eAMzB,CAAC;eAEU,cAAc"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA6C,KAAK,eAAe,EAAuC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA6HlK;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,eAMzB,CAAC;eAEU,cAAc;AAE7B;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAEjG"}

package/dist/module.js

@@ -5,7 +5,7 @@
  *
  * Provides snapshot.create, snapshot.list, snapshot.restore, snapshot.diff, snapshot.delete procedures.
  */
-import { createProcedure, zodAdapter, defineModule } from "@procedures/client";
+import { createProcedure, zodAdapter, defineModule, PROCEDURE_REGISTRY, registerModules } from "@procedures/client";
 import { snapshotCreate, snapshotList, snapshotRestore, snapshotDiff, snapshotDelete, } from "./procedures/snapshot/index.js";
 import { SnapshotCreateInputSchema, SnapshotListInputSchema, SnapshotRestoreInputSchema, SnapshotDiffInputSchema, SnapshotDeleteInputSchema, SnapshotCreateOutputSchema, SnapshotRestoreOutputSchema, SnapshotListOutputSchema, SnapshotDiffOutputSchema, SnapshotDeleteOutputSchema, } from "./types.js";
 // =============================================================================
@@ -17,6 +17,9 @@ const snapshotCreateProcedure = createProcedure()
     .output(zodAdapter(SnapshotCreateOutputSchema))
     .meta({
     description: "Create environment snapshot and upload to S3",
+    // It writes the archive to a new folder of the temporary directory and to new S3 keys with a
+    // unique id, so it replaces no data
+    effects: { reads: ["fs", "s3", "network"], writes: ["fs", "s3", "network"], destructive: false },
     args: ["name"],
     shorts: { bucket: "b", preset: "p", description: "d" },
     output: "json",
@@ -31,6 +34,8 @@ const snapshotListProcedure = createProcedure()
     .output(zodAdapter(SnapshotListOutputSchema))
     .meta({
     description: "List available snapshots in S3 bucket",
+    // It downloads the metadata files into memory, not to a file
+    effects: { reads: ["s3", "network"], writes: [] },
     args: [],
     shorts: { bucket: "b", prefix: "p", maxResults: "n" },
     output: "json",
@@ -45,6 +50,8 @@ const snapshotRestoreProcedure = createProcedure()
     .output(zodAdapter(SnapshotRestoreOutputSchema))
     .meta({
     description: "Restore environment from S3 snapshot",
+    // With overwrite: true, a restored folder replaces the existing folder
+    effects: { reads: ["fs", "s3", "network"], writes: ["fs"] },
     args: ["id"],
     shorts: { bucket: "b", targetPath: "t", overwrite: "f" },
     output: "json",
@@ -59,6 +66,8 @@ const snapshotDiffProcedure = createProcedure()
     .output(zodAdapter(SnapshotDiffOutputSchema))
     .meta({
     description: "Compare current state against a snapshot",
+    // It reads the repositories with git queries that change nothing
+    effects: { reads: ["fs", "s3", "network"], writes: [] },
     args: ["id"],
     shorts: { bucket: "b" },
     output: "json",
@@ -73,6 +82,7 @@ const snapshotDeleteProcedure = createProcedure()
     .output(zodAdapter(SnapshotDeleteOutputSchema))
     .meta({
     description: "Delete a snapshot from S3",
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"] },
     args: ["id"],
     shorts: { bucket: "b" },
     output: "json",
@@ -96,4 +106,12 @@ export const snapshotModule = defineModule("@procedures/snapshot", [
     snapshotDeleteProcedure,
 ]);
 export default snapshotModule;
+/**
+ * This function registers the procedures of @procedures/snapshot, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export function registerSnapshotProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [snapshotModule]);
+}
 //# sourceMappingURL=module.js.map

package/dist/module.js.map

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

package/dist/register.d.ts

@@ -1,8 +1,7 @@
 /**
- * Importing this file registers the procedures of @procedures/snapshot in the global registry
- * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
- * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ * 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";
-export declare function registerSnapshotProcedures(): void;
 //# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

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

package/dist/register.js

@@ -1,14 +1,9 @@
 /**
- * Importing this file registers the procedures of @procedures/snapshot in the global registry
- * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
- * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ * 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 { registerProcedures } from "@procedures/client";
-import { snapshotModule } from "./module.js";
+import { registerSnapshotProcedures } from "./module.js";
 export * from "./module.js";
-export function registerSnapshotProcedures() {
-    registerProcedures(snapshotModule.procedures);
-}
-// Auto-register when this module is loaded
 registerSnapshotProcedures();
 //# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,0BAA0B;IACxC,kBAAkB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,2CAA2C;AAC3C,0BAA0B,EAAE,CAAC"}
+{"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/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/snapshot",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Snapshot and restore development environments with S3: git state, packages and files, with streamed archives and a safe restore.",
   "keywords": [
     "snapshot",
@@ -34,6 +34,10 @@
       "types": "./dist/module.d.ts",
       "import": "./dist/module.js"
     },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    },
     "./register.js": {
       "import": "./dist/register.js"
     }
@@ -47,7 +51,6 @@
     "CHANGELOG.md"
   ],
   "sideEffects": [
-    "./dist/index.js",
     "./dist/register.js"
   ],
   "engines": {
@@ -58,12 +61,12 @@
     "provenance": true
   },
   "dependencies": {
-    "@procedures/client": "0.1.0",
-    "@procedures/fs": "0.1.0",
-    "@procedures/git": "0.1.0",
-    "@procedures/pnpm": "0.1.0",
-    "@procedures/s3": "0.1.0",
-    "@procedures/shell": "0.1.0",
+    "@procedures/client": "0.2.1",
+    "@procedures/fs": "0.2.1",
+    "@procedures/git": "0.2.1",
+    "@procedures/pnpm": "0.2.1",
+    "@procedures/s3": "0.2.1",
+    "@procedures/shell": "0.2.1",
     "tar": "^7.5.0",
     "zod": "^4.6.5"
   },

package/src/index.ts

@@ -10,8 +10,7 @@
  * - heavy: + pnpm store (~10GB+)
  */
 
-// Importing the package registers its procedures, as in the other client packages (BUGS-2026-07 H18)
-import "./register.js";
+export * from "./module.js";
 
 // Re-export types
 export type {

package/src/module.ts

@@ -6,7 +6,7 @@
  * Provides snapshot.create, snapshot.list, snapshot.restore, snapshot.diff, snapshot.delete procedures.
  */
 
-import { createProcedure, zodAdapter, defineModule, type ProcedureModule } from "@procedures/client";
+import { createProcedure, zodAdapter, defineModule, type ProcedureModule, PROCEDURE_REGISTRY, registerModules, type ProcedureRegistry } from "@procedures/client";
 import type { ProcedureContext } from "@procedures/client";
 import {
   snapshotCreate,
@@ -48,6 +48,9 @@ const snapshotCreateProcedure = createProcedure()
   .output(zodAdapter<SnapshotCreateOutput>(SnapshotCreateOutputSchema))
   .meta({
     description: "Create environment snapshot and upload to S3",
+    // It writes the archive to a new folder of the temporary directory and to new S3 keys with a
+    // unique id, so it replaces no data
+    effects: { reads: ["fs", "s3", "network"], writes: ["fs", "s3", "network"], destructive: false },
     args: ["name"],
     shorts: { bucket: "b", preset: "p", description: "d" },
     output: "json",
@@ -63,6 +66,8 @@ const snapshotListProcedure = createProcedure()
   .output(zodAdapter<SnapshotListOutput>(SnapshotListOutputSchema))
   .meta({
     description: "List available snapshots in S3 bucket",
+    // It downloads the metadata files into memory, not to a file
+    effects: { reads: ["s3", "network"], writes: [] },
     args: [],
     shorts: { bucket: "b", prefix: "p", maxResults: "n" },
     output: "json",
@@ -78,6 +83,8 @@ const snapshotRestoreProcedure = createProcedure()
   .output(zodAdapter<SnapshotRestoreOutput>(SnapshotRestoreOutputSchema))
   .meta({
     description: "Restore environment from S3 snapshot",
+    // With overwrite: true, a restored folder replaces the existing folder
+    effects: { reads: ["fs", "s3", "network"], writes: ["fs"] },
     args: ["id"],
     shorts: { bucket: "b", targetPath: "t", overwrite: "f" },
     output: "json",
@@ -93,6 +100,8 @@ const snapshotDiffProcedure = createProcedure()
   .output(zodAdapter<SnapshotDiffOutput>(SnapshotDiffOutputSchema))
   .meta({
     description: "Compare current state against a snapshot",
+    // It reads the repositories with git queries that change nothing
+    effects: { reads: ["fs", "s3", "network"], writes: [] },
     args: ["id"],
     shorts: { bucket: "b" },
     output: "json",
@@ -108,6 +117,7 @@ const snapshotDeleteProcedure = createProcedure()
   .output(zodAdapter<SnapshotDeleteOutput>(SnapshotDeleteOutputSchema))
   .meta({
     description: "Delete a snapshot from S3",
+    effects: { reads: ["s3", "network"], writes: ["s3", "network"] },
     args: ["id"],
     shorts: { bucket: "b" },
     output: "json",
@@ -134,3 +144,12 @@ export const snapshotModule: ProcedureModule = defineModule("@procedures/snapsho
   ]);
 
 export default snapshotModule;
+
+/**
+ * This function registers the procedures of @procedures/snapshot, and of the modules that it requires, in
+ * a registry. The default is the global registry. Importing this file registers nothing: the
+ * `./register` entry starts this function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export function registerSnapshotProcedures(registry: ProcedureRegistry = PROCEDURE_REGISTRY): void {
+  registerModules(registry, [snapshotModule]);
+}

package/src/register.ts

@@ -1,17 +1,11 @@
 /**
- * Importing this file registers the procedures of @procedures/snapshot in the global registry
- * (DECISIONS-2026-10, "Every package root registers its procedures"). The procedures as data
- * are in `module.ts`, which registers nothing: a host with its own registry uses that one.
+ * 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 { registerProcedures } from "@procedures/client";
-import { snapshotModule } from "./module.js";
+import { registerSnapshotProcedures } from "./module.js";
 
 export * from "./module.js";
 
-export function registerSnapshotProcedures(): void {
-  registerProcedures(snapshotModule.procedures);
-}
-
-// Auto-register when this module is loaded
 registerSnapshotProcedures();