app/routes/procedure[.md].ts

Functions

Imports

It imports app/db/procedures.ts, app/kb/procedures/library.mjs, app/kb/procedures/lineage.mjs, app/kb/procedures/lineage.server.ts, app/kb/procedures/proof.mjs, app/kb/procedures/proof.server.ts, app/kb/procedures/route.ts, app/lib/context.ts, app/lib/markdown-twin.ts, app/lib/seo.ts. No module of this repo imports it.

Source

1import { getProcedureByPath, getPublishedProcedureMarkdown, listPublishedLibraryRecords } from "~/db/procedures";
2import { getEnv } from "~/lib/context";
3import { canonicalLink } from "~/lib/markdown-twin";
4import { libraryItems, workflowContext, workflowMarkdown } from "~/kb/procedures/library.mjs";
5import { withLineage } from "~/kb/procedures/lineage.mjs";
6import { lineageFor } from "~/kb/procedures/lineage.server";
7import { proofMarkdown } from "~/kb/procedures/proof.mjs";
8import { proofFor } from "~/kb/procedures/proof.server";
9import { PROCEDURES_CACHE_TAG } from "~/kb/procedures/route";
10import { SHARED_CACHE_CONTROL, SITE_ORIGIN } from "~/lib/seo";
11
12import type { Route } from "./+types/procedure[.md]";
13
14/**
15 * A procedure's markdown twin at `<page>.md`, generated from the same file as the page
16 * (app/kb/procedures/render.mjs), so an agent reads the facts a person does. Drafts answer 404.
17 */
18export async function loader({ request, context }: Route.LoaderArgs) {
19  const path = new URL(request.url).pathname.replace(/\.md$/, "");
20  const env = getEnv(context);
21  const stored = await getPublishedProcedureMarkdown(env, path);
22  if (stored === null) {
23    return new Response("Not found\n", { status: 404, headers: { "content-type": "text/plain; charset=utf-8" } });
24  }
25  // A protocol's place in the phage workflow depends on the other protocols, so it is added here, not stored in the row.
26  const workflow = workflowMarkdown(workflowContext(libraryItems(await listPublishedLibraryRecords(env)), path), SITE_ORIGIN);
27  // Proof of use is slugs in the file; the twin gives the papers' titles and the phages' names, as the page does.
28  const row = await getProcedureByPath(env, path);
29  const proof = proofMarkdown(await proofFor(env, row?.record.proofOfUse ?? null), SITE_ORIGIN);
30  const extra = [workflow, proof].filter(Boolean).join("\n\n");
31  // A variant's parent by its title and address, as the page's "Based on" (P3).
32  const named = row ? withLineage(stored, row.record, await lineageFor(env, row.record), SITE_ORIGIN) : stored;
33  const markdown = extra ? `${named.trimEnd()}\n\n${extra}\n` : named;
34  return new Response(markdown, {
35    headers: {
36      "content-type": "text/markdown; charset=utf-8",
37      "cache-control": SHARED_CACHE_CONTROL,
38      "cache-tag": PROCEDURES_CACHE_TAG,
39      // As every other page twin (public/_headers): the HTML page is the one to index.
40      "x-robots-tag": "noindex",
41      link: canonicalLink(path),
42    },
43  });
44}