@things-factory/figure-service 10.1.65 → 10.1.67

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

@@ -33,20 +33,13 @@ function stubRepository(rows: any[]) {
 const MINE = { id: 'domain-mine' }
 const THEIRS = { id: 'domain-theirs' }
 
-const SOURCE = {
-  version: 2,
-  type: 'MIXER',
-  base: { x: 300, y: 500, z: 300 },
-  detailLevel: 'M',
-  parts: [
-    {
-      name: 'body',
-      primitive: 'cube',
-      transform: { position: { x: 0, y: 250, z: 0 }, size: { x: 300, y: 400, z: 300 } },
-      material: { token: 'palette.primary' }
-    }
-  ]
-}
+/** A stored figure: one body on the floor, its room declared. */
+const SOURCE = (() => {
+  const model = require('@hatiolab/figure-model')
+  let asset = model.addV3Box(model.createV3Asset('Mixer'), { id: 'body', size: { x: 300, y: 400, z: 300 }, position: { x: 0, y: 200, z: 0 } })
+  asset = model.applyV3Authoring(asset, { kind: 'declare-occupancy', proposal: model.proposeV3Occupancy(asset), placement: 'floor' })
+  return asset
+})()
 
 const ROWS = [
   { id: 'fig-1', type: 'MIXER', name: '믹서', state: 'draft', domain: MINE, source: JSON.stringify(SOURCE) },
@@ -74,12 +67,7 @@ function install() {
         attempts: 1
       }
     },
-    compile: model.compile,
-    costOf: model.costOf,
-    scoreOf: model.scoreOf,
-    validate: model.validate,
-    isPlaceholderType: model.isPlaceholderType,
-    parseAnySource: require('./figure-format').parseAnySource,
+    parseSource: require('./figure-format').parseSource,
     v3CostOf: model.v3CostOf,
     v3ScoreOf: model.v3ScoreOf
   })
@@ -251,7 +239,7 @@ describe('대화면 문맥에서 대상을 해소한다', () => {
     const result = await toolNamed('getFigureSource').builder({}, ctx())
 
     expect(result.id).toBe('fig-1')
-    expect(result.source.type).toBe('MIXER')
+    expect(result.source.name).toBe('Mixer')
   })
 
   it.each(['getFigureSource', 'inspectFigure'])('%s: 목록의 대상 누락은 채팅을 끊지 않고 다음 동작을 안내한다', async name => {
@@ -267,7 +255,7 @@ describe('대화면 문맥에서 대상을 해소한다', () => {
     const target = catalog.figures.find((figure: any) => figure.name === '믹서')
     const result = await toolNamed('getFigureSource').builder({ figureId: target.id }, ctx({}))
     expect(result.id).toBe('fig-1')
-    expect(result.source.type).toBe('MIXER')
+    expect(result.source.name).toBe('Mixer')
   })
 
   it('정본이 없는 도형은 없다고 말한다 — 지어내지 않는다', async () => {
@@ -281,56 +269,7 @@ describe('대화면 문맥에서 대상을 해소한다', () => {
     const result = await toolNamed('getFigureSource').builder({ figureId: 'fig-1' }, ctx())
 
     expect(result.cost.triangles).toBeGreaterThan(0)
-    expect(result.cost.drawCalls).toBeGreaterThan(0)
-  })
-
-  it('저장 전 초안이 있으면 그것을 읽고, 초안이라는 사실도 함께 낸다', async () => {
-    const draft = {
-      ...SOURCE,
-      parts: [
-        ...SOURCE.parts,
-        {
-          name: 'lid',
-          primitive: 'cube',
-          transform: { position: { x: 0, y: 500, z: 0 }, size: { x: 100, y: 20, z: 100 } },
-          material: { token: 'palette.primary' }
-        }
-      ]
-    }
-    const result = await toolNamed('getFigureSource').builder({}, ctx({ figureId: 'fig-1', palette: ['palette.primary'], draftSource: draft }))
-
-    expect(result.draft).toBe(true)
-    expect(result.source.parts).toHaveLength(2)
-  })
-
-  it('다른 type의 초안은 거절한다 — 브라우저 문맥으로 저장 식별자를 바꾸지 않는다', async () => {
-    await expect(
-      toolNamed('getFigureSource').builder(
-        {},
-        ctx({ figureId: 'fig-1', palette: ['palette.primary'], draftSource: { ...SOURCE, type: 'FORKLIFT' } })
-      )
-    ).rejects.toThrow(/does not match Figure/)
-  })
-
-  it('재현: 기존 도형 편집 중 미저장 초안의 type이 FIGURE여도 현재 도형 초안으로 허용해야 한다', async () => {
-    // DB의 row는 MIXER(또는 OHT)이지만, 캔버스/도크의 초안 type은 일반 'FIGURE'일 수 있음
-    const result = await toolNamed('getFigureSource').builder(
-      {},
-      ctx({ figureId: 'fig-1', palette: ['palette.primary'], draftSource: { ...SOURCE, type: 'FIGURE' } })
-    )
-    expect(result.draft).toBe(true)
-    expect(result.type).toBe('MIXER')
-  })
-
-  it('재현: LLM이 새 미저장 모델의 임시 타입(FIGURE_MTZO5R10)을 figureId로 전달해도 초안을 읽어야 한다', async () => {
-    const tempDraft = { ...SOURCE, type: 'FIGURE_MTZO5R10' }
-    const host = { editorMode: 'new', draftSource: tempDraft, palette: ['palette.primary'] }
-    const result = await toolNamed('getFigureSource').builder(
-      { figureId: 'FIGURE_MTZO5R10' },
-      ctx(host)
-    )
-    expect(result.draft).toBe(true)
-    expect(result.type).toBe('FIGURE_MTZO5R10')
+    expect(result.cost.groups).toBeGreaterThan(0)
   })
 })
 
@@ -397,8 +336,8 @@ describe('제안을 요청할 때', () => {
     expect(proposed).toHaveLength(0)
   })
 
-  it('V3 가 아닌 원본은 고치지 않는다 — V2 를 제안기에 건네지 않는다', async () => {
-    const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '고쳐줘' }, ctx({ figureId: 'fig-1', context: 'c', revision: 1 }))
+  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)
   })
@@ -439,7 +378,7 @@ describe('제안을 요청할 때', () => {
     __setFigureToolDepsForTest({
       getRepository: () => stubRepository(ROWS),
       Figure: class {},
-      parseAnySource: require('./figure-format').parseAnySource,
+      parseSource: require('./figure-format').parseSource,
       proposeFigureV3: async () => {
         throw new ProposeV3Failure('만들지 못했습니다.', ['ATTACH_FACE: steps[4]: attach: faces along x'], 3)
       },
@@ -480,19 +419,17 @@ describe('제안이 카드가 된다', () => {
   })
 })
 
-describe('V3 도형이 열려 있을 때', () => {
+describe('도형이 모델러에 열려 있을 때', () => {
   it('저장 전 V3 초안을 V3 로 읽고, V3 셈으로 잰다', async () => {
     const draft = v3Draft()
     const got = await toolNamed('getFigureSource').builder({}, ctx({ figureId: 'fig-1', draftSource: draft, palette: ['palette.primary'] }))
-    expect(got.format).toBe('v3')
     expect(got.draft).toBe(true)
     expect(got.cost.triangles).toBe(12)
     expect(got.score.grade).toBe('A')
   })
 
-  it('형식을 어긴 V3 초안은 V3 의 말로 거절한다 — V2 파서의 말이 아니다', async () => {
+  it('형식을 어긴 초안은 저장 문의 말로 거절한다', async () => {
     const broken = { ...v3Draft(), appearance: [] }
-    await expect(toolNamed('getFigureSource').builder({}, ctx({ figureId: 'fig-1', draftSource: broken, palette: ['palette.primary'] }))).rejects.toThrow(/V3 draft/)
-    await expect(toolNamed('getFigureSource').builder({}, ctx({ figureId: 'fig-1', draftSource: broken, palette: ['palette.primary'] }))).rejects.not.toThrow(/base 가 없다/)
+    await expect(toolNamed('getFigureSource').builder({}, ctx({ figureId: 'fig-1', draftSource: broken }))).rejects.toThrow(/unsaved draft is invalid/)
   })
 })

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

@@ -57,19 +57,12 @@ function getDeps(): any {
     _deps = {
       getRepository: shell.getRepository,
       Figure: entity.Figure,
-      /*
-        The format-aware door, so an AI asked about a V3 model gets the V3 judgement rather than a V2 parser's
-        complaint. The tool's own contract is unchanged: it reads, it never saves (ADR-0087).
-      */
-      inspectSource: format.inspectAnySource,
-      parseAnySource: format.parseAnySource,
+      /* The same doors a save and a release go through. The tool reads; it never saves. */
+      inspectSource: format.inspectSource,
+      parseSource: format.parseSource,
       v3CostOf: model.v3CostOf,
       v3ScoreOf: model.v3ScoreOf,
       proposeFigureV3: proposeV3.proposeFigureV3,
-      compile: model.compile,
-      costOf: model.costOf,
-      scoreOf: model.scoreOf,
-      validate: model.validate,
       isPlaceholderType: model.isPlaceholderType
     }
   }
@@ -108,55 +101,24 @@ async function figureInDomain(figureId: string, domainId: string): Promise<any>
 }
 
 /**
- * figureId 또는 hostContext로부터 대상 Figure row(또는 미저장 초안 가상 row)를 해소한다.
+ * The figure a tool is about: by id, or by its type name, in the caller's domain. None named: none.
  */
-async function resolveFigureTarget(figureId: string | undefined, domainId: string, host: any): Promise<any> {
-  if (
-    host?.editorMode === 'new' &&
-    host?.draftSource &&
-    (!figureId || figureId === host.draftSource.type || figureId.startsWith('FIGURE'))
-  ) {
-    return unsavedFigure(host)
-  }
-
-  if (figureId) {
-    const { getRepository, Figure } = getDeps()
-    let found = await getRepository(Figure).findOne({
-      where: { id: figureId, domain: { id: domainId } }
-    })
-    if (!found) {
-      found = await getRepository(Figure).findOne({
-        where: { type: figureId, domain: { id: domainId } }
-      })
-    }
-    if (!found) {
-      if (
-        host?.editorMode === 'new' ||
-        (host?.draftSource &&
-          (host.draftSource.type === figureId ||
-            figureId.startsWith('FIGURE') ||
-            !host.figureId ||
-            host.figureId === figureId))
-      ) {
-        const unsaved = unsavedFigure(host)
-        if (unsaved) return unsaved
-      }
-      throw new Error(`figure not found in this tenant: ${figureId}`)
-    }
-    return found
-  }
-
-  return unsavedFigure(host)
+async function resolveFigureTarget(figureId: string | undefined, domainId: string, _host: any): Promise<any> {
+  if (!figureId) return undefined
+  const { getRepository, Figure } = getDeps()
+  const found =
+    (await getRepository(Figure).findOne({ where: { id: figureId, domain: { id: domainId } } })) ??
+    (await getRepository(Figure).findOne({ where: { type: figureId, domain: { id: domainId } } }))
+  if (!found) throw new Error(`figure not found in this tenant: ${figureId}`)
+  return found
 }
 
 /**
- * 모델러가 아직 저장하지 않은 source를 도구가 읽는 유일한 길.
+ * The source a tool reads: the draft on screen when the modeller has this figure open, else the stored one.
  *
- * host context는 브라우저가 보낸 값이므로 권한 근거가 될 수 없다. 먼저 `row`를 현재 도메인에서
- * 찾은 뒤에만 보며, Figure의 불변 type과 형식 검증을 다시 확인한다. 검증되지 않은 큰 객체를 LLM
- * 프롬프트로 옮기면 비용만 태우고, DB에 있던 Figure와 다른 것을 고친다고 잘못 말할 수 있다.
+ * The host context is the browser's, so it is no ground for access: the row is found in the domain first, and the
+ * draft is put through the same door a save goes through before anything reads it.
  */
-/** A V3 asset names its format in `version`; a V2 FigureSource carries a number there. */
 const isV3 = (source: any) => source?.version === 'figure-v3-asset-1'
 
 /**
@@ -173,51 +135,19 @@ function figureNotOpen() {
 }
 
 function sourceForTool(row: any, host: any): { source: any; draft: boolean } {
-  const isMatch = host?.figureId === row.id || (!row.id && host?.editorMode === 'new') || (!row.id && !host?.figureId)
-  const draft = isMatch ? host?.draftSource : undefined
-  if (!draft) {
-    return { source: row.source ? JSON.parse(row.source) : null, draft: false }
-  }
-
-  if (typeof draft !== 'object' || Array.isArray(draft)) {
-    throw new Error('the unsaved draft is not a FigureSource object')
-  }
+  const draft = host?.figureId === row.id ? host?.draftSource : undefined
+  if (!draft) return { source: row.source ? JSON.parse(row.source) : null, draft: false }
 
+  if (typeof draft !== 'object' || Array.isArray(draft)) throw new Error('the unsaved draft is not a figure asset')
   const serialized = JSON.stringify(draft)
-  if (serialized.length > 100_000) {
-    throw new Error('the unsaved draft is too large to safely review')
+  if (serialized.length > 100_000) throw new Error('the unsaved draft is too large to safely review')
+  try {
+    getDeps().parseSource(serialized)
+  } catch (e: any) {
+    const findings = Array.isArray(e?.findings) ? e.findings.map((one: any) => one.message).join(' · ') : String(e?.message ?? e)
+    throw new Error(`the unsaved draft is invalid: ${findings}`)
   }
-
-  /* A V3 draft is checked as V3 -- the same door a save goes through. It names no type; the row does. */
-  if (isV3(draft)) {
-    try {
-      getDeps().parseAnySource(serialized)
-    } catch (e: any) {
-      const findings = Array.isArray(e?.findings) ? e.findings.map((one: any) => one.message).join(' · ') : String(e?.message ?? e)
-      throw new Error(`the unsaved V3 draft is invalid: ${findings}`)
-    }
-    return { source: draft, draft: true }
-  }
-
-  const { validate, isPlaceholderType } = getDeps()
-  const checked = validate(draft)
-  if (checked.errors.length > 0) {
-    throw new Error(`the unsaved draft is invalid: ${checked.errors.map((one: any) => one.message).join(' · ')}`)
-  }
-
-  let normalizedDraft = draft
-  if (draft.type !== row.type) {
-    // 템플릿 기본값 'FIGURE', 임시 draftType('FIGURE_...'), 또는 빈 값인 경우
-    // 현재 열려 있는 Figure의 실제 type으로 보정/정규화한다.
-    const isGenericOrTempType = !draft.type || draft.type === 'FIGURE' || isPlaceholderType(draft.type)
-    if (isGenericOrTempType && row.type) {
-      normalizedDraft = { ...draft, type: row.type }
-    } else {
-      throw new Error(`the unsaved draft type '${draft.type}' does not match Figure '${row.type}'`)
-    }
-  }
-
-  return { source: normalizedDraft, draft: true }
+  return { source: draft, draft: true }
 }
 
 /**
@@ -244,14 +174,6 @@ function missingFigureTarget() {
   }
 }
 
-function unsavedFigure(host: any): any | undefined {
-  if (host?.editorMode !== 'new' || !host?.draftSource) return undefined
-  const row = { id: host.figureId, type: host.draftSource.type || 'FIGURE', name: '', state: 'draft' }
-  // Reuse size, shape and vocabulary validation before trusting browser content.
-  const current = sourceForTool(row, host)
-  return { ...row, source: JSON.stringify(current.source) }
-}
-
 const FIGURE_ID_ARG = {
   figureId: {
     type: 'string',
@@ -303,7 +225,7 @@ function figureToolSpecs(): ToolSpec[] {
        * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 도형을 읽는 권한 검사가 선언에서 사라진다. */
       doors: ['Query.figure'],
       description:
-        'Returns the canonical FigureSource of one figure, with its measured cost ' +
+        'Returns the source (the figure asset) of one figure, with its measured cost ' +
         '(triangles, part groups, and how many of it hold 60fps on one screen). Call it before proposing a revision — ' +
         'revising without reading it means proposing against a guess.',
       schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },
@@ -319,25 +241,8 @@ function figureToolSpecs(): ToolSpec[] {
           return { id: row.id, type: row.type, name: row.name, source: null, cost: null }
         }
 
-        if (isV3(current.source)) {
-          /* A V3 asset is measured as V3 -- triangles, draw groups, and its grade against one screen. */
-          const { v3CostOf, v3ScoreOf } = getDeps()
-          return {
-            id: row.id,
-            type: row.type,
-            name: row.name,
-            state: row.state,
-            format: 'v3',
-            source: current.source,
-            draft: current.draft,
-            cost: v3CostOf(current.source),
-            score: v3ScoreOf(current.source) ?? null
-          }
-        }
-
-        const { compile, costOf, scoreOf } = getDeps()
-        const blueprint = compile(current.source)
-
+        /* Measured as the catalogue measures it: triangles, draw groups, and its grade against one screen. */
+        const { v3CostOf, v3ScoreOf } = getDeps()
         return {
           id: row.id,
           type: row.type,
@@ -345,8 +250,8 @@ function figureToolSpecs(): ToolSpec[] {
           state: row.state,
           source: current.source,
           draft: current.draft,
-          cost: costOf(blueprint, 100),
-          score: scoreOf(blueprint)
+          cost: v3CostOf(current.source),
+          score: v3ScoreOf(current.source) ?? null
         }
       }
     },

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

@@ -25,7 +25,7 @@ export class NewFigure {
   @Field(type => [String], { nullable: true, description: 'Free-form tags. A figure may carry several.' })
   tags?: string[]
 
-  @Field({ description: 'The canonical FigureSource JSON.' })
+  @Field({ description: 'The figure asset JSON (figure-v3-asset-1).' })
   source: string
 
   @Field({ nullable: true, description: 'JSON definition of the master-data fields an instance carries.' })
@@ -70,7 +70,7 @@ export class FigurePatch {
   @Field(type => [String], { nullable: true, description: 'The new tags. An empty list clears them; omitting the field leaves them.' })
   tags?: string[]
 
-  @Field({ nullable: true, description: 'The new FigureSource JSON.' })
+  @Field({ nullable: true, description: 'The new figure asset JSON (figure-v3-asset-1).' })
   source?: string
 
   @Field({ nullable: true, description: 'The new master-data field definition.' })
@@ -136,46 +136,9 @@ export class FigureSaveResult {
  * 것들이라 그 칸이 필요 없었다. 발행 판정은 막는 것과 알리는 것을 함께 내므로, 어느 쪽인지를 값이
  * 스스로 말해야 한다 — 코드를 보고 화면이 다시 분류하면 규칙이 두 벌이 된다.
  */
-/** A measured, one-anchor repair candidate for a release-gate sizing split. */
-@ObjectType({ description: 'A reversible anchor change measured to reduce a sizing split.' })
-export class FigureGateFix {
-  @Field({ description: 'Sizing test that this candidate improves, for example y or x-y.' })
-  findingWay: string
-
-  @Field({ description: 'Stable FigureSource part name to change.' })
-  part: string
-
-  @Field({ description: 'Axis whose anchor will change.' })
-  axis: string
-
-  @Field({ nullable: true, description: 'Current explicit anchor, if one is present.' })
-  from?: string
-
-  @Field({ description: 'Suggested explicit anchor: min, center, max, or span.' })
-  to: string
-
-  @Field(type => Int, { description: 'Number of blocking sizing-split checks removed by this one change.' })
-  resolved: number
-
-  @Field({ description: 'True only when every blocking sizing check is clear after remeasurement.' })
-  safe: boolean
-}
-
-@ObjectType({ description: 'A coordinated, fully remeasured set of anchor changes that clears release-blocking sizing splits.' })
-export class FigureGateFixPlan {
-  @Field(type => [FigureGateFix], { description: 'The draft-only anchor changes to apply together.' })
-  fixes: FigureGateFix[]
-
-  @Field(type => Int, { description: 'Number of blocking sizing checks cleared by the complete plan.' })
-  resolved: number
-
-  @Field({ description: 'True only when the full plan was remeasured with no sizing split left.' })
-  safe: boolean
-}
-
 @ObjectType({ description: 'One finding from the release gate.' })
 export class FigureGateFinding {
-  @Field({ description: 'Stable code — figure-model validation codes, or sizing-splits / sizing-loose.' })
+  @Field({ description: 'Stable code of the gate finding, for example part-outside-occupancy or parts-split-on-resize.' })
   code: string
 
   @Field({ description: 'Human-readable message.' })
@@ -190,18 +153,6 @@ export class FigureGateFinding {
   @Field({ nullable: true, description: 'Where it points: part names that came apart, or a path in the source.' })
   at?: string
 
-  @Field(type => [FigureGateFix], {
-    nullable: true,
-    description: 'Measured repair candidates. They are previews until the author explicitly applies one.'
-  })
-  fixes?: FigureGateFix[]
-
-  @Field(type => FigureGateFixPlan, {
-    nullable: true,
-    description: 'A coordinated recommended repair, available only when the complete sizing suite clears.'
-  })
-  fixPlan?: FigureGateFixPlan
-
   @Field({ description: 'True when this finding blocks the release.' })
   blocking: boolean
 }

package/server/service/figure/figure-v3-write.ts

@@ -1,4 +1,4 @@
-import { parseV3Asset, serializeV3Asset, compileV3Asset, v3CostOf } from '@hatiolab/figure-model'
+import { parseV3Asset, serializeV3Asset, compileV3Asset, v3CostOf, v3ScoreOf } from '@hatiolab/figure-model'
 
 export interface V3WriteCriteria {
   id: string
@@ -24,14 +24,13 @@ export function prepareV3Write(source: string, existing?: { source?: string }, e
   const asset = parseV3Asset(source)
   compileV3Asset(asset)
   /*
-    The same measure `parseAnySource` uses, so the catalogue's budget columns do not depend on which mutation
-    wrote the row. `score` stays null: it measures V2 reuse and nothing has measured V3 (ADR-0087).
+    The same measure `parseSource` uses, so the catalogue's columns do not depend on which mutation wrote the row.
   */
   const cost = v3CostOf(asset)
   return {
     source: serializeV3Asset(asset),
     name: asset.name,
-    score: null,
+    score: v3ScoreOf(asset)?.score ?? null,
     triangles: cost.triangles,
     groups: cost.groups,
     state: 'draft' as const

package/server/service/figure/figure.ts

@@ -19,17 +19,12 @@ import { Domain, longTextColumn } from '@things-factory/shell'
  *
  * `Board` 를 준용한다. 다른 점만 주석으로 적는다.
  *
- * ## 무엇을 담나 — `FigureSource` 다, 씬 모델이 아니다
+ * ## 무엇을 담나 — 도형 자산이다, 씬 모델이 아니다
  *
- * 정본 형식은 `@hatiolab/figure-model` 이 정한다(`FigureSource`). 씬 컴포넌트 트리를
- * 담지 않는다. 담으면 저작도구가 씬 편집기가 되고, 부품 이름·상태 슬롯·애니메이션
- * 자리가 형식에 없어 따로 관리해야 한다.
+ * 형식은 `@hatiolab/figure-model` 이 정한다(`figure-v3-asset-1`). 씬 컴포넌트 트리를 담지 않는다.
+ * 컴파일한 것도 저장하지 않는다 — 원본에서 파생되므로 소비하는 쪽이 커널로 컴파일한다. 저장하면 원본과 갈린다.
  *
- * 청사진(`FigureBlueprint`)은 **저장하지 않는다.** 정본에서 파생되는 캐시이므로
- * 소비하는 쪽이 `compile()` 로 만든다. 저장하면 정본과 갈린다.
- *
- * 그래서 `baseWidth`·`anchor`·`statusSlots`·`parts`·`animations` 같은 것을 컬럼으로
- * 두지 않는다 — 전부 `source` 안에 이미 있는 자리다. 두 벌이면 갈린다.
+ * 그래서 부품·움직임·자리 같은 것을 컬럼으로 두지 않는다 — 전부 `source` 안에 이미 있다. 두 벌이면 갈린다.
  *
  * 설계: `docs/design/figure-modules.md` §2
  */
@@ -39,7 +34,7 @@ import { Domain, longTextColumn } from '@things-factory/shell'
   where: '"deleted_at" IS NULL'
 })
 @Index('ix_figure_2', (figure: Figure) => [figure.domain, figure.category])
-@ObjectType({ description: 'An authored 3D component type — the canonical FigureSource plus its metadata.' })
+@ObjectType({ description: 'An authored 3D component type — its figure asset plus its metadata.' })
 export class Figure {
   @PrimaryGeneratedColumn('uuid')
   @Field(type => ID, { nullable: true, description: 'Unique identifier for the figure.' })
@@ -119,13 +114,13 @@ export class Figure {
   state?: 'draft' | 'released'
 
   /**
-   * `FigureSource` JSON.
+   * The figure asset JSON (`figure-v3-asset-1`).
    *
    * `Board.model` 자리이지만 이름을 바꿨다 — 「씬 모델이 아니다」를 필드 이름이
    * 드러내야 한다.
    */
   @Column({ nullable: true, ...longTextColumn() })
-  @Field({ nullable: true, description: 'The canonical FigureSource JSON authored by the modeller.' })
+  @Field({ nullable: true, description: 'The figure asset JSON (figure-v3-asset-1) authored by the modeller.' })
   source?: string
 
   // ── 파생값 — 저장하는 이유가 하나뿐이다 ──────────────────────────────────

package/server/service/index.ts

@@ -1,7 +1,7 @@
 // Entity types
 export * from './figure/figure.js'
 export * from './figure/figure-type.js'
-export * from './figure/figure-source.js'
+export * from './figure/figure-format.js'
 export * from './figure/figure-history.js'
 
 // Entities, resolvers

package/dist-server/service/figure/figure-gate.d.ts

@@ -1,93 +0,0 @@
-import type { Axis } from '@hatiolab/figure-model';
-/** Service transport shape. It deliberately contains only an explicit, reversible FigureSource edit. */
-export interface GateFix {
-    findingWay: string;
-    part: string;
-    axis: Axis;
-    from?: string;
-    to: 'min' | 'center' | 'max' | 'span';
-    resolved: number;
-    /** True only when rechecking every sizing case leaves no release-blocking split. */
-    safe: boolean;
-}
-/**
- * A coordinated repair, measured from the current source all the way through the sizing suite.
- * A split often involves several independently anchored parts, so no single anchor edit can be
- * called a solution. This remains a draft-only edit; it is never saved or released by the gate.
- */
-export interface GateFixPlan {
-    fixes: GateFix[];
-    resolved: number;
-    /** True only after the complete plan leaves no release-blocking sizing split. */
-    safe: boolean;
-}
-/**
- * 발행해도 되나 — **서버가 판정한다.**
- *
- * ## 왜 서버인가
- *
- * 이 검사는 브라우저 하네스에만 있었다(`test/browser/check-figure-scaling.mjs`). 사람이 돌릴 때만
- * 돌았고, 발행 경로에는 아무 검사도 없었다 — 형식만 맞으면 무엇이든 발행되었다. 발행은 소비처에게
- * 하는 약속이므로, 그 약속을 지킬 수 있는지는 약속하는 자리가 재야 한다.
- *
- * ## 무엇을 막고 무엇을 알리나
- *
- * 판정은 `figure-model` 의 `gate.ts` 가 이미 문서로 정해 두었다. 여기서 새로 정하지 않는다.
- *
- *   sizing-splits              크기를 바꾸면 조각이 갈라진다      **막는다**
- *   part-outside-base          부품이 기준 상자를 넘는다          **막는다**
- *   parts-off-placement-face   기준면에 안 닿는다                 **막는다**
- *   sizing-loose               1배에서 이미 여러 조각이다         알린다
- *   그 밖의 violations          형식이 권하지 않는 것              알린다 (저장 때 이미 보여 준 것들)
- *
- * 갈라짐을 막는 이유는 사람 눈에 「부서졌다」로 보이기 때문이다 — 시그널타워를 3배로 세우니 램프가
- * 기둥 위 공중에 떴던 그것이고, 앵커 규칙이 생긴 이유다. 소비처가 형상을 늘려 쓰는 것은 막을 수
- * 없으니(그것이 이 형식의 값이다), 늘려도 견디는지를 발행 전에 본다.
- *
- * ## 몇 개가 걸리나는 여기 안 적는다
- *
- * 한동안 「표본 15개 중 갈라짐 1 · 조용함 14」를 적어 두고 **게이트가 벽이 아니라는 근거**로
- * 삼았다. 수는 굳고 카탈로그는 움직인다 — 기준 상자 판정이 붙자 그 비율이 하루 만에 뒤집혔다.
- * 굳은 수를 근거로 든 문장은 그때부터 사실이 아닌 채로 사람을 안심시킨다.
- *
- * 무엇이 걸리고 얼마나 넘쳤나는 **저작 도구가 재서 보여 준다.** 그것을 볼 사람은 고치는
- * 사람이고, 그 사람이 보는 자리는 여기가 아니다.
- */
-/** 게이트가 낸 한 가지. `blocking` 이 참이면 발행이 안 된다. */
-export interface GateFinding {
-    code: string;
-    message: string;
-    /**
-     * **왜 그것이 문제인가.** 잰 것만 보여 주면 읽는 사람이 「그래서?」에서 멈춘다 — 화면에
-     * 「1 조각이 2 조각으로 갈라진다」만 떴을 때 실제로 그랬다.
-     */
-    why?: string;
-    /** **무엇을 바꾸면 되나.** 부품 이름과 값으로. 형식이 만든 문장을 그대로 옮긴다. */
-    how?: string;
-    /** 어디를 가리키나 — 갈라짐은 갈라진 부품 이름들, 형식 위반은 정본 안의 경로. */
-    at?: string;
-    /**
-     * 실제로 재 본, 되돌릴 수 있는 한 앵커 수정안들. 문장을 파싱해서 고치는 것이 아니라
-     * FigureSource 에 적용할 정확한 값만 내보낸다. 화면은 이것을 후보로만 보여 주고 저작자가
-     * 수락하기 전에는 정본을 바꾸지 않는다.
-     */
-    fixes?: GateFix[];
-    /** The one-click, fully remeasured repair when individual candidates are insufficient. */
-    fixPlan?: GateFixPlan;
-    blocking: boolean;
-}
-export interface Inspection {
-    findings: GateFinding[];
-    /** 막는 것이 하나라도 있나. 화면이 이것으로 단추를 잠근다. */
-    blocked: boolean;
-}
-/**
- * 정본 하나를 판정한다.
- *
- * 정본이 없거나(아직 저장 전) JSON 이 아니면 **막는다** — 발행할 대상이 없는 것이다. 그 경우를
- * 조용히 통과시키면 빈 것이 발행된다.
- *
- * `releasedJson` 은 **직전 발행판의 정본**이다. 주면 그것과 견주어 「이미 놓인 인스턴스를 깨는
- * 발행인가」를 함께 낸다(ADR-0063 결정 3). 한 번도 발행된 적 없으면 견줄 것이 없으므로 안 준다.
- */
-export declare function inspectSource(sourceJson?: string | null, releasedJson?: string | null): Inspection;