/** * 外部执行已证明 applied、但本地协调未完成时的恢复准备。 * 只在所有待确认请求都有 applied 证据时暂存资源/run/ledger 结果;旧回执的模型不直接发布。 * 调用者还要取完整 fresh read、验证 assertCanonical、重放 pending 并可靠发布同一 Root。 */ import type { Id } from '../canvas-core/types.ts'; import { equal, fault, freeze, readMap } from '../canvas-core/values.ts'; import type { AppliedModelProof, CanonicalProposal, EngineSnapshot, PersistencePort } from './contracts.ts'; import { createLedger, type FrozenRequest } from './ledger.ts'; import { runTerminal, type RunPort } from './runs.ts'; import type { AssetPort } from './resources.ts'; /** Stage acknowledgements only. The caller must validate a complete fresh read and durably publish it. */ /** 在私有表上解释已保存回执,返回 staged 快照与 fresh read 断言;缺证据/解释器即整体拒绝。 */ export function stageAppliedRecovery(snapshot:EngineSnapshot,ports:{persistence:PersistencePort;runs?:RunPort;assets?:AssetPort;now:number}) { const waiting=[...snapshot.runtime.ledger.requests.values()].filter(request=>request.phase!=='resolved'); // 只要还有 accepted/unresolved,就不能把整组当成确定已执行恢复,也不能新建替代请求重发。 const unknown=waiting.filter(request=>request.outcome!=='applied'); if(unknown.length)throw fault('recovery_waiting_for_receipts',unknown.map(request=>request.id)); /** 同一请求可能包含多个意图,以最早逻辑 sequence 排序,保证 run 受理先于其控制动作解释。 */ const sequence=(request:FrozenRequest)=>request.operationIds.reduce((result,id)=>Math.min(result,snapshot.runtime.ledger.operations.get(id)?.intent.sequence??Infinity),Infinity); waiting.sort((a,b)=>sequence(a)-sequence(b)); // 新建候选账本和资源/run 表,后面的任何校验失败不会污染原 snapshot。 const ledger=createLedger(snapshot.runtime.ledger),runs=new Map(snapshot.runtime.runs),resources=new Map(snapshot.runtime.resources),conflicts=new Map(snapshot.runtime.conflicts); const proofs:AppliedModelProof[]=[],runIds=new Set(); for(const request of waiting){ const receipt=snapshot.runtime.receipts.get(request.id);if(receipt===undefined)throw fault('recovery_receipt_missing',[request.id]); let proof:AppliedModelProof|undefined; // 资源回执核对逻辑资源 ID 与原字节长度;资源上传不声明 canvas 文档版本推进。 if(request.kind==='asset.upload'){ const intent=snapshot.runtime.ledger.operations.get(request.operationIds[0])?.intent,resource=intent?.operationType==='asset.upload'?resources.get(intent.resourceId):undefined; if(!ports.assets||!resource)throw fault('asset_interpreter_unavailable',[request.id]); const stored=freeze(ports.assets.accept(request,{outcome:'applied',canonical:receipt},resource)); if(stored.id!==resource.id||stored.bytes!==resource.byteLength)throw fault('asset_receipt_mismatch'); resources.set(resource.id,freeze({...resource,stored})); // run 由专用解释器验证受理/动作身份,不能把文档回执当成任务已执行证明。 }else if(['run.start','run.cancel','run.apply'].includes(request.kind??'')){ if(!ports.runs?.verifyApplied)throw fault('run_receipt_interpreter_unavailable',[request.id]); const verified=ports.runs.verifyApplied(request,receipt);proof=verified.model; // 受理必须绑定原 intent/request/board/target;已有 run 也必须具有相同身份和计划。 if(request.kind==='run.start'){ const run=verified.admission,intent=snapshot.runtime.ledger.operations.get(request.operationIds[0])?.intent; if(!run||verified.action||intent?.operationType!=='run.start'||run.operationId!==intent.id||run.requestId!==request.id||run.boardId!==intent.run.boardId||!equal(run.target,intent.run.target))throw fault('run_identity_mismatch'); const existing=runs.get(run.id); if(existing&&(existing.requestId!==run.requestId||existing.operationId!==run.operationId||!equal(existing.plan,run.plan)))throw fault('run_identity_mismatch'); if(!existing)runs.set(run.id,freeze(run));runIds.add(run.id); }else{ const action=verified.action,run=action?runs.get(action.runId):undefined; if(!action||verified.admission||action.runId!==request.runId||!run)throw fault('run_identity_mismatch'); if(request.kind==='run.cancel'){ if(!action.runStatus||action.outputId||runTerminal(run.status)&&runTerminal(action.runStatus)&&run.status!==action.runStatus)throw fault('run_status_conflict'); }else if(!action.outputId||action.runStatus)throw fault('run_identity_mismatch'); // 控制 epoch 递增阻止旧 poll 盖回新状态;标 hasMore/nextPollAt 让任务按原 ID 继续追尾。 runs.set(run.id,freeze({...run,controlEpoch:(run.controlEpoch??0)+1,...(action.runStatus?{status:action.runStatus}:{}),...(action.outputId?{appliedOutputIds:[...new Set([...(run.appliedOutputIds??[]),action.outputId])]}:{}),hasMore:true,blocked:false,error:undefined,pendingPage:undefined,nextPollAt:ports.now}));runIds.add(run.id); } }else{ if(!ports.persistence.verifyApplied)throw fault('document_receipt_interpreter_unavailable',[request.id]); proof=ports.persistence.verifyApplied(request,receipt); } // 各请求有不同写版本范围:start 只 owner,cancel/upload 无文档写,普通/apply 要完整参与者。 const writes=request.kind==='run.start'?[request.ownerCanvasId!]:request.kind==='run.cancel'||request.kind==='asset.upload'?[]:request.canvasIds; if(writes.length!==(proof?.versions.size??0)||writes.some(id=>!proof?.versions.has(id)))throw fault('receipt_coverage_mismatch',[request.id]); if(proof){for(const [canvas,version]of proof.versions)if(!Number.isSafeInteger(version)||version<=request.expectedVersions[canvas])throw fault('receipt_version_mismatch',[canvas]);proofs.push(proof);} // 仅在候选账本标已协调 applied;真正采用仍需外层 fresh read 校验和持久化。 ledger.result(request.id,'applied');conflicts.delete(request.id); } const staged:EngineSnapshot=Object.freeze({...snapshot,runtime:Object.freeze({...snapshot.runtime,ledger:ledger.getSnapshot(),runs:readMap(runs),resources:readMap(resources),conflicts:readMap(conflicts)})}); return Object.freeze({snapshot:staged,requestIds:Object.freeze(waiting.map(request=>request.id)),runIds:Object.freeze([...runIds]), /** fresh read 版本不得落后于任何执行证明,并逐个执行协议专用内容断言。 */ assertCanonical(canonical:CanonicalProposal){for(const proof of proofs){for(const [canvas,version]of proof.versions)if((canonical.versions.get(canvas)??-1)