@kb-labs/shared-daemon 2.112.0 → 2.114.0

package/README.md

@@ -2,44 +2,37 @@
 
 Universal process-lifecycle bootstrapper for KB Labs daemon services.
 
-`runDaemon()` owns the boilerplate every daemon repeats — repo-root
-resolution, `.env` loading, platform bootstrap, port/host resolution from
-env, and graceful `SIGTERM`/`SIGINT` shutdown — so each service only writes
-its own `setup()`.
+`runService()` is the only process launcher for KB Labs services. It owns root
+resolution, layered `.env` loading, platform initialisation, port/host
+resolution and graceful `SIGTERM`/`SIGINT` shutdown; a service only writes its
+own `setup()`.
 
 ## Usage
 
 ```ts
-import { runDaemon } from '@kb-labs/shared-daemon';
-import { createServiceBootstrap } from '@kb-labs/core-runtime';
+import { runService } from '@kb-labs/shared-daemon';
 import { makeAssemblyHook } from '@kb-labs/plugin-runtime';
 import { getListenOptions } from '@kb-labs/shared-http';
 
-await runDaemon(
-  {
+await runService({
     appId: 'my-service',
     defaultPort: 5070,
     portEnvVar: 'MY_SERVICE_PORT',
     hostEnvVar: 'MY_SERVICE_HOST',
-    async setup({ platform, port, host, repoRoot }) {
-      const server = await createServer({ platform, repoRoot });
+    platform: { assemblyHook: makeAssemblyHook() },
+    async setup({ platform, port, host, projectRoot }) {
+      const server = await createServer({ platform, projectRoot });
       await server.listen(getListenOptions(port, host));
       return () => server.close(); // teardown — runs before platform.shutdown()
     },
-  },
-  // DI: keeps makeAssemblyHook (Layer 1) out of this package
-  (appId, repoRoot) =>
-    createServiceBootstrap({ appId, repoRoot, assemblyHook: makeAssemblyHook() }),
-);
+});
 ```
 
 ## What it handles
 
-- **Env + platform** — resolves `repoRoot` via `findRepoRoot`, loads `.env`,
-  bootstraps the platform through the injected factory.
-- **Socket isolation** — seeds `KB_SOCKET_HASH` (from `KB_PROJECT_ROOT ?? repoRoot`)
-  before config interpolation so `${KB_SOCKET_HASH}` socket paths resolve, matching
-  kb-dev's per-project hash.
+- **Env + platform** — resolves platform/project roots, loads their `.env`
+  layers, derives shared platform environment and initialises adapters through
+  the declared assembly hook.
 - **Port/host** — read from the configured env vars with defaults.
 - **Shutdown** — a single re-entrant handler runs `setup()`'s teardown, then
   `platform.shutdown()`, then exits; a second signal is ignored.

package/dist/index.d.ts

@@ -1,47 +1,51 @@
-import { PlatformContainer } from '@kb-labs/core-runtime';
-import { ILogger } from '@kb-labs/core-platform';
+import { PlatformAssemblyHook, PlatformFailurePolicy, PlatformUiProvider, PlatformContainer, PlatformRuntime } from '@kb-labs/core-runtime';
+import { IContextLogger } from '@kb-labs/core-platform';
 
-interface DaemonContext {
+interface ServiceContext {
     platform: PlatformContainer;
-    logger: ILogger;
+    logger: IContextLogger;
     port: number;
     host: string;
-    /**
-     * Repository root resolved via findRepoRoot(process.cwd()). Services should
-     * use this (not process.cwd()) for plugin/workflow discovery so they behave
-     * correctly when launched from a subdirectory.
-     */
-    repoRoot: string;
+    runtime: PlatformRuntime;
+    platformRoot: string;
+    projectRoot: string;
 }
-interface DaemonConfig {
+interface NetworkServiceConfig {
     appId: string;
     /**
-     * serviceId in the transport map (declarative network). Defaults to appId.
-     * Set explicitly when they differ. The daemon binds the port the transport
-     * publishes for this serviceId — keeping bind and route consistent (incl.
-     * any KB_NET_OFFSET shift).
+     * serviceId in the declarative transport map. Defaults to appId.
+     * Edge services that are not in the map use defaultPort + KB_NET_OFFSET.
      */
     serviceId?: string;
     defaultPort: number;
     portEnvVar: string;
     defaultHost?: string;
     hostEnvVar?: string;
+}
+interface ServiceConfig extends NetworkServiceConfig {
+    /** Starting directory for project/platform root resolution. */
+    startDir?: string;
+    /** Entrypoint import.meta.url for installed-mode platform discovery. */
+    moduleUrl?: string;
+    platform: {
+        assemblyHook: PlatformAssemblyHook;
+        failurePolicy?: PlatformFailurePolicy;
+        loadEnv?: boolean;
+        storeRawConfig?: boolean;
+        uiProvider?: PlatformUiProvider;
+    };
     /**
-     * Called after platform is ready. Returns a teardown callback.
-     * The callback is invoked before platform.shutdown() on SIGTERM/SIGINT.
+     * Runs after the platform is ready. The returned teardown is always called
+     * before PlatformRuntime.shutdown().
      */
-    setup(ctx: DaemonContext): Promise<() => Promise<void>>;
+    setup(ctx: ServiceContext): Promise<() => Promise<void>>;
 }
 /**
- * Universal process-lifecycle runner for KB Labs daemon services.
- *
- * Handles: env loading, platform init, port/host resolution,
- * setup invocation, and graceful SIGTERM/SIGINT shutdown.
+ * Canonical service process launcher.
  *
- * @param config - Service-specific configuration
- * @param platformBootstrap - DI factory for platform (keeps makeAssemblyHook out of this package)
- *   Example: (appId, repoRoot) => createServiceBootstrap({ appId, repoRoot, assemblyHook: makeAssemblyHook() })
+ * Every service gets the same roots/env/config/platform lifecycle. Service code
+ * starts only inside setup(), after PlatformRuntime is ready.
  */
-declare function runDaemon(config: DaemonConfig, platformBootstrap: (appId: string, repoRoot: string) => Promise<PlatformContainer>): Promise<void>;
+declare function runService(config: ServiceConfig): Promise<void>;
 
-export { type DaemonConfig, type DaemonContext, runDaemon };
+export { type ServiceConfig, type ServiceContext, runService };

package/dist/index.js

@@ -1,49 +1,131 @@
-import { createHash } from 'crypto';
-import { findRepoRoot } from '@kb-labs/core-sys';
-import { loadEnvFromRoot } from '@kb-labs/core-runtime';
+import { launchPlatform } from '@kb-labs/core-runtime';
 
 // src/daemon.ts
-async function runDaemon(config, platformBootstrap) {
-  const repoRoot = await findRepoRoot(process.cwd());
-  loadEnvFromRoot(repoRoot);
-  if (!process.env.KB_SOCKET_HASH) {
-    const hashRoot = process.env.KB_PROJECT_ROOT ?? repoRoot;
-    process.env.KB_SOCKET_HASH = createHash("md5").update(hashRoot).digest("hex").slice(0, 8);
-  }
-  const platform = await platformBootstrap(config.appId, repoRoot);
-  const logger = platform.logger.child({
-    serviceId: config.appId,
-    service: "bootstrap"
-  });
+function resolveNetwork(config, platform) {
   const serviceId = config.serviceId ?? config.appId;
   const transport = platform.getAdapter("serviceTransport");
-  const addr = transport?.listenAddress?.(serviceId);
+  const address = transport?.listenAddress?.(serviceId);
   const netOffset = Number(process.env.KB_NET_OFFSET) || 0;
-  const port = addr && "port" in addr ? addr.port : (process.env[config.portEnvVar] ? parseInt(process.env[config.portEnvVar], 10) : config.defaultPort) + netOffset;
-  const addrHost = addr && "host" in addr ? addr.host : void 0;
-  const host = config.hostEnvVar && process.env[config.hostEnvVar] ? process.env[config.hostEnvVar] : addrHost ?? config.defaultHost ?? "0.0.0.0";
-  logger.info(`${config.appId}: starting`, { port, host });
-  const teardown = await config.setup({ platform, logger, port, host, repoRoot });
-  let shuttingDown = false;
-  const shutdown = async (signal) => {
-    if (shuttingDown) {
-      return;
-    }
-    shuttingDown = true;
-    logger.warn(`${config.appId}: received ${signal}`);
-    await teardown();
-    await platform.shutdown();
-    logger.info(`${config.appId}: stopped`);
-    process.exit(0);
-  };
-  process.on("SIGTERM", async () => {
-    await shutdown("SIGTERM");
+  const port = address && "port" in address ? address.port : (process.env[config.portEnvVar] ? parseInt(process.env[config.portEnvVar], 10) : config.defaultPort) + netOffset;
+  const transportHost = address && "host" in address ? address.host : void 0;
+  const host = config.hostEnvVar && process.env[config.hostEnvVar] ? process.env[config.hostEnvVar] : transportHost ?? config.defaultHost ?? "0.0.0.0";
+  return { port, host };
+}
+async function runManagedService(config, managed, setup) {
+  const { port, host } = resolveNetwork(config, managed.platform);
+  const logger = managed.logger.forComponent("service-bootstrap");
+  logger.event("info", {
+    event: "service.starting",
+    message: "Service starting",
+    fields: { port, host }
   });
-  process.on("SIGINT", async () => {
-    await shutdown("SIGINT");
+  let teardown;
+  try {
+    teardown = await setup({
+      runtime: managed.runtime,
+      platform: managed.platform,
+      logger,
+      port,
+      host,
+      projectRoot: managed.projectRoot,
+      platformRoot: managed.platformRoot
+    });
+  } catch (error) {
+    logger.error(
+      "Service setup failed",
+      error instanceof Error ? error : void 0,
+      {
+        event: "service.failed",
+        error: error instanceof Error ? error.message : String(error)
+      }
+    );
+    await managed.shutdown("service.setup-failed");
+    throw error;
+  }
+  logger.event("info", {
+    event: "service.ready",
+    message: "Service ready",
+    fields: { port, host, outcome: "success" }
+  });
+  let shutdownPromise;
+  const shutdown = (signal) => {
+    shutdownPromise ??= (async () => {
+      logger.event("info", {
+        event: "service.stopping",
+        message: "Service stopping",
+        fields: { signal }
+      });
+      let shutdownError;
+      try {
+        await teardown?.();
+      } catch (error) {
+        shutdownError = error;
+        logger.error(
+          "Service teardown failed",
+          error instanceof Error ? error : void 0,
+          {
+            event: "service.failed",
+            phase: "teardown"
+          }
+        );
+      }
+      try {
+        await managed.shutdown(`signal:${signal}`);
+      } catch (error) {
+        shutdownError ??= error;
+        logger.error(
+          "Platform shutdown failed",
+          error instanceof Error ? error : void 0,
+          {
+            event: "service.failed",
+            phase: "platform-shutdown"
+          }
+        );
+      }
+      const exitCode = shutdownError ? 1 : 0;
+      logger.event(shutdownError ? "error" : "info", {
+        event: shutdownError ? "service.failed" : "service.stopped",
+        message: shutdownError ? "Service stopped with errors" : "Service stopped",
+        fields: {
+          signal,
+          exitCode,
+          outcome: shutdownError ? "failure" : "success"
+        }
+      });
+      process.exit(exitCode);
+    })();
+    return shutdownPromise;
+  };
+  process.once("SIGTERM", () => shutdown("SIGTERM"));
+  process.once("SIGINT", () => shutdown("SIGINT"));
+}
+async function runService(config) {
+  const runtime = await launchPlatform({
+    applicationId: config.appId,
+    serviceId: config.serviceId ?? config.appId,
+    kind: "service",
+    startDir: config.startDir,
+    moduleUrl: config.moduleUrl,
+    assemblyHook: config.platform.assemblyHook,
+    failurePolicy: config.platform.failurePolicy,
+    loadEnv: config.platform.loadEnv,
+    storeRawConfig: config.platform.storeRawConfig,
+    uiProvider: config.platform.uiProvider
   });
+  await runManagedService(
+    config,
+    {
+      runtime,
+      platform: runtime.platform,
+      logger: runtime.logger,
+      projectRoot: runtime.roots.projectRoot,
+      platformRoot: runtime.roots.platformRoot,
+      shutdown: (reason) => runtime.shutdown(reason)
+    },
+    config.setup
+  );
 }
 
-export { runDaemon };
+export { runService };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/daemon.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { createHash } from 'node:crypto';\nimport { findRepoRoot } from '@kb-labs/core-sys';\nimport { loadEnvFromRoot } from '@kb-labs/core-runtime';\nimport type { PlatformContainer } from '@kb-labs/core-runtime';\nimport type { ILogger, IServiceTransport } from '@kb-labs/core-platform';\n\nexport interface DaemonContext {\n  platform: PlatformContainer;\n  logger: ILogger;\n  port: number;\n  host: string;\n  /**\n   * Repository root resolved via findRepoRoot(process.cwd()). Services should\n   * use this (not process.cwd()) for plugin/workflow discovery so they behave\n   * correctly when launched from a subdirectory.\n   */\n  repoRoot: string;\n}\n\nexport interface DaemonConfig {\n  appId: string;\n  /**\n   * serviceId in the transport map (declarative network). Defaults to appId.\n   * Set explicitly when they differ. The daemon binds the port the transport\n   * publishes for this serviceId — keeping bind and route consistent (incl.\n   * any KB_NET_OFFSET shift).\n   */\n  serviceId?: string;\n  defaultPort: number;\n  portEnvVar: string;\n  defaultHost?: string;\n  hostEnvVar?: string;\n  /**\n   * Called after platform is ready. Returns a teardown callback.\n   * The callback is invoked before platform.shutdown() on SIGTERM/SIGINT.\n   */\n  setup(ctx: DaemonContext): Promise<() => Promise<void>>;\n}\n\n/**\n * Universal process-lifecycle runner for KB Labs daemon services.\n *\n * Handles: env loading, platform init, port/host resolution,\n * setup invocation, and graceful SIGTERM/SIGINT shutdown.\n *\n * @param config - Service-specific configuration\n * @param platformBootstrap - DI factory for platform (keeps makeAssemblyHook out of this package)\n *   Example: (appId, repoRoot) => createServiceBootstrap({ appId, repoRoot, assemblyHook: makeAssemblyHook() })\n */\nexport async function runDaemon(\n  config: DaemonConfig,\n  platformBootstrap: (appId: string, repoRoot: string) => Promise<PlatformContainer>,\n): Promise<void> {\n  const repoRoot = await findRepoRoot(process.cwd());\n  loadEnvFromRoot(repoRoot);\n\n  // Ensure KB_SOCKET_HASH is set before interpolateConfig() runs inside platformBootstrap.\n  // kb-dev sets it via spawnEnv() for all managed services (including gateway, rest-api).\n  // For manual starts (dev scripts, local testing), derive it the same way kb-dev does —\n  // from the project dir (KB_PROJECT_ROOT), falling back to repoRoot — so a manually\n  // started service lands in the same /tmp/kb-<hash>/ dir as kb-dev-managed peers.\n  if (!process.env.KB_SOCKET_HASH) {\n    const hashRoot = process.env.KB_PROJECT_ROOT ?? repoRoot;\n    process.env.KB_SOCKET_HASH = createHash('md5').update(hashRoot).digest('hex').slice(0, 8);\n  }\n\n  const platform = await platformBootstrap(config.appId, repoRoot);\n  const logger = platform.logger.child({\n    serviceId: config.appId,\n    service: 'bootstrap',\n  });\n\n  // Bind port from the transport (the single declarative network source): the\n  // daemon listens on exactly the port the transport publishes for its\n  // serviceId, so bind and route stay consistent — including any KB_NET_OFFSET\n  // shift. Socket services resolve their bind via KB_SOCKET_PATH (setup →\n  // getListenOptions), so listenAddress returns socketPath and we keep the\n  // fallback port. Services NOT in the transport map (e.g. state-daemon — not\n  // gateway-routed) are treated as edges: the fallback applies KB_NET_OFFSET\n  // directly, so the one offset knob still shifts their bind. Host stays the\n  // daemon's own concern (offset never affects host).\n  const serviceId = config.serviceId ?? config.appId;\n  const transport = platform.getAdapter<IServiceTransport>('serviceTransport');\n  const addr = transport?.listenAddress?.(serviceId);\n  const netOffset = Number(process.env.KB_NET_OFFSET) || 0;\n  const port = addr && 'port' in addr\n    ? addr.port\n    : (process.env[config.portEnvVar]\n        ? parseInt(process.env[config.portEnvVar]!, 10)\n        : config.defaultPort) + netOffset;\n\n  // Host precedence: explicit env override > transport's advisory host (set only\n  // by adapters that own the bind host, e.g. k8s) > daemon default.\n  const addrHost = addr && 'host' in addr ? addr.host : undefined;\n  const host = (config.hostEnvVar && process.env[config.hostEnvVar])\n    ? process.env[config.hostEnvVar]!\n    : (addrHost ?? config.defaultHost ?? '0.0.0.0');\n\n  logger.info(`${config.appId}: starting`, { port, host } as Record<string, unknown>);\n\n  const teardown = await config.setup({ platform, logger, port, host, repoRoot });\n\n  // Guard against a second signal (e.g. SIGTERM then Ctrl-C) re-running teardown\n  // against already-closed resources.\n  let shuttingDown = false;\n  const shutdown = async (signal: string) => {\n    if (shuttingDown) {\n      return;\n    }\n    shuttingDown = true;\n    logger.warn(`${config.appId}: received ${signal}`);\n    await teardown();\n    await platform.shutdown();\n    logger.info(`${config.appId}: stopped`);\n    process.exit(0);\n  };\n\n  process.on('SIGTERM', async () => { await shutdown('SIGTERM'); });\n  process.on('SIGINT', async () => { await shutdown('SIGINT'); });\n}\n"]}
+{"version":3,"sources":["../src/daemon.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  launchPlatform,\n  type PlatformAssemblyHook,\n  type PlatformContainer,\n  type PlatformFailurePolicy,\n  type PlatformRuntime,\n  type PlatformUiProvider,\n} from \"@kb-labs/core-runtime\";\nimport type { IContextLogger, IServiceTransport } from \"@kb-labs/core-platform\";\n\nexport interface ServiceContext {\n  platform: PlatformContainer;\n  logger: IContextLogger;\n  port: number;\n  host: string;\n  runtime: PlatformRuntime;\n  platformRoot: string;\n  projectRoot: string;\n}\n\ninterface NetworkServiceConfig {\n  appId: string;\n  /**\n   * serviceId in the declarative transport map. Defaults to appId.\n   * Edge services that are not in the map use defaultPort + KB_NET_OFFSET.\n   */\n  serviceId?: string;\n  defaultPort: number;\n  portEnvVar: string;\n  defaultHost?: string;\n  hostEnvVar?: string;\n}\n\nexport interface ServiceConfig extends NetworkServiceConfig {\n  /** Starting directory for project/platform root resolution. */\n  startDir?: string;\n  /** Entrypoint import.meta.url for installed-mode platform discovery. */\n  moduleUrl?: string;\n  platform: {\n    assemblyHook: PlatformAssemblyHook;\n    failurePolicy?: PlatformFailurePolicy;\n    loadEnv?: boolean;\n    storeRawConfig?: boolean;\n    uiProvider?: PlatformUiProvider;\n  };\n  /**\n   * Runs after the platform is ready. The returned teardown is always called\n   * before PlatformRuntime.shutdown().\n   */\n  setup(ctx: ServiceContext): Promise<() => Promise<void>>;\n}\n\ninterface ManagedRuntime {\n  platform: PlatformContainer;\n  logger: IContextLogger;\n  projectRoot: string;\n  platformRoot: string;\n  shutdown(reason?: string): Promise<void>;\n  runtime: PlatformRuntime;\n}\n\nfunction resolveNetwork(\n  config: NetworkServiceConfig,\n  platform: PlatformContainer,\n): { port: number; host: string } {\n  const serviceId = config.serviceId ?? config.appId;\n  const transport = platform.getAdapter<IServiceTransport>(\"serviceTransport\");\n  const address = transport?.listenAddress?.(serviceId);\n  const netOffset = Number(process.env.KB_NET_OFFSET) || 0;\n\n  const port =\n    address && \"port\" in address\n      ? address.port\n      : (process.env[config.portEnvVar]\n          ? parseInt(process.env[config.portEnvVar]!, 10)\n          : config.defaultPort) + netOffset;\n\n  const transportHost = address && \"host\" in address ? address.host : undefined;\n  const host =\n    config.hostEnvVar && process.env[config.hostEnvVar]\n      ? process.env[config.hostEnvVar]!\n      : (transportHost ?? config.defaultHost ?? \"0.0.0.0\");\n\n  return { port, host };\n}\n\nasync function runManagedService(\n  config: NetworkServiceConfig,\n  managed: ManagedRuntime,\n  setup: (context: ServiceContext) => Promise<() => Promise<void>>,\n): Promise<void> {\n  const { port, host } = resolveNetwork(config, managed.platform);\n  const logger = managed.logger.forComponent(\"service-bootstrap\");\n\n  logger.event(\"info\", {\n    event: \"service.starting\",\n    message: \"Service starting\",\n    fields: { port, host },\n  });\n\n  let teardown: (() => Promise<void>) | undefined;\n  try {\n    teardown = await setup({\n      runtime: managed.runtime as PlatformRuntime,\n      platform: managed.platform,\n      logger,\n      port,\n      host,\n      projectRoot: managed.projectRoot,\n      platformRoot: managed.platformRoot,\n    });\n  } catch (error) {\n    logger.error(\n      \"Service setup failed\",\n      error instanceof Error ? error : undefined,\n      {\n        event: \"service.failed\",\n        error: error instanceof Error ? error.message : String(error),\n      },\n    );\n    await managed.shutdown(\"service.setup-failed\");\n    throw error;\n  }\n\n  logger.event(\"info\", {\n    event: \"service.ready\",\n    message: \"Service ready\",\n    fields: { port, host, outcome: \"success\" },\n  });\n\n  let shutdownPromise: Promise<void> | undefined;\n  const shutdown = (signal: string): Promise<void> => {\n    shutdownPromise ??= (async () => {\n      logger.event(\"info\", {\n        event: \"service.stopping\",\n        message: \"Service stopping\",\n        fields: { signal },\n      });\n      let shutdownError: unknown;\n\n      try {\n        await teardown?.();\n      } catch (error) {\n        shutdownError = error;\n        logger.error(\n          \"Service teardown failed\",\n          error instanceof Error ? error : undefined,\n          {\n            event: \"service.failed\",\n            phase: \"teardown\",\n          },\n        );\n      }\n\n      try {\n        await managed.shutdown(`signal:${signal}`);\n      } catch (error) {\n        shutdownError ??= error;\n        logger.error(\n          \"Platform shutdown failed\",\n          error instanceof Error ? error : undefined,\n          {\n            event: \"service.failed\",\n            phase: \"platform-shutdown\",\n          },\n        );\n      }\n\n      const exitCode = shutdownError ? 1 : 0;\n      logger.event(shutdownError ? \"error\" : \"info\", {\n        event: shutdownError ? \"service.failed\" : \"service.stopped\",\n        message: shutdownError\n          ? \"Service stopped with errors\"\n          : \"Service stopped\",\n        fields: {\n          signal,\n          exitCode,\n          outcome: shutdownError ? \"failure\" : \"success\",\n        },\n      });\n      process.exit(exitCode);\n    })();\n    return shutdownPromise;\n  };\n\n  process.once(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\n  process.once(\"SIGINT\", () => shutdown(\"SIGINT\"));\n}\n\n/**\n * Canonical service process launcher.\n *\n * Every service gets the same roots/env/config/platform lifecycle. Service code\n * starts only inside setup(), after PlatformRuntime is ready.\n */\nexport async function runService(config: ServiceConfig): Promise<void> {\n  const runtime = await launchPlatform({\n    applicationId: config.appId,\n    serviceId: config.serviceId ?? config.appId,\n    kind: \"service\",\n    startDir: config.startDir,\n    moduleUrl: config.moduleUrl,\n    assemblyHook: config.platform.assemblyHook,\n    failurePolicy: config.platform.failurePolicy,\n    loadEnv: config.platform.loadEnv,\n    storeRawConfig: config.platform.storeRawConfig,\n    uiProvider: config.platform.uiProvider,\n  });\n\n  await runManagedService(\n    config,\n    {\n      runtime,\n      platform: runtime.platform,\n      logger: runtime.logger,\n      projectRoot: runtime.roots.projectRoot,\n      platformRoot: runtime.roots.platformRoot,\n      shutdown: (reason) => runtime.shutdown(reason),\n    },\n    config.setup,\n  );\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kb-labs/shared-daemon",
   "description": "Universal process-lifecycle bootstrapper for KB Labs daemon services",
-  "version": "2.112.0",
+  "version": "2.114.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,9 +26,8 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@kb-labs/core-platform": "^2.112.0",
-    "@kb-labs/core-runtime": "^2.112.0",
-    "@kb-labs/core-sys": "^2.112.0"
+    "@kb-labs/core-platform": "^2.114.0",
+    "@kb-labs/core-runtime": "^2.114.0"
   },
   "devDependencies": {
     "@kb-labs/devkit": "workspace:*",