@things-factory/figure-service 10.1.210 → 10.1.212

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.210",
+  "version": "10.1.212",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -27,16 +27,16 @@
   "dependencies": {
     "@hatiolab/figure-model": "^0.11.0",
     "@operato/typeorm-history": "^10.0.0",
-    "@things-factory/ai-client-base": "^10.1.208",
-    "@things-factory/attachment-base": "^10.1.208",
-    "@things-factory/auth-base": "^10.1.208",
+    "@things-factory/ai-client-base": "^10.1.212",
+    "@things-factory/attachment-base": "^10.1.212",
+    "@things-factory/auth-base": "^10.1.212",
     "@things-factory/env": "^10.1.149",
-    "@things-factory/setting-base": "^10.1.208",
+    "@things-factory/setting-base": "^10.1.212",
     "@things-factory/shell": "^10.1.208",
     "graphql-scalars": "^1.22.4",
     "graphql-upload": "^15.0.2",
     "jszip": "^3.10.1",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "89fbda12d43d8532ba4e95ba6d6d7e05e2da2502"
+  "gitHead": "1e1cdb79fca2915580429af451b6cf1dae653a93"
 }

package/recipes/belt-surface/guide.ko.md

@@ -15,4 +15,4 @@
 
 ## 알아 둘 것
 
-- 벨트는 움직이지 않습니다. 흐름은 도형의 능력(흐른다)으로 나타냅니다.
+- 벨트는 움직이지 않습니다. 흐름은 피규어의 능력(흐른다)으로 나타냅니다.

package/recipes/roller-row/facts.md

@@ -17,4 +17,4 @@
 
 ## 알려진 한계
 - 롤러는 X 방향으로만 줄을 선다.
-- 한 줄 100개를 넘는 길이에서는 그릴 수 없어, 도형의 가장 큰 크기가 줄어든다.
+- 한 줄 100개를 넘는 길이에서는 그릴 수 없어, 피규어의 가장 큰 크기가 줄어든다.

package/recipes/roller-row/guide.ko.md

@@ -17,4 +17,4 @@
 
 ## 알아 둘 것
 
-- 한 줄에 100개까지 놓입니다. 그보다 길어지는 크기에서는 도형의 가장 큰 크기가 줄어듭니다.
+- 한 줄에 100개까지 놓입니다. 그보다 길어지는 크기에서는 피규어의 가장 큰 크기가 줄어듭니다.

package/recipes/sliding-door/facts.md

@@ -23,4 +23,4 @@
 
 ## 알려진 한계
 - 문짝은 문틀 앞에서 미끄러지며, 열리면 기둥 앞을 지난다(벽 속으로 들어가지 않는다).
-- 문틀 폭이 600 mm 이하가 되는 크기에서는 그릴 수 없어, 도형에 선언된 크기가 있으면 가장 작은 크기가 올라간다(넣을 때 알리지 않는다).
+- 문틀 폭이 600 mm 이하가 되는 크기에서는 그릴 수 없어, 피규어에 선언된 크기가 있으면 가장 작은 크기가 올라간다(넣을 때 알리지 않는다).

package/recipes/sliding-door/guide.ko.md

@@ -19,4 +19,4 @@
 ## 알아 둘 것
 
 - 문짝은 문틀 앞에서 미끄러지고, 다 열리면 기둥 앞에 겹칩니다.
-- 문틀 폭이 기둥 두 개보다 좁아지는 크기에서는 문을 그릴 수 없습니다. 도형에 크기가 선언되어 있으면 그 가장 작은 크기가 올라갑니다.
+- 문틀 폭이 기둥 두 개보다 좁아지는 크기에서는 문을 그릴 수 없습니다. 피규어에 크기가 선언되어 있으면 그 가장 작은 크기가 올라갑니다.

package/server/service/figure/catalog-db.test.ts

@@ -121,7 +121,7 @@ describe('태그가 정말 써진다', () => {
     expect((await readBack(saved.id))!.tags).toEqual([])
   })
 
-  it('안 준 도형은 태그가 없다 — 빈 배열로 갈음하지 않는다', async () => {
+  it('안 준 피규어는 태그가 없다 — 빈 배열로 갈음하지 않는다', async () => {
     const saved = await seed()
 
     expect((await readBack(saved.id))!.tags).toBeNull()

package/server/service/figure/event-subscriber.ts

@@ -8,14 +8,14 @@ import { FigureHistory } from './figure-history.js'
 /**
  * 판본을 남긴다 — **발행된 저장에만.**
  *
- * `@operato/typeorm-history` 는 원래 모든 저장을 베낀다. 그런데 도형은 저작 중에 수십 번 저장되고,
+ * `@operato/typeorm-history` 는 원래 모든 저장을 베낀다. 그런데 피규어는 저작 중에 수십 번 저장되고,
  * 그 전부를 남기면 판본 목록이 「내가 오늘 몇 번 눌렀나」가 된다. 사람이 판이라고 부르는 것은
  * **발행한 것**이므로 그때만 베낀다. board 가 같은 규칙으로 돈다(`board-service` 의 같은 이름 파일).
  *
  * 발행판의 정본(`__releaseSource`)은 크기 범위를 적은 발행판 사본이다 — Figure 행에는 작성자가 좁힌 끝만 남는다.
  *
  * 발행 메모는 Figure 의 칸이 아니다. `releaseFigure` 가 저장할 엔티티에 `__releaseComment` 로 얹어
- * 두면 여기서 판본의 `comment` 로 옮긴다 — 메모는 그 판의 것이지 도형의 것이 아니다. 정본 형식
+ * 두면 여기서 판본의 `comment` 로 옮긴다 — 메모는 그 판의 것이지 피규어의 것이 아니다. 정본 형식
  * (`__releaseFormat`), 잰 커널의 판(`__releaseKernel`, ADR-0109 C1), 직전 판에 견준 변경(`__releaseChanges`), 발행 때 잰 값(`__releaseMetrics`)과
  * 윗모습(`__releaseTopView`)도 같은 길로 옮긴다(ADR-0104).
  */

package/server/service/figure/figure-blueprint-query.test.ts

@@ -100,7 +100,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발
     await repo.save({
       domain: testDomain,
       type: 'DRAFT_FIGURE',
-      name: '초안 도형',
+      name: '초안 피규어',
       state: 'draft',
       source: sampleSource,
       version: 0
@@ -116,7 +116,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발
     await repo.save({
       domain: testDomain,
       type: 'RELEASED_FIGURE',
-      name: '발행 도형',
+      name: '발행 피규어',
       state: 'released',
       source: sampleSource,
       version: 1
@@ -141,7 +141,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발
     const figure = await repo.save({
       domain: testDomain,
       type: 'UPDATING_FIGURE',
-      name: '수정 중인 도형',
+      name: '수정 중인 피규어',
       state: 'draft',
       source: draftSource,
       version: 1

package/server/service/figure/figure-format.test.ts

@@ -158,8 +158,8 @@ describe('figure-format — 판을 알아보는 문', () => {
     })
 
     /*
-      (2026-09-24) 드라이룸 램프처럼 — 붙어 있던 부품이 도형을 키우면 떨어진다.
-      여기서는 손으로 만든다: 램프의 높이가 도형 높이(size.y)를 따라 올라가고, 몸통은 그대로다.
+      (2026-09-24) 드라이룸 램프처럼 — 붙어 있던 부품이 피규어를 키우면 떨어진다.
+      여기서는 손으로 만든다: 램프의 높이가 피규어 높이(size.y)를 따라 올라가고, 몸통은 그대로다.
     */
     const splitting = () => {
       let asset = createFigureAsset('Lamp post')
@@ -185,8 +185,8 @@ describe('figure-format — 판을 알아보는 문', () => {
       expect(`${finding!.message}${finding!.why}${finding!.how}`).not.toMatch(/come away|piece/)
     })
 
-    /* 한 비율로 커진다고 선언한 도형에서 제 숫자를 가진 부품(수석 아키텍트 판정 2026-09-24 조건 ②). */
-    it('한 비율로 커진다고 선언한 도형에서 따라 커지지 않는 부품을 막고 이름을 댄다', () => {
+    /* 한 비율로 커진다고 선언한 피규어에서 제 숫자를 가진 부품(수석 아키텍트 판정 2026-09-24 조건 ②). */
+    it('한 비율로 커진다고 선언한 피규어에서 따라 커지지 않는 부품을 막고 이름을 댄다', () => {
       let asset = createFigureAsset('Uniform')
       asset = addFigureBox(asset, { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
       for (const axis of ['x', 'y', 'z']) {
@@ -197,7 +197,7 @@ describe('figure-format — 판을 알아보는 문', () => {
       const finding = inspectSource(serializeFigureAsset(asset), null, translatorOf(KO)).findings.find(f => f.code === 'sizing-not-uniform')
 
       expect(finding?.blocking).toBe(true)
-      expect(finding!.message).toBe("이 도형은 한 비율로 커지는데, 크기를 X 로 2배로 하면 'body' 부품은 같이 커지지 않습니다.")
+      expect(finding!.message).toBe("이 피규어는 한 비율로 커지는데, 크기를 X 로 2배로 하면 'body' 부품은 같이 커지지 않습니다.")
       expect(finding!.how).toContain('크기에 비례')
     })
 
@@ -234,10 +234,10 @@ describe('figure-format — 판을 알아보는 문', () => {
     })
 
     /*
-      자산에는 type 이 없어 임시 이름 검사가 돌지 않았고, 새 도형이 `FIGURE_<uuid>` 로 발행됐다(:3300, 2026-09-24).
+      자산에는 type 이 없어 임시 이름 검사가 돌지 않았고, 새 피규어가 `FIGURE_<uuid>` 로 발행됐다(:3300, 2026-09-24).
       발행하면 이름이 굳으므로 행의 type 으로 거절한다.
     */
-    it('임시 이름인 도형은 발행을 막는다 — 이름은 행에 있다', () => {
+    it('임시 이름인 피규어는 발행을 막는다 — 이름은 행에 있다', () => {
       /* The name a new figure gets — the format's rule, the one the gate recognises. */
       const placeholder = placeholderType()
       const finding = inspectSource(figureSource(), null, translatorOf(KO), placeholder).findings.find(f => f.code === 'type-is-placeholder')

package/server/service/figure/figure-format.ts

@@ -107,7 +107,7 @@ function assertFormat(sourceJson: string): void {
   }
   if ((parsed as { version?: unknown } | null)?.version !== FIGURE_ASSET_VERSION)
     throw new FigureSourceError([
-      { code: 'source-format-unknown', message: `정본의 판을 알 수 없다 — 도형 자산은 version '${FIGURE_ASSET_VERSION}' 을 적는다`, at: 'version' }
+      { code: 'source-format-unknown', message: `정본의 판을 알 수 없다 — 피규어 자산은 version '${FIGURE_ASSET_VERSION}' 을 적는다`, at: 'version' }
     ])
 }
 

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

@@ -2,7 +2,7 @@
  * 실제 LLM Figure 후보 생성 smoke test (기본 비활성).
  *
  * 결정적 시험은 프롬프트·도구·검사 배선을 고정하지만, 실제 모델이 명령 목록(ADR-0094)을 써서 게이트를
- * 지나는 도형을 만드는지는 대신할 수 없다. 이 시험은 `RUN_FIGURE_LLM_SMOKE=1`과 공급자 API 키가 모두 있을 때만 실행한다.
+ * 지나는 피규어를 만드는지는 대신할 수 없다. 이 시험은 `RUN_FIGURE_LLM_SMOKE=1`과 공급자 API 키가 모두 있을 때만 실행한다.
  * DB·GraphQL·Figure 저장을 건드리지 않고 후보 생성 함수만 호출하므로, 외부 영향은 API 비용뿐이다.
  *
  * 실행:

package/server/service/figure/figure-mutation.ts

@@ -273,7 +273,7 @@ export class FigureMutation {
       **타입은 발행 전에만 바뀐다** — ADR-0063 결정 4.
 
       발행된 뒤에는 이미 배치된 도면이 이 이름을 가리키고, 바꾸면 그 도면이 아무 오류 없이
-      빈 자리가 된다. 발행된 적 없는 도형은 가리키는 도면이 있을 수 없다 — 도면은 최신
+      빈 자리가 된다. 발행된 적 없는 피규어는 가리키는 도면이 있을 수 없다 — 도면은 최신
       발행판을 그리므로 그려질 자리가 없다.
 
       행과 정본 둘 다 고친다. 정본 안에도 `type` 이 있어서 한쪽만 고치면 저장된 JSON 과
@@ -358,7 +358,7 @@ export class FigureMutation {
    *
    * ## 무엇이 일어나나
    *
-   * `state` 가 `released` 가 되고, 판 번호가 하나 오르고, 그 순간의 도형이 판본으로 남는다
+   * `state` 가 `released` 가 되고, 판 번호가 하나 오르고, 그 순간의 피규어가 판본으로 남는다
    * (`FigureHistory` — 스냅샷은 구독자가 뜬다). 저작 중 저장은 이 셋 중 아무것도 하지 않는다.
    *
    * ## 왜 이미 발행된 것을 거절하나
@@ -368,12 +368,12 @@ export class FigureMutation {
    *
    * ## 번호는 판본에서 센다
    *
-   * 도형의 현재 번호가 아니라 **판본의 최대 번호 + 1** 이다. 되돌리기로 옛 판이 현재가 되어도
+   * 피규어의 현재 번호가 아니라 **판본의 최대 번호 + 1** 이다. 되돌리기로 옛 판이 현재가 되어도
    * 다음 발행이 이미 쓴 번호를 다시 쓰지 않는다.
    *
    * ## 게이트를 통과해야 한다
    *
-   * 크기를 바꿨을 때 조각이 갈라지는 도형은 발행되지 않는다(`figure-gate.ts`). 소비처는 형상을
+   * 크기를 바꿨을 때 조각이 갈라지는 피규어는 발행되지 않는다(`figure-gate.ts`). 소비처는 형상을
    * 늘려 쓰므로 — 그것이 이 형식의 값이다 — 늘려도 견디는지가 약속의 일부다. 화면은 같은 판정을
    * `inspectFigure` 로 미리 물어 이유를 보여 준다.
    */
@@ -473,7 +473,7 @@ export class FigureMutation {
    *
    * ## 비용은 다시 잰다
    *
-   * 판본이 든 점수·삼각형은 **그때의 형식**으로 잰 값이다. 지금 이 도형이 그 내용이 되었으므로
+   * 판본이 든 점수·삼각형은 **그때의 형식**으로 잰 값이다. 지금 이 피규어가 그 내용이 되었으므로
    * 오늘 기준으로 다시 계산한다. 옛 값은 판본에 그대로 남아 있다.
    */
   @Directive('@transaction')
@@ -592,7 +592,7 @@ export class FigureMutation {
   /**
    * 저작 보조에게 제안을 시킨다(ADR-0094).
    *
-   * **저장하지 않는다.** 모델러 명령 목록과 그것이 만드는 도형을 돌려줄 뿐이고, 정본이 되는 것은 저작자가 모델러에
+   * **저장하지 않는다.** 모델러 명령 목록과 그것이 만드는 피규어를 돌려줄 뿐이고, 정본이 되는 것은 저작자가 모델러에
    * 적용하고 저장한 뒤다. 커널이 거절한 명령이나 게이트가 잡은 것은 여기까지 오지 않는다 — 제안기가 사유를 모델에
    * 돌려주고 다시 시킨다. 끝내 못 만들면 **사유와 함께 던진다.** 반쯤 만든 것을 돌려주지 않는다.
    */

package/server/service/figure/figure-propose-steps.test.ts

@@ -256,8 +256,8 @@ describe('a failure told to a person', () => {
 
   it('says the first line in the reader\'s language, the reasons as they were', () => {
     const said: any[] = []
-    const text = proposalFailureForPerson(failure, (key, params) => (said.push([key, params]), '도형을 만들지 못했습니다.'))
-    expect(text).toBe('도형을 만들지 못했습니다.\nATTACH_FACE: steps[4]: attach: faces along x')
+    const text = proposalFailureForPerson(failure, (key, params) => (said.push([key, params]), '피규어를 만들지 못했습니다.'))
+    expect(text).toBe('피규어를 만들지 못했습니다.\nATTACH_FACE: steps[4]: attach: faces along x')
     expect(said).toEqual([['error.figure-proposal-failed', { defaultValue: 'The figure could not be made.' }]])
   })
 

package/server/service/figure/figure-query.ts

@@ -53,7 +53,7 @@ export class FigureQuery {
 
         `simple-json` 이라 칸에는 `["반출","자동"]` 이 통째로 들어 있고, LIKE 는 그 글자를
         본다. 「반출」로 찾으면 걸린다. 정확히 그 태그만 걸리는 것은 아니지만(이름에 「반출」이
-        든 도형도 걸린다) 찾기로는 그것이 오히려 낫다.
+        든 피규어도 걸린다) 찾기로는 그것이 오히려 낫다.
       */
       searchables: ['type', 'name', 'description', 'category', 'tags']
     })
@@ -97,7 +97,7 @@ export class FigureQuery {
    * 발행된 판들 — 최근 것부터.
    *
    * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧
-   * 「이 도형이 몇 번 약속되었나」다.
+   * 「이 피규어가 몇 번 약속되었나」다.
    */
   @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
   @Query(returns => [FigureHistory], { description: 'Released versions of a figure, newest first.' })
@@ -117,7 +117,7 @@ export class FigureQuery {
   /**
    * 지금 소비처가 쓰는 판.
    *
-   * 도형의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,
+   * 피규어의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,
    * 그것을 이 자리가 답한다.
    */
   /** What a kept GLB holds, read again from its bytes (ADR-0129): the modeller asks when it reopens a figure. */
@@ -254,7 +254,7 @@ export class FigureQuery {
   }
 
   /**
-   * 소비처(operato-board, operato-twin, things-scene)가 발행된 도형을 받아 가는 문.
+   * 소비처(operato-board, operato-twin, things-scene)가 발행된 피규어를 받아 가는 문.
    *
    * 이름은 보드와의 계약이라 그대로 둔다(바꾸는 일은 따로 한다). 돌려주는 것은 자산이다 —
    * `{ type, asset }`. 그리는 쪽(`registerFigure`)이 커널로 컴파일한다.

package/server/service/figure/figure-rename-db.test.ts

@@ -79,7 +79,7 @@ async function namespaced(domain: any) {
 
 let DOMAIN: { id: string }
 
-/* 도형이 도메인을 가리킨다 — 행이 없으면 외래키가 먼저 막는다. */
+/* 피규어가 도메인을 가리킨다 — 행이 없으면 외래키가 먼저 막는다. */
 async function seedDomain() {
   const saved = await namespaced(await dataSource!.getRepository(shell.Domain).save({ name: 'rename-probe', subdomain: 'rename-probe' }))
   DOMAIN = { id: saved.id }
@@ -127,7 +127,7 @@ describe('이름을 바꾸기 전에 읽는 사실', () => {
     expect((await facts(figure, 'robot-arm')).hasHistory).toBe(true)
   })
 
-  it('같은 도메인에서 그 이름을 쓰는 다른 도형을 찾는다', async () => {
+  it('같은 도메인에서 그 이름을 쓰는 다른 피규어를 찾는다', async () => {
     const figure = await seedFigure()
     await seedFigure({ type: 'conveyor', name: '컨베이어' })
 

package/server/service/figure/figure-rename.test.ts

@@ -1,7 +1,7 @@
 /*
  * 초안의 타입을 고치는 규칙 — ADR-0063 결정 4.
  *
- * 이 규칙이 지키는 것은 하나다: **발행된 이름은 안 바뀐다.** 도면은 그 이름 하나로 도형을
+ * 이 규칙이 지키는 것은 하나다: **발행된 이름은 안 바뀐다.** 도면은 그 이름 하나로 피규어를
  * 찾으므로, 바뀌면 배치된 자리가 아무 오류 없이 빈다.
  */
 import { readFileSync } from 'fs'
@@ -21,7 +21,7 @@ const never = { version: 0, hasHistory: false, takenByAnother: false }
 
 describe('초안의 type 고치기', () => {
   /*
-    자산에는 type 칸이 없고 형식은 모르는 칸을 거절한다. 원본에 이름을 써 넣었더니 그 도형을 다시 열 수
+    자산에는 type 칸이 없고 형식은 모르는 칸을 거절한다. 원본에 이름을 써 넣었더니 그 피규어를 다시 열 수
     없었다(`parseFigureAsset` — "unknown type"). 행만 바뀐다.
   */
   it('★ 행만 바뀌고, 원본은 그대로 다시 열린다', () => {
@@ -97,7 +97,7 @@ describe('문이 이 규칙을 지난다', () => {
     저장이 임시 이름을 스스로 지었다(`FIGURE_<32 hex>`). 형식의 `isPlaceholderType` 이 그것을 못 알아봐서
     발행 판정이 기계 이름을 통과시켰다. 짓는 쪽과 알아보는 쪽이 한 규칙이어야 한다.
   */
-  /* 새 도형의 임시 이름이 판정이 알아보는 그 규칙인지는 문을 실제로 불러 본다 — figure-rename-db.test.ts 「이름 없이 부르면」. */
+  /* 새 피규어의 임시 이름이 판정이 알아보는 그 규칙인지는 문을 실제로 불러 본다 — figure-rename-db.test.ts 「이름 없이 부르면」. */
 
   it('문이 type 을 받는 칸을 갖는다', () => {
     const type = source('figure-type.ts')

package/server/service/figure/figure-rename.ts

@@ -6,8 +6,8 @@ import { TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'
  * ## 왜 발행 전에만인가
  *
  * `type` 은 도면에 적히는 이름이다. 도면은 `{ type, left, top, width, height }` 만 갖고 늘 최신
- * 발행판을 그리므로, 발행된 도형의 이름을 바꾸면 이미 배치된 도면이 아무 오류 없이 빈 자리가
- * 된다. 한 번도 발행되지 않은 도형은 그려질 자리가 없으니 가리키는 도면도 있을 수 없다.
+ * 발행판을 그리므로, 발행된 피규어의 이름을 바꾸면 이미 배치된 도면이 아무 오류 없이 빈 자리가
+ * 된다. 한 번도 발행되지 않은 피규어는 그려질 자리가 없으니 가리키는 도면도 있을 수 없다.
  *
  * ## 왜 열어야 했나
  *
@@ -28,10 +28,10 @@ export interface RenameFacts {
   version?: number
   /** 판본이 하나라도 있나. 되돌리기로 판 번호가 도로 낮아져도 이력은 남는다. */
   hasHistory: boolean
-  /** 같은 도메인에서 그 이름을 이미 쓰는 **다른** 도형이 있나. */
+  /** 같은 도메인에서 그 이름을 이미 쓰는 **다른** 피규어가 있나. */
   takenByAnother: boolean
   /**
-   * 같은 도메인에서 그 이름으로 발행한 뒤 지워진 도형이 있나. 발행한 도형을 지울 수 없게 되기(G4) 전에 지워진 것이다.
+   * 같은 도메인에서 그 이름으로 발행한 뒤 지워진 피규어가 있나. 발행한 피규어를 지울 수 없게 되기(G4) 전에 지워진 것이다.
    * 그 이름을 다시 쓰면 판 번호가 1부터 다시 매겨져 같은 `ns/type@n` 이 다른 내용을 가리킨다.
    */
   releasedBefore?: boolean
@@ -57,7 +57,7 @@ export async function typeReleasedBefore(
 
 /** Said when a type was released and deleted before: a new figure may not take it. */
 export const releasedBeforeMessage = (type: string) =>
-  `type 「${type}」 는 이 도메인에서 발행한 뒤 지운 도형의 이름이다 — 다시 쓰면 같은 판 번호가 다른 내용을 가리키므로 다른 이름을 고른다`
+  `type 「${type}」 는 이 도메인에서 발행한 뒤 지운 피규어의 이름이다 — 다시 쓰면 같은 판 번호가 다른 내용을 가리키므로 다른 이름을 고른다`
 
 export class FigureRenameRefused extends Error {
   constructor(
@@ -100,7 +100,7 @@ export function renameDraftType(
   if ((facts.version ?? 0) > 0 || facts.hasHistory) {
     throw new FigureRenameRefused(
       'already-released',
-      '발행된 도형의 type 은 바꿀 수 없다 — 이미 배치된 도면이 이 이름을 가리킨다'
+      '발행된 피규어의 type 은 바꿀 수 없다 — 이미 배치된 도면이 이 이름을 가리킨다'
     )
   }
 

package/server/service/figure/figure-subject.test.ts

@@ -4,7 +4,7 @@
 const mockFigures: any[] = [
   { id: 'f1', domain: 'plant-a', name: '선풍기', type: 'system/fan' },
   { id: 'f2', domain: 'plant-a', name: '', type: 'system/agv-lift' },
-  { id: 'f3', domain: 'plant-b', name: '남의 도형', type: 'other/one' }
+  { id: 'f3', domain: 'plant-b', name: '남의 피규어', type: 'other/one' }
 ]
 const mockRegistered: any[] = []
 

package/server/service/figure/figure-tools.test.ts

@@ -6,7 +6,7 @@
  * 나타나는 증상이 실제로 겪은 실패와 1:1 로 대응한다.
  *
  *   · guidance → 도구 호출          끊기면 → 「후보를 만들었습니다」라고만 쓰고 화면에는 아무것도 없다
- *   · hostContext.figureId → 대상    끊기면 → 화면에 도형이 떠 있는데 「어느 도형입니까」를 되묻는다
+ *   · hostContext.figureId → 대상    끊기면 → 화면에 피규어가 떠 있는데 「어느 피규어입니까」를 되묻는다
  *   · 도메인 확인 → 대상            끊기면 → 모델이 넘긴 id 로 남의 테넌트를 읽는다
  *   · hostContext.context·revision → 제안   끊기면 → 모델러가 모델이 본 판이 아닌 판에 명령을 적용한다
  *
@@ -301,7 +301,7 @@ describe('모델이 읽는 글은 영어다', () => {
 })
 
 describe('대화면 문맥에서 대상을 해소한다', () => {
-  it('id 를 안 주면 열려 있는 도형을 읽는다 — 사용자에게 되묻지 않는다', async () => {
+  it('id 를 안 주면 열려 있는 피규어를 읽는다 — 사용자에게 되묻지 않는다', async () => {
     const result = await toolNamed('getFigureSource').builder({}, ctx())
 
     expect(result.id).toBe('fig-1')
@@ -316,7 +316,7 @@ describe('대화면 문맥에서 대상을 해소한다', () => {
     expect(result.source).toBeUndefined()
   })
 
-  it('목록에서 대상을 찾아 다시 호출하면 해당 도형의 정본을 읽는다', async () => {
+  it('목록에서 대상을 찾아 다시 호출하면 해당 피규어의 정본을 읽는다', async () => {
     const catalog = await toolNamed('listFigures').builder({}, ctx({}))
     const target = catalog.figures.find((figure: any) => figure.name === '믹서')
     const result = await toolNamed('getFigureSource').builder({ figureId: target.id }, ctx({}))
@@ -324,7 +324,7 @@ describe('대화면 문맥에서 대상을 해소한다', () => {
     expect(result.source.name).toBe('Mixer')
   })
 
-  it('정본이 없는 도형은 없다고 말한다 — 지어내지 않는다', async () => {
+  it('정본이 없는 피규어는 없다고 말한다 — 지어내지 않는다', async () => {
     const result = await toolNamed('getFigureSource').builder({ figureId: 'fig-blank' }, ctx())
 
     expect(result.source).toBeNull()
@@ -344,7 +344,7 @@ describe('대화면 문맥에서 대상을 해소한다', () => {
   있고, 그것을 그대로 믿으면 남의 테넌트를 읽는다.
 */
 describe('모델이 넘긴 id 를 믿지 않는다', () => {
-  it('다른 도메인의 도형은 못 찾았다고 한다', async () => {
+  it('다른 도메인의 피규어는 못 찾았다고 한다', async () => {
     await expect(toolNamed('getFigureSource').builder({ figureId: 'fig-other' }, ctx())).rejects.toThrow(
       /not found in this tenant/
     )
@@ -362,7 +362,7 @@ describe('모델이 넘긴 id 를 믿지 않는다', () => {
     expect(result.figures.map((one: any) => one.id)).toEqual(['fig-1', 'fig-blank'])
   })
 
-  it('도구 설명이 저장 전 도형은 모델러에 열린 것만 읽는다고 말한다', () => {
+  it('도구 설명이 저장 전 피규어는 모델러에 열린 것만 읽는다고 말한다', () => {
     const description = toolNamed('getFigureSource').schema.properties.figureId.description
     expect(description).not.toMatch(/never saved is not open/)
     expect(description).toMatch(/not saved yet/)
@@ -394,7 +394,7 @@ describe('목록이 잘릴 때', () => {
     expect(result.note).toMatch(/search/)
   })
 
-  it('이름이나 타입의 일부로 찾으면 잘린 뒤의 도형도 나온다 — 대소문자 없이', async () => {
+  it('이름이나 타입의 일부로 찾으면 잘린 뒤의 피규어도 나온다 — 대소문자 없이', async () => {
     const byName = await toolNamed('listFigures').builder({ search: 'roll PRESS' }, ctx({}))
     const byType = await toolNamed('listFigures').builder({ search: 'old_press' }, ctx({}))
     expect(byName.figures.map((one: any) => one.id)).toEqual(['fig-old'])
@@ -411,7 +411,7 @@ describe('목록이 잘릴 때', () => {
 
 /*
   제안은 모델러의 명령 목록이다(ADR-0094). 고치는 제안은 모델러가 모델이 본 판 위에 한 단계로 적용하므로, 고칠 수
-  있는 것은 모델러에 열린 도형뿐이고 그 판(context · revision)을 문맥이 싣고 와야 한다.
+  있는 것은 모델러에 열린 피규어뿐이고 그 판(context · revision)을 문맥이 싣고 와야 한다.
 */
 const figureDraft = () => {
   const model = require('@hatiolab/figure-model')
@@ -422,7 +422,7 @@ const figureDraft = () => {
 const modeller = (over: any = {}) => ({ figureId: 'fig-1', draftSource: figureDraft(), context: 'ctx-7', revision: 4, ...over })
 
 describe('제안을 요청할 때', () => {
-  it('열린 도형을 고치면 그 초안이 제안기에 가고, 모델러가 적용할 판이 함께 돌아온다', async () => {
+  it('열린 피규어를 고치면 그 초안이 제안기에 가고, 모델러가 적용할 판이 함께 돌아온다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '다리를 길게' }, ctx(modeller()))
     expect(proposed[0].base.name).toBe('Probe')
     expect(proposed[0].base.version).toBe('figure-asset-1')
@@ -438,19 +438,19 @@ describe('제안을 요청할 때', () => {
     expect(proposed).toHaveLength(0)
   })
 
-  it('모델러에 열리지 않은 도형은 고치지 않고, 열라고 말한다', async () => {
+  it('모델러에 열리지 않은 피규어는 고치지 않고, 열라고 말한다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '고쳐줘', figureId: 'fig-blank' }, ctx(modeller()))
     expect(out.error).toBe('FIGURE_NOT_OPEN')
     expect(proposed).toHaveLength(0)
   })
 
-  it('원본이 없는 도형은 고치지 않는다 — 빈 것을 제안기에 건네지 않는다', async () => {
+  it('원본이 없는 피규어는 고치지 않는다 — 빈 것을 제안기에 건네지 않는다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '고쳐줘' }, ctx({ figureId: 'fig-blank', context: 'c', revision: 1 }))
     expect(out.error).toBe('FIGURE_NOT_OPEN')
     expect(proposed).toHaveLength(0)
   })
 
-  it('목록에서 새 제작은 열린 도형을 요구하지 않는다', async () => {
+  it('목록에서 새 제작은 열린 피규어를 요구하지 않는다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '믹서를 새로 만들어줘', create: true, name: 'Mixer' }, ctx({}))
     expect(out.proposed).toBe(true)
     expect(proposed[0].base).toBeUndefined()
@@ -464,7 +464,7 @@ describe('제안을 요청할 때', () => {
     expect(proposed[0].base).toBeUndefined()
   })
 
-  it('create 를 켜면 열린 도형이 있어도 새로 만든다 — 열린 것을 덮어쓰는 제안이 오지 않게', async () => {
+  it('create 를 켜면 열린 피규어가 있어도 새로 만든다 — 열린 것을 덮어쓰는 제안이 오지 않게', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '새 컨베이어', create: true }, ctx(modeller()))
     expect(proposed[0].base).toBeUndefined()
     expect(out.revision).toBeUndefined()
@@ -474,7 +474,7 @@ describe('제안을 요청할 때', () => {
     await expect(toolNamed('proposeFigureCandidate').builder({ prompt: '   ' }, ctx(modeller()))).rejects.toThrow(/prompt is required/)
   })
 
-  it('남의 도형을 고치라고 하면 못 찾았다고 한다', async () => {
+  it('남의 피규어를 고치라고 하면 못 찾았다고 한다', async () => {
     await expect(
       toolNamed('proposeFigureCandidate').builder({ prompt: '고쳐줘', figureId: 'fig-other' }, ctx(modeller()))
     ).rejects.toThrow(/not found in this tenant/)
@@ -600,7 +600,7 @@ describe('사람이 붙인 그림', () => {
   })
 })
 
-describe('도형이 모델러에 열려 있을 때', () => {
+describe('피규어가 모델러에 열려 있을 때', () => {
   it('저장 전 초안을 이 모델로 읽고, 셈으로 잰다', async () => {
     const draft = figureDraft()
     const got = await toolNamed('getFigureSource').builder({}, ctx({ figureId: 'fig-1', draftSource: draft, palette: ['palette.primary'] }))
@@ -639,7 +639,7 @@ describe('도형이 모델러에 열려 있을 때', () => {
     expect(got.trying).toEqual({ clips: { open: 1 } })
   })
 
-  it('저장된 정본을 읽을 때는 화면의 선택을 붙이지 않는다 — 다른 도형의 선택일 수 있다', async () => {
+  it('저장된 정본을 읽을 때는 화면의 선택을 붙이지 않는다 — 다른 피규어의 선택일 수 있다', async () => {
     const got = await toolNamed('getFigureSource').builder({ figureId: 'fig-1' }, ctx({ selection: { part: 'body', context: 'c', revision: 1 }, context: 'c', revision: 1 }))
     expect(got.draft).toBe(false)
     expect(got.selection).toBeUndefined()
@@ -661,7 +661,7 @@ describe('도형이 모델러에 열려 있을 때', () => {
   Until then the tools refused any draft over 100,000 characters: a figure that opened and saved got no read, no
   inspection and no proposal, and saving again did not help. Now it is read as an outline and the parts asked for.
 */
-describe('도형이 한 번에 보일 만큼보다 클 때', () => {
+describe('피규어가 한 번에 보일 만큼보다 클 때', () => {
   const { FIGURE_CONTEXT_BUDGET } = require('./figure-context')
   const model = require('@hatiolab/figure-model')
   let under: any
@@ -770,7 +770,7 @@ describe('도형이 한 번에 보일 만큼보다 클 때', () => {
   the screen sent, through the same door a save goes through. Only the figure open on that screen: an id the model passes
   that has no row and is not the open one is still not found.
 */
-describe('저장 전 도형', () => {
+describe('저장 전 피규어', () => {
   const CREATION = '33333333-3333-4333-8333-333333333333'
   const unsaved = (over: any = {}) => modeller({ figureId: CREATION, editorMode: 'new', ...over })
 
@@ -811,7 +811,7 @@ describe('저장 전 도형', () => {
     await expect(toolNamed('getFigureSource').builder({}, ctx({ figureId: CREATION, editorMode: 'new' }))).rejects.toThrow(/not found in this tenant/)
   })
 
-  it('생성 식별자 꼴이 아닌 이름은 저장 전 도형으로 읽지 않는다', async () => {
+  it('생성 식별자 꼴이 아닌 이름은 저장 전 피규어로 읽지 않는다', async () => {
     await expect(toolNamed('getFigureSource').builder({}, ctx(unsaved({ figureId: 'fig-unknown' })))).rejects.toThrow(/not found in this tenant/)
   })
 })

package/server/service/figure/figure-tools.ts

@@ -100,7 +100,7 @@ function requireDomainId(state: any): string {
 }
 
 /**
- * 이 도형이 호출자 도메인 것인가.
+ * 이 피규어가 호출자 도메인 것인가.
  *
  * 모델이 넘긴 id 를 그대로 쓰지 않는다. 없으면 못 찾았다고 말한다 — 「권한이 없다」와 구별해
  * 알려 줄 것이 없다(다른 테넌트에 그 id 가 있다는 사실 자체가 알려 줄 것이 아니다).
@@ -211,8 +211,8 @@ function focusOf(host: any, source: any): { selection?: { part: string }; trying
 /**
  * 무엇을 고치라는 것인지 대화면 문맥에서 해소한다.
  *
- * 모델이 대상을 안 줬으면 **저작면이 지금 열고 있는 도형**이다. 사용자에게 식별자를 되묻지
- * 않는다 — 화면에 그 도형이 떠 있는데 「어느 도형입니까」를 묻는 것은 문맥을 안 읽은 것이다.
+ * 모델이 대상을 안 줬으면 **저작면이 지금 열고 있는 피규어**이다. 사용자에게 식별자를 되묻지
+ * 않는다 — 화면에 그 피규어가 떠 있는데 「어느 피규어입니까」를 묻는 것은 문맥을 안 읽은 것이다.
  */
 function figureIdFrom(args: any, host: any): string | undefined {
   const said = typeof args?.figureId === 'string' ? args.figureId.trim() : ''
@@ -303,7 +303,7 @@ function figureToolSpecs(): ToolSpec[] {
     {
       kind: 'read',
       name: 'listFigures',
-      /* 이 도메인의 도형 목록 — 저장소를 직접 읽지만 같은 일을 하는 문은 이것이다. */
+      /* 이 도메인의 피규어 목록 — 저장소를 직접 읽지만 같은 일을 하는 문은 이것이다. */
       doors: ['Query.figures'],
       description:
         'Lists the figures in this tenant with their type names, states and part counts. ' +
@@ -354,8 +354,8 @@ function figureToolSpecs(): ToolSpec[] {
     {
       kind: 'read',
       name: 'getFigureSource',
-      /* 저장된 도형의 원본. **저장 전 초안**을 물으면 저장소에 갈 것이 없어 화면이 보낸 것을 그대로 돌려준다 —
-       * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 도형을 읽는 권한 검사가 선언에서 사라진다. */
+      /* 저장된 피규어의 원본. **저장 전 초안**을 물으면 저장소에 갈 것이 없어 화면이 보낸 것을 그대로 돌려준다 —
+       * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 피규어를 읽는 권한 검사가 선언에서 사라진다. */
       doors: ['Query.figure'],
       description:
         'Returns the source (the figure asset) of one figure, with its measured cost ' +
@@ -467,12 +467,12 @@ function figureToolSpecs(): ToolSpec[] {
         if (!prompt) throw new Error('prompt is required: there is nothing to ask for')
 
         /*
-          고치는 것인지 만드는 것인지를 **문맥에서 정한다.** 열린 도형이 있으면 고치는 것이 기본이고,
-          모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 도형을 덮어쓰는
+          고치는 것인지 만드는 것인지를 **문맥에서 정한다.** 열린 피규어가 있으면 고치는 것이 기본이고,
+          모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 피규어를 덮어쓰는
           후보가 온다.
 
           고치는 제안은 모델러가 **요청 당시의 판(context · revision)** 위에 한 단계로 적용한다(ADR-0094).
-          그래서 고칠 수 있는 것은 모델러에 열린 도형뿐이고, 그 판을 문맥이 함께 실어 와야 한다.
+          그래서 고칠 수 있는 것은 모델러에 열린 피규어뿐이고, 그 판을 문맥이 함께 실어 와야 한다.
         */
         const host = ctx?.host
         const create = args?.create === true || args?.figureId === null

package/server/service/figure/figure-type.ts

@@ -48,8 +48,8 @@ export class NewFigure {
  *
  * `type` 은 **한 번도 발행되지 않은 초안에서만** 바뀐다(ADR-0063 결정 4). 저장되는 식별자라
  * 발행된 뒤에 바꾸면 이미 배치된 보드가 타입을 못 찾아 오류 없이 빈 화면이 된다. 발행 전에는
- * 그 도형을 가리키는 도면이 있을 수 없다 — 도면은 최신 발행판을 그리므로 발행된 적 없는
- * 도형은 그려질 자리가 없다.
+ * 그 피규어를 가리키는 도면이 있을 수 없다 — 도면은 최신 발행판을 그리므로 발행된 적 없는
+ * 피규어는 그려질 자리가 없다.
  *
  * 닫아 두었더니 저작자가 이름을 한 번도 정하지 못했다. 새 Figure 에는 기계가 지은 이름이
  * 붙고(`FIGURE_MU6RJH47`) 칸에 자물쇠가 걸려서, 그 이름이 그대로 도면에 적히는 이름이 됐다.