@procedures/docker 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -31,5 +31,5 @@ export type { DockerRunInput, DockerBuildInput, DockerPullInput, DockerExecInput
 export type { DockerLogItem } from "./procedures/docker/logs.js";
 export { DockerRunInputSchema, DockerBuildInputSchema, DockerPullInputSchema, DockerExecInputSchema, DockerStopInputSchema, DockerRmInputSchema, DockerPsInputSchema, DockerLogsInputSchema, DockerComposeUpInputSchema, DockerComposeDownInputSchema, } from "./types.js";
 export { dockerRun, dockerBuild, dockerPull, dockerExec, dockerStop, dockerRm, dockerPs, dockerLogs, dockerComposeUp, dockerComposeDown, } from "./procedures/docker/index.js";
-export { registerDockerProcedures } from "./register.js";
+export { registerDockerProcedures } from "./module.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -31,5 +31,5 @@ export { DockerRunInputSchema, DockerBuildInputSchema, DockerPullInputSchema, Do
 // Procedures
 export { dockerRun, dockerBuild, dockerPull, dockerExec, dockerStop, dockerRm, dockerPs, dockerLogs, dockerComposeUp, dockerComposeDown, } from "./procedures/docker/index.js";
 // Registration
-export { registerDockerProcedures } from "./register.js";
+export { registerDockerProcedures } from "./module.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAkBH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAEtC,eAAe;AACf,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAkBH,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAEtC,eAAe;AACf,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/module.d.ts

@@ -6,11 +6,17 @@
  * Provides docker.run, docker.build, docker.pull, docker.exec, docker.stop,
  * docker.rm, docker.ps, docker.logs, docker.compose.up, docker.compose.down 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 dockerModule: ProcedureModule;
 export default dockerModule;
+/**
+ * This function registers the procedures of @procedures/docker, 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 registerDockerProcedures(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;;;;;;;GAOG;AAGH,OAAO,EAA6C,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiNrG;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAWR,CAAC;eAEL,YAAY"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAA6C,KAAK,eAAe,EAAuC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAqOlK;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,eAWR,CAAC;eAEL,YAAY;AAE3B;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE/F"}

package/dist/module.js

@@ -6,7 +6,7 @@
  * Provides docker.run, docker.build, docker.pull, docker.exec, docker.stop,
  * docker.rm, docker.ps, docker.logs, docker.compose.up, docker.compose.down procedures.
  */
-import { createProcedure, zodAdapter, defineModule } from "@procedures/client";
+import { createProcedure, zodAdapter, defineModule, PROCEDURE_REGISTRY, registerModules } from "@procedures/client";
 import shellModule from "@procedures/shell/module";
 import { dockerRun, dockerBuild, dockerPull, dockerExec, dockerStop, dockerRm, dockerPs, dockerLogs, dockerComposeUp, dockerComposeDown, } from "./procedures/docker/index.js";
 import { DockerRunInputSchema, DockerBuildInputSchema, DockerPullInputSchema, DockerExecInputSchema, DockerStopInputSchema, DockerRmInputSchema, DockerPsInputSchema, DockerLogsInputSchema, DockerComposeUpInputSchema, DockerComposeDownInputSchema, DockerCommandOutputSchema, DockerLogsOutputSchema, } from "./types.js";
@@ -20,6 +20,9 @@ const dockerRunProcedure = createProcedure()
     .meta({
     description: "Run a Docker container",
     calls: ["shell.run"],
+    // The container runs the image and command of the caller. The volumes give it host files, and
+    // docker pulls a missing image.
+    effects: { reads: ["docker", "fs", "network"], writes: ["docker", "fs", "process"] },
     args: ["image"],
     shorts: { name: "n", detach: "d" },
     output: "json",
@@ -35,6 +38,9 @@ const dockerBuildProcedure = createProcedure()
     .meta({
     description: "Build a Docker image",
     calls: ["shell.run"],
+    // The RUN steps of the Dockerfile are code of the project. Docker reads the context and pulls
+    // the base images. The tag goes to the new image, and the earlier image stays.
+    effects: { reads: ["docker", "fs", "network"], writes: ["docker", "process"], destructive: false },
     args: ["context"],
     shorts: { tag: "t", dockerfile: "f" },
     output: "json",
@@ -50,6 +56,7 @@ const dockerPullProcedure = createProcedure()
     .meta({
     description: "Pull a Docker image",
     calls: ["shell.run"],
+    effects: { reads: ["docker", "network"], writes: ["docker"], destructive: false, idempotent: true },
     args: ["image"],
     output: "json",
 })
@@ -64,6 +71,8 @@ const dockerExecProcedure = createProcedure()
     .meta({
     description: "Execute command in a running container",
     calls: ["shell.run"],
+    // The container runs the command of the caller
+    effects: { reads: ["docker"], writes: ["docker", "process"] },
     args: ["container", "command"],
     shorts: { interactive: "i", tty: "t", workdir: "w" },
     output: "json",
@@ -79,6 +88,8 @@ const dockerStopProcedure = createProcedure()
     .meta({
     description: "Stop running container(s)",
     calls: ["shell.run"],
+    // The stop of a stopped container changes nothing
+    effects: { reads: ["docker"], writes: ["docker"], idempotent: true },
     args: ["containers"],
     shorts: { time: "t" },
     output: "json",
@@ -94,6 +105,7 @@ const dockerRmProcedure = createProcedure()
     .meta({
     description: "Remove container(s)",
     calls: ["shell.run"],
+    effects: { reads: ["docker"], writes: ["docker"] },
     args: ["containers"],
     shorts: { force: "f", volumes: "v" },
     output: "json",
@@ -109,6 +121,7 @@ const dockerPsProcedure = createProcedure()
     .meta({
     description: "List containers",
     calls: ["shell.run"],
+    effects: { reads: ["docker"], writes: [] },
     shorts: { all: "a", filter: "f", format: "F" },
     output: "json",
 })
@@ -124,6 +137,7 @@ const dockerLogsProcedure = createProcedure()
     .meta({
     description: "Get container logs",
     calls: ["shell.run", "shell.stream"],
+    effects: { reads: ["docker"], writes: [] },
     args: ["container"],
     shorts: { follow: "f", tail: "n", timestamps: "t" },
     output: "json",
@@ -139,6 +153,9 @@ const dockerComposeUpProcedure = createProcedure()
     .meta({
     description: "Start services with docker compose",
     calls: ["shell.run"],
+    // The compose file of the caller sets the images, the commands and the host folders of the
+    // services. An up can replace the containers of changed services.
+    effects: { reads: ["docker", "fs", "network"], writes: ["docker", "fs", "process"] },
     shorts: { file: "f", detach: "d", build: "b" },
     output: "json",
 })
@@ -153,6 +170,9 @@ const dockerComposeDownProcedure = createProcedure()
     .meta({
     description: "Stop services with docker compose",
     calls: ["shell.run"],
+    // It removes the containers of the project, and with volumes: true its volumes. A second down
+    // changes nothing.
+    effects: { reads: ["docker", "fs"], writes: ["docker"], idempotent: true },
     shorts: { file: "f", volumes: "v" },
     output: "json",
 })
@@ -180,4 +200,12 @@ export const dockerModule = defineModule("@procedures/docker", [
     dockerComposeDownProcedure,
 ], [shellModule]);
 export default dockerModule;
+/**
+ * This function registers the procedures of @procedures/docker, 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 registerDockerProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [dockerModule]);
+}
 //# 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,9 +1,7 @@
 /**
- * Importing this file registers the procedures of @procedures/docker 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/docker, and of the modules that it
+ * requires, in the global registry: `import "@procedures/docker/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
  */
-import "@procedures/shell";
 export * from "./module.js";
-export declare function registerDockerProcedures(): 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;AAGH,OAAO,mBAAmB,CAAC;AAK3B,cAAc,aAAa,CAAC;AAE5B,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -1,16 +1,9 @@
 /**
- * Importing this file registers the procedures of @procedures/docker 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/docker, and of the modules that it
+ * requires, in the global registry: `import "@procedures/docker/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
  */
-// Import shell dependency to ensure shell.exec is registered
-import "@procedures/shell";
-import { registerProcedures } from "@procedures/client";
-import { dockerModule } from "./module.js";
+import { registerDockerProcedures } from "./module.js";
 export * from "./module.js";
-export function registerDockerProcedures() {
-    registerProcedures(dockerModule.procedures);
-}
-// Auto-register when this module is loaded
 registerDockerProcedures();
 //# 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,6DAA6D;AAC7D,OAAO,mBAAmB,CAAC;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,wBAAwB;IACtC,kBAAkB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,2CAA2C;AAC3C,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,cAAc,aAAa,CAAC;AAE5B,wBAAwB,EAAE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/docker",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Docker and Docker Compose as typed procedures: ps, run, exec, logs (streaming), build, pull, stop, rm, compose up and down, run with argv and no shell injection.",
   "keywords": [
     "docker",
@@ -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,8 +61,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@procedures/client": "0.1.0",
-    "@procedures/shell": "0.1.0",
+    "@procedures/client": "0.2.1",
+    "@procedures/shell": "0.2.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/index.ts

@@ -72,4 +72,4 @@ export {
 } from "./procedures/docker/index.js";
 
 // Registration
-export { registerDockerProcedures } from "./register.js";
+export { registerDockerProcedures } from "./module.js";

package/src/module.ts

@@ -8,7 +8,7 @@
  */
 
 
-import { createProcedure, zodAdapter, defineModule, type ProcedureModule } from "@procedures/client";
+import { createProcedure, zodAdapter, defineModule, type ProcedureModule, PROCEDURE_REGISTRY, registerModules, type ProcedureRegistry } from "@procedures/client";
 import shellModule from "@procedures/shell/module";
 import {
   dockerRun,
@@ -61,6 +61,9 @@ const dockerRunProcedure = createProcedure()
   .meta({
     description: "Run a Docker container",
     calls: ["shell.run"],
+    // The container runs the image and command of the caller. The volumes give it host files, and
+    // docker pulls a missing image.
+    effects: { reads: ["docker", "fs", "network"], writes: ["docker", "fs", "process"] },
     args: ["image"],
     shorts: { name: "n", detach: "d" },
     output: "json",
@@ -77,6 +80,9 @@ const dockerBuildProcedure = createProcedure()
   .meta({
     description: "Build a Docker image",
     calls: ["shell.run"],
+    // The RUN steps of the Dockerfile are code of the project. Docker reads the context and pulls
+    // the base images. The tag goes to the new image, and the earlier image stays.
+    effects: { reads: ["docker", "fs", "network"], writes: ["docker", "process"], destructive: false },
     args: ["context"],
     shorts: { tag: "t", dockerfile: "f" },
     output: "json",
@@ -93,6 +99,7 @@ const dockerPullProcedure = createProcedure()
   .meta({
     description: "Pull a Docker image",
     calls: ["shell.run"],
+    effects: { reads: ["docker", "network"], writes: ["docker"], destructive: false, idempotent: true },
     args: ["image"],
     output: "json",
   })
@@ -108,6 +115,8 @@ const dockerExecProcedure = createProcedure()
   .meta({
     description: "Execute command in a running container",
     calls: ["shell.run"],
+    // The container runs the command of the caller
+    effects: { reads: ["docker"], writes: ["docker", "process"] },
     args: ["container", "command"],
     shorts: { interactive: "i", tty: "t", workdir: "w" },
     output: "json",
@@ -124,6 +133,8 @@ const dockerStopProcedure = createProcedure()
   .meta({
     description: "Stop running container(s)",
     calls: ["shell.run"],
+    // The stop of a stopped container changes nothing
+    effects: { reads: ["docker"], writes: ["docker"], idempotent: true },
     args: ["containers"],
     shorts: { time: "t" },
     output: "json",
@@ -140,6 +151,7 @@ const dockerRmProcedure = createProcedure()
   .meta({
     description: "Remove container(s)",
     calls: ["shell.run"],
+    effects: { reads: ["docker"], writes: ["docker"] },
     args: ["containers"],
     shorts: { force: "f", volumes: "v" },
     output: "json",
@@ -156,6 +168,7 @@ const dockerPsProcedure = createProcedure()
   .meta({
     description: "List containers",
     calls: ["shell.run"],
+    effects: { reads: ["docker"], writes: [] },
     shorts: { all: "a", filter: "f", format: "F" },
     output: "json",
   })
@@ -172,6 +185,7 @@ const dockerLogsProcedure = createProcedure()
   .meta({
     description: "Get container logs",
     calls: ["shell.run", "shell.stream"],
+    effects: { reads: ["docker"], writes: [] },
     args: ["container"],
     shorts: { follow: "f", tail: "n", timestamps: "t" },
     output: "json",
@@ -190,6 +204,9 @@ const dockerComposeUpProcedure = createProcedure()
   .meta({
     description: "Start services with docker compose",
     calls: ["shell.run"],
+    // The compose file of the caller sets the images, the commands and the host folders of the
+    // services. An up can replace the containers of changed services.
+    effects: { reads: ["docker", "fs", "network"], writes: ["docker", "fs", "process"] },
     shorts: { file: "f", detach: "d", build: "b" },
     output: "json",
   })
@@ -205,6 +222,9 @@ const dockerComposeDownProcedure = createProcedure()
   .meta({
     description: "Stop services with docker compose",
     calls: ["shell.run"],
+    // It removes the containers of the project, and with volumes: true its volumes. A second down
+    // changes nothing.
+    effects: { reads: ["docker", "fs"], writes: ["docker"], idempotent: true },
     shorts: { file: "f", volumes: "v" },
     output: "json",
   })
@@ -235,3 +255,12 @@ export const dockerModule: ProcedureModule = defineModule("@procedures/docker",
   ], [shellModule]);
 
 export default dockerModule;
+
+/**
+ * This function registers the procedures of @procedures/docker, 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 registerDockerProcedures(registry: ProcedureRegistry = PROCEDURE_REGISTRY): void {
+  registerModules(registry, [dockerModule]);
+}

package/src/register.ts

@@ -1,20 +1,11 @@
 /**
- * Importing this file registers the procedures of @procedures/docker 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/docker, and of the modules that it
+ * requires, in the global registry: `import "@procedures/docker/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
  */
 
-// Import shell dependency to ensure shell.exec is registered
-import "@procedures/shell";
-
-import { registerProcedures } from "@procedures/client";
-import { dockerModule } from "./module.js";
+import { registerDockerProcedures } from "./module.js";
 
 export * from "./module.js";
 
-export function registerDockerProcedures(): void {
-  registerProcedures(dockerModule.procedures);
-}
-
-// Auto-register when this module is loaded
 registerDockerProcedures();