A module is a package, not a bare manifest

Each module becomes modules/<name>/ holding module.json, with room for
the rest of what a module is — its tools, health checks, provisioning,
lifecycle — which the conversion from hal still has to bring across.
The flat <name>.json was only the resource-declaration half.

Claude-Session: https://claude.ai/code/session_01LrgweAeERJYBg88c5cKDzF

modules/postgres/module.json

@@ -0,0 +1,101 @@
+{
+  "module": "postgres",
+  "version": "1",
+  "provides": [
+    {
+      "name": "postgres-database",
+      "scope": "mesh"
+    }
+  ],
+  "capabilities": [
+    "container-runtime"
+  ],
+  "listens": [
+    {
+      "port": 5432,
+      "protocol": "tcp",
+      "from": "mesh",
+      "why": "modules on any machine that were granted a database"
+    }
+  ],
+  "serves": {
+    "postgres-database": {}
+  },
+  "receives": {
+    "postgres-database": "/var/lib/postgres/grants/mesh.json"
+  },
+  "grants": {
+    "postgres-database": "/var/lib/postgres/grants"
+  },
+  "own-secrets": {
+    "superuser": "/var/lib/postgres/superuser.secret"
+  },
+  "resources": [
+    {
+      "id": "state",
+      "type": "directory",
+      "path": "/var/lib/postgres",
+      "mode": "0700"
+    },
+    {
+      "id": "grants",
+      "type": "directory",
+      "path": "/var/lib/postgres/grants",
+      "mode": "0700"
+    },
+    {
+      "id": "superuser-env",
+      "type": "file",
+      "path": "/var/lib/postgres/superuser.env",
+      "mode": "0600",
+      "content": "POSTGRES_PASSWORD=${secret:superuser}\n"
+    },
+    {
+      "id": "data",
+      "type": "directory",
+      "path": "/services/postgres/db-data",
+      "mode": "0700"
+    },
+    {
+      "id": "net",
+      "type": "network",
+      "name": "postgres"
+    },
+    {
+      "id": "server",
+      "type": "container",
+      "name": "postgres",
+      "image": "postgres@sha256:7456ef82e5f5bc43d997f4781bbd7c0d6389bff397564649a356e206ba473aee",
+      "network": "postgres",
+      "env": {
+        "POSTGRES_USER": "postgres",
+        "POSTGRES_DB": "postgres"
+      },
+      "env-file": [
+        "/var/lib/postgres/superuser.env"
+      ],
+      "ports": [
+        "5432"
+      ],
+      "volumes": [
+        "/services/postgres/db-data:/var/lib/postgresql/data"
+      ]
+    },
+    {
+      "id": "provisioner",
+      "type": "container",
+      "name": "mesh-provision-postgres",
+      "image": "mesh-provision-postgres@sha256:0000000000000000000000000000000000000000000000000000000000000000",
+      "network": "postgres",
+      "env": {
+        "GRANTS": "/var/lib/postgres/grants",
+        "MESH_PROVISION_POSTGRES": "postgres://postgres@postgres:5432/postgres?sslmode=disable",
+        "MESH_PROVISION_PASSWORD_FILE": "/run/secrets/superuser"
+      },
+      "volumes": [
+        "/var/lib/postgres/grants:/var/lib/postgres/grants:ro",
+        "/var/lib/postgres/superuser.secret:/run/secrets/superuser:ro"
+      ]
+    }
+  ]
+}