@things-factory/ai-client-base 10.1.3 → 10.1.6

package/server/service/utils/grounding.ts

@@ -18,21 +18,43 @@
  * 한국어·하이픈 없는 일반어는 애초에 매칭하지 않는다.
  */
 
-/** id 관례 — 소문자로 시작, 하이픈으로 이어진 소문자·숫자 토큰. `fk-1` `weld-station` `a-dc` 등. */
-const ID_TOKEN = /[a-z][a-z0-9]*(?:-[a-z0-9]+)+/g
+/**
+ * id 관례 — 영문자로 시작, 하이픈으로 이어진 영숫자 토큰. `fk-1` · `weld-station` · `WO-ECU-2609B`.
+ *
+ * ── 소문자만 보다가 두 제품을 통째로 놓치고 있었다 (2026-09-10) ──────────────
+ * 이 패턴이 `[a-z]…` 였다. 그래서 **대문자 식별자를 쓰는 제품에는 이 가드가 아예 닿지 않았다.**
+ * 실측:
+ *
+ *   'WO-ECU-SET-2609B'  → []      plant 의 실제 오더 이름(seed/sets/svm-gunsan.ts)
+ *   'TAG-FUNC-AGING'    → []      트윈의 태그
+ *   'dock-3'            → ['dock-3']
+ *
+ * 즉 「지어낸 오더 번호를 잡는다」는 보장이 plant 에서는 성립하지 않았고, 경고가 0 건인 것이
+ * 「깨끗하다」로 읽혔다. 없는 것과 안 보는 것이 같은 그림이었다.
+ *
+ * 넓혀도 소음이 늘지 않는 이유는 `filterEntityLike` 가 뒤에 있기 때문이다 — `Read-Only` 는 숫자도
+ * 없고 근거에 `Read-` 계열도 없어 그대로 걸러진다.
+ */
+const ID_TOKEN = /[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)+/g
 
-/** 문자열에서 id 후보 토큰을 뽑는다(중복 제거). */
+/** 문자열에서 id 후보 토큰을 뽑는다(중복 제거). **쓰인 그대로** 담는다 — 사람에게 보일 값이다. */
 export function extractIdTokens(s: string): Set<string> {
   const out = new Set<string>()
   for (const m of (s ?? '').matchAll(ID_TOKEN)) out.add(m[0])
   return out
 }
 
-/** 답이 언급한 id − 근거 코퍼스의 id = 미확인(환각 후보). 순서는 답에 나온 순서. */
+/**
+ * 답이 언급한 id − 근거 코퍼스의 id = 미확인(환각 후보). 순서는 답에 나온 순서.
+ *
+ * **대조는 대소문자를 무시한다.** 모델이 `WO-2609B` 를 `wo-2609b` 로 적는 것은 표기이지 다른
+ * 대상이 아니다. 엄격히 보면 그 한 글자 차이로 정상 답이 경고를 받고, 그런 경고가 몇 번 나오면
+ * 사람이 경고 자체를 안 본다. 대소문자만 다른 두 식별자를 쓰는 체계라면 그것이 먼저 고칠 문제다.
+ */
 export function checkGrounding(reply: string, groundedCorpus: string): string[] {
-  const grounded = extractIdTokens(groundedCorpus)
+  const grounded = new Set([...extractIdTokens(groundedCorpus)].map(id => id.toLowerCase()))
   const mentioned = extractIdTokens(reply)
-  return [...mentioned].filter(id => !grounded.has(id))
+  return [...mentioned].filter(id => !grounded.has(id.toLowerCase()))
 }
 
 /**
@@ -51,9 +73,11 @@ export function checkGrounding(reply: string, groundedCorpus: string): string[]
  * 잡으려면 일반 영어 합성어를 함께 잡게 되므로, 이 가드는 **정확도를 택하고 재현율을 버린다**.
  */
 export function filterEntityLike(tokens: string[], groundedCorpus: string): string[] {
+  /* 계열 대조도 대소문자를 무시한다 — `checkGrounding` 과 같은 규칙이어야 한다. 한쪽만 엄격하면
+   * 근거에 `WO-1` 이 있는데 답의 `wo-7` 이 계열 밖으로 새어 경고를 놓친다. */
   const families = new Set<string>()
-  for (const id of extractIdTokens(groundedCorpus)) families.add(id.split('-')[0])
-  return tokens.filter(t => /[0-9]/.test(t) || families.has(t.split('-')[0]))
+  for (const id of extractIdTokens(groundedCorpus)) families.add(id.split('-')[0].toLowerCase())
+  return tokens.filter(t => /[0-9]/.test(t) || families.has(t.split('-')[0].toLowerCase()))
 }
 
 /**
@@ -63,3 +87,45 @@ export function filterEntityLike(tokens: string[], groundedCorpus: string): stri
 export function groundingWarnings(reply: string, groundedCorpus: string): string[] {
   return filterEntityLike(checkGrounding(reply, groundedCorpus), groundedCorpus)
 }
+
+/*
+ * ── 근거집합의 정의 (2026-09-10 에 board-ai 에서 옮겨 왔다) ────────────────────
+ *
+ * 이 모양이 `board-ai` 에 있었고, 그래서 접지 검사를 하려면 보드 편집기를 지나야 했다. 판정 규칙은
+ * 여기 있었는데 **무엇을 근거로 볼 것인가**가 저기 있었으니, 보드가 없는 제품은 규칙만 있고 쓸 길이
+ * 없었다. 자리는 있고 길이 없는 쪽이다.
+ *
+ * 옮기면서 칸 하나를 고쳤다: `boardContext` → `hostContext`. 근거는 보드일 수도 있고 공장 현황일
+ * 수도 있고 저작 중인 자산일 수도 있다 — 그것을 아는 것은 호스트뿐이다.
+ *
+ * **하나라도 빼면 정상 답이 경고를 받는다.** 모델이 시스템 프롬프트에서 읽은 타입 이름을 말하는 것은
+ * 근거 있는 발언이다. 그래서 이 목록은 「모델이 이 턴에 본 것 전부」이고, 줄이는 것이 아니라 채우는
+ * 것이 맞다.
+ */
+export interface GroundingSources {
+  /** 시스템 프롬프트 — 생성 가능한 타입 목록·규칙 등. 여기 있는 이름을 말하는 것은 정상이다. */
+  systemPrompt?: string
+  /** 호스트가 대화 앞에 붙인 문맥 — 보드 요약·현장 상태·저작 중인 자산. */
+  hostContext?: string
+  /** 사용자·어시스턴트 이력 텍스트. 사용자가 말한 식별자를 되받는 것은 정상이다. */
+  messages?: string[]
+  /**
+   * `tool_result` 로 회신된 **원문**(시간순).
+   *
+   * ⚠ `toolUsages[].result` 를 넣지 말 것 — 그것은 화면 표시용으로 깊이·길이가 잘린 값이다. 잘려
+   * 나간 식별자를 「근거 없음」으로 오판한다. 넣을 값은 `AgenticLoopResult.groundedTexts` 다.
+   */
+  toolResults?: string[]
+}
+
+/** 근거집합을 한 덩어리로. 식별자 토큰만 대조하므로 구분자는 개행으로 충분하다. */
+export function buildGroundedCorpus(sources: GroundingSources): string {
+  return [
+    sources.systemPrompt ?? '',
+    sources.hostContext ?? '',
+    ...(sources.messages ?? []),
+    ...(sources.toolResults ?? [])
+  ]
+    .filter(Boolean)
+    .join('\n')
+}