isorite 0.10.0 → 0.12.0

package/dist/main.js

@@ -43,6 +43,342 @@ var __exportAll = (all, no_symbols) => {
 	return target;
 };
 //#endregion
+//#region packages/kit/src/assemble.ts
+function meta(html, name) {
+	for (const m of html.matchAll(/<meta\b[^>]*>/gi)) {
+		const tag = m[0];
+		if ((tag.match(/\bname\s*=\s*["']([^"']*)["']/i)?.[1])?.toLowerCase() === name) return unescape(tag.match(/\bcontent\s*=\s*"([^"]*)"|\bcontent\s*=\s*'([^']*)'/i)?.slice(1).find((x) => x !== void 0) ?? "");
+	}
+	return null;
+}
+function manifestOf(html) {
+	return {
+		title: unescape(html.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1]?.trim() ?? ""),
+		description: meta(html, "description") ?? "",
+		author: meta(html, "author") ?? "",
+		date: meta(html, "date") ?? "",
+		kit: meta(html, "isorite:kit"),
+		uses: (meta(html, "isorite:uses") ?? "").split(/[\s,]+/).filter(Boolean)
+	};
+}
+/** The artifact with its manifest as given (write_artifact, plan-m23 §3.5): its title, description, author, date, kit
+*  and uses set in its head, put in where missing, so they're always right whatever the file said. A file with no
+*  head or no document around it is given one. */
+function withManifest(html, m) {
+	const esc = (s) => s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+	let doc = html.trim();
+	if (!/<html\b/i.test(doc)) doc = /<head\b/i.test(doc) ? `<!doctype html>\n<html lang="en">\n${doc}\n</html>` : `<!doctype html>\n<html lang="en">\n<head>\n</head>\n<body>\n${doc.replace(/<\/?body\b[^>]*>/gi, "")}\n</body>\n</html>`;
+	if (!/<head\b/i.test(doc)) doc = doc.replace(/<html\b[^>]*>/i, (h) => `${h}\n<head>\n</head>`);
+	if (!/^<!doctype/i.test(doc)) doc = `<!doctype html>\n${doc}`;
+	const metas = [
+		["description", m.description],
+		["author", m.author],
+		["date", m.date],
+		["isorite:kit", m.kit ?? void 0],
+		["isorite:uses", m.uses?.join(" ")]
+	];
+	for (const [name, value] of metas) {
+		if (value === void 0) continue;
+		const tag = `<meta name="${name}" content="${esc(value)}">`, re = new RegExp(`<meta\\b[^>]*\\bname\\s*=\\s*["']${name.replace(":", "\\:")}["'][^>]*>`, "i");
+		doc = re.test(doc) ? doc.replace(re, () => tag) : doc.replace(/<head\b[^>]*>/i, (h) => `${h}\n${tag}`);
+	}
+	if (m.title !== void 0) {
+		const t = `<title>${esc(m.title)}</title>`;
+		doc = /<title\b[^>]*>[\s\S]*?<\/title>/i.test(doc) ? doc.replace(/<title\b[^>]*>[\s\S]*?<\/title>/i, () => t) : doc.replace(/<head\b[^>]*>/i, (h) => `${h}\n${t}`);
+	}
+	if (!/<meta\b[^>]*charset/i.test(doc)) doc = doc.replace(/<head\b[^>]*>/i, (h) => `${h}\n<meta charset="utf-8">`);
+	return doc.endsWith("\n") ? doc : doc + "\n";
+}
+/** The kit's parts an artifact uses beyond the core: Plot with a chart, three.js with 3D. */
+function partsUsed(html) {
+	const parts = [];
+	if (/<iso-chart[\s>]|\bPlot\.\w/.test(html)) parts.push("chart");
+	if (/<iso-model[\s>]|<iso-chart3d[\s>]|\bTHREE\.\w/.test(html)) parts.push("model");
+	const text = html.replace(/<script\b[\s\S]*?<\/script>/gi, "").replace(/<style\b[\s\S]*?<\/style>/gi, "");
+	if (/<iso-math[\s>]|\biso\.math\(|\$\$[\s\S]+?\$\$|\\\(|\$(?=\S)[^$\n]+?(?<=\S)\$(?!\d)/.test(text) || /\biso\.math\(/.test(html)) parts.push("math");
+	return parts;
+}
+/** The artifact as one document: the CSP, the kit's themes, components and the parts it uses, inlined at the top of
+*  its head (any kit <link> or <script src> it wrote is taken out), with its data too for a standalone export. */
+function assemble(html, kit, opts = {}) {
+	const look = opts.look ?? "isorite", ground = opts.ground ?? "lapis";
+	const body = html.replace(/<link\b[^>]*\bhref\s*=\s*["'](?:\.\/)?kit\/[^"']*["'][^>]*>\s*/gi, "").replace(/<script\b[^>]*\bsrc\s*=\s*["'](?:\.\/)?kit\/[^"']*["'][^>]*>\s*<\/script>\s*/gi, "");
+	const data = Object.entries(opts.data ?? {}).map(([p, v]) => typeof v === "string" ? `<script type="text/plain" data-path="${attr(p)}">${safe(v)}<\/script>` : `<script type="application/octet-stream" data-encoding="base64" data-path="${attr(p)}">${base64(v)}<\/script>`);
+	const parts = partsUsed(body).map((p) => `${p === "math" ? `<style>\n${safe(kit["math.css"])}\n</style>\n` : ""}<script>\n${safe(kit[`${p}.js`])}\n<\/script>`);
+	const head = [
+		CSP,
+		`<style data-look="isorite">\n${safe(kit["isorite.css"])}\n</style>`,
+		`<style data-look="plain">\n${safe(kit["plain.css"])}\n</style>`,
+		`<style>\n${safe(kit["kit.css"])}\n</style>`,
+		...data,
+		`<script>\n${safe(kit["kit.js"])}\n<\/script>`,
+		...parts
+	].join("\n");
+	return (/<head\b[^>]*>/i.test(body) ? body.replace(/<head\b[^>]*>/i, (h) => `${h}\n${head}\n`) : `<!doctype html><html><head><meta charset="utf-8">\n${head}\n</head><body>${body}</body></html>`).replace(/<html\b([^>]*)>/i, (_, a) => `<html${a.replace(/\s+data-(?:look|ground)\s*=\s*("[^"]*"|'[^']*'|\S+)/gi, "")} data-look="${look}" data-ground="${ground}">`);
+}
+function base64(bytes) {
+	let s = "";
+	for (let i = 0; i < bytes.length; i += 32768) s += String.fromCharCode(...bytes.subarray(i, i + 32768));
+	return btoa(s);
+}
+var KIT_FILES, unescape, CSP, safe, attr;
+var init_assemble = __esmMin((() => {
+	KIT_FILES = [
+		"kit.js",
+		"chart.js",
+		"model.js",
+		"math.js",
+		"math.css",
+		"isorite.css",
+		"plain.css",
+		"kit.css"
+	];
+	unescape = (s) => s.replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+	CSP = `<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data: blob:; font-src data:; media-src data: blob:; connect-src 'none'">`;
+	safe = (t) => t.replace(/<\/(script|style)/gi, "<\\/$1");
+	attr = (s) => s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}));
+//#endregion
+//#region packages/kit/src/rules.ts
+/** The files an artifact reads, from its markup and script: data="…", an iso-model's src, iso.data/text/bytes("…"). */
+function readsOf(html) {
+	const own = html.replace(/<!--[\s\S]*?-->/g, ""), reads = /* @__PURE__ */ new Set();
+	for (const r of own.matchAll(/iso\.(?:data|text|bytes)\(\s*["'`]([^"'`$]+)["'`]/g)) reads.add(r[1]);
+	for (const t of own.matchAll(TAG)) {
+		const a = attrsOf(t[2]);
+		(a.data ?? "").split(/[\s,]+/).filter(Boolean).forEach((f) => reads.add(f));
+		if (t[1].toLowerCase() === "iso-model" && a.src) reads.add(a.src);
+	}
+	return [...reads];
+}
+function checkArtifact(html, ctx = {}) {
+	const out = [], m = manifestOf(html);
+	const err = (rule, message) => out.push({
+		rule,
+		level: "error",
+		message
+	});
+	const warn = (rule, message) => out.push({
+		rule,
+		level: "warning",
+		message
+	});
+	const own = html.replace(/<!--[\s\S]*?-->/g, "");
+	if (m.kit === null) err(1, "no <meta name=\"isorite:kit\" content=\"1\">: without it isorite gives it no kit");
+	if (!m.title) err(1, "no <title>");
+	if (!m.description) err(1, "no <meta name=\"description\" content=\"…\">: one sentence on what it shows");
+	const reads = /* @__PURE__ */ new Set();
+	for (const r of own.matchAll(/iso\.(?:data|text|bytes)\(\s*["'`]([^"'`$]+)["'`]/g)) reads.add(r[1]);
+	const files = (a) => (a.data ?? "").split(/[\s,]+/).filter(Boolean);
+	for (const t of own.matchAll(TAG)) {
+		const a = attrsOf(t[2]);
+		files(a).forEach((f) => reads.add(f));
+		if (t[1].toLowerCase() === "iso-model" && a.src) reads.add(a.src);
+	}
+	for (const r of reads) if (!m.uses.includes(r)) err(2, `it reads ${r}, which isn't in <meta name="isorite:uses">`);
+	if (ctx.files) {
+		for (const u of m.uses) if (!ctx.files.includes(u)) err(2, `${u} is in isorite:uses but there's no such file beside it${ctx.files.length ? ` (there are: ${ctx.files.join(", ")})` : ""}`);
+	}
+	if (ctx.uses && [...ctx.uses].sort().join() !== [...m.uses].sort().join()) err(2, `isorite:uses (${m.uses.join(" ") || "none"}) and the uses given (${ctx.uses.join(" ") || "none"}) differ`);
+	if (ctx.columns) for (const t of own.matchAll(TAG)) {
+		const a = attrsOf(t[2]), fs = files(a), known = fs.map((f) => ctx.columns[f]);
+		if (!fs.length || known.some((k) => !k)) continue;
+		const have = [...new Set(known.flat()), ...fs.length > 1 ? ["file"] : []];
+		for (const k of COLUMN_ATTRS) for (const c of (a[k] ?? "").split(/[\s,]+/).filter(Boolean)) {
+			const name = c.replace(/^abs\((.+)\)$/, "$1");
+			if (k === "at" && t[1].toLowerCase() !== "iso-chart3d" && !have.includes(name)) continue;
+			if (!have.includes(name)) err(3, `<${t[1]} data="${a.data}" ${k}="${a[k]}">: ${a.data} has no column "${name}" (it has ${have.join(", ")})`);
+		}
+	}
+	const code = own.replace(/<meta\b[^>]*>/gi, "").replace(/\btone\s*=\s*"[^"]*"/g, "");
+	const colour = code.match(/#[0-9a-fA-F]{3,8}\b(?![-\w])|\b(?:rgba?|hsla?|oklch|oklab|lab|lch)\(\s*[\d.]/i) ?? code.match(/\b(?:fill|stroke|fillStyle|strokeStyle|color|background(?:-color)?|shadowColor|border(?:-color)?)\s*[:=]\s*["'`]?(?:white|black|red|blue|green|gray|grey|orange|yellow|purple|pink|navy|teal|silver)\b/i);
+	if (colour) err(4, `a colour of its own (${colour[0].trim().slice(0, 40)}): use the theme's, var(--lattice) in CSS or iso.tokens().lattice in script`);
+	const font = code.match(/font-family\s*:\s*[^;"}]*|\bfont\s*[:=]\s*["'`]?[^;"'`}]*(?<![.\w-])(?:sans-serif|serif|monospace|Arial|Helvetica|system-ui|Georgia|Times|Courier|Inter|Roboto)\b/i);
+	if (font && !/var\(--font|\$\{/.test(font[0])) err(4, `a font of its own (${font[0].slice(0, 50)}): use var(--font-ui), var(--font-text) or iso.tokens().ui`);
+	if (/border-radius\s*:/i.test(code)) err(4, "border-radius: the theme decides corners");
+	const urls = code.replace(/http:\/\/www\.w3\.org\/[\w/.-]+/g, "").match(/\bhttps?:\/\/[^\s"'`)<]+/);
+	if (urls) err(5, `a web address (${urls[0].slice(0, 60)}): an artifact reaches nothing outside the file`);
+	if (/<script\b[^>]*\bsrc\s*=/i.test(code.replace(/<script\b[^>]*\bsrc\s*=\s*["'](?:\.\/)?kit\/[^"']*["'][^>]*>/gi, ""))) err(5, "a <script src>: everything is in the file, and the kit is given");
+	if (/<link\b[^>]*\bhref\s*=\s*["'](?!(?:\.\/)?kit\/)/i.test(code)) err(5, "a <link href>: everything is in the file, and the kit is given");
+	if (/\b(?:fetch|XMLHttpRequest|WebSocket|EventSource|importScripts)\s*\(|\bimport\s*\(/.test(code)) err(5, "fetch, XMLHttpRequest or import(): read files with iso.data(path)");
+	if (html.length > 2e5) err(6, `${Math.round(html.length / 1024)} kB, over 200 kB: keep data in a data file, not in the page`);
+	const directive = own.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]*>/g, " ").match(/\b(?:drag(?:ging)? to|click (?:here|to|on)|tap to|scroll to|hover (?:to|over)|use the slider|press (?:the|play)|try (?:dragging|moving|clicking))\b[^.]*/i);
+	if (directive) warn(7, `text that explains how to use it ("${directive[0].trim().slice(0, 60)}"): say what a thing is, not what to do with it`);
+	return out;
+}
+var COLUMN_ATTRS, TAG, attrsOf;
+var init_rules = __esmMin((() => {
+	init_assemble();
+	COLUMN_ATTRS = [
+		"x",
+		"y",
+		"z",
+		"by",
+		"column",
+		"columns",
+		"at"
+	];
+	TAG = /<(iso-[\w-]+)\b([^>]*)>/gi;
+	attrsOf = (s) => Object.fromEntries([...s.matchAll(/([\w-]+)\s*=\s*"([^"]*)"/g)].map((m) => [m[1].toLowerCase(), m[2]]));
+}));
+//#endregion
+//#region packages/kit/src/data.ts
+/** One line of delimited text into fields; quotes may hold the delimiter, newlines and doubled quotes. */
+function* records(text, sep) {
+	let field = "", row = [], quoted = false;
+	for (let i = 0; i < text.length; i++) {
+		const c = text[i];
+		if (quoted) {
+			if (c === "\"") {
+				if (text[i + 1] === "\"") {
+					field += "\"";
+					i++;
+				} else quoted = false;
+			} else field += c;
+		} else if (c === "\"" && field === "") quoted = true;
+		else if (c === sep) {
+			row.push(field);
+			field = "";
+		} else if (c === "\n" || c === "\r") {
+			if (c === "\r" && text[i + 1] === "\n") i++;
+			row.push(field);
+			field = "";
+			if (row.length > 1 || row[0] !== "") yield row;
+			row = [];
+		} else field += c;
+	}
+	row.push(field);
+	if (row.length > 1 || row[0] !== "") yield row;
+}
+function parseDelimited(text, sep = ",") {
+	const it = records(text.replace(/^/, ""), sep), head = it.next();
+	if (head.done) return [];
+	const cols = head.value.map((c) => c.trim());
+	const out = [];
+	for (const r of it) out.push(Object.fromEntries(cols.map((c, i) => [c, value(r[i] ?? "")])));
+	return out;
+}
+function parseData(path, text) {
+	const ext = path.toLowerCase().split(".").pop();
+	if (ext === "json") {
+		const j = JSON.parse(text);
+		if (Array.isArray(j)) return j;
+		const inner = j && typeof j === "object" ? Object.values(j).find(Array.isArray) : null;
+		if (inner) return inner;
+		throw new Error(`${path}: not an array of rows`);
+	}
+	if (ext === "jsonl" || ext === "ndjson") return text.split(/\r?\n/).filter((l) => l.trim()).map((l) => JSON.parse(l));
+	if (ext === "tsv") return parseDelimited(text, "	");
+	if (ext === "csv") return parseDelimited(text, ",");
+	throw new Error(`${path}: the kit reads CSV, TSV, JSON and JSON lines`);
+}
+/** Every column any row has, in the order they first appear. */
+function columnsOf(rows) {
+	const seen = /* @__PURE__ */ new Set();
+	for (const r of rows.slice(0, 1e3)) for (const k of Object.keys(r)) seen.add(k);
+	return [...seen];
+}
+/** What read_data tells Iso: enough to build on a file without reading it. */
+function shapeOf(path, rows, head = 5) {
+	return {
+		path,
+		rows: rows.length,
+		head: rows.slice(0, head),
+		columns: columnsOf(rows).map((name) => {
+			const vs = rows.map((r) => r[name]), present = vs.filter((v) => v !== null && v !== void 0 && v !== ""), empty = vs.length - present.length;
+			if (!present.length) return {
+				name,
+				type: "empty",
+				empty
+			};
+			if (present.every((v) => typeof v === "number")) {
+				let min = Infinity, max = -Infinity, sum = 0;
+				for (const v of present) {
+					if (v < min) min = v;
+					if (v > max) max = v;
+					sum += v;
+				}
+				return {
+					name,
+					type: "number",
+					min,
+					max,
+					mean: sum / present.length,
+					empty
+				};
+			}
+			if (present.every((v) => typeof v === "boolean")) return {
+				name,
+				type: "boolean",
+				empty
+			};
+			const distinct = [...new Set(present.map(String))];
+			return {
+				name,
+				type: "text",
+				distinct: distinct.length,
+				values: distinct.slice(0, 12),
+				empty
+			};
+		})
+	};
+}
+/** The shape as text, the way Iso reads it. */
+function describeShape(s) {
+	const g = (x) => Number.isInteger(x) ? String(x) : String(+x.toPrecision(4));
+	const lines = [`${s.path}: ${s.rows} rows, ${s.columns.length} columns`];
+	for (const c of s.columns) {
+		const empty = c.empty ? `, ${c.empty} empty` : "";
+		if (c.type === "number") lines.push(`- ${c.name}: number, ${g(c.min)} to ${g(c.max)} (mean ${g(c.mean)})${empty}`);
+		else if (c.type === "text") lines.push(`- ${c.name}: text, ${c.distinct} distinct: ${c.values.join(", ")}${c.distinct > c.values.length ? ", …" : ""}${empty}`);
+		else lines.push(`- ${c.name}: ${c.type}${empty}`);
+	}
+	const cols = s.columns.map((c) => c.name);
+	lines.push("First rows:", cols.join(","), ...s.head.map((r) => cols.map((c) => r[c] ?? "").join(",")));
+	return lines.join("\n");
+}
+var NUMBER, value;
+var init_data = __esmMin((() => {
+	NUMBER = /^[-+]?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/;
+	value = (s) => s === "" ? null : NUMBER.test(s.trim()) ? +s : s;
+}));
+//#endregion
+//#region packages/kit/src/context.gen.ts
+var REFERENCE, RECIPES;
+var init_context_gen = __esmMin((() => {
+	REFERENCE = "# The kit (isorite kit 1)\n\nAn artifact is one HTML file: markup, perhaps a script, and a manifest in its `<head>`. isorite gives it the kit: the look (every colour, font and corner), the elements below, and `window.iso`. Write what it shows and does, never how it looks: no colour, font family or border-radius of your own.\n\n## The file\n\n```html\n<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>Title</title>\n<meta name=\"description\" content=\"One sentence: what it shows, and what can be done with it.\">\n<meta name=\"isorite:kit\" content=\"1\">\n<meta name=\"isorite:uses\" content=\"runs.csv other.csv\">\n<style>/* layout only, if needed */</style>\n</head>\n<body>\n<iso-page>\n  <header><h1>Title</h1><p>The question it answers, in a sentence or two.</p></header>\n  <iso-grid>\n    <iso-panel class=\"wide\"><h2>Name <span>a short reading</span></h2> … </iso-panel>\n    <iso-panel><h2>…</h2> … </iso-panel>\n  </iso-grid>\n</iso-page>\n</body>\n</html>\n```\n\n`write_artifact` fills in the title, description and manifest from its arguments, so they are always right.\n\n## Layout\n\n- `<iso-grid>`: panels in two columns (`style=\"--cols: 3\"` for three); `<iso-panel class=\"wide\">` spans the row.\n- `<iso-panel>`: its first child is `<h2>`; a `<span>` in the `h2` is a soft aside. A `<p>` in a panel is a caption: what the panel shows, in a sentence.\n- `<iso-row>`: controls side by side. `<iso-stats>`: big numbers side by side.\n\n## Data, with no script\n\nEvery element with `data=\"file.csv\"` reads it itself. Several files are one table: `data=\"euler.csv leapfrog.csv\"` adds a column `file` (`euler`, `leapfrog`) to compare them with `by=\"file\"`. `where=\"integrator=leapfrog\"` keeps some rows; `where=\"t<=$t\"` compares with a control's value. `abs(col)` is a column's size.\n\n- `<iso-chart data=\"f.csv\" x=\"t\" y=\"energy\" by=\"body\">`: a chart.\n  - `type`: `line` (default), `dot`, `bar`, `area`, `step`.\n  - `y` may name several columns: `y=\"kinetic potential total\"`, each its own line.\n  - `by`: a column whose values are the series.\n  - `x-scale`, `y-scale`: `linear` or `log`, or `$name` to follow a control (`y-scale=\"$scale\"`).\n  - `x-label`, `y-label`: the axis with its unit (`\"time (s)\"`). `height` in pixels (260).\n  - `at=\"t\"`: follows the control `t`. A rule where x is its value; or, when the data has a column `t` and x is another column (a path in x and y over time), a dot on each series at the row whose `t` is nearest it.\n- `<iso-table data=\"f.csv\" columns=\"a b c\" limit=\"50\">`: the rows.\n- `<iso-stat data=\"f.csv\" column=\"err\" of=\"max\" label=\"worst error\" tone=\"gold\">`: one number. `of`: `min`, `max`, `mean`, `sum`, `count`, `first`, `last`. Tones: `gold`, `blue`, `green`, `rose`. Without `data`, set it from a script: `el.value = 0.0023`.\n- `<iso-chart3d data=\"f.csv\" x=\"x\" y=\"y\" z=\"z\" by=\"body\" at=\"t\">`: points or paths in 3D, turned by dragging.\n- `<iso-model src=\"part.glb\">`: a 3D model (glTF, GLB, STL, OBJ), turned by dragging. List it in isorite:uses.\n\n## Text and maths\n\n- A `<p>` in a panel is its caption. Maths is written as in a note: `$E = \\tfrac12 m v^2$` inline, `$$…$$` on a line of its own; the kit sets it. `<iso-math>\\frac{a}{b}</iso-math>` is a formula alone.\n- Never name the theme's colours in text (\"the lattice line\"): a chart's legend says which series is which.\n\n## Controls\n\nEach writes its value to `iso.state[name]`; elements that name it (`at=\"t\"`, `$t`) follow it.\n\n- `<iso-slider name=\"dt\" label=\"time step\" min=\"0.001\" max=\"0.05\" step=\"0.001\" value=\"0.01\" digits=\"3\">`\n- `<iso-select name=\"scale\" label=\"scale\" options=\"linear log\">`: one of several.\n- `<iso-toggle name=\"softened\" label=\"softened\" value=\"true\">`: on or off.\n- `<iso-play name=\"t\" min=\"0\" max=\"12\" speed=\"1.5\">`: plays `iso.state.t` from min to max, and pauses.\n- `<iso-note href=\"physics/softening\">softening</iso-note>`: opens a note in isorite.\n\n## Script, when markup isn't enough\n\nFor a simulation or anything computed. Put it at the end of the body.\n\n- `const rows = await iso.data(\"f.csv\")`: the rows as objects, numbers as numbers.\n- `iso.state.name`, `iso.watch((name) => …)`: the shared state; `watch` runs after any change.\n- `iso.loop((dt, t) => …)`: runs every frame (dt in seconds), paused when hidden. Returns a stop function.\n- `<iso-canvas height=\"320\" id=\"sim\">` and `document.getElementById(\"sim\").draw = (ctx, w, h, t) => { … }`: draw on a canvas sized to its panel; call `.redraw()` after a change. `t` is the theme: `t.text`, `t.soft`, `t.faint`, `t.line`, `t.lattice` (blue), `t.growth` (gold), `t.malachite` (green), `t.rose`, `t.series[i]`, `t.ui` (the font).\n- A chart of what the script computes: `chart.rows = [{ t: 0, energy: -1.3 }, …]` on an `<iso-chart>` with no `data`.\n- `iso.format(x)`: a number to read (3 figures, 2.3×10⁻³). `iso.tokens()`: the theme, as `t` above.\n- In CSS: `var(--text)`, `var(--text-soft)`, `var(--text-faint)`, `var(--line)`, `var(--lattice)`, `var(--growth)`, `var(--malachite)`, `var(--rose)`, `var(--font-ui)`, `var(--font-text)`.\n\n## Rules (write_artifact checks them, and refuses a file that breaks one)\n\n1. Every file read (`data=\"…\"`, `src=\"…\"`, `iso.data(\"…\")`) is in `uses`, and exists: call `read_data` first.\n2. Every column named is in its file, spelt as `read_data` gives it.\n3. No colour, font family or border-radius of its own: no `#hex`, `rgb(…)`, `white`, `Arial`. Use the tokens.\n4. No network: no `http…` address, no `<script src>`, no `fetch`. The kit is given; everything else is in the file.\n5. Under 200 kB: data stays in data files.\n6. No text that tells how to use it (\"drag to rotate\", \"click here\"): a label says what a thing is.\n\n## What good is\n\nEvery panel answers a question about the data, with a caption saying what to see. Numbers are read out. Axes say what they measure, with units. Controls change what is drawn at once. Nothing is decoration.\n";
+	RECIPES = {
+		"dashboard": {
+			"about": "a dashboard of one data file: numbers, charts and a table, in markup only",
+			"html": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>The pendulum's period</title>\n<meta name=\"description\" content=\"Forty timed swings at eight lengths: how the period grows with length, how close it comes to 2π√(L/g), and how much the trials scatter.\">\n<meta name=\"isorite:kit\" content=\"1\">\n<meta name=\"isorite:uses\" content=\"pendulum.csv\">\n</head>\n<body>\n<!-- Recipe 1: a dashboard of one data file, in markup only. Change: the file, the numbers, the charts' columns, the\n     captions. Every column named here must be one read_data gave. -->\n<iso-page>\n  <header>\n    <h1>The pendulum's period</h1>\n    <p>Does a longer pendulum swing slower, and by as much as theory says?</p>\n  </header>\n  <iso-grid>\n    <iso-panel class=\"wide\">\n      <h2>In numbers <span>40 swings</span></h2>\n      <iso-stats>\n        <iso-stat data=\"pendulum.csv\" column=\"period_s\" of=\"min\" label=\"shortest period (s)\" tone=\"blue\"></iso-stat>\n        <iso-stat data=\"pendulum.csv\" column=\"period_s\" of=\"max\" label=\"longest period (s)\" tone=\"gold\"></iso-stat>\n        <iso-stat data=\"pendulum.csv\" column=\"temp_c\" of=\"mean\" label=\"mean temperature (°C)\"></iso-stat>\n        <iso-stat data=\"pendulum.csv\" column=\"trial\" of=\"count\" label=\"swings timed\"></iso-stat>\n      </iso-stats>\n    </iso-panel>\n    <iso-panel>\n      <h2>Period against length</h2>\n      <iso-chart data=\"pendulum.csv\" type=\"dot\" x=\"length_m\" y=\"period_s\" x-label=\"length (m)\" y-label=\"period (s)\"></iso-chart>\n      <p>The period rises with length, more slowly as the pendulum gets longer: a square root.</p>\n    </iso-panel>\n    <iso-panel>\n      <h2>On log axes <span>slope ½ is √L</span></h2>\n      <iso-chart data=\"pendulum.csv\" type=\"dot\" x=\"length_m\" y=\"period_s\" x-scale=\"log\" y-scale=\"log\" x-label=\"length (m)\" y-label=\"period (s)\"></iso-chart>\n      <p>A straight line here is a power law; its slope, near one half, is the exponent.</p>\n    </iso-panel>\n    <iso-panel class=\"wide\">\n      <h2>Each trial <span>the scatter is the stopwatch</span></h2>\n      <iso-chart data=\"pendulum.csv\" type=\"line\" x=\"length_m\" y=\"period_s\" by=\"trial\" height=\"200\" x-label=\"length (m)\" y-label=\"period (s)\"></iso-chart>\n    </iso-panel>\n    <iso-panel class=\"wide\">\n      <h2>The measurements</h2>\n      <iso-table data=\"pendulum.csv\" columns=\"length_m trial period_s temp_c\" limit=\"40\"></iso-table>\n    </iso-panel>\n  </iso-grid>\n</iso-page>\n</body>\n</html>\n"
+		},
+		"compare": {
+			"about": "two data files with the same columns, compared: together on one chart, and side by side",
+			"html": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>A lid against an open mug</title>\n<meta name=\"description\" content=\"Two mugs of the same coffee cooling for an hour, one with a lid: their temperature together, the gap between them, and where each stands at a chosen minute.\">\n<meta name=\"isorite:kit\" content=\"1\">\n<meta name=\"isorite:uses\" content=\"mug-open.csv mug-lid.csv\">\n</head>\n<body>\n<!-- Recipe 2: comparing two data files with the same columns. data=\"a.csv b.csv\" reads both as one table with a\n     column `file` (\"mug-open\", \"mug-lid\"), so by=\"file\" draws one series each and where=\"file=…\" picks one.\n     Change: the files, the columns, the captions. -->\n<iso-page>\n  <header>\n    <h1>A lid against an open mug</h1>\n    <p>How much longer does a lid keep coffee hot?</p>\n  </header>\n  <iso-grid>\n    <iso-panel class=\"wide\">\n      <h2>At one minute</h2>\n      <iso-row>\n        <iso-slider name=\"t\" label=\"minute\" min=\"0\" max=\"60\" step=\"2\" value=\"20\" digits=\"0\"></iso-slider>\n        <iso-select name=\"scale\" label=\"temperature scale\" options=\"linear log\"></iso-select>\n      </iso-row>\n      <iso-stats>\n        <iso-stat data=\"mug-open.csv\" column=\"temp_c\" of=\"last\" where=\"t_min<=$t\" label=\"open (°C)\" tone=\"blue\"></iso-stat>\n        <iso-stat data=\"mug-lid.csv\" column=\"temp_c\" of=\"last\" where=\"t_min<=$t\" label=\"with a lid (°C)\" tone=\"gold\"></iso-stat>\n        <iso-stat data=\"mug-open.csv\" column=\"temp_c\" of=\"last\" label=\"open after the hour (°C)\"></iso-stat>\n        <iso-stat data=\"mug-lid.csv\" column=\"temp_c\" of=\"last\" label=\"lid after the hour (°C)\"></iso-stat>\n      </iso-stats>\n    </iso-panel>\n    <iso-panel class=\"wide\">\n      <h2>Both, cooling</h2>\n      <iso-chart data=\"mug-open.csv mug-lid.csv\" x=\"t_min\" y=\"temp_c\" by=\"file\" at=\"t\" y-scale=\"$scale\" x-label=\"time (min)\" y-label=\"temperature (°C)\" height=\"300\"></iso-chart>\n      <p>Both fall fast at first and slower as they near the room's 21 °C; the lid halves the early loss.</p>\n    </iso-panel>\n    <iso-panel>\n      <h2>Open</h2>\n      <iso-table data=\"mug-open.csv\" limit=\"12\"></iso-table>\n    </iso-panel>\n    <iso-panel>\n      <h2>With a lid</h2>\n      <iso-table data=\"mug-lid.csv\" limit=\"12\"></iso-table>\n    </iso-panel>\n  </iso-grid>\n</iso-page>\n</body>\n</html>\n"
+		},
+		"simulation": {
+			"about": "a simulation with parameters, play and reset, drawn on a canvas, with a live chart (a script)",
+			"html": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>A damped spring</title>\n<meta name=\"description\" content=\"A mass on a spring, integrated live: change the stiffness and the damping and see the motion, the energy draining away, and the period against theory's.\">\n<meta name=\"isorite:kit\" content=\"1\">\n<meta name=\"isorite:uses\" content=\"\">\n<style>\n  /* Layout only. */\n  .readout { margin-top: 12px; }\n</style>\n</head>\n<body>\n<!-- Recipe 3: a simulation with parameters and play. The parts to change are marked CHANGE: the state (what the\n     model is), step() (how it moves), draw() (what's on the canvas), and what's measured. The rest stays. -->\n<iso-page>\n  <header>\n    <h1>A damped spring</h1>\n    <p>How do stiffness and damping shape an oscillation?</p>\n  </header>\n  <iso-grid>\n    <iso-panel class=\"wide\">\n      <h2>The model</h2>\n      <iso-row>\n        <iso-slider name=\"k\" label=\"stiffness k (N/m)\" min=\"1\" max=\"40\" step=\"0.5\" value=\"10\" digits=\"1\"></iso-slider>\n        <iso-slider name=\"c\" label=\"damping c (kg/s)\" min=\"0\" max=\"2\" step=\"0.05\" value=\"0.3\" digits=\"2\"></iso-slider>\n      </iso-row>\n      <iso-row>\n        <iso-toggle name=\"playing\" label=\"play\" value=\"true\"></iso-toggle>\n        <button type=\"button\" class=\"iso-button\" id=\"reset\">reset</button>\n      </iso-row>\n      <iso-stats class=\"readout\">\n        <iso-stat id=\"time\" label=\"time (s)\"></iso-stat>\n        <iso-stat id=\"energy\" label=\"energy left\" tone=\"gold\"></iso-stat>\n        <iso-stat id=\"period\" label=\"period, theory (s)\" tone=\"blue\"></iso-stat>\n      </iso-stats>\n    </iso-panel>\n    <iso-panel>\n      <h2>The mass</h2>\n      <iso-canvas id=\"scene\" height=\"300\"></iso-canvas>\n    </iso-panel>\n    <iso-panel>\n      <h2>Energy <span>a share of the start</span></h2>\n      <iso-chart id=\"chart\" x=\"t\" y=\"energy\" x-label=\"time (s)\" y-label=\"energy left\" height=\"300\"></iso-chart>\n      <p>With no damping the energy stays; damping drains it, faster the larger c is.</p>\n    </iso-panel>\n  </iso-grid>\n</iso-page>\n<script>\n  // CHANGE: the model's state and its start.\n  const m = 1;\n  let s, history;\n  function reset() { s = { t: 0, x: 1, v: 0 }; history = []; }\n  reset();\n  const energy = () => 0.5 * m * s.v * s.v + 0.5 * iso.state.k * s.x * s.x;\n  let e0 = energy();\n\n  // CHANGE: one step of the model (here semi-implicit Euler, small steps).\n  function step(dt) {\n    const a = (-iso.state.k * s.x - iso.state.c * s.v) / m;\n    s.v += a * dt;\n    s.x += s.v * dt;\n    s.t += dt;\n  }\n\n  // CHANGE: what's drawn. t is the theme: t.line, t.text, t.soft, t.faint, t.lattice, t.growth, t.ui.\n  const scene = document.getElementById(\"scene\");\n  scene.draw = (ctx, w, h, t) => {\n    const cx = w / 2, y0 = 24, rest = h * 0.5, y = rest + s.x * h * 0.3;\n    ctx.strokeStyle = t.line; ctx.lineWidth = 1;\n    ctx.beginPath(); ctx.moveTo(cx - 60, y0); ctx.lineTo(cx + 60, y0); ctx.stroke();\n    ctx.setLineDash([3, 4]); ctx.beginPath(); ctx.moveTo(cx - 80, rest); ctx.lineTo(cx + 80, rest); ctx.stroke(); ctx.setLineDash([]);\n    // The spring, as a zigzag from the ceiling to the mass.\n    ctx.strokeStyle = t.soft; ctx.lineWidth = 1.5; ctx.beginPath(); ctx.moveTo(cx, y0);\n    for (let i = 1; i < 16; i++) ctx.lineTo(cx + (i % 2 ? 12 : -12), y0 + (y - 20 - y0) * i / 16);\n    ctx.lineTo(cx, y - 20); ctx.stroke();\n    ctx.fillStyle = t.lattice; ctx.fillRect(cx - 20, y - 20, 40, 40);\n    ctx.fillStyle = t.faint; ctx.font = `11px ${t.ui}`; ctx.fillText(\"rest\", cx + 84, rest + 4);\n  };\n\n  // Measured, and shown: the readouts and the chart, a few times a second.\n  const chart = document.getElementById(\"chart\");\n  let since = 0;\n  function show() {\n    document.getElementById(\"time\").value = s.t.toFixed(1);\n    document.getElementById(\"energy\").value = iso.format(energy() / e0);\n    document.getElementById(\"period\").value = iso.format(2 * Math.PI * Math.sqrt(m / iso.state.k));\n    chart.rows = history;\n  }\n\n  iso.loop((dt) => {\n    if (!iso.state.playing) return;\n    for (let i = 0; i < 20; i++) step(dt / 20);\n    scene.redraw();\n    since += dt;\n    if (since > 0.1) { since = 0; history.push({ t: +s.t.toFixed(2), energy: energy() / e0 }); if (history.length > 600) history.shift(); show(); }\n  });\n  iso.watch((name) => { if (name === \"k\") { e0 = energy(); } show(); scene.redraw(); });\n  document.getElementById(\"reset\").addEventListener(\"click\", () => { reset(); e0 = energy(); show(); scene.redraw(); });\n  show();\n<\/script>\n</body>\n</html>\n"
+		},
+		"explorable": {
+			"about": "an explorable explanation: inputs, numbers derived from them, and linked views (a script)",
+			"html": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>Why a fast wheel turns backwards</title>\n<meta name=\"description\" content=\"Sample a sine too slowly and a slower one appears: choose the signal's frequency and the sampling rate, and see the samples, the wave they seem to come from, and where every frequency lands.\">\n<meta name=\"isorite:kit\" content=\"1\">\n<meta name=\"isorite:uses\" content=\"\">\n</head>\n<body>\n<!-- Recipe 4: an explorable explanation. An input, numbers derived from it, and linked views that all follow the same\n     state; captions say what to see. CHANGE: the inputs (sliders), derive() (the numbers), the drawing, and the\n     chart's rows. Keep: every view redrawn from iso.state in one place, update(). -->\n<iso-page>\n  <header>\n    <h1>Why a fast wheel turns backwards</h1>\n    <p>Sampled too slowly, a signal is indistinguishable from a slower one. Which one, and when?</p>\n  </header>\n  <iso-grid>\n    <iso-panel class=\"wide\">\n      <h2>The signal and the sampling</h2>\n      <iso-row>\n        <iso-slider name=\"f\" label=\"signal (Hz)\" min=\"0.2\" max=\"12\" step=\"0.1\" value=\"7\" digits=\"1\"></iso-slider>\n        <iso-slider name=\"fs\" label=\"samples per second\" min=\"2\" max=\"24\" step=\"1\" value=\"8\" digits=\"0\"></iso-slider>\n      </iso-row>\n      <iso-stats>\n        <iso-stat id=\"nyquist\" label=\"Nyquist limit (Hz)\" tone=\"blue\"></iso-stat>\n        <iso-stat id=\"apparent\" label=\"what the samples show (Hz)\" tone=\"gold\"></iso-stat>\n        <iso-stat id=\"verdict\" label=\"faithful?\"></iso-stat>\n      </iso-stats>\n    </iso-panel>\n    <iso-panel class=\"wide\">\n      <h2>One second <span>the signal, its samples, and the slower wave through them</span></h2>\n      <iso-canvas id=\"wave\" height=\"260\"></iso-canvas>\n      <p>Gold dots are the samples. Above the Nyquist limit the blue wave, slower, passes through every one of them as\n        well as the true signal does: from the samples alone, the two can't be told apart.</p>\n    </iso-panel>\n    <iso-panel class=\"wide\">\n      <h2>Where every frequency lands</h2>\n      <iso-chart id=\"fold\" x=\"signal\" y=\"apparent\" at=\"f\" x-label=\"signal (Hz)\" y-label=\"frequency the samples show (Hz)\" height=\"220\"></iso-chart>\n      <p>The frequency seen climbs with the signal's up to half the sampling rate, then folds back down:\n        $f_\\text{seen} = |f - f_s \\operatorname{round}(f / f_s)|$. See <iso-note href=\"signals/sampling\">sampling</iso-note>.</p>\n    </iso-panel>\n  </iso-grid>\n</iso-page>\n<script>\n  // CHANGE: the numbers derived from the inputs.\n  function derive(f, fs) {\n    const nyquist = fs / 2;\n    const folded = Math.abs(f - fs * Math.round(f / fs));\n    return { nyquist, apparent: folded, faithful: f < nyquist };\n  }\n\n  // CHANGE: the drawing. t is the theme (t.line, t.soft, t.faint, t.lattice, t.growth, t.ui).\n  const wave = document.getElementById(\"wave\");\n  wave.draw = (ctx, w, h, t) => {\n    const { f, fs } = iso.state, d = derive(f, fs), mid = h / 2, amp = h * 0.38;\n    const X = (s) => 40 + s * (w - 60), Y = (v) => mid - v * amp;\n    ctx.strokeStyle = t.line; ctx.lineWidth = 1;\n    ctx.beginPath(); ctx.moveTo(X(0), mid); ctx.lineTo(X(1), mid); ctx.stroke();\n    const curve = (freq, colour, width) => {\n      ctx.strokeStyle = colour; ctx.lineWidth = width; ctx.beginPath();\n      for (let i = 0; i <= 600; i++) { const s = i / 600, v = Math.sin(2 * Math.PI * freq * s); i ? ctx.lineTo(X(s), Y(v)) : ctx.moveTo(X(s), Y(v)); }\n      ctx.stroke();\n    };\n    curve(f, t.soft, 1);\n    // The slower wave through the same samples: the signal less the nearest whole number of sampling rates.\n    if (!d.faithful) curve(f - fs * Math.round(f / fs), t.lattice, 2);\n    ctx.fillStyle = t.growth;\n    for (let k = 0; k <= fs; k++) { const s = k / fs; ctx.beginPath(); ctx.arc(X(s), Y(Math.sin(2 * Math.PI * f * s)), 4, 0, 2 * Math.PI); ctx.fill(); }\n    ctx.fillStyle = t.faint; ctx.font = `11px ${t.ui}`; ctx.fillText(\"0 s\", X(0) - 8, h - 6); ctx.fillText(\"1 s\", X(1) - 8, h - 6);\n  };\n\n  // One place redraws every view from the state.\n  const fold = document.getElementById(\"fold\");\n  function update() {\n    const { f, fs } = iso.state, d = derive(f, fs);\n    document.getElementById(\"nyquist\").value = iso.format(d.nyquist);\n    document.getElementById(\"apparent\").value = iso.format(d.apparent);\n    document.getElementById(\"verdict\").value = d.faithful ? \"yes\" : \"no: aliased\";\n    // CHANGE: the chart's rows, computed from the state.\n    const rows = [];\n    for (let s = 0; s <= 12; s += 0.05) rows.push({ signal: +s.toFixed(2), apparent: derive(s, fs).apparent });\n    fold.rows = rows;\n    wave.redraw();\n  }\n  iso.watch(update);\n  update();\n<\/script>\n</body>\n</html>\n"
+		},
+		"viewer": {
+			"about": "a 3D model's viewer (glTF, GLB, STL, OBJ), with what it is beside it",
+			"html": "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>The corner bracket</title>\n<meta name=\"description\" content=\"The printed corner bracket in 3D, with its dimensions and the notes on how it was designed and tested.\">\n<meta name=\"isorite:kit\" content=\"1\">\n<meta name=\"isorite:uses\" content=\"bracket.stl\">\n</head>\n<body>\n<!-- Recipe 5: a 3D model's viewer, with what it is beside it. iso-model shows glTF, GLB, STL and OBJ; list the file\n     in isorite:uses. CHANGE: the model's file, the numbers, the notes it links to. -->\n<iso-page>\n  <header>\n    <h1>The corner bracket</h1>\n    <p>The part as printed: an L of two plates, 6 cm by 5 cm.</p>\n  </header>\n  <iso-grid style=\"--cols: 3\">\n    <iso-panel class=\"wide\">\n      <h2>The part <span>bracket.stl</span></h2>\n      <iso-model src=\"bracket.stl\" height=\"380\"></iso-model>\n    </iso-panel>\n    <iso-panel>\n      <h2>Size</h2>\n      <iso-stats>\n        <iso-stat label=\"long arm (mm)\" value=\"60\" tone=\"blue\"></iso-stat>\n        <iso-stat label=\"short arm (mm)\" value=\"50\"></iso-stat>\n        <iso-stat label=\"thickness (mm)\" value=\"10\"></iso-stat>\n      </iso-stats>\n    </iso-panel>\n    <iso-panel>\n      <h2>Printed</h2>\n      <iso-stats>\n        <iso-stat label=\"infill\" value=\"40%\"></iso-stat>\n        <iso-stat label=\"mass (g)\" value=\"31\" tone=\"gold\"></iso-stat>\n      </iso-stats>\n    </iso-panel>\n    <iso-panel>\n      <h2>Notes</h2>\n      <p><iso-note href=\"design/bracket-loads\">The loads it takes</iso-note>, and\n        <iso-note href=\"design/print-settings\">how it was printed</iso-note>.</p>\n    </iso-panel>\n  </iso-grid>\n</iso-page>\n</body>\n</html>\n"
+		}
+	};
+}));
+//#endregion
+//#region packages/kit/src/index.ts
+var init_src$2 = __esmMin((() => {
+	init_assemble();
+	init_rules();
+	init_data();
+	init_context_gen();
+}));
+//#endregion
 //#region packages/core/src/text.ts
 /** Compare by code point, as Python sorts strings. */
 function cmp(a, b) {
@@ -488,7 +824,7 @@ function pictureSize(bytes, type) {
 	} catch {}
 	return null;
 }
-var TYPES$1, pictureType;
+var TYPES$1, pictureType, OTHER, fileType;
 var init_picture = __esmMin((() => {
 	TYPES$1 = {
 		png: "image/png",
@@ -503,6 +839,36 @@ var init_picture = __esmMin((() => {
 		const dot = path.lastIndexOf(".");
 		return dot < 0 || path.lastIndexOf("/") > dot ? null : TYPES$1[path.slice(dot + 1).toLowerCase()] ?? null;
 	};
+	OTHER = {
+		html: "text/html",
+		htm: "text/html",
+		csv: "text/csv",
+		tsv: "text/tab-separated-values",
+		json: "application/json",
+		jsonl: "application/jsonl",
+		ndjson: "application/x-ndjson",
+		txt: "text/plain",
+		tex: "text/plain",
+		pdf: "application/pdf",
+		glb: "model/gltf-binary",
+		gltf: "model/gltf+json",
+		stl: "model/stl",
+		obj: "model/obj",
+		zip: "application/zip",
+		parquet: "application/vnd.apache.parquet",
+		arrow: "application/vnd.apache.arrow.file",
+		npy: "application/octet-stream",
+		xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+		docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+		epub: "application/epub+zip",
+		odt: "application/vnd.oasis.opendocument.text"
+	};
+	fileType = (path) => {
+		const dot = path.lastIndexOf(".");
+		if (dot < 0 || path.lastIndexOf("/") > dot) return null;
+		const ext = path.slice(dot + 1).toLowerCase();
+		return ext === "md" ? null : pictureType(path) ?? OTHER[ext] ?? "application/octet-stream";
+	};
 }));
 //#endregion
 //#region packages/core/src/kinds.ts
@@ -613,16 +979,24 @@ var init_kinds = __esmMin((() => {
 function comparePaths(a, b) {
 	return cmpTuple(a.split("/"), b.split("/"));
 }
-var AGENTS_FILE, ARTIFACT, IMAGE, citeKind, isEntry, Concept, Directory, SCHEME, LOG_DATE, Bundle, oneLine, escape;
+var AGENTS_FILE, KINDS$2, citeKind, isEntry, Concept, Directory, SCHEME, LOG_DATE, Bundle, oneLine, escape;
 var init_bundle = __esmMin((() => {
 	init_frontmatter();
 	init_markdown();
 	init_kinds();
 	init_text();
 	AGENTS_FILE = "AGENTS.md";
-	ARTIFACT = /\.html?$/i;
-	IMAGE = /\.(png|jpe?g|gif|svg|webp|avif)$/i;
-	citeKind = (path) => ARTIFACT.test(path) ? "artifact" : IMAGE.test(path) ? "image" : null;
+	KINDS$2 = [
+		["artifact", /\.html?$/i],
+		["image", /\.(png|jpe?g|gif|svg|webp|avif)$/i],
+		["data", /\.(csv|tsv|json|jsonl|ndjson|parquet|arrow|feather|npy|npz|xlsx|xls|h5|hdf5|nc)$/i],
+		["document", /\.(pdf|docx?|odt|rtf|epub|pptx?|odp|txt|tex)$/i]
+	];
+	citeKind = (path) => {
+		const name = basename$1(path);
+		if (/\.md$/i.test(name) || !/\.[^.]+$/.test(name.replace(/^\./, ""))) return null;
+		return KINDS$2.find(([, re]) => re.test(name))?.[0] ?? "misc";
+	};
 	isEntry = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 	Concept = class {
 		id;
@@ -1196,6 +1570,79 @@ var init_source = __esmMin((() => {
 	};
 }));
 //#endregion
+//#region packages/core/src/unwrap.ts
+function unwrap(text) {
+	const lines = text.split("\n"), out = [];
+	let i = 0, fence = "", maths = false;
+	/** What the last line written may be continued by: prose, a quoted line, or nothing. */
+	let open = "";
+	if (lines[0] === "---") {
+		const end = lines.indexOf("---", 1);
+		if (end > 0) {
+			out.push(...lines.slice(0, end + 1));
+			i = end + 1;
+		}
+	}
+	for (; i < lines.length; i++) {
+		const l = lines[i], t = l.trim();
+		if (fence) {
+			out.push(l);
+			if (t.startsWith(fence)) fence = "";
+			continue;
+		}
+		if (maths) {
+			out.push(l);
+			if (t.endsWith("$$")) maths = false;
+			continue;
+		}
+		if (t.startsWith("```") || t.startsWith("~~~")) {
+			fence = t.slice(0, 3);
+			out.push(l);
+			open = "";
+			continue;
+		}
+		if (t.startsWith("$$") && !t.slice(2).includes("$$")) {
+			maths = true;
+			out.push(l);
+			open = "";
+			continue;
+		}
+		if (!t) {
+			out.push(l);
+			open = "";
+			continue;
+		}
+		const hard = /( {2}|\\)$/.test(out.at(-1) ?? "");
+		if (APART.test(l)) {
+			if (open === "quote" && QUOTED.test(l) && !/^\s*>\s*([-*+]|\d+[.)]|#)/.test(l) && !hard) {
+				out[out.length - 1] += " " + l.replace(/^\s*>\s?/, "").trim();
+				continue;
+			}
+			out.push(l);
+			open = QUOTED.test(l) ? "quote" : "";
+			continue;
+		}
+		if (ITEM.test(l)) {
+			out.push(l);
+			open = "prose";
+			continue;
+		}
+		if (open === "prose" && !hard) {
+			out[out.length - 1] += " " + t;
+			continue;
+		}
+		out.push(l);
+		open = open === "" && /^( {4}|\t)/.test(l) ? "" : "prose";
+	}
+	return out.join("\n");
+}
+var ITEM, APART, QUOTED;
+var init_unwrap = __esmMin((() => {
+	ITEM = /^\s*([-*+]|\d+[.)])\s+/;
+	APART = /^\s*(#{1,6}\s|\||<|```|~~~|\$\$|>|---\s*$|\*\*\*\s*$|___\s*$|\[[^\]]+\]:\s)/;
+	QUOTED = /^\s*>\s?\S/;
+}));
+//#endregion
 //#region packages/core/src/search.ts
 function stem(token) {
 	for (const suffix of ["ness", "ing"]) if (token.endsWith(suffix) && token.length - suffix.length >= 4) return token.slice(0, -suffix.length);
@@ -1719,16 +2166,21 @@ function written$1(note, p, region) {
 	lines.splice(at, 0, ...blank(at - 1) ? [] : [""], ...ins, ...blank(at) ? [] : [""]);
 	return lines.join("\n");
 }
-/** The journal as the timeline shows it. Your own edits in a row within a session are one moment; a proposal is
-*  one moment whose `what` says how it ended. Revisions are not moments. */
+/** The journal as the timeline shows it. Your own edits in a row within a session are one moment, until ten minutes
+*  pass with none (LAYER_IDLE_MS); a proposal is one moment whose `what` says how it ended. Revisions are not
+*  moments. */
 function moments(entries) {
 	const out = [], offered = /* @__PURE__ */ new Map(), asked = /* @__PURE__ */ new Map();
+	/** Lines a change put in and took out: a note's first entry, all of its text. */
+	const size = (c) => c.why === "start" || !c.hunks.length && c.before === null ? [(c.text ?? "").split("\n").length, 0] : [c.hunks.reduce((n, h) => n + h.ins.length, 0), c.hunks.reduce((n, h) => n + h.del.length, 0)];
 	for (const e of entries) {
 		const base = {
 			ids: [e.id],
 			at: e.at,
 			session: e.session,
-			who: e.who
+			who: e.who,
+			added: 0,
+			removed: 0
 		};
 		if (e.kind === "proposal") {
 			const m = {
@@ -1747,22 +2199,29 @@ function moments(entries) {
 			}
 		} else if (e.kind === "change") {
 			const m = e.proposal ? offered.get(e.proposal) : void 0;
+			const [added, removed] = size(e);
 			if (e.why === "keep" && m) {
 				m.what = "kept";
 				m.ids.push(e.id);
 				m.at = e.at;
+				m.added += added;
+				m.removed += removed;
 				continue;
 			}
 			const last = out[out.length - 1];
-			if (e.why === "edit" && last && last.what === "edited" && last.who === e.who && last.session === e.session) {
+			if (e.why === "edit" && last && last.what === "edited" && last.who === e.who && last.session === e.session && Date.parse(e.at) - Date.parse(last.at) <= 6e5) {
 				last.ids.push(e.id);
 				last.at = e.at;
+				last.added += added;
+				last.removed += removed;
 				continue;
 			}
 			const what = e.why === "start" ? e.who === "external" ? "found" : "wrote" : e.why === "edit" ? "edited" : e.why === "restore" ? "restored" : e.why === "keep" ? "kept" : e.why === "move" ? "moved" : "changed elsewhere";
 			out.push({
 				...base,
 				what,
+				added,
+				removed,
 				...e.asked ? { asked: e.asked } : {}
 			});
 		}
@@ -1884,10 +2343,54 @@ function mapModel(base) {
 		]);
 	}
 	const holdsFiles = /* @__PURE__ */ new Set();
-	for (const f of base.files) holdsFiles.add(f.includes("/") ? f.slice(0, f.lastIndexOf("/")) : "");
+	const parentOf = (p) => p.includes("/") ? p.slice(0, p.lastIndexOf("/")) : "";
+	for (const f of base.files) holdsFiles.add(parentOf(f));
+	const pictureFolder = (d) => {
+		const dd = base.directories.get(d);
+		const here = [...base.files].filter((f) => parentOf(f) === d);
+		return !!d && (!dd || !dd.concepts.length && !dd.children.length) && here.length > 0 && here.every((f) => citeKind(f) === "image");
+	};
+	const refOf = (f) => citeKind(f) === "image" && pictureFolder(parentOf(f)) ? parentOf(f) + "/" : f;
+	const fileEdges = /* @__PURE__ */ new Map();
+	for (const c of base.concepts.values()) for (const x of c.cites) {
+		if (x.broken || !base.files.has(x.target)) continue;
+		const ref = refOf(x.target);
+		if (!fileEdges.has(c.id)) fileEdges.set(c.id, /* @__PURE__ */ new Set());
+		fileEdges.get(c.id).add(ref);
+	}
+	const rankOf = /* @__PURE__ */ new Map();
+	for (const [from, refs] of fileEdges) for (const ref of refs) {
+		edges.push([
+			from,
+			ref,
+			STRENGTH.uses
+		]);
+		rankOf.set(ref, Math.max(rankOf.get(ref) ?? 0, order.get(from)?.depth ?? 0));
+	}
+	const filesIn = /* @__PURE__ */ new Map();
+	for (const f of [...base.files].sort()) {
+		const of = citeKind(f), ref = of ? refOf(f) : null;
+		if (!of || !ref) continue;
+		const at = ref.endsWith("/") ? parentOf(ref.slice(0, -1)) : parentOf(f);
+		const list = filesIn.get(at) ?? [];
+		if (!list.some((n) => n.ref === ref)) list.push({
+			kind: "concept",
+			id: "f:" + ref,
+			ref,
+			weight: 1,
+			rank: rankOf.get(ref) ?? 0,
+			of
+		});
+		filesIn.set(at, list);
+	}
 	const dir = (id) => {
 		const d = base.directories.get(id);
-		const children = [...[...d.children].sort().map(dir).filter((c) => c !== null), ...[...d.concepts].sort().map(note)];
+		if (id && pictureFolder(id)) return null;
+		const children = [
+			...[...d.children].sort().map(dir).filter((c) => c !== null),
+			...[...d.concepts].sort().map(note),
+			...filesIn.get(id) ?? []
+		];
 		return id && !children.length && (holdsFiles.has(id) || d.children.length) ? null : {
 			kind: "dir",
 			id: "d:" + id,
@@ -1901,6 +2404,7 @@ function mapModel(base) {
 	};
 }
 var init_map = __esmMin((() => {
+	init_bundle();
 	init_graph();
 }));
 //#endregion
@@ -1911,6 +2415,7 @@ var init_src$1 = __esmMin((() => {
 	init_frontmatter();
 	init_source();
 	init_markdown();
+	init_unwrap();
 	init_text();
 	init_search();
 	init_record();
@@ -1925,6 +2430,7 @@ var init_src$1 = __esmMin((() => {
 }));
 //#endregion
 //#region packages/core/src/node.ts
+init_src$2();
 init_src$1();
 init_bundle();
 init_text();
@@ -2111,7 +2617,8 @@ async function completeOnce(http, p, key, call, heard) {
 		...call.tools?.length ? {
 			tools: call.tools,
 			tool_choice: call.toolChoice ?? "auto"
-		} : {}
+		} : {},
+		...call.effort && p.name === OPENROUTER.name ? { reasoning: { effort: call.effort } } : {}
 	});
 	let res;
 	try {
@@ -2369,13 +2876,14 @@ async function rounds(o) {
 	let firstIn = 0;
 	for (let round = 0, calls = 1;; round++, calls++) {
 		let first = true;
-		const ask = (maxTokens) => complete(o.http, o.provider, o.key, {
+		const ask = (maxTokens, effort) => complete(o.http, o.provider, o.key, {
 			model,
 			messages,
 			maxTokens,
 			tools: most ? o.lookup.defs() : [],
 			toolChoice: round < most ? "auto" : "none",
 			signal: o.signal,
+			...effort ? { effort } : {},
 			onText: (piece) => {
 				o.onText(piece, first && round > 0);
 				first = false;
@@ -2392,10 +2900,14 @@ async function rounds(o) {
 		add(r);
 		if (round === 0) firstIn = r.usage.tokensIn;
 		if (empty(r)) {
-			r = await ask(o.maxTokens * 3);
+			r = await ask(o.maxTokens * 3, "low");
 			add(r);
 			if (empty(r)) throw new ModelError(`${model} used its whole output budget (${Math.max(o.maxTokens * 3, o.provider.maxTokens ?? 0)} tokens) thinking, and wrote nothing. Try a lower tier, or raise max_tokens under [provider] in config.toml.`, 502, { kind: "cut" });
 		}
+		if (!r.text.trim() && !r.calls.length && !r.cut) {
+			r = await ask(o.maxTokens);
+			add(r);
+		}
 		if (!r.calls.length || round >= most) return {
 			text: r.text,
 			usage,
@@ -2627,7 +3139,7 @@ function parseRewrite(reply, count) {
 /** A passage's new text, set between the same neighbours as the old: it keeps the old one's space and line
 *  breaks at either end, whatever the model put round what it wrote. An empty one takes the passage out. */
 function fitted(old, text) {
-	const core = text.trim();
+	const core = unwrap(text.trim());
 	if (!core) return "";
 	return /^\s*/.exec(old)[0] + core + /\s*$/.exec(old)[0];
 }
@@ -2686,7 +3198,7 @@ function replyText(reply) {
 	let text = reply.replaceAll(HERE, "").replace(/^\s*\n/, "").trimEnd();
 	const fenced = /^```(?:markdown|md)?\n([\s\S]*)\n```$/.exec(text.trim());
 	if (fenced) text = fenced[1];
-	return text.trim();
+	return unwrap(text.trim());
 }
 var HERE, WHO$1, INSERT, OPEN, CLOSE, SAY_OPEN, SAY_CLOSE, REWRITE, NOTE, FORMAT, FORMAT_RULES, LOOKUP, estimate, CONVERSATION_BUDGET, NOTE_BUDGET, OLD_EXCHANGE, NO_LOOKUP, looked, LINKED_BUDGET;
 var init_iso = __esmMin((() => {
@@ -2781,6 +3293,8 @@ something at one place in the note they have open.`;
 - A picture is shown as ![what it shows](its/path.png). You can't see it: what
   you know of it is the words in the brackets. Keep a picture's line as it is
   when you rewrite around it, and never make up a picture's path.
+- A paragraph or a list item is one line, however long: do not break lines at
+  a width. The editor wraps them to the pane.
 - Ordinary Markdown otherwise. No HTML.`;
 	FORMAT_RULES = FORMAT;
 	LOOKUP = (rounds, meaning) => `# Looking things up
@@ -3098,38 +3612,6 @@ var init_lookup = __esmMin((() => {
 	};
 }));
 //#endregion
-//#region packages/engine/src/understand.ts
-/** The two parts of an Understanding note's file. A file in another shape is read as all scratchpad. */
-function parseUnderstanding(text) {
-	if (!text) return {
-		reading: "",
-		scratchpad: ""
-	};
-	const body = text.replace(/^---\n[\s\S]*?\n---\n/, "");
-	const r = body.indexOf(READING$1), p = body.indexOf(PAD);
-	if (r < 0 && p < 0) return {
-		reading: "",
-		scratchpad: body.trim()
-	};
-	return {
-		reading: r < 0 ? "" : body.slice(r + 16, p > r ? p : void 0).trim(),
-		scratchpad: p < 0 ? "" : body.slice(p + 13, r > p ? r : void 0).trim()
-	};
-}
-/** An Understanding note's file, from its parts. */
-function understandingText(note, title, parts) {
-	return `---\ntype: Understanding\ntitle: ${JSON.stringify(`Understanding · ${title}`)}\nof: ${note}\n---\n\n${READING$1}\n\n${parts.reading.trim()}\n\n${PAD}\n\n${parts.scratchpad.trim()}\n`;
-}
-var UNDERSTANDING_PREFIX, UNDERSTANDING_DIR, isUnderstandingId, understandingId, READING$1, PAD;
-var init_understand = __esmMin((() => {
-	UNDERSTANDING_PREFIX = "@understanding/";
-	UNDERSTANDING_DIR = "understanding";
-	isUnderstandingId = (id) => id.startsWith(UNDERSTANDING_PREFIX);
-	understandingId = (note) => UNDERSTANDING_PREFIX + note;
-	READING$1 = "## Iso's reading";
-	PAD = "## Scratchpad";
-}));
-//#endregion
 //#region packages/engine/src/hand.ts
 /** The lines about the working set in a conversation's file, in order. Turns' own lines are passed over. */
 function readHand(text) {
@@ -3250,6 +3732,7 @@ function readTurns(text) {
 			turns.set(t.id, {
 				...t,
 				mode: MODES.includes(t.mode) ? t.mode : "ask",
+				given: (t.given ?? []).filter((g) => GIVEN.includes(g.kind)),
 				items: [],
 				state: "running"
 			});
@@ -3258,7 +3741,7 @@ function readTurns(text) {
 		const t = turns.get(line.turn);
 		if (!t) continue;
 		if (line.kind === "item") {
-			if (ITEMS.includes(line.item.kind)) t.items.push(line.item);
+			if (ITEMS.includes(line.item.kind) && !(line.item.kind === "change" && line.item.note.startsWith("@understanding/"))) t.items.push(line.item);
 		} else if (line.kind === "answer") {
 			for (const i of t.items) if (i.kind === "permission" && i.id === line.permission) i.answer = line.decision;
 		} else if (line.kind === "taken") {
@@ -3275,9 +3758,9 @@ function readTurns(text) {
 		state: "stopped"
 	} : t).sort((a, b) => a.id < b.id ? -1 : 1);
 }
-/** A turn's own tools: its mode's, and with an Understanding note given, the one that rewrites Iso's reading. */
-function turnTools(mode, sent) {
-	return [...MODE_TOOLS[mode], ...sent.some((s) => s.kind === "understanding") ? [WRITE_UNDERSTANDING] : []];
+/** A turn's own tools: its mode's. */
+function turnTools(mode) {
+	return MODE_TOOLS[mode];
 }
 function sentText(s) {
 	if (s.kind === "note") {
@@ -3286,15 +3769,14 @@ function sentText(s) {
 	}
 	if (s.kind === "passage") return `## A passage they chose in ${s.title} (/${s.id}.md)\n\n${s.text.split("\n").map((l) => `> ${l}`).join("\n")}`;
 	if (s.kind === "read") return `## ${s.title} (/${s.id}.md)${s.sections === "whole" ? "" : `, ${s.sections.length === 1 ? "the section" : "the sections"} ${s.sections.map((x) => `"${x}"`).join(", ")}`}\n\n${s.text}`;
-	if (s.kind === "folder") return `## The folder ${s.id || "at the top of the base"}: its notes\n\n${s.notes.map((n) => `- ${n.title} (/${n.id}.md)${n.description ? `: ${n.description}` : ""}`).join("\n") || "(empty)"}`;
-	return `## Their understanding of ${s.title} (/${s.id}.md)\n\nYour reading so far: ${s.reading || "none yet."}`;
+	return `## The folder ${s.id || "at the top of the base"}: its notes\n\n${s.notes.map((n) => `- ${n.title} (/${n.id}.md)${n.description ? `: ${n.description}` : ""}`).join("\n") || "(empty)"}`;
 }
 /** An earlier turn as it is sent: in the shape `conversation()` shortens. */
 function turnExchange(t) {
 	const text = t.items.filter((i) => i.kind === "text").map((i) => i.text).join("\n\n").trim();
 	const changed = t.items.flatMap((i) => i.kind === "change" ? [`${i.why === "create" ? "made" : i.why === "delete" ? "deleted" : i.why === "move" ? "moved" : "changed"} ${i.title} (/${i.note}.md)`] : []);
 	const asked = t.items.flatMap((i) => i.kind === "question" ? [`You asked them: ${i.title}${i.made ? ` (/${i.made}.md)` : ""}.`] : i.kind === "offer" ? [`You offered them a passage for /${i.note}.md, which they ${i.taken ? "inserted" : "have not inserted"}.`] : []);
-	const gave = t.given.filter((g) => g.kind !== "understanding").map((g) => g.kind === "passage" ? `a passage of /${g.id}.md` : `/${g.id}${g.kind === "note" ? ".md" : "/"}`);
+	const gave = t.given.map((g) => g.kind === "passage" ? `a passage of /${g.id}.md` : `/${g.id}${g.kind === "note" ? ".md" : "/"}`);
 	return {
 		id: t.id,
 		note: "",
@@ -3303,7 +3785,6 @@ function turnExchange(t) {
 }
 /** The messages for a turn, and what they hold, part by part. */
 function turnMessages(a) {
-	const understood = a.sent.filter((s) => s.kind === "understanding");
 	const checking = a.sent.some((s) => s.kind === "note" && s.of === "problem");
 	const system = [
 		WHO,
@@ -3311,22 +3792,21 @@ function turnMessages(a) {
 		PRACTICE,
 		LEARNING,
 		MODE_RULES[a.mode],
+		...a.mode === "write" ? [ARTIFACTS] : [],
 		ASKING(a.mode === "write"),
 		...checking ? [CHECKING] : [],
-		...understood.length ? [UNDERSTANDING] : [],
 		FORMAT_RULES,
-		LOOKING(ROUNDS[a.tier], a.meaning, a.lookup)
+		LOOKING(a.mode === "write" ? Math.max(ROUNDS[a.tier], 6) : ROUNDS[a.tier], a.meaning, a.lookup)
 	].join("\n\n");
 	const briefed = a.briefings?.length ? `# Earlier in this conversation, summed up\n\n${a.briefings.join("\n\n---\n\n")}` : "";
 	const talk = a.earlier.map((t) => turnExchange(t).text).join("\n\n---\n\n");
 	const earlier = [briefed, talk ? `# Earlier in this conversation\n\n${talk}` : ""].filter(Boolean).join("\n\n");
-	const given = a.sent.filter((s) => s.kind !== "understanding" && s.kind !== "read"), reads = a.sent.filter((s) => s.kind === "read");
+	const given = a.sent.filter((s) => s.kind !== "read"), reads = a.sent.filter((s) => s.kind === "read");
 	const gave = given.length ? `# What they gave you\n\n${given.map(sentText).join("\n\n")}` : "";
 	const held = reads.length ? `# Notes you read earlier in this conversation\n\n${reads.map(sentText).join("\n\n")}` : "";
 	const aside = a.aside?.length ? `# Read earlier, set aside\n\n${a.aside.map((n) => `- ${n.title} (/${n.id}.md)`).join("\n")}` : "";
 	const agents = a.agents?.trim() ? `# Their instructions for this knowledge base (AGENTS.md)\n\n${a.agents.trim()}` : "";
 	const lent = a.lookup && a.lent?.length ? `# Other knowledge bases lent to you\n\nYou may read these with the same look-up tools, giving their base; you change notes only in this one. Look in them where what is asked may be there: how the person works, their tools, what was settled before.\n\n${a.lent.map((l) => `- ${l.name}: ${l.about}`).join("\n")}` : "";
-	const known = understood.length ? `# Their understanding, as you have recorded it\n\n${understood.map(sentText).join("\n\n")}` : "";
 	const broken = a.broken?.length ? `# Code links that no longer resolve\n\nSince you were last told, these links in their notes point to files no longer in their repository. Mention it only where it bears on what they ask.\n\n${a.broken.map((b) => `- in ${b.title} (/${b.id}.md): ${b.href}`).join("\n")}` : "";
 	const request = `# What they ask now\n\n${a.asked}`;
 	return {
@@ -3342,7 +3822,6 @@ function turnMessages(a) {
 				agents,
 				lent,
 				earlier,
-				known,
 				gave,
 				held,
 				aside,
@@ -3354,7 +3833,7 @@ function turnMessages(a) {
 			{
 				name: "instructions and tools",
 				detail: `${a.mode} mode${checking ? ", checking" : ""}${a.lookup ? "" : ", no look-ups"}`,
-				tokens: estimate(system) + estimate(lent) + (a.lookup ? 500 : 0) + turnTools(a.mode, a.sent).length * 120
+				tokens: estimate(system) + estimate(lent) + (a.lookup ? 500 : 0) + turnTools(a.mode).length * 120
 			},
 			{
 				name: "earlier in this conversation",
@@ -3376,11 +3855,6 @@ function turnMessages(a) {
 				detail: `${reads.length} in hand${a.aside?.length ? `, ${a.aside.length} set aside` : ""}`,
 				tokens: estimate(held) + estimate(aside)
 			}] : [],
-			...understood.length ? [{
-				name: "your understanding",
-				detail: `${understood.length} ${understood.length === 1 ? "note" : "notes"}`,
-				tokens: estimate(known)
-			}] : [],
 			...broken ? [{
 				name: "code links broken",
 				detail: `${a.broken.length}`,
@@ -3394,7 +3868,7 @@ function turnMessages(a) {
 		]
 	};
 }
-var MODES, ITEMS, CONVERSATIONS_DIR, conversationPath, WHO, ISORITE, PRACTICE, LEARNING, ASK, WRITE, UNDERSTANDING, ASKING, CHECKING, MODE_RULES, LOOKING, COMPACT$1, str, fn, POINT_TO_NOTE, EDIT_NOTE$1, WRITE_NOTE$1, MOVE_NOTE, DELETE_NOTE, WRITE_UNDERSTANDING, ASK_QUESTION, OFFER_TEXT, MODE_TOOLS;
+var MODES, GIVEN, ITEMS, CONVERSATIONS_DIR, conversationPath, WHO, ISORITE, PRACTICE, LEARNING, ASK, WRITE, ARTIFACTS, ASKING, CHECKING, MODE_RULES, LOOKING, COMPACT$1, str, fn, POINT_TO_NOTE, EDIT_NOTE$1, WRITE_NOTE$1, MOVE_NOTE, DELETE_NOTE, ASK_QUESTION, READ_DATA, ARTIFACT_RECIPE, WRITE_ARTIFACT, READ_ARTIFACT, OFFER_TEXT, MODE_TOOLS;
 var init_turn = __esmMin((() => {
 	init_iso();
 	init_loop();
@@ -3403,6 +3877,11 @@ var init_turn = __esmMin((() => {
 		"write",
 		"build"
 	];
+	GIVEN = [
+		"note",
+		"folder",
+		"passage"
+	];
 	ITEMS = [
 		"text",
 		"look",
@@ -3432,6 +3911,11 @@ what you change is shown to them there as you do it.`;
   problem note is practice that \`uses\` notes. Theirs alone to mark:
   \`resolved\` or \`solved\`, with the day. \`[[!name]]\` alone on a line
   embeds one in a note.
+- A problem of several steps is several problem notes, each linked to the one
+  before it as "requires", in a folder of their own when they belong
+  together. A problem has no steps inside it.
+- Files beside the notes that are not notes (data, documents, pictures,
+  artifacts) are linked as any note is: [runs](/simulation/runs.csv).
 - Every change you make is marked as yours, in the note's history, and they
   can undo it.
 
@@ -3468,6 +3952,9 @@ It follows from [surprise](/basics/surprise.md "requires"), but how?
   stop. Explain once they have answered. When they ask for a fact, a check or
   a change, just answer.
 - Prefer a question back, or a problem to try, to a summary.
+- Where they stand shows in their notes: what they wrote, their open questions,
+  the problems they have solved and not. Where you find it stops, offer it to
+  them as a question to keep (ask_question) or a problem to try.
 - Check a solution; never solve it for them.`;
 	ASK = `# Ask mode: what you may do
 
@@ -3481,6 +3968,9 @@ note, no folder.
   the notes you used, so they can open them. Where the base does not hold what
   is asked, answer from what you know of the subject, exactly, and say that
   their notes do not cover it.
+- Cite in the sentence: the phrase that rests on a note is the link to it,
+  with its kind. No numbered references and no list of sources at the end;
+  the notes you read are shown under your reply.
 - When one of their notes would help them and they may not know it, point it
   out with point_to_note. Use it sparingly: one or two notes.
 - Never invent a note, a link or a quotation.`;
@@ -3498,25 +3988,29 @@ change marked as yours, and can undo it.
 - A new note (write_note) is written as one of theirs: frontmatter with type
   and title, their notation, their level, plain words, linked to the notes it
   rests on.
+- Write each paragraph and each list item on one line. Do not break lines at a
+  width: the editor wraps them to the pane.
 - Moving or deleting a note is asked of them before it happens. Do it only
   when they asked for it.
 - When you are done, say in a sentence or two what you changed and why. Do not
   repeat the text you wrote: they see it in the note.
 - Never invent a note, a link or a quotation.`;
-	UNDERSTANDING = `# Their understanding
+	ARTIFACTS = `# Artifacts
 
-Below, for each note in hand, is your reading of their understanding of it so
-far, from its Understanding note.
+An artifact is an HTML page beside their notes that isorite shows working: a
+dashboard of their data, a comparison, a simulation, an explorable
+explanation, a 3D model's viewer. Make one when they ask for something to see
+or try; not for what an answer or a note says as well.
 
-- Start from where they are: do not explain what they have shown they know; go
-  to what they have not yet shown, and ask about that first.
-- At the end of a conversation about a note, or when your reading of them has
-  changed, rewrite your reading with write_understanding: a few plain
-  sentences on what they can do with the note and what they have not yet
-  shown. It is theirs to read. Rest each sentence on evidence they can open,
-  linked: what they wrote in a note, a question of theirs open or resolved,
-  a problem solved or not. Say nothing the evidence does not show.
-- Never invent a note, a link or a quotation.`;
+1. artifact_recipe with the recipe nearest what they asked: dashboard,
+   compare, simulation, explorable or viewer. It gives a complete working
+   artifact and the kit's reference. Start from the recipe and change what it
+   marks; keep the rest.
+2. read_data for every data file it will read. Use the columns as given.
+3. write_artifact with the whole file. It is checked and run. If it reports a
+   problem, fix that and write the whole file again.
+4. Say in a sentence what it shows, linked: [what it shows](/folder/name.html).
+   Link it from the note it belongs to if they want it there.`;
 	ASKING = (write) => `# Asking back, and their own answers
 
 - Where a question to them would do more than an answer (what is unclear in
@@ -3638,13 +4132,6 @@ was not said.`;
 		}
 	}, ["id", "to"]);
 	DELETE_NOTE = fn("delete_note", "Delete a note. They are asked first. Its history stays.", { id: str }, ["id"]);
-	WRITE_UNDERSTANDING = fn("write_understanding", "Rewrite your reading of their understanding of one note: a few plain sentences on what they can do with it and what they have not yet shown, each resting on evidence linked as [their words](/id.md), [a question](/id.md) or [a problem](/id.md). Replaces the reading you had.", {
-		id: {
-			...str,
-			description: "The note's id."
-		},
-		reading: str
-	}, ["id", "reading"]);
 	ASK_QUESTION = fn("ask_question", "Ask them a question back, kept as an open question in their base, about one or more of their notes.", {
 		title: {
 			...str,
@@ -3664,6 +4151,50 @@ was not said.`;
 		"text",
 		"about"
 	]);
+	READ_DATA = fn("read_data", "A data file's shape: its columns with their types and ranges, the row count and the first rows. Read it before writing anything that uses the file, so the column names are real.", { path: {
+		...str,
+		description: "The file's path in the base: folder/name.csv."
+	} }, ["path"]);
+	ARTIFACT_RECIPE = fn("artifact_recipe", "A recipe for an artifact: a complete working one to start from, the kit's reference, and the rules write_artifact checks. dashboard: numbers, charts and a table of one data file. compare: two data files side by side. simulation: a model with parameters and play. explorable: inputs, derived numbers and linked views. viewer: a 3D model.", { name: {
+		type: "string",
+		enum: [
+			"dashboard",
+			"compare",
+			"simulation",
+			"explorable",
+			"viewer"
+		]
+	} }, ["name"]);
+	WRITE_ARTIFACT = fn("write_artifact", "Write an artifact: a whole HTML file on the kit. The title, description and uses given here are written into it. It is checked, and run where it can be; the result says what to fix. Nothing is written while a rule is broken.", {
+		path: {
+			...str,
+			description: "Where: folder/name.html, beside the notes it belongs to."
+		},
+		title: str,
+		description: {
+			...str,
+			description: "One sentence: what it shows, and what can be done with it."
+		},
+		uses: {
+			type: "array",
+			items: str,
+			description: "The data or model files it reads, relative to it (runs.csv). Those its markup and script name are added."
+		},
+		html: {
+			...str,
+			description: "The whole file."
+		}
+	}, [
+		"path",
+		"title",
+		"description",
+		"uses",
+		"html"
+	]);
+	READ_ARTIFACT = fn("read_artifact", "An artifact's whole file, to change it and write it again.", { path: {
+		...str,
+		description: "folder/name.html"
+	} }, ["path"]);
 	OFFER_TEXT = fn("offer_text", "Offer them their own answers, lightly joined, to insert at the end of a note as their writing. Only their words.", {
 		id: {
 			...str,
@@ -3678,7 +4209,8 @@ was not said.`;
 		ask: [
 			POINT_TO_NOTE,
 			ASK_QUESTION,
-			OFFER_TEXT
+			OFFER_TEXT,
+			READ_DATA
 		],
 		write: [
 			EDIT_NOTE$1,
@@ -3687,7 +4219,11 @@ was not said.`;
 			DELETE_NOTE,
 			POINT_TO_NOTE,
 			ASK_QUESTION,
-			OFFER_TEXT
+			OFFER_TEXT,
+			READ_DATA,
+			ARTIFACT_RECIPE,
+			WRITE_ARTIFACT,
+			READ_ARTIFACT
 		]
 	};
 }));
@@ -3892,6 +4428,11 @@ function checkNoteId(id) {
 	if (!id || id.length > 400 || parts.some((p) => !p || BAD_PART.test(p))) throw new EngineError(`not a note's id: ${JSON.stringify(id)}`);
 	return id;
 }
+/** A file's path in the base as Iso gives one: no leading slash, no "..", nothing hidden. */
+function filePathOf(raw) {
+	const p = String(raw ?? "").trim().replace(/^\/+/, "");
+	return p && !p.split("/").some((x) => !x || x === "." || x === ".." || x.startsWith(".")) ? p : null;
+}
 async function walk(files, root) {
 	const out = [];
 	const at = (path) => root && path ? `${root}/${path}` : root || path;
@@ -3929,14 +4470,13 @@ function keepDone(before, next) {
 		return next;
 	}
 }
-var SIGN_IN_MS, fromBase, REPLY_TOKENS, NOTE_TOKENS, DRAFT_PREFIX, DRAFT_DIR, isDraftId, bare, inBase, BAD_PART, TURN_ID, escapeRe, MAX_SENT, BRIEF, NOTE_ARG, MARKED, EDIT_NOTE, WRITE_NOTE, Engine;
+var SIGN_IN_MS, fromBase, REPLY_TOKENS, NOTE_TOKENS, ARTIFACT_TOKENS, DRAFT_PREFIX, DRAFT_DIR, isDraftId, bare, inBase, BAD_PART, TURN_ID, escapeRe, MAX_SENT, BRIEF, NOTE_ARG, MARKED, EDIT_NOTE, WRITE_NOTE, Engine;
 var init_engine = __esmMin((() => {
 	init_src$1();
 	init_api();
 	init_iso();
 	init_loop();
 	init_lookup();
-	init_understand();
 	init_hand();
 	init_turn();
 	init_meaning();
@@ -3945,10 +4485,11 @@ var init_engine = __esmMin((() => {
 	fromBase = (base, text) => `(From the base ${base}: name its notes ${base}:<id>, or give base "${base}".)\n${text}`;
 	REPLY_TOKENS = 2500;
 	NOTE_TOKENS = 6e3;
+	ARTIFACT_TOKENS = 32e3;
 	DRAFT_PREFIX = "@draft/";
 	DRAFT_DIR = "drafts";
 	isDraftId = (id) => id.startsWith(DRAFT_PREFIX);
-	bare = (id) => isDraftId(id) ? id.slice(7) : isUnderstandingId(id) ? id.slice(UNDERSTANDING_PREFIX.length) : id;
+	bare = (id) => isDraftId(id) ? id.slice(7) : id;
 	inBase = (id) => !id.startsWith("@");
 	BAD_PART = /^\.|[\0\\:*?"<>|]|^\s|\s$/;
 	TURN_ID = /^[0-9A-HJKMNP-TV-Z]{26}$/;
@@ -4149,9 +4690,54 @@ var init_engine = __esmMin((() => {
 					...pictures.length ? { pictures } : {}
 				};
 			}
+			const model = mapModel(this.bundle), files = {};
+			const items = [];
+			const walk = (d) => {
+				for (const c of d.children) if (c.kind === "dir") walk(c);
+				else if (c.id.startsWith("f:")) items.push(c.ref);
+			};
+			walk(model.root);
+			const all = new Set(items);
+			for (const ref of items) {
+				if (ref.endsWith("/")) {
+					const count = [...this.bundle.files].filter((f) => f.startsWith(ref) && !f.slice(ref.length).includes("/")).length;
+					files[ref] = {
+						title: `${ref.slice(0, -1).split("/").at(-1)} · ${count} ${count === 1 ? "picture" : "pictures"}`,
+						kind: "image",
+						count
+					};
+					continue;
+				}
+				const kind = citeKind(ref), name = ref.split("/").at(-1);
+				if (kind !== "artifact") {
+					files[ref] = {
+						title: name,
+						kind
+					};
+					continue;
+				}
+				const html = await this.opts.notes.read(ref).catch(() => null), m = html ? manifestOf(html) : null;
+				files[ref] = {
+					title: m?.title || name,
+					kind
+				};
+				const dir = ref.split("/").slice(0, -1);
+				for (const u of m?.uses ?? []) {
+					const parts = [...dir];
+					for (const p of u.split("/")) if (p === "..") parts.pop();
+					else if (p && p !== ".") parts.push(p);
+					const to = parts.join("/");
+					if (all.has(to) && !model.edges.some(([a, b]) => a === ref && b === to)) model.edges.push([
+						ref,
+						to,
+						STRENGTH.uses
+					]);
+				}
+			}
 			return {
-				model: mapModel(this.bundle),
-				notes
+				model,
+				notes,
+				...items.length ? { files } : {}
 			};
 		}
 		/** The base's settings, from `.isorite/settings.toml`. */
@@ -4505,7 +5091,7 @@ var init_engine = __esmMin((() => {
 		}
 		async deleteNote(id, base, who = "you") {
 			if (!inBase(id)) throw new EngineError("only a note of the base is deleted here");
-			const notes = this.opts.notes, path = `${checkNoteId(id)}.md`;
+			const { files: notes, path } = this.where(id);
 			await this.one(async () => {
 				const now = await notes.read(path);
 				if (now === null) throw new Conflict(`${id} is gone`, null);
@@ -4543,10 +5129,10 @@ var init_engine = __esmMin((() => {
 			this.queue = run.catch(() => void 0);
 			return run;
 		}
-		/** A picture (M22), in the notes or in the base's repository. The path must be a picture's, within its folder,
-		*  and (in the notes) never in a hidden folder such as `.isorite/`: nothing but a picture is given this way. */
+		/** A file in the notes that isn't a note (M23: any kind; M22 gave pictures only), or a picture in the base's
+		*  repository. Within its folder, and (in the notes) never in a hidden folder such as `.isorite/`. */
 		async file(path, from = "notes") {
-			const type = pictureType(path);
+			const type = from === "code" ? pictureType(path) : fileType(path);
 			if (!type) return null;
 			let files, at;
 			if (from === "code") {
@@ -4644,12 +5230,19 @@ var init_engine = __esmMin((() => {
 				};
 			});
 		}
-		/** Where a note's file is: drafts and Understanding notes are among isorite's own files. */
+		/** Where a note's file is: drafts are among isorite's own files. */
 		where(id) {
-			if (!inBase(id)) return {
-				files: this.opts.own,
-				path: `${isDraftId(id) ? DRAFT_DIR : UNDERSTANDING_DIR}/${checkNoteId(bare(id))}.md`
+			if (inBase(id) && citeKind(id) === "artifact") return {
+				files: this.opts.notes,
+				path: checkNoteId(id)
 			};
+			if (!inBase(id)) {
+				if (!isDraftId(id)) throw new EngineError(`there is no note ${id}`);
+				return {
+					files: this.opts.own,
+					path: `${DRAFT_DIR}/${checkNoteId(bare(id))}.md`
+				};
+			}
 			return {
 				files: this.opts.notes,
 				path: `${checkNoteId(id)}.md`
@@ -5398,6 +5991,32 @@ var init_engine = __esmMin((() => {
 				} : t)
 			};
 		}
+		async conversations() {
+			const study = this.opts.own;
+			const names = await study.list(CONVERSATIONS_DIR).catch(() => []);
+			const all = [];
+			for (const f of names) {
+				const id = f.name.slice(0, -6);
+				if (f.dir || !f.name.endsWith(".jsonl") || !TURN_ID.test(id)) continue;
+				const turns = readTurns(await study.read(conversationPath(id)) ?? "");
+				if (!turns.length) continue;
+				const notes = /* @__PURE__ */ new Set();
+				for (const t of turns) {
+					for (const g of t.given) if (g.kind !== "folder") notes.add(g.id);
+					for (const i of t.items) if (i.kind === "look" && i.step.opened && !i.step.away) notes.add(i.step.opened);
+					else if (i.kind === "point" || i.kind === "change" && i.why !== "delete") notes.add(i.kind === "change" && i.to ? i.to : i.note);
+				}
+				all.push({
+					id,
+					at: turns[0].at,
+					last: turns.at(-1).at,
+					asked: turns[0].asked,
+					turns: turns.length,
+					notes: notes.size
+				});
+			}
+			return all.sort((a, b) => a.last < b.last ? 1 : a.last > b.last ? -1 : 0);
+		}
 		/** What was given, checked: notes and passages of the base, and its folders. */
 		given(raw) {
 			if (!Array.isArray(raw) || raw.length > 40) throw new EngineError("give Iso between none and forty notes, folders and passages");
@@ -5415,10 +6034,6 @@ var init_engine = __esmMin((() => {
 					kind: "note",
 					id
 				};
-				if (g?.kind === "understanding") return {
-					kind: "understanding",
-					id
-				};
 				if (g?.kind === "passage" && typeof g.text === "string" && g.text.trim() && g.text.length <= 2e4) return {
 					kind: "passage",
 					id,
@@ -5454,16 +6069,6 @@ var init_engine = __esmMin((() => {
 				}
 				const c = this.bundle.concepts.get(g.id);
 				if (!c) continue;
-				if (g.kind === "understanding") {
-					const u = await this.understanding(g.id);
-					out.push({
-						kind: "understanding",
-						id: g.id,
-						title: c.title,
-						reading: u.reading
-					});
-					continue;
-				}
 				if (g.kind === "passage") out.push({
 					kind: "passage",
 					id: g.id,
@@ -5594,7 +6199,7 @@ var init_engine = __esmMin((() => {
 					group: "notes",
 					kind: g.kind,
 					title: g.kind === "folder" ? g.id || "the top of the base" : title(g.id),
-					detail: g.kind === "passage" ? "a passage" : g.kind === "folder" ? `${s.kind === "folder" ? s.notes.length : 0} notes listed` : g.kind === "understanding" ? "your understanding" : "",
+					detail: g.kind === "passage" ? "a passage" : g.kind === "folder" ? `${s.kind === "folder" ? s.notes.length : 0} notes listed` : "",
 					tokens: scaled(estimate(sentText(s))),
 					on: !w.off.has(k),
 					by: "you",
@@ -5884,7 +6489,7 @@ var init_engine = __esmMin((() => {
 				const big = [...w.built.parts].sort((a, b) => b.tokens - a.tokens)[0], k = (n) => `${Math.round(n / 1e3)}k`;
 				throw new EngineError(`This turn would be sent about ${k(size())} tokens, more than the ${k(limit)} the model takes. The largest part is ${big.name} (${k(w.scaled(big.tokens))}): switch parts off in the Context view.`, 413);
 			}
-			const sent = [...w.sent, ...w.reads], own = turnTools(mode, sent);
+			const sent = [...w.sent, ...w.reads], own = turnTools(mode);
 			const inHand = new Map(w.reads.flatMap((r) => r.kind === "read" ? [[r.id, r.sections]] : []));
 			for (const g of w.givenOn) if (g.kind === "note") inHand.set(g.id, "whole");
 			const { messages } = turnMessages({
@@ -6008,9 +6613,9 @@ var init_engine = __esmMin((() => {
 						tier: req.tier,
 						messages,
 						lookup: tools,
-						maxTokens: REPLY_TOKENS * 2,
 						signal: abort.signal,
-						most: ROUNDS[req.tier],
+						maxTokens: mode === "write" ? ARTIFACT_TOKENS : REPLY_TOKENS * 2,
+						most: mode === "write" ? Math.max(ROUNDS[req.tier], 6) : ROUNDS[req.tier],
 						onText: (delta, again) => this.publish({
 							type: "iso-text",
 							request: turn,
@@ -6172,7 +6777,7 @@ var init_engine = __esmMin((() => {
 			if (name === "edit_note") {
 				const id = noteId(this.bundle, args.id);
 				if (!id) return `There is no note ${String(args.id ?? "")}. Search for it by its words.`;
-				const old = String(args.old ?? ""), next = String(args.new ?? "");
+				const old = String(args.old ?? ""), next = unwrap(String(args.new ?? ""));
 				if (!old) return "Give the passage as it is now, in old.";
 				const now = await this.readNote(id);
 				const at = now.text.indexOf(old), again = at < 0 ? -1 : now.text.indexOf(old, at + 1);
@@ -6193,7 +6798,7 @@ var init_engine = __esmMin((() => {
 			if (name === "write_note") {
 				const id = this.newNoteId(args.id);
 				if (!id) return `${String(args.id ?? "")} is not a note's id in their base: give folder/name, lower case with hyphens.`;
-				let text = String(args.text ?? "");
+				let text = unwrap(String(args.text ?? ""));
 				if (!text.trim()) return "Give the note's whole text.";
 				if (!/^---\n/.test(text)) text = `---\ntype: Concept\ntitle: ${JSON.stringify(/^#\s+(.+)$/m.exec(text)?.[1]?.trim() ?? id.split("/").at(-1).replace(/-/g, " "))}\n---\n\n${text.replace(/^#\s+.+\n+/, "")}`;
 				const was = this.bundle.concepts.has(id) ? await this.readNote(id) : null;
@@ -6299,52 +6904,100 @@ var init_engine = __esmMin((() => {
 				});
 				return `It is offered to them for ${agents ? "their AGENTS.md" : title(id)}.`;
 			}
-			if (name === "write_understanding") {
-				const id = noteId(this.bundle, args.id);
-				if (!id) return `There is no note ${String(args.id ?? "")}.`;
-				const reading = String(args.reading ?? "").trim();
-				if (!reading) return "Give your reading.";
-				const uid = understandingId(id), was = await this.readNote(uid).catch(() => null);
-				const text = understandingText(id, title(id), {
-					...parseUnderstanding(was?.text ?? null),
-					reading
-				});
-				const saved = await this.one(() => this.put(uid, text, was?.version ?? null, "edit", {}, t.who));
-				if (saved.entry) await t.item({
-					kind: "change",
-					note: uid,
-					entry: saved.entry,
-					why: was ? "edit" : "create",
-					title: `Understanding · ${title(id)}`,
-					added: 0,
-					removed: 0
-				});
-				return `Your reading of ${title(id)} is written.`;
+			if (name === "read_data") {
+				const path = filePathOf(args.path);
+				if (!path) return `${String(args.path ?? "")} is not a file's path in their base.`;
+				const got = await this.file(path).catch(() => null);
+				if (!got) return `There is no file ${path}.${this.nearFiles(path)}`;
+				try {
+					return describeShape(shapeOf(path, parseData(path, new TextDecoder().decode(got.bytes))));
+				} catch (e) {
+					return `${path} could not be read as data: ${e.message}`;
+				}
+			}
+			if (name === "artifact_recipe") {
+				const r = RECIPES[String(args.name ?? "")];
+				if (!r) return `There's no recipe ${String(args.name ?? "")}: there are ${Object.keys(RECIPES).join(", ")}.`;
+				return `${REFERENCE}\n\n# The recipe: ${String(args.name)}\n\n${r.about}. A complete working artifact; change what it marks, keep the rest.\n\n\`\`\`html\n${r.html}\`\`\``;
 			}
+			if (name === "read_artifact") {
+				const path = filePathOf(args.path);
+				if (!path || citeKind(path) !== "artifact") return `${String(args.path ?? "")} is not an artifact's path (folder/name.html).`;
+				const got = await this.opts.notes.read(path);
+				return got === null ? `There is no artifact ${path}.` : got;
+			}
+			if (name === "write_artifact") return this.writeArtifact(args, t);
 			return `${name} cannot be used yet.`;
 		}
-		/** A note's Understanding note (M10): Iso's reading and your scratchpad. */
-		async understanding(note) {
-			if (!inBase(checkNoteId(note))) throw new EngineError("only a note of the base has an Understanding note");
-			const uid = understandingId(note);
-			const source = await this.readNote(uid).catch(() => null);
-			return {
-				note,
-				...parseUnderstanding(source?.text ?? null),
-				version: source?.version ?? null
+		/** Files in the same folder as a path, to say which there are when one isn't. */
+		nearFiles(path) {
+			const dir = path.split("/").slice(0, -1).join("/"), there = [...this.files.keys()].filter((f) => !f.endsWith(".md") && f.split("/").slice(0, -1).join("/") === dir);
+			return there.length ? ` In ${dir || "the top folder"} there are: ${there.map((f) => f.split("/").at(-1)).join(", ")}.` : "";
+		}
+		/** write_artifact (M23, plan-m23 §3.5, §3.7): the manifest written as given, the rules checked before anything is
+		*  written, then written and journalled as a note is, and run where it can be, with all it reports said back. */
+		async writeArtifact(args, t) {
+			const path = filePathOf(args.path);
+			if (!path || citeKind(path) !== "artifact" || !inBase(path)) return `${String(args.path ?? "")} is not an artifact's path: give folder/name.html.`;
+			const raw = String(args.html ?? "");
+			if (!raw.trim()) return "Give the whole file, in html.";
+			const given = (Array.isArray(args.uses) ? args.uses : typeof args.uses === "string" ? args.uses.split(/[\s,]+/) : []).map((u) => String(u));
+			const uses = [...new Set([
+				...given,
+				...manifestOf(raw).uses,
+				...readsOf(raw)
+			].map((u) => u.trim().replace(/^\.\//, "")).filter(Boolean))];
+			const title = String(args.title ?? "").trim() || manifestOf(raw).title || path.split("/").at(-1).replace(/\.html?$/, "").replace(/-/g, " ");
+			const html = withManifest(raw, {
+				title,
+				description: String(args.description ?? "").trim() || manifestOf(raw).description,
+				author: "Iso",
+				date: new Date(this.opts.clock.now()).toISOString().slice(0, 10),
+				kit: "1",
+				uses
+			});
+			const dir = path.split("/").slice(0, -1);
+			const at = (rel) => {
+				const parts = [...dir];
+				for (const p of rel.split("/")) if (p === "..") parts.pop();
+				else if (p && p !== ".") parts.push(p);
+				return parts.join("/");
 			};
-		}
-		/** Your scratchpad in a note's Understanding note: yours alone; Iso does not write it. `base` as for saveNote, or
-		*  null when there is no Understanding note yet. */
-		async saveScratchpad(note, scratchpad, base) {
-			if (!inBase(checkNoteId(note))) throw new EngineError("only a note of the base has an Understanding note");
-			const uid = understandingId(note), was = await this.readNote(uid).catch(() => null);
-			const title = this.bundle.concepts.get(note)?.title ?? note;
-			await this.one(() => this.put(uid, understandingText(note, title, {
-				...parseUnderstanding(was?.text ?? null),
-				scratchpad
-			}), base));
-			return this.understanding(note);
+			const files = [], columns = {};
+			for (const u of uses) {
+				const got = await this.file(at(u)).catch(() => null);
+				if (!got) continue;
+				files.push(u);
+				if (citeKind(u) === "data") try {
+					columns[u] = columnsOf(parseData(u, new TextDecoder().decode(got.bytes)));
+				} catch {}
+			}
+			const broken = checkArtifact(html, {
+				files,
+				columns
+			}), errors = broken.filter((b) => b.level === "error");
+			const list = (bs) => bs.map((b) => `- ${b.message}`).join("\n");
+			if (errors.length) return `Not written: ${errors.length === 1 ? "a rule is" : "rules are"} broken.\n${list(errors)}\nFix ${errors.length === 1 ? "it" : "them"} and call write_artifact again with the whole file.`;
+			const was = await this.opts.notes.read(path);
+			const saved = await this.one(() => this.put(path, html, was === null ? null : hashText(was), "edit", { asked: t.asked }, t.who));
+			if (saved.entry) await t.item({
+				kind: "change",
+				note: path,
+				entry: saved.entry,
+				why: was === null ? "create" : "edit",
+				title,
+				added: html.split("\n").length,
+				removed: was?.split("\n").length ?? 0
+			});
+			const warnings = broken.filter((b) => b.level === "warning");
+			const run = await this.opts.renderArtifact?.(path, html).catch(() => null) ?? null;
+			const problems = [
+				...run && !run.rendered ? ["it didn't start: the kit never said it was ready"] : [],
+				...(run?.errors ?? []).map((e) => `it reported: ${e}`),
+				...run && run.rendered && run.drawn === 0 ? ["it drew nothing: no chart, canvas or 3D view has anything in it"] : [],
+				...warnings.map((w) => w.message)
+			];
+			return `${was === null ? "Written" : "Written anew"}: ${path}. ${run ? "It was run, with every control touched" : "It couldn't be run here (no browser), so only its rules were checked"}${problems.length ? `, and:\n${problems.map((p) => `- ${p}`).join("\n")}\nFix these and call write_artifact again with the whole file.` : run ? ", with no error." : "."}`;
 		}
 		/** A question asked in a turn, made a question note: in the folder of the first note it is about, named by its
 		*  title. */
@@ -6781,7 +7434,6 @@ var init_src = __esmMin((() => {
 	init_iso();
 	init_meaning();
 	init_agent();
-	init_understand();
 	init_turn();
 }));
 //#endregion
@@ -7964,7 +8616,7 @@ function toTurns(messages, { live = /* @__PURE__ */ new Map(), ours = /* @__PURE
 /** What is asked from a page, with what was given in the Iso pane's context: notes and folders by name, for the
 *  agent to read with isorite's tools, and passages as they are. */
 function given(asked, parts, title) {
-	const notes = parts.filter((p) => p.kind === "note" || p.kind === "understanding").map((p) => `- ${title(p.id)} (${p.id})`);
+	const notes = parts.filter((p) => p.kind === "note").map((p) => `- ${title(p.id)} (${p.id})`);
 	const folders = parts.filter((p) => p.kind === "folder").map((p) => `- the folder ${p.id}`);
 	const passages = parts.flatMap((p) => p.kind === "passage" ? [`From ${title(p.id)} (${p.id}):\n${p.text.split("\n").map((l) => "> " + l).join("\n")}`] : []);
 	const out = [asked.trim()];
@@ -8288,10 +8940,6 @@ const Given = z.discriminatedUnion("kind", [
 		kind: z.literal("passage"),
 		id: z.string().max(400),
 		text: z.string().max(2e4)
-	}).strict(),
-	z.object({
-		kind: z.literal("understanding"),
-		id: z.string().max(400)
 	}).strict()
 ]);
 const Mode = z.enum([
@@ -8476,7 +9124,7 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, terminal
 			if (e instanceof EngineError) return refuse(c, e.status, e.message);
 			throw e;
 		}
-		if (!found) return refuse(c, 404, `no picture at ${path}`);
+		if (!found) return refuse(c, 404, `no file at ${path}`);
 		const etag = `"${found.version}"`;
 		const headers = {
 			"Content-Type": found.type,
@@ -8509,11 +9157,6 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, terminal
 	});
 	post("/api/iso/ask", Ask, (_c, b) => api.ask(b));
 	post("/api/iso/converse", TurnAsk, (_c, b) => api.converse(b));
-	app.get("/api/understanding", (c) => answer(c, () => api.understanding(id(c))));
-	post("/api/understanding/scratchpad", z.object({
-		scratchpad: z.string().max(2e5),
-		base: z.string().max(64).nullable()
-	}).strict(), (c, b) => api.saveScratchpad(id(c), b.scratchpad, b.base));
 	post("/api/iso/take", z.object({
 		conversation: z.string().max(64),
 		turn: z.string().max(64),
@@ -8544,6 +9187,7 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, terminal
 			"reject"
 		])
 	}).strict(), (_c, b) => api.answer(b.turn, b.permission, b.decision));
+	app.get("/api/conversations", (c) => answer(c, () => api.conversations()));
 	app.get("/api/conversation", (c) => answer(c, async () => await api.conversation(c.req.query("id") || void 0) ?? {
 		id: "",
 		turns: []
@@ -9134,7 +9778,7 @@ var Setup = class {
 };
 //#endregion
 //#region packages/server/src/version.ts
-const VERSION = "0.10.0";
+const VERSION = "0.12.0";
 //#endregion
 //#region packages/server/src/git.ts
 /** The top of the repository `folder` is in, or null: the nearest folder holding `.git`, a directory or, in a
@@ -9188,9 +9832,155 @@ function openStudyBase(path) {
 	};
 }
 //#endregion
+//#region packages/server/src/render.ts
+/** A Chromium on this machine: ISORITE_BROWSER, Playwright's own, or a browser installed in the usual places. */
+function findBrowser(env = process.env) {
+	if (env.ISORITE_BROWSER && existsSync(env.ISORITE_BROWSER)) return env.ISORITE_BROWSER;
+	const cache = env.PLAYWRIGHT_BROWSERS_PATH ?? (process.platform === "darwin" ? join(homedir(), "Library", "Caches", "ms-playwright") : process.platform === "win32" ? join(env.LOCALAPPDATA ?? "", "ms-playwright") : join(homedir(), ".cache", "ms-playwright"));
+	const found = [];
+	try {
+		for (const d of readdirSync(cache).filter((d) => /^chromium(_headless_shell)?-\d+$/.test(d)).sort().reverse()) for (const p of [
+			"chrome-linux/headless_shell",
+			"chrome-headless-shell-linux64/chrome-headless-shell",
+			"chrome-linux/chrome",
+			"chrome-linux64/chrome",
+			"chrome-mac/headless_shell",
+			"chrome-headless-shell-mac-arm64/chrome-headless-shell",
+			"chrome-mac/Chromium.app/Contents/MacOS/Chromium",
+			"chrome-win/headless_shell.exe",
+			"chrome-headless-shell-win64/chrome-headless-shell.exe",
+			"chrome-win/chrome.exe"
+		]) found.push(join(cache, d, p));
+	} catch {}
+	found.push("/usr/bin/chromium", "/usr/bin/chromium-browser", "/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/snap/bin/chromium", "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "/Applications/Chromium.app/Contents/MacOS/Chromium", join(env["PROGRAMFILES"] ?? "C:\\Program Files", "Google", "Chrome", "Application", "chrome.exe"), join(env["PROGRAMFILES(X86)"] ?? "C:\\Program Files (x86)", "Microsoft", "Edge", "Application", "msedge.exe"));
+	return found.find((p) => existsSync(p)) ?? null;
+}
+/** The host: a sandboxed frame given the document, and the bridge, answering files through window.isoRead. */
+const HOST = `(doc, ground) => {
+  const f = document.getElementById("f");
+  window.said = []; window.ready = false;
+  const tell = (m, t = []) => f.contentWindow.postMessage({ isorite: 0, ...m }, "*", t);
+  addEventListener("message", async (e) => {
+    const m = e.data;
+    if (e.source !== f.contentWindow || !m || m.isorite !== 0) return;
+    if (m.type === "ready") { window.ready = true; tell({ type: "ground", ground }); tell({ type: "look", look: "isorite" }); }
+    else if (m.type === "file" || m.type === "bytes") {
+      const got = await window.isoRead(m.path);
+      if (got.error) tell({ type: "reply", id: m.id, error: got.error });
+      else if (m.type === "bytes") { const buf = got.b64 !== undefined ? Uint8Array.from(atob(got.b64), (c) => c.charCodeAt(0)).buffer : new TextEncoder().encode(got.text).buffer; tell({ type: "reply", id: m.id, bytes: buf }, [buf]); }
+      else tell({ type: "reply", id: m.id, text: got.text ?? atob(got.b64) });
+    }
+    else if (m.type === "height") f.style.height = Math.min(8000, Math.ceil(m.height) + 4) + "px";
+    else if (m.type === "error") window.said.push(String(m.message));
+  });
+  f.srcdoc = doc;
+}`;
+/** What it drew: SVG marks, a table's cells, and 100 for each canvas with anything on it (a WebGL one, if it has a size). */
+const DRAWN = `(() => {
+  let n = document.querySelectorAll("svg path, svg line, svg circle, svg rect, svg polyline, svg polygon, svg text, iso-table td").length;
+  for (const c of document.querySelectorAll("canvas")) {
+    try {
+      const g = c.getContext("2d");
+      if (g) { const d = g.getImageData(0, 0, c.width, c.height).data; if (d.some((v, i) => v !== d[i % 4])) n += 100; }
+      else n += 100;
+    } catch { n += 100; }
+  }
+  return n;
+})()`;
+/** Every control touched: sliders to three quarters, choices to their second, buttons pressed, a drag on a canvas. */
+const TOUCH = `(async () => {
+  for (const r of document.querySelectorAll("input[type=range]")) { r.value = String(+r.min + (+r.max - +r.min) * 0.75); r.dispatchEvent(new Event("input", { bubbles: true })); r.dispatchEvent(new Event("change", { bubbles: true })); }
+  for (const s of document.querySelectorAll("select")) if (s.options.length > 1) { s.selectedIndex = 1; s.dispatchEvent(new Event("change", { bubbles: true })); }
+  for (const b of document.querySelectorAll("button, input[type=checkbox]")) if (!b.closest("iso-note")) b.click();
+  await new Promise((r) => setTimeout(r, 400));
+  const c = document.querySelector("canvas");
+  if (c) {
+    const r = c.getBoundingClientRect(), at = (t, x) => c.dispatchEvent(new PointerEvent(t, { clientX: r.left + x, clientY: r.top + r.height / 2, bubbles: true, pointerId: 1 }));
+    at("pointerdown", r.width / 2); at("pointermove", r.width / 2 + 60); at("pointerup", r.width / 2 + 60);
+    c.dispatchEvent(new MouseEvent("click", { clientX: r.left + r.width / 3, clientY: r.top + r.height / 3, bubbles: true }));
+  }
+})()`;
+let launched = null;
+async function browser(path) {
+	launched ??= (async () => {
+		const { chromium } = await import("playwright-core");
+		return chromium.launch({
+			executablePath: path,
+			args: [
+				"--use-gl=angle",
+				"--use-angle=swiftshader",
+				"--enable-unsafe-swiftshader"
+			]
+		});
+	})().catch((e) => {
+		launched = null;
+		throw e;
+	});
+	return launched;
+}
+/** Render an assembled artifact (packages/kit's assemble) unseen, answer its bridge from `read` for the files in
+*  `uses`, touch its controls, and say what happened. */
+async function renderArtifact(doc, uses, read, opts) {
+	const b = await browser(opts.executable), width = opts.width ?? 1100;
+	const page = await b.newPage({ viewport: {
+		width,
+		height: 900
+	} });
+	const errors = [];
+	page.on("console", (m) => {
+		if (m.type?.() === "error") errors.push(m.text());
+	});
+	page.on("pageerror", (e) => errors.push(e.message ?? String(e)));
+	const work = (async () => {
+		await page.exposeFunction("isoRead", async (rel) => {
+			if (!uses.includes(rel)) return { error: `${rel} is not in the artifact's manifest (isorite:uses)` };
+			const got = await read(rel);
+			if (got === null) return { error: `${rel}: no such file beside the artifact` };
+			return typeof got === "string" ? { text: got } : { b64: Buffer.from(got).toString("base64") };
+		});
+		await page.setContent(`<!doctype html><html><body style="margin:0;background:${opts.ground === "quartz" ? "#F2F0EA" : "#07101C"}"><iframe id="f" sandbox="allow-scripts" style="display:block;width:${width}px;height:900px;border:0"></iframe></body></html>`);
+		await page.evaluate(`(${HOST})(${JSON.stringify(doc)}, ${JSON.stringify(opts.ground ?? "lapis")})`);
+		await page.waitForTimeout(2e3);
+		const ready = await page.evaluate("window.ready");
+		const frame = page.frames().find((fr) => fr !== page.mainFrame());
+		const height = await page.evaluate("document.getElementById(\"f\").offsetHeight");
+		const drawn = frame ? await frame.evaluate(DRAWN) : 0;
+		let screenshot;
+		if (opts.screenshot) {
+			await page.setViewportSize({
+				width,
+				height: Math.max(400, Math.min(height, 4e3))
+			});
+			screenshot = await page.screenshot({ fullPage: true });
+		}
+		if (frame) await frame.evaluate(TOUCH);
+		await page.waitForTimeout(600);
+		const said = await page.evaluate("window.said");
+		return {
+			rendered: ready,
+			errors: [.../* @__PURE__ */ new Set([...said, ...errors])].slice(0, 12),
+			drawn,
+			height,
+			...screenshot ? { screenshot } : {}
+		};
+	})();
+	const timeout = new Promise((resolve) => setTimeout(() => resolve({
+		rendered: false,
+		errors: ["it didn't finish starting within the time allowed: a loop that never ends?"],
+		drawn: 0,
+		height: 0
+	}), opts.timeout ?? 2e4));
+	try {
+		return await Promise.race([work, timeout]);
+	} finally {
+		await page.close().catch(() => void 0);
+	}
+}
+//#endregion
 //#region packages/server/src/serve.ts
 init_src$1();
 init_src();
+init_src$2();
 /** The built app: in a checkout, where npm run build puts it; installed from npm, in the package's web/. */
 const WEB_DIR = [join(dirname(fileURLToPath(import.meta.url)), "..", "web"), join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "app", "build")].find((dir) => existsSync(join(dir, "index.html"))) ?? join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "app", "build");
 const moveIt = (study) => `${study} is a study base, which this isorite no longer reads (format 1). Move it into its notes with: isorite migrate ${study}`;
@@ -9248,9 +10038,28 @@ async function openEngine({ notes }, device = deviceId(), config = configPath(),
 				name: `vectors-${createHash("sha256").update(notes).digest("hex").slice(0, 16)}.json`
 			}
 		} : {},
-		...extras.elsewhere ? { elsewhere: extras.elsewhere } : {}
+		...extras.elsewhere ? { elsewhere: extras.elsewhere } : {},
+		renderArtifact: (path, html) => runArtifact(notes, path, html)
 	});
 }
+/** Run an artifact unseen: null when there's no browser, or no built kit, to run it with. */
+async function runArtifact(notes, path, html) {
+	const executable = findBrowser(), kitDir = join(WEB_DIR, "kit");
+	if (!executable || !existsSync(join(kitDir, "kit.js"))) return null;
+	const kit = Object.fromEntries(KIT_FILES.map((f) => [f, readFileSync(join(kitDir, f), "utf8")]));
+	const dir = dirname(resolve(notes, path)), uses = manifestOf(html).uses;
+	const read = async (rel) => {
+		const at = resolve(dir, rel);
+		if (!at.startsWith(resolve(notes) + sep) || !existsSync(at)) return null;
+		return /\.(csv|tsv|json|jsonl|ndjson|txt|gltf|obj)$/i.test(at) ? readFileSync(at, "utf8") : new Uint8Array(readFileSync(at));
+	};
+	const got = await renderArtifact(assemble(html, kit), uses, read, { executable });
+	return {
+		rendered: got.rendered,
+		errors: got.errors,
+		drawn: got.drawn
+	};
+}
 /** The guide's finder, as a provider: no key, no sign-in, and a name that says what it is. */
 const { auth: _auth, ...openrouter } = OPENROUTER;
 const FINDER = {
@@ -9981,6 +10790,8 @@ async function doctor(folder, o = {}) {
 		say("browser pages", asking.length ? "fail" : "ok", asking.length ? `${asking.join(" and ")} asked for a password (401, Basic): that is not isorite's server; stop it, or give isorite another port (--port <n>)` : `isorite's pages at ${url}/ ask for no password. ${hint}`);
 	}
 	if (env.SSH_CONNECTION) say("browser", "ok", `over SSH: on your own machine, ssh -L ${port}:localhost:${port} <this host>, then http://localhost:${port}/`);
+	const chrome = findBrowser(env);
+	say("artifacts", chrome ? "ok" : "warn", chrome ? `run unseen when Iso writes one, in ${chrome}` : "no Chromium found to run them unseen, so only their rules are checked when Iso writes one; ISORITE_BROWSER names one (Chrome, Chromium, Edge)");
 	let model = null;
 	if (env.ISORITE_EMBED === "off") say("search by meaning", "skip", "switched off (ISORITE_EMBED=off)");
 	else {
@@ -11057,7 +11868,7 @@ const ISO_QUESTIONS = {
 		about: [TRIANGLE]
 	}
 };
-/** Iso's reading of you on Gauss–Bonnet, each sentence resting on what you can open. */
+/** Iso's answer to where you stand on Gauss–Bonnet, each sentence resting on what you can open. */
 const READING = `You can state it and use it: the [examples](/${BONNET}.md) are yours, and you [solved the torus](/${TORUS}.md). [The proof sketch](/${BONNET}.md) is still mine, untouched: you have not yet said it in your own words. [Where compactness is used](/${COMPACT}.md) is open, and so is [the triangle](/${TRIANGLE}.md), whose solution leans on a step not yet shown.`;
 const anchor = (text) => ({
 	text,
@@ -11306,7 +12117,6 @@ async function buildGeometry(sources, code, now = Date.now()) {
 		await write(CYLINDER, final(CYLINDER));
 		await engine.setDone(CYLINDER, true, (await engine.readNote(CYLINDER)).version);
 	});
-	on(1, 55, async () => engine.saveScratchpad(BONNET, "Compact: I think it is only that the triangulation is finite. Check against the Möbius band, which is compact and still fails, so orientation must be a separate matter.", null));
 	on(0, -40, async () => {
 		replies.push({
 			calls: [{
@@ -11322,34 +12132,20 @@ async function buildGeometry(sources, code, now = Date.now()) {
 				usd: .0071
 			}
 		}, {
-			calls: [{
-				name: "write_understanding",
-				arguments: {
-					id: BONNET,
-					reading: READING
-				}
-			}],
+			text: READING,
 			usage: {
 				in: 7200,
 				out: 150,
 				cached: 4200,
 				usd: .0103
 			}
-		}, {
-			text: "I have written my reading of you on Gauss–Bonnet.",
-			usage: {
-				in: 7500,
-				out: 20,
-				cached: 7e3,
-				usd: .0037
-			}
 		});
 		const { turn: id } = await engine.converse({
 			mode: "ask",
 			asked: "where do I stand on Gauss–Bonnet?",
 			tier: "mid",
 			given: [{
-				kind: "understanding",
+				kind: "note",
 				id: BONNET
 			}]
 		});
@@ -11377,14 +12173,14 @@ const finderHttp = (pace = 0) => scriptedHttp(finderAnswer, pace);
 //#region packages/guide/src/node.ts
 /** In a checkout, the package's notes/; in the npm package, where this is bundled into dist/, the guide/ beside it. */
 const GUIDE_DIR = [join(import.meta.dirname, "..", "guide"), join(import.meta.dirname, "..", "notes")].find((d) => existsSync(join(d, "start-here.md"))) ?? join(import.meta.dirname, "..", "notes");
-/** The guide's pictures (M22), by path, as bytes. */
+/** The guide's files that aren't notes, by path, as bytes: its pictures (M22), and its artifacts and their data (M23). */
 function loadGuidePictures(dir = GUIDE_DIR) {
 	const out = {};
 	const visit = (at) => {
 		for (const name of readdirSync(at)) {
 			const path = join(at, name);
 			if (statSync(path).isDirectory()) visit(path);
-			else if (/\.(png|jpe?g|gif|svg|webp|avif)$/i.test(name)) out[relative(dir, path).split(sep).join("/")] = new Uint8Array(readFileSync(path));
+			else if (/\.(png|jpe?g|gif|svg|webp|avif|html|csv|tsv|json|jsonl|stl|glb|gltf|obj|pdf)$/i.test(name)) out[relative(dir, path).split(sep).join("/")] = new Uint8Array(readFileSync(path));
 		}
 	};
 	visit(dir);
@@ -11606,6 +12402,7 @@ function bases(args, { config = configPath(), out = console.log } = {}) {
 }
 //#endregion
 //#region packages/server/src/main.ts
+init_src$2();
 init_src$1();
 init_model();
 const USAGE = `isorite: an agentic harness for understanding
@@ -11658,8 +12455,29 @@ function check(notes, out = console.log, unused = false) {
 	const bundle = loadBundle(root), issues = bundle.lint(), cycles = bundle.requiresCycles();
 	for (const i of issues) out(`${i.level.padEnd(7)} ${i.path}: ${i.message}`);
 	for (const c of cycles) out(`warning requires cycle: ${c.join(" -> ")}`);
-	const errors = issues.filter((i) => i.level === "error").length;
-	out(`${bundle.concepts.size} notes in ${bundle.directories.size} folders; ${errors} errors, ${issues.length - errors} warnings, ${cycles.length} requires cycles`);
+	let artifactErrors = 0, artifactWarnings = 0;
+	for (const f of [...bundle.files].filter((x) => citeKind(x) === "artifact").sort()) {
+		const html = readFileSync(join(root, f), "utf8");
+		if (manifestOf(html).kit === null) continue;
+		const dir = dirname(join(root, f)), files = manifestOf(html).uses.filter((u) => existsSync(join(dir, u)));
+		const columns = Object.fromEntries(files.filter((u) => citeKind(u) === "data").flatMap((u) => {
+			try {
+				return [[u, columnsOf(parseData(u, readFileSync(join(dir, u), "utf8")))]];
+			} catch {
+				return [];
+			}
+		}));
+		for (const b of checkArtifact(html, {
+			files,
+			columns
+		})) {
+			out(`${b.level.padEnd(7)} ${f}: ${b.message}`);
+			if (b.level === "error") artifactErrors++;
+			else artifactWarnings++;
+		}
+	}
+	const errors = issues.filter((i) => i.level === "error").length + artifactErrors;
+	out(`${bundle.concepts.size} notes in ${bundle.directories.size} folders; ${errors} errors, ${issues.length - issues.filter((i) => i.level === "error").length + artifactWarnings} warnings, ${cycles.length} requires cycles`);
 	if (unused) {
 		const cited = new Set([...bundle.concepts.values()].flatMap((c) => c.cites.map((x) => x.target)));
 		const idle = [...bundle.files].filter((f) => citeKind(f) === "image" && !cited.has(f)).sort();