deadbyte-mcp 0.15.31 → 0.15.33

package/scripts/windows-gate-evidence-r55.mjs

@@ -0,0 +1,79 @@
+import { createHash } from 'node:crypto';
+import { mkdir, open, readFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { doctor } from '../src/doctor-r45.mjs';
+
+const root=path.resolve(path.dirname(fileURLToPath(import.meta.url)),'..');
+const stateRoot=path.resolve(process.env.DEADBYTE_STATE_ROOT||path.join(os.homedir(),'.deadbyte-mcp'));
+const sha256=bytes=>createHash('sha256').update(bytes).digest('hex');
+const insist=(ok,message)=>{if(!ok)throw new Error(message);};
+const pkg=JSON.parse(await readFile(path.join(root,'package.json'),'utf8'));
+const release=JSON.parse(await readFile(path.join(root,'RELEASE.json'),'utf8'));
+const provenance=JSON.parse(await readFile(path.join(root,'PROVENANCE.json'),'utf8'));
+const matrix=JSON.parse(await readFile(path.join(root,'TEST-MATRIX.json'),'utf8'));
+const active=JSON.parse(await readFile(path.join(stateRoot,'active-release.json'),'utf8'));
+const manifestSha256=sha256(await readFile(path.join(root,'MANIFEST.SHA256')));
+
+insist(pkg.version==='0.15.32'&&release.version===pkg.version&&release.train==='R55','R55 candidate identity mismatch');
+insist(release.parent.version==='0.15.31','R55 source parent mismatch');
+insist(release.parent.manifest_sha256==='16854fe5b3eb0fa1c6dd2b96e3c5d6f792c5adbc91dd2a71e7fc2771472bbdd4','R55 source parent manifest mismatch');
+insist(release.parent.tarball_sha256==='ff6eba3036cb00ac639ac8907ad6063e6ea8169cf32aca8721f75b1e403e501a','R55 source parent tarball mismatch');
+insist(
+  active.release_id===release.runtime_predecessor.release_id&&
+  active.manifest_sha256===release.runtime_predecessor.manifest_sha256&&
+  active.generation_manifest_sha256===release.runtime_predecessor.generation_manifest_sha256,
+  'active runtime is not exact sealed 0.15.29 predecessor'
+);
+insist(release.hotfix?.foreground_guardian_owner_parent_binding===true,'R55 guardian owner/parent binding missing');
+insist(release.hotfix?.foreground_guardian_session_nonce_contract===true,'R55 guardian nonce contract missing');
+insist(release.hotfix?.unrelated_stale_runtime_fail_closed===true,'R55 stale-runtime negative control missing');
+insist(release.hotfix?.full_regression==='PASS','R55 full regression metadata is not PASS');
+insist(matrix.observed_pre_release_evidence?.full_regression?.status==='PASS','R55 full regression evidence is not PASS');
+insist(provenance.operator_override?.stable_final_claim===false,'R55 must not claim stable/final');
+insist(matrix.operator_override?.four_hour_soak==='NOT_COMPLETED','R55 matrix must preserve soak bypass');
+
+const health=await doctor();
+insist(health.status==='ok'&&health.package_version===pkg.version&&health.manifest?.verified===true,'R55 doctor evidence invalid');
+
+const evidence={
+ schema:'deadbyte.r55-windows-gate.v1',
+ status:'passed',
+ exit_code:0,
+ version:pkg.version,
+ train:'R55',
+ completed_at_utc:new Date().toISOString(),
+ manifest_sha256:manifestSha256,
+ parent:release.parent,
+ runtime_predecessor:release.runtime_predecessor,
+ hotfix:release.hotfix,
+ operator_override:provenance.operator_override,
+ active_predecessor:{
+  release_id:active.release_id,
+  version:active.version,
+  manifest_sha256:active.manifest_sha256,
+  generation_manifest_sha256:active.generation_manifest_sha256
+ },
+ doctor:{verified_entries:health.manifest.verified_entries},
+ gates:{
+  r55_focused:true,
+  package_boundary:true,
+  full_regression:true,
+  manifest_final_verify:true,
+  four_hour_soak_completed:false
+ }
+};
+const bytes=Buffer.from(JSON.stringify(evidence,null,2)+'\n');
+const dir=path.join(stateRoot,'evidence','release');
+await mkdir(dir,{recursive:true});
+const target=path.join(dir,`r55-windows-gate-${manifestSha256.slice(0,16)}.json`);
+try{
+ const handle=await open(target,'wx',0o600);
+ try{await handle.writeFile(bytes);await handle.sync();}finally{await handle.close();}
+}catch(error){
+ if(error?.code!=='EEXIST')throw error;
+ const prior=JSON.parse(await readFile(target,'utf8'));
+ insist(prior.schema===evidence.schema&&prior.status==='passed'&&prior.version===evidence.version&&prior.manifest_sha256===manifestSha256,'conflicting R55 gate evidence identity');
+}
+console.log(JSON.stringify({status:'passed',path:target,sha256:sha256(bytes),manifest_sha256:manifestSha256}));

package/scripts/windows-gate-evidence-r56.mjs

@@ -0,0 +1,81 @@
+import { createHash } from 'node:crypto';
+import { mkdir, open, readFile } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { doctor } from '../src/doctor-r45.mjs';
+
+const root=path.resolve(path.dirname(fileURLToPath(import.meta.url)),'..');
+const stateRoot=path.resolve(process.env.DEADBYTE_STATE_ROOT||path.join(os.homedir(),'.deadbyte-mcp'));
+const sha256=bytes=>createHash('sha256').update(bytes).digest('hex');
+const insist=(ok,message)=>{if(!ok)throw new Error(message);};
+const pkg=JSON.parse(await readFile(path.join(root,'package.json'),'utf8'));
+const release=JSON.parse(await readFile(path.join(root,'RELEASE.json'),'utf8'));
+const provenance=JSON.parse(await readFile(path.join(root,'PROVENANCE.json'),'utf8'));
+const matrix=JSON.parse(await readFile(path.join(root,'TEST-MATRIX.json'),'utf8'));
+const active=JSON.parse(await readFile(path.join(stateRoot,'active-release.json'),'utf8'));
+const manifestSha256=sha256(await readFile(path.join(root,'MANIFEST.SHA256')));
+
+insist(pkg.version==='0.15.33'&&release.version===pkg.version&&release.train==='R56','R56 candidate identity mismatch');
+insist(release.parent.version==='0.15.32','R56 parent mismatch');
+insist(release.parent.manifest_sha256==='e7223f467777f5dfeb20fd2cc7a6eca22619a44ed95e5bc0b32d9c7aabba361b','R56 parent manifest mismatch');
+insist(release.parent.generation_manifest_sha256==='740443fd207c5e6ffd5952079214bf6e81e9281a6ec880de9bbe3b8ce1deb00e','R56 parent generation mismatch');
+insist(release.parent.tarball_sha256==='c9e1f5875dd2177cee0089305b40321c128c54ce7f5522e34e507d4ecfb22638','R56 parent tarball mismatch');
+insist(
+  active.release_id===release.runtime_predecessor.release_id&&
+  active.manifest_sha256===release.runtime_predecessor.manifest_sha256&&
+  active.generation_manifest_sha256===release.runtime_predecessor.generation_manifest_sha256,
+  'active runtime is not exact sealed 0.15.32 predecessor'
+);
+insist(release.hotfix?.signed_handoff_launcher_snapshot_required===true,'R56 signed rollback handoff launcher requirement missing');
+insist(release.hotfix?.stored_predecessor_verified_without_live_launcher===true,'R56 stored predecessor verification split missing');
+insist(release.hotfix?.predecessor_launcher_restored_before_pointer_commit===true,'R56 predecessor launcher ordering missing');
+insist(release.hotfix?.successor_launcher_restored_before_recovery_pointer===true,'R56 successor recovery ordering missing');
+insist(release.hotfix?.full_regression==='PASS','R56 full regression metadata is not PASS');
+insist(matrix.observed_pre_release_evidence?.full_regression?.status==='PASS','R56 full regression evidence is not PASS');
+insist(provenance.operator_override?.stable_final_claim===false,'R56 must not claim stable/final');
+insist(matrix.operator_override?.four_hour_soak==='NOT_COMPLETED','R56 matrix must preserve soak bypass');
+
+const health=await doctor();
+insist(health.status==='ok'&&health.package_version===pkg.version&&health.manifest?.verified===true,'R56 doctor evidence invalid');
+
+const evidence={
+ schema:'deadbyte.r56-windows-gate.v1',
+ status:'passed',
+ exit_code:0,
+ version:pkg.version,
+ train:'R56',
+ completed_at_utc:new Date().toISOString(),
+ manifest_sha256:manifestSha256,
+ parent:release.parent,
+ runtime_predecessor:release.runtime_predecessor,
+ hotfix:release.hotfix,
+ operator_override:provenance.operator_override,
+ active_predecessor:{
+  release_id:active.release_id,
+  version:active.version,
+  manifest_sha256:active.manifest_sha256,
+  generation_manifest_sha256:active.generation_manifest_sha256
+ },
+ doctor:{verified_entries:health.manifest.verified_entries},
+ gates:{
+  r56_focused:true,
+  package_boundary:true,
+  full_regression:true,
+  manifest_final_verify:true,
+  four_hour_soak_completed:false
+ }
+};
+const bytes=Buffer.from(JSON.stringify(evidence,null,2)+'\n');
+const dir=path.join(stateRoot,'evidence','release');
+await mkdir(dir,{recursive:true});
+const target=path.join(dir,`r56-windows-gate-${manifestSha256.slice(0,16)}.json`);
+try{
+ const handle=await open(target,'wx',0o600);
+ try{await handle.writeFile(bytes);await handle.sync();}finally{await handle.close();}
+}catch(error){
+ if(error?.code!=='EEXIST')throw error;
+ const prior=JSON.parse(await readFile(target,'utf8'));
+ insist(prior.schema===evidence.schema&&prior.status==='passed'&&prior.version===evidence.version&&prior.manifest_sha256===manifestSha256,'conflicting R56 gate evidence identity');
+}
+console.log(JSON.stringify({status:'passed',path:target,sha256:sha256(bytes),manifest_sha256:manifestSha256}));

package/src/runtime-update.mjs

@@ -647,6 +647,18 @@ async function readLedger(ctx,name){
 function sameGeneration(a,b){
   return a.pid===b.pid&&a.instance_nonce===b.instance_nonce&&a.creation_time_utc===b.creation_time_utc&&a.image_sha256===b.image_sha256;
 }
+function activationGuardianOwnedByLineage(item,selfLineage){
+  const name=String(item?.Name??'').toLowerCase();
+  if(name!=='node.exe') return false;
+  const commandLine=String(item?.CommandLine??'');
+  if(!commandLine.toLowerCase().includes('remote-session-guardian.mjs')) return false;
+  const ownerMatch=/(?:^|\s)--owner-pid(?:=|\s+)(\d+)(?=\s|$)/i.exec(commandLine);
+  const nonceMatch=/(?:^|\s)--session-nonce(?:=|\s+)([0-9a-f]{64})(?=\s|$)/i.exec(commandLine);
+  if(!ownerMatch||!nonceMatch) return false;
+  const ownerPid=Number(ownerMatch[1]);
+  const parentPid=Number(item?.ParentProcessId);
+  return Number.isInteger(ownerPid)&&ownerPid>0&&parentPid===ownerPid&&selfLineage.has(ownerPid);
+}
 export function selectOfflineRecoveryBlockers(processes,currentPid=process.pid){
   const list=(Array.isArray(processes)?processes:[processes]).filter(Boolean);
   const byPid=new Map();
@@ -668,6 +680,7 @@ export function selectOfflineRecoveryBlockers(processes,currentPid=process.pid){
   return list.filter(item=>{
     const pid=Number(item?.ProcessId);
     if(selfLineage.has(pid)) return false;
+    if(activationGuardianOwnedByLineage(item,selfLineage)) return false;
     const name=String(item?.Name??'').toLowerCase();
     if(!runtimeNames.has(name)) return false;
     const commandLine=String(item?.CommandLine??'').toLowerCase();
@@ -848,16 +861,21 @@ async function verifyPackageRoot(root,expectedVersion,expectedManifest,label){
   if(pkg?.name!=='deadbyte-mcp'||pkg?.version!==expectedVersion) throw new Error(`${label} package identity mismatch`);
   return {root:absolute,manifest_sha256:digest,entries:entries.size};
 }
-async function verifyActiveInstallation(stateRoot,pointer){
+async function verifyStoredInstallation(stateRoot,pointer){
   const state=path.resolve(stateRoot); const expectedRelease=path.join(state,'releases',releaseId(pointer.version,pointer.manifest_sha256));
   if(path.resolve(pointer.release_root)!==path.resolve(expectedRelease)) throw new Error('active pointer release root is not content-addressed store path');
   const release=await verifyPackageRoot(pointer.release_root,pointer.version,pointer.manifest_sha256,'active release');
   const generation=await verifyGenerationBundle(pointer.generation_root,pointer.generation_manifest_sha256);
   const expectedConfig=path.join(path.resolve(pointer.generation_root),'controller-config.psd1');
   if(path.resolve(pointer.config_path)!==path.resolve(expectedConfig)) throw new Error('active pointer config path mismatch');
+  return {release,generation};
+}
+async function verifyActiveInstallation(stateRoot,pointer){
+  const state=path.resolve(stateRoot);
+  const verified=await verifyStoredInstallation(state,pointer);
   const currentLauncher=await sha256File(launcherPath(state));
   if(currentLauncher!==pointer.launcher_sha256) throw new Error('active pointer launcher digest mismatch');
-  return {release,generation};
+  return verified;
 }
 async function loadPointerIfPresent(stateRoot){
   const file=path.join(path.resolve(stateRoot),'active-release.json');
@@ -1071,6 +1089,41 @@ function decodeSnapshot(snapshot,label){
   }
   return {exists:false,bytes:null,sha256:null};
 }
+export function rollbackLauncherPlanFromHandoff(body,priorPointer,activePointer,stateRoot=DEFAULT_STATE_ROOT){
+  if(!body||typeof body!=='object') throw new Error('rollback handoff body required');
+  const handoffPrior=body.prior_pointer?parseActivePointer(JSON.stringify(body.prior_pointer)):null;
+  const handoffActive=body.new_pointer?parseActivePointer(JSON.stringify(body.new_pointer)):null;
+  if(!samePublicPointer(handoffPrior,priorPointer)||!samePublicPointer(handoffActive,activePointer)) throw new Error('rollback handoff pointer binding mismatch');
+  const state=path.resolve(stateRoot);
+  const launchers={
+    ps1:path.resolve(String(body.launchers?.ps1??'')),
+    cmd:path.resolve(String(body.launchers?.cmd??'')),
+    top:path.resolve(String(body.launchers?.top??TOP_LAUNCHER)),
+    launcher_sha256:String(body.launchers?.launcher_sha256??''),
+    ps1Bytes:Buffer.from(String(body.launchers?.ps1_bytes??''),'base64'),
+    cmdBytes:Buffer.from(String(body.launchers?.cmd_bytes??''),'base64'),
+    snapshots:{
+      ps1:decodeSnapshot(body.launchers?.snapshots?.ps1,'rollback.launcher.ps1'),
+      cmd:decodeSnapshot(body.launchers?.snapshots?.cmd,'rollback.launcher.cmd'),
+      top:decodeSnapshot(body.launchers?.snapshots?.top,'rollback.launcher.top')
+    },
+    installed:true
+  };
+  if(launchers.ps1!==path.resolve(launcherPath(state))||
+     launchers.cmd!==path.resolve(path.join(state,'bin','DEADBYTE-MCP.cmd'))||
+     launchers.top!==path.resolve(TOP_LAUNCHER)) throw new Error('rollback launcher paths are not canonical');
+  if(!HEX64.test(launchers.launcher_sha256)||sha256Bytes(launchers.ps1Bytes)!==launchers.launcher_sha256) throw new Error('rollback successor launcher bytes/hash mismatch');
+  if(launchers.launcher_sha256!==activePointer.launcher_sha256) throw new Error('rollback successor launcher hash does not match active pointer');
+  if(!launchers.snapshots.ps1.exists||launchers.snapshots.ps1.sha256!==priorPointer.launcher_sha256) throw new Error('rollback predecessor launcher snapshot does not match signed prior pointer');
+  return launchers;
+}
+async function restoreRollbackLaunchers(plan){
+  await restoreFile(plan.ps1,plan.snapshots.ps1);
+  await restoreFile(plan.cmd,plan.snapshots.cmd);
+  await restoreFile(plan.top,plan.snapshots.top);
+  if(await sha256File(plan.ps1)!==plan.snapshots.ps1.sha256) throw new Error('rollback predecessor launcher restore hash mismatch');
+  return plan;
+}
 const UPDATE_PHASE_RANK=Object.freeze({
   initial:0,candidate_prepared:10,old_runtime_verified:20,shutdown_handoff_armed:25,supervisor_spawned:30,
   authority_revoked:40,old_runtime_stopped:50,workspace_ready:60,launcher_installed:70,pointer_committed:80,
@@ -1574,19 +1627,28 @@ export async function performSlotRollback({activationReceipt,stateRoot=DEFAULT_S
   const activePointer=parseActivePointer(JSON.stringify(activationEnvelope.body.active_pointer));
   const pointerInfo=await loadPointerIfPresent(state);
   if(!pointerInfo.pointer||canonicalJson(publicPointer(pointerInfo.pointer))!==canonicalJson(publicPointer(activePointer))) throw new Error('rollback current pointer does not match signed activation pointer');
-  await verifyActiveInstallation(state,priorPointer);
+
+  const handoffPath=path.join(path.dirname(receiptFile),'handoff.json');
+  const {body:handoffBody}=await readHandoffEnvelope(handoffPath,state);
+  if(handoffBody.update_id!==activationEnvelope.body.update_id) throw new Error('rollback handoff update identity mismatch');
+  const rollbackLaunchers=rollbackLauncherPlanFromHandoff(handoffBody,priorPointer,activePointer,state);
+  await verifyStoredInstallation(state,priorPointer);
+
   const currentCtx=slotContext(state,pointerInfo.pointer),currentRuntime=await captureRuntime(currentCtx);
   const revoked=await revokeAuthority(currentCtx,currentRuntime.status);
   const rollbackId=`r31-rollback-${activationEnvelope.receipt_sha256.slice(0,16)}-${Date.now().toString(36)}-${randomBytes(4).toString('hex')}`;
   const evidenceDir=path.join(state,'evidence','updates',rollbackId),statePath=path.join(evidenceDir,'state.json'),receiptPath=path.join(evidenceDir,'receipt.json');
   await mkdir(evidenceDir,{recursive:true});
   const journal={schema:'deadbyte.r31-slot-rollback-state.v1',rollback_id:rollbackId,activation_receipt:path.resolve(receiptFile),
-    activation_receipt_sha256:activationEnvelope.receipt_sha256,from_pointer:publicPointer(activePointer),to_pointer:publicPointer(priorPointer),created_at_utc:new Date().toISOString()};
+    activation_receipt_sha256:activationEnvelope.receipt_sha256,handoff_path:handoffPath,
+    from_pointer:publicPointer(activePointer),to_pointer:publicPointer(priorPointer),created_at_utc:new Date().toISOString()};
   await writeState(statePath,journal,'verified');
-  let stopped=false,pointerCommitted=false,priorCtx=null,priorRuntime=null;
+  let stopped=false,launchersRestored=false,pointerCommitted=false,priorCtx=null,priorRuntime=null;
   try {
     await stopAndVerify(currentCtx,currentRuntime); stopped=true;
     await writeState(statePath,journal,'successor_stopped');
+    await restoreRollbackLaunchers(rollbackLaunchers); launchersRestored=true;
+    await writeState(statePath,journal,'predecessor_launcher_restored',{launcher_sha256:priorPointer.launcher_sha256});
     await atomicWriteActivePointer(pointerInfo.file,priorPointer); pointerCommitted=true;
     await verifyActiveInstallation(state,priorPointer);
     await writeState(statePath,journal,'prior_pointer_restored',{active_pointer:publicPointer(priorPointer)});
@@ -1597,16 +1659,27 @@ export async function performSlotRollback({activationReceipt,stateRoot=DEFAULT_S
     if(finalStatus.process_armed||finalStatus.coding_armed||finalStatus.autonomous_armed||finalStatus.desktop_armed||finalStatus.host_armed) throw new Error('rollback predecessor authority must remain disarmed');
     const body={schema:ROLLBACK_SCHEMA,rollback_id:rollbackId,activation_receipt_sha256:activationEnvelope.receipt_sha256,
       completed_at_utc:new Date().toISOString(),from_pointer:publicPointer(activePointer),active_pointer:publicPointer(priorPointer),
-      old_runtime:generationTuple(currentRuntime),new_runtime:generationTuple(priorRuntime),stabilization,authority_revoked:revoked.revoked,rollback_performed:true};
+      launcher_restored:true,old_runtime:generationTuple(currentRuntime),new_runtime:generationTuple(priorRuntime),stabilization,
+      authority_revoked:revoked.revoked,rollback_performed:true};
     const receipt=await writeEnvelope(receiptPath,body,key);
     await writeState(statePath,journal,'completed',{receipt_path:receiptPath,receipt_sha256:receipt.receipt_sha256});
     return {ok:true,rollback_id:rollbackId,state_path:statePath,receipt_path:receiptPath,receipt_sha256:receipt.receipt_sha256,pointer:priorPointer,new_runtime:priorRuntime};
   } catch(error){
-    const recovery={attempted:false,prior_runtime_stopped:false,successor_pointer_restored:false,successor_runtime_restarted:false,errors:[]};
+    const recovery={attempted:false,prior_runtime_stopped:false,successor_launcher_restored:false,successor_pointer_restored:false,successor_runtime_restarted:false,errors:[]};
     if(stopped){
       recovery.attempted=true;
       if(pointerCommitted&&priorCtx){ try { controllerCaptured(priorCtx,'stop',30000); recovery.prior_runtime_stopped=true; } catch(recoveryError){ recovery.errors.push(`stop-prior:${recoveryError.message}`); } }
-      if(pointerCommitted){ try { await atomicWriteActivePointer(pointerInfo.file,activePointer); await verifyActiveInstallation(state,activePointer); recovery.successor_pointer_restored=true; } catch(recoveryError){ recovery.errors.push(`restore-pointer:${recoveryError.message}`); } }
+      if(launchersRestored){
+        try { await installLaunchers(rollbackLaunchers); recovery.successor_launcher_restored=true; }
+        catch(recoveryError){ recovery.errors.push(`restore-successor-launcher:${recoveryError.message}`); }
+      }
+      if(pointerCommitted){
+        try { await atomicWriteActivePointer(pointerInfo.file,activePointer); await verifyActiveInstallation(state,activePointer); recovery.successor_pointer_restored=true; }
+        catch(recoveryError){ recovery.errors.push(`restore-pointer:${recoveryError.message}`); }
+      }else if(recovery.successor_launcher_restored){
+        try { await verifyActiveInstallation(state,activePointer); recovery.successor_pointer_restored=true; }
+        catch(recoveryError){ recovery.errors.push(`verify-successor-pointer:${recoveryError.message}`); }
+      }
       try { await startAndVerify(currentCtx,currentRuntime); recovery.successor_runtime_restarted=true; } catch(recoveryError){ recovery.errors.push(`restart-successor:${recoveryError.message}`); }
     }
     await writeState(statePath,journal,'failed',{error:{name:error?.name??'Error',message:String(error?.message??error)},recovery}).catch(()=>{});

package/src/version.mjs

@@ -1,4 +1,4 @@
-export const DEADBYTE_VERSION = '0.15.31';
+export const DEADBYTE_VERSION = '0.15.33';
 export const MCP_PROTOCOL_VERSION = '2026-07-28';
 export const RECEIPT_SCHEMA_V1 = 'deadbyte.receipt.v1';
 export const RECEIPT_SCHEMA_V2 = 'deadbyte.receipt.v2';

package/test/r49-windows-gate.test.mjs

@@ -4,9 +4,13 @@ import test from 'node:test';
 
 const read=path=>readFile(new URL(`../${path}`,import.meta.url),'utf8');
 
-test('R54 canonical Windows gate is successor-bound and preserves R53/R52/R51/R50/R49 historical gates',async()=>{
-  const [pkgText,gate,evidence,historicalR53,historicalEvidenceR53,historicalR52,historicalEvidenceR52,historicalR51,historicalEvidenceR51,historicalR50,historicalR49,deferred]=await Promise.all([
+test('R56 canonical Windows gate is successor-bound and preserves R55/R54/R53/R52/R51/R50/R49 historical gates',async()=>{
+  const [pkgText,gate,evidence,historicalR55,historicalEvidenceR55,historicalR54,historicalEvidenceR54,historicalR53,historicalEvidenceR53,historicalR52,historicalEvidenceR52,historicalR51,historicalEvidenceR51,historicalR50,historicalR49,deferred]=await Promise.all([
     read('package.json'),
+    read('scripts/gate-windows-r56.ps1'),
+    read('scripts/windows-gate-evidence-r56.mjs'),
+    read('scripts/gate-windows-r55.ps1'),
+    read('scripts/windows-gate-evidence-r55.mjs'),
     read('scripts/gate-windows-r54.ps1'),
     read('scripts/windows-gate-evidence-r54.mjs'),
     read('scripts/gate-windows-r53.ps1'),
@@ -20,18 +24,22 @@ test('R54 canonical Windows gate is successor-bound and preserves R53/R52/R51/R5
     read('scripts/deferred-slot-operation-r46.mjs')
   ]);
   const pkg=JSON.parse(pkgText);
-  assert.match(pkg.scripts['gate:windows'],/gate-windows-r54\.ps1$/);
-  assert.match(gate,/DEADBYTE 0\.15\.31 \/ R54 WINDOWS GATE: PASS/);
-  assert.match(gate,/r54-package-boundary/);
-  assert.match(gate,/r54-focused-contracts/);
-  assert.match(gate,/full-regression/);
+  assert.match(pkg.scripts['gate:windows'],/gate-windows-r56\.ps1$/);
+  assert.match(gate,/DEADBYTE 0\.15\.33 \/ R56 WINDOWS GATE: PASS/);
+  assert.match(gate,/r56-package-boundary/);
+  assert.match(gate,/r56-focused-contracts/);
+  assert.match(gate,/full-regression-evidence/);
   assert.match(gate,/manifest-verify/);
   assert.match(gate,/doctor/);
-  assert.match(evidence,/deadbyte\.r54-windows-gate\.v1/);
-  assert.match(evidence,/pkg\.version==='0\.15\.31'/);
-  assert.match(evidence,/release\.train==='R54'/);
-  assert.match(evidence,/release\.parent\.version==='0\.15\.30'/);
+  assert.match(evidence,/deadbyte\.r56-windows-gate\.v1/);
+  assert.match(evidence,/pkg\.version==='0\.15\.33'/);
+  assert.match(evidence,/release\.train==='R56'/);
+  assert.match(evidence,/release\.parent\.version==='0\.15\.32'/);
   assert.match(evidence,/four_hour_soak_completed:false/);
+  assert.match(historicalR55,/DEADBYTE 0\.15\.32 \/ R55 WINDOWS GATE: PASS/);
+  assert.match(historicalEvidenceR55,/deadbyte\.r55-windows-gate\.v1/);
+  assert.match(historicalR54,/DEADBYTE 0\.15\.31 \/ R54 WINDOWS GATE: PASS/);
+  assert.match(historicalEvidenceR54,/deadbyte\.r54-windows-gate\.v1/);
   assert.match(historicalR53,/DEADBYTE 0\.15\.30 \/ R53 WINDOWS GATE: PASS/);
   assert.match(historicalEvidenceR53,/deadbyte\.r53-windows-gate\.v1/);
   assert.match(historicalR52,/DEADBYTE 0\.15\.29 \/ R52 WINDOWS GATE: PASS/);
@@ -42,10 +50,5 @@ test('R54 canonical Windows gate is successor-bound and preserves R53/R52/R51/R5
   assert.match(historicalR49,/DEADBYTE 0\.15\.26 \/ R49 WINDOWS GATE: PASS/);
   assert.match(deferred,/const expectedVersion=packageIdentity\.version/);
   assert.match(deferred,/'--expected-version',expectedVersion/);
-  assert.match(deferred,/async function awaitHandoffCompletion/);
   assert.match(deferred,/verifySlotUpdateEnvelope\(envelope,publicKey\)/);
-  assert.match(deferred,/active pointer does not match signed activation receipt/);
-  assert.match(deferred,/failure-receipt\.json/);
-  assert.match(deferred,/await awaitHandoffCompletion\(await runSlotUpdateCli/);
-  assert.doesNotMatch(deferred,/'--expected-version','0\.15\.5'/);
 });

package/test/r54-release-contract.test.mjs

@@ -5,8 +5,10 @@ import { readFile } from 'node:fs/promises';
 const root=new URL('../',import.meta.url);
 const read=rel=>readFile(new URL(rel,root),'utf8');
 const json=rel=>read(rel).then(JSON.parse);
+const currentPackage=await json('package.json');
+const r54test=currentPackage.version==='0.15.31'?test:test.skip;
 
-test('R54 release identity is coherent across package lock source metadata SBOM and gate',async()=>{
+r54test('R54 release identity is coherent across package lock source metadata SBOM and gate',async()=>{
   const [pkg,lock,release,provenance,matrix,sbom,versionSource]=await Promise.all([
     json('package.json'),json('package-lock.json'),json('RELEASE.json'),json('PROVENANCE.json'),json('TEST-MATRIX.json'),json('SBOM.cdx.json'),read('src/version.mjs')
   ]);
@@ -25,7 +27,7 @@ test('R54 release identity is coherent across package lock source metadata SBOM
   assert.match(pkg.scripts['r54:focused:test'],/r54-offline-predecessor-self-exclusion\.test\.mjs/);
 });
 
-test('R54 source predecessor is exact immutable published 0.15.30 while runtime predecessor remains exact 0.15.29',async()=>{
+r54test('R54 source predecessor is exact immutable published 0.15.30 while runtime predecessor remains exact 0.15.29',async()=>{
   const [release,provenance]=await Promise.all([json('RELEASE.json'),json('PROVENANCE.json')]);
   assert.equal(release.parent.version,'0.15.30');
   assert.equal(release.parent.release_id,'v0.15.30-ddf7c7338d9a371f');
@@ -44,7 +46,7 @@ test('R54 source predecessor is exact immutable published 0.15.30 while runtime
   assert.deepEqual(provenance.runtime_predecessor,release.runtime_predecessor);
 });
 
-test('R54 records surgical activation recovery fix and preserves explicit non-final claim',async()=>{
+r54test('R54 records surgical activation recovery fix and preserves explicit non-final claim',async()=>{
   const [release,provenance,matrix]=await Promise.all([json('RELEASE.json'),json('PROVENANCE.json'),json('TEST-MATRIX.json')]);
   assert.equal(release.hotfix.activation_ancestry_excluded,true);
   assert.equal(release.hotfix.unrelated_stale_runtime_fail_closed,true);

package/test/r55-offline-predecessor-guardian-family.test.mjs

@@ -0,0 +1,51 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { pathToFileURL } from 'node:url';
+import path from 'node:path';
+
+const target=process.env.R55_RUNTIME_UPDATE_PATH
+  ? path.resolve(process.env.R55_RUNTIME_UPDATE_PATH)
+  : path.resolve(new URL('../src/runtime-update.mjs',import.meta.url).pathname.replace(/^\/(?:[A-Za-z]:)/,m=>m.slice(1)));
+const runtimeUpdate=await import(pathToFileURL(target).href+'?r55='+Date.now());
+const nonce='a'.repeat(64);
+
+test('R55 excludes the verified foreground remote guardian sibling owned by an activation ancestor',()=>{
+  const processes=[
+    {ProcessId:100,ParentProcessId:50,Name:'node.exe',CommandLine:'node npx-cli.js --yes deadbyte-mcp@0.15.32 remote'},
+    {ProcessId:200,ParentProcessId:100,Name:'cmd.exe',CommandLine:'cmd /d /s /c deadbyte-mcp remote'},
+    {ProcessId:300,ParentProcessId:200,Name:'node.exe',CommandLine:'node C:\\cache\\deadbyte-mcp\\src\\deadbyte-cli.mjs remote'},
+    {ProcessId:350,ParentProcessId:300,Name:'node.exe',CommandLine:'node C:\\cache\\deadbyte-mcp\\scripts\\deploy-r48.mjs'},
+    {ProcessId:400,ParentProcessId:350,Name:'node.exe',CommandLine:'node C:\\slot\\deadbyte-mcp\\scripts\\runtime-self-update.mjs --resume-handoff x'},
+    {ProcessId:500,ParentProcessId:300,Name:'node.exe',CommandLine:`node C:\\cache\\deadbyte-mcp\\src\\remote-session-guardian.mjs --state-root C:\\Users\\DEADBYTE\\.deadbyte-mcp --owner-pid 300 --session-nonce ${nonce}`},
+    {ProcessId:900,ParentProcessId:1,Name:'node.exe',CommandLine:'node C:\\stale\\deadbyte-mcp\\src\\mcp-server.mjs'}
+  ];
+  const blockers=runtimeUpdate.selectOfflineRecoveryBlockers(processes,400);
+  assert.deepEqual(blockers.map(item=>item.ProcessId),[900]);
+});
+
+test('R55 does not exempt a guardian whose parent does not equal its declared ancestor owner',()=>{
+  const processes=[
+    {ProcessId:300,ParentProcessId:200,Name:'node.exe',CommandLine:'node C:\\cache\\deadbyte-mcp\\src\\deadbyte-cli.mjs remote'},
+    {ProcessId:400,ParentProcessId:300,Name:'node.exe',CommandLine:'node C:\\slot\\deadbyte-mcp\\scripts\\runtime-self-update.mjs --resume-handoff x'},
+    {ProcessId:510,ParentProcessId:999,Name:'node.exe',CommandLine:`node C:\\cache\\deadbyte-mcp\\src\\remote-session-guardian.mjs --owner-pid 300 --session-nonce ${nonce}`}
+  ];
+  assert.deepEqual(runtimeUpdate.selectOfflineRecoveryBlockers(processes,400).map(item=>item.ProcessId),[510]);
+});
+
+test('R55 does not exempt a guardian whose owner is outside the activation lineage',()=>{
+  const processes=[
+    {ProcessId:300,ParentProcessId:200,Name:'node.exe',CommandLine:'node C:\\cache\\deadbyte-mcp\\src\\deadbyte-cli.mjs remote'},
+    {ProcessId:400,ParentProcessId:300,Name:'node.exe',CommandLine:'node C:\\slot\\deadbyte-mcp\\scripts\\runtime-self-update.mjs --resume-handoff x'},
+    {ProcessId:520,ParentProcessId:777,Name:'node.exe',CommandLine:`node C:\\cache\\deadbyte-mcp\\src\\remote-session-guardian.mjs --owner-pid 777 --session-nonce ${nonce}`}
+  ];
+  assert.deepEqual(runtimeUpdate.selectOfflineRecoveryBlockers(processes,400).map(item=>item.ProcessId),[520]);
+});
+
+test('R55 does not exempt a guardian without the signed-session-shaped nonce contract',()=>{
+  const processes=[
+    {ProcessId:300,ParentProcessId:200,Name:'node.exe',CommandLine:'node C:\\cache\\deadbyte-mcp\\src\\deadbyte-cli.mjs remote'},
+    {ProcessId:400,ParentProcessId:300,Name:'node.exe',CommandLine:'node C:\\slot\\deadbyte-mcp\\scripts\\runtime-self-update.mjs --resume-handoff x'},
+    {ProcessId:530,ParentProcessId:300,Name:'node.exe',CommandLine:'node C:\\cache\\deadbyte-mcp\\src\\remote-session-guardian.mjs --owner-pid 300 --session-nonce short'}
+  ];
+  assert.deepEqual(runtimeUpdate.selectOfflineRecoveryBlockers(processes,400).map(item=>item.ProcessId),[530]);
+});

package/test/r55-release-contract.test.mjs

@@ -0,0 +1,63 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs/promises';
+
+const root=new URL('../',import.meta.url);
+const read=rel=>readFile(new URL(rel,root),'utf8');
+const json=rel=>read(rel).then(JSON.parse);
+const currentPackage=await json('package.json');
+const r55test=currentPackage.version==='0.15.32'?test:test.skip;
+
+r55test('R55 release identity is coherent across package lock source metadata SBOM and gate',async()=>{
+  const [pkg,lock,release,provenance,matrix,sbom,versionSource]=await Promise.all([
+    json('package.json'),json('package-lock.json'),json('RELEASE.json'),json('PROVENANCE.json'),json('TEST-MATRIX.json'),json('SBOM.cdx.json'),read('src/version.mjs')
+  ]);
+  assert.equal(pkg.version,'0.15.32');
+  assert.equal(lock.version,pkg.version);
+  assert.equal(lock.packages[''].version,pkg.version);
+  assert.match(versionSource,/DEADBYTE_VERSION = '0\.15\.32'/);
+  assert.equal(release.version,pkg.version);
+  assert.equal(release.train,'R55');
+  assert.equal(provenance.version,pkg.version);
+  assert.equal(matrix.version,pkg.version);
+  assert.equal(matrix.train,'R55');
+  assert.equal(sbom.metadata.component.version,pkg.version);
+  assert.equal(sbom.serialNumber,'urn:cdx:deadbyte-mcp:r55:0.15.32');
+  assert.match(pkg.scripts['gate:windows'],/gate-windows-r55\.ps1/);
+  assert.match(pkg.scripts['r55:focused:test'],/r55-offline-predecessor-guardian-family\.test\.mjs/);
+});
+
+r55test('R55 source predecessor is exact immutable published 0.15.31 while runtime predecessor remains exact 0.15.29',async()=>{
+  const [release,provenance]=await Promise.all([json('RELEASE.json'),json('PROVENANCE.json')]);
+  assert.equal(release.parent.version,'0.15.31');
+  assert.equal(release.parent.release_id,'v0.15.31-16854fe5b3eb0fa1');
+  assert.equal(release.parent.manifest_sha256,'16854fe5b3eb0fa1c6dd2b96e3c5d6f792c5adbc91dd2a71e7fc2771472bbdd4');
+  assert.equal(release.parent.tarball_sha256,'ff6eba3036cb00ac639ac8907ad6063e6ea8169cf32aca8721f75b1e403e501a');
+  assert.equal(release.parent.activation_status,'PUBLISHED_NOT_ACTIVATED');
+  assert.equal(release.source_predecessor.version,'0.15.31');
+  assert.equal(release.source_predecessor.tarball_sha256,release.parent.tarball_sha256);
+  assert.equal(release.source_predecessor.manifest_file_sha256,release.parent.manifest_sha256);
+  assert.deepEqual(release.runtime_predecessor,{
+    release_id:'v0.15.29-f74eaa1b3d00e6fb',
+    manifest_sha256:'f74eaa1b3d00e6fb5a36b2358efb815e3686c9fe9dbd3b84d25a713ef957748c',
+    generation_manifest_sha256:'289b4fc065de0681da6864cc1bbe09aab198ca804945ffc27c786438dad13f5a'
+  });
+  assert.equal(provenance.parent_manifest_sha256,release.parent.manifest_sha256);
+  assert.deepEqual(provenance.runtime_predecessor,release.runtime_predecessor);
+});
+
+r55test('R55 records the guardian sibling RED to GREEN and preserves fail-closed negative controls',async()=>{
+  const [release,provenance,matrix]=await Promise.all([json('RELEASE.json'),json('PROVENANCE.json'),json('TEST-MATRIX.json')]);
+  assert.equal(release.hotfix.activation_ancestry_excluded,true);
+  assert.equal(release.hotfix.foreground_guardian_owner_parent_binding,true);
+  assert.equal(release.hotfix.foreground_guardian_session_nonce_contract,true);
+  assert.equal(release.hotfix.unrelated_stale_runtime_fail_closed,true);
+  assert.equal(release.hotfix.red_parent_0_15_31,'FAIL_1_OF_4');
+  assert.equal(release.hotfix.green_r55_candidate,'PASS_4_OF_4');
+  assert.equal(release.hotfix.stable_final_claim,false);
+  assert.equal(matrix.observed_pre_release_evidence.red_parent_0_15_31.receipt_sha256,'07ba973aa9224fbb1dde572af35640a1e07ca47273f1e50958d787bfe2aaf429');
+  assert.equal(matrix.observed_pre_release_evidence.green_r55_candidate.receipt_sha256,'a217f72cce51a9daf56136f9075ba487adb2a899c291a63af835ea15f8c632f0');
+  assert.equal(provenance.operator_override.four_hour_soak,'NOT_COMPLETED');
+  assert.equal(provenance.operator_override.stable_final_claim,false);
+  assert.equal(matrix.operator_override.stable_final_claim,false);
+});

package/test/r56-release-contract.test.mjs

@@ -0,0 +1,63 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs/promises';
+
+const root=new URL('../',import.meta.url);
+const read=rel=>readFile(new URL(rel,root),'utf8');
+const json=rel=>read(rel).then(JSON.parse);
+
+test('R56 release identity is coherent across package lock source metadata SBOM and gate',async()=>{
+  const [pkg,lock,release,provenance,matrix,sbom,versionSource]=await Promise.all([
+    json('package.json'),json('package-lock.json'),json('RELEASE.json'),json('PROVENANCE.json'),json('TEST-MATRIX.json'),json('SBOM.cdx.json'),read('src/version.mjs')
+  ]);
+  assert.equal(pkg.version,'0.15.33');
+  assert.equal(lock.version,pkg.version);
+  assert.equal(lock.packages[''].version,pkg.version);
+  assert.match(versionSource,/DEADBYTE_VERSION = '0\.15\.33'/);
+  assert.equal(release.version,pkg.version);
+  assert.equal(release.train,'R56');
+  assert.equal(provenance.version,pkg.version);
+  assert.equal(matrix.version,pkg.version);
+  assert.equal(matrix.train,'R56');
+  assert.equal(sbom.metadata.component.version,pkg.version);
+  assert.equal(sbom.serialNumber,'urn:cdx:deadbyte-mcp:r56:0.15.33');
+  assert.match(pkg.scripts['gate:windows'],/gate-windows-r56\.ps1/);
+  assert.match(pkg.scripts['r56:focused:test'],/r56-rollback-launcher-restore\.test\.mjs/);
+});
+
+test('R56 source and runtime predecessor are exact active published 0.15.32',async()=>{
+  const [release,provenance]=await Promise.all([json('RELEASE.json'),json('PROVENANCE.json')]);
+  assert.equal(release.parent.version,'0.15.32');
+  assert.equal(release.parent.release_id,'v0.15.32-e7223f467777f5df');
+  assert.equal(release.parent.manifest_sha256,'e7223f467777f5dfeb20fd2cc7a6eca22619a44ed95e5bc0b32d9c7aabba361b');
+  assert.equal(release.parent.generation_manifest_sha256,'740443fd207c5e6ffd5952079214bf6e81e9281a6ec880de9bbe3b8ce1deb00e');
+  assert.equal(release.parent.tarball_sha256,'c9e1f5875dd2177cee0089305b40321c128c54ce7f5522e34e507d4ecfb22638');
+  assert.equal(release.parent.activation_status,'ACTIVATED_ROLLBACK_DEFECT_OBSERVED');
+  assert.equal(release.source_predecessor.version,'0.15.32');
+  assert.deepEqual(release.runtime_predecessor,{
+    release_id:'v0.15.32-e7223f467777f5df',
+    manifest_sha256:'e7223f467777f5dfeb20fd2cc7a6eca22619a44ed95e5bc0b32d9c7aabba361b',
+    generation_manifest_sha256:'740443fd207c5e6ffd5952079214bf6e81e9281a6ec880de9bbe3b8ce1deb00e'
+  });
+  assert.equal(provenance.parent_manifest_sha256,release.parent.manifest_sha256);
+  assert.equal(provenance.parent_generation_manifest_sha256,release.parent.generation_manifest_sha256);
+  assert.deepEqual(provenance.runtime_predecessor,release.runtime_predecessor);
+});
+
+test('R56 records signed rollback launcher ordering RED to GREEN and preserves non-final claim',async()=>{
+  const [release,provenance,matrix]=await Promise.all([json('RELEASE.json'),json('PROVENANCE.json'),json('TEST-MATRIX.json')]);
+  assert.equal(release.hotfix.signed_handoff_launcher_snapshot_required,true);
+  assert.equal(release.hotfix.stored_predecessor_verified_without_live_launcher,true);
+  assert.equal(release.hotfix.predecessor_launcher_restored_before_pointer_commit,true);
+  assert.equal(release.hotfix.successor_launcher_restored_before_recovery_pointer,true);
+  assert.equal(release.hotfix.exact_parent_activation_receipt_sha256,'6518a04154f485cfae42e582269634d69a8b05a0183149d5e10006fbdd9d933c');
+  assert.equal(release.hotfix.observed_parent_rollback_failure_receipt_sha256,'00cbd497e4902c67ab39313a378e2fcf32159113b46339ad1d54b5e5a7714205');
+  assert.equal(release.hotfix.red_parent_0_15_32,'FAIL_5_OF_5');
+  assert.equal(release.hotfix.green_r56_candidate,'PASS_5_OF_5');
+  assert.equal(matrix.observed_pre_release_evidence.red_parent_0_15_32.receipt_sha256,'f3b446306691d61e97896ab4d237abaa20d1243237299812e790233c46451dba');
+  assert.equal(matrix.observed_pre_release_evidence.green_r56_candidate.receipt_sha256,'4198930f38a3fc4b7978cfc94ca4509127561c170b05f7566bdf79513e449a8b');
+  assert.equal(release.hotfix.stable_final_claim,false);
+  assert.equal(provenance.operator_override.four_hour_soak,'NOT_COMPLETED');
+  assert.equal(provenance.operator_override.stable_final_claim,false);
+  assert.equal(matrix.operator_override.stable_final_claim,false);
+});