Function buildShellLifecycleEnv

runtime/api-server/src/app-lifecycle-worker.ts:342–399

(
  params: {
    appDir?: string;
    httpPort?: number;
    mcpPort?: number;
    holabossUserId?: string;
    workspaceId?: string;
    resolvedApp?: ResolvedApplicationRuntime;
    integrationEnv?: NodeJS.ProcessEnv;
  }
)

}

function buildShellLifecycleEnv(
  params: {
    appDir?: string;
    httpPort?: number;
    mcpPort?: number;
    holabossUserId?: string;
    workspaceId?: string;
    resolvedApp?: ResolvedApplicationRuntime;
    integrationEnv?: NodeJS.ProcessEnv;
  }
): NodeJS.ProcessEnv {
  const env: NodeJS.ProcessEnv = params.appDir ? buildAppSetupEnv(params.appDir) : { ...process.env };
  if (params.integrationEnv) {
    Object.assign(env, params.integrationEnv);
  }
  if (params.httpPort !== undefined) {
    env.PORT = String(params.httpPort);
  }
  if (params.mcpPort !== undefined) {
    env.MCP_PORT = String(params.mcpPort);
  }
  if (
    params.holabossUserId &&
    params.resolvedApp &&
    params.resolvedApp.envContract.includes("HOLABOSS_USER_ID")
  ) {
    env.HOLABOSS_USER_ID = params.holabossUserId;
  }
  if (
    params.workspaceId &&
    params.resolvedApp &&
    params.resolvedApp.envContract.includes("HOLABOSS_WORKSPACE_ID") &&
    !env.HOLABOSS_WORKSPACE_ID
  ) {
    env.HOLABOSS_WORKSPACE_ID = params.workspaceId;
  }
  if (
    params.workspaceId &&
    params.resolvedApp &&
    params.resolvedApp.envContract.includes("WORKSPACE_DB_PATH") &&
    !env.WORKSPACE_DB_PATH
  ) {
    try {
      // ensureWorkspaceDataDb() materializes the file with WAL + the
      // _workspace_meta anchor row before the app process spawns. This
      // closes the race where workspace-level data tools ran before
      // any app had called getDb() and saw a missing file even though
      // the app was about to write.
      const dataDbPath = ensureWorkspaceDataDb(workspaceDirForId(params.workspaceId));
      env.WORKSPACE_DB_PATH = dataDbPath;
      maybeApplyAppSchema(params.resolvedApp, dataDbPath);
    } catch {
      // sanitizeWorkspaceId throws on invalid ids; the caller will surface
      // the underlying validation error elsewhere — don't crash env build.
    }
  }
  return env;
}