@things-factory/figure-service 10.1.47 → 10.1.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.47",
+  "version": "10.1.49",
   "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.53",
+    "@hatiolab/figure-model": "^0.1.55",
     "@operato/typeorm-history": "^10.0.0",
     "@things-factory/ai-client-base": "^10.1.39",
     "@things-factory/auth-base": "^10.1.47",
@@ -33,5 +33,5 @@
     "graphql-upload": "^15.0.2",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "185f20d7d9a15715a0ee2757a6a8189ec36cfb9d"
+  "gitHead": "f9b29dcbdfecbfdd72e33bbcf74aea05331da75f"
 }

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

@@ -276,6 +276,22 @@ describe('figure-format — 판을 알아보는 문', () => {
       expect(`${finding!.message}${finding!.why}${finding!.how}`).not.toMatch(/come away|piece/)
     })
 
+    /* 한 비율로 커진다고 선언한 도형에서 제 숫자를 가진 부품(수석 아키텍트 판정 2026-09-24 조건 ②). */
+    it('한 비율로 커진다고 선언한 도형에서 따라 커지지 않는 부품을 막고 이름을 댄다', () => {
+      let asset = createV3Asset('Uniform')
+      asset = addV3Box(asset, { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+      for (const axis of ['x', 'y', 'z']) {
+        asset.document.model.inputs.push({ id: `size.${axis}`, unit: 'mm', min: 1, max: 20000, role: 'design' } as never)
+        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')
+
+      expect(finding?.blocking).toBe(true)
+      expect(finding!.message).toBe("이 도형은 한 비율로 커지는데, 크기를 X 로 2배로 하면 'body' 부품은 같이 커지지 않습니다.")
+      expect(finding!.how).toContain('크기에 비례')
+    })
+
     /* The server's translator is i18next with its defaults, which escape values for HTML. The panel draws text. */
     it('부품 이름의 따옴표가 HTML 로 바뀌지 않는다 — 서버와 같은 i18next 로', async () => {
       const i18next = require('i18next').createInstance()

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

@@ -177,6 +177,18 @@ function v3Wording(violation: V3Violation, say: Say, hasParts: boolean): Pick<Ga
         how: say(key('how'), { parts }, `Fasten ${parts} to a face of the part they rest on, or press "fix here" under placement, so they stay put when the figure is resized.`)
       }
     }
+    case 'SIZING_NOT_UNIFORM': {
+      /* The figure declares it grows by one ratio; these parts keep a size or place of their own (ruling 2026-09-24). */
+      const resize = violation.resize!
+      const parts = (violation.parts ?? []).map(one => `'${one}'`).join(', ')
+      const axes = resize.axes.map(one => one.toUpperCase()).join('·')
+      const factor = resize.factor
+      return {
+        message: say(key('message'), { parts, axes, factor }, `The figure grows by one ratio, but at ${factor}x on ${axes} ${parts} do not grow with it.`),
+        why: say(key('why'), {}, 'A figure that grows by one ratio keeps its proportions at any size. A part with a size or place of its own comes apart from the rest.'),
+        how: say(key('how'), { parts }, `Let ${parts} follow the figure's size ("in proportion to size" under size and placement), or remove their own fixed numbers.`)
+      }
+    }
   }
 }
 

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

@@ -79,7 +79,10 @@ function install() {
     costOf: model.costOf,
     scoreOf: model.scoreOf,
     validate: model.validate,
-    isPlaceholderType: model.isPlaceholderType
+    isPlaceholderType: model.isPlaceholderType,
+    parseAnySource: require('./figure-format').parseAnySource,
+    v3CostOf: model.v3CostOf,
+    v3ScoreOf: model.v3ScoreOf
   })
 }
 
@@ -505,3 +508,38 @@ describe('후보가 카드가 된다', () => {
     expect(proposed[0].refine).toBe(false)
   })
 })
+
+/*
+  V3 도형이 열려 있을 때(사용자 2026-09-24: 도크가 V3 초안에 「type 이 없다 · base 가 없다」 로 답했다). 읽기는 V3 로 읽고
+  잰다. 후보 제안은 아직 V2 만 쓰므로 지어내지 않고 그렇다고 말한다.
+*/
+describe('V3 도형이 열려 있을 때', () => {
+  const v3Draft = () => {
+    const model = require('@hatiolab/figure-model')
+    let asset = model.createV3Asset('Probe')
+    asset = model.addV3Box(asset, { id: 'body', size: { x: 100, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })
+    return asset
+  }
+
+  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 () => {
+    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 가 없다/)
+  })
+
+  it('후보 제안은 V3 도형에 V2 후보를 지어내지 않고, 아직 못 한다고 말한다', async () => {
+    const got = await toolNamed('proposeFigureCandidate').builder({ prompt: '다리를 길게' }, ctx({ figureId: 'fig-1', draftSource: v3Draft(), palette: ['palette.primary'] }))
+    expect(got.error).toBe('V3_PROPOSAL_UNAVAILABLE')
+    expect(proposed).toHaveLength(0)
+  })
+})
+

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

@@ -62,6 +62,9 @@ function getDeps(): any {
         complaint. The tool's own contract is unchanged: it reads, it never saves (ADR-0087).
       */
       inspectSource: format.inspectAnySource,
+      parseAnySource: format.parseAnySource,
+      v3CostOf: model.v3CostOf,
+      v3ScoreOf: model.v3ScoreOf,
       proposeFigure: propose.proposeFigure,
       compile: model.compile,
       costOf: model.costOf,
@@ -153,6 +156,23 @@ async function resolveFigureTarget(figureId: string | undefined, domainId: strin
  * 찾은 뒤에만 보며, Figure의 불변 type과 형식 검증을 다시 확인한다. 검증되지 않은 큰 객체를 LLM
  * 프롬프트로 옮기면 비용만 태우고, DB에 있던 Figure와 다른 것을 고친다고 잘못 말할 수 있다.
  */
+/** 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'
+
+/**
+ * The V2 proposer writes V2 figures; a V3 figure open in the modeller is not something it can revise or add to. Said as
+ * what is true, with what the assistant can do instead -- not a V2 parser's complaint about a V3 asset (user,
+ * 2026-09-24: the dock answered 「type 이 없다 · base 가 없다」 for a V3 draft).
+ */
+function v3ProposalUnavailable() {
+  return {
+    error: 'V3_PROPOSAL_UNAVAILABLE',
+    message: '이 도형은 V3 형식입니다. AI 후보 제안은 아직 V2 도형만 만들 수 있어 이 도형을 고치는 후보를 낼 수 없습니다.',
+    nextStep:
+      'Tell the person plainly that candidate proposals do not support V3 figures yet. You can still read the figure (getFigureSource) and explain whether it may be released and why (inspectFigure). Do not produce a V2 candidate for a V3 figure.'
+  }
+}
+
 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
@@ -169,6 +189,17 @@ function sourceForTool(row: any, host: any): { source: any; draft: boolean } {
     throw new Error('the unsaved draft is too large to safely review')
   }
 
+  /* 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) {
@@ -306,6 +337,22 @@ 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)
 
@@ -339,7 +386,7 @@ function figureToolSpecs(): ToolSpec[] {
 
         const current = sourceForTool(row, ctx?.host)
         const { inspectSource } = getDeps()
-        return { ...inspectSource(current.source ? JSON.stringify(current.source) : null), draft: current.draft }
+        return { ...inspectSource(current.source ? JSON.stringify(current.source) : null, null, undefined, row.type), draft: current.draft }
       }
     },
     {
@@ -391,6 +438,7 @@ function figureToolSpecs(): ToolSpec[] {
             base = sourceForTool(row, ctx?.host).source ?? undefined
           }
         }
+        if (isV3(base) || (args?.create !== true && isV3(ctx?.host?.draftSource))) return v3ProposalUnavailable()
 
         const palette = Array.isArray(ctx?.host?.palette) ? ctx.host.palette : []
         if (palette.length === 0) {

package/translations/en.json

@@ -14,6 +14,9 @@
   "figure.gate.parts-split-on-resize.how": "Fasten {parts} to a face of the part they rest on, or press “fix here” under placement, so they stay put when the figure is resized.",
   "figure.gate.parts-split-on-resize.message": "At {factor}x on {axes}, {parts} come away from the rest of the figure.",
   "figure.gate.parts-split-on-resize.why": "A figure placed at another size shows those parts hanging in the air — to a person, it looks broken.",
+  "figure.gate.sizing-not-uniform.how": "Let {parts} follow the figure's size (“in proportion to size” under size and placement), or remove their own fixed numbers.",
+  "figure.gate.sizing-not-uniform.message": "The figure grows by one ratio, but at {factor}x on {axes} {parts} do not grow with it.",
+  "figure.gate.sizing-not-uniform.why": "A figure that grows by one ratio keeps its proportions at any size. A part with a size or place of its own comes apart from the rest.",
   "figure.gate.placement-face-tilted.how": "Choose a mounting face parallel to the plane, or turn '{part}' upright.",
   "figure.gate.placement-face-tilted.message": "The mounting face of '{part}' is tilted {degrees}° from the plane the figure stands on.",
   "figure.gate.placement-face-tilted.why": "A tilted face cannot lie on the plane, so how the figure stands is not settled.",

package/translations/ko.json

@@ -14,6 +14,9 @@
   "figure.gate.parts-split-on-resize.how": "{parts} 부품을 올려 둔 부품의 면에 붙이거나, 부품의 「위치와 크기」에서 「여기에 고정」을 누르면 크기를 바꿔도 제자리에 있습니다.",
   "figure.gate.parts-split-on-resize.message": "크기를 {axes} 로 {factor}배로 하면 {parts} 부품이 나머지에서 떨어집니다.",
   "figure.gate.parts-split-on-resize.why": "다른 크기로 놓으면 그 부품이 공중에 떠 보입니다. 보는 사람에게는 부서진 도형입니다.",
+  "figure.gate.sizing-not-uniform.how": "{parts} 부품이 도형 크기를 따르게 하세요(「위치와 크기」의 「크기에 비례」). 제 고정 숫자를 가진 부품은 한 비율로 커지지 않습니다.",
+  "figure.gate.sizing-not-uniform.message": "이 도형은 한 비율로 커지는데, 크기를 {axes} 로 {factor}배로 하면 {parts} 부품은 같이 커지지 않습니다.",
+  "figure.gate.sizing-not-uniform.why": "한 비율로 커지는 도형은 어떤 크기에서도 비례를 지킵니다. 제 크기나 자리를 따로 가진 부품은 나머지와 어긋납니다.",
   "figure.gate.placement-face-tilted.how": "평면과 나란한 면을 장착면으로 다시 정하거나, '{part}' 부품을 바로 세우세요.",
   "figure.gate.placement-face-tilted.message": "장착면으로 정한 '{part}' 부품의 면이 놓이는 평면에서 {degrees}° 기울어 있습니다.",
   "figure.gate.placement-face-tilted.why": "기운 면은 평면에 닿을 수 없어서, 도형이 어떤 자세로 놓이는지 정해지지 않습니다.",