infra-kit 0.5.0 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/dist/{boot-AJLBGRED.js → boot-BL4EQMZV.js} +2 -2
  2. package/dist/chunk-744Y674Y.js +10 -0
  3. package/dist/{chunk-DHYZ6MBU.js.map → chunk-744Y674Y.js.map} +4 -4
  4. package/dist/chunk-GF2CA4CD.js +2 -0
  5. package/dist/chunk-GF2CA4CD.js.map +7 -0
  6. package/dist/{chunk-4ZE5XSVW.js → chunk-IERRU26T.js} +2 -2
  7. package/dist/chunk-LCNORKDV.js +8 -0
  8. package/dist/chunk-LCNORKDV.js.map +7 -0
  9. package/dist/chunk-MFAFQVTW.js +2 -0
  10. package/dist/chunk-MFAFQVTW.js.map +7 -0
  11. package/dist/chunk-PQG63EIV.js +4 -0
  12. package/dist/chunk-PQG63EIV.js.map +7 -0
  13. package/dist/chunk-QJQQ7ENL.js +445 -0
  14. package/dist/chunk-QJQQ7ENL.js.map +7 -0
  15. package/dist/{chunk-HXBIE4JP.js → chunk-QUXDC3A3.js} +2 -2
  16. package/dist/{chunk-HXBIE4JP.js.map → chunk-QUXDC3A3.js.map} +1 -1
  17. package/dist/{chunk-7POMR4QK.js → chunk-XJOY7J3G.js} +1 -1
  18. package/dist/chunk-XJOY7J3G.js.map +7 -0
  19. package/dist/cli.js +12 -12
  20. package/dist/cli.js.map +4 -4
  21. package/dist/dev-server.js +4 -4
  22. package/dist/dev-server.js.map +1 -1
  23. package/dist/dev-wizard-run-DWDA5R3A.js +2 -0
  24. package/dist/{dev-wizard-run-FNMMYTDX.js.map → dev-wizard-run-DWDA5R3A.js.map} +1 -1
  25. package/dist/mcp-proxy.js +11 -0
  26. package/dist/mcp-proxy.js.map +7 -0
  27. package/dist/mcp.js +110 -1
  28. package/dist/mcp.js.map +4 -4
  29. package/dist/update-check.js +1 -1
  30. package/package.json +10 -9
  31. package/readme.md +1 -1
  32. package/dist/chunk-5OHTHRS7.js +0 -2
  33. package/dist/chunk-5OHTHRS7.js.map +0 -7
  34. package/dist/chunk-7POMR4QK.js.map +0 -7
  35. package/dist/chunk-D4UYDBN5.js +0 -3
  36. package/dist/chunk-D4UYDBN5.js.map +0 -7
  37. package/dist/chunk-DHYZ6MBU.js +0 -10
  38. package/dist/chunk-LXBIHXUR.js +0 -422
  39. package/dist/chunk-LXBIHXUR.js.map +0 -7
  40. package/dist/chunk-Q4HKBLQG.js +0 -7
  41. package/dist/chunk-Q4HKBLQG.js.map +0 -7
  42. package/dist/dev-wizard-run-FNMMYTDX.js +0 -2
  43. /package/dist/{boot-AJLBGRED.js.map → boot-BL4EQMZV.js.map} +0 -0
  44. /package/dist/{chunk-4ZE5XSVW.js.map → chunk-IERRU26T.js.map} +0 -0
@@ -1,4 +1,4 @@
1
- import{a as Le,c as L,f as re,j as Oe,k as N,l as H,m as Ue,n as B,t as Fe,u as Me,v as He,y as Be}from"./chunk-DHYZ6MBU.js";import"./chunk-7POMR4QK.js";import{a as O,b as je}from"./chunk-VDBJ73LS.js";import{$ as Ne,L as T,M as C,N as F,O as Pe,P as De,Q as M,R as ke,S as $,T as xe,U as Ae,V as Re,W as Ee,X as Te,Y as Ce,Z as $e,fa as te}from"./chunk-Q4HKBLQG.js";import{d as Ie,e as ne,m as _e}from"./chunk-D4UYDBN5.js";import{Command as Un}from"commander";import P from"node:process";import{pathToFileURL as Fn}from"node:url";import*as Ge from"node:path";import Kt from"node:process";var Vt=r=>({pane:{surfaces:[{type:"terminal",command:r}]}}),ie=(r,e)=>{if(r.length===1)return Vt(r[0]);let t=Math.ceil(r.length/2),n=r.slice(0,t),i=r.slice(t);return{direction:e%2===0?"horizontal":"vertical",split:Math.round(t/r.length*100)/100,children:[ie(n,e+1),ie(i,e+1)]}},We=r=>{if(r.length===0)throw new Error("buildCmuxLayout: at least one command is required");return ie(r,0)};var Jt=(r,e)=>r.map(({app:t,targets:n})=>`pnpm exec infra-kit dev ${n&&n.length>0?`--target=${n.join(",")}`:`--app=${t}`}${e?" --watch":""}`),qt=r=>{let e=new Map;for(let t of Object.keys(r?.apps??{})){let n=t.split("/")[0];n===void 0||n==="*"||e.set(n,[...e.get(n)??[],t])}return e},zt=(r,e)=>{let t=F(r);return e?t.filter(n=>e.includes(n.name)):t},Yt=(r,e)=>{T.info(`\u{1F9E9} Opened cmux dev workspace ${e} with ${r.length} pane(s):`);for(let t of r)T.info(` \u2022 ${t.name} (infra-kit dev --app=${t.name})`)},Xt=r=>{B({onSignal:async e=>{T.info(`
1
+ import{a as Ne,d as L,g as re,k as Oe,l as N,m as H,n as Ue,o as B,u as Fe,v as Me,w as He,z as Be}from"./chunk-744Y674Y.js";import{$ as xe,L as T,N as Pe,T as te,W as C,X as F,Y as De,Z as ke,_ as M,aa as $,ba as Ae,ca as Re,da as Ee,ea as Te,fa as Ce,ga as $e,ha as Le}from"./chunk-LCNORKDV.js";import"./chunk-MFAFQVTW.js";import"./chunk-XJOY7J3G.js";import{d as Ie,e as ne,n as _e}from"./chunk-PQG63EIV.js";import{a as O,b as je}from"./chunk-VDBJ73LS.js";import{Command as Un}from"commander";import P from"node:process";import{pathToFileURL as Fn}from"node:url";import*as Ge from"node:path";import Kt from"node:process";var Vt=r=>({pane:{surfaces:[{type:"terminal",command:r}]}}),ie=(r,e)=>{if(r.length===1)return Vt(r[0]);let t=Math.ceil(r.length/2),n=r.slice(0,t),i=r.slice(t);return{direction:e%2===0?"horizontal":"vertical",split:Math.round(t/r.length*100)/100,children:[ie(n,e+1),ie(i,e+1)]}},We=r=>{if(r.length===0)throw new Error("buildCmuxLayout: at least one command is required");return ie(r,0)};var Jt=(r,e)=>r.map(({app:t,targets:n})=>`pnpm exec infra-kit dev ${n&&n.length>0?`--target=${n.join(",")}`:`--app=${t}`}${e?" --watch":""}`),qt=r=>{let e=new Map;for(let t of Object.keys(r?.apps??{})){let n=t.split("/")[0];n===void 0||n==="*"||e.set(n,[...e.get(n)??[],t])}return e},zt=(r,e)=>{let t=F(r);return e?t.filter(n=>e.includes(n.name)):t},Yt=(r,e)=>{T.info(`\u{1F9E9} Opened cmux dev workspace ${e} with ${r.length} pane(s):`);for(let t of r)T.info(` \u2022 ${t.name} (infra-kit dev --app=${t.name})`)},Xt=r=>{B({onSignal:async e=>{T.info(`
2
2
  Received ${e}, closing cmux dev workspace ${r}...`),await He(r)}})},Ve=async r=>{let e=C(Kt.cwd()),t=zt(e,M(r.include));if(t.length===0){T.warn("No API apps found to run");return}let n=qt(r.presetDef),i=Jt(t.map(u=>({app:u.name,targets:n.get(u.name)})),r.watch??!1),s=We(i),o=`${Ge.basename(e)} dev`,a=await Me({cwd:e,title:o,layout:s});Yt(t,a),Xt(a);let l=setInterval(()=>{l.refresh()},2**30);await new Promise(()=>{})};import se from"node:process";var oe=r=>{try{se.stderr.write(r)}catch{}},I=(r,e,t=!0)=>{let n=e instanceof Error?`${e.message}
3
3
  ${e.stack??"(no stack)"}`:String(e);return`
4
4
  \u26A0\uFE0F ${r}: ${n}
@@ -21,7 +21,7 @@ ${t.join(`
21
21
  `);t=s.pop()??"";for(let o of s)n(o);t.length>tn&&(n(t),t="")}),r.on("end",()=>{t!==""&&(n(t),t="")}),r.on("error",i=>{e.appendLog?.(`[infra-kit] ui dev stream error: ${i.message}
22
22
  `)})},Nt=({packageNames:r,cwd:e,concurrency:t,env:n,appendLog:i,onLine:s,onTaskFailure:o,onUnexpectedExit:a})=>{let l=r.map(d=>`--filter=${d}`),u=Wr("pnpm",["exec","turbo","run","dev",...l,`--concurrency=${t}`,"--env-mode=loose","--only","--continue=dependencies-successful","--output-logs=new-only","--no-update-notifier","--ui=stream"],{cwd:e,detached:!0,stdio:["ignore","pipe","pipe"],env:{...Gr.env,...n}});return $t(u.stdout,{appendLog:i,onLine:s,onTaskFailure:o}),$t(u.stderr,{appendLog:i,onLine:s,onTaskFailure:o}),H(u,void 0,a)};var X="runner",gn="turbo",hn="watch",me=r=>`${Math.round(r/1e6)} MB`;function Y(r){let e=dn.homedir();return r===e||r.startsWith(`${e}${w.sep}`)?`~${r.slice(e.length)}`:r}function It(r){return r.map(e=>e.packageName).join(", ")}var fn=cn.promisify(ln),mn=async(r,e)=>{try{let{stderr:t}=await fn(r,{maxBuffer:33554432});t&&e&&e(` (build) ${t.trim()}`,"debug"),t&&!e&&console.error("stderr:",t)}catch(t){let n=t;throw e&&(n.stdout||n.stderr)&&(n.stdout&&e(` stdout: ${n.stdout.trim()}`,"error"),n.stderr&&e(` stderr: ${n.stderr.trim()}`,"error")),t}},Q=null;function Ut(r){Q?.write(X,r)}var vn=()=>new Promise((r,e)=>{let t=pn.createServer();t.unref(),t.on("error",e),t.listen(0,"127.0.0.1",()=>{let n=t.address(),i=typeof n=="object"&&n!==null?n.port:0;t.close(()=>r(i))})}),yn=r=>typeof r=="object",Z=async r=>(await r.body?.cancel(),{kind:"foreign",status:r.status,contentType:r.headers.get("content-type")}),wn=(r,e)=>{let t=e.contentType?.split(";")[0]?.trim(),n=t==null||t===""?`${e.status}`:`${e.status} ${t}`;return`port ${r} answered ${n}, not vite's ping \u2014 liveness cannot be verified`},bn=1500,_t={accept:"text/x-vite-ping"},Sn=r=>r.kind==="api"?`http://127.0.0.1:${r.port}/__health`:`http://127.0.0.1:${r.port}/`,Pn=(r,e)=>{try{return new URL(r,e)}catch{return null}},Dn=async(r,e)=>{let t=await fetch(r,{signal:e});return t.ok?(await t.body?.cancel(),"ok"):Z(t)},kn=async(r,e)=>{let t=await fetch(r,{headers:_t,redirect:"manual",signal:e});if(t.status===204)return"ok";if(t.status<300||t.status>=400)return Z(t);let n=t.headers.get("location"),i=n==null?null:Pn(n,r);if(i==null||i.origin!==new URL(r).origin)return Z(t);await t.body?.cancel();let s=await fetch(i,{headers:_t,redirect:"manual",signal:e});return s.status!==204?Z(s):(await s.body?.cancel(),"ok")},xn=async r=>{let e=Sn(r),t=AbortSignal.timeout(bn);try{return r.kind==="api"?await Dn(e,t):await kn(e,t)}catch{return"refused"}},An=[{name:"@slip-stream-kit/vite",floor:"0.1.134"},{name:"@slip-stream-kit/config",floor:"0.1.134"},{name:"infra-kit",floor:"0.1.132"}],Rn=(r,e)=>{let t=s=>s.split(".").map(o=>Number.parseInt(o,10)||0),n=t(r),i=t(e);for(let s=0;s<Math.max(n.length,i.length);s+=1){let o=n[s]??0,a=i[s]??0;if(o!==a)return o<a}return!1},En=r=>{let e=[r];try{for(let t of v.readdirSync(w.join(r,"apps"),{withFileTypes:!0}))if(t.isDirectory())for(let n of["api","ui"])e.push(w.join(r,"apps",t.name,n))}catch{}return e},Tn=(r,e)=>{try{let t=JSON.parse(v.readFileSync(w.join(r,"package.json"),"utf-8"));return["dependencies","devDependencies"].some(n=>t[n]?.[e]!=null)}catch{return!1}},Cn=(r,e,t)=>{let n=t.split("/"),i=e;for(;;){let s=w.join(i,"node_modules",...n);if(v.existsSync(s))return s;let o=w.dirname(i);if(i===r||o===i)return;i=o}},$n=(r,e)=>{try{let t=v.realpathSync(e),n=v.realpathSync(r);return t.startsWith(n+w.sep)&&!t.includes(`${w.sep}node_modules${w.sep}`)}catch{return!1}},Ln=r=>{try{return v.realpathSync(r)}catch{return r}},Nn=(r,e,t,n)=>{if($n(r,n))return;let i;try{let s=JSON.parse(v.readFileSync(w.join(n,"package.json"),"utf-8"));if(typeof s.version!="string")throw new Error("no version field");i=s.version}catch{throw new Error(`infra-kit dev: could not read the version of the pinned \`${e}\` helper (${n}). Refusing to start rather than risk proxying plain HTTP at a TLS listener. Run \`pnpm install\`.`)}if(Rn(i,t))throw new Error(`infra-kit dev: this repo pins ${e} ${i}, but dev URLs are now HTTPS and the \`infraKitDev\` helper only understands them from ${t}. An older helper would proxy plain HTTP at a TLS listener \u2014 silently. Bump the dependency:
23
23
  pnpm add -D ${e}@^${t}`)},On=r=>{let e=En(r);for(let{name:t,floor:n}of An){let i=e.filter(o=>Tn(o,t)),s=new Map;for(let o of[...i,r]){let a=Cn(r,o,t);a&&s.set(Ln(a),a)}if(s.size===0){if(i.length===0)continue;throw new Error(`infra-kit dev: ${i[0]}/package.json depends on ${t} but it does not resolve from there, so the \`infraKitDev\` helper version cannot be verified. Run \`pnpm install\`.`)}for(let o of s.values())Nn(r,t,n,o)}},ve=r=>{try{let e=un("git",["rev-parse","--abbrev-ref","HEAD"],{cwd:r,encoding:"utf-8"}).trim(),t=on(e);return t===""?Ot:t}catch{return Ot}},In=r=>{let t=(r instanceof Error?r.message:String(r)).split(`
24
- `)[0]?.trim()??"";return t===""?"unknown error (see the log)":t},ye=class r{monorepoRoot;devContextDir;appServers=[];reqTimes=new Map;lastSummary=null;readyAt=0;watchDebounceTimers=new Map;pendingChanges=new Map;moduleGeneration=null;watcher=null;static WATCH_DEBOUNCE_MS=400;restartWorkChain=Promise.resolve();static PORT_RELEASE_DELAY_MS=200;livenessTimer=null;health=new Map;firstErrorLogged=new Set;uiTagByPackage=new Map;static LIVENESS_INTERVAL_MS=5e3;static LIVENESS_FAILURE_THRESHOLD=2;static NEVER_UP_DOWN_THRESHOLD=6;options;runBuild;turboWatchFactory;turboWatch=null;uiDevFactory;uiDev=null;sink;intercept;dryRunner;failedApps=[];degradedRoutes=[];launchedUis=[];proxyRoutes=[];renderer;healthProbe;proxy;proxyPort=Ne;registeredAliases=new Set;uiPortMap={};shuttingDown=!1;closureMap=null;closureBuild=Promise.resolve();teardown=null;stage="idle";constructor(e={},t=mn,n=Ct,i=Nt,s,o,a=xn,l=Oe(),u){this.options=e,this.runBuild=t,this.turboWatchFactory=n,this.uiDevFactory=i,this.dryRunner=s,this.proxy=l,this.sink=u??new K,Q=this.sink;let d=Ft(this.options);this.intercept=d?bt({sink:this.sink,fallbackService:X,currentService:W}):null,this.renderer=o??new je({appendLog:Ut,verbose:this.options.verbose??!1,isTTY:d}),this.healthProbe=a,this.devContextDir=w.join(m.cwd(),".infra-kit","dev-context"),this.monorepoRoot=C(m.cwd()),(m.env.DOPPLER_PROJECT!=null||m.env.DOPPLER_ENVIRONMENT!=null)&&this.renderer.log("\u{1F510} Doppler env detected (DOPPLER_PROJECT / DOPPLER_ENVIRONMENT)","debug")}discoverApiApps(e){return F(this.monorepoRoot).map(t=>({...t,preferredPort:this.resolvePreferredPort(t.name,e),appScopedPort:this.resolvePreferredPort(t.name,e,!1),prefixUrl:this.resolvePrefixUrl(t.name,e),watchDeps:!0}))}async loadDevConfig(){try{return(await te()).dev??{}}catch{return{}}}normalizeAppInclude(){return M(this.options.include)}resolvePreferredPort(e,t,n=!0){return Pt(e,m.env,t,n)}resolvePrefixUrl(e,t){return Dt(e,t)}async loadDevPresets(){try{return(await te()).devServersPresets??{}}catch{return{}}}resolvePresetDef(e){if(this.options.presetDef!=null)return this.options.presetDef;let t=this.options.preset;if(t==null)return{};let n=e[t];if(!n){let i=Object.keys(e);throw new Error(`Unknown dev preset "${t}". Available: ${i.length>0?i.join(", "):"(none defined in devServersPresets)"}`)}return n}assertPresetKeysValid(e){let t=this.options.preset??"dev",n=Ee({[t]:e});if(n.length!==0)throw new Error(`infra-kit dev: cannot run this preset \u2014 ${n.map(i=>i.message).join("; ")}`)}async assertPresetProxyLocalityValid(e,t,n,i){let s={[e]:t},{ctx:o,loadErrors:a}=await Le(this.monorepoRoot,s,n,i);if(a.length>0)return;let l=$e(s,o);if(l.length!==0)throw new Error(`infra-kit dev: cannot run this preset \u2014 ${l.map(u=>u.message).join("; ")}`)}async start(){let e=Date.now(),t=this.normalizeAppInclude(),n=this.options.watch??!1,i=await this.loadDevConfig();m.env.POWERTOOLS_DEV??="true",m.env.LOG_LEVEL??="DEBUG",this.renderer.narrate("\u{1F680} Starting Development Server Runner"),n&&this.renderer.narrate("\u{1F440} Watch mode: will rebuild and restart on file save");let{apps:s,uiApps:o,apiAppsAll:a,uiAppsAll:l,wantedLocalPkgs:u,presetProxy:d}=await this.resolveRunPlan(i,t);if(s.length===0&&o.length===0){this.renderer.log("\u26A0\uFE0F No API or UI apps to run for this preset","warn");return}this.warnUiMissingVitePlugin(o),n&&this.installModuleGeneration(),await this.bringUpProxy(s),await this.buildAll(s,o,n),s.length>0&&(this.renderer.bootStep("starting servers"),await this.startAllApps(s),this.renderer.narrate(this.failedApps.length===0?"\u{1F389} All servers started!":`\u26A0\uFE0F ${this.appServers.length}/${s.length} servers started \u2014 ${this.failedApps.length} failed`),this.renderer.narrate(`\u{1F4DD} Logs \u2192 ${Y(this.sink.dir)} (one file per service)`));let h=Ce({preset:this.options.preset,running:[...s.map(g=>`${g.name}/api`),...o.map(g=>`${g.name}/ui`)],discovered:[...a.map(g=>`${g.name}/api`),...l.map(g=>`${g.name}/ui`)]});if(this.degradedRoutes=await this.collectDegradedRoutes(o,u,d),this.degradedRoutes.length>0&&!n)throw new Error(tt(this.degradedRoutes,h));if(await this.printReady(s,o,e,h),this.options.routes&&this.printRouteDump(),this.appServers.length===0&&o.length===0&&this.failedApps.length>0)throw new Error(`infra-kit dev: no app started (${this.failedApps.length} of ${s.length} failed). First failure: ${this.failedApps[0]?.reason??"unknown"}`);this.armWatch(s,o,n),o.length>0&&this.startUiDev(o),this.startLivenessMonitor()}async resolveRunPlan(e,t){let n=this.discoverApiApps(e),i=De(this.monorepoRoot),s=await this.loadDevPresets(),o=this.resolvePresetDef(s);this.assertPresetKeysValid(o);let a={api:n.map(c=>c.name),ui:i.map(c=>c.name)};this.options.presetDef==null&&this.options.preset!=null&&await this.assertPresetProxyLocalityValid(this.options.preset,o,a,n);let l=Te(o,a);l.unmatched.length>0&&this.renderer.log(`\u26A0\uFE0F Preset targets not found (skipped): ${l.unmatched.join(", ")}`,"warn");let u=new Set(l.targets.filter(c=>c.part==="api").map(c=>c.app)),d=new Set(l.targets.filter(c=>c.part==="ui").map(c=>c.app)),h=c=>!t||t.includes(c),g=new Map(l.targets.filter(c=>c.part==="api").map(c=>[c.app,c.watchDeps])),p=n.filter(c=>u.has(c.name)&&h(c.name)),f=p.map(c=>({...c,watchDeps:g.get(c.name)??c.watchDeps,preferredPort:p.length===1?c.preferredPort:c.appScopedPort})),y=i.filter(c=>d.has(c.name)&&h(c.name)),b=new Set(n.filter(c=>u.has(c.name)).map(c=>c.packageName));return{apps:f,uiApps:y,apiAppsAll:n,uiAppsAll:i,wantedLocalPkgs:b,presetProxy:l.proxy}}async collectDegradedRoutes(e,t,n){if(e.length===0)return[];let i=[];for(let s of e){let o=await nn(s.path).catch(()=>{});if(!o?.proxy)continue;let a=n[s.name]??{},l=Object.fromEntries(Object.entries(o.proxy.routes).map(([u,d])=>[u,{...d,pinnedLocal:a[u]==="local"}]));i.push({app:s.name,routes:l,cloudTemplate:o.proxy.templates.cloud})}return this.launchedUis=i,Qe({uis:i,wanted:t,running:new Set(this.appServers.map(({app:s})=>s.packageName)),reasons:new Map(this.failedApps.map(({app:s,reason:o})=>[s.packageName,{app:s.name,reason:o}])),env:m.env[ne]})}warnUiMissingVitePlugin(e){for(let t of e)!t.managedPort||Pe(t.path)||this.renderer.log(`\u26A0\uFE0F ${t.name}/ui is wired with the infra-kit vite helper directly, not the infraKit() plugin \u2014 its proxy is baked at config load and won't react to backend routing changes. Wire the infraKit() vite plugin (from @slip-stream-kit/vite) instead.`,"warn")}proxiesFor(e){let t=this.proxyRoutes.filter(n=>n.uiApp===e).map(n=>({route:n.route,source:n.source,target:n.target}));return t.length>0?t:void 0}async bringUpProxy(e){On(C(m.cwd())),await this.ensureProxy(),e.length>0&&this.assertNoPortConflicts(e)}async buildAll(e,t,n){let i=[e.length>0?`building ${It(e)}`:"",t.length>0?`warming ${It(t)}`:""].filter(Boolean).join(" \xB7 ");this.renderer.bootStep(i),e.length>0&&await this.buildApps(e,n),t.length>0&&await this.buildUiApps(t)}armWatch(e,t,n){n&&(this.appServers.length>0||t.length>0)&&(this.setupWatch(e,t),this.closureBuild=this.buildClosureMapSafe(e).then(i=>{this.closureMap=i}))}async buildUiApps(e){let t=e.map(n=>`--filter=${n.packageName}^...`).join(" ");try{await this.runBuild(`pnpm exec turbo run build ${t} --env-mode=loose --output-logs=errors-only --no-update-notifier`,this.renderer.logFn),this.renderer.narrate("\u2705 UI deps built")}catch(n){this.renderer.log(`\u26A0\uFE0F UI dep build failed (continuing; vite will report unresolved deps): ${String(n)}`,"warn")}}startUiDev(e){let t=e.map(o=>o.name).join(", ");this.renderer.narrate(`\u{1F3A8} Starting ${e.length} UI dev server(s) via \`turbo run dev\`: ${t}`),this.renderer.narrate(" (framework output is routed into the live tail; full detail in the runner log)");let n=Object.keys(this.uiPortMap).length>0?{INFRA_KIT_UI_PORTS:JSON.stringify(this.uiPortMap)}:void 0,i=m.env.NODE_EXTRA_CA_CERTS==null&&v.existsSync(re())?{NODE_EXTRA_CA_CERTS:re()}:void 0,s=new Map(e.map(o=>[o.packageName,`${o.name}/ui`]));this.uiDev=this.uiDevFactory({packageNames:e.map(o=>o.packageName),cwd:m.cwd(),concurrency:Math.max(e.length+4,12),env:n||i?{...n,...i}:void 0,appendLog:o=>{this.sink.write(gn,o)},onLine:({pkg:o,text:a,level:l})=>{let u=s.get(o)??`${o}/ui`;this.sink.write(u,a,{level:l})},onTaskFailure:o=>{this.markUiTaskFailed(s.get(o)??`${o}/ui`)},onUnexpectedExit:o=>{this.markUiEngineDead(),this.reportEngineDeath("UI dev engine (`turbo run dev`)","frontends stopped reloading",o)}})}formatAppList(e){return e.map(t=>`${t.name}:${t.port}`).join(", ")}assertNoPortConflicts(e){let t=e.filter(s=>s.preferredPort!=null).map(s=>({name:s.name,port:s.preferredPort})),{duplicatePorts:n,conflictingApps:i}=kt(t);if(n.length!==0)throw this.renderer.log(`\u26A0\uFE0F Port conflict detected! ${n.join(", ")}`,"error"),this.renderer.log(`Conflicting apps: ${this.formatAppList(i)}`,"error"),this.renderer.log("\n\u{1F4A1} Tip: give each app a distinct port via `{APP}_PORT` env (e.g. `CLIENT_PORT=`,","error"),this.renderer.log(" `SEARCH_ENGINE_PORT=`) or `dev.<app>.port` in infra-kit.json; or run a subset with","error"),this.renderer.log(" `--app=<name>,<name>`.\n","error"),new Error(`Port conflict detected: ${n.join(", ")}`)}async buildApps(e,t){let i=`pnpm exec turbo run build ${e.map(s=>`--filter=${s.packageName}`).join(" ")} --env-mode=loose --output-logs=errors-only --no-update-notifier${t?" --force":""}`;try{await this.runBuild(i,this.renderer.logFn),this.renderer.narrate("\u2705 Build complete")}catch(s){this.renderer.log(`\u274C Build failed: ${String(s)}`,"error"),s instanceof Error&&s.message&&this.renderer.log(` ${s.message}`,"error");let o=s;throw o.stdout&&this.renderer.log(` stdout: ${o.stdout.trim()}`,"error"),o.stderr&&this.renderer.log(` stderr: ${o.stderr.trim()}`,"error"),s}}async startAllApps(e){await Promise.all(e.map(async t=>{try{let n=await this.startOneApp(t);n&&this.appServers.push({app:t,...n,startedAt:Date.now(),restarts:0})}catch(n){this.renderer.log(`\u274C Failed to start ${t.name}: ${String(n)}`,"error"),this.failedApps.push({app:t,reason:In(n)})}}))}async ensureProxy(){let e=this.proxy.binPath();if(e==null||!await this.proxy.isAvailable())throw new Error("infra-kit dev: portless is not installed, so no dev URL can resolve. It ships as a dependency of infra-kit \u2014 reinstall with `pnpm install`.");let t=await this.proxy.probeProxy(this.proxyPort,!0);if(t!=="serving")throw t==="not-portless"?new Error(`infra-kit dev: something else is already listening on :${this.proxyPort}, and it is not portless (no \`X-Portless\` header on the wire). Find and stop it, e.g. \`sudo lsof -iTCP:${this.proxyPort} -sTCP:LISTEN\`. Installing or trusting portless will not help while another process holds the port.`):this.proxy.isServiceInstalled()==="no"?new Error(`infra-kit dev: no portless daemon is serving HTTPS on :${this.proxyPort}, and its OS service is not installed yet, so no dev URL can resolve. Install it once (this is the only step that needs root):
24
+ `)[0]?.trim()??"";return t===""?"unknown error (see the log)":t},ye=class r{monorepoRoot;devContextDir;appServers=[];reqTimes=new Map;lastSummary=null;readyAt=0;watchDebounceTimers=new Map;pendingChanges=new Map;moduleGeneration=null;watcher=null;static WATCH_DEBOUNCE_MS=400;restartWorkChain=Promise.resolve();static PORT_RELEASE_DELAY_MS=200;livenessTimer=null;health=new Map;firstErrorLogged=new Set;uiTagByPackage=new Map;static LIVENESS_INTERVAL_MS=5e3;static LIVENESS_FAILURE_THRESHOLD=2;static NEVER_UP_DOWN_THRESHOLD=6;options;runBuild;turboWatchFactory;turboWatch=null;uiDevFactory;uiDev=null;sink;intercept;dryRunner;failedApps=[];degradedRoutes=[];launchedUis=[];proxyRoutes=[];renderer;healthProbe;proxy;proxyPort=Pe;registeredAliases=new Set;uiPortMap={};shuttingDown=!1;closureMap=null;closureBuild=Promise.resolve();teardown=null;stage="idle";constructor(e={},t=mn,n=Ct,i=Nt,s,o,a=xn,l=Oe(),u){this.options=e,this.runBuild=t,this.turboWatchFactory=n,this.uiDevFactory=i,this.dryRunner=s,this.proxy=l,this.sink=u??new K,Q=this.sink;let d=Ft(this.options);this.intercept=d?bt({sink:this.sink,fallbackService:X,currentService:W}):null,this.renderer=o??new je({appendLog:Ut,verbose:this.options.verbose??!1,isTTY:d}),this.healthProbe=a,this.devContextDir=w.join(m.cwd(),".infra-kit","dev-context"),this.monorepoRoot=C(m.cwd()),(m.env.DOPPLER_PROJECT!=null||m.env.DOPPLER_ENVIRONMENT!=null)&&this.renderer.log("\u{1F510} Doppler env detected (DOPPLER_PROJECT / DOPPLER_ENVIRONMENT)","debug")}discoverApiApps(e){return F(this.monorepoRoot).map(t=>({...t,preferredPort:this.resolvePreferredPort(t.name,e),appScopedPort:this.resolvePreferredPort(t.name,e,!1),prefixUrl:this.resolvePrefixUrl(t.name,e),watchDeps:!0}))}async loadDevConfig(){try{return(await te()).dev??{}}catch{return{}}}normalizeAppInclude(){return M(this.options.include)}resolvePreferredPort(e,t,n=!0){return Pt(e,m.env,t,n)}resolvePrefixUrl(e,t){return Dt(e,t)}async loadDevPresets(){try{return(await te()).devServersPresets??{}}catch{return{}}}resolvePresetDef(e){if(this.options.presetDef!=null)return this.options.presetDef;let t=this.options.preset;if(t==null)return{};let n=e[t];if(!n){let i=Object.keys(e);throw new Error(`Unknown dev preset "${t}". Available: ${i.length>0?i.join(", "):"(none defined in devServersPresets)"}`)}return n}assertPresetKeysValid(e){let t=this.options.preset??"dev",n=Te({[t]:e});if(n.length!==0)throw new Error(`infra-kit dev: cannot run this preset \u2014 ${n.map(i=>i.message).join("; ")}`)}async assertPresetProxyLocalityValid(e,t,n,i){let s={[e]:t},{ctx:o,loadErrors:a}=await Ne(this.monorepoRoot,s,n,i);if(a.length>0)return;let l=Le(s,o);if(l.length!==0)throw new Error(`infra-kit dev: cannot run this preset \u2014 ${l.map(u=>u.message).join("; ")}`)}async start(){let e=Date.now(),t=this.normalizeAppInclude(),n=this.options.watch??!1,i=await this.loadDevConfig();m.env.POWERTOOLS_DEV??="true",m.env.LOG_LEVEL??="DEBUG",this.renderer.narrate("\u{1F680} Starting Development Server Runner"),n&&this.renderer.narrate("\u{1F440} Watch mode: will rebuild and restart on file save");let{apps:s,uiApps:o,apiAppsAll:a,uiAppsAll:l,wantedLocalPkgs:u,presetProxy:d}=await this.resolveRunPlan(i,t);if(s.length===0&&o.length===0){this.renderer.log("\u26A0\uFE0F No API or UI apps to run for this preset","warn");return}this.warnUiMissingVitePlugin(o),n&&this.installModuleGeneration(),await this.bringUpProxy(s),await this.buildAll(s,o,n),s.length>0&&(this.renderer.bootStep("starting servers"),await this.startAllApps(s),this.renderer.narrate(this.failedApps.length===0?"\u{1F389} All servers started!":`\u26A0\uFE0F ${this.appServers.length}/${s.length} servers started \u2014 ${this.failedApps.length} failed`),this.renderer.narrate(`\u{1F4DD} Logs \u2192 ${Y(this.sink.dir)} (one file per service)`));let h=$e({preset:this.options.preset,running:[...s.map(g=>`${g.name}/api`),...o.map(g=>`${g.name}/ui`)],discovered:[...a.map(g=>`${g.name}/api`),...l.map(g=>`${g.name}/ui`)]});if(this.degradedRoutes=await this.collectDegradedRoutes(o,u,d),this.degradedRoutes.length>0&&!n)throw new Error(tt(this.degradedRoutes,h));if(await this.printReady(s,o,e,h),this.options.routes&&this.printRouteDump(),this.appServers.length===0&&o.length===0&&this.failedApps.length>0)throw new Error(`infra-kit dev: no app started (${this.failedApps.length} of ${s.length} failed). First failure: ${this.failedApps[0]?.reason??"unknown"}`);this.armWatch(s,o,n),o.length>0&&this.startUiDev(o),this.startLivenessMonitor()}async resolveRunPlan(e,t){let n=this.discoverApiApps(e),i=ke(this.monorepoRoot),s=await this.loadDevPresets(),o=this.resolvePresetDef(s);this.assertPresetKeysValid(o);let a={api:n.map(c=>c.name),ui:i.map(c=>c.name)};this.options.presetDef==null&&this.options.preset!=null&&await this.assertPresetProxyLocalityValid(this.options.preset,o,a,n);let l=Ce(o,a);l.unmatched.length>0&&this.renderer.log(`\u26A0\uFE0F Preset targets not found (skipped): ${l.unmatched.join(", ")}`,"warn");let u=new Set(l.targets.filter(c=>c.part==="api").map(c=>c.app)),d=new Set(l.targets.filter(c=>c.part==="ui").map(c=>c.app)),h=c=>!t||t.includes(c),g=new Map(l.targets.filter(c=>c.part==="api").map(c=>[c.app,c.watchDeps])),p=n.filter(c=>u.has(c.name)&&h(c.name)),f=p.map(c=>({...c,watchDeps:g.get(c.name)??c.watchDeps,preferredPort:p.length===1?c.preferredPort:c.appScopedPort})),y=i.filter(c=>d.has(c.name)&&h(c.name)),b=new Set(n.filter(c=>u.has(c.name)).map(c=>c.packageName));return{apps:f,uiApps:y,apiAppsAll:n,uiAppsAll:i,wantedLocalPkgs:b,presetProxy:l.proxy}}async collectDegradedRoutes(e,t,n){if(e.length===0)return[];let i=[];for(let s of e){let o=await nn(s.path).catch(()=>{});if(!o?.proxy)continue;let a=n[s.name]??{},l=Object.fromEntries(Object.entries(o.proxy.routes).map(([u,d])=>[u,{...d,pinnedLocal:a[u]==="local"}]));i.push({app:s.name,routes:l,cloudTemplate:o.proxy.templates.cloud})}return this.launchedUis=i,Qe({uis:i,wanted:t,running:new Set(this.appServers.map(({app:s})=>s.packageName)),reasons:new Map(this.failedApps.map(({app:s,reason:o})=>[s.packageName,{app:s.name,reason:o}])),env:m.env[ne]})}warnUiMissingVitePlugin(e){for(let t of e)!t.managedPort||De(t.path)||this.renderer.log(`\u26A0\uFE0F ${t.name}/ui is wired with the infra-kit vite helper directly, not the infraKit() plugin \u2014 its proxy is baked at config load and won't react to backend routing changes. Wire the infraKit() vite plugin (from @slip-stream-kit/vite) instead.`,"warn")}proxiesFor(e){let t=this.proxyRoutes.filter(n=>n.uiApp===e).map(n=>({route:n.route,source:n.source,target:n.target}));return t.length>0?t:void 0}async bringUpProxy(e){On(C(m.cwd())),await this.ensureProxy(),e.length>0&&this.assertNoPortConflicts(e)}async buildAll(e,t,n){let i=[e.length>0?`building ${It(e)}`:"",t.length>0?`warming ${It(t)}`:""].filter(Boolean).join(" \xB7 ");this.renderer.bootStep(i),e.length>0&&await this.buildApps(e,n),t.length>0&&await this.buildUiApps(t)}armWatch(e,t,n){n&&(this.appServers.length>0||t.length>0)&&(this.setupWatch(e,t),this.closureBuild=this.buildClosureMapSafe(e).then(i=>{this.closureMap=i}))}async buildUiApps(e){let t=e.map(n=>`--filter=${n.packageName}^...`).join(" ");try{await this.runBuild(`pnpm exec turbo run build ${t} --env-mode=loose --output-logs=errors-only --no-update-notifier`,this.renderer.logFn),this.renderer.narrate("\u2705 UI deps built")}catch(n){this.renderer.log(`\u26A0\uFE0F UI dep build failed (continuing; vite will report unresolved deps): ${String(n)}`,"warn")}}startUiDev(e){let t=e.map(o=>o.name).join(", ");this.renderer.narrate(`\u{1F3A8} Starting ${e.length} UI dev server(s) via \`turbo run dev\`: ${t}`),this.renderer.narrate(" (framework output is routed into the live tail; full detail in the runner log)");let n=Object.keys(this.uiPortMap).length>0?{INFRA_KIT_UI_PORTS:JSON.stringify(this.uiPortMap)}:void 0,i=m.env.NODE_EXTRA_CA_CERTS==null&&v.existsSync(re())?{NODE_EXTRA_CA_CERTS:re()}:void 0,s=new Map(e.map(o=>[o.packageName,`${o.name}/ui`]));this.uiDev=this.uiDevFactory({packageNames:e.map(o=>o.packageName),cwd:m.cwd(),concurrency:Math.max(e.length+4,12),env:n||i?{...n,...i}:void 0,appendLog:o=>{this.sink.write(gn,o)},onLine:({pkg:o,text:a,level:l})=>{let u=s.get(o)??`${o}/ui`;this.sink.write(u,a,{level:l})},onTaskFailure:o=>{this.markUiTaskFailed(s.get(o)??`${o}/ui`)},onUnexpectedExit:o=>{this.markUiEngineDead(),this.reportEngineDeath("UI dev engine (`turbo run dev`)","frontends stopped reloading",o)}})}formatAppList(e){return e.map(t=>`${t.name}:${t.port}`).join(", ")}assertNoPortConflicts(e){let t=e.filter(s=>s.preferredPort!=null).map(s=>({name:s.name,port:s.preferredPort})),{duplicatePorts:n,conflictingApps:i}=kt(t);if(n.length!==0)throw this.renderer.log(`\u26A0\uFE0F Port conflict detected! ${n.join(", ")}`,"error"),this.renderer.log(`Conflicting apps: ${this.formatAppList(i)}`,"error"),this.renderer.log("\n\u{1F4A1} Tip: give each app a distinct port via `{APP}_PORT` env (e.g. `CLIENT_PORT=`,","error"),this.renderer.log(" `SEARCH_ENGINE_PORT=`) or `dev.<app>.port` in infra-kit.json; or run a subset with","error"),this.renderer.log(" `--app=<name>,<name>`.\n","error"),new Error(`Port conflict detected: ${n.join(", ")}`)}async buildApps(e,t){let i=`pnpm exec turbo run build ${e.map(s=>`--filter=${s.packageName}`).join(" ")} --env-mode=loose --output-logs=errors-only --no-update-notifier${t?" --force":""}`;try{await this.runBuild(i,this.renderer.logFn),this.renderer.narrate("\u2705 Build complete")}catch(s){this.renderer.log(`\u274C Build failed: ${String(s)}`,"error"),s instanceof Error&&s.message&&this.renderer.log(` ${s.message}`,"error");let o=s;throw o.stdout&&this.renderer.log(` stdout: ${o.stdout.trim()}`,"error"),o.stderr&&this.renderer.log(` stderr: ${o.stderr.trim()}`,"error"),s}}async startAllApps(e){await Promise.all(e.map(async t=>{try{let n=await this.startOneApp(t);n&&this.appServers.push({app:t,...n,startedAt:Date.now(),restarts:0})}catch(n){this.renderer.log(`\u274C Failed to start ${t.name}: ${String(n)}`,"error"),this.failedApps.push({app:t,reason:In(n)})}}))}async ensureProxy(){let e=this.proxy.binPath();if(e==null||!await this.proxy.isAvailable())throw new Error("infra-kit dev: portless is not installed, so no dev URL can resolve. It ships as a dependency of infra-kit \u2014 reinstall with `pnpm install`.");let t=await this.proxy.probeProxy(this.proxyPort,!0);if(t!=="serving")throw t==="not-portless"?new Error(`infra-kit dev: something else is already listening on :${this.proxyPort}, and it is not portless (no \`X-Portless\` header on the wire). Find and stop it, e.g. \`sudo lsof -iTCP:${this.proxyPort} -sTCP:LISTEN\`. Installing or trusting portless will not help while another process holds the port.`):this.proxy.isServiceInstalled()==="no"?new Error(`infra-kit dev: no portless daemon is serving HTTPS on :${this.proxyPort}, and its OS service is not installed yet, so no dev URL can resolve. Install it once (this is the only step that needs root):
25
25
  ${L(["service","install"],{sudo:!0,bin:e})}
26
26
  Then trust its local CA (no sudo needed):
27
27
  ${L(["trust"],{bin:e})}
@@ -29,10 +29,10 @@ Then trust its local CA (no sudo needed):
29
29
  ${L(["service","status"],{bin:e})}
30
30
  Reinstalling restarts it (still the only step that needs root):
31
31
  ${L(["service","install"],{sudo:!0,bin:e})}
32
- \`infra-kit doctor\` checks the daemon and CA trust state.`)}async registerAppAlias(e,t,n){let i=ve(t),s=sn(e);if(s==="")throw new Error(`infra-kit dev: package name "${e}" has no letters or digits to build a hostname from.`);let o=`${i}.${s}`;if(!await this.proxy.registerAlias(o,n))throw new Error(`infra-kit dev: portless refused the alias "${o}" \u2192 127.0.0.1:${n}.`);return this.registeredAliases.add(o),`${o}.localhost`}async startOneApp(e){this.renderer.narrate(`\u{1F504} Starting ${e.name}...`);let t=new q({controllersPath:e.path,prefixUrl:e.prefixUrl,port:e.preferredPort,appName:e.name,serviceTag:`${e.name}/api`,onRequestLog:({method:s,path:o,status:a,ms:l})=>{if(o==="/__health")return;let u=`${e.name}/api`,d=`${s} ${o} ${a} ${l}ms`;this.sink.write(u,d,{level:a>=500?"error":"info"});let h=this.reqTimes.get(u);h?h.push(Date.now()):this.reqTimes.set(u,[Date.now()])}}),n=await t.start(),i;try{i=await this.registerAppAlias(e.packageName,e.path,n)}catch(s){throw await t.close().catch(()=>{}),s}try{this.writeDevContextFragment(e,n,i)}catch(s){this.renderer.log(`\u26A0\uFE0F Failed to write dev-context fragment for ${e.name}: ${String(s)}`,"warn")}return this.renderer.narrate(`\u2705 ${e.name} started on port ${n}`),{server:t,boundPort:n,alias:i}}writeDevContextFragment(e,t,n){let i={v:rn,package:e.packageName,port:t,pid:m.pid,writtenAt:Date.now(),release:ve(e.path),alias:n,origin:`https://${n}`},s=w.join(this.devContextDir,`${e.name}.json`),o=w.join(this.devContextDir,`${e.name}.json.${m.pid}.tmp`);v.mkdirSync(this.devContextDir,{recursive:!0}),v.writeFileSync(o,JSON.stringify(i,null,2)),v.renameSync(o,s)}removeDevContextFragment(e){v.rmSync(w.join(this.devContextDir,`${e.name}.json`),{force:!0})}scheduleRestartWork(e){let t=this.restartWorkChain.then(()=>e(),()=>e());return this.restartWorkChain=t.catch(()=>{}),t}async delayPortRelease(){await new Promise(e=>setTimeout(e,r.PORT_RELEASE_DELAY_MS))}restart(e,t=[]){return this.shuttingDown?Promise.resolve():this.scheduleRestartWork(()=>this.shuttingDown?Promise.resolve():this.runRestart(e,t))}resolveRestartTargets(e){return e.map(t=>({idx:this.appServers.findIndex(n=>n.app.name===t.name),app:t})).filter(t=>t.idx>=0||this.isFailedApp(t.app.name))}isFailedApp(e){return this.failedApps.some(t=>t.app.name===e)}promoteRecoveredApp(e,t){let n={app:e,...t,startedAt:Date.now(),restarts:0},i=`${e.name}/api`;this.healthEntry(i,"api"),this.appServers.push(n);let s=this.failedApps.findIndex(o=>o.app.name===e.name);return s>=0&&this.failedApps.splice(s,1),this.lastSummary&&(this.lastSummary={...this.lastSummary,endpoints:[...this.lastSummary.endpoints,{tag:i,url:O({prefixUrl:e.prefixUrl,alias:t.alias}),health:this.healthOf(i)}],failed:(this.lastSummary.failed??[]).filter(o=>o.tag!==i)}),n}async runRestart(e,t=[]){let n=this.resolveRestartTargets(e);if(n.length===0)return;let i=n.length===1?n[0].app.name:`${n.length} apps`,s=this.moduleGeneration?.budgetState()??"ok";if(s==="stop"){this.reportGenerationBudgetStop(ce(m.env.INFRA_KIT_DEV_STOP_BYTES).stopBytes),this.shutdown().catch(()=>{}).finally(()=>{this.options.onExitRequest?.(1)}).catch(()=>{});return}s==="warn"&&this.reportGenerationBudgetWarn(),this.moduleGeneration?.bump(),this.renderer.log(`\u{1F504} Restarting ${i}...`),await Promise.all(n.map(async({idx:g})=>{if(!(g<0))try{await this.appServers[g].server.close()}catch(p){this.renderer.log(` Close warning: ${String(p)}`,"debug")}})),await this.delayPortRelease();let o=await Promise.all(n.map(async({idx:g,app:p})=>{try{let f=await this.startOneApp(p);if(f){if(g<0){let c=this.promoteRecoveredApp(p,f);return this.renderer.log(`\u2705 ${p.name} recovered \u2014 its routes are served locally again`,"info"),{app:p,entry:c}}let y=this.appServers[g],b={app:p,...f,startedAt:Date.now(),restarts:(y?.restarts??0)+1};return this.appServers[g]=b,{app:p,entry:b}}return{app:p,entry:null}}catch(f){return this.renderer.log(`\u274C Failed to ${g<0?"start":"restart"} ${p.name}: ${String(f)}`,"error"),{app:p,entry:null}}})),a=await Promise.all(o.map(async({app:g,entry:p})=>{let f=`${g.name}/api`;if(p==null)return this.markDown(f,"api"),this.refreshStatus(),{label:`${g.name} \u25CF down`,healthy:!1};let y={tag:f,port:p.boundPort,kind:"api"},b=await this.healthProbe(y);this.recordProbe(y,b),this.refreshStatus();let c=b==="ok";return{label:`${g.name}:${p.boundPort} ${c?"\u25CF up":"\u25CF down"}`,healthy:c}})),l=a.every(g=>g.healthy),u=a.map(g=>g.label).join(", "),h=o.some(g=>g.entry!==null)?this.resolveStaleFiles(t,n):[];if(h.length>0){this.renderer.log(`\u26A0\uFE0F Restarted ${u} \u2014 still serving the OLD ${Rt(h)}. Re-run \`infra-kit dev\` to pick this up.`,"warn");return}this.renderer.log(`${l?"\u2705":"\u26A0\uFE0F "} Restarted ${u}`)}resolveStaleFiles(e,t){let n=this.moduleGeneration;return n?e.filter(i=>!n.bustedUnder(w.dirname(i))):e.filter(i=>!t.some(s=>At(i,s.app.path)))}async buildClosureMapSafe(e){try{return await qe(this.monorepoRoot,e,this.dryRunner)}catch(t){return this.renderer.log(`\u26A0\uFE0F Dependency-closure map unavailable (${String(t)}); package changes restart all apps`,"warn"),null}}reportEngineDeath(e,t,n){this.shuttingDown||this.renderer.log(`\u26A0\uFE0F ${e} ${n} \u2014 ${t}. Restart \`infra-kit dev\`.`,"warn")}markUiEngineDead(){if(!this.shuttingDown){for(let{tag:e,kind:t}of this.uiTargets())this.healthEntry(e,t).dead=!0;this.refreshStatus()}}markUiTaskFailed(e){if(this.shuttingDown)return;if(this.uiHealthEnabled()){if(this.healthOf(e)==="down")return;this.markDown(e,"ui")}let t=this.uiTagByPackage.size>1?"; other frontends are unaffected":"";this.renderer.log(`\u26A0\uFE0F ${e} failed to start \u2014 its \`dev\` task exited${t}`,"error"),this.refreshStatus()}setupWatch(e,t){this.turboWatch=this.turboWatchFactory({depInclusive:e.map(l=>l.packageName),depClosure:t.map(l=>l.packageName),cwd:m.cwd(),logFile:this.sink.pathFor(hn),onUnexpectedExit:l=>{this.reportEngineDeath("Watch engine (`turbo watch build`)","file saves no longer rebuild",l)}}),this.renderer.narrate("\u{1F440} Watch mode: started `turbo watch build` engine; watching dist output");let n=xe(e),i=$(this.monorepoRoot),s=[...n,...i];if(s.length===0){this.renderer.log("\u26A0\uFE0F No app or package dist directories found to watch (were they built?)","warn");return}let o=m.env.DEV_SERVER_CHOKIDAR_POLL==="1",a=an.watch(s,{ignoreInitial:!0,awaitWriteFinish:{stabilityThreshold:200,pollInterval:100},ignored:l=>l.endsWith(".tsbuildinfo")||l.endsWith(".map"),...o?{usePolling:!0,interval:400}:{}});this.watcher=a,o&&this.renderer.log("\u{1F440} chokidar: usePolling enabled (DEV_SERVER_CHOKIDAR_POLL=1)","debug");for(let l of["add","change","unlink"])a.on(l,u=>{this.handleDistChange(u,e,n,i)});this.renderer.narrate(`\u{1F440} Watching ${n.length} app dist + ${i.length} package dist dir(s) for changes...`),this.renderer.narrate(this.moduleGeneration?"\u{1F440} Watch reloads the whole local graph in place \u2014 shared packages and services included.":"\u{1F440} Watch reloads serverless handler entry files only; other modules need a re-run of `infra-kit dev`.")}handleDistChange(e,t,n,i){this.renderer.log(`\u{1F440} dist change detected: ${e}`,"debug");let s=Ae(e,n,i);if(s.kind==="package"){this.handlePackageDistChange(e,t,s.packageDir);return}let o=t.find(a=>w.join(a.path,"dist")===s.app);o&&(this.markChanged(o.name,e),this.scheduleDebounced(o.name,()=>this.restart([o],this.takeChanged(o.name))))}handlePackageDistChange(e,t,n){let i=ze(t,this.closureMap,n);if(i===null){this.markChanged("__packages__",e),this.scheduleDebounced("__packages__",()=>this.restart(t,this.takeChanged("__packages__")));return}for(let s of i)this.markChanged(s.name,e),this.scheduleDebounced(s.name,()=>this.restart([s],this.takeChanged(s.name)))}markChanged(e,t){let n=this.pendingChanges.get(e);n?n.add(t):this.pendingChanges.set(e,new Set([t]))}installModuleGeneration(){if(m.env.INFRA_KIT_DEV_NO_GENERATION==="1"){this.renderer.log("\u{1F440} Module generation disabled (INFRA_KIT_DEV_NO_GENERATION=1)","debug");return}if(!vt()){this.renderer.log(`\u26A0\uFE0F This Node (${m.version}) has no \`module.registerHooks\`, so only handler entry files reload in place.`,"warn");return}let e=ce(m.env.INFRA_KIT_DEV_STOP_BYTES);this.moduleGeneration=wt({root:v.realpathSync(this.monorepoRoot),selfDist:yt(),stopBytes:e.stopBytes,stopEnabled:e.stopEnabled})}reportGenerationBudgetWarn(){let e=this.moduleGeneration?.generation()??0;this.renderer.log(`\u26A0\uFE0F Reload memory ${me(m.memoryUsage.rss())} after ${e} reload(s). Module records cannot be freed in-process, so this only grows \u2014 re-run \`infra-kit dev\` when convenient.`,"warn")}reportGenerationBudgetStop(e){let t=this.moduleGeneration?.generation()??0;this.renderer.log(`\u26D4 Reload memory ${me(m.memoryUsage.rss())} exceeds the ${me(e)} budget after ${t} reload(s) \u2014 stopping. Module records cannot be freed in-process. Re-run \`infra-kit dev\` to continue, or set INFRA_KIT_DEV_STOP_BYTES to raise the budget (or \`off\` to disable the stop).`,"error")}takeChanged(e){let t=this.pendingChanges.get(e);return this.pendingChanges.delete(e),t?[...t]:[]}scheduleDebounced(e,t){if(this.shuttingDown)return;let n=this.watchDebounceTimers.get(e);n&&clearTimeout(n);let i=setTimeout(()=>{this.watchDebounceTimers.delete(e),!this.shuttingDown&&t().catch(s=>{this.renderer.log(`Restart error (${e}): ${String(s)}`,"error")})},r.WATCH_DEBOUNCE_MS);this.watchDebounceTimers.set(e,i)}uiHealthEnabled(){return(this.options.uiHealth??!0)&&m.env.INFRA_KIT_NO_UI_HEALTH!=="1"}apiTargets(){return this.appServers.map(({app:e,boundPort:t})=>({tag:`${e.name}/api`,port:t,kind:"api"}))}uiTargets(){return this.uiHealthEnabled()?Object.entries(this.uiPortMap).map(([e,{port:t}])=>({tag:this.uiTagByPackage.get(e)??`${e}/ui`,port:t,kind:"ui"})):[]}healthEntry(e,t){let n=this.health.get(e);if(n)return n;let i={kind:t,failures:0,foreignStreak:0,everUp:!1,dead:!1,unverified:!1};return this.health.set(e,i),i}recordProbe(e,t){let n=this.healthEntry(e.tag,e.kind),i=r.LIVENESS_FAILURE_THRESHOLD;if(t==="ok"){let s=n.failures>=i;n.everUp=!0,n.failures=0,n.foreignStreak=0,n.unverified=!1,s&&this.renderer.log(`\u2705 ${e.tag} recovered`);return}if(yn(t)&&e.kind==="ui"){n.foreignStreak+=1,n.unverified=n.foreignStreak>=i,n.foreignStreak===i&&this.renderer.log(`\u26A0\uFE0F ${e.tag}: ${wn(e.port,t)}`,"warn");return}if(n.foreignStreak=0,n.failures+=1,e.kind==="ui"&&n.failures>=i&&(n.unverified=!1),n.failures===i){let s=e.kind==="api"?"/__health not responding":"not answering vite's ping";this.renderer.log(`\u26A0\uFE0F ${e.tag} unhealthy (${s})`,"warn")}}markDown(e,t){let n=this.healthEntry(e,t);n.dead=!0,n.failures=r.LIVENESS_FAILURE_THRESHOLD,n.foreignStreak=0,n.unverified=!1}healthOf(e){let t=this.health.get(e);return t==null?"unknown":t.unverified?"unverified":t.everUp?t.failures>=r.LIVENESS_FAILURE_THRESHOLD?"down":"ok":this.neverUpState(t)}neverUpState(e){return e.kind==="api"||e.dead||e.failures>=r.NEVER_UP_DOWN_THRESHOLD?"down":"starting"}startLivenessMonitor(){this.scheduleLivenessTick()}scheduleLivenessTick(){let e=this.options.livenessIntervalMs??r.LIVENESS_INTERVAL_MS;this.livenessTimer=setTimeout(()=>{this.livenessTick().finally(()=>{this.shuttingDown||this.scheduleLivenessTick()}).catch(()=>{})},e),this.livenessTimer.unref()}refreshStatus(){let e=this.lastSummary;if(e==null)return;let t=Date.now(),n=new Map(this.appServers.map(i=>[`${i.app.name}/api`,i]));this.pruneRequestWindow(t),this.renderer.refresh?.({...e,sessionUptimeMs:t-this.readyAt,degraded:this.degradedRows(),uiRefs:e.uiRefs.map(i=>({...i,errors:this.announceFirstError(i.tag)})),endpoints:e.endpoints.map(i=>{let s=n.get(i.tag);return{...i,health:this.healthOf(i.tag),uptimeMs:s?t-s.startedAt:void 0,restarts:s?.restarts,rpm:(this.reqTimes.get(i.tag)??[]).length,errors:this.announceFirstError(i.tag)}})})}announceFirstError(e){let{errors:t}=this.sink.statsFor(e);return t>0&&!this.firstErrorLogged.has(e)&&(this.firstErrorLogged.add(e),this.renderer.log(`\u26A0\uFE0F ${e} reported its first error \u2192 ${Y(this.sink.pathFor(e))}`,"warn")),t}degradedRows(){if(this.degradedRoutes.length===0)return[];let e=new Set(this.appServers.map(({app:t})=>t.packageName));return this.degradedRoutes.filter(t=>!e.has(t.packageName)).map(t=>({route:t.route,tag:`${t.uiApp}/ui`,fallback:t.fallback,target:t.cloudTarget}))}pruneRequestWindow(e){let t=e-6e4;for(let[n,i]of this.reqTimes)this.reqTimes.set(n,i.filter(s=>s>t))}async livenessTick(){this.shuttingDown||(await Promise.all([...this.apiTargets(),...this.uiTargets()].map(e=>this.probeOne(e))),this.refreshStatus())}async probeOne(e){let t=await this.healthProbe(e);this.shuttingDown||this.recordProbe(e,t)}async printReady(e,t,n,i){let s=Date.now()-n;await Promise.all(this.apiTargets().map(p=>this.probeOne(p)));let o=this.appServers.map(({app:p,alias:f})=>({tag:`${p.name}/api`,url:O({prefixUrl:p.prefixUrl,alias:f}),health:this.healthOf(`${p.name}/api`)})),a=new Map(this.appServers.map(({app:p,alias:f})=>[p.packageName,O({prefixUrl:p.prefixUrl,alias:f})]));this.proxyRoutes=Ze({uis:this.launchedUis,running:new Set(this.appServers.map(({app:p})=>p.packageName)),localOrigin:p=>a.get(p),env:m.env[ne]}),this.uiPortMap={};let l=[],u=[];for(let p of t){let f=await this.assignUiPort(p),y=`${p.name}/ui`;f!=null?l.push({tag:y,url:O({prefixUrl:"",alias:f.alias}),health:this.seedUiHealth(y),proxies:this.proxiesFor(p.name)}):u.push({tag:y,proxies:this.proxiesFor(p.name)})}let d=this.options.watch??!1,h=e.length+t.length,g=$(this.monorepoRoot).length;this.lastSummary={target:i,watch:d,release:ve(m.cwd()),elapsedMs:s,endpoints:[...o,...l],uiRefs:u,failed:this.failedApps.map(({app:p,reason:f})=>({tag:`${p.name}/api`,reason:f})),degraded:this.degradedRows(),watchSummary:`${h} app${h===1?"":"s"} \xB7 ${g} package${g===1?"":"s"}`,logPath:Y(this.sink.dir),logHref:this.sink.dir},this.readyAt=Date.now(),this.renderer.ready(this.lastSummary),this.refreshStatus()}async assignUiPort(e){if(!e.managedPort)return null;let t;try{t=await vn()}catch{return null}let n=await this.registerAppAlias(e.packageName,e.path,t);return this.uiPortMap[e.packageName]={port:t,alias:n},this.uiTagByPackage.set(e.packageName,`${e.name}/ui`),{port:t,alias:n}}seedUiHealth(e){return this.uiHealthEnabled()?(this.healthEntry(e,"ui"),this.healthOf(e)):"unknown"}printRouteDump(){if(this.appServers.length!==0){this.renderer.log("\u{1F5FA}\uFE0F Registered routes:");for(let{app:e,server:t}of this.appServers){let n=t.getRegisteredRoutes();this.renderer.log(` ${e.name} (${n.length}): ${n.length>0?n.join(", "):"(none)"}`)}}}reportFault(e){this.sink.write(W()??X,e,{level:"error"}),!this.shuttingDown&&this.renderer.log(e,"error",{tee:!1})}fileFault(e){this.sink.write(W()??X,e,{level:"error"})}get shutdownStage(){return this.stage}shutdown(){return this.teardown!=null?this.teardown:(this.teardown=this.doShutdown(),this.teardown.catch(()=>{}),this.teardown)}async doShutdown(){this.shuttingDown=!0,this.stage="starting",this.renderer.dispose(),this.intercept?.uninstall(),this.renderer.log("\u{1F6D1} Shutting down all servers...");for(let e of this.watchDebounceTimers.values())clearTimeout(e);this.watchDebounceTimers.clear(),this.livenessTimer&&(clearTimeout(this.livenessTimer),this.livenessTimer=null),this.watcher&&(this.stage="watcher.close",await this.watcher.close(),this.watcher=null),this.stage="restartWorkChain",await this.restartWorkChain,this.stage="closureBuild",await this.closureBuild,this.stage="removeAlias",await Promise.all([...this.registeredAliases].map(e=>this.proxy.removeAlias(e))),this.registeredAliases.clear(),this.turboWatch&&(this.stage="turboWatch.kill",await this.turboWatch.kill(),this.turboWatch=null),this.uiDev&&(this.stage="uiDev.kill",await this.uiDev.kill(),this.uiDev=null);for(let{app:e,server:t}of this.appServers){this.stage=`server.close(${e.name})`;try{await t.close()}catch{}this.removeDevContextFragment(e)}this.intercept?.uninstall(),this.renderer.log(`\u2713 dev stopped \xB7 logs \u2192 ${Y(this.sink.dir)}`),this.sink.close(),Q===this.sink&&(Q=null),this.stage="done"}},Ft=r=>(r.tty??!!m.stdout.isTTY)&&!r.json,_n=async r=>{if(!Ft(r))return;let{PersistentInkDevUi:e}=await import("./persistent-ink-dev-ui-P65EJCC6.js"),{createSafeStream:t}=await import("./safe-stderr-ECYA6DRR.js");return new e({appendLog:Ut,verbose:r.verbose??!1,stdout:t(ut())})};async function Mt(r={}){let e=await _n(r),t=new ye(r,void 0,void 0,void 0,void 0,e);try{await t.start()}catch(n){throw await t.shutdown().catch(()=>{}),n}return t}var we=1,Mn=2e4,Hn=r=>{if(r!=null){for(let e of r)if(Re(e)!==null)throw new Error(`infra-kit dev: invalid --target "${e}" (expected "<app>/api" or "<app>/ui").`);return{apps:Object.fromEntries(r.map(e=>[e,{}]))}}},Ht=r=>{if(r==null)return null;let e=r.split(",").map(t=>t.trim()).filter(Boolean);return e.length>0?e:null},Bt=r=>({watch:r.watch??!1,include:Ht(r.app),preset:r.preset,presetDef:Hn(Ht(r.target)),cmux:r.cmux??!1,self:r.self??!1,verbose:r.verbose??!1,routes:r.routes??!1,uiHealth:r.uiHealth??!0}),Bn=r=>!r.self||r.include?r:{...r,include:[ke(P.cwd())]},jt=(r,e)=>{let t=setTimeout(r,e);return t.unref(),()=>{clearTimeout(t)}},jn=(r=jt)=>{let e=!1;return(t,n)=>{if(e)return()=>{};e=!0;let i=r(t,n);return()=>{e=!1,i()}}},Wt=(r,e,t)=>{r(),e(t)},Wn=({getRunner:r,forceReap:e=N,exit:t=s=>{P.exit(s)},setTimer:n=jt,deadlineMs:i=Mn})=>{let s=!1;return o=>{if(s)return;s=!0;let a=r();if(a==null){Wt(e,t,we);return}a.fileFault(`
32
+ \`infra-kit doctor\` checks the daemon and CA trust state.`)}async registerAppAlias(e,t,n){let i=ve(t),s=sn(e);if(s==="")throw new Error(`infra-kit dev: package name "${e}" has no letters or digits to build a hostname from.`);let o=`${i}.${s}`;if(!await this.proxy.registerAlias(o,n))throw new Error(`infra-kit dev: portless refused the alias "${o}" \u2192 127.0.0.1:${n}.`);return this.registeredAliases.add(o),`${o}.localhost`}async startOneApp(e){this.renderer.narrate(`\u{1F504} Starting ${e.name}...`);let t=new q({controllersPath:e.path,prefixUrl:e.prefixUrl,port:e.preferredPort,appName:e.name,serviceTag:`${e.name}/api`,onRequestLog:({method:s,path:o,status:a,ms:l})=>{if(o==="/__health")return;let u=`${e.name}/api`,d=`${s} ${o} ${a} ${l}ms`;this.sink.write(u,d,{level:a>=500?"error":"info"});let h=this.reqTimes.get(u);h?h.push(Date.now()):this.reqTimes.set(u,[Date.now()])}}),n=await t.start(),i;try{i=await this.registerAppAlias(e.packageName,e.path,n)}catch(s){throw await t.close().catch(()=>{}),s}try{this.writeDevContextFragment(e,n,i)}catch(s){this.renderer.log(`\u26A0\uFE0F Failed to write dev-context fragment for ${e.name}: ${String(s)}`,"warn")}return this.renderer.narrate(`\u2705 ${e.name} started on port ${n}`),{server:t,boundPort:n,alias:i}}writeDevContextFragment(e,t,n){let i={v:rn,package:e.packageName,port:t,pid:m.pid,writtenAt:Date.now(),release:ve(e.path),alias:n,origin:`https://${n}`},s=w.join(this.devContextDir,`${e.name}.json`),o=w.join(this.devContextDir,`${e.name}.json.${m.pid}.tmp`);v.mkdirSync(this.devContextDir,{recursive:!0}),v.writeFileSync(o,JSON.stringify(i,null,2)),v.renameSync(o,s)}removeDevContextFragment(e){v.rmSync(w.join(this.devContextDir,`${e.name}.json`),{force:!0})}scheduleRestartWork(e){let t=this.restartWorkChain.then(()=>e(),()=>e());return this.restartWorkChain=t.catch(()=>{}),t}async delayPortRelease(){await new Promise(e=>setTimeout(e,r.PORT_RELEASE_DELAY_MS))}restart(e,t=[]){return this.shuttingDown?Promise.resolve():this.scheduleRestartWork(()=>this.shuttingDown?Promise.resolve():this.runRestart(e,t))}resolveRestartTargets(e){return e.map(t=>({idx:this.appServers.findIndex(n=>n.app.name===t.name),app:t})).filter(t=>t.idx>=0||this.isFailedApp(t.app.name))}isFailedApp(e){return this.failedApps.some(t=>t.app.name===e)}promoteRecoveredApp(e,t){let n={app:e,...t,startedAt:Date.now(),restarts:0},i=`${e.name}/api`;this.healthEntry(i,"api"),this.appServers.push(n);let s=this.failedApps.findIndex(o=>o.app.name===e.name);return s>=0&&this.failedApps.splice(s,1),this.lastSummary&&(this.lastSummary={...this.lastSummary,endpoints:[...this.lastSummary.endpoints,{tag:i,url:O({prefixUrl:e.prefixUrl,alias:t.alias}),health:this.healthOf(i)}],failed:(this.lastSummary.failed??[]).filter(o=>o.tag!==i)}),n}async runRestart(e,t=[]){let n=this.resolveRestartTargets(e);if(n.length===0)return;let i=n.length===1?n[0].app.name:`${n.length} apps`,s=this.moduleGeneration?.budgetState()??"ok";if(s==="stop"){this.reportGenerationBudgetStop(ce(m.env.INFRA_KIT_DEV_STOP_BYTES).stopBytes),this.shutdown().catch(()=>{}).finally(()=>{this.options.onExitRequest?.(1)}).catch(()=>{});return}s==="warn"&&this.reportGenerationBudgetWarn(),this.moduleGeneration?.bump(),this.renderer.log(`\u{1F504} Restarting ${i}...`),await Promise.all(n.map(async({idx:g})=>{if(!(g<0))try{await this.appServers[g].server.close()}catch(p){this.renderer.log(` Close warning: ${String(p)}`,"debug")}})),await this.delayPortRelease();let o=await Promise.all(n.map(async({idx:g,app:p})=>{try{let f=await this.startOneApp(p);if(f){if(g<0){let c=this.promoteRecoveredApp(p,f);return this.renderer.log(`\u2705 ${p.name} recovered \u2014 its routes are served locally again`,"info"),{app:p,entry:c}}let y=this.appServers[g],b={app:p,...f,startedAt:Date.now(),restarts:(y?.restarts??0)+1};return this.appServers[g]=b,{app:p,entry:b}}return{app:p,entry:null}}catch(f){return this.renderer.log(`\u274C Failed to ${g<0?"start":"restart"} ${p.name}: ${String(f)}`,"error"),{app:p,entry:null}}})),a=await Promise.all(o.map(async({app:g,entry:p})=>{let f=`${g.name}/api`;if(p==null)return this.markDown(f,"api"),this.refreshStatus(),{label:`${g.name} \u25CF down`,healthy:!1};let y={tag:f,port:p.boundPort,kind:"api"},b=await this.healthProbe(y);this.recordProbe(y,b),this.refreshStatus();let c=b==="ok";return{label:`${g.name}:${p.boundPort} ${c?"\u25CF up":"\u25CF down"}`,healthy:c}})),l=a.every(g=>g.healthy),u=a.map(g=>g.label).join(", "),h=o.some(g=>g.entry!==null)?this.resolveStaleFiles(t,n):[];if(h.length>0){this.renderer.log(`\u26A0\uFE0F Restarted ${u} \u2014 still serving the OLD ${Rt(h)}. Re-run \`infra-kit dev\` to pick this up.`,"warn");return}this.renderer.log(`${l?"\u2705":"\u26A0\uFE0F "} Restarted ${u}`)}resolveStaleFiles(e,t){let n=this.moduleGeneration;return n?e.filter(i=>!n.bustedUnder(w.dirname(i))):e.filter(i=>!t.some(s=>At(i,s.app.path)))}async buildClosureMapSafe(e){try{return await qe(this.monorepoRoot,e,this.dryRunner)}catch(t){return this.renderer.log(`\u26A0\uFE0F Dependency-closure map unavailable (${String(t)}); package changes restart all apps`,"warn"),null}}reportEngineDeath(e,t,n){this.shuttingDown||this.renderer.log(`\u26A0\uFE0F ${e} ${n} \u2014 ${t}. Restart \`infra-kit dev\`.`,"warn")}markUiEngineDead(){if(!this.shuttingDown){for(let{tag:e,kind:t}of this.uiTargets())this.healthEntry(e,t).dead=!0;this.refreshStatus()}}markUiTaskFailed(e){if(this.shuttingDown)return;if(this.uiHealthEnabled()){if(this.healthOf(e)==="down")return;this.markDown(e,"ui")}let t=this.uiTagByPackage.size>1?"; other frontends are unaffected":"";this.renderer.log(`\u26A0\uFE0F ${e} failed to start \u2014 its \`dev\` task exited${t}`,"error"),this.refreshStatus()}setupWatch(e,t){this.turboWatch=this.turboWatchFactory({depInclusive:e.map(l=>l.packageName),depClosure:t.map(l=>l.packageName),cwd:m.cwd(),logFile:this.sink.pathFor(hn),onUnexpectedExit:l=>{this.reportEngineDeath("Watch engine (`turbo watch build`)","file saves no longer rebuild",l)}}),this.renderer.narrate("\u{1F440} Watch mode: started `turbo watch build` engine; watching dist output");let n=Ae(e),i=$(this.monorepoRoot),s=[...n,...i];if(s.length===0){this.renderer.log("\u26A0\uFE0F No app or package dist directories found to watch (were they built?)","warn");return}let o=m.env.DEV_SERVER_CHOKIDAR_POLL==="1",a=an.watch(s,{ignoreInitial:!0,awaitWriteFinish:{stabilityThreshold:200,pollInterval:100},ignored:l=>l.endsWith(".tsbuildinfo")||l.endsWith(".map"),...o?{usePolling:!0,interval:400}:{}});this.watcher=a,o&&this.renderer.log("\u{1F440} chokidar: usePolling enabled (DEV_SERVER_CHOKIDAR_POLL=1)","debug");for(let l of["add","change","unlink"])a.on(l,u=>{this.handleDistChange(u,e,n,i)});this.renderer.narrate(`\u{1F440} Watching ${n.length} app dist + ${i.length} package dist dir(s) for changes...`),this.renderer.narrate(this.moduleGeneration?"\u{1F440} Watch reloads the whole local graph in place \u2014 shared packages and services included.":"\u{1F440} Watch reloads serverless handler entry files only; other modules need a re-run of `infra-kit dev`.")}handleDistChange(e,t,n,i){this.renderer.log(`\u{1F440} dist change detected: ${e}`,"debug");let s=Re(e,n,i);if(s.kind==="package"){this.handlePackageDistChange(e,t,s.packageDir);return}let o=t.find(a=>w.join(a.path,"dist")===s.app);o&&(this.markChanged(o.name,e),this.scheduleDebounced(o.name,()=>this.restart([o],this.takeChanged(o.name))))}handlePackageDistChange(e,t,n){let i=ze(t,this.closureMap,n);if(i===null){this.markChanged("__packages__",e),this.scheduleDebounced("__packages__",()=>this.restart(t,this.takeChanged("__packages__")));return}for(let s of i)this.markChanged(s.name,e),this.scheduleDebounced(s.name,()=>this.restart([s],this.takeChanged(s.name)))}markChanged(e,t){let n=this.pendingChanges.get(e);n?n.add(t):this.pendingChanges.set(e,new Set([t]))}installModuleGeneration(){if(m.env.INFRA_KIT_DEV_NO_GENERATION==="1"){this.renderer.log("\u{1F440} Module generation disabled (INFRA_KIT_DEV_NO_GENERATION=1)","debug");return}if(!vt()){this.renderer.log(`\u26A0\uFE0F This Node (${m.version}) has no \`module.registerHooks\`, so only handler entry files reload in place.`,"warn");return}let e=ce(m.env.INFRA_KIT_DEV_STOP_BYTES);this.moduleGeneration=wt({root:v.realpathSync(this.monorepoRoot),selfDist:yt(),stopBytes:e.stopBytes,stopEnabled:e.stopEnabled})}reportGenerationBudgetWarn(){let e=this.moduleGeneration?.generation()??0;this.renderer.log(`\u26A0\uFE0F Reload memory ${me(m.memoryUsage.rss())} after ${e} reload(s). Module records cannot be freed in-process, so this only grows \u2014 re-run \`infra-kit dev\` when convenient.`,"warn")}reportGenerationBudgetStop(e){let t=this.moduleGeneration?.generation()??0;this.renderer.log(`\u26D4 Reload memory ${me(m.memoryUsage.rss())} exceeds the ${me(e)} budget after ${t} reload(s) \u2014 stopping. Module records cannot be freed in-process. Re-run \`infra-kit dev\` to continue, or set INFRA_KIT_DEV_STOP_BYTES to raise the budget (or \`off\` to disable the stop).`,"error")}takeChanged(e){let t=this.pendingChanges.get(e);return this.pendingChanges.delete(e),t?[...t]:[]}scheduleDebounced(e,t){if(this.shuttingDown)return;let n=this.watchDebounceTimers.get(e);n&&clearTimeout(n);let i=setTimeout(()=>{this.watchDebounceTimers.delete(e),!this.shuttingDown&&t().catch(s=>{this.renderer.log(`Restart error (${e}): ${String(s)}`,"error")})},r.WATCH_DEBOUNCE_MS);this.watchDebounceTimers.set(e,i)}uiHealthEnabled(){return(this.options.uiHealth??!0)&&m.env.INFRA_KIT_NO_UI_HEALTH!=="1"}apiTargets(){return this.appServers.map(({app:e,boundPort:t})=>({tag:`${e.name}/api`,port:t,kind:"api"}))}uiTargets(){return this.uiHealthEnabled()?Object.entries(this.uiPortMap).map(([e,{port:t}])=>({tag:this.uiTagByPackage.get(e)??`${e}/ui`,port:t,kind:"ui"})):[]}healthEntry(e,t){let n=this.health.get(e);if(n)return n;let i={kind:t,failures:0,foreignStreak:0,everUp:!1,dead:!1,unverified:!1};return this.health.set(e,i),i}recordProbe(e,t){let n=this.healthEntry(e.tag,e.kind),i=r.LIVENESS_FAILURE_THRESHOLD;if(t==="ok"){let s=n.failures>=i;n.everUp=!0,n.failures=0,n.foreignStreak=0,n.unverified=!1,s&&this.renderer.log(`\u2705 ${e.tag} recovered`);return}if(yn(t)&&e.kind==="ui"){n.foreignStreak+=1,n.unverified=n.foreignStreak>=i,n.foreignStreak===i&&this.renderer.log(`\u26A0\uFE0F ${e.tag}: ${wn(e.port,t)}`,"warn");return}if(n.foreignStreak=0,n.failures+=1,e.kind==="ui"&&n.failures>=i&&(n.unverified=!1),n.failures===i){let s=e.kind==="api"?"/__health not responding":"not answering vite's ping";this.renderer.log(`\u26A0\uFE0F ${e.tag} unhealthy (${s})`,"warn")}}markDown(e,t){let n=this.healthEntry(e,t);n.dead=!0,n.failures=r.LIVENESS_FAILURE_THRESHOLD,n.foreignStreak=0,n.unverified=!1}healthOf(e){let t=this.health.get(e);return t==null?"unknown":t.unverified?"unverified":t.everUp?t.failures>=r.LIVENESS_FAILURE_THRESHOLD?"down":"ok":this.neverUpState(t)}neverUpState(e){return e.kind==="api"||e.dead||e.failures>=r.NEVER_UP_DOWN_THRESHOLD?"down":"starting"}startLivenessMonitor(){this.scheduleLivenessTick()}scheduleLivenessTick(){let e=this.options.livenessIntervalMs??r.LIVENESS_INTERVAL_MS;this.livenessTimer=setTimeout(()=>{this.livenessTick().finally(()=>{this.shuttingDown||this.scheduleLivenessTick()}).catch(()=>{})},e),this.livenessTimer.unref()}refreshStatus(){let e=this.lastSummary;if(e==null)return;let t=Date.now(),n=new Map(this.appServers.map(i=>[`${i.app.name}/api`,i]));this.pruneRequestWindow(t),this.renderer.refresh?.({...e,sessionUptimeMs:t-this.readyAt,degraded:this.degradedRows(),uiRefs:e.uiRefs.map(i=>({...i,errors:this.announceFirstError(i.tag)})),endpoints:e.endpoints.map(i=>{let s=n.get(i.tag);return{...i,health:this.healthOf(i.tag),uptimeMs:s?t-s.startedAt:void 0,restarts:s?.restarts,rpm:(this.reqTimes.get(i.tag)??[]).length,errors:this.announceFirstError(i.tag)}})})}announceFirstError(e){let{errors:t}=this.sink.statsFor(e);return t>0&&!this.firstErrorLogged.has(e)&&(this.firstErrorLogged.add(e),this.renderer.log(`\u26A0\uFE0F ${e} reported its first error \u2192 ${Y(this.sink.pathFor(e))}`,"warn")),t}degradedRows(){if(this.degradedRoutes.length===0)return[];let e=new Set(this.appServers.map(({app:t})=>t.packageName));return this.degradedRoutes.filter(t=>!e.has(t.packageName)).map(t=>({route:t.route,tag:`${t.uiApp}/ui`,fallback:t.fallback,target:t.cloudTarget}))}pruneRequestWindow(e){let t=e-6e4;for(let[n,i]of this.reqTimes)this.reqTimes.set(n,i.filter(s=>s>t))}async livenessTick(){this.shuttingDown||(await Promise.all([...this.apiTargets(),...this.uiTargets()].map(e=>this.probeOne(e))),this.refreshStatus())}async probeOne(e){let t=await this.healthProbe(e);this.shuttingDown||this.recordProbe(e,t)}async printReady(e,t,n,i){let s=Date.now()-n;await Promise.all(this.apiTargets().map(p=>this.probeOne(p)));let o=this.appServers.map(({app:p,alias:f})=>({tag:`${p.name}/api`,url:O({prefixUrl:p.prefixUrl,alias:f}),health:this.healthOf(`${p.name}/api`)})),a=new Map(this.appServers.map(({app:p,alias:f})=>[p.packageName,O({prefixUrl:p.prefixUrl,alias:f})]));this.proxyRoutes=Ze({uis:this.launchedUis,running:new Set(this.appServers.map(({app:p})=>p.packageName)),localOrigin:p=>a.get(p),env:m.env[ne]}),this.uiPortMap={};let l=[],u=[];for(let p of t){let f=await this.assignUiPort(p),y=`${p.name}/ui`;f!=null?l.push({tag:y,url:O({prefixUrl:"",alias:f.alias}),health:this.seedUiHealth(y),proxies:this.proxiesFor(p.name)}):u.push({tag:y,proxies:this.proxiesFor(p.name)})}let d=this.options.watch??!1,h=e.length+t.length,g=$(this.monorepoRoot).length;this.lastSummary={target:i,watch:d,release:ve(m.cwd()),elapsedMs:s,endpoints:[...o,...l],uiRefs:u,failed:this.failedApps.map(({app:p,reason:f})=>({tag:`${p.name}/api`,reason:f})),degraded:this.degradedRows(),watchSummary:`${h} app${h===1?"":"s"} \xB7 ${g} package${g===1?"":"s"}`,logPath:Y(this.sink.dir),logHref:this.sink.dir},this.readyAt=Date.now(),this.renderer.ready(this.lastSummary),this.refreshStatus()}async assignUiPort(e){if(!e.managedPort)return null;let t;try{t=await vn()}catch{return null}let n=await this.registerAppAlias(e.packageName,e.path,t);return this.uiPortMap[e.packageName]={port:t,alias:n},this.uiTagByPackage.set(e.packageName,`${e.name}/ui`),{port:t,alias:n}}seedUiHealth(e){return this.uiHealthEnabled()?(this.healthEntry(e,"ui"),this.healthOf(e)):"unknown"}printRouteDump(){if(this.appServers.length!==0){this.renderer.log("\u{1F5FA}\uFE0F Registered routes:");for(let{app:e,server:t}of this.appServers){let n=t.getRegisteredRoutes();this.renderer.log(` ${e.name} (${n.length}): ${n.length>0?n.join(", "):"(none)"}`)}}}reportFault(e){this.sink.write(W()??X,e,{level:"error"}),!this.shuttingDown&&this.renderer.log(e,"error",{tee:!1})}fileFault(e){this.sink.write(W()??X,e,{level:"error"})}get shutdownStage(){return this.stage}shutdown(){return this.teardown!=null?this.teardown:(this.teardown=this.doShutdown(),this.teardown.catch(()=>{}),this.teardown)}async doShutdown(){this.shuttingDown=!0,this.stage="starting",this.renderer.dispose(),this.intercept?.uninstall(),this.renderer.log("\u{1F6D1} Shutting down all servers...");for(let e of this.watchDebounceTimers.values())clearTimeout(e);this.watchDebounceTimers.clear(),this.livenessTimer&&(clearTimeout(this.livenessTimer),this.livenessTimer=null),this.watcher&&(this.stage="watcher.close",await this.watcher.close(),this.watcher=null),this.stage="restartWorkChain",await this.restartWorkChain,this.stage="closureBuild",await this.closureBuild,this.stage="removeAlias",await Promise.all([...this.registeredAliases].map(e=>this.proxy.removeAlias(e))),this.registeredAliases.clear(),this.turboWatch&&(this.stage="turboWatch.kill",await this.turboWatch.kill(),this.turboWatch=null),this.uiDev&&(this.stage="uiDev.kill",await this.uiDev.kill(),this.uiDev=null);for(let{app:e,server:t}of this.appServers){this.stage=`server.close(${e.name})`;try{await t.close()}catch{}this.removeDevContextFragment(e)}this.intercept?.uninstall(),this.renderer.log(`\u2713 dev stopped \xB7 logs \u2192 ${Y(this.sink.dir)}`),this.sink.close(),Q===this.sink&&(Q=null),this.stage="done"}},Ft=r=>(r.tty??!!m.stdout.isTTY)&&!r.json,_n=async r=>{if(!Ft(r))return;let{PersistentInkDevUi:e}=await import("./persistent-ink-dev-ui-P65EJCC6.js"),{createSafeStream:t}=await import("./safe-stderr-ECYA6DRR.js");return new e({appendLog:Ut,verbose:r.verbose??!1,stdout:t(ut())})};async function Mt(r={}){let e=await _n(r),t=new ye(r,void 0,void 0,void 0,void 0,e);try{await t.start()}catch(n){throw await t.shutdown().catch(()=>{}),n}return t}var we=1,Mn=2e4,Hn=r=>{if(r!=null){for(let e of r)if(Ee(e)!==null)throw new Error(`infra-kit dev: invalid --target "${e}" (expected "<app>/api" or "<app>/ui").`);return{apps:Object.fromEntries(r.map(e=>[e,{}]))}}},Ht=r=>{if(r==null)return null;let e=r.split(",").map(t=>t.trim()).filter(Boolean);return e.length>0?e:null},Bt=r=>({watch:r.watch??!1,include:Ht(r.app),preset:r.preset,presetDef:Hn(Ht(r.target)),cmux:r.cmux??!1,self:r.self??!1,verbose:r.verbose??!1,routes:r.routes??!1,uiHealth:r.uiHealth??!0}),Bn=r=>!r.self||r.include?r:{...r,include:[xe(P.cwd())]},jt=(r,e)=>{let t=setTimeout(r,e);return t.unref(),()=>{clearTimeout(t)}},jn=(r=jt)=>{let e=!1;return(t,n)=>{if(e)return()=>{};e=!0;let i=r(t,n);return()=>{e=!1,i()}}},Wt=(r,e,t)=>{r(),e(t)},Wn=({getRunner:r,forceReap:e=N,exit:t=s=>{P.exit(s)},setTimer:n=jt,deadlineMs:i=Mn})=>{let s=!1;return o=>{if(s)return;s=!0;let a=r();if(a==null){Wt(e,t,we);return}a.fileFault(`
33
33
  \u2717 dev-server exiting: ${o}
34
34
  `);let l=n(()=>{e(),t(we)},i);a.shutdown().finally(()=>{l(),t(we)}).catch(()=>{})}},Gn=["SIGINT","SIGTERM"],Vn=({forceReap:r=N,exit:e=i=>{P.exit(i)},register:t=(i,s)=>{P.on(i,s)},unregister:n=(i,s)=>{P.off(i,s)}}={})=>{let i=new Map;for(let s of Gn){let o=()=>{Wt(r,e,Ue(s))};i.set(s,o),t(s,o)}return{remove:()=>{for(let[s,o]of i)n(s,o)}}},be=async r=>{let e=Bn(r);if(e.cmux){if(await Fe()){await Ve(e);return}P.stdout.write(`cmux not available; falling back to single-terminal dev
35
35
  `)}let t=null,n=jn(),i=Wn({getRunner:()=>t,setTimer:n}),s=st({onDeath:(l,u)=>{i(`stdio unwritable: ${l} ${u.code}`)}}),o=Vn();try{t=await Mt({...e,onExitRequest:l=>{P.exit(l)}})}finally{o.remove()}let a=t;Ke({onFault:(l,u)=>{a.reportFault(I(l,u))},isTerminalDead:s.isDead,fileFault:(l,u)=>{a.fileFault(I(l,u,!1))},onFatal:i}),B({onSignal:async l=>{le(`
36
36
  Received ${l}, shutting down dev-server...
37
- `),await a.shutdown()},describeStall:()=>a.shutdownStage,fileReport:l=>{a.fileFault(l)},setTimer:n})},Kn=(r,e,t)=>!r.preset&&!r.app&&!r.self&&!r.cmux&&!r.watch&&!r.verbose&&!r.routes&&e&&!t,Jn=(r,e)=>({watch:r.watch,cmux:r.cmux,include:r.include??null,preset:r.preset,presetDef:r.presetDef,self:!1,verbose:!1,routes:!1,uiHealth:e.uiHealth??!0}),Ls=async(r,e,t)=>{if(Kn(r,e,t)){let{runDevWizard:n}=await import("./dev-wizard-run-FNMMYTDX.js"),i=Promise.all([import("./persistent-ink-dev-ui-P65EJCC6.js"),import("./safe-stderr-ECYA6DRR.js")]).catch(()=>{}),s;try{s=await n()}catch(o){if(Be(o))return;throw o}if(s==null)return;await i,await be({...Jn(s,r),tty:e,json:t});return}await be({...Bt(r),tty:e,json:t})},qn=async r=>{let e=new Un;e.name("infra-kit-dev-server").description("Run local dev servers for the apps in a named devServersPresets preset (or all apps)").argument("[preset]","Named preset from devServersPresets (omit to run every app)").option("-w, --watch","Rebuild and restart on file save").option("--app <names>","Further narrow to these app folder names (comma-separated)").option("--cmux","Run each app in its own cmux pane (one workspace, N panes; falls back to single terminal if cmux is unavailable)").option("--self","Run only the app of the current directory (infer from cwd; use inside apps/<app>/\u2026)").option("-V, --verbose","Print full boot narration (default: quiet; full detail always in the session log)").option("--routes","Print each app\u2019s registered METHOD /path routes at startup (default: off)"),e.parse(r),await be(Bt({...e.opts(),preset:e.args[0]}))};import.meta.url===Fn(P.argv[1]??"").href&&qn(P.argv).catch(r=>{console.error(r instanceof Error?r.message:String(r)),P.exit(1)});export{Wn as createFatalHandler,jn as createSharedDeadlineTimer,Vn as installBootSignalGuard,be as runDevServer,Ls as runDevServerCli,Kn as shouldRunWizard,Bt as toDevServerOptions};
37
+ `),await a.shutdown()},describeStall:()=>a.shutdownStage,fileReport:l=>{a.fileFault(l)},setTimer:n})},Kn=(r,e,t)=>!r.preset&&!r.app&&!r.self&&!r.cmux&&!r.watch&&!r.verbose&&!r.routes&&e&&!t,Jn=(r,e)=>({watch:r.watch,cmux:r.cmux,include:r.include??null,preset:r.preset,presetDef:r.presetDef,self:!1,verbose:!1,routes:!1,uiHealth:e.uiHealth??!0}),Ls=async(r,e,t)=>{if(Kn(r,e,t)){let{runDevWizard:n}=await import("./dev-wizard-run-DWDA5R3A.js"),i=Promise.all([import("./persistent-ink-dev-ui-P65EJCC6.js"),import("./safe-stderr-ECYA6DRR.js")]).catch(()=>{}),s;try{s=await n()}catch(o){if(Be(o))return;throw o}if(s==null)return;await i,await be({...Jn(s,r),tty:e,json:t});return}await be({...Bt(r),tty:e,json:t})},qn=async r=>{let e=new Un;e.name("infra-kit-dev-server").description("Run local dev servers for the apps in a named devServersPresets preset (or all apps)").argument("[preset]","Named preset from devServersPresets (omit to run every app)").option("-w, --watch","Rebuild and restart on file save").option("--app <names>","Further narrow to these app folder names (comma-separated)").option("--cmux","Run each app in its own cmux pane (one workspace, N panes; falls back to single terminal if cmux is unavailable)").option("--self","Run only the app of the current directory (infer from cwd; use inside apps/<app>/\u2026)").option("-V, --verbose","Print full boot narration (default: quiet; full detail always in the session log)").option("--routes","Print each app\u2019s registered METHOD /path routes at startup (default: off)"),e.parse(r),await be(Bt({...e.opts(),preset:e.args[0]}))};import.meta.url===Fn(P.argv[1]??"").href&&qn(P.argv).catch(r=>{console.error(r instanceof Error?r.message:String(r)),P.exit(1)});export{Wn as createFatalHandler,jn as createSharedDeadlineTimer,Vn as installBootSignalGuard,be as runDevServer,Ls as runDevServerCli,Kn as shouldRunWizard,Bt as toDevServerOptions};
38
38
  //# sourceMappingURL=dev-server.js.map