dsh-aha-tutor 1.2.0 → 1.3.0

package/lib/{runtime-ywaTyu56.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);
@@ -683,6 +707,7 @@ 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);
@@ -698,7 +723,12 @@ function normalizeBoard(raw, { conceptIds = [] } = {}) {
 			ats.push(sentenceIndex(rawOp?.at));
 		}
 		syncOps(ops, ats);
-		const check = rawStep?.check ? normalizeItem(rawStep.check, steps.length, conceptIds) : null;
+		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({
@@ -740,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,
@@ -885,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;
@@ -1177,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) {
@@ -1377,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;
@@ -1404,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,
@@ -1543,7 +1581,8 @@ const STEP_SPEC = `Each output line is ONE teaching step:
 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 {
@@ -1553,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.
@@ -1577,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 }) {
@@ -1613,6 +1678,7 @@ 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.
@@ -1638,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 }) {
@@ -1674,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…]}`)
 	};
@@ -1741,4 +1821,4 @@ function getRuntime() {
 	return runtime;
 }
 //#endregion
-export { intakeSummary as $, emptyProgress as A, passageRange as B, summaryPrompt as C, generateText as D, generateSteps as E, readMaterials as F, recommendNext as G, applyEvidence as H, readProfile as I, conceptIndex as J, boardToPlainText as K, readProgress as L, materialImages as M, materialsSummary as N, streamCounter as O, passagesFor as P, insertLesson as Q, documentParts as R, shortPrompt as S, generateJson as T, createConceptState as U, spreadPassages as V, masteryPercent as W, findLesson as X, courseProgress as Y, flattenLessons as Z, projectsPrompt as _, blueprintPrompt as a, normalizePractice as at, reexplainPrompt as b, digestPartPrompt as c, outlineForPrompt as ct, gradePrompt as d, assertId as dt, lessonAfter as et, lessonPrompt as f, newId as ft, projectReviewPrompt as g, profilePrompt as h, assistPrompt as i, normalizeCheatsheet as it, masteryFor as j, EMPTY_PROFILE as k, digestPrompt as l, safeRelativePath as lt, practicePrompt as m, publishRuntime as n, normalizeBlueprint as nt, cheatsheetPrompt as o, normalizeProject as ot, materialBriefPrompt as p, normalizeBoard as q, askPrompt as r, normalizeCards as rt, detectLanguage as s, normalizeQuestionnaire as st, getRuntime as t, nextLesson as tt, flashcardsPrompt as u, text as ut, questionnairePrompt as v, TutorError as w, revisePrompt as x, quizPrompt as y, formatPassages 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-aha-tutor",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "开窍 Aha Tutor: a personal AI tutor for DeepSeek Harness that builds a course around you and teaches it on a narrated handwriting whiteboard",
   "type": "module",
   "main": "./lib/index.js",