amalgm 0.1.199 → 0.1.201

package/package.json

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

package/runtime/scripts/amalgm-mcp/tests/workspace-checkpoint.test.js

@@ -40,6 +40,19 @@ test.after(() => {
   fs.rmSync(tempRoot, { recursive: true, force: true });
 });
 
+test('checkpoint publication waits until the reducer finishes writing both repo layers', async () => {
+  const { withMaterialization } = require('../workspace/reducer');
+  const repoKey = 'https://example.test/repo.git';
+
+  assert.equal(_test.checkpointMayPublish(repoKey), true);
+  await withMaterialization(repoKey, async () => {
+    assert.equal(_test.checkpointMayPublish(repoKey), false);
+    await Promise.resolve();
+    assert.equal(_test.checkpointMayPublish(repoKey), false);
+  });
+  assert.equal(_test.checkpointMayPublish(repoKey), true);
+});
+
 async function run(cwd, ...args) {
   await execFileAsync(
     'git',

package/runtime/scripts/amalgm-mcp/tests/workspace-wall.test.js

@@ -353,6 +353,7 @@ test('peer records and earlier local history survive later publishes', async ()
     wall: 'code-project@3',
     project: repoKey,
     machine: 'machine-b',
+    mutationId: 'mut_project_peer',
     publishedAt: '2026-07-19T00:00:00.000Z',
     cards: [{ card: 'repo-card@2', machine: 'machine-b', replica: 'rpl_peer', path: '/work/app', head: { branch: 'preview' } }],
   });
@@ -407,6 +408,7 @@ test('wall compaction deletes only records superseded for every machine', () =>
     wall: 'code-project@3',
     project: repoKey,
     machine,
+    mutationId: `mut_project_${machine}_${value}`,
     cards: [{ value }],
   });
   const oldA = line('machine-a', 'old-a');
@@ -422,12 +424,36 @@ test('wall compaction deletes only records superseded for every machine', () =>
   assert.equal(compacted.includes(oldB), false);
 });
 
+test('an unordered legacy record cannot pin wall compaction', () => {
+  const unordered = JSON.stringify({
+    wall: 'code-project@3',
+    project: repoKey,
+    machine: '16.612Z',
+    cards: [{ value: 'corrupted-legacy-record' }],
+  });
+  const ordered = (machine) => JSON.stringify({
+    wall: 'code-project@3',
+    project: repoKey,
+    machine,
+    mutationId: `mut_project_${machine}`,
+    cards: [{ value: machine }],
+  });
+  const latestA = ordered('machine-a');
+  const latestB = ordered('machine-b');
+
+  assert.equal(
+    compactWallText(`${unordered}\n${latestA}\n${latestB}\n`, repoKey),
+    `${latestA}\n${latestB}\n`,
+  );
+});
+
 test('a concurrent deletion-only compaction and append commute in Yjs', () => {
   const Y = require('yjs');
   const line = (machine, value) => JSON.stringify({
     wall: 'code-project@3',
     project: repoKey,
     machine,
+    mutationId: `mut_project_${machine}_${value}`,
     cards: [{ value }],
   });
   const oldA = line('machine-a', 'old-a');

package/runtime/scripts/amalgm-mcp/workspace/checkpoint.js

@@ -188,6 +188,10 @@ function checkpointBaseReady(card, reduced) {
   );
 }
 
+function checkpointMayPublish(repoKey) {
+  return !require('./reducer').isMaterializing(repoKey);
+}
+
 async function publishPass(replicaId = null) {
   const machine = machineId();
   const run = { published: 0, skips: 0, waiting: 0, failures: 0 };
@@ -196,6 +200,10 @@ async function publishPass(replicaId = null) {
     if (card.health !== 'healthy' || card.kind !== 'primary' || card.operation !== 'none') continue;
     const repoKey = repoKeyOfCard(card);
     if (!repoKey || !card.head?.oid) continue;
+    if (!checkpointMayPublish(repoKey)) {
+      run.waiting += 1;
+      continue;
+    }
     try {
       const reduced = require('./reducer').readRepoState(repoKey);
       if (!checkpointBaseReady(card, reduced)) {
@@ -376,6 +384,7 @@ module.exports = {
   _test: {
     checkpointBaseReady,
     checkpointForSharedState,
+    checkpointMayPublish,
   },
   CHECKPOINT_CONTRACT,
   MAX_INLINE_DIFF_BYTES,

package/runtime/scripts/amalgm-mcp/workspace/reducer.js

@@ -50,6 +50,20 @@ const service = {
   repos: new Map(),
   lastPass: null,
 };
+const materializing = new Set();
+
+function isMaterializing(repoKey) {
+  return materializing.has(repoKey);
+}
+
+async function withMaterialization(repoKey, work) {
+  materializing.add(repoKey);
+  try {
+    return await work();
+  } finally {
+    materializing.delete(repoKey);
+  }
+}
 
 function stateFile(repoKey) {
   const digest = crypto.createHash('sha256').update(repoKey).digest('hex').slice(0, 24);
@@ -587,7 +601,10 @@ async function runReducer() {
     if (!plan.card) continue;
     try {
       if (!local?.head?.oid) {
-        const hydrated = await hydrateRepo(wall.projectForRepo(repoKey), plan);
+        const hydrated = await withMaterialization(
+          repoKey,
+          () => hydrateRepo(wall.projectForRepo(repoKey), plan),
+        );
         service.repos.set(repoKey, {
           repoKey,
           path: wall.projectForRepo(repoKey)?.path || local?.path || null,
@@ -627,7 +644,10 @@ async function runReducer() {
         service.counters.waiting += 1;
         continue;
       }
-      const outcome = await materializeRepo(refreshed, currentPlan);
+      const outcome = await withMaterialization(
+        repoKey,
+        () => materializeRepo(refreshed, currentPlan),
+      );
       service.repos.set(repoKey, { repoKey, path: local.path, ...outcome, at: new Date().toISOString() });
       if (outcome.state === 'waiting') service.counters.waiting += 1;
       if (outcome.moved) {
@@ -718,6 +738,7 @@ module.exports = {
   advanceIndex,
   captureIsOnRail,
   hydrateRepo,
+  isMaterializing,
   localCardMayMaterialize,
   materializeRepo,
   readRepoState,
@@ -727,4 +748,5 @@ module.exports = {
   reducerStats,
   startWorkspaceReducer,
   stopWorkspaceReducer,
+  withMaterialization,
 };

package/runtime/scripts/amalgm-mcp/workspace/wall.js

@@ -135,6 +135,7 @@ function parseWallLine(line) {
       entry?.wall !== WALL_CONTRACT
       || !entry.project
       || !entry.machine
+      || !entry.mutationId
       || !Array.isArray(entry.cards)
     ) return null;
     return entry;