AI-powered virtual executive team — a single coherent executive persona backed by 8 specialist agents (FastAPI + Next.js).
/**
* A department's recurring check-in as a plain choice: every day, every week
* on a given day, or off — the picker on a department's settings. The backend
* stores a cadence spec (departments/cadence.py), always in UTC:
* `daily@HH:MM`, `weekly@DOW@HH:MM` (or `weekly@DOW-HH:MM`), or an empty
* string for off. Any other spec (a quarterly one, say) is kept as "custom"
* so opening and saving the settings never rewrites it.
*/
export type Weekday = "mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun";
export type CheckInChoice =
| { kind: "daily"; time: string }
| { kind: "weekly"; day: Weekday; time: string }
| { kind: "off" }
| { kind: "custom"; spec: string };
export const WEEKDAYS: { id: Weekday; label: string }[] = [
{ id: "mon", label: "Monday" },
{ id: "tue", label: "Tuesday" },
{ id: "wed", label: "Wednesday" },
{ id: "thu", label: "Thursday" },
{ id: "fri", label: "Friday" },
{ id: "sat", label: "Saturday" },
{ id: "sun", label: "Sunday" },
];
/** What a new department starts with (DEFAULT_CHECK_IN_CADENCE). */
export const DEFAULT_CHECK_IN_DAY: Weekday = "mon";
export const DEFAULT_CHECK_IN_TIME = "09:00";
const TIME_RE = /^([01]\d|2[0-3]):[0-5]\d$/;
const DAILY_RE = /^daily@(\d{2}:\d{2})$/;
const WEEKLY_RE = /^weekly@([A-Za-z]{3})[@-](\d{2}:\d{2})$/;
function isWeekday(v: string): v is Weekday {
return WEEKDAYS.some((d) => d.id === v);
}
/** Read a stored spec (missing or blank means off). */
export function parseCheckIn(spec: string | null | undefined): CheckInChoice {
const raw = (spec ?? "").trim();
if (!raw) return { kind: "off" };
const daily = DAILY_RE.exec(raw);
if (daily && TIME_RE.test(daily[1])) return { kind: "daily", time: daily[1] };
const weekly = WEEKLY_RE.exec(raw);
if (weekly) {
const day = weekly[1].toLowerCase();
if (isWeekday(day) && TIME_RE.test(weekly[2])) {
return { kind: "weekly", day, time: weekly[2] };
}
}
return { kind: "custom", spec: raw };
}
/** The spec to save for a choice. Off is the empty spec. */
export function checkInSpec(choice: CheckInChoice): string {
switch (choice.kind) {
case "daily":
return `daily@${choice.time}`;
case "weekly":
return `weekly@${choice.day}@${choice.time}`;
case "off":
return "";
case "custom":
return choice.spec;
}
}
/** Switch to another kind, keeping the time (and day) already picked. */
export function withKind(
choice: CheckInChoice,
kind: "daily" | "weekly" | "off",
): CheckInChoice {
const time = "time" in choice ? choice.time : DEFAULT_CHECK_IN_TIME;
if (kind === "daily") return { kind, time };
if (kind === "weekly") {
return { kind, day: choice.kind === "weekly" ? choice.day : DEFAULT_CHECK_IN_DAY, time };
}
return { kind: "off" };
}
/** The choice in words, for the settings summary. */
export function describeCheckIn(choice: CheckInChoice): string {
switch (choice.kind) {
case "daily":
return `Every day at ${choice.time} UTC`;
case "weekly": {
const day = WEEKDAYS.find((d) => d.id === choice.day)?.label ?? choice.day;
return `Every ${day} at ${choice.time} UTC`;
}
case "off":
return "Off";
case "custom":
return choice.spec;
}
}
/**
* The queued next check-in as a short local date and time, e.g.
* "Mon 20 Oct, 09:00". Empty for a missing or unreadable timestamp.
*/
export function formatNextCheckIn(
iso: string | null | undefined,
timeZone?: string | null,
locale?: string,
): string {
if (!iso) return "";
const at = new Date(iso);
if (!Number.isFinite(at.getTime())) return "";
try {
return at.toLocaleString(locale, {
weekday: "short",
day: "numeric",
month: "short",
hour: "2-digit",
minute: "2-digit",
...(timeZone ? { timeZone } : {}),
});
} catch {
// An unknown zone name: fall back to the browser's own.
return at.toLocaleString(locale, {
weekday: "short",
day: "numeric",
month: "short",
hour: "2-digit",
minute: "2-digit",
});
}
}