@lunora/cli/dist/packem_chunks/planDevCommand.mjs

The Lunora CLI: init, dev, deploy, codegen, migrate, seed, doctor, insights, logs, registry, and the rest of the project commands

import{spawnSync as R,spawn as q}from"node:child_process";import{existsSync as N,watch as fe,readFileSync as z,statSync as ve,openSync as Y,readSync as we,closeSync as X,mkdirSync as he}from"node:fs";import{join as b,dirname as Se}from"node:path";import{runCodegen as Z}from"@lunora/codegen";import{detectAgentRules as Q,claimDevServerState as ee,clearDevServerState as w,readDevServerState as L,readLiveDevServerState as E,detectFramework as re,readProjectDependencyNames as ke,DEV_HANDOFF_ENV as k,isRecordedProcessCurrent as ye,DEV_LOG_FILE as be,DEV_LOG_FILE_ENV as oe,DEV_DAEMON_ENV as O,updateDevServerState as te,detectAiAgent as Ee,readProjectRemotePreference as $e,resolveTargetOrThrow as Ie,inferLunoraBindings as Re,packageNamesFromBindings as Ne,ensureDevVarsExample as Le,ensureDevVariables as Oe,isInteractive as Te,DEV_VARS_FILE as A,DEV_VARS_EXAMPLE_FILE as Pe,fillDevSecrets as De,claimAgentRulesHint as xe,AGENT_RULES_HINT as Ae,resolveDeployDriver as _e,resolveProjectTarget as je,discoverContainerInfo as Ce,streamContainerLogs as Me,formatLunoraEvent as Fe}from"@lunora/config";import{resolveRemoteEnabled as Ge,findWranglerFile as ne,readWranglerJsonc as se,materializeRemoteWranglerConfig as Ue}from"@lunora/config/cloudflare";import{r as Ve}from"../packem_shared/api-spec-BENwiyUa.mjs";import{l as He}from"../packem_shared/codegen-error-DJN6pTH5.mjs";import{a as We}from"../packem_shared/platform-diagnostics-C4TFj5Pu.mjs";import{i as Be}from"../packem_shared/command-0l-ZPhIX.mjs";import{l as ie,M as $,k as Je}from"../packem_shared/detect-package-manager-DXDstphE.mjs";import{createServer as Ke,connect as qe}from"node:net";import{forceJsonLogging as ze}from"../packem_shared/createLogger-BoSxdb2T.mjs";import{networkInterfaces as Ye}from"node:os";import{spawnShellCompat as ae}from"../packem_shared/createRecordingSpawner-SKs4R1fc.mjs";import{createServer as Xe,request as Ze}from"node:http";import{loadStudioAssets as _,studioAssetsStamp as j,renderStudioHtml as Qe,resolveAdminToken as er,transportRejectionReason as C,SCHEMA_EDIT_ENDPOINT as rr,POLICY_SCAFFOLD_ENDPOINT as or,SEED_ENDPOINT as tr,serveJsonHandler as nr,isStandaloneModulePath as sr,readStandaloneAsset as ir,assetContentType as ar,handleSchemaEditRequest as dr,handlePolicyScaffoldRequest as cr,handleSeedRequest as lr}from"@lunora/config/studio-host";import{I as ur}from"../packem_shared/tui-prompts-BU3irGxV.mjs";import{setTimeout as I}from"node:timers/promises";import{d as h}from"../packem_shared/output-format-Cv3aLqhP.mjs";const pr=100,gr=/[/\\]/u,M=(e,r,t)=>{const{apiSpec:o,logger:n,projectRoot:s,target:i}=e;try{const a=Z({apiSpec:o,lunoraDirectory:r,projectRoot:s,target:i});n.success(`codegen: wrote ${r}/_generated (${t})`),We(a.platformDiagnostics,n)}catch(a){n.error(He(a,t))}},mr=e=>{const r=e.lunoraDirectory??"lunora",t=b(e.projectRoot,r),o=e.debounceMs??pr;M(e,r,"startup");const n=d=>(e.logger.warn(`codegen watch unavailable (${d}) — schema edits will NOT auto-regenerate. Run \`lunora codegen\` manually after each edit.`),{close:()=>{},watchAvailable:!1});let s,i;if(!N(t))return n(`no such directory: ${t}`);try{i=fe(t,{recursive:!0},(d,c)=>{typeof c=="string"&&c.split(gr).includes("_generated")||(s&&clearTimeout(s),s=setTimeout(()=>{M(e,r,`change: ${c??"?"}`)},o))})}catch(d){return n(d instanceof Error?d.message:String(d))}const a=i;return{close:()=>{s&&clearTimeout(s),a.close()},watchAvailable:!0}},fr=64,de="127.0.0.1",vr=65535,wr=(e,r=de)=>new Promise(t=>{const o=Ke();o.once("error",()=>{t(!1)}),o.once("listening",()=>{o.close(()=>{t(!0)})}),o.listen(e,r)}),hr=async(e,r=de,t=fr)=>{for(let o=e;o<e+t&&o<=vr;o+=1)if(await wr(o,r))return o;return e},F=(e=Ye)=>Object.values(e()).some(r=>r?.some(t=>t.internal&&t.address==="::1")),G="/_lunora",U=e=>{const r=e.indexOf("?");return r===-1?e:e.slice(0,r)},Sr=(e,r,t)=>{const o=Ze({headers:{...e.headers,host:t.host},hostname:t.hostname,method:e.method,path:e.url,port:t.port},n=>{r.writeHead(n.statusCode??502,n.headers),n.pipe(r)});o.on("error",n=>{r.statusCode=502,r.end(`lunora dev: worker unreachable (${n.message})`)}),e.pipe(o)},kr=5e3,yr=(e,r,t,o)=>{const n=qe({host:o.hostname,port:Number(o.port)},()=>{n.setTimeout(0);const s=[`${e.method??"GET"} ${e.url??"/"} HTTP/1.1`];for(const[i,a]of Object.entries(e.headers))if(i!=="host")for(const d of Array.isArray(a)?a:[a])d!==void 0&&s.push(`${i}: ${d}`);s.push(`host: ${o.host}`,"",""),n.write(s.join(`\r
`)),t.length>0&&n.write(t),n.pipe(r),r.pipe(n)});n.setTimeout(kr,()=>n.destroy()),n.on("error",()=>r.destroy()),r.on("error",()=>n.destroy())},br=async e=>{const r=e.host??"127.0.0.1",t=r==="127.0.0.1"||r==="localhost"||r==="::1",o=new URL(e.workerOrigin);let n=_(e.logger,import.meta.url),s=j(import.meta.url);const i=Qe({adminToken:t?er(e.cwd):void 0,basePath:"/",dataEditable:t,rulesInstalled:Q(e.cwd).installed,runAsIdentity:t,schemaEditable:t,scriptSrc:"/studio.js",styleHref:"/styles.css"}),a=(l,u,p)=>{l.statusCode=200,l.setHeader("Content-Type",p),l.end(u)},d=(l,u,p)=>{l.statusCode=u,l.setHeader("Content-Type","text/plain"),l.end(p)},c=(l,u,p,v)=>{if(t){nr(l,u,p,e.cwd);return}d(u,403,v)},g=(l,u)=>{const p=l==="/styles.css",v=sr(l);if(!p&&!v)return!1;const P=j(import.meta.url);if(P!==s&&(n=_(e.logger,import.meta.url),s=P),n===void 0)return d(u,501,"Lunora studio assets not found — install and build @lunora/studio."),!0;if(p)return a(u,n.styles,"text/css; charset=utf-8"),!0;const D=l.slice(l.lastIndexOf("/")+1),x=ir(D,import.meta.url);return x===void 0?(d(u,404,"Not found"),!0):(a(u,x,ar(D)),!0)},m=Buffer.from(i),f=Xe((l,u)=>{const p=U(l.url??"/");if(t){const v=C(l,e.logger);if(v!==void 0){d(u,403,v);return}}if(p.startsWith(G)){if(!t){d(u,403,"Lunora studio: the worker admin proxy is only available on a loopback bind.");return}Sr(l,u,o);return}if(p===rr){c(l,u,dr,"Lunora schema editing is only available on loopback hosts in dev.");return}if(p===or){c(l,u,cr,"Lunora policy scaffolding is only available on loopback hosts in dev.");return}if(p===tr){c(l,u,lr,"Lunora data seeding is only available on loopback hosts in dev.");return}g(p,u)||a(u,m,"text/html; charset=utf-8")});return f.on("upgrade",(l,u,p)=>{if(!t||C(l,e.logger)!==void 0){u.destroy();return}U(l.url??"").startsWith(G)?yr(l,u,p,o):u.destroy()}),await new Promise((l,u)=>{f.once("error",p=>{p.code==="EADDRINUSE"?u(new Error(`studio port ${String(e.port)} is already in use — pass a different port with --port, or stop the process using it`,{cause:p})):u(p)}),f.listen(e.port,r,()=>{l()})}),{close:()=>new Promise(l=>{f.close(()=>{l()})}),url:`http://${r==="0.0.0.0"||r==="::"?"localhost":r}:${String(e.port)}`}},Er=12e4,ce=250,$r=1e4,Ir=100,Rr=40,S=256*1024,Nr="LUNORA_DEV_READY_TIMEOUT_MS",Lr=new Set(["nuxt","sveltekit"]),T=e=>Lr.has(re(e).framework)?"framework-worker":ke(e).has("@lunora/vite")?"vite":"wrangler",le=e=>{const r=ie(e);let t;try{const o=z(b(e,"package.json"),"utf8");t=JSON.parse(o).scripts?.dev}catch{}if(t===void 0||t.trim()===""||t.includes("lunora")){const o=$(r,"vite",["dev"]);return{args:o.args,command:o.command}}return{args:["run","dev"],command:r}},Or=async e=>{try{return await fetch(new URL("/_lunora/status",e),{signal:AbortSignal.timeout(1e3)}),!0}catch{return!1}},Tr=e=>{he(Se(e.logPath),{recursive:!0});const r=Y(e.logPath,"w",384);let t;const o=ae(e.command,e.args);try{t=q(o.command,o.args,{cwd:e.cwd,detached:!0,env:e.env,shell:o.shell,stdio:["ignore",r,r],windowsHide:!0})}finally{X(r)}return t.unref(),{exited:new Promise(n=>{t.on("error",()=>{n(1)}),t.on("exit",(s,i)=>{n(s??(i?1:0))})}),pid:t.pid}},Pr=e=>{try{const{size:r}=ve(e);if(r<=S)return z(e,"utf8");const t=Y(e,"r");try{const o=Buffer.alloc(S),n=we(t,o,0,S,r-S),s=o.toString("utf8",0,n);return s.slice(s.indexOf(`
`)+1)}finally{X(t)}}catch{return}},ue=(e,r)=>{const t=Pr(e);if(t===void 0)return[];const o=t.split(`
`);return o.at(-1)===""&&o.pop(),r>0?o.slice(-r):o},pe=(e,r)=>r?.logFile??b(e,be),ge=e=>{e.info("  Stop:   lunora dev stop"),e.info("  Status: lunora dev status"),e.info("  Logs:   lunora dev logs")},y=(e,r)=>{e.warn(`Dev server already running at ${r.url} (pid ${String(r.pid)})`),ge(e)},Dr=(e,r)=>{e.success(`Dev server running at ${r.url} (pid ${String(r.pid)})`),r.studioUrl!==void 0&&e.info(`  Studio: ${r.studioUrl}`),ge(e)},xr=async e=>{const{child:r,cwd:t,deadline:o,pollIntervalMs:n,probe:s}=e,i=r.exited.then(a=>({exitCode:a}));for(;Date.now()<o;){const a=E(t);if(a!==void 0&&a.pid!==process.pid&&await s(a.url))return{state:a,status:"ready"};const d=await Promise.race([i,I(n)]);if(d!==void 0)return{...d,status:"exited"}}return{status:"timeout"}},Ar=async e=>{const{cwd:r,logger:t}=e,o=pe(r,void 0),n=Number(process.env[Nr]??""),s=e.readyTimeoutMs??(Number.isFinite(n)&&n>0?n:Er),i=(e.spawnDetached??Tr)({args:e.command.args,command:e.command.command,cwd:r,env:{...process.env,...e.env,[O]:"1",[oe]:o,...process.env.FORCE_COLOR===void 0?{NO_COLOR:"1"}:{},...e.json?{LUNORA_LOG_JSON:"1"}:{}},logPath:o}),a=await xr({child:i,cwd:r,deadline:Date.now()+s,pollIntervalMs:e.pollIntervalMs??ce,probe:e.probe??Or});if(a.status==="ready")return Dr(t,a.state),{code:0};if(a.status==="exited"){t.error(`dev server exited before becoming ready (exit code ${String(a.exitCode)}). Last output:`);for(const c of ue(o,Rr))t.error(`  ${c}`);return w(r,i.pid??process.pid),{code:a.exitCode===0?1:a.exitCode}}i.pid!==void 0&&L(r)?.pid===process.pid&&te(r,{logFile:o,pid:i.pid});const d=i.pid===void 0?"":` (pid ${String(i.pid)})`;return t.warn(`dev server did not confirm ready within ${String(Math.round(s/1e3))}s — it may still be compiling${d}. Check \`lunora dev status\` and \`lunora dev logs\`; \`lunora dev stop\` shuts it down.`),{code:1}},_r=(e,r)=>{const t=["dev"];return e.apiSpec!==void 0&&t.push("--api-spec",e.apiSpec),e.port!==void 0&&t.push("--port",String(e.port)),e.workerPort!==void 0&&t.push("--worker-port",String(e.workerPort)),e.codegen===!1&&t.push("--no-codegen"),e.studio===!1&&t.push("--no-studio"),e.worker===!1&&t.push("--no-worker"),e.target!==void 0&&t.push("--target",e.target),r&&t.push("--remote"),t},jr=async e=>{const{cwd:r,jsonLogs:t,logger:o,options:n,remote:s}=e,i=e.run??Ar,a=T(r),d=a==="wrangler"?`http://localhost:${String(n.workerPort??8787)}`:"http://localhost:5173",c=ee(r,{background:!0,mode:"cli",pid:process.pid,startedAt:new Date().toISOString(),url:d});if(!c.ok)return c.existing!==void 0&&y(o,c.existing),{code:0};const g={[k]:String(process.pid)};try{return a==="vite"?await i({command:le(r),cwd:r,env:{...s?{LUNORA_REMOTE:"1"}:{},...g},json:t,logger:o}):await i({command:{args:[process.argv[1]??"lunora",..._r(n,s)],command:process.execPath},cwd:r,env:g,json:t,logger:o})}finally{w(r,process.pid)}},Cr=e=>{try{const r=R("ps",["-o","pgid=","-p",String(e)],{encoding:"utf8"}),t=Number.parseInt(r.stdout.trim(),10);return Number.isInteger(t)&&t>0?t:void 0}catch{return}},Mr=(e,r,t=process.platform,o=R)=>{if(t==="win32"){try{o("taskkill",["/pid",String(e.pid),"/T","/F"],{stdio:"ignore"})}catch{}return}if(e.background===!0)try{r(-(Cr(e.pid)??e.pid),"SIGKILL");return}catch{}try{r(e.pid,"SIGKILL")}catch{}},Fr=(e,r)=>(r.json?h({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}),Gr=async e=>{const{cwd:r,logger:t}=e,o=L(r),n=e.alive??(m=>m===o?.pid&&ye(o)),s=e.signal??((m,f)=>{process.kill(m,f)}),i=e.pollIntervalMs??ce,a=e.stopGraceMs??$r,d=e.platform??process.platform,c=e.spawnSyncImpl??R;if(o===void 0||!n(o.pid))return o!==void 0&&w(r,o.pid),e.json?h({running:!1,stopped:!1}):t.info("No dev server running."),{code:0};try{s(o.pid,"SIGTERM")}catch{}const g=Date.now()+a;for(;n(o.pid)&&Date.now()<g;)await I(i);return n(o.pid)&&(Mr(o,s,d,c),await I(i),n(o.pid))?Fr(o,e):(w(r,o.pid),e.json?h({pid:o.pid,stopped:!0}):t.success(`Stopped dev server (pid ${String(o.pid)}).`),{code:0})},Ur=e=>{const{cwd:r,logger:t}=e,o=E(r);if(o===void 0)return e.json?h({running:!1}):t.info("No dev server running."),{code:0};const n=e.now??Date.now,s=o.startedAt===void 0?Number.NaN:Date.parse(o.startedAt),i=Number.isFinite(s)?Math.max(0,Math.round((n()-s)/1e3)):void 0;if(e.json)return h({background:o.background===!0,logFile:o.logFile,mode:o.mode,pid:o.pid,running:!0,startedAt:o.startedAt,studioUrl:o.studioUrl,uptimeSeconds:i,url:o.url}),{code:0};const a=[`pid ${String(o.pid)}`,...i===void 0?[]:[`uptime ${String(i)}s`],o.background===!0?"background":"foreground"];return t.success(`Dev server running at ${o.url} (${a.join(", ")})`),o.studioUrl!==void 0&&t.info(`  Studio: ${o.studioUrl}`),o.logFile!==void 0&&t.info(`  Logs:   lunora dev logs (${o.logFile})`),{code:0}},Vr=e=>{const{cwd:r,logger:t}=e,o=L(r),n=pe(r,o);if(!N(n))return t.info("No dev server logs found — output is captured when the server runs in background mode (`lunora dev --background`)."),{code:0};const s=ue(n,e.lines??Ir);return s.length>0&&process.stdout.write(`${s.join(`
`)}
`),{code:0}},Hr=e=>{const{cwd:r,json:t,lines:o,logger:n,subcommand:s}=e;if(s==="stop")return Gr({cwd:r,json:t,logger:n});if(s==="status")return Ur({cwd:r,json:t,logger:n});if(s==="logs")return Vr({cwd:r,lines:o,logger:n});if(s!==void 0)return n.error(`dev: unknown subcommand "${s}" — expected stop | status | logs (or no subcommand to start the dev server)`),{code:1}},V="wrangler.dev.jsonc",H=6173,me=8787,W=5173,Wr=5e3,Br=(e,r)=>{const t=()=>{};if(!e.remote)return{args:[],plan:{bindings:[],cleanup:t,enabled:!1}};const o=(e.materializeRemote??Ue)({enabled:!0,projectRoot:r}),n=o.remoteBindings.map(i=>`${i.binding} (${i.kind})`),{cleanup:s}=o;return o.configPath===void 0?{args:[],plan:{bindings:n,cleanup:s,enabled:!0,reason:o.reason}}:{args:["--config",o.configPath],plan:{bindings:n,cleanup:s,enabled:!0}}},B=e=>se(e).parsed?.dev?.ip,J=(e,r,t)=>{if(t!==void 0){const n=b(e,t);if(N(n)&&B(n)!==void 0)return[]}const o=ne(e);return o!==void 0&&B(o)!==void 0?[]:r()?[]:["--ip","127.0.0.1"]},Jr=async(e,r)=>{if(e.workerPort!==void 0)return e.workerPort;const t=ne(r);if(t!==void 0){const{parsed:o}=se(t);if(typeof o?.dev?.port=="number")return o.dev.port}return(e.findFreePort??hr)(me)},Kr=e=>{const r=e.cwd??process.cwd(),t=ie(r),o=e.flavor??T(r);if(o==="vite"||o==="framework-worker"){const g=le(r);let m;if(o==="framework-worker"){const f=J(r,e.hasIpv6Loopback??F,V),l=_e(je(r)).toolchain?.dev({configPath:V,extraArgs:[...f,"--var","WORKER_ENV:development"]}),u=$(t,l?.tool??"wrangler",l?.args??[]);m={args:u.args,command:u.command,cwd:r,tag:"worker"}}return e.worker===!1&&e.logger.warn(`--no-worker does not apply to the ${o} flavor: Vite owns the worker, codegen and studio in-process. Run your framework's dev script instead.`),{codegenEnabled:!1,flavor:o,ipv4LoopbackForced:!1,remote:{bindings:[],cleanup:()=>{},enabled:e.remote===!0},...m?{sidecar:m}:{},studioEnabled:!1,studioPort:e.port??H,workerEnabled:!0,workerOrigin:`http://localhost:${String(W)}`,workerPort:W,wrangler:{args:g.args,command:g.command,cwd:r,...e.remote===!0?{env:{LUNORA_REMOTE:"1"}}:{},tag:"vite"}}}const n=re(r),s=n.framework==="none"?void 0:`this project uses ${n.framework} — the worker runs inside Vite there. run \`${Je(t,"dev")}\` for the full app (frontend + HMR); \`lunora dev\` starts only the worker.`,i=e.workerPort??me,a=Br(e,r),d=J(r,e.hasIpv6Loopback??F),c=$(t,"wrangler",["dev","--port",String(i),...d,"--var","WORKER_ENV:development",...a.args]);return{codegenEnabled:e.codegen!==!1,flavor:o,frameworkHint:s,ipv4LoopbackForced:d.length>0,remote:a.plan,studioEnabled:e.studio!==!1,studioPort:e.port??H,workerEnabled:e.worker!==!1,workerOrigin:`http://localhost:${String(i)}`,workerPort:i,wrangler:{args:c.args,command:c.command,cwd:r,tag:"wrangler"}}},K=(e,r,t,o)=>{if(e.length===0)return;const n=Fe(e);if(n){o[n.level](`[lunora] ${n.text}`);return}const s=`[${r}] ${e}`;t==="stderr"?o.warn(s):o.info(s)},qr=(e,r,t)=>{const o=(n,s)=>{if(!n)return;let i="";n.on("data",a=>{i+=a.toString("utf8");const d=i.split(`
`);i=d.pop()??"";for(const c of d)K(c.trimEnd(),r,s,t)}),n.on("end",()=>{K(i.trimEnd(),r,s,t),i=""})};o(e.stdout,"stdout"),o(e.stderr,"stderr")},zr=(e,r)=>{const t=ae(e.command,e.args),o=q(t.command,t.args,{cwd:e.cwd??process.cwd(),env:e.env?{...process.env,...e.env}:process.env,shell:t.shell,stdio:["inherit","pipe","pipe"]});return qr(o,e.tag,r),{exited:new Promise(n=>{o.on("error",s=>{r.error(`[${e.tag}] failed to start: ${s.message}`),n(1)}),o.on("exit",s=>{n(s??0)})}),kill:n=>{try{o.kill(n)}catch{}}}},Yr=(e,r,t)=>{e.info(""),e.success("Lunora dev"),e.info(`  ➜  Worker:     ${r.workerOrigin}`),t!==void 0&&e.info(`  ➜  Studio:  ${t}`),r.codegenEnabled&&e.info("  ➜  Codegen:    watching lunora/"),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("")},Xr=(e,r)=>{Q(r).installed||!xe()||(e.info(`  ⓘ  ${Ae}`),e.info(""))},Zr=(e,r)=>{if(process.env.LUNORA_CONTAINER_LOGS==="0")return;const t=Ce(e,"lunora").containers.map(o=>({className:o.className,exportName:o.exportName}));if(t.length!==0)return Me({containers:t,onLine:o=>{const n=`[container:${o.name}] ${o.text}`;o.level==="error"?r.warn(n):r.info(n)},onUnavailable:o=>{r.warn(`[container] Docker engine unreachable — container logs unavailable (${o})`)}})},Qr=async e=>{e.codegen?.close(),e.containerLogs?.close(),await e.studio?.close().catch(()=>{});try{e.remoteCleanup?.()}catch{}},eo=async(e,r)=>{try{const t=await Re({projectRoot:r}),o=Ne(t),n=(e.ensureExample??Le)(r,o);n.length>0&&e.logger.info(`Updated .dev.vars.example with secrets for: ${o.join(", ")} (${n.join(", ")})`)}catch{}(await(e.ensureEnv??Oe)({confirm:ur(),cwd:r,info:t=>{e.logger.info(t)}})).status==="declined"&&!Te()&&e.logger.info(`hint: ${A} was not scaffolded (non-interactive run). Copy ${Pe} → ${A} and fill in secrets, or run \`lunora dev\` in an interactive terminal to scaffold automatically.`);try{(e.fillSecrets??De)({cwd:r,info:t=>{e.logger.info(t)}})}catch{}},ro=(e,r,t,o)=>{if(e.flavor!=="wrangler")return;o!==void 0&&te(r,{studioUrl:o});let n;try{n=Zr(r,t)}catch{}return Yr(t,e,o),n},oo=(e,r)=>{const t=Number(process.env[k]),o=ee(r,{background:process.env[O]==="1",logFile:process.env[oe],mode:"cli",pid:process.pid,startedAt:new Date().toISOString(),url:e.workerOrigin},Number.isInteger(t)&&t>0?{supersedePid:t}:void 0);return o.ok?void 0:o.existing},to=async e=>{const r=e.cwd??process.cwd(),t=e.flavor??T(r),o=t==="wrangler"?await Jr(e,r):e.workerPort;return Kr({...e,cwd:r,flavor:t,workerPort:o})},no=async e=>await new Promise(r=>{const t={},o=i=>{e.info(`received ${i} — shutting down`),t.sigint&&process.off("SIGINT",t.sigint),t.sigterm&&process.off("SIGTERM",t.sigterm),r(0)},n=()=>{o("SIGINT")},s=()=>{o("SIGTERM")};t.sigint=n,t.sigterm=s,process.on("SIGINT",n),process.on("SIGTERM",s)}),so=async(e,r,t)=>{let o=0,n;const s=c=>{e.kill(c),r?.kill(c)},i=()=>{o+=1,o===1?(t.info("received SIGINT — shutting down (press Ctrl-C again to force-kill)"),s("SIGTERM"),n=setTimeout(()=>{s("SIGKILL")},Wr),n.unref()):s("SIGKILL")},a=()=>{s("SIGTERM")};process.on("SIGINT",i),process.on("SIGTERM",a);const d=await Promise.race([e.exited.then(c=>({code:c,who:"worker"})),...r===void 0?[]:[r.exited.then(c=>({code:c,who:"sidecar"}))]]);return r!==void 0&&(d.who==="sidecar"?(t.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])),n&&clearTimeout(n),process.off("SIGINT",i),process.off("SIGTERM",a),d.code},io=async(e,r,t,o)=>{if(r.studioEnabled)try{return await(e.startStudio??br)({cwd:t,logger:{warnOnce:n=>{o.warn(n)}},port:r.studioPort,workerOrigin:r.workerOrigin})}catch(n){o.warn(`studio server failed to start (${n instanceof Error?n.message:String(n)}) — continuing without it`);return}},ao=e=>{const r=[e.codegenEnabled?"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}.`},co=(e,r,t,o,n)=>{if(e.sidecar!==void 0)try{Z({apiSpec:r.apiSpec,lunoraDirectory:"lunora",projectRoot:t,target:n})}catch(s){o.warn(`codegen (pre-sidecar) failed: ${s instanceof Error?s.message:String(s)} — the framework dev server will retry`)}},lo=async e=>{const r=await to(e),{logger:t}=e,o=r.wrangler.cwd??process.cwd(),n=Ie(o,e.target),s={remoteCleanup:r.remote.cleanup};try{const i=Number(process.env[k]),a=E(o);if(a!==void 0&&a.pid!==process.pid&&a.pid!==i)return y(t,a),{code:0,plan:r};const d=oo(r,o);if(d!==void 0)return y(t,d),{code:0,plan:r};(r.flavor==="vite"||r.flavor==="framework-worker")&&(r.wrangler.env={...r.wrangler.env,[k]:String(process.pid)}),await eo(e,o),t.info(r.flavor==="vite"?"starting vite dev (worker + studio + codegen run inside Vite via @lunora/vite)":"starting wrangler dev + studio"),r.ipv4LoopbackForced&&t.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."),r.codegenEnabled&&(s.codegen=(e.startCodegen??mr)({apiSpec:e.apiSpec,logger:t,projectRoot:o,target:n})),s.studio=await io(e,r,o,t);const c=s.studio?.url;if(r.frameworkHint!==void 0&&t.warn(r.frameworkHint),!r.workerEnabled)return t.info(ao(r)),{code:await no(t),plan:r};co(r,e,o,t,n);const g=e.startWorker??zr,m=g(r.wrangler,t),f=r.sidecar===void 0?void 0:g(r.sidecar,t);return s.containerLogs=ro(r,o,t,c),Xr(t,o),{code:await so(m,f,t),plan:r}}finally{w(o,process.pid),await Qr(s)}},Po=Be(async({argument:e,cwd:r,logger:t,options:o})=>{const n=o.json===!0,s=Hr({cwd:r,json:n,lines:o.lines,logger:t,subcommand:e[0]});if(s!==void 0)return s;const i=process.env[O]==="1",a=i?void 0:Ee(),d=n||a!==void 0;d&&ze(),a!==void 0&&o.background!==!0&&t.info(`AI agent detected (${a.name} via ${a.variable}) — starting the dev server in background mode with JSON logs. Set LUNORA_AGENT_MODE=0 to opt out.`);const c=Ge({configPreference:$e(r),envValue:process.env.LUNORA_REMOTE,flag:o.remote});if(!i&&(o.background===!0||a!==void 0)){const g=E(r);return g!==void 0?(y(t,g),{code:0}):jr({cwd:r,jsonLogs:d,logger:t,options:o,remote:c})}return lo({apiSpec:Ve(o.apiSpec),codegen:o.codegen===!1?!1:void 0,cwd:r,logger:t,port:o.port,remote:c,studio:o.studio===!1?!1:void 0,target:o.target,workerPort:o.workerPort})});export{T as detectDevFlavor,Po as execute,Kr as planDevCommand,Jr as resolveWorkerPort,lo as runDevCommand};