@mogragsigma/dsh-dual-host-plugin 0.0.0-stage → 0.33.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (271) hide show
  1. package/LICENSE +58 -0
  2. package/LICENSE.en.md +94 -0
  3. package/README.md +88 -2
  4. package/bundle/ASSET_NOTICE.md +19 -0
  5. package/bundle/LICENSE +58 -0
  6. package/bundle/LICENSE.en.md +94 -0
  7. package/bundle/README.md +75 -0
  8. package/bundle/THIRD_PARTY_NOTICES.md +94 -0
  9. package/bundle/a2a-dispatches.js +38 -0
  10. package/bundle/a2a-endpoint.js +112 -0
  11. package/bundle/a2a-tools.js +11 -0
  12. package/bundle/a2a-worker.js +63 -0
  13. package/bundle/approval-auth.js +5 -0
  14. package/bundle/approval-chat.js +150 -0
  15. package/bundle/approval-feishu.js +52 -0
  16. package/bundle/approval-guidance.js +68 -0
  17. package/bundle/approval-http.js +8 -0
  18. package/bundle/approval-ledger.js +142 -0
  19. package/bundle/approval-local-relay.js +86 -0
  20. package/bundle/approval-receipts.js +62 -0
  21. package/bundle/approval-reference.js +33 -0
  22. package/bundle/approval-semantic-model.js +26 -0
  23. package/bundle/approval-semantics.js +51 -0
  24. package/bundle/approval-ui/app.js +1 -0
  25. package/bundle/approval-ui/index.html +1 -0
  26. package/bundle/approval-ui/style.css +1 -0
  27. package/bundle/approval-workbench.js +45 -0
  28. package/bundle/artifact-media.js +34 -0
  29. package/bundle/bounded-text.js +44 -0
  30. package/bundle/compatibility.json +980 -0
  31. package/bundle/cordis.patch.yml +5 -0
  32. package/bundle/delivery-approval.js +133 -0
  33. package/bundle/delivery-artifacts.js +52 -0
  34. package/bundle/delivery-commit.js +125 -0
  35. package/bundle/delivery-contract.js +42 -0
  36. package/bundle/delivery-git-read.js +217 -0
  37. package/bundle/delivery-index.js +23 -0
  38. package/bundle/delivery-journal.js +207 -0
  39. package/bundle/delivery-object-plan.js +138 -0
  40. package/bundle/delivery-preview.js +153 -0
  41. package/bundle/delivery-process-receipts.js +90 -0
  42. package/bundle/delivery-process.js +46 -0
  43. package/bundle/delivery-process.py +228 -0
  44. package/bundle/delivery-push-approval.js +89 -0
  45. package/bundle/delivery-push-plan.js +98 -0
  46. package/bundle/delivery-push-recovery.js +32 -0
  47. package/bundle/delivery-push.js +83 -0
  48. package/bundle/delivery-recovery.js +143 -0
  49. package/bundle/delivery-runtime.js +182 -0
  50. package/bundle/delivery-ssh.js +64 -0
  51. package/bundle/delivery-state.js +106 -0
  52. package/bundle/development-attention.js +35 -0
  53. package/bundle/development-bridge.js +136 -0
  54. package/bundle/development-command-review.js +110 -0
  55. package/bundle/development-container.js +110 -0
  56. package/bundle/development-contract.js +17 -0
  57. package/bundle/development-files.js +101 -0
  58. package/bundle/development-gate.js +236 -0
  59. package/bundle/development-model-budget.js +48 -0
  60. package/bundle/development-peer.js +155 -0
  61. package/bundle/development-plan.js +43 -0
  62. package/bundle/development-reconciliation.js +62 -0
  63. package/bundle/development-review.js +81 -0
  64. package/bundle/development-rules/AGENTS.md +51 -0
  65. package/bundle/development-runtime.js +68 -0
  66. package/bundle/development-source.js +48 -0
  67. package/bundle/development-test-runner.js +13 -0
  68. package/bundle/development-tools.js +45 -0
  69. package/bundle/development-worker-review.js +110 -0
  70. package/bundle/development-worker.js +68 -0
  71. package/bundle/development-workspace.js +54 -0
  72. package/bundle/diagnostics.js +78 -0
  73. package/bundle/distribution-lock.json +773 -0
  74. package/bundle/drained-process.js +26 -0
  75. package/bundle/durable-inbox.js +294 -0
  76. package/bundle/feishu-policy.js +24 -0
  77. package/bundle/gateway-maintenance.js +55 -0
  78. package/bundle/global-rules/AGENTS.md +83 -0
  79. package/bundle/im-delivery.js +60 -0
  80. package/bundle/index.js +445 -0
  81. package/bundle/intervention-actions.js +135 -0
  82. package/bundle/intervention-job-control.js +28 -0
  83. package/bundle/intervention-state.js +43 -0
  84. package/bundle/job-version.js +15 -0
  85. package/bundle/legacy-feishu-adapter.js +89 -0
  86. package/bundle/link-contract.js +80 -0
  87. package/bundle/maintenance-process-identity.js +93 -0
  88. package/bundle/model-selection.js +71 -0
  89. package/bundle/native-context.js +14 -0
  90. package/bundle/native-entry-admission.js +2 -0
  91. package/bundle/native-entry.js +58 -0
  92. package/bundle/native-file-reference.js +32 -0
  93. package/bundle/native-owner-origin.js +12 -0
  94. package/bundle/native-rules/AGENTS.md +199 -0
  95. package/bundle/native-tools.js +108 -0
  96. package/bundle/notification-artifacts.js +70 -0
  97. package/bundle/notification-contract.js +29 -0
  98. package/bundle/notification-defaults.js +81 -0
  99. package/bundle/notification-discovery.js +65 -0
  100. package/bundle/notification-endpoint.js +54 -0
  101. package/bundle/notification-feishu.js +51 -0
  102. package/bundle/notification-media-endpoint.js +94 -0
  103. package/bundle/notification-review.js +27 -0
  104. package/bundle/notification-targets.js +54 -0
  105. package/bundle/onboarding-activity.js +66 -0
  106. package/bundle/onboarding-agent-hold.js +94 -0
  107. package/bundle/onboarding-boundary.js +20 -0
  108. package/bundle/onboarding-cloud-contract.js +29 -0
  109. package/bundle/onboarding-cloud-file-review.js +58 -0
  110. package/bundle/onboarding-cloud-files.js +100 -0
  111. package/bundle/onboarding-cloud-im.js +34 -0
  112. package/bundle/onboarding-cloud-model-probe.js +53 -0
  113. package/bundle/onboarding-cloud-models.js +68 -0
  114. package/bundle/onboarding-cloud-operation.js +276 -0
  115. package/bundle/onboarding-cloud-package.js +38 -0
  116. package/bundle/onboarding-cloud-repositories.js +89 -0
  117. package/bundle/onboarding-cloud-retirement.js +59 -0
  118. package/bundle/onboarding-cloud-task-runtime.js +90 -0
  119. package/bundle/onboarding-cloud-web.js +85 -0
  120. package/bundle/onboarding-cloud.js +110 -0
  121. package/bundle/onboarding-coordinated-hold.js +94 -0
  122. package/bundle/onboarding-exclusive-rename.js +16 -0
  123. package/bundle/onboarding-existing-host.js +63 -0
  124. package/bundle/onboarding-existing-setup.js +123 -0
  125. package/bundle/onboarding-file-contract.js +31 -0
  126. package/bundle/onboarding-file-review-contract.js +38 -0
  127. package/bundle/onboarding-file-transfer.js +133 -0
  128. package/bundle/onboarding-handoff-remote.js +98 -0
  129. package/bundle/onboarding-handoff.js +112 -0
  130. package/bundle/onboarding-host-stop-observation.js +44 -0
  131. package/bundle/onboarding-host.js +254 -0
  132. package/bundle/onboarding-identity.js +9 -0
  133. package/bundle/onboarding-im-maintenance-native.js +30 -0
  134. package/bundle/onboarding-im-maintenance.js +70 -0
  135. package/bundle/onboarding-im.js +31 -0
  136. package/bundle/onboarding-inspection-guard.js +15 -0
  137. package/bundle/onboarding-install-fs.js +58 -0
  138. package/bundle/onboarding-installer.js +157 -0
  139. package/bundle/onboarding-local-pair-native.js +21 -0
  140. package/bundle/onboarding-local-pair.js +99 -0
  141. package/bundle/onboarding-maintenance-fs.js +69 -0
  142. package/bundle/onboarding-maintenance-plan.js +213 -0
  143. package/bundle/onboarding-maintenance-record.js +169 -0
  144. package/bundle/onboarding-maintenance.js +163 -0
  145. package/bundle/onboarding-model-probe.js +119 -0
  146. package/bundle/onboarding-models.js +107 -0
  147. package/bundle/onboarding-native-host.js +101 -0
  148. package/bundle/onboarding-native-probe.js +56 -0
  149. package/bundle/onboarding-native-runner.js +29 -0
  150. package/bundle/onboarding-node-bootstrap.py +678 -0
  151. package/bundle/onboarding-node.js +77 -0
  152. package/bundle/onboarding-notification-defaults.js +93 -0
  153. package/bundle/onboarding-package-source.js +33 -0
  154. package/bundle/onboarding-paths.js +58 -0
  155. package/bundle/onboarding-peer-binding.js +61 -0
  156. package/bundle/onboarding-peer-contract.js +12 -0
  157. package/bundle/onboarding-plugin-repair.js +116 -0
  158. package/bundle/onboarding-plugin-version.js +143 -0
  159. package/bundle/onboarding-remote-control.js +140 -0
  160. package/bundle/onboarding-remote-probe.js +40 -0
  161. package/bundle/onboarding-repositories.js +88 -0
  162. package/bundle/onboarding-repository.js +49 -0
  163. package/bundle/onboarding-runtime-activation.js +83 -0
  164. package/bundle/onboarding-runtime-artifacts-client.js +87 -0
  165. package/bundle/onboarding-runtime-artifacts.js +126 -0
  166. package/bundle/onboarding-runtime-extension.js +400 -0
  167. package/bundle/onboarding-runtime-inventory.js +88 -0
  168. package/bundle/onboarding-runtime-program.js +42 -0
  169. package/bundle/onboarding-runtime-reclaim-client.js +94 -0
  170. package/bundle/onboarding-runtime-reclaim-worker.js +63 -0
  171. package/bundle/onboarding-runtime-reclaim.js +132 -0
  172. package/bundle/onboarding-runtime-repair-client.js +50 -0
  173. package/bundle/onboarding-runtime-repair.js +88 -0
  174. package/bundle/onboarding-runtime-stop.js +90 -0
  175. package/bundle/onboarding-runtime-uninstall-client.js +88 -0
  176. package/bundle/onboarding-runtime-uninstall.js +167 -0
  177. package/bundle/onboarding-runtime-version-client.js +138 -0
  178. package/bundle/onboarding-runtime-version.js +145 -0
  179. package/bundle/onboarding-schema.js +42 -0
  180. package/bundle/onboarding-self-disable.js +3 -0
  181. package/bundle/onboarding-self-lifecycle.js +95 -0
  182. package/bundle/onboarding-self-maintenance.js +52 -0
  183. package/bundle/onboarding-self-remove.js +3 -0
  184. package/bundle/onboarding-self-stop.js +85 -0
  185. package/bundle/onboarding-ssh-forward.js +48 -0
  186. package/bundle/onboarding-ssh.js +105 -0
  187. package/bundle/onboarding-state.js +95 -0
  188. package/bundle/onboarding-task-runtime-contract.js +38 -0
  189. package/bundle/onboarding-task-runtime-native.js +80 -0
  190. package/bundle/onboarding-task-runtime.js +66 -0
  191. package/bundle/onboarding-token-plan.js +52 -0
  192. package/bundle/onboarding-version-activation-client.js +48 -0
  193. package/bundle/onboarding-version-candidate.js +96 -0
  194. package/bundle/onboarding-version-repair.js +128 -0
  195. package/bundle/package-lock.json +773 -0
  196. package/bundle/package.json +99 -0
  197. package/bundle/peer-file-fs.js +62 -0
  198. package/bundle/peer-file-migration.js +59 -0
  199. package/bundle/peer-file-review.js +107 -0
  200. package/bundle/peer-files.js +157 -0
  201. package/bundle/peer-mailbox.js +75 -0
  202. package/bundle/protocol.js +17 -0
  203. package/bundle/recovery.js +40 -0
  204. package/bundle/repository-catalog.js +85 -0
  205. package/bundle/repository-gitee.js +76 -0
  206. package/bundle/repository-managed.js +46 -0
  207. package/bundle/repository-writer.js +43 -0
  208. package/bundle/rules/AGENTS.md +22 -0
  209. package/bundle/runtime-im-lock.json +11577 -0
  210. package/bundle/runtime-im-package.json +18 -0
  211. package/bundle/runtime-lock.json +10152 -0
  212. package/bundle/runtime-package.json +17 -0
  213. package/bundle/scheduler-migration.js +45 -0
  214. package/bundle/search-contract.js +19 -0
  215. package/bundle/skills/dsh-dual-end/SKILL.md +12 -0
  216. package/bundle/skills/task-a2a/SKILL.md +55 -0
  217. package/bundle/skills/task-a2a-worker/SKILL.md +23 -0
  218. package/bundle/skills/task-approval/SKILL.md +128 -0
  219. package/bundle/skills/task-artifacts/SKILL.md +46 -0
  220. package/bundle/skills/task-development/SKILL.md +144 -0
  221. package/bundle/skills/task-diagnostics/SKILL.md +41 -0
  222. package/bundle/skills/task-direct-link/SKILL.md +143 -0
  223. package/bundle/skills/task-file-transfer/SKILL.md +107 -0
  224. package/bundle/skills/task-handoff/SKILL.md +23 -0
  225. package/bundle/skills/task-intake/SKILL.md +13 -0
  226. package/bundle/skills/task-notify/SKILL.md +102 -0
  227. package/bundle/skills/task-onboarding/SKILL.md +708 -0
  228. package/bundle/skills/task-recovery/SKILL.md +54 -0
  229. package/bundle/skills/task-repository/SKILL.md +145 -0
  230. package/bundle/skills/task-research/SKILL.md +43 -0
  231. package/bundle/skills/task-schedule/SKILL.md +79 -0
  232. package/bundle/skills/task-sidebar/SKILL.md +122 -0
  233. package/bundle/skills/task-workbench/SKILL.md +30 -0
  234. package/bundle/skills/task-worker/SKILL.md +88 -0
  235. package/bundle/source-search.js +89 -0
  236. package/bundle/source-web.js +17 -0
  237. package/bundle/ssh-connector.js +24 -0
  238. package/bundle/store.js +102 -0
  239. package/bundle/task-a2a.js +298 -0
  240. package/bundle/task-artifacts.js +179 -0
  241. package/bundle/task-board-a2a.js +55 -0
  242. package/bundle/task-board-development.js +83 -0
  243. package/bundle/task-board-planning.js +84 -0
  244. package/bundle/task-board.js +132 -0
  245. package/bundle/task-branch.js +2 -0
  246. package/bundle/task-catalog.js +77 -0
  247. package/bundle/task-context.js +40 -0
  248. package/bundle/task-envelope.js +96 -0
  249. package/bundle/task-interventions.js +54 -0
  250. package/bundle/task-jobs.js +156 -0
  251. package/bundle/task-notifications.js +132 -0
  252. package/bundle/task-results.js +16 -0
  253. package/bundle/task-scheduler.js +77 -0
  254. package/bundle/task-sources.js +101 -0
  255. package/bundle/task-trigger-time.js +46 -0
  256. package/bundle/task-triggers.js +157 -0
  257. package/bundle/task-worker.js +73 -0
  258. package/bundle/task-workflows.js +117 -0
  259. package/bundle/tools.js +13 -0
  260. package/bundle/workbench-assets/asset-provenance.json +26 -0
  261. package/bundle/workbench-assets/whale-ui-states.png +0 -0
  262. package/bundle/workbench-client.js +811 -0
  263. package/bundle/workbench-decisions.js +48 -0
  264. package/bundle/workbench-host.js +122 -0
  265. package/bundle/workbench-im-identity.js +51 -0
  266. package/bundle/workbench-proxy.js +127 -0
  267. package/bundle/worker-rules/AGENTS.md +84 -0
  268. package/bundle/worker-tools.js +13 -0
  269. package/compatibility.json +980 -0
  270. package/cordis.patch.yml +3 -0
  271. package/package.json +57 -4
@@ -0,0 +1,88 @@
1
+ // Operator-only durable intent. Reopening reads local history, never retries SSH.
2
+ import {createHash} from 'node:crypto';
3
+ import {credentialKey} from '@deepseek-ai/dsh-credentials';
4
+ import {runtimeProgram,runtimeCommand} from './onboarding-runtime-program.js';
5
+ const hash=x=>createHash('sha256').update(JSON.stringify(x)).digest('hex');
6
+ const fail=c=>{throw Error('ONBOARDING_CLOUD_UNINSTALL_'+c);};
7
+ const exact=(v,k)=>v&&typeof v==='object'&&!Array.isArray(v)&&Object.keys(v).sort().join()===k.slice().sort().join();
8
+ const uuid=x=>typeof x==='string'&&/^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/.test(x);
9
+ const hex=x=>typeof x==='string'&&/^[a-f0-9]{64}$/.test(x),version=x=>typeof x==='string'&&/^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(x)&&x.length<100;
10
+ const terminal=s=>['committed','rolled_back','refused'].includes(s),scope='owned_plugin_rules_skills_only';
11
+ const lastRequests=d=>[...new Map((d?.requests??[]).filter(r=>r.receipt?.state!=='refused').map(r=>[r.targetId,r])).values()];
12
+ export const uninstallRecordKey=id=>credentialKey('dsh-task-gateway','onboarding-runtime-uninstall-v1-'+id);
13
+ export const uninstallPending=d=>lastRequests(d).some(r=>r.state==='requested'||!terminal(r.receipt?.state));
14
+ export const uninstallBlocked=d=>uninstallPending(d)||lastRequests(d).some(r=>r.receipt?.state==='committed');
15
+ const common=(operationId,runtimeId)=>({contract:1,operationId,runtimeId,scope,hostStarted:false,activationVerified:false,initialization:false,dependenciesRemoved:false,userDataPreserved:true,backupsRetained:true});
16
+ const receiptFields=['contract','operationId','runtimeId','scope','hostStarted','activationVerified','initialization','dependenciesRemoved','userDataPreserved','backupsRetained','id','version','state','recoveryRequired','pluginInstalled','managedRestartBlocked'];
17
+ function checkReceipt(v,d,id,ver){
18
+ const base=common(d.operationId,d.runtimeId);
19
+ if(!v||Object.entries(base).some(([k,x])=>v[k]!==x)||v.id!==id||v.version!==ver||!['intent','rules_removed','capturing','committed','rolled_back','refused'].includes(v.state)||v.recoveryRequired!==!terminal(v.state)||v.pluginInstalled!==(v.state==='committed'?false:null)||v.managedRestartBlocked!==!['rolled_back','refused'].includes(v.state))fail('RESPONSE_REVIEW');
20
+ }
21
+ export function parseUninstallRequest(record,operationId){
22
+ if(!record)return null;const d=record.payload;
23
+ if(record.kind!=='grant'||!exact(d,['schema','operationId','runtimeId','binding','revision','plans','requests'])||d.schema!==1||d.operationId!==operationId||!uuid(d.runtimeId)||!hex(d.binding)||!Number.isSafeInteger(d.revision)||d.revision<1||!Array.isArray(d.plans)||d.plans.length>128||!Array.isArray(d.requests)||d.requests.length>128||Buffer.byteLength(JSON.stringify(d))>262144)fail('LOCAL_LEDGER_REVIEW');
24
+ const ids=new Set();for(const p of d.plans){if(!exact(p,['id','kind','targetId','fingerprint','expiresAt','version'])||!uuid(p.id)||ids.has(p.id)||!['apply','recover'].includes(p.kind)||!uuid(p.targetId)||!hex(p.fingerprint)||!Number.isSafeInteger(p.expiresAt)||!version(p.version))fail('LOCAL_LEDGER_REVIEW');ids.add(p.id);}
25
+ for(const p of d.plans)if(p.kind==='apply'?p.id!==p.targetId:!d.plans.some(x=>x.kind==='apply'&&x.id===p.targetId&&x.version===p.version))fail('LOCAL_LEDGER_REVIEW');
26
+ const seen=new Set();for(const r of d.requests){
27
+ const p=d.plans.find(p=>p.id===r?.planId&&p.kind===r?.action);
28
+ if(!exact(r,['key','action','planId','targetId','fingerprint','state','receipt'])||!p||r.key!==r.action+':'+r.planId||seen.has(r.key)||r.targetId!==p.targetId||r.fingerprint!==p.fingerprint||!['requested','observed'].includes(r.state)||r.state==='requested'&&r.receipt!==null)fail('LOCAL_LEDGER_REVIEW');seen.add(r.key);
29
+ if(r.state==='observed'){if(!exact(r.receipt,receiptFields))fail('LOCAL_LEDGER_REVIEW');try{checkReceipt(r.receipt,d,p.targetId,p.version);}catch{fail('LOCAL_LEDGER_REVIEW');}}
30
+ }return d;
31
+ }
32
+ export async function runtimeUninstallClient({args,p,a,b,runtimeId,credentials,ssh,now=Date.now}){
33
+ const action=args?.action,fields={uninstall_record:[],uninstall_preview:[],uninstall_apply:['id','fingerprint','confirm'],uninstall_status:['id'],uninstall_recover_preview:['id'],uninstall_recover:['id','fingerprint','confirm']};
34
+ const mutation=['uninstall_apply','uninstall_recover'].includes(action),kind=action?.slice(10);
35
+ if(!Object.hasOwn(fields,action)||!exact(args,['action','operationId',...fields[action]])||args.operationId!==p.id||Object.hasOwn(args,'id')&&!uuid(args.id)||mutation&&(args.confirm!==true||!hex(args.fingerprint)))fail('CONFIRMATION_REQUIRED');
36
+ const key=uninstallRecordKey(p.id),c=credentials(),binding=hash({operationId:p.id,archiveHash:p.archiveHash,bindingFingerprint:p.bindingFingerprint});
37
+ let ledger=parseUninstallRequest(await c.readRecord(key),p.id);
38
+ if(ledger&&(ledger.binding!==binding||runtimeId&&ledger.runtimeId!==runtimeId))fail('BINDING_CHANGED');
39
+ const decode=n=>{const f=a.files.find(x=>x.path==='plugin/'+n);if(!f)fail('ARCHIVE_REVIEW');return Buffer.from(f.data,'base64').toString();};
40
+ const compat=JSON.parse(decode('compatibility.json')),supported=['onboardingPluginVersion','onboardingPluginVersionRequests','onboardingPluginVersionLifecycle','onboardingPluginVersionArtifacts','onboardingPluginUninstall','onboardingPluginUninstallRequests'].every(k=>compat[k]===1);
41
+ const cached=r=>({...r.receipt??{...common(p.id,runtimeId),id:r.targetId,state:'uninstall_outcome_unknown',recoveryRequired:true,managedRestartBlocked:true,pluginInstalled:null},cached:true,historical:true,notResent:true,requestState:r.state});
42
+ if(action==='uninstall_record')return {supported,operationId:p.id,runtimeId:ledger?.runtimeId??runtimeId??null,cached:true,historical:true,pending:uninstallPending(ledger),blocked:uninstallBlocked(ledger),plans:ledger?.plans??[],requests:ledger?.requests.map(r=>({...r,receipt:r.receipt?{...r.receipt,cached:true,historical:true}:null}))??[],initialization:false,hostStarted:false};
43
+ if(!supported)fail('UNSUPPORTED');if(!uuid(runtimeId))fail('RUNTIME_RECORD_REQUIRED');
44
+ const empty={schema:1,operationId:p.id,runtimeId,binding,revision:0,plans:[],requests:[]},current=()=>ledger??empty;
45
+ async function save(next){const old=ledger,value={...next,revision:(ledger?.revision??0)+1};parseUninstallRequest({kind:'grant',payload:value},p.id);await c.modifyRecord(key,r=>{if(JSON.stringify(parseUninstallRequest(r,p.id))!==JSON.stringify(old))fail('LOCAL_CONFLICT');return {kind:'grant',payload:value};});ledger=value;}
46
+ const previous=mutation?current().requests.find(r=>r.key===kind+':'+args.id):null;
47
+ if(previous){if(previous.fingerprint!==args.fingerprint)fail('PLAN_DRIFT');return cached(previous);}
48
+ const last=id=>current().requests.filter(r=>r.targetId===id&&r.receipt?.state!=='refused').at(-1);
49
+ if(uninstallBlocked(ledger)&&!['uninstall_status','uninstall_recover_preview','uninstall_recover'].includes(action))fail('RECOVERY_REQUIRED');
50
+ if(['uninstall_recover_preview','uninstall_recover'].includes(action)&&current().requests.some(r=>r.state==='requested'))fail('OUTCOME_UNKNOWN');
51
+ let target=args.id,plan,remoteArgs={};
52
+ if(mutation){
53
+ plan=current().plans.find(x=>x.id===args.id&&x.kind===kind);
54
+ if(!plan||plan.fingerprint!==args.fingerprint||plan.expiresAt<=now())fail('PLAN_EXPIRED');target=plan.targetId;
55
+ if(kind==='recover'&&last(target)?.receipt?.recoveryRequired!==true)fail('RECOVERY_REQUIRED');
56
+ remoteArgs={id:plan.id,fingerprint:plan.fingerprint,confirm:true};
57
+ }else if(action!=='uninstall_preview'){
58
+ if(!current().plans.some(x=>x.kind==='apply'&&x.id===args.id))fail('TRANSACTION_UNKNOWN');remoteArgs={id:args.id};
59
+ if(action==='uninstall_recover_preview'&&last(args.id)?.receipt?.recoveryRequired!==true)fail('RECOVERY_REQUIRED');
60
+ }
61
+ const input=JSON.stringify({action:'runtime_version',root:p.root,operationId:p.id,installationId:p.installationId,proof:p.proof,planHash:p.planHash,versionAction:action==='uninstall_recover_preview'?'uninstall_recoveryPreview':action,args:remoteArgs});
62
+ const command=runtimeCommand(a.baseline.node.path,runtimeProgram(decode('onboarding-remote-control.js'),decode('onboarding-runtime-extension.js')),'runtimeVersionCLI');
63
+ let request;if(mutation){if(current().requests.length>=128)fail('HISTORY_FULL');request={key:kind+':'+args.id,action:kind,planId:args.id,targetId:target,fingerprint:args.fingerprint,state:'requested',receipt:null};await save({...current(),requests:[...current().requests,request]});}
64
+ let result;try{result=JSON.parse(await ssh.execute(b,command,input,{timeoutMs:120000}));}catch{fail('OUTCOME_UNKNOWN');}
65
+ if(result?.ok!==true){
66
+ if(request&&['ONBOARDING_CLOUD_RUNTIME_VERSION_PREFLIGHT_REFUSED','ONBOARDING_CLOUD_RUNTIME_UNINSTALL_PLAN_DRIFT','ONBOARDING_CLOUD_RUNTIME_UNINSTALL_CONFIRMATION_REQUIRED'].includes(result?.error)){
67
+ const receipt={...common(p.id,runtimeId),id:target,version:plan.version,state:'refused',recoveryRequired:false,pluginInstalled:null,managedRestartBlocked:false};
68
+ await save({...current(),requests:current().requests.map(r=>r.key===request.key?{...r,state:'observed',receipt}:r)});
69
+ }
70
+ throw Error(typeof result?.error==='string'&&/^ONBOARDING_CLOUD_[A-Z_]{1,120}$/.test(result.error)?result.error:'ONBOARDING_CLOUD_UNINSTALL_RESPONSE_REVIEW');
71
+ }
72
+ const v=result.value;if(!v||Object.entries(common(p.id,runtimeId)).some(([k,x])=>v[k]!==x))fail('RESPONSE_REVIEW');
73
+ if(['uninstall_preview','uninstall_recover_preview'].includes(action)){
74
+ const recover=action==='uninstall_recover_preview',ver=recover?current().plans.find(x=>x.kind==='apply'&&x.id===args.id)?.version:v.version;
75
+ if(!recover&&(typeof v.canApply!=='boolean'||!Array.isArray(v.conflicts)||!Array.isArray(v.changes)||!Array.isArray(v.retained)||v.conflicts.length>256||v.changes.length>66||v.retained.length>256))fail('RESPONSE_REVIEW');
76
+ if(!recover&&!v.canApply){if(v.id!==null||v.fingerprint!==null||v.expiresAt!==null)fail('RESPONSE_REVIEW');return {...v,cached:false};}
77
+ if(!uuid(v.id)||!hex(v.fingerprint)||!Number.isSafeInteger(v.expiresAt)||v.expiresAt<=now()||v.expiresAt>now()+301000||!version(ver)||recover&&(v.transactionId!==args.id||v.confirmRequired!==true||!['finalize_receipt','rollback_incomplete_changes','finish_recorded_uninstall','cancel_proven_unstarted_uninstall'].includes(v.action))||!recover&&v.conflicts.length)fail('RESPONSE_REVIEW');
78
+ if(current().plans.length>=128||current().plans.some(p=>p.id===v.id))fail('HISTORY_FULL');
79
+ const next={id:v.id,kind:recover?'recover':'apply',targetId:recover?args.id:v.id,fingerprint:v.fingerprint,expiresAt:v.expiresAt,version:ver};await save({...current(),plans:[...current().plans,next]});return {...v,cached:false};
80
+ }
81
+ const base=current().plans.find(p=>p.kind==='apply'&&p.id===target);checkReceipt(v,current(),target,base?.version);
82
+ const receipt=Object.fromEntries(receiptFields.map(k=>[k,v[k]])),relevant=request??last(target);
83
+ if(relevant){
84
+ if(relevant.state==='requested'&&relevant.action==='recover'&&!terminal(receipt.state)&&request!==relevant)return {...cached(relevant),observedState:receipt.state};
85
+ await save({...current(),requests:current().requests.map(r=>r.key===relevant.key?{...r,state:'observed',receipt}:r)});
86
+ }
87
+ return {...receipt,cached:false,historical:action==='uninstall_status'};
88
+ }
@@ -0,0 +1,167 @@
1
+ // Original-archive, offline three-artifact removal. The installed image is
2
+ // retired by no-replace rename, not recursively deleted. User data, dependency
3
+ // installation and every version/repair backup remain outside this operation.
4
+ import {randomUUID} from 'node:crypto';
5
+ import {createOnboardingMaintenance} from './onboarding-maintenance.js';
6
+ import {createMaintenancePlanner} from './onboarding-maintenance-plan.js';
7
+ import {snapshot,bytes} from './onboarding-install-fs.js';
8
+ import {syncDirectory} from './onboarding-maintenance-fs.js';
9
+ const uuid=x=>typeof x==='string'&&/^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/.test(x);
10
+ const hex=x=>typeof x==='string'&&/^[a-f0-9]{64}$/.test(x);
11
+ const exact=(x,k)=>x&&typeof x==='object'&&!Array.isArray(x)&&Object.keys(x).sort().join()===k.slice().sort().join();
12
+ const terminal=r=>['committed','rolled_back'].includes(r.state);
13
+ const op=x=>({path:x.path,kind:x.kind,before:x.before,after:x.after,afterHash:x.afterHash,action:x.action});
14
+
15
+ export function createRuntimeUninstall(api,q,j,{current,guard,moveImage,artifacts}){
16
+ const {fs,path,hash,fail,regular,signed,verified,atomicJSON,checkAncestors}=api,now=api.versionNow??Date.now;
17
+ const control=path.join(q.root,'.control/runtime'),file=path.join(control,'plugin-uninstall.json'),planFile=path.join(control,'plugin-uninstall-plan.json');
18
+ const target=path.join(q.root,'runtime/plugin'),retired=path.join(control,'retired-plugin');
19
+ const home=path.join(q.root,'runtime/native-home'),dsh=path.join(home,'dsh'),state=path.join(dsh,'dual-host-onboarding');
20
+ const config={onboarding:{role:'cloud',installation:{enabled:true,isolatedRoot:path.join(q.root,'runtime')}}};
21
+ const options={home,env:{HOME:home,DSH_HOME:dsh,DSH_AGENTS_HOME:path.join(home,'agents'),DSH_ONBOARDING_ISOLATED_ROOT:path.join(q.root,'runtime')},source:target,maintenanceHook:api.artifactsHook};
22
+ const binding=hash({root:q.root,operationId:q.operationId,runtimeId:j.id,inventoryHash:j.inventoryHash});
23
+ const bad=code=>fail('RUNTIME_UNINSTALL_'+code);
24
+ async function exists(p){await checkAncestors(path.dirname(p));try{return await fs.lstat(p);}catch(e){if(e.code==='ENOENT')return null;throw e;}}
25
+ async function load(p){const f=await regular(p,16777216);if(!f)return null;if(f.identity.uid!==process.getuid()||f.identity.mode!==0o600)bad('LEDGER_REVIEW');try{return verified(JSON.parse(f.data),q.proof);}catch{bad('LEDGER_REVIEW');}}
26
+ async function save(p,d){if(Buffer.byteLength(JSON.stringify(d))>16000000)bad('HISTORY_LIMIT');await atomicJSON(p,signed(d,q.proof));}
27
+ async function ledger(){
28
+ const d=await load(file);if(!d){if(await exists(retired))bad('LEDGER_REVIEW');return {schema:1,binding,records:[]};}
29
+ if(!exact(d,['schema','binding','records'])||d.schema!==1||d.binding!==binding||!Array.isArray(d.records)||d.records.length>16||new Set(d.records.map(r=>r.id)).size!==d.records.length)bad('LEDGER_REVIEW');
30
+ for(const [i,r] of d.records.entries()){
31
+ if(!exact(r,['id','fingerprint','state','image','beforeMetadata','artifactLedgerHash','innerId','innerFingerprint','operations','restoredMetadataHash','updatedAt'])||!uuid(r.id)||!uuid(r.innerId)||![r.fingerprint,r.artifactLedgerHash,r.innerFingerprint].every(hex)||!['intent','rules_removed','capturing','committed','rolled_back'].includes(r.state)||i<d.records.length-1&&r.state!=='rolled_back'||!Array.isArray(r.operations)||r.operations.length>65||!r.beforeMetadata||!hex(r.beforeMetadata.hash)||!hex(r.beforeMetadata.contentHash)||!Array.isArray(r.beforeMetadata.rows)||!Number.isSafeInteger(r.updatedAt)||r.restoredMetadataHash!==null&&!hex(r.restoredMetadataHash)||r.state==='rolled_back'&&!hex(r.restoredMetadataHash)||!r.image?.version||!Array.isArray(r.image.image)||r.image.image.length>4096)bad('LEDGER_REVIEW');
32
+ }return d;
33
+ }
34
+ const view=(r,extra={})=>({contract:1,operationId:q.operationId,runtimeId:j.id,scope:'owned_plugin_rules_skills_only',id:r?.id??null,state:r?.state??'not_requested',version:r?.image.version??null,recoveryRequired:!!r&&!terminal(r),historical:true,pluginInstalled:r?.state==='committed'?false:null,hostStarted:false,initialization:false,activationVerified:false,automaticRetry:false,dependenciesRemoved:false,userDataPreserved:true,backupsRetained:true,managedRestartBlocked:!!r&&r.state!=='rolled_back',...extra});
35
+ async function assertOpen(){const r=(await ledger()).records.at(-1);if(r&&r.state!=='rolled_back')bad(r.state==='committed'?'ALREADY_UNINSTALLED':'RECOVERY_REQUIRED');}
36
+ async function restored(){const r=(await ledger()).records.at(-1);return r?.state==='rolled_back'?{metadataHash:r.restoredMetadataHash,artifactLedgerHash:r.artifactLedgerHash}:null;}
37
+ async function metadata(){return (await artifacts()).metadata();}
38
+ async function imageAt(location,image){
39
+ await checkAncestors(path.dirname(location));const rows=image.image,seen=new Set();
40
+ if(!rows.some(x=>x.path===''&&x.kind==='directory'))bad('IMAGE_REVIEW');
41
+ for(const x of rows){
42
+ if(typeof x.path!=='string'||x.path&&(!/^[A-Za-z0-9_./-]+$/.test(x.path)||x.path.split('/').some(n=>!n||n==='.'||n==='..'))||seen.has(x.path)||!['file','directory'].includes(x.kind))bad('IMAGE_REVIEW');seen.add(x.path);
43
+ const p=path.join(location,x.path);await checkAncestors(path.dirname(p));const s=await exists(p);
44
+ if(!s||s.isSymbolicLink()||s.dev!==x.dev||s.ino!==x.ino||s.uid!==x.uid||(s.mode&0o777)!==x.mode)bad('IMAGE_DRIFT');
45
+ if(x.kind==='directory'){
46
+ if(!s.isDirectory())bad('IMAGE_DRIFT');const names=rows.filter(y=>y.path&&path.posix.dirname(y.path)===(x.path||'.')).map(y=>path.posix.basename(y.path)).sort();
47
+ if(hash((await fs.readdir(p)).sort())!==hash(names))bad('IMAGE_DRIFT');
48
+ }else{const f=await regular(p,4194304);if(!f||f.sha256!==x.sha256||f.data.length!==x.bytes||f.identity.ino!==x.ino||f.identity.dev!==x.dev)bad('IMAGE_DRIFT');}
49
+ }
50
+ }
51
+ async function location(r){
52
+ const a=await exists(target),b=await exists(retired);
53
+ if(a&&!b){await imageAt(target,r.image);return 'installed';}
54
+ if(!a&&b&&['capturing','committed'].includes(r.state)){await imageAt(retired,r.image);return 'retired';}
55
+ bad('IMAGE_DRIFT');
56
+ }
57
+ async function preflight(){
58
+ await guard();await assertOpen();if(await exists(retired))bad('IMAGE_DRIFT');
59
+ const image=await current();await imageAt(target,image);
60
+ const owner=await (await artifacts()).ownership(),p=await createMaintenancePlanner(config,options).prepare('uninstall');
61
+ if(!p.view.planReady)return {blocked:p.view};
62
+ const root=await fs.lstat(control);if(image.image.some(x=>x.dev!==root.dev))bad('CROSS_DEVICE');
63
+ return {image,owner,p};
64
+ }
65
+ function publicPlan(p,v={}){return {contract:1,operationId:q.operationId,runtimeId:j.id,id:p.id,fingerprint:p.fingerprint,expiresAt:p.expiresAt,scope:'owned_plugin_rules_skills_only',hostStarted:false,activationVerified:false,initialization:false,automaticRetry:false,dependenciesRemoved:false,backupsRetained:true,userDataPreserved:true,...v};}
66
+ async function writePlan(body){const p={schema:1,binding,id:randomUUID(),expiresAt:now()+300000,...body};p.fingerprint=hash(p);await save(planFile,p);return p;}
67
+ async function plan(a,kind){
68
+ if(!exact(a,['id','fingerprint','confirm'])||a.confirm!==true||!uuid(a.id)||!hex(a.fingerprint))bad('CONFIRMATION_REQUIRED');
69
+ const p=await load(planFile);if(!p||p.schema!==1||p.binding!==binding||p.kind!==kind||p.id!==a.id||p.fingerprint!==a.fingerprint||p.expiresAt<=now())bad('PLAN_DRIFT');
70
+ const {fingerprint,...body}=p;if(hash(body)!==fingerprint)bad('PLAN_DRIFT');return p;
71
+ }
72
+ async function preview(){
73
+ const c=await preflight();if(c.blocked)return publicPlan({id:null,fingerprint:null,expiresAt:null},{canApply:false,conflicts:c.blocked.conflicts,changes:[],retained:c.blocked.retained});
74
+ const p=await writePlan({kind:'apply',imageHash:hash(c.image),metadataHash:c.owner.metadata.hash,artifactLedgerHash:c.owner.ledgerHash,innerFingerprint:c.p.view.fingerprint});
75
+ return publicPlan(p,{canApply:true,version:c.image.version,changes:[{path:target,action:'retire_owned_image',files:c.image.manifest.length},...c.p.view.changes],conflicts:[],retained:[{path:home,reason:'user_configuration_credentials_sessions_preserved'},{path:path.join(q.root,'runtime/workspace'),reason:'tasks_and_artifacts_preserved'},{path:control,reason:'all_history_and_retired_image_preserved'},...c.p.view.retained]});
76
+ }
77
+ async function inner(r){
78
+ const f=await snapshot(path.join(state,'maintenance-transactions',r.innerId,'journal.json'),2097152);if(f.missing)bad('INNER_JOURNAL_REQUIRED');
79
+ let x;try{x=JSON.parse(bytes(f));}catch{bad('INNER_JOURNAL_REVIEW');}
80
+ const before=new Map(r.beforeMetadata.rows);
81
+ if(x.schema!==2||x.id!==r.innerId||x.action!=='uninstall'||x.fingerprint!==r.innerFingerprint||x.afterManifest!==null||hash(x.beforeManifest)!==hash(before.get(path.join(state,'installed.json')))||hash(x.beforeLatest)!==hash(before.get(path.join(state,'latest.json')))||!Array.isArray(x.items)||hash(x.items.map(op))!==hash(r.operations))bad('INNER_JOURNAL_REVIEW');
82
+ const svc=createOnboardingMaintenance(config,options),s=await svc.status({id:r.innerId});return {x,s,svc};
83
+ }
84
+ async function result(r){
85
+ const v=await inner(r),live=await v.svc.status();if(live.canRecover)bad('INNER_RECOVERY_REQUIRED');
86
+ if(v.s.state==='rolled_back'){
87
+ for(const i of r.operations){const s=await snapshot(i.path);if(i.before.missing?!s.missing:s.missing||s.sha256!==i.before.sha256||s.mode!==i.before.mode)bad('RESTORE_REVIEW');}
88
+ const m=await metadata();if(m.contentHash!==r.beforeMetadata.contentHash)bad('RESTORE_REVIEW');
89
+ return {state:'rolled_back',metadata:m};
90
+ }
91
+ if(v.s.state!=='committed'||live.state!=='uninstalled'||live.id!==r.innerId)bad('INNER_RECOVERY_REQUIRED');
92
+ for(const [n,i] of r.operations.entries()){
93
+ const s=await snapshot(i.path),published=v.x.items[n].published;
94
+ if(i.after===null?!s.missing:s.missing||s.sha256!==i.afterHash||s.mode!==i.before.mode||!published||s.ino!==published.ino||s.dev!==published.dev)bad('RULES_DRIFT');
95
+ }
96
+ return {state:'uninstalled'};
97
+ }
98
+ async function update(d,r,values){Object.assign(r,values,{updatedAt:now()});await save(file,d);}
99
+ async function finish(d,r){
100
+ await guard();const state=await result(r),where=await location(r);
101
+ if(state.state==='rolled_back'){
102
+ if(where!=='installed')bad('RESTORE_REVIEW');await update(d,r,{state:'rolled_back',restoredMetadataHash:state.metadata.hash});return view(r,{historical:false});
103
+ }
104
+ if(r.state==='intent')await update(d,r,{state:'rules_removed'});
105
+ await api.uninstallHook?.('rules_removed');
106
+ if(where==='installed'){
107
+ await update(d,r,{state:'capturing'});await guard();await imageAt(target,r.image);if(await exists(retired))bad('IMAGE_DRIFT');
108
+ await api.uninstallHook?.('before_capture');await moveImage(target,retired);await syncDirectory(path.dirname(target));await syncDirectory(path.dirname(retired));await api.uninstallHook?.('after_capture');
109
+ }
110
+ await guard();if(await location(r)!=='retired')bad('IMAGE_DRIFT');await result(r);
111
+ await update(d,r,{state:'committed'});await api.uninstallHook?.('after_commit');return view(r,{historical:false});
112
+ }
113
+ async function apply(a){
114
+ if(!exact(a,['id','fingerprint','confirm'])||a.confirm!==true||!uuid(a.id)||!hex(a.fingerprint))bad('CONFIRMATION_REQUIRED');
115
+ await guard();const d=await ledger(),prior=d.records.find(r=>r.id===a.id);
116
+ if(prior){if(a.fingerprint!==prior.fingerprint)bad('PLAN_DRIFT');return view(prior,{notResent:true});}
117
+ const p=await plan(a,'apply'),c=await preflight();
118
+ if(c.blocked||hash(c.image)!==p.imageHash||c.owner.metadata.hash!==p.metadataHash||c.owner.ledgerHash!==p.artifactLedgerHash||c.p.view.fingerprint!==p.innerFingerprint)bad('PLAN_DRIFT');
119
+ if(d.records.length>=16)bad('HISTORY_LIMIT');const svc=createOnboardingMaintenance(config,options),v=await svc.preview({action:'uninstall'});
120
+ if(!v.canApply||v.fingerprint!==p.innerFingerprint)bad('PLAN_DRIFT');
121
+ const r={id:p.id,fingerprint:p.fingerprint,state:'intent',image:c.image,beforeMetadata:c.owner.metadata,artifactLedgerHash:c.owner.ledgerHash,innerId:v.id,innerFingerprint:v.fingerprint,operations:c.p.operations.map(op),restoredMetadataHash:null,updatedAt:now()};d.records.push(r);await save(file,d);
122
+ await api.uninstallHook?.('intent_saved');await guard();await imageAt(target,r.image);
123
+ await svc.apply({id:v.id,fingerprint:v.fingerprint,confirm:true});await api.uninstallHook?.('rules_returned');
124
+ return finish(d,r);
125
+ }
126
+ async function recoveryState(r){
127
+ await guard();const where=await location(r),lock=await snapshot(path.join(state,'lock.json'),2097152);
128
+ // A missing inner journal alone is never evidence of non-execution. Only the
129
+ // pre-call outer phase, absence of both lock AND transaction directory, and
130
+ // exact original file/metadata identities can authorize a separate cancellation.
131
+ const innerDir=path.join(state,'maintenance-transactions',r.innerId);
132
+ if(r.state==='intent'&&where==='installed'&&lock.missing&&!await exists(innerDir)){
133
+ const m=await metadata();if(m.hash!==r.beforeMetadata.hash)bad('INNER_JOURNAL_REQUIRED');
134
+ for(const i of r.operations)if(hash(await snapshot(i.path))!==hash(i.before))bad('INNER_JOURNAL_REQUIRED');
135
+ return {where,innerState:'not_observed',metadataHash:m.hash,recovery:{action:'cancel_proven_unstarted_uninstall'}};
136
+ }
137
+ const v=await inner(r);
138
+ const recovery=lock.missing?null:await v.svc.recoveryPreview({id:r.innerId});
139
+ if(!recovery)await result(r);
140
+ return {where,innerState:v.s.state,innerJournalHash:hash(v.x),lockHash:hash(lock),recovery:recovery?{id:recovery.id,fingerprint:recovery.fingerprint,action:recovery.action,state:recovery.state}:null};
141
+ }
142
+ async function recoveryPreview(a){
143
+ if(!exact(a,['id'])||!uuid(a.id))bad('ARGUMENTS');const d=await ledger(),r=d.records.at(-1);if(!r||r.id!==a.id||terminal(r))bad('RECOVERY_REQUIRED');
144
+ const s=await recoveryState(r),p=await writePlan({kind:'recover',targetId:r.id,recordHash:hash(r),observationHash:hash(s)});
145
+ return publicPlan(p,{transactionId:r.id,action:s.recovery?.action??'finish_recorded_uninstall',confirmRequired:true});
146
+ }
147
+ async function recover(a){
148
+ const p=await plan(a,'recover'),d=await ledger(),r=d.records.at(-1);if(!r||r.id!==p.targetId||hash(r)!==p.recordHash||terminal(r))bad('PLAN_DRIFT');
149
+ const s=await recoveryState(r);if(hash(s)!==p.observationHash)bad('PLAN_DRIFT');
150
+ if(s.recovery?.action==='cancel_proven_unstarted_uninstall'){
151
+ await update(d,r,{state:'rolled_back',restoredMetadataHash:s.metadataHash});return view(r,{historical:false,cancelledBeforeInnerAction:true});
152
+ }
153
+ if(s.recovery){const v=await inner(r),fresh=await v.svc.recoveryPreview({id:r.innerId});if(fresh.fingerprint!==s.recovery.fingerprint)bad('PLAN_DRIFT');await v.svc.recover({id:r.innerId,fingerprint:fresh.fingerprint,confirm:true});}
154
+ return finish(d,r);
155
+ }
156
+ async function status(a={}){if(!exact(a,[])&&!exact(a,['id'])||a.id!==undefined&&!uuid(a.id))bad('ARGUMENTS');const d=await ledger(),r=a.id?d.records.find(r=>r.id===a.id):d.records.at(-1);if(a.id&&!r)bad('NOT_FOUND');return view(r);}
157
+ async function reclamationProof(){
158
+ // The reclamation caller separately verifies the stopped runtime and immutable
159
+ // deletion ownership. Later user rule/data edits do not invalidate a completed
160
+ // historical uninstall and must not be read into deletion ownership.
161
+ const r=(await ledger()).records.at(-1);
162
+ if(!r||r.state!=='committed')bad('NOT_COMPLETED');
163
+ if(await location(r)!=='retired')bad('RESULT_REVIEW');
164
+ return view(r);
165
+ }
166
+ return {preview,apply,status,recoveryPreview,recover,assertOpen,restored,reclamationProof};
167
+ }
@@ -0,0 +1,138 @@
1
+ // Operator-only version RPC. Package bytes come from our installed distribution,
2
+ // never from RPC paths/URLs. Durable intents precede SSH and survive re-creation.
3
+ import path from 'node:path';
4
+ import {randomUUID} from 'node:crypto';
5
+ import {credentialKey} from '@deepseek-ai/dsh-credentials';
6
+ import {cloudPackage} from './onboarding-cloud-package.js';
7
+ import {validateVersionCandidatePackage} from './onboarding-version-candidate.js';
8
+ import {fs,hash,ancestors,snapshot,bytes,syncWrite} from './onboarding-install-fs.js';
9
+ import {syncDirectory} from './onboarding-maintenance-fs.js';
10
+ import {runtimeProgram,runtimeCommand} from './onboarding-runtime-program.js';
11
+ const fail=c=>{throw Error('ONBOARDING_CLOUD_VERSION_'+c);},digest=x=>hash(JSON.stringify(x));
12
+ const exact=(v,k)=>v&&typeof v==='object'&&!Array.isArray(v)&&Object.keys(v).sort().join()===k.slice().sort().join();
13
+ const uuid=x=>typeof x==='string'&&/^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/.test(x);
14
+ const hex=x=>typeof x==='string'&&/^[a-f0-9]{64}$/.test(x),ver=x=>typeof x==='string'&&x.length<100&&/^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(x);
15
+ export const versionRecordKey=id=>credentialKey('dsh-task-gateway','onboarding-runtime-version-v1-'+id);
16
+ const mutations=['receive','apply','recover','rollback'];
17
+ const resource=r=>(r.action==='receive'?'candidate:':'version:')+r.targetId;
18
+ export function versionPending(p){
19
+ const last=new Map((p?.requests??[]).filter(r=>r.receipt?.state!=='refused').map(r=>[resource(r),r]));
20
+ return [...last.values()].some(r=>r.state==='requested'||r.receipt?.recoveryRequired===true&&!(r.action==='receive'&&r.receipt.state==='needs_review'));
21
+ }
22
+ export function parseVersionRequest(record,operationId){
23
+ if(!record)return null;const p=record.payload;
24
+ if(record.kind!=='grant'||!exact(p,['schema','operationId','runtimeId','binding','revision','candidates','plans','requests'])||p.schema!==1||p.operationId!==operationId||!uuid(p.runtimeId)||!hex(p.binding)||!Number.isSafeInteger(p.revision)||p.revision<1||!Array.isArray(p.candidates)||p.candidates.length>16||!Array.isArray(p.plans)||p.plans.length>128||!Array.isArray(p.requests)||p.requests.length>128||Buffer.byteLength(JSON.stringify(p))>262144)fail('LOCAL_LEDGER_REVIEW');
25
+ const seen=new Set();for(const c of p.candidates){if(!exact(c,['id','fingerprint','manifestHash','archiveHash','version','bytes','files','expiresAt'])||!uuid(c.id)||seen.has(c.id)||![c.fingerprint,c.manifestHash,c.archiveHash].every(hex)||!ver(c.version)||!Number.isSafeInteger(c.bytes)||c.bytes<0||c.bytes>8388608||!Number.isSafeInteger(c.files)||c.files<1||c.files>512||!Number.isSafeInteger(c.expiresAt))fail('LOCAL_LEDGER_REVIEW');seen.add(c.id);}
26
+ const plans=new Set();for(const v of p.plans){if(!exact(v,['id','kind','targetId','candidateId','fingerprint','expiresAt','fromVersion','toVersion'])||!uuid(v.id)||plans.has(v.id)||!['apply','rollback','recover'].includes(v.kind)||!uuid(v.targetId)||v.candidateId!==null&&!seen.has(v.candidateId)||!hex(v.fingerprint)||!Number.isSafeInteger(v.expiresAt)||![v.fromVersion,v.toVersion].every(ver))fail('LOCAL_LEDGER_REVIEW');plans.add(v.id);}
27
+ const ids=new Set();for(const r of p.requests){if(!exact(r,['key','action','planId','targetId','fingerprint','state','receipt'])||!mutations.includes(r.action)||!uuid(r.planId)||!uuid(r.targetId)||r.key!==r.action+':'+r.planId||ids.has(r.key)||!hex(r.fingerprint)||!['requested','observed'].includes(r.state)||r.state==='requested'&&r.receipt!==null||r.state==='observed'&&(!r.receipt||r.receipt.id!==r.targetId||r.receipt.operationId!==p.operationId||r.receipt.runtimeId!==p.runtimeId||typeof r.receipt.recoveryRequired!=='boolean'||typeof r.receipt.state!=='string'))fail('LOCAL_LEDGER_REVIEW');ids.add(r.key);}
28
+ for(const v of p.plans)if(v.kind==='apply'?(v.id!==v.targetId||!seen.has(v.candidateId)):(v.candidateId!==null||!p.plans.some(x=>x.kind==='apply'&&x.targetId===v.targetId)))fail('LOCAL_LEDGER_REVIEW');
29
+ for(const r of p.requests){
30
+ const v=r.action==='receive'?p.candidates.find(x=>x.id===r.planId):p.plans.find(x=>x.id===r.planId&&x.kind===r.action);
31
+ if(!v||v.fingerprint!==r.fingerprint||(r.action==='receive'?v.id:v.targetId)!==r.targetId)fail('LOCAL_LEDGER_REVIEW');
32
+ const receipt=r.receipt;if(!receipt)continue;
33
+ if(receipt.hostStarted!==false||receipt.activationVerified!==false)fail('LOCAL_LEDGER_REVIEW');
34
+ if(receipt.state==='refused'){if(receipt.recoveryRequired!==false)fail('LOCAL_LEDGER_REVIEW');continue;}
35
+ const states=r.action==='receive'?['receiving','ready','needs_review']:['preparing','applying','committed','rolling_back','rolled_back','needs_review'];
36
+ if(receipt.contract!==1||!states.includes(receipt.state)||receipt.recoveryRequired!==!(r.action==='receive'?['ready']:['committed','rolled_back']).includes(receipt.state))fail('LOCAL_LEDGER_REVIEW');
37
+ }
38
+ return p;
39
+ }
40
+ export async function runtimeVersionClient({args,p,a,b,runtimeId,credentials,ssh,localState,source,now=Date.now}){
41
+ const fields={record:[],candidate_preview:[],receive:['id','fingerprint','confirm'],candidate_status:['id'],preview:['candidateId'],apply:['id','fingerprint','confirm'],status:['id'],recover_preview:['id'],recover:['id','fingerprint','confirm'],rollback_preview:['id'],rollback:['id','fingerprint','confirm']};
42
+ const action=args?.action;
43
+ if(!Object.hasOwn(fields,action)||!exact(args,['action','operationId',...fields[action]])||args.operationId!==p.id||['id','candidateId'].some(k=>Object.hasOwn(args,k)&&!uuid(args[k]))||mutations.includes(action)&&(args.confirm!==true||!hex(args.fingerprint)))fail('CONFIRMATION_REQUIRED');
44
+ const key=versionRecordKey(p.id),c=credentials(),binding=digest({operationId:p.id,archiveHash:p.archiveHash,bindingFingerprint:p.bindingFingerprint});
45
+ let ledger=parseVersionRequest(await c.readRecord(key),p.id);
46
+ if(ledger&&(ledger.binding!==binding||runtimeId&&ledger.runtimeId!==runtimeId))fail('BINDING_CHANGED');
47
+ const decode=n=>{const f=a.files.find(f=>f.path==='plugin/'+n);if(!f)fail('ARCHIVE_REVIEW');return Buffer.from(f.data,'base64');};
48
+ const compat=JSON.parse(decode('compatibility.json')),supported=compat.onboardingPluginVersion===1&&compat.onboardingPluginVersionRequests===1;
49
+ if(action==='record')return {operationId:p.id,supported,cached:true,historical:true,pending:versionPending(ledger),runtimeId:ledger?.runtimeId??runtimeId??null,candidates:ledger?.candidates??[],plans:ledger?.plans??[],requests:ledger?.requests.map(r=>({...r,receipt:r.receipt?{...r.receipt,cached:true,historical:true}:null}))??[],initialization:false,hostStarted:false,activationVerified:false};
50
+ if(!supported)fail('UNSUPPORTED');if(!uuid(runtimeId))fail('RUNTIME_RECORD_REQUIRED');
51
+ const empty={schema:1,operationId:p.id,runtimeId,binding,revision:0,candidates:[],plans:[],requests:[]};
52
+ const current=()=>ledger??empty;
53
+ async function save(next){
54
+ const old=ledger,value={...next,revision:(ledger?.revision??0)+1};parseVersionRequest({kind:'grant',payload:value},p.id);
55
+ await c.modifyRecord(key,record=>{if(JSON.stringify(parseVersionRequest(record,p.id))!==JSON.stringify(old))fail('LOCAL_CONFLICT');return {kind:'grant',payload:value};});ledger=value;
56
+ }
57
+ const cached=r=>({operationId:p.id,runtimeId,initialization:false,hostStarted:false,activationVerified:false,...(r.receipt??{id:r.targetId,state:'version_outcome_unknown',recoveryRequired:true}),requestState:r.state,notResent:true,cached:true,historical:true});
58
+ const prior=mutations.includes(action)?current().requests.find(r=>r.key===action+':'+args.id):null;
59
+ if(prior){if(prior.fingerprint!==args.fingerprint)fail('PLAN_DRIFT');return cached(prior);}
60
+ const pending=versionPending(ledger),last=id=>current().requests.filter(r=>r.targetId===id&&r.action!=='receive'&&r.receipt?.state!=='refused').at(-1);
61
+ if(pending&&!['candidate_status','status','recover_preview','recover'].includes(action))fail('RECOVERY_REQUIRED');
62
+ if(['recover_preview','recover'].includes(action)&&current().requests.some(r=>r.state==='requested'))fail('OUTCOME_UNKNOWN');
63
+ const original={package:JSON.parse(decode('package.json')),compatibility:compat,lock:JSON.parse(decode('package-lock.json')),files:new Map(a.files.map(f=>[f.path,f]))};
64
+ const candidateFile=id=>path.join(localState,'cloud',p.id,'version-candidates',id,'package.json');
65
+ if(action==='candidate_preview'){
66
+ if(current().candidates.length>=16)fail('HISTORY_FULL');
67
+ const pkg=await cloudPackage(source),checked=validateVersionCandidatePackage(pkg.files,pkg.manifestHash,original),data=JSON.stringify({files:pkg.files,manifestHash:pkg.manifestHash}),id=randomUUID(),file=candidateFile(id);
68
+ await ancestors(path.dirname(file));await fs.mkdir(path.dirname(file),{recursive:true,mode:0o700});await ancestors(path.dirname(file));await syncWrite(file,data);await syncDirectory(path.dirname(file));
69
+ const plan={id,manifestHash:pkg.manifestHash,archiveHash:hash(data),version:checked.version,bytes:checked.total,files:checked.manifest.length,expiresAt:now()+300000};plan.fingerprint=digest({binding,runtimeId,...plan});
70
+ await save({...current(),candidates:[...current().candidates,plan]});
71
+ return {...plan,operationId:p.id,runtimeId,scope:'candidate_files_only',requiresConfirmation:true,remoteContacted:false,runtimeChanged:false,hostStarted:false,initialization:false,activationVerified:false};
72
+ }
73
+ const candidate=current().candidates.find(x=>x.id===(args.candidateId??args.id));
74
+ const plan=current().plans.find(x=>x.id===args.id&&x.kind===action);
75
+ let remoteAction=action,remoteArgs,targetId=args.id,request;
76
+ if(action==='receive'){
77
+ if(!candidate||candidate.fingerprint!==args.fingerprint||candidate.expiresAt<=now())fail('PLAN_EXPIRED');
78
+ const s=await snapshot(candidateFile(candidate.id),12582912);if(s.missing||s.sha256!==candidate.archiveHash)fail('CANDIDATE_DRIFT');const pkg=JSON.parse(bytes(s));validateVersionCandidatePackage(pkg.files,pkg.manifestHash,original);
79
+ if(pkg.manifestHash!==candidate.manifestHash)fail('CANDIDATE_DRIFT');remoteArgs={id:candidate.id,manifestHash:pkg.manifestHash,files:pkg.files,confirm:true};
80
+ }else if(action==='candidate_status'){
81
+ if(!candidate)fail('CANDIDATE_UNKNOWN');remoteArgs={id:args.id};
82
+ }else if(action==='preview'){
83
+ const received=current().requests.find(r=>r.action==='receive'&&r.targetId===args.candidateId);if(!candidate||received?.state!=='observed'||received.receipt?.state!=='ready')fail('CANDIDATE_NOT_READY');targetId=args.candidateId;remoteArgs={id:targetId};
84
+ }else if(['apply','rollback','recover'].includes(action)){
85
+ if(!plan||plan.fingerprint!==args.fingerprint||plan.expiresAt<=now())fail('PLAN_EXPIRED');targetId=plan.targetId;
86
+ if(action==='recover'&&(!last(targetId)||last(targetId).receipt?.recoveryRequired!==true))fail('RECOVERY_REQUIRED');
87
+ remoteArgs=action==='rollback'?{id:targetId,planId:plan.id,fingerprint:plan.fingerprint,confirm:true}:action==='recover'?{id:targetId,confirm:true}:{id:plan.id,fingerprint:plan.fingerprint,confirm:true};
88
+ }else{
89
+ if(!current().plans.some(v=>v.kind==='apply'&&v.targetId===args.id))fail('TRANSACTION_UNKNOWN');
90
+ remoteAction=action==='rollback_preview'?'previewRollback':'status';remoteArgs={id:args.id};
91
+ }
92
+ const program=runtimeProgram(decode('onboarding-remote-control.js').toString(),decode('onboarding-runtime-extension.js').toString()),command=runtimeCommand(a.baseline.node.path,program,'runtimeVersionCLI');
93
+ const q={action:'runtime_version',root:p.root,operationId:p.id,installationId:p.installationId,proof:p.proof,planHash:p.planHash,versionAction:remoteAction,args:remoteArgs},input=JSON.stringify(q);if(Buffer.byteLength(input)>12582912)fail('PACKAGE_LIMIT');
94
+ if(mutations.includes(action)){
95
+ if(current().requests.length>=128)fail('HISTORY_FULL');request={key:action+':'+args.id,action,planId:args.id,targetId,fingerprint:args.fingerprint,state:'requested',receipt:null};
96
+ await save({...current(),requests:[...current().requests,request]});
97
+ }
98
+ let result;try{result=JSON.parse(await ssh.execute(b,command,input,{timeoutMs:120000}));}catch{fail('OUTCOME_UNKNOWN');}
99
+ if(result?.ok!==true){
100
+ // These validations precede any image operation in the archived controller.
101
+ if(request&&['ONBOARDING_CLOUD_RUNTIME_VERSION_PREFLIGHT_REFUSED','ONBOARDING_CLOUD_RUNTIME_VERSION_PLAN_DRIFT','ONBOARDING_CLOUD_RUNTIME_VERSION_CONFIRMATION_REQUIRED'].includes(result?.error)){
102
+ const receipt={operationId:p.id,runtimeId,id:targetId,state:'refused',recoveryRequired:false,scope:action==='receive'?'candidate_files_only':'stopped_owned_plugin_image_only',hostStarted:false,activationVerified:false};
103
+ await save({...current(),requests:current().requests.map(r=>r.key===request.key?{...r,state:'observed',receipt}:r)});
104
+ }
105
+ throw Error(typeof result?.error==='string'&&/^ONBOARDING_CLOUD_[A-Z_]{1,100}$/.test(result.error)?result.error:'ONBOARDING_CLOUD_VERSION_RESPONSE_REVIEW');
106
+ }
107
+ const v=result.value;
108
+ if(!v||v.operationId!==p.id||v.runtimeId!==runtimeId||v.initialization!==false||v.hostStarted!==false||v.activationVerified!==false)fail('RESPONSE_REVIEW');
109
+ if(['preview','rollback_preview'].includes(action)){
110
+ if(!uuid(v.id)||!hex(v.fingerprint)||!Number.isSafeInteger(v.expiresAt)||v.expiresAt<=now()||v.expiresAt>now()+301000||![v.fromVersion,v.toVersion].every(ver)||v.scope!=='stopped_owned_plugin_image_only'||action==='preview'&&v.toVersion!==candidate.version||action==='rollback_preview'&&v.transactionId!==args.id)fail('RESPONSE_REVIEW');
111
+ if(action==='preview'&&(!Array.isArray(v.changes)||v.changes.length>1024||v.changes.some(x=>!exact(x,['path','action'])||typeof x.path!=='string'||x.path.length>240||!['add','remove','replace'].includes(x.action))))fail('RESPONSE_REVIEW');
112
+ if(current().plans.length>=128||current().plans.some(x=>x.id===v.id))fail('HISTORY_FULL');
113
+ const next={id:v.id,kind:action==='preview'?'apply':'rollback',targetId:action==='preview'?v.id:args.id,candidateId:action==='preview'?args.candidateId:null,fingerprint:v.fingerprint,expiresAt:v.expiresAt,fromVersion:v.fromVersion,toVersion:v.toVersion};
114
+ await save({...current(),plans:[...current().plans,next]});return {...v,cached:false};
115
+ }
116
+ let receipt;
117
+ if(['receive','candidate_status'].includes(action)){
118
+ if(v.contract!==1||v.id!==candidate.id||v.manifestHash!==candidate.manifestHash||v.version!==candidate.version||v.files!==candidate.files||v.bytes!==candidate.bytes||v.scope!=='candidate_files_only'||v.runtimeChanged!==false||!['receiving','ready','needs_review'].includes(v.state)||v.recoveryRequired!==(v.state!=='ready'))fail('RESPONSE_REVIEW');
119
+ receipt={operationId:p.id,runtimeId,contract:1,id:v.id,state:v.state,manifestHash:v.manifestHash,version:v.version,files:v.files,bytes:v.bytes,scope:v.scope,runtimeChanged:false,recoveryRequired:v.recoveryRequired,hostStarted:false,initialization:false,activationVerified:false};
120
+ }else{
121
+ const base=current().plans.find(x=>x.kind==='apply'&&x.targetId===targetId);
122
+ if(!base||v.contract!==1||v.id!==targetId||!['preparing','applying','committed','rolling_back','rolled_back','needs_review'].includes(v.state)||v.fromVersion!==base.fromVersion||v.toVersion!==base.toVersion||v.scope!=='stopped_owned_plugin_image_only'||v.recoveryRequired!==!['committed','rolled_back'].includes(v.state))fail('RESPONSE_REVIEW');
123
+ receipt={operationId:p.id,runtimeId,contract:1,id:v.id,state:v.state,fromVersion:v.fromVersion,toVersion:v.toVersion,scope:v.scope,recoveryRequired:v.recoveryRequired,hostStarted:false,initialization:false,activationVerified:false,threeArtifactMaintenancePending:true};
124
+ }
125
+ if(action==='recover_preview'){
126
+ if(!receipt.recoveryRequired||!last(args.id))fail('RECOVERY_REQUIRED');if(current().plans.length>=128)fail('HISTORY_FULL');
127
+ const next={id:randomUUID(),kind:'recover',targetId:args.id,candidateId:null,expiresAt:now()+300000,fromVersion:receipt.toVersion,toVersion:receipt.fromVersion};next.fingerprint=digest({binding,runtimeId,...next});
128
+ await save({...current(),plans:[...current().plans,next]});return {...next,operationId:p.id,runtimeId,scope:'stopped_owned_plugin_image_only',initialization:false,hostStarted:false,activationVerified:false,requiresConfirmation:true};
129
+ }
130
+ const relevant=request??(action==='candidate_status'?current().requests.find(r=>r.action==='receive'&&r.targetId===targetId):last(targetId));
131
+ if(relevant){
132
+ // Old committed state cannot settle an unknown rollback/recovery request.
133
+ const matches=relevant.state==='observed'||relevant.action==='receive'&&['ready','needs_review'].includes(receipt.state)||relevant.action==='apply'||['recover','rollback'].includes(relevant.action)&&receipt.state==='rolled_back'||request===relevant;
134
+ if(matches)await save({...current(),requests:current().requests.map(r=>r.key===relevant.key?{...r,state:'observed',receipt}:r)});
135
+ else return {...receipt,state:'version_outcome_unknown',observedState:receipt.state,requestState:'requested',notResent:true,historical:true};
136
+ }
137
+ return {...receipt,cached:false,historical:action.endsWith('status')};
138
+ }
@@ -0,0 +1,145 @@
1
+ // Original verified archive only. Candidate code is data here, never imported.
2
+ import {createRequire} from 'node:module';
3
+ import {createPluginVersion} from './onboarding-plugin-version.js';
4
+ import {createExclusiveRename} from './onboarding-exclusive-rename.js';
5
+ import {createVersionCandidates} from './onboarding-version-candidate.js';
6
+ import {createRuntimeActivation} from './onboarding-runtime-activation.js';
7
+ export async function dispatchRuntimeVersion(api,q,io={}){
8
+ const {fail,cleanupRead,runtimeRecord,runtimeLock}=api,exact=(x,keys)=>x&&typeof x==='object'&&!Array.isArray(x)&&Object.keys(x).sort().join()===keys.slice().sort().join();
9
+ const keys={uninstall_preview:[],uninstall_apply:['id','fingerprint','confirm'],uninstall_status:['id'],uninstall_recoveryPreview:['id'],uninstall_recover:['id','fingerprint','confirm'],rules_preview:[],rules_apply:['id','fingerprint','confirm'],rules_status:['id'],rules_recoveryPreview:['id'],rules_recover:['id','fingerprint','confirm'],receive:['id','manifestHash','files','confirm'],candidate_status:['id'],preview:['id'],apply:['id','fingerprint','confirm'],status:['id'],recover:['id','confirm'],previewRollback:['id'],rollback:['id','planId','fingerprint','confirm']};
10
+ Object.assign(keys,{activation_verify:['id'],activation_status:['id'],reclaim_worker:['id','planHash'],reclaim_preview:[],reclaim_apply:['id','fingerprint','confirm'],reclaim_status:[],reclaim_recoveryPreview:[],reclaim_recover:['id','fingerprint','confirm']});
11
+ if(!exact(q,['action','root','operationId','installationId','proof','planHash','versionAction','args'])||q.action!=='runtime_version'||!Object.hasOwn(keys,q.versionAction)||!exact(q.args,keys[q.versionAction])&&!(q.versionAction==='uninstall_status'&&exact(q.args,[])))fail('ARGUMENTS');
12
+ let entered=false,ready=false;const launches=[];
13
+ const invoke=async()=>{entered=true;if(await cleanupRead(q))fail('RUNTIME_CLEANUP_RECOVERY_REQUIRED');const service=await createRuntimeVersion({...api,...io,deferReclaimStart:handle=>launches.push(handle)},q,await runtimeRecord(q));ready=true;return service.action(q.versionAction,q.args);};
14
+ try{
15
+ // Signed read-only reclamation snapshots must remain observable while a
16
+ // deletion worker holds the exclusive owner lock. They never advance work.
17
+ const result=q.versionAction==='reclaim_status'?await invoke():await(io.lock??runtimeLock)(q,invoke);
18
+ for(const h of launches)h.start();return result;
19
+ }catch(e){for(const h of launches)h.cancel();if(!entered||!ready)fail('RUNTIME_VERSION_PREFLIGHT_REFUSED');throw e;}
20
+
21
+ }
22
+ export async function createRuntimeVersion(api,q,j){
23
+ const {fs,path,hash,fail,regular,runtimeSource,runtimeRecord,runtimeAlive,runtimeStopLedger,runtimeInventory,runtimeBaseInventory}=api;
24
+ const source=await runtimeSource(q),read=async n=>JSON.parse((await regular(path.join(q.root,'plugin',n),4194304)).data),compat=await read('compatibility.json');
25
+ if(compat.onboardingPluginVersion!==1)fail('RUNTIME_VERSION_UNSUPPORTED');
26
+ if(!j?.inventoryHash||!j.nativeReceipt?.ok)fail('RUNTIME_VERSION_NOT_READY');
27
+ const original=await runtimeBaseInventory(q,j),pkg=await read('package.json'),isPlugin=p=>p==='runtime/plugin'||p.startsWith('runtime/plugin/');
28
+ const mutable=p=>['runtime/native-home','runtime/native-tmp','runtime/workspace'].some(x=>p===x||p.startsWith(x+'/'));
29
+ async function stopped(){
30
+ const current=await runtimeRecord(q);
31
+ if(current?.id!==j.id||current.revision!==j.revision||current.inventoryHash!==j.inventoryHash)fail('RUNTIME_VERSION_RUNTIME_CHANGED');
32
+ if(!['host_ready','failed','stopped'].includes(current.state))fail('RUNTIME_VERSION_NOT_READY');
33
+ for(const p of [current.host,current.worker,current.child,current.restart?.launcher])if(await runtimeAlive(p))fail('RUNTIME_PROCESS_ACTIVE');
34
+ await runtimeStopLedger(q,current,true);
35
+ }
36
+ async function guard(){
37
+ await stopped();
38
+ return {operationId:q.operationId,runtimeId:j.id,stopped:true,ownershipVerified:true};
39
+ }
40
+ async function outside(){await guard();const current=await runtimeInventory(q,new Set(['runtime/plugin'])),filter=x=>!isPlugin(x.path)&&!mutable(x.path);if(hash(current.filter(filter))!==hash(original.items.filter(filter)))fail('RUNTIME_VERSION_OUTSIDE_DRIFT');}
41
+ const receiver=createVersionCandidates({q,j,original:{package:pkg,compatibility:compat,lock:await read('package-lock.json'),files:new Map(source.owner.manifest.map(f=>[f.path,f]))},regular,signed:api.signed,verified:api.verified,atomicJSON:api.atomicJSON,guard,hook:api.versionHook});
42
+ let nativeMove;
43
+ async function moveImage(from,to){
44
+ // Dependencies remain the signed original runtime; importing from the
45
+ // unlinked archive's node_modules would resolve the wrong installation.
46
+ await outside();if(api.versionMove)return api.versionMove(from,to);
47
+ if(!nativeMove){const require=createRequire(path.join(q.root,'runtime/package.json')),name=require.resolve('koffi');if(!name.startsWith(path.join(q.root,'runtime/node_modules/koffi')+path.sep))fail('RUNTIME_VERSION_DEPENDENCY_REVIEW');const p=JSON.parse((await regular(path.join(q.root,'runtime/node_modules/koffi/package.json'))).data);if(p.version!=='3.1.1')fail('RUNTIME_VERSION_DEPENDENCY_REVIEW');nativeMove=createExclusiveRename(require('koffi'));}
48
+ return nativeMove(from,to);
49
+ }
50
+ const initial={version:pkg.version,manifest:source.owner.manifest.map(f=>({path:f.path.slice(7),sha256:f.sha256})),image:original.items.filter(x=>isPlugin(x.path)).map(x=>({path:x.path==='runtime/plugin'?'':x.path.slice(15),kind:x.kind,dev:x.dev,ino:x.ino,uid:x.uid,mode:x.mode,...(x.kind==='file'?{bytes:x.bytes,sha256:x.sha256}:{})}))};
51
+ const version=createPluginVersion({root:q.root,operationId:q.operationId,runtimeId:j.id,proof:q.proof,initial,exclusive:fn=>fn(),verifyOwnedStopped:guard,moveImage,hook:api.versionHook,verifyRepairCandidate:id=>receiver.release(id)});
52
+ function versionError(e){if(/^ONBOARDING_PLUGIN_VERSION_[A-Z_]+$/.test(e.message))fail('RUNTIME_VERSION_'+e.message.slice('ONBOARDING_PLUGIN_VERSION_'.length));throw e;}
53
+ async function verifiedRelease(){try{return await version.effective();}catch(e){versionError(e);}}
54
+ async function artifacts(){
55
+ if(compat.onboardingPluginVersionArtifacts!==1)fail('RUNTIME_ARTIFACTS_UNSUPPORTED');
56
+ const {createRuntimeArtifacts}=await import('./onboarding-runtime-artifacts.js');return createRuntimeArtifacts({...api,...(compat.onboardingPluginUninstall===1?{uninstallRestored:async()=>(await uninstall()).restored()}:{})},q,j,{original,effective:verifiedRelease,guard:outside});
57
+ }
58
+ async function uninstall(){
59
+ if(compat.onboardingPluginUninstall!==1||compat.onboardingPluginVersionLifecycle!==1||compat.onboardingPluginVersionArtifacts!==1)fail('RUNTIME_UNINSTALL_UNSUPPORTED');
60
+ const {createRuntimeUninstall}=await import('./onboarding-runtime-uninstall.js');return createRuntimeUninstall(api,q,j,{current:verifiedRelease,guard:outside,moveImage,artifacts});
61
+ }
62
+ async function reclamation(){
63
+ if(compat.onboardingRuntimeReclamation!==1)fail('RUNTIME_RECLAIM_UNSUPPORTED');
64
+ const {createRuntimeReclamation}=await import('./onboarding-runtime-reclaim.js');
65
+ return createRuntimeReclamation(api,q,j,{background:compat.onboardingRuntimeReclamationWorker===1,prerequisite:async()=>(await uninstall()).reclamationProof()});
66
+ }
67
+ async function reclaimGate(){
68
+ const marker=path.join(q.root,'.control/runtime/runtime-reclaim.json');await api.checkAncestors(path.dirname(marker));
69
+ try{await fs.lstat(marker);}catch(e){if(e.code==='ENOENT')return null;throw e;}
70
+ const r=await(await reclamation()).status();
71
+ if(q.action!=='runtime_status')fail('RUNTIME_RECLAIM_RESTART_BLOCKED');
72
+ return {state:r.state==='committed'?'runtime_reclaimed':'reclamation_needs_review',runtimeInstalled:false,nativeHostReady:false,managedRestartBlocked:true,reclamation:r};
73
+ }
74
+ function view(v){return {...v,operationId:q.operationId,runtimeId:j.id,initialization:false,automaticRetry:false,activationVerified:false,threeArtifactMaintenancePending:true};}
75
+ async function action(name,args){
76
+ try{
77
+ if(name.startsWith('reclaim_'))return await(await reclamation())[name.slice(8)](args);
78
+ await reclaimGate();
79
+ if(name.startsWith('uninstall_'))return await (await uninstall())[name.slice(10)](args);
80
+ if(compat.onboardingPluginUninstall===1&&!['status','candidate_status','rules_status'].includes(name))await (await uninstall()).assertOpen();
81
+ if(name.startsWith('activation_'))return await activation(name,args);
82
+ if(!['status','candidate_status','rules_status'].includes(name))try{await outside();}catch{fail('RUNTIME_VERSION_PREFLIGHT_REFUSED');}
83
+ if(name.startsWith('rules_'))try{return await (await artifacts())[name.slice(6)](args);}catch(e){if(/^ONBOARDING_(?!CLOUD_)[A-Z_]+$/.test(e.message))fail('RUNTIME_ARTIFACTS_'+e.message.slice('ONBOARDING_'.length));throw e;}
84
+ if(compat.onboardingPluginVersionArtifacts===1&&['preview','apply','recover','previewRollback','rollback'].includes(name))await (await artifacts()).noPending();
85
+ if(name==='receive')return view(await receiver.receive(args));
86
+ if(name==='candidate_status')return view(await receiver.status(args.id));
87
+ if(name==='preview'){await guard();return view(await version.preview(await receiver.release(args.id)));}
88
+ if(!['apply','status','recover','previewRollback','rollback'].includes(name))fail('ARGUMENTS');
89
+ return view(await version[name](args));
90
+ }catch(e){versionError(e);}
91
+ }
92
+ async function activation(name,args){
93
+ if(compat.onboardingVersionActivation!==1||compat.onboardingPluginVersionArtifacts!==1)fail('RUNTIME_VERSION_ACTIVATION_UNSUPPORTED');
94
+ const binding=await version.activationBinding();
95
+ if(args.id!==binding.transactionId)fail('RUNTIME_ACTIVATION_VERSION_CHANGED');
96
+ const current=name==='activation_verify'?await effective():null;
97
+ const currentCompat=name==='activation_verify'?JSON.parse((await regular(path.join(q.root,'runtime/plugin/compatibility.json'))).data):compat;
98
+ if(name==='activation_verify'&&currentCompat.onboardingVersionActivation!==1)fail('RUNTIME_VERSION_ACTIVATION_UNSUPPORTED');
99
+ const verifier=createRuntimeActivation(api,q,j,{inventory:current?.items??[],source:{owner:{manifest:binding.release.manifest}},compat:currentCompat,
100
+ versionContext:{version:binding.release.version,imageHash:hash(binding.release),transactionId:binding.transactionId,artifactsReady:async()=>(await artifacts()).ready()},
101
+ versionSubject:{state:binding.state,historyHash:binding.historyHash,stillCurrent:async()=>hash(await version.activationBinding())===hash(binding)}});
102
+ const value=name==='activation_verify'?await verifier.verify(args.id):await verifier.status();
103
+ return {...value,operationId:q.operationId,runtimeId:j.id,initialization:false,requestedTransactionId:args.id};
104
+ }
105
+ async function effective(){
106
+ const r=await verifiedRelease(),rows=r.image.map(x=>({path:x.path?'runtime/plugin/'+x.path:'runtime/plugin',dev:x.dev,ino:x.ino,uid:x.uid,mode:x.mode,kind:x.kind,...(x.kind==='file'?{bytes:x.bytes,sha256:x.sha256}:{})}));
107
+ // Canonical original scanner order, not locale collation. Preserve every
108
+ // non-plugin row from the signed baseline; no user data is adopted.
109
+ const map=new Map(rows.map(x=>[x.path,x])),result=[];let inserted=false;
110
+ for(const row of original.items){if(isPlugin(row.path)){if(!inserted){const visit=p=>{const x=map.get(p);if(!x)fail('RUNTIME_VERSION_IMAGE_DRIFT');result.push(x);if(x.kind==='directory')for(const n of [...map.keys()].filter(n=>path.posix.dirname(n)===p).sort())visit(n);};visit('runtime/plugin');inserted=true;}}else result.push(row);}
111
+ if(!inserted)fail('RUNTIME_VERSION_IMAGE_DRIFT');return {items:result,version:r.version,originalVersion:pkg.version};
112
+ }
113
+ async function repair(){
114
+ if(compat.onboardingVersionRepair!==1||compat.onboardingPluginVersionLifecycle!==1)fail('RUNTIME_VERSION_REPAIR_INTERLOCK');
115
+ const name=q.action.slice(15),args={...(q.repairId?{id:q.repairId,confirm:true}:{}),...(q.fingerprint?{fingerprint:q.fingerprint}:{})};
116
+ if(!['preview','apply','status','recover','verify'].includes(name))fail('ARGUMENTS');
117
+ const activationSupported=compat.onboardingVersionRepairActivation===1&&compat.onboardingPluginVersionArtifacts===1;
118
+ if(name==='verify'&&!activationSupported)fail('RUNTIME_REPAIR_ACTIVATION_UNSUPPORTED');
119
+ try{
120
+ if(!['status','verify'].includes(name))await outside();
121
+ if(compat.onboardingPluginVersionArtifacts===1&&['preview','apply','recover'].includes(name))await (await artifacts()).noPending();
122
+ const r=await version.repair(name==='verify'?'status':name,name==='verify'?{}:args);
123
+ if(name==='preview')return {...r,activationSupported,operationId:q.operationId,runtimeId:j.id,initialization:false,repairSupported:true,ownershipRebased:false,activationVerified:false};
124
+ r.activationSupported=activationSupported&&r.activeVersionRepair;
125
+ let activation=null;
126
+ if(activationSupported&&!r.recoveryRequired&&['status','verify'].includes(name)){
127
+ const binding=await version.repairBinding(),current=name==='verify'?await effective():null;
128
+ const currentCompat=name==='verify'?JSON.parse((await regular(path.join(q.root,'runtime/plugin/compatibility.json'))).data):compat;
129
+ const verifier=createRuntimeActivation(api,q,j,{repair:binding.repair,inventory:current?.items??[],source:{owner:{manifest:binding.release.manifest}},compat:currentCompat,
130
+ versionContext:{version:binding.release.version,imageHash:hash(binding.release),transactionId:binding.versionTransactionId,artifactsReady:async()=>(await artifacts()).ready()}});
131
+ activation=name==='verify'?await verifier.verify(q.repairId):await verifier.status();
132
+ }
133
+ return {operationId:q.operationId,runtimeId:j.id,initialization:false,hostStarted:await runtimeAlive(j.host),state:'repair_'+r.state,scope:'stopped_owned_plugin_files_only',repair:r,activation,automaticRetry:false};
134
+ }catch(e){
135
+ if(/^ONBOARDING_PLUGIN_(VERSION_REPAIR|REPAIR)_[A-Z_]+$/.test(e.message))fail('RUNTIME_REPAIR_'+e.message.replace(/^ONBOARDING_PLUGIN_(VERSION_REPAIR|REPAIR)_/,''));
136
+ versionError(e);
137
+ }
138
+ }
139
+ async function uninstallGate(){
140
+ const s=await(await uninstall()).status();if(!s.managedRestartBlocked)return null;
141
+ if(q.action!=='runtime_status')fail(s.state==='committed'?'RUNTIME_UNINSTALL_ALREADY_UNINSTALLED':'RUNTIME_UNINSTALL_RECOVERY_REQUIRED');
142
+ return {state:s.state==='committed'?'plugin_uninstalled':'uninstall_needs_review',pluginInstalled:s.pluginInstalled,nativeHostReady:false,managedRestartBlocked:true,uninstall:s};
143
+ }
144
+ return {action,effective,repair,uninstallGate,reclaimGate,artifactsReady:async()=>compat.onboardingPluginVersionArtifacts===1&&(await artifacts()).ready()};
145
+ }