cuelo 0.10.19 → 0.10.21

package/Tools/OMP_Global_Config/patches/apply-core-patch.mjs

@@ -116,7 +116,8 @@ const OPUS55_HEAD_1846 = OPUS55_ROW_1846.anchor.slice(0, OPUS55_ROW_1846.anchor.
  * (공개 이슈 #30: 같은 본문 재저장·context 만 바뀐 갱신도 벡터를 지워 다음 store open 이 다시 예약했다).
  * 벡터의 모델 일치는 store open 의 reconcileEmbeddingModel 이 계속 책임진다. 별도 projection(embed_text ≠ 본문)은 기존처럼 지운다.
  */
-const learnTopicUpsertBlock = `// HANSE: topic-key learn upsert
+/** 이슈 #32 이전에 배포된 learn topic upsert(HEAD b8f1aad, embedding 보존판) 그대로다. */
+const learnTopicUpsertPreEvidenceBlock = `// HANSE: topic-key learn upsert
 function upsertLearnTopic(
 	state: MnemopiSessionState,
 	params: LearnParams,
@@ -160,12 +161,61 @@ function upsertLearnTopic(
 
 export class LearnTool implements AgentTool<LearnSchema> {`;
 
+const learnTopicUpsertBlock = `// HANSE: topic-key learn upsert
+function upsertLearnTopic(
+	state: MnemopiSessionState,
+	params: LearnParams,
+	target: ReturnType<MnemopiSessionState["getScopedRetainTarget"]>,
+	evidence: LearnEvidence,
+): { id: string; revision: number } {
+	const topic = params.topic!.normalize("NFKC").trim().toLowerCase();
+	if (!topic) throw new Error("Learn topic must not be blank.");
+	if (redactMemorySecrets(topic) !== topic) throw new Error("Learn topic contains a credential.");
+	const db = target.memory.conn;
+	const existing = db.query(
+		"SELECT id, timestamp, metadata_json FROM working_memory WHERE json_extract(metadata_json, '$.topic_key') = ? ORDER BY timestamp DESC, id DESC LIMIT 1",
+	).get(topic) as { id: string; timestamp: string; metadata_json: string } | null;
+	// HANSE: learn topic evidence is stored with the topic row
+	// 근거(kind·citations)는 본문·임베딩과 같은 쓰기 단위로 저장한다. 갱신은 아래 transaction 한 번, 새로 만들 때는 한 번의 INSERT 다.
+	const revision = existing ? (Number(JSON.parse(existing.metadata_json).revision) || 1) + 1 : 1;
+	if (existing) return db.transaction(() => {
+		const content = redactMemorySecrets(params.memory);
+		const stored = JSON.parse(existing.metadata_json);
+		delete stored.kind;
+		delete stored.citations;
+		const now = new Date().toISOString();
+		// HANSE: learn topic provenance keeps first and latest source
+		const firstSeen = stored.revision === 1 ? { first_context: stored.context ?? null, first_timestamp: existing.timestamp } : {};
+		const latest = { updated_session_id: state.sessionId, updated_cwd: state.session.sessionManager.getCwd(), updated_at: now };
+		const metadata = JSON.stringify({ ...firstSeen, ...stored, context: params.context == null ? null : redactMemorySecrets(params.context), topic_key: topic, revision, ...latest, ...learnEvidenceMetadata(evidence) });
+		// HANSE: learn topic keeps embedding when its input is unchanged
+		// 비교할 본문은 쓰기 lock 을 잡은(immediate) 같은 transaction 안에서 다시 읽는다. 바깥에서 읽은 값이면
+		// 그 사이 다른 프로세스가 바꾼 본문·벡터를 이 갱신이 그대로 남길 수 있다.
+		const current = db.query("SELECT content, embed_text FROM working_memory WHERE id = ?").get(existing.id) as { content: string; embed_text: string | null } | null;
+		if (current?.content === content && (current.embed_text == null || current.embed_text === content)) {
+			db.query("UPDATE working_memory SET timestamp = ?, metadata_json = ? WHERE id = ?").run(now, metadata, existing.id);
+		} else {
+			db.query("UPDATE working_memory SET content = ?, embed_text = NULL, timestamp = ?, metadata_json = ? WHERE id = ?").run(content, now, metadata, existing.id);
+			db.query("DELETE FROM memory_embeddings WHERE memory_id = ?").run(existing.id);
+		}
+		return { id: existing.id, revision };
+	}).immediate();
+	const id = state.rememberScoped(params.memory, {
+		source: "coding-agent-learn", importance: 0.8,
+		metadata: { session_id: state.sessionId, cwd: state.session.sessionManager.getCwd(), context: params.context ?? null, tool: "learn", topic_key: topic, revision, ...learnEvidenceMetadata(evidence) },
+		scope: "bank", extract: true, extractEntities: true, veracity: "tool", memoryType: "fact",
+	}, target);
+	return { id, revision };
+}
+
+export class LearnTool implements AgentTool<LearnSchema> {`;
+
 /**
  * 회상 줄의 범위(global/project)·정정 표시 보조. 순수 표시이며 DB 와 RecallResult 원본은 바꾸지 않는다.
  * 범위는 collectScopedRecallResults 가 고른 결과의 실제 bank 로 붙인 일시 필드(recallScope)에서만 읽는다.
  * 정정 표시는 revision>1 일 때만, 최초 시점은 first_timestamp 가 있을 때만, 정정 시점은 updated_at 이 있을 때만 쓴다.
  */
-const recallProvenanceBlock = String.raw`// HANSE: recall provenance note
+const recallProvenanceLegacyBlock = String.raw`// HANSE: recall provenance note
 type RecallProvenance = { scope?: string; revision: number; first?: string; corrected?: string };
 function recallProvenance(result: RecallResult): RecallProvenance {
 	const scope = (result as { recallScope?: string }).recallScope;
@@ -205,6 +255,452 @@ function recallRevisionFooter(results: readonly RecallResult[]): string {
 
 `;
 
+/**
+ * 2026-10-17: 근거형 learn 의 citations 를 회상 줄에 `근거 후보:` 로 싣는다. 확인할 위치이지 근거가 아니라는 안내는 줄이 하나라도
+ * 있을 때 한 번만 붙는다. 위 legacy 본문(정정 표시만)을 쓰던 설치는 legacyPatched 로 이 본문으로 바뀐다.
+ */
+const recallProvenanceBlock = String.raw`// HANSE: recall provenance note
+type RecallProvenance = { scope?: string; revision: number; first?: string; corrected?: string; citations: string[] };
+function recallProvenance(result: RecallResult): RecallProvenance {
+	const scope = (result as { recallScope?: string }).recallScope;
+	let meta: Record<string, unknown> | null = null;
+	try {
+		const raw: unknown = result.metadata ?? (result.metadata_json ? JSON.parse(result.metadata_json) : null);
+		if (raw && typeof raw === "object") meta = raw as Record<string, unknown>;
+	} catch {
+		meta = null;
+	}
+	const day = (value: unknown): string | undefined =>
+		typeof value === "string" && /^\d{4}-\d{2}-\d{2}/.test(value) ? value.slice(0, 10) : undefined;
+	const revision = Number(meta?.revision);
+	const cited: unknown[] = Array.isArray(meta?.citations) ? (meta?.citations as unknown[]) : [];
+	const citations = cited.flatMap((entry): string[] => {
+		const item = entry as { path?: unknown; anchor?: unknown } | null;
+		if (!item || typeof item.path !== "string" || item.path === "") return [];
+		const text = item.path + (typeof item.anchor === "string" && item.anchor !== "" ? "#" + item.anchor : "");
+		return [text.length > 120 ? text.slice(0, 119) + "…" : text];
+	});
+	return {
+		scope,
+		revision: Number.isInteger(revision) ? revision : 0,
+		first: day(meta?.first_timestamp),
+		corrected: day(meta?.updated_at),
+		citations,
+	};
+}
+function recallProvenanceNote(result: RecallResult): string {
+	const info = recallProvenance(result);
+	const parts: string[] = [];
+	if (info.scope) parts.push(info.scope);
+	if (info.revision > 1) {
+		parts.push("corrected r" + info.revision);
+		parts.push("first " + (info.first ?? "unknown"));
+		if (info.corrected) parts.push("corrected " + info.corrected);
+	}
+	if (info.citations.length > 0) {
+		const more = info.citations.length > 3 ? " 외 " + (info.citations.length - 3) + "건" : "";
+		parts.push("근거 후보: " + info.citations.slice(0, 3).join(", ") + more);
+	}
+	return parts.length > 0 ? " {" + parts.join("; ") + "}" : "";
+}
+function recallRevisionFooter(results: readonly RecallResult[]): string {
+	const notes: string[] = [];
+	if (results.some(result => recallProvenance(result).revision > 1))
+		notes.push("Corrected rows: read memory://<id> for the full metadata and correction reason.");
+	if (results.some(result => recallProvenance(result).citations.length > 0))
+		notes.push("근거 후보 paths are where a memory says it was recorded, not proof: open one to verify before relying on the memory.");
+	return notes.length > 0 ? "\n\n" + notes.join("\n") : "";
+}
+
+/**
+ * A fact extracted from an evidence lesson carries only source_memory_id, so the recall line for it would show no 근거 후보 even when the
+ * lesson it came from cites a record. Copy just the citations of that origin row onto the fact result before it is rendered.
+ */
+function attachFactCitations(memory: { conn: { query(sql: string): { get(...params: string[]): unknown } } }, results: RecallResult[]): void {
+	for (const result of results) {
+		const origin = (result as { source_memory_id?: unknown }).source_memory_id;
+		if (result.tier !== "fact" || typeof origin !== "string" || result.metadata) continue;
+		try {
+			const row = memory.conn.query("SELECT metadata_json FROM working_memory WHERE id = ?").get(origin) as { metadata_json?: string | null } | null;
+			const cited: unknown = row?.metadata_json ? (JSON.parse(row.metadata_json) as { citations?: unknown }).citations : undefined;
+			if (Array.isArray(cited) && cited.length > 0) result.metadata = { citations: cited };
+		} catch {
+			// A fact whose origin row cannot be read simply shows no citation.
+		}
+	}
+}
+
+`;
+
+/**
+ * 2026-10-17 근거형 learn(이슈 #32 배포본). kind 와 citations 를 받아 저장 전에 검증하고 metadata 에 남긴다. 존재(경로·앵커)만 보며
+ * 글이 교훈을 뒷받침하는지는 판정하지 않는다. 주석·문자열에 백틱과 달러 중괄호를 쓰지 않는다(이 파일의 String.raw 안이다).
+ * 이 본문은 배포된 그대로 두고(아래 learnEvidenceBlock 의 legacyPatched), 오류 문구만 바꾼 새 판을 그 아래에서 만든다.
+ */
+const learnEvidenceIssue32Block = String.raw`// HANSE: learn evidence citations
+type LearnKind = "evidence" | "preference" | "procedure" | "hypothesis";
+type LearnCitation = { path: string; anchor?: string };
+type LearnEvidence = { kind?: LearnKind; citations: LearnCitation[] };
+const LEARN_MAX_CITATIONS = 8;
+const LEARN_MAX_ANCHOR_FILE_BYTES = 8 * 1024 * 1024;
+
+const learnKindSchema = type("'evidence' | 'preference' | 'procedure' | 'hypothesis'").describe(
+	"what the lesson is: evidence = project fact, design decision or failure cause (needs citations in project scope); preference = how the user wants work done; procedure = how to do a task; hypothesis = unverified guess",
+);
+const learnCitationsSchema = type({
+	path: type("string").describe("file path relative to the project root"),
+	"anchor?": type("string").describe("a '## ' heading text, a header field name such as RECORD or SCOPE, or a line range such as 120-140"),
+})
+	.array()
+	.describe("project files that record this lesson; required for kind evidence in project scope; checked for existence only, not for whether the file supports the lesson");
+
+function learnProjectRoot(cwd: string): string {
+	let real = cwd;
+	try {
+		real = fs.realpathSync(cwd);
+	} catch {
+		// An unreadable cwd is reported by the citation path check below.
+	}
+	try {
+		const out = Bun.spawnSync(["git", "-C", real, "rev-parse", "--show-toplevel"], { stdout: "pipe", stderr: "ignore" });
+		const top = out.exitCode === 0 ? out.stdout.toString().trim() : "";
+		if (top) return fs.realpathSync(top);
+	} catch {
+		// No git: the session cwd is the project root.
+	}
+	return real;
+}
+
+function learnPathIgnored(root: string, rel: string): boolean {
+	try {
+		return Bun.spawnSync(["git", "-C", root, "check-ignore", "-q", "--", rel], { stdout: "ignore", stderr: "ignore" }).exitCode === 0;
+	} catch {
+		return false;
+	}
+}
+
+function learnHeadings(text: string): string[] {
+	const headings: string[] = [];
+	for (const line of text.split(/\r?\n/)) {
+		const match = /^#{1,6}\s+(.*?)\s*#*\s*$/.exec(line);
+		if (match) headings.push(match[1]!.replace(/\s+/g, " "));
+	}
+	return headings;
+}
+
+function learnAnchorFound(text: string, anchor: string): boolean {
+	const lines = text.split(/\r?\n/);
+	const range = /^(\d+)(?:-(\d+))?$/.exec(anchor);
+	if (range) {
+		const start = Number(range[1]);
+		const end = Number(range[2] ?? range[1]);
+		return start >= 1 && end >= start && end <= lines.length;
+	}
+	if (/^(RECORD|DATE|SCOPE|PATHS|STATUS)$/.test(anchor)) {
+		return lines.slice(0, 40).some(line => line.startsWith(anchor + ":") || line.startsWith("*" + anchor + ":"));
+	}
+	const want = anchor.replace(/^#{1,6}\s*/, "").replace(/\s+/g, " ").trim().toLowerCase();
+	if (!want) return false;
+	return learnHeadings(text).some(heading => {
+		const have = heading.toLowerCase();
+		return have === want || have.startsWith(want);
+	});
+}
+
+function resolveLearnEvidence(session: ToolSession, params: LearnParams): LearnEvidence {
+	const given = params.citations ?? [];
+	const projectScope = (params.scope ?? "project") === "project";
+	const kind = params.kind ?? (given.length > 0 ? "evidence" : undefined);
+	if (kind === undefined && projectScope) {
+		throw new Error(
+			"learn needs a kind. Use kind evidence for a project fact, design decision or failure cause, and add citations (a list of path plus optional anchor) naming the project file that records it. Use kind preference (how the user wants work done), procedure (how to do a task) or hypothesis (unverified) when no project file records it.",
+		);
+	}
+	if (kind === "evidence" && projectScope && given.length === 0) {
+		throw new Error(
+			"kind evidence in project scope needs at least one citation: citations = [{ path: <file relative to the project root>, anchor: <optional: a '## ' heading text, a header field such as RECORD or SCOPE, or a line range like 120-140> }]. Cite the file that records it (a doc/history record, HANDOFF.md, source). If no file records it yet, write the record first, or use kind hypothesis.",
+		);
+	}
+	if (given.length > LEARN_MAX_CITATIONS) {
+		throw new Error("learn accepts at most " + LEARN_MAX_CITATIONS + " citations; cite the one or two files that matter most.");
+	}
+	if (given.length === 0) return { kind, citations: [] };
+	const root = learnProjectRoot(session.cwd);
+	const citations: LearnCitation[] = [];
+	const seen = new Set<string>();
+	given.forEach((citation, index) => {
+		const label = "citations[" + index + "]";
+		const raw = citation.path.trim().replaceAll("\\", "/");
+		if (!raw) throw new Error(label + ".path is empty.");
+		// A credential-shaped path or anchor is rejected before any error below can echo it and before anything is stored; the value is never quoted.
+		const rawAnchor = citation.anchor?.trim();
+		if (redactMemorySecrets(raw) !== raw) throw new Error(label + ".path contains a credential and cannot be cited.");
+		if (rawAnchor && redactMemorySecrets(rawAnchor) !== rawAnchor) throw new Error(label + ".anchor contains a credential and cannot be cited.");
+		let real: string;
+		try {
+			real = fs.realpathSync(path.resolve(root, raw));
+		} catch {
+			throw new Error(label + '.path "' + raw + '" does not exist under the project root ' + root + ". Use a path relative to the project root.");
+		}
+		const rel = path.relative(root, real);
+		if (rel === "" || rel === ".." || rel.startsWith(".." + path.sep) || path.isAbsolute(rel)) {
+			throw new Error(label + '.path "' + raw + '" is outside the project root ' + root + ".");
+		}
+		// The normalized path is checked before any filesystem call on it, so a native stat error cannot echo a credential-shaped real path.
+		const relPosix = rel.split(path.sep).join("/");
+		if (redactMemorySecrets(relPosix) !== relPosix) throw new Error(label + ".path contains a credential and cannot be cited.");
+		const stat = fs.statSync(real);
+		if (!stat.isFile()) throw new Error(label + '.path "' + raw + '" is not a file; cite a file.');
+		if (!eligibleFile(relPosix, stat.size, true) || learnPathIgnored(root, relPosix)) {
+			throw new Error(label + '.path "' + raw + '" is a secret, binary, empty, excluded or git-ignored file and cannot be cited.');
+		}
+		const anchor = citation.anchor?.trim();
+		if (anchor) {
+			if (stat.size > LEARN_MAX_ANCHOR_FILE_BYTES) throw new Error(label + '.path "' + raw + '" is too large to check an anchor in; cite it without an anchor or use a line range of a smaller file.');
+			const text = fs.readFileSync(real, "utf8");
+			if (!learnAnchorFound(text, anchor)) {
+				const headings = learnHeadings(text).slice(0, 8).map(heading => redactMemorySecrets(heading));
+				throw new Error(
+					label + '.anchor "' + anchor + '" was not found in ' + relPosix + ". Use the text of a '## ' heading, a header field name (RECORD, DATE, SCOPE, PATHS, STATUS) or a line range inside the file." +
+						(headings.length > 0 ? " Headings in the file: " + headings.join(" | ") : ""),
+				);
+			}
+		}
+		// Store a heading without its "## " prefix so the recall line reads path#heading.
+		const stored = anchor ? anchor.replace(/^#{1,6}\s*/, "") : undefined;
+		if (stored && redactMemorySecrets(stored) !== stored) throw new Error(label + ".anchor contains a credential and cannot be cited.");
+		const key = relPosix + "#" + (stored ?? "");
+		if (seen.has(key)) return;
+		seen.add(key);
+		citations.push(stored ? { path: relPosix, anchor: stored } : { path: relPosix });
+	});
+	return { kind, citations };
+}
+
+function learnEvidenceMetadata(evidence: LearnEvidence): Record<string, unknown> {
+	return { ...(evidence.kind ? { kind: evidence.kind } : {}), ...(evidence.citations.length > 0 ? { citations: evidence.citations } : {}) };
+}
+
+const learnSchemaBase = type({
+`;
+
+/**
+ * 2026-10-17 18.11.3 이식: #32 판의 경로 오류가 절대 프로젝트 루트를 그대로 보였다. 오류는 "the project root" 라고만 말하고,
+ * 사용자가 준 상대 경로만 인용한다(절대 경로 입력은 루트를 담을 수 있으므로 "(an absolute path)"). 루트 안으로 확인된 뒤의
+ * 오류는 정규화한 상대 경로를 인용한다. 이슈 #34: 안전한 이름의 링크 cwd 뒤 실제 루트가 native fs 오류(EACCES 등)에 그대로
+ * 실리므로 stat·read 실패도 상대 경로와 오류 코드만 보인다. 나머지 본문은 #32 판과 바이트가 같다.
+ */
+const learnEvidenceBlock = (() => {
+	let text = learnEvidenceIssue32Block;
+	const swap = (from, to) => {
+		const found = text.split(from).length - 1;
+		if (found !== 1) throw new Error(`learn 근거 블록을 만들 수 없다: ${JSON.stringify(from.slice(0, 80))} ${found}/1`);
+		text = text.replace(from, () => to);
+	};
+	swap("\t\tlet real: string;\n", String.raw`		// Errors never echo the absolute project root: they say "the project root" and quote only a relative input.
+		const shown = path.isAbsolute(raw) || /^[A-Za-z]:\//.test(raw) ? "(an absolute path)" : '"' + raw + '"';
+		let real: string;
+`);
+	swap(
+		String.raw`throw new Error(label + '.path "' + raw + '" does not exist under the project root ' + root + ". Use a path relative to the project root.");`,
+		String.raw`throw new Error(label + ".path " + shown + " does not exist under the project root. Use a path relative to the project root.");`,
+	);
+	swap(
+		String.raw`throw new Error(label + '.path "' + raw + '" is outside the project root ' + root + ".");`,
+		String.raw`throw new Error(label + ".path " + shown + " is outside the project root.");`,
+	);
+	swap(String.raw`'.path "' + raw + '" is not a file; cite a file.'`, String.raw`'.path "' + relPosix + '" is not a file; cite a file.'`);
+	swap(String.raw`'.path "' + raw + '" is a secret, binary,`, String.raw`'.path "' + relPosix + '" is a secret, binary,`);
+	swap(String.raw`'.path "' + raw + '" is too large`, String.raw`'.path "' + relPosix + '" is too large`);
+	swap(
+		"\t\tconst stat = fs.statSync(real);\n",
+		String.raw`		// Native fs errors quote the absolute real path; report only the relative path and the error code.
+		let stat: fs.Stats;
+		try {
+			stat = fs.statSync(real);
+		} catch (error) {
+			throw new Error(label + '.path "' + relPosix + '" could not be read (' + ((error as NodeJS.ErrnoException).code ?? "error") + ").");
+		}
+`,
+	);
+	swap(
+		'\t\t\tconst text = fs.readFileSync(real, "utf8");\n',
+		String.raw`			let text: string;
+			try {
+				text = fs.readFileSync(real, "utf8");
+			} catch (error) {
+				throw new Error(label + '.path "' + relPosix + '" could not be read (' + ((error as NodeJS.ErrnoException).code ?? "error") + ").");
+			}
+`,
+	);
+	return text;
+})();
+/** 새 판에만 있는 줄. #32 판·그 이전 판에는 없다. */
+const LEARN_EVIDENCE_MASKED_MARKER = String.raw`+ " is outside the project root.");`;
+/** #32 판과 새 판에만 있는 줄. 그 이전 판(learnEvidenceLegacyBlock)과 순정에는 없다. */
+const LEARN_EVIDENCE_SINCE_32 = "// A credential-shaped path or anchor is rejected";
+
+/** 이슈 #32 이전에 배포된 learn 근거 블록(HEAD b8f1aad) 그대로다. 새 판(learnEvidenceBlock)이 이 본문을 대체한다(legacyPatched). */
+const learnEvidenceLegacyBlock = String.raw`// HANSE: learn evidence citations
+type LearnKind = "evidence" | "preference" | "procedure" | "hypothesis";
+type LearnCitation = { path: string; anchor?: string };
+type LearnEvidence = { kind?: LearnKind; citations: LearnCitation[] };
+const LEARN_MAX_CITATIONS = 8;
+const LEARN_MAX_ANCHOR_FILE_BYTES = 8 * 1024 * 1024;
+
+const learnKindSchema = type("'evidence' | 'preference' | 'procedure' | 'hypothesis'").describe(
+	"what the lesson is: evidence = project fact, design decision or failure cause (needs citations in project scope); preference = how the user wants work done; procedure = how to do a task; hypothesis = unverified guess",
+);
+const learnCitationsSchema = type({
+	path: type("string").describe("file path relative to the project root"),
+	"anchor?": type("string").describe("a '## ' heading text, a header field name such as RECORD or SCOPE, or a line range such as 120-140"),
+})
+	.array()
+	.describe("project files that record this lesson; required for kind evidence in project scope; checked for existence only, not for whether the file supports the lesson");
+
+function learnProjectRoot(cwd: string): string {
+	let real = cwd;
+	try {
+		real = fs.realpathSync(cwd);
+	} catch {
+		// An unreadable cwd is reported by the citation path check below.
+	}
+	try {
+		const out = Bun.spawnSync(["git", "-C", real, "rev-parse", "--show-toplevel"], { stdout: "pipe", stderr: "ignore" });
+		const top = out.exitCode === 0 ? out.stdout.toString().trim() : "";
+		if (top) return fs.realpathSync(top);
+	} catch {
+		// No git: the session cwd is the project root.
+	}
+	return real;
+}
+
+function learnPathIgnored(root: string, rel: string): boolean {
+	try {
+		return Bun.spawnSync(["git", "-C", root, "check-ignore", "-q", "--", rel], { stdout: "ignore", stderr: "ignore" }).exitCode === 0;
+	} catch {
+		return false;
+	}
+}
+
+function learnHeadings(text: string): string[] {
+	const headings: string[] = [];
+	for (const line of text.split(/\r?\n/)) {
+		const match = /^#{1,6}\s+(.*?)\s*#*\s*$/.exec(line);
+		if (match) headings.push(match[1]!.replace(/\s+/g, " "));
+	}
+	return headings;
+}
+
+function learnAnchorFound(text: string, anchor: string): boolean {
+	const lines = text.split(/\r?\n/);
+	const range = /^(\d+)(?:-(\d+))?$/.exec(anchor);
+	if (range) {
+		const start = Number(range[1]);
+		const end = Number(range[2] ?? range[1]);
+		return start >= 1 && end >= start && end <= lines.length;
+	}
+	if (/^(RECORD|DATE|SCOPE|PATHS|STATUS)$/.test(anchor)) {
+		return lines.slice(0, 40).some(line => line.startsWith(anchor + ":") || line.startsWith("*" + anchor + ":"));
+	}
+	const want = anchor.replace(/^#{1,6}\s*/, "").replace(/\s+/g, " ").trim().toLowerCase();
+	if (!want) return false;
+	return learnHeadings(text).some(heading => {
+		const have = heading.toLowerCase();
+		return have === want || have.startsWith(want);
+	});
+}
+
+function resolveLearnEvidence(session: ToolSession, params: LearnParams): LearnEvidence {
+	const given = params.citations ?? [];
+	const projectScope = (params.scope ?? "project") === "project";
+	const kind = params.kind ?? (given.length > 0 ? "evidence" : undefined);
+	if (kind === undefined && projectScope) {
+		throw new Error(
+			"learn needs a kind. Use kind evidence for a project fact, design decision or failure cause, and add citations (a list of path plus optional anchor) naming the project file that records it. Use kind preference (how the user wants work done), procedure (how to do a task) or hypothesis (unverified) when no project file records it.",
+		);
+	}
+	if (kind === "evidence" && projectScope && given.length === 0) {
+		throw new Error(
+			"kind evidence in project scope needs at least one citation: citations = [{ path: <file relative to the project root>, anchor: <optional: a '## ' heading text, a header field such as RECORD or SCOPE, or a line range like 120-140> }]. Cite the file that records it (a doc/history record, HANDOFF.md, source). If no file records it yet, write the record first, or use kind hypothesis.",
+		);
+	}
+	if (given.length > LEARN_MAX_CITATIONS) {
+		throw new Error("learn accepts at most " + LEARN_MAX_CITATIONS + " citations; cite the one or two files that matter most.");
+	}
+	if (given.length === 0) return { kind, citations: [] };
+	const root = learnProjectRoot(session.cwd);
+	const citations: LearnCitation[] = [];
+	const seen = new Set<string>();
+	given.forEach((citation, index) => {
+		const label = "citations[" + index + "]";
+		const raw = citation.path.trim().replaceAll("\\", "/");
+		if (!raw) throw new Error(label + ".path is empty.");
+		let real: string;
+		try {
+			real = fs.realpathSync(path.resolve(root, raw));
+		} catch {
+			throw new Error(label + '.path "' + raw + '" does not exist under the project root ' + root + ". Use a path relative to the project root.");
+		}
+		const rel = path.relative(root, real);
+		if (rel === "" || rel === ".." || rel.startsWith(".." + path.sep) || path.isAbsolute(rel)) {
+			throw new Error(label + '.path "' + raw + '" is outside the project root ' + root + ".");
+		}
+		const stat = fs.statSync(real);
+		if (!stat.isFile()) throw new Error(label + '.path "' + raw + '" is not a file; cite a file.');
+		const relPosix = rel.split(path.sep).join("/");
+		if (!eligibleFile(relPosix, stat.size, true) || learnPathIgnored(root, relPosix)) {
+			throw new Error(label + '.path "' + raw + '" is a secret, binary, empty, excluded or git-ignored file and cannot be cited.');
+		}
+		const anchor = citation.anchor?.trim();
+		if (anchor) {
+			if (stat.size > LEARN_MAX_ANCHOR_FILE_BYTES) throw new Error(label + '.path "' + raw + '" is too large to check an anchor in; cite it without an anchor or use a line range of a smaller file.');
+			const text = fs.readFileSync(real, "utf8");
+			if (!learnAnchorFound(text, anchor)) {
+				const headings = learnHeadings(text).slice(0, 8);
+				throw new Error(
+					label + '.anchor "' + anchor + '" was not found in ' + relPosix + ". Use the text of a '## ' heading, a header field name (RECORD, DATE, SCOPE, PATHS, STATUS) or a line range inside the file." +
+						(headings.length > 0 ? " Headings in the file: " + headings.join(" | ") : ""),
+				);
+			}
+		}
+		// Store a heading without its "## " prefix so the recall line reads path#heading.
+		const stored = anchor ? anchor.replace(/^#{1,6}\s*/, "") : undefined;
+		const key = relPosix + "#" + (stored ?? "");
+		if (seen.has(key)) return;
+		seen.add(key);
+		citations.push(stored ? { path: relPosix, anchor: stored } : { path: relPosix });
+	});
+	return { kind, citations };
+}
+
+function learnEvidenceMetadata(evidence: LearnEvidence): Record<string, unknown> {
+	return { ...(evidence.kind ? { kind: evidence.kind } : {}), ...(evidence.citations.length > 0 ? { citations: evidence.citations } : {}) };
+}
+
+/** A topic lesson is written by upsertLearnTopic; the evidence of the newest revision replaces the previous one afterwards. */
+function stampLearnTopicEvidence(
+	target: ReturnType<MnemopiSessionState["getScopedRetainTarget"]>,
+	topicInput: string,
+	evidence: LearnEvidence,
+): void {
+	const topic = topicInput.normalize("NFKC").trim().toLowerCase();
+	const db = target.memory.conn;
+	db.transaction(() => {
+		const row = db
+			.query("SELECT id, metadata_json FROM working_memory WHERE json_extract(metadata_json, '$.topic_key') = ? ORDER BY timestamp DESC, id DESC LIMIT 1")
+			.get(topic) as { id: string; metadata_json: string } | null;
+		if (!row) throw new Error("Lesson stored, but its topic row was not found to attach the evidence.");
+		const metadata: Record<string, unknown> = JSON.parse(row.metadata_json);
+		delete metadata.kind;
+		delete metadata.citations;
+		db.query("UPDATE working_memory SET metadata_json = ? WHERE id = ?").run(JSON.stringify({ ...metadata, ...learnEvidenceMetadata(evidence) }), row.id);
+	}).immediate();
+}
+
+const learnSchemaBase = type({
+`;
+
 /** embedding 보존 이전(출처 구분) learn topic upsert 적용본. 새 판(learnTopicUpsertBlock)이 이 본문을 대체한다(legacyPatched). */
 const learnTopicUpsertLegacyBlock = `// HANSE: topic-key learn upsert
 function upsertLearnTopic(
@@ -504,6 +1000,33 @@ const IRC_STEER_BRACKET_MEMBERS = `
 		}
 	}`;
 
+/**
+ * 2026-10-16 Codex realtime v3 목소리. core 18.11.1 의 `LIVE_VOICE_OPTIONS` 는 v1 아홉 개뿐이라 `live.voice` 가
+ * 새 목소리(한국어 haetsal·hanul 등)를 거절한다. CUELO 통화는 Codex CLI 와 같은 frameless-bidi/avas 경로
+ * (`gpt-live-1-codex`)이고, Codex CLI 는 그 경로를 `RealtimeVoicesList::builtin().v3`(openai/codex
+ * codex-rs/protocol/src/protocol.rs, #52363) 로 검증한다. 기존 아홉 개와 기본값 `sol` 은 그대로 두고 v3 에만 있는
+ * 열여섯 개를 같은 순서로 뒤에 붙인다. 한국어 두 목소리만 뜻을 라벨에 덧붙인다.
+ * 회귀: patches/core-patch-test.ts [34].
+ */
+const CODEX_V3_LIVE_VOICES = [
+	["aube", "Aube"],
+	["bubbie", "Bubbie"],
+	["haetsal", "Haetsal (햇살)"],
+	["hanul", "Hanul (하늘)"],
+	["himari", "Himari"],
+	["leher", "Leher"],
+	["miko", "Miko"],
+	["neer", "Neer"],
+	["porto", "Porto"],
+	["rindo", "Rindo"],
+	["rio", "Rio"],
+	["rivage", "Rivage"],
+	["selva", "Selva"],
+	["sonna", "Sonna"],
+	["tinta", "Tinta"],
+	["viola", "Viola"],
+];
+
 /** 각 항목: 원본 앵커를 찾아 patched 로 바꾼다. marker 가 있으면 이미 적용된 것으로 본다. */
 const EDITS = [
 	{
@@ -3692,6 +4215,37 @@ function evalRejectionResult(error: unknown): AgentToolResult<EvalToolDetails |
 				...(params.tools?.length`,
 		}],
 	},
+	{
+		// 2026-10-17 18.11.3 공개 이슈 #33: upstream 은 seance 전용 task `model` 을 넣으며 validateSeanceParams 로 다른 agent 의
+		// `model` 을 거절한다. planSpawns 가 이 검사를 speculative launch 와 dispatch 양쪽에서 부르므로 CUELO Maker 의
+		// `model: '<후보 selector>:auto'` 발주가 executor 에 닿기 전에 막힌다. Maker(agent 이름 `maker`, CUELO task-guard 가
+		// 허용하는 유일한 child) 만 문자열 selector 하나를 받는다. selector 자체(후보·`:auto`)는 command-guard maker-routing 이
+		// 검사한다. seance 검사(sourceSession 필수·custom tools 금지·selector 형태)와 비-seance `sourceSession` 거절, 다른
+		// 비-seance agent 의 `model` 거절은 그대로다. seance.ts 가 없는 옛 판(18.11.1 이하)은 index.ts 의 no-op 후보로 둔다.
+		file: "src/task/seance.ts",
+		marker: "// CUELO: the Maker carries its routed candidate",
+		anchor: `	if (agent !== SEANCE_AGENT_NAME) {
+		if (item.sourceSession !== undefined)
+			return \`\\\`sourceSession\\\` is only accepted for the \\\`\${SEANCE_AGENT_NAME}\\\` agent.\`;
+		if (item.model !== undefined) return \`\\\`model\\\` is only accepted for the \\\`\${SEANCE_AGENT_NAME}\\\` agent.\`;`,
+		patched: `	if (agent !== SEANCE_AGENT_NAME) {
+		if (item.sourceSession !== undefined)
+			return \`\\\`sourceSession\\\` is only accepted for the \\\`\${SEANCE_AGENT_NAME}\\\` agent.\`;
+		// CUELO: the Maker carries its routed candidate as one \`model\` selector ('<selector>:auto'); the command-guard
+		// maker-routing hook validates that selector. Every other non-seance agent still rejects \`model\`.
+		if (agent === "maker" && item.model !== undefined) {
+			if (typeof item.model === "string" && item.model.trim().length > 0) return undefined;
+			return "\`model\` for the \`maker\` agent must be one non-empty selector string.";
+		}
+		if (item.model !== undefined) return \`\\\`model\\\` is only accepted for the \\\`\${SEANCE_AGENT_NAME}\\\` agent.\`;`,
+		alternates: [{
+			file: "src/task/index.ts",
+			excludes: "validateSeanceParams",
+			marker: 'import { formatTaskResultSummary } from "./result-summary";',
+			anchor: 'import { formatTaskResultSummary } from "./result-summary";',
+			patched: 'import { formatTaskResultSummary } from "./result-summary";',
+		}],
+	},
 	{
 		// 18.3.3 BLOCK: upstream 은 `task`·`bash` 를 가진 SubAgent 정의에 `wait` 를 자동으로 더한다
 		// (executor.ts:3505-3516). CUELO 계약은 Main 전용 wait 다(harness-policy
@@ -5702,137 +6256,47 @@ class LocalTextBackend implements TextBackend {`,
 		patched: `import type { Settings } from "../config/settings";
 import { cfgJudgmentProvider } from "../config/model-settings";`,
 	},
+	// 2026-10-17 RETIRE(사용자 결정: Experiential 탈퇴): typesafe 경로를 Experiential Labs gateway 로 보내던 설정을 지웠으므로
+	// 그 gateway decoder 의 32문항 한도(MAX_DECISION_QUESTIONS) 때문에 judge chain 이 typesafe 요청을 32개씩 나누던
+	// 2026-10-09 항목 두 개(18.9.1 typesafe.ts·18.9.2 이후 judgment/index.ts import·#createJudge)를 없앤다. judge 는 이제
+	// upstream createNativeJudge(catalog 상한) 그대로다. 이미 그 패치를 실은 설치(18.11.1 라이브)를 --apply·--revert 가
+	// upstream 줄로 되돌리도록 옛 적용본을 legacyPatched 로 둔 no-op 후보로 남긴다. 회귀 시험 core-typesafe-split-test.ts 도 지웠다.
 	{
-		// 2026-10-09 WSL 회귀 감사 3.5: JEV `find` 판정이 typesafe 경로에서 23.8% 400("Invalid decision request.
-		// Send only model, state, and bounded typed questions; ...")으로 실패하고 openrouter 로 넘어갔다. typesafe
-		// provider 는 Experiential Labs gateway(models.yml)로 가고, 그 decoder 는 요청당 질문을 32개까지만 받는다
-		// (experientiallabs/experiential exp/runtime/gateway/decisions_contracts.py MAX_DECISION_QUESTIONS = 32).
-		// find 는 한 요청에 최대 64(NAME_BATCH·DIR_BATCH)·48(SKETCH_CARDS_MAX)개를 보낸다. 세션 기록에서 400 62건은
-		// 전부 35문항 이상, 성공 184건은 전부 30문항 이하였다. 질문은 같은 state 에 대해 서로 독립으로 판정되므로
-		// 32개씩 나눠 같은 state 로 병렬 전송하고 응답을 합친다. jfind 배치 상수와 벤치마크한 state 배치는 그대로다.
-		// 32개 이하 요청은 본문 바이트가 그대로이고, openrouter-decisions 경로(61문항도 받았다)는 나누지 않는다.
-		// 검증: core-typesafe-split-test.ts.
-		file: "../pi-ai/src/judgment/typesafe.ts",
-		marker: "const TYPESAFE_MAX_QUESTIONS = 32;",
-		anchor: "\treturn Math.min(BACKOFF_BASE_MS * 2 ** attempt, BACKOFF_MAX_MS);\n}\n\nexport class TypeSafeJudge implements Judge {\n",
-		patched: [
-			"\treturn Math.min(BACKOFF_BASE_MS * 2 ** attempt, BACKOFF_MAX_MS);",
-			"}",
-			"",
-			"/**",
-			" * CUELO: questions per request on the `typesafe` route. CUELO points that route at the Experiential Labs",
-			" * gateway, whose decoder admits at most 32 questions (`MAX_DECISION_QUESTIONS`) and answers a larger set",
-			" * with 400 \"Invalid decision request\". Questions are judged independently against the shared state, so a",
-			" * larger set goes out as parts that each repeat the state.",
-			" */",
-			"const TYPESAFE_MAX_QUESTIONS = 32;",
-			"",
-			"/** `questions` itself when it has at most `max` entries, else parts of at most `max` in insertion order. */",
-			"function questionParts(questions: Questions, max: number): Questions[] {",
-			"\tconst ids = Object.keys(questions);",
-			"\tif (ids.length <= max) return [questions];",
-			"\tconst parts: Questions[] = [];",
-			"\tfor (let start = 0; start < ids.length; start += max) {",
-			"\t\tconst part: Questions = {};",
-			"\t\tfor (const id of ids.slice(start, start + max)) part[id] = questions[id]!;",
-			"\t\tparts.push(part);",
-			"\t}",
-			"\treturn parts;",
-			"}",
-			"",
-			"/** The parts' responses as one: answers merged, token counts and billed cost summed where reported. */",
-			"function mergeResponses(responses: SystemOneResponse[]): SystemOneResponse {",
-			"\tif (responses.length === 1) return responses[0]!;",
-			"\tconst total = (pick: (usage: SystemOneResponse[\"usage\"]) => number | undefined): number | undefined => {",
-			"\t\tlet sum: number | undefined;",
-			"\t\tfor (const response of responses) {",
-			"\t\t\tconst value = pick(response.usage);",
-			"\t\t\tif (value !== undefined) sum = (sum ?? 0) + value;",
-			"\t\t}",
-			"\t\treturn sum;",
-			"\t};",
-			"\treturn {",
-			"\t\tmodel: responses[0]!.model,",
-			"\t\tanswers: Object.assign({}, ...responses.map(response => response.answers)),",
-			"\t\tusage: {",
-			"\t\t\tinput_tokens: total(usage => usage.input_tokens),",
-			"\t\t\toutput_tokens: total(usage => usage.output_tokens),",
-			"\t\t\tcost: total(usage => usage.cost),",
-			"\t\t},",
-			"\t};",
-			"}",
-			"",
-			"export class TypeSafeJudge implements Judge {",
+		file: "src/judgment/index.ts",
+		marker: 'import * as AIError from "@oh-my-pi/pi-ai/error";\n',
+		anchor: 'import * as AIError from "@oh-my-pi/pi-ai/error";\n',
+		patched: 'import * as AIError from "@oh-my-pi/pi-ai/error";\n',
+		legacyPatched: [
+			'import * as AIError from "@oh-my-pi/pi-ai/error";',
+			"// CUELO: the typesafe route's per-request question cap (see #createJudge).",
+			'import { NativeJudge as TypesafeGatewayJudge } from "@oh-my-pi/pi-ai";',
+			'import { resolveJudgmentQuestionsMax } from "@oh-my-pi/pi-catalog/compat/judgment-questions";',
 			"",
 		].join("\n"),
-		// 2026-10-13 18.9.2(ADAPT): upstream 이 TypeSafeJudge·typesafe.ts 를 지우고 NativeJudge 로 바꿨다. NativeJudge 는
-		// catalog `judgment-questions-max` 로 요청을 나누지만(최대 4개 병렬, 한 조각 실패 시 나머지 중단) TypeSafe jev 는
-		// 한도 없음으로 둔다. CUELO 는 typesafe 경로를 Experiential gateway(32문항)로 보내므로 judge chain 호출부
-		// (judgment/index.ts)에서만 그 경로의 상한을 32로 넘긴다. 이 항목은 그 호출부가 쓰는 import 두 줄이다.
-		alternates: [{
-			file: "src/judgment/index.ts",
-			requires: "\tcreateNativeJudge,\n",
-			marker: 'import { resolveJudgmentQuestionsMax } from "@oh-my-pi/pi-catalog/compat/judgment-questions";',
-			anchor: 'import * as AIError from "@oh-my-pi/pi-ai/error";\n',
-			patched: [
-				'import * as AIError from "@oh-my-pi/pi-ai/error";',
-				"// CUELO: the typesafe route's per-request question cap (see #createJudge).",
-				'import { NativeJudge as TypesafeGatewayJudge } from "@oh-my-pi/pi-ai";',
-				'import { resolveJudgmentQuestionsMax } from "@oh-my-pi/pi-catalog/compat/judgment-questions";',
-				"",
-			].join("\n"),
-		}],
 	},
 	{
-		// 위 항목과 짝: judge 가 질문 묶음을 나눠 보내고 응답을 합친다. 나누지 않으면 parts 는 request.questions
-		// 그 객체 하나라 본문이 원래 식 `{ state, model, questions }` 과 바이트까지 같다.
-		file: "../pi-ai/src/judgment/typesafe.ts",
-		marker: "// CUELO: past the typesafe question bound",
-		anchor: "\t\tconst body = JSON.stringify({ state: request.state, model: this.model, questions: request.questions });\n\t\tconst signal = options?.signal;\n\t\tconst response = await withAuth(\n\t\t\tthis.#apiKey,\n\t\t\tkey => this.#attempt<SystemOneResponse>(JUDGMENT_ROUTES[this.api], body, key, signal),\n\t\t\t{ signal },\n\t\t);\n",
-		patched: [
-			"\t\tconst signal = options?.signal;",
-			"\t\t// CUELO: past the typesafe question bound the parts run in parallel and merge into one response.",
-			"\t\tconst parts = questionParts(request.questions, this.api === TYPESAFE_PROVIDER ? TYPESAFE_MAX_QUESTIONS : Infinity);",
-			"\t\tconst response = mergeResponses(",
-			"\t\t\tawait Promise.all(",
-			"\t\t\t\tparts.map(questions => {",
-			"\t\t\t\t\tconst body = JSON.stringify({ state: request.state, model: this.model, questions });",
-			"\t\t\t\t\treturn withAuth(",
-			"\t\t\t\t\t\tthis.#apiKey,",
-			"\t\t\t\t\t\tkey => this.#attempt<SystemOneResponse>(JUDGMENT_ROUTES[this.api], body, key, signal),",
-			"\t\t\t\t\t\t{ signal },",
-			"\t\t\t\t\t);",
-			"\t\t\t\t}),",
-			"\t\t\t),",
-			"\t\t);",
+		file: "src/judgment/index.ts",
+		marker: "\t\t\tconst judge = createNativeJudge(model, { apiKey, headers });\n",
+		anchor: "\t\t\tconst judge = createNativeJudge(model, { apiKey, headers });\n",
+		patched: "\t\t\tconst judge = createNativeJudge(model, { apiKey, headers });\n",
+		legacyPatched: [
+			"\t\t\t// CUELO: past the typesafe question bound the judge splits the request. CUELO points the `typesafe` route at the",
+			"\t\t\t// Experiential Labs gateway, whose decoder admits at most 32 questions (`MAX_DECISION_QUESTIONS`) and answers a",
+			"\t\t\t// larger set with 400 \"Invalid decision request\"; the catalog leaves TypeSafe jev uncapped.",
+			"\t\t\tconst judge =",
+			"\t\t\t\tmodel.api === TYPESAFE_PROVIDER",
+			"\t\t\t\t\t? new TypesafeGatewayJudge({",
+			"\t\t\t\t\t\t\tapiKey,",
+			"\t\t\t\t\t\t\theaders,",
+			"\t\t\t\t\t\t\tapi: model.api,",
+			"\t\t\t\t\t\t\tprovider: model.provider,",
+			"\t\t\t\t\t\t\tmodel: model.requestModelId ?? model.id,",
+			"\t\t\t\t\t\t\tbaseUrl: model.baseUrl,",
+			"\t\t\t\t\t\t\tmaxQuestions: Math.min(resolveJudgmentQuestionsMax(model) ?? 32, 32),",
+			"\t\t\t\t\t\t})",
+			"\t\t\t\t\t: createNativeJudge(model, { apiKey, headers });",
 			"",
 		].join("\n"),
-		// 2026-10-13 18.9.2(ADAPT): 위 항목과 짝. typesafe API 후보만 catalog 상한과 32 중 작은 값으로 NativeJudge 를 직접
-		// 만들고(createNativeJudge 와 같은 wire id·baseUrl), 다른 judgment API 와 auth-gateway 는 upstream createNativeJudge 그대로다.
-		alternates: [{
-			file: "src/judgment/index.ts",
-			requires: "\tcreateNativeJudge,\n",
-			marker: "// CUELO: past the typesafe question bound",
-			anchor: "\t\t\tconst judge = createNativeJudge(model, { apiKey, headers });\n",
-			patched: [
-				"\t\t\t// CUELO: past the typesafe question bound the judge splits the request. CUELO points the `typesafe` route at the",
-				"\t\t\t// Experiential Labs gateway, whose decoder admits at most 32 questions (`MAX_DECISION_QUESTIONS`) and answers a",
-				"\t\t\t// larger set with 400 \"Invalid decision request\"; the catalog leaves TypeSafe jev uncapped.",
-				"\t\t\tconst judge =",
-				"\t\t\t\tmodel.api === TYPESAFE_PROVIDER",
-				"\t\t\t\t\t? new TypesafeGatewayJudge({",
-				"\t\t\t\t\t\t\tapiKey,",
-				"\t\t\t\t\t\t\theaders,",
-				"\t\t\t\t\t\t\tapi: model.api,",
-				"\t\t\t\t\t\t\tprovider: model.provider,",
-				"\t\t\t\t\t\t\tmodel: model.requestModelId ?? model.id,",
-				"\t\t\t\t\t\t\tbaseUrl: model.baseUrl,",
-				"\t\t\t\t\t\t\tmaxQuestions: Math.min(resolveJudgmentQuestionsMax(model) ?? 32, 32),",
-				"\t\t\t\t\t\t})",
-				"\t\t\t\t\t: createNativeJudge(model, { apiKey, headers });",
-				"",
-			].join("\n"),
-		}],
 	},
 	{
 		// 18.2.7 에는 `providers.judgmentProvider` schema 항목 자체가 없다(legacy key 목록에만
@@ -7488,12 +7952,14 @@ function operationFromNative(op: string): Operation | undefined {
 		marker: "// HANSE: recall provenance note",
 		anchor: "function formatRecallBlock(results: RecallResult[]): string {\n",
 		patched: recallProvenanceBlock + "function formatRecallBlock(results: RecallResult[]): string {\n",
+		legacyPatched: recallProvenanceLegacyBlock + "function formatRecallBlock(results: RecallResult[]): string {\n",
 		alternates: [{
 			file: "src/mnemopi/state.ts",
 			requires: "findPersistedRecall",
 			marker: "// HANSE: recall provenance note",
 			anchor: "/** Renders a recall block and the offset where each result's text starts in it. */\nfunction formatRecallBlock(results: RecallResult[]): { text: string; offsets: number[] } {\n",
 			patched: recallProvenanceBlock + "/** Renders a recall block and the offset where each result's text starts in it. */\nfunction formatRecallBlock(results: RecallResult[]): { text: string; offsets: number[] } {\n",
+			legacyPatched: recallProvenanceLegacyBlock + "/** Renders a recall block and the offset where each result's text starts in it. */\nfunction formatRecallBlock(results: RecallResult[]): { text: string; offsets: number[] } {\n",
 		}],
 	},
 	{
@@ -7541,6 +8007,73 @@ function operationFromNative(op: string): Operation | undefined {
 			patched: "\t\t\t\t\t\tfor (const result of results) {\n\t\t\t\t\t\t\t// HANSE: recall result carries its bank scope\n\t\t\t\t\t\t\tconst recallScope = this.scoped.global ? (target.bank === this.scoped.global.bank ? \"global\" : \"project\") : undefined;\n\t\t\t\t\t\t\tmergeRecallResult(merged, byId, byContent, { ...result, recallScope } as RecallResult);\n",
 		}],
 	},
+	{
+		// 2026-10-17: recall 은 facts 를 함께 싣는데 fact 줄은 metadata 가 없다. 출처 기억(source_memory_id)의 citations 만 줄에 옮겨 근거 후보가 사라지지 않게 한다.
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: facts carry the citations of the memory they were taken from",
+		anchor: "targetSucceeded = true;\n",
+		patched: "targetSucceeded = true;\n\t\t\t\t\t// HANSE: facts carry the citations of the memory they were taken from\n\t\t\t\t\tattachFactCitations(target.memory, results);\n",
+	},
+	{
+		// 2026-10-17 턴 단위 주입 게이트(doc/history/2026/10/17-memory-gate-citations): 자동 첫 턴 회상에서 상위 후보의 원시 dense
+		// 코사인 최댓값이 기준 미만이면 그 턴에는 기억을 싣지 않는다. 기준은 설정이고 0 이면 끈다(기본 0.80, multilingual-e5 전용).
+		file: "src/mnemopi/settings.ts",
+		marker: "cfgMnemopiRecallDenseGate",
+		anchor: "export const cfgMnemopiRecallContextTurns = register({ id: \"mnemopi.recallContextTurns\", type: \"number\", default: 3 });\n",
+		patched: "export const cfgMnemopiRecallContextTurns = register({ id: \"mnemopi.recallContextTurns\", type: \"number\", default: 3 });\n\n// HANSE: turn-level dense gate setting (0 disables)\nexport const cfgMnemopiRecallDenseGate = register({ id: \"mnemopi.recallDenseGate\", type: \"number\", default: 0.8 });\n",
+	},
+	{
+		file: "src/mnemopi/config.ts",
+		marker: "\tcfgMnemopiRecallDenseGate,\n",
+		anchor: "\tcfgMnemopiRecallContextTurns,\n",
+		patched: "\tcfgMnemopiRecallContextTurns,\n\tcfgMnemopiRecallDenseGate,\n",
+	},
+	{
+		file: "src/mnemopi/config.ts",
+		marker: "\trecallDenseGate: number;\n",
+		anchor: "\trecallContextTurns: number;\n",
+		patched: "\trecallContextTurns: number;\n\t/** HANSE: turn-level dense gate; best raw dense cosine below this skips the first-turn injection. 0 disables. */\n\trecallDenseGate: number;\n",
+	},
+	{
+		file: "src/mnemopi/config.ts",
+		marker: "\t\trecallDenseGate: Math.min(1, Math.max(0, Number(cfgMnemopiRecallDenseGate.get(settings)) || 0)),\n",
+		anchor: "\t\trecallContextTurns: Math.max(1, Math.floor(cfgMnemopiRecallContextTurns.get(settings))),\n",
+		patched: "\t\trecallContextTurns: Math.max(1, Math.floor(cfgMnemopiRecallContextTurns.get(settings))),\n\t\trecallDenseGate: Math.min(1, Math.max(0, Number(cfgMnemopiRecallDenseGate.get(settings)) || 0)),\n",
+	},
+	{
+		// recallForContext 는 압축 회상도 쓰므로 게이트는 세 번째 인자로 자동 첫 턴 주입 경로만 켠다.
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: turn-level dense gate",
+		anchor: "\tasync recallForContext(query: string, signal?: AbortSignal): Promise<string | undefined> {\n\t\treturn (await this.#recallBlock(query, signal))?.text || undefined;\n\t}\n\n\t/** Recalls `query` into a prompt block plus the memories it holds; undefined when aborted. */\n\tasync #recallBlock(query: string, signal?: AbortSignal): Promise<RecallBlock | undefined> {\n\t\tconst results = await this.collectScopedRecallResults(query);\n\t\tif (signal?.aborted) return undefined;\n\t\tif (results.length === 0) return { text: \"\", memories: [] };\n",
+		patched: "\t/** `autoInjection` is passed only by the first-turn prompt injection; compaction recall and explicit recall never gate. */\n\tasync recallForContext(query: string, signal?: AbortSignal, autoInjection = false): Promise<string | undefined> {\n\t\treturn (await this.#recallBlock(query, signal, autoInjection))?.text || undefined;\n\t}\n\n"
+			+ "\t// HANSE: turn-level dense gate\n"
+			+ "\t/**\n\t * Whole-turn skip for the automatic first-turn recall: when even the best raw dense cosine among the recalled candidates\n\t * is below `mnemopi.recallDenseGate`, the request matches nothing stored and no memory is injected this turn.\n\t * Calibrated for multilingual-e5 (other models have another cosine range), so it is off for them. A turn with no dense\n\t * signal at all (embeddings off, rows not embedded yet) never gates.\n\t */\n"
+			+ "\t#recallGated(results: readonly RecallResult[]): boolean {\n"
+			+ "\t\tconst gate = this.config.recallDenseGate;\n"
+			+ "\t\tconst provider = this.config.providerOptions;\n"
+			+ "\t\tif (!(typeof gate === \"number\" && gate > 0)) return false;\n"
+			+ "\t\tif (!provider || provider.noEmbeddings || provider.embeddingApiUrl || !/(^|[/_-])e5([-_]|$)/i.test(provider.embeddingModel ?? \"\")) return false;\n"
+			+ "\t\tlet best = 0;\n"
+			+ "\t\tfor (const result of results) if (typeof result.dense_score === \"number\" && result.dense_score > best) best = result.dense_score;\n"
+			+ "\t\tif (best <= 0 || best >= gate) return false;\n"
+			+ "\t\tlogger.debug(\"Mnemopi: first-turn recall skipped by dense gate\", { best, gate });\n"
+			+ "\t\tthis.session.sessionManager.appendCustomEntry?.(\"mnemopi-recall-gated\", { dense: best, gate, candidates: results.length });\n"
+			+ "\t\treturn true;\n"
+			+ "\t}\n\n"
+			+ "\t/** Recalls `query` into a prompt block plus the memories it holds; undefined when aborted. */\n\tasync #recallBlock(query: string, signal?: AbortSignal, autoInjection = false): Promise<RecallBlock | undefined> {\n\t\tconst results = await this.collectScopedRecallResults(query);\n\t\tif (signal?.aborted) return undefined;\n\t\tif (results.length === 0) return { text: \"\", memories: [] };\n\t\tif (autoInjection && this.#recallGated(results)) return { text: \"\", memories: [] };\n",
+	},
+	{
+		file: "src/mnemopi/state.ts",
+		marker: "await this.#recallBlock(truncated, signal, true);",
+		anchor: "\t\tconst recall = await this.#recallBlock(truncated, signal);\n",
+		patched: "\t\tconst recall = await this.#recallBlock(truncated, signal, true);\n",
+	},
+	{
+		file: "src/mnemopi/state.ts",
+		marker: "await this.#recallBlock(truncated, undefined, true);",
+		anchor: "\t\t\t\tconst recall = await this.#recallBlock(truncated);\n",
+		patched: "\t\t\t\tconst recall = await this.#recallBlock(truncated, undefined, true);\n",
+	},
 	{
 		file: "src/tools/learn.ts",
 		marker: 'import { redactMemorySecrets } from "../memory-backend/redact";',
@@ -7561,12 +8094,24 @@ function operationFromNative(op: string): Operation | undefined {
 	},
 	{
 		// 출처 구분: 갱신해도 최초 session/cwd 는 남고 updated_* 가 최신 정정자다. 실효 embedding 입력이 같으면 벡터를 둔다(#30).
-		// legacyPatched 는 embedding 보존 이전(출처 구분) 적용본이다.
+		// 이슈 #32: topic 근거(kind·citations)는 이 함수가 본문·임베딩과 같은 쓰기 단위로 저장한다.
+		// 본 후보의 legacyPatched 는 #32 이전에 배포된 embedding 보존판(HEAD b8f1aad)이고, alternates 는 embedding 보존 이전(출처 구분) 적용본을 옮긴다.
 		file: "src/tools/learn.ts",
-		marker: "// HANSE: learn topic keeps embedding when its input is unchanged",
+		marker: "// HANSE: learn topic evidence is stored with the topic row",
 		anchor: "export class LearnTool implements AgentTool<LearnSchema> {",
-		legacyPatched: learnTopicUpsertLegacyBlock,
+		excludes: learnTopicUpsertLegacyBlock,
+		legacyPatched: learnTopicUpsertPreEvidenceBlock,
 		patched: learnTopicUpsertBlock,
+		alternates: [
+			{
+				file: "src/tools/learn.ts",
+				marker: "// HANSE: learn topic evidence is stored with the topic row",
+				anchor: "export class LearnTool implements AgentTool<LearnSchema> {",
+				requires: learnTopicUpsertLegacyBlock,
+				legacyPatched: learnTopicUpsertLegacyBlock,
+				patched: learnTopicUpsertBlock,
+			},
+		],
 	},
 	{
 		// learn 은 rememberScoped 가 돌려준 기억 id 를 버리고 "Lesson stored." 만 알렸다. 교훈을 뒤에서
@@ -7574,10 +8119,22 @@ function operationFromNative(op: string): Operation | undefined {
 		// 18.3.3은 호출을 `rememberScoped(memory, {...}, target)` 3인자로 펼쳤다(learn.ts:110-134,
 		// global scope 지원). 반환값(기억 id)은 그대로 string 이다.
 		file: "src/tools/learn.ts",
+		// 이슈 #32: topic 호출이 근거(evidence)를 함께 넘긴다. 본 후보의 legacyPatched 는 근거를 넘기지 않던 배포본(HEAD b8f1aad)이다.
 		marker: "// HANSE: learn reports memory id",
 		anchor: "\t\t\ttry {\n\t\t\t\tstate.rememberScoped(\n",
-		legacyPatched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst memoryId = state.rememberScoped(\n",
-		patched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst topicResult = params.topic ? upsertLearnTopic(state, params, target ?? state.getScopedRetainTarget()) : undefined;\n\t\t\t\tconst memoryId = topicResult?.id ?? state.rememberScoped(\n",
+		excludes: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst memoryId = state.rememberScoped(\n",
+		legacyPatched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst topicResult = params.topic ? upsertLearnTopic(state, params, target ?? state.getScopedRetainTarget()) : undefined;\n\t\t\t\tconst memoryId = topicResult?.id ?? state.rememberScoped(\n",
+		patched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst topicResult = params.topic ? upsertLearnTopic(state, params, target ?? state.getScopedRetainTarget(), evidence) : undefined;\n\t\t\t\tconst memoryId = topicResult?.id ?? state.rememberScoped(\n",
+		alternates: [
+			{
+				file: "src/tools/learn.ts",
+				marker: "// HANSE: learn reports memory id",
+				anchor: "\t\t\ttry {\n\t\t\t\tstate.rememberScoped(\n",
+				requires: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst memoryId = state.rememberScoped(\n",
+				legacyPatched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst memoryId = state.rememberScoped(\n",
+				patched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst topicResult = params.topic ? upsertLearnTopic(state, params, target ?? state.getScopedRetainTarget(), evidence) : undefined;\n\t\t\t\tconst memoryId = topicResult?.id ?? state.rememberScoped(\n",
+			},
+		],
 	},
 	{
 		file: "src/tools/learn.ts",
@@ -7586,6 +8143,72 @@ function operationFromNative(op: string): Operation | undefined {
 		legacyPatched: "\t\t\t\t\ttarget,\n\t\t\t\t);\n\t\t\t\tif (memoryId) memoryMessage = `Lesson stored (id: ${memoryId})`;\n\t\t\t} catch (error) {\n",
 		patched: "\t\t\t\t\ttarget,\n\t\t\t\t);\n\t\t\t\tif (memoryId) memoryMessage = `Lesson stored (id: ${memoryId}${topicResult ? `, revision: ${topicResult.revision}` : \"\"})`;\n\t\t\t} catch (error) {\n",
 	},
+	{
+		// 2026-10-17 근거형 learn: 검증·metadata 보조 함수와 kind·citations schema 는 learnSchemaBase 앞에 한 덩어리로 둔다.
+		file: "src/tools/learn.ts",
+		// legacyPatched 는 citation 의 비밀 형태 거절 이전 적용본이다(#32).
+		// 2026-10-17 18.11.3 이식: 경로 오류가 루트를 가린 새 판. #32 배포본(learnEvidenceIssue32Block)은 아래 alternate 의
+		// legacyPatched 로 받는다. 두 후보는 #32 이후에만 있는 비밀 거절 주석으로 서로 배타적이다(순정·옛 판 = 본 후보).
+		marker: LEARN_EVIDENCE_MASKED_MARKER,
+		excludes: LEARN_EVIDENCE_SINCE_32,
+		anchor: "const learnSchemaBase = type({\n",
+		legacyPatched: learnEvidenceLegacyBlock,
+		patched: learnEvidenceBlock,
+		alternates: [{
+			file: "src/tools/learn.ts",
+			requires: LEARN_EVIDENCE_SINCE_32,
+			marker: LEARN_EVIDENCE_MASKED_MARKER,
+			anchor: "const learnSchemaBase = type({\n",
+			legacyPatched: learnEvidenceIssue32Block,
+			patched: learnEvidenceBlock,
+		}],
+	},
+	{
+		file: "src/tools/learn.ts",
+		marker: 'import { eligibleFile } from "./jfind/tree";',
+		anchor: 'import type { ToolSession } from ".";\n',
+		patched: 'import type { ToolSession } from ".";\nimport * as fs from "node:fs";\nimport * as path from "node:path";\nimport { eligibleFile } from "./jfind/tree";\n',
+	},
+	{
+		file: "src/tools/learn.ts",
+		marker: '\t"kind?": learnKindSchema,\n\t"citations?": learnCitationsSchema,\n\t"skill?": learnSkillSchema,\n});\n\n/** Offered only',
+		anchor: '\t"skill?": learnSkillSchema,\n});\n\n/** Offered only',
+		patched: '\t"kind?": learnKindSchema,\n\t"citations?": learnCitationsSchema,\n\t"skill?": learnSkillSchema,\n});\n\n/** Offered only',
+	},
+	{
+		file: "src/tools/learn.ts",
+		marker: '\t"kind?": learnKindSchema,\n\t"citations?": learnCitationsSchema,\n\t"skill?": learnSkillSchema,\n});\n\ntype LearnSchema',
+		anchor: '\t"skill?": learnSkillSchema,\n});\n\ntype LearnSchema',
+		patched: '\t"kind?": learnKindSchema,\n\t"citations?": learnCitationsSchema,\n\t"skill?": learnSkillSchema,\n});\n\ntype LearnSchema',
+	},
+	{
+		// 저장 전에 검증한다. mnemopi 만 metadata 를 남길 수 있으므로 다른 백엔드는 kind·citations 를 요구하지 않는다.
+		file: "src/tools/learn.ts",
+		marker: "// HANSE: learn evidence is validated before anything is written",
+		anchor: '\t\tconst backend = cfgMemoryBackend.get(this.session.settings);\n\t\tif (params.scope === "global" && backend !== "mnemopi") {\n',
+		patched: '\t\tconst backend = cfgMemoryBackend.get(this.session.settings);\n\t\t// HANSE: learn evidence is validated before anything is written\n\t\tconst evidence: LearnEvidence = backend === "mnemopi" ? resolveLearnEvidence(this.session, params) : { citations: [] };\n\t\tif (params.scope === "global" && backend !== "mnemopi") {\n',
+	},
+	{
+		file: "src/tools/learn.ts",
+		marker: "...learnEvidenceMetadata(evidence),",
+		anchor: '\t\t\t\t\t\t\ttool: "learn",\n\t\t\t\t\t\t},\n',
+		patched: '\t\t\t\t\t\t\ttool: "learn",\n\t\t\t\t\t\t\t...learnEvidenceMetadata(evidence),\n\t\t\t\t\t\t},\n',
+	},
+	{
+		// 이슈 #32: 별도 stamp 호출(저장 뒤 두 번째 쓰기)을 없앴다. 근거는 upsertLearnTopic 이 저장한다.
+		// legacyPatched 는 그 stamp 호출을 넣었던 배포본(HEAD b8f1aad)이다. 원본·#32 이후 상태에서는 앵커를 그대로 둔다.
+		file: "src/tools/learn.ts",
+		marker: "// HANSE: learn topic evidence has no separate stamp write",
+		anchor: '\t\t} else if (backend === "local") {\n',
+		legacyPatched: '\t\t\t// HANSE: learn evidence of a topic lesson follows its newest revision\n\t\t\tif (params.topic) stampLearnTopicEvidence(target ?? state.getScopedRetainTarget(), params.topic, evidence);\n\t\t} else if (backend === "local") {\n',
+		patched: '\t\t\t// HANSE: learn topic evidence has no separate stamp write\n\t\t} else if (backend === "local") {\n',
+	},
+	{
+		file: "src/prompts/tools/learn.md",
+		marker: "`kind` is required in project scope",
+		anchor: "Capture sparingly, specifically: one strong reusable lesson > several vague ones.",
+		patched: "`kind` is required in project scope. `evidence` = a project fact, design decision, or failure cause: add `citations`, each a `path` relative to the project root plus an optional `anchor` (a `## ` heading text, a header field such as `RECORD`/`SCOPE`, or a line range), naming the file that records it. The save is rejected when a path or anchor does not exist; the check does not judge whether the file supports the lesson, so cite only what you read. Recall shows citations as places to verify, not as proof. `preference` (how the user wants work done), `procedure` (how to do a task) and `hypothesis` (unverified) need no citation.\n\nCapture sparingly, specifically: one strong reusable lesson > several vague ones.",
+	},
 	{
 		// 2026-09-27: 자동 주입 <memories> 는 세션 파일에 남지 않아, Main 단독 세션에서 어떤 교훈이 전달됐는지
 		// 셀 수 없었다(위임 attempt 만 routing_verdict appliedLessons 로 연결됨). 첫 턴 회상이 확정될 때 전달한
@@ -13954,6 +14577,20 @@ function createSubagentRunMonitor(args: RunMonitorArgs): SubagentRunMonitor {`,
 		anchor: '\t\t\t...(latest.type === "task" ? { agentUrlId: current?.agentId ?? latest.id } : {}),',
 		patched: '\t\t\t...(latest.type === "task" ? { agentUrlId: j.completion?.agentId ?? current?.agentId ?? latest.id } : {}),\n\t\t\t...(options.includeResults !== false && j.completion ? { completion: j.completion } : {}),',
 	},
+	{
+		// Codex realtime v3 목소리(위 CODEX_V3_LIVE_VOICES 주석). CUELO 앱이 읽는 소스 판.
+		file: "src/live/voices.ts",
+		marker: "\t// CUELO: Codex realtime v3 voices",
+		anchor: '\t{ value: "vale", label: "Vale" },\n] as const;',
+		patched: `\t{ value: "vale", label: "Vale" },\n\t// CUELO: Codex realtime v3 voices (gpt-live-1-codex, openai/codex RealtimeVoicesList::builtin().v3).\n${CODEX_V3_LIVE_VOICES.map(([value, label]) => `\t{ value: "${value}", label: "${label}" },\n`).join("")}] as const;`,
+	},
+	{
+		// 같은 목록의 CLI 번들(dist/cli.js, Linux `omp`) 판. 같은 config.yml 을 읽으므로 CLI 도 새 값을 거절하지 않게 한다.
+		file: "dist/cli.js",
+		marker: '{value:"haetsal",label:"Haetsal (햇살)"}',
+		anchor: '{value:"spruce",label:"Spruce"},{value:"vale",label:"Vale"}]',
+		patched: `{value:"spruce",label:"Spruce"},{value:"vale",label:"Vale"}${CODEX_V3_LIVE_VOICES.map(([value, label]) => `,{value:"${value}",label:"${label}"}`).join("")}]`,
+	},
 ];
 // EDITS 문자열의 줄 끝을 LF로 통일한다. 이 파일의 작업 사본이 CRLF여도 core 파일(LF)과
 // 비교·치환이 어긋나지 않는다. core 파일 자체의 줄 끝은 건드리지 않는다.
@@ -14317,6 +14954,216 @@ interface ComputerElementRef
 		patched: swap(agentOptional.patched, ...options),
 	}];
 }
+// 2026-10-17 18.11.3 이식(공개 이슈 #31·#33 포함). 18.11.1 후보는 한 바이트도 바꾸지 않고, 18.11.3 순정에서 앵커를 잃은 항목마다
+// 그 판에만 성립하는 후보를 더한다. marker 를 공유하는 후보는 18.11.3 에만 있는 문자열로 requires(새 후보)·excludes(옛 후보)를
+// 짝지어 서로 배타적으로 둔다.
+//  - ADAPT: IRC steer bracket(in-flight epoch), wake-turn 판정·완료 기록(publishMessageResult·messageResult), Vercel judge
+//    (#31: #withCandidate 의 셋째 인자가 images 배열), task schema 의 seance 필드, recall 의 tool 가중(env 로 바뀜).
+//  - RETIRE: upstream 이 seance 와 함께 넣은 task model 타입·전달 줄(같은 줄을 두 번 넣지 않는다. 특히 TaskItem·TaskParams 의
+//    `model?: string` 은 upstream 의 `string | string[]` 과 겹쳐 TS2717 이 된다), 번들의 advisor transcript filter 새 이름.
+{
+	const one = (predicate, label) => {
+		const found = EDITS.filter(predicate);
+		if (found.length !== 1) throw new Error(`18.11.3 후보를 만들 수 없다: ${label} ${found.length}/1`);
+		return found[0];
+	};
+	const swap = (text, from, to) => {
+		const found = text.split(from).length - 1;
+		if (found !== 1) throw new Error(`18.11.3 후보를 만들 수 없다: ${JSON.stringify(from.slice(0, 80))} ${found}/1`);
+		return text.replace(from, () => to);
+	};
+	const noop = (file, text, extra = {}) => ({ file, marker: text, anchor: text, patched: text, ...extra });
+
+	// IRC steer continuation bracket: #beginInFlight 가 epoch 를 돌려주고 #endInFlight(epoch, onSettled) 가 abort 뒤(#resetInFlight 가
+	// epoch 를 올린 뒤) 늦게 온 settle 콜백을 버린다. 18.11.1 에서는 그 늦은 콜백이 flush 되어 관찰자가 닫혔으므로, epoch 가
+	// 지났으면 관찰자를 직접 닫아 부모가 받을 답 하나를 그대로 지킨다.
+	const EPOCH_18113 = "#endInFlight(epoch: number";
+	const steerOpen = one(entry => entry.marker === "const steerObservation = this.#beginIrcSteerContinuationObservation()", "steer bracket open");
+	const steerOpenTurnEnded = steerOpen.alternates.find(candidate => candidate.requires === "turnEnded: boolean;");
+	steerOpenTurnEnded.excludes = EPOCH_18113;
+	const epochBegin = ["\t\t\t\tthis.#beginInFlight();\n", "\t\t\t\tconst inFlightEpoch = this.#beginInFlight();\n"];
+	steerOpen.alternates.push({
+		file: steerOpen.file,
+		requires: EPOCH_18113,
+		marker: steerOpen.marker,
+		anchor: swap(steerOpenTurnEnded.anchor, ...epochBegin),
+		patched: swap(steerOpenTurnEnded.patched, ...epochBegin),
+	});
+	const steerClose = one(entry => entry.marker === "IRC steer continuation observer failed to finish", "steer bracket close");
+	steerClose.excludes = EPOCH_18113;
+	(steerClose.alternates ??= []).push({
+		file: steerClose.file,
+		requires: EPOCH_18113,
+		marker: steerClose.marker,
+		anchor: swap(steerClose.anchor, "this.#endInFlight();", "this.#endInFlight(inFlightEpoch);"),
+		patched: `					this.#usagePreflightReadyForNextModelCall = false;
+					const finishSteerObservation = steerObservation?.finish
+						? async () => {
+								this.#ircTurnBracketOpen = false;
+								try {
+									await steerObservation.finish?.(
+										steerObservationError,
+										undefined,
+										this.#takeAdoptedParentSteerRecords(),
+									);
+								} catch (error) {
+									logger.warn("IRC steer continuation observer failed to finish", {
+										error: String(error),
+									});
+								}
+							}
+						: undefined;
+					// An abort (#resetInFlight) already released this bracket and #endInFlight drops a stale settle
+					// callback, yet the steering parent is still owed its one answer: close the observer here then.
+					if (finishSteerObservation && inFlightEpoch !== this.#inFlightEpoch) void finishSteerObservation();
+					else this.#endInFlight(inFlightEpoch, finishSteerObservation);
+				}
+			},
+			{
+				delayMs: options.delayMs,`,
+	});
+
+	// Wake turn: upstream 이 owner 판정을 ownerWoken 변수로 빼고(publishMessageResult 에도 쓴다), 완료 인자에 publishMessageResult·
+	// signal 을, 결과 분기에 messageResult 를 더했다. CUELO 의 runningTurn 예외는 wake job 선등록에만 걸고, ircWakeTurn 표시와
+	// 완료 기록은 같은 자리에 그대로 둔다.
+	const wakeRegister = one(entry => entry.marker.startsWith("if (bracket?.runningTurn !== true && wakeSources(records, id)"), "wake register");
+	const ownerWoken = "\t\tconst ownerWoken = wakeSources(records, id).some(source => source.from === ownerId);\n";
+	wakeRegister.alternates.push({
+		file: wakeRegister.file,
+		marker: "if (bracket?.runningTurn !== true && ownerWoken) {",
+		anchor: `${ownerWoken}\t\tif (ownerWoken) registerWakeJob();`,
+		patched: `${ownerWoken}\t\t// A bracket opened over a turn that was already running (a parent steer
+		// adopted mid-turn) is not parent-woken work: that turn may leave the steer
+		// queued, and the continuation that consumes it owns the answer. Keep the
+		// yield-time registration for it so a stranded turn stays silent.
+		if (bracket?.runningTurn !== true && ownerWoken) {
+			registerWakeJob();
+		}`,
+	});
+	const PUBLISH_FIELD_18113 = "publishMessageResult?: boolean;";
+	const wakeField = one(entry => entry.marker === "ircWakeTurn?: boolean;", "ircWakeTurn field");
+	const publishField = ["\tfollowUpTurn?: boolean;\n", `\tfollowUpTurn?: boolean;\n\t${PUBLISH_FIELD_18113}\n`];
+	wakeField.excludes = PUBLISH_FIELD_18113;
+	(wakeField.alternates ??= []).push({
+		file: wakeField.file,
+		requires: PUBLISH_FIELD_18113,
+		marker: wakeField.marker,
+		anchor: swap(wakeField.anchor, ...publishField),
+		patched: swap(wakeField.patched, ...publishField),
+	});
+	const PUBLISH_ARG_18113 = "\t\t\t\t\tpublishMessageResult: ownerWoken || userPrompted,";
+	const wakeArg = one(entry => entry.marker === "\t\t\t\t\tircWakeTurn: true,", "ircWakeTurn argument");
+	wakeArg.excludes = PUBLISH_ARG_18113;
+	(wakeArg.alternates ??= []).push({
+		file: wakeArg.file,
+		requires: PUBLISH_ARG_18113,
+		marker: wakeArg.marker,
+		anchor: `\t\t\t\t\tfollowUpTurn: true,\n${PUBLISH_ARG_18113}`,
+		patched: `\t\t\t\t\tfollowUpTurn: true,\n\t\t\t\t\tircWakeTurn: true,\n${PUBLISH_ARG_18113}`,
+	});
+	const MESSAGE_RESULT_18113 = "if (wakeJob && (yielded || messageResult) && result) {";
+	const completion = one(entry => entry.marker === "\t\t\t\t\tconst completionJob = session.asyncJobManager?.getJob(wakeJob.jobId);", "wake completion record");
+	const resultBranch = ["if (wakeJob && yielded && result) {", MESSAGE_RESULT_18113];
+	completion.excludes = MESSAGE_RESULT_18113;
+	(completion.alternates ??= []).push({
+		file: completion.file,
+		requires: MESSAGE_RESULT_18113,
+		marker: completion.marker,
+		anchor: swap(completion.anchor, ...resultBranch),
+		patched: swap(completion.patched, ...resultBranch),
+	});
+
+	// #31 Vercel judge: 18.11.2 부터 #withCandidate 의 셋째 인자가 images 배열이고 첫 줄에서 requiresImages 를 계산하며 후보는
+	// #resolveCandidates(images) 로 고른다. upstream 세 줄은 그대로 두고 명시 Vercel 분기를 requiresImages 계산 바로 뒤에 둔다.
+	// 고정 평가 요청은 이미지를 싣지 않으므로 이미지 요청은 명시적으로 거절하고, 텍스트 요청은 한 번만 보내 usage 를 한 번 남기며
+	// chat/local 후보로 넘어가지 않는다(18.11.1 후보와 같은 본문).
+	const IMAGES_18112 = "const requiresImages = images.length > 0;";
+	const vercel = one(entry => entry.file === "src/judgment/index.ts" && entry.marker.startsWith("VERCEL_JUDGMENT_PROVIDER) {\n\t\t\tconst vercel = new VercelJudge("), "Vercel judge");
+	const vercelPrivate = vercel.alternates.find(candidate => candidate.requires === "\tasync #withCandidate<T>(");
+	const imagesArg = ["\t\trequiresImages: boolean,\n\t): Promise<T> {\n", `\t\timages: readonly ImageContent[],\n\t): Promise<T> {\n\t\t${IMAGES_18112}\n`];
+	vercelPrivate.excludes = IMAGES_18112;
+	vercel.alternates.push({
+		file: vercel.file,
+		requires: IMAGES_18112,
+		marker: vercelPrivate.marker,
+		anchor: swap(vercelPrivate.anchor, ...imagesArg),
+		patched: swap(vercelPrivate.patched, ...imagesArg),
+	});
+
+	// recall 가중: upstream 이 상수표를 env 로 읽는 resolveTrustWeights 로 바꿨다(MNEMOPI_TOOL_WEIGHT, 기본 0.5). learn/retain 의
+	// 의도적 기록 가중 1.0 은 기본값으로만 지키고, 사용자가 env 로 정한 값은 그대로 따른다.
+	const TRUST_18113 = "function resolveTrustWeights(";
+	const recallWeight = one(entry => entry.marker === "// HANSE: deliberate learn/retain weight", "recall tool weight");
+	recallWeight.excludes = TRUST_18113;
+	(recallWeight.alternates ??= []).push({
+		file: recallWeight.file,
+		requires: TRUST_18113,
+		marker: recallWeight.marker,
+		anchor: "\t\t\ttool: Math.max(0, toolWeight()),\n",
+		patched: '\t\t\t// HANSE: deliberate learn/retain weight (default 1.0; MNEMOPI_TOOL_WEIGHT still overrides)\n\t\t\ttool: Math.max(0, toolWeight({ MNEMOPI_TOOL_WEIGHT: "1.0", ...process.env })),\n',
+	});
+
+	// task schema: 동적 schema 가 ...seanceFields 를 펼치고 createTaskSchema 앞에 SeanceTaskSchemaFields 타입이 생겼다. batch 항목의
+	// `model?` 추가와 agent optional 정리는 같은 의미로 새 모양에 둔다. seance 가 노출되면 upstream 의 seance 필드가 뒤에서
+	// `model?` 을 string | string[] 로 덮는다(Maker 는 아래 validator 와 maker-routing 이 문자열 하나만 받는다).
+	const SEANCE_FIELDS_18113 = "const seanceFields = options.seanceFields;";
+	for (const indent of ["\t\t\t\t", "\t\t\t"]) {
+		const entry = one(candidate => candidate.file === "src/task/types.ts" && candidate.marker.startsWith(`"model?": "string",\n${indent}...effortField,\n${indent}"outputSchema?"`), `task schema ${indent.length}`);
+		const structured = entry.alternates.find(candidate => candidate.requires === "const schemaFields = options.structured");
+		const spread = [`${indent}...toolsField,\n`, `${indent}...toolsField,\n${indent}...seanceFields,\n`];
+		structured.excludes = SEANCE_FIELDS_18113;
+		entry.alternates.push({
+			file: entry.file,
+			requires: SEANCE_FIELDS_18113,
+			marker: swap(structured.marker, ...spread),
+			anchor: swap(structured.anchor, ...spread),
+			patched: swap(structured.patched, ...spread),
+		});
+	}
+	const agentOptional = one(candidate => candidate.marker === "// CUELO: task schema agent is optional on the wire.", "agent optional");
+	const agentOptionalStructured = agentOptional.alternates.find(candidate => candidate.requires === "const schemaFields = options.structured");
+	const seanceType = 'type SeanceTaskSchemaFields = {\n\t"sourceSession?"?: FluentType<string>;\n\t"model?"?: FluentType<string | string[]>;\n};\n\n';
+	const seanceOption = ["\tstructured: boolean;\n}): BaseType {", "\tstructured: boolean;\n\tseanceFields: SeanceTaskSchemaFields;\n}): BaseType {"];
+	agentOptionalStructured.excludes = SEANCE_FIELDS_18113;
+	agentOptional.alternates.push({
+		file: agentOptional.file,
+		requires: SEANCE_FIELDS_18113,
+		marker: agentOptional.marker,
+		anchor: swap(swap(agentOptionalStructured.anchor, "}\n\nfunction createTaskSchema(", `}\n\n${seanceType}function createTaskSchema(`), ...seanceOption),
+		patched: swap(swap(agentOptionalStructured.patched, "BaseType>();\n\nfunction createTaskSchema(", `BaseType>();\n\n${seanceType}function createTaskSchema(`), ...seanceOption),
+	});
+
+	// RETIRE: 18.11.3 upstream 의 TaskItem·TaskParams `model?: string | string[]`, 단일 형 item 과 spawn 의 model 복사,
+	// preflight·실행 요청의 `model: params.model` 은 CUELO 가 넣던 줄과 같은 일을 한다. 그 판에서는 upstream 줄을 no-op 후보로 둔다.
+	const SEANCE_TYPES_18113 = "\t/** Historical source session selected by the bundled consult agent. */\n\tsourceSession?: string;\n\t/** Optional model selector override for the historical source session. */\n\tmodel?: string | string[];";
+	for (const [marker, agentLine] of [
+		["Standard model selector for this spawn (item)", "\t/** Agent type to run this item (e.g. \"scout\"). Defaults to the spawn policy's default agent. */\n\tagent?: string;\n"],
+		["Standard model selector for this spawn (flat form)", "\t/** Agent type to spawn (flat form); omitted values resolve from the session spawn policy. */\n\tagent?: string;\n"],
+	]) {
+		const entry = one(candidate => candidate.marker === marker, marker);
+		entry.excludes = SEANCE_TYPES_18113;
+		entry.alternates.push(noop(entry.file, agentLine + SEANCE_TYPES_18113, { requires: SEANCE_TYPES_18113 }));
+	}
+	const itemSource = 'if ("sourceSession" in params) item.sourceSession = params.sourceSession;';
+	const flatItem = one(candidate => candidate.file === "src/task/index.ts" && candidate.marker.startsWith("\tconst item: TaskItem = {"), "flat item model");
+	flatItem.excludes = itemSource;
+	flatItem.alternates.push(noop(flatItem.file, `\t${itemSource}\n\tif ("model" in params) item.model = params.model;`, { requires: itemSource }));
+	const spawnSource = 'if ("sourceSession" in item) spawn.sourceSession = item.sourceSession;';
+	const spawnModel = one(candidate => candidate.file === "src/task/index.ts" && candidate.marker.startsWith("\tconst spawn: TaskParams = {"), "spawn model");
+	spawnModel.excludes = spawnSource;
+	spawnModel.alternates.push(noop(spawnModel.file, `\t${spawnSource}\n\tif ("model" in item) spawn.model = item.model;`, { requires: spawnSource }));
+	for (const [next, indent] of [['...("is', "\t\t\t"], ["...(params.tools", "\t\t\t\t"]]) {
+		const entry = one(candidate => candidate.file === "src/task/index.ts" && candidate.marker.startsWith(`...(params.model !== undefined ? { model: params.model } : {}),\n${indent}${next}`), `request model ${indent.length}`);
+		const forwarded = `\n${indent}sourceSession: params.sourceSession,\n${indent}model: params.model,\n`;
+		entry.excludes = [entry.excludes, forwarded];
+		entry.alternates.push(noop(entry.file, forwarded, { requires: forwarded }));
+	}
+
+	// RETIRE(17번째): 번들의 advisor transcript filter 이름이 b_e → X_e 로 바뀌었다(본문 같음:
+	// e===J_e||e.startsWith(`${Y_e}.`)&&e.endsWith(cue), Y_e="__advisor", cue=".jsonl").
+	const advisorFilter = one(candidate => candidate.file === "dist/cli.js" && candidate.marker.startsWith('if(!o.endsWith(".jsonl")||o.includes(".bak")||o==="__advisor.jsonl"'), "advisor filter");
+	advisorFilter.alternates.push(noop(advisorFilter.file, 'if(!a.endsWith(".jsonl")||a.includes(".bak")||X_e(a))continue;let l=a.slice(0,-6),'));
+}
 // 18.9.1 MCPManager 는 deferred 전역 로더에 `static #deferred` 를 새로 둔다. JS 는 같은 class 안에서 static 과 instance
 // private 이름을 겹쳐 둘 수 없어("#deferred" has already been declared) 모듈 적재가 실패한다. 요청별 MCP 선택이 쓰는
 // instance 표(나중에 띄울 서버)의 이름만 #deferredServers 로 바꾼 18.9.1 후보를 만든다. 의미·위치는 같다(ADAPT).
@@ -14380,6 +15227,8 @@ for (const update of EDITS.splice(watchFollowupStart, watchFollowupEnd - watchFo
  * 새 판의 순정이 국소 문맥까지 바이트가 같을 때만 쓴다(18.5.0 task/index.ts 의 model 전달: upstream 이 우리
  * 패치와 같은 줄을 넣어 marker 만으로는 "옛 판 적용본"과 "새 판 순정"을 가를 수 없고, 잘못 가르면 --revert 가
  * upstream 줄을 지운다). 조건은 marker·anchor 판별 전에 적용하고, 남은 후보 수 규칙은 그대로다.
+ * `excludes` 는 문자열 하나 또는 목록이며, 목록이면 그중 하나라도 있으면 후보가 아니다(18.11.3: 18.5.0 과 18.11.3 이
+ * 같은 model 전달 줄을 서로 다른 모양으로 upstream 에 넣었다).
  */
 function resolveEdit(entry, target) {
 	const candidates = [entry, ...(entry.alternates ?? [])];
@@ -14389,7 +15238,7 @@ function resolveEdit(entry, target) {
 		.map(candidate => {
 			const text = readFileSync(join(target, candidate.file), "utf8");
 			if (candidate.requires !== undefined && !text.includes(candidate.requires)) return undefined;
-			if (candidate.excludes !== undefined && text.includes(candidate.excludes)) return undefined;
+			if (candidate.excludes !== undefined && [candidate.excludes].flat().some(excluded => text.includes(excluded))) return undefined;
 			if (candidate.legacyPatched && text.includes(candidate.legacyPatched)) return { ...candidate, path: join(target, candidate.file), text, status: "legacy" };
 			if (text.includes(candidate.marker)) return { ...candidate, path: join(target, candidate.file), text, status: "applied" };
 			if (text.includes(candidate.anchor)) return { ...candidate, path: join(target, candidate.file), text, status: "appliable" };