practice — discretized parameter axes: named levels, never a number (owner-approved 2026-09-29)

Contracts: LadderRung 0-4, CueDistance 0-2, Presentation theory|
application; PracticeParams carries the three named levels. Doc
comments hold the three definition tables verbatim (rung names +
definitions from the ladder doctrine; cue levels; presentation
levels).

Core: LADDER_RUNGS/CUE_LEVELS/PRESENTATIONS tables in src/core/
practice.ts (definitions verbatim) — ONE source spoken by the agents'
prompts, the dialog's stepped controls, and the exam header; core
barrel re-exports practice.ts (pure domain, browser-safe).

Agents: Part I's ladder intro now 'five rungs, numbered; the request
arrives as a rung' with bullets numbered 0-4 (definitions untouched);
Part III's parameters block replaced with the named-level doctrine
(rung = exact class, no continuum; cue counts lesson examples AND
previous problems' situations; presentation dresses, never changes);
partitioner's RESPECT THE PARAMETERS replaced (low rungs = many small
assignments, high = larger; far cue makes confusables-together MORE
important; presentation does not shape the partition). renderParams
outputs the exact named-level block. Anchor/0..1 language swept dead.

Service + store: strict union validation — floats between levels,
out-of-range, wrong strings, legacy dial shapes all 400 at the API
and fail isProblemSet (legacy sets skipped from lists; no migration —
data/practice is disposable scratch, owner wipes before testing).

UI: dialog = 5-detent ladder slider + 3-detent cue slider (each shows
the level NAME + one-line definition) + Theory|Application segmented
toggle; defaults rung 2 / cue 1 / theory; Create posts the new shape.
Exam header gains the levels line ('Direct exercise · Adjacent
context · Theory').

Tests: renderParams exact-block pin; strict-validation pins (new
tests/practice-service.test.ts — bad unions 400, legacy shape 400);
store pins (legacy floats + 2.5 rung fail); render pins (detents +
names + definitions, defaults, detent-swap, toggle active segment,
levels line); every params fixture moved off floats. 1138/1138, tsc
0, lint 0, build 0.

Docs: architecture.md — discretization paragraph (compact tables,
named-level invocation, defaults, one-table source), UI mentions;
README axes sentence.

tests/render-practice.test.tsx

@@ -9,11 +9,7 @@ import {
 	PracticeListBody,
 	setStatusWord,
 } from "../components/practice-list.tsx";
-import {
-	PRACTICE_DIALS,
-	PracticeDialogBody,
-	type PracticeFailure,
-} from "../components/practice-dialog.tsx";
+import { DEFAULT_PRACTICE_PARAMS, PracticeDialogBody, type PracticeFailure } from "../components/practice-dialog.tsx";
 import type { GraphClusterGroup } from "../src/core";
 import { PracticeExamBody } from "../components/practice-exam.tsx";
 import type { Problem, ProblemSet } from "../src/core";
@@ -30,13 +26,7 @@ import type { Problem, ProblemSet } from "../src/core";
 
 // ─── fixtures ────────────────────────────────────────────────────────────────
 
-const PARAMS = { searchSolutionRatio: 0.5, cueDistance: 0.5, presentation: 0.5 };
-
-const dialValues = {
-	searchSolutionRatio: 0.7,
-	cueDistance: 0.5,
-	presentation: 0.3,
-};
+const PARAMS = { ladderRung: 2, cueDistance: 1, presentation: "theory" } as const;
 
 function clusters(): GraphClusterGroup[] {
 	return [
@@ -95,8 +85,8 @@ function set(over: Partial<ProblemSet> = {}): ProblemSet {
 
 describe("PracticeDialogBody — creation (cluster picker)", () => {
 	const base = {
-		values: dialValues,
-		onDial: () => {},
+		params: { ...DEFAULT_PRACTICE_PARAMS },
+		onParam: () => {},
 		clusters: clusters(),
 		selectedKey: null,
 		onSelect: () => {},
@@ -107,13 +97,33 @@ describe("PracticeDialogBody — creation (cluster picker)", () => {
 		onRun: () => {},
 	};
 
-	it("renders the three dials with anchor labels", () => {
+	it("stepped controls: 5-detent ladder + 3-detent cue + Theory|Application toggle, defaults rung 2 / cue 1 / theory", () => {
 		const html = renderToStaticMarkup(<PracticeDialogBody {...base} />);
-		for (const dial of PRACTICE_DIALS) {
-			assert.ok(html.includes(`data-testid="dial-${dial.key}"`), `the ${dial.key} dial`);
-			assert.ok(html.includes(dial.anchors), `the ${dial.key} anchors`);
-			assert.ok(html.includes(dial.label));
-		}
+		assert.ok(html.includes('data-testid="param-ladder"'));
+		assert.match(html, /min="0" max="4" step="1"/);
+		assert.ok(html.includes('data-testid="param-cue"'));
+		assert.match(html, /min="0" max="2" step="1"/);
+		assert.ok(html.includes('data-testid="param-presentation-theory"'));
+		assert.ok(html.includes('data-testid="param-presentation-application"'));
+		// The DEFAULTS: rung 2 / cue 1 / theory, with names + definitions.
+		assert.match(html, /value="2"/); // ladder detent
+		assert.match(html, /value="1"/); // cue detent
+		assert.ok(html.includes("Direct exercise"), "default rung name");
+		assert.ok(html.includes("Adjacent context"), "default cue name");
+		assert.ok(html.includes("one step, no hint"), "current rung definition shown");
+		assert.ok(html.includes("same domain, different setup/packaging"), "current cue definition shown");
+	});
+
+	it("moving a detent swaps the shown name + definition; the toggle switches", () => {
+		const moved = renderToStaticMarkup(
+			<PracticeDialogBody {...base} params={{ ladderRung: 4, cueDistance: 0, presentation: "application" }} />,
+		);
+		assert.ok(moved.includes("Path-finding"));
+		assert.ok(moved.includes("the statement suggesting wrong methods"), "rung-4 definition");
+		assert.ok(moved.includes("Lesson context"));
+		assert.ok(moved.includes("textbook/toy-example shape"), "cue-0 definition");
+		assert.ok(moved.includes("a concrete worldly affair"), "application definition shown");
+		assert.match(moved, /param-presentation-application[^]*border-primary/, "application segment active");
 	});
 
 	it("cluster picker: label + proposition-count rows, notes kind marked, Create gated until picked", () => {
@@ -264,6 +274,13 @@ describe("PracticeExamBody — exam states", () => {
 		assert.ok(!html.includes('data-testid="practice-submit"'));
 	});
 
+	it("the header carries the levels line (named levels, owner 2026-09-29)", () => {
+		const s = set({ problems: [readyProblem("pp_1", ["n3"])] });
+		const html = renderToStaticMarkup(<PracticeExamBody set={s} {...examBase} />);
+		assert.ok(html.includes('data-testid="practice-exam-levels"'));
+		assert.ok(html.includes("Direct exercise · Adjacent context · Theory"), "the fixture's rung 2 / cue 1 / theory");
+	});
+
 	it("ready: the statement renders as markdown, the box is answerable, submit gated on a draft", () => {
 		const s = set({ problems: [readyProblem("pp_1", ["n3"])] });
 		const gated = renderToStaticMarkup(<PracticeExamBody set={s} {...examBase} />);