amalgm 0.1.248 → 0.1.249

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amalgm",
-  "version": "0.1.248",
+  "version": "0.1.249",
   "description": "Amalgm local computer runtime: login, MCP, chat, events, previews, and tunnels.",
   "license": "UNLICENSED",
   "private": false,

package/runtime/scripts/amalgm-mcp/registration/service.js

@@ -267,7 +267,11 @@ function createRegistrationService({
     const home = await bootstrapUserHome();
     const expected = new Map();
     for (const entry of [...home.roots, ...home.exactManaged]) {
-      expected.set(entry.record.uuid, entry.record);
+      // `bootstrapUserHome` returns the public record used by the local
+      // registration boundary. The cloud proof must instead compare its
+      // complete logical form, including the null payload head carried by
+      // containers, with the registry's sync representation.
+      expected.set(entry.record.uuid, boundary.current.registry.syncRecord(entry.record.uuid));
     }
     const records = boundary.current.registry.syncRecords();
     if (records.length !== expected.size) {

package/runtime/scripts/amalgm-mcp/server/routes/entities.js

@@ -147,19 +147,18 @@ async function handleEntityRoutes(ctx) {
     const service = registrationService();
     try {
       const existing = service.entityCloud.replica();
-      let bootstrapRecords = null;
+      let requiresBootstrapProof = existing?.state === 'reconciling-bootstrap';
       try {
         const snapshot = JSON.parse(Buffer.from(String(body?.snapshotBase64 || ''), 'base64').toString('utf8'));
-        if (
-          existing?.state === 'reconciling-bootstrap'
-          || (Number(body?.headVersion) === 0 && Array.isArray(snapshot?.records) && snapshot.records.length === 0)
-        ) {
-          bootstrapRecords = await service.exactUserHomeCloudRecords();
-        }
+        requiresBootstrapProof ||= Number(body?.headVersion) === 0
+          && Array.isArray(snapshot?.records) && snapshot.records.length === 0;
       } catch {
-        // install performs the authoritative checksum and shape validation;
-        // this lookahead only decides whether exact bootstrap proof is needed.
+        // Install validates malformed snapshots. This lookahead merely decides
+        // whether the legacy empty-resource repair needs its exact local proof.
       }
+      const bootstrapRecords = requiresBootstrapProof
+        ? await service.exactUserHomeCloudRecords()
+        : null;
       ctx.sendJson(200, service.entityCloud.install({
         registry: service.registration.registry,
         resourceId: body?.resourceId,

package/runtime/scripts/amalgm-mcp/tests/registration.service.test.js

@@ -217,6 +217,14 @@ test('user-home bootstrap creates only declared roots and registers them through
     }
   }
 
+  const cloudRecords = await service.exactUserHomeCloudRecords();
+  assert.equal(cloudRecords.length, 9,
+    'the declared home is the entire graph eligible to repair a legacy empty cloud registry');
+  assert.deepEqual(
+    new Set(cloudRecords.map((record) => record.uuid)),
+    new Set([...bootstrapped.roots, ...bootstrapped.exactManaged].map((entry) => entry.record.uuid)),
+  );
+
   const repeat = await service.bootstrapUserHome();
   assert.deepEqual(
     repeat.roots.map((entry) => entry.record.uuid),