dsh-aha-tutor 1.1.0 → 1.3.0

package/lib/{runtime-CiA2I7-X.js → runtime-BCGFUDlg.js}

@@ -240,12 +240,34 @@ function normalizeBlueprint(raw, { language } = {}) {
 		projects: list(raw?.projects, LIMITS.projects, normalizeProject)
 	};
 }
+function blueprintOutline(raw) {
+	const units = list(raw?.units, LIMITS.units, (unit) => {
+		const title = text(unit?.title, 120);
+		if (!title) return null;
+		return {
+			title,
+			lectures: list(unit?.lectures, LIMITS.lecturesPerUnit, (lecture) => {
+				const lessons = strings(lecture?.lessons, LIMITS.lessonsPerLecture, 120);
+				const name = text(lecture?.title, 120);
+				return name || lessons.length ? {
+					title: name,
+					lessons
+				} : null;
+			})
+		};
+	});
+	return {
+		title: text(raw?.title, 120),
+		units
+	};
+}
 const ITEM_KINDS = [
 	"choice",
 	"multi",
 	"blank",
 	"number",
 	"short",
+	"work",
 	"order"
 ];
 function normalizeItem(raw, index = 0, conceptIds = []) {
@@ -261,6 +283,8 @@ function normalizeItem(raw, index = 0, conceptIds = []) {
 		difficulty: Math.min(3, Math.max(1, Math.round(Number(raw?.difficulty) || 2))),
 		conceptIds: (Array.isArray(raw?.conceptIds) ? raw.conceptIds : []).filter((id) => conceptIds.includes(id)).slice(0, 4)
 	};
+	const figure = text(raw?.svg ?? raw?.figure, 16e3);
+	if (/^<svg[\s>]/iu.test(figure)) item.svg = figure;
 	if (kind === "choice" || kind === "multi" || kind === "order") {
 		item.options = list(raw?.options, LIMITS.options4, (option, optionIndex) => {
 			const label = text(typeof option === "string" ? option : option?.text ?? option?.label, 400);
@@ -667,14 +691,28 @@ function normalizeOp(raw, index) {
 		default: return null;
 	}
 }
+function syncOps(ops, rawAts) {
+	if (!rawAts.some((value) => value !== null)) return;
+	let current = 0;
+	ops.forEach((op, index) => {
+		current = Math.max(current, rawAts[index] ?? current);
+		op.at = current;
+	});
+}
+function sentenceIndex(value) {
+	const number = Number(value);
+	return value !== null && value !== "" && Number.isInteger(number) && number >= 0 ? Math.min(19, number) : null;
+}
 function normalizeBoard(raw, { conceptIds = [] } = {}) {
 	const sourceSteps = Array.isArray(raw) ? raw : Array.isArray(raw?.steps) ? raw.steps : [];
 	const steps = [];
 	let opCounter = 0;
+	let worked = false;
 	const idMap = /* @__PURE__ */ new Map();
 	for (const rawStep of sourceSteps.slice(0, BOARD_LIMITS.steps)) {
 		const say = text(rawStep?.say ?? rawStep?.narration ?? rawStep?.speech, BOARD_LIMITS.say);
 		const ops = [];
+		const ats = [];
 		for (const rawOp of (Array.isArray(rawStep?.ops ?? rawStep?.board) ? rawStep.ops ?? rawStep.board : []).slice(0, BOARD_LIMITS.opsPerStep)) {
 			const op = normalizeOp(rawOp, opCounter);
 			if (!op) continue;
@@ -682,13 +720,22 @@ function normalizeBoard(raw, { conceptIds = [] } = {}) {
 			op.id = `o${++opCounter}`;
 			if (originalId) idMap.set(originalId, op.id);
 			ops.push(op);
+			ats.push(sentenceIndex(rawOp?.at));
 		}
-		const check = rawStep?.check ? normalizeItem(rawStep.check, steps.length, conceptIds) : null;
+		syncOps(ops, ats);
+		let check = rawStep?.check ? normalizeItem(rawStep.check, steps.length, conceptIds) : null;
+		if (check?.kind === "work") if (worked) check = {
+			...check,
+			kind: "short"
+		};
+		else worked = true;
 		if (!say && !ops.length && !check) continue;
+		const goal = sentenceIndex(rawStep?.goal);
 		steps.push({
 			id: `s${steps.length + 1}`,
 			say,
 			ops,
+			...goal !== null && goal < 12 ? { goal } : {},
 			...check && check.kind !== "order" ? { check: {
 				...check,
 				id: `k${steps.length + 1}`
@@ -723,6 +770,164 @@ function boardToPlainText(board, { maxChars = 8e3, uptoStep } = {}) {
 	return output.length > maxChars ? `${output.slice(0, maxChars)}\n…` : output;
 }
 //#endregion
+//#region src/core/json-extract.js
+var JsonExtractError = class extends Error {
+	constructor(message, { cause, text } = {}) {
+		super(message, cause ? { cause } : void 0);
+		this.name = "JsonExtractError";
+		this.preview = typeof text === "string" ? text.slice(0, 200) : void 0;
+	}
+};
+const FENCE = /```(?:json|jsonl|javascript|js)?\s*\n?([\s\S]*?)```/giu;
+function stripTrailingCommas(text) {
+	let out = "";
+	let inString = false;
+	let escaped = false;
+	for (let index = 0; index < text.length; index += 1) {
+		const char = text[index];
+		if (inString) {
+			out += char;
+			if (escaped) escaped = false;
+			else if (char === "\\") escaped = true;
+			else if (char === "\"") inString = false;
+			continue;
+		}
+		if (char === "\"") {
+			inString = true;
+			out += char;
+			continue;
+		}
+		if (char === ",") {
+			let next = index + 1;
+			while (next < text.length && /\s/u.test(text[next])) next += 1;
+			if (text[next] === "}" || text[next] === "]") continue;
+		}
+		out += char;
+	}
+	return out;
+}
+function balancedSlice(text, from = 0) {
+	const start = text.slice(from).search(/[{[]/u);
+	if (start < 0) return void 0;
+	const begin = from + start;
+	const stack = [];
+	let inString = false;
+	let escaped = false;
+	for (let index = begin; index < text.length; index += 1) {
+		const char = text[index];
+		if (inString) {
+			if (escaped) escaped = false;
+			else if (char === "\\") escaped = true;
+			else if (char === "\"") inString = false;
+			continue;
+		}
+		if (char === "\"") inString = true;
+		else if (char === "{" || char === "[") stack.push(char);
+		else if (char === "}" || char === "]") {
+			const open = stack.pop();
+			if (char === "}" && open !== "{" || char === "]" && open !== "[") return void 0;
+			if (stack.length === 0) return {
+				begin,
+				end: index + 1,
+				text: text.slice(begin, index + 1)
+			};
+		}
+	}
+	return {
+		begin,
+		end: text.length,
+		text: text.slice(begin),
+		truncated: true,
+		stack
+	};
+}
+function repairTruncated(text) {
+	let body = text;
+	for (let attempt = 0; attempt < 40; attempt += 1) {
+		const closed = closeOpen(body);
+		if (closed !== void 0) try {
+			return JSON.parse(stripTrailingCommas(closed));
+		} catch {}
+		const cut = Math.max(body.lastIndexOf(","), body.lastIndexOf("{"), body.lastIndexOf("["));
+		if (cut <= 0) break;
+		body = body.slice(0, body[cut] === "," ? cut : cut + 1);
+	}
+	throw new JsonExtractError("model output was truncated beyond repair", { text });
+}
+function closeOpen(text) {
+	const stack = [];
+	let inString = false;
+	let escaped = false;
+	for (const char of text) {
+		if (inString) {
+			if (escaped) escaped = false;
+			else if (char === "\\") escaped = true;
+			else if (char === "\"") inString = false;
+			continue;
+		}
+		if (char === "\"") inString = true;
+		else if (char === "{" || char === "[") stack.push(char);
+		else if (char === "}" || char === "]") stack.pop();
+	}
+	if (inString) return void 0;
+	return text + stack.reverse().map((open) => open === "{" ? "}" : "]").join("");
+}
+function extractJson(raw, { allowTruncated = true } = {}) {
+	if (raw !== null && typeof raw === "object") return raw;
+	const text = String(raw ?? "").replace(/^/u, "").trim();
+	if (!text) throw new JsonExtractError("model returned an empty response", { text });
+	const candidates = [];
+	for (const match of text.matchAll(FENCE)) candidates.push(match[1].trim());
+	candidates.push(text);
+	let lastError;
+	for (const candidate of candidates) {
+		try {
+			return JSON.parse(candidate);
+		} catch (error) {
+			lastError = error;
+		}
+		const slice = balancedSlice(candidate);
+		if (slice === void 0) continue;
+		if (!slice.truncated) try {
+			return JSON.parse(stripTrailingCommas(slice.text));
+		} catch (error) {
+			lastError = error;
+		}
+		else if (allowTruncated) try {
+			return repairTruncated(slice.text);
+		} catch (error) {
+			lastError = error;
+		}
+	}
+	throw new JsonExtractError("model output did not contain valid JSON", {
+		cause: lastError,
+		text
+	});
+}
+function parseJsonLines(raw, { final = true } = {}) {
+	const lines = String(raw ?? "").replace(/```(?:jsonl|json)?/giu, "").split(/\r?\n/u);
+	const rest = final ? "" : lines.pop() ?? "";
+	const items = [];
+	const errors = [];
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed || !/^[{[]/u.test(trimmed)) continue;
+		try {
+			items.push(JSON.parse(stripTrailingCommas(trimmed)));
+		} catch (error) {
+			errors.push({
+				line: trimmed.slice(0, 120),
+				message: error.message
+			});
+		}
+	}
+	return {
+		items,
+		errors,
+		rest
+	};
+}
+//#endregion
 //#region src/core/mastery.js
 const BKT_DEFAULTS = Object.freeze({
 	pInit: .2,
@@ -868,6 +1073,13 @@ function pushHistory(state, entry) {
 function masteryPercent(state) {
 	return Math.round(clamp(Number(state?.pKnown) || 0, 0, 1) * 100);
 }
+Object.freeze([
+	"none",
+	"weak",
+	"learning",
+	"proficient",
+	"mastered"
+]);
 function masteryLevel(state) {
 	const p = clamp(Number(state?.pKnown) || 0, 0, 1);
 	let level = MASTERY_LEVELS[0].id;
@@ -1014,10 +1226,53 @@ function selectPassages(chunks, query, { maxChars = 12e3, limit = 12 } = {}) {
 	}
 	return result;
 }
+function spreadPassages(chunks, { maxChars = 12e3, samples = 16 } = {}) {
+	if (!chunks?.length) return [];
+	if (chunks.reduce((sum, chunk) => sum + chunk.text.length, 0) <= maxChars) return chunks.slice();
+	const count = Math.min(chunks.length, Math.max(2, samples));
+	const share = Math.max(200, Math.floor(maxChars / count));
+	const picked = [];
+	for (let index = 0; index < count; index += 1) {
+		const at = Math.round(index * (chunks.length - 1) / (count - 1));
+		if (picked.at(-1) !== at) picked.push(at);
+	}
+	return picked.map((at) => {
+		const chunk = chunks[at];
+		return chunk.text.length > share ? {
+			...chunk,
+			text: `${chunk.text.slice(0, share)}…`
+		} : chunk;
+	});
+}
+function documentParts(chunks, { partChars = 2e4, maxParts = 24, maxPartChars = 4e4 } = {}) {
+	if (!chunks?.length) return [];
+	const total = Math.max(1, chunks.reduce((sum, chunk) => sum + chunk.text.length, 0));
+	const count = Math.min(maxParts, Math.max(1, Math.ceil(total / partChars)));
+	const parts = Array.from({ length: count }, () => []);
+	let seen = 0;
+	for (const chunk of chunks) {
+		parts[Math.min(count - 1, Math.floor(seen / total * count))].push(chunk);
+		seen += chunk.text.length;
+	}
+	return parts.filter((part) => part.length).map((part) => {
+		return part.reduce((sum, chunk) => sum + chunk.text.length, 0) > maxPartChars ? spreadPassages(part, {
+			maxChars: maxPartChars,
+			samples: 24
+		}) : part;
+	});
+}
+function locationOf(passage) {
+	return passage?.page ? `p.${passage.page}` : passage?.slide ? `slide ${passage.slide}` : passage?.section ?? "";
+}
+function passageRange(passages) {
+	const first = locationOf(passages?.[0]);
+	const last = locationOf(passages?.at(-1));
+	return first && last && first !== last ? `${first}–${last}` : first || last;
+}
 function formatPassages(passages, sourceTitle) {
 	return passages.map((passage) => {
-		const where = passage.page ? `p.${passage.page}` : passage.slide ? `slide ${passage.slide}` : passage.section ?? "";
-		return `<<${sourceTitle ?? passage.source ?? "source"}${where ? ` · ${where}` : ""}>>\n${passage.text}`;
+		const where = locationOf(passage);
+		return `<<${[sourceTitle ?? passage.source ?? "source", where].filter(Boolean).join(" · ") || "excerpt"}>>\n${passage.text}`;
 	}).join("\n\n");
 }
 //#endregion
@@ -1117,164 +1372,6 @@ async function materialImages(store, materials) {
 	return images;
 }
 //#endregion
-//#region src/core/json-extract.js
-var JsonExtractError = class extends Error {
-	constructor(message, { cause, text } = {}) {
-		super(message, cause ? { cause } : void 0);
-		this.name = "JsonExtractError";
-		this.preview = typeof text === "string" ? text.slice(0, 200) : void 0;
-	}
-};
-const FENCE = /```(?:json|jsonl|javascript|js)?\s*\n?([\s\S]*?)```/giu;
-function stripTrailingCommas(text) {
-	let out = "";
-	let inString = false;
-	let escaped = false;
-	for (let index = 0; index < text.length; index += 1) {
-		const char = text[index];
-		if (inString) {
-			out += char;
-			if (escaped) escaped = false;
-			else if (char === "\\") escaped = true;
-			else if (char === "\"") inString = false;
-			continue;
-		}
-		if (char === "\"") {
-			inString = true;
-			out += char;
-			continue;
-		}
-		if (char === ",") {
-			let next = index + 1;
-			while (next < text.length && /\s/u.test(text[next])) next += 1;
-			if (text[next] === "}" || text[next] === "]") continue;
-		}
-		out += char;
-	}
-	return out;
-}
-function balancedSlice(text, from = 0) {
-	const start = text.slice(from).search(/[{[]/u);
-	if (start < 0) return void 0;
-	const begin = from + start;
-	const stack = [];
-	let inString = false;
-	let escaped = false;
-	for (let index = begin; index < text.length; index += 1) {
-		const char = text[index];
-		if (inString) {
-			if (escaped) escaped = false;
-			else if (char === "\\") escaped = true;
-			else if (char === "\"") inString = false;
-			continue;
-		}
-		if (char === "\"") inString = true;
-		else if (char === "{" || char === "[") stack.push(char);
-		else if (char === "}" || char === "]") {
-			const open = stack.pop();
-			if (char === "}" && open !== "{" || char === "]" && open !== "[") return void 0;
-			if (stack.length === 0) return {
-				begin,
-				end: index + 1,
-				text: text.slice(begin, index + 1)
-			};
-		}
-	}
-	return {
-		begin,
-		end: text.length,
-		text: text.slice(begin),
-		truncated: true,
-		stack
-	};
-}
-function repairTruncated(text) {
-	let body = text;
-	for (let attempt = 0; attempt < 40; attempt += 1) {
-		const closed = closeOpen(body);
-		if (closed !== void 0) try {
-			return JSON.parse(stripTrailingCommas(closed));
-		} catch {}
-		const cut = Math.max(body.lastIndexOf(","), body.lastIndexOf("{"), body.lastIndexOf("["));
-		if (cut <= 0) break;
-		body = body.slice(0, body[cut] === "," ? cut : cut + 1);
-	}
-	throw new JsonExtractError("model output was truncated beyond repair", { text });
-}
-function closeOpen(text) {
-	const stack = [];
-	let inString = false;
-	let escaped = false;
-	for (const char of text) {
-		if (inString) {
-			if (escaped) escaped = false;
-			else if (char === "\\") escaped = true;
-			else if (char === "\"") inString = false;
-			continue;
-		}
-		if (char === "\"") inString = true;
-		else if (char === "{" || char === "[") stack.push(char);
-		else if (char === "}" || char === "]") stack.pop();
-	}
-	if (inString) return void 0;
-	return text + stack.reverse().map((open) => open === "{" ? "}" : "]").join("");
-}
-function extractJson(raw, { allowTruncated = true } = {}) {
-	if (raw !== null && typeof raw === "object") return raw;
-	const text = String(raw ?? "").replace(/^/u, "").trim();
-	if (!text) throw new JsonExtractError("model returned an empty response", { text });
-	const candidates = [];
-	for (const match of text.matchAll(FENCE)) candidates.push(match[1].trim());
-	candidates.push(text);
-	let lastError;
-	for (const candidate of candidates) {
-		try {
-			return JSON.parse(candidate);
-		} catch (error) {
-			lastError = error;
-		}
-		const slice = balancedSlice(candidate);
-		if (slice === void 0) continue;
-		if (!slice.truncated) try {
-			return JSON.parse(stripTrailingCommas(slice.text));
-		} catch (error) {
-			lastError = error;
-		}
-		else if (allowTruncated) try {
-			return repairTruncated(slice.text);
-		} catch (error) {
-			lastError = error;
-		}
-	}
-	throw new JsonExtractError("model output did not contain valid JSON", {
-		cause: lastError,
-		text
-	});
-}
-function parseJsonLines(raw, { final = true } = {}) {
-	const lines = String(raw ?? "").replace(/```(?:jsonl|json)?/giu, "").split(/\r?\n/u);
-	const rest = final ? "" : lines.pop() ?? "";
-	const items = [];
-	const errors = [];
-	for (const line of lines) {
-		const trimmed = line.trim();
-		if (!trimmed || !/^[{[]/u.test(trimmed)) continue;
-		try {
-			items.push(JSON.parse(stripTrailingCommas(trimmed)));
-		} catch (error) {
-			errors.push({
-				line: trimmed.slice(0, 120),
-				message: error.message
-			});
-		}
-	}
-	return {
-		items,
-		errors,
-		rest
-	};
-}
-//#endregion
 //#region src/host/generate.js
 var TutorError = class extends Error {
 	constructor(code, message) {
@@ -1284,15 +1381,19 @@ var TutorError = class extends Error {
 	}
 };
 const REPAIR = "Your previous reply could not be parsed as JSON. Reply again with the complete answer as valid JSON only — no code fences, no commentary.";
-async function generateJson(llm, { purpose = "teach", prompt, maxTokens = 8e3, images, signal, normalize = (value) => value }) {
-	const first = await llm.complete({
+async function generateJson(llm, { purpose = "teach", prompt, maxTokens = 8e3, images, signal, normalize = (value) => value, onText }) {
+	const request = {
 		purpose,
 		system: prompt.system,
 		user: prompt.user,
 		images,
 		maxTokens,
 		signal
-	});
+	};
+	const first = onText ? await llm.stream({
+		...request,
+		onText
+	}) : await llm.complete(request);
 	try {
 		return normalize(extractJson(first));
 	} catch (error) {
@@ -1313,7 +1414,7 @@ async function generateJson(llm, { purpose = "teach", prompt, maxTokens = 8e3, i
 		}
 	}
 }
-async function generateSteps(llm, { purpose = "teach", prompt, maxTokens = 12e3, signal, conceptIds = [], onStep, minSteps = 1, images }) {
+async function generateSteps(llm, { purpose = "teach", effort, prompt, maxTokens = 12e3, signal, conceptIds = [], onStep, minSteps = 1, images }) {
 	const raw = [];
 	let buffer = "";
 	let emitted = 0;
@@ -1340,6 +1441,7 @@ async function generateSteps(llm, { purpose = "teach", prompt, maxTokens = 12e3,
 	};
 	const full = await llm.stream({
 		purpose,
+		effort,
 		system: prompt.system,
 		user: prompt.user,
 		images,
@@ -1369,6 +1471,20 @@ async function generateSteps(llm, { purpose = "teach", prompt, maxTokens = 12e3,
 	}
 	return board;
 }
+function streamCounter(marker, onCount) {
+	let tail = "";
+	let count = 0;
+	return (delta) => {
+		const textValue = tail + String(delta ?? "");
+		let found = 0;
+		for (let at = textValue.indexOf(marker); at !== -1; at = textValue.indexOf(marker, at + marker.length)) found += 1;
+		tail = textValue.slice(-(marker.length - 1));
+		if (found) {
+			count += found;
+			onCount(count);
+		}
+	};
+}
 async function generateText(llm, { purpose = "teach", prompt, maxTokens = 6e3, signal, onText }) {
 	const textValue = onText ? await llm.stream({
 		purpose,
@@ -1462,8 +1578,11 @@ Fill the left column, then {"t":"col"}, then the right column; start a new page
 const STEP_SPEC = `Each output line is ONE teaching step:
 {"say":"what you say while writing — natural spoken sentences, 1–4 sentences, no markdown","ops":[ …board ops written during this step… ],"check":{ …optional quick question… }}
 
+Write the board in time with your voice: give every op "at", the 0-based index of the sentence in "say" during which you write it, so each item appears while the sentence about it is spoken (sentences end at 。！？；.!?;). "at" never goes down within a step: {"say":"先看这个公式。它说明力与位移方向相反。","ops":[{"t":"math","tex":"F=-kx","at":0},{"t":"p","text":"负号 = 方向相反","at":1}]}
+
 A check is a short question asked right after the step, to see whether the idea landed:
-{"kind":"choice|multi|blank|number|short","prompt":"…","options":["…","…"],"answer":<option index (0-based) for choice, list of indexes for multi, accepted strings for blank, a number for number, a model answer for short>,"tolerance":<number, for number>,"explanation":"why the answer is right, in one or two sentences","conceptIds":["<ids from the concept list>"]}
+{"kind":"choice|multi|blank|number|short|work","prompt":"…","options":["…","…"],"answer":<option index (0-based) for choice, list of indexes for multi, accepted strings for blank, a number for number, a model answer for short, the full model working for work>,"tolerance":<number, for number>,"rubric":["…"],"explanation":"why the answer is right, in one or two sentences","conceptIds":["<ids from the concept list>"]}
+A "work" check has the learner write out a whole calculation or derivation: "answer" is the model working, one step per line with inline math $…$, and "rubric" lists the 2–4 steps a correct working must contain. Use "work" only where the instructions ask for it.
 Make wrong options plausible (common mistakes), never trick questions.`;
 function questionnairePrompt({ goal, language, materialsSummary, profile }) {
 	return {
@@ -1473,14 +1592,33 @@ function questionnairePrompt({ goal, language, materialsSummary, profile }) {
 Return {"questions":[{"prompt":"…","topic":"purpose|level|timeline|style|focus|other","multi":false,"options":[{"label":"…","detail":"…"}]}]}`)
 	};
 }
-function sizeGuidance(timeline) {
+const SIZE_RANGES = Object.freeze({
+	short: [
+		3,
+		8,
+		"1–2"
+	],
+	standard: [
+		10,
+		20,
+		"2–4"
+	],
+	full: [
+		25,
+		45,
+		"4–8"
+	]
+});
+function sizeGuidance(timeline, size) {
+	const range = SIZE_RANGES[size];
+	if (range) return `The learner chose the course size: ${range[0]}–${range[1]} lessons in the whole course, in ${range[2]} units. Count every lesson across all units before you answer: never more than ${range[1]}; if the subject seems to need more, merge closely related lessons. The pace only spreads the lessons over the weeks. Never pad with filler lessons.`;
 	return `Size the course to the goal first. When the goal is a single idea or names a time budget ("in 20 minutes", "one evening", "this weekend"), fit it: one unit with a single lecture of 1–4 lessons can be the whole course. Never pad with filler lessons. ${timeline === "intensive" ? "Intensive pace: for a broad subject, up to 4–6 units and 18–30 lessons, focused on what matters most for the goal." : timeline === "relaxed" ? "No fixed deadline: for a broad subject, up to 6–10 units and 35–70 lessons, with room for depth, connections and enrichment." : "Balanced pace: for a broad subject, up to 5–8 units and 26–45 lessons, covering foundations, practice and an applied project."}`;
 }
-function blueprintPrompt({ goal, language, intake, materialsSummary, profile, timeline, weeklyMinutes }) {
+function blueprintPrompt({ goal, language, intake, materialsSummary, profile, timeline, size, weeklyMinutes }) {
 	return {
 		system: join(PERSONA, `You design personal courses with the care of an experienced curriculum designer: clear prerequisites first, one new idea per lesson, frequent practice, and applied projects that make the knowledge usable. ${languageRule(language)}`, JSON_ONLY),
 		user: join(block("learning_goal", goal), block("intake_answers", intake), block("materials", materialsSummary), learnerBlock({ profile }), `Design the course blueprint.
-- ${sizeGuidance(timeline)}${weeklyMinutes ? ` The learner can study about ${weeklyMinutes} minutes per week.` : ""}
+- ${sizeGuidance(timeline, size)}${weeklyMinutes ? ` The learner can study about ${weeklyMinutes} minutes per week.` : ""}
 - Structure: units → lectures (1–5 per unit) → lessons (1–5 per lecture). Each lesson takes 10–25 minutes and teaches one coherent idea.
 - Order lessons so every prerequisite comes first. Start from where the learner is, not from zero if they already know the basics.
 - If materials were provided, follow their scope and order where sensible.
@@ -1497,13 +1635,20 @@ function revisePrompt({ blueprint, instruction, language }) {
 		user: join(block("current_blueprint", blueprint), block("change_request", instruction), "Apply the change request and return the complete revised blueprint in the same JSON shape. Keep the \"id\" field of every unit, lecture, lesson and concept you do not substantially change; new items get no id.")
 	};
 }
+const ITEM_FIGURE = "When a figure makes a question clearer (a shape to measure, a graph to read, a circuit, a diagram to label), give the item \"svg\": a small diagram following the same rules as the board's svg op (viewBox at most 480×320). Most items need no figure.";
+function reworkPrompt({ outline, unitTitle, lectureTitle, lesson, mode, language }) {
+	return {
+		system: join(PERSONA, `You design personal courses with the care of an experienced curriculum designer: clear prerequisites first, one new idea per lesson. ${languageRule(language)}`, JSON_ONLY),
+		user: join(block("course_outline", outline), block("position", `Unit: ${unitTitle}\nLecture: ${lectureTitle}`), block("lesson", lesson), mode === "split" ? "Split this lesson into two consecutive lessons that together cover everything it covers. Each teaches one coherent idea in 10–20 minutes, and the first prepares the second. Stay consistent with the rest of the course." : "Rewrite this lesson to go deeper. Keep its topic and its place in the course, but aim at why it works, its edge cases and its connections to the rest of the course; adjust the objectives, concepts and minutes (at most 25) to match.", "Return {\"lessons\":[{\"title\":\"…\",\"summary\":\"…\",\"objectives\":[\"…\"],\"concepts\":[\"…\"],\"estMinutes\":15}]}")
+	};
+}
 function practicePrompt({ course, lecture, lessons, language, passages }) {
 	const lessonLines = lessons.map((lesson) => `- [${lesson.id}] ${lesson.title}: ${lesson.objectives.join("; ")} | concepts: ${lesson.concepts.map((concept) => `${concept.id}=${concept.name}`).join(", ")}`).join("\n");
 	return {
 		system: join(PERSONA, `You write practice that builds real understanding: retrieval, application, and common-mistake traps, from easy to harder. ${languageRule(language)}`, JSON_ONLY),
-		user: join(block("course", `${course.title} — ${course.summary ?? ""}`), block("lecture", lecture.title), block("lessons", lessonLines), block("source_passages", passages), `For EACH lesson write 4–6 practice items. Mix kinds: "choice" (4 options), "multi", "blank" (short exact answer; list accepted spellings), "number" (with tolerance), "short" (a sentence or two, with a model answer and 2–3 rubric points). At least one item per lesson asks the learner to apply the idea to a new situation. Give each item 1–2 hints that nudge without giving the answer, an explanation, a difficulty 1–3, and the conceptIds it tests (use the ids given).
+		user: join(block("course", `${course.title} — ${course.summary ?? ""}`), block("lecture", lecture.title), block("lessons", lessonLines), block("source_passages", passages), `For EACH lesson write 4–6 practice items. Mix kinds: "choice" (4 options), "multi", "blank" (short exact answer; list accepted spellings), "number" (with tolerance), "short" (a sentence or two, with a model answer and 2–3 rubric points). At least one item per lesson asks the learner to apply the idea to a new situation. Give each item 1–2 hints that nudge without giving the answer, an explanation, a difficulty 1–3, and the conceptIds it tests (use the ids given). ${ITEM_FIGURE}
 
-Return {"lessons":{"<lesson id>":{"items":[{"kind":"choice","prompt":"…","options":["…"],"answer":0,"hints":["…"],"explanation":"…","difficulty":1,"conceptIds":["…"]}]}}}`)
+Return {"lessons":{"<lesson id>":{"items":[{"kind":"choice","prompt":"…","options":["…"],"answer":0,"hints":["…"],"explanation":"…","difficulty":1,"conceptIds":["…"],"svg":"<svg …>…</svg> (optional)"}]}}}`)
 	};
 }
 function projectsPrompt({ course, projects, language }) {
@@ -1533,8 +1678,10 @@ function lessonPrompt({ course, unit, lecture, lesson, language, learner, passag
 - Build intuition before formalism; then make it precise; then work at least one example fully on the board.
 - Draw a diagram or chart whenever a picture makes the idea click.
 - Put 2–4 checks after the key ideas, plus one at the end; every check must name its conceptIds.
+- If the lesson works through a calculation or a derivation, make exactly one check a "work" check, right after the key worked example: a similar problem the learner solves alone, writing every step. A lesson without a calculation or derivation gets no "work" check.
 - If source passages are given, stay consistent with them and mention the page when you lean on one.
 - Close with a recap step: a "key" note with the 2–3 takeaways, and say what comes next.
+- Give each step that works towards one of the objectives "goal": its 0-based index in the objectives above (${lesson.objectives.map((objective, index) => `${index} = ${objective}`).join("; ") || "none"}); leave it out for the hook and the recap. Cover the objectives in order.
 Start with a step whose ops begin with {"t":"title","text":"${lesson.title.replace(/"/gu, "\\\"")}"}.`)
 	};
 }
@@ -1557,10 +1704,24 @@ function reexplainPrompt({ lesson, language, step, boardSoFar, style }) {
 		user: join(block("lesson", lesson ? lesson.title : ""), block("board_so_far", boardSoFar), block("step_to_reexplain", step), `The learner did not get this step. Explain the same idea again ${REEXPLAIN_STYLES[style] ?? REEXPLAIN_STYLES.example}, in 2–4 steps, starting with {"t":"page","title":"…"}. End with one quick check.`)
 	};
 }
+const GRADE_FIELDS = "\"score\":<0 to 1>,\"verdict\":\"correct|partial|incorrect\",\"feedback\":\"2–3 encouraging sentences: what is right, what is missing, how to fix it\",\"errorTag\":\"<3–6 word label of the main mistake, or empty>\",\"misconception\":<true if the answer shows a confident wrong belief rather than a gap>";
 function gradePrompt({ item, response, language }) {
+	const work = item.kind === "work";
 	return {
-		system: join(PERSONA, `You grade open answers fairly: credit correct ideas expressed in the learner's own words, ignore spelling and phrasing, and pinpoint the exact gap. ${languageRule(language)}`, JSON_ONLY),
-		user: join(block("question", item.prompt), block("model_answer", item.answer), block("rubric", (item.rubric ?? []).join("\n")), block("learner_answer", response), "Return {\"score\":<0 to 1>,\"verdict\":\"correct|partial|incorrect\",\"feedback\":\"2–3 encouraging sentences: what is right, what is missing, how to fix it\",\"errorTag\":\"<3–6 word label of the main mistake, or empty>\",\"misconception\":<true if the answer shows a confident wrong belief rather than a gap>}")
+		system: join(PERSONA, `You grade open answers fairly: credit correct ideas expressed in the learner's own words, ignore spelling and phrasing, and pinpoint the exact gap.${work ? " For a written working, follow it line by line and find the first line that goes wrong; a different but valid route is not a mistake, and a slip carried forward counts once." : ""} ${languageRule(language)}`, JSON_ONLY),
+		user: join(block("question", item.prompt), block(work ? "model_working" : "model_answer", item.answer), block("rubric", (item.rubric ?? []).join("\n")), block(work ? "learner_working" : "learner_answer", response), work ? `Return {${GRADE_FIELDS},"wrongStep":"the first wrong line of the learner's working, copied exactly, or empty when every line is right","why":"one sentence: what is wrong in that line","fix":"that line written correctly, with inline math $…$"}` : `Return {${GRADE_FIELDS}}`)
+	};
+}
+function correctionPrompt({ course, lesson, language, boardSoFar, item, response, grade }) {
+	const notes = [
+		grade.wrongStep ? `First wrong line: ${grade.wrongStep}` : "",
+		grade.why ? `What is wrong: ${grade.why}` : "",
+		grade.fix ? `Corrected line: ${grade.fix}` : "",
+		grade.feedback ? `Feedback already shown: ${grade.feedback}` : ""
+	].filter(Boolean).join("\n");
+	return {
+		system: join(PERSONA, BOARD_SPEC, STEP_SPEC, languageRule(language), JSONL_ONLY),
+		user: join(block("course", course ? course.title : ""), block("lesson", lesson ? `${lesson.title}: ${lesson.objectives?.join("; ") ?? ""}` : ""), block("board_so_far", boardSoFar), block("problem", item.prompt), block("model_working", item.answer), block("learner_working", response), block("grader_notes", notes), "The learner just wrote out their working for this problem and went wrong somewhere. Correct it at the board in 2–3 steps, continuing on the current board: (1) write the learner's wrong line as they wrote it, in an op with an \"id\", then {\"t\":\"mark\",\"ref\":\"<that id>\",\"style\":\"box\"}, and say kindly what went wrong there and why; (2) write the corrected line and carry the working on to the right answer; (3) end with a short {\"t\":\"note\",\"tone\":\"key\",\"text\":\"…\"} holding the rule to remember. Speak to the learner directly and keep it brief. Add no check, and do not continue the lesson itself.")
 	};
 }
 function projectReviewPrompt({ project, submission, language }) {
@@ -1593,7 +1754,7 @@ Return {"cards":[{"front":"…","back":"…","tag":"<topic>"}]}`)
 function quizPrompt({ scopeTitle, outline, concepts, language, count = 10 }) {
 	return {
 		system: join(PERSONA, `You write fair, well-balanced quizzes. ${languageRule(language)}`, JSON_ONLY),
-		user: join(block("scope", scopeTitle), block("outline", outline), block("concepts", concepts), `Write a ${count}-question quiz across the whole scope: about 30% recall, 50% application, 20% harder transfer questions. Mix choice, multi, blank, number and short items, each with explanation, difficulty and conceptIds (use the ids given).
+		user: join(block("scope", scopeTitle), block("outline", outline), block("concepts", concepts), `Write a ${count}-question quiz across the whole scope: about 30% recall, 50% application, 20% harder transfer questions. Mix choice, multi, blank, number and short items, each with explanation, difficulty and conceptIds (use the ids given). ${ITEM_FIGURE}
 
 Return {"items":[…same item shape as practice items…]}`)
 	};
@@ -1604,10 +1765,16 @@ function summaryPrompt({ scopeTitle, passages, outline, language }) {
 		user: join(block("scope", scopeTitle), block("outline", outline), block("source_passages", passages), "Write structured study notes in Markdown: a 3–5 sentence overview, then sections with headings, key points, formulas ($…$ / $$…$$), and short examples, then a \"Check yourself\" list of 5 questions. Cite pages as (p. N) where the source says so.")
 	};
 }
-function digestPrompt({ title, passages, language }) {
+function digestPrompt({ title, passages, notes, language }) {
 	return {
 		system: join(PERSONA, `You help learners digest long readings: you surface the structure and the argument, not just a summary. ${languageRule(language)}`, JSON_ONLY),
-		user: join(block("document", title), block("passages", passages), "Return {\"overview\":\"3–5 sentences\",\"structure\":[{\"heading\":\"…\",\"points\":[\"…\"],\"pages\":\"e.g. 3–7\"}],\"keyIdeas\":[\"…\"],\"arguments\":[{\"claim\":\"…\",\"support\":\"…\",\"page\":\"…\"}],\"glossary\":[{\"term\":\"…\",\"meaning\":\"…\"}],\"questions\":[\"5 questions worth discussing or testing\"]}")
+		user: join(block("document", title), notes ? block("notes_on_each_part", notes) : block("passages", passages), notes ? "The notes above cover the whole document part by part, in order. Combine them into one digest of the whole document: follow its structure from beginning to end, merge points that repeat, and keep the page references from the notes." : "", "Return {\"overview\":\"3–5 sentences\",\"structure\":[{\"heading\":\"…\",\"points\":[\"…\"],\"pages\":\"e.g. 3–7\"}],\"keyIdeas\":[\"…\"],\"arguments\":[{\"claim\":\"…\",\"support\":\"…\",\"page\":\"…\"}],\"glossary\":[{\"term\":\"…\",\"meaning\":\"…\"}],\"questions\":[\"5 questions worth discussing or testing\"]}")
+	};
+}
+function digestPartPrompt({ title, part, parts, range, passages, language }) {
+	return {
+		system: join(PERSONA, `You are reading a long document one part at a time for a learner. Take faithful notes on this part only; a later pass combines the notes of all parts. ${languageRule(language)}`, JSON_ONLY),
+		user: join(block("document", title), block("part", `Part ${part} of ${parts}${range ? ` (${range})` : ""}`), block("passages", passages), "Take notes on this part only. Return {\"sections\":[{\"heading\":\"the chapter or section title as the text gives it\",\"pages\":\"e.g. 12–18\",\"points\":[\"…\"]}],\"keyIdeas\":[\"…\"],\"arguments\":[{\"claim\":\"…\",\"support\":\"…\",\"page\":\"…\"}],\"glossary\":[{\"term\":\"…\",\"meaning\":\"…\"}]}. Take page numbers from the passage labels; never invent them.")
 	};
 }
 const ASSIST_MODES = Object.freeze({
@@ -1630,7 +1797,7 @@ function shortPrompt({ topic, passages, language }) {
 function materialBriefPrompt({ title, passages, language }) {
 	return {
 		system: join(PERSONA, languageRule(language), JSON_ONLY),
-		user: join(block("document", title), block("passages", passages), "Describe this material for a course designer. Return {\"summary\":\"3–4 sentences\",\"topics\":[\"main topics in order\"],\"level\":\"beginner|intermediate|advanced\",\"suggestedGoal\":\"one sentence learning goal a student might have for it\"}")
+		user: join(block("document", title), block("passages", passages), "The passages are excerpts spread across the whole document, each labelled with where it comes from. Describe this material as a whole for a course designer, not just its opening. Return {\"summary\":\"3–4 sentences\",\"topics\":[\"main topics in the order the document covers them\"],\"level\":\"beginner|intermediate|advanced\",\"suggestedGoal\":\"one sentence learning goal a student might have for it\"}")
 	};
 }
 function profilePrompt({ profile, events, language }) {
@@ -1654,4 +1821,4 @@ function getRuntime() {
 	return runtime;
 }
 //#endregion
-export { normalizePractice as $, materialImages as A, boardToPlainText as B, TutorError as C, EMPTY_PROFILE as D, generateText as E, readProgress as F, flattenLessons as G, conceptIndex as H, applyEvidence as I, lessonAfter as J, insertLesson as K, createConceptState as L, passagesFor as M, readMaterials as N, emptyProgress as O, readProfile as P, normalizeCheatsheet as Q, masteryPercent as R, summaryPrompt as S, generateSteps as T, courseProgress as U, normalizeBoard as V, findLesson as W, normalizeBlueprint as X, nextLesson as Y, normalizeCards as Z, questionnairePrompt as _, blueprintPrompt as a, assertId as at, revisePrompt as b, digestPrompt as c, lessonPrompt as d, normalizeProject as et, materialBriefPrompt as f, projectsPrompt as g, projectReviewPrompt as h, assistPrompt as i, text as it, materialsSummary as j, masteryFor as k, flashcardsPrompt as l, profilePrompt as m, publishRuntime as n, outlineForPrompt as nt, cheatsheetPrompt as o, newId as ot, practicePrompt as p, intakeSummary as q, askPrompt as r, safeRelativePath as rt, detectLanguage as s, getRuntime as t, normalizeQuestionnaire as tt, gradePrompt as u, quizPrompt as v, generateJson as w, shortPrompt as x, reexplainPrompt as y, recommendNext as z };
+export { courseProgress as $, streamCounter as A, documentParts as B, reworkPrompt as C, generateJson as D, TutorError as E, materialsSummary as F, createConceptState as G, passageRange as H, passagesFor as I, extractJson as J, masteryPercent as K, readMaterials as L, emptyProgress as M, masteryFor as N, generateSteps as O, materialImages as P, conceptIndex as Q, readProfile as R, revisePrompt as S, summaryPrompt as T, spreadPassages as U, formatPassages as V, applyEvidence as W, normalizeBoard as X, boardToPlainText as Y, blueprintOutline as Z, projectReviewPrompt as _, newId as _t, blueprintPrompt as a, nextLesson as at, quizPrompt as b, detectLanguage as c, normalizeCheatsheet as ct, flashcardsPrompt as d, normalizeProject as dt, findLesson as et, gradePrompt as f, normalizeQuestionnaire as ft, profilePrompt as g, assertId as gt, practicePrompt as h, text as ht, assistPrompt as i, lessonAfter as it, EMPTY_PROFILE as j, generateText as k, digestPartPrompt as l, normalizeLesson as lt, materialBriefPrompt as m, safeRelativePath as mt, publishRuntime as n, insertLesson as nt, cheatsheetPrompt as o, normalizeBlueprint as ot, lessonPrompt as p, outlineForPrompt as pt, recommendNext as q, askPrompt as r, intakeSummary as rt, correctionPrompt as s, normalizeCards as st, getRuntime as t, flattenLessons as tt, digestPrompt as u, normalizePractice as ut, projectsPrompt as v, shortPrompt as w, reexplainPrompt as x, questionnairePrompt as y, readProgress as z };