bopodev-api 0.1.28 → 0.1.30

package/src/services/heartbeat-service/cron.ts

@@ -0,0 +1,58 @@
+export function isHeartbeatDue(cronExpression: string, lastRunAt: Date | null, now: Date) {
+  const normalizedNow = truncateToMinute(now);
+  if (!matchesCronExpression(cronExpression, normalizedNow)) {
+    return false;
+  }
+  if (!lastRunAt) {
+    return true;
+  }
+  return truncateToMinute(lastRunAt).getTime() !== normalizedNow.getTime();
+}
+
+function truncateToMinute(date: Date) {
+  const clone = new Date(date);
+  clone.setSeconds(0, 0);
+  return clone;
+}
+
+function matchesCronExpression(expression: string, date: Date) {
+  const parts = expression.trim().split(/\s+/);
+  if (parts.length !== 5) {
+    return false;
+  }
+
+  const [minute, hour, dayOfMonth, month, dayOfWeek] = parts as [string, string, string, string, string];
+  return (
+    matchesCronField(minute, date.getMinutes(), 0, 59) &&
+    matchesCronField(hour, date.getHours(), 0, 23) &&
+    matchesCronField(dayOfMonth, date.getDate(), 1, 31) &&
+    matchesCronField(month, date.getMonth() + 1, 1, 12) &&
+    matchesCronField(dayOfWeek, date.getDay(), 0, 6)
+  );
+}
+
+function matchesCronField(field: string, value: number, min: number, max: number) {
+  return field.split(",").some((part) => matchesCronPart(part.trim(), value, min, max));
+}
+
+function matchesCronPart(part: string, value: number, min: number, max: number): boolean {
+  if (part === "*") {
+    return true;
+  }
+
+  const stepMatch = part.match(/^\*\/(\d+)$/);
+  if (stepMatch) {
+    const step = Number(stepMatch[1]);
+    return Number.isInteger(step) && step > 0 ? (value - min) % step === 0 : false;
+  }
+
+  const rangeMatch = part.match(/^(\d+)-(\d+)$/);
+  if (rangeMatch) {
+    const start = Number(rangeMatch[1]);
+    const end = Number(rangeMatch[2]);
+    return start <= value && value <= end;
+  }
+
+  const exact = Number(part);
+  return Number.isInteger(exact) && exact >= min && exact <= max && exact === value;
+}

package/src/services/heartbeat-service/heartbeat-realtime.ts

@@ -0,0 +1,28 @@
+import type { RealtimeHub } from "../../realtime/hub";
+import { createHeartbeatRunsRealtimeEvent } from "../../realtime/heartbeat-runs";
+
+export function publishHeartbeatRunStatus(
+  realtimeHub: RealtimeHub | undefined,
+  input: {
+    companyId: string;
+    runId: string;
+    status: "started" | "completed" | "failed" | "skipped";
+    message?: string | null;
+    startedAt?: Date;
+    finishedAt?: Date;
+  }
+) {
+  if (!realtimeHub) {
+    return;
+  }
+  realtimeHub.publish(
+    createHeartbeatRunsRealtimeEvent(input.companyId, {
+      type: "run.status.updated",
+      runId: input.runId,
+      status: input.status,
+      message: input.message ?? null,
+      startedAt: input.startedAt?.toISOString(),
+      finishedAt: input.finishedAt?.toISOString() ?? null
+    })
+  );
+}

package/src/services/heartbeat-service/heartbeat-run-summary-text.ts

@@ -0,0 +1,53 @@
+const AGENT_COMMENT_EMOJI_REGEX = /[\p{Extended_Pictographic}\uFE0F\u200D]/gu;
+
+export function sanitizeAgentSummaryCommentBody(body: string) {
+  const sanitized = body.replace(AGENT_COMMENT_EMOJI_REGEX, "").trim();
+  return sanitized.length > 0 ? sanitized : "Run update.";
+}
+
+function extractSummaryFromJsonLikeText(input: string) {
+  const fencedMatch = input.match(/```(?:json)?\s*([\s\S]*?)```/i);
+  const candidate = fencedMatch?.[1]?.trim() ?? input.match(/\{[\s\S]*\}\s*$/)?.[0]?.trim();
+  if (!candidate) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(candidate) as Record<string, unknown>;
+    const summary = parsed.summary;
+    if (typeof summary === "string" && summary.trim().length > 0) {
+      return summary.trim();
+    }
+  } catch {
+    // Fall through to regex extraction for loosely-formatted JSON.
+  }
+  const summaryMatch = candidate.match(/"summary"\s*:\s*"([\s\S]*?)"/);
+  const summary = summaryMatch?.[1]
+    ?.replace(/\\"/g, "\"")
+    .replace(/\\n/g, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+  return summary && summary.length > 0 ? summary : null;
+}
+
+export function extractNaturalRunUpdate(executionSummary: string) {
+  const normalized = executionSummary.trim();
+  const jsonSummary = extractSummaryFromJsonLikeText(normalized);
+  const source = jsonSummary ?? normalized;
+  const lines = source
+    .split("\n")
+    .map((line) => line.trim())
+    .filter((line) => line.length > 0)
+    .filter((line) => !line.startsWith("{") && !line.startsWith("}"));
+  const compact = (lines.length > 0 ? lines.slice(0, 2).join(" ") : source)
+    .replace(/^run (failure )?summary\s*:\s*/i, "")
+    .replace(/^completed all assigned issue steps\s*:\s*/i, "")
+    .replace(/^issue status\s*:\s*/i, "")
+    .replace(/`+/g, "")
+    .replace(/\s+/g, " ")
+    .trim();
+  const bounded = compact.length > 260 ? `${compact.slice(0, 257).trimEnd()}...` : compact;
+  if (!bounded) {
+    return "Run update.";
+  }
+  return /[.!?]$/.test(bounded) ? bounded : `${bounded}.`;
+}