oh-my-opencode 5.1.48 → 5.1.54

package/packages/shared-skills/skills/ulw-research/scripts/contracts.test.ts

@@ -1,5 +1,4 @@
 import { describe, expect, test } from "bun:test"
-
 import {
 	ANSWERED_BY,
 	DEFECT_CODES,
@@ -22,120 +21,14 @@ import {
 	validateOutcomeManifest,
 	validateRepairState,
 } from "./contracts.mjs"
+import { SEVERITIES, STATIC_CODES_EXPECTED, LAYOUT_CODES_EXPECTED, FIDELITY_BLOCKERS, FIDELITY_MAJORS, FIDELITY_MINORS, FIDELITY_CODES_EXPECTED, fourGateManifest, sampleManifest } from "./tests/contracts-support"
 
-const SEVERITIES = new Set(["blocker", "major", "minor"])
-const STATIC_CODES_EXPECTED = [
-	"korean_no_keep_all",
-	"palette_off_token",
-	"emoji_in_prose",
-	"em_dash_in_prose",
-	"en_dash_in_prose",
-	"heading_too_long",
-	"heading_generic",
-	"unsourced_number",
-	"chart_without_figure",
-	"chart_svg_no_text",
-	"chart_svg_missing_labels",
-	"report_without_visual",
-	"image_missing_alt",
-	"korean_serif_font",
-	"section_without_citation",
-	"missing_closing_section",
-	"missing_citation_section",
-	"broken_asset_reference",
-	"missing_required_section",
-]
-const LAYOUT_CODES_EXPECTED = [
-	"layout_overflow",
-	"layout_text_clipped",
-	"layout_scroll_container",
-	"layout_image_distorted",
-	"layout_sibling_overlap",
-]
-// Fidelity vocabulary contract (#11009): severity and integrity per code are fixed here.
-const FIDELITY_BLOCKERS = [
-	"unresolved_placeholder",
-	"value_mismatch",
-	"unit_mismatch",
-	"quote_not_verbatim",
-	"claim_status_invalid",
-	"incompatible_operands",
-	"pointer_label_mismatch",
-	"quote_anchor_unresolved",
-	"unit_duplicated",
-	"polish_diff_fail",
-	"fidelity_interview_incomplete",
-	"derived_not_allowed",
-	"source_outside_floor",
-	"brief_changed",
-	"snapshot_hash_mismatch",
-	"chart_value_untraceable",
-	"quote_unbound",
-	"edition_unverified",
-]
-const FIDELITY_MAJORS = [
-	"untraceable_number",
-	"unsupported_verification",
-	"claim_kind_mismatch",
-	"conflicting_readings",
-	"hedge_dropped",
-	"direction_flipped",
-	"causality_added",
-	"qualifier_dropped",
-	"unbound_sentence",
-	"meaning_drift_confirmed",
-	"meaning_unverified",
-	"polish_edit_rejected",
-	"polish_hedging_decreased",
-	"polish_text_churn",
-	"snapshot_mismatch",
-	"join_integrity_fail",
-	"quote_stale_version",
-]
-const FIDELITY_MINORS = [
-	"quote_fuzzy_match",
-	"name_outside_quote",
-	"verification_claim_unmarked",
-	"scope_widened_warn",
-	"particle_unverified",
-	"fallback_without_entity",
-	"meaning_drift_warn",
-	"polish_edit_unlocated",
-	"polish_link_changed",
-	"polish_name_changed",
-]
-const FIDELITY_CODES_EXPECTED = [...FIDELITY_BLOCKERS, ...FIDELITY_MAJORS, ...FIDELITY_MINORS]
-
-function fourGateManifest() {
-	const manifest = sampleManifest()
-	const { fidelity: _dropped, ...gates } = manifest.gates
-	return { ...manifest, gates }
-}
 
-function sampleManifest() {
-	return {
-		schemaVersion: SCHEMA_VERSION,
-		sessionDir: "/tmp/session/20260101-120000",
-		startedAt: "2026-01-01T12:00:00.000Z",
-		finishedAt: null,
-		elapsedMinutes: null,
-		lane: "no-format",
-		interview: null,
-		deliverables: [
-			{ format: "pdf", status: "pending", promised: true, updatedAt: "2026-01-01T12:00:00.000Z" },
-		],
-		renders: [],
-		gates: { static: "not_run", fidelity: "not_run", layout: "not_run", visual: "not_run", proofread: "not_run" },
-		residualDefects: [],
-		repair: null,
-		sources: null,
-	}
-}
 
 describe("DEFECT_CODES", () => {
 	test("#given the code table #when every code is inspected #then it has a severity, a hint, and an integrity flag", () => {
 		expect(Object.keys(DEFECT_CODES).sort()).toEqual(
-			[...STATIC_CODES_EXPECTED, "missing_promised_deliverable", ...LAYOUT_CODES_EXPECTED, ...FIDELITY_CODES_EXPECTED].sort(),
+			[...STATIC_CODES_EXPECTED, "missing_promised_deliverable", ...LAYOUT_CODES_EXPECTED, ...FIDELITY_CODES_EXPECTED, "conversion_altered_number", "unit_unbound"].sort(),
 		)
 		for (const [code, entry] of Object.entries(DEFECT_CODES)) {
 			expect(SEVERITIES.has(entry.severity), `${code} severity`).toBe(true)
@@ -154,6 +47,7 @@ describe("DEFECT_CODES", () => {
 				"missing_promised_deliverable",
 				"missing_required_section",
 				...FIDELITY_BLOCKERS,
+				"conversion_altered_number",
 			].sort(),
 		)
 		for (const code of INTEGRITY_CODES) expect(DEFECT_CODES[code].severity).toBe("blocker")
@@ -174,8 +68,10 @@ describe("DEFECT_CODES", () => {
 
 	test("#given the fidelity codes #when inspected #then each carries its fixed severity and integrity flag", () => {
 		for (const code of FIDELITY_BLOCKERS) expect([code, DEFECT_CODES[code]?.severity, DEFECT_CODES[code]?.integrity]).toEqual([code, "blocker", true])
+		expect([DEFECT_CODES.conversion_altered_number?.severity, DEFECT_CODES.conversion_altered_number?.integrity]).toEqual(["blocker", true])
 		for (const code of FIDELITY_MAJORS) expect([code, DEFECT_CODES[code]?.severity, DEFECT_CODES[code]?.integrity]).toEqual([code, "major", false])
 		for (const code of FIDELITY_MINORS) expect([code, DEFECT_CODES[code]?.severity, DEFECT_CODES[code]?.integrity]).toEqual([code, "minor", false])
+		expect([DEFECT_CODES.unit_unbound?.severity, DEFECT_CODES.unit_unbound?.integrity]).toEqual(["minor", false])
 		expect(DEFECT_CODES).not.toHaveProperty("incompatible_populations")
 	})
 })
@@ -185,7 +81,7 @@ describe("code groups", () => {
 		expect([...STATIC_CODES].sort()).toEqual(STATIC_CODES_EXPECTED.slice().sort())
 		expect([...LAYOUT_CODES].sort()).toEqual(LAYOUT_CODES_EXPECTED.slice().sort())
 		expect([...MANIFEST_CODES]).toEqual(["missing_promised_deliverable"])
-		expect([...FIDELITY_CODES].sort()).toEqual(FIDELITY_CODES_EXPECTED.slice().sort())
+		expect([...FIDELITY_CODES].sort()).toEqual([...FIDELITY_CODES_EXPECTED, "conversion_altered_number", "unit_unbound"].sort())
 		const union = [...STATIC_CODES, ...LAYOUT_CODES, ...MANIFEST_CODES, ...FIDELITY_CODES].sort()
 		expect(union).toEqual(Object.keys(DEFECT_CODES).sort())
 		expect(new Set(union).size).toBe(union.length)

package/packages/shared-skills/skills/ulw-research/scripts/conversion-altered.test.ts

@@ -0,0 +1,154 @@
+import { describe, expect, onTestFinished, test } from "bun:test"
+import { copyFileSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+
+import { CliError } from "./cli-support.mjs"
+import { DEFECT_CODES } from "./contracts.mjs"
+import { run } from "./report-tools.mjs"
+import { writeSnapshot } from "./source-snapshot.mjs"
+
+type Json = Record<string, unknown> & { data?: Record<string, unknown>; error?: string }
+const PAGE = "<p>USD 4.2<sup>2</sup> billion in revenue.</p><p>Staff grew to 1,250 people.</p>"
+
+function session() {
+	const dir = mkdtempSync(join(tmpdir(), "conversion-altered-"))
+	onTestFinished(() => rmSync(dir, { recursive: true, force: true }))
+	return dir
+}
+
+async function snapshot(dir: string, html = PAGE) {
+	const file = join(dir, "page.html")
+	writeFileSync(file, html)
+	return (await run(["source", "snapshot", "--id", "S1", "--html", file, "--session-dir", dir])) as { exitCode: number; json: Json; summary: string }
+}
+
+describe("the conversion probe result is consumed", () => {
+	test("#given a page whose conversion altered a number #when snapshotted #then the JSON and the summary report it", async () => {
+		const result = await snapshot(session())
+		expect(result.exitCode).toBe(0)
+		expect(result.json.data?.conversion_altered_numbers).toEqual(["4.22"])
+		expect(result.summary).toContain("1 altered")
+	})
+
+	test("#given an altered 4.22 in conversion.json #when fact add --find locates it #then it refuses with conversion_altered_number and writes no row", async () => {
+		const dir = session()
+		await snapshot(dir)
+		const result = (await run(["fact", "add", "--source", "S1", "--find", "USD", "--label", "usd_bn", "--session-dir", dir, "--json"])) as { exitCode: number; json: Json }
+		expect(result.exitCode).toBe(1)
+		expect(result.json.error).toBe("conversion_altered_number")
+		expect(existsSync(join(dir, "fact-ledger.json"))).toBe(false)
+		expect(DEFECT_CODES.conversion_altered_number).toMatchObject({ severity: "blocker", integrity: true })
+	})
+
+	test("#given an unaltered number in the same snapshot #when fact add --find locates it #then it registers", async () => {
+		const dir = session()
+		await snapshot(dir)
+		const result = (await run(["fact", "add", "--source", "S1", "--find", "Staff grew to", "--label", "staff", "--session-dir", dir, "--json"])) as { exitCode: number; json: Json }
+		expect(result.exitCode).toBe(0)
+		expect((result.json.data?.row as { value: string }).value).toBe("1250")
+	})
+
+	test("#given a non-ISO observed_at #when writeSnapshot runs #then it throws before writing anything", () => {
+		const dir = join(session(), "sources")
+		expect(() => writeSnapshot(dir, "S1", { path: "p.html", html: PAGE, extractor: "model", observed_at: "yesterday" })).toThrow(TypeError)
+		expect(existsSync(join(dir, "S1"))).toBe(false)
+	})
+
+	test("#given an image named chart-109.png beside a glued 10<sup>9</sup> #when fact add --find locates it #then it refuses and registers nothing", async () => {
+		const dir = session()
+		const snap = await snapshot(dir, '<p>Output reached 10<sup>9</sup> kWh</p><p><img src="chart-109.png"></p>')
+		expect(snap.json.data?.conversion_altered_numbers).toEqual(["109"])
+		const result = (await run(["fact", "add", "--source", "S1", "--find", "Output reached", "--label", "output", "--session-dir", dir, "--json"])) as { exitCode: number; json: Json }
+		expect(result.exitCode).toBe(1)
+		expect(result.json.error).toBe("conversion_altered_number")
+		expect(existsSync(join(dir, "fact-ledger.json"))).toBe(false)
+	})
+})
+
+test("#given a genuine 4.22 beside a glued 4.2<sup>2</sup> #when fact add --find locates the genuine one #then the refusal names the --replace recovery", async () => {
+	const dir = session()
+	await snapshot(dir, "<p>USD 4.2<sup>2</sup> billion in revenue.</p><p>Margin was 4.22 points.</p>")
+	const result = (await run(["fact", "add", "--source", "S1", "--find", "Margin was", "--label", "margin", "--session-dir", dir, "--json"])) as { exitCode: number; json: Json & { message?: string } }
+	expect(result.exitCode).toBe(1)
+	expect(result.json.error).toBe("conversion_altered_number")
+	expect(result.json.message).toContain("source snapshot --id S1 --text <verified.txt> --replace")
+})
+
+describe("the documented recovery: source snapshot --replace with a verified text", () => {
+	const s = (dir: string) => ["--session-dir", dir]
+
+	test("#given a refused 4.22 #when the verified text replaces S1 #then fact add registers 4.2 billion and the filled report verifies clean", async () => {
+		const dir = session()
+		await snapshot(dir)
+		const verified = join(dir, "verified.txt")
+		writeFileSync(verified, "USD 4.2 billion in revenue.\nStaff grew to 1,250 people.\n")
+		const replaced = (await run(["source", "snapshot", "--id", "S1", "--text", verified, "--replace", ...s(dir)])) as { exitCode: number; json: Json }
+		expect(replaced.exitCode).toBe(0)
+		expect(existsSync(join(dir, "sources", "S1", "conversion.json"))).toBe(false)
+		const added = (await run(["fact", "add", "--source", "S1", "--find", "USD", "--label", "usd_bn", ...s(dir), "--json"])) as { exitCode: number; json: Json }
+		expect(added.exitCode).toBe(0)
+		expect((added.json.data?.row as { value: string }).value).toBe("4200000000")
+		copyFileSync(join(import.meta.dir, "tests", "fixtures", "fidelity-brief-locked.md"), join(dir, "brief.md"))
+		writeFileSync(join(dir, "report.src.html"), [
+			'<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Revenue</title></head><body><h1>Revenue</h1>',
+			"<h2>Findings</h2><p>Revenue was {{F1:usd_bn}} [S1].</p>",
+			"<h2>How this report was made</h2><p>Collected from one cited public page [S1].</p>",
+			'<h2>Sources</h2><ol><li id="s1">[S1] Revenue page, retrieved 2026-10-01.</li></ol></body></html>',
+		].join("\n"))
+		const filled = (await run(["fact", "fill", join(dir, "report.src.html"), "--out", join(dir, "report.html"), ...s(dir)])) as { exitCode: number }
+		expect(filled.exitCode).toBe(0)
+		const verifiedReport = (await run(["fact", "verify", join(dir, "report.html"), "--sources", join(dir, "sources"), "--brief", join(dir, "brief.md"), ...s(dir)])) as { exitCode: number; json: { defects?: unknown[] } }
+		expect(verifiedReport.json.defects).toEqual([])
+		expect(verifiedReport.exitCode).toBe(0)
+	})
+
+	test("#given an active row pinning S1 #when --replace runs #then it refuses with snapshot_pinned and keeps the old text", async () => {
+		const dir = session()
+		await snapshot(dir)
+		await run(["fact", "add", "--source", "S1", "--find", "Staff grew to", "--label", "staff", ...s(dir), "--json"])
+		const verified = join(dir, "verified.txt")
+		writeFileSync(verified, "USD 4.2 billion in revenue.\n")
+		const replaced = (await run(["source", "snapshot", "--id", "S1", "--text", verified, "--replace", ...s(dir)])) as { exitCode: number; json: Json }
+		expect(replaced.exitCode).toBe(1)
+		expect(replaced.json.error).toBe("snapshot_pinned")
+		expect(existsSync(join(dir, "sources", "S1", "conversion.json"))).toBe(true)
+	})
+})
+
+test("#given --html whose conversion altered 4.22 #when fact add is refused, the verified text replaces S1, and the row is added, filled and verified #then the replacement is declared text over the kept raw.bin and every step passes", async () => {
+	const dir = session()
+	const s = ["--session-dir", dir]
+	await snapshot(dir)
+	const refused = (await run(["fact", "add", "--source", "S1", "--find", "USD", "--label", "usd_bn", ...s, "--json"])) as { exitCode: number; json: Json }
+	expect([refused.exitCode, refused.json.error]).toEqual([1, "conversion_altered_number"])
+	const verified = join(dir, "verified.txt")
+	writeFileSync(verified, "USD 4.2 billion in revenue.\nStaff grew to 1,250 people.\n")
+	const replaced = (await run(["source", "snapshot", "--id", "S1", "--text", verified, "--replace", ...s])) as { exitCode: number; json: Json }
+	expect([replaced.exitCode, replaced.json.data?.text_source, replaced.json.data?.kind]).toEqual([0, "declared", "page"])
+	expect(existsSync(join(dir, "sources", "S1", "raw.bin"))).toBe(true)
+	const added = (await run(["fact", "add", "--source", "S1", "--find", "USD", "--label", "usd_bn", ...s, "--json"])) as { exitCode: number; json: Json & { message?: string } }
+	expect([added.exitCode, added.json.error, added.json.message]).toEqual([0, undefined, undefined])
+	const row = added.json.data?.row as { value: string; locator: { artifact: string; unit: string } }
+	expect([row.value, row.locator.artifact, row.locator.unit]).toEqual(["4200000000", "text.txt", "bytes"])
+	copyFileSync(join(import.meta.dir, "tests", "fixtures", "fidelity-brief-locked.md"), join(dir, "brief.md"))
+	writeFileSync(join(dir, "report.src.html"), [
+		'<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Revenue</title></head><body><h1>Revenue</h1>',
+		"<h2>Findings</h2><p>Revenue was {{F1:usd_bn}} [S1].</p>",
+		"<h2>How this report was made</h2><p>Collected from one cited public page [S1].</p>",
+		'<h2>Sources</h2><ol><li id="s1">[S1] Revenue page, retrieved 2026-10-01.</li></ol></body></html>',
+	].join("\n"))
+	expect(((await run(["fact", "fill", join(dir, "report.src.html"), "--out", join(dir, "report.html"), ...s])) as { exitCode: number }).exitCode).toBe(0)
+	const report = (await run(["fact", "verify", join(dir, "report.html"), "--sources", join(dir, "sources"), "--brief", join(dir, "brief.md"), ...s])) as { exitCode: number; json: { defects?: unknown[] } }
+	expect([report.exitCode, report.json.defects]).toEqual([0, []])
+	expect((JSON.parse(readFileSync(join(dir, "fidelity-defects.json"), "utf8")) as { defects: { code: string }[] }).defects.map((d) => d.code)).not.toContain("snapshot_not_raw")
+})
+
+test("#given a malformed conversion.json #when fact add reads it #then it is a usage error naming the file, not a crash", async () => {
+	const dir = session()
+	await snapshot(dir)
+	writeFileSync(join(dir, "sources", "S1", "conversion.json"), "{not json")
+	const added = run(["fact", "add", "--source", "S1", "--find", "Staff grew to", "--label", "staff", "--session-dir", dir, "--json"])
+	await expect(added).rejects.toBeInstanceOf(CliError)
+	await expect(added).rejects.toThrow(/conversion\.json/)
+})

package/packages/shared-skills/skills/ulw-research/scripts/conversion-originals.test.ts

@@ -0,0 +1,297 @@
+import { describe, expect, test } from "bun:test"
+import { readFileSync } from "node:fs"
+import { join } from "node:path"
+
+import { markdownAsHtml } from "./fact-commands-verify.mjs"
+import { derive } from "./fact-derive.mjs"
+import { fill } from "./fact-fill.mjs"
+import { addRow, emptyLedger } from "./fact-ledger.mjs"
+import { checkFidelity } from "./gates-fidelity.mjs"
+import { valueChecks } from "./fidelity-values.mjs"
+import { buildContext } from "./gates-static.mjs"
+import { parseHtml } from "./html-lite.mjs"
+
+/** fact derive stamps observed_at from a caller-supplied clock (#11285); these rows only need a fixed one. */
+const NOW = "2026-10-27T00:00:00.000Z"
+
+type Row = Record<string, unknown> & { fact_id: string }
+type Ledger = { rows: Row[] }
+const FIX = join(import.meta.dir, "tests", "fixtures", "fidelity")
+const BASE: Ledger = JSON.parse(readFileSync(join(FIX, "ledger-verify.json"), "utf8"))
+const BRIEF = readFileSync(join(FIX, "..", "fidelity-brief-locked.md"), "utf8")
+/** F8 in the shape fact derive writes it: raw is the render (fact-derive.mjs compute: raw = render). */
+const DERIVED: Ledger = { ...BASE, rows: BASE.rows.map((r) => (r.fact_id === "F8" ? { ...r, raw: r.render } : r)) }
+const check = (html: string, ledger: Ledger = DERIVED, sources: string | null = join(FIX, "sources")) =>
+	valueChecks(buildContext(parseHtml(`<h2>Findings</h2>${html}`), { baseDir: FIX }), ledger, null, sources)
+const data = (id: string, shown: string) => `<p><data data-fact="${id}">${shown}</data></p>`
+const rowOf = (ledger: Ledger, id: string) => ledger.rows.find((r) => r.fact_id === id) as Row
+
+function measured(id: string, value: string, unit: string, extra: Record<string, unknown> = {}) {
+	return { fact_id: id, kind: "measured", value, unit, raw: `${value} ${unit}`, quote: `The figure is ${value} ${unit}.`, source_id: "S1", locator: { artifact: "sources/S1/text.txt", char_start: 0, char_end: 5 }, snapshot_sha256: "a".repeat(64), extracted_by: "fact add --find", observed_at: "2026-10-23T08:00:00Z", label: id.toLowerCase(), ...extra }
+}
+
+/** A derive-produced row filled by fact fill, so the report is exactly what the tools wrote. */
+function derivedReport(rows: Row[], spec: Record<string, unknown>) {
+	const ledger = emptyLedger() as Ledger
+	for (const row of rows) addRow(ledger, row)
+	const result = derive(ledger, { now: NOW, ...spec }) as { row?: Row; error?: string }
+	if (!result.row) throw new Error(`derive refused: ${result.error}`)
+	const filled = fill(`<h2>Findings</h2><p>The total is {{${result.row.fact_id}:${result.row.label}}}.</p>`, ledger)
+	if (filled.out === null) throw new Error("fill failed")
+	return { ledger, row: result.row, html: filled.out }
+}
+
+describe("the converted half of a derived or converted row is display(value, unit)", () => {
+	const dated = { valid_at: "2026-10-01" }
+	const cases: [string, Row[], Record<string, unknown>][] = [
+		["a grouped KRW-e8 sum", [measured("F1", "1617", "KRW-e8"), measured("F2", "1617", "KRW-e8")], { op: "sum", operands: ["F1", "F2"], unit: "KRW-e8" }],
+		["a grouped KRW-e3 sum", [measured("F1", "1617", "KRW-e3"), measured("F2", "1617", "KRW-e3")], { op: "sum", operands: ["F1", "F2"], unit: "KRW-e3" }],
+		["a grouped KRW-e4 sum", [measured("F1", "1617", "KRW-e4"), measured("F2", "1617", "KRW-e4")], { op: "sum", operands: ["F1", "F2"], unit: "KRW-e4" }],
+		["a grouped KRW-e12 sum", [measured("F1", "1617", "KRW-e12"), measured("F2", "1617", "KRW-e12")], { op: "sum", operands: ["F1", "F2"], unit: "KRW-e12" }],
+		["a km/h sum", [measured("F1", "30000", "km/h"), measured("F2", "30000", "km/h")], { op: "sum", operands: ["F1", "F2"], unit: "km/h" }],
+		["a KRW/person sum", [measured("F1", "30000", "KRW/person"), measured("F2", "30000", "KRW/person")], { op: "sum", operands: ["F1", "F2"], unit: "KRW/person" }],
+		["an FX expr in KRW-e8", [measured("F1", "12", "USD", dated), measured("F2", "1420", "KRW-e8/USD", dated)], { op: "expr", formula: "F1 * F2", unit: "KRW-e8" }],
+	]
+	for (const [name, rows, spec] of cases) {
+		test(`#given ${name} exactly as fill wrote it #when verified #then no defect`, () => {
+			const { ledger, html } = derivedReport(rows, spec)
+			expect(valueChecks(buildContext(parseHtml(html), {}), ledger, null, null)).toEqual([])
+		})
+	}
+
+	test("#given a grouped KRW-e8 sum whose converted half was edited #when verified #then it still blocks", () => {
+		const { ledger, row, html } = derivedReport(cases[0][1], cases[0][2])
+		const edited = html.replace(`>${String(row.raw)}<`, ">3,243 KRW-e8<")
+		expect(edited).not.toBe(html)
+		expect(valueChecks(buildContext(parseHtml(edited), {}), ledger, null, null).map((d: { code: string }) => d.code)).toContain("value_mismatch")
+	})
+})
+
+describe("conversion originals bind both halves", () => {
+	for (const [shown, code] of [["320,000 mm (320 mm)", "unit_mismatch"], ["320,000 mm (999 m)", "value_mismatch"], ["320,000 mm (three m)", "value_mismatch"], ["320,000 mm (\uFF19\uFF19\uFF19 m)", "value_mismatch"], ["320,000 mm (m)", "value_mismatch"]]) {
+		test(`#given an edited original ${shown} #when verified #then ${code} on part original`, () => {
+			expect(check(data("F8", shown))).toContainEqual(expect.objectContaining({ code, part: "original" }))
+			expect(checkFidelity(data("F8", shown), { ledger: DERIVED, brief: BRIEF }).defects).toContainEqual(expect.objectContaining({ code, part: "original" }))
+		})
+	}
+
+	test("#given a ledger render edited to match a tampered report #when verified #then the original stays bound to its operand", () => {
+		const ledger = structuredClone(DERIVED)
+		rowOf(ledger, "F8").render = "320,000 mm (999 m)"
+		expect(check(data("F8", "320,000 mm (999 m)"), ledger)).toContainEqual(expect.objectContaining({ code: "value_mismatch", part: "original" }))
+	})
+
+	test("#given an edited converted half or a number beside the original #when verified #then value_mismatch", () => {
+		expect(check(data("F8", "320,000 mm (320 m)"))).toEqual([])
+		expect(check(data("F8", "319,000 mm (320 m)"))).toContainEqual(expect.objectContaining({ code: "value_mismatch" }))
+		expect(check(data("F8", "320,000 mm (320 m) 999"))).toContainEqual(expect.objectContaining({ code: "value_mismatch", part: "original" }))
+	})
+
+	test("#given the fixture F8 whose raw is not its render #when filled and verified #then the shape fact derive never writes is rejected", () => {
+		expect(rowOf(BASE, "F8").raw).not.toBe(rowOf(BASE, "F8").render)
+		const filled = fill("<h2>Findings</h2><p>The span is {{F8:span_mm}}.</p>", structuredClone(BASE))
+		expect(valueChecks(buildContext(parseHtml(String(filled.out)), {}), BASE, null, null)).toContainEqual(expect.objectContaining({ code: "value_mismatch" }))
+	})
+
+	test("#given grouped and percent originals #when verified #then the operation display contract holds", () => {
+		const ledger = structuredClone(DERIVED)
+		rowOf(ledger, "F1").value = "1237"
+		const converted = rowOf(ledger, "F8")
+		converted.value = "1237000"
+		expect(check(data("F8", "1,237,000 mm (1,237 m)"), ledger)).toEqual([])
+		Object.assign(converted, { kind: "derived", value: "0.12", unit: null, derived_from: ["F3"] })
+		expect(check(data("F8", "0.12 (12%)"), ledger)).toEqual([])
+	})
+
+	test("#given a converted row filled in value and unit mode #when verified #then no original is due", () => {
+		for (const pointer of [(id: string) => `{{${id}:span_mm:value}} mm`, (id: string) => `{{${id}:span_mm:value}}{{${id}:span_mm:unit}}`]) {
+			const ledger = emptyLedger() as Ledger
+			addRow(ledger, measured("F1", "320", "m"))
+			const { row } = derive(ledger, { now: NOW, op: "convert", operands: ["F1"], to: "mm", label: "span_mm" }) as { row: Row }
+			const filled = fill(`<h2>Findings</h2><p>The span is ${pointer(row.fact_id)}.</p>`, ledger)
+			expect(valueChecks(buildContext(parseHtml(String(filled.out)), {}), ledger, null, null)).toEqual([])
+		}
+	})
+})
+
+/**
+ * The conversion-original class: one row per written form (EN and KO), each applied at the fill
+ * site of a real fact derive convert row ("320,000 mm (320 m)") filled by fact fill, in four
+ * renders: HTML paragraph, HTML table cell, Markdown paragraph, Markdown table cell (fill map and
+ * projection, as fact verify reads it). Every bracket group is an original; a dash is not one.
+ */
+describe("conversion originals: the bracket grammar class", () => {
+	const PASS = "pass"
+	const ORIGINAL = "value_mismatch/original"
+	const KO = { prefix: "\uD658\uC0B0 ", tbd: "\uBBF8\uC815", na: "\uD574\uB2F9 \uC5C6\uC74C", about: "\uC57D", words: "\uC0BC\uBC31\uC774\uC2ED" }
+	/** `after`: the input is typed right after the untouched fill site instead of replacing it. */
+	const ROWS: { form: string; input: string; expected: string; after?: true }[] = [
+		{ form: "ASCII parentheses", input: "320,000 mm (320 m)", expected: PASS },
+		{ form: "fullwidth parentheses", input: "320,000 mm\uFF08320 m\uFF09", expected: PASS },
+		{ form: "fullwidth parentheses after a space", input: "320,000 mm \uFF08320 m\uFF09", expected: PASS },
+		{ form: "square brackets", input: "320,000 mm [320 m]", expected: PASS },
+		{ form: "fullwidth square brackets", input: "320,000 mm\uFF3B320 m\uFF3D", expected: PASS },
+		{ form: "lenticular brackets", input: "320,000 mm\u3010320 m\u3011", expected: PASS },
+		{ form: "corner brackets", input: "320,000 mm\u300C320 m\u300D", expected: PASS },
+		{ form: "tortoise-shell brackets", input: "320,000 mm\u3014320 m\u3015", expected: PASS },
+		{ form: "NFKC fullwidth digits and letters throughout", input: "\uFF13\uFF12\uFF10\uFF0C\uFF10\uFF10\uFF10 \uFF4D\uFF4D\uFF08\uFF13\uFF12\uFF10 \uFF4D\uFF09", expected: PASS },
+		{ form: "NFKC fullwidth digits inside the original", input: "320,000 mm (\uFF13\uFF12\uFF10 m)", expected: PASS },
+		{ form: "spaces inside the brackets", input: "320,000 mm ( 320 m )", expected: PASS },
+		{ form: "no space before the bracket", input: "320,000 mm(320 m)", expected: PASS },
+		{ form: "EN digit-free prefix", input: "Converted: 320,000 mm (320 m)", expected: PASS },
+		{ form: "KO digit-free prefix, fullwidth", input: `${KO.prefix}320,000 mm\uFF08320 m\uFF09`, expected: PASS },
+		{ form: "ASCII parentheses, wrong original", input: "320,000 mm (999 m)", expected: ORIGINAL },
+		{ form: "fullwidth parentheses, wrong original", input: "320,000 mm\uFF08999 m\uFF09", expected: ORIGINAL },
+		{ form: "square brackets, wrong original", input: "320,000 mm [999 m]", expected: ORIGINAL },
+		{ form: "fullwidth square brackets, wrong original", input: "320,000 mm\uFF3B999 m\uFF3D", expected: ORIGINAL },
+		{ form: "lenticular brackets, wrong original", input: "320,000 mm\u3010999 m\u3011", expected: ORIGINAL },
+		{ form: "corner brackets, wrong original", input: "320,000 mm\u300C999 m\u300D", expected: ORIGINAL },
+		{ form: "tortoise-shell brackets, wrong original", input: "320,000 mm\u3014999 m\u3015", expected: ORIGINAL },
+		{ form: "NFKC fullwidth digits, wrong original", input: "320,000 mm (\uFF19\uFF19\uFF19 m)", expected: ORIGINAL },
+		{ form: "spaces inside, wrong original", input: "320,000 mm ( 999 m )", expected: ORIGINAL },
+		{ form: "hyphen separator, right number", input: "320,000 mm - 320 m", expected: ORIGINAL },
+		{ form: "en-dash separator, right number", input: "320,000 mm \u2013 320 m", expected: ORIGINAL },
+		{ form: "em-dash separator, right number", input: "320,000 mm \u2014 320 m", expected: ORIGINAL },
+		{ form: "hyphen separator, wrong number", input: "320,000 mm - 999 m", expected: ORIGINAL },
+		{ form: "en-dash separator, wrong number", input: "320,000 mm \u2013 999 m", expected: ORIGINAL },
+		{ form: "separator after the original", input: "320,000 mm (320 m) - 999 m", expected: ORIGINAL },
+		{ form: "nested parentheses", input: "320,000 mm ((320 m))", expected: ORIGINAL },
+		{ form: "square inside parentheses", input: "320,000 mm ([320 m])", expected: ORIGINAL },
+		{ form: "ASCII inside fullwidth parentheses", input: "320,000 mm\uFF08(320 m)\uFF09", expected: ORIGINAL },
+		{ form: "mismatched bracket pair", input: "320,000 mm (320 m]", expected: ORIGINAL },
+		{ form: "unclosed bracket", input: "320,000 mm (320 m", expected: ORIGINAL },
+		{ form: "EN number word", input: "320,000 mm (twenty m)", expected: ORIGINAL },
+		{ form: "EN n/a", input: "320,000 mm (n/a)", expected: ORIGINAL },
+		{ form: "EN TBD", input: "320,000 mm (TBD)", expected: ORIGINAL },
+		{ form: "EN approx. alone", input: "320,000 mm (approx.)", expected: ORIGINAL },
+		{ form: "EN approx. beside the original", input: "320,000 mm (approx.) (320 m)", expected: ORIGINAL },
+		{ form: "bare unit", input: "320,000 mm (m)", expected: ORIGINAL },
+		{ form: "KO TBD", input: `320,000 mm (${KO.tbd})`, expected: ORIGINAL },
+		{ form: "KO n/a, fullwidth", input: `320,000 mm\uFF08${KO.na}\uFF09`, expected: ORIGINAL },
+		{ form: "KO hedge inside the original", input: `320,000 mm (${KO.about} 320 m)`, expected: ORIGINAL },
+		{ form: "KO number word", input: `320,000 mm (${KO.words} m)`, expected: ORIGINAL },
+		{ form: "missing original", input: "320,000 mm", expected: ORIGINAL },
+		{ form: "EN prefix, missing original", input: "Converted: 320,000 mm", expected: ORIGINAL },
+		{ form: "KO prefix, missing original", input: `${KO.prefix}320,000 mm`, expected: ORIGINAL },
+		{ form: "original before the value", input: "(320 m) 320,000 mm", expected: ORIGINAL },
+		{ form: "fullwidth original before the value", input: "\uFF08320 m\uFF09320,000 mm", expected: ORIGINAL },
+		{ form: "two originals, both right", input: "320,000 mm (320 m) (320 m)", expected: ORIGINAL },
+		{ form: "two originals, second wrong", input: "320,000 mm (320 m)\uFF08999 m\uFF09", expected: ORIGINAL },
+		{ form: "two originals, mixed brackets", input: "320,000 mm (320 m) [320 m]", expected: ORIGINAL },
+		{ form: "second original typed after the fill site", input: " (999 m)", expected: ORIGINAL, after: true },
+		{ form: "fullwidth original typed after the fill site", input: "\uFF08320 m\uFF09", expected: ORIGINAL, after: true },
+		{ form: "square original typed after the fill site", input: " [999 m]", expected: ORIGINAL, after: true },
+		{ form: "separator original typed after the fill site", input: " - 999 m", expected: ORIGINAL, after: true },
+		{ form: "prose bracket typed after the fill site", input: " (approx.)", expected: PASS, after: true },
+	]
+	const SENTENCE = { en: ["The span is ", "."], ko: ["\uAD50\uB7C9 \uAE38\uC774\uB294 ", "\uC774\uB2E4."] }
+	type Render = { format: "html" | "md"; doc: (pointer: string, around: string[]) => string }
+	const RENDERS: Record<string, Render> = {
+		"html paragraph": { format: "html", doc: (p, [a, b]) => `<h2>Findings</h2><p>${a}${p}${b}</p>` },
+		"html table cell": { format: "html", doc: (p) => `<h2>Findings</h2><table><tr><th>span</th><td>${p}</td></tr></table>` },
+		"md paragraph": { format: "md", doc: (p, [a, b]) => `## Findings\n\n${a}${p}${b}\n` },
+		"md table cell": { format: "md", doc: (p) => `## Findings\n\n| item | value |\n| --- | --- |\n| span | ${p} |\n` },
+	}
+
+	/** The verdict fact verify gives the form written at the fill site: pass, or the code/part of the first value defect. */
+	function verdict(input: string, render: Render, lang: "en" | "ko", after = false) {
+		const ledger = emptyLedger() as Ledger
+		addRow(ledger, measured("F1", "320", "m"))
+		const row = (derive(ledger, { now: NOW, op: "convert", operands: ["F1"], to: "mm", label: "span_mm" }) as { row: Row }).row
+		const filled = fill(render.doc(`{{${row.fact_id}:span_mm}}`, SENTENCE[lang]), ledger, { format: render.format }) as { out: string; fillMap: Parameters<typeof markdownAsHtml>[1] }
+		const site = render.format === "html" ? `>${row.render}</data>` : String(row.render)
+		const edited = filled.out.replace(site, after ? `${site}${input}` : render.format === "html" ? `>${input}</data>` : input)
+		if (!filled.out.includes(site) || (input !== row.render && edited === filled.out)) return "fill site not found"
+		const projected = render.format === "md" ? markdownAsHtml(edited, filled.fillMap, ledger) : null
+		const defects = valueChecks(buildContext(parseHtml(projected?.html ?? edited), {}), ledger, projected?.stale ?? null, null) as { code: string; part?: string }[]
+		const value = defects.find((d) => d.code === "value_mismatch" || d.code === "unit_mismatch")
+		if (value) return `${value.code}/${value.part ?? "-"}`
+		return defects.length === 0 ? PASS : defects.map((d) => d.code).join(",")
+	}
+
+	test(`#given ${ROWS.length} written forms x ${Object.keys(RENDERS).length} renders x EN and KO #when verified #then each verdict is the row's expected`, () => {
+		const got: string[] = []
+		const want: string[] = []
+		for (const { form, input, expected, after } of ROWS) {
+			for (const [name, render] of Object.entries(RENDERS)) {
+				for (const lang of ["en", "ko"] as const) {
+					got.push(`${form} | ${name} | ${lang} | ${verdict(input, render, lang, after)}`)
+					want.push(`${form} | ${name} | ${lang} | ${expected}`)
+				}
+			}
+		}
+		expect(got).toEqual(want)
+	})
+})
+
+/**
+ * What can follow a converted element: each shape is written in the report template right after
+ * the fill site of a real fact derive convert row and resolved by fact fill, so every untampered
+ * row is a report exactly as the tools write it. A following group is another original only when
+ * it is a bare numeral with a unit of the operand's dimension that is not a filled element.
+ */
+describe("conversion originals: what can follow a converted element", () => {
+	const [CLEAN, ORIGINAL, UNTRACED] = ["clean", "original", "untraceable_number"]
+	const BRACKETS = [["(", ")"], ["\uFF08", "\uFF09"], ["[", "]"], ["\uFF3B", "\uFF3D"], ["\u3010", "\u3011"], ["\u300C", "\u300D"], ["\u3014", "\u3015"], ["\u300E", "\u300F"], ["\u300A", "\u300B"]]
+	const SEPARATORS = ["-", "\u2013", "\u2014", "/"]
+	const ROWS: { shape: string; after: string; expected: string }[] = [
+		{ shape: "nothing (element at the end of the cell or line)", after: "", expected: CLEAN },
+		...BRACKETS.flatMap(([o, c]) => [
+			{ shape: `${o}${c} second placeholder in prose`, after: ` ${o}{{F3:rate_yoy}} longer${c}`, expected: CLEAN },
+			{ shape: `${o}${c} second placeholder alone`, after: ` ${o}{{F1:span_len}}${c}`, expected: CLEAN },
+			{ shape: `${o}${c} bare numeral, wrong`, after: ` ${o}999 m${c}`, expected: ORIGINAL },
+			{ shape: `${o}${c} bare numeral, right, other unit of the dimension`, after: ` ${o}0.32 km${c}`, expected: ORIGINAL },
+		]),
+		...SEPARATORS.flatMap((s) => [
+			{ shape: `${s} then a filled element`, after: ` ${s} {{F1:span_len}}`, expected: CLEAN },
+			{ shape: `${s} then a bare numeral`, after: ` ${s} 999 m`, expected: ORIGINAL },
+			{ shape: `${s} then prose with a count`, after: ` ${s} 12 sites`, expected: UNTRACED },
+		]),
+		{ shape: "prose with a filled percent", after: " ({{F3:rate_yoy}} longer)", expected: CLEAN },
+		{ shape: "prose with a literal percent", after: " (12 % longer)", expected: UNTRACED },
+		{ shape: "a bare unitless number (footnote)", after: " (7)", expected: UNTRACED },
+		{ shape: "a year", after: " (2024)", expected: UNTRACED },
+		{ shape: "two consecutive elements", after: " {{F1:span_len}}", expected: CLEAN },
+		{ shape: "two consecutive elements, glued", after: "{{F3:rate_yoy}}", expected: CLEAN },
+		{ shape: "prose without digits", after: " (approx.)", expected: CLEAN },
+	]
+	const SENTENCE = { en: ["The span is ", "."], ko: ["\uAD50\uB7C9 \uAE38\uC774\uB294 ", "\uC774\uB2E4."] }
+	type Render = { format: "html" | "md"; doc: (body: string, around: string[]) => string; stale?: true }
+	const RENDERS: Record<string, Render> = {
+		"html paragraph": { format: "html", doc: (b, [x, y]) => `<h2>Findings</h2><p>${x}${b}${y}</p>` },
+		"html table cell": { format: "html", doc: (b) => `<h2>Findings</h2><table><tr><th>span</th><td>${b}</td></tr></table>` },
+		"md paragraph": { format: "md", doc: (b, [x, y]) => `## Findings\n\n${x}${b}${y}\n` },
+		"md table cell": { format: "md", doc: (b) => `## Findings\n\n| item | value |\n| --- | --- |\n| span | ${b} |\n` },
+		"md paragraph, edited before the site (stale fill map)": { format: "md", doc: (b, [x, y]) => `## Findings\n\n${x}${b}${y}\n`, stale: true },
+	}
+
+	/** derive -> fill -> verify as fact verify wires it: "original" when a defect is on part original, else the defect codes or clean. */
+	function verdict(after: string, render: Render, lang: "en" | "ko") {
+		const ledger = emptyLedger() as Ledger
+		// The fixture's own source rows: each pins S4 and quotes its sentence, as fact add writes them.
+		for (const id of ["F1", "F3"]) addRow(ledger, structuredClone(rowOf(BASE, id)))
+		const row = (derive(ledger, { now: NOW, op: "convert", operands: ["F1"], to: "mm", label: "span_mm" }) as { row: Row }).row
+		const filled = fill(render.doc(`{{${row.fact_id}:span_mm}}${after}`, SENTENCE[lang]), ledger, { format: render.format }) as { out: string | null; fillMap: Parameters<typeof markdownAsHtml>[1] }
+		if (filled.out === null) return "fill failed"
+		const report = render.stale ? filled.out.replace("## Findings", "## Findings, revised after the review") : filled.out
+		const projected = render.format === "md" ? markdownAsHtml(report, filled.fillMap, ledger) : null
+		if (render.stale && projected?.stale.length === 0) return "fill map not stale"
+		const defects = valueChecks(buildContext(parseHtml(projected?.html ?? report), {}), ledger, projected?.stale ?? null, join(FIX, "sources")) as { code: string; part?: string }[]
+		if (defects.some((d) => d.part === "original")) return ORIGINAL
+		return defects.length === 0 ? CLEAN : [...new Set(defects.map((d) => d.code))].sort().join(",")
+	}
+
+	test(`#given ${ROWS.length} shapes x ${Object.keys(RENDERS).length} renders x EN and KO after a filled convert row #when verified #then each verdict is the row's expected`, () => {
+		const got: string[] = []
+		const want: string[] = []
+		for (const { shape, after, expected } of ROWS) {
+			for (const [name, render] of Object.entries(RENDERS)) {
+				for (const lang of ["en", "ko"] as const) {
+					got.push(`${shape} | ${name} | ${lang} | ${verdict(after, render, lang)}`)
+					want.push(`${shape} | ${name} | ${lang} | ${expected}`)
+				}
+			}
+		}
+		expect(got).toEqual(want)
+	})
+})