src/portal-overnight.ts

Functions

Imports

It imports src/env.ts, src/http.ts, src/ops-feed.ts, src/ops-types/views.ts, src/overnight-plan.ts, src/portal-auth.ts. Imported by src/routes.ts.

Source

1import type { Env } from "./env";
2import { OPS_RETURN_TO } from "./ops-feed";
3import type { PortalDigest, PortalPlan } from "./ops-types/views";
4import { digestSinceFrom, readOvernightDigest, readOvernightPlan } from "./overnight-plan";
5import { portalGate } from "./portal-auth";
6import { jsonResponse as json } from "./http";
7
8// The Portal's Tonight plan and its "since you last looked" strip
9// (docs/design/design-portal-evaluation.md, DECIDE 3, ruled 2026-10-09):
10// GET /portal/api/plan and GET /portal/api/digest. The readers behind `capsid_work_jobs` action list
11// with view "plan" and view "digest" (src/overnight-plan.ts), over every namespace, so the
12// Portal and chat cannot disagree. Their own routes, read when the page that shows them
13// opens, since OPS_FEED_READS is pinned and the feed does not grow a read. Routes, not
14// tools, so no grant is checked here (one enforcement point, test/route-gates.test.ts): each
15// answers to portalGate, and src/scope.ts lists them among the routes gated some other way.
16
17export const PORTAL_PLAN_PATH = "/portal/api/plan";
18export const PORTAL_DIGEST_PATH = "/portal/api/digest";
19
20/** GET /portal/api/plan: what an overnight run would work, per repo, and what it skips. */
21export async function handlePortalPlan(request: Request, env: Env, now: Date = new Date()): Promise<Response> {
22  const gate = await portalGate(request, env, now, OPS_RETURN_TO);
23  if (!gate.ok) return gate.response;
24  const { for_namespace: _all, ...plan } = await readOvernightPlan(env, {}, now);
25  const body: PortalPlan = plan;
26  return json(body);
27}
28
29/** GET /portal/api/digest?since=: what finished, blocked and is ready since then. */
30export async function handlePortalDigest(request: Request, env: Env, now: Date = new Date()): Promise<Response> {
31  const gate = await portalGate(request, env, now, OPS_RETURN_TO);
32  if (!gate.ok) return gate.response;
33  const since = digestSinceFrom(new URL(request.url).searchParams.get("since") ?? undefined, now);
34  if (!since.ok) return new Response(since.refusal, { status: 400, headers: { "Content-Type": "text/plain; charset=utf-8" } });
35  const body: PortalDigest = await readOvernightDigest(env, { since: since.since }, now);
36  return json(body);
37}