mcp-agents-memory 0.9.32 → 0.9.34

package/README.ko.md

@@ -58,7 +58,7 @@
 | 컬럼 | 설명 |
 |---|---|
 | `user_id` | 사용자 식별 |
-| `agent_platform` | claude-code / codex / chatgpt / hermes-agent / openclaw / opencode 등 |
+| `agent_platform` | **수집·실행 경로**. 세션 캡처면 그 실행 환경(claude-code / codex-acp / hermes / grok-cli …), 버즈 게시 원문을 직접 수집한 행이면 `buzz` |
 | `agent_model` | opus-4-7 / gemini-3-pro / gpt-5.5 등 |
 | `subagent` | yes / no (1-level만 추적) |
 | `subagent_model` / `subagent_role` | sub일 때 채움. role은 free-form (lowercase normalize) |
@@ -69,8 +69,18 @@
 | `embedding` | `vector(3072)` — text-embedding-3-large |
 | `is_active` / `archived_at` | soft delete (무손실 보존) |
 | `is_pinned` | `manage_knowledge`로 강제 기억된 row, archive 면제 |
+| `venue` | **대화 공간**. `buzz:<채널>` / `buzz:dm` / `terminal`(사람과 1:1) / `slack` / `auto` / `subagent`. 알 수 없으면 NULL |
+| `device_name` | **캡처 장비** — 그 행을 적은 프로세스의 hostname(`os.hostname()`). 글을 쓴 사람의 기기가 **아니다**. 버즈 원문 수집 행은 의도적으로 NULL |
+| `external_uuid` | 중복 방지 키. 버즈 원문 수집본은 `buzz:<event id>` 접두라 **수집 경로 표식으로도 쓰인다** |
 | `created_at` / `updated_at` | |
 
+> **`venue` 와 `agent_platform` 에 둘 다 `buzz` 가 보이는 이유** — 뜻이 다른 두 칸이다.
+> 같은 버즈 채널 대화라도 **어디서 말했나**(`venue=buzz:<채널>`)와 **어느 경로로 저장됐나**가 따로다:
+> 버즈에 게시된 원문을 수집기가 직접 가져오면 `agent_platform=buzz`, 그 글을 받은 에이전트 세션
+> 로그에서 캡처되면 `agent_platform=codex-acp` 처럼 그 실행 환경이 들어간다. 그래서 한 발화가
+> 두 경로로 각각 남을 수 있고, 두 칸은 서로 대체되지 않는다.
+> ⚠️ `agent_platform=buzz` 행의 '실행 환경'은 **미상**이다 — 그 값은 실행 환경이 아니라 수집 경로다.
+
 **`user` 테이블** — Librarian이 memory에서 핵심 정보 promote
 
 | 컬럼 | 설명 |

package/build/index.js

@@ -32909,7 +32909,7 @@ function venueFromBuzzContext(message) {
   if (scope !== "thread" && scope !== "channel" && scope !== "dm") return null;
   if (scope === "dm") return "buzz:dm";
   const channel = lines.find((l) => l.startsWith("Channel: "))?.trimEnd();
-  const m = channel ? /^Channel: (.+?) \(#[0-9a-f-]{36}\)$/.exec(channel) : null;
+  const m = channel ? CHANNEL_LINE.exec(channel) : null;
   return m ? `buzz:${m[1]}` : "buzz";
 }
 function looksLikeBuzzTurn(message) {
@@ -32919,15 +32919,46 @@ function looksLikeBuzzTurn(message) {
   const close = text.indexOf(CONTEXT_CLOSE);
   return close >= 0 && TURN_OPEN.test(text.slice(close + CONTEXT_CLOSE.length));
 }
+function venueFromBuzzEvent(text) {
+  const open = EVENT_ONLY_OPEN.exec(text);
+  if (!open) return null;
+  const lines = text.split("\n").map((l) => l.replace(/\r$/, "").trimEnd());
+  const firstContent = lines.findIndex((l) => EVENT_CONTENT_LINE.test(l));
+  let events;
+  if (open[1] === "buzz-event") {
+    events = [lines];
+  } else {
+    const starts = lines.flatMap((l, i) => EVENT_BOUNDARY.test(l) ? [i] : []);
+    if (!starts.length || firstContent >= 0 && starts[0] > firstContent) return null;
+    events = starts.map((from, k) => lines.slice(from, starts[k + 1] ?? lines.length));
+  }
+  const names = /* @__PURE__ */ new Set();
+  for (const event of events) {
+    const head = event.slice(0, EVENT_HEADER_LINES);
+    const end = head.findIndex((l) => EVENT_CONTENT_LINE.test(l));
+    if (end < 0) return null;
+    const own = /* @__PURE__ */ new Set();
+    for (const line of head.slice(0, end)) {
+      const m = CHANNEL_LINE.exec(line);
+      if (m) own.add(m[1]);
+    }
+    if (own.size !== 1) return null;
+    for (const name2 of own) names.add(name2);
+  }
+  if (names.size !== 1) return null;
+  const [name] = names;
+  return name === "DM" ? "buzz:dm" : `buzz:${name}`;
+}
 function venueFromBuzzMessage(message) {
   try {
-    const loc = locateBuzzContext(message.trimStart());
-    return loc ? venueFromBuzzContext(loc.rest.slice(loc.pos)) : null;
+    const text = message.trimStart();
+    const loc = locateBuzzContext(text);
+    return loc ? venueFromBuzzContext(loc.rest.slice(loc.pos)) : venueFromBuzzEvent(text);
   } catch {
     return null;
   }
 }
-var PREAMBLE_BLOCKS, HISTORY_OPEN, TURN_OPEN, TURN_IN_DROPPED, TURN_LINE, CONTEXT_OPEN, BUZZ_SCOPE, BUZZ_CHANNEL, CONTEXT_CLOSE, QUOTE_ENTRY, EVENT_HEADER, WRAPPER_LINE, EVENT_LABEL, IDENTIFIER_ONLY;
+var PREAMBLE_BLOCKS, HISTORY_OPEN, TURN_OPEN, TURN_IN_DROPPED, TURN_LINE, CONTEXT_OPEN, BUZZ_SCOPE, BUZZ_CHANNEL, CONTEXT_CLOSE, CHANNEL_LINE, EVENT_ONLY_OPEN, EVENT_CONTENT_LINE, EVENT_BOUNDARY, EVENT_HEADER_LINES, QUOTE_ENTRY, EVENT_HEADER, WRAPPER_LINE, EVENT_LABEL, IDENTIFIER_ONLY;
 var init_buzz_envelope = __esm({
   "src/auto_save/buzz_envelope.ts"() {
     "use strict";
@@ -32940,6 +32971,11 @@ var init_buzz_envelope = __esm({
     BUZZ_SCOPE = /^Scope: (?:thread|channel|dm)\r?\n/;
     BUZZ_CHANNEL = /(?:^|\n)Channel: .+ \(#[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\)\r?(?=\n|$)/;
     CONTEXT_CLOSE = "\n</context>";
+    CHANNEL_LINE = /^Channel: (.+?) \(#[0-9a-f-]{36}\)$/;
+    EVENT_ONLY_OPEN = /^<(buzz-events?)[\s>]/;
+    EVENT_CONTENT_LINE = /^Content: /;
+    EVENT_BOUNDARY = /^--- Event \d+ \(.*\) ---$/;
+    EVENT_HEADER_LINES = 12;
     QUOTE_ENTRY = /^\[(\d+)\] (?:([0-9a-f]{64})|.*? \(([0-9a-f]{64})\)) \((\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?(?:Z|[+-]\d\d:\d\d))\): ?/;
     EVENT_HEADER = /^(?:Event ID: [0-9a-f]{64}|Kind: \d+|Time: \d{4}-\d{2}-\d{2}T\S+|--- Event \d+ \(.*\) ---|Note: A new message arrived while you were working\..*)\s*$/;
     WRAPPER_LINE = /^<\/?[a-z-]+(\s[^>]*)?>\s*$/;
@@ -43028,6 +43064,220 @@ OUTPUT strict JSON object: { "verdict": "project" | "generic" | "unsure", "reaso
   }
 });
 
+// src/cold_path/tagger_core.ts
+function agentCandidateLine(c) {
+  if (!c || !c.project_name) return "";
+  const why = c.reason ? ` \u2014 ${c.reason}` : "";
+  const refs = c.evidence_refs?.length ? ` [evidence: ${c.evidence_refs.join(", ")}]` : "";
+  return `agent candidate (a proposal from the agent that had this conversation \u2014 NOT a decision; verify against the list): ${c.project_name}${why}${refs}
+`;
+}
+function buildUserPrompt(input, candidates, registry2 = false, hint) {
+  if (registry2) {
+    const hintLine = hint && input.venue ? `${registryHintLine(input.venue, hint)}
+` : "";
+    return `registry (the ONLY allowed p_tag values \u2014 pick exactly one name, or null if none clearly fits; never invent a name, never use NEW:):
+${registryCandidateLines(candidates)}
+${hintLine}${agentCandidateLine(input.agentCandidate)}role=${input.role}
+message: ${input.message}`;
+  }
+  const candList = candidates.length > 0 ? candidates.map((c) => c.name).join(", ") : "(none)";
+  return `candidates: ${candList}
+${agentCandidateLine(input.agentCandidate)}role=${input.role}
+message: ${input.message}`;
+}
+function registrySchema(candidates) {
+  return {
+    type: "object",
+    properties: {
+      p_tag: { anyOf: [{ type: "string", enum: candidates.map((c) => c.name) }, { type: "null" }] },
+      d_tag: { type: "array", items: { type: "string" }, maxItems: 5 }
+    },
+    required: ["p_tag", "d_tag"],
+    additionalProperties: false
+  };
+}
+async function resolveRegistryAnswer(raw, candidates, ports, trace) {
+  const answer = parsePTagAnswer(raw);
+  if (trace) trace.parser_result = answer.type;
+  let canonicalId = null;
+  if (answer.type === "name") {
+    canonicalId = await ports.resolveCanonical(answer.slug, { maxDepth: REGISTRY_ALIAS_MAX_DEPTH });
+  }
+  const verdict = registryVerdict(answer, canonicalId, new Set(candidates.map((c) => c.id)));
+  if (verdict.accept == null && verdict.reason !== "no_answer") {
+    console.error(`\u26A0\uFE0F [Tagger] \uBA85\uBD80 \uBAA8\uB4DC: "${String(raw)}" \uBC1B\uC9C0 \uC54A\uC74C (${verdict.reason}). p_tag NULL.`);
+  }
+  if (trace) {
+    trace.decision_reason = verdict.accept != null ? "resolved_existing" : verdict.reason === "no_answer" ? "no_answer" : "null_no_match";
+  }
+  return verdict.accept;
+}
+async function runTagger(input, ports, trace) {
+  const { rows: candidates, registry: registry2 } = await ports.listCandidates();
+  const hint = registry2 && input.venue ? (await ports.listHints()).get(input.venue) : void 0;
+  const userPrompt = buildUserPrompt(input, candidates, registry2, hint);
+  if (trace) {
+    trace.assembled_prompt = userPrompt;
+    trace.registry_mode = registry2;
+    trace.candidate_count = candidates.length;
+    trace.fallback_attempted = false;
+    trace.fallback_used = false;
+    trace.jev_applied = false;
+    trace.persistence_action = "none";
+  }
+  const isLocal = ports.isLocalProvider();
+  let raw;
+  if (isLocal) {
+    try {
+      raw = await ports.callPrimary({
+        system: ports.systemPrompt,
+        user: userPrompt,
+        responseFormat: "json",
+        jsonSchema: registry2 ? registrySchema(candidates) : TAGGER_SCHEMA,
+        enableThinking: false
+        // thinking off — 태거는 단순 매핑 작업. thinking 켜면 reasoning이 모든 토큰 소비해 content 비어버림.
+        // jsonSchema → llama.cpp grammar로 <think> bleed 차단 (Qwen3 bug #20345).
+      });
+    } catch (err3) {
+      if (!ports.fallbackEnabled()) throw err3;
+      console.warn(`\u26A0\uFE0F [Tagger] Local model \uC2E4\uD328, grok fallback: ${err3.message?.slice(0, 80)}`);
+      if (trace) trace.fallback_attempted = true;
+      try {
+        raw = await ports.callFallback({
+          system: ports.systemPrompt,
+          user: userPrompt,
+          responseFormat: "json"
+        });
+      } catch (fbErr) {
+        if (trace) trace.fallback_error = fbErr.message;
+        throw fbErr;
+      }
+      if (trace) trace.fallback_used = true;
+    }
+  } else {
+    raw = await ports.callPrimary({
+      system: ports.systemPrompt,
+      user: userPrompt,
+      responseFormat: "json"
+    });
+  }
+  if (trace) trace.raw_model_output = raw;
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`Tagger returned invalid JSON: ${raw.slice(0, 200)}`);
+  }
+  if (trace) trace.model_raw_p_tag = parsed.p_tag ?? null;
+  const qwenProposedNewTag = typeof parsed.p_tag === "string" && parsed.p_tag.startsWith("NEW:");
+  if (!qwenProposedNewTag) {
+    const jev = await ports.judgeJev({
+      message: input.message,
+      role: input.role,
+      agent_platform: input.agent_platform,
+      agent_model: input.agent_model,
+      candidates
+    });
+    if (jev !== null && ports.applyJev(jev)) {
+      parsed.p_tag = jev.choice;
+      if (trace) trace.jev_applied = true;
+    }
+  }
+  if (trace) trace.effective_p_tag = parsed.p_tag ?? null;
+  let p_tag_id = null;
+  let newly_created_p_tag_name;
+  if (registry2) {
+    p_tag_id = await resolveRegistryAnswer(parsed.p_tag, candidates, ports, trace);
+  } else if (parsed.p_tag && typeof parsed.p_tag === "string") {
+    if (parsed.p_tag.startsWith("NEW:")) {
+      const newName = parsed.p_tag.slice(4).trim();
+      if (newName && await ports.isBlockedNewName(newName)) {
+        console.error(`\u26A0\uFE0F [Tagger] "${newName}"\uC740(\uB294) \uC0C8 \uD0DC\uADF8 \uC81C\uC548\uC5D0\uC11C \uC0AC\uB78C\uC758 \uACB0\uC815\uC744 \uAE30\uB2E4\uB9AC\uAC70\uB098 \uBC18\uB824\uB41C \uC774\uB984\uC774\uB77C \uB9CC\uB4E4\uC9C0 \uC54A\uC74C. p_tag NULL.`);
+        if (trace) {
+          trace.decision_reason = "blocked_by_policy";
+          trace.proposed_name = newName;
+        }
+      } else if (newName) {
+        if (ports.getOrCreateTag) {
+          p_tag_id = await ports.getOrCreateTag(newName);
+          newly_created_p_tag_name = newName;
+          if (trace) {
+            trace.decision_reason = "new_created_or_existing";
+            trace.proposed_name = newName;
+            trace.persistence_action = "created_or_existing";
+          }
+        } else {
+          if (trace) {
+            trace.decision_reason = "new_proposal_no_persist";
+            trace.proposed_name = newName;
+            trace.persistence_action = "skipped_no_port";
+          }
+        }
+      }
+    } else {
+      const slug = parsed.p_tag.toLowerCase().trim();
+      const candidateSlugs = new Set(candidates.map((c) => c.name.toLowerCase()));
+      if (candidateSlugs.has(slug)) {
+        p_tag_id = ports.getOrCreateTag ? await ports.getOrCreateTag(parsed.p_tag) : await ports.resolveCanonical(slug);
+        if (trace) {
+          trace.decision_reason = "resolved_existing";
+          trace.persistence_action = ports.getOrCreateTag ? "created_or_existing" : "none";
+        }
+      } else {
+        const aliasId = await ports.resolveCanonical(slug);
+        if (aliasId != null) {
+          p_tag_id = aliasId;
+          if (trace) trace.decision_reason = "resolved_existing";
+        } else {
+          console.error(`\u26A0\uFE0F [Tagger] \uD6C4\uBCF4 \uC678 \uC774\uB984 "${parsed.p_tag}" \uAC70\uBD80 (NEW: prefix \uC5C6\uC74C). p_tag NULL \uBC18\uD658.`);
+          p_tag_id = null;
+          if (trace) trace.decision_reason = "rejected_not_candidate";
+        }
+      }
+    }
+  } else if (trace) {
+    trace.decision_reason = "no_answer";
+  }
+  const d_tag = Array.isArray(parsed.d_tag) ? parsed.d_tag.filter((t) => typeof t === "string").map((t) => t.toLowerCase().trim()).filter((t) => t.length > 0 && t.length <= 50).slice(0, 5) : [];
+  return {
+    p_tag_id,
+    d_tag,
+    newly_created_p_tag_name
+  };
+}
+var TAGGER_SCHEMA, GENERIC_TAGGER_PROMPT, REGISTRY_ALIAS_MAX_DEPTH;
+var init_tagger_core = __esm({
+  "src/cold_path/tagger_core.ts"() {
+    "use strict";
+    init_project_registry();
+    TAGGER_SCHEMA = {
+      type: "object",
+      properties: {
+        p_tag: { type: ["string", "null"] },
+        d_tag: { type: "array", items: { type: "string" }, maxItems: 5 }
+      },
+      required: ["p_tag", "d_tag"],
+      additionalProperties: false
+    };
+    GENERIC_TAGGER_PROMPT = `Tagger for a user's long-term memory across AI agents.
+
+OUTPUT (strict JSON):
+{ "p_tag": "<existing-name>" | "NEW:<slug>" | null, "d_tag": ["<kw>", ...] }
+
+p_tag: ONE project tag. Prefer matching a name from the candidate list below;
+  map obvious synonyms to an existing candidate. Use "NEW:<slug>" only when the
+  message is clearly about a project absent from the list. null when the message
+  is too short or generic to project-tag.
+
+d_tag: 0-3 short lowercase hyphenated keywords about the topic. Skip if no signal.
+
+ROLE: input includes role='user' or role='assistant'. For role='assistant',
+  tag the topic; do not treat the reply as a fact about the user.`;
+    REGISTRY_ALIAS_MAX_DEPTH = 20;
+  }
+});
+
 // src/cold_path/tagger.ts
 function candidateSelectionConfig() {
   const configuredStrategy = process.env.TAGGER_CANDIDATE_STRATEGY?.trim().toLowerCase();
@@ -43117,20 +43367,6 @@ async function listChannelHints() {
   _hintCache = { map, expires: now + CANDIDATE_CACHE_TTL_MS };
   return map;
 }
-function buildUserPrompt(input, candidates, registry2 = false, hint) {
-  if (registry2) {
-    const hintLine = hint && input.venue ? `${registryHintLine(input.venue, hint)}
-` : "";
-    return `registry (the ONLY allowed p_tag values \u2014 pick exactly one name, or null if none clearly fits; never invent a name, never use NEW:):
-${registryCandidateLines(candidates)}
-${hintLine}role=${input.role}
-message: ${input.message}`;
-  }
-  const candList = candidates.length > 0 ? candidates.map((c) => c.name).join(", ") : "(none)";
-  return `candidates: ${candList}
-role=${input.role}
-message: ${input.message}`;
-}
 async function getOrCreateProjectTag(name) {
   const slug = name.toLowerCase().trim();
   if (!slug) throw new Error("Empty p_tag name");
@@ -43154,136 +43390,51 @@ async function getOrCreateProjectTag(name) {
   invalidateCandidateCache();
   return Number(inserted.rows[0].id);
 }
-function registrySchema(candidates) {
-  return {
-    type: "object",
-    properties: {
-      p_tag: { anyOf: [{ type: "string", enum: candidates.map((c) => c.name) }, { type: "null" }] },
-      d_tag: { type: "array", items: { type: "string" }, maxItems: 5 }
-    },
-    required: ["p_tag", "d_tag"],
-    additionalProperties: false
-  };
-}
-async function resolveRegistryAnswer(raw, candidates) {
-  const answer = parsePTagAnswer(raw);
-  let canonicalId = null;
-  if (answer.type === "name") {
+async function resolveCanonicalId(name, opts) {
+  if (opts?.maxDepth != null) {
     const chain = await db.query(
       `WITH RECURSIVE chain AS (
          SELECT id, alias_of, 0 AS depth FROM project_tags WHERE name = $1
          UNION ALL
          SELECT pt.id, pt.alias_of, c.depth + 1 FROM project_tags pt JOIN chain c ON pt.id = c.alias_of
-          WHERE c.depth < 20
+          WHERE c.depth < ${opts.maxDepth}
        )
        SELECT id FROM chain WHERE alias_of IS NULL LIMIT 1`,
-      [answer.slug]
+      [name]
     );
-    canonicalId = chain.rows.length > 0 ? Number(chain.rows[0].id) : null;
-  }
-  const verdict = registryVerdict(answer, canonicalId, new Set(candidates.map((c) => c.id)));
-  if (verdict.accept == null && verdict.reason !== "no_answer") {
-    console.error(`\u26A0\uFE0F [Tagger] \uBA85\uBD80 \uBAA8\uB4DC: "${String(raw)}" \uBC1B\uC9C0 \uC54A\uC74C (${verdict.reason}). p_tag NULL.`);
+    return chain.rows.length > 0 ? Number(chain.rows[0].id) : null;
   }
-  return verdict.accept;
+  const aliasCheck = await db.query(
+    `WITH RECURSIVE chain AS (
+       SELECT id, alias_of FROM project_tags WHERE name = $1
+       UNION ALL
+       SELECT pt.id, pt.alias_of FROM project_tags pt JOIN chain c ON pt.id = c.alias_of
+     )
+     SELECT id FROM chain WHERE alias_of IS NULL LIMIT 1`,
+    [name]
+  );
+  return aliasCheck.rows.length > 0 ? Number(aliasCheck.rows[0].id) : null;
 }
-async function tagMessage(input) {
-  const { rows: candidates, registry: registry2 } = await listProjectTagCandidates();
-  const hint = registry2 && input.venue ? (await listChannelHints()).get(input.venue) : void 0;
-  const userPrompt = buildUserPrompt(input, candidates, registry2, hint);
-  const isLocal = ROLE_REGISTRY.tagger.provider === "local";
-  let raw;
-  if (isLocal) {
-    try {
-      raw = await callRole("tagger", {
-        system: SYSTEM_PROMPT,
-        user: userPrompt,
-        responseFormat: "json",
-        jsonSchema: registry2 ? registrySchema(candidates) : TAGGER_SCHEMA,
-        enableThinking: false
-        // thinking off — 태거는 단순 매핑 작업. thinking 켜면 reasoning이 모든 토큰 소비해 content 비어버림.
-        // jsonSchema → llama.cpp grammar로 <think> bleed 차단 (Qwen3 bug #20345).
-      });
-    } catch (err3) {
-      if (!localFallbackEnabled()) throw err3;
-      console.warn(`\u26A0\uFE0F [Tagger] Local model \uC2E4\uD328, grok fallback: ${err3.message?.slice(0, 80)}`);
-      raw = await callSpec(GROK_FALLBACK_SPEC, {
-        system: SYSTEM_PROMPT,
-        user: userPrompt,
-        responseFormat: "json"
-      });
-    }
-  } else {
-    raw = await callRole("tagger", {
-      system: SYSTEM_PROMPT,
-      user: userPrompt,
-      responseFormat: "json"
-    });
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new Error(`Tagger returned invalid JSON: ${raw.slice(0, 200)}`);
-  }
-  const qwenProposedNewTag = typeof parsed.p_tag === "string" && parsed.p_tag.startsWith("NEW:");
-  if (!qwenProposedNewTag) {
-    const jev = await judgeProjectTag({
-      message: input.message,
-      role: input.role,
-      agent_platform: input.agent_platform,
-      agent_model: input.agent_model,
-      candidates
-    });
-    if (jev !== null && shouldApplyJevJudgment(jev)) {
-      parsed.p_tag = jev.choice;
-    }
-  }
-  let p_tag_id = null;
-  let newly_created_p_tag_name;
-  if (registry2) {
-    p_tag_id = await resolveRegistryAnswer(parsed.p_tag, candidates);
-  } else if (parsed.p_tag && typeof parsed.p_tag === "string") {
-    if (parsed.p_tag.startsWith("NEW:")) {
-      const newName = parsed.p_tag.slice(4).trim();
-      if (newName && await isBlockedNewTagName(newName)) {
-        console.error(`\u26A0\uFE0F [Tagger] "${newName}"\uC740(\uB294) \uC0C8 \uD0DC\uADF8 \uC81C\uC548\uC5D0\uC11C \uC0AC\uB78C\uC758 \uACB0\uC815\uC744 \uAE30\uB2E4\uB9AC\uAC70\uB098 \uBC18\uB824\uB41C \uC774\uB984\uC774\uB77C \uB9CC\uB4E4\uC9C0 \uC54A\uC74C. p_tag NULL.`);
-      } else if (newName) {
-        p_tag_id = await getOrCreateProjectTag(newName);
-        newly_created_p_tag_name = newName;
-      }
-    } else {
-      const slug = parsed.p_tag.toLowerCase().trim();
-      const candidateSlugs = new Set(candidates.map((c) => c.name.toLowerCase()));
-      if (candidateSlugs.has(slug)) {
-        p_tag_id = await getOrCreateProjectTag(parsed.p_tag);
-      } else {
-        const aliasCheck = await db.query(
-          `WITH RECURSIVE chain AS (
-             SELECT id, alias_of FROM project_tags WHERE name = $1
-             UNION ALL
-             SELECT pt.id, pt.alias_of FROM project_tags pt JOIN chain c ON pt.id = c.alias_of
-           )
-           SELECT id FROM chain WHERE alias_of IS NULL LIMIT 1`,
-          [slug]
-        );
-        if (aliasCheck.rows.length > 0) {
-          p_tag_id = Number(aliasCheck.rows[0].id);
-        } else {
-          console.error(`\u26A0\uFE0F [Tagger] \uD6C4\uBCF4 \uC678 \uC774\uB984 "${parsed.p_tag}" \uAC70\uBD80 (NEW: prefix \uC5C6\uC74C). p_tag NULL \uBC18\uD658.`);
-          p_tag_id = null;
-        }
-      }
-    }
-  }
-  const d_tag = Array.isArray(parsed.d_tag) ? parsed.d_tag.filter((t) => typeof t === "string").map((t) => t.toLowerCase().trim()).filter((t) => t.length > 0 && t.length <= 50).slice(0, 5) : [];
+function operationalPorts() {
   return {
-    p_tag_id,
-    d_tag,
-    newly_created_p_tag_name
+    systemPrompt: SYSTEM_PROMPT,
+    isLocalProvider: () => ROLE_REGISTRY.tagger.provider === "local",
+    fallbackEnabled: localFallbackEnabled,
+    callPrimary: (opts) => callRole("tagger", opts),
+    callFallback: (opts) => callSpec(GROK_FALLBACK_SPEC, opts),
+    judgeJev: (i) => judgeProjectTag(i),
+    applyJev: (j) => shouldApplyJevJudgment(j),
+    listCandidates: listProjectTagCandidates,
+    listHints: listChannelHints,
+    resolveCanonical: resolveCanonicalId,
+    isBlockedNewName: isBlockedNewTagName,
+    getOrCreateTag: getOrCreateProjectTag
   };
 }
-var GROK_FALLBACK_SPEC, localFallbackEnabled, _candidateCache, REGISTRY_CANDIDATE_LIMIT, CANDIDATE_CACHE_TTL_MS, _hintCache, TAGGER_SCHEMA, GENERIC_TAGGER_PROMPT, SYSTEM_PROMPT;
+async function tagMessage(input) {
+  return runTagger(input, operationalPorts());
+}
+var GROK_FALLBACK_SPEC, localFallbackEnabled, _candidateCache, REGISTRY_CANDIDATE_LIMIT, CANDIDATE_CACHE_TTL_MS, _hintCache, SYSTEM_PROMPT;
 var init_tagger = __esm({
   "src/cold_path/tagger.ts"() {
     "use strict";
@@ -43293,35 +43444,13 @@ var init_tagger = __esm({
     init_prompts();
     init_dtag_promoter();
     init_project_registry();
+    init_tagger_core();
     GROK_FALLBACK_SPEC = { provider: "xai", model_name: "grok-4-1-fast-non-reasoning" };
     localFallbackEnabled = () => process.env.LOCAL_GROK_FALLBACK !== "false";
     _candidateCache = null;
     REGISTRY_CANDIDATE_LIMIT = 60;
     CANDIDATE_CACHE_TTL_MS = 5 * 60 * 1e3;
     _hintCache = null;
-    TAGGER_SCHEMA = {
-      type: "object",
-      properties: {
-        p_tag: { type: ["string", "null"] },
-        d_tag: { type: "array", items: { type: "string" }, maxItems: 5 }
-      },
-      required: ["p_tag", "d_tag"],
-      additionalProperties: false
-    };
-    GENERIC_TAGGER_PROMPT = `Tagger for a user's long-term memory across AI agents.
-
-OUTPUT (strict JSON):
-{ "p_tag": "<existing-name>" | "NEW:<slug>" | null, "d_tag": ["<kw>", ...] }
-
-p_tag: ONE project tag. Prefer matching a name from the candidate list below;
-  map obvious synonyms to an existing candidate. Use "NEW:<slug>" only when the
-  message is clearly about a project absent from the list. null when the message
-  is too short or generic to project-tag.
-
-d_tag: 0-3 short lowercase hyphenated keywords about the topic. Skip if no signal.
-
-ROLE: input includes role='user' or role='assistant'. For role='assistant',
-  tag the topic; do not treat the reply as a fact about the user.`;
     SYSTEM_PROMPT = getPrompt("tagger", GENERIC_TAGGER_PROMPT);
   }
 });
@@ -59307,15 +59436,15 @@ date_range \uC778\uC2DD \uD615\uC2DD:
         date_range: external_exports.string().optional().describe("\uAE30\uAC04 \uD55C\uC815 (today / last_week / last_month / 7_days_ago / YYYY-MM-DD)"),
         role: external_exports.enum(["user", "assistant"]).optional().describe("\uBC1C\uD654\uC790 \uD55C\uC815 (\uC0DD\uB7B5 \uC2DC \uB458 \uB2E4)"),
         agent_platform: external_exports.string().optional().describe(
-          "agent platform \uD55C\uC815 (\uC608: 'claude-code', 'gemini-cli-mcp-client'). \uC0DD\uB7B5 \uB610\uB294 '*' \uC774\uBA74 cross-platform(\uC804 \uD50C\uB7AB\uD3FC)."
+          "**\uC218\uC9D1\xB7\uC2E4\uD589 \uACBD\uB85C** \uD55C\uC815 (\uC608: 'claude-code', 'gemini-cli-mcp-client'). 'buzz' \uB294 \uBC84\uC988 \uAC8C\uC2DC \uC6D0\uBB38\uC744 \uC9C1\uC811 \uC218\uC9D1\uD55C \uD589\uC774\uB2E4 \u2014 \uC2E4\uD589 \uD658\uACBD\uC774 \uC544\uB2C8\uB77C \uC218\uC9D1 \uACBD\uB85C\uC774\uACE0, \uADF8 \uD589\uC758 \uC2E4\uD589 \uD658\uACBD\uC740 \uBBF8\uC0C1\uC774\uB2E4. **\uB300\uD654 \uACF5\uAC04\uC73C\uB85C \uC881\uD788\uB824\uBA74 \uC774 \uCE78\uC774 \uC544\uB2C8\uB77C venue \uB97C \uC4F4\uB2E4.** \uC0DD\uB7B5 \uB610\uB294 '*' \uC774\uBA74 cross-platform(\uC804 \uD50C\uB7AB\uD3FC)."
         ),
         device_scope: external_exports.enum(["local", "global"]).optional().describe(
-          "\uAE30\uAE30 \uD55C\uC815. 'global'(\uAE30\uBCF8): \uC804 \uAE30\uAE30 \uAC80\uC0C9(\uB113\uAC8C). 'local': \uD604\uC7AC \uAE30\uAE30(hostname)\uB85C \uD55C\uC815(\uC774\uC5B4\uBC1B\uAE30\uC6A9, \uC881\uAC8C). zero-config \u2014 \uC11C\uBC84\uAC00 hostname \uC790\uB3D9 \uD574\uC11D."
+          "**\uCEA1\uCC98 \uC7A5\uBE44** \uD55C\uC815. 'global'(\uAE30\uBCF8): \uC804 \uAE30\uAE30 \uAC80\uC0C9(\uB113\uAC8C). 'local': \uD604\uC7AC \uAE30\uAE30(hostname)\uB85C \uD55C\uC815(\uC774\uC5B4\uBC1B\uAE30\uC6A9, \uC881\uAC8C). zero-config \u2014 \uC11C\uBC84\uAC00 hostname \uC790\uB3D9 \uD574\uC11D. \uC8FC\uC758: device_name \uC740 \uADF8 \uD589\uC744 \uC801\uC740 \uD504\uB85C\uC138\uC2A4\uC758 \uAE30\uACC4\uC774\uACE0 \uAE00\uC744 \uC4F4 \uC0AC\uB78C\uC758 \uAE30\uAE30\uAC00 \uC544\uB2C8\uB2E4. \uBC84\uC988 \uC6D0\uBB38 \uC218\uC9D1 \uD589\uC740 NULL \uC774\uB77C 'local' \uC5D0 \uC548 \uAC78\uB9B0\uB2E4 \u2014 \uB2E8 **pinned(\uAC15\uC81C\uAE30\uC5B5) \uD589\uC740 device_name \uC774 NULL \uC774\uC5B4\uB3C4 'local' \uC5D0 \uD3EC\uD568**\uB41C\uB2E4(\uAC15\uC81C\uAE30\uC5B5\uC740 \uB9E5\uB77D \uBD88\uBB38 \uB178\uCD9C)."
         ),
         limit: external_exports.number().int().min(1).max(50).optional().describe(`\uCD5C\uB300 \uACB0\uACFC \uC218 (default ${DEFAULT_LIMIT})`),
         include_archived: external_exports.boolean().optional().describe("archived \uBA54\uBAA8\uB9AC\uB3C4 \uD3EC\uD568 (default false)"),
         venue: external_exports.string().optional().describe(
-          "\uB300\uD654\uAC00 \uC624\uAC04 \uC790\uB9AC\uB85C \uD55C\uC815. 'buzz'(\uBC84\uC988 \uC804\uCCB4) / 'buzz:<\uCC44\uB110>'(\uADF8 \uCC44\uB110, \uC608: buzz:DevRoom) / 'buzz:dm' / 'terminal'(\uC0AC\uB78C\uACFC 1:1) / 'slack' / 'auto'. \uACB0\uACFC\uB9C8\uB2E4 venue\uAC00 \uBD99\uC5B4 \uB098\uC628\uB2E4."
+          "**\uB300\uD654 \uACF5\uAC04**(\uC5B4\uB514\uC11C \uB9D0\uD588\uB098)\uC73C\uB85C \uD55C\uC815. 'buzz'(\uBC84\uC988 \uC804\uCCB4) / 'buzz:<\uCC44\uB110>'(\uADF8 \uCC44\uB110, \uC608: buzz:DevRoom) / 'buzz:dm' / 'terminal'(\uC0AC\uB78C\uACFC 1:1) / 'slack' / 'auto'. \uACB0\uACFC\uB9C8\uB2E4 venue\uAC00 \uBD99\uC5B4 \uB098\uC628\uB2E4. \uAC19\uC740 \uACF5\uAC04\uC758 \uB300\uD654\uAC00 \uC218\uC9D1 \uACBD\uB85C(agent_platform)\uB294 \uC5EC\uB7EC \uC885\uB958\uC77C \uC218 \uC788\uB2E4."
         )
       }
     },
@@ -63734,6 +63863,7 @@ async function maybeRunLibrarian() {
 }
 var COLDPATH_ADVISORY_LOCK_KEY = 4242000017;
 var lockClient = null;
+var ownedColdPath = false;
 async function acquireColdPathLock() {
   if (lockClient) return true;
   const client2 = await db.getClient();
@@ -63741,6 +63871,7 @@ async function acquireColdPathLock() {
     const res = await client2.query("SELECT pg_try_advisory_lock($1) AS got", [COLDPATH_ADVISORY_LOCK_KEY]);
     if (res.rows[0]?.got === true) {
       lockClient = client2;
+      ownedColdPath = true;
       return true;
     }
     client2.release();
@@ -63812,6 +63943,7 @@ function stopColdPathWorker() {
   console.error("\u{1F535} [ColdPath] stopped");
 }
 async function drainColdPath(maxTicks = 12) {
+  if (!ownedColdPath) return 0;
   let waitCount = 0;
   while (running && waitCount < 30) {
     await new Promise((r) => setTimeout(r, 100));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-agents-memory",
-  "version": "0.9.32",
+  "version": "0.9.34",
   "description": "Long-term memory for AI agents with provenance tracking",
   "main": "build/index.js",
   "type": "module",
@@ -32,7 +32,14 @@
     "check:alias-evidence": "esbuild scripts/check_alias_evidence.ts --bundle --platform=node --format=esm --outfile=node_modules/.cache/mcp-agents-memory/check_alias_evidence.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_alias_evidence.mjs",
     "check:retag": "esbuild scripts/check_ptag_retag.ts --bundle --platform=node --format=esm --outfile=node_modules/.cache/mcp-agents-memory/check_ptag_retag.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_ptag_retag.mjs",
     "check:coldpath-gate": "esbuild scripts/check_coldpath_gate.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_coldpath_gate.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_coldpath_gate.mjs",
-    "check:codex-arm": "esbuild scripts/check_codex_arm.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_codex_arm.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_codex_arm.mjs"
+    "check:codex-arm": "esbuild scripts/check_codex_arm.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_codex_arm.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_codex_arm.mjs",
+    "check:coldpath-drain": "esbuild scripts/check_coldpath_drain.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_coldpath_drain.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_coldpath_drain.mjs",
+    "check:tagger-core": "esbuild scripts/check_tagger_core_equivalence.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_tagger_core_equivalence.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_tagger_core_equivalence.mjs",
+    "check:tagger-nodb": "esbuild scripts/check_tagger_core_nodb.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_tagger_core_nodb.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_tagger_core_nodb.mjs",
+    "eval:tagging": "esbuild scripts/eval_tagging_runner.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/eval_tagging_runner.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/eval_tagging_runner.mjs",
+    "check:eval-runner": "esbuild scripts/check_eval_runner.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_eval_runner.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_eval_runner.mjs",
+    "eval:candidates": "esbuild scripts/eval_candidate_generator.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/eval_candidate_generator.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/eval_candidate_generator.mjs",
+    "check:candidates": "esbuild scripts/check_candidate_generator.ts --bundle --platform=node --format=esm --packages=external --outfile=node_modules/.cache/mcp-agents-memory/check_candidate_generator.mjs --log-level=warning && node node_modules/.cache/mcp-agents-memory/check_candidate_generator.mjs"
   },
   "keywords": [
     "mcp",