infra-kit 0.1.128 → 0.1.130

package/dist/dev-wizard-run-LYNLPQMV.js

@@ -0,0 +1,2 @@
+import{e as k,r as u}from"./chunk-V375VXOL.js";import{F as x,N as w,v as d,w as h,x as P,y}from"./chunk-4YU4TAGX.js";import{c as v}from"./chunk-YGCVOVNX.js";import"./chunk-2PZRQHWF.js";import R from"@inquirer/checkbox";import N from"@inquirer/confirm";import D from"@inquirer/select";import O from"node:path";import m from"node:process";var b=e=>new Map(e.apps.map(r=>[r.name,r])),C=(e,r,t,s,a)=>{let n=e.localCapable&&t.has(e.packageName);n?e.ownerApp!=null&&s.localOwners.add(e.ownerApp):(s.anyCloud=!0,e.ownerApp===r&&s.demoteOwn.add(r));for(let i of e.routes)a[i]=n?"local":"cloud"},S=(e,r)=>{let t={localOwners:new Set,demoteOwn:new Set,proxyByUiApp:new Map,anyCloud:!1};for(let s of e.apps){let a=r.get(s);if(!a?.hasUi)continue;let n=new Set(e.localBackendsByApp[s]??[]),i={};for(let o of a.backends)C(o,s,n,t,i);Object.keys(i).length>0&&t.proxyByUiApp.set(s,i)}return t},A=(e,r)=>{let t=b(r),s=e.apps.filter(o=>t.get(o)?.hasUi===!0),a=new Set(e.apps.filter(o=>t.get(o)?.hasApi===!0)),n=S(e,t);for(let o of n.localOwners)a.add(o);for(let o of n.demoteOwn)n.localOwners.has(o)||a.delete(o);let i={};for(let o of s){let p=n.proxyByUiApp.get(o);i[`${o}/ui`]=p?{proxy:p}:{}}for(let o of a)i[`${o}/api`]??={};return{presetDef:{apps:i,cmux:e.cmux},anyCloudRoute:n.anyCloud,targetKeys:Object.keys(i).sort()}},B=e=>e.split("/")[0],z=(e,r,t)=>{let s=b(t),a=[...new Set(e.targetKeys.map(B))].sort(),n=new Set(e.targetKeys),i=a.every(p=>{let l=s.get(p);if(!l)return!1;let c=!l.hasUi||n.has(`${p}/ui`),g=!l.hasApi||n.has(`${p}/api`);return c&&g}),o=[`--app=${a.join(",")}`];return r.watch&&o.push("--watch"),r.cmux&&o.push("--cmux"),{flags:o.join(" "),exact:i}};var $={select:e=>D({message:e.message,choices:e.choices,default:e.default},{output:m.stderr}),checkbox:e=>R({message:e.message,choices:e.choices},{output:m.stderr}),confirm:e=>N({message:e.message,default:e.default},{output:m.stderr})},U=(e,r)=>{let t=new Map;for(let[s,a]of Object.entries(e)){let n=t.get(a.packageName),i=a.from.includes("local");n?(n.routes.push(s),n.localCapable=n.localCapable||i):t.set(a.packageName,{packageName:a.packageName,routes:[s],localCapable:i,ownerApp:r.get(a.packageName)})}return[...t.values()]},j=async e=>{let r=P(e),t=y(e),s=await w(),a=new Map(r.map(c=>[c.packageName,c.name])),n=new Map(r.map(c=>[c.name,c.packageName])),i=new Set(t.map(c=>c.name)),o=new Set(r.map(c=>c.name)),p=[...new Set([...o,...i])].sort();return{apps:await Promise.all(p.map(async c=>{let g=i.has(c),f=g?(await v(O.join(e,"apps",c,"ui")))?.proxy?.routes:void 0;return{name:c,hasApi:o.has(c),hasUi:g,apiPackage:n.get(c),backends:f?U(f,a):[]}})),presets:Object.keys(s.devServersPresets??{}),environments:s.environments}},q=e=>{let r=[e.hasUi?"ui":null,e.hasApi?"api":null].filter(Boolean);return`${e.name} (${r.join("+")})`},_=async(e,r,t)=>{let s=new Map(t.apps.map(n=>[n.name,n])),a={};for(let n of r){let i=s.get(n);if(!i?.hasUi||i.backends.length===0)continue;let o=i.backends.map(p=>{let l=`${p.routes.join(",")} \u2192 ${p.packageName}`;return p.localCapable&&p.ownerApp!=null?{name:l,value:p.packageName,checked:!0}:{name:`${l} (cloud only)`,value:p.packageName,disabled:"(cloud only)"}});a[n]=await e.checkbox({message:`\u{1F500} ${n}: which backends run locally?`,choices:o})}return a},K=e=>{let r={api:e.apps.filter(a=>a.hasApi).map(a=>a.name),ui:e.apps.filter(a=>a.hasUi).map(a=>a.name)},t={},s=new Map;for(let a of e.apps){a.apiPackage!=null&&(t[a.name]=a.apiPackage);for(let n of a.backends)for(let i of n.routes)s.set(`${a.name} ${i}`,n.packageName)}return{discovered:r,apiPkgByApp:t,routePkg:(a,n)=>s.get(`${a} ${n}`)}},I=(e,r)=>x({__wizard__:e},K(r)).map(t=>t.message),W=async(e,r)=>{if(r.apps.length===0)return d.warn("No apps discovered to run."),null;let t=await e.checkbox({message:"\u{1F4E6} Which apps?",choices:r.apps.map(c=>({name:q(c),value:c.name,checked:!0}))});if(t.length===0)return d.warn("No apps selected."),null;let s=await _(e,t,r),a=await e.confirm({message:"\u{1F440} Rebuild & restart on save (watch)?",default:!1}),n=await e.confirm({message:"\u{1F9E9} Run each app in its own cmux pane?",default:!1}),i={apps:t,localBackendsByApp:s,watch:a,cmux:n},o=A(i,r);o.anyCloudRoute&&(i.env=await e.select({message:"\u2601\uFE0F  Point cloud routes at which environment?",choices:r.environments.map(c=>({name:c,value:c}))}),m.env[k]=i.env);let p=I(o.presetDef,r);if(p.length>0){d.warn("\u26A0\uFE0F  Proxy audit found issues with this selection:");for(let c of p)d.warn(`   \u2022 ${c}`);return null}E(o,i,r);let l=o.targetKeys.filter(c=>c.endsWith("/api")).map(c=>c.split("/")[0]);return n&&l.length>0?{include:l,watch:a,cmux:!0}:(n&&d.info("\u2139\uFE0F  cmux needs at least one local backend (panes are backend-only) \u2014 running in-process instead."),{presetDef:o.presetDef,watch:a,cmux:!1})},E=(e,r,t)=>{u.start("dev"),u.setInteractive();let s=z(e,r,t);u.addOption(s.flags,!0),u.print(),s.exact||d.info("\u2139\uFE0F  This part-level selection has no exact single-flag form \u2014 save it as a devPreset to reproduce it.")},L=async(e,r)=>{let t=await e.confirm({message:"\u{1F440} Rebuild & restart on save (watch)?",default:!1});return u.start("dev"),u.setInteractive(),u.addOption(r,!0),t&&u.addOption("--watch",!0),u.print(),{preset:r,watch:t,cmux:!1}},M=" manual",T=async(e,r)=>{if(r.presets.length===0)return W(e,r);let t=await e.select({message:"\u{1F680} Start from a preset, or configure manually?",choices:[...r.presets.map(s=>({name:s,value:s})),{name:"Manual (custom)\u2026",value:M}]});return t===M?W(e,r):L(e,t)},se=async(e=$,r=h(m.cwd()))=>T(e,await j(r));export{M as MANUAL_CHOICE,I as auditManualPlan,$ as defaultPrompts,j as gatherWizardModel,se as runDevWizard,T as runWizardFlow};
+//# sourceMappingURL=dev-wizard-run-LYNLPQMV.js.map

package/dist/dev-wizard-run-LYNLPQMV.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/dev/dev-wizard-run.ts", "../src/dev/dev-wizard.ts"],
+  "sourcesContent": ["/**\n * Impure driver for the interactive `infra-kit dev` wizard: filesystem/config discovery, the inquirer\n * prompt flow (step-0 preset-or-manual, then the manual matrix), the pre-flight proxy audit, and the\n * `commandEcho` teaching line. The pure answer\u2192plan mapping lives in {@link file://./dev-wizard.ts}.\n *\n * Prompts are behind the injectable {@link WizardPrompts} seam so the flow is testable without a TTY.\n * This module is reached ONLY from the bare-invocation TTY branch of the entry point; every flagged /\n * non-TTY / `--json` / MCP invocation bypasses it entirely.\n */\nimport inquirerCheckbox from '@inquirer/checkbox'\nimport inquirerConfirm from '@inquirer/confirm'\nimport inquirerSelect from '@inquirer/select'\nimport path from 'node:path'\nimport process from 'node:process'\n\nimport { discoverApiApps, discoverUiApps, findMonorepoRoot } from 'src/dev/discovery'\nimport { commandEcho } from 'src/lib/command-echo'\nimport { INFRA_KIT_ENV_VAR } from 'src/lib/constants'\nimport { getInfraKitConfig } from 'src/lib/infra-kit-config'\nimport type { DevPreset } from 'src/lib/infra-kit-config'\nimport { logger } from 'src/lib/logger'\nimport { loadDev } from 'src/lib/vite/vite'\n\nimport { deriveManualPlan, equivalentCommand } from './dev-wizard.js'\nimport type { DerivedPlan, ManualSelection, ProxyBackend, WizardApp, WizardModel } from './dev-wizard.js'\nimport { validatePresetProxy } from './presets.js'\nimport type { DiscoveredParts, PresetProxyContext } from './presets.js'\n\n/** A wizard prompt choice \u2014 all values are strings, so the seam needs no generics. */\nexport interface WizardChoice {\n  name: string\n  value: string\n  description?: string\n  checked?: boolean\n  disabled?: boolean | string\n}\n\n/**\n * Injectable prompt seam (a string-valued subset of `@inquirer/*`). The default implementation\n * ({@link defaultPrompts}) delegates to the real prompts, rendering to stderr so the dev-server's\n * stdout stays clean. Tests pass a scripted object.\n */\nexport interface WizardPrompts {\n  select: (cfg: { message: string; choices: WizardChoice[]; default?: string }) => Promise<string>\n  checkbox: (cfg: { message: string; choices: WizardChoice[] }) => Promise<string[]>\n  confirm: (cfg: { message: string; default?: boolean }) => Promise<boolean>\n}\n\n/** Real `@inquirer/*` prompts, rendered to stderr (mirrors the bare-`infra-kit` command palette). */\nexport const defaultPrompts: WizardPrompts = {\n  select: (cfg) => {\n    return inquirerSelect(\n      { message: cfg.message, choices: cfg.choices, default: cfg.default },\n      { output: process.stderr },\n    )\n  },\n  checkbox: (cfg) => {\n    return inquirerCheckbox({ message: cfg.message, choices: cfg.choices }, { output: process.stderr })\n  },\n  confirm: (cfg) => {\n    return inquirerConfirm({ message: cfg.message, default: cfg.default }, { output: process.stderr })\n  },\n}\n\n/** What the wizard hands back to the entry point (merged into `DevServerOptions`), or null on cancel. */\nexport interface WizardResult {\n  /** Named preset (preset branch) \u2014 passed through as `options.preset`. */\n  preset?: string\n  /** In-memory preset (manual branch, non-cmux) \u2014 passed through as `options.presetDef`. */\n  presetDef?: DevPreset\n  /**\n   * App-name include list for the cmux path only. `runCmuxDevServer` is preset-unaware and runs one\n   * pane per discovered API app filtered by `include`, so a cmux manual run degrades to its selected\n   * API backends (cmux panes are backend-only by design). Unset for the non-cmux manual path.\n   */\n  include?: string[]\n  watch: boolean\n  cmux: boolean\n}\n\n/** Group one frontend's `dev.proxy.routes` into {@link ProxyBackend}s keyed by backend package. */\nconst groupBackends = (\n  routes: Record<string, { packageName: string; from: readonly string[] }>,\n  ownerByPkg: Map<string, string>,\n): ProxyBackend[] => {\n  const byPkg = new Map<string, ProxyBackend>()\n\n  for (const [route, def] of Object.entries(routes)) {\n    const existing = byPkg.get(def.packageName)\n    const localCapable = def.from.includes('local')\n\n    if (existing) {\n      existing.routes.push(route)\n      existing.localCapable = existing.localCapable || localCapable\n    } else {\n      byPkg.set(def.packageName, {\n        packageName: def.packageName,\n        routes: [route],\n        localCapable,\n        ownerApp: ownerByPkg.get(def.packageName),\n      })\n    }\n  }\n\n  return [...byPkg.values()]\n}\n\n/** Discover apps + configs and assemble the {@link WizardModel} (backends resolved per frontend). */\nexport const gatherWizardModel = async (root: string): Promise<WizardModel> => {\n  const apiApps = discoverApiApps(root)\n  const uiApps = discoverUiApps(root)\n  const config = await getInfraKitConfig()\n\n  const ownerByPkg = new Map(\n    apiApps.map((a) => {\n      return [a.packageName, a.name] as const\n    }),\n  )\n  const apiPkgByName = new Map(\n    apiApps.map((a) => {\n      return [a.name, a.packageName] as const\n    }),\n  )\n  const uiNames = new Set(\n    uiApps.map((a) => {\n      return a.name\n    }),\n  )\n  const apiNames = new Set(\n    apiApps.map((a) => {\n      return a.name\n    }),\n  )\n  const allNames = [...new Set([...apiNames, ...uiNames])].sort()\n\n  const apps: WizardApp[] = await Promise.all(\n    allNames.map(async (name): Promise<WizardApp> => {\n      const hasUi = uiNames.has(name)\n      const routes = hasUi ? (await loadDev(path.join(root, 'apps', name, 'ui')))?.proxy?.routes : undefined\n\n      return {\n        name,\n        hasApi: apiNames.has(name),\n        hasUi,\n        apiPackage: apiPkgByName.get(name),\n        backends: routes ? groupBackends(routes, ownerByPkg) : [],\n      }\n    }),\n  )\n\n  return { apps, presets: Object.keys(config.devServersPresets ?? {}), environments: config.environments }\n}\n\n/** A short \"client (ui+api)\" style label for the app checkbox. */\nconst appLabel = (app: WizardApp): string => {\n  const parts = [app.hasUi ? 'ui' : null, app.hasApi ? 'api' : null].filter(Boolean)\n\n  return `${app.name} (${parts.join('+')})`\n}\n\n/**\n * Ask, per selected frontend that proxies to a backend, which backends run locally. A cloud-only route\n * (no `local` in `from`) is shown disabled. Returns the `localBackendsByApp` map.\n */\nconst promptLocalBackends = async (\n  prompts: WizardPrompts,\n  selectedApps: string[],\n  model: WizardModel,\n): Promise<Record<string, string[]>> => {\n  const byName = new Map(\n    model.apps.map((a) => {\n      return [a.name, a] as const\n    }),\n  )\n  const result: Record<string, string[]> = {}\n\n  for (const name of selectedApps) {\n    const app = byName.get(name)\n\n    if (!app?.hasUi || app.backends.length === 0) continue\n\n    const choices: WizardChoice[] = app.backends.map((b) => {\n      const label = `${b.routes.join(',')} \u2192 ${b.packageName}`\n\n      return b.localCapable && b.ownerApp != null\n        ? { name: label, value: b.packageName, checked: true }\n        : { name: `${label} (cloud only)`, value: b.packageName, disabled: '(cloud only)' }\n    })\n\n    result[name] = await prompts.checkbox({ message: `\uD83D\uDD00 ${name}: which backends run locally?`, choices })\n  }\n\n  return result\n}\n\n/** Build the audit context from the gathered model (no re-reading of configs). */\nconst buildAuditContext = (model: WizardModel): PresetProxyContext => {\n  const discovered: DiscoveredParts = {\n    api: model.apps\n      .filter((a) => {\n        return a.hasApi\n      })\n      .map((a) => {\n        return a.name\n      }),\n    ui: model.apps\n      .filter((a) => {\n        return a.hasUi\n      })\n      .map((a) => {\n        return a.name\n      }),\n  }\n  const apiPkgByApp: Record<string, string> = {}\n  const routeToPkg = new Map<string, string>()\n\n  for (const app of model.apps) {\n    // Map EVERY discovered api app to its own api package \u2014 including api-only apps a frontend proxies\n    // to cross-app \u2014 so `launchedPkgs` in validatePresetProxy is faithful (mirrors preset-proxy-check.ts).\n    // Deriving this from proxy backends alone would miss api-only owners and false-positive the audit.\n    if (app.apiPackage != null) apiPkgByApp[app.name] = app.apiPackage\n    for (const b of app.backends) {\n      for (const route of b.routes) {\n        routeToPkg.set(`${app.name} ${route}`, b.packageName)\n      }\n    }\n  }\n\n  return {\n    discovered,\n    apiPkgByApp,\n    routePkg: (app, route) => {\n      return routeToPkg.get(`${app} ${route}`)\n    },\n  }\n}\n\n/**\n * Run the assembled plan through the SAME proxy-locality rule the root audit uses. Returns issue\n * messages (empty when clean). Catches a `local` override whose backend won't launch \u2014 the wizard's\n * derivation launches owners, so a hit means the backend has no discoverable owning app.\n */\nexport const auditManualPlan = (presetDef: DevPreset, model: WizardModel): string[] => {\n  return validatePresetProxy({ __wizard__: presetDef }, buildAuditContext(model)).map((i) => {\n    return i.message\n  })\n}\n\n/** The manual-branch flow: app + per-app proxy + env + watch + cmux \u2192 audited plan \u2192 echo. */\nconst runManualBranch = async (prompts: WizardPrompts, model: WizardModel): Promise<WizardResult | null> => {\n  if (model.apps.length === 0) {\n    logger.warn('No apps discovered to run.')\n\n    return null\n  }\n\n  const selectedApps = await prompts.checkbox({\n    message: '\uD83D\uDCE6 Which apps?',\n    choices: model.apps.map((a) => {\n      return { name: appLabel(a), value: a.name, checked: true }\n    }),\n  })\n\n  if (selectedApps.length === 0) {\n    logger.warn('No apps selected.')\n\n    return null\n  }\n\n  const localBackendsByApp = await promptLocalBackends(prompts, selectedApps, model)\n  const watch = await prompts.confirm({ message: '\uD83D\uDC40 Rebuild & restart on save (watch)?', default: false })\n  const cmux = await prompts.confirm({ message: '\uD83E\uDDE9 Run each app in its own cmux pane?', default: false })\n\n  const selection: ManualSelection = { apps: selectedApps, localBackendsByApp, watch, cmux }\n  const plan = deriveManualPlan(selection, model)\n\n  if (plan.anyCloudRoute) {\n    selection.env = await prompts.select({\n      message: '\u2601\uFE0F  Point cloud routes at which environment?',\n      choices: model.environments.map((e) => {\n        return { name: e, value: e }\n      }),\n    })\n    process.env[INFRA_KIT_ENV_VAR] = selection.env\n  }\n\n  const issues = auditManualPlan(plan.presetDef, model)\n\n  if (issues.length > 0) {\n    logger.warn('\u26A0\uFE0F  Proxy audit found issues with this selection:')\n    for (const issue of issues) {\n      logger.warn(`   \u2022 ${issue}`)\n    }\n\n    return null\n  }\n\n  echoManual(plan, selection, model)\n\n  // cmux is backend-pane-only and preset-unaware: hand it the selected API apps as an include list.\n  const apiApps = plan.targetKeys\n    .filter((k) => {\n      return k.endsWith('/api')\n    })\n    .map((k) => {\n      return k.split('/')[0]!\n    })\n\n  // An empty include would collapse to `null` in `normalizeAppInclude` and make cmux run EVERY api app,\n  // so a cmux run with no selected backends (e.g. an all-frontend selection) falls back to in-process.\n  if (cmux && apiApps.length > 0) {\n    return { include: apiApps, watch, cmux: true }\n  }\n\n  if (cmux) {\n    logger.info('\u2139\uFE0F  cmux needs at least one local backend (panes are backend-only) \u2014 running in-process instead.')\n  }\n\n  return { presetDef: plan.presetDef, watch, cmux: false }\n}\n\n/** Print the equivalent flag command (and, for a part-level selection, the save-as-preset hint). */\nconst echoManual = (plan: DerivedPlan, selection: ManualSelection, model: WizardModel): void => {\n  commandEcho.start('dev')\n  commandEcho.setInteractive()\n\n  const eq = equivalentCommand(plan, selection, model)\n\n  commandEcho.addOption(eq.flags, true)\n  commandEcho.print()\n\n  if (!eq.exact) {\n    logger.info('\u2139\uFE0F  This part-level selection has no exact single-flag form \u2014 save it as a devPreset to reproduce it.')\n  }\n}\n\n/** The preset-branch flow: run a named preset, asking only whether to watch (presets can't encode it). */\nconst runPresetBranch = async (prompts: WizardPrompts, preset: string): Promise<WizardResult> => {\n  const watch = await prompts.confirm({ message: '\uD83D\uDC40 Rebuild & restart on save (watch)?', default: false })\n\n  commandEcho.start('dev')\n  commandEcho.setInteractive()\n  commandEcho.addOption(preset, true)\n  if (watch) commandEcho.addOption('--watch', true)\n  commandEcho.print()\n\n  return { preset, watch, cmux: false }\n}\n\n/** Sentinel value for the \"Manual (custom)\" step-0 choice (a preset name can never be empty). */\nexport const MANUAL_CHOICE = ' manual'\n\n/**\n * Drive the wizard's branch flow over an ALREADY-gathered model (no disk/config access). Split from\n * {@link runDevWizard} so the flow is unit-testable with scripted prompts + a fixture model.\n */\nexport const runWizardFlow = async (prompts: WizardPrompts, model: WizardModel): Promise<WizardResult | null> => {\n  if (model.presets.length === 0) {\n    return runManualBranch(prompts, model)\n  }\n\n  const choice = await prompts.select({\n    message: '\uD83D\uDE80 Start from a preset, or configure manually?',\n    choices: [\n      ...model.presets.map((p) => {\n        return { name: p, value: p }\n      }),\n      { name: 'Manual (custom)\u2026', value: MANUAL_CHOICE },\n    ],\n  })\n\n  return choice === MANUAL_CHOICE ? runManualBranch(prompts, model) : runPresetBranch(prompts, choice)\n}\n\n/**\n * Gather the model from disk/config, then drive the wizard flow, returning the resolved run options (or\n * null on cancel / empty selection). The entry point calls this on a bare TTY `infra-kit dev`.\n */\nexport const runDevWizard = async (\n  prompts: WizardPrompts = defaultPrompts,\n  root: string = findMonorepoRoot(process.cwd()),\n): Promise<WizardResult | null> => {\n  return runWizardFlow(prompts, await gatherWizardModel(root))\n}\n", "/**\n * Pure core of the interactive `infra-kit dev` wizard (the no-args, TTY path).\n *\n * The wizard is FRONTEND-CENTRIC: you pick apps to run, and for each frontend you choose, per backend\n * it proxies to, whether that backend runs LOCALLY (its `/api` is launched \u2192 the route resolves local)\n * or stays CLOUD (not launched \u2192 the route proxies to the `<env>` cloud target). A backend runs iff a\n * frontend points at it locally, or its app is selected and not demoted to cloud. This module turns\n * those answers into an in-memory {@link DevPreset} the runner consumes verbatim (part-level targets\n * that the app-name-only `--app` include cannot express) \u2014 and is side-effect-free so the mapping is\n * fully unit-testable. The impure I/O (discovery, inquirer prompts, audit, launch) lives in\n * {@link file://./dev-wizard-run.ts}.\n */\nimport type { DevPreset, ProxySource } from 'src/lib/infra-kit-config'\n\n/**\n * One backend a frontend's proxy routes can be pointed at, grouped by the backend package. A frontend\n * that maps `/api` and `/media` to the same package yields ONE {@link ProxyBackend} with both routes \u2014\n * launching the package flips every one of its `local`-capable routes together (see `pickSource`).\n */\nexport interface ProxyBackend {\n  /** Backend package name (a route's `packageName`). */\n  packageName: string\n  /** Route paths that resolve to this package (for display + the audit's per-route overrides). */\n  routes: string[]\n  /** True when at least one of `routes` lists `local` in its `from` capabilities \u2014 i.e. it is toggleable. A `false` backend is fixed-cloud, shown as info. */\n  localCapable: boolean\n  /** App folder whose `api` package is {@link packageName}, or undefined when no discovered app owns it (a `local` choice then has nothing to launch \u2014 the audit flags it). */\n  ownerApp?: string\n}\n\n/** A discovered app as the wizard sees it: which parts exist + which backends its frontend proxies to. */\nexport interface WizardApp {\n  /** App folder name (e.g. `client`). */\n  name: string\n  /** Has `apps/<app>/api` (a launchable backend). */\n  hasApi: boolean\n  /** Has `apps/<app>/ui` (a launchable frontend). */\n  hasUi: boolean\n  /**\n   * This app's OWN `api` package name (from `apps/<app>/api`), or undefined when it has no api. Carried\n   * so the audit can build a faithful `app \u2192 apiPackage` map for EVERY discovered api app \u2014 including\n   * api-only apps a frontend proxies to cross-app \u2014 mirroring the root audit (`preset-proxy-check.ts`).\n   */\n  apiPackage?: string\n  /** Backends this app's frontend proxies to (empty for api-only apps or a frontend with no `dev.proxy`). */\n  backends: ProxyBackend[]\n}\n\n/** Everything the wizard needs, gathered impurely by {@link file://./dev-wizard-run.ts}. */\nexport interface WizardModel {\n  /** All discovered apps (api and/or ui), sorted by name. */\n  apps: WizardApp[]\n  /** `devServersPresets` names (drives the preset-or-manual step-0). */\n  presets: string[]\n  /** Configured `environments` (the cloud-env `select` options). */\n  environments: string[]\n}\n\n/** The manual-branch answers collected from the prompts, fed to {@link deriveManualPlan}. */\nexport interface ManualSelection {\n  /** Selected app folder names. */\n  apps: string[]\n  /** app folder \u2192 backend package names the user chose to run LOCALLY (subset of that app's `localCapable` backends). */\n  localBackendsByApp: Record<string, string[]>\n  /** Chosen cloud env for cloud routes (undefined when nothing resolves cloud). */\n  env?: string\n  /** Rebuild + restart on save. */\n  watch: boolean\n  /** One cmux pane per app. */\n  cmux: boolean\n}\n\n/** The resolved run plan derived from a {@link ManualSelection}. */\nexport interface DerivedPlan {\n  /** In-memory preset handed to the runner (`options.presetDef`). */\n  presetDef: DevPreset\n  /** At least one route resolves to cloud \u2192 an env must be chosen (pre-flight gate). */\n  anyCloudRoute: boolean\n  /** Resolved `<app>/<part>` target keys, sorted \u2014 for the echo + audit display. */\n  targetKeys: string[]\n}\n\n/** Index a model's apps by folder name for O(1) lookup. */\nconst byName = (model: WizardModel): Map<string, WizardApp> => {\n  return new Map(\n    model.apps.map((a) => {\n      return [a.name, a]\n    }),\n  )\n}\n\ninterface ProxyPass {\n  /** Owner apps whose `/api` must launch because a route was chosen local. */\n  localOwners: Set<string>\n  /** Selected apps whose OWN backend was chosen cloud \u2192 demote (drop their `/api`) unless still needed local. */\n  demoteOwn: Set<string>\n  /** frontend app \u2192 per-route source overrides (recorded for the audit; runtime derives from the api targets). */\n  proxyByUiApp: Map<string, Record<string, ProxySource>>\n  /** At least one route resolved cloud. */\n  anyCloud: boolean\n}\n\n/**\n * Fold ONE backend of a frontend into the pass: record its Local/Cloud source per route, add its owner\n * to the launch set (local) or flag its own-api demotion + a cloud route (cloud). Extracted so\n * {@link resolveProxyPass}'s loop stays flat.\n */\nconst applyBackend = (\n  backend: ProxyBackend,\n  appName: string,\n  localPkgs: ReadonlySet<string>,\n  pass: ProxyPass,\n  overrides: Record<string, ProxySource>,\n): void => {\n  const isLocal = backend.localCapable && localPkgs.has(backend.packageName)\n\n  if (isLocal) {\n    if (backend.ownerApp != null) pass.localOwners.add(backend.ownerApp)\n  } else {\n    pass.anyCloud = true\n    // The selected app's OWN backend, left cloud \u2192 run frontend-only (drop its /api later).\n    if (backend.ownerApp === appName) pass.demoteOwn.add(appName)\n  }\n\n  for (const route of backend.routes) {\n    overrides[route] = isLocal ? 'local' : 'cloud'\n  }\n}\n\n/**\n * Resolve every selected frontend's per-backend Local/Cloud choice into the owner-api launch set, the\n * own-api demotions, and the per-route override map. Kept separate from {@link deriveManualPlan} so the\n * target-set arithmetic stays readable.\n */\nconst resolveProxyPass = (selection: ManualSelection, apps: Map<string, WizardApp>): ProxyPass => {\n  const pass: ProxyPass = { localOwners: new Set(), demoteOwn: new Set(), proxyByUiApp: new Map(), anyCloud: false }\n\n  for (const name of selection.apps) {\n    const app = apps.get(name)\n\n    if (!app?.hasUi) continue\n\n    const localPkgs = new Set(selection.localBackendsByApp[name] ?? [])\n    const overrides: Record<string, ProxySource> = {}\n\n    for (const backend of app.backends) {\n      applyBackend(backend, name, localPkgs, pass, overrides)\n    }\n\n    if (Object.keys(overrides).length > 0) pass.proxyByUiApp.set(name, overrides)\n  }\n\n  return pass\n}\n\n/**\n * Turn a {@link ManualSelection} into an in-memory {@link DevPreset}. Target rules:\n *  - every selected app with a `ui` runs its frontend (`<app>/ui`);\n *  - a selected app with an `api` runs it full-stack by default, UNLESS its own frontend demoted that\n *    backend to cloud (and no other frontend needs it local);\n *  - any backend a selected frontend proxies to LOCALLY launches (`<owner>/api`), even cross-app or\n *    when the owner app was not itself selected.\n *\n * @example\n * // client (ui+api) selected, its /api chosen cloud \u2192 frontend-only:\n * deriveManualPlan(\n *   { apps: ['client'], localBackendsByApp: {}, env: 'dev', watch: false, cmux: false },\n *   { apps: [{ name: 'client', hasApi: true, hasUi: true,\n *              backends: [{ packageName: 'client-api', routes: ['/api'], localCapable: true, ownerApp: 'client' }] }],\n *     presets: [], environments: ['dev'] },\n * ).targetKeys // => ['client/ui']\n */\nexport const deriveManualPlan = (selection: ManualSelection, model: WizardModel): DerivedPlan => {\n  const apps = byName(model)\n  const uiApps = selection.apps.filter((n) => {\n    return apps.get(n)?.hasUi === true\n  })\n  const apiTargets = new Set(\n    selection.apps.filter((n) => {\n      return apps.get(n)?.hasApi === true\n    }),\n  )\n\n  const pass = resolveProxyPass(selection, apps)\n\n  for (const owner of pass.localOwners) {\n    apiTargets.add(owner)\n  }\n  for (const name of pass.demoteOwn) {\n    if (!pass.localOwners.has(name)) apiTargets.delete(name)\n  }\n\n  const presetApps: Record<string, { proxy?: Record<string, ProxySource> }> = {}\n\n  for (const name of uiApps) {\n    const overrides = pass.proxyByUiApp.get(name)\n\n    presetApps[`${name}/ui`] = overrides ? { proxy: overrides } : {}\n  }\n  for (const name of apiTargets) {\n    presetApps[`${name}/api`] ??= {}\n  }\n\n  return {\n    presetDef: { apps: presetApps, cmux: selection.cmux },\n    anyCloudRoute: pass.anyCloud,\n    targetKeys: Object.keys(presetApps).sort(),\n  }\n}\n\n/** The equivalent non-interactive command, plus whether it reproduces the selection exactly. */\nexport interface EquivalentCommand {\n  /** The `--app=\u2026`-form flag string (no leading `infra-kit dev`). */\n  flags: string\n  /**\n   * True when `--app` reproduces the plan exactly \u2014 i.e. every involved app runs ALL the parts it has.\n   * False for a part-level selection (e.g. frontend-only), which `--app` (app-name granularity) cannot\n   * express; the caller then hints \"save as a preset\" for exact reproduction.\n   */\n  exact: boolean\n}\n\n/** App folder name from an `<app>/<part>` target key. */\nconst appOf = (key: string): string => {\n  return key.split('/')[0]!\n}\n\n/**\n * Build the equivalent `infra-kit dev --app=\u2026 [--watch] [--cmux]` flag string for a derived plan.\n * `exact` is true only when the target set covers every part each involved app HAS (a whole-app\n * selection), since `--app` filters by app name, not part.\n */\nexport const equivalentCommand = (\n  plan: DerivedPlan,\n  selection: ManualSelection,\n  model: WizardModel,\n): EquivalentCommand => {\n  const apps = byName(model)\n  const involved = [...new Set(plan.targetKeys.map(appOf))].sort()\n  const present = new Set(plan.targetKeys)\n\n  const exact = involved.every((name) => {\n    const app = apps.get(name)\n\n    if (!app) return false\n\n    const uiOk = !app.hasUi || present.has(`${name}/ui`)\n    const apiOk = !app.hasApi || present.has(`${name}/api`)\n\n    return uiOk && apiOk\n  })\n\n  const parts = [`--app=${involved.join(',')}`]\n\n  if (selection.watch) parts.push('--watch')\n  if (selection.cmux) parts.push('--cmux')\n\n  return { flags: parts.join(' '), exact }\n}\n"],
+  "mappings": "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",
+  "names": ["inquirerCheckbox", "inquirerConfirm", "inquirerSelect", "path", "process", "byName", "model", "a", "applyBackend", "backend", "appName", "localPkgs", "pass", "overrides", "isLocal", "route", "resolveProxyPass", "selection", "apps", "name", "app", "deriveManualPlan", "uiApps", "n", "apiTargets", "owner", "presetApps", "appOf", "key", "equivalentCommand", "plan", "involved", "present", "exact", "uiOk", "apiOk", "parts", "defaultPrompts", "cfg", "inquirerSelect", "process", "inquirerCheckbox", "inquirerConfirm", "groupBackends", "routes", "ownerByPkg", "byPkg", "route", "def", "existing", "localCapable", "gatherWizardModel", "root", "apiApps", "discoverApiApps", "uiApps", "discoverUiApps", "config", "getInfraKitConfig", "a", "apiPkgByName", "uiNames", "apiNames", "allNames", "name", "hasUi", "loadDev", "path", "appLabel", "app", "parts", "promptLocalBackends", "prompts", "selectedApps", "model", "byName", "result", "choices", "b", "label", "buildAuditContext", "discovered", "apiPkgByApp", "routeToPkg", "auditManualPlan", "presetDef", "validatePresetProxy", "i", "runManualBranch", "logger", "localBackendsByApp", "watch", "cmux", "selection", "plan", "deriveManualPlan", "e", "INFRA_KIT_ENV_VAR", "issues", "issue", "echoManual", "k", "commandEcho", "eq", "equivalentCommand", "runPresetBranch", "preset", "MANUAL_CHOICE", "runWizardFlow", "choice", "p", "runDevWizard", "findMonorepoRoot"]
+}

package/dist/entry/index.d.ts

@@ -1,4 +1,4 @@
 export { defineConfig } from '../lib/package-config/package-config';
-export type { InfraKitPackageConfig, InfraKitPackageConfigInput } from '../lib/package-config/package-config';
+export type { InfraKitDev, InfraKitDevProxy, InfraKitDevProxyRoute, InfraKitDevProxySource, InfraKitPackageConfig, InfraKitPackageConfigInput, } from '../lib/package-config/package-config';
 export { defineVendorConfig } from '../lib/vendor/config-schema';
 export type { VendorConfig, VendorCopyItem } from '../lib/vendor/config-schema';

package/dist/entry/vite.d.ts

@@ -0,0 +1,2 @@
+export { infraKitDev, infraKitProxy, resolveProxyConfig, slugifyRelease } from '../lib/vite/vite';
+export type { InfraKitBasicAuth, InfraKitDevOptions, InfraKitViteProxy, InfraKitViteProxyEntry } from '../lib/vite/vite';

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as o,g as e}from"./chunk-YSBF5C7C.js";export{o as defineConfig,e as defineVendorConfig};
+import{a as e,g as o}from"./chunk-Z6KTUVIC.js";export{e as defineConfig,o as defineVendorConfig};
 //# sourceMappingURL=index.js.map

package/dist/lib/package-config/package-config-schema.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+/**
+ * Schema for the resolved (post-factory) package config object. `strictObject`
+ * rejects unknown keys so typos in `infra-kit.config.ts` surface as validation
+ * errors instead of being silently ignored.
+ *
+ * Kept in its own module — separate from the public `defineConfig`/types entry —
+ * so the published `infra-kit` type surface stays free of a `zod` import.
+ */
+export declare const packageConfigSchema: z.ZodObject<{
+    requiredScripts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    turbo: z.ZodOptional<z.ZodObject<{
+        requiredTasks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    dev: z.ZodOptional<z.ZodObject<{
+        proxy: z.ZodOptional<z.ZodObject<{
+            templates: z.ZodObject<{
+                local: z.ZodString;
+                cloud: z.ZodString;
+            }, z.core.$strict>;
+            routes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                packageName: z.ZodString;
+                from: z.ZodArray<z.ZodEnum<{
+                    local: "local";
+                    cloud: "cloud";
+                }>>;
+                default: z.ZodOptional<z.ZodEnum<{
+                    local: "local";
+                    cloud: "cloud";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;

package/dist/lib/package-config/package-config.d.ts

@@ -24,6 +24,34 @@ export interface InfraKitPackageConfig {
         /** Tasks that must be defined in turbo.json `tasks`. */
         requiredTasks?: string[];
     };
+    /** Local-dev configuration. Accepted-and-inert to the audit; consumed by the dev server. */
+    dev?: InfraKitDev;
+}
+/** A proxy route's allowed backend source. */
+export type InfraKitDevProxySource = 'local' | 'cloud';
+export interface InfraKitDevProxyRoute {
+    /** Backend package this route targets when resolved locally. */
+    packageName: string;
+    /** Capabilities this route can resolve to. Must be non-empty. */
+    from: InfraKitDevProxySource[];
+    /**
+     * Source used when a local backend for this package isn't active. Required when
+     * `from` lists more than one source; redundant (and omitted) for a single-source
+     * route. When set, must be one of `from`.
+     */
+    default?: InfraKitDevProxySource;
+}
+export interface InfraKitDevProxy {
+    /** URL templates. Placeholders like `<release>`/`<packageName>`/`<env>` are substituted at dev time. */
+    templates: {
+        local: string;
+        cloud: string;
+    };
+    /** Path-prefix (e.g. `/api`, `/api/v1`, `/media`) → route definition. */
+    routes: Record<string, InfraKitDevProxyRoute>;
+}
+export interface InfraKitDev {
+    proxy?: InfraKitDevProxy;
 }
 /**
  * Accepted shapes for a package config's default export — mirrors Vite's

package/dist/lib/release-slug/release-slug.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared, dependency-light release-slug helper.
+ *
+ * Extracted from `lib/vite/vite.ts` so BOTH the published `infra-kit/vite` helper
+ * (which re-exports it) and the dev-server's dev-context fragment writer derive the
+ * `<release>` hostname segment from ONE implementation — the recorded slug and the
+ * helper-computed slug can never drift. Pure (regex only, no imports) so importing it
+ * into the lightweight `infra-kit/vite` bundle stays cheap.
+ */
+/**
+ * Slugify a git branch into a `<release>` token: strip a leading git-flow prefix
+ * (`feature/`, `release/`, …), lowercase, collapse non-alphanumeric runs to `-`,
+ * and trim stray dashes.
+ *
+ * @example
+ * slugifyRelease('release/2.4')     // => '2-4'
+ * slugifyRelease('feature/HUL-123') // => 'hul-123'
+ */
+export declare const slugifyRelease: (branch: string) => string;

package/dist/lib/vite/vite.d.ts

@@ -0,0 +1,136 @@
+import type { InfraKitDev, InfraKitDevProxy } from '../package-config/package-config';
+import { slugifyRelease } from '../release-slug/release-slug';
+/**
+ * A single Vite `server.proxy` entry. `changeOrigin` is always set; the
+ * cloud-only pair (`secure: false` + `cookieDomainRewrite: 'localhost'`) makes a
+ * local FE talk to an HTTPS cloud BE without cert/cookie-domain breakage.
+ * `headers` is present only when HTTP Basic Auth is injected (see
+ * {@link buildBasicAuthHeader}) — it carries the `Authorization` header applied
+ * uniformly to every route so upstream environments behind auth (e2e/staging)
+ * stay reachable.
+ */
+export interface InfraKitViteProxyEntry {
+    target: string;
+    changeOrigin: true;
+    secure?: false;
+    cookieDomainRewrite?: 'localhost';
+    headers?: Record<string, string>;
+}
+/** A Vite `server.proxy`-shaped map: path-prefix → proxy entry. */
+export type InfraKitViteProxy = Record<string, InfraKitViteProxyEntry>;
+/** Explicit HTTP Basic Auth credentials, overriding the `E2E__BASIC_AUTH_*` env vars. */
+export interface InfraKitBasicAuth {
+    username: string;
+    password: string;
+}
+export interface InfraKitDevOptions {
+    /** Package dir whose `infra-kit.config.ts` is loaded. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /**
+     * Explicit HTTP Basic Auth credentials injected into every proxy route as an
+     * `Authorization` header. Takes precedence over the `E2E__BASIC_AUTH_USERNAME`
+     * / `E2E__BASIC_AUTH_PASSWORD` env vars. Omit to use the env-based default.
+     */
+    basicAuth?: InfraKitBasicAuth;
+    /**
+     * Vite's `command`. Pass it (`defineConfig(async ({ command }) => ({ server: await infraKitDev({ command }) }))`)
+     * so `build` is a no-op: `server` is irrelevant to a build and proxy resolution would otherwise
+     * fail-fast on a cloud route with no sourced env. Omit (or `'serve'`) for the dev-server config.
+     */
+    command?: 'build' | 'serve';
+    /**
+     * Explicit dev-server port. Omit for a **per-worktree dynamic** free port (a fresh OS-assigned
+     * port) so N simultaneous git worktrees never collide on Vite's default `5173`; Vite prints the
+     * chosen URL. Pass a fixed number only when an external contract pins the port.
+     */
+    port?: number;
+}
+/**
+ * Re-exported from the shared, dependency-light `lib/release-slug` module so the
+ * published `infra-kit/vite` surface (`entry/vite.ts:7`) is unchanged while the
+ * dev-server's fragment writer derives `<release>` from the SAME implementation
+ * (no slug drift). See {@link slugifyRelease}.
+ */
+export { slugifyRelease };
+interface ResolveProxyArgs {
+    proxy: InfraKitDevProxy;
+    localSet: ReadonlySet<string>;
+    env: string | undefined;
+    getRelease: () => string;
+    /** Pre-computed `Authorization` header value applied uniformly to every route. */
+    authHeader?: string;
+    /** Per-package runtime data (recorded release/port) from the dev-context merge. */
+    localInfo?: ReadonlyMap<string, LocalPackageInfo>;
+}
+/**
+ * Pure resolver: turn a `dev.proxy` config + resolved inputs (local set, env,
+ * lazy release) into a Vite `server.proxy` map. Side-effect-free so the
+ * resolution shape is fully unit-testable. When `authHeader` is set, every route
+ * entry gets a matching `headers.Authorization`; otherwise no `headers` key.
+ */
+export declare const resolveProxyConfig: ({ proxy, localSet, env, getRelease, authHeader, localInfo, }: ResolveProxyArgs) => InfraKitViteProxy;
+/**
+ * Load a package's `infra-kit.config.ts` and return its `dev` block, or
+ * `undefined` when the config or the `dev` key is absent. The `.ts` config is
+ * evaluated via Node's native type stripping (Node >= 24) — the same mechanism
+ * the CLI's config loader uses. Cache-busted by mtime so repeated dev-server
+ * reloads pick up edits.
+ */
+export declare const loadDev: (cwd: string) => Promise<InfraKitDev | undefined>;
+/** Per-package runtime data merged from the dev-context fragment directory. */
+export interface LocalPackageInfo {
+    /** The real bound port the runner recorded (available for a future direct mode). */
+    port: number;
+    /** The runner-recorded release slug, preferred over the helper's git derivation. */
+    release?: string;
+}
+/**
+ * The locally-running package set plus a `package → { port, release }` map merged
+ * from the dev-context fragments. `packages` feeds `pickSource`; `info` lets a
+ * `local` route emit the per-package recorded release (see {@link resolveRoute}).
+ */
+export interface LocalContext {
+    packages: ReadonlySet<string>;
+    info: ReadonlyMap<string, LocalPackageInfo>;
+}
+/**
+ * Read the locally-running package context, searched upward from `cwd`. Prefers
+ * the `.infra-kit/dev-context/` fragment DIRECTORY (merged via
+ * {@link readFragmentDir}); when it is absent, falls back to the legacy single
+ * `.infra-kit/dev-context.json` file (read as before — no per-package release);
+ * when neither exists → empty context (frontend-only, every route resolves cloud).
+ */
+export declare const readLocalContext: (cwd: string) => LocalContext;
+/**
+ * Read the set of locally-running packages (searched upward from `cwd`). Thin
+ * wrapper over {@link readLocalContext} preserving the historical `Set`-returning
+ * contract. Absent dev-context → empty set (frontend-only cloud resolution).
+ */
+export declare const readLocalSet: (cwd: string) => ReadonlySet<string>;
+/**
+ * Resolve a package's `dev` block into a ready-made Vite `server` config: a per-worktree dev-server
+ * `port` plus the `proxy` map. Loads the package's `infra-kit.config.ts`, merges the local dev set
+ * from the `.infra-kit/dev-context/` fragment directory, and interpolates the local/cloud templates.
+ * `<env>` comes from `INFRA_KIT_ENV`; `<release>` from each package's runner-recorded fragment when
+ * present, else the slugified git branch (computed lazily, only when a local route needs it).
+ *
+ * `port` defaults to a fresh OS-assigned free port so simultaneous git worktrees never collide on
+ * Vite's `5173` (override via `options.port`). Pass `command` so `build` is a no-op (empty proxy, no
+ * port) — a build ignores `server` and proxy resolution would otherwise fail-fast on a cloud route
+ * with no sourced env.
+ *
+ * @example
+ * // vite.config.ts — the whole `server` field is the helper's output
+ * import { infraKitDev } from 'infra-kit/vite'
+ * export default defineConfig(async ({ command }) => ({ server: await infraKitDev({ command }) }))
+ */
+export declare const infraKitDev: (options?: InfraKitDevOptions) => Promise<{
+    port?: number;
+    strictPort?: boolean;
+    proxy: InfraKitViteProxy;
+}>;
+/**
+ * Convenience wrapper returning just the proxy map (for spreading into
+ * `server.proxy` directly). Equivalent to `(await infraKitDev(options)).proxy`.
+ */
+export declare const infraKitProxy: (options?: InfraKitDevOptions) => Promise<InfraKitViteProxy>;

package/dist/mcp.js

@@ -1,2 +1,2 @@
-import{S as m,a as s,b as p,c}from"./chunk-QBHCWAAG.js";import"./chunk-DB6CTNBS.js";import"./chunk-YSBF5C7C.js";import{StdioServerTransport as g}from"@modelcontextprotocol/sdk/server/stdio.js";import h from"node:process";import o from"node:process";var l=r=>{o.on("SIGINT",()=>{r.info({msg:"Received SIGINT. Shutting down..."}),o.exit(0)}),o.on("SIGTERM",()=>{r.info({msg:"Received SIGTERM. Shutting down..."}),o.exit(0)}),o.on("uncaughtException",e=>{r.fatal({err:e,msg:"Uncaught Exception"}),r.error(`Uncaught Exception! Check ${s}. Shutting down...`),r.flush(),o.exit(1)}),o.on("unhandledRejection",(e,n)=>{r.fatal({reason:e,promise:n,msg:"Unhandled Rejection"}),r.error(`Unhandled Rejection! Check ${s}. Shutting down...`),r.flush(),o.exit(1)})};import{McpServer as x}from"@modelcontextprotocol/sdk/server/mcp.js";var d=async r=>{};var u=async r=>{};var a=r=>async e=>{let{toolName:n,handler:S}=r;c.info({msg:`Tool execution started: ${n}`,params:e});try{let i=await S({...e,confirmedCommand:!0});return c.info({msg:`Tool execution successful: ${n}`}),i}catch(i){throw c.error({err:i,params:e,msg:`Tool execution failed: ${n}`}),i}};var f=async r=>{for(let e of m())r.registerTool(e.name,{description:e.description,inputSchema:e.inputSchema,outputSchema:e.outputSchema},a({toolName:e.name,handler:e.handler}))};async function v(){let r=new x({name:"infra-kit",version:"1.0.0"},{capabilities:{resources:{},tools:{},prompts:{}}});return await d(r),await u(r),await f(r),r}var t=p(),T=async()=>{let r;try{r=await v(),t.info("MCP Server instance created")}catch(e){t.error({err:e,msg:"Failed to create MCP server"}),t.error("Fatal error during server creation."),h.exit(1)}try{let e=new g;await r.connect(e),t.info({msg:"Server connected to transport. Ready."})}catch(e){t.error({err:e,msg:"Failed to initialize server"}),t.error("Fatal error during server transport init."),h.exit(1)}};l(t);T();
+import{G as m}from"./chunk-AP63Y7KE.js";import"./chunk-Q36WX5RP.js";import"./chunk-Z6KTUVIC.js";import"./chunk-V375VXOL.js";import{t as s,u as p,v as c}from"./chunk-4YU4TAGX.js";import"./chunk-YGCVOVNX.js";import"./chunk-2PZRQHWF.js";import{StdioServerTransport as g}from"@modelcontextprotocol/sdk/server/stdio.js";import h from"node:process";import o from"node:process";var l=r=>{o.on("SIGINT",()=>{r.info({msg:"Received SIGINT. Shutting down..."}),o.exit(0)}),o.on("SIGTERM",()=>{r.info({msg:"Received SIGTERM. Shutting down..."}),o.exit(0)}),o.on("uncaughtException",e=>{r.fatal({err:e,msg:"Uncaught Exception"}),r.error(`Uncaught Exception! Check ${s}. Shutting down...`),r.flush(),o.exit(1)}),o.on("unhandledRejection",(e,n)=>{r.fatal({reason:e,promise:n,msg:"Unhandled Rejection"}),r.error(`Unhandled Rejection! Check ${s}. Shutting down...`),r.flush(),o.exit(1)})};import{McpServer as x}from"@modelcontextprotocol/sdk/server/mcp.js";var d=async r=>{};var u=async r=>{};var a=r=>async e=>{let{toolName:n,handler:S}=r;c.info({msg:`Tool execution started: ${n}`,params:e});try{let i=await S({...e,confirmedCommand:!0});return c.info({msg:`Tool execution successful: ${n}`}),i}catch(i){throw c.error({err:i,params:e,msg:`Tool execution failed: ${n}`}),i}};var f=async r=>{for(let e of m())r.registerTool(e.name,{description:e.description,inputSchema:e.inputSchema,outputSchema:e.outputSchema},a({toolName:e.name,handler:e.handler}))};async function v(){let r=new x({name:"infra-kit",version:"1.0.0"},{capabilities:{resources:{},tools:{},prompts:{}}});return await d(r),await u(r),await f(r),r}var t=p(),T=async()=>{let r;try{r=await v(),t.info("MCP Server instance created")}catch(e){t.error({err:e,msg:"Failed to create MCP server"}),t.error("Fatal error during server creation."),h.exit(1)}try{let e=new g;await r.connect(e),t.info({msg:"Server connected to transport. Ready."})}catch(e){t.error({err:e,msg:"Failed to initialize server"}),t.error("Fatal error during server transport init."),h.exit(1)}};l(t);T();
 //# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/entry/mcp.ts", "../src/lib/error-handlers/index.ts", "../src/mcp/server.ts", "../src/mcp/prompts/index.ts", "../src/mcp/resources/index.ts", "../src/lib/tool-handler/tool-handler.ts", "../src/mcp/tools/index.ts"],
   "sourcesContent": ["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport process from 'node:process'\n\nimport { setupErrorHandlers } from 'src/lib/error-handlers'\nimport { initLoggerMcp } from 'src/lib/logger'\n\nimport { createMcpServer } from '../mcp/server'\n\nconst logger = initLoggerMcp()\n\nconst startServer = async () => {\n  let server\n\n  try {\n    server = await createMcpServer()\n\n    logger.info('MCP Server instance created')\n  } catch (error) {\n    logger.error({ err: error, msg: 'Failed to create MCP server' })\n    logger.error(`Fatal error during server creation.`)\n\n    process.exit(1)\n  }\n\n  try {\n    const transport = new StdioServerTransport()\n\n    await server.connect(transport)\n\n    logger.info({ msg: 'Server connected to transport. Ready.' })\n  } catch (error) {\n    logger.error({ err: error, msg: 'Failed to initialize server' })\n    logger.error(`Fatal error during server transport init.`)\n\n    process.exit(1)\n  }\n}\n\n// Setup error handlers\nsetupErrorHandlers(logger)\n\n// Start the server\nstartServer()\n", "import process from 'node:process'\nimport type { Logger } from 'pino'\n\nimport { LOG_FILE_PATH } from '../logger/index'\n\n/**\n * Setup error handlers for the application\n * @param logger - The logger instance\n *\n * ONLY FOR SERVER!\n */\nexport const setupErrorHandlers = (logger: Logger) => {\n  process.on('SIGINT', () => {\n    logger.info({ msg: 'Received SIGINT. Shutting down...' })\n    process.exit(0)\n  })\n\n  process.on('SIGTERM', () => {\n    logger.info({ msg: 'Received SIGTERM. Shutting down...' })\n    process.exit(0)\n  })\n\n  process.on('uncaughtException', (error) => {\n    logger.fatal({ err: error, msg: 'Uncaught Exception' })\n    logger.error(`Uncaught Exception! Check ${LOG_FILE_PATH}. Shutting down...`)\n    logger.flush()\n    process.exit(1)\n  })\n\n  process.on('unhandledRejection', (reason, promise) => {\n    logger.fatal({ reason, promise, msg: 'Unhandled Rejection' })\n    logger.error(`Unhandled Rejection! Check ${LOG_FILE_PATH}. Shutting down...`)\n    logger.flush()\n    process.exit(1)\n  })\n}\n", "import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nimport { initializePrompts } from './prompts'\nimport { initializeResources } from './resources'\nimport { initializeTools } from './tools'\n\nexport async function createMcpServer() {\n  const server = new McpServer(\n    {\n      name: 'infra-kit',\n      version: '1.0.0',\n    },\n    {\n      capabilities: {\n        resources: {},\n        tools: {},\n        prompts: {},\n      },\n    },\n  )\n\n  await initializePrompts(server)\n  await initializeResources(server)\n  await initializeTools(server)\n\n  return server\n}\n", "import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nexport const initializePrompts = async (_server: McpServer) => {}\n", "import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nexport const initializeResources = async (_server: McpServer) => {}\n", "import { logger } from 'src/lib/logger'\nimport type { ToolsExecutionResult } from 'src/types'\n\ninterface ToolHandlerArgs {\n  toolName: string\n  handler: (params: any) => Promise<ToolsExecutionResult>\n}\n\nexport const createToolHandler = (args: ToolHandlerArgs) => {\n  return async (params: unknown) => {\n    const { toolName, handler } = args\n\n    logger.info({ msg: `Tool execution started: ${toolName}`, params })\n    try {\n      const payload = await handler({ ...(params as object), confirmedCommand: true })\n\n      logger.info({ msg: `Tool execution successful: ${toolName}` })\n\n      return payload\n    } catch (error) {\n      logger.error({\n        err: error,\n        params,\n        msg: `Tool execution failed: ${toolName}`,\n      })\n\n      throw error\n    }\n  }\n}\n", "import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nimport { getExposedMcpTools } from 'src/lib/command-catalog'\nimport { createToolHandler } from 'src/lib/tool-handler'\n\nexport const initializeTools = async (server: McpServer) => {\n  // The registered tool set is derived from the single command catalog, filtered\n  // by its explicit `mcpExposed` allowlist. doctor / vendor-sync / vendor-manifest\n  // are intentionally excluded there and must never be registered here.\n  for (const tool of getExposedMcpTools()) {\n    server.registerTool(\n      tool.name,\n      {\n        description: tool.description,\n        inputSchema: tool.inputSchema,\n        outputSchema: tool.outputSchema,\n      },\n      createToolHandler({ toolName: tool.name, handler: tool.handler }),\n    )\n  }\n}\n"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["StdioServerTransport", "process", "process", "setupErrorHandlers", "logger", "process", "error", "LOG_FILE_PATH", "reason", "promise", "McpServer", "initializePrompts", "_server", "initializeResources", "_server", "createToolHandler", "args", "params", "toolName", "handler", "logger", "payload", "error", "initializeTools", "server", "tool", "getExposedMcpTools", "createToolHandler", "createMcpServer", "server", "McpServer", "initializePrompts", "initializeResources", "initializeTools", "logger", "initLoggerMcp", "startServer", "server", "createMcpServer", "error", "process", "transport", "StdioServerTransport", "setupErrorHandlers"]
 }

package/dist/vite.js

@@ -0,0 +1,2 @@
+import{b as r,d as t,e}from"./chunk-YGCVOVNX.js";import{a as i}from"./chunk-2PZRQHWF.js";export{t as infraKitDev,e as infraKitProxy,r as resolveProxyConfig,i as slugifyRelease};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "infra-kit",
   "type": "module",
-  "version": "0.1.128",
+  "version": "0.1.130",
+  "files": [
+    "dist"
+  ],
   "description": "infra-kit",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -10,6 +13,10 @@
     ".": {
       "types": "./dist/entry/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/entry/vite.d.ts",
+      "import": "./dist/vite.js"
     }
   },
   "bin": {
@@ -21,7 +28,7 @@
   "scripts": {
     "inspector": "npx @modelcontextprotocol/inspector node ./dist/mcp.js --debug",
     "build": "pnpm run clean-artifacts && node ./scripts/build.js",
-    "infra-kit-check": "infra-kit audit",
+    "infra-kit-check": "pnpm exec infra-kit audit",
     "clean-artifacts": "rm -rf dist",
     "clean-cache": "rm -rf node_modules/.cache .eslintcache tsconfig.tsbuildinfo .turbo .swc",
     "prettier-fix": "pnpm exec prettier **/* --write --no-error-on-unmatched-pattern --log-level silent --ignore-path ../../../.prettierignore",
@@ -49,6 +56,7 @@
     "ink": "^7.1.0",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
+    "portless": "^0.15.1",
     "react": "19.2.7",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
@@ -56,7 +64,7 @@
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.162",
-    "@types/react": "catalog:",
+    "@types/react": "19.2.17",
     "@wl/eslint-config": "workspace:*",
     "@wl/vitest-config": "workspace:*",
     "esbuild": "^0.28.1",