@things-factory/figure-service 10.1.48 → 10.1.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.48",
+  "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.54",
+    "@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": "448b0d568a1816d25aa49f3b6233d8086d6011f9"
+  "gitHead": "f9b29dcbdfecbfdd72e33bbcf74aea05331da75f"
 }

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) {