bopodev-api 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bopodev-api",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "license": "MIT",
   "type": "module",
   "files": [
@@ -15,9 +15,9 @@
     "nanoid": "^5.1.5",
     "ws": "^8.19.0",
     "zod": "^4.1.5",
-    "bopodev-agent-sdk": "0.1.2",
-    "bopodev-contracts": "0.1.2",
-    "bopodev-db": "0.1.2"
+    "bopodev-agent-sdk": "0.1.3",
+    "bopodev-contracts": "0.1.3",
+    "bopodev-db": "0.1.3"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",

package/src/server.ts

@@ -1,6 +1,8 @@
 import { createServer } from "node:http";
+import { sql } from "drizzle-orm";
 import { bootstrapDatabase } from "bopodev-db";
 import { checkRuntimeCommandHealth } from "bopodev-agent-sdk";
+import type { RuntimeCommandHealth } from "bopodev-agent-sdk";
 import { createApp } from "./app";
 import { loadGovernanceRealtimeSnapshot } from "./realtime/governance";
 import { loadOfficeSpaceRealtimeSnapshot } from "./realtime/office-space";
@@ -12,21 +14,35 @@ async function main() {
   const port = Number(process.env.PORT ?? 4020);
   const { db } = await bootstrapDatabase(dbPath);
   const codexCommand = process.env.BOPO_CODEX_COMMAND ?? "codex";
+  const skipCodexPreflight = process.env.BOPO_SKIP_CODEX_PREFLIGHT === "1";
+  const codexHealthRequired =
+    !skipCodexPreflight &&
+    (process.env.BOPO_REQUIRE_CODEX_HEALTH === "1" || (await hasCodexAgentsConfigured(db)));
   const getRuntimeHealth = async () => {
-    const codex = await checkRuntimeCommandHealth(codexCommand, {
-      timeoutMs: 5_000
-    });
+    const codex = codexHealthRequired
+      ? await checkRuntimeCommandHealth(codexCommand, {
+          timeoutMs: 5_000
+        })
+      : {
+          command: codexCommand,
+          available: skipCodexPreflight ? false : true,
+          exitCode: null,
+          elapsedMs: 0,
+          error: skipCodexPreflight
+            ? "Skipped by configuration: BOPO_SKIP_CODEX_PREFLIGHT=1."
+            : "Skipped: no Codex agents configured."
+        };
     return {
       codex
     };
   };
-  const startupCodexHealth = await checkRuntimeCommandHealth(codexCommand, {
-    timeoutMs: 5_000
-  });
-  const suppressStartupWarnings = process.env.BOPO_SUPPRESS_STARTUP_WARNINGS === "1";
-  if (!startupCodexHealth.available && !suppressStartupWarnings) {
-    // eslint-disable-next-line no-console
-    console.warn("[startup] Codex command preflight failed.", startupCodexHealth);
+  if (codexHealthRequired) {
+    const startupCodexHealth = await checkRuntimeCommandHealth(codexCommand, {
+      timeoutMs: 5_000
+    });
+    if (!startupCodexHealth.available) {
+      emitCodexPreflightWarning(startupCodexHealth);
+    }
   }
 
   const server = createServer();
@@ -50,3 +66,27 @@ async function main() {
 }
 
 void main();
+
+async function hasCodexAgentsConfigured(db: Awaited<ReturnType<typeof bootstrapDatabase>>["db"]) {
+  const result = await db.execute(sql`
+    SELECT id
+    FROM agents
+    WHERE provider_type = 'codex'
+    LIMIT 1
+  `);
+  return (result.rows ?? []).length > 0;
+}
+
+function emitCodexPreflightWarning(health: RuntimeCommandHealth) {
+  const red = process.stderr.isTTY ? "\x1b[31m" : "";
+  const yellow = process.stderr.isTTY ? "\x1b[33m" : "";
+  const reset = process.stderr.isTTY ? "\x1b[0m" : "";
+  const symbol = `${red}✖${reset}`;
+  process.stderr.write(
+    `${symbol} ${yellow}Codex preflight failed${reset}: command '${health.command}' is unavailable.\n`
+  );
+  process.stderr.write(`  Install Codex CLI or set BOPO_SKIP_CODEX_PREFLIGHT=1 for local dev.\n`);
+  if (process.env.BOPO_VERBOSE_STARTUP_WARNINGS === "1") {
+    process.stderr.write(`  Details: ${JSON.stringify(health)}\n`);
+  }
+}