everything-dev 1.53.2 → 2.0.0-rc.0

package/dist/infra/planner.mjs

@@ -1,17 +1,15 @@
+import { buildDescription, isAuthMirrorPluginEntry } from "../service-descriptor.mjs";
 import { PortAllocator } from "../app.mjs";
-import { buildDatabaseConfigs, buildOriginMap, buildRedisConfigs, getSecretGroups, loadPortState, savePortState } from "../cli/infra.mjs";
-import { buildDescription } from "../service-descriptor.mjs";
+import { buildConventionalDatabases, buildConventionalRedis, getSecretGroups, loadPortState, savePortState } from "../cli/infra.mjs";
 import { InfraError } from "./types.mjs";
+import { shouldPersistPortState } from "./materializer.mjs";
+import { ownerOfPort } from "./port-ownership.mjs";
 import { resolve } from "node:path";
+import { Clock, Effect } from "effect";
 import { createHash } from "node:crypto";
-import { Effect } from "effect";
 
 //#region src/infra/planner.ts
 const DEFAULT_HOST_PORT = 3e3;
-const DEFAULT_API_PORT = 3001;
-const DEFAULT_AUTH_PORT = 3002;
-const DEFAULT_UI_PORT = 3003;
-const DEFAULT_PLUGIN_PORT_START = 3010;
 const POSTGRES_USER = "everythingdev";
 const POSTGRES_PASSWORD = "everythingdev";
 function workspaceKey(configDir) {
@@ -23,68 +21,98 @@ function normalizeCliPorts(input) {
 		api: input.apiPort,
 		auth: input.authPort,
 		ui: input.uiPort,
-		uiSsr: void 0,
 		pluginsStart: input.pluginPortStart,
 		plugins: input.plugins
 	};
 }
-function allocateServices(cliPorts, plugins, configDir) {
+const PLUGIN_START_OFFSET = 10;
+const BLOCK_STEP = 100;
+function allocateServices(cliPorts, plugins, configDir, auth, sources) {
 	return Effect.gen(function* () {
 		const wKey = workspaceKey(configDir);
 		const persisted = loadPortState(configDir).devPorts;
 		const allocator = yield* PortAllocator;
-		const hostPort = yield* allocator.pickAvailable(cliPorts.host ?? persisted?.host ?? DEFAULT_HOST_PORT);
-		const apiPort = yield* allocator.pickAvailable(cliPorts.api ?? persisted?.api ?? DEFAULT_API_PORT);
-		const authPort = yield* allocator.pickAvailable(cliPorts.auth ?? persisted?.auth ?? DEFAULT_AUTH_PORT);
-		const uiPort = yield* allocator.pickAvailable(cliPorts.ui ?? persisted?.ui ?? DEFAULT_UI_PORT);
-		const uiSsrPort = yield* allocator.pickAvailable(cliPorts.uiSsr ?? uiPort + 1);
-		const pluginApiPorts = {};
-		const pluginUiPorts = {};
+		const base = cliPorts.host ?? persisted?.host ?? DEFAULT_HOST_PORT;
+		const pluginStartPreferred = cliPorts.pluginsStart ?? persisted?.pluginPortStart ?? base + PLUGIN_START_OFFSET;
+		const pluginStartPinned = cliPorts.pluginsStart !== void 0 || persisted?.pluginPortStart !== void 0;
+		const entries = [];
+		const addEntry = (key, flag, persistedValue, derived) => {
+			if (flag !== void 0) entries.push({
+				key,
+				preferred: flag,
+				pinned: true
+			});
+			else if (persistedValue !== void 0) entries.push({
+				key,
+				preferred: persistedValue,
+				pinned: true
+			});
+			else entries.push({
+				key,
+				preferred: derived,
+				pinned: false
+			});
+		};
+		addEntry("host", cliPorts.host, void 0, base);
+		if (sources?.api !== "remote") addEntry("api", cliPorts.api, persisted?.api, base + 1);
+		if (sources?.auth !== "remote") addEntry("auth", cliPorts.auth, persisted?.auth, base + 2);
+		if (sources?.ui !== "remote") addEntry("ui", cliPorts.ui, persisted?.ui, base + 3);
 		const pluginKeys = Object.keys(plugins).sort();
-		const pluginStart = cliPorts.pluginsStart ?? persisted?.pluginPortStart ?? DEFAULT_PLUGIN_PORT_START;
-		let nextPluginPort = pluginStart;
+		const isAuthMirrorFor = (pluginId, pluginCfg) => pluginCfg !== void 0 && isAuthMirrorPluginEntry(auth, pluginId, pluginCfg);
+		let pluginSlot = 0;
 		for (const pluginId of pluginKeys) {
 			const pluginCfg = plugins[pluginId];
-			const preferred = cliPorts.plugins?.[pluginId]?.api ?? nextPluginPort;
-			const pluginPort = yield* allocator.pickAvailable(preferred);
-			pluginApiPorts[pluginId] = pluginPort;
-			nextPluginPort = pluginPort + 1;
+			const pluginIsLocal = pluginCfg?.source === "local";
+			const slotBase = pluginStartPinned ? pluginStartPreferred : base + PLUGIN_START_OFFSET;
+			if (!isAuthMirrorFor(pluginId, pluginCfg) && pluginIsLocal) {
+				addEntry(`plugin:${pluginId}`, cliPorts.plugins?.[pluginId]?.api, void 0, slotBase + pluginSlot);
+				pluginSlot += 1;
+			}
 			if (pluginCfg?.source === "local" && pluginCfg?.localPath && pluginCfg?.ui?.source === "local") {
-				const uiPreferred = cliPorts.plugins?.[pluginId]?.ui ?? nextPluginPort;
-				const pluginUiPort = yield* allocator.pickAvailable(uiPreferred);
-				pluginUiPorts[pluginId] = pluginUiPort;
-				nextPluginPort = pluginUiPort + 1;
+				addEntry(`plugin-ui:${pluginId}`, cliPorts.plugins?.[pluginId]?.ui, void 0, slotBase + pluginSlot);
+				pluginSlot += 1;
 			}
 		}
+		const allocation = yield* allocator.acquireBlock({
+			base,
+			step: BLOCK_STEP,
+			entries
+		});
+		if (allocation.base !== base) {
+			yield* Effect.logError(`[Dev] Preferred port block starting at ${base} is occupied — using ${allocation.base} (this run only; restarts will retry ${base})`);
+			for (const conflict of allocation.conflicts.slice(0, 6)) if (conflict.claimed) yield* Effect.logError(`[Dev]   port ${conflict.port} (${conflict.key}) — live bos session (registry claim)`);
+			else {
+				const owner = yield* ownerOfPort(conflict.port);
+				yield* Effect.logError(`[Dev]   port ${conflict.port} (${conflict.key}) — ${owner ? `pid ${owner.pid} (${owner.command})` : "foreign holder (lsof unavailable)"}`);
+			}
+		}
+		const pluginApiPorts = {};
+		const pluginUiPorts = {};
+		for (const pluginId of pluginKeys) {
+			const api = allocation.ports[`plugin:${pluginId}`];
+			if (api !== void 0) pluginApiPorts[pluginId] = api;
+			const ui = allocation.ports[`plugin-ui:${pluginId}`];
+			if (ui !== void 0) pluginUiPorts[pluginId] = ui;
+		}
 		const resolved = {
-			host: hostPort,
-			api: apiPort,
-			auth: authPort,
-			ui: uiPort,
-			uiSsr: uiSsrPort,
-			plugins: Object.fromEntries(Object.entries(pluginApiPorts).map(([k, v]) => [k, {
-				api: v,
+			host: allocation.ports.host,
+			api: allocation.ports.api,
+			auth: allocation.ports.auth,
+			ui: allocation.ports.ui,
+			plugins: Object.fromEntries(pluginKeys.map((k) => [k, {
+				api: pluginApiPorts[k],
 				ui: pluginUiPorts[k]
-			}])),
-			postgres: {},
-			redis: {}
+			}]))
 		};
 		const devPortsState = {
-			host: hostPort,
-			api: apiPort,
-			auth: authPort,
-			ui: uiPort,
-			pluginPortStart: pluginStart
-		};
-		const claimPorts = {
-			host: hostPort,
-			api: apiPort,
-			auth: authPort,
-			ui: uiPort,
-			uiSsr: uiSsrPort
+			host: cliPorts.host,
+			api: cliPorts.api,
+			auth: cliPorts.auth,
+			ui: cliPorts.ui,
+			pluginPortStart: cliPorts.pluginsStart
 		};
-		for (const [id, port] of Object.entries(pluginApiPorts)) claimPorts[`plugin:${id}`] = port;
-		for (const [id, port] of Object.entries(pluginUiPorts)) claimPorts[`plugin-ui:${id}`] = port;
+		const claimPorts = {};
+		for (const [key, port] of Object.entries(allocation.ports)) claimPorts[key] = port;
 		return {
 			ports: resolved,
 			claims: [{
@@ -92,7 +120,7 @@ function allocateServices(cliPorts, plugins, configDir) {
 				pid: process.pid,
 				configDir,
 				ports: claimPorts,
-				startedAt: Date.now()
+				startedAt: yield* Clock.currentTimeMillis
 			}],
 			devPortsState
 		};
@@ -102,46 +130,40 @@ function allocateServices(cliPorts, plugins, configDir) {
 		cause: portErr
 	})));
 }
-function allocateDatabases(runtimeConfig, configDir) {
+function allocateDatabases(runtimeConfig) {
 	return Effect.gen(function* () {
-		const persisted = loadPortState(configDir);
 		const allSecrets = getSecretGroups(runtimeConfig).flatMap((group) => group.secrets);
-		const originMap = buildOriginMap(configDir, runtimeConfig);
 		const allocator = yield* PortAllocator;
-		const infraDatabases = yield* Effect.sync(() => buildDatabaseConfigs(allSecrets, originMap, { ...persisted.postgresPorts }));
-		const infraRedis = yield* Effect.sync(() => buildRedisConfigs(allSecrets, originMap, { ...persisted.redisPorts }));
-		const postgres = {};
+		const conventionalDatabases = buildConventionalDatabases(allSecrets);
+		const conventionalRedis = buildConventionalRedis(allSecrets);
 		const dbs = [];
-		for (const db of infraDatabases) {
-			const port = yield* allocator.pickAvailable(db.port);
-			postgres[db.slug] = port;
+		const allocatedByDesired = /* @__PURE__ */ new Map();
+		for (const db of conventionalDatabases) {
+			let port;
+			if (allocatedByDesired.has(db.port)) port = allocatedByDesired.get(db.port);
+			else {
+				port = yield* allocator.pickAvailable(db.port);
+				allocatedByDesired.set(db.port, port);
+			}
 			dbs.push({
 				secret: db.secret,
 				slug: db.slug,
 				port,
 				dbName: db.databaseName,
-				containerName: db.containerName,
-				volumeName: db.volumeName,
-				url: `postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:${port}/${db.slug}_db`
+				url: `postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:${port}/${db.databaseName}`
 			});
 		}
-		const redis = {};
 		const redisPlans = [];
-		for (const r of infraRedis) {
+		for (const r of conventionalRedis) {
 			const port = yield* allocator.pickAvailable(r.port);
-			redis[r.slug] = port;
 			redisPlans.push({
 				secret: r.secret,
 				slug: r.slug,
 				port,
-				containerName: r.containerName,
-				volumeName: r.volumeName,
 				url: `redis://localhost:${port}`
 			});
 		}
 		return {
-			postgres,
-			redis,
 			dbs,
 			redisPlans
 		};
@@ -192,25 +214,19 @@ function buildServiceDescriptors(runtimeConfig, resolvedPorts) {
 			port: isLocal ? resolvedPorts.ui : void 0,
 			localPath: isLocal ? runtimeConfig.ui.localPath : void 0
 		});
-		if (isLocal && resolvedPorts.uiSsr) descriptors.push({
-			key: "ui-ssr",
-			source: "local",
-			url: `http://localhost:${resolvedPorts.uiSsr}`,
-			port: resolvedPorts.uiSsr,
-			localPath: runtimeConfig.ui.localPath
-		});
 	}
 	if (runtimeConfig.plugins) for (const [pluginId, pluginCfg] of Object.entries(runtimeConfig.plugins)) {
 		const pluginIsLocal = pluginCfg.source === "local";
 		const p = resolvedPorts.plugins[pluginId];
-		if (pluginIsLocal && p?.api) descriptors.push({
+		const isAuthMirror = isAuthMirrorPluginEntry(runtimeConfig.auth, pluginId, pluginCfg);
+		if (pluginIsLocal && p?.api && !isAuthMirror) descriptors.push({
 			key: `plugin:${pluginId}`,
 			source: "local",
 			url: `http://localhost:${p.api}`,
 			port: p.api,
 			localPath: pluginCfg.localPath
 		});
-		if (!pluginIsLocal && pluginCfg.url) descriptors.push({
+		if (!pluginIsLocal && pluginCfg.url && !isAuthMirror) descriptors.push({
 			key: `plugin:${pluginId}`,
 			source: "remote",
 			url: pluginCfg.url,
@@ -243,15 +259,12 @@ function buildLaunchSpec(runtimeConfig, resolvedPorts) {
 		runtimeConfig
 	};
 }
-function buildComposeModel(dbs, redisPlans) {
-	return {
-		databases: dbs,
-		redis: redisPlans
-	};
-}
 function buildEnvGenerated(resolvedPorts, dbs, redisPlans) {
 	const env = {};
-	if (resolvedPorts.host) env.CORS_ORIGIN = `http://localhost:${resolvedPorts.host}`;
+	if (resolvedPorts.host) {
+		env.CORS_ORIGIN = `http://localhost:${resolvedPorts.host}`;
+		env.BASE_URL = `http://localhost:${resolvedPorts.host}`;
+	}
 	for (const db of dbs) env[db.secret] = db.url;
 	for (const r of redisPlans) env[r.secret] = r.url;
 	return env;
@@ -260,18 +273,23 @@ function planInfra(input) {
 	return Effect.gen(function* () {
 		const cliPorts = normalizeCliPorts(input.cli);
 		const wKey = workspaceKey(input.configDir);
-		const { ports: svcPorts, claims, devPortsState } = yield* allocateServices(cliPorts, input.bosConfig.plugins ?? {}, input.configDir);
-		const { dbs, redisPlans, postgres: pgPorts, redis: rdPorts } = yield* allocateDatabases(input.bosConfig, input.configDir);
-		const resolvedPorts = {
-			...svcPorts,
-			postgres: pgPorts,
-			redis: rdPorts
-		};
-		if (process.env.BOS_NO_PERSIST_PORTS !== "1") savePortState(input.configDir, {
-			postgresPorts: pgPorts,
-			redisPorts: rdPorts,
-			devPorts: devPortsState
+		const { ports: svcPorts, claims, devPortsState } = yield* allocateServices(cliPorts, input.bosConfig.plugins ?? {}, input.configDir, input.bosConfig.auth, {
+			host: input.bosConfig.host?.source,
+			api: input.bosConfig.api?.source,
+			auth: input.bosConfig.auth?.source,
+			ui: input.bosConfig.ui?.source
 		});
+		const { dbs, redisPlans } = yield* allocateDatabases(input.bosConfig);
+		const resolvedPorts = { ...svcPorts };
+		const previousDevPorts = loadPortState(input.configDir).devPorts ?? {};
+		const devPorts = {
+			host: devPortsState.host ?? previousDevPorts.host,
+			api: devPortsState.api ?? previousDevPorts.api,
+			auth: devPortsState.auth ?? previousDevPorts.auth,
+			ui: devPortsState.ui ?? previousDevPorts.ui,
+			pluginPortStart: devPortsState.pluginPortStart ?? previousDevPorts.pluginPortStart
+		};
+		if (shouldPersistPortState()) savePortState(input.configDir, { devPorts });
 		const hostIsLocal = input.bosConfig.host?.source === "local";
 		const apiIsLocal = input.bosConfig.api?.source === "local";
 		const uiIsLocal = input.bosConfig.ui?.source === "local";
@@ -292,7 +310,8 @@ function planInfra(input) {
 			ui: uiIsLocal && resolvedPorts.ui ? {
 				...input.bosConfig.ui,
 				port: resolvedPorts.ui,
-				url: `http://localhost:${resolvedPorts.ui}`
+				url: `http://localhost:${resolvedPorts.ui}`,
+				ssrUrl: void 0
 			} : input.bosConfig.ui,
 			auth: authIsLocal && resolvedPorts.auth && input.bosConfig.auth ? {
 				...input.bosConfig.auth,
@@ -300,21 +319,36 @@ function planInfra(input) {
 				url: `http://localhost:${resolvedPorts.auth}`
 			} : input.bosConfig.auth,
 			plugins: input.bosConfig.plugins ? Object.fromEntries(Object.entries(input.bosConfig.plugins).map(([id, p]) => {
+				const isAuthMirror = isAuthMirrorPluginEntry(input.bosConfig.auth, id, p);
 				const pluginPort = resolvedPorts.plugins[id];
+				const patchedUi = (() => {
+					if (p.ui?.source !== "local" || !p.ui?.localPath || !pluginPort?.ui) return p.ui;
+					return {
+						...p.ui,
+						port: pluginPort.ui,
+						url: `http://localhost:${pluginPort.ui}`,
+						ssrUrl: void 0
+					};
+				})();
+				if (isAuthMirror) return [id, {
+					...p,
+					ui: patchedUi
+				}];
 				if (p.source === "local" && pluginPort?.api) return [id, {
 					...p,
 					port: pluginPort.api,
-					url: `http://localhost:${pluginPort.api}`
+					url: `http://localhost:${pluginPort.api}`,
+					ui: patchedUi
 				}];
 				return [id, p];
 			})) : void 0
 		};
-		const serviceDescriptors = buildServiceDescriptors(input.bosConfig, resolvedPorts);
+		const serviceDescriptors = buildServiceDescriptors(assignedRuntimeConfig, resolvedPorts);
 		const launch = buildLaunchSpec(input.bosConfig, resolvedPorts);
-		const composeModel = buildComposeModel(dbs, redisPlans);
 		const envGenerated = buildEnvGenerated(resolvedPorts, dbs, redisPlans);
 		const packages = serviceDescriptors.map((d) => d.key);
-		const description = buildDescription(new Map(serviceDescriptors.map((d) => [d.key, d])));
+		const descriptionMap = new Map(serviceDescriptors.map((d) => [d.key, d]));
+		const description = buildDescription(descriptionMap);
 		const orchestrator = {
 			packages,
 			env: {},
@@ -331,7 +365,6 @@ function planInfra(input) {
 			description,
 			serviceDescriptors: new Map(serviceDescriptors.map((d) => [d.key, d])),
 			envGenerated,
-			composeModel,
 			claims,
 			orchestrator
 		};
@@ -339,5 +372,5 @@ function planInfra(input) {
 }
 
 //#endregion
-export { buildComposeModel, buildEnvGenerated, buildLaunchSpec, buildServiceDescriptors, planInfra, workspaceKey };
+export { buildEnvGenerated, buildLaunchSpec, buildServiceDescriptors, planInfra, workspaceKey };
 //# sourceMappingURL=planner.mjs.map

package/dist/infra/planner.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"planner.mjs","names":[],"sources":["../../src/infra/planner.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { resolve } from \"node:path\";\nimport { Effect } from \"effect\";\nimport { PortAllocator } from \"../app\";\nimport {\n  buildDatabaseConfigs,\n  buildOriginMap,\n  buildRedisConfigs,\n  type DatabaseSecretConfig,\n  getSecretGroups,\n  loadPortState,\n  type RedisSecretConfig,\n  savePortState,\n} from \"../cli/infra\";\nimport { buildDescription } from \"../service-descriptor\";\nimport type { RuntimeConfig } from \"../types\";\nimport type {\n  ClaimRecord,\n  CliPorts,\n  ComposeModelPlan,\n  DatabasePlan,\n  InfraInput,\n  InfraPlan,\n  RedisPlan,\n  ResolvedPorts,\n  RuntimeLaunchSpec,\n  ServiceDescriptorPlan,\n} from \"./types\";\nimport { InfraError } from \"./types\";\n\nconst DEFAULT_HOST_PORT = 3000;\nconst DEFAULT_API_PORT = 3001;\nconst DEFAULT_AUTH_PORT = 3002;\nconst DEFAULT_UI_PORT = 3003;\nconst DEFAULT_PLUGIN_PORT_START = 3010;\nconst POSTGRES_USER = \"everythingdev\";\nconst POSTGRES_PASSWORD = \"everythingdev\";\n\nexport function workspaceKey(configDir: string): string {\n  const hash = createHash(\"sha256\").update(resolve(configDir)).digest(\"hex\");\n  return hash.slice(0, 12);\n}\n\nfunction normalizeCliPorts(input: InfraInput[\"cli\"]): CliPorts {\n  return {\n    host: input.port,\n    api: input.apiPort,\n    auth: input.authPort,\n    ui: input.uiPort,\n    uiSsr: undefined,\n    pluginsStart: input.pluginPortStart,\n    plugins: input.plugins,\n  };\n}\n\ninterface AllocateServicesResult {\n  ports: ResolvedPorts;\n  claims: ClaimRecord[];\n  devPortsState: { host: number; api: number; auth: number; ui: number; pluginPortStart: number };\n}\n\nfunction allocateServices(\n  cliPorts: CliPorts,\n  plugins: Record<\n    string,\n    { source: string; localPath?: string; ui?: { source: string; localPath?: string } }\n  >,\n  configDir: string,\n): Effect.Effect<AllocateServicesResult, InfraError, PortAllocator> {\n  return Effect.gen(function* () {\n    const wKey = workspaceKey(configDir);\n    const persisted = loadPortState(configDir).devPorts;\n    const allocator = yield* PortAllocator;\n\n    const hostPort = yield* allocator.pickAvailable(\n      cliPorts.host ?? persisted?.host ?? DEFAULT_HOST_PORT,\n    );\n\n    const apiPort = yield* allocator.pickAvailable(\n      cliPorts.api ?? persisted?.api ?? DEFAULT_API_PORT,\n    );\n\n    const authPort = yield* allocator.pickAvailable(\n      cliPorts.auth ?? persisted?.auth ?? DEFAULT_AUTH_PORT,\n    );\n\n    const uiPort = yield* allocator.pickAvailable(cliPorts.ui ?? persisted?.ui ?? DEFAULT_UI_PORT);\n\n    const uiSsrPort = yield* allocator.pickAvailable(cliPorts.uiSsr ?? uiPort + 1);\n\n    const pluginApiPorts: Record<string, number> = {};\n    const pluginUiPorts: Record<string, number> = {};\n\n    const pluginKeys = Object.keys(plugins).sort();\n    const pluginStart =\n      cliPorts.pluginsStart ?? persisted?.pluginPortStart ?? DEFAULT_PLUGIN_PORT_START;\n    let nextPluginPort = pluginStart;\n    for (const pluginId of pluginKeys) {\n      const pluginCfg = plugins[pluginId];\n      const preferred = cliPorts.plugins?.[pluginId]?.api ?? nextPluginPort;\n      const pluginPort = yield* allocator.pickAvailable(preferred);\n      pluginApiPorts[pluginId] = pluginPort;\n      nextPluginPort = pluginPort + 1;\n\n      if (\n        pluginCfg?.source === \"local\" &&\n        pluginCfg?.localPath &&\n        pluginCfg?.ui?.source === \"local\"\n      ) {\n        const uiPreferred = cliPorts.plugins?.[pluginId]?.ui ?? nextPluginPort;\n        const pluginUiPort = yield* allocator.pickAvailable(uiPreferred);\n        pluginUiPorts[pluginId] = pluginUiPort;\n        nextPluginPort = pluginUiPort + 1;\n      }\n    }\n\n    const resolved: ResolvedPorts = {\n      host: hostPort,\n      api: apiPort,\n      auth: authPort,\n      ui: uiPort,\n      uiSsr: uiSsrPort,\n      plugins: Object.fromEntries(\n        Object.entries(pluginApiPorts).map(([k, v]) => [k, { api: v, ui: pluginUiPorts[k] }]),\n      ),\n      postgres: {},\n      redis: {},\n    };\n\n    const devPortsState = {\n      host: hostPort,\n      api: apiPort,\n      auth: authPort,\n      ui: uiPort,\n      pluginPortStart: pluginStart,\n    };\n\n    const claimPorts: Record<string, number> = {\n      host: hostPort,\n      api: apiPort,\n      auth: authPort,\n      ui: uiPort,\n      uiSsr: uiSsrPort,\n    };\n    for (const [id, port] of Object.entries(pluginApiPorts)) {\n      claimPorts[`plugin:${id}`] = port;\n    }\n    for (const [id, port] of Object.entries(pluginUiPorts)) {\n      claimPorts[`plugin-ui:${id}`] = port;\n    }\n\n    const claim: ClaimRecord = {\n      resourceKey: `workspace:${wKey}`,\n      pid: process.pid,\n      configDir,\n      ports: claimPorts,\n      startedAt: Date.now(),\n    };\n\n    return { ports: resolved, claims: [claim], devPortsState };\n  }).pipe(\n    Effect.mapError(\n      (portErr) =>\n        new InfraError({\n          phase: \"allocate-services\",\n          message: `Port allocation failed: ${String(portErr)}`,\n          cause: portErr,\n        }),\n    ),\n  );\n}\n\nfunction allocateDatabases(\n  runtimeConfig: RuntimeConfig,\n  configDir: string,\n): Effect.Effect<\n  {\n    postgres: Record<string, number>;\n    redis: Record<string, number>;\n    dbs: DatabasePlan[];\n    redisPlans: RedisPlan[];\n  },\n  InfraError,\n  PortAllocator\n> {\n  return Effect.gen(function* () {\n    const persisted = loadPortState(configDir);\n    const groups = getSecretGroups(runtimeConfig);\n    const allSecrets = groups.flatMap((group) => group.secrets);\n    const originMap = buildOriginMap(configDir, runtimeConfig);\n    const allocator = yield* PortAllocator;\n\n    const infraDatabases: DatabaseSecretConfig[] = yield* Effect.sync(() =>\n      buildDatabaseConfigs(allSecrets, originMap, { ...persisted.postgresPorts }),\n    );\n    const infraRedis: RedisSecretConfig[] = yield* Effect.sync(() =>\n      buildRedisConfigs(allSecrets, originMap, { ...persisted.redisPorts }),\n    );\n\n    const postgres: Record<string, number> = {};\n    const dbs: DatabasePlan[] = [];\n    for (const db of infraDatabases) {\n      const port = yield* allocator.pickAvailable(db.port);\n      postgres[db.slug] = port;\n      dbs.push({\n        secret: db.secret,\n        slug: db.slug,\n        port,\n        dbName: db.databaseName,\n        containerName: db.containerName,\n        volumeName: db.volumeName,\n        url: `postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:${port}/${db.slug}_db`,\n      });\n    }\n\n    const redis: Record<string, number> = {};\n    const redisPlans: RedisPlan[] = [];\n    for (const r of infraRedis) {\n      const port = yield* allocator.pickAvailable(r.port);\n      redis[r.slug] = port;\n      redisPlans.push({\n        secret: r.secret,\n        slug: r.slug,\n        port,\n        containerName: r.containerName,\n        volumeName: r.volumeName,\n        url: `redis://localhost:${port}`,\n      });\n    }\n\n    return { postgres, redis, dbs, redisPlans };\n  }).pipe(\n    Effect.mapError(\n      (portErr) =>\n        new InfraError({\n          phase: \"allocate-databases\",\n          message: `Database port allocation failed: ${String(portErr)}`,\n          cause: portErr,\n        }),\n    ),\n  );\n}\n\nexport function buildServiceDescriptors(\n  runtimeConfig: RuntimeConfig,\n  resolvedPorts: ResolvedPorts,\n): ServiceDescriptorPlan[] {\n  const descriptors: ServiceDescriptorPlan[] = [];\n\n  if (runtimeConfig.host) {\n    const isLocal = runtimeConfig.host.source === \"local\";\n    descriptors.push({\n      key: \"host\",\n      source: runtimeConfig.host.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.host}` : runtimeConfig.host.url,\n      port: isLocal ? resolvedPorts.host : undefined,\n      localPath: isLocal ? runtimeConfig.host.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.api) {\n    const isLocal = runtimeConfig.api.source === \"local\";\n    descriptors.push({\n      key: \"api\",\n      source: runtimeConfig.api.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.api}` : runtimeConfig.api.url,\n      port: isLocal ? resolvedPorts.api : undefined,\n      localPath: isLocal ? runtimeConfig.api.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.auth) {\n    const isLocal = runtimeConfig.auth.source === \"local\";\n    descriptors.push({\n      key: \"auth\",\n      source: runtimeConfig.auth.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.auth}` : runtimeConfig.auth.url,\n      port: isLocal ? resolvedPorts.auth : undefined,\n      localPath: isLocal ? runtimeConfig.auth.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.ui) {\n    const isLocal = runtimeConfig.ui.source === \"local\";\n    descriptors.push({\n      key: \"ui\",\n      source: runtimeConfig.ui.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.ui}` : runtimeConfig.ui.url,\n      port: isLocal ? resolvedPorts.ui : undefined,\n      localPath: isLocal ? runtimeConfig.ui.localPath : undefined,\n    });\n    if (isLocal && resolvedPorts.uiSsr) {\n      descriptors.push({\n        key: \"ui-ssr\",\n        source: \"local\",\n        url: `http://localhost:${resolvedPorts.uiSsr}`,\n        port: resolvedPorts.uiSsr,\n        localPath: runtimeConfig.ui.localPath,\n      });\n    }\n  }\n\n  if (runtimeConfig.plugins) {\n    for (const [pluginId, pluginCfg] of Object.entries(runtimeConfig.plugins)) {\n      const pluginIsLocal = pluginCfg.source === \"local\";\n      const p = resolvedPorts.plugins[pluginId];\n      if (pluginIsLocal && p?.api) {\n        descriptors.push({\n          key: `plugin:${pluginId}`,\n          source: \"local\",\n          url: `http://localhost:${p.api}`,\n          port: p.api,\n          localPath: pluginCfg.localPath,\n        });\n      }\n      if (!pluginIsLocal && pluginCfg.url) {\n        descriptors.push({\n          key: `plugin:${pluginId}`,\n          source: \"remote\",\n          url: pluginCfg.url,\n          port: undefined,\n          localPath: undefined,\n        });\n      }\n      if (pluginIsLocal && p?.ui && pluginCfg.ui?.source === \"local\") {\n        descriptors.push({\n          key: `plugin-ui:${pluginId}`,\n          source: \"local\",\n          url: `http://localhost:${p.ui}`,\n          port: p.ui,\n          localPath: pluginCfg.ui?.localPath,\n        });\n      }\n    }\n  }\n\n  return descriptors;\n}\n\nexport function buildLaunchSpec(\n  runtimeConfig: RuntimeConfig,\n  resolvedPorts: ResolvedPorts,\n): RuntimeLaunchSpec {\n  const hostPort =\n    runtimeConfig.host?.source === \"local\" ? resolvedPorts.host : runtimeConfig.host?.port;\n  const corsOrigin = hostPort ? `http://localhost:${hostPort}` : `http://localhost:3000`;\n\n  return {\n    port: resolvedPorts.host,\n    hostUrl: runtimeConfig.host?.url,\n    corsOrigin,\n    env: {\n      ...(resolvedPorts.host ? { PORT: String(resolvedPorts.host) } : {}),\n      ...(resolvedPorts.api ? { API_PORT: String(resolvedPorts.api) } : {}),\n      ...(resolvedPorts.ui ? { UI_PORT: String(resolvedPorts.ui) } : {}),\n      ...(resolvedPorts.auth ? { AUTH_PORT: String(resolvedPorts.auth) } : {}),\n    },\n    runtimeConfig,\n  };\n}\n\nexport function buildComposeModel(dbs: DatabasePlan[], redisPlans: RedisPlan[]): ComposeModelPlan {\n  return { databases: dbs, redis: redisPlans };\n}\n\nexport function buildEnvGenerated(\n  resolvedPorts: ResolvedPorts,\n  dbs: DatabasePlan[],\n  redisPlans: RedisPlan[],\n): Record<string, string> {\n  const env: Record<string, string> = {};\n\n  if (resolvedPorts.host) {\n    env.CORS_ORIGIN = `http://localhost:${resolvedPorts.host}`;\n  }\n\n  for (const db of dbs) {\n    env[db.secret] = db.url;\n  }\n  for (const r of redisPlans) {\n    env[r.secret] = r.url;\n  }\n\n  return env;\n}\n\nexport function planInfra(input: InfraInput): Effect.Effect<InfraPlan, InfraError, PortAllocator> {\n  return Effect.gen(function* () {\n    const cliPorts = normalizeCliPorts(input.cli);\n    const wKey = workspaceKey(input.configDir);\n\n    const plugins = (input.bosConfig.plugins ?? {}) as Record<\n      string,\n      { source: string; localPath?: string; ui?: { source: string; localPath?: string } }\n    >;\n\n    const {\n      ports: svcPorts,\n      claims,\n      devPortsState,\n    } = yield* allocateServices(cliPorts, plugins, input.configDir);\n\n    const {\n      dbs,\n      redisPlans,\n      postgres: pgPorts,\n      redis: rdPorts,\n    } = yield* allocateDatabases(input.bosConfig, input.configDir);\n\n    const resolvedPorts: ResolvedPorts = {\n      ...svcPorts,\n      postgres: pgPorts,\n      redis: rdPorts,\n    };\n\n    // Write merged state once after all allocations succeed\n    // Skip persistence for regression tests / ephemeral runs\n    if (process.env.BOS_NO_PERSIST_PORTS !== \"1\") {\n      savePortState(input.configDir, {\n        postgresPorts: pgPorts,\n        redisPorts: rdPorts,\n        devPorts: devPortsState,\n      });\n    }\n\n    const hostIsLocal = input.bosConfig.host?.source === \"local\";\n    const apiIsLocal = input.bosConfig.api?.source === \"local\";\n    const uiIsLocal = input.bosConfig.ui?.source === \"local\";\n    const authIsLocal = input.bosConfig.auth?.source === \"local\";\n    const assignedRuntimeConfig: RuntimeConfig = {\n      ...input.bosConfig,\n      host: resolvedPorts.host\n        ? {\n            ...input.bosConfig.host,\n            port: resolvedPorts.host,\n            url: `http://localhost:${resolvedPorts.host}`,\n            remoteUrl: !hostIsLocal\n              ? (input.bosConfig.host.remoteUrl ?? input.bosConfig.host.url)\n              : undefined,\n          }\n        : input.bosConfig.host,\n      api:\n        apiIsLocal && resolvedPorts.api\n          ? {\n              ...input.bosConfig.api,\n              port: resolvedPorts.api,\n              url: `http://localhost:${resolvedPorts.api}`,\n            }\n          : input.bosConfig.api,\n      ui:\n        uiIsLocal && resolvedPorts.ui\n          ? {\n              ...input.bosConfig.ui,\n              port: resolvedPorts.ui,\n              url: `http://localhost:${resolvedPorts.ui}`,\n            }\n          : input.bosConfig.ui,\n      auth:\n        authIsLocal && resolvedPorts.auth && input.bosConfig.auth\n          ? {\n              ...input.bosConfig.auth,\n              port: resolvedPorts.auth,\n              url: `http://localhost:${resolvedPorts.auth}`,\n            }\n          : input.bosConfig.auth,\n      plugins: input.bosConfig.plugins\n        ? Object.fromEntries(\n            Object.entries(input.bosConfig.plugins).map(([id, p]) => {\n              const pluginPort = resolvedPorts.plugins[id];\n              if (p.source === \"local\" && pluginPort?.api) {\n                return [\n                  id,\n                  { ...p, port: pluginPort.api, url: `http://localhost:${pluginPort.api}` },\n                ];\n              }\n              return [id, p];\n            }),\n          )\n        : undefined,\n    };\n\n    const serviceDescriptors = buildServiceDescriptors(input.bosConfig, resolvedPorts);\n\n    const launch = buildLaunchSpec(input.bosConfig, resolvedPorts);\n    const composeModel = buildComposeModel(dbs, redisPlans);\n    const envGenerated = buildEnvGenerated(resolvedPorts, dbs, redisPlans);\n\n    const packages = serviceDescriptors.map((d) => d.key);\n    const descriptionMap = new Map(serviceDescriptors.map((d) => [d.key, d]));\n    const description = buildDescription(descriptionMap);\n\n    const orchestrator = {\n      packages,\n      env: {},\n      description,\n      port: resolvedPorts.host,\n      interactive: input.cli.interactive,\n    };\n\n    return {\n      workspaceKey: wKey,\n      cliPorts,\n      resolvedPorts,\n      runtimeConfig: assignedRuntimeConfig,\n      launch,\n      description,\n      serviceDescriptors: new Map(serviceDescriptors.map((d) => [d.key, d])),\n      envGenerated,\n      composeModel,\n      claims,\n      orchestrator,\n    };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"planner.mjs","names":[],"sources":["../../src/infra/planner.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { resolve } from \"node:path\";\nimport { Clock, Effect } from \"effect\";\nimport { PortAllocator, type PortBlockEntry } from \"../app\";\nimport {\n  buildConventionalDatabases,\n  buildConventionalRedis,\n  getSecretGroups,\n  loadPortState,\n  savePortState,\n} from \"../cli/infra\";\nimport {\n  type AuthSlotShape,\n  buildDescription,\n  isAuthMirrorPluginEntry,\n} from \"../service-descriptor\";\nimport type { RuntimeConfig } from \"../types\";\nimport { shouldPersistPortState } from \"./materializer\";\nimport { ownerOfPort } from \"./port-ownership\";\nimport type {\n  ClaimRecord,\n  CliPorts,\n  DatabasePlan,\n  InfraInput,\n  InfraPlan,\n  RedisPlan,\n  ResolvedPorts,\n  RuntimeLaunchSpec,\n  ServiceDescriptorPlan,\n} from \"./types\";\nimport { InfraError } from \"./types\";\n\nconst DEFAULT_HOST_PORT = 3000;\n\nconst POSTGRES_USER = \"everythingdev\";\nconst POSTGRES_PASSWORD = \"everythingdev\";\n\nexport function workspaceKey(configDir: string): string {\n  const hash = createHash(\"sha256\").update(resolve(configDir)).digest(\"hex\");\n  return hash.slice(0, 12);\n}\n\nfunction normalizeCliPorts(input: InfraInput[\"cli\"]): CliPorts {\n  return {\n    host: input.port,\n    api: input.apiPort,\n    auth: input.authPort,\n    ui: input.uiPort,\n    pluginsStart: input.pluginPortStart,\n    plugins: input.plugins,\n  };\n}\n\ninterface AllocateServicesResult {\n  ports: ResolvedPorts;\n  claims: ClaimRecord[];\n  devPortsState: {\n    host?: number;\n    api?: number;\n    auth?: number;\n    ui?: number;\n    pluginPortStart?: number;\n  };\n}\n\nexport interface ServiceSources {\n  host?: \"local\" | \"remote\";\n  api?: \"local\" | \"remote\";\n  auth?: \"local\" | \"remote\";\n  ui?: \"local\" | \"remote\";\n}\n\nconst PLUGIN_START_OFFSET = 10;\nconst BLOCK_STEP = 100;\n\nfunction allocateServices(\n  cliPorts: CliPorts,\n  plugins: Record<\n    string,\n    { source: string; localPath?: string; ui?: { source: string; localPath?: string } }\n  >,\n  configDir: string,\n  auth?: AuthSlotShape,\n  sources?: ServiceSources,\n): Effect.Effect<AllocateServicesResult, InfraError, PortAllocator> {\n  return Effect.gen(function* () {\n    const wKey = workspaceKey(configDir);\n    const persisted = loadPortState(configDir).devPorts;\n    const allocator = yield* PortAllocator;\n\n    const base = cliPorts.host ?? persisted?.host ?? DEFAULT_HOST_PORT;\n    const pluginStartPreferred =\n      cliPorts.pluginsStart ?? persisted?.pluginPortStart ?? base + PLUGIN_START_OFFSET;\n    const pluginStartPinned =\n      cliPorts.pluginsStart !== undefined || persisted?.pluginPortStart !== undefined;\n\n    const entries: PortBlockEntry[] = [];\n    const addEntry = (\n      key: string,\n      flag: number | undefined,\n      persistedValue: number | undefined,\n      derived: number,\n    ) => {\n      if (flag !== undefined) {\n        entries.push({ key, preferred: flag, pinned: true });\n      } else if (persistedValue !== undefined) {\n        entries.push({ key, preferred: persistedValue, pinned: true });\n      } else {\n        entries.push({ key, preferred: derived, pinned: false });\n      }\n    };\n\n    // Remote-source services spawn nothing locally (ADR 0009 start stack:\n    // remotes load over MF from their published origins) — no port is\n    // allocated for them. The host is the exception: even when loaded as a\n    // remote module, runServer binds its own port.\n    addEntry(\"host\", cliPorts.host, undefined, base);\n    if (sources?.api !== \"remote\") {\n      addEntry(\"api\", cliPorts.api, persisted?.api, base + 1);\n    }\n    if (sources?.auth !== \"remote\") {\n      addEntry(\"auth\", cliPorts.auth, persisted?.auth, base + 2);\n    }\n    if (sources?.ui !== \"remote\") {\n      addEntry(\"ui\", cliPorts.ui, persisted?.ui, base + 3);\n    }\n\n    const pluginKeys = Object.keys(plugins).sort();\n    const isAuthMirrorFor = (\n      pluginId: string,\n      pluginCfg: { source: string; localPath?: string } | undefined,\n    ) => pluginCfg !== undefined && isAuthMirrorPluginEntry(auth, pluginId, pluginCfg);\n\n    let pluginSlot = 0;\n    for (const pluginId of pluginKeys) {\n      const pluginCfg = plugins[pluginId];\n      const pluginIsLocal = pluginCfg?.source === \"local\";\n      const slotBase = pluginStartPinned ? pluginStartPreferred : base + PLUGIN_START_OFFSET;\n      // The auth mirror's backend is owned by the `auth` app slot — no api\n      // port. Its ui surface is still real: without a port the runtime config\n      // advertises an empty ui.url and the browser can never load the remote\n      // (the /login page never renders).\n      if (!isAuthMirrorFor(pluginId, pluginCfg) && pluginIsLocal) {\n        addEntry(\n          `plugin:${pluginId}`,\n          cliPorts.plugins?.[pluginId]?.api,\n          undefined,\n          slotBase + pluginSlot,\n        );\n        pluginSlot += 1;\n      }\n      if (\n        pluginCfg?.source === \"local\" &&\n        pluginCfg?.localPath &&\n        pluginCfg?.ui?.source === \"local\"\n      ) {\n        addEntry(\n          `plugin-ui:${pluginId}`,\n          cliPorts.plugins?.[pluginId]?.ui,\n          undefined,\n          slotBase + pluginSlot,\n        );\n        pluginSlot += 1;\n      }\n    }\n\n    const allocation = yield* allocator.acquireBlock({ base, step: BLOCK_STEP, entries });\n\n    if (allocation.base !== base) {\n      yield* Effect.logError(\n        `[Dev] Preferred port block starting at ${base} is occupied — using ${allocation.base} (this run only; restarts will retry ${base})`,\n      );\n      for (const conflict of allocation.conflicts.slice(0, 6)) {\n        if (conflict.claimed) {\n          yield* Effect.logError(\n            `[Dev]   port ${conflict.port} (${conflict.key}) — live bos session (registry claim)`,\n          );\n        } else {\n          const owner = yield* ownerOfPort(conflict.port);\n          yield* Effect.logError(\n            `[Dev]   port ${conflict.port} (${conflict.key}) — ${\n              owner ? `pid ${owner.pid} (${owner.command})` : \"foreign holder (lsof unavailable)\"\n            }`,\n          );\n        }\n      }\n    }\n\n    const pluginApiPorts: Record<string, number> = {};\n    const pluginUiPorts: Record<string, number> = {};\n    for (const pluginId of pluginKeys) {\n      const api = allocation.ports[`plugin:${pluginId}`];\n      if (api !== undefined) pluginApiPorts[pluginId] = api;\n      const ui = allocation.ports[`plugin-ui:${pluginId}`];\n      if (ui !== undefined) pluginUiPorts[pluginId] = ui;\n    }\n\n    const resolved: ResolvedPorts = {\n      host: allocation.ports.host,\n      api: allocation.ports.api,\n      auth: allocation.ports.auth,\n      ui: allocation.ports.ui,\n      plugins: Object.fromEntries(\n        pluginKeys.map((k) => [k, { api: pluginApiPorts[k], ui: pluginUiPorts[k] }]),\n      ),\n    };\n\n    const devPortsState = {\n      host: cliPorts.host,\n      api: cliPorts.api,\n      auth: cliPorts.auth,\n      ui: cliPorts.ui,\n      pluginPortStart: cliPorts.pluginsStart,\n    };\n\n    const claimPorts: Record<string, number> = {};\n    for (const [key, port] of Object.entries(allocation.ports)) {\n      claimPorts[key] = port;\n    }\n\n    const claim: ClaimRecord = {\n      resourceKey: `workspace:${wKey}`,\n      pid: process.pid,\n      configDir,\n      ports: claimPorts,\n      startedAt: yield* Clock.currentTimeMillis,\n    };\n\n    return { ports: resolved, claims: [claim], devPortsState };\n  }).pipe(\n    Effect.mapError(\n      (portErr) =>\n        new InfraError({\n          phase: \"allocate-services\",\n          message: `Port allocation failed: ${String(portErr)}`,\n          cause: portErr,\n        }),\n    ),\n  );\n}\n\nfunction allocateDatabases(runtimeConfig: RuntimeConfig): Effect.Effect<\n  {\n    dbs: DatabasePlan[];\n    redisPlans: RedisPlan[];\n  },\n  InfraError,\n  PortAllocator\n> {\n  return Effect.gen(function* () {\n    const groups = getSecretGroups(runtimeConfig);\n    const allSecrets = groups.flatMap((group) => group.secrets);\n    const allocator = yield* PortAllocator;\n\n    const conventionalDatabases = buildConventionalDatabases(allSecrets);\n    const conventionalRedis = buildConventionalRedis(allSecrets);\n\n    const dbs: DatabasePlan[] = [];\n    const allocatedByDesired = new Map<number, number>();\n    for (const db of conventionalDatabases) {\n      let port: number;\n      if (allocatedByDesired.has(db.port)) {\n        port = allocatedByDesired.get(db.port)!;\n      } else {\n        port = yield* allocator.pickAvailable(db.port);\n        allocatedByDesired.set(db.port, port);\n      }\n      dbs.push({\n        secret: db.secret,\n        slug: db.slug,\n        port,\n        dbName: db.databaseName,\n        url: `postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@localhost:${port}/${db.databaseName}`,\n      });\n    }\n\n    const redisPlans: RedisPlan[] = [];\n    for (const r of conventionalRedis) {\n      const port = yield* allocator.pickAvailable(r.port);\n      redisPlans.push({\n        secret: r.secret,\n        slug: r.slug,\n        port,\n        url: `redis://localhost:${port}`,\n      });\n    }\n\n    return { dbs, redisPlans };\n  }).pipe(\n    Effect.mapError(\n      (portErr) =>\n        new InfraError({\n          phase: \"allocate-databases\",\n          message: `Database port allocation failed: ${String(portErr)}`,\n          cause: portErr,\n        }),\n    ),\n  );\n}\n\nexport function buildServiceDescriptors(\n  runtimeConfig: RuntimeConfig,\n  resolvedPorts: ResolvedPorts,\n): ServiceDescriptorPlan[] {\n  const descriptors: ServiceDescriptorPlan[] = [];\n\n  if (runtimeConfig.host) {\n    const isLocal = runtimeConfig.host.source === \"local\";\n    descriptors.push({\n      key: \"host\",\n      source: runtimeConfig.host.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.host}` : runtimeConfig.host.url,\n      port: isLocal ? resolvedPorts.host : undefined,\n      localPath: isLocal ? runtimeConfig.host.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.api) {\n    const isLocal = runtimeConfig.api.source === \"local\";\n    descriptors.push({\n      key: \"api\",\n      source: runtimeConfig.api.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.api}` : runtimeConfig.api.url,\n      port: isLocal ? resolvedPorts.api : undefined,\n      localPath: isLocal ? runtimeConfig.api.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.auth) {\n    const isLocal = runtimeConfig.auth.source === \"local\";\n    descriptors.push({\n      key: \"auth\",\n      source: runtimeConfig.auth.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.auth}` : runtimeConfig.auth.url,\n      port: isLocal ? resolvedPorts.auth : undefined,\n      localPath: isLocal ? runtimeConfig.auth.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.ui) {\n    const isLocal = runtimeConfig.ui.source === \"local\";\n    descriptors.push({\n      key: \"ui\",\n      source: runtimeConfig.ui.source,\n      url: isLocal ? `http://localhost:${resolvedPorts.ui}` : runtimeConfig.ui.url,\n      port: isLocal ? resolvedPorts.ui : undefined,\n      localPath: isLocal ? runtimeConfig.ui.localPath : undefined,\n    });\n  }\n\n  if (runtimeConfig.plugins) {\n    for (const [pluginId, pluginCfg] of Object.entries(runtimeConfig.plugins)) {\n      const pluginIsLocal = pluginCfg.source === \"local\";\n      const p = resolvedPorts.plugins[pluginId];\n      const isAuthMirror = isAuthMirrorPluginEntry(runtimeConfig.auth, pluginId, pluginCfg);\n      if (pluginIsLocal && p?.api && !isAuthMirror) {\n        descriptors.push({\n          key: `plugin:${pluginId}`,\n          source: \"local\",\n          url: `http://localhost:${p.api}`,\n          port: p.api,\n          localPath: pluginCfg.localPath,\n        });\n      }\n      if (!pluginIsLocal && pluginCfg.url && !isAuthMirror) {\n        descriptors.push({\n          key: `plugin:${pluginId}`,\n          source: \"remote\",\n          url: pluginCfg.url,\n          port: undefined,\n          localPath: undefined,\n        });\n      }\n      if (pluginIsLocal && p?.ui && pluginCfg.ui?.source === \"local\") {\n        descriptors.push({\n          key: `plugin-ui:${pluginId}`,\n          source: \"local\",\n          url: `http://localhost:${p.ui}`,\n          port: p.ui,\n          localPath: pluginCfg.ui?.localPath,\n        });\n      }\n    }\n  }\n\n  return descriptors;\n}\n\nexport function buildLaunchSpec(\n  runtimeConfig: RuntimeConfig,\n  resolvedPorts: ResolvedPorts,\n): RuntimeLaunchSpec {\n  const hostPort =\n    runtimeConfig.host?.source === \"local\" ? resolvedPorts.host : runtimeConfig.host?.port;\n  const corsOrigin = hostPort ? `http://localhost:${hostPort}` : `http://localhost:3000`;\n\n  return {\n    port: resolvedPorts.host,\n    hostUrl: runtimeConfig.host?.url,\n    corsOrigin,\n    env: {\n      ...(resolvedPorts.host ? { PORT: String(resolvedPorts.host) } : {}),\n      ...(resolvedPorts.api ? { API_PORT: String(resolvedPorts.api) } : {}),\n      ...(resolvedPorts.ui ? { UI_PORT: String(resolvedPorts.ui) } : {}),\n      ...(resolvedPorts.auth ? { AUTH_PORT: String(resolvedPorts.auth) } : {}),\n    },\n    runtimeConfig,\n  };\n}\n\nexport function buildEnvGenerated(\n  resolvedPorts: ResolvedPorts,\n  dbs: DatabasePlan[],\n  redisPlans: RedisPlan[],\n): Record<string, string> {\n  const env: Record<string, string> = {};\n\n  if (resolvedPorts.host) {\n    env.CORS_ORIGIN = `http://localhost:${resolvedPorts.host}`;\n    // The host origin for plugins that derive absolute URLs from it (e.g. the\n    // auth plugin's Better Auth baseURL — email links, passkey RP id).\n    env.BASE_URL = `http://localhost:${resolvedPorts.host}`;\n  }\n\n  for (const db of dbs) {\n    env[db.secret] = db.url;\n  }\n  for (const r of redisPlans) {\n    env[r.secret] = r.url;\n  }\n\n  return env;\n}\n\nexport function planInfra(input: InfraInput): Effect.Effect<InfraPlan, InfraError, PortAllocator> {\n  return Effect.gen(function* () {\n    const cliPorts = normalizeCliPorts(input.cli);\n    const wKey = workspaceKey(input.configDir);\n\n    const plugins = (input.bosConfig.plugins ?? {}) as Record<\n      string,\n      { source: string; localPath?: string; ui?: { source: string; localPath?: string } }\n    >;\n\n    const {\n      ports: svcPorts,\n      claims,\n      devPortsState,\n    } = yield* allocateServices(cliPorts, plugins, input.configDir, input.bosConfig.auth, {\n      host: input.bosConfig.host?.source,\n      api: input.bosConfig.api?.source,\n      auth: input.bosConfig.auth?.source,\n      ui: input.bosConfig.ui?.source,\n    });\n\n    const { dbs, redisPlans } = yield* allocateDatabases(input.bosConfig);\n\n    const resolvedPorts: ResolvedPorts = { ...svcPorts };\n\n    // Write merged state once after all allocations succeed\n    // Skip persistence for regression tests / ephemeral runs\n    // devPorts pins are explicit choices only (ADR 0012 §4): this run's flags,\n    // falling back to previously-persisted explicit choices — never drift.\n    const previousDevPorts = loadPortState(input.configDir).devPorts ?? {};\n    const devPorts = {\n      host: devPortsState.host ?? previousDevPorts.host,\n      api: devPortsState.api ?? previousDevPorts.api,\n      auth: devPortsState.auth ?? previousDevPorts.auth,\n      ui: devPortsState.ui ?? previousDevPorts.ui,\n      pluginPortStart: devPortsState.pluginPortStart ?? previousDevPorts.pluginPortStart,\n    };\n    if (shouldPersistPortState()) {\n      savePortState(input.configDir, { devPorts });\n    }\n\n    const hostIsLocal = input.bosConfig.host?.source === \"local\";\n    const apiIsLocal = input.bosConfig.api?.source === \"local\";\n    const uiIsLocal = input.bosConfig.ui?.source === \"local\";\n    const authIsLocal = input.bosConfig.auth?.source === \"local\";\n    const assignedRuntimeConfig: RuntimeConfig = {\n      ...input.bosConfig,\n      host: resolvedPorts.host\n        ? {\n            ...input.bosConfig.host,\n            port: resolvedPorts.host,\n            url: `http://localhost:${resolvedPorts.host}`,\n            remoteUrl: !hostIsLocal\n              ? (input.bosConfig.host.remoteUrl ?? input.bosConfig.host.url)\n              : undefined,\n          }\n        : input.bosConfig.host,\n      api:\n        apiIsLocal && resolvedPorts.api\n          ? {\n              ...input.bosConfig.api,\n              port: resolvedPorts.api,\n              url: `http://localhost:${resolvedPorts.api}`,\n            }\n          : input.bosConfig.api,\n      ui:\n        uiIsLocal && resolvedPorts.ui\n          ? {\n              ...input.bosConfig.ui,\n              port: resolvedPorts.ui,\n              url: `http://localhost:${resolvedPorts.ui}`,\n              ssrUrl: undefined,\n            }\n          : input.bosConfig.ui,\n      auth:\n        authIsLocal && resolvedPorts.auth && input.bosConfig.auth\n          ? {\n              ...input.bosConfig.auth,\n              port: resolvedPorts.auth,\n              url: `http://localhost:${resolvedPorts.auth}`,\n            }\n          : input.bosConfig.auth,\n      plugins: input.bosConfig.plugins\n        ? Object.fromEntries(\n            Object.entries(input.bosConfig.plugins).map(([id, p]) => {\n              const isAuthMirror = isAuthMirrorPluginEntry(input.bosConfig.auth, id, p);\n              const pluginPort = resolvedPorts.plugins[id];\n              const patchedUi = (() => {\n                if (p.ui?.source !== \"local\" || !p.ui?.localPath || !pluginPort?.ui) return p.ui;\n                return {\n                  ...p.ui,\n                  port: pluginPort.ui,\n                  url: `http://localhost:${pluginPort.ui}`,\n                  ssrUrl: undefined,\n                };\n              })();\n              if (isAuthMirror) {\n                return [id, { ...p, ui: patchedUi }];\n              }\n              if (p.source === \"local\" && pluginPort?.api) {\n                return [\n                  id,\n                  {\n                    ...p,\n                    port: pluginPort.api,\n                    url: `http://localhost:${pluginPort.api}`,\n                    ui: patchedUi,\n                  },\n                ];\n              }\n              return [id, p];\n            }),\n          )\n        : undefined,\n    };\n\n    const serviceDescriptors = buildServiceDescriptors(assignedRuntimeConfig, resolvedPorts);\n\n    const launch = buildLaunchSpec(input.bosConfig, resolvedPorts);\n    const envGenerated = buildEnvGenerated(resolvedPorts, dbs, redisPlans);\n\n    const packages = serviceDescriptors.map((d) => d.key);\n    const descriptionMap = new Map(serviceDescriptors.map((d) => [d.key, d]));\n    const description = buildDescription(descriptionMap);\n\n    const orchestrator = {\n      packages,\n      env: {},\n      description,\n      port: resolvedPorts.host,\n      interactive: input.cli.interactive,\n    };\n\n    return {\n      workspaceKey: wKey,\n      cliPorts,\n      resolvedPorts,\n      runtimeConfig: assignedRuntimeConfig,\n      launch,\n      description,\n      serviceDescriptors: new Map(serviceDescriptors.map((d) => [d.key, d])),\n      envGenerated,\n      claims,\n      orchestrator,\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/infra/port-ownership.cjs

@@ -0,0 +1,57 @@
+let effect = require("effect");
+let node_child_process = require("node:child_process");
+
+//#region src/infra/port-ownership.ts
+let lsofCached = null;
+const execFileText = (path, args) => new Promise((resolve, reject) => {
+	(0, node_child_process.execFile)(path, args, { timeout: 5e3 }, (error, stdout) => {
+		if (error && !stdout) reject(error);
+		else resolve(stdout);
+	});
+});
+const isValidPort = (port) => Number.isInteger(port) && port > 0 && port <= 65535;
+const ownerOfPort = (port, options) => effect.Effect.callback((resume) => {
+	(async () => {
+		if (!isValidPort(port)) {
+			resume(effect.Effect.succeed(null));
+			return;
+		}
+		const lsof = options?.lsofPath ?? "lsof";
+		try {
+			const stdout = await execFileText(lsof, [
+				"-ti",
+				`:${port}`,
+				"-sTCP:LISTEN"
+			]);
+			const pid = Number.parseInt(stdout.trim().split("\n")[0] ?? "", 10);
+			if (!Number.isInteger(pid) || pid <= 0) {
+				resume(effect.Effect.succeed(null));
+				return;
+			}
+			try {
+				const psOut = await execFileText(options?.psPath ?? "ps", [
+					"-o",
+					"command=",
+					"-p",
+					String(pid)
+				]);
+				resume(effect.Effect.succeed({
+					pid,
+					command: psOut.trim() || "unknown"
+				}));
+			} catch {
+				resume(effect.Effect.succeed({
+					pid,
+					command: "unknown"
+				}));
+			}
+		} catch (error) {
+			if (error.code === "ENOENT") lsofCached = false;
+			resume(effect.Effect.succeed(null));
+		}
+	})();
+});
+
+//#endregion
+exports.ownerOfPort = ownerOfPort;
+//# sourceMappingURL=port-ownership.cjs.map

package/dist/infra/port-ownership.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-ownership.cjs","names":["Effect"],"sources":["../../src/infra/port-ownership.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { Effect } from \"effect\";\n\nexport interface PortOwner {\n  pid: number;\n  command: string;\n}\n\nexport interface PortOwnershipOptions {\n  lsofPath?: string;\n  psPath?: string;\n}\n\nlet lsofCached: boolean | null = null;\n\nconst execFileText = (path: string, args: string[]): Promise<string> =>\n  new Promise((resolve, reject) => {\n    execFile(path, args, { timeout: 5000 }, (error, stdout) => {\n      if (error && !stdout) reject(error);\n      else resolve(stdout);\n    });\n  });\n\nconst isValidPort = (port: number): boolean => Number.isInteger(port) && port > 0 && port <= 65535;\n\n// ownerOfPort identifies the process listening on a port via lsof + ps.\n// Returns null when the port is free or when lsof is unavailable (degraded:\n// callers report \"unknown owner\" rather than failing).\nexport const ownerOfPort = (\n  port: number,\n  options?: PortOwnershipOptions,\n): Effect.Effect<PortOwner | null> =>\n  Effect.callback((resume) => {\n    void (async () => {\n      if (!isValidPort(port)) {\n        resume(Effect.succeed(null));\n        return;\n      }\n      const lsof = options?.lsofPath ?? \"lsof\";\n      try {\n        const stdout = await execFileText(lsof, [\"-ti\", `:${port}`, \"-sTCP:LISTEN\"]);\n        const pid = Number.parseInt(stdout.trim().split(\"\\n\")[0] ?? \"\", 10);\n        if (!Number.isInteger(pid) || pid <= 0) {\n          resume(Effect.succeed(null));\n          return;\n        }\n        try {\n          const psOut = await execFileText(options?.psPath ?? \"ps\", [\n            \"-o\",\n            \"command=\",\n            \"-p\",\n            String(pid),\n          ]);\n          resume(Effect.succeed({ pid, command: psOut.trim() || \"unknown\" }));\n        } catch {\n          resume(Effect.succeed({ pid, command: \"unknown\" }));\n        }\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") lsofCached = false;\n        resume(Effect.succeed(null));\n      }\n    })();\n  });\n\n// isLsofAvailable probes (once per process) whether the lsof binary exists —\n// ownership reporting degrades gracefully when it does not.\nexport const isLsofAvailable = (options?: PortOwnershipOptions): Effect.Effect<boolean> =>\n  Effect.callback((resume) => {\n    if (lsofCached !== null) {\n      resume(Effect.succeed(lsofCached));\n      return;\n    }\n    void (async () => {\n      try {\n        await execFileText(options?.lsofPath ?? \"lsof\", [\"-v\"]);\n        lsofCached = true;\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") lsofCached = false;\n        else lsofCached = true;\n      }\n      resume(Effect.succeed(lsofCached));\n    })();\n  });\n\nexport const resetLsofCacheForTests = (): void => {\n  lsofCached = null;\n};\n"],"mappings":";;;;AAaA,IAAI,aAA6B;AAEjC,MAAM,gBAAgB,MAAc,SAClC,IAAI,SAAS,SAAS,WAAW;CAC/B,iCAAS,MAAM,MAAM,EAAE,SAAS,IAAK,IAAI,OAAO,WAAW;EACzD,IAAI,SAAS,CAAC,QAAQ,OAAO,KAAK;OAC7B,QAAQ,MAAM;CACrB,CAAC;AACH,CAAC;AAEH,MAAM,eAAe,SAA0B,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,QAAQ;AAK7F,MAAa,eACX,MACA,YAEAA,cAAO,UAAU,WAAW;CAC1B,CAAM,YAAY;EAChB,IAAI,CAAC,YAAY,IAAI,GAAG;GACtB,OAAOA,cAAO,QAAQ,IAAI,CAAC;GAC3B;EACF;EACA,MAAM,OAAO,SAAS,YAAY;EAClC,IAAI;GACF,MAAM,SAAS,MAAM,aAAa,MAAM;IAAC;IAAO,IAAI;IAAQ;GAAc,CAAC;GAC3E,MAAM,MAAM,OAAO,SAAS,OAAO,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE;GAClE,IAAI,CAAC,OAAO,UAAU,GAAG,KAAK,OAAO,GAAG;IACtC,OAAOA,cAAO,QAAQ,IAAI,CAAC;IAC3B;GACF;GACA,IAAI;IACF,MAAM,QAAQ,MAAM,aAAa,SAAS,UAAU,MAAM;KACxD;KACA;KACA;KACA,OAAO,GAAG;IACZ,CAAC;IACD,OAAOA,cAAO,QAAQ;KAAE;KAAK,SAAS,MAAM,KAAK,KAAK;IAAU,CAAC,CAAC;GACpE,QAAQ;IACN,OAAOA,cAAO,QAAQ;KAAE;KAAK,SAAS;IAAU,CAAC,CAAC;GACpD;EACF,SAAS,OAAO;GACd,IAAK,MAAgC,SAAS,UAAU,aAAa;GACrE,OAAOA,cAAO,QAAQ,IAAI,CAAC;EAC7B;CACF,EAAC,CAAE;AACL,CAAC"}

package/dist/infra/port-ownership.mjs

@@ -0,0 +1,57 @@
+import { Effect } from "effect";
+import { execFile } from "node:child_process";
+
+//#region src/infra/port-ownership.ts
+let lsofCached = null;
+const execFileText = (path, args) => new Promise((resolve, reject) => {
+	execFile(path, args, { timeout: 5e3 }, (error, stdout) => {
+		if (error && !stdout) reject(error);
+		else resolve(stdout);
+	});
+});
+const isValidPort = (port) => Number.isInteger(port) && port > 0 && port <= 65535;
+const ownerOfPort = (port, options) => Effect.callback((resume) => {
+	(async () => {
+		if (!isValidPort(port)) {
+			resume(Effect.succeed(null));
+			return;
+		}
+		const lsof = options?.lsofPath ?? "lsof";
+		try {
+			const stdout = await execFileText(lsof, [
+				"-ti",
+				`:${port}`,
+				"-sTCP:LISTEN"
+			]);
+			const pid = Number.parseInt(stdout.trim().split("\n")[0] ?? "", 10);
+			if (!Number.isInteger(pid) || pid <= 0) {
+				resume(Effect.succeed(null));
+				return;
+			}
+			try {
+				const psOut = await execFileText(options?.psPath ?? "ps", [
+					"-o",
+					"command=",
+					"-p",
+					String(pid)
+				]);
+				resume(Effect.succeed({
+					pid,
+					command: psOut.trim() || "unknown"
+				}));
+			} catch {
+				resume(Effect.succeed({
+					pid,
+					command: "unknown"
+				}));
+			}
+		} catch (error) {
+			if (error.code === "ENOENT") lsofCached = false;
+			resume(Effect.succeed(null));
+		}
+	})();
+});
+
+//#endregion
+export { ownerOfPort };
+//# sourceMappingURL=port-ownership.mjs.map

package/dist/infra/port-ownership.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-ownership.mjs","names":[],"sources":["../../src/infra/port-ownership.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { Effect } from \"effect\";\n\nexport interface PortOwner {\n  pid: number;\n  command: string;\n}\n\nexport interface PortOwnershipOptions {\n  lsofPath?: string;\n  psPath?: string;\n}\n\nlet lsofCached: boolean | null = null;\n\nconst execFileText = (path: string, args: string[]): Promise<string> =>\n  new Promise((resolve, reject) => {\n    execFile(path, args, { timeout: 5000 }, (error, stdout) => {\n      if (error && !stdout) reject(error);\n      else resolve(stdout);\n    });\n  });\n\nconst isValidPort = (port: number): boolean => Number.isInteger(port) && port > 0 && port <= 65535;\n\n// ownerOfPort identifies the process listening on a port via lsof + ps.\n// Returns null when the port is free or when lsof is unavailable (degraded:\n// callers report \"unknown owner\" rather than failing).\nexport const ownerOfPort = (\n  port: number,\n  options?: PortOwnershipOptions,\n): Effect.Effect<PortOwner | null> =>\n  Effect.callback((resume) => {\n    void (async () => {\n      if (!isValidPort(port)) {\n        resume(Effect.succeed(null));\n        return;\n      }\n      const lsof = options?.lsofPath ?? \"lsof\";\n      try {\n        const stdout = await execFileText(lsof, [\"-ti\", `:${port}`, \"-sTCP:LISTEN\"]);\n        const pid = Number.parseInt(stdout.trim().split(\"\\n\")[0] ?? \"\", 10);\n        if (!Number.isInteger(pid) || pid <= 0) {\n          resume(Effect.succeed(null));\n          return;\n        }\n        try {\n          const psOut = await execFileText(options?.psPath ?? \"ps\", [\n            \"-o\",\n            \"command=\",\n            \"-p\",\n            String(pid),\n          ]);\n          resume(Effect.succeed({ pid, command: psOut.trim() || \"unknown\" }));\n        } catch {\n          resume(Effect.succeed({ pid, command: \"unknown\" }));\n        }\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") lsofCached = false;\n        resume(Effect.succeed(null));\n      }\n    })();\n  });\n\n// isLsofAvailable probes (once per process) whether the lsof binary exists —\n// ownership reporting degrades gracefully when it does not.\nexport const isLsofAvailable = (options?: PortOwnershipOptions): Effect.Effect<boolean> =>\n  Effect.callback((resume) => {\n    if (lsofCached !== null) {\n      resume(Effect.succeed(lsofCached));\n      return;\n    }\n    void (async () => {\n      try {\n        await execFileText(options?.lsofPath ?? \"lsof\", [\"-v\"]);\n        lsofCached = true;\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") lsofCached = false;\n        else lsofCached = true;\n      }\n      resume(Effect.succeed(lsofCached));\n    })();\n  });\n\nexport const resetLsofCacheForTests = (): void => {\n  lsofCached = null;\n};\n"],"mappings":";;;;AAaA,IAAI,aAA6B;AAEjC,MAAM,gBAAgB,MAAc,SAClC,IAAI,SAAS,SAAS,WAAW;CAC/B,SAAS,MAAM,MAAM,EAAE,SAAS,IAAK,IAAI,OAAO,WAAW;EACzD,IAAI,SAAS,CAAC,QAAQ,OAAO,KAAK;OAC7B,QAAQ,MAAM;CACrB,CAAC;AACH,CAAC;AAEH,MAAM,eAAe,SAA0B,OAAO,UAAU,IAAI,KAAK,OAAO,KAAK,QAAQ;AAK7F,MAAa,eACX,MACA,YAEA,OAAO,UAAU,WAAW;CAC1B,CAAM,YAAY;EAChB,IAAI,CAAC,YAAY,IAAI,GAAG;GACtB,OAAO,OAAO,QAAQ,IAAI,CAAC;GAC3B;EACF;EACA,MAAM,OAAO,SAAS,YAAY;EAClC,IAAI;GACF,MAAM,SAAS,MAAM,aAAa,MAAM;IAAC;IAAO,IAAI;IAAQ;GAAc,CAAC;GAC3E,MAAM,MAAM,OAAO,SAAS,OAAO,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,EAAE;GAClE,IAAI,CAAC,OAAO,UAAU,GAAG,KAAK,OAAO,GAAG;IACtC,OAAO,OAAO,QAAQ,IAAI,CAAC;IAC3B;GACF;GACA,IAAI;IACF,MAAM,QAAQ,MAAM,aAAa,SAAS,UAAU,MAAM;KACxD;KACA;KACA;KACA,OAAO,GAAG;IACZ,CAAC;IACD,OAAO,OAAO,QAAQ;KAAE;KAAK,SAAS,MAAM,KAAK,KAAK;IAAU,CAAC,CAAC;GACpE,QAAQ;IACN,OAAO,OAAO,QAAQ;KAAE;KAAK,SAAS;IAAU,CAAC,CAAC;GACpD;EACF,SAAS,OAAO;GACd,IAAK,MAAgC,SAAS,UAAU,aAAa;GACrE,OAAO,OAAO,QAAQ,IAAI,CAAC;EAC7B;CACF,EAAC,CAAE;AACL,CAAC"}