cuelo 0.9.4 → 0.9.6

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

@@ -85,6 +85,131 @@ const OPUS55_ROW_18410 = {
  */
 const OPUS55_ROW_1851 = OPUS55_ROW_1846.patched.replace('"tps":95.2,', '"tps":93,');
 
+/**
+ * learn topic upsert 적용본. 갱신 때 metadata 의 session_id/cwd 는 최초 저장자로 남고,
+ * updated_session_id/updated_cwd/updated_at 이 최신 정정자·시점이며 context 는 최신 이유다.
+ * first_context/first_timestamp 는 기존 revision 이 명시적으로 1 일 때만 갱신 직전 값으로 보존한다
+ * (revision 없음/2+ 는 최초 이유·시점을 알 수 없으므로 지어내지 않는다). `$` 중괄호와 백틱은 쓰지 않는다.
+ */
+const learnTopicUpsertBlock = `// HANSE: topic-key learn upsert
+function upsertLearnTopic(
+	state: MnemopiSessionState,
+	params: LearnParams,
+	target: ReturnType<MnemopiSessionState["getScopedRetainTarget"]>,
+): { 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;
+	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);
+		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 };
+		db.query("UPDATE working_memory SET content = ?, embed_text = NULL, timestamp = ?, metadata_json = ? WHERE id = ?").run(
+			content, now,
+			JSON.stringify({ ...firstSeen, ...stored, context: params.context == null ? null : redactMemorySecrets(params.context), topic_key: topic, revision, ...latest }),
+			existing.id,
+		);
+		db.query("DELETE FROM memory_embeddings WHERE memory_id = ?").run(existing.id);
+		return { id: existing.id, revision };
+	})();
+	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 },
+		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
+type RecallProvenance = { scope?: string; revision: number; first?: string; corrected?: 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);
+	return {
+		scope,
+		revision: Number.isInteger(revision) ? revision : 0,
+		first: day(meta?.first_timestamp),
+		corrected: day(meta?.updated_at),
+	};
+}
+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);
+	}
+	return parts.length > 0 ? " {" + parts.join("; ") + "}" : "";
+}
+function recallRevisionFooter(results: readonly RecallResult[]): string {
+	return results.some(result => recallProvenance(result).revision > 1)
+		? "\n\nCorrected rows: read memory://<id> for the full metadata and correction reason."
+		: "";
+}
+
+`;
+
+/** 출처 구분 이전 learn topic upsert 적용본. 새 판(learnTopicUpsertBlock)이 이 본문을 대체한다(legacyPatched). */
+const learnTopicUpsertLegacyBlock = `// HANSE: topic-key learn upsert
+function upsertLearnTopic(
+	state: MnemopiSessionState,
+	params: LearnParams,
+	target: ReturnType<MnemopiSessionState["getScopedRetainTarget"]>,
+): { 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, 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;
+	const revision = existing ? (Number(JSON.parse(existing.metadata_json).revision) || 1) + 1 : 1;
+	if (existing) return db.transaction(() => {
+		const content = redactMemorySecrets(params.memory);
+		db.query("UPDATE working_memory SET content = ?, embed_text = NULL, timestamp = ?, metadata_json = ? WHERE id = ?").run(
+			content, new Date().toISOString(),
+			JSON.stringify({ ...JSON.parse(existing.metadata_json), context: params.context == null ? null : redactMemorySecrets(params.context), topic_key: topic, revision }),
+			existing.id,
+		);
+		db.query("DELETE FROM memory_embeddings WHERE memory_id = ?").run(existing.id);
+		return { id: existing.id, revision };
+	})();
+	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 },
+		scope: "bank", extract: true, extractEntities: true, veracity: "tool", memoryType: "fact",
+	}, target);
+	return { id, revision };
+}
+
+export class LearnTool implements AgentTool<LearnSchema> {`;
+
 /**
  * 기억 임베딩 (6) 항목의 본문. 0.9.3 은 recall 이 e5 여부로 dense 하한을 고르게 `usesE5Prefix` 를 export 한다.
  * 0.9.2 적용본(export 없음)은 legacyPatched 로 남겨 같은 항목이 새 판으로 바꾼다.
@@ -116,6 +241,109 @@ export function currentEmbeddingModel(): string {
 }
 `;
 
+/**
+ * task schema 정적 네 곳(item·isolated item·단일 flat·단일 no-isolation)의 per-spawn `model?` 전달과 optional `agent`.
+ * 18.3.4는 모든 schema에 필수 `solutionSpace: "string"` 을 `task` 바로 뒤에 넣었고 `model?` 은 그 뒤에 둔다.
+ *
+ * `agent: "string = 'task'"` 기본값은 pi-ai validateToolArguments가 extension tool_call 앞에서 채워, hook에는 생략한 호출과
+ * 명시한 `task`가 구별되지 않았다. 생략을 undefined로 두면 CUELO guard가 생략만 maker로 해석하고 명시 `task`·scout 등은 계속
+ * 거절할 수 있다. core executor는 생략을 이미 처리한다(task/index.ts spawnParamsFor `item.agent?.trim() || defaultAgent`,
+ * `spawn.agent ?? defaultAgent`)이므로 다른 프로필의 기본 agent 의미는 그대로다.
+ *
+ * 두 변경은 같은 줄 묶음에 있으므로 한 항목이 함께 만든다. 각 항목의 marker는 자기 schema header를 포함해 다른 schema의 줄이
+ * 이 항목을 이미 적용한 것으로 보이게 하지 않고, 빠진 model 줄은 그 schema에서만 복구된다. 후보는
+ *  - 기본 후보: model이 없는 순정(18.4 이하)에서 model과 optional agent를 함께 넣는다. 옛 패치가 이미 model을 넣은
+ *    기본-agent 상태는 `legacyPatched` 로 optional agent만 얹는다.
+ *  - alternates: model을 가진 18.5+ upstream(`string | string[]`)에 optional agent만 얹는다.
+ * 한 항목이 변환 전체를 가지므로 `--revert` 는 patched를 anchor로 되돌려 순정을 그대로 복원한다.
+ */
+const TASK_SCHEMA_MODEL_EDITS = [
+	"export const taskItemSchema = type({",
+	"const taskItemSchemaIsolated = type({",
+	"export const taskSchema = type({",
+	"const taskSchemaNoIsolation = type({",
+].map(header => {
+	const body = (agent, model) =>
+		[header, '\t"name?": "string",', `\t${agent}`, '\ttask: "string",', '\tsolutionSpace: "string",', ...(model ? [`\t${model}`] : [])].join("\n");
+	const DEFAULT_AGENT = "agent: \"string = 'task'\",";
+	const OPTIONAL_AGENT = '"agent?": "string",';
+	const SINGLE = '"model?": "string",';
+	const SINGLE_OR_ARRAY = '"model?": "string | string[]",';
+	const output = '\n\t"outputSchema?": outputSchemaInputSchema,';
+	return {
+		file: "src/task/types.ts",
+		marker: body(OPTIONAL_AGENT, SINGLE),
+		anchor: body(DEFAULT_AGENT) + output,
+		patched: body(OPTIONAL_AGENT, SINGLE) + output,
+		legacyPatched: body(DEFAULT_AGENT, SINGLE) + output,
+		alternates: [{
+			file: "src/task/types.ts",
+			marker: body(OPTIONAL_AGENT, SINGLE_OR_ARRAY),
+			anchor: body(DEFAULT_AGENT, SINGLE_OR_ARRAY),
+			patched: body(OPTIONAL_AGENT, SINGLE_OR_ARRAY),
+		}],
+	};
+});
+
+/**
+ * 위 정적 schema와 같은 이유로 defaultAgent 동적 schema(createTaskSchema)의 agent도 optional로 둔다.
+ * 동적 model 항목의 앵커가 `agent,` 를 포함하므로 반드시 그 뒤에 적용한다.
+ */
+const TASK_AGENT_OPTIONAL_EDITS = [
+	...[
+		["\t\t\tconst item = type.raw({", "\t\t\t\t"],
+		["\t\tconst item = type.raw({", "\t\t\t"],
+		["\t\treturn type.raw({", "\t\t\t"],
+		["\treturn type.raw({", "\t\t"],
+	].map(([header, indent]) => ({
+		file: "src/task/types.ts",
+		marker: `${header}\n${indent}"name?": "string",\n${indent}"agent?": "string",`,
+		anchor: `${header}\n${indent}"name?": "string",\n${indent}agent,`,
+		patched: `${header}\n${indent}"name?": "string",\n${indent}"agent?": "string",`,
+	})),
+	{
+		// 위 여덟 곳이 더는 쓰지 않는 기본 agent 규칙 helper와 그 정규식·지역 변수를 함께 지운다.
+		file: "src/task/types.ts",
+		marker: "// CUELO: task schema agent is optional on the wire.",
+		anchor: [
+			"const TASK_AGENT_NAME_PATTERN = /^[A-Za-z0-9_-]+$/;",
+			"const taskSchemaCache = new Map<string, BaseType>();",
+			"",
+			"function taskAgentSchemaRule(defaultAgent: string): string {",
+			"\tconst trimmed = defaultAgent.trim();",
+			"\tif (TASK_AGENT_NAME_PATTERN.test(trimmed)) {",
+			"\t\treturn `string = '${trimmed}'`;",
+			"\t}",
+			"\treturn \"string\";",
+			"}",
+			"",
+			"function createTaskSchema(options: {",
+			"\tisolationEnabled: boolean;",
+			"\tbatchEnabled: boolean;",
+			"\tdefaultAgent: string;",
+			"\teffortEnabled: boolean;",
+			"\tevalToolsEnabled: boolean;",
+			"}): BaseType {",
+			"\tconst agent = taskAgentSchemaRule(options.defaultAgent);",
+			"",
+		].join("\n"),
+		patched: [
+			"// CUELO: task schema agent is optional on the wire. An omitted agent reaches extension hooks as undefined and",
+			"// the executor resolves it to the spawn policy's defaultAgent.",
+			"const taskSchemaCache = new Map<string, BaseType>();",
+			"",
+			"function createTaskSchema(options: {",
+			"\tisolationEnabled: boolean;",
+			"\tbatchEnabled: boolean;",
+			"\tdefaultAgent: string;",
+			"\teffortEnabled: boolean;",
+			"\tevalToolsEnabled: boolean;",
+			"}): BaseType {",
+			"",
+		].join("\n"),
+	},
+];
+
 /** 각 항목: 원본 앵커를 찾아 patched 로 바꾼다. marker 가 있으면 이미 적용된 것으로 본다. */
 const EDITS = [
 	{
@@ -2535,165 +2763,7 @@ function evalRejectionResult(error: unknown): AgentToolResult<EvalToolDetails |
 			patched: "\t/** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */\n\teffort?: \"lo\" | \"med\" | \"hi\";\n\t/** Per-spawn model selector or ordered selector array; overrides agent and settings preferences. */\n\tmodel?: string | string[];",
 		}],
 	},
-	{
-		// 18.3.4는 모든 task schema에 필수 `solutionSpace: "string"` 을 `task` 바로 뒤에 넣었다
-		// (types.ts:52-185). per-spawn `model?` 은 그 필수 필드 뒤에 둔다. 의미는 18.3.2와 같다.
-		file: "src/task/types.ts",
-		marker: `task: "string",
-	solutionSpace: "string",
-	"model?": "string",`,
-		anchor: `export const taskItemSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"outputSchema?": outputSchemaInputSchema,
-	"schemaMode?": '"permissive" | "strict"',
-	"tools?": "string[]",
-	"+": "delete",
-});
-const taskItemSchemaIsolated = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"outputSchema?": outputSchemaInputSchema,
-	"schemaMode?": '"permissive" | "strict"',
-	"tools?": "string[]",
-	"isolated?": "boolean",
-	"+": "delete",
-});`,
-		patched: `export const taskItemSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string",
-	"outputSchema?": outputSchemaInputSchema,
-	"schemaMode?": '"permissive" | "strict"',
-	"tools?": "string[]",
-	"+": "delete",
-});
-const taskItemSchemaIsolated = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string",
-	"outputSchema?": outputSchemaInputSchema,
-	"schemaMode?": '"permissive" | "strict"',
-	"tools?": "string[]",
-	"isolated?": "boolean",
-	"+": "delete",
-});`,
-		alternates: [{
-			file: "src/task/types.ts",
-			marker: `export const taskItemSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-			anchor: `export const taskItemSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-			patched: `export const taskItemSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-		}],
-	},
-	{
-		file: "src/task/types.ts",
-		marker: `export const taskSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string",`,
-		anchor: `export const taskSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"outputSchema?": outputSchemaInputSchema,`,
-		patched: `export const taskSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string",
-	"outputSchema?": outputSchemaInputSchema,`,
-		alternates: [{
-			file: "src/task/types.ts",
-			marker: `export const taskSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-			anchor: `export const taskSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-			patched: `export const taskSchema = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-		}],
-	},
-	{
-		file: "src/task/types.ts",
-		marker: `const taskSchemaNoIsolation = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string",`,
-		anchor: `const taskSchemaNoIsolation = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"outputSchema?": outputSchemaInputSchema,`,
-		patched: `const taskSchemaNoIsolation = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string",
-	"outputSchema?": outputSchemaInputSchema,`,
-		alternates: [{
-			file: "src/task/types.ts",
-			marker: `const taskSchemaNoIsolation = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-			anchor: `const taskSchemaNoIsolation = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-			patched: `const taskSchemaNoIsolation = type({
-	"name?": "string",
-	agent: "string = 'task'",
-	task: "string",
-	solutionSpace: "string",
-	"model?": "string | string[]",`,
-		}],
-	},
+	...TASK_SCHEMA_MODEL_EDITS,
 	{
 		file: "src/task/types.ts",
 		marker: `"model?": "string",
@@ -3152,6 +3222,45 @@ import { isUnexpectedSocketCloseMessage } from "@oh-my-pi/pi-utils/fetch-retry";
 						// Other roots retain their timers and revivers. Release while shared
 						// resources are still live; subagent disposal does not tear down roots.`,
 	},
+	{
+		// 2026-10-05: 재시작 뒤 복원된 child 의 부모는 top-level 별칭(`Main#3` 등)일 수 있다. 부활 factory 는 parentId 가 literal
+		// `Main` 에 닿을 때까지의 단계 수로 taskDepth 를 정해 `Main#3` 직속 child 의 depth 가 하나 늘었다. top-level(kind main)
+		// 에서도 멈추게 해 registry 의 실제 parent 를 그대로 쓴다. literal `Main`·없는 ref·깊은 child 의 기존 동작은 같다.
+		file: "src/task/persisted-revive.ts",
+		marker: "export function revivedTaskDepth(",
+		anchor: `/**
+ * Build the factory the {@link AgentLifecycleManager} uses to cold-revive a`,
+		patched: `/** HANSE: depth of a cold-revived subagent from its persisted parent chain; a top-level (\`main\`) parent ends the climb. */
+export function revivedTaskDepth(ref: { parentId?: string }, registry: AgentRegistry): number {
+	let taskDepth = 1;
+	let parentId = ref.parentId;
+	const seen = new Set<string>();
+	while (parentId && parentId !== MAIN_AGENT_ID && registry.get(parentId)?.kind !== "main" && !seen.has(parentId)) {
+		seen.add(parentId);
+		taskDepth++;
+		parentId = registry.get(parentId)?.parentId;
+	}
+	return taskDepth;
+}
+
+/**
+ * Build the factory the {@link AgentLifecycleManager} uses to cold-revive a`,
+	},
+	{
+		file: "src/task/persisted-revive.ts",
+		marker: "const taskDepth = revivedTaskDepth(ref, registry);",
+		anchor: `		let taskDepth = 1;
+		let parentId = ref.parentId;
+		const seen = new Set<string>();
+		while (parentId && parentId !== MAIN_AGENT_ID && !seen.has(parentId)) {
+			seen.add(parentId);
+			taskDepth++;
+			parentId = registry.get(parentId)?.parentId;
+		}
+`,
+		patched: `		const taskDepth = revivedTaskDepth(ref, registry);
+`,
+	},
 	// 18.3.0 RETIRE: `hub wait` 의 생략 ids 미소비 결과 포함·정산 결과 우선(옛 #115·#116).
 	// upstream `wait` 가 `undeliveredJobs` 로 같은 일을 실행 중 job 유무와 무관하게 먼저 한다
 	// (tools/wait.ts:78-81, async/job-control.ts:44-58). 차이는 isDeliverySuppressed 인
@@ -5739,7 +5848,35 @@ function operationFromNative(op: string): Operation | undefined {
 		file: "src/mnemopi/state.ts",
 		marker: "// HANSE: recall line carries memory id",
 		anchor: "\t\treturn `- ${content}${source}${date}`;\n",
-		patched: "\t\t// HANSE: recall line carries memory id\n\t\tconst memoryId = result.id ? ` (id: ${result.id})` : \"\";\n\t\treturn `- ${content}${source}${date}${memoryId}`;\n",
+		patched: "\t\t// HANSE: recall line carries memory id\n\t\tconst memoryId = result.id ? ` (id: ${result.id})` : \"\";\n\t\treturn `- ${content}${source}${date}${recallProvenanceNote(result)}${memoryId}`;\n",
+		legacyPatched: "\t\t// HANSE: recall line carries memory id\n\t\tconst memoryId = result.id ? ` (id: ${result.id})` : \"\";\n\t\treturn `- ${content}${source}${date}${memoryId}`;\n",
+	},
+	{
+		// 위 항목의 짝. 범위·정정 표시 보조 함수와 정정 행이 있을 때만 붙는 한 줄 안내(상세는 memory://<id>).
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: recall provenance note",
+		anchor: "function formatRecallBlock(results: RecallResult[]): string {\n",
+		patched: recallProvenanceBlock + "function formatRecallBlock(results: RecallResult[]): string {\n",
+	},
+	{
+		file: "src/mnemopi/state.ts",
+		marker: "${lines.join(\"\\n\\n\")}${recallRevisionFooter(results)}\\n</memories>",
+		anchor: "${lines.join(\"\\n\\n\")}\\n</memories>`;\n",
+		patched: "${lines.join(\"\\n\\n\")}${recallRevisionFooter(results)}\\n</memories>`;\n",
+	},
+	{
+		// recall 도구 출력도 같은 표시를 쓴다.
+		file: "src/mnemopi/state.ts",
+		marker: "${source}${date}${recallProvenanceNote(result)}${confidence}",
+		anchor: "\t\t\treturn `- ${result.content}${id}${source}${date}${confidence}`;\n\t\t});\n\t\treturn lines.join(\"\\n\\n\");\n",
+		patched: "\t\t\treturn `- ${result.content}${id}${source}${date}${recallProvenanceNote(result)}${confidence}`;\n\t\t});\n\t\treturn lines.join(\"\\n\\n\") + recallRevisionFooter(results);\n",
+	},
+	{
+		// 결과가 실제로 나온 bank 로 범위를 일시 표시한다(DB 저장 없음). 전역 bank 가 없는 구성은 추정하지 않는다.
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: recall result carries its bank scope",
+		anchor: "\t\t\t\t\tfor (const result of results) {\n\t\t\t\t\t\tmergeRecallResult(merged, byId, byContent, result);\n",
+		patched: "\t\t\t\t\tfor (const result of results) {\n\t\t\t\t\t\t// HANSE: recall result carries its bank scope\n\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\tmergeRecallResult(merged, byId, byContent, { ...result, recallScope } as RecallResult);\n",
 	},
 	{
 		file: "src/tools/learn.ts",
@@ -5760,42 +5897,12 @@ function operationFromNative(op: string): Operation | undefined {
 		patched: '\t"topic?": type("string").describe("stable topic key; later lessons with this key replace the prior project lesson"),\n\t"scope?": type("\'project\' | \'global\'").describe(',
 	},
 	{
+		// 출처 구분: 갱신해도 최초 session/cwd 는 남고 updated_* 가 최신 정정자다. legacyPatched 는 출처 구분 이전 적용본이다.
 		file: "src/tools/learn.ts",
-		marker: "// HANSE: topic-key learn upsert",
+		marker: "// HANSE: learn topic provenance keeps first and latest source",
 		anchor: "export class LearnTool implements AgentTool<LearnSchema> {",
-		patched: `// HANSE: topic-key learn upsert
-function upsertLearnTopic(
-	state: MnemopiSessionState,
-	params: LearnParams,
-	target: ReturnType<MnemopiSessionState["getScopedRetainTarget"]>,
-): { 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, 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;
-	const revision = existing ? (Number(JSON.parse(existing.metadata_json).revision) || 1) + 1 : 1;
-	if (existing) return db.transaction(() => {
-		const content = redactMemorySecrets(params.memory);
-		db.query("UPDATE working_memory SET content = ?, embed_text = NULL, timestamp = ?, metadata_json = ? WHERE id = ?").run(
-			content, new Date().toISOString(),
-			JSON.stringify({ ...JSON.parse(existing.metadata_json), context: params.context == null ? null : redactMemorySecrets(params.context), topic_key: topic, revision }),
-			existing.id,
-		);
-		db.query("DELETE FROM memory_embeddings WHERE memory_id = ?").run(existing.id);
-		return { id: existing.id, revision };
-	})();
-	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 },
-		scope: "bank", extract: true, extractEntities: true, veracity: "tool", memoryType: "fact",
-	}, target);
-	return { id, revision };
-}
-
-export class LearnTool implements AgentTool<LearnSchema> {`,
+		legacyPatched: learnTopicUpsertLegacyBlock,
+		patched: learnTopicUpsertBlock,
 	},
 	{
 		// learn 은 rememberScoped 가 돌려준 기억 id 를 버리고 "Lesson stored." 만 알렸다. 교훈을 뒤에서
@@ -9889,6 +9996,8 @@ function matchesReplacementCredential(
 		anchor: "\t\t\t\t\tconst previewBytes = firstLineExceedsLimit ? (firstLinePreview?.bytes ?? 0) : 0;\n",
 		patched: "\t\t\t\t\t// CUELO: hashline mode refuses the oversized line outright and delivers none of it, so its\n\t\t\t\t\t// notice must report 0 bytes shown, not the preview it never rendered.\n\t\t\t\t\tconst previewBytes =\n\t\t\t\t\t\tfirstLineExceedsLimit && (rawSelector || !displayMode.hashLines) ? (firstLinePreview?.bytes ?? 0) : 0;\n",
 	},
+	// agent 생략 보존: 위 per-item model 항목의 앵커가 `agent: "string = 'task'"`를 포함하므로 반드시 그 뒤에 적용한다.
+	...TASK_AGENT_OPTIONAL_EDITS,
 ];
 // EDITS 문자열의 줄 끝을 LF로 통일한다. 이 파일의 작업 사본이 CRLF여도 core 파일(LF)과
 // 비교·치환이 어긋나지 않는다. core 파일 자체의 줄 끝은 건드리지 않는다.

package/install.mjs

@@ -170,6 +170,7 @@ export const PROFILE_DEFAULTS = {
   memory: { backend: "mnemopi" },
   mnemopi: { scoping: "per-project-tagged", embeddingVariant: "multilingual", autoRetain: false },
   task: {
+    enableLsp: true,
     softRequestBudget: 400,
     maxConcurrency: 8,
     eager: "preferred",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cuelo",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "CUELO — open-source AI coding agent workspace and harness for omp (oh-my-pi)",
   "homepage": "https://github.com/gim47656-ship-it/CUELO#readme",
   "repository": {