@things-factory/board-ai 10.0.0-beta.108

package/dist-server/service/mention-resolver.d.ts

@@ -0,0 +1,96 @@
+/**
+ * `#token` 멘션 해석 (things-factory 식별자 컨벤션 준수).
+ *
+ * things-factory 정책:
+ *   - `#` 은 사용자가 컴포넌트를 가리키는 SELECTOR. things-scene Finder 의
+ *     CSS 셀렉터 컨셉과 같은 맥락 — 와이드 검색 (name / id / type 셋 다 OR).
+ *   - **refid 는 시스템 내부 핸들** — 사용자에게 노출 금지. 사용자가 본 적도
+ *     없는 숫자라 `(refid 35)` 같은 표기는 혼란만 가중.
+ *   - id 는 데이터 바인딩 식별자 (human-readable). unique 제약 없음.
+ *   - name 은 사용자 라벨. 가장 친숙.
+ *
+ * Resolver 정책:
+ *   - 본문의 `#token` 은 LITERAL 보존 (refid 본문 노출 0)
+ *   - 매칭 결과는 본문 끝에 구조화된 "mention map" 블록으로 첨부
+ *   - AI 는 시스템 프롬프트의 안내에 따라 mention map 의 refid 를 tool
+ *     호출 인자로만 사용. 사용자 답변 텍스트에서는 name/id 로 지칭.
+ *
+ * Token 매칭 (모두 시도, OR):
+ *   - name 정확 일치 (case-insensitive)
+ *   - id 정확 일치 (case-insensitive)
+ *   - type 정확 일치 (case-insensitive) — `#rect` 같이 모든 type 가리키기
+ *
+ * 부분 / fuzzy 매칭 안 함 — popup 측에서 사용자가 정확한 식별자 선택.
+ *
+ * Token 정규식: /#([^\s#]+)/g (한글/영문/하이픈/언더스코어/숫자).
+ */
+import type { BoardModel } from '@things-factory/board-import';
+/** 매칭된 컴포넌트의 핵심 정보 — refid 는 시스템 핸들, 나머지는 사용자 친화적 식별.
+ *  things-scene F-Finder 와 동일한 검색 필드 (id/name/type/tag/class/text)
+ *  + position (AI 가 식별 + 조작 좌표 판단에 활용). */
+export interface MentionedComponent {
+    refid: number;
+    name?: string;
+    id?: string;
+    type: string;
+    tag?: string;
+    class?: string;
+    text?: string;
+    /** 중심 좌표 (rect: left+w/2, top+h/2 / circle: cx, cy) — 정수 반올림 */
+    position?: {
+        x: number;
+        y: number;
+    };
+}
+/** popup 에서 사용자가 명시 선택한 컴포넌트 — server 가 정확한 매칭에 사용. */
+export interface MentionPick {
+    /** 사용자 텍스트의 #token 부분 (예: '경광등1') */
+    token: string;
+    /** popup 에서 선택된 정확한 refid */
+    refid: number;
+}
+export interface ResolveMentionsOptions {
+    /** popup 에서 명시 선택된 mentions — 해당 token 은 fallback 매칭 안 거치고 정확한 refid 로 즉시 해석 */
+    picks?: MentionPick[];
+}
+export interface MentionMatch {
+    /** 사용자가 입력한 #token 의 token 부분 */
+    token: string;
+    /** 토큰 위치 (start: '#' 위치, end: 마지막 글자 다음) */
+    start: number;
+    end: number;
+    /** name/id/type 매칭으로 발견한 컴포넌트들 */
+    matched: MentionedComponent[];
+}
+/**
+ * 텍스트의 모든 #token 을 보드에서 매칭. UI / 디버그 / 테스트용.
+ */
+export declare function findMentions(text: string, currentBoard: BoardModel | null | undefined, options?: ResolveMentionsOptions): MentionMatch[];
+/**
+ * Token 으로 컴포넌트 매칭 — name/id/type/tag/class/text OR (things-scene F-Finder
+ * 동일 필드 셋). 여러 기준에서 동시 일치하더라도 같은 refid 는 한 번만 반환 (dedup).
+ *
+ * picks 에 해당 token 이 있으면 fallback 안 거치고 그 refid 로 직접 매칭 (popup 에서
+ * 사용자가 명시 선택한 결정적 매핑). 그 refid 가 보드에 없으면 fallback 으로.
+ */
+export declare function lookupComponents(token: string, components: readonly any[], picks?: readonly MentionPick[]): MentionedComponent[];
+/**
+ * 텍스트의 #token 을 LLM 친화 형태로 변환.
+ *
+ * 본문은 그대로 + 매칭 성공한 토큰의 mention map 을 끝에 첨부:
+ *
+ *   "[원본 본문]
+ *
+ *    --- mention map (자동 첨부 — 사용자가 # 로 지칭한 컴포넌트) ---
+ *    #경광등1 →
+ *      { name='경광등1', id='motor-1', type='rect', refid=35 }
+ *    #펌프 →
+ *      { name='펌프A', id='pump-1', type='rect', refid=42 }
+ *      { name='펌프B', id='pump-2', type='rect', refid=51 }"
+ *
+ * AI 는 system prompt 안내에 따라 refid 를 tool 호출 인자로만 사용. 답변
+ * 텍스트에서는 refid 직접 언급 금지.
+ *
+ * 매칭 0 → 변경 없음 (본문 그대로 반환).
+ */
+export declare function resolveMentions(text: string, currentBoard: BoardModel | null | undefined, options?: ResolveMentionsOptions): string;

package/dist-server/service/mention-resolver.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findMentions = findMentions;
+exports.lookupComponents = lookupComponents;
+exports.resolveMentions = resolveMentions;
+const MENTION_PATTERN = /#([^\s#]+)/g;
+/**
+ * 텍스트의 모든 #token 을 보드에서 매칭. UI / 디버그 / 테스트용.
+ */
+function findMentions(text, currentBoard, options = {}) {
+    if (!text || typeof text !== 'string')
+        return [];
+    const components = currentBoard?.components ?? [];
+    return collectMatches(text, components, options.picks);
+}
+/**
+ * Token 으로 컴포넌트 매칭 — name/id/type/tag/class/text OR (things-scene F-Finder
+ * 동일 필드 셋). 여러 기준에서 동시 일치하더라도 같은 refid 는 한 번만 반환 (dedup).
+ *
+ * picks 에 해당 token 이 있으면 fallback 안 거치고 그 refid 로 직접 매칭 (popup 에서
+ * 사용자가 명시 선택한 결정적 매핑). 그 refid 가 보드에 없으면 fallback 으로.
+ */
+function lookupComponents(token, components, picks) {
+    if (!token || components.length === 0)
+        return [];
+    // picks 우선 — popup 으로 명시 선택된 token 은 그 refid 로 직접 매칭
+    if (picks) {
+        const pick = picks.find(p => p.token === token);
+        if (pick) {
+            const c = components.find((x) => x && typeof x.refid === 'number' && x.refid === pick.refid);
+            if (c) {
+                const fields = readSearchFields(c);
+                return [
+                    {
+                        refid: pick.refid,
+                        name: fields.name,
+                        id: fields.id,
+                        type: fields.type,
+                        tag: fields.tag,
+                        class: fields.cls,
+                        text: fields.text,
+                        position: extractPosition(c)
+                    }
+                ];
+            }
+            // pick 이 stale (refid 가 더 이상 보드에 없음) — fallback 으로 진행
+        }
+    }
+    const lower = token.toLowerCase();
+    const out = [];
+    const seen = new Set();
+    for (const c of components) {
+        if (!c || typeof c.refid !== 'number')
+            continue;
+        const refid = c.refid;
+        if (seen.has(refid))
+            continue;
+        const fields = readSearchFields(c);
+        if ((fields.name && fields.name.toLowerCase() === lower) ||
+            (fields.id && fields.id.toLowerCase() === lower) ||
+            fields.type.toLowerCase() === lower ||
+            (fields.tag && fields.tag.toLowerCase() === lower) ||
+            (fields.cls && fields.cls.toLowerCase() === lower) ||
+            (fields.text && fields.text.toLowerCase() === lower)) {
+            seen.add(refid);
+            out.push({
+                refid,
+                name: fields.name,
+                id: fields.id,
+                type: fields.type,
+                tag: fields.tag,
+                class: fields.cls,
+                text: fields.text,
+                position: extractPosition(c)
+            });
+        }
+    }
+    return out;
+}
+/** 컴포넌트 중심 좌표 — rect: left+w/2 / circle: cx,cy. */
+function extractPosition(c) {
+    if (typeof c.cx === 'number' && typeof c.cy === 'number') {
+        return { x: Math.round(c.cx), y: Math.round(c.cy) };
+    }
+    if (typeof c.left === 'number' && typeof c.top === 'number') {
+        const w = typeof c.width === 'number' ? c.width : 0;
+        const h = typeof c.height === 'number' ? c.height : 0;
+        return { x: Math.round(c.left + w / 2), y: Math.round(c.top + h / 2) };
+    }
+    return undefined;
+}
+function readSearchFields(c) {
+    const str = (v) => typeof v === 'string' && v.length > 0 ? v : undefined;
+    return {
+        name: str(c.name),
+        id: str(c.id),
+        type: typeof c.type === 'string' ? c.type : 'unknown',
+        tag: str(c.tag),
+        cls: str(c.class),
+        text: str(c.text)
+    };
+}
+/**
+ * 텍스트의 #token 을 LLM 친화 형태로 변환.
+ *
+ * 본문은 그대로 + 매칭 성공한 토큰의 mention map 을 끝에 첨부:
+ *
+ *   "[원본 본문]
+ *
+ *    --- mention map (자동 첨부 — 사용자가 # 로 지칭한 컴포넌트) ---
+ *    #경광등1 →
+ *      { name='경광등1', id='motor-1', type='rect', refid=35 }
+ *    #펌프 →
+ *      { name='펌프A', id='pump-1', type='rect', refid=42 }
+ *      { name='펌프B', id='pump-2', type='rect', refid=51 }"
+ *
+ * AI 는 system prompt 안내에 따라 refid 를 tool 호출 인자로만 사용. 답변
+ * 텍스트에서는 refid 직접 언급 금지.
+ *
+ * 매칭 0 → 변경 없음 (본문 그대로 반환).
+ */
+function resolveMentions(text, currentBoard, options = {}) {
+    if (!text || typeof text !== 'string')
+        return text;
+    const components = currentBoard?.components ?? [];
+    if (components.length === 0)
+        return text;
+    const matches = collectMatches(text, components, options.picks);
+    const resolved = matches.filter(m => m.matched.length > 0);
+    if (resolved.length === 0)
+        return text;
+    const block = [
+        '',
+        '--- mention map (자동 첨부 — 사용자가 # 로 지칭한 컴포넌트) ---'
+    ];
+    for (const m of resolved) {
+        block.push(`#${m.token} →`);
+        for (const c of m.matched) {
+            block.push(`  ${formatComponentRef(c)}`);
+        }
+    }
+    return text + '\n' + block.join('\n');
+}
+function collectMatches(text, components, picks) {
+    const out = [];
+    const pattern = new RegExp(MENTION_PATTERN.source, 'g');
+    let m;
+    while ((m = pattern.exec(text)) !== null) {
+        const token = m[1];
+        out.push({
+            token,
+            start: m.index,
+            end: m.index + m[0].length,
+            matched: lookupComponents(token, components, picks)
+        });
+    }
+    return out;
+}
+function formatComponentRef(c) {
+    const parts = [];
+    if (c.name)
+        parts.push(`name='${c.name}'`);
+    if (c.id)
+        parts.push(`id='${c.id}'`);
+    parts.push(`type='${c.type}'`);
+    if (c.tag)
+        parts.push(`tag='${c.tag}'`);
+    if (c.class)
+        parts.push(`class='${c.class}'`);
+    if (c.text)
+        parts.push(`text='${c.text}'`);
+    if (c.position)
+        parts.push(`pos=(${c.position.x},${c.position.y})`);
+    parts.push(`refid=${c.refid}`);
+    return `{ ${parts.join(', ')} }`;
+}
+//# sourceMappingURL=mention-resolver.js.map

package/dist-server/service/mention-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mention-resolver.js","sourceRoot":"","sources":["../../server/service/mention-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `#token` 멘션 해석 (things-factory 식별자 컨벤션 준수).\n *\n * things-factory 정책:\n *   - `#` 은 사용자가 컴포넌트를 가리키는 SELECTOR. things-scene Finder 의\n *     CSS 셀렉터 컨셉과 같은 맥락 — 와이드 검색 (name / id / type 셋 다 OR).\n *   - **refid 는 시스템 내부 핸들** — 사용자에게 노출 금지. 사용자가 본 적도\n *     없는 숫자라 `(refid 35)` 같은 표기는 혼란만 가중.\n *   - id 는 데이터 바인딩 식별자 (human-readable). unique 제약 없음.\n *   - name 은 사용자 라벨. 가장 친숙.\n *\n * Resolver 정책:\n *   - 본문의 `#token` 은 LITERAL 보존 (refid 본문 노출 0)\n *   - 매칭 결과는 본문 끝에 구조화된 \"mention map\" 블록으로 첨부\n *   - AI 는 시스템 프롬프트의 안내에 따라 mention map 의 refid 를 tool\n *     호출 인자로만 사용. 사용자 답변 텍스트에서는 name/id 로 지칭.\n *\n * Token 매칭 (모두 시도, OR):\n *   - name 정확 일치 (case-insensitive)\n *   - id 정확 일치 (case-insensitive)\n *   - type 정확 일치 (case-insensitive) — `#rect` 같이 모든 type 가리키기\n *\n * 부분 / fuzzy 매칭 안 함 — popup 측에서 사용자가 정확한 식별자 선택.\n *\n * Token 정규식: /#([^\\s#]+)/g (한글/영문/하이픈/언더스코어/숫자).\n */\nimport type { BoardModel } from '@things-factory/board-import'\n\nconst MENTION_PATTERN = /#([^\\s#]+)/g\n\n/** 매칭된 컴포넌트의 핵심 정보 — refid 는 시스템 핸들, 나머지는 사용자 친화적 식별.\n *  things-scene F-Finder 와 동일한 검색 필드 (id/name/type/tag/class/text)\n *  + position (AI 가 식별 + 조작 좌표 판단에 활용). */\nexport interface MentionedComponent {\n  refid: number\n  name?: string\n  id?: string\n  type: string\n  tag?: string\n  class?: string\n  text?: string\n  /** 중심 좌표 (rect: left+w/2, top+h/2 / circle: cx, cy) — 정수 반올림 */\n  position?: { x: number; y: number }\n}\n\n/** popup 에서 사용자가 명시 선택한 컴포넌트 — server 가 정확한 매칭에 사용. */\nexport interface MentionPick {\n  /** 사용자 텍스트의 #token 부분 (예: '경광등1') */\n  token: string\n  /** popup 에서 선택된 정확한 refid */\n  refid: number\n}\n\nexport interface ResolveMentionsOptions {\n  /** popup 에서 명시 선택된 mentions — 해당 token 은 fallback 매칭 안 거치고 정확한 refid 로 즉시 해석 */\n  picks?: MentionPick[]\n}\n\nexport interface MentionMatch {\n  /** 사용자가 입력한 #token 의 token 부분 */\n  token: string\n  /** 토큰 위치 (start: '#' 위치, end: 마지막 글자 다음) */\n  start: number\n  end: number\n  /** name/id/type 매칭으로 발견한 컴포넌트들 */\n  matched: MentionedComponent[]\n}\n\n/**\n * 텍스트의 모든 #token 을 보드에서 매칭. UI / 디버그 / 테스트용.\n */\nexport function findMentions(\n  text: string,\n  currentBoard: BoardModel | null | undefined,\n  options: ResolveMentionsOptions = {}\n): MentionMatch[] {\n  if (!text || typeof text !== 'string') return []\n  const components = currentBoard?.components ?? []\n  return collectMatches(text, components, options.picks)\n}\n\n\n/**\n * Token 으로 컴포넌트 매칭 — name/id/type/tag/class/text OR (things-scene F-Finder\n * 동일 필드 셋). 여러 기준에서 동시 일치하더라도 같은 refid 는 한 번만 반환 (dedup).\n *\n * picks 에 해당 token 이 있으면 fallback 안 거치고 그 refid 로 직접 매칭 (popup 에서\n * 사용자가 명시 선택한 결정적 매핑). 그 refid 가 보드에 없으면 fallback 으로.\n */\nexport function lookupComponents(\n  token: string,\n  components: readonly any[],\n  picks?: readonly MentionPick[]\n): MentionedComponent[] {\n  if (!token || components.length === 0) return []\n\n  // picks 우선 — popup 으로 명시 선택된 token 은 그 refid 로 직접 매칭\n  if (picks) {\n    const pick = picks.find(p => p.token === token)\n    if (pick) {\n      const c = components.find(\n        (x: any) => x && typeof x.refid === 'number' && x.refid === pick.refid\n      )\n      if (c) {\n        const fields = readSearchFields(c)\n        return [\n          {\n            refid: pick.refid,\n            name: fields.name,\n            id: fields.id,\n            type: fields.type,\n            tag: fields.tag,\n            class: fields.cls,\n            text: fields.text,\n            position: extractPosition(c)\n          }\n        ]\n      }\n      // pick 이 stale (refid 가 더 이상 보드에 없음) — fallback 으로 진행\n    }\n  }\n\n  const lower = token.toLowerCase()\n  const out: MentionedComponent[] = []\n  const seen = new Set<number>()\n  for (const c of components) {\n    if (!c || typeof (c as any).refid !== 'number') continue\n    const refid = (c as any).refid\n    if (seen.has(refid)) continue\n    const fields = readSearchFields(c)\n    if (\n      (fields.name && fields.name.toLowerCase() === lower) ||\n      (fields.id && fields.id.toLowerCase() === lower) ||\n      fields.type.toLowerCase() === lower ||\n      (fields.tag && fields.tag.toLowerCase() === lower) ||\n      (fields.cls && fields.cls.toLowerCase() === lower) ||\n      (fields.text && fields.text.toLowerCase() === lower)\n    ) {\n      seen.add(refid)\n      out.push({\n        refid,\n        name: fields.name,\n        id: fields.id,\n        type: fields.type,\n        tag: fields.tag,\n        class: fields.cls,\n        text: fields.text,\n        position: extractPosition(c)\n      })\n    }\n  }\n  return out\n}\n\n/** 컴포넌트 중심 좌표 — rect: left+w/2 / circle: cx,cy. */\nfunction extractPosition(c: any): { x: number; y: number } | undefined {\n  if (typeof c.cx === 'number' && typeof c.cy === 'number') {\n    return { x: Math.round(c.cx), y: Math.round(c.cy) }\n  }\n  if (typeof c.left === 'number' && typeof c.top === 'number') {\n    const w = typeof c.width === 'number' ? c.width : 0\n    const h = typeof c.height === 'number' ? c.height : 0\n    return { x: Math.round(c.left + w / 2), y: Math.round(c.top + h / 2) }\n  }\n  return undefined\n}\n\nfunction readSearchFields(c: any): {\n  name?: string\n  id?: string\n  type: string\n  tag?: string\n  cls?: string\n  text?: string\n} {\n  const str = (v: any): string | undefined =>\n    typeof v === 'string' && v.length > 0 ? v : undefined\n  return {\n    name: str(c.name),\n    id: str(c.id),\n    type: typeof c.type === 'string' ? c.type : 'unknown',\n    tag: str(c.tag),\n    cls: str(c.class),\n    text: str(c.text)\n  }\n}\n\n/**\n * 텍스트의 #token 을 LLM 친화 형태로 변환.\n *\n * 본문은 그대로 + 매칭 성공한 토큰의 mention map 을 끝에 첨부:\n *\n *   \"[원본 본문]\n *\n *    --- mention map (자동 첨부 — 사용자가 # 로 지칭한 컴포넌트) ---\n *    #경광등1 →\n *      { name='경광등1', id='motor-1', type='rect', refid=35 }\n *    #펌프 →\n *      { name='펌프A', id='pump-1', type='rect', refid=42 }\n *      { name='펌프B', id='pump-2', type='rect', refid=51 }\"\n *\n * AI 는 system prompt 안내에 따라 refid 를 tool 호출 인자로만 사용. 답변\n * 텍스트에서는 refid 직접 언급 금지.\n *\n * 매칭 0 → 변경 없음 (본문 그대로 반환).\n */\nexport function resolveMentions(\n  text: string,\n  currentBoard: BoardModel | null | undefined,\n  options: ResolveMentionsOptions = {}\n): string {\n  if (!text || typeof text !== 'string') return text\n  const components = currentBoard?.components ?? []\n  if (components.length === 0) return text\n\n  const matches = collectMatches(text, components, options.picks)\n  const resolved = matches.filter(m => m.matched.length > 0)\n  if (resolved.length === 0) return text\n\n  const block: string[] = [\n    '',\n    '--- mention map (자동 첨부 — 사용자가 # 로 지칭한 컴포넌트) ---'\n  ]\n  for (const m of resolved) {\n    block.push(`#${m.token} →`)\n    for (const c of m.matched) {\n      block.push(`  ${formatComponentRef(c)}`)\n    }\n  }\n  return text + '\\n' + block.join('\\n')\n}\n\nfunction collectMatches(\n  text: string,\n  components: readonly any[],\n  picks?: readonly MentionPick[]\n): MentionMatch[] {\n  const out: MentionMatch[] = []\n  const pattern = new RegExp(MENTION_PATTERN.source, 'g')\n  let m: RegExpExecArray | null\n  while ((m = pattern.exec(text)) !== null) {\n    const token = m[1]\n    out.push({\n      token,\n      start: m.index,\n      end: m.index + m[0].length,\n      matched: lookupComponents(token, components, picks)\n    })\n  }\n  return out\n}\n\nfunction formatComponentRef(c: MentionedComponent): string {\n  const parts: string[] = []\n  if (c.name) parts.push(`name='${c.name}'`)\n  if (c.id) parts.push(`id='${c.id}'`)\n  parts.push(`type='${c.type}'`)\n  if (c.tag) parts.push(`tag='${c.tag}'`)\n  if (c.class) parts.push(`class='${c.class}'`)\n  if (c.text) parts.push(`text='${c.text}'`)\n  if (c.position) parts.push(`pos=(${c.position.x},${c.position.y})`)\n  parts.push(`refid=${c.refid}`)\n  return `{ ${parts.join(', ')} }`\n}\n"]}

package/dist-server/service/patch-entry/board-patch-broadcast.d.ts

@@ -0,0 +1,13 @@
+import type { PatchEntry } from './patch-entry.js';
+/** board-patch 브로드캐스트 토픽. */
+export declare const BOARD_PATCH_TOPIC = "board-patch";
+/** 방송 페이로드 — 구독 필터(domain+board)용 메타 + PatchEntry 본체. */
+export interface BoardPatchPayload {
+    domainId: string;
+    boardId?: string;
+    patch: PatchEntry;
+}
+/**
+ * 같은 domain + board 구독자에게만 통과시키는 필터 (도메인 격리 = 보안 핵심).
+ */
+export declare function boardPatchFilter(domainId: string, boardId: string): (payload: BoardPatchPayload) => boolean;

package/dist-server/service/patch-entry/board-patch-broadcast.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOARD_PATCH_TOPIC = void 0;
+exports.boardPatchFilter = boardPatchFilter;
+/** board-patch 브로드캐스트 토픽. */
+exports.BOARD_PATCH_TOPIC = 'board-patch';
+/**
+ * 같은 domain + board 구독자에게만 통과시키는 필터 (도메인 격리 = 보안 핵심).
+ */
+function boardPatchFilter(domainId, boardId) {
+    return (payload) => !!payload && payload.domainId === domainId && payload.boardId === boardId;
+}
+//# sourceMappingURL=board-patch-broadcast.js.map

package/dist-server/service/patch-entry/board-patch-broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-patch-broadcast.js","sourceRoot":"","sources":["../../../server/service/patch-entry/board-patch-broadcast.ts"],"names":[],"mappings":";;;AAoBA,4CAGC;AAhBD,6BAA6B;AAChB,QAAA,iBAAiB,GAAG,aAAa,CAAA;AAS9C;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAAgB,EAAE,OAAe;IAChE,OAAO,CAAC,OAA0B,EAAW,EAAE,CAC7C,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAA;AAC7E,CAAC","sourcesContent":["/*\n * board-patch 브로드캐스트 — 순수 로직 (토픽/페이로드/필터). 데코레이터·pubsub import 없음\n * → 단위테스트 가능. 데코레이터 resolver(board-patch-subscription.ts)와 pubsub 의존\n * publishBoardPatch 는 별도.\n */\nimport type { PatchEntry } from './patch-entry.js' // type-only — 런타임 import 아님\n\n/** board-patch 브로드캐스트 토픽. */\nexport const BOARD_PATCH_TOPIC = 'board-patch'\n\n/** 방송 페이로드 — 구독 필터(domain+board)용 메타 + PatchEntry 본체. */\nexport interface BoardPatchPayload {\n  domainId: string\n  boardId?: string\n  patch: PatchEntry\n}\n\n/**\n * 같은 domain + board 구독자에게만 통과시키는 필터 (도메인 격리 = 보안 핵심).\n */\nexport function boardPatchFilter(domainId: string, boardId: string) {\n  return (payload: BoardPatchPayload): boolean =>\n    !!payload && payload.domainId === domainId && payload.boardId === boardId\n}\n"]}

package/dist-server/service/patch-entry/board-patch-subscription.d.ts

@@ -0,0 +1,12 @@
+import { PatchEntry } from './patch-entry.js';
+import { type BoardPatchPayload } from './board-patch-broadcast.js';
+export { BOARD_PATCH_TOPIC, boardPatchFilter } from './board-patch-broadcast.js';
+export type { BoardPatchPayload } from './board-patch-broadcast.js';
+/**
+ * PatchEntry 생성 직후 호출 — 같은 board 구독자에게 방송.
+ * boardId 없으면(세션 미연결) skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.
+ */
+export declare function publishBoardPatch(payload: BoardPatchPayload): void;
+export declare class BoardPatchSubscription {
+    boardPatchActivity(payload: BoardPatchPayload, boardId: string): PatchEntry;
+}

package/dist-server/service/patch-entry/board-patch-subscription.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoardPatchSubscription = exports.boardPatchFilter = exports.BOARD_PATCH_TOPIC = void 0;
+exports.publishBoardPatch = publishBoardPatch;
+const tslib_1 = require("tslib");
+/*
+ * BoardPatchSubscription (Phase Board-AI C1 — op-브로드캐스트 spine).
+ *
+ * PatchEntry(AI 또는 user-direct 편집) 가 생성될 때마다 같은 board 구독자에게 방송 →
+ * 실시간 공동편집의 척추. 클라이언트(C2)가 구독해 원격 patch 를 applyBoardEditPatch 로 적용.
+ *
+ * 전송/패턴은 기존 board-service/board-subscription.ts 복제 (PubSub + graphql-ws, domain 격리).
+ * 순수 로직(토픽/필터)은 board-patch-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_yoga_1 = require("graphql-yoga");
+const shell_1 = require("@things-factory/shell");
+const patch_entry_js_1 = require("./patch-entry.js");
+const board_patch_broadcast_js_1 = require("./board-patch-broadcast.js");
+const subscribe_auth_js_1 = require("../subscribe-auth.js");
+var board_patch_broadcast_js_2 = require("./board-patch-broadcast.js");
+Object.defineProperty(exports, "BOARD_PATCH_TOPIC", { enumerable: true, get: function () { return board_patch_broadcast_js_2.BOARD_PATCH_TOPIC; } });
+Object.defineProperty(exports, "boardPatchFilter", { enumerable: true, get: function () { return board_patch_broadcast_js_2.boardPatchFilter; } });
+/**
+ * PatchEntry 생성 직후 호출 — 같은 board 구독자에게 방송.
+ * boardId 없으면(세션 미연결) skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.
+ */
+function publishBoardPatch(payload) {
+    if (!payload.boardId)
+        return;
+    try {
+        shell_1.pubsub.publish(board_patch_broadcast_js_1.BOARD_PATCH_TOPIC, payload);
+    }
+    catch {
+        /* 방송 생략 — 영속은 이미 끝남 */
+    }
+}
+let BoardPatchSubscription = class BoardPatchSubscription {
+    boardPatchActivity(payload, boardId) {
+        return payload.patch;
+    }
+};
+exports.BoardPatchSubscription = BoardPatchSubscription;
+tslib_1.__decorate([
+    (0, type_graphql_1.Subscription)({
+        description: 'Subscribes to board edit patches (AI or user-direct) for real-time collaboration on a board.',
+        subscribe: async ({ args, context }) => {
+            const { domain, user } = context.state;
+            const { boardId } = args;
+            await (0, subscribe_auth_js_1.assertDomainSubscribeAllowed)(domain, user, (d, u) => process.superUserGranted(d, u));
+            return (0, graphql_yoga_1.pipe)(shell_1.pubsub.subscribe(board_patch_broadcast_js_1.BOARD_PATCH_TOPIC), (0, graphql_yoga_1.filter)((0, board_patch_broadcast_js_1.boardPatchFilter)(domain.id, boardId)));
+        }
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('boardId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String]),
+    tslib_1.__metadata("design:returntype", patch_entry_js_1.PatchEntry)
+], BoardPatchSubscription.prototype, "boardPatchActivity", null);
+exports.BoardPatchSubscription = BoardPatchSubscription = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(patch_entry_js_1.PatchEntry)
+], BoardPatchSubscription);
+//# sourceMappingURL=board-patch-subscription.js.map

package/dist-server/service/patch-entry/board-patch-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-patch-subscription.js","sourceRoot":"","sources":["../../../server/service/patch-entry/board-patch-subscription.ts"],"names":[],"mappings":";;;AAuBA,8CAOC;;AA9BD;;;;;;;;GAQG;AACH,+CAAgE;AAChE,+CAA2C;AAC3C,iDAA8C;AAC9C,qDAA6C;AAC7C,yEAAwG;AACxG,4DAAmE;AAEnE,uEAAgF;AAAvE,6HAAA,iBAAiB,OAAA;AAAE,4HAAA,gBAAgB,OAAA;AAG5C;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,OAA0B;IAC1D,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAM;IAC5B,IAAI,CAAC;QACH,cAAM,CAAC,OAAO,CAAC,4CAAiB,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC;AAGM,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAajC,kBAAkB,CAAS,OAA0B,EAAkB,OAAe;QACpF,OAAO,OAAO,CAAC,KAAK,CAAA;IACtB,CAAC;CACF,CAAA;AAhBY,wDAAsB;AAajC;IAZC,IAAA,2BAAY,EAAC;QACZ,WAAW,EACT,8FAA8F;QAChG,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;YACtC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;YAExB,MAAM,IAAA,gDAA4B,EAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1F,OAAO,IAAA,mBAAI,EAAC,cAAM,CAAC,SAAS,CAAC,4CAAiB,CAAC,EAAE,IAAA,qBAAM,EAAC,IAAA,2CAAgB,EAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAChG,CAAC;KACF,CAAC;IACkB,mBAAA,IAAA,mBAAI,GAAE,CAAA;IAA8B,mBAAA,IAAA,kBAAG,EAAC,SAAS,CAAC,CAAA;;;4CAAmB,2BAAU;gEAElG;iCAfU,sBAAsB;IADlC,IAAA,uBAAQ,EAAC,2BAAU,CAAC;GACR,sBAAsB,CAgBlC","sourcesContent":["/*\n * BoardPatchSubscription (Phase Board-AI C1 — op-브로드캐스트 spine).\n *\n * PatchEntry(AI 또는 user-direct 편집) 가 생성될 때마다 같은 board 구독자에게 방송 →\n * 실시간 공동편집의 척추. 클라이언트(C2)가 구독해 원격 patch 를 applyBoardEditPatch 로 적용.\n *\n * 전송/패턴은 기존 board-service/board-subscription.ts 복제 (PubSub + graphql-ws, domain 격리).\n * 순수 로직(토픽/필터)은 board-patch-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.\n */\nimport { Resolver, Subscription, Root, Arg } from 'type-graphql'\nimport { filter, pipe } from 'graphql-yoga'\nimport { pubsub } from '@things-factory/shell'\nimport { PatchEntry } from './patch-entry.js'\nimport { BOARD_PATCH_TOPIC, boardPatchFilter, type BoardPatchPayload } from './board-patch-broadcast.js'\nimport { assertDomainSubscribeAllowed } from '../subscribe-auth.js'\n\nexport { BOARD_PATCH_TOPIC, boardPatchFilter } from './board-patch-broadcast.js'\nexport type { BoardPatchPayload } from './board-patch-broadcast.js'\n\n/**\n * PatchEntry 생성 직후 호출 — 같은 board 구독자에게 방송.\n * boardId 없으면(세션 미연결) skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.\n */\nexport function publishBoardPatch(payload: BoardPatchPayload): void {\n  if (!payload.boardId) return\n  try {\n    pubsub.publish(BOARD_PATCH_TOPIC, payload)\n  } catch {\n    /* 방송 생략 — 영속은 이미 끝남 */\n  }\n}\n\n@Resolver(PatchEntry)\nexport class BoardPatchSubscription {\n  @Subscription({\n    description:\n      'Subscribes to board edit patches (AI or user-direct) for real-time collaboration on a board.',\n    subscribe: async ({ args, context }) => {\n      const { domain, user } = context.state\n      const { boardId } = args\n\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n\n      return pipe(pubsub.subscribe(BOARD_PATCH_TOPIC), filter(boardPatchFilter(domain.id, boardId)))\n    }\n  })\n  boardPatchActivity(@Root() payload: BoardPatchPayload, @Arg('boardId') boardId: string): PatchEntry {\n    return payload.patch\n  }\n}\n"]}

package/dist-server/service/patch-entry/index.d.ts

@@ -0,0 +1,4 @@
+import { PatchEntry } from './patch-entry.js';
+export { PatchEntry };
+export { BoardPatchSubscription, publishBoardPatch, boardPatchFilter, BOARD_PATCH_TOPIC, type BoardPatchPayload } from './board-patch-subscription.js';
+export declare const entities: (typeof PatchEntry)[];

package/dist-server/service/patch-entry/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = exports.BOARD_PATCH_TOPIC = exports.boardPatchFilter = exports.publishBoardPatch = exports.BoardPatchSubscription = exports.PatchEntry = void 0;
+const patch_entry_js_1 = require("./patch-entry.js");
+Object.defineProperty(exports, "PatchEntry", { enumerable: true, get: function () { return patch_entry_js_1.PatchEntry; } });
+var board_patch_subscription_js_1 = require("./board-patch-subscription.js");
+Object.defineProperty(exports, "BoardPatchSubscription", { enumerable: true, get: function () { return board_patch_subscription_js_1.BoardPatchSubscription; } });
+Object.defineProperty(exports, "publishBoardPatch", { enumerable: true, get: function () { return board_patch_subscription_js_1.publishBoardPatch; } });
+Object.defineProperty(exports, "boardPatchFilter", { enumerable: true, get: function () { return board_patch_subscription_js_1.boardPatchFilter; } });
+Object.defineProperty(exports, "BOARD_PATCH_TOPIC", { enumerable: true, get: function () { return board_patch_subscription_js_1.BOARD_PATCH_TOPIC; } });
+exports.entities = [patch_entry_js_1.PatchEntry];
+//# sourceMappingURL=index.js.map

package/dist-server/service/patch-entry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/patch-entry/index.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAEpC,2FAFA,2BAAU,OAEA;AACnB,6EAMsC;AALpC,qIAAA,sBAAsB,OAAA;AACtB,gIAAA,iBAAiB,OAAA;AACjB,+HAAA,gBAAgB,OAAA;AAChB,gIAAA,iBAAiB,OAAA;AAIN,QAAA,QAAQ,GAAG,CAAC,2BAAU,CAAC,CAAA","sourcesContent":["import { PatchEntry } from './patch-entry.js'\n\nexport { PatchEntry }\nexport {\n  BoardPatchSubscription,\n  publishBoardPatch,\n  boardPatchFilter,\n  BOARD_PATCH_TOPIC,\n  type BoardPatchPayload\n} from './board-patch-subscription.js'\n\nexport const entities = [PatchEntry]\n"]}

package/dist-server/service/patch-entry/patch-entry.d.ts

@@ -0,0 +1,16 @@
+import { ChatSession } from '../chat-session/chat-session.js';
+export declare class PatchEntry {
+    readonly id?: string;
+    session?: ChatSession;
+    sessionId?: string;
+    /** 'ai' | 'user-direct' | 'import' */
+    source: string;
+    /** BoardEditOp[] JSON-stringified — column 으로는 long text. */
+    ops: string;
+    /** GraphQL 노출용 — JSON 객체로 변환. */
+    get opsJson(): any;
+    summary?: string;
+    confidence?: number;
+    reverted: boolean;
+    createdAt?: Date;
+}

package/dist-server/service/patch-entry/patch-entry.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchEntry = void 0;
+const tslib_1 = require("tslib");
+/**
+ * PatchEntry — 보드의 한 변경 단위 (영구 이력).
+ *
+ * source 별:
+ *   - 'ai': AI 가 chat 응답에서 생성
+ *   - 'user-direct': 사용자가 모델러에서 직접 편집 — 변경 이벤트로 자동 기록
+ *   - 'import': ImportSession 결과 (도면 → 보드)
+ *
+ * AI 컨텍스트 유지의 핵심: 사용자 직접 편집도 PatchEntry 로 기록되어
+ * 다음 chat 호출 시 system 메시지로 자동 합류 → AI 가 모든 변경을 인지.
+ */
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const env_1 = require("@things-factory/env");
+const chat_session_js_1 = require("../chat-session/chat-session.js");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
+let PatchEntry = class PatchEntry {
+    /** GraphQL 노출용 — JSON 객체로 변환. */
+    get opsJson() {
+        try {
+            return JSON.parse(this.ops || '[]');
+        }
+        catch {
+            return [];
+        }
+    }
+};
+exports.PatchEntry = PatchEntry;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => chat_session_js_1.ChatSession, session => session.patches, { onDelete: 'CASCADE' }),
+    tslib_1.__metadata("design:type", chat_session_js_1.ChatSession)
+], PatchEntry.prototype, "session", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((patch) => patch.session),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 32 }),
+    (0, type_graphql_1.Field)({ description: "'ai' | 'user-direct' | 'import'" }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "source", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        type: DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+            ? 'longtext'
+            : DATABASE_TYPE == 'oracle'
+                ? 'clob'
+                : DATABASE_TYPE == 'mssql'
+                    ? 'nvarchar'
+                    : 'text',
+        length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
+    }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "ops", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => graphql_scalars_1.GraphQLJSON, { description: 'BoardEditOp[] (parsed JSON array).' }),
+    tslib_1.__metadata("design:type", Object),
+    tslib_1.__metadata("design:paramtypes", [])
+], PatchEntry.prototype, "opsJson", null);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Short human summary of this patch.' }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "summary", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'float', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'AI confidence 0..1 (null for user-direct).' }),
+    tslib_1.__metadata("design:type", Number)
+], PatchEntry.prototype, "confidence", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, type_graphql_1.Field)({ description: 'Whether this patch was reverted.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], PatchEntry.prototype, "reverted", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], PatchEntry.prototype, "createdAt", void 0);
+exports.PatchEntry = PatchEntry = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_patch_entry_1', (patch) => [patch.session, patch.createdAt]),
+    (0, type_graphql_1.ObjectType)({ description: 'One board edit operation history (cascade-deleted with ChatSession).' })
+], PatchEntry);
+//# sourceMappingURL=patch-entry.js.map

package/dist-server/service/patch-entry/patch-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-entry.js","sourceRoot":"","sources":["../../../server/service/patch-entry/patch-entry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * PatchEntry — 보드의 한 변경 단위 (영구 이력).\n *\n * source 별:\n *   - 'ai': AI 가 chat 응답에서 생성\n *   - 'user-direct': 사용자가 모델러에서 직접 편집 — 변경 이벤트로 자동 기록\n *   - 'import': ImportSession 결과 (도면 → 보드)\n *\n * AI 컨텍스트 유지의 핵심: 사용자 직접 편집도 PatchEntry 로 기록되어\n * 다음 chat 호출 시 system 메시지로 자동 합류 → AI 가 모든 변경을 인지.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId\n} from 'typeorm'\nimport { Field, ID, Float, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_patch_entry_1', (patch: PatchEntry) => [patch.session, patch.createdAt])\n@ObjectType({ description: 'One board edit operation history (cascade-deleted with ChatSession).' })\nexport class PatchEntry {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.patches, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((patch: PatchEntry) => patch.session)\n  sessionId?: string\n\n  /** 'ai' | 'user-direct' | 'import' */\n  @Column({ type: 'varchar', length: 32 })\n  @Field({ description: \"'ai' | 'user-direct' | 'import'\" })\n  source!: string\n\n  /** BoardEditOp[] JSON-stringified — column 으로는 long text. */\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  ops!: string\n\n  /** GraphQL 노출용 — JSON 객체로 변환. */\n  @Field(type => GraphQLJSON, { description: 'BoardEditOp[] (parsed JSON array).' })\n  get opsJson(): any {\n    try {\n      return JSON.parse(this.ops || '[]')\n    } catch {\n      return []\n    }\n  }\n\n  @Column({ type: 'text', nullable: true })\n  @Field({ nullable: true, description: 'Short human summary of this patch.' })\n  summary?: string\n\n  @Column({ type: 'float', nullable: true })\n  @Field(type => Float, { nullable: true, description: 'AI confidence 0..1 (null for user-direct).' })\n  confidence?: number\n\n  @Column({ default: false })\n  @Field({ description: 'Whether this patch was reverted.' })\n  reverted!: boolean\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n}\n"]}