@things-factory/figure-service 10.1.65 → 10.1.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.65",
+  "version": "10.1.67",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -23,7 +23,7 @@
     "migration:create": "node ../../node_modules/typeorm/cli.js migration:create ./server/migrations/migration"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.76",
+    "@hatiolab/figure-model": "^0.1.78",
     "@operato/typeorm-history": "^10.0.0",
     "@things-factory/ai-client-base": "^10.1.53",
     "@things-factory/auth-base": "^10.1.47",
@@ -33,5 +33,5 @@
     "graphql-upload": "^15.0.2",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "87b95ef312f11d3d646f6e2247ee202b68d23e3f"
+  "gitHead": "cd3f81fbf667f513dfcfb90906cb97ba935373f5"
 }

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

@@ -26,25 +26,19 @@ function loadCompiled(modulePath: string): any {
   return require(resolved)
 }
 
-const sampleSource = JSON.stringify({
-  version: 2,
-  type: 'TEST_BOX',
-  base: { x: 100, y: 100, z: 100 },
-  parts: [
-    {
-      name: 'box-1',
-      primitive: 'cube',
-      transform: { position: { x: 0, y: 50, z: 0 }, size: { x: 100, y: 100, z: 100 } },
-      material: { token: 'palette.primary' }
-    }
-  ]
-})
+const model = require('@hatiolab/figure-model')
 
-/** The same box under a different type and part name, so a test can tell the sources apart. */
-const boxNamed = (type: string, part: string) => {
-  const parsed = JSON.parse(sampleSource)
-  return JSON.stringify({ ...parsed, type, parts: [{ ...parsed.parts[0], name: part }] })
-}
+/** A released figure's source: one box, named `part`, `size` mm on each side. */
+const box = (part = 'box-1', size = 100) =>
+  model.serializeV3Asset(model.addV3Box(model.createV3Asset('Test box'), { id: part, size: { x: size, y: size, z: size }, position: { x: 0, y: size / 2, z: 0 } }))
+const sampleSource = box()
+
+/** The same box under a different part name, so a test can tell the sources apart. */
+const boxNamed = (_type: string, part: string) => box(part)
+
+/** What a consumer was handed: the part ids of the asset, and a part's width. */
+const partsOf = (payload: any): string[] => payload.asset.document.model.nodes.filter((n: any) => n.op === 'place@1').map((n: any) => n.id)
+const widthOf = (payload: any, part: string): number => payload.asset.designInputs[`${part}.size.x`]
 
 beforeAll(async () => {
   Figure = loadCompiled('service/figure/figure').Figure
@@ -91,7 +85,7 @@ function makeContext() {
   } as any
 }
 
-describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위한 청사진 전달', () => {
+describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발행된 자산 전달', () => {
   it('존재하지 않는 타입은 null을 반환한다', async () => {
     const query = new FigureQuery()
     const result = await query.figureBlueprint('NON_EXISTENT', makeContext())
@@ -114,7 +108,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
     expect(result).toBeNull()
   })
 
-  it('발행된(released) Figure는 올바르게 컴파일된 Blueprint를 반환한다', async () => {
+  it('발행된(released) Figure는 자산을 format · type 과 함께 반환한다', async () => {
     const repo = dataSource!.getRepository(Figure)
     await repo.save({
       domain: testDomain,
@@ -128,37 +122,25 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
     const query = new FigureQuery()
     const result = await query.figureBlueprint('RELEASED_FIGURE', makeContext())
     expect(result).not.toBeNull()
-    expect(result.type).toBe('TEST_BOX')
-    expect(result.groups).toBeDefined()
-    expect(result.groups.length).toBe(1)
-    expect(result.groups[0].members[0].name).toBe('box-1')
+    expect(result.format).toBe('v3')
+    expect(result.type).toBe('RELEASED_FIGURE')
+    expect(result.asset.version).toBe('figure-v3-asset-1')
+    expect(partsOf(result)).toEqual(['box-1'])
   })
 
-  it('현재 저작 중(draft)이더라도 과거 발행판(FigureHistory)이 있으면 최신 발행판을 컴파일해 반환한다', async () => {
+  it('현재 저작 중(draft)이더라도 과거 발행판(FigureHistory)이 있으면 최신 발행판을 반환한다', async () => {
     const repo = dataSource!.getRepository(Figure)
     const historyRepo = dataSource!.getRepository(FigureHistory)
 
     const v1Source = sampleSource
-    const v2DraftSource = JSON.stringify({
-      version: 2,
-      type: 'UPDATING_FIGURE',
-      base: { x: 200, y: 200, z: 200 },
-      parts: [
-        {
-          name: 'box-modified',
-          primitive: 'cube',
-          transform: { position: { x: 0, y: 100, z: 0 }, size: { x: 200, y: 200, z: 200 } },
-          material: { token: 'palette.primary' }
-        }
-      ]
-    })
+    const draftSource = box('box-modified', 200)
 
     const figure = await repo.save({
       domain: testDomain,
       type: 'UPDATING_FIGURE',
       name: '수정 중인 도형',
       state: 'draft',
-      source: v2DraftSource,
+      source: draftSource,
       version: 1
     })
 
@@ -178,8 +160,8 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
 
     expect(result).not.toBeNull()
     // 소비처는 수정 중인 초안(box-modified, size 200)이 아니라 기발행된 판(box-1, size 100)을 본다!
-    expect(result.groups[0].members[0].name).toBe('box-1')
-    expect(result.groups[0].members[0].transform.size.x).toBe(100)
+    expect(partsOf(result)).toEqual(['box-1'])
+    expect(widthOf(result, 'box-1')).toBe(100)
   })
 
   /*
@@ -217,7 +199,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
     const result = await new FigureQuery().figureBlueprint('MULTI', makeContext())
 
     expect(result).not.toBeNull()
-    expect(result.groups[0].members[0].name).toBe('v3')
+    expect(partsOf(result)).toEqual(['v3'])
   })
 
   /*
@@ -261,7 +243,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
     const result = await new FigureQuery().figureBlueprint('WIP', makeContext())
 
     expect(result).not.toBeNull()
-    expect(result.groups[0].members[0].name).toBe('released-v2')
+    expect(partsOf(result)).toEqual(['released-v2'])
   })
 
   /*
@@ -393,8 +375,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
   })
 
   describe('a child domain shadows its parent only with a released version', () => {
-    const boxOf = (type: string, part: string) =>
-      JSON.stringify({ ...JSON.parse(sampleSource), type, parts: [{ ...JSON.parse(sampleSource).parts[0], name: part }] })
+    const boxOf = (_type: string, part: string) => box(part)
 
     let childSeq = 0
 
@@ -419,7 +400,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
       const result = await new FigureQuery().figureBlueprint('CONVEYOR', contextIn(child))
 
       expect(result).not.toBeNull()
-      expect(result.groups[0].members[0].name).toBe('standard')
+      expect(partsOf(result)).toEqual(['standard'])
     })
 
     it('uses the child release when the child has one', async () => {
@@ -431,7 +412,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
 
       const result = await new FigureQuery().figureBlueprint('CONVEYOR', contextIn(child))
 
-      expect(result.groups[0].members[0].name).toBe('tenant')
+      expect(partsOf(result)).toEqual(['tenant'])
     })
 
     /*
@@ -462,7 +443,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)를 위
       const result = await new FigureQuery().figureBlueprint('CONVEYOR', contextIn(child))
 
       expect(result).not.toBeNull()
-      expect(result.groups[0].members[0].name).toBe('tenant-v1')
+      expect(partsOf(result)).toEqual(['tenant-v1'])
     })
 
     /*

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

@@ -1,38 +1,15 @@
 /**
- * figure-format — 한 문이 두 판을 읽는다.
+ * figure-format — the doors a stored source goes through: save, release, hand to a board.
  *
- * 전환 중에는 `source` 칸에 V2 정본과 V3 자산이 섞여 있다(ADR-0087). 저장·발행·되돌리기·소비처가
- * 저마다 판을 따지면 네 자리에서 답이 갈린다. 여기서 한 번 묻는다.
- *
- * 이 파일이 지키는 것:
- *   - 판은 자산이 적은 `version` 으로 안다. 생김새로 짐작하지 않는다.
- *   - 판을 모르는 정본은 거절한다 — 알아보지 못하는 것을 저장하면 안 된다.
- *   - V3 자산도 저장·발행·되돌리기·소비처를 지난다. 이 넷은 전에 V2 만 지날 수 있었다.
- *   - 예산 칸(`triangles`·`groups`)은 두 판에서 같은 뜻이다.
+ * What this file holds:
+ *   - the format is known from the `version` the asset carries, never guessed from its shape;
+ *   - a source that does not name the format is refused -- what cannot be identified is not stored;
+ *   - the budget columns (`triangles`, `groups`) and the score are the kernel's.
  */
 import { createV3Asset, addV3Box, addV3Primitive, serializeV3Asset, applyV3Authoring, proposeV3Occupancy, placeholderType, v3ScoreOf } from '@hatiolab/figure-model'
 import type { V3Asset } from '@hatiolab/figure-model'
 
-import { consumablePayloadOf, formatOf, inspectAnySource, parseAnySource } from './figure-format'
-import { FigureSourceError } from './figure-source'
-
-/** 온전한 V2 정본 하나. 바닥에 선 상자 한 부품. */
-const v2Source = (over: Record<string, unknown> = {}) =>
-  JSON.stringify({
-    version: 2,
-    type: 'MIXER',
-    base: { x: 300, y: 800, z: 300 },
-    detailLevel: 'M',
-    parts: [
-      {
-        name: 'body',
-        primitive: 'cube',
-        transform: { position: { x: 0, y: 50, z: 0 }, size: { x: 100, y: 100, z: 100 } },
-        material: { token: 'palette.primary' }
-      }
-    ],
-    ...over
-  })
+import { FigureSourceError, consumablePayloadOf, inspectSource, parseSource } from './figure-format'
 
 /** 온전한 V3 자산 하나: 바닥에 선 상자와, 부품에서 제안받아 확정한 점유 부피. */
 function v3Asset(): V3Asset {
@@ -50,68 +27,56 @@ const v3Source = () => serializeV3Asset(v3Asset())
 
 describe('figure-format — 판을 알아보는 문', () => {
   describe('판은 자산이 적는다', () => {
-    it('숫자 version 은 V2, figure-v3-asset-1 은 V3 다', () => {
-      expect(formatOf(v2Source())).toBe('v2')
-      expect(formatOf(v3Source())).toBe('v3')
-    })
-
     it('판을 안 적은 정본은 거절한다 — 생김새로 짐작하지 않는다', () => {
-      expect(() => formatOf(JSON.stringify({ type: 'MIXER', parts: [] }))).toThrow(FigureSourceError)
-      try {
-        formatOf(JSON.stringify({ type: 'MIXER' }))
-      } catch (e) {
-        expect((e as FigureSourceError).findings[0].code).toBe('source-format-unknown')
+      for (const text of [JSON.stringify({ type: 'MIXER', parts: [] }), JSON.stringify({ version: 2, type: 'MIXER', parts: [] })]) {
+        expect(() => parseSource(text)).toThrow(FigureSourceError)
+        try {
+          parseSource(text)
+        } catch (e) {
+          expect((e as FigureSourceError).findings[0].code).toBe('source-format-unknown')
+        }
       }
     })
 
     it('JSON 이 아니면 그 말로 거절한다', () => {
       try {
-        formatOf('{')
+        parseSource('{')
       } catch (e) {
         expect((e as FigureSourceError).findings[0].code).toBe('source-not-json')
       }
     })
   })
 
-  describe('저장 — 두 판 다 지난다', () => {
-    it('V2 정본은 전과 같이 점수·삼각형·묶음을 받는다', () => {
-      const parsed = parseAnySource(v2Source())
-      expect(parsed.format).toBe('v2')
-      expect(parsed.derived.triangles).toBe(12)
-      expect(parsed.derived.groups).toBeGreaterThan(0)
-      expect(typeof parsed.derived.score).toBe('number')
-    })
-
-    it('V3 자산은 같은 예산 칸을 받는다 — 상자 하나는 두 판에서 다 삼각형 12 다', () => {
-      const parsed = parseAnySource(v3Source())
-      expect(parsed.format).toBe('v3')
+  describe('저장', () => {
+    it('예산 칸을 커널이 잰다 — 상자 하나는 삼각형 12, 묶음 1', () => {
+      const parsed = parseSource(v3Source())
       expect(parsed.derived.triangles).toBe(12)
       expect(parsed.derived.groups).toBe(1)
     })
 
-    it('V3 의 점수 칸은 v3ScoreOf 다 — 저작면의 성숙도 탭과 같은 수(수석 아키텍트 판정 09-24)', () => {
-      const score = parseAnySource(v3Source()).derived.score
+    it('점수 칸은 v3ScoreOf 다 — 저작면의 성숙도 탭과 같은 수(수석 아키텍트 판정 09-24)', () => {
+      const score = parseSource(v3Source()).derived.score
       expect(score).toBe(v3ScoreOf(v3Asset())!.score)
       expect(score).toBeGreaterThan(0)
     })
 
-    it('형식을 어긴 V3 자산은 거절한다', () => {
+    it('형식을 어긴 자산은 거절한다', () => {
       const broken = JSON.parse(v3Source())
       broken.appearance = []
-      expect(() => parseAnySource(JSON.stringify(broken))).toThrow(FigureSourceError)
+      expect(() => parseSource(JSON.stringify(broken))).toThrow(FigureSourceError)
     })
   })
 
-  describe('발행 판정 — 두 판 다 지난다', () => {
+  describe('발행 판정', () => {
     it('제 부피 안에 든 V3 자산은 막지 않는다', () => {
-      const inspection = inspectAnySource(v3Source())
+      const inspection = inspectSource(v3Source())
       expect(inspection.blocked).toBe(false)
     })
 
     it('선언한 부피 밖으로 나간 부품은 이름과 함께 막는다', () => {
       let asset = v3Asset()
       asset = addV3Box(asset, { id: 'arm', size: { x: 100, y: 100, z: 100 }, position: { x: 900, y: 50, z: 0 } })
-      const inspection = inspectAnySource(serializeV3Asset(asset))
+      const inspection = inspectSource(serializeV3Asset(asset))
       expect(inspection.blocked).toBe(true)
       expect(inspection.findings.some(f => f.code === 'part-outside-occupancy' && f.at === 'arm')).toBe(true)
     })
@@ -119,7 +84,7 @@ describe('figure-format — 판을 알아보는 문', () => {
     it('부피를 선언하지 않은 V3 자산은 막는다', () => {
       let asset = createV3Asset('Bare')
       asset = addV3Box(asset, { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
-      const inspection = inspectAnySource(serializeV3Asset(asset))
+      const inspection = inspectSource(serializeV3Asset(asset))
       expect(inspection.blocked).toBe(true)
       expect(inspection.findings.some(f => f.code === 'occupancy-undeclared')).toBe(true)
     })
@@ -149,7 +114,7 @@ describe('figure-format — 판을 알아보는 문', () => {
         placement: 'floor'
       })
 
-      const inspection = inspectAnySource(serializeV3Asset(asset))
+      const inspection = inspectSource(serializeV3Asset(asset))
       const sampled = inspection.findings.find(f => f.code === 'state-range-sampled')
       expect(sampled).toBeDefined()
       expect(sampled!.blocking).toBe(false)
@@ -159,11 +124,11 @@ describe('figure-format — 판을 알아보는 문', () => {
     })
 
     it('정본이 없으면 전과 같이 그 말로 막는다', () => {
-      expect(inspectAnySource(null).findings[0].code).toBe('no-source')
+      expect(inspectSource(null).findings[0].code).toBe('no-source')
     })
 
     it('바뀐 것 없는 V3 재발행은 아무 말도 없이 지난다', () => {
-      const again = inspectAnySource(v3Source(), v3Source())
+      const again = inspectSource(v3Source(), v3Source())
       expect(again.blocked).toBe(false)
       expect(again.findings.filter(f => f.code !== 'state-range-sampled')).toEqual([])
     })
@@ -171,7 +136,7 @@ describe('figure-format — 판을 알아보는 문', () => {
     it('놓인 인스턴스가 기대던 것을 없앤 V3 재발행은 막는다 — 없어진 능력을 이름으로 댄다', () => {
       const before = v3Asset()
       before.document.capabilities.names = ['Holdable']
-      const inspection = inspectAnySource(v3Source(), serializeV3Asset(before))
+      const inspection = inspectSource(v3Source(), serializeV3Asset(before))
       const gone = inspection.findings.find(f => f.code === 'capability-gone')
       expect(gone).toBeDefined()
       expect(gone!.blocking).toBe(true)
@@ -180,24 +145,11 @@ describe('figure-format — 판을 알아보는 문', () => {
       expect(gone!.how).toBeTruthy()
       expect(inspection.blocked).toBe(true)
     })
-
-    it('직전 발행판이 V2 면 견주지 못했다고 말한다 — 막지는 않는다', () => {
-      /* 전환한 도형의 직전 발행판은 모두 V2 다. 두 판을 견주는 길은 없으니 그 사실을 적는다. */
-      const converted = inspectAnySource(v3Source(), v2Source())
-      const warning = converted.findings.find(f => f.code === 'released-unreadable')
-      expect(warning).toBeDefined()
-      expect(warning!.blocking).toBe(false)
-      expect(converted.blocked).toBe(false)
-
-      /* 첫 발행에는 견줄 것이 없으니 그 말도 없다. */
-      expect(inspectAnySource(v3Source()).findings.some(f => f.code === 'released-unreadable')).toBe(false)
-    })
   })
 
   /*
-    ADR-0087 5단계에서 V3 판정이 저작자가 보는 유일한 발행 판정이 된다. 그때까지 이 판정은 발행 패널에 영어 문장
-    (`detail`)을 그대로 냈고 왜 · 어떻게가 없었다 — 사용자가 2026-09-19 에 「가장 큰 문제」로 짚고 V2 에서 고친 바로
-    그 모양이다. 문장은 요청의 언어를 아는 서버가 코드와 값에서 만든다(ADR-0054).
+    이 판정은 한때 발행 패널에 영어 문장(`detail`)을 그대로 냈고 왜 · 어떻게가 없었다 — 사용자가 2026-09-19 에
+    「가장 큰 문제」로 짚은 모양이다. 문장은 요청의 언어를 아는 서버가 코드와 값에서 만든다(ADR-0054).
   */
   describe('V3 판정의 문장 — 발행 패널의 말로', () => {
     const KO = require('../../../translations/ko.json') as Record<string, string>
@@ -223,7 +175,7 @@ describe('figure-format — 판을 알아보는 문', () => {
     }
 
     it('넘은 부품은 이름 · 축 · 넘은 양을 화면 말투로 말하고, 왜와 어떻게를 함께 낸다', () => {
-      const finding = inspectAnySource(outside(), null, translatorOf(KO)).findings.find(f => f.code === 'part-outside-occupancy')!
+      const finding = inspectSource(outside(), null, translatorOf(KO)).findings.find(f => f.code === 'part-outside-occupancy')!
 
       expect(finding.message).toMatch(/^'arm' 부품이 공간 선언을 X 로 [\d.]+mm 넘습니다\.$/)
       expect(finding.why).toMatch(/니다\.$/)
@@ -234,7 +186,7 @@ describe('figure-format — 판을 알아보는 문', () => {
     })
 
     it('공간을 선언하지 않은 도형은 무엇을 누르면 되는지 말한다', () => {
-      const finding = inspectAnySource(bare(), null, translatorOf(KO)).findings.find(f => f.code === 'occupancy-undeclared')!
+      const finding = inspectSource(bare(), null, translatorOf(KO)).findings.find(f => f.code === 'occupancy-undeclared')!
 
       expect(finding.message).toBe('이 도형은 차지하는 공간을 아직 선언하지 않았습니다.')
       expect(finding.how).toContain('부품에 맞추기')
@@ -242,14 +194,14 @@ describe('figure-format — 판을 알아보는 문', () => {
 
     it('부품이 없는 새 도형에는 도형을 먼저 추가하라고 한다 — 화면은 그때 맞추기 단추를 내지 않는다', () => {
       const empty = serializeV3Asset(createV3Asset('Empty'))
-      const finding = inspectAnySource(empty, null, translatorOf(KO)).findings.find(f => f.code === 'occupancy-undeclared')!
+      const finding = inspectSource(empty, null, translatorOf(KO)).findings.find(f => f.code === 'occupancy-undeclared')!
 
       expect(finding.how).toBe('먼저 도형을 추가한 뒤, 「부품에 맞추기」로 공간을 선언하세요.')
-      expect(inspectAnySource(empty).findings.find(f => f.code === 'occupancy-undeclared')!.how).toMatch(/^Add a shape first/)
+      expect(inspectSource(empty).findings.find(f => f.code === 'occupancy-undeclared')!.how).toMatch(/^Add a shape first/)
     })
 
     /*
-      V2 의 sizing-splits 가 V3 판정에 온 것(2026-09-24). 드라이룸 램프처럼 — 붙어 있던 부품이 도형을 키우면 떨어진다.
+      (2026-09-24) 드라이룸 램프처럼 — 붙어 있던 부품이 도형을 키우면 떨어진다.
       여기서는 손으로 만든다: 램프의 높이가 도형 높이(size.y)를 따라 올라가고, 몸통은 그대로다.
     */
     const splitting = () => {
@@ -266,7 +218,7 @@ describe('figure-format — 판을 알아보는 문', () => {
     }
 
     it('크기를 바꾸면 떨어지는 부품을 막고, 어느 부품이 어느 축에서인지 · 왜 · 어떻게를 말한다', () => {
-      const finding = inspectAnySource(splitting(), null, translatorOf(KO)).findings.find(f => f.code === 'parts-split-on-resize')
+      const finding = inspectSource(splitting(), null, translatorOf(KO)).findings.find(f => f.code === 'parts-split-on-resize')
 
       expect(finding?.blocking).toBe(true)
       expect(finding!.message).toBe("크기를 Y 로 2배로 하면 'lamp' 부품이 나머지에서 떨어집니다.")
@@ -285,7 +237,7 @@ describe('figure-format — 판을 알아보는 문', () => {
         asset.designInputs[`size.${axis}`] = 100
       }
       asset = applyV3Authoring(asset, { kind: 'scale-uniformly' } as never)
-      const finding = inspectAnySource(serializeV3Asset(asset), null, translatorOf(KO)).findings.find(f => f.code === 'sizing-not-uniform')
+      const finding = inspectSource(serializeV3Asset(asset), null, translatorOf(KO)).findings.find(f => f.code === 'sizing-not-uniform')
 
       expect(finding?.blocking).toBe(true)
       expect(finding!.message).toBe("이 도형은 한 비율로 커지는데, 크기를 X 로 2배로 하면 'body' 부품은 같이 커지지 않습니다.")
@@ -303,7 +255,7 @@ describe('figure-format — 판을 알아보는 문', () => {
         interpolation: { prefix: '{', suffix: '}' },
         keySeparator: false
       })
-      const finding = inspectAnySource(splitting(), null, i18next.t.bind(i18next)).findings.find(f => f.code === 'parts-split-on-resize')!
+      const finding = inspectSource(splitting(), null, i18next.t.bind(i18next)).findings.find(f => f.code === 'parts-split-on-resize')!
 
       expect(finding.message).toBe("크기를 Y 로 2배로 하면 'lamp' 부품이 나머지에서 떨어집니다.")
       expect(`${finding.message}${finding.how}`).not.toContain('&#39;')
@@ -318,36 +270,36 @@ describe('figure-format — 판을 알아보는 문', () => {
     })
 
     it('번역이 없으면 영어로 답한다 — 키를 찍지 않는다', () => {
-      const finding = inspectAnySource(outside()).findings.find(f => f.code === 'part-outside-occupancy')!
+      const finding = inspectSource(outside()).findings.find(f => f.code === 'part-outside-occupancy')!
 
       expect(finding.message).toMatch(/^'arm' goes [\d.]+ mm past the declared space on X\.$/)
       expect(finding.message).not.toContain('figure.gate.')
     })
 
     /*
-      V3 자산에는 type 이 없어 V2 의 임시 이름 검사가 돌지 않았고, 새 V3 도형이 `FIGURE_<uuid>` 로 발행됐다
-      (:3300, 2026-09-24). 발행하면 이름이 굳으므로 행의 type 으로 같은 거절을 한다.
+      자산에는 type 이 없어 임시 이름 검사가 돌지 않았고, 새 도형이 `FIGURE_<uuid>` 로 발행됐다(:3300, 2026-09-24).
+      발행하면 이름이 굳으므로 행의 type 으로 거절한다.
     */
-    it('임시 이름인 V3 도형은 발행을 막는다 — 이름은 행에 있다', () => {
-      /* The name a new V3 figure gets — the format's rule, the one the gate recognises. */
+    it('임시 이름인 도형은 발행을 막는다 — 이름은 행에 있다', () => {
+      /* The name a new figure gets — the format's rule, the one the gate recognises. */
       const placeholder = placeholderType()
-      const finding = inspectAnySource(v3Source(), null, translatorOf(KO), placeholder).findings.find(f => f.code === 'type-is-placeholder')
+      const finding = inspectSource(v3Source(), null, translatorOf(KO), placeholder).findings.find(f => f.code === 'type-is-placeholder')
 
       expect(finding?.blocking).toBe(true)
       expect(finding!.message).toBe(`'${placeholder}' 타입은 처음 저장할 때 붙은 임시 타입입니다.`)
       /* 화면의 칸 이름은 「타입」이다(`figure.label.figure-type`). */
       expect(finding!.how).toContain('타입 칸')
-      expect(inspectAnySource(v3Source(), null, translatorOf(KO), 'ROLLER_CONVEYOR').blocked).toBe(false)
+      expect(inspectSource(v3Source(), null, translatorOf(KO), 'ROLLER_CONVEYOR').blocked).toBe(false)
     })
 
     /* 코드가 묻는 키가 두 언어에 다 있어야 한다 — 없으면 그 언어의 화면에 영어가 섞인다. */
     it('판정이 묻는 키는 ko · en 에 다 있다', () => {
       const asked: string[] = []
       const t = translatorOf(KO, asked)
-      inspectAnySource(outside(), null, t)
-      inspectAnySource(bare(), null, t)
-      inspectAnySource(v3Source(), v3Source(), t)
-      inspectAnySource(v3Source(), null, t, 'FIGURE_ABCDEF12')
+      inspectSource(outside(), null, t)
+      inspectSource(bare(), null, t)
+      inspectSource(v3Source(), v3Source(), t)
+      inspectSource(v3Source(), null, t, 'FIGURE_ABCDEF12')
 
       const keys = [...new Set(asked)]
       expect(keys.length).toBeGreaterThan(5)
@@ -356,21 +308,13 @@ describe('figure-format — 판을 알아보는 문', () => {
     })
   })
 
-  describe('소비처 — 판마다 받을 것이 다르다', () => {
-    it('V2 는 전과 같이 청사진을 받는다', () => {
-      const payload = consumablePayloadOf(v2Source())
-      expect(payload.format).toBe('v2')
-      expect((payload.blueprint as { groups?: unknown[] }).groups!.length).toBeGreaterThan(0)
-      expect((payload.blueprint as Record<string, unknown>).format).toBeUndefined()
-    })
-
-    it('V3 는 자산을 그대로 받는다 — 그리는 쪽이 커널로 컴파일한다', () => {
+  describe('소비처', () => {
+    it('자산을 그대로 받는다 — 그리는 쪽이 커널로 컴파일한다', () => {
       const payload = consumablePayloadOf(v3Source())
-      expect(payload.format).toBe('v3')
-      expect((payload.asset as V3Asset).version).toBe('figure-v3-asset-1')
+      expect(payload.asset.version).toBe('figure-v3-asset-1')
     })
 
-    it('컴파일되지 않는 V3 자산은 소비처에 넘기지 않고 던진다', () => {
+    it('컴파일되지 않는 자산은 소비처에 넘기지 않고 던진다', () => {
       const broken = JSON.parse(v3Source())
       broken.designInputs = {}
       expect(() => consumablePayloadOf(JSON.stringify(broken))).toThrow()