src/portal-stale.ts

Functions

Imports

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

Source

1import type { Env } from "./env";
2import { OPS_RETURN_TO } from "./ops-feed";
3import type { PortalStale } from "./ops-types/views";
4import { portalGate } from "./portal-auth";
5import { staleJobs } from "./stale-jobs";
6
7// The Portal's stale jobs: GET /portal/api/stale (capsid/research/design-stale-jobs.md,
8// settled: its own route, since OPS_FEED_READS is pinned and the feed does not grow a
9// read). The same reader as `capsid_work_jobs` action list with stale: true (src/stale-jobs.ts), so
10// the Portal and chat cannot disagree, over every namespace. It costs no GitHub reads:
11// the pull request states come from the cache the merge-resume step writes. A route, not
12// a tool, so no grant is checked here (one enforcement point, test/route-gates.test.ts): it answers
13// to portalGate, and src/scope.ts lists it among the routes gated some other way.
14
15export const PORTAL_STALE_PATH = "/portal/api/stale";
16
17/** GET /portal/api/stale: the jobs that look stuck, each with its rule and reason. */
18export async function handlePortalStale(request: Request, env: Env, now: Date = new Date()): Promise<Response> {
19  const gate = await portalGate(request, env, now, OPS_RETURN_TO);
20  if (!gate.ok) return gate.response;
21  const read = await staleJobs(env, now);
22  const body: PortalStale = { generated: now.toISOString(), rows: read.rows, truncated: read.truncated, note: read.note ?? null };
23  return new Response(JSON.stringify(body), { headers: { "Content-Type": "application/json", "Cache-Control": "no-store" } });
24}