src/portal-maintenance.ts

Functions

Imports

It imports src/env.ts, src/maintenance.ts, src/ops-feed.ts, src/ops-types/views.ts, src/portal-auth.ts, src/roster.ts. Imported by src/routes.ts.

Source

1import type { Env } from "./env";
2import { ROSTER } from "./roster";
3import { readMaintenance } from "./maintenance";
4import { OPS_RETURN_TO } from "./ops-feed";
5import type { PortalMaintenance } from "./ops-types/views";
6import { portalGate } from "./portal-auth";
7
8// The Portal's Maintenance list: GET /portal/api/maintenance (job_549550d73d4e). The list
9// the daily maintenance pass stored, the same one capsid_run_improve action status serves per namespace, so
10// the Portal and chat cannot disagree. It reads KV only and runs nothing: the pass runs on
11// the five-minute tick once a day. A route, not a tool, so no grant is checked here
12// (one enforcement point, test/route-gates.test.ts): it answers to portalGate, and src/scope.ts lists
13// it among the routes gated some other way.
14
15export const PORTAL_MAINTENANCE_PATH = "/portal/api/maintenance";
16
17const sum = (counts: Record<string, number>): number => Object.values(counts).reduce((a, b) => a + b, 0);
18
19/** GET /portal/api/maintenance: the last pass's list and what it read. */
20export async function handlePortalMaintenance(request: Request, env: Env, now: Date = new Date()): Promise<Response> {
21  const gate = await portalGate(request, env, now, OPS_RETURN_TO);
22  if (!gate.ok) return gate.response;
23  const list = await readMaintenance(env);
24  const body: PortalMaintenance = list
25    ? {
26        generated: list.generated,
27        items: list.items,
28        read: {
29          prs: sum(list.prs_read),
30          branches: sum(list.branches_read),
31          repos: Object.keys(list.prs_read).length,
32          roster: ROSTER.length,
33          deploys: Object.keys(list.deploys_read).length,
34        },
35      }
36    : { generated: null, items: [], read: { prs: 0, branches: 0, repos: 0, roster: ROSTER.length, deploys: 0 } };
37  return new Response(JSON.stringify(body), { headers: { "Content-Type": "application/json", "Cache-Control": "no-store" } });
38}