@fps-games/editor-deployment 0.2.3-beta.4 → 0.2.3-beta.6

package/bin/fps-editor-agent.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import{randomUUID as N}from"node:crypto";import{constants as ge,createReadStream as he}from"node:fs";import{access as ve,readFile as H,realpath as Y,stat as ye}from"node:fs/promises";import b from"node:path";var He=8*1024*1024,J=128,G=256*1024;var c=Object.freeze({ok:0,usage:2,discovery:3,unavailable:4,conflict:5,execution:6,running:7,interrupted:130}),U=1024*1024,B=3e4,F=b.join(".fps-editor","state","agent-runtime.json"),X=Object.freeze({kind:"fps-editor-agent-deadline"}),q=!1,te=Number.POSITIVE_INFINITY,ne=B,T=new AbortController;process.once("SIGINT",()=>{q=!0,T.abort(),process.exitCode=c.interrupted,setTimeout(()=>process.exit(c.interrupted),25).unref?.()});we().catch(e=>{let t=q?P():me(e);I(t.result??{ok:!1,error:{code:t.code,message:t.message}}),t.log!==!1&&process.stderr.write(`[fps-editor-agent] ${t.message}
+`),process.exitCode=t.exitCode});async function we(){let e=De(process.argv.slice(2)),t=e.argv,n=e.projectRoot??process.cwd(),i=e.projectRoot!==void 0;if(ne=e.deadlineMs,te=Date.now()+e.deadlineMs,t.length===0||t.includes("--help")||t[0]==="help"){I({ok:!0,usage:Ue()});return}if(t.includes("--version")){let o=JSON.parse(await H(new URL("../package.json",import.meta.url),"utf8"));I({ok:!0,package:o.name,version:o.version,protocolVersion:2});return}let s=t.shift();if(s==="doctor"){let o=await se(n,{validateService:!1,exactProjectRoot:i}),u=await ce(o),r=await(await Q(n,{exactProjectRoot:i})).request({kind:"status"});I({ok:!0,descriptorPath:o.descriptorPath,projectRoot:o.projectRoot,checks:u,status:r.status});return}let a=await Q(n,{exactProjectRoot:i});if(s==="status"){I(await a.request({kind:"status"}));return}if(s==="commands"){await Re(a,t);return}if(s==="command"){await Se(a,t);return}if(s==="transaction"){await Oe(a,t);return}if(s==="apply"){await Ee(a,t);return}if(s==="operation"){await _e(a,t);return}if(s==="trace"){await Ae(a,t);return}throw d(`Unknown command: ${String(s)}`)}async function Re(e,t){let n=t.shift();if(n==="describe"){let o=D(t,"command id");de(t),I(await e.request({kind:"commands.describe",commandId:o}));return}let i=_(t,new Set(["--cursor","--limit"])),s=m(i.options,"--cursor"),a=R(i.options,"--limit",{minimum:1});if(n==="list"){if(i.positionals.length)throw d("commands list does not accept positional arguments.");I(await e.request({kind:"commands.list",...s?{cursor:s}:{},...a?{limit:a}:{}}));return}if(n==="search"){let o=D(i.positionals,"search query");if(i.positionals.length)throw d("commands search accepts one query.");I(await e.request({kind:"commands.search",query:o,...s?{cursor:s}:{},...a?{limit:a}:{}}));return}throw d("commands requires list, search, or describe.")}async function Se(e,t){let n=_(t,new Set(["--stdin","--input-file","--input-json","--expected-revision","--idempotency-key","--request-id","--timeout","--trace-id","--client-id"]),new Set(["--stdin"])),i=D(n.positionals,"command id");if(n.positionals.length)throw d("command accepts one command id.");let s=await ke(n.options),a=await e.request({kind:"commands.describe",commandId:i}),o=a.ok&&a.kind==="command"?a.command:null;if(!o)throw p(c.unavailable,"command.unknown",`Editor command is not registered: ${i}`);if(!o.availability.available)throw p(c.unavailable,"command.unavailable",o.availability.reasons.map(v=>v.message).join("; ")||`Editor command is unavailable: ${i}`);let u=R(n.options,"--expected-revision",{minimum:0}),l=e.serviceInstanceId;if(o.manifest.access==="write"&&u===void 0){let v=await e.request({kind:"status"});u=v.status.documentRevision,l=v.status.serviceInstanceId}let r=m(n.options,"--request-id")??N(),g=m(n.options,"--idempotency-key")??(o.manifest.access==="write"?N():void 0),y=R(n.options,"--timeout",{minimum:0}),f=await e.request({kind:"command.invoke",invocation:{commandId:i,input:s,requestId:r,...g?{idempotencyKey:g}:{},...u!==void 0?{expectedRevision:{serviceInstanceId:l,document:u}}:{},principal:{type:"agent",id:"fps-editor-agent"},source:"agent-cli",...m(n.options,"--trace-id")?{traceId:m(n.options,"--trace-id")}:{},...m(n.options,"--client-id")?{clientId:m(n.options,"--client-id")}:{}},...y!==void 0?{timeoutMs:y}:{}});I(f),j(f.operation)}async function Oe(e,t){let n=t.shift();if(n==="begin"){let o=_(t,new Set(["--expected-revision","--label","--transaction-id","--trace-id","--service-instance-id"]));if(o.positionals.length)throw d("transaction begin does not accept positional arguments.");let u=await ie(e),l=m(o.options,"--transaction-id")??N(),r=await e.request({kind:"transaction.begin",serviceInstanceId:m(o.options,"--service-instance-id")??u.serviceInstanceId,expectedDocumentRevision:R(o.options,"--expected-revision",{minimum:0})??u.documentRevision,...m(o.options,"--label")?{label:m(o.options,"--label")}:{},transactionId:l,...m(o.options,"--trace-id")?{traceId:m(o.options,"--trace-id")}:{}});I(r),k(r.transaction);return}let i=_(t,new Set(["--service-instance-id","--sequence","--stdin","--input-file","--cursor","--limit"]),new Set(["--stdin"])),s=D(i.positionals,"transaction id");if(i.positionals.length)throw d(`transaction ${String(n)} accepts one transaction id.`);let a=m(i.options,"--service-instance-id")??e.serviceInstanceId;if(n==="append"){$(i.options,new Set(["--service-instance-id","--sequence","--stdin","--input-file"]));let o=R(i.options,"--sequence",{minimum:0});o===void 0&&(o=(await e.request({kind:"transaction.get",transactionId:s,serviceInstanceId:a,limit:1})).transaction.acceptedOperations);let u,l=oe(i.options);await re({client:e,source:l,transactionId:s,serviceInstanceId:a,sequence:o,maxOperations:e.status.transactions.maxOperationsPerAppend,maxBytes:e.status.transactions.maxBytesPerAppend,onAppend(r){u=r,I(r)}}),k(u?.transaction);return}if(n==="preflight"||n==="commit"||n==="abort"){$(i.options,new Set(["--service-instance-id"]));let o=await e.request({kind:`transaction.${n}`,transactionId:s,serviceInstanceId:a});I(o),k(o.transaction,{abortedIsSuccess:n==="abort"});return}if(n==="get"){$(i.options,new Set(["--service-instance-id","--cursor","--limit"]));let o=await e.request({kind:"transaction.get",transactionId:s,serviceInstanceId:a,...m(i.options,"--cursor")?{cursor:m(i.options,"--cursor")}:{},...R(i.options,"--limit",{minimum:1})?{limit:R(i.options,"--limit",{minimum:1})}:{}});I(o),k(o.transaction);return}throw d("transaction requires begin, append, preflight, commit, get, or abort.")}async function Ee(e,t){let n=_(t,new Set(["--stdin","--input-file","--save","--expected-revision","--label","--transaction-id","--trace-id","--service-instance-id","--timeout"]),new Set(["--stdin","--save"]));if(n.positionals.length)throw d("apply does not accept positional arguments.");let i=await ie(e),s=m(n.options,"--service-instance-id")??i.serviceInstanceId,a=R(n.options,"--expected-revision",{minimum:0})??i.documentRevision,o=R(n.options,"--timeout",{minimum:0}),u=m(n.options,"--transaction-id")??N(),l=m(n.options,"--trace-id"),r,g="begin";try{r=(await e.request({kind:"transaction.begin",serviceInstanceId:s,expectedDocumentRevision:a,transactionId:u,...m(n.options,"--label")?{label:m(n.options,"--label")}:{},...l?{traceId:l}:{}})).transaction,C("begin",r),g="append";let f=oe(n.options);if(await re({client:e,source:f,transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId,sequence:r.acceptedOperations,maxOperations:i.transactions.maxOperationsPerAppend,maxBytes:i.transactions.maxBytesPerAppend,onAppend(Ie){r=Ie.transaction,C("append",r)}}),g="commit",r=(await e.request({kind:"transaction.commit",transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId})).transaction,C("commit",r),r.state!=="working_committed"){O(!1,"commit_failed",r),k(r);return}if(!n.options.has("--save")){O(!0,"working_committed",r);return}g="document.export";let h=await z(e,{commandId:"document.export",input:{},expectedDocumentRevision:r.workingDocumentRevision,serviceInstanceId:r.serviceInstanceId,transactionId:r.transactionId,traceId:l,timeoutMs:o});if(W("document.export",r,h.operation),h.operation?.status==="accepted"||h.operation?.status==="running"){O(!1,"awaiting_export_operation",r,{operation:E(h.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=c.running;return}if(h.operation?.status!=="completed"){O(!1,"save_failed",r,{operation:E(h.operation),allowedActions:["command document.export","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),j(h.operation);return}let w=h.operation.output;if(!w||typeof w!="object"||Array.isArray(w))throw p(c.execution,"document.exportReceiptInvalid","document.export returned an invalid receipt.");if(w.persistedByEditor===!1){O(!1,"awaiting_persistence_confirmation",r,{operation:E(h.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=c.running;return}let x=typeof w.transactionId=="string"&&w.transactionId.trim()?w.transactionId:null;if(!x)throw p(c.execution,"document.exportReceiptInvalid","document.export receipt is missing transactionId.");g="document.commit";let fe=Number.isSafeInteger(w.documentRevision)?w.documentRevision:r.workingDocumentRevision,S=await z(e,{commandId:"document.commit",input:{transactionId:x},expectedDocumentRevision:fe,serviceInstanceId:r.serviceInstanceId,transactionId:r.transactionId,traceId:l,timeoutMs:o});if(W("document.commit",r,S.operation),S.operation?.status==="accepted"||S.operation?.status==="running"){O(!1,"awaiting_commit_operation",r,{saveTransactionId:x,operation:E(S.operation),allowedActions:["operation.get","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),process.exitCode=c.running;return}if(S.operation?.status!=="completed"){O(!1,"save_commit_failed",r,{saveTransactionId:x,operation:E(S.operation),allowedActions:["command document.commit","transaction.get"],retry:{retryable:!0,requiresRebase:!1}}),j(S.operation);return}O(!0,"saved",r,{saveTransactionId:x,operation:E(S.operation),receipt:be(S.operation.output)})}catch(y){let f=me(y);if(f.result?.kind==="cli.deadline"){I({...f.result,kind:"apply.result",phase:g,...r?{transaction:A(r)}:{}}),process.exitCode=f.exitCode;return}let v;if(r&&(r.state==="open"||r.state==="preflighted"))try{r=(await e.request({kind:"transaction.abort",transactionId:r.transactionId,serviceInstanceId:r.serviceInstanceId})).transaction,v=A(r),C("abort",r)}catch{}I({ok:!1,kind:"apply.result",state:r?.state==="working_committed"?"save_failed":"failed",phase:g,...r?{transaction:A(r)}:{},...v?{aborted:v}:{},error:{code:f.code,message:f.message},allowedActions:r?.state==="working_committed"?["command document.export","transaction.get"]:["status"],retry:{retryable:r?.state==="working_committed",requiresRebase:/revision|serviceInstance/i.test(f.code)}}),process.exitCode=f.exitCode}}async function ie(e){let t=await e.request({kind:"status"});if(t.kind!=="status"||!t.status)throw p(c.discovery,"protocol.statusInvalid","Editor Service returned an invalid status response.");return t.status}function oe(e){if(["--stdin","--input-file"].filter(i=>e.has(i)).length>1)throw d("Use only one of --stdin or --input-file.");let n=m(e,"--input-file");return!n||n==="-"?process.stdin:he(b.resolve(n),{encoding:"utf8"})}async function re(e){let t=K(e.maxOperations,J),n=K(e.maxBytes,G),i=[],s=2,a=e.sequence,o=0,u=0,l=async()=>{if(i.length===0)return;let r=i.length,g=await e.client.request({kind:"transaction.append",transactionId:e.transactionId,serviceInstanceId:e.serviceInstanceId,sequence:a,operations:i});if(g.kind!=="transaction"||g.transaction.acceptedOperations<a+r)throw p(c.execution,"transaction.appendReceiptInvalid","Editor Service returned an invalid append receipt.");a=g.transaction.acceptedOperations,o+=r,e.onAppend(g),i=[],s=2};for await(let r of Me(e.source,T.signal,n)){u+=1;let g=r.endsWith("\r")?r.slice(0,-1):r;if(!g.trim())continue;let y;try{y=JSON.parse(g)}catch(w){throw d(`NDJSON line ${u} is not valid JSON: ${w instanceof Error?w.message:String(w)}`)}Te(y,u);let f=JSON.stringify(y),v=Buffer.byteLength(f);if(v+2>n)throw d(`NDJSON line ${u} exceeds the ${n}-byte transaction append limit.`);let h=s+v+(i.length?1:0);i.length&&(i.length>=t||h>n)&&await l(),i.push(y),s+=v+(i.length>1?1:0),(i.length>=t||s>=n)&&await l()}if(await l(),o===0)throw d("Transaction input must contain at least one NDJSON operation.");return{acceptedOperations:o,nextSequence:a}}function Te(e,t){if(!e||typeof e!="object"||Array.isArray(e))throw d(`NDJSON line ${t} must be a transaction operation object.`);if(typeof e.opId!="string"||!e.opId.trim())throw d(`NDJSON line ${t} requires a non-empty opId.`);if(typeof e.commandId!="string"||!e.commandId.trim())throw d(`NDJSON line ${t} requires a non-empty commandId.`);if(e.as!==void 0&&(typeof e.as!="string"||!e.as.trim()))throw d(`NDJSON line ${t} as must be a non-empty string.`)}async function z(e,t){let n=await e.request({kind:"commands.describe",commandId:t.commandId}),i=n.kind==="command"?n.command:null;if(!i)throw p(c.unavailable,"command.unknown",`Editor command is not registered: ${t.commandId}`);if(!i.availability.available)throw p(c.unavailable,"command.unavailable",i.availability.reasons.map(o=>o.message).join("; ")||`Editor command is unavailable: ${t.commandId}`);let s=await e.request({kind:"command.invoke",invocation:{commandId:t.commandId,input:t.input,requestId:N(),idempotencyKey:N(),expectedRevision:{serviceInstanceId:t.serviceInstanceId,...t.expectedDocumentRevision===void 0?{}:{document:t.expectedDocumentRevision}},principal:{type:"agent",id:"fps-editor-agent"},source:"agent-cli",transactionId:t.transactionId,...t.traceId?{traceId:t.traceId}:{}},...t.timeoutMs===void 0?{}:{timeoutMs:t.timeoutMs}}),a=s.operation;return a&&!pe(a.status)&&(a=(await e.request({kind:"operation.get",operationId:a.operationId})).operation??a),{response:s,operation:a}}function C(e,t){I({ok:t.state!=="failed",kind:"apply.event",phase:e,state:t.state,transaction:A(t)})}function W(e,t,n){I({ok:n?.status!=="failed"&&n?.status!=="cancelled",kind:"apply.event",phase:e,state:n?.status??"unavailable",transaction:A(t),operation:E(n)})}function O(e,t,n,i={}){I({ok:e,kind:"apply.result",state:t,phase:t==="saved"?"complete":n.phase,transaction:A(n),...i.allowedActions?{}:{allowedActions:n.allowedActions},...i.retry?{}:{retry:n.retry},...i})}function A(e){return{transactionId:e.transactionId,serviceInstanceId:e.serviceInstanceId,state:e.state,phase:e.phase,baseDocumentRevision:e.baseDocumentRevision,...e.workingDocumentRevision===void 0?{}:{workingDocumentRevision:e.workingDocumentRevision},dirty:e.dirty,acceptedOperations:e.acceptedOperations,acceptedBytes:e.acceptedBytes,processedOperations:e.processedOperations,allowedActions:e.allowedActions,retry:e.retry,diagnostics:e.diagnostics,results:{offset:e.results.offset,returned:e.results.returned,total:e.results.total,...e.results.nextCursor?{nextCursor:e.results.nextCursor}:{}}}}function E(e){return e?{operationId:e.operationId,requestId:e.requestId,commandId:e.commandId,status:e.status,...e.transactionId?{transactionId:e.transactionId}:{},...e.traceId?{traceId:e.traceId}:{},...e.output===void 0?{}:{output:e.output},...e.diagnostics?{diagnostics:e.diagnostics}:{}}:null}function be(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:{}}function K(e,t){return Number.isSafeInteger(e)&&e>0?e:t}async function _e(e,t){let n=t.shift();if(n==="get"){let i=_(t,new Set(["--request-id","--service-instance-id"])),s=i.positionals.shift();if(i.positionals.length)throw d("operation get accepts at most one operation id.");let a=m(i.options,"--request-id");if(!s&&!a||s&&a)throw d("operation get requires exactly one operation id or --request-id.");let o=m(i.options,"--service-instance-id");if(o&&o!==e.serviceInstanceId)throw p(c.conflict,"operation.serviceInstanceChanged",`Expected Editor Service ${o}, received ${e.serviceInstanceId}.`);let u=await e.request(s?{kind:"operation.get",operationId:s}:{kind:"operation.get",requestId:a});I(u),u.operation?j(u.operation):process.exitCode=c.unavailable;return}if(n==="cancel"){let i=D(t,"operation id");de(t);let s=await e.request({kind:"operation.cancel",operationId:i});I(s),s.operation?!s.cancelled&&!pe(s.operation.status)&&(process.exitCode=c.running):process.exitCode=c.unavailable;return}throw d("operation requires get or cancel.")}async function Ae(e,t){if(t.shift()!=="get")throw d("trace requires get.");let i=_(t,new Set(["--cursor","--limit"])),s=i.positionals.shift();if(i.positionals.length)throw d("trace get accepts at most one trace id.");I(await e.request({kind:"trace.get",...s?{traceId:s}:{},...m(i.options,"--cursor")?{cursor:m(i.options,"--cursor")}:{},...R(i.options,"--limit",{minimum:1})?{limit:R(i.options,"--limit",{minimum:1})}:{}}))}async function Q(e,t={}){let n=await se(e,{validateService:!0,...t}),i=ae(process.env.FPS_EDITOR_AGENT_ENDPOINT?.trim()||n.descriptor.endpoint),s=process.env.FPS_EDITOR_AGENT_TOKEN?.trim()||n.descriptor.token,a=async u=>{if(q)throw p(c.interrupted,"cli.interrupted","Interrupted.");let l=te-Date.now();if(l<=0)throw Z(n,u);let r=new AbortController,g=()=>r.abort(T.signal.reason);T.signal.addEventListener("abort",g,{once:!0});let y=setTimeout(()=>r.abort(X),l);y.unref?.();try{let f=await fetch(i,{method:"POST",headers:{authorization:`Bearer ${s}`,"content-type":"application/json"},body:JSON.stringify(u),signal:r.signal}),v=await je(f),h;try{h=JSON.parse(v)}catch{throw p(c.discovery,"protocol.invalidJson","Editor Service returned invalid JSON.")}if(f.status===401||f.status===403)throw p(c.discovery,"auth.invalidToken",ue(h)||"Editor Service authentication failed.");if(!h?.ok)throw Ce(h);return h}catch(f){throw q||T.signal.aborted?P():r.signal.reason===X?Z(n,u):f&&Number.isInteger(f.exitCode)?f:p(c.discovery,"service.unreachable",`Editor Service is unreachable: ${f instanceof Error?f.message:String(f)}`)}finally{clearTimeout(y),T.signal.removeEventListener("abort",g)}},o=await a({kind:"status"});return xe(n,o),Object.freeze({discovery:n,serviceInstanceId:n.descriptor.serviceInstanceId,status:o.status,request:a})}async function se(e,t={}){let n;try{n=await Y(b.resolve(e))}catch(i){throw p(c.discovery,"projectRoot.invalid",`Project root is unavailable: ${i instanceof Error?i.message:String(i)}`)}for(;;){let i=b.join(n,F);if(await Pe(i)){let a=await Ne(i),o=await Y(n);if(a.canonicalProjectRoot!==o)throw p(c.discovery,"descriptor.projectMismatch",`Runtime descriptor does not own ${o}.`);let u={descriptorPath:i,projectRoot:o,descriptor:a};return t.validateService!==!1&&await ce(u),u}if(t.exactProjectRoot===!0)break;let s=b.dirname(n);if(s===n)break;n=s}throw p(c.discovery,"descriptor.notFound",`No ${F} was found from ${e}.`)}async function Ne(e){let t;try{t=JSON.parse(await H(e,"utf8"))}catch(n){throw p(c.discovery,"descriptor.invalid",`Runtime descriptor is unreadable: ${n instanceof Error?n.message:String(n)}`)}if(t?.schemaVersion!==1||t?.protocolVersion!==2||t?.packageName!=="@fps-games/editor"||typeof t?.serviceInstanceId!="string"||typeof t?.canonicalProjectRoot!="string"||typeof t?.endpoint!="string"||typeof t?.token!="string"||!Number.isSafeInteger(t?.pid))throw p(c.discovery,"descriptor.incompatible","Runtime descriptor schema or protocol is incompatible.");if(ae(t.endpoint),process.platform!=="win32"){let n=(await ye(e)).mode&511;if(n&63)throw p(c.discovery,"descriptor.permissions",`Runtime descriptor permissions must be 0600; received ${n.toString(8)}.`)}return t}function ae(e){let t;try{t=new URL(e)}catch{throw p(c.discovery,"descriptor.endpoint","Runtime descriptor endpoint is invalid.")}if(t.protocol!=="http:"||!["127.0.0.1","localhost","[::1]"].includes(t.hostname))throw p(c.discovery,"descriptor.endpoint","Runtime descriptor endpoint must be project-local loopback HTTP.");return t.toString()}async function ce(e){let t=[];t.push({id:"descriptor.schema",ok:e.descriptor.schemaVersion===1}),t.push({id:"descriptor.protocol",ok:e.descriptor.protocolVersion===2}),t.push({id:"descriptor.project",ok:e.descriptor.canonicalProjectRoot===e.projectRoot});let n=qe(e.descriptor.pid);if(t.push({id:"descriptor.process",ok:n,pid:e.descriptor.pid}),!n)throw p(c.discovery,"descriptor.stale",`Editor Service process is not alive: ${e.descriptor.pid}.`);return t}function xe(e,t){let n=t?.kind==="status"?t.status:null;if(!n||n.protocolVersion!==2)throw p(c.discovery,"protocol.incompatible","Editor Service status protocol is incompatible.");if(n.serviceInstanceId!==e.descriptor.serviceInstanceId||n.canonicalProjectRoot!==e.projectRoot||n.packageVersion!==e.descriptor.packageVersion||n.buildKey!==e.descriptor.buildKey)throw p(c.discovery,"service.identityMismatch","Editor Service identity does not match the project runtime descriptor.")}async function ke(e){if(["--stdin","--input-file","--input-json"].filter(s=>e.has(s)).length>1)throw d("Use only one of --stdin, --input-file, or --input-json.");if(e.has("--stdin"))return M(await Le(process.stdin,T.signal),"--stdin");let n=m(e,"--input-file");if(n)return M(await H(b.resolve(n),"utf8"),"--input-file");let i=m(e,"--input-json");return i===void 0?{}:M(i,"--input-json")}function M(e,t){try{return JSON.parse(e)}catch(n){throw d(`${t} is not valid JSON: ${n instanceof Error?n.message:String(n)}`)}}function _(e,t,n=new Set){let i=new Map,s=[];for(;e.length;){let a=e.shift();if(!a.startsWith("--")){s.push(a);continue}let[o,u]=a.split("=",2);if(!t.has(o))throw d(`Unknown option: ${o}`);if(i.has(o))throw d(`Option may only be provided once: ${o}`);if(n.has(o)){if(u!==void 0)throw d(`${o} does not accept a value.`);i.set(o,!0);continue}let l=u??e.shift();if(l===void 0||l.startsWith("--"))throw d(`${o} requires a value.`);i.set(o,l)}return{options:i,positionals:s}}function m(e,t){let n=e.get(t);if(n!==void 0){if(typeof n!="string"||!n.trim())throw d(`${t} requires a non-empty value.`);return n.trim()}}function De(e){let t=[],n=B,i=!1,s;for(let a=0;a<e.length;a+=1){let o=e[a];if(o==="--project-root"||o.startsWith("--project-root=")){if(s!==void 0)throw d("--project-root may only be provided once.");let r=o==="--project-root"?e[++a]:o.slice(15);if(r===void 0||!r.trim()||r.startsWith("--"))throw d("--project-root requires a non-empty path.");s=b.resolve(process.cwd(),r);continue}if(o!=="--deadline"&&!o.startsWith("--deadline=")){t.push(o);continue}if(i)throw d("--deadline may only be provided once.");i=!0;let u=o==="--deadline"?e[++a]:o.slice(11);if(u===void 0||u.startsWith("--"))throw d("--deadline requires a value.");let l=Number(u);if(!Number.isSafeInteger(l)||l<1)throw d("--deadline must be an integer >= 1.");n=l}return{argv:t,deadlineMs:n,projectRoot:s}}function R(e,t,{minimum:n}){let i=m(e,t);if(i===void 0)return;let s=Number(i);if(!Number.isSafeInteger(s)||s<n)throw d(`${t} must be an integer >= ${n}.`);return s}function D(e,t){let n=e.shift();if(!n)throw d(`Missing ${t}.`);return n}function de(e){if(e.length)throw d(`Unexpected argument: ${e[0]}`)}function $(e,t){for(let n of e.keys())if(!t.has(n))throw d(`Option is not valid for this action: ${n}`)}function j(e){if(!e){process.exitCode=c.unavailable;return}if(e.status==="accepted"||e.status==="running"){process.exitCode=c.running;return}(e.status==="failed"||e.status==="cancelled")&&(process.exitCode=V(e.diagnostics))}function k(e,t={}){if(!e){process.exitCode=c.unavailable;return}if(e.state==="preflighting"||e.state==="committing"){process.exitCode=c.running;return}if(e.state==="failed"){process.exitCode=V(e.diagnostics);return}e.state==="aborted"&&t.abortedIsSuccess!==!0&&(process.exitCode=c.execution)}function V(e=[]){let t=e.map(n=>n?.code??"");return t.some(n=>/revision|idempotency|conflict|serviceInstance/i.test(n))?c.conflict:t.some(n=>/unknown|unavailable|notFound|sessionUnavailable/i.test(n))?c.unavailable:c.execution}function Ce(e){let t=Array.isArray(e?.diagnostics)?e.diagnostics:[];return p(V(t),t[0]?.code??"service.requestFailed",ue(e)||"Editor Service request failed.")}function ue(e){return Array.isArray(e?.diagnostics)?e.diagnostics.map(t=>t?.message).filter(Boolean).join("; "):""}function qe(e){try{return process.kill(e,0),!0}catch(t){return t?.code==="EPERM"}}function pe(e){return e==="completed"||e==="failed"||e==="cancelled"}async function je(e){let t=Number(e.headers.get("content-length"));if(Number.isFinite(t)&&t>U)throw p(c.execution,"response.tooLarge","Editor Service response exceeds 1 MiB.");let n=await e.text();if(Buffer.byteLength(n)>U)throw p(c.execution,"response.tooLarge","Editor Service response exceeds 1 MiB.");return n}async function Pe(e){try{return await ve(e,ge.R_OK),!0}catch{return!1}}async function Le(e,t){let n=[];for await(let i of le(e,t))n.push(Buffer.isBuffer(i)?i:Buffer.from(i));return Buffer.concat(n).toString("utf8")}async function*Me(e,t,n=Number.POSITIVE_INFINITY){let i="";for await(let s of le(e,t)){i+=s.toString();let a;for(;(a=i.indexOf(`
+`))>=0;){let o=i.slice(0,a);if(Buffer.byteLength(o)>n)throw d(`NDJSON line exceeds the ${n}-byte transaction append limit.`);yield o,i=i.slice(a+1)}if(Buffer.byteLength(i)>n)throw d(`NDJSON line exceeds the ${n}-byte transaction append limit.`)}i&&(yield i)}async function*le(e,t){let n=e[Symbol.asyncIterator]();for(;;){let i=await $e(n,t);if(i.done)return;yield i.value}}function $e(e,t){return t.aborted?Promise.reject(P()):new Promise((n,i)=>{let s=()=>i(P());t.addEventListener("abort",s,{once:!0}),e.next().then(n,i).finally(()=>t.removeEventListener("abort",s))})}function I(e){let t=JSON.stringify(e);if(Buffer.byteLength(t)>U)throw p(c.execution,"output.tooLarge","CLI output exceeds 1 MiB.");process.stdout.write(`${t}
+`)}function Ue(){return{globalOptions:{deadline:`End-to-end CLI deadline in milliseconds (default ${B}).`,projectRoot:"Exact target project root. Required for deployment-owned usage from outside the project."},commands:["status","commands list [--cursor CURSOR] [--limit N]","commands search QUERY [--cursor CURSOR] [--limit N]","commands describe COMMAND_ID","command COMMAND_ID [--stdin|--input-file FILE|--input-json JSON] [--expected-revision N] [--idempotency-key KEY] [--request-id ID] [--trace-id ID] [--client-id ID] [--timeout MS]","apply [--stdin|--input-file FILE] [--save] [--expected-revision N] [--transaction-id ID] [--label TEXT] [--trace-id ID] [--timeout MS]","transaction begin [--expected-revision N] [--transaction-id ID] [--label TEXT] [--trace-id ID]","transaction append TRANSACTION_ID [--stdin|--input-file FILE] [--sequence N] [--service-instance-id ID]","transaction preflight TRANSACTION_ID [--service-instance-id ID]","transaction commit TRANSACTION_ID [--service-instance-id ID]","transaction get TRANSACTION_ID [--service-instance-id ID] [--cursor CURSOR] [--limit N]","transaction abort TRANSACTION_ID [--service-instance-id ID]","operation get OPERATION_ID [--service-instance-id ID]","operation get --request-id REQUEST_ID [--service-instance-id ID]","operation cancel OPERATION_ID","trace get [TRACE_ID] [--cursor CURSOR] [--limit N]","doctor"],exitCodes:c}}function d(e){return p(c.usage,"cli.usage",e)}function p(e,t,n,i=!0,s){return Object.assign(new Error(n),{exitCode:e,code:t,log:i,...s?{result:s}:{}})}function Z(e,t){let n=t?.kind==="command.invoke"?t.invocation:null,i=t?.kind?.startsWith("transaction.")?t.transactionId:n?.transactionId,s=!!n||typeof t?.kind=="string"&&/^transaction\.(begin|append|preflight|commit|abort)$/.test(t.kind),a=n?.requestId,o=a?`operation get --request-id ${a} --service-instance-id ${e.descriptor.serviceInstanceId}`:null,u=i?`transaction get ${i} --service-instance-id ${e.descriptor.serviceInstanceId}`:null,l=[o,u].filter(Boolean);l.length||l.push("status");let r=`Agent CLI exceeded its ${ne}ms end-to-end deadline.`;return p(c.running,"cli.deadlineExceeded",r,!0,{ok:!1,kind:"cli.deadline",state:s?"outcome_unknown":"timed_out",serviceInstanceId:e.descriptor.serviceInstanceId,...n?.commandId?{commandId:n.commandId}:{},...a?{requestId:a}:{},...i?{transactionId:i}:{},error:{code:"cli.deadlineExceeded",message:r},allowedActions:l,retry:{retryable:!s,requiresOperationQuery:s}})}function P(){return p(c.interrupted,"cli.interrupted","Interrupted.")}function me(e){return e&&Number.isInteger(e.exitCode)&&typeof e.code=="string"?e:p(c.execution,"cli.failure",e instanceof Error?e.message:String(e))}

package/bin/fps-editor-prepare.mjs

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import{createHash as H,randomBytes as G}from"node:crypto";import{once as Q}from"node:events";import{chmod as X,copyFile as B,mkdir as g,mkdtemp as V,readFile as f,readdir as C,rename as I,rm as w,stat as j,writeFile as A}from"node:fs/promises";import{spawn as Y}from"node:child_process";import{fileURLToPath as Z}from"node:url";import e from"node:path";var tt=e.dirname(Z(import.meta.url)),F=e.resolve(tt,".."),n=e.resolve(process.cwd()),T=e.join(n,"node_modules/vite/bin/vite.js"),k=e.join(n,".fps-editor"),b=e.join(k,"deployments"),E=e.join(k,"adapters"),O=e.join(k,"state"),U=e.join(k,"current.json"),D=e.join(O,"runtime-bridge-token"),et=process.argv.includes("--reset-test-state"),rt=e.join(O,"playwright-working-document-journal.json"),P=JSON.parse(await f(e.join(n,"node_modules/@fps-games/editor/dist/build-info.json"),"utf8")),x=await ft();yt();et&&await w(rt,{force:!0});await g(b,{recursive:!0});await g(E,{recursive:!0});await g(O,{recursive:!0,mode:448});await lt();var l=await dt(),S=JSON.parse(await f(e.join(F,"manifest.json"),"utf8"));st(S,P);await at(F,S.files);var W=L(S.files);l&&l.editorDistHash===P.distHash&&l.projectSourceHash===x&&l.deployment?.packageHash===W&&await ct(l)&&(console.log("[fps-editor-server] existing deployment and Project Adapter are current."),process.exit(0));var s=await it(F,S,W),p=await nt(P,s),ot=["a","b"].map(t=>({release:t,artifactId:`${s.id}-${t}`,rootPath:e.relative(n,e.join(s.rootPath,"public")),build:{...s.manifest.build,buildId:`${s.manifest.build.buildId}.release-${t}`}})),K={schemaVersion:2,preparedAt:new Date().toISOString(),editorDistHash:P.distHash,projectSourceHash:x,deployment:{id:s.id,rootPath:e.relative(n,s.rootPath),packageHash:s.packageHash,manifest:s.manifest},adapter:{id:p.id,rootPath:e.relative(n,p.rootPath),browserRoot:e.relative(n,p.browserRoot),browserEntry:p.browserEntry,workerEntry:e.relative(n,p.workerEntry),manifest:p.manifest},workerEntry:e.relative(n,e.join(s.rootPath,s.manifest.entrypoints.worker)),serverEntry:e.relative(n,e.join(s.rootPath,s.manifest.entrypoints.server)),builds:ot,staged:l?.deployment?.id&&l.deployment.id!==s.id?{deploymentId:l.deployment.id,adapterId:l.adapter?.id??null}:null};await ut(U,K);await pt(K);console.log([`[fps-editor-server] prepared deployment ${s.id}`,`and Project Adapter ${p.id}`,`(browser ${M(p.manifest.sizes.browserBytes)},`,`worker ${M(p.manifest.sizes.workerBytes)}).`].join(" "));async function it(t,o,r){let i=await V(e.join(b,".install-"));try{for(let u of o.files){let v=e.join(i,u.path);await g(e.dirname(v),{recursive:!0}),await B(e.join(t,u.path),v)}await B(e.join(t,"manifest.json"),e.join(i,"manifest.json"));let a=`${o.version}-${r.slice(0,16)}`,c=e.join(b,a);return(await j(c).catch(()=>null))?.isDirectory()?await w(i,{recursive:!0,force:!0}):await I(i,c),{id:a,rootPath:c,manifest:o,packageHash:r}}finally{await w(i,{recursive:!0,force:!0}).catch(()=>{})}}async function nt(t,o){let r=await V(e.join(E,".build-")),i=e.join(r,"browser"),a=e.join(r,"worker");try{await z(process.execPath,[T,"build","--config",e.join(n,"vite.editor-project-adapter.config.ts")],{...process.env,FPS_EDITOR_PROJECT_ADAPTER_OUT_DIR:e.relative(n,i)}),await z(process.execPath,[T,"build","--config",e.join(n,"vite.editor-server-worker.config.ts")],{...process.env,FPS_EDITOR_SERVER_WORKER_OUT_DIR:e.relative(n,a)});let c=e.join(i,".vite/manifest.json"),h=JSON.parse(await f(c,"utf8")),u=Object.values(h).find(d=>d?.isEntry)?.file;if(typeof u!="string")throw new Error("Project browser Adapter entry is missing.");await w(e.dirname(c),{recursive:!0,force:!0});let v=e.join(a,"project-adapter.mjs");if(!(await j(v).catch(()=>null))?.isFile())throw new Error("Project worker Adapter entry is missing.");let m=await wt(r),R=`project-adapter-${L(m).slice(0,20)}`,_={schemaVersion:1,artifactKind:"fps-editor-project-adapter",artifactId:R,editorDistHash:t.distHash,deploymentPackageHash:o.packageHash,projectSourceHash:x,browserEntry:u,workerEntry:"worker/project-adapter.mjs",projectAssetsBundled:!1,files:m,sizes:{browserBytes:m.filter(d=>d.path.startsWith("browser/")).reduce((d,$)=>d+$.size,0),workerBytes:m.filter(d=>d.path.startsWith("worker/")).reduce((d,$)=>d+$.size,0)}};await A(e.join(r,"manifest.json"),`${JSON.stringify(_,null,2)}
-`),mt(m);let y=e.join(E,R);return(await j(y).catch(()=>null))?.isDirectory()?await w(r,{recursive:!0,force:!0}):await I(r,y),{id:R,rootPath:y,browserRoot:e.join(y,"browser"),browserEntry:u,workerEntry:e.join(y,"worker/project-adapter.mjs"),manifest:_}}finally{await w(r,{recursive:!0,force:!0}).catch(()=>{})}}function st(t,o){if(t?.schemaVersion!==2||t.artifactKind!=="fps-editor-deployment-package"||t.packageName!=="@fps-games/editor-deployment")throw new Error("Editor deployment manifest is invalid.");if(t.node?.range!==">=24 <27"||t.node?.bundled!==!1)throw new Error("Editor deployment Node.js contract is invalid.");if(t.build?.version!==o.version||t.build?.distHash!==o.distHash)throw new Error("Editor deployment does not match the installed @fps-games/editor package.");if(typeof o.gitSha!="string"||t.commitSha!==o.gitSha)throw new Error("Editor deployment commit does not match the installed @fps-games/editor package.");for(let r of["server","worker","browser"])if(typeof t.entrypoints?.[r]!="string")throw new Error(`Editor deployment ${r} entrypoint is missing.`);for(let r of["prepare","server"])if(typeof t.binaries?.[r]!="string")throw new Error(`Editor deployment ${r} binary is missing.`);if(t.projectContentBundled!==!1)throw new Error("Editor deployment must not contain project content.")}async function at(t,o){if(!Array.isArray(o)||o.length===0)throw new Error("Editor deployment file manifest is empty.");for(let r of o){if(!ht(r.path))throw new Error(`Unsafe deployment file path: ${String(r.path)}.`);let i=await f(e.join(t,r.path));if(i.byteLength!==r.size||q(i)!==r.sha256)throw new Error(`Editor deployment file integrity mismatch: ${r.path}.`)}}async function ct(t){try{let o=[t.serverEntry,t.workerEntry,e.join(t.adapter.browserRoot,t.adapter.browserEntry),t.adapter.workerEntry];return(await Promise.all(o.map(r=>j(e.join(n,r))))).every(r=>r.isFile())}catch{return!1}}async function dt(){try{let t=JSON.parse(await f(U,"utf8"));return t?.schemaVersion===2?t:null}catch{return null}}async function pt(t){let o=new Set([t.deployment.id,t.staged?.deploymentId].filter(Boolean)),r=new Set([t.adapter.id,t.staged?.adapterId].filter(Boolean));await J(b,o),await J(E,r)}async function J(t,o){for(let r of await C(t,{withFileTypes:!0}))!r.isDirectory()||r.name.startsWith(".")||o.has(r.name)||await w(e.join(t,r.name),{recursive:!0,force:!0})}async function lt(){(await f(D,"utf8").catch(()=>"")).trim()||(await A(D,`${G(32).toString("base64url")}
-`,{encoding:"utf8",mode:384}),await X(D,384))}async function ft(){let t=H("sha256"),o=["fps.config.ts","vite.editor-project-adapter.config.ts","vite.editor-server-worker.config.ts","src"];for(let r of o){let i=e.join(n,r),c=(await j(i)).isDirectory()?await N(i):[i];for(let h of c)t.update(e.relative(n,h).split(e.sep).join("/")).update("\0"),t.update(await f(h)).update("\0")}return t.digest("hex")}async function wt(t){let o=[];for(let r of await N(t)){let i=await f(r);o.push({path:e.relative(t,r).split(e.sep).join("/"),size:i.byteLength,sha256:q(i)})}return o}async function N(t){let o=[];for(let r of(await C(t,{withFileTypes:!0})).sort((i,a)=>i.name.localeCompare(a.name))){let i=e.join(t,r.name);r.isDirectory()?o.push(...await N(i)):r.isFile()&&o.push(i)}return o}async function ut(t,o){await g(e.dirname(t),{recursive:!0});let r=`${t}.${process.pid}.tmp`;await A(r,`${JSON.stringify(o,null,2)}
-`),await I(r,t)}async function z(t,o,r=process.env){let i=Y(t,o,{cwd:n,env:r,stdio:"inherit"}),[a,c]=await Q(i,"exit");if(a!==0)throw new Error(`Editor Server preparation failed (${c??a??"unknown"}).`)}function ht(t){return typeof t=="string"&&t.length>0&&!t.includes("\\")&&!e.isAbsolute(t)&&!t.split("/").includes("..")}function mt(t){let o=t.filter(r=>/\.(?:env|glb|gltf|ktx2?|basis|png|jpe?g|webp|wav|mp3|ogg)$/i.test(r.path));if(o.length>0)throw new Error(`Project Adapter bundled project assets: ${o.map(r=>r.path).join(", ")}.`)}function L(t){return H("sha256").update(JSON.stringify(t)).digest("hex")}function q(t){return H("sha256").update(t).digest("hex")}function yt(){let t=Number.parseInt(process.versions.node.split(".")[0]??"",10);if(!Number.isSafeInteger(t)||t<24||t>=27)throw new Error(`prepare:server requires Node.js >=24 <27; current version is ${process.versions.node}.`)}function M(t){return`${(t/1024/1024).toFixed(2)} MiB`}
+import{createHash as y,randomBytes as O}from"node:crypto";import{chmod as J,copyFile as k,mkdir as u,mkdtemp as V,readFile as m,readdir as T,rename as x,rm as l,stat as w,writeFile as F}from"node:fs/promises";import{fileURLToPath as C,pathToFileURL as B}from"node:url";import e from"node:path";import N from"node:path";function $(t){let r=[],o;for(let i=0;i<t.length;i+=1){let s=t[i];if(s!=="--project-root"&&!s.startsWith("--project-root=")){r.push(s);continue}if(o!==void 0)throw new Error("--project-root may only be provided once.");let a=s==="--project-root"?t[++i]:s.slice(15);if(a===void 0||!a.trim()||a.startsWith("--"))throw new Error("--project-root requires a non-empty path.");o=a}return{argv:r,projectRoot:N.resolve(process.cwd(),o??"."),explicit:o!==void 0}}var L=e.dirname(C(import.meta.url)),g=e.resolve(L,".."),j=$(process.argv.slice(2)),U=j.argv.includes("--reset-test-state"),D=j.argv.filter(t=>t!=="--reset-test-state");if(D.length>0)throw new Error(`Unexpected argument: ${D[0]}`);var p=j.projectRoot,v=e.join(p,".fps-editor"),f=e.join(v,"deployments"),b=e.join(v,"state"),R=e.join(v,"current.json"),h=e.join(b,"runtime-bridge-token"),q=e.join(b,"playwright-working-document-journal.json");nt();U&&await l(q,{force:!0});await u(f,{recursive:!0});await u(b,{recursive:!0,mode:448});await Z();var c=await Q(),d=JSON.parse(await m(e.join(g,"manifest.json"),"utf8"));z(d);var E=await _(),A=tt(E);await K(g,d.files);var H=rt(d.files);c&&c.editorDistHash===d.build.distHash&&c.projectSourceHash===A&&c.deployment?.packageHash===H&&await G(c)&&(console.log("[fps-editor-server] existing deployment and static Project definition are current."),process.exit(0));var n=await W(g,d,H),M=["a","b"].map(t=>({release:t,artifactId:`${n.id}-${t}`,rootPath:e.relative(p,e.join(n.rootPath,"public")),build:{...n.manifest.build,buildId:`${n.manifest.build.buildId}.release-${t}`}})),I={schemaVersion:3,preparedAt:new Date().toISOString(),editorDistHash:d.build.distHash,projectSourceHash:A,projectDefinition:E,deployment:{id:n.id,rootPath:e.relative(p,n.rootPath),packageHash:n.packageHash,manifest:n.manifest},workerEntry:e.relative(p,e.join(n.rootPath,n.manifest.entrypoints.worker)),serverEntry:e.relative(p,e.join(n.rootPath,n.manifest.entrypoints.server)),builds:M,staged:c?.deployment?.id&&c.deployment.id!==n.id?{deploymentId:c.deployment.id}:null};await et(R,I);await X(I);console.log([`[fps-editor-server] prepared deployment ${n.id}`,`for static Project ${E.projectId}.`].join(" "));async function W(t,r,o){let i=await V(e.join(f,".install-"));try{for(let P of r.files){let S=e.join(i,P.path);await u(e.dirname(S),{recursive:!0}),await k(e.join(t,P.path),S)}await k(e.join(t,"manifest.json"),e.join(i,"manifest.json"));let s=`${r.version}-${o.slice(0,16)}`,a=e.join(f,s);return(await w(a).catch(()=>null))?.isDirectory()?await l(i,{recursive:!0,force:!0}):await x(i,a),{id:s,rootPath:a,manifest:r,packageHash:o}}finally{await l(i,{recursive:!0,force:!0}).catch(()=>{})}}function z(t){if(t?.schemaVersion!==2||t.artifactKind!=="fps-editor-deployment-package"||t.packageName!=="@fps-games/editor-deployment")throw new Error("Editor deployment manifest is invalid.");if(t.node?.range!==">=24 <27"||t.node?.bundled!==!1)throw new Error("Editor deployment Node.js contract is invalid.");if(typeof t.build?.version!="string"||typeof t.build?.distHash!="string"||typeof t.commitSha!="string")throw new Error("Editor deployment build identity is incomplete.");for(let r of["server","worker","browser"])if(typeof t.entrypoints?.[r]!="string")throw new Error(`Editor deployment ${r} entrypoint is missing.`);for(let r of["prepare","server","project","agent"])if(typeof t.binaries?.[r]!="string")throw new Error(`Editor deployment ${r} binary is missing.`);if(t.projectContentBundled!==!1)throw new Error("Editor deployment must not contain project content.")}async function K(t,r){if(!Array.isArray(r)||r.length===0)throw new Error("Editor deployment file manifest is empty.");for(let o of r){if(!ot(o.path))throw new Error(`Unsafe deployment file path: ${String(o.path)}.`);let i=await m(e.join(t,o.path));if(i.byteLength!==o.size||it(i)!==o.sha256)throw new Error(`Editor deployment file integrity mismatch: ${o.path}.`)}}async function G(t){try{let r=[t.serverEntry,t.workerEntry,e.join(t.deployment.rootPath,t.deployment.manifest.entrypoints.browser)];return(await Promise.all(r.map(o=>w(e.join(p,o))))).every(o=>o.isFile())}catch{return!1}}async function Q(){try{let t=JSON.parse(await m(R,"utf8"));return t?.schemaVersion===3?t:null}catch{return null}}async function X(t){let r=new Set([t.deployment.id,t.staged?.deploymentId].filter(Boolean));await Y(f,r)}async function Y(t,r){for(let o of await T(t,{withFileTypes:!0}))!o.isDirectory()||o.name.startsWith(".")||r.has(o.name)||await l(e.join(t,o.name),{recursive:!0,force:!0})}async function Z(){(await m(h,"utf8").catch(()=>"")).trim()||(await F(h,`${O(32).toString("base64url")}
+`,{encoding:"utf8",mode:384}),await J(h,384))}async function _(){let t=e.join(p,"fps.config.ts");if(!(await w(t).catch(()=>null))?.isFile())throw new Error("fps.config.ts is required.");let o=await import(`${B(t).href}?fps-editor-prepare=${Date.now()}`),i=o.default??o.fpsConfig;if(!i||typeof i!="object"||Array.isArray(i)||i.schemaVersion!==1||typeof i.projectId!="string"||!i.authoring||!Array.isArray(i.plugins))throw new Error("fps.config.ts must default-export a valid defineFpsProject() definition.");return i}function tt(t){return y("sha256").update(JSON.stringify(t)).digest("hex")}async function et(t,r){await u(e.dirname(t),{recursive:!0});let o=`${t}.${process.pid}.tmp`;await F(o,`${JSON.stringify(r,null,2)}
+`),await x(o,t)}function ot(t){return typeof t=="string"&&t.length>0&&!t.includes("\\")&&!e.isAbsolute(t)&&!t.split("/").includes("..")}function rt(t){return y("sha256").update(JSON.stringify(t)).digest("hex")}function it(t){return y("sha256").update(t).digest("hex")}function nt(){let t=Number.parseInt(process.versions.node.split(".")[0]??"",10);if(!Number.isSafeInteger(t)||t<24||t>=27)throw new Error(`prepare:server requires Node.js >=24 <27; current version is ${process.versions.node}.`)}