",
- kind: "deterministic",
- done: true,
- },
+const PAGE_CSS = ".release-link{color:inherit;letter-spacing:inherit;}" +
+ ".release-link:hover{color:var(--green);}";
+
+/* ------------------------------------------------------------------ *
+ * Hand-tokenized document source
+ * ------------------------------------------------------------------ */
+
+/**
+ * One run of source text. A bare string is unstyled; a tuple carries the
+ * token class the design system paints it with, and `bold` is the Markdown
+ * structure (headings) that reads at full weight rather than as a token.
+ */
+type Tok = string | ["key" | "str" | "mod" | "dim" | "bold", string];
+
+const key = (text: string): Tok => ["key", text];
+const str = (text: string): Tok => ["str", text];
+const mod = (text: string): Tok => ["mod", text];
+const dim = (text: string): Tok => ["dim", text];
+const bold = (text: string): Tok => ["bold", text];
+
+const TOK_CLASS = {
+ key: "tok-key",
+ str: "tok-str",
+ mod: "tok-mod",
+ dim: "tok-dim",
+} as const;
+
+/** Source lines, joined with newlines so `` lays them out. */
+function Source({ lines }: { lines: Tok[][] }) {
+ return (
+ <>
+ {lines.map((parts, line) => (
+
+ {line > 0 ? "\n" : null}
+ {parts.map((part, i) =>
+ typeof part === "string"
+ ? part
+ : part[0] === "bold"
+ ? {part[1]}
+ : {part[1]}
+ )}
+
+ ))}
+
+ );
+}
+
+const RELEASE_MD: Tok[][] = [
+ [bold("# Release")],
+ [],
+ ["Run the tests."],
+ [],
+ ["```bash ", mod("exec")],
+ ["deno task test"],
+ ["```"],
+ [],
+ ["Now decide how these changes should be"],
+ ["versioned."],
+ [],
+ [key("")],
+ [],
+ [
+ key(""),
+ ],
+ [" ", key("")],
+ [" Which version bump do these changes"],
+ [" require? Return JSON matching:"],
+ [],
+ [" ", key("")],
+ [],
+ [" ```bash ", mod("exec")],
+ [" git log --oneline main..HEAD"],
+ [" ```"],
+ [" ", key("")],
+ [key("")],
+ [],
+ [
+ key(""),
+ ],
];
-/** What each step of the "See it" document does, numbered to match. */
-const NOTES: { n: string; body: ComponentChildren; model?: boolean }[] = [
- {
- n: "1",
- body: (
- <>
- {""} deterministically selects the instruction files.
-
- ),
- },
- {
- n: "2",
- body: (
- <>
- {""}{" "}
- applies the same read procedure to every selected path.
-
- ),
- },
- {
- n: "3",
- body: (
- <>
- {""}{" "}
- reads through the contextual filesystem capability.
-
- ),
- },
- {
- n: "4",
- model: true,
- body: (
- <>
- {""}{" "}
- is the one explicitly probabilistic judgment step, and the one step that
- spends model tokens.
-
- ),
- },
- {
- n: "5",
- body: (
- <>
- The write form of {""}{" "}
- atomically saves the review at a declared path.
-
- ),
- },
- {
- n: "6",
- body: "The read form renders the saved artifact back into the document.",
- },
+const README_MD: Tok[][] = [
+ [dim("---")],
+ [dim("props:")],
+ [dim(" package:")],
+ [dim(" type:"), " ", str("string")],
+ [dim(" pattern:"), " ", str('"^packages/[a-z0-9._-]+$"')],
+ [dim("---")],
+ [],
+ [bold("## Setup")],
+ [],
+ ["```bash ", mod("exec")],
+ ["deno task setup"],
+ ["```"],
+ [],
+ [bold("## Test")],
+ [],
+ [bold("### Complete")],
+ [],
+ ["```bash ", mod("timeout=30m exec")],
+ ["deno task verify"],
+ ["```"],
+ [],
+ [bold("## Bootstrap")],
+ [],
+ [key("")],
];
-const FITS: { title: string; body: string }[] = [
- {
- title: "Release and repository procedures",
- body:
- "Files, branches, commits, pull requests, tests, and review steps expressed as one readable process.",
- },
- {
- title: "Repeatable AI-assisted work",
- body:
- "Deterministic structure around visible probabilistic steps such as agents and sampling, with inputs and outputs named in the document.",
- },
- {
- title: "Operational runbooks",
- body:
- "Documentation that can collect input, branch, retry, and eventually suspend or continue when those contracts ship.",
- },
+const AGENTS_MD: Tok[][] = [
+ [bold("## Architect")],
+ [key("")],
+ [],
+ [bold("## Implementor")],
+ [
+ key(""),
+ ],
+ [],
+ [bold("## Reviewer")],
+ [key("")],
];
-const AMORTIZATION = [
- "authoring and improving the executable procedure has an up-front reasoning cost;",
- "deterministic steps do not incur repeated LLM interpretation on every run;",
- "per-run token cost is limited to the explicit agent or sampling steps the workflow contains; and",
- "reduced interpretation also reduces latency, variance, retries, and human supervision.",
+const IMPLEMENTOR_MD: Tok[][] = [
+ [key("")],
+ [" ", key("")],
+ [" ", key("")],
+ [" You're an implementor agent."],
+ [
+ " ",
+ key(""),
+ ],
+ [" Implement this ticket:"],
+ [
+ " ",
+ key(""),
+ ],
+ [" ", key("")],
+ [
+ " ",
+ key(""),
+ ],
+ [
+ " ",
+ key(""),
+ ],
+ [" ", key("")],
+ [" ", key("")],
+ [key("")],
];
+const SCOPES_MD: Tok[][] = [
+ [key("")],
+ [" ", key("")],
+ [
+ " ",
+ key(""),
+ ],
+ [" ", key("")],
+ [key("")],
+];
+
+const WRAPPERS_MD: Tok[][] = [
+ [key("")],
+ [
+ " ",
+ key(""),
+ ],
+ [
+ " ",
+ key(""),
+ ],
+ [" ", key("")],
+ [
+ " ",
+ key(""),
+ ],
+ [
+ " ",
+ key(""),
+ ],
+ [" ", key("")],
+ [key("")],
+];
+
+const LOOP_MD: Tok[][] = [
+ [key("")],
+ [" ", key("")],
+ [" ", mod("{proposalCandidate}")],
+ [" ", key("")],
+ [],
+ [
+ " ",
+ key(""),
+ ],
+ [" ", key("")],
+ [" ", key("")],
+ [" ", key("")],
+ [" Correct your previous response"],
+ [" without changing its meaning."],
+ [" Return only corrected JSON matching"],
+ [" the supplied result contract."],
+ [" ", key("