@lunora/cli
Version:
The Lunora CLI: init, dev, deploy, codegen, migrate, seed, doctor, insights, logs, registry, and the rest of the project commands
8 lines (7 loc) • 26.8 kB
JavaScript
import{spawnSync as $,spawn as re}from"node:child_process";import{existsSync as N,watch as Te,readFileSync as C,mkdirSync as Re,openSync as te,closeSync as ne,statSync as _e,readSync as Le}from"node:fs";import{join as k,dirname as Ie}from"node:path";import{runCodegen as oe}from"@lunora/codegen";import{runPostCodegenHook as Oe,detectAgentRules as ie,updateDevServerState as M,readDevServerState as O,claimDevServerState as ae,DEV_HANDOFF_ENV as R,clearDevServerState as y,readLiveDevServerState as D,isDevServerReady as G,detectFramework as se,readProjectDependencyNames as De,DEV_LOG_FILE_ENV as ce,DEV_DAEMON_ENV as x,detectPackageManager as de,execArgsFor as A,isRecordedProcessCurrent as Pe,DEV_LOG_FILE as Ae,CODEGEN_ENV as le,isCodegenDisabled as $e,detectAiAgent as Ne,readProjectRemotePreference as Ce,inferLunoraBindings as Me,packageNamesFromBindings as xe,ensureDevVarsExample as Fe,ensureDevVariables as je,isInteractive as Ge,DEV_VARS_FILE as _,DEV_VARS_EXAMPLE_FILE as Ue,fillDevSecrets as Ve,DEV_BINDINGS_FILE as We,DEV_STATE_FILE as ue,claimAgentRulesHint as He,AGENT_RULES_HINT as Be,resolveDeployDriver as Ke,resolveProjectTarget as Ye,runScriptCommand as Je,discoverContainerInfo as Xe,streamContainerLogs as ze,parseDevVariableEntries as Qe,formatLunoraEvent as Ze}from"@lunora/config";import{resolveRemoteEnabled as qe,findWranglerFile as fe,readWranglerJsonc as ge,materializeRemoteWranglerConfig as er}from"@lunora/config/cloudflare";import{p as rr,a as tr}from"../packem_shared/deploy-target-B0Xcb2jV.mjs";import{w as nr}from"../packem_shared/binding-manifest-file-CQ1eQYy1.mjs";import{a as or}from"../packem_shared/codegen-error-AmH54ofi.mjs";import{a as ir}from"../packem_shared/platform-diagnostics-Cn2g6Jh-.mjs";import{d as ar}from"../packem_shared/command-DwC11Cwe.mjs";import{createServer as sr,connect as cr}from"node:net";import{forceJsonLogging as dr}from"../packem_shared/createLogger-hGafwf-3.mjs";import{networkInterfaces as lr}from"node:os";import{spawnShellCompat as ve}from"../packem_shared/createRecordingSpawner-DJlNacZ6.mjs";import{createServer as ur,request as fr}from"node:http";import{pipeline as gr}from"node:stream";import{loadStudioAssets as U,studioAssetsStamp as V,renderStudioHtml as vr,resolveAdminToken as mr,transportRejectionReason as W,SCHEMA_EDIT_ENDPOINT as pr,POLICY_SCAFFOLD_ENDPOINT as wr,SEED_ENDPOINT as hr,sendStudioDocument as Sr,serveJsonHandler as yr,isStandaloneModulePath as Er,readStandaloneAsset as kr,assetContentType as br,handleSchemaEditRequest as Tr,handlePolicyScaffoldRequest as Rr,handleSeedRequest as _r,applyStudioAssetCache as Lr}from"@lunora/config/studio-host";import{c as Ir}from"../packem_shared/tui-prompts-DzYd2fL3.mjs";import{setTimeout as L}from"node:timers/promises";import{provisionBindings as Or}from"./runDeployCommand.mjs";import{p as E}from"../packem_shared/output-format-DfogXx0p.mjs";const Dr=100,Pr=300,Ar=/[/\\]/u,$r=(e,r,n)=>{const{apiSpec:t,logger:o,projectRoot:i,target:a}=e;try{const s=oe({apiSpec:t,lunoraDirectory:r,projectRoot:i,target:a});o.success(`codegen: wrote ${r}/_generated (${n})`),ir(s.platformDiagnostics,o)}catch(s){return o.error(or(s,n)),!1}return!0},Nr=e=>{const r=e.lunoraDirectory??"lunora",n=k(e.projectRoot,r),t=e.debounceMs??Dr;let o=!1,i=!1,a=!1,s,d=0,u=Promise.resolve(),g;const m=new Promise(v=>{g=v}),p=v=>{o||(s=v,!i&&(i=!0,u=(async()=>{try{for(;s!==void 0;){const h=s;if(s=void 0,!!$r(e,r,h)){a=!0;try{(await Oe({cwd:e.projectRoot,logger:e.logger,spawner:e.spawner,stdoutToStderr:e.jsonLogs})).ran&&(d=Date.now())}finally{a=!1}}}}catch(h){e.logger.error(`codegen watch: ${h instanceof Error?h.message:String(h)}`)}finally{i=!1,g()}})()))};p("startup");const l=v=>(e.logger.warn(`codegen watch unavailable (${v}) — schema edits will NOT auto-regenerate. Run \`lunora codegen\` manually after each edit.`),{close:()=>(o=!0,s=void 0,u),ready:m,watchAvailable:!1});let c,f;if(!N(n))return l(`no such directory: ${n}`);try{f=Te(n,{recursive:!0},(v,h)=>{if(!(typeof h=="string"&&h.split(Ar).includes("_generated"))){if(a||Date.now()-d<Pr){c&&(clearTimeout(c),c=void 0);return}c&&clearTimeout(c),c=setTimeout(()=>{p(`change: ${h??"?"}`)},t)}})}catch(v){return l(v instanceof Error?v.message:String(v))}const w=f;return{close:()=>(o=!0,s=void 0,c&&clearTimeout(c),w.close(),u),ready:m,watchAvailable:!0}},Cr=64,me="127.0.0.1",Mr=65535,xr=(e,r=me)=>new Promise(n=>{const t=sr();t.once("error",()=>{n(!1)}),t.once("listening",()=>{t.close(()=>{n(!0)})}),t.listen(e,r)}),Fr=async(e,r=me,n=Cr)=>{for(let t=e;t<e+n&&t<=Mr;t+=1)if(await xr(t,r))return t;return e},H=(e=lr)=>Object.values(e()).some(r=>r?.some(n=>n.internal&&n.address==="::1")),B="/_lunora",K=e=>{const r=e.indexOf("?");return r===-1?e:e.slice(0,r)},Y=3e4,J=(e,r,n)=>{const t=fr({headers:{...e.headers,host:n.host},hostname:n.hostname,method:e.method,path:e.url,port:n.port},o=>{r.writeHead(o.statusCode??502,o.headers),gr(o,r,()=>{})});t.setTimeout(Y,()=>{t.destroy(new Error(`no response within ${String(Y)}ms`))}),t.on("error",o=>{if(r.headersSent){r.destroy();return}r.statusCode=o.message.startsWith("no response within")?504:502,r.end(`lunora dev: worker unreachable (${o.message})`)}),r.on("close",()=>{r.writableFinished||t.destroy()}),e.pipe(t)},jr=5e3,Gr=(e,r,n,t)=>{const o=cr({host:t.hostname,port:Number(t.port)},()=>{o.setTimeout(0);const i=[`${e.method??"GET"} ${e.url??"/"} HTTP/1.1`];for(const[a,s]of Object.entries(e.headers))if(a!=="host")for(const d of Array.isArray(s)?s:[s])d!==void 0&&i.push(`${a}: ${d}`);i.push(`host: ${t.host}`,"",""),o.write(i.join(`\r
`)),n.length>0&&o.write(n),o.pipe(r),r.pipe(o)});o.setTimeout(jr,()=>o.destroy()),o.on("error",()=>r.destroy()),r.on("error",()=>o.destroy())},Ur=async e=>{const r=e.host??"127.0.0.1",n=r==="127.0.0.1"||r==="localhost"||r==="::1",t=new URL(e.workerOrigin);let o=U(e.logger,import.meta.url),i=V(import.meta.url);const a=vr({adminToken:n?mr(e.cwd):void 0,basePath:"/",dataEditable:n,rulesInstalled:ie(e.cwd).installed,runAsIdentity:n,schemaEditable:n,scriptSrc:"/studio.js",styleHref:"/styles.css"}),s=(l,c,f,w,v)=>{Lr(l,c,v,i)||(c.statusCode=200,c.setHeader("Content-Type",w),c.end(f))},d=(l,c,f)=>{l.statusCode=c,l.setHeader("Content-Type","text/plain"),l.end(f)},u=(l,c,f,w)=>{if(n){yr(l,c,f,e.cwd,{apiSpec:e.apiSpec});return}d(c,403,w)},g=(l,c,f)=>{const w=l==="/styles.css",v=Er(l);if(!w&&!v)return!1;const h=V(import.meta.url);if(h!==i&&(o=U(e.logger,import.meta.url),i=h),o===void 0)return d(f,501,"Lunora studio assets not found — install and build @lunora/studio."),!0;if(w)return s(c,f,o.styles,"text/css; charset=utf-8","styles.css"),!0;const b=l.slice(l.lastIndexOf("/")+1),j=kr(b,import.meta.url);return j===void 0?(d(f,404,"Not found"),!0):(s(c,f,j,br(b),b),!0)},m=Buffer.from(a),p=ur((l,c)=>{const f=K(l.url??"/");if(n){const v=W(l,e.logger);if(v!==void 0){d(c,403,v);return}}if(f.startsWith(B)){if(!n){d(c,403,"Lunora studio: the worker admin proxy is only available on a loopback bind.");return}J(l,c,t);return}if(f===pr){u(l,c,Tr,"Lunora schema editing is only available on loopback hosts in dev.");return}if(f===wr){u(l,c,Rr,"Lunora policy scaffolding is only available on loopback hosts in dev.");return}if(f===hr){u(l,c,_r,"Lunora data seeding is only available on loopback hosts in dev.");return}if(g(f,l,c))return;const w=l.headers["sec-fetch-mode"];if(n&&typeof w=="string"&&w!=="navigate"){J(l,c,t);return}Sr(c,m)});return p.on("upgrade",(l,c,f)=>{if(!n||W(l,e.logger)!==void 0){c.destroy();return}K(l.url??"").startsWith(B)?Gr(l,c,f,t):c.destroy()}),await new Promise((l,c)=>{p.once("error",f=>{f.code==="EADDRINUSE"?c(new Error(`studio port ${String(e.port)} is already in use — pass a different port with --port, or stop the process using it`,{cause:f})):c(f)}),p.listen(e.port,r,()=>{l()})}),{close:()=>new Promise(l=>{p.close(()=>{l()})}),url:`http://${r==="0.0.0.0"||r==="::"?"localhost":r}:${String(e.port)}`}},Vr=12e4,F=250,Wr=1e3,Hr="LUNORA_DEV_READY_TIMEOUT_MS",pe=e=>{if(e!==void 0)return e;const r=Number(process.env[Hr]??"");return Number.isFinite(r)&&r>0?r:Vr},we=async(e,r)=>{try{const n=AbortSignal.timeout(Wr);return await(await fetch(new URL("/_lunora/status",e),{redirect:"manual",signal:r===void 0?n:AbortSignal.any([r,n])})).body?.cancel(),!0}catch{return!1}},Br=async e=>{const{cwd:r,logger:n,origin:t,signal:o}=e,i=e.probe??we,a=pe(e.readyTimeoutMs),s=Date.now()+a,d=()=>o.aborted;for(;!d()&&Date.now()<s;){let u=!1;try{u=await i(t,o)}catch{}if(d()||Date.now()>=s)break;if(u)return M(r,{readyAt:new Date().toISOString()},{expectedPid:process.pid}),O(r)?.readyAt!==void 0;try{await L(F,void 0,{signal:o})}catch{}}return d()||n.warn(`server did not answer on ${t} within ${String(Math.round(a/1e3))}s — .lunora/dev.json will have no readyAt, so anything polling for readiness will keep waiting. The server itself is unaffected; raise LUNORA_DEV_READY_TIMEOUT_MS if it is just slow to boot.`),!1},Kr=1e4,Yr=100,Jr=40,T=256*1024,Xr=new Set(["nuxt","sveltekit"]),P=e=>Xr.has(se(e).framework)?"framework-worker":De(e).has("@lunora/vite")?"vite":"wrangler",he=e=>{const r=de(e);let n;try{const t=C(k(e,"package.json"),"utf8");n=JSON.parse(t).scripts?.dev}catch{}if(n===void 0||n.trim()===""||n.includes("lunora")){const t=A(r,"vite",["dev"]);return{args:t.args,command:t.command}}return{args:["run","dev"],command:r}},zr=e=>{Re(Ie(e.logPath),{recursive:!0});const r=te(e.logPath,"w",384);let n;const t=ve(e.command,e.args);try{n=re(t.command,t.args,{cwd:e.cwd,detached:!0,env:e.env,shell:t.shell,stdio:["ignore",r,r],windowsHide:!0})}finally{ne(r)}return n.unref(),{exited:new Promise(o=>{n.on("error",()=>{o(1)}),n.on("exit",(i,a)=>{o(i??(a?1:0))})}),pid:n.pid}},Qr=e=>{try{const{size:r}=_e(e);if(r<=T)return C(e,"utf8");const n=te(e,"r");try{const t=Buffer.alloc(T),o=Le(n,t,0,T,r-T),i=t.toString("utf8",0,o);return i.slice(i.indexOf(`
`)+1)}finally{ne(n)}}catch{return}},Se=(e,r)=>{const n=Qr(e);if(n===void 0)return[];const t=n.split(`
`);return t.at(-1)===""&&t.pop(),r>0?t.slice(-r):t},ye=(e,r)=>r?.logFile??k(e,Ae),Ee=e=>{e.info(" Stop: lunora dev stop"),e.info(" Status: lunora dev status"),e.info(" Logs: lunora dev logs")},I=(e,r)=>{e.warn(`Dev server already running at ${r.url} (pid ${String(r.pid)})`),Ee(e)},Zr=(e,r)=>{e.success(`Dev server running at ${r.url} (pid ${String(r.pid)})`),r.studioUrl!==void 0&&e.info(` Studio: ${r.studioUrl}`),Ee(e)},qr=async e=>{const{child:r,cwd:n,deadline:t,pollIntervalMs:o,probe:i}=e,a=r.exited.then(s=>({exitCode:s}));for(;Date.now()<t;){const s=D(n);if(s!==void 0&&s.pid!==process.pid&&await i(s.url))return{state:s,status:"ready"};const d=await Promise.race([a,L(o)]);if(d!==void 0)return{...d,status:"exited"}}return{status:"timeout"}},et=async e=>{const{cwd:r,logger:n}=e,t=ye(r,void 0),o=pe(e.readyTimeoutMs),i=(e.spawnDetached??zr)({args:e.command.args,command:e.command.command,cwd:r,env:{...process.env,...e.env,[x]:"1",[ce]:t,...process.env.FORCE_COLOR===void 0?{NO_COLOR:"1"}:{},...e.json?{LUNORA_LOG_JSON:"1"}:{}},logPath:t}),a=await qr({child:i,cwd:r,deadline:Date.now()+o,pollIntervalMs:e.pollIntervalMs??F,probe:e.probe??we});if(a.status==="ready")return Zr(n,a.state),{code:0};if(a.status==="exited"){n.error(`dev server exited before becoming ready (exit code ${String(a.exitCode)}). Last output:`);for(const d of Se(t,Jr))n.error(` ${d}`);return y(r,i.pid??process.pid),{code:a.exitCode===0?1:a.exitCode}}i.pid!==void 0&&O(r)?.pid===process.pid&&M(r,{logFile:t,pid:i.pid});const s=i.pid===void 0?"":` (pid ${String(i.pid)})`;return n.warn(`dev server did not confirm ready within ${String(Math.round(o/1e3))}s — it may still be compiling${s}. Check \`lunora dev status\` and \`lunora dev logs\`; \`lunora dev stop\` shuts it down.`),{code:1}},ke=e=>e.codegen!==!1&&!$e(process.env[le]),be=e=>{const r={...e.remote===!0?{LUNORA_REMOTE:"1"}:{},...e.codegen===!1?{[le]:"0"}:{}};return Object.keys(r).length>0?{env:r}:{}},rt=(e,r)=>{const n=["dev"];return e.apiSpec!==void 0&&n.push("--api-spec",e.apiSpec),e.port!==void 0&&n.push("--port",String(e.port)),e.workerPort!==void 0&&n.push("--worker-port",String(e.workerPort)),e.emitBindings!==void 0&&n.push("--emit-bindings",e.emitBindings),e.codegen===!1&&n.push("--no-codegen"),e.studio===!1&&n.push("--no-studio"),e.worker===!1&&n.push("--no-worker"),e.target!==void 0&&n.push("--target",e.target),r&&n.push("--remote"),n},tt=async e=>{const{cwd:r,jsonLogs:n,logger:t,options:o,remote:i}=e,a=e.run??et,s=P(r),d=s==="wrangler"?`http://localhost:${String(o.workerPort??8787)}`:"http://localhost:5173",u=ae(r,{background:!0,mode:"cli",pid:process.pid,startedAt:new Date().toISOString(),url:d});if(!u.ok)return u.existing!==void 0&&I(t,u.existing),{code:0};const g={[R]:String(process.pid)};try{return s==="vite"?await a({command:he(r),cwd:r,env:{...be({...o,remote:i}).env,...g},json:n,logger:t}):await a({command:{args:[process.argv[1]??"lunora",...rt(o,i)],command:process.execPath},cwd:r,env:g,json:n,logger:t})}finally{y(r,process.pid)}},nt=e=>{try{const r=$("ps",["-o","pgid=","-p",String(e)],{encoding:"utf8"}),n=Number.parseInt(r.stdout.trim(),10);return Number.isInteger(n)&&n>0?n:void 0}catch{return}},ot=(e,r,n=process.platform,t=$)=>{if(n==="win32"){try{t("taskkill",["/pid",String(e.pid),"/T","/F"],{stdio:"ignore"})}catch{}return}if(e.background===!0)try{r(-(nt(e.pid)??e.pid),"SIGKILL");return}catch{}try{r(e.pid,"SIGKILL")}catch{}},it=(e,r)=>(r.json?E({pid:e.pid,stopped:!1}):r.logger.error(`dev server (pid ${String(e.pid)}) survived the force-kill — record kept; retry \`lunora dev stop\` or kill the process manually.`),{code:1}),at=async e=>{const{cwd:r,logger:n}=e,t=O(r),o=e.alive??(m=>m===t?.pid&&Pe(t)),i=e.signal??((m,p)=>{process.kill(m,p)}),a=e.pollIntervalMs??F,s=e.stopGraceMs??Kr,d=e.platform??process.platform,u=e.spawnSyncImpl??$;if(t===void 0||!o(t.pid))return t!==void 0&&y(r,t.pid),e.json?E({running:!1,stopped:!1}):n.info("No dev server running."),{code:0};try{i(t.pid,"SIGTERM")}catch{}const g=Date.now()+s;for(;o(t.pid)&&Date.now()<g;)await L(a);return o(t.pid)&&(ot(t,i,d,u),await L(a),o(t.pid))?it(t,e):(y(r,t.pid),e.json?E({pid:t.pid,stopped:!0}):n.success(`Stopped dev server (pid ${String(t.pid)}).`),{code:0})},st=e=>{const{cwd:r,logger:n}=e,t=D(r);if(t===void 0)return e.json?E({running:!1}):n.info("No dev server running."),{code:0};const o=e.now??Date.now,i=t.startedAt===void 0?Number.NaN:Date.parse(t.startedAt),a=Number.isFinite(i)?Math.max(0,Math.round((o()-i)/1e3)):void 0;if(e.json)return E({background:t.background===!0,logFile:t.logFile,mode:t.mode,pid:t.pid,ready:G(t),readyAt:t.readyAt,running:!0,startedAt:t.startedAt,studioUrl:t.studioUrl,uptimeSeconds:a,url:t.url}),{code:0};const s=[`pid ${String(t.pid)}`,...a===void 0?[]:[`uptime ${String(a)}s`],t.background===!0?"background":"foreground",G(t)?"ready":"starting"];return n.success(`Dev server running at ${t.url} (${s.join(", ")})`),t.studioUrl!==void 0&&n.info(` Studio: ${t.studioUrl}`),t.logFile!==void 0&&n.info(` Logs: lunora dev logs (${t.logFile})`),{code:0}},ct=e=>{const{cwd:r,logger:n}=e,t=O(r),o=ye(r,t);if(!N(o))return n.info("No dev server logs found — output is captured when the server runs in background mode (`lunora dev --background`)."),{code:0};const i=Se(o,e.lines??Yr);return i.length>0&&process.stdout.write(`${i.join(`
`)}
`),{code:0}},dt=e=>{const{cwd:r,json:n,lines:t,logger:o,subcommand:i}=e;if(i==="stop")return at({cwd:r,json:n,logger:o});if(i==="status")return st({cwd:r,json:n,logger:o});if(i==="logs")return ct({cwd:r,lines:t,logger:o});if(i!==void 0)return o.error(`dev: unknown subcommand "${i}" — expected stop | status | logs (or no subcommand to start the dev server)`),{code:1}},X="wrangler.dev.jsonc",z=6173,S=8787,Q=5173,lt=5e3,ut=(e,r)=>{const n=()=>{};if(!e.remote)return{args:[],plan:{bindings:[],cleanup:n,enabled:!1}};const o=(e.materializeRemote??er)({enabled:!0,projectRoot:r}),i=o.remoteBindings.map(s=>`${s.binding} (${s.kind})`),{cleanup:a}=o;return o.configPath===void 0?{args:[],plan:{bindings:i,cleanup:a,enabled:!0,reason:o.reason}}:{args:["--config",o.configPath],plan:{bindings:i,cleanup:a,enabled:!0}}},Z=e=>ge(e).parsed?.dev?.ip,q=(e,r,n)=>{if(n!==void 0){const o=k(e,n);if(N(o)&&Z(o)!==void 0)return[]}const t=fe(e);return t!==void 0&&Z(t)!==void 0?[]:r()?[]:["--ip","127.0.0.1"]},ft=new Set(["127.0.0.1","::1","[::1]","localhost"]),gt=(e,r)=>{let n;try{n=C(k(e,_),"utf8")}catch{return[]}const t=[];for(const o of Qe(n)){let i;try{i=new URL(o.value)}catch{continue}ft.has(i.hostname)&&i.port===String(r)&&t.push(o.key)}return t},vt=async(e,r)=>{if(e.workerPort!==void 0)return e.workerPort;const n=fe(r);if(n!==void 0){const{parsed:i}=ge(n);if(typeof i?.dev?.port=="number")return i.dev.port}const t=await(e.findFreePort??Fr)(S);if(t===S)return t;const o=gt(r,S);if(o.length>0)throw new Error(`port ${String(S)} is in use, but ${_} pins the worker origin to it (${o.join(", ")}). Serving on ${String(t)} would leave those URLs pointing at nothing. Stop whatever holds ${String(S)}, or run \`lunora dev --worker-port ${String(t)}\` and update those values to match.`);return t},mt=e=>{const r=e.cwd??process.cwd(),n=de(r),t=e.flavor??P(r);if(t==="vite"||t==="framework-worker"){const g=he(r);let m;if(t==="framework-worker"){const p=q(r,e.hasIpv6Loopback??H,X),l=Ke(Ye(r)).toolchain?.dev({configPath:X,extraArgs:[...p,"--var","WORKER_ENV:development"]}),c=A(n,l?.tool??"wrangler",l?.args??[]);m={args:c.args,command:c.command,cwd:r,tag:"worker"}}return e.worker===!1&&e.logger.warn(`--no-worker does not apply to the ${t} flavor: Vite owns the worker, codegen and studio in-process. Run your framework's dev script instead.`),{runsCodegenWatch:!1,flavor:t,ipv4LoopbackForced:!1,remote:{bindings:[],cleanup:()=>{},enabled:e.remote===!0},...m?{sidecar:m}:{},studioEnabled:!1,studioPort:e.port??z,workerEnabled:!0,workerOrigin:`http://localhost:${String(Q)}`,workerPort:Q,wrangler:{args:g.args,command:g.command,cwd:r,...be(e),tag:"vite"}}}const o=se(r),i=o.framework==="none"?void 0:`this project uses ${o.framework} — the worker runs inside Vite there. run \`${Je(n,"dev")}\` for the full app (frontend + HMR); \`lunora dev\` starts only the worker.`,a=e.workerPort??S,s=ut(e,r),d=q(r,e.hasIpv6Loopback??H),u=A(n,"wrangler",["dev","--port",String(a),...d,"--var","WORKER_ENV:development",...s.args]);return{runsCodegenWatch:ke(e),flavor:t,frameworkHint:i,ipv4LoopbackForced:d.length>0,remote:s.plan,studioEnabled:e.studio!==!1,studioPort:e.port??z,workerEnabled:e.worker!==!1,workerOrigin:`http://localhost:${String(a)}`,workerPort:a,wrangler:{args:u.args,command:u.command,cwd:r,tag:"wrangler"}}},ee=(e,r,n,t)=>{if(e.length===0)return;const o=Ze(e);if(o){t[o.level](`[lunora] ${o.text}`);return}const i=`[${r}] ${e}`;n==="stderr"?t.warn(i):t.info(i)},pt=(e,r,n)=>{const t=(o,i)=>{if(!o)return;let a="";o.on("data",s=>{a+=s.toString("utf8");const d=a.split(`
`);a=d.pop()??"";for(const u of d)ee(u.trimEnd(),r,i,n)}),o.on("end",()=>{ee(a.trimEnd(),r,i,n),a=""})};t(e.stdout,"stdout"),t(e.stderr,"stderr")},wt=(e,r)=>{const n=ve(e.command,e.args),t=re(n.command,n.args,{cwd:e.cwd??process.cwd(),env:e.env?{...process.env,...e.env}:process.env,shell:n.shell,stdio:["inherit","pipe","pipe"]});return pt(t,e.tag,r),{exited:new Promise(o=>{t.on("error",i=>{r.error(`[${e.tag}] failed to start: ${i.message}`),o(1)}),t.on("exit",(i,a)=>{o(i??(a?1:0))})}),kill:o=>{try{t.kill(o)}catch{}}}},ht=(e,r,n,t)=>{e.info(""),e.success("Lunora dev"),e.info(` ➜ Worker: ${r.workerOrigin}`),n!==void 0&&e.info(` ➜ Studio: ${n}`),r.runsCodegenWatch&&e.info(" ➜ Codegen: watching lunora/"),t!==void 0&&e.info(` ➜ Supervisor: ${t} (needs) · ${ue} (status)`),r.remote.enabled&&(r.remote.bindings.length>0?e.info(` ➜ Remote: ${r.remote.bindings.join(", ")} → deployed worker`):e.warn(` ➜ Remote: requested but inactive (${r.remote.reason??"no eligible bindings"}) — running fully local`)),e.info("")},St=(e,r)=>{ie(r).installed||!He()||(e.info(` ⓘ ${Be}`),e.info(""))},yt=(e,r)=>{if(process.env.LUNORA_CONTAINER_LOGS==="0")return;const t=Xe(e,"lunora").containers.map(o=>({className:o.className,exportName:o.exportName}));if(t.length!==0)return ze({containers:t,onLine:o=>{const i=`[container:${o.name}] ${o.text}`;o.level==="error"?r.warn(i):r.info(i)},onUnavailable:o=>{r.warn(`[container] Docker engine unreachable — container logs unavailable (${o})`)}})},Et=async e=>{e.readyProbe?.abort(),await e.codegen?.close().catch(()=>{}),e.containerLogs?.close(),await e.studio?.close().catch(()=>{});try{e.remoteCleanup?.()}catch{}},kt=async(e,r)=>{try{const t=await Me({projectRoot:r}),o=xe(t),i=(e.ensureExample??Fe)(r,o);i.length>0&&e.logger.info(`Updated .dev.vars.example with secrets for: ${o.join(", ")} (${i.join(", ")})`)}catch{}(await(e.ensureEnv??je)({confirm:Ir(),cwd:r,info:t=>{e.logger.info(t)}})).status==="declined"&&!Ge()&&e.logger.info(`hint: ${_} was not scaffolded (non-interactive run). Copy ${Ue} → ${_} and fill in secrets, or run \`lunora dev\` in an interactive terminal to scaffold automatically.`);try{(e.fillSecrets??Ve)({cwd:r,info:t=>{e.logger.info(t)}})}catch{}},bt=(e,r,n,t,o)=>{if(e.flavor!=="wrangler")return;t!==void 0&&M(r,{studioUrl:t});let i;try{i=yt(r,n)}catch{}return ht(n,e,t,o),i},Tt=(e,r)=>{const n=Number(process.env[R]),t=ae(r,{background:process.env[x]==="1",logFile:process.env[ce],mode:"cli",pid:process.pid,startedAt:new Date().toISOString(),url:e.workerOrigin},Number.isInteger(n)&&n>0?{supersedePid:n}:void 0);return t.ok?void 0:t.existing},Rt=e=>{const{cwd:r,destination:n,logger:t,plan:o}=e,i=n!==void 0,a=n??We,s=nr({destination:a,dev:{...o.flavor==="wrangler"?{origin:o.workerOrigin}:{},statusFile:ue},logger:i?t:{...t,success:()=>{},warn:()=>{}},projectRoot:r});return s.error!==void 0?i?s:(t.debug?.(`skipped the default binding manifest: ${s.error}`),{}):{written:a}},_t=async e=>{const r=e.cwd??process.cwd(),n=e.flavor??P(r),t=n==="wrangler"?await vt(e,r):e.workerPort;return mt({...e,cwd:r,flavor:n,workerPort:t})},Lt=async e=>await new Promise(r=>{const n={},t=a=>{e.info(`received ${a} — shutting down`),n.sigint&&process.off("SIGINT",n.sigint),n.sigterm&&process.off("SIGTERM",n.sigterm),r(0)},o=()=>{t("SIGINT")},i=()=>{t("SIGTERM")};n.sigint=o,n.sigterm=i,process.on("SIGINT",o),process.on("SIGTERM",i)}),It=async(e,r,n)=>{let t=0,o;const i=u=>{e.kill(u),r?.kill(u)},a=()=>{t+=1,t===1?(n.info("received SIGINT — shutting down (press Ctrl-C again to force-kill)"),i("SIGTERM"),o=setTimeout(()=>{i("SIGKILL")},lt),o.unref()):i("SIGKILL")},s=()=>{i("SIGTERM")};process.on("SIGINT",a),process.on("SIGTERM",s);const d=await Promise.race([e.exited.then(u=>({code:u,who:"worker"})),...r===void 0?[]:[r.exited.then(u=>({code:u,who:"sidecar"}))]]);return r!==void 0&&(d.who==="sidecar"?(n.warn("[worker] the Lunora sidecar (wrangler dev) exited — shutting down the framework dev server"),e.kill("SIGTERM")):r.kill("SIGTERM"),await Promise.allSettled([e.exited,r.exited])),o&&clearTimeout(o),process.off("SIGINT",a),process.off("SIGTERM",s),d.code},Ot=async(e,r,n,t)=>{if(r.studioEnabled)try{return await(e.startStudio??Ur)({apiSpec:e.apiSpec,cwd:n,logger:{warnOnce:o=>{t.warn(o)}},port:r.studioPort,workerOrigin:r.workerOrigin})}catch(o){t.warn(`studio server failed to start (${o instanceof Error?o.message:String(o)}) — continuing without it`);return}},Dt=e=>{const r=[e.runsCodegenWatch?"codegen watch":void 0,e.studioEnabled?"studio":void 0].filter(t=>t!==void 0);return`--no-worker: not starting wrangler. ${r.length>0?`${r.join(" + ")} running`:"nothing else to run"}; your task runner owns the worker on ${e.workerOrigin}.`},Pt=(e,r,n,t,o)=>{if(!(e.sidecar===void 0||!ke(r)))try{oe({apiSpec:r.apiSpec,lunoraDirectory:"lunora",projectRoot:n,target:o})}catch(i){t.warn(`codegen (pre-sidecar) failed: ${i instanceof Error?i.message:String(i)} — the framework dev server will retry`)}},At=async e=>{const{logger:r}=e,n=e.cwd??process.cwd(),t=e.flavor??P(n),o=tr(n,e.target);if(o.target===void 0)throw new Error(o.error??"unknown deploy target");const{target:i}=o;t==="wrangler"&&await Or(n,r,void 0,i,void 0);const a=await _t({...e,flavor:t}),s={remoteCleanup:a.remote.cleanup};try{const d=Number(process.env[R]),u=D(n);if(u!==void 0&&u.pid!==process.pid&&u.pid!==d)return I(r,u),{code:0,plan:a};const g=Tt(a,n);if(g!==void 0)return I(r,g),{code:0,plan:a};(a.flavor==="vite"||a.flavor==="framework-worker")&&(a.wrangler.env={...a.wrangler.env,[R]:String(process.pid)}),await kt(e,n),r.info(a.flavor==="vite"?"starting vite dev (worker + studio + codegen run inside Vite via @lunora/vite)":"starting wrangler dev + studio"),a.ipv4LoopbackForced&&r.info("no IPv6 loopback (::1) on this host — binding the worker to 127.0.0.1 (--ip) so wrangler dev doesn't crash. Pin `dev.ip` in wrangler.jsonc to override."),a.runsCodegenWatch&&(s.codegen=(e.startCodegen??Nr)({apiSpec:e.apiSpec,jsonLogs:e.jsonLogs,logger:r,projectRoot:n,target:i})),s.studio=await Ot(e,a,n,r);const m=Rt({cwd:n,destination:e.emitBindings,logger:r,plan:a});if(m.error!==void 0)return r.error(m.error),{code:1,plan:a};await s.codegen?.ready;const p=s.studio?.url;a.frameworkHint!==void 0&&r.warn(a.frameworkHint);const l=()=>{a.flavor==="wrangler"&&(s.readyProbe=new AbortController,Br({cwd:n,logger:r,origin:a.workerOrigin,probe:e.probeReady,signal:s.readyProbe.signal}))};if(!a.workerEnabled)return l(),r.info(Dt(a)),{code:await(e.waitForInterrupt??Lt)(r),plan:a};Pt(a,e,n,r,i);const c=e.startWorker??wt,f=c(a.wrangler,r),w=a.sidecar===void 0?void 0:c(a.sidecar,r);return l(),s.containerLogs=bt(a,n,r,p,m.written),St(r,n),{code:await It(f,w,r),plan:a}}finally{s.readyProbe?.abort(),y(n,process.pid),await Et(s)}},$t=e=>({codegen:e.codegen===!1?!1:void 0,studio:e.studio===!1?!1:void 0,worker:e.worker===!1?!1:void 0}),tn=ar(async({argument:e,cwd:r,logger:n,options:t})=>{const o=t.json===!0,i=dt({cwd:r,json:o,lines:t.lines,logger:n,subcommand:e[0]});if(i!==void 0)return i;const a=process.env[x]==="1",s=a?void 0:Ne(),d=o||s!==void 0;d&&dr(),s!==void 0&&t.background!==!0&&n.info(`AI agent detected (${s.name} via ${s.variable}) — starting the dev server in background mode with JSON logs. Set LUNORA_AGENT_MODE=0 to opt out.`);const u=qe({configPreference:Ce(r),envValue:process.env.LUNORA_REMOTE,flag:t.remote});if(!a&&(t.background===!0||s!==void 0)){const g=D(r);return g!==void 0?(I(n,g),{code:0}):tt({cwd:r,jsonLogs:d,logger:n,options:t,remote:u})}return At({apiSpec:rr(t.apiSpec),cwd:r,emitBindings:t.emitBindings,jsonLogs:d,logger:n,port:t.port,remote:u,target:t.target,workerPort:t.workerPort,...$t(t)})});export{wt as defaultWorkerSpawner,P as detectDevFlavor,tn as execute,$t as negatableDevFlags,mt as planDevCommand,vt as resolveWorkerPort,At as runDevCommand};