@things-factory/board-ai 10.1.24 → 10.1.26

package/logs/.5e5d741d8b7784a2fbad65eedc0fd46946aaf6f2-audit.json

@@ -9,6 +9,11 @@
             "date": 1789195002942,
             "name": "logs/connections-2026-09-12-15.log",
             "hash": "cf643fb0881a2a037b9657d9f0cab3f858825cbc597ef955ba6335a9305911c5"
+        },
+        {
+            "date": 1789629007157,
+            "name": "logs/connections-2026-09-17-16.log",
+            "hash": "c1197ab32a8e488c0eca99467d70519d581cbe046549df9f7106554417a0f184"
         }
     ],
     "hashType": "sha256"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/board-ai",
-  "version": "10.1.24",
+  "version": "10.1.26",
   "main": "dist-server/index.js",
   "browser": "dist-client/client/index.js",
   "things-factory": true,
@@ -30,13 +30,14 @@
     "@apollo/client": "^3.13.0",
     "@operato/graphql": "^10.0.0",
     "@operato/i18n": "^10.0.0",
+    "@operato/scene-ops": "^10.14.1",
     "@operato/styles": "^10.0.0",
-    "@things-factory/ai-assistant": "^10.1.24",
-    "@things-factory/ai-client-base": "^10.1.20",
-    "@things-factory/auth-base": "^10.1.24",
-    "@things-factory/board-import": "^10.1.24",
+    "@things-factory/ai-assistant": "^10.1.26",
+    "@things-factory/ai-client-base": "^10.1.26",
+    "@things-factory/auth-base": "^10.1.26",
+    "@things-factory/board-import": "^10.1.26",
     "@things-factory/env": "^10.1.20",
-    "@things-factory/shell": "^10.1.20",
+    "@things-factory/shell": "^10.1.26",
     "dompurify": "^3.0.0",
     "graphql-tag": "^2.12.6",
     "lit": "^3.1.2",
@@ -46,5 +47,5 @@
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.0"
   },
-  "gitHead": "0d88a504e0ffa63cd91279b88c6998d4bf1b3d86"
+  "gitHead": "151bda14d899442c6846532ddded1e2bfe23a2f5"
 }

package/server/index.ts

@@ -9,14 +9,14 @@
  * @example
  * ```ts
  * import { createAIClient } from '@things-factory/ai-client-base'
- * import { DefaultBoardAIAssistant, applyBoardEditPatch } from '@things-factory/board-ai'
+ * import { DefaultBoardAIAssistant, applyScenePatch } from '@things-factory/board-ai'
  *
  * const base = createAIClient({ provider: 'anthropic', apiKey: '...' })
  * const ai = new DefaultBoardAIAssistant(base, { scopes: ['fmsim'] })
  *
  * let board
  * const r = await ai.chat([{ role: 'user', content: 'AGV 3대를 우측에 추가' }], board)
- * if (r.patch) board = applyBoardEditPatch(board, r.patch)
+ * if (r.patch) board = applyScenePatch(board, r.patch)
  * console.log(r.reply)
  * ```
  */

package/server/service/assistant-integration.test.ts

@@ -1,5 +1,5 @@
 /**
- * 통합 테스트 — assistant.chat() → BoardEditPatch → apply-patch 풀 파이프라인.
+ * 통합 테스트 — assistant.chat() → SceneEditPatch → apply-patch 풀 파이프라인.
  *
  * 단위 테스트의 공백 보완:
  *   - assistant.test.ts 는 patch 가 "올바르게 만들어지는지" 까지만 검증
@@ -13,7 +13,7 @@
  */
 import type { AIClient } from '@things-factory/ai-client-base'
 import { DefaultBoardAIAssistant } from './assistant'
-import { applyBoardEditPatch, applyBoardEditPatchVerbose } from './apply-patch'
+import { applyScenePatch, applyScenePatchVerbose } from '@operato/scene-ops'
 import type { BoardModel } from '@things-factory/board-import'
 
 // ── Mock provider — assistant.test.ts 의 패턴과 동일 ──────────────────
@@ -59,11 +59,11 @@ describe('통합 — addComponent 시나리오', () => {
     const r = await a.chat([{ role: 'user', content: 'rect 하나 추가' }], initial)
 
     expect(r.patch?.ops).toHaveLength(1)
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(1)
     expect(verbose.missed).toHaveLength(0)
-    expect(verbose.board.components).toHaveLength(1)
-    const added: any = verbose.board.components[0]
+    expect(verbose.model.components).toHaveLength(1)
+    const added: any = verbose.model.components[0]
     expect(added.type).toBe('rect')
     expect(added.left).toBe(50)
     expect(added.top).toBe(60)
@@ -84,9 +84,9 @@ describe('통합 — addComponent 시나리오', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: 'rect, circle, text 추가' }], initial)
 
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
-    expect(verbose.board.components).toHaveLength(3)
-    expect(verbose.board.components.map((c: any) => c.type)).toEqual(['rect', 'circle', 'text'])
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
+    expect(verbose.model.components).toHaveLength(3)
+    expect(verbose.model.components.map((c: any) => c.type)).toEqual(['rect', 'circle', 'text'])
     expect(verbose.applied).toHaveLength(3)
     expect(verbose.missed).toHaveLength(0)
   })
@@ -113,11 +113,11 @@ describe('통합 — modifyComponentByRefid 시나리오', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: '왼쪽 200으로' }], initial)
 
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(1)
     expect(verbose.missed).toHaveLength(0)
-    const c1: any = verbose.board.components[0]
-    const c2: any = verbose.board.components[1]
+    const c1: any = verbose.model.components[0]
+    const c2: any = verbose.model.components[1]
     expect(c1.left).toBe(200)
     expect(c1.top).toBe(20) // 다른 속성 보존
     expect(c1.width).toBe(100)
@@ -145,15 +145,15 @@ describe('통합 — modifyComponentByRefid 시나리오', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: '999 left=200' }], initial)
 
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(0)
     expect(verbose.missed).toHaveLength(1)
     // 보드는 그대로
-    expect((verbose.board.components[0] as any).left).toBe(10)
+    expect((verbose.model.components[0] as any).left).toBe(10)
   })
 })
 
-describe('통합 — modifyBoard 시나리오 (root 속성)', () => {
+describe('통합 — modifyScene 시나리오 (root 속성)', () => {
   test('"배경색 #0a1929" → root.fillStyle 만 변경, children 영향 없음', async () => {
     const initial = makeBoard([
       { refid: 1, type: 'rect', fillStyle: '#fff' }
@@ -164,7 +164,7 @@ describe('통합 — modifyBoard 시나리오 (root 속성)', () => {
         toolCalls: [
           {
             id: 'c1',
-            name: 'modifyBoard',
+            name: 'modifyScene',
             arguments: { patch: { fillStyle: '#0a1929' } }
           }
         ]
@@ -174,15 +174,15 @@ describe('통합 — modifyBoard 시나리오 (root 속성)', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: '심해 컬러' }], initial)
 
-    const after: any = applyBoardEditPatch(initial, r.patch!)
+    const after: any = applyScenePatch(initial, r.patch!)
     expect(after.fillStyle).toBe('#0a1929')
     expect(after.components).toHaveLength(1)
     expect((after.components[0] as any).fillStyle).toBe('#fff') // 자식은 그대로
   })
 
-  test('"심해 분위기" multi-turn — getAtmosphereGuide 후 modifyBoard 패치가 root 에 반영', async () => {
+  test('"심해 분위기" multi-turn — getAtmosphereGuide 후 modifyScene 패치가 root 에 반영', async () => {
     // 실제 사용 패턴: AI 가 atmosphere primer 를 먼저 read tool 로 가져와 archetype
-    // 보고, 거기서 추출한 patch (sky/exposure/dirLight 등) 로 modifyBoard 호출.
+    // 보고, 거기서 추출한 patch (sky/exposure/dirLight 등) 로 modifyScene 호출.
     const initial = makeBoard()
     const { client, callLog } = makeMockClient([
       // turn 1: read tool — guide 조회
@@ -194,7 +194,7 @@ describe('통합 — modifyBoard 시나리오 (root 속성)', () => {
         toolCalls: [
           {
             id: 'c2',
-            name: 'modifyBoard',
+            name: 'modifyScene',
             arguments: {
               patch: { sky: 'color', skyColor: '#0a1929', exposure: 0.7, hemiIntensity: 1.5 }
             }
@@ -207,8 +207,8 @@ describe('통합 — modifyBoard 시나리오 (root 속성)', () => {
     const r = await a.chat([{ role: 'user', content: '심해 분위기로' }], initial)
 
     expect(callLog).toHaveLength(3) // read → write → finalize
-    expect(r.patch?.ops).toHaveLength(1) // read 는 patch 에 안 잡히고 modifyBoard 만
-    const after: any = applyBoardEditPatch(initial, r.patch!)
+    expect(r.patch?.ops).toHaveLength(1) // read 는 patch 에 안 잡히고 modifyScene 만
+    const after: any = applyScenePatch(initial, r.patch!)
     expect(after.sky).toBe('color')
     expect(after.skyColor).toBe('#0a1929')
     expect(after.exposure).toBe(0.7)
@@ -237,7 +237,7 @@ describe('통합 — removeComponentByRefid', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: '36 삭제' }], initial)
 
-    const after = applyBoardEditPatch(initial, r.patch!)
+    const after = applyScenePatch(initial, r.patch!)
     expect(after.components).toHaveLength(2)
     expect(after.components.map((c: any) => c.refid)).toEqual([35, 37])
   })
@@ -265,7 +265,7 @@ describe('통합 — replaceBoard', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: '갈아엎어' }], initial)
 
-    const after: any = applyBoardEditPatch(initial, r.patch!)
+    const after: any = applyScenePatch(initial, r.patch!)
     expect(after.width).toBe(1920)
     expect(after.height).toBe(1080)
     expect(after.fillStyle).toBe('#000')
@@ -296,7 +296,7 @@ describe('통합 — read-then-write 다중 turn', () => {
     expect(callLog).toHaveLength(3)
     expect(r.patch?.ops).toHaveLength(1) // read 는 patch 에 안 들어감
     expect(r.patch?.ops[0].op).toBe('modify')
-    const after = applyBoardEditPatch(initial, r.patch!)
+    const after = applyScenePatch(initial, r.patch!)
     expect((after.components[0] as any).left).toBe(100)
   })
 
@@ -324,7 +324,7 @@ describe('통합 — read-then-write 다중 turn', () => {
     const r = await a.chat([{ role: 'user', content: 'rect 다 빨갛게' }], initial)
 
     expect(r.patch?.ops).toHaveLength(2)
-    const after = applyBoardEditPatch(initial, r.patch!)
+    const after = applyScenePatch(initial, r.patch!)
     expect((after.components[0] as any).fillStyle).toBe('#ff0000') // rect
     expect((after.components[1] as any).fillStyle).toBe('#ff0000') // rect
     expect((after.components[2] as any).fillStyle).toBe('#fff') // circle 무영향
@@ -353,7 +353,7 @@ describe('통합 — write + action 혼합', () => {
     expect(r.actions![0]).toEqual({ action: 'setSceneMode', mode: 'view' })
 
     // apply-patch 는 patch.ops 만 처리 (actions 는 호스트가 별도 처리)
-    const after = applyBoardEditPatch(initial, r.patch!)
+    const after = applyScenePatch(initial, r.patch!)
     expect((after.components[0] as any).left).toBe(100)
   })
 
@@ -393,11 +393,11 @@ describe('통합 — 다중 op 한 patch 안 순차 적용', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: 'circle 추가하고 1 left=50' }], initial)
 
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(2)
-    expect(verbose.board.components).toHaveLength(2)
-    expect((verbose.board.components[0] as any).left).toBe(50)
-    expect((verbose.board.components[1] as any).type).toBe('circle')
+    expect(verbose.model.components).toHaveLength(2)
+    expect((verbose.model.components[0] as any).left).toBe(50)
+    expect((verbose.model.components[1] as any).type).toBe('circle')
   })
 
   test('일부 applied + 일부 missed 혼합', async () => {
@@ -415,10 +415,10 @@ describe('통합 — 다중 op 한 patch 안 순차 적용', () => {
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: 'do' }], initial)
 
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(2) // refid 1 modify + add
     expect(verbose.missed).toHaveLength(1) // refid 999 modify
-    expect(verbose.board.components).toHaveLength(2)
+    expect(verbose.model.components).toHaveLength(2)
   })
 })
 
@@ -441,10 +441,10 @@ describe('통합 — Phase 2 scene 조작 op (모델 차원 noop, scene API 정
 
     expect(r.patch?.ops).toHaveLength(1)
     expect(r.patch?.ops[0]).toEqual({ op: 'align', refids: [1, 2], direction: 'left' })
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(1)
     expect(verbose.missed).toHaveLength(0)
-    expect(verbose.board).toBe(initial) // model 차원에선 reference 동일
+    expect(verbose.model).toBe(initial) // model 차원에선 reference 동일
   })
 
   test('group + zorder 혼합', async () => {
@@ -465,7 +465,7 @@ describe('통합 — Phase 2 scene 조작 op (모델 차원 noop, scene API 정
     const r = await a.chat([{ role: 'user', content: '그룹 + 앞으로' }], initial)
 
     expect(r.patch?.ops).toHaveLength(2)
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(2)
     expect(verbose.missed).toHaveLength(0)
   })
@@ -482,7 +482,7 @@ describe('통합 — text-only 응답 (patch 없음)', () => {
     expect(r.patch).toBeUndefined()
     expect(r.actions).toBeUndefined()
     // 보드도 변경 없음
-    const after = applyBoardEditPatch(initial, { ops: [], summary: '', confidence: 0 })
+    const after = applyScenePatch(initial, { ops: [], summary: '', confidence: 0 })
     expect(after).toBe(initial)
   })
 })
@@ -517,7 +517,7 @@ describe('통합 — Prefab (검증된 복합 컴포넌트 한 번에 추가)',
 
     expect(callLog).toHaveLength(3) // read → write → finalize
     expect(r.patch?.ops).toHaveLength(1) // addPrefab → 단일 add op
-    const after = applyBoardEditPatch(initial, r.patch!)
+    const after = applyScenePatch(initial, r.patch!)
     expect(after.components).toHaveLength(1)
     const added: any = after.components[0]
     expect(added.type).toBe('group') // prefab 은 group 으로 wrapping
@@ -573,7 +573,7 @@ describe('통합 — Prefab (검증된 복합 컴포넌트 한 번에 추가)',
     const r = await a.chat([{ role: 'user', content: 'KPI 타일 3개' }], initial)
 
     expect(r.patch?.ops).toHaveLength(3)
-    const after = applyBoardEditPatch(initial, r.patch!)
+    const after = applyScenePatch(initial, r.patch!)
     expect(after.components).toHaveLength(3)
     // 각 타일이 group 이고 fillStyle 이 다름 (옵션 반영)
     const fills = (after.components as any[])
@@ -582,7 +582,7 @@ describe('통합 — Prefab (검증된 복합 컴포넌트 한 번에 추가)',
     expect(fills).toEqual(['#0ea5e9', '#10b981', '#ef4444'])
   })
 
-  test('잘못된 prefab name → patch 에 누락 (silent skip — toolCallToBoardEditOp 가 null 반환)', async () => {
+  test('잘못된 prefab name → patch 에 누락 (silent skip — toolCallToSceneEditOp 가 null 반환)', async () => {
     const initial = makeBoard()
     const { client } = makeMockClient([
       {
@@ -598,7 +598,7 @@ describe('통합 — Prefab (검증된 복합 컴포넌트 한 번에 추가)',
     ])
     const a = new DefaultBoardAIAssistant(client)
     const r = await a.chat([{ role: 'user', content: 'x' }], initial)
-    // 잘못된 prefab → toolCallToBoardEditOp 가 null → patch 에 op 미추가
+    // 잘못된 prefab → toolCallToSceneEditOp 가 null → patch 에 op 미추가
     expect(r.patch).toBeUndefined()
   })
 })
@@ -622,7 +622,7 @@ describe('통합 — Design system 카탈로그 (color palette + layout template
         toolCalls: [
           {
             id: 'w1',
-            name: 'modifyBoard',
+            name: 'modifyScene',
             arguments: { patch: { fillStyle: '#0f1722' } } // industrial-steel.base
           },
           {
@@ -663,7 +663,7 @@ describe('통합 — Design system 카탈로그 (color palette + layout template
     expect(readNames).toContain('getLayoutTemplates')
 
     // patch 적용 후 보드 배경 + 2 prefab tile
-    const after: any = applyBoardEditPatch(initial, r.patch!)
+    const after: any = applyScenePatch(initial, r.patch!)
     expect(after.fillStyle).toBe('#0f1722') // industrial-steel.base
     expect(after.components).toHaveLength(2)
     // 모두 group prefab
@@ -868,10 +868,10 @@ describe('통합 — Sugar layout (arrange grid/row/column)', () => {
       expect(r.patch.ops[0].layout).toEqual({ type: 'grid', cols: 3 })
     }
     // model 차원 noop — 호스트가 정본 (board-edit-dispatch 가 위치 계산)
-    const verbose = applyBoardEditPatchVerbose(initial, r.patch!)
+    const verbose = applyScenePatchVerbose(initial, r.patch!)
     expect(verbose.applied).toHaveLength(1)
     expect(verbose.missed).toHaveLength(0)
-    expect(verbose.board).toBe(initial) // model 동일
+    expect(verbose.model).toBe(initial) // model 동일
   })
 
   test('"한 줄로 가운데 정렬" → arrangeInRow + align:center', async () => {

package/server/service/assistant-llm-smoke.test.ts

@@ -171,7 +171,7 @@ describeIf('LLM 스모크 — 실제 모델 tool 선택 검증', () => {
   )
 
   test(
-    '"보드 배경 어둡게" → modifyBoard',
+    '"보드 배경 어둡게" → modifyScene',
     async () => {
       const a = new DefaultBoardAIAssistant(client)
       const r = await a.chat(
@@ -181,14 +181,14 @@ describeIf('LLM 스모크 — 실제 모델 tool 선택 검증', () => {
       )
       const names = (r.toolUsages ?? []).map((u: any) => u.name)
       dumpUsages(r.toolUsages)
-      // modifyBoard 또는 atmosphere primer + modifyBoard 둘 다 OK
-      expect(names).toContain('modifyBoard')
+      // modifyScene 또는 atmosphere primer + modifyScene 둘 다 OK
+      expect(names).toContain('modifyScene')
     },
     TIMEOUT_MS
   )
 
   test(
-    '"심해 분위기로" → getAtmosphereGuide + modifyBoard 패턴',
+    '"심해 분위기로" → getAtmosphereGuide + modifyScene 패턴',
     async () => {
       const a = new DefaultBoardAIAssistant(client)
       const r = await a.chat(
@@ -200,7 +200,7 @@ describeIf('LLM 스모크 — 실제 모델 tool 선택 검증', () => {
       dumpUsages(r.toolUsages)
       // 핵심: AI 가 atmosphere primer 를 활용 (LLM 이 atmosphere 모르더라도 우리
       // primer 가이드를 호출해야 일관된 결과 — 시스템 프롬프트의 의도)
-      expect(names).toContain('modifyBoard')
+      expect(names).toContain('modifyScene')
     },
     TIMEOUT_MS
   )