visualproof 0.1.0 → 0.2.0

package/dist/assets/webfonts/LICENSE-Jost.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Jost Project Authors (https://github.com/indestructible-type/Jost) Jost-Italic[wght].ttf: Copyright 2020 The Jost Project Authors (https://github.com/indestructible-type/Jost)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/assets/webfonts/LICENSE-SourceSans3.txt

@@ -0,0 +1,93 @@
+Google Inc.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/assets/webfonts/LICENSE-SourceSerif4.txt

@@ -0,0 +1,93 @@
+Google Inc.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/server/agent.js

@@ -47,6 +47,8 @@ import { authorLine, authorsOf, reviewTraces, viewTraces } from "../shared/doc/a
 import { itemsShownOn } from "../shared/noteplace.js";
 import { buildDoc, DocInputError, docNotes } from "../shared/doc/build.js";
 import { boardSpots } from "./boardspots.js";
+import { outlineOf } from "../shared/doc/outline.js";
+import { planDoc } from "../shared/doc/sections.js";
 import { docFiles, figureFiles, figureNotes } from "./figures.js";
 import { renderLatex } from "../shared/doc/latex.js";
 import { readSettings, SETTINGS_HELP } from "../shared/doc/settings.js";
@@ -717,6 +719,39 @@ export class AgentApi {
         const tv = this.titleVersion(rec, at, version);
         return ok({ view: rec.id, title: docTitle({ ...base, ...(tv !== undefined ? { version: tv } : {}) }, titleContext(this.world)), author: authorLine(authors), authors });
     }
+    /** The outline of the document of view `view` at the build `version` names (ExportSpec decision
+     *  18; left out, the view's own): its sections, declarations and notes in the document's order,
+     *  without their text, from the board as its page draws it (as `document` reads it). What the
+     *  page's linear form draws (GET /api/export/outline); a view too large to print has one too. */
+    exportOutline(view, version) {
+        const rec = view ? this.world.views?.book.get(view) : undefined;
+        if (!rec)
+            return fail(404, `There is no view ${view.slice(0, 200)}.`, "GET /api/agent/views lists them.");
+        const at = this.exportAt(rec, version);
+        if (at !== null && typeof at === "object")
+            return at;
+        const v = this.graph();
+        if (!(v instanceof View))
+            return v;
+        const notes = this.world.views?.book.notes ?? [];
+        const memory = this.world.views?.book.memoryOf(rec.id, rec.clustering) ?? null;
+        const whole = v.meta.layouts?.[rec.clustering];
+        let g = v.g;
+        let review = this.world.review.data;
+        let past;
+        if (at !== null) {
+            const b = this.pasts.get(at, v.g, v.version, (m) => v.modules.get(m)?.file ?? null);
+            if (!b)
+                return fail(404, `There is no snapshot ${at}.`, "GET /api/agent/history lists them.");
+            past = { snapshot: at, nowName: b.past.nowName, now: v.g, nowReview: review };
+            g = b.past.graph;
+            review = reviewThen(review, b.past.nowName);
+        }
+        const set = evaluate(rec.scope, { g, review });
+        const plan = planDoc(g, set, rec.clustering, rec.hidden[rec.clustering] ?? []);
+        const board = boardSpots({ g, review, rec, memory, whole, notes, ...(past ? { past } : {}) });
+        return ok({ view: rec.id, ...(at !== null ? { version: at } : {}), outline: outlineOf(plan, g, board) });
+    }
     /** The exported document's model (ExportSpec decision 6) of view `view` with `settings` at the
      *  build `version` names (decision 16; left out, the view's own), as a request sends them: what
      *  the page's Export and an agent typeset (POST /api/export, POST /api/agent/export), and what
@@ -956,7 +991,7 @@ export class AgentApi {
             people: out,
             privateCount: P.privateCount(),
             agents,
-            note: "privateCount: how many people are here privately — not listed, not followable, nothing known of where they are. Each person's place is that of their liveliest page: the view, the tool (how a click selects), what is selected (a query), the declaration their panel tells of, whether its source window is open (and collapsed), the source windows they pinned (pinned: declaration, collapsed), and, where their page says them, Activity (open, kind, who, mine: whose targets), the lost-and-found (lostAndFound.open), the colouring (kind or status), edges and proofEdges — all of which those following them see too. idle: no input for five minutes, or the page in the background. verified: invited by a personal link, so the name is theirs. To look where someone looks, POST /api/agent/view with their view and declaration; ?wait=<s>&since=<rev> waits for the next change (at most 60 s).",
+            note: "privateCount: how many people are here privately — not listed, not followable, nothing known of where they are. Each person's place is that of their liveliest page: the view, the tool (how a click selects), what is selected (a query), the declaration their panel tells of, whether its source window is open (and collapsed), the source windows they pinned (pinned: declaration, collapsed), and, where their page says them, Activity (open, kind, who, mine: whose targets), the lost-and-found (lostAndFound.open), the colouring (kind or status), edges — all of which those following them see too. idle: no input for five minutes, or the page in the background. verified: invited by a personal link, so the name is theirs. To look where someone looks, POST /api/agent/view with their view and declaration; ?wait=<s>&since=<rev> waits for the next change (at most 60 s).",
         });
     }
     /** A page's or an agent's place, as the companion tells it (and a conversation's message, where
@@ -986,7 +1021,7 @@ export class AgentApi {
             : v.lostFound?.open
                 ? ", with the lost-and-found open"
                 : "";
-        const drawn = (v.scheme ? `, coloured by ${v.scheme}` : "") + (v.edges === false ? ", edges hidden" : "") + (v.proofEdges ? ", proof edges shown" : "");
+        const drawn = (v.scheme ? `, coloured by ${v.scheme}` : "") + (v.edges === false ? ", edges hidden" : "");
         return {
             view: v.view ?? PROJECT,
             viewTitle: title,
@@ -1004,7 +1039,6 @@ export class AgentApi {
             ...(v.lostFound ? { lostAndFound: { open: v.lostFound.open } } : {}),
             ...(v.scheme ? { colouring: v.scheme } : {}),
             ...(v.edges !== undefined ? { edges: v.edges } : {}),
-            ...(v.proofEdges !== undefined ? { proofEdges: v.proofEdges } : {}),
             inWords: words + then + shownBy + drawn + ".",
         };
     }
@@ -2519,7 +2553,8 @@ export class AgentApi {
             place[k] = b[k];
             return null;
         };
-        const bad = bool("sourceCollapsed") ?? bool("edges") ?? bool("proofEdges");
+        // (proofEdges, said until 2026-10-15, is no more: left as it is, as any word not known)
+        const bad = bool("sourceCollapsed") ?? bool("edges");
         if (bad)
             return bad;
         if (b.lostFound !== undefined) {
@@ -2744,7 +2779,7 @@ export class AgentApi {
             {
                 method: "GET", path: "/api/agent/companion", brief: "who is on the page, and where each one looks", about: "Who is on the page now and where each one is — every person (the place of their liveliest page: view, tool, selection, the declaration in their panel, the source window and the pinned ones, Activity, the lost-and-found, the colouring and the edges, idle or not) and the agents present — to follow the people you help; privateCount says how many people are here privately, who are not listed and cannot be followed. With wait, the answer waits until someone comes, goes or moves.",
                 params: { wait: "optional: seconds to wait for a change (at most 60)", since: "optional: the rev of an earlier answer; with wait, the answer comes as soon as the revision is another" },
-                returns: "{rev, changed?, now, sharedBy?: {name, here}, sharedByNote?, people: [{name, idle, pages, place: {view, viewTitle, targets?, scope?, mode, tool, selection, declaration, source, sourceCollapsed, pinned: [{declaration, collapsed}], history?, activity?: {open, kind, who, mine?}, lostAndFound?: {open}, colouring?, edges?, proofEdges?, inWords}}], privateCount, agents: [{name, idle, state?, status?, lastSeen?, you?, place}], note}",
+                returns: "{rev, changed?, now, sharedBy?: {name, here}, sharedByNote?, people: [{name, idle, pages, place: {view, viewTitle, targets?, scope?, mode, tool, selection, declaration, source, sourceCollapsed, pinned: [{declaration, collapsed}], history?, activity?: {open, kind, who, mine?}, lostAndFound?: {open}, colouring?, edges?, inWords}}], privateCount, agents: [{name, idle, state?, status?, lastSeen?, you?, place}], note}",
                 run: (a) => this.companion(a),
             },
             {
@@ -2881,7 +2916,7 @@ export class AgentApi {
             },
             {
                 method: "POST", path: "/api/agent/view/link", about: "A link to what you look at, or to a place you give, that opens exactly that for whoever opens it, as a person's Share makes with Exactly what I see (the owner's decision of 2026-10-12): the address, and after it a snapshot of everything followed — the view, the build in the Time Machine, the region of the board, the tool, the selection, the focus, the panel, the source windows, the reference window, Activity, the lost-and-found, the colouring, the edges. Fields you send are taken over your own place (as POST view takes them); nothing moves, you neither. The page that opens it applies it once, and says in a line what is no longer there. It holds no key: it opens for whoever is let in already, the people on the page.",
-                params: { "view, review, sel, selection, mode, source, focus, paper": "as POST view: over your own place", sourceCollapsed: "true: the source window following sel is collapsed to its pill", pinned: `source windows pinned, [{name, collapsed?}], at most ${MAX_PINNED}, the first pinned first`, history: "a snapshot's id (GET /api/agent/history): the Time Machine at that build; null for none", region: "[x, y, w, h]: the region of the board framed — its centre, width and height in the board's world — fitted to the opener's screen; left out, framed as for any link", activity: "{open, kind?, who?, mine?}: Activity open or closed, its filters", lostFound: "true: the lost-and-found open", scheme: "kind or status: the colouring", edges: "edges drawn", proofEdges: "proof edges drawn", exact: "false: only the view, as Share's switch turned off makes it (the address alone)" },
+                params: { "view, review, sel, selection, mode, source, focus, paper": "as POST view: over your own place", sourceCollapsed: "true: the source window following sel is collapsed to its pill", pinned: `source windows pinned, [{name, collapsed?}], at most ${MAX_PINNED}, the first pinned first`, history: "a snapshot's id (GET /api/agent/history): the Time Machine at that build; null for none", region: "[x, y, w, h]: the region of the board framed — its centre, width and height in the board's world — fitted to the opener's screen; left out, framed as for any link", activity: "{open, kind?, who?, mine?}: Activity open or closed, its filters", lostFound: "true: the lost-and-found open", scheme: "kind or status: the colouring", edges: "edges drawn", exact: "false: only the view, as Share's switch turned off makes it (the address alone)" },
                 returns: "{ok, link, exact, carries: what the link opens on, length, note, temporary?}",
                 run: (a) => this.viewLink(a),
             },

package/dist/server/history.js

@@ -70,6 +70,45 @@ export function commitNow(root) {
     const status = git(root, "status", "--porcelain", "--untracked-files=no", "--", "*.lean");
     return { hash, branch: branch && branch !== "HEAD" ? branch : null, ...(status ? { dirty: true } : {}) };
 }
+/** The project's git source and the commit checked out, as a page may show them (an artwork's foot,
+ *  ExportSpec decision 19): the remote's address (`origin`, else the first) with no user name or
+ *  password (sourceAddress); null where the project is not a git repository. Read-only, as `git`. */
+export function gitSource(root) {
+    const c = commitNow(root);
+    if (!c)
+        return null;
+    const remotes = (git(root, "remote") ?? "").split("\n").filter(Boolean);
+    const name = remotes.includes("origin") ? "origin" : remotes[0];
+    const url = name ? git(root, "remote", "get-url", name) : null;
+    return { source: url ? sourceAddress(url) : null, commit: c.hash, branch: c.branch, ...(c.dirty ? { dirty: true } : {}) };
+}
+/** A remote's address as a page shows it: its host and path, without the scheme, a user name, a
+ *  password, a port or `.git` — `git@github.com:A/B.git` and `https://user:token@github.com/A/B`
+ *  both read `github.com/A/B`. Null for a path on this machine, or what is no address. */
+export function sourceAddress(url) {
+    const u = url.trim();
+    let host, path;
+    // scp-like, [user@]host:path, but not a Windows drive
+    const scp = /^(?:[^@/\s]+@)?([A-Za-z0-9.-]+):(?!\/\/)(\S+)$/.exec(u);
+    if (scp && !/^[A-Za-z]:[\\/]/.test(u))
+        [host, path] = [scp[1], scp[2]];
+    else {
+        let p;
+        try {
+            p = new URL(u);
+        }
+        catch {
+            return null;
+        }
+        if (!["https:", "http:", "ssh:", "git:"].includes(p.protocol) || !p.hostname)
+            return null;
+        [host, path] = [p.hostname, decodeURIComponent(p.pathname)];
+    }
+    path = path.replace(/^\/+|\/+$/g, "").replace(/\.git$/, "");
+    if (!/^[A-Za-z0-9.-]+$/.test(host) || !path || !/^[\w.~/-]+$/.test(path))
+        return null;
+    return `${host}/${path}`;
+}
 /** The last commit made before `at`: what an imported extraction was probably built from. */
 function commitBefore(root, at) {
     const hash = git(root, "log", "-1", "--format=%H", `--before=${at}`);

package/dist/server/historyapi.js

@@ -8,7 +8,7 @@
 // or an agent at level full.
 //
 // The Time Machine steps from build to build, and a snapshot's graph is large (on a large project,
-// megabytes of JSON and a noticeable time to make and compress: the showcase's, 7,851 declarations, is 13.7 MB, made
+// megabytes of JSON and a noticeable time to make and compress: Sphere-Packing-Lean's, 7,851 declarations, is 13.7 MB, made
 // in 0.6 s): the page takes it in two parts, its declarations as JSON and its
 // edges packed as the graph on show's are (shared/edgecodec.ts), each compressed once and kept for
 // the last few snapshots asked, under the renames in force, and tagged so that a page that has one
@@ -21,7 +21,7 @@ const no = (status, error) => ({ status, body: { error } });
 const ok = (body) => ({ status: 200, body });
 /** the parts of the last snapshots asked, per history, by snapshot, build read and renames */
 const kept = new WeakMap();
-/** how many snapshots' parts are kept: about a megabyte each, compressed, on a large project (the showcase's:
+/** how many snapshots' parts are kept: about a megabyte each, compressed, on a large project (Sphere-Packing-Lean's:
  *  0.7 MB of declarations, 0.5 MB of edges) */
 const KEEP_PARTS = 8;
 /** what changed between two snapshots, as answered last (a step on the Time Machine's timeline asks

package/dist/server/hover.js

@@ -15,7 +15,7 @@
 // (a diagnostic), not as a hover.
 //
 // Lean runs each open file in a worker process of its own, which can die (a worker on a large
-// project holds gigabytes: 4.1 GB for the showcase's main theorem's module; and the kernel's OOM killer picks the
+// project holds gigabytes: 4.1 GB for Sphere-Packing-Lean's main theorem's module; and the kernel's OOM killer picks the
 // largest). Lean then says the file's progress
 // is a fatal error, and starts the worker again only when the document changes: until then every
 // question about it would wait forever. So a crashed document is closed and opened again here, as a
@@ -38,8 +38,8 @@ const IDLE_MS = 10 * 60 * 1000;
 const REQUEST_MS = 5 * 60 * 1000;
 /** a document still being elaborated that Lean has said nothing about for this long has stopped,
  *  whatever Lean says: it is opened again, as a crashed one (loading a large project's imports can
- *  take minutes on a machine short of memory, in which Lean says nothing; on an idle one the
- *  showcase's main theorem's module answers in 2 s) */
+ *  take minutes on a machine short of memory, in which Lean says nothing; on an idle one
+ *  Sphere-Packing-Lean's main theorem's module answers in 2 s) */
 const STALL_MS = 10 * 60 * 1000;
 /** crashes in a row (the document never elaborated to its end between them) after which a document
  *  is not opened again until GIVE_UP_MS have passed */

package/dist/server/layoutthread.js

@@ -1,5 +1,5 @@
 // The graph's layouts, off the server's thread: computeLayout then stabilize, for each clustering in
-// a worker of its own, both at once. Laid out on the server's thread, the showcase's graph held
+// a worker of its own, both at once. Laid out on the server's thread, Sphere-Packing-Lean's graph held
 // every request for seconds (2.5 s a clustering, more against a memory far off); a worker holds
 // none. A worker is given what a layout reads of each declaration, the edges and the memory, as
 // the page's own (web/src/layoutworker.ts), and gives the layout back. This module is its own

package/dist/server/main.js

@@ -7,7 +7,7 @@ import { existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
 import { createServer } from "node:http";
 import { extname, join, resolve } from "node:path";
 import { gunzipSync, gzipSync } from "node:zlib";
-import { WEB, bundleDir, bundleDirIn, ensureBundle, prepare, useBundleDir } from "./pipeline.js";
+import { WEB, WEBFONTS, bundleDir, bundleDirIn, ensureBundle, prepare, useBundleDir } from "./pipeline.js";
 import { SiteBusy, cacheHome, dataHome, lockSite, openSite, projectDirs } from "./dirs.js";
 import { ProjectError, openProject, targetsInWords } from "./project.js";
 import { Live } from "./live.js";
@@ -16,7 +16,7 @@ import { isDeclName, LeanHover } from "./hover.js";
 import { Identities, layoutAuthor } from "./identity.js";
 import { LAYOUT_VERSION } from "../shared/graph.js";
 import { MAX_MEMORY_BYTES, Views } from "./views.js";
-import { cleanView, defaultAgentName, validSession } from "../shared/collab.js";
+import { cleanView, defaultAgentName, validSession, withoutArtwork } from "../shared/collab.js";
 import { writeSnapshot } from "./snapshot.js";
 import { lakeTextHash } from "./status.js";
 import { invalidTemplate } from "../shared/editor.js";
@@ -265,6 +265,11 @@ export class App {
     async export(req, res, url, agent, readOnly = false) {
         const path = url.pathname;
         const api = this.agents;
+        // the document's outline, which the linear form draws: nothing is typeset for it
+        if (path === "/api/export/outline") {
+            const o = api.exportOutline(url.searchParams.get("view") ?? "", url.searchParams.get("version") ?? undefined);
+            return sendJson(res, o.body, o.status, o.headers);
+        }
         if (!this.exporter)
             return sendJson(res, { error: "This server does not export documents." }, 404);
         let a;
@@ -817,6 +822,9 @@ export class App {
                 return sendFile(req, res, join(WEB, "index.html"));
             if (path === "/style.css")
                 return sendFile(req, res, join(WEB, "style.css"));
+            // the fonts an artwork is drawn in (ExportSpec decision 19)
+            if (FONT_PATH.test(path))
+                return sendFile(req, res, join(WEBFONTS, path.slice("/fonts/".length)));
             // the page, and its workers: the one that lays out the Time Machine's past graphs
             // (web/src/layoutworker.ts), the one that chooses the overview's edges (web/src/edgeworker.ts),
             // and pdf.js's, which reads the library's PDFs for the reference window (AttachmentSpec decision 11)
@@ -937,8 +945,9 @@ export class App {
                 // its own event stream only, by the secret the stream was given (`hello`)
                 const name = this.ids.who(req);
                 const priv = !agent && b.private === true;
+                // agents have no artwork (ExportSpec decision 19): the page draws it
                 if (agent && name)
-                    live.presence.agentBeat(name, cleanView(b.view));
+                    live.presence.agentBeat(name, withoutArtwork(cleanView(b.view)));
                 else if (!live.beat(b.token, priv ? null : name, priv ? null : cleanView(b.view), !priv && b.idle === true, priv, !!this.ids.person(req)))
                     return sendJson(res, { error: "This heartbeat is not from an open event stream of this page's: it is sent with the token the stream says hello with.", stream: false }, 403);
                 return sendJson(res, { ok: true });
@@ -1080,7 +1089,10 @@ export class App {
         }
     }
 }
+/** an artwork's font file (assets/webfonts/) */
+const FONT_PATH = /^\/fonts\/(source-sans-3|source-serif-4|jost)-[a-z-]+\.woff2$/;
 const TYPES = {
+    ".woff2": "font/woff2",
     ".html": "text/html; charset=utf-8",
     ".css": "text/css; charset=utf-8",
     ".js": "text/javascript; charset=utf-8",

package/dist/server/mcptools.js

@@ -149,7 +149,7 @@ export const TOOLS = [
         default: "move",
         actions: {
             move: { method: "POST", path: "/api/agent/view", says: "go to a view, a target's view, a declaration, its source; fields left out keep their value", args: ["view", "review", "sel", "selection", "mode", "source", "paper", "focus", "leave"] },
-            link: { method: "POST", path: "/api/agent/view/link", says: "a link that opens exactly what you look at, or a place you describe, to hand people in a reply", args: ["view", "review", "sel", "selection", "mode", "source", "paper", "focus", "sourceCollapsed", "pinned", "history", "region", "activity", "lostFound", "scheme", "edges", "proofEdges", "exact"] },
+            link: { method: "POST", path: "/api/agent/view/link", says: "a link that opens exactly what you look at, or a place you describe, to hand people in a reply", args: ["view", "review", "sel", "selection", "mode", "source", "paper", "focus", "sourceCollapsed", "pinned", "history", "region", "activity", "lostFound", "scheme", "edges", "exact"] },
             ask_follow: { method: "POST", path: "/api/agent/ask-follow", says: "ask the people on the page to follow you first", args: ["who", "wait"] },
         },
         args: {
@@ -157,7 +157,7 @@ export const TOOLS = [
             review: str("a target: be on its view"),
             sel: str("the declaration you look at"),
             selection: str("what you select, as a query: decl(A.b) or tcb(A.c)"),
-            mode: str("how you select: plain; Rests on's deps, tcb, keys; apps", ["plain", "deps", "tcb", "keys", "apps"]),
+            mode: str("how you select: plain; Rests on's deps, tcb, keys, refs (what it uses directly); apps", ["plain", "deps", "tcb", "keys", "refs", "apps"]),
             source: bool("the source window open on sel"),
             paper: PAPER,
             focus: str("your focus on the view: a target, \"none\", or \"view\" for the view's own"),
@@ -170,7 +170,6 @@ export const TOOLS = [
             lostFound: bool("link: the lost-and-found open"),
             scheme: str("link: the colouring", ["kind", "status"]),
             edges: bool("link: edges drawn"),
-            proofEdges: bool("link: proof edges drawn"),
             exact: bool("link: false for the view's address alone"),
             who: str("ask_follow: a person's name; left out, everyone"),
             wait: bool("ask_follow: false answers at once (default: wait for them, at most 30 s)"),

package/dist/server/pastdoc.js

@@ -14,7 +14,7 @@ import { pastGraph } from "../shared/pastgraph.js";
 import { pageGraph } from "./history.js";
 import { MOST_DIFF, snapshotDiff } from "./historyapi.js";
 /** how many past builds are kept: a past graph and the texts read for a large view are large on a
- *  large project (the showcase's past graph: 13.7 MB of JSON) */
+ *  large project (Sphere-Packing-Lean's past graph: 13.7 MB of JSON) */
 const KEEP = 2;
 export class PastBuilds {
     w;