bopodev-api 0.1.28 → 0.1.30

package/src/startup/runtime-health.ts

@@ -0,0 +1,128 @@
+import { agents, eq } from "bopodev-db";
+import { checkRuntimeCommandHealth } from "bopodev-agent-sdk";
+import type { RuntimeCommandHealth } from "bopodev-agent-sdk";
+import type { BootstrappedDb } from "./database";
+
+type BopoDb = BootstrappedDb["db"];
+
+export async function hasCodexAgentsConfigured(db: BopoDb) {
+  const result = await db
+    .select({ id: agents.id })
+    .from(agents)
+    .where(eq(agents.providerType, "codex"))
+    .limit(1);
+  return result.length > 0;
+}
+
+export async function hasOpenCodeAgentsConfigured(db: BopoDb) {
+  const result = await db
+    .select({ id: agents.id })
+    .from(agents)
+    .where(eq(agents.providerType, "opencode"))
+    .limit(1);
+  return result.length > 0;
+}
+
+export 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`);
+  }
+}
+
+export function emitOpenCodePreflightWarning(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}OpenCode preflight failed${reset}: command '${health.command}' is unavailable.\n`
+  );
+  process.stderr.write(`  Install OpenCode CLI or set BOPO_SKIP_OPENCODE_PREFLIGHT=1 for local dev.\n`);
+  if (process.env.BOPO_VERBOSE_STARTUP_WARNINGS === "1") {
+    process.stderr.write(`  Details: ${JSON.stringify(health)}\n`);
+  }
+}
+
+export async function runStartupRuntimePreflights(options: {
+  codexHealthRequired: boolean;
+  openCodeHealthRequired: boolean;
+  codexCommand: string;
+  openCodeCommand: string;
+}) {
+  const { codexHealthRequired, openCodeHealthRequired, codexCommand, openCodeCommand } = options;
+  if (codexHealthRequired) {
+    const startupCodexHealth = await checkRuntimeCommandHealth(codexCommand, {
+      timeoutMs: 5_000
+    });
+    if (!startupCodexHealth.available) {
+      emitCodexPreflightWarning(startupCodexHealth);
+    }
+  }
+  if (openCodeHealthRequired) {
+    const startupOpenCodeHealth = await checkRuntimeCommandHealth(openCodeCommand, {
+      timeoutMs: 5_000
+    });
+    if (!startupOpenCodeHealth.available) {
+      emitOpenCodePreflightWarning(startupOpenCodeHealth);
+    }
+  }
+}
+
+export function buildGetRuntimeHealth(options: {
+  codexCommand: string;
+  openCodeCommand: string;
+  skipCodexPreflight: boolean;
+  skipOpenCodePreflight: boolean;
+  codexHealthRequired: boolean;
+  openCodeHealthRequired: boolean;
+}) {
+  const {
+    codexCommand,
+    openCodeCommand,
+    skipCodexPreflight,
+    skipOpenCodePreflight,
+    codexHealthRequired,
+    openCodeHealthRequired
+  } = options;
+
+  return async () => {
+    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."
+        };
+    const opencode = openCodeHealthRequired
+      ? await checkRuntimeCommandHealth(openCodeCommand, {
+          timeoutMs: 5_000
+        })
+      : {
+          command: openCodeCommand,
+          available: skipOpenCodePreflight ? false : true,
+          exitCode: null,
+          elapsedMs: 0,
+          error: skipOpenCodePreflight
+            ? "Skipped by configuration: BOPO_SKIP_OPENCODE_PREFLIGHT=1."
+            : "Skipped: no OpenCode agents configured."
+        };
+    return {
+      codex,
+      opencode
+    };
+  };
+}

package/src/startup/scheduler-config.ts

@@ -0,0 +1,39 @@
+import { asc, companies, eq } from "bopodev-db";
+import type { BootstrappedDb } from "./database";
+
+export async function resolveSchedulerCompanyId(
+  db: BootstrappedDb["db"],
+  configuredCompanyId: string | null
+) {
+  if (configuredCompanyId) {
+    const configured = await db
+      .select({ id: companies.id })
+      .from(companies)
+      .where(eq(companies.id, configuredCompanyId))
+      .limit(1);
+    if (configured.length > 0) {
+      return configuredCompanyId;
+    }
+    // eslint-disable-next-line no-console
+    console.warn(`[startup] BOPO_DEFAULT_COMPANY_ID='${configuredCompanyId}' was not found; using first available company.`);
+  }
+
+  const fallback = await db
+    .select({ id: companies.id })
+    .from(companies)
+    .orderBy(asc(companies.createdAt))
+    .limit(1);
+  const id = fallback[0]?.id;
+  return typeof id === "string" && id.length > 0 ? id : null;
+}
+
+export function shouldStartScheduler() {
+  const rawRole = (process.env.BOPO_SCHEDULER_ROLE ?? "auto").trim().toLowerCase();
+  if (rawRole === "off" || rawRole === "follower") {
+    return false;
+  }
+  if (rawRole === "leader" || rawRole === "auto") {
+    return true;
+  }
+  throw new Error(`Invalid BOPO_SCHEDULER_ROLE '${rawRole}'. Expected one of: auto, leader, follower, off.`);
+}

package/src/types/express.d.ts

@@ -0,0 +1,13 @@
+import type { RequestActor } from "./request-actor";
+
+declare global {
+  namespace Express {
+    interface Request {
+      actor?: RequestActor;
+      companyId?: string;
+      requestId?: string;
+    }
+  }
+}
+
+export {};

package/src/types/request-actor.ts

@@ -0,0 +1,6 @@
+export type RequestActor = {
+  type: "board" | "member" | "agent";
+  id: string;
+  companyIds: string[] | null;
+  permissions: string[];
+};

package/src/validation/issue-routes.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+
+export const createIssueSchema = z.object({
+  projectId: z.string().min(1),
+  parentIssueId: z.string().optional(),
+  title: z.string().min(1),
+  body: z.string().optional(),
+  metadata: z
+    .object({
+      delegatedHiringIntent: z
+        .object({
+          intentType: z.literal("agent_hiring_request"),
+          requestedRole: z.string().nullable().optional(),
+          requestedRoleKey: z.string().nullable().optional(),
+          requestedTitle: z.string().nullable().optional(),
+          requestedName: z.string().nullable().optional(),
+          requestedManagerAgentId: z.string().nullable().optional(),
+          requestedProviderType: z.string().nullable().optional(),
+          requestedRuntimeModel: z.string().nullable().optional(),
+          requestedCapabilities: z.string().max(4000).nullable().optional()
+        })
+        .optional()
+    })
+    .optional(),
+  status: z.enum(["todo", "in_progress", "blocked", "in_review", "done", "canceled"]).default("todo"),
+  priority: z.enum(["none", "low", "medium", "high", "urgent"]).default("none"),
+  assigneeAgentId: z.string().nullable().optional(),
+  goalIds: z.array(z.string().min(1)).default([]),
+  externalLink: z.string().max(2048).nullable().optional(),
+  labels: z.array(z.string()).default([]),
+  tags: z.array(z.string()).default([])
+});
+
+export const createIssueCommentSchema = z.object({
+  body: z.string().min(1),
+  recipients: z
+    .array(
+      z.object({
+        recipientType: z.enum(["agent", "board", "member"]),
+        recipientId: z.string().nullable().optional()
+      })
+    )
+    .default([]),
+  authorType: z.enum(["human", "agent", "system"]).optional(),
+  authorId: z.string().optional()
+});
+
+export const createIssueCommentLegacySchema = z.object({
+  issueId: z.string().min(1),
+  body: z.string().min(1),
+  recipients: z
+    .array(
+      z.object({
+        recipientType: z.enum(["agent", "board", "member"]),
+        recipientId: z.string().nullable().optional()
+      })
+    )
+    .default([]),
+  authorType: z.enum(["human", "agent", "system"]).optional(),
+  authorId: z.string().optional()
+});
+
+export const updateIssueCommentSchema = z.object({
+  body: z.string().min(1)
+});
+
+export const updateIssueSchema = z
+  .object({
+    projectId: z.string().min(1).optional(),
+    title: z.string().min(1).optional(),
+    body: z.string().nullable().optional(),
+    status: z.enum(["todo", "in_progress", "blocked", "in_review", "done", "canceled"]).optional(),
+    priority: z.enum(["none", "low", "medium", "high", "urgent"]).optional(),
+    assigneeAgentId: z.string().nullable().optional(),
+    goalIds: z.array(z.string().min(1)).optional(),
+    externalLink: z.string().max(2048).nullable().optional(),
+    labels: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional()
+  })
+  .refine((payload) => Object.keys(payload).length > 0, "At least one field must be provided.");