refactor: address code review feedback - improve docs and type safety

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

api/index.ts

@@ -47,6 +47,9 @@ let bootstrapPromise: Promise<void> | null = null;
  * Minimal plugin that exposes our Hono app as the `http.server` service.
  * ObjectOS plugins call `context.getService('http.server').getRawApp()`
  * to register their HTTP routes.
+ *
+ * Only `getRawApp()` and `app` are used by ObjectOS plugins; the
+ * remaining stubs satisfy the IHttpServer shape expected by the kernel.
  */
 function createHttpServicePlugin(honoApp: Hono): Plugin {
   return {
@@ -72,7 +75,7 @@ function createHttpServicePlugin(honoApp: Hono): Plugin {
     },
     async start() {},
     async destroy() {},
-  } as unknown as Plugin;
+  } as Plugin;
 }
 
 async function bootstrapKernel(): Promise<void> {

apps/web/src/main.tsx

@@ -14,10 +14,14 @@ const queryClient = new QueryClient({
   },
 });
 
+// BASE_URL is set by Vite based on the `base` config:
+// Vercel → "/" (stripped to ""), Local → "/console/" (stripped to "/console")
+const basename = import.meta.env.BASE_URL.replace(/\/+$/, '');
+
 createRoot(document.getElementById('root')!).render(
   <StrictMode>
     <QueryClientProvider client={queryClient}>
-      <BrowserRouter basename={import.meta.env.BASE_URL.replace(/\/+$/, '')}>
+      <BrowserRouter basename={basename}>
         <App />
       </BrowserRouter>
     </QueryClientProvider>