@kb-labs/rest-api-app 2.112.0 → 2.114.0

package/dist/index.js

@@ -1,9 +1,9 @@
 import { loadRestApiConfig, combineManifestsToRegistry } from '@kb-labs/rest-api-core';
 import Fastify from 'fastify';
-import { loadEnvFromRoot, createServiceBootstrap, platform, getPlatformRoot } from '@kb-labs/core-runtime';
+import { platform } from '@kb-labs/core-runtime';
 import { EventEmitter } from 'events';
 import { performance, monitorEventLoopDelay } from 'perf_hooks';
-import { OperationMetricsTracker, getListenOptions, registerOpenAPI, createCorrelatedLogger, createServiceObservabilityDescribe, createServiceObservabilityHealth } from '@kb-labs/shared-http';
+import { OperationMetricsTracker, getListenOptions, registerOpenAPI, createHttpLogger, createServiceObservabilityDescribe, createServiceObservabilityHealth } from '@kb-labs/shared-http';
 import { Registry, Histogram, Counter, Gauge } from 'prom-client';
 import * as os from 'os';
 import { hostname } from 'os';
@@ -29,9 +29,9 @@ import fastifyRateLimit from '@fastify/rate-limit';
 import { ulid } from 'ulid';
 import { randomUUID, createHash } from 'crypto';
 import { TenantRateLimiter, getDefaultTenantTier } from '@kb-labs/core-tenant';
-import { promises, existsSync, readFileSync } from 'fs';
-import { findRepoRoot } from '@kb-labs/core-sys';
+import { existsSync, readFileSync } from 'fs';
 import { makeAssemblyHook } from '@kb-labs/plugin-runtime';
+import { runService } from '@kb-labs/shared-daemon';
 
 // src/bootstrap.ts
 var EventHub = class {
@@ -899,17 +899,17 @@ async function registerEventRoutes(server, basePath, registry, readiness, eventH
           request.kbLogger.warn("Failed to fetch system health for SSE client", { err: error });
         }
       });
-      await new Promise((resolve3) => {
+      await new Promise((resolve2) => {
         request.raw.on("close", () => {
           unsubscribe();
           reply.raw.end();
-          resolve3();
+          resolve2();
         });
         if (request.raw.socket && !request.raw.socket.writable) {
           void healthPromise.then(() => {
             unsubscribe();
             reply.raw.end();
-            resolve3();
+            resolve2();
           });
         }
       });
@@ -1529,8 +1529,8 @@ async function registerHealthRoutes(fastify, config, _repoRoot, registry, readin
   const readyPaths = resolvePaths(basePath, "/ready");
   const observabilityDescribePaths = resolvePaths(basePath, "/observability/describe");
   const observabilityHealthPaths = resolvePaths(basePath, "/observability/health");
-  for (const path3 of healthPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of healthPaths) {
+    fastify.get(path2, async (_request, reply) => {
       const eventHub = fastify.kbEventHub;
       try {
         const baseSnapshot = await getBaseSnapshot(registry);
@@ -1575,8 +1575,8 @@ async function registerHealthRoutes(fastify, config, _repoRoot, registry, readin
       }
     });
   }
-  for (const path3 of readyPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of readyPaths) {
+    fastify.get(path2, async (_request, reply) => {
       const eventHub = fastify.kbEventHub;
       const { registryLoaded, registryPartial, registryStale } = evaluateRegistryState(registry);
       readiness.registryLoaded = registryLoaded;
@@ -1604,11 +1604,11 @@ async function registerHealthRoutes(fastify, config, _repoRoot, registry, readin
       return reply.code(statusCode).send(response);
     });
   }
-  for (const path3 of observabilityDescribePaths) {
-    fastify.get(path3, async () => buildRestObservabilityDescribe(basePath));
+  for (const path2 of observabilityDescribePaths) {
+    fastify.get(path2, async () => buildRestObservabilityDescribe(basePath));
   }
-  for (const path3 of observabilityHealthPaths) {
-    fastify.get(path3, async () => {
+  for (const path2 of observabilityHealthPaths) {
+    fastify.get(path2, async () => {
       try {
         const baseSnapshot = await getBaseSnapshot(registry);
         const pluginsMetrics = metricsCollector.getLastPluginMountSnapshot();
@@ -1930,8 +1930,8 @@ function registerMetricsRoutes(server, config) {
     reply.header("Content-Type", "text/plain; version=0.0.4; charset=utf-8");
     return promMetrics + "\n" + customLines.join("\n");
   };
-  for (const path3 of metricsPaths) {
-    server.get(path3, handler);
+  for (const path2 of metricsPaths) {
+    server.get(path2, handler);
   }
   server.get(`${basePath}/metrics/headers/debug`, {
     schema: {
@@ -2087,7 +2087,10 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
     );
     const handlerExistsMap = /* @__PURE__ */ new Map();
     for (const result of handlerAccessResults) {
-      handlerExistsMap.set(result.key, { exists: result.exists, filePath: result.filePath });
+      handlerExistsMap.set(result.key, {
+        exists: result.exists,
+        filePath: result.filePath
+      });
     }
     platform.logger.debug("Batch handler file validation completed", {
       totalHandlers: handlerChecks.length,
@@ -2126,7 +2129,10 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
         const reasonCode = inferRouteValidationReasonCode(restValidationErrors);
         logDiagnosticEvent(platform.logger, {
           event: "plugin.routes.validation",
-          level: resolveRouteValidationLogLevel(restValidationErrors, manifest.rest?.routes?.length ?? 0),
+          level: resolveRouteValidationLogLevel(
+            restValidationErrors,
+            manifest.rest?.routes?.length ?? 0
+          ),
           reasonCode,
           message: "Plugin route validation failed",
           outcome: "failed",
@@ -2140,22 +2146,31 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
             totalRoutes: manifest.rest?.routes?.length ?? 0
           }
         });
-        platform.logger.warn("REST validation errors found, will skip problematic routes but continue mounting others", {
-          plugin: `${manifest.id}@${manifest.version}`,
-          pluginRoot,
-          remediation: "Verify REST handler file and export exist",
-          errors: restValidationErrors
-        });
-        const errorPaths = new Set(restValidationErrors.map((error) => {
-          const match = error.match(/Route\s+(\w+)\s+([^\s:]+)/);
-          return match ? `${match[1]} ${match[2]}` : null;
-        }).filter(Boolean));
+        platform.logger.warn(
+          "REST validation errors found, will skip problematic routes but continue mounting others",
+          {
+            plugin: `${manifest.id}@${manifest.version}`,
+            pluginRoot,
+            remediation: "Verify REST handler file and export exist",
+            errors: restValidationErrors
+          }
+        );
+        const errorPaths = new Set(
+          restValidationErrors.map((error) => {
+            const match = error.match(/Route\s+(\w+)\s+([^\s:]+)/);
+            return match ? `${match[1]} ${match[2]}` : null;
+          }).filter(Boolean)
+        );
         const validRoutes = manifest.rest.routes.filter((route) => {
           const routeKey = `${route.method} ${route.path}`;
           return !errorPaths.has(routeKey);
         });
         if (validRoutes.length === 0) {
-          restDomainOperationMetrics.recordOperation("plugin.routes.mount", 0, "error");
+          restDomainOperationMetrics.recordOperation(
+            "plugin.routes.mount",
+            0,
+            "error"
+          );
           logDiagnosticEvent(platform.logger, {
             event: "plugin.routes.validation",
             level: "error",
@@ -2193,7 +2208,10 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
           if (manifest.rest.basePath.startsWith("/api/")) {
             pluginBasePath = manifest.rest.basePath;
           } else if (manifest.rest.basePath.startsWith("/v1/")) {
-            pluginBasePath = manifest.rest.basePath.replace(/^\/v1/, config.basePath);
+            pluginBasePath = manifest.rest.basePath.replace(
+              /^\/v1/,
+              config.basePath
+            );
           } else {
             pluginBasePath = `${config.basePath}${manifest.rest.basePath}`;
           }
@@ -2226,13 +2244,17 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
           );
         }
         mountMetrics.recordSuccess(manifest.id, routesCount, duration);
-        restDomainOperationMetrics.recordOperation("plugin.routes.mount", duration, "ok");
+        restDomainOperationMetrics.recordOperation(
+          "plugin.routes.mount",
+          duration,
+          "ok"
+        );
         for (const route of manifest.rest?.routes ?? []) {
-          platform.logger.info("Mounted route", {
-            plugin: manifest.id,
-            method: route.method,
-            path: `${pluginBasePath}${route.path}`,
-            handler: route.handler
+          platform.logger.debug("Mounted route", {
+            pluginId: manifest.id,
+            "http.method": route.method,
+            "http.route": `${pluginBasePath}${route.path}`,
+            "plugin.handler": route.handler
           });
         }
         platform.logger.info("Successfully mounted plugin routes", {
@@ -2301,7 +2323,11 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
         succeeded.push(manifest.id);
       } catch (error) {
         mountMetrics.recordFailure(manifest.id, shortErrorMessage(error));
-        restDomainOperationMetrics.recordOperation("plugin.routes.mount", 0, "error");
+        restDomainOperationMetrics.recordOperation(
+          "plugin.routes.mount",
+          0,
+          "error"
+        );
         logDiagnosticEvent(platform.logger, {
           event: "plugin.routes.mount",
           level: "error",
@@ -2332,14 +2358,17 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
     if (readiness) {
       readiness.pluginRouteFailures = routeFailures;
     }
-    platform.logger.info("Sequential plugin route and WebSocket channel mounting completed", {
-      total: mountableManifests.length,
-      succeeded: succeeded.length,
-      failed: failed.length,
-      mountedRoutes,
-      mountedChannels,
-      errors
-    });
+    platform.logger.info(
+      "Sequential plugin route and WebSocket channel mounting completed",
+      {
+        total: mountableManifests.length,
+        succeeded: succeeded.length,
+        failed: failed.length,
+        mountedRoutes,
+        mountedChannels,
+        errors
+      }
+    );
   } catch (error) {
     logDiagnosticEvent(platform.logger, {
       domain: "registry",
@@ -2367,7 +2396,9 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
         error: `rest_discovery_failed ${shortErrorMessage(error)}`
       });
     }
-    metricsCollector.completePluginMount(platform.logger);
+    metricsCollector.completePluginMount(
+      platform.logger
+    );
     return;
   }
   if (readiness) {
@@ -2380,15 +2411,20 @@ async function registerPluginRoutes(server, config, repoRoot, registry, readines
       (performance.now() - mountStart).toFixed(2)
     );
   }
-  metricsCollector.completePluginMount(platform.logger);
+  metricsCollector.completePluginMount(
+    platform.logger
+  );
 }
 async function registerPluginSnapshotRoutes(server, config, registry) {
   const basePath = config.basePath;
   server.post(`${basePath}/plugins/refresh`, async (_request, reply) => {
     try {
-      await restDomainOperationMetrics.observeOperation("plugin.registry.refresh", async () => {
-        await registry.refresh();
-      });
+      await restDomainOperationMetrics.observeOperation(
+        "plugin.registry.refresh",
+        async () => {
+          await registry.refresh();
+        }
+      );
       const snapshot = await restDomainOperationMetrics.observeOperation(
         "plugin.registry.snapshot",
         async () => registry.snapshot()
@@ -2486,119 +2522,151 @@ async function registerPluginSnapshotRoutes(server, config, registry) {
       });
     }
   });
-  server.get(`${basePath}/plugins/@:scope/:name/readme`, {
-    schema: { hide: true }
-  }, async (request, reply) => {
-    const { scope, name } = request.params;
-    if (!scope || !name) {
-      return reply.code(400).send({ error: "Invalid plugin identifier" });
-    }
-    const pluginId = `@${scope}/${name}`;
-    const snapshot = registry.snapshot();
-    const manifests = extractSnapshotManifests(snapshot);
-    const entry = manifests.find((e) => e.pluginId === pluginId);
-    if (!entry) {
-      return reply.code(404).send({ error: `Plugin not found: ${pluginId}` });
-    }
-    const readmePath = path.join(entry.pluginRoot, "README.md");
-    if (!readmePath.startsWith(entry.pluginRoot)) {
-      return reply.code(400).send({ error: "Invalid path" });
-    }
-    try {
-      const content = await fs.readFile(readmePath, "utf-8");
-      return reply.code(200).header("Content-Type", "text/plain; charset=utf-8").send(content);
-    } catch (error) {
-      if (error.code === "ENOENT") {
-        return reply.code(404).send({ error: "README.md not found" });
+  server.get(
+    `${basePath}/plugins/@:scope/:name/readme`,
+    {
+      schema: { hide: true }
+    },
+    async (request, reply) => {
+      const { scope, name } = request.params;
+      if (!scope || !name) {
+        return reply.code(400).send({ error: "Invalid plugin identifier" });
+      }
+      const pluginId = `@${scope}/${name}`;
+      const snapshot = registry.snapshot();
+      const manifests = extractSnapshotManifests(snapshot);
+      const entry = manifests.find((e) => e.pluginId === pluginId);
+      if (!entry) {
+        return reply.code(404).send({ error: `Plugin not found: ${pluginId}` });
+      }
+      const readmePath = path.join(entry.pluginRoot, "README.md");
+      if (!readmePath.startsWith(entry.pluginRoot)) {
+        return reply.code(400).send({ error: "Invalid path" });
+      }
+      try {
+        const content = await fs.readFile(readmePath, "utf-8");
+        return reply.code(200).header("Content-Type", "text/plain; charset=utf-8").send(content);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return reply.code(404).send({ error: "README.md not found" });
+        }
+        return reply.code(500).send({ error: "Failed to read README.md" });
       }
-      return reply.code(500).send({ error: "Failed to read README.md" });
-    }
-  });
-  server.get(`${basePath}/plugins/@:scope/:name/changelog`, {
-    schema: { hide: true }
-  }, async (request, reply) => {
-    const { scope, name } = request.params;
-    if (!scope || !name) {
-      return reply.code(400).send({ error: "Invalid plugin identifier" });
-    }
-    const pluginId = `@${scope}/${name}`;
-    const snapshot = registry.snapshot();
-    const manifests = extractSnapshotManifests(snapshot);
-    const entry = manifests.find((e) => e.pluginId === pluginId);
-    if (!entry) {
-      return reply.code(404).send({ error: `Plugin not found: ${pluginId}` });
     }
-    const changelogPath = path.join(entry.pluginRoot, "CHANGELOG.md");
-    if (!changelogPath.startsWith(entry.pluginRoot)) {
-      return reply.code(400).send({ error: "Invalid path" });
+  );
+  server.get(
+    `${basePath}/plugins/@:scope/:name/changelog`,
+    {
+      schema: { hide: true }
+    },
+    async (request, reply) => {
+      const { scope, name } = request.params;
+      if (!scope || !name) {
+        return reply.code(400).send({ error: "Invalid plugin identifier" });
+      }
+      const pluginId = `@${scope}/${name}`;
+      const snapshot = registry.snapshot();
+      const manifests = extractSnapshotManifests(snapshot);
+      const entry = manifests.find((e) => e.pluginId === pluginId);
+      if (!entry) {
+        return reply.code(404).send({ error: `Plugin not found: ${pluginId}` });
+      }
+      const changelogPath = path.join(entry.pluginRoot, "CHANGELOG.md");
+      if (!changelogPath.startsWith(entry.pluginRoot)) {
+        return reply.code(400).send({ error: "Invalid path" });
+      }
+      try {
+        const content = await fs.readFile(changelogPath, "utf-8");
+        return reply.code(200).header("Content-Type", "text/plain; charset=utf-8").send(content);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return reply.code(404).send({ error: "CHANGELOG.md not found" });
+        }
+        return reply.code(500).send({ error: "Failed to read CHANGELOG.md" });
+      }
     }
-    try {
-      const content = await fs.readFile(changelogPath, "utf-8");
-      return reply.code(200).header("Content-Type", "text/plain; charset=utf-8").send(content);
-    } catch (error) {
-      if (error.code === "ENOENT") {
-        return reply.code(404).send({ error: "CHANGELOG.md not found" });
+  );
+  server.get(
+    `${basePath}/studio/registry`,
+    {
+      schema: {
+        tags: ["Studio"],
+        summary: "Get Studio Registry V2 (plugin pages for Module Federation)"
+      }
+    },
+    async (_request, reply) => {
+      try {
+        const snapshot = await restDomainOperationMetrics.observeOperation(
+          "plugin.studio.registry",
+          async () => registry.snapshot()
+        );
+        const manifests = extractSnapshotManifests(snapshot);
+        const studioManifests = manifests.filter((entry) => entry.manifest.studio?.version === 2).map((entry) => ({
+          manifest: entry.manifest,
+          pluginRoot: entry.pluginRoot
+        }));
+        const studioRegistry = combineManifestsToRegistry(studioManifests);
+        reply.type("application/json");
+        return studioRegistry;
+      } catch (error) {
+        platform.logger.error(
+          "Failed to generate studio registry",
+          error instanceof Error ? error : new Error(String(error))
+        );
+        reply.code(500).send({
+          error: "Failed to generate studio registry",
+          message: error instanceof Error ? error.message : String(error)
+        });
       }
-      return reply.code(500).send({ error: "Failed to read CHANGELOG.md" });
     }
-  });
-  server.get(`${basePath}/studio/registry`, {
-    schema: { tags: ["Studio"], summary: "Get Studio Registry V2 (plugin pages for Module Federation)" }
-  }, async (_request, reply) => {
-    try {
-      const snapshot = await restDomainOperationMetrics.observeOperation(
-        "plugin.studio.registry",
-        async () => registry.snapshot()
-      );
+  );
+  server.get(
+    "/plugins/@:scope/:name/widgets/*",
+    {
+      schema: { hide: true }
+    },
+    async (request, reply) => {
+      const { scope, name } = request.params;
+      const filePath = request.params["*"];
+      if (!scope || !name || !filePath || filePath.includes("..")) {
+        return reply.code(400).send({ error: "Invalid path" });
+      }
+      const pluginId = `@${scope}/${name}`;
+      const snapshot = registry.snapshot();
       const manifests = extractSnapshotManifests(snapshot);
-      const studioManifests = manifests.filter((entry) => entry.manifest.studio?.version === 2).map((entry) => ({ manifest: entry.manifest, pluginRoot: entry.pluginRoot }));
-      const studioRegistry = combineManifestsToRegistry(studioManifests);
-      reply.type("application/json");
-      return studioRegistry;
-    } catch (error) {
-      platform.logger.error("Failed to generate studio registry", error instanceof Error ? error : new Error(String(error)));
-      reply.code(500).send({
-        error: "Failed to generate studio registry",
-        message: error instanceof Error ? error.message : String(error)
-      });
+      const entry = manifests.find(
+        (e) => e.manifest.id === pluginId && e.manifest.studio?.version === 2
+      );
+      if (!entry) {
+        return reply.code(404).send({ error: `No widget bundle for ${pluginId}` });
+      }
+      const { join: join2, extname } = await import('path');
+      const { createReadStream, existsSync: existsSync2, statSync } = await import('fs');
+      const bundleDir = join2(entry.pluginRoot, "dist", "widgets");
+      const fullPath = join2(bundleDir, filePath);
+      if (!fullPath.startsWith(bundleDir)) {
+        return reply.code(400).send({ error: "Invalid path" });
+      }
+      if (!existsSync2(fullPath) || !statSync(fullPath).isFile()) {
+        return reply.code(404).send({
+          error: `Widget file not found: ${pluginId}/widgets/${filePath}`
+        });
+      }
+      const MIME = {
+        ".js": "application/javascript",
+        ".mjs": "application/javascript",
+        ".css": "text/css",
+        ".json": "application/json",
+        ".map": "application/json"
+      };
+      const ext = extname(filePath);
+      const isEntry = filePath === "remoteEntry.js";
+      return reply.code(200).header("Content-Type", MIME[ext] ?? "application/octet-stream").header("Content-Length", statSync(fullPath).size).header(
+        "Cache-Control",
+        isEntry ? "public, max-age=10, must-revalidate" : process.env.NODE_ENV === "production" ? "public, max-age=31536000, immutable" : "no-cache"
+      ).send(createReadStream(fullPath));
     }
-  });
-  server.get("/plugins/@:scope/:name/widgets/*", {
-    schema: { hide: true }
-  }, async (request, reply) => {
-    const { scope, name } = request.params;
-    const filePath = request.params["*"];
-    if (!scope || !name || !filePath || filePath.includes("..")) {
-      return reply.code(400).send({ error: "Invalid path" });
-    }
-    const pluginId = `@${scope}/${name}`;
-    const snapshot = registry.snapshot();
-    const manifests = extractSnapshotManifests(snapshot);
-    const entry = manifests.find((e) => e.manifest.id === pluginId && e.manifest.studio?.version === 2);
-    if (!entry) {
-      return reply.code(404).send({ error: `No widget bundle for ${pluginId}` });
-    }
-    const { join: join3, extname } = await import('path');
-    const { createReadStream, existsSync: existsSync2, statSync } = await import('fs');
-    const bundleDir = join3(entry.pluginRoot, "dist", "widgets");
-    const fullPath = join3(bundleDir, filePath);
-    if (!fullPath.startsWith(bundleDir)) {
-      return reply.code(400).send({ error: "Invalid path" });
-    }
-    if (!existsSync2(fullPath) || !statSync(fullPath).isFile()) {
-      return reply.code(404).send({ error: `Widget file not found: ${pluginId}/widgets/${filePath}` });
-    }
-    const MIME = {
-      ".js": "application/javascript",
-      ".mjs": "application/javascript",
-      ".css": "text/css",
-      ".json": "application/json",
-      ".map": "application/json"
-    };
-    const ext = extname(filePath);
-    const isEntry = filePath === "remoteEntry.js";
-    return reply.code(200).header("Content-Type", MIME[ext] ?? "application/octet-stream").header("Content-Length", statSync(fullPath).size).header("Cache-Control", isEntry ? "public, max-age=10, must-revalidate" : process.env.NODE_ENV === "production" ? "public, max-age=31536000, immutable" : "no-cache").send(createReadStream(fullPath));
-  });
+  );
   server.get(`${basePath}/plugins/health`, async (_request, reply) => {
     try {
       const snapshot = await restDomainOperationMetrics.observeOperation(
@@ -2617,7 +2685,9 @@ async function registerPluginSnapshotRoutes(server, config, registry) {
       }
       const registryErrors = snapshot.errors ?? [];
       const discoveryDiagnostics = snapshot.diagnostics ?? [];
-      const discoveryErrorCount = discoveryDiagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+      const discoveryErrorCount = discoveryDiagnostics.filter(
+        (diagnostic) => diagnostic.severity === "error"
+      ).length;
       const partialReasons = [];
       if (snapshot.corrupted) {
         partialReasons.push("snapshot_corrupted");
@@ -2658,7 +2728,9 @@ async function registerPluginSnapshotRoutes(server, config, registry) {
         diagnostics: {
           total: discoveryDiagnostics.length,
           errors: discoveryErrorCount,
-          warnings: discoveryDiagnostics.filter((diagnostic) => diagnostic.severity === "warning").length,
+          warnings: discoveryDiagnostics.filter(
+            (diagnostic) => diagnostic.severity === "warning"
+          ).length,
           items: discoveryDiagnostics.map((diagnostic) => ({
             severity: diagnostic.severity,
             code: diagnostic.code,
@@ -2677,7 +2749,10 @@ async function registerPluginSnapshotRoutes(server, config, registry) {
         message: registryErrors.length > 0 ? `Registry is partial - ${registryErrors.length} plugin(s) failed to load. Check registryErrors.items for details.` : discoveryErrorCount > 0 ? `Registry has discovery diagnostics - ${discoveryErrorCount} blocking issue(s). Check diagnostics.items for details.` : snapshot.partial && partialReasons.includes("initialization_incomplete") ? "Registry is partial - initialization incomplete. Try refreshing or wait for the snapshot rebuild to complete." : snapshot.partial ? `Registry is partial - reasons: ${partialReasons.join(", ")}` : snapshot.stale ? "Registry is stale - plugin snapshot may be outdated." : validationIssues.length > 0 ? `${validationIssues.length} plugin(s) have validation errors.` : "All plugins are healthy."
       };
     } catch (error) {
-      platform.logger.error("Failed to get plugin health", error instanceof Error ? error : new Error(String(error)));
+      platform.logger.error(
+        "Failed to get plugin health",
+        error instanceof Error ? error : new Error(String(error))
+      );
       reply.code(500).send({
         error: "Failed to get plugin health",
         message: error instanceof Error ? error.message : String(error)
@@ -2699,7 +2774,9 @@ async function registerPluginSnapshotRoutes(server, config, registry) {
         "plugin.registry.snapshot",
         async () => registry.snapshot()
       );
-      const pluginEntry = snapshot.manifests.find((entry) => entry.pluginId === pluginId);
+      const pluginEntry = snapshot.manifests.find(
+        (entry) => entry.pluginId === pluginId
+      );
       if (!pluginEntry) {
         reply.code(404).send({
           error: "Plugin not found",
@@ -2730,7 +2807,10 @@ Please answer the question based on the plugin manifest above.`;
         usage: response.usage
       };
     } catch (error) {
-      platform.logger.error("Failed to get AI answer about plugin", error instanceof Error ? error : new Error(String(error)));
+      platform.logger.error(
+        "Failed to get AI answer about plugin",
+        error instanceof Error ? error : new Error(String(error))
+      );
       reply.code(500).send({
         error: "Failed to get AI answer",
         message: error instanceof Error ? error.message : String(error)
@@ -3292,15 +3372,15 @@ async function registerCacheRoutes(server, config, registry) {
     }
   });
 }
-async function registerObservabilityRoutes(fastify, config, repoRoot, historicalMetrics, platform17) {
+async function registerObservabilityRoutes(fastify, config, repoRoot, historicalMetrics, platform16) {
   const basePath = normalizeBasePath(config.basePath);
   const stateBrokerPaths = resolvePaths(basePath, "/observability/state-broker");
   const systemMetricsPaths = resolvePaths(basePath, "/observability/system-metrics");
   const metricsHistoryPaths = resolvePaths(basePath, "/observability/metrics/history");
   const metricsHeatmapPaths = resolvePaths(basePath, "/observability/metrics/heatmap");
   const insightsChatPaths = resolvePaths(basePath, "/observability/insights/chat");
-  for (const path3 of stateBrokerPaths) {
-    fastify.get(path3, { schema: { tags: ["Observability"], summary: "State Broker statistics" } }, async (_request, reply) => {
+  for (const path2 of stateBrokerPaths) {
+    fastify.get(path2, { schema: { tags: ["Observability"], summary: "State Broker statistics" } }, async (_request, reply) => {
       try {
         const stateBrokerUrl = process.env.KB_STATE_DAEMON_URL || "http://localhost:7777";
         fastify.log.debug({ url: stateBrokerUrl }, "Fetching State Broker stats");
@@ -3339,7 +3419,7 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
           }
         };
       } catch (error) {
-        platform17?.logger.error("Failed to fetch State Broker stats", error instanceof Error ? error : new Error(String(error)));
+        platform16?.logger.error("Failed to fetch State Broker stats", error instanceof Error ? error : new Error(String(error)));
         const isTimeout = error instanceof Error && error.name === "AbortError";
         return reply.code(503).send({
           ok: false,
@@ -3354,10 +3434,10 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
       }
     });
   }
-  for (const path3 of systemMetricsPaths) {
-    fastify.get(path3, { schema: { tags: ["Observability"], summary: "System resource metrics" } }, async (_request, reply) => {
+  for (const path2 of systemMetricsPaths) {
+    fastify.get(path2, { schema: { tags: ["Observability"], summary: "System resource metrics" } }, async (_request, reply) => {
       try {
-        if (!platform17?.cache) {
+        if (!platform16?.cache) {
           return reply.code(503).send({
             ok: false,
             error: {
@@ -3369,18 +3449,18 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
         fastify.log.debug("Fetching system metrics from all instances");
         const allMetrics = [];
         try {
-          const cacheWithScan = platform17.cache;
-          if ("scan" in platform17.cache && typeof cacheWithScan.scan === "function") {
+          const cacheWithScan = platform16.cache;
+          if ("scan" in platform16.cache && typeof cacheWithScan.scan === "function") {
             const keys = await cacheWithScan.scan("system-metrics:*");
             for (const key of keys) {
-              const metrics = await platform17.cache.get(key);
+              const metrics = await platform16.cache.get(key);
               if (metrics) {
                 allMetrics.push(metrics);
               }
             }
           } else {
             const currentInstanceId = hostname();
-            const metrics = await platform17.cache.get(`system-metrics:${currentInstanceId}`);
+            const metrics = await platform16.cache.get(`system-metrics:${currentInstanceId}`);
             if (metrics) {
               allMetrics.push(metrics);
             }
@@ -3389,7 +3469,7 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
         } catch (scanError) {
           fastify.log.warn({ err: scanError }, "Failed to scan platform.cache for system metrics");
           const currentInstanceId = hostname();
-          const metrics = await platform17.cache.get(`system-metrics:${currentInstanceId}`);
+          const metrics = await platform16.cache.get(`system-metrics:${currentInstanceId}`);
           if (metrics) {
             allMetrics.push(metrics);
           }
@@ -3437,7 +3517,7 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
           }
         };
       } catch (error) {
-        platform17?.logger.error("Failed to fetch system metrics", error instanceof Error ? error : new Error(String(error)));
+        platform16?.logger.error("Failed to fetch system metrics", error instanceof Error ? error : new Error(String(error)));
         return reply.code(500).send({
           ok: false,
           error: {
@@ -3448,8 +3528,8 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
       }
     });
   }
-  for (const path3 of metricsHistoryPaths) {
-    fastify.get(path3, {
+  for (const path2 of metricsHistoryPaths) {
+    fastify.get(path2, {
       schema: {
         tags: ["Observability"],
         summary: "Historical time-series metrics",
@@ -3535,7 +3615,7 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
           }
         };
       } catch (error) {
-        platform17?.logger.error("Failed to query historical metrics", error instanceof Error ? error : new Error(String(error)), { query });
+        platform16?.logger.error("Failed to query historical metrics", error instanceof Error ? error : new Error(String(error)), { query });
         return reply.code(500).send({
           ok: false,
           error: {
@@ -3546,8 +3626,8 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
       }
     });
   }
-  for (const path3 of metricsHeatmapPaths) {
-    fastify.get(path3, {
+  for (const path2 of metricsHeatmapPaths) {
+    fastify.get(path2, {
       schema: {
         tags: ["Observability"],
         summary: "Metrics heatmap data",
@@ -3626,7 +3706,7 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
           }
         };
       } catch (error) {
-        platform17?.logger.error("Failed to query heatmap data", error instanceof Error ? error : new Error(String(error)), { query });
+        platform16?.logger.error("Failed to query heatmap data", error instanceof Error ? error : new Error(String(error)), { query });
         return reply.code(500).send({
           ok: false,
           error: {
@@ -3637,8 +3717,8 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
       }
     });
   }
-  for (const path3 of insightsChatPaths) {
-    fastify.post(path3, {
+  for (const path2 of insightsChatPaths) {
+    fastify.post(path2, {
       schema: {
         tags: ["Observability"],
         summary: "AI-powered observability insights chat",
@@ -3660,7 +3740,7 @@ async function registerObservabilityRoutes(fastify, config, repoRoot, historical
         }
       }
     }, async (request, reply) => {
-      if (!platform17?.llm) {
+      if (!platform16?.llm) {
         return reply.code(503).send({
           ok: false,
           error: {
@@ -3726,15 +3806,15 @@ Provide a clear, actionable response based on the data above. Include:
 
 Be concise but thorough. Use markdown formatting.`;
         fastify.log.debug({ question: body.question, contextLength: contextText.length }, "Calling LLM for insights");
-        const result = await platform17.llm.complete(prompt, {
+        const result = await platform16.llm.complete(prompt, {
           systemPrompt: "You are a DevOps and SRE expert assistant. Analyze system metrics and provide actionable insights. Be concise, technical, and helpful.",
           temperature: 0.7,
           maxTokens: 1e3
         });
         const totalTokens = result.usage.promptTokens + result.usage.completionTokens;
         fastify.log.debug({ tokensUsed: totalTokens }, "LLM response received for insights");
-        if (platform17.analytics) {
-          platform17.analytics.track("ai_insights.chat", {
+        if (platform16.analytics) {
+          platform16.analytics.track("ai_insights.chat", {
             questionLength: body.question.length,
             contextIncluded: Object.keys(contextConfig).filter((k) => contextConfig[k]),
             timeRange: contextConfig.timeRange,
@@ -3763,9 +3843,9 @@ Be concise but thorough. Use markdown formatting.`;
           }
         };
       } catch (error) {
-        platform17?.logger.error("Failed to generate insights", error instanceof Error ? error : new Error(String(error)));
-        if (platform17?.analytics) {
-          platform17.analytics.track("ai_insights.error", {
+        platform16?.logger.error("Failed to generate insights", error instanceof Error ? error : new Error(String(error)));
+        if (platform16?.analytics) {
+          platform16.analytics.track("ai_insights.error", {
             error: error instanceof Error ? error.message : "Unknown error",
             questionLength: request.body?.question?.length ?? 0
           }).catch(() => {
@@ -3786,8 +3866,8 @@ Be concise but thorough. Use markdown formatting.`;
 async function registerAnalyticsRoutes(fastify, config) {
   const basePath = normalizeBasePath(config.basePath);
   const eventsPaths = resolvePaths(basePath, "/analytics/events");
-  for (const path3 of eventsPaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of eventsPaths) {
+    fastify.get(path2, async (request, reply) => {
       try {
         const analytics = platform.analytics;
         const getEvents = analytics.getEvents;
@@ -3856,8 +3936,8 @@ async function registerAnalyticsRoutes(fastify, config) {
     });
   }
   const statsPaths = resolvePaths(basePath, "/analytics/stats");
-  for (const path3 of statsPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of statsPaths) {
+    fastify.get(path2, async (_request, reply) => {
       try {
         const analytics = platform.analytics;
         const getStats = analytics.getStats;
@@ -3908,8 +3988,8 @@ async function registerAnalyticsRoutes(fastify, config) {
     });
   }
   const bufferPaths = resolvePaths(basePath, "/analytics/buffer/status");
-  for (const path3 of bufferPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of bufferPaths) {
+    fastify.get(path2, async (_request, reply) => {
       try {
         const analytics = platform.analytics;
         const getBufferStatus = analytics.getBufferStatus;
@@ -3965,8 +4045,8 @@ async function registerAnalyticsRoutes(fastify, config) {
     });
   }
   const dlqPaths = resolvePaths(basePath, "/analytics/dlq/status");
-  for (const path3 of dlqPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of dlqPaths) {
+    fastify.get(path2, async (_request, reply) => {
       try {
         const analytics = platform.analytics;
         const getDlqStatus = analytics.getDlqStatus;
@@ -4107,8 +4187,8 @@ function isValidISODate(dateString) {
 async function registerAdaptersRoutes(fastify, config) {
   const basePath = normalizeBasePath(config.basePath);
   const llmUsagePaths = resolvePaths(basePath, "/adapters/llm/usage");
-  for (const path3 of llmUsagePaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of llmUsagePaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getEvents) {
         return reply.code(501).send({
@@ -4291,8 +4371,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const llmDailyStatsPaths = resolvePaths(basePath, "/adapters/llm/daily-stats");
-  for (const path3 of llmDailyStatsPaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of llmDailyStatsPaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getDailyStats) {
         return reply.code(501).send({
@@ -4337,8 +4417,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const embeddingsDailyStatsPaths = resolvePaths(basePath, "/adapters/embeddings/daily-stats");
-  for (const path3 of embeddingsDailyStatsPaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of embeddingsDailyStatsPaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getDailyStats) {
         return reply.code(501).send({
@@ -4378,8 +4458,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const embeddingsUsagePaths = resolvePaths(basePath, "/adapters/embeddings/usage");
-  for (const path3 of embeddingsUsagePaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of embeddingsUsagePaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getEvents) {
         return reply.code(501).send({
@@ -4507,8 +4587,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const vectorstoreDailyStatsPaths = resolvePaths(basePath, "/adapters/vectorstore/daily-stats");
-  for (const path3 of vectorstoreDailyStatsPaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of vectorstoreDailyStatsPaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getDailyStats) {
         return reply.code(501).send({
@@ -4548,8 +4628,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const vectorstoreUsagePaths = resolvePaths(basePath, "/adapters/vectorstore/usage");
-  for (const path3 of vectorstoreUsagePaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of vectorstoreUsagePaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getEvents) {
         return reply.code(501).send({
@@ -4660,8 +4740,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const cacheDailyStatsPaths = resolvePaths(basePath, "/adapters/cache/daily-stats");
-  for (const path3 of cacheDailyStatsPaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of cacheDailyStatsPaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getDailyStats) {
         return reply.code(501).send({
@@ -4701,8 +4781,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const cacheUsagePaths = resolvePaths(basePath, "/adapters/cache/usage");
-  for (const path3 of cacheUsagePaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of cacheUsagePaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getEvents) {
         return reply.code(501).send({
@@ -4788,8 +4868,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const storageDailyStatsPaths = resolvePaths(basePath, "/adapters/storage/daily-stats");
-  for (const path3 of storageDailyStatsPaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of storageDailyStatsPaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getDailyStats) {
         return reply.code(501).send({
@@ -4829,8 +4909,8 @@ async function registerAdaptersRoutes(fastify, config) {
     });
   }
   const storageUsagePaths = resolvePaths(basePath, "/adapters/storage/usage");
-  for (const path3 of storageUsagePaths) {
-    fastify.get(path3, async (request, reply) => {
+  for (const path2 of storageUsagePaths) {
+    fastify.get(path2, async (request, reply) => {
       const analytics = platform.analytics;
       if (!analytics.getEvents) {
         return reply.code(501).send({
@@ -5037,7 +5117,7 @@ Keep the summary under 300 words. Use simple paragraphs separated by double newl
 }
 function extractCorrelationKeys(log) {
   return {
-    requestId: log.fields.requestId ?? log.fields.reqId,
+    requestId: log.fields.requestId,
     traceId: log.fields.traceId,
     executionId: log.fields.executionId,
     sessionId: log.fields.sessionId
@@ -5048,12 +5128,15 @@ async function findRelatedLogs(targetLog) {
   const timeWindow = 6e4;
   if (correlationKeys.requestId || correlationKeys.traceId || correlationKeys.executionId) {
     const relatedLogs = [];
-    const result2 = await platform.logs.query({
-      from: targetLog.timestamp - timeWindow,
-      to: targetLog.timestamp + timeWindow
-    }, {
-      limit: 1e3
-    });
+    const result2 = await platform.logs.query(
+      {
+        from: targetLog.timestamp - timeWindow,
+        to: targetLog.timestamp + timeWindow
+      },
+      {
+        limit: 1e3
+      }
+    );
     for (const log of result2.logs) {
       if (log.id === targetLog.id) {
         continue;
@@ -5067,13 +5150,16 @@ async function findRelatedLogs(targetLog) {
       return relatedLogs.sort((a, b) => a.timestamp - b.timestamp).map(toFrontendLogRecord);
     }
   }
-  const result = await platform.logs.query({
-    source: targetLog.source,
-    from: targetLog.timestamp - timeWindow,
-    to: targetLog.timestamp + timeWindow
-  }, {
-    limit: 50
-  });
+  const result = await platform.logs.query(
+    {
+      source: targetLog.source,
+      from: targetLog.timestamp - timeWindow,
+      to: targetLog.timestamp + timeWindow
+    },
+    {
+      limit: 50
+    }
+  );
   return result.logs.filter((log) => log.id !== targetLog.id).sort((a, b) => a.timestamp - b.timestamp).map(toFrontendLogRecord);
 }
 function generateFallbackSummary(stats, logs) {
@@ -5094,7 +5180,9 @@ function generateFallbackSummary(stats, logs) {
   if (Object.keys(stats.byPlugin).length > 0) {
     summary += `By Plugin:
 `;
-    Object.entries(stats.byPlugin).sort((a, b) => b[1] - a[1]).slice(0, 5).forEach(([plugin, count]) => {
+    Object.entries(stats.byPlugin).sort(
+      (a, b) => b[1] - a[1]
+    ).slice(0, 5).forEach(([plugin, count]) => {
       summary += `${plugin}: ${count}
 `;
     });
@@ -5120,62 +5208,70 @@ function generateFallbackSummary(stats, logs) {
   return summary;
 }
 async function registerLogRoutes(server, config, eventHub) {
-  server.get("/api/v1/logs", { schema: { tags: ["Logs"], summary: "Query logs with filters" } }, async (request, reply) => {
-    try {
-      const limit = request.query.limit ? parseInt(request.query.limit, 10) : 100;
-      const offset = request.query.offset ? parseInt(request.query.offset, 10) : 0;
-      const query = {
-        level: request.query.level,
-        source: request.query.plugin,
-        from: request.query.from ? new Date(request.query.from).getTime() : void 0,
-        to: request.query.to ? new Date(request.query.to).getTime() : void 0
-      };
-      let result;
-      if (request.query.search) {
-        result = await platform.logs.search(request.query.search, {
-          limit,
-          offset
-        });
-      } else {
-        result = await platform.logs.query(query, {
-          limit,
-          offset
+  server.get(
+    "/api/v1/logs",
+    { schema: { tags: ["Logs"], summary: "Query logs with filters" } },
+    async (request, reply) => {
+      try {
+        const limit = request.query.limit ? parseInt(request.query.limit, 10) : 100;
+        const offset = request.query.offset ? parseInt(request.query.offset, 10) : 0;
+        const query = {
+          level: request.query.level,
+          source: request.query.plugin,
+          from: request.query.from ? new Date(request.query.from).getTime() : void 0,
+          to: request.query.to ? new Date(request.query.to).getTime() : void 0
+        };
+        let result;
+        if (request.query.search) {
+          result = await platform.logs.search(request.query.search, {
+            limit,
+            offset
+          });
+        } else {
+          result = await platform.logs.query(query, {
+            limit,
+            offset
+          });
+        }
+        const frontendLogs = result.logs.map(toFrontendLogRecord);
+        const stats = await platform.logs.getStats();
+        return {
+          ok: true,
+          data: {
+            logs: frontendLogs,
+            total: result.total,
+            hasMore: result.hasMore,
+            filters: request.query,
+            source: "source" in result ? result.source : void 0,
+            stats: {
+              buffer: stats.buffer ? {
+                size: stats.buffer.size,
+                maxSize: stats.buffer.maxSize,
+                oldest: stats.buffer.oldestTimestamp ? new Date(stats.buffer.oldestTimestamp).toISOString() : void 0,
+                newest: stats.buffer.newestTimestamp ? new Date(stats.buffer.newestTimestamp).toISOString() : void 0
+              } : void 0,
+              persistence: stats.persistence ? {
+                totalLogs: stats.persistence.totalLogs,
+                oldestTimestamp: stats.persistence.oldestTimestamp ? new Date(
+                  stats.persistence.oldestTimestamp
+                ).toISOString() : void 0,
+                newestTimestamp: stats.persistence.newestTimestamp ? new Date(
+                  stats.persistence.newestTimestamp
+                ).toISOString() : void 0,
+                sizeBytes: stats.persistence.sizeBytes
+              } : void 0
+            }
+          }
+        };
+      } catch (error) {
+        return reply.code(503).send({
+          ok: false,
+          error: "Log query failed",
+          message: error instanceof Error ? error.message : "Unknown error"
         });
       }
-      const frontendLogs = result.logs.map(toFrontendLogRecord);
-      const stats = await platform.logs.getStats();
-      return {
-        ok: true,
-        data: {
-          logs: frontendLogs,
-          total: result.total,
-          hasMore: result.hasMore,
-          filters: request.query,
-          source: "source" in result ? result.source : void 0,
-          stats: {
-            buffer: stats.buffer ? {
-              size: stats.buffer.size,
-              maxSize: stats.buffer.maxSize,
-              oldest: stats.buffer.oldestTimestamp ? new Date(stats.buffer.oldestTimestamp).toISOString() : void 0,
-              newest: stats.buffer.newestTimestamp ? new Date(stats.buffer.newestTimestamp).toISOString() : void 0
-            } : void 0,
-            persistence: stats.persistence ? {
-              totalLogs: stats.persistence.totalLogs,
-              oldestTimestamp: stats.persistence.oldestTimestamp ? new Date(stats.persistence.oldestTimestamp).toISOString() : void 0,
-              newestTimestamp: stats.persistence.newestTimestamp ? new Date(stats.persistence.newestTimestamp).toISOString() : void 0,
-              sizeBytes: stats.persistence.sizeBytes
-            } : void 0
-          }
-        }
-      };
-    } catch (error) {
-      return reply.code(503).send({
-        ok: false,
-        error: "Log query failed",
-        message: error instanceof Error ? error.message : "Unknown error"
-      });
     }
-  });
+  );
   server.get(
     "/api/v1/logs/:id",
     { schema: { tags: ["Logs"], summary: "Get log entry by ID" } },
@@ -5212,7 +5308,12 @@ async function registerLogRoutes(server, config, eventHub) {
   );
   server.get(
     "/api/v1/logs/:id/related",
-    { schema: { tags: ["Logs"], summary: "Get logs related to a specific entry" } },
+    {
+      schema: {
+        tags: ["Logs"],
+        summary: "Get logs related to a specific entry"
+      }
+    },
     async (request, reply) => {
       try {
         const log = await platform.logs.getById(request.params.id);
@@ -5241,202 +5342,223 @@ async function registerLogRoutes(server, config, eventHub) {
       }
     }
   );
-  server.get("/api/v1/logs/stream", { schema: { hide: true } }, async (request, reply) => {
-    const caps = platform.logs.getCapabilities();
-    if (!caps.hasStreaming) {
-      return reply.code(503).send({
-        error: "Log streaming not enabled",
-        message: "Logger adapter does not support streaming. Enable logRingBuffer in kb.config.json"
-      });
-    }
-    reply.hijack();
-    let streamClosed = false;
-    const origin = request.headers.origin;
-    if (origin === "http://localhost:3000" || origin === "http://localhost:5173") {
-      reply.raw.setHeader("Access-Control-Allow-Origin", origin);
-      reply.raw.setHeader("Access-Control-Allow-Credentials", "true");
-    } else {
-      reply.raw.setHeader("Access-Control-Allow-Origin", "*");
-    }
-    reply.raw.setHeader("Content-Type", "text/event-stream");
-    reply.raw.setHeader("Cache-Control", "no-cache, no-transform");
-    reply.raw.setHeader("Connection", "keep-alive");
-    try {
-      reply.raw.flushHeaders?.();
-      reply.raw.write(": connected\n\n");
-    } catch (err) {
-      streamClosed = true;
-      return;
-    }
-    const unsubscribe = platform.logs.subscribe((log) => {
-      if (!streamClosed && !reply.raw.writableEnded && !reply.raw.destroyed) {
-        try {
-          const frontendLog = toFrontendLogRecord(log);
-          reply.raw.write(`event: log
+  server.get(
+    "/api/v1/logs/stream",
+    { schema: { hide: true } },
+    async (request, reply) => {
+      const caps = platform.logs.getCapabilities();
+      if (!caps.hasStreaming) {
+        return reply.code(503).send({
+          error: "Log streaming not enabled",
+          message: "Logger adapter does not support streaming. Enable logRingBuffer in kb.config.json"
+        });
+      }
+      reply.hijack();
+      let streamClosed = false;
+      const origin = request.headers.origin;
+      if (origin === "http://localhost:3000" || origin === "http://localhost:5173") {
+        reply.raw.setHeader("Access-Control-Allow-Origin", origin);
+        reply.raw.setHeader("Access-Control-Allow-Credentials", "true");
+      } else {
+        reply.raw.setHeader("Access-Control-Allow-Origin", "*");
+      }
+      reply.raw.setHeader("Content-Type", "text/event-stream");
+      reply.raw.setHeader("Cache-Control", "no-cache, no-transform");
+      reply.raw.setHeader("Connection", "keep-alive");
+      try {
+        reply.raw.flushHeaders?.();
+        reply.raw.write(": connected\n\n");
+      } catch (err) {
+        streamClosed = true;
+        return;
+      }
+      const unsubscribe = platform.logs.subscribe((log) => {
+        if (!streamClosed && !reply.raw.writableEnded && !reply.raw.destroyed) {
+          try {
+            const frontendLog = toFrontendLogRecord(log);
+            reply.raw.write(`event: log
 `);
-          reply.raw.write(`data: ${JSON.stringify(frontendLog)}
+            reply.raw.write(`data: ${JSON.stringify(frontendLog)}
 
 `);
-        } catch (err) {
-          streamClosed = true;
-        }
-      }
-    });
-    const cleanup = () => {
-      if (!streamClosed) {
-        streamClosed = true;
-        unsubscribe();
-        try {
-          if (!reply.raw.writableEnded && !reply.raw.destroyed) {
-            reply.raw.end();
+          } catch (err) {
+            streamClosed = true;
           }
-        } catch (err) {
         }
-      }
-    };
-    request.raw.on("close", cleanup);
-    request.raw.on("error", cleanup);
-    await new Promise(() => {
-    });
-  });
-  server.get("/api/v1/logs/stats", { schema: { tags: ["Logs"], summary: "Get log storage statistics" } }, async (request, reply) => {
-    try {
-      const stats = await platform.logs.getStats();
-      const caps = platform.logs.getCapabilities();
-      return {
-        ok: true,
-        data: {
-          capabilities: caps,
-          buffer: stats.buffer ? {
-            size: stats.buffer.size,
-            maxSize: stats.buffer.maxSize,
-            oldest: stats.buffer.oldestTimestamp ? new Date(stats.buffer.oldestTimestamp).toISOString() : void 0,
-            newest: stats.buffer.newestTimestamp ? new Date(stats.buffer.newestTimestamp).toISOString() : void 0
-          } : void 0,
-          persistence: stats.persistence ? {
-            totalLogs: stats.persistence.totalLogs,
-            oldest: stats.persistence.oldestTimestamp ? new Date(stats.persistence.oldestTimestamp).toISOString() : void 0,
-            newest: stats.persistence.newestTimestamp ? new Date(stats.persistence.newestTimestamp).toISOString() : void 0,
-            sizeBytes: stats.persistence.sizeBytes
-          } : void 0
+      });
+      const cleanup = () => {
+        if (!streamClosed) {
+          streamClosed = true;
+          unsubscribe();
+          try {
+            if (!reply.raw.writableEnded && !reply.raw.destroyed) {
+              reply.raw.end();
+            }
+          } catch (err) {
+          }
         }
       };
-    } catch (error) {
-      return reply.code(500).send({
-        ok: false,
-        error: "Failed to fetch stats",
-        message: error instanceof Error ? error.message : "Unknown error"
+      request.raw.on("close", cleanup);
+      request.raw.on("error", cleanup);
+      await new Promise(() => {
       });
     }
-  });
-  server.post("/api/v1/logs/summarize", { schema: { tags: ["Logs"], summary: "AI-powered log summarization" } }, async (request, reply) => {
-    const { timeRange, filters, groupBy, question, includeContext } = request.body;
-    try {
-      const query = {
-        level: filters?.level,
-        source: filters?.plugin,
-        from: timeRange?.from ? new Date(timeRange.from).getTime() : void 0,
-        to: timeRange?.to ? new Date(timeRange.to).getTime() : void 0
-      };
-      const result = await platform.logs.query(query, { limit: 1e3 });
-      const frontendLogs = result.logs.map(toFrontendLogRecord);
-      let filteredLogs = frontendLogs;
-      if (filters?.traceId) {
-        filteredLogs = filteredLogs.filter((log) => log.traceId === filters.traceId);
-      }
-      if (filters?.executionId) {
-        filteredLogs = filteredLogs.filter((log) => log.executionId === filters.executionId);
-      }
-      const stats = {
-        total: filteredLogs.length,
-        byLevel: {},
-        byPlugin: {},
-        topErrors: [],
-        timeRange: {
-          from: filteredLogs.length > 0 ? filteredLogs[0].time : null,
-          to: filteredLogs.length > 0 ? filteredLogs[filteredLogs.length - 1].time : null
+  );
+  server.get(
+    "/api/v1/logs/stats",
+    { schema: { tags: ["Logs"], summary: "Get log storage statistics" } },
+    async (request, reply) => {
+      try {
+        const stats = await platform.logs.getStats();
+        const caps = platform.logs.getCapabilities();
+        return {
+          ok: true,
+          data: {
+            capabilities: caps,
+            buffer: stats.buffer ? {
+              size: stats.buffer.size,
+              maxSize: stats.buffer.maxSize,
+              oldest: stats.buffer.oldestTimestamp ? new Date(stats.buffer.oldestTimestamp).toISOString() : void 0,
+              newest: stats.buffer.newestTimestamp ? new Date(stats.buffer.newestTimestamp).toISOString() : void 0
+            } : void 0,
+            persistence: stats.persistence ? {
+              totalLogs: stats.persistence.totalLogs,
+              oldest: stats.persistence.oldestTimestamp ? new Date(stats.persistence.oldestTimestamp).toISOString() : void 0,
+              newest: stats.persistence.newestTimestamp ? new Date(stats.persistence.newestTimestamp).toISOString() : void 0,
+              sizeBytes: stats.persistence.sizeBytes
+            } : void 0
+          }
+        };
+      } catch (error) {
+        return reply.code(500).send({
+          ok: false,
+          error: "Failed to fetch stats",
+          message: error instanceof Error ? error.message : "Unknown error"
+        });
+      }
+    }
+  );
+  server.post(
+    "/api/v1/logs/summarize",
+    { schema: { tags: ["Logs"], summary: "AI-powered log summarization" } },
+    async (request, reply) => {
+      const { timeRange, filters, groupBy, question, includeContext } = request.body;
+      try {
+        const query = {
+          level: filters?.level,
+          source: filters?.plugin,
+          from: timeRange?.from ? new Date(timeRange.from).getTime() : void 0,
+          to: timeRange?.to ? new Date(timeRange.to).getTime() : void 0
+        };
+        const result = await platform.logs.query(query, { limit: 1e3 });
+        const frontendLogs = result.logs.map(toFrontendLogRecord);
+        let filteredLogs = frontendLogs;
+        if (filters?.traceId) {
+          filteredLogs = filteredLogs.filter(
+            (log) => log.traceId === filters.traceId
+          );
         }
-      };
-      const errorMessages = /* @__PURE__ */ new Map();
-      for (const log of filteredLogs) {
-        stats.byLevel[log.level] = (stats.byLevel[log.level] || 0) + 1;
-        if (log.plugin) {
-          stats.byPlugin[log.plugin] = (stats.byPlugin[log.plugin] || 0) + 1;
-        }
-        if (log.level === "error" && log.msg) {
-          errorMessages.set(log.msg, (errorMessages.get(log.msg) || 0) + 1);
-        }
-      }
-      stats.topErrors = Array.from(errorMessages.entries()).map(([message2, count]) => ({ message: message2, count })).sort((a, b) => b.count - a.count).slice(0, 10);
-      let groups = null;
-      if (groupBy) {
-        const fieldMap = {
-          trace: "traceId",
-          execution: "executionId",
-          plugin: "plugin"
+        if (filters?.executionId) {
+          filteredLogs = filteredLogs.filter(
+            (log) => log.executionId === filters.executionId
+          );
+        }
+        const stats = {
+          total: filteredLogs.length,
+          byLevel: {},
+          byPlugin: {},
+          topErrors: [],
+          timeRange: {
+            from: filteredLogs.length > 0 ? filteredLogs[0].time : null,
+            to: filteredLogs.length > 0 ? filteredLogs[filteredLogs.length - 1].time : null
+          }
         };
-        const groupMap = /* @__PURE__ */ new Map();
+        const errorMessages = /* @__PURE__ */ new Map();
         for (const log of filteredLogs) {
-          const fieldName = fieldMap[groupBy] || groupBy;
-          const key = String(log[fieldName] || "unknown");
-          if (!groupMap.has(key)) {
-            groupMap.set(key, []);
+          stats.byLevel[log.level] = (stats.byLevel[log.level] || 0) + 1;
+          if (log.plugin) {
+            stats.byPlugin[log.plugin] = (stats.byPlugin[log.plugin] || 0) + 1;
+          }
+          if (log.level === "error" && log.msg) {
+            errorMessages.set(log.msg, (errorMessages.get(log.msg) || 0) + 1);
           }
-          groupMap.get(key).push(log);
         }
-        groups = Object.fromEntries(groupMap.entries());
-      }
-      let aiSummary = null;
-      let message = null;
-      if (platform.llm && question) {
-        try {
-          const context = includeContext || {
-            errors: true,
-            warnings: true,
-            info: false,
-            metadata: true,
-            stackTraces: true
+        stats.topErrors = Array.from(errorMessages.entries()).map(([message2, count]) => ({ message: message2, count })).sort((a, b) => b.count - a.count).slice(0, 10);
+        let groups = null;
+        if (groupBy) {
+          const fieldMap = {
+            trace: "traceId",
+            execution: "executionId",
+            plugin: "plugin"
           };
-          const prompt = buildLogSummaryPrompt(question, filteredLogs, stats, context);
-          const response = await platform.llm.complete(prompt, {
-            temperature: 0.7,
-            maxTokens: 1e3,
-            systemPrompt: "You are a technical log analysis assistant. Provide clear, actionable insights based on application logs."
-          });
-          aiSummary = response.content.trim();
-        } catch (error) {
-          platform.logger.warn("LLM summarization failed, using fallback", {
-            error: error instanceof Error ? error.message : String(error)
-          });
+          const groupMap = /* @__PURE__ */ new Map();
+          for (const log of filteredLogs) {
+            const fieldName = fieldMap[groupBy] || groupBy;
+            const key = String(log[fieldName] || "unknown");
+            if (!groupMap.has(key)) {
+              groupMap.set(key, []);
+            }
+            groupMap.get(key).push(log);
+          }
+          groups = Object.fromEntries(groupMap.entries());
+        }
+        let aiSummary = null;
+        let message = null;
+        if (platform.llm && question) {
+          try {
+            const context = includeContext || {
+              errors: true,
+              warnings: true,
+              info: false,
+              metadata: true,
+              stackTraces: true
+            };
+            const prompt = buildLogSummaryPrompt(
+              question,
+              filteredLogs,
+              stats,
+              context
+            );
+            const response = await platform.llm.complete(prompt, {
+              temperature: 0.7,
+              maxTokens: 1e3,
+              systemPrompt: "You are a technical log analysis assistant. Provide clear, actionable insights based on application logs."
+            });
+            aiSummary = response.content.trim();
+          } catch (error) {
+            platform.logger.warn("LLM summarization failed, using fallback", {
+              error: error instanceof Error ? error.message : String(error)
+            });
+            aiSummary = generateFallbackSummary(stats, filteredLogs);
+            message = "AI summarization unavailable, showing statistical summary";
+          }
+        } else {
           aiSummary = generateFallbackSummary(stats, filteredLogs);
-          message = "AI summarization unavailable, showing statistical summary";
+          message = platform.llm ? "No question provided" : "LLM not configured";
         }
-      } else {
-        aiSummary = generateFallbackSummary(stats, filteredLogs);
-        message = platform.llm ? "No question provided" : "LLM not configured";
+        return {
+          ok: true,
+          data: {
+            summary: {
+              question: question || "General log summary",
+              timeRange: stats.timeRange,
+              total: stats.total,
+              stats,
+              groups
+            },
+            aiSummary,
+            message
+          }
+        };
+      } catch (error) {
+        return reply.code(500).send({
+          ok: false,
+          error: "Log summarization failed",
+          message: error instanceof Error ? error.message : "Unknown error"
+        });
       }
-      return {
-        ok: true,
-        data: {
-          summary: {
-            question: question || "General log summary",
-            timeRange: stats.timeRange,
-            total: stats.total,
-            stats,
-            groups
-          },
-          aiSummary,
-          message
-        }
-      };
-    } catch (error) {
-      return reply.code(500).send({
-        ok: false,
-        error: "Log summarization failed",
-        message: error instanceof Error ? error.message : "Unknown error"
-      });
     }
-  });
+  );
 }
 var SENSITIVE_KEYS = [
   "apiKey",
@@ -5447,10 +5569,10 @@ var SENSITIVE_KEYS = [
   "credentials",
   "auth"
 ];
-function redactSensitiveData(obj, redacted = [], path3 = "") {
+function redactSensitiveData(obj, redacted = [], path2 = "") {
   const result = {};
   for (const [key, value] of Object.entries(obj)) {
-    const currentPath = path3 ? `${path3}.${key}` : key;
+    const currentPath = path2 ? `${path2}.${key}` : key;
     const lowerKey = key.toLowerCase();
     const isSensitive = SENSITIVE_KEYS.some((pattern) => lowerKey.includes(pattern.toLowerCase()));
     if (isSensitive && typeof value === "string") {
@@ -5492,8 +5614,8 @@ async function loadPlatformConfig(repoRoot) {
 async function registerPlatformRoutes(fastify, config, repoRoot) {
   const basePath = normalizeBasePath(config.basePath);
   const configPaths = resolvePaths(basePath, "/platform/config");
-  for (const path3 of configPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of configPaths) {
+    fastify.get(path2, async (_request, reply) => {
       try {
         const { adapters, adapterOptions, execution } = await restDomainOperationMetrics.observeOperation(
           "platform.config.get",
@@ -5692,8 +5814,8 @@ function registerRouteCollector(fastify) {
 async function registerDebugRoutes(fastify, config) {
   const basePath = normalizeBasePath(config.basePath);
   const routesPaths = resolvePaths(basePath, "/routes");
-  for (const path3 of routesPaths) {
-    fastify.get(path3, async (_request, reply) => {
+  for (const path2 of routesPaths) {
+    fastify.get(path2, async (_request, reply) => {
       let routes = collectedRoutes.filter((r) => r.url.startsWith("/api/"));
       if (routes.length === 0) {
         routes = [...collectedRoutes];
@@ -6101,20 +6223,18 @@ function registerRequestIdMiddleware(server) {
     request.id = requestId;
     reply.header("X-Request-Id", requestId);
     reply.header("X-Trace-Id", traceId);
-    request.kbLogger = createCorrelatedLogger(platform.logger, {
+    const logger = createHttpLogger(platform.logger, {
       serviceId: "rest",
-      logsSource: "rest",
-      layer: "rest",
-      service: "request",
+      layer: "service",
+      component: "http-request",
       requestId,
       traceId,
       method: request.method,
       url: request.url,
       operation: "http.request"
     });
-    const method = request.method.toUpperCase();
-    const fullUrl = request.url;
-    request.kbLogger.info(`\u2192 ${method} ${fullUrl}`);
+    request.kbLogger = logger;
+    logger.debug("HTTP request started");
   });
 }
 
@@ -6429,41 +6549,40 @@ async function createServer(config, repoRoot, registry) {
 }
 var registryInstance = null;
 var metricsCollector2 = null;
-async function findMonorepoRoot(startDir) {
-  let dir = path.resolve(startDir);
-  while (true) {
-    const hasWorkspace = await promises.access(path.join(dir, "pnpm-workspace.yaml")).then(() => true).catch(() => false);
-    if (hasWorkspace) {
-      return dir;
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) {
-      break;
-    }
-    dir = parent;
-  }
-  return findRepoRoot(startDir);
-}
 async function bootstrap(cwd = process.cwd()) {
-  const repoRoot = await findMonorepoRoot(cwd);
-  loadEnvFromRoot(repoRoot);
-  const { config, diagnostics } = await loadRestApiConfig(cwd);
-  await createServiceBootstrap({ appId: "rest-api", repoRoot, assemblyHook: makeAssemblyHook() });
+  await runService({
+    appId: "rest-api",
+    serviceId: "rest",
+    startDir: cwd,
+    defaultPort: 5050,
+    portEnvVar: "REST_API_PORT",
+    defaultHost: "0.0.0.0",
+    hostEnvVar: "REST_API_HOST",
+    platform: {
+      assemblyHook: makeAssemblyHook()
+    },
+    setup: startRestApi
+  });
+}
+async function startRestApi({
+  platform: platform16,
+  projectRoot: repoRoot,
+  platformRoot,
+  logger: serviceLogger
+}) {
+  const { config, diagnostics } = await loadRestApiConfig(repoRoot);
   const startupRequestId = `rest-startup-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
   const startupTraceId = randomUUID();
   const startupSpanId = randomUUID();
-  const bootstrapLogger = platform.logger.child({
-    layer: "rest",
-    service: "bootstrap",
+  const bootstrapLogger = serviceLogger.forComponent("rest-bootstrap").forOperation("rest.bootstrap", {
     requestId: startupRequestId,
-    reqId: startupRequestId,
     traceId: startupTraceId,
-    spanId: startupSpanId,
-    invocationId: startupSpanId,
-    executionId: startupSpanId
-  });
+    spanId: startupSpanId
+  }).with({ invocationId: startupSpanId, executionId: startupSpanId });
   if (diagnostics.length > 0) {
-    bootstrapLogger.warn("Configuration diagnostics", { diagnosticsCount: diagnostics.length });
+    bootstrapLogger.warn("Configuration diagnostics", {
+      diagnosticsCount: diagnostics.length
+    });
     for (const diagnostic of diagnostics) {
       bootstrapLogger.warn("Configuration diagnostic", {
         level: diagnostic.level,
@@ -6471,22 +6590,28 @@ async function bootstrap(cwd = process.cwd()) {
       });
     }
   }
-  bootstrapLogger.info("Resolved repo root", { cwd, repoRoot });
+  bootstrapLogger.info("Resolved service roots", {
+    projectRoot: repoRoot,
+    platformRoot
+  });
   bootstrapLogger.info("Platform adapters initialized");
   bootstrapLogger.info("Initializing entity registry");
   const isDevelopment = process.env.NODE_ENV !== "production";
   const snapshotTTL = isDevelopment ? 10 * 60 * 1e3 : 60 * 60 * 1e3;
-  const platformRoot = getPlatformRoot();
   const registryInitStart = performance.now();
   const registry = await createRegistry({
     root: repoRoot,
     platformRoot: platformRoot !== repoRoot ? platformRoot : void 0,
     cache: {
       ttlMs: snapshotTTL,
-      adapter: platform.cache
+      adapter: platform16.cache
     }
   });
-  restDomainOperationMetrics.recordOperation("registry.init", performance.now() - registryInitStart, "ok");
+  restDomainOperationMetrics.recordOperation(
+    "registry.init",
+    performance.now() - registryInitStart,
+    "ok"
+  );
   const plugins = registry.listPlugins();
   bootstrapLogger.info("Entity registry initialized", {
     pluginsFound: plugins.length,
@@ -6503,9 +6628,12 @@ async function bootstrap(cwd = process.cwd()) {
   });
   const server = await createServer(config, repoRoot, registry);
   bootstrapLogger.info("Starting system metrics collector");
-  metricsCollector2 = new SystemMetricsCollector("rest", () => metricsCollector.getActiveRequests());
+  metricsCollector2 = new SystemMetricsCollector(
+    "rest",
+    () => metricsCollector.getActiveRequests()
+  );
   await metricsCollector2.start(1e4, 6e4);
-  const restTransport = platform.getAdapter("serviceTransport");
+  const restTransport = platform16.getAdapter("serviceTransport");
   const restAddr = restTransport?.listenAddress?.("rest");
   const listenPort = restAddr && "port" in restAddr ? restAddr.port : config.port;
   const restAddrHost = restAddr && "host" in restAddr ? restAddr.host : void 0;
@@ -6522,20 +6650,15 @@ async function bootstrap(cwd = process.cwd()) {
       await registryInstance.dispose();
       registryInstance = null;
     }
-    await platform.shutdown();
-    bootstrapLogger.info("Platform shutdown complete");
     await server.close();
     bootstrapLogger.info("Server closed");
-    process.exit(0);
   };
-  process.on("SIGTERM", () => shutdown("SIGTERM"));
-  process.on("SIGINT", () => shutdown("SIGINT"));
+  return () => shutdown("service-runner");
 }
 
 // src/index.ts
-bootstrap(process.cwd()).catch((error) => {
-  console.error("Failed to start server:", error);
-  process.exit(1);
+bootstrap(process.cwd()).catch(() => {
+  process.exitCode = 1;
 });
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map