@things-factory/board-ai 10.1.24 → 10.1.26

package/server/service/assistant.ts

@@ -16,8 +16,6 @@ import {
 } from '@things-factory/board-import'
 import type {
   BoardAIAssistant,
-  BoardEditOp,
-  BoardEditPatch,
   ChatOptions,
   ChatResponse,
   ComponentSchema,
@@ -49,7 +47,7 @@ import {
   type ToolGate as NeutralToolGate,
   type AgenticLoopResult
 } from '@things-factory/ai-client-base'
-import type { BoardActionOp } from './types.js'
+import type { SceneActionOp, SceneEditOp, SceneEditPatch } from '@operato/scene-ops'
 
 /** 이 대화면의 도구가 알아야 하는 것 — 루프는 나르기만 한다. */
 type BoardToolContext = { board: BoardModel | undefined; selectedRefids: number[] }
@@ -246,7 +244,7 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
       return undefined
     }
 
-    const loopResult = await runAgenticLoop<BoardToolContext, BoardActionOp>({
+    const loopResult = await runAgenticLoop<BoardToolContext, SceneActionOp>({
       initialConversation: conversation,
       tools,
       options: {
@@ -266,7 +264,7 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
         executeReadTool: (tc, ctx) => wrappedExecuteReadTool(tc, ctx.board, ctx.selectedRefids),
         /* 문서에서 부품을 꺼내는 일은 **여기서** 한다 — 루프는 board 의 모양을 모른다. */
         validateWriteToolCall: (tc, ctx) => validateWriteToolCall(tc, (ctx.board?.components ?? []) as any[]),
-        toolCallToOp: toolCallToBoardActionOp,
+        toolCallToOp: toolCallToSceneActionOp,
         summarizeToolResult
       },
       context: { board: currentBoard, selectedRefids }
@@ -277,11 +275,11 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
     const lastText = loopResult.lastText
     const stopReason = loopResult.stopReason
 
-    // accumulated write calls → BoardEditPatch (tool 이 array 반환 가능 — flat)
+    // accumulated write calls → SceneEditPatch (tool 이 array 반환 가능 — flat)
     const components = (currentBoard?.components ?? []) as any[]
     const ops = accumulatedWriteCalls
       .flatMap(call => {
-        const r = toolCallToBoardEditOp(call, components, gate)
+        const r = toolCallToSceneEditOp(call, components, gate)
         if (r === null) return []
         return Array.isArray(r) ? r : [r]
       })
@@ -291,7 +289,7 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
     const baseReply = lastText || (ops.length > 0 ? '변경했습니다.' : '')
     const reply = baseReply + formatAbortNotice(loopResult.abortReason)
 
-    let patch: BoardEditPatch | undefined
+    let patch: SceneEditPatch | undefined
     if (ops.length > 0) {
       patch = {
         ops,
@@ -390,7 +388,7 @@ export class DefaultBoardAIAssistant implements BoardAIAssistant {
 아무것도 안 바뀌었기 때문.
 
 룰:
-  1. 변경 요청 → write tool 호출 필수 (modifyBoard / setFill / setStroke / setMaterial /
+  1. 변경 요청 → write tool 호출 필수 (modifyScene / setFill / setStroke / setMaterial /
      setShadow / setOpacity / setVisible / setFont / setText / setMaterial / addComponent /
      removeComponentByRefid / modifyComponentByRefid / align/distribute/group/zorder 등)
   2. 호출 + 짧은 reply 텍스트 동시 작성 OK — reply 는 *결과* 를 한국어로 한두 문장 요약
@@ -414,22 +412,22 @@ root-level properties separate from any child:
     - 3D 환경: \`sky\` / \`skyColor\` / \`exposure\` / \`hemi*\` / \`dirLight*\` / \`dirShadow*\` / \`camera*\` / \`autoRotate\`
     - 식별: \`id\`, \`refid\`, \`type\` ("model-layer")
     ⚠ 보드 \*\*name\*\* 은 root attribute 가 아님 — Board 엔티티의 DB 컬럼이지 scene
-    MODEL 의 필드가 아님 (model-layer 가 무시). 보드 라벨 변경은 modifyBoard 영역 X.
+    MODEL 의 필드가 아님 (model-layer 가 무시). 보드 라벨 변경은 modifyScene 영역 X.
   • Children: an array of components inside the board (rect / circle / text /
     gauge / etc.). 컴포넌트들은 \`name\` (user label) 를 가질 수 있음 — 이는 child
     component 의 속성이지 board root 의 속성이 아님.
 
 Rules:
   - To change a board-level attribute (background, board size, 3D atmosphere)
-    → call \`modifyBoard({ patch: { fillStyle: ..., width: ..., sky: ..., exposure: ..., dirLight*: ..., hemi*: ... } })\`.
+    → call \`modifyScene({ patch: { fillStyle: ..., width: ..., sky: ..., exposure: ..., dirLight*: ..., hemi*: ... } })\`.
     NOTE: 보드 라벨/제목 ("보드 이름") 은 scene model 이 아니라 Board *엔티티* 의 컬럼.
-    things-scene 의 model-layer 는 \`name\` 을 인식하지 않음. modifyBoard 의 patch 에
+    things-scene 의 model-layer 는 \`name\` 을 인식하지 않음. modifyScene 의 patch 에
     \`name\` 을 넣지 말 것 — 죽은 필드로 박힐 뿐 효과 없음.
   - To change a CHILD COMPONENT's attribute → call \`modifyComponentByRefid\`.
-  - DO NOT use modifyBoard to change a child. DO NOT use modifyComponentByRefid
+  - DO NOT use modifyScene to change a child. DO NOT use modifyComponentByRefid
     to change board background.
   - "보드 배경색", "board background", "테두리/캔버스 크기" 같은 요청은 root
-    attribute 변경 → \`modifyBoard\`.
+    attribute 변경 → \`modifyScene\`.
 
 ==== COMPONENT TREE (NESTING) ====
 컴포넌트는 *재귀 구조*. group / container 같은 부모 컴포넌트는 자기 \`components\`
@@ -495,8 +493,8 @@ to that wording in your reply. Do not echo refid back to the user.
 
 ==== AVAILABLE TOOLS ====
 Board-level (root attributes):
-  - modifyBoard: change board's own fillStyle / width / height / fitMode / translate / scale AND 3D atmosphere (sky / skyColor / exposure / hemiSkyColor / hemiGroundColor / hemiIntensity / dirLightEnabled / dirLightColor / dirLightIntensity / dirLightFollowCamera / dirLightAzimuth / dirLightElevation / dirShadow* / camera* / autoRotate / initialCameraView). ⚠ "name" 금지 — scene MODEL 이 아니라 Board 엔티티 컬럼.
-  - replaceBoard: wholesale board reset (heavy — prefer modifyBoard for most changes)
+  - modifyScene: change board's own fillStyle / width / height / fitMode / translate / scale AND 3D atmosphere (sky / skyColor / exposure / hemiSkyColor / hemiGroundColor / hemiIntensity / dirLightEnabled / dirLightColor / dirLightIntensity / dirLightFollowCamera / dirLightAzimuth / dirLightElevation / dirShadow* / camera* / autoRotate / initialCameraView). ⚠ "name" 금지 — scene MODEL 이 아니라 Board 엔티티 컬럼.
+  - replaceBoard: wholesale board reset (heavy — prefer modifyScene for most changes)
 Child components — data:
   - addComponent: add a new component (parallel calls for multiple adds)
   - removeComponentByRefid: remove a child by refid
@@ -553,10 +551,10 @@ Modeller actions (ephemeral — does NOT modify the board model, no undo, no sav
   - fitToView: reset view so the board fits the canvas (mode: fit/ratio/width/height)
   - setSceneMode: switch modeller between 'edit' and 'view' modes
 Knowledge:
-  - getAtmosphereGuide: 3D atmosphere synthesis primer — parameter physics, ranges, color theory, archetype recipes (time-of-day / indoor / surreal). Call BEFORE applying atmospheric/styling modifyBoard for any natural-language mood request.
+  - getAtmosphereGuide: 3D atmosphere synthesis primer — parameter physics, ranges, color theory, archetype recipes (time-of-day / indoor / surreal). Call BEFORE applying atmospheric/styling modifyScene for any natural-language mood request.
 
 ==== 3D ATMOSPHERE SYNTHESIS ====
-3D scene atmosphere = combination of (1) sky preset / color (2) exposure (3) hemisphere ambient (4) directional sun/key (5) floor material. ALL of these are root-level board attributes — applied via a SINGLE modifyBoard call.
+3D scene atmosphere = combination of (1) sky preset / color (2) exposure (3) hemisphere ambient (4) directional sun/key (5) floor material. ALL of these are root-level board attributes — applied via a SINGLE modifyScene call.
 
 For ANY natural-language atmospheric request — "공장 분위기로", "심해 컬러", "황혼", "사이버펑크", "안개 자욱한 새벽", "1980 우주정거장", "따뜻하게", "차갑고 극적으로" — follow this workflow:
 
@@ -564,11 +562,11 @@ For ANY natural-language atmospheric request — "공장 분위기로", "심해
   2. From the guide's "archetypes" section, pick the closest base recipe (time-of-day / indoor / surreal). Interpolate if user combines multiple cues.
   3. Apply user's nuance via the guide's "modifiers" (warm/cool, drama, saturation, contrast).
   4. Sanity-check: avoid washout (all params maxed) or mud (all minned). Confirm hemi sky/ground colors and dir color are consistent with the mood.
-  5. Apply ALL keys in ONE modifyBoard({patch}) call (sky, skyColor?, exposure, hemiIntensity, hemiSkyColor, hemiGroundColor, dirLightEnabled, dirLightColor, dirLightIntensity, dirLightFollowCamera=false, dirLightAzimuth, dirLightElevation, fillStyle?). ONE patch — not multiple modifyBoard calls.
+  5. Apply ALL keys in ONE modifyScene({patch}) call (sky, skyColor?, exposure, hemiIntensity, hemiSkyColor, hemiGroundColor, dirLightEnabled, dirLightColor, dirLightIntensity, dirLightFollowCamera=false, dirLightAzimuth, dirLightElevation, fillStyle?). ONE patch — not multiple modifyScene calls.
   6. In the reply, briefly state which archetype + modifier you composed.
 
 Avoid:
-  - Calling modifyBoard with only "fillStyle" for atmospheric requests — that only changes 2D background and floor tint, NOT the 3D scene mood.
+  - Calling modifyScene with only "fillStyle" for atmospheric requests — that only changes 2D background and floor tint, NOT the 3D scene mood.
   - Mixing a sky preset with explicit skyColor (preset wins, skyColor ignored).
   - Setting dirLightAzimuth/Elevation while leaving dirLightFollowCamera=true (no effect — set follow=false first).
   - Using only canned presets when the user describes a custom mood — the guide enables synthesis beyond presets.
@@ -761,7 +759,7 @@ export function buildBoardEditTools(knownTypes: string[], exposure: ToolExposure
       }
     },
     {
-      name: 'modifyBoard',
+      name: 'modifyScene',
       description:
         "Modify the BOARD's OWN root-level properties — the board itself is the topmost parent (model-layer) and has its own attributes (NOT child components). Valid root keys (things-scene 의 model-layer 가 실제 인식하는 것만):\n  • Layout/Geometry: `width`, `height`, `fitMode` ('ratio'|'both'|'width'|'height'|'center'|'none'), `translate` ({x,y}), `scale` ({x,y})\n  • 2D 배경: `fillStyle` (string color or object)\n  • 3D Sky: `sky` (preset 이름), `skyColor` (preset 미지정 시 단색)\n  • 3D Tone: `exposure` (toneMappingExposure, 기본 1.0~1.2)\n  • 3D Hemisphere light: `hemiSkyColor`, `hemiGroundColor`, `hemiIntensity` (기본 4.0)\n  • 3D Directional light: `dirLightEnabled` (bool), `dirLightColor`, `dirLightIntensity` (기본 2.0), `dirLightFollowCamera` (bool, 기본 true), `dirLightAzimuth` (deg, follow=false 일 때만), `dirLightElevation` (deg, follow=false 일 때만)\n  • 3D Shadow: `dirShadowEnabled`, `dirShadowMapSize` (기본 2048), `dirShadowBias`\n  • 3D Camera: `cameraX`, `cameraY`, `cameraZ`, `cameraAutoPlay` ('orbit' 등), `autoRotate` (bool), `initialCameraView`\n\n⚠ 절대 사용 금지: `name` — Board *엔티티* 의 컬럼이지 scene MODEL 의 필드가 아님. things-scene 이 인식 안 함. 보드 라벨 변경은 GraphQL boardPatch 의 영역.\n\nDo NOT use for child component edits (use modifyComponentByRefid for those). Do NOT pass a `components` array here — children are managed by add/remove/modify ops separately.",
       parameters: {
@@ -780,7 +778,7 @@ export function buildBoardEditTools(knownTypes: string[], exposure: ToolExposure
     {
       name: 'replaceBoard',
       description:
-        'Replace the entire board (use ONLY for fresh start or wholesale redesign — heavy operation that resets undo history). For just changing background or size, prefer modifyBoard. Provide width/height and the full components array.',
+        'Replace the entire board (use ONLY for fresh start or wholesale redesign — heavy operation that resets undo history). For just changing background or size, prefer modifyScene. Provide width/height and the full components array.',
       parameters: {
         type: 'object',
         properties: {
@@ -856,7 +854,7 @@ export function buildBoardEditTools(knownTypes: string[], exposure: ToolExposure
     {
       name: 'getAtmosphereGuide',
       description:
-        "Get a comprehensive 3D atmosphere synthesis guide — parameter physics (sky / exposure / hemisphere / directional / shadow / floor / camera), sane ranges, color theory, time-of-day archetypes, and indoor/surreal mood recipes. Call this BEFORE applying atmospheric/styling changes via modifyBoard whenever the user describes a mood / scene / time-of-day in natural language (e.g. '심해 컬러', '황혼', '공장 분위기', '사이버펑크', '안개 자욱한 새벽'). The guide enables you to synthesize concrete parameter values yourself, beyond canned presets.",
+        "Get a comprehensive 3D atmosphere synthesis guide — parameter physics (sky / exposure / hemisphere / directional / shadow / floor / camera), sane ranges, color theory, time-of-day archetypes, and indoor/surreal mood recipes. Call this BEFORE applying atmospheric/styling changes via modifyScene whenever the user describes a mood / scene / time-of-day in natural language (e.g. '심해 컬러', '황혼', '공장 분위기', '사이버펑크', '안개 자욱한 새벽'). The guide enables you to synthesize concrete parameter values yourself, beyond canned presets.",
       parameters: { type: 'object', properties: {} }
     },
     {
@@ -1215,7 +1213,7 @@ const WRITE_TOOL_NAMES = new Set([
   'setShadowProperties',
   'clearStyle',
   'copyStyle',
-  'modifyBoard',
+  'modifyScene',
   'replaceBoard',
   // Phase 2 — model 차원 scene 조작 (좌표/구조/zorder)
   'alignComponents',
@@ -1232,7 +1230,7 @@ const WRITE_TOOL_NAMES = new Set([
 ])
 /**
  * C-1 — ephemeral scene 조작 (selection / view / mode). model 변경 X, undo 영향 X.
- * 별도 ChatResponse.actions 채널로 전달 → 호스트가 board-action-execute 로 적용.
+ * 별도 ChatResponse.actions 채널로 전달 → 호스트가 scene-action-execute 로 적용.
  */
 const ACTION_TOOL_NAMES = new Set([
   'selectComponents',
@@ -1377,14 +1375,14 @@ export function executeReadTool(
  *
  * 의도 — preset 한 단어로 끝나지 않는 사용자 요청 ("심해", "황혼", "1980 우주정거장",
  * "안개 새벽") 에 AI 가 구체적 파라미터 값을 직접 합성하도록 물리/색채/미학 지식
- * 동시 제공. AI 는 이 가이드를 받은 뒤 modifyBoard 로 한 번에 적용.
+ * 동시 제공. AI 는 이 가이드를 받은 뒤 modifyScene 로 한 번에 적용.
  *
- * things-scene 의 board model 에 들어가는 root level 키만 다룸 (modifyBoard 로
+ * things-scene 의 board model 에 들어가는 root level 키만 다룸 (modifyScene 로
  * 적용 가능한 것). camera position 같은 ephemeral 한 것은 별도 영역.
  */
 const ATMOSPHERE_GUIDE = {
   overview:
-    '3D 보드 분위기는 (1) sky preset 또는 단색 (2) tone mapping exposure (3) hemisphere ambient (4) directional sun/key (5) floor 의 조합. 모두 board root model 의 속성이라 modifyBoard 단일 op 로 한 번에 적용. 자연어 요청은 archetype 레시피를 base 로 잡고 modifier 로 fine-tune.',
+    '3D 보드 분위기는 (1) sky preset 또는 단색 (2) tone mapping exposure (3) hemisphere ambient (4) directional sun/key (5) floor 의 조합. 모두 board root model 의 속성이라 modifyScene 단일 op 로 한 번에 적용. 자연어 요청은 archetype 레시피를 base 로 잡고 modifier 로 fine-tune.',
 
   parameters: {
     sky: {
@@ -1724,7 +1722,7 @@ const ATMOSPHERE_GUIDE = {
     '2. archetypes 에서 가장 가까운 base 레시피 선택.',
     '3. modifiers 로 사용자 요청 뉘앙스 fine-tune (warm/cool/drama/...).',
     '4. sanity check — exposure × hemi × dir 어느 한쪽 극단 아닌지, hemi sky/ground 색 모순 없는지.',
-    "5. modifyBoard({ patch: { ...combined keys... } }) 한 번에 적용. 사용자에게 어떤 archetype + modifier 조합으로 갔는지 한 줄로 설명."
+    "5. modifyScene({ patch: { ...combined keys... } }) 한 번에 적용. 사용자에게 어떤 archetype + modifier 조합으로 갔는지 한 줄로 설명."
   ],
 
   pitfalls: [
@@ -1746,7 +1744,7 @@ const ATMOSPHERE_GUIDE = {
  * 사용 흐름:
  *   1. 사용자 의도 (산업 / 금융 / 의료 / SF / ...) 식별
  *   2. recommendations 에서 매칭 후보 1~2개 추림
- *   3. modifyBoard 로 board.fillStyle 을 palette.base 로 설정
+ *   3. modifyScene 로 board.fillStyle 을 palette.base 로 설정
  *   4. addPrefab / addComponent 시 palette 의 surface/accent/text 사용
  *   5. 일관된 룩 → 한 번 정한 팔레트 안에서만 색 선택
  *
@@ -1877,7 +1875,7 @@ const COLOR_PALETTES = {
   workflow: [
     '1. 사용자 도메인 / 분위기 키워드 식별 — 산업/금융/관제/의료/SF/프레젠테이션',
     '2. recommendations 에서 매칭 후보 추림. 사용자 모호하면 가장 흔한 industrial-steel 디폴트.',
-    "3. modifyBoard({ patch: { fillStyle: palette.base } }) 으로 보드 배경 set.",
+    "3. modifyScene({ patch: { fillStyle: palette.base } }) 으로 보드 배경 set.",
     '4. 이후 모든 add / addPrefab 호출 시 palette.surface / accent / text / border 사용. 자유 색 X.',
     '5. status 표시는 success / warning / danger / info 4종에서만 — 자체 hex 만들지 마라.'
   ],
@@ -2109,13 +2107,13 @@ function buildExternalCategoryDefinitions(
 }
 
 /**
- * Tool call → BoardActionOp 변환 (C-1 ephemeral scene 조작).
+ * Tool call → SceneActionOp 변환 (C-1 ephemeral scene 조작).
  * 잘못된 인자는 null — agentic loop 가 Unknown tool 비슷하게 처리.
  */
-export function toolCallToBoardActionOp(
+export function toolCallToSceneActionOp(
   tc: AIToolCall,
   gate: ToolGate = buildToolGate()
-): import('./types.js').BoardActionOp | null {
+): import('@operato/scene-ops').SceneActionOp | null {
   const args = tc.arguments ?? {}
   /* 씬 조작 액션은 전부 코어(보드) 능력 — 노출 안 된 대화에서는 만들지 않는다.
    * loop 는 gate.isAction 으로 이미 걸러내지만, 다른 호출부의 오용도 막는다. */
@@ -2147,7 +2145,7 @@ export function toolCallToBoardActionOp(
   }
 }
 
-// ── Tool call → BoardEditOp 변환 ───────────────────────────────────
+// ── Tool call → SceneEditOp 변환 ───────────────────────────────────
 
 /**
  * AIToolChatResult → ChatResponse.
@@ -2160,14 +2158,14 @@ export function toolCallToBoardActionOp(
 export function toolResultToChatResponse(result: AIToolChatResult): ChatResponse {
   const ops = result.toolCalls
     .flatMap(call => {
-      const r = toolCallToBoardEditOp(call)
+      const r = toolCallToSceneEditOp(call)
       if (r === null) return []
       return Array.isArray(r) ? r : [r]
     })
 
   const reply = result.text || (ops.length > 0 ? '변경했습니다.' : '')
 
-  let patch: BoardEditPatch | undefined
+  let patch: SceneEditPatch | undefined
   if (ops.length > 0) {
     patch = {
       ops,
@@ -2179,11 +2177,11 @@ export function toolResultToChatResponse(result: AIToolChatResult): ChatResponse
   return { reply, patch, followUp: undefined }
 }
 
-export function toolCallToBoardEditOp(
+export function toolCallToSceneEditOp(
   tc: AIToolCall,
   components: ReadonlyArray<any> = [],
   gate: ToolGate = buildToolGate()
-): BoardEditOp | BoardEditOp[] | null {
+): SceneEditOp | SceneEditOp[] | null {
   const args = tc.arguments ?? {}
   /* 노출되지 않은 코어(보드 편집) 도구는 op 를 만들지 않는다 — 정의를 숨겼어도 호출은 올 수 있다. */
   if (!gate.coreOn && !gate.spec(tc.name)) return null
@@ -2194,7 +2192,7 @@ export function toolCallToBoardEditOp(
     return dispatchStylingTool(tc.name, args, components)
   }
   // tool-registry plugin point — 외부 등록 'write' 카테고리 dispatch.
-  // builder 결과는 BoardEditOp[] | { ops, errors? } | null 셋 중 하나.
+  // builder 결과는 SceneEditOp[] | { ops, errors? } | null 셋 중 하나.
   // (read/external 카테고리는 별도 dispatch path — agentic loop 의 executeReadTool 이 직접 처리.)
   const registrySpec = gate.spec(tc.name)
   if (registrySpec && registrySpec.kind === 'write') {
@@ -2220,15 +2218,15 @@ export function toolCallToBoardEditOp(
     // 모든 styling tool (setFill/setStroke/setText/setFont/setShadow/setOpacity/
     // setVisible/setMaterial/setShadowProperties/clearStyle/copyStyle) 은 registry
     // 가 처리 — 상단 isStylingTool 분기 참조
-    case 'modifyBoard': {
+    case 'modifyScene': {
       if (!args.patch || typeof args.patch !== 'object' || Array.isArray(args.patch)) return null
-      return { op: 'modifyBoard', patch: args.patch as Partial<BoardModel> }
+      return { op: 'modifyScene', patch: args.patch as Partial<BoardModel> }
     }
     case 'replaceBoard': {
       if (!Array.isArray(args.components)) return null
       return {
         op: 'replace',
-        board: {
+        model: {
           width: typeof args.width === 'number' ? args.width : undefined,
           height: typeof args.height === 'number' ? args.height : undefined,
           fillStyle: typeof args.fillStyle === 'string' ? args.fillStyle : undefined,

package/server/service/board-ai-resolver.ts

@@ -190,7 +190,7 @@ class BoardAIChatOutput {
   @Field({ description: 'Conversational reply.' })
   reply: string
 
-  @Field(() => GraphQLJSON, { nullable: true, description: 'BoardEditPatch.' })
+  @Field(() => GraphQLJSON, { nullable: true, description: 'SceneEditPatch.' })
   patch?: any
 
   @Field({ nullable: true, description: 'Clarifying question when input is ambiguous.' })
@@ -221,7 +221,7 @@ class BoardAIChatOutput {
   @Field(() => GraphQLJSON, {
     nullable: true,
     description:
-      'Ephemeral scene actions (selection/view/mode) — sequence of BoardActionOp. Applied via board-action-execute event on the host. Distinct from `patch` which carries persistent model changes.'
+      'Ephemeral scene actions (selection/view/mode) — sequence of SceneActionOp. Applied via scene-action-execute event on the host. Distinct from `patch` which carries persistent model changes.'
   })
   actions?: any
 

package/server/service/index.ts

@@ -16,7 +16,6 @@ import { entities as PatchEntryEntities } from './patch-entry/index.js'
 
 export * from './types.js'
 export * from './assistant.js'
-export * from './apply-patch.js'
 export * from './prefab-registry.js'
 export * from './mention-resolver.js'
 export * from './catalog-resolver.js'

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

@@ -2,7 +2,7 @@
  * BoardPatchSubscription (Phase Board-AI C1 — op-브로드캐스트 spine).
  *
  * PatchEntry(AI 또는 user-direct 편집) 가 생성될 때마다 같은 board 구독자에게 방송 →
- * 실시간 공동편집의 척추. 클라이언트(C2)가 구독해 원격 patch 를 applyBoardEditPatch 로 적용.
+ * 실시간 공동편집의 척추. 클라이언트(C2)가 구독해 원격 patch 를 applyScenePatch 로 적용.
  *
  * 전송/패턴은 기존 board-service/board-subscription.ts 복제 (PubSub + graphql-ws, domain 격리).
  * 순수 로직(토픽/필터)은 board-patch-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.

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

@@ -48,7 +48,7 @@ export class PatchEntry {
   @Field({ description: "'ai' | 'user-direct' | 'import'" })
   source!: string
 
-  /** BoardEditOp[] JSON-stringified — column 으로는 long text. */
+  /** SceneEditOp[] JSON-stringified — column 으로는 long text. */
   @Column({
     type:
       DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
@@ -63,7 +63,7 @@ export class PatchEntry {
   ops!: string
 
   /** GraphQL 노출용 — JSON 객체로 변환. */
-  @Field(type => GraphQLJSON, { description: 'BoardEditOp[] (parsed JSON array).' })
+  @Field(type => GraphQLJSON, { description: 'SceneEditOp[] (parsed JSON array).' })
   get opsJson(): any {
     try {
       return JSON.parse(this.ops || '[]')

package/server/service/styling/clear-tools.ts

@@ -3,7 +3,7 @@
  *
  * preset 적용 전 / 데이터 바인딩 적용 전 깨끗한 상태로 돌리기 위한 helper.
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 
 export interface ClearStyleInput {
   refids: number[]
@@ -11,7 +11,7 @@ export interface ClearStyleInput {
 }
 
 export interface OpsResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 

package/server/service/styling/copy-tools.ts

@@ -9,7 +9,7 @@
  * 입력 — sourceRefid 의 실제 styling 값을 미리 알 필요 없음. server 가 components
  * 에서 source 찾아 styling 추출 후 target 들에 patch 생성.
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 
 export interface CopyStyleInput {
   sourceRefid: number
@@ -18,7 +18,7 @@ export interface CopyStyleInput {
 }
 
 export interface OpsResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 
@@ -52,7 +52,7 @@ const DEFAULT_ASPECTS: Array<keyof typeof ASPECT_FIELDS> = [
 ]
 
 /**
- * input + components 배열 → BoardEditOp[].
+ * input + components 배열 → SceneEditOp[].
  *
  * components 는 board 의 모든 컴포넌트 (caller 가 전달). source 찾아 styling 추출.
  */

package/server/service/styling/effect-tools.ts

@@ -5,7 +5,7 @@
  * setOpacity: state.alpha (컴포넌트 전체 알파, 0..1)
  * setVisible: state.hidden 토글 (true → 숨김)
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 import { normalizeColor, validateColor } from './color-utils'
 
 export interface SetShadowInput {
@@ -34,7 +34,7 @@ export interface SetVisibleInput {
 }
 
 export interface OpsResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 

package/server/service/styling/fill-tools.test.ts

@@ -1,5 +1,5 @@
 /**
- * fill-tools — setFill 입력 → BoardEditOp[] 변환 검증.
+ * fill-tools — setFill 입력 → SceneEditOp[] 변환 검증.
  *
  * 4 modes (none/solid/gradient/pattern) 별 동작 + 검증 + multi-target.
  *

package/server/service/styling/fill-tools.ts

@@ -17,7 +17,7 @@
  * 이전 2-op (null + new) 방식은 중간 null 상태가 onchange / 3D texture
  * 크래시 유발 → 제거. 정확한 colorStops 출력으로 stale 필드 문제는 자체 해결.
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 import { parseColor, normalizeColor, validateColor } from './color-utils'
 
 export interface SetFillInput {
@@ -59,12 +59,12 @@ export interface SetFillInput {
 }
 
 export interface SetFillResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]  // refid 별 에러 (성공한 것은 op 만 발사)
 }
 
 /**
- * setFill 입력 검증 + BoardEditOp[] 생성.
+ * setFill 입력 검증 + SceneEditOp[] 생성.
  *
  * 기본 정책:
  *   - refids 비어있거나 mode 도 색도 없으면 에러
@@ -73,7 +73,7 @@ export interface SetFillResult {
  */
 export function buildSetFillOps(input: SetFillInput): SetFillResult {
   const errors: string[] = []
-  const ops: BoardEditOp[] = []
+  const ops: SceneEditOp[] = []
 
   if (!Array.isArray(input.refids) || input.refids.length === 0) {
     return { ops: [], errors: ['refids must be a non-empty array of numbers'] }

package/server/service/styling/material-tools.ts

@@ -4,7 +4,7 @@
  * Material3D (`things-scene/src/threed/material-3d.ts`) 와 1:1 매핑.
  * preset 만 줘도 변경 가능 (resolveMaterial3d 가 default 위 override 적용).
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 import { normalizeColor, validateColor } from './color-utils'
 
 const MATERIAL_PRESETS = ['default', 'metal', 'glass', 'plastic', 'wood', 'ceramic', 'rubber', 'custom'] as const
@@ -29,7 +29,7 @@ export interface SetShadowPropertiesInput {
 }
 
 export interface OpsResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 

package/server/service/styling/registry.ts

@@ -12,10 +12,10 @@
  *   STYLING_TOOLS 는 초기엔 비어있고, 한 tool 씩 점진 이전한다. 각 단계마다
  *   기존 hardcoded 정의/dispatch 와 byte-단위 동등성을 단위 테스트가 잠금.
  *
- * 비-styling write tool (addComponent / modifyBoard / alignComponents 등) 은
+ * 비-styling write tool (addComponent / modifyScene / alignComponents 등) 은
  * 본 registry 의 영역이 아니다 — 의미·구조가 styling 패턴과 달라 별도 dispatch.
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 import { buildSetFillOps } from './fill-tools'
 import { buildSetStrokeOps } from './stroke-tools'
 import { buildSetTextOps, buildSetFontOps } from './text-tools'
@@ -25,7 +25,7 @@ import { buildClearStyleOps } from './clear-tools'
 import { buildCopyStyleOps } from './copy-tools'
 
 export interface OpsResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 
@@ -393,12 +393,12 @@ export function buildStylingToolDefinitions(
 }
 
 /**
- * AIToolCall name 에 매칭되는 styling tool 의 builder 호출 → BoardEditOp[] | null.
+ * AIToolCall name 에 매칭되는 styling tool 의 builder 호출 → SceneEditOp[] | null.
  *
  * 반환:
  *   - 매칭 spec 없음 → null (caller 가 다른 카테고리 dispatch 시도)
  *   - 빈 ops (validation 실패 등) → null (assistant.ts 의 기존 동작과 동일)
- *   - 정상 → BoardEditOp[]
+ *   - 정상 → SceneEditOp[]
  *
  * components 인자는 copyStyle 같은 source-lookup 필요 tool 에만 의미 있음.
  */
@@ -407,7 +407,7 @@ export function dispatchStylingTool(
   args: any,
   components: ReadonlyArray<any> = [],
   registry: ReadonlyArray<StylingToolSpec> = STYLING_TOOLS
-): BoardEditOp[] | null {
+): SceneEditOp[] | null {
   const spec = registry.find(s => s.name === name)
   if (!spec) return null
   const result = spec.builder(args, components)

package/server/service/styling/stroke-tools.test.ts

@@ -1,5 +1,5 @@
 /**
- * stroke-tools — buildSetStrokeOps 입력 → BoardEditOp[] 변환 검증.
+ * stroke-tools — buildSetStrokeOps 입력 → SceneEditOp[] 변환 검증.
  *
  * things-scene canonical fields (모두 top-level): strokeStyle (string color), lineWidth,
  * lineDash (preset 이름 string), lineCap, lineJoin. tool 파라미터 이름이 engine 필드와

package/server/service/styling/stroke-tools.ts

@@ -14,7 +14,7 @@
  * 입력 단순화 — AI 친화적 alias 도 받아 things-scene preset 으로 매핑:
  *   AI 'dashed' → 'dash', 'dotted' → 'square-dot', 'dashdot' → 'dash-dot'.
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 import { normalizeColor, validateColor } from './color-utils'
 
 export interface SetStrokeInput {
@@ -44,7 +44,7 @@ export interface SetStrokeInput {
 }
 
 export interface SetStrokeResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 
@@ -140,6 +140,6 @@ export function buildSetStrokeOps(input: SetStrokeInput): SetStrokeResult {
     patch.lineWidth = 0
   }
 
-  const ops: BoardEditOp[] = refids.map(refid => ({ op: 'modify', refid, patch }))
+  const ops: SceneEditOp[] = refids.map(refid => ({ op: 'modify', refid, patch }))
   return { ops, errors: [] }
 }

package/server/service/styling/text-tools.ts

@@ -7,7 +7,7 @@
  *
  * 두 tool 분리 — 의도가 다름. 내용 변경 vs 시각 스타일.
  */
-import type { BoardEditOp } from '../types'
+import type { SceneEditOp } from '@operato/scene-ops'
 import { normalizeColor, validateColor } from './color-utils'
 
 export interface SetTextInput {
@@ -44,7 +44,7 @@ const VALID_TEXT_BASELINE = new Set([
 ])
 
 export interface OpsResult {
-  ops: BoardEditOp[]
+  ops: SceneEditOp[]
   errors: string[]
 }
 

package/server/service/tool-exposure.test.ts

@@ -20,8 +20,8 @@ import {
 import {
   buildBoardEditTools,
   buildToolGate,
-  toolCallToBoardEditOp,
-  toolCallToBoardActionOp
+  toolCallToSceneEditOp,
+  toolCallToSceneActionOp
 } from './assistant'
 
 /* 두 개의 가짜 외부 카테고리 — 하나는 보드 저작 계열, 하나는 운영 계열. */
@@ -95,29 +95,29 @@ describe('도구 노출 게이트', () => {
     const gate = buildToolGate({ boardTools: false, toolCategories: ['test-ops'] })
     const components = [{ refid: 7, type: 'rect' }]
 
-    const add = toolCallToBoardEditOp({ id: 'x', name: 'addComponent', arguments: { type: 'rect' } } as any, components, gate)
+    const add = toolCallToSceneEditOp({ id: 'x', name: 'addComponent', arguments: { type: 'rect' } } as any, components, gate)
     expect(add).toBeNull()
 
-    const fill = toolCallToBoardEditOp(
+    const fill = toolCallToSceneEditOp(
       { id: 'x', name: 'setFill', arguments: { refids: [7], fillStyle: '#f00' } } as any,
       components,
       gate
     )
     expect(fill).toBeNull()
 
-    const action = toolCallToBoardActionOp({ id: 'x', name: 'selectComponents', arguments: { refids: [7] } } as any, gate)
+    const action = toolCallToSceneActionOp({ id: 'x', name: 'selectComponents', arguments: { refids: [7] } } as any, gate)
     expect(action).toBeNull()
   })
 
   it('허용되지 않은 외부 카테고리의 write 도구도 실행되지 않는다', () => {
     const gate = buildToolGate({ toolCategories: ['test-ops'] })
-    const r = toolCallToBoardEditOp({ id: 'x', name: 'testBindThing', arguments: { refid: 7 } } as any, [{ refid: 7 }], gate)
+    const r = toolCallToSceneEditOp({ id: 'x', name: 'testBindThing', arguments: { refid: 7 } } as any, [{ refid: 7 }], gate)
     expect(r).toBeNull()
   })
 
   it('허용된 카테고리의 write 도구는 정상 실행된다(게이트가 과잉 차단하지 않는다)', () => {
     const gate = buildToolGate({ toolCategories: ['test-authoring'] })
-    const r: any = toolCallToBoardEditOp({ id: 'x', name: 'testBindThing', arguments: { refid: 7 } } as any, [{ refid: 7 }], gate)
+    const r: any = toolCallToSceneEditOp({ id: 'x', name: 'testBindThing', arguments: { refid: 7 } } as any, [{ refid: 7 }], gate)
     expect(r).toEqual([{ op: 'modify', refid: 7, patch: { tag: 'bound' } }])
   })