@things-factory/figure-service 10.1.29 → 10.1.32

package/dist-server/service/figure/figure-gate.js

@@ -96,6 +96,16 @@ function inspectSource(sourceJson, releasedJson) {
         findings.push({
             code: violation.code,
             message: violation.message,
+            /*
+              왜·어떻게는 형식이 만든 것을 그대로 옮긴다. 여기서 서버가 다시 쓰면 두 벌이 되고 곧 어긋난다 —
+              크기 반응 판정이 이미 그 규율이다(아래 `report.findings`).
+      
+              이 두 줄이 없던 동안 발행 화면은 막는 위반에 문장 하나만 보여 줬다. 표본 47 개를 게이트에 넣어
+              보니 막는 판정 99 건 중 왜·어떻게를 가진 것이 2 건이었고, 나머지 97 건은 저작자가 상자를 키울지
+              부품을 옮길지 알 길이 없었다(2026-09-19, figure-model 0.1.29 가 그 값을 싣기 시작했다).
+            */
+            why: violation.why,
+            how: violation.how,
             /* 어느 위반이 막나는 형식이 안다 — 여기 목록을 또 들면 둘이 갈린다(ADR-0044 결정 ②). */
             blocking: (0, figure_model_1.blocksRelease)(violation.code)
         });

package/dist-server/service/figure/figure-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-gate.js","sourceRoot":"","sources":["../../../server/service/figure/figure-gate.ts"],"names":[],"mappings":"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","sourcesContent":["import { blocksRelease, compile, contractChanges, sizingReport, validate } from '@hatiolab/figure-model'\nimport type { Axis, FigureSource } from '@hatiolab/figure-model'\n\n/** Service transport shape. It deliberately contains only an explicit, reversible FigureSource edit. */\nexport interface GateFix {\n  findingWay: string\n  part: string\n  axis: Axis\n  from?: string\n  to: 'min' | 'center' | 'max' | 'span'\n  resolved: number\n  /** True only when rechecking every sizing case leaves no release-blocking split. */\n  safe: boolean\n}\n\n/**\n * 발행해도 되나 — **서버가 판정한다.**\n *\n * ## 왜 서버인가\n *\n * 이 검사는 브라우저 하네스에만 있었다(`test/browser/check-figure-scaling.mjs`). 사람이 돌릴 때만\n * 돌았고, 발행 경로에는 아무 검사도 없었다 — 형식만 맞으면 무엇이든 발행되었다. 발행은 소비처에게\n * 하는 약속이므로, 그 약속을 지킬 수 있는지는 약속하는 자리가 재야 한다.\n *\n * ## 무엇을 막고 무엇을 알리나\n *\n * 판정은 `figure-model` 의 `gate.ts` 가 이미 문서로 정해 두었다. 여기서 새로 정하지 않는다.\n *\n *   sizing-splits              크기를 바꾸면 조각이 갈라진다      **막는다**\n *   part-outside-base          부품이 기준 상자를 넘는다          **막는다**\n *   parts-off-placement-face   기준면에 안 닿는다                 **막는다**\n *   sizing-loose               1배에서 이미 여러 조각이다         알린다\n *   그 밖의 violations          형식이 권하지 않는 것              알린다 (저장 때 이미 보여 준 것들)\n *\n * 갈라짐을 막는 이유는 사람 눈에 「부서졌다」로 보이기 때문이다 — 시그널타워를 3배로 세우니 램프가\n * 기둥 위 공중에 떴던 그것이고, 앵커 규칙이 생긴 이유다. 소비처가 형상을 늘려 쓰는 것은 막을 수\n * 없으니(그것이 이 형식의 값이다), 늘려도 견디는지를 발행 전에 본다.\n *\n * ## 몇 개가 걸리나는 여기 안 적는다\n *\n * 한동안 「표본 15개 중 갈라짐 1 · 조용함 14」를 적어 두고 **게이트가 벽이 아니라는 근거**로\n * 삼았다. 수는 굳고 카탈로그는 움직인다 — 기준 상자 판정이 붙자 그 비율이 하루 만에 뒤집혔다.\n * 굳은 수를 근거로 든 문장은 그때부터 사실이 아닌 채로 사람을 안심시킨다.\n *\n * 무엇이 걸리고 얼마나 넘쳤나는 **저작 도구가 재서 보여 준다.** 그것을 볼 사람은 고치는\n * 사람이고, 그 사람이 보는 자리는 여기가 아니다.\n */\n\n/** 게이트가 낸 한 가지. `blocking` 이 참이면 발행이 안 된다. */\nexport interface GateFinding {\n  code: string\n  message: string\n  /**\n   * **왜 그것이 문제인가.** 잰 것만 보여 주면 읽는 사람이 「그래서?」에서 멈춘다 — 화면에\n   * 「1 조각이 2 조각으로 갈라진다」만 떴을 때 실제로 그랬다.\n   */\n  why?: string\n  /** **무엇을 바꾸면 되나.** 부품 이름과 값으로. 형식이 만든 문장을 그대로 옮긴다. */\n  how?: string\n  /** 어디를 가리키나 — 갈라짐은 갈라진 부품 이름들, 형식 위반은 정본 안의 경로. */\n  at?: string\n  /**\n   * 실제로 재 본, 되돌릴 수 있는 한 앵커 수정안들. 문장을 파싱해서 고치는 것이 아니라\n   * FigureSource 에 적용할 정확한 값만 내보낸다. 화면은 이것을 후보로만 보여 주고 저작자가\n   * 수락하기 전에는 정본을 바꾸지 않는다.\n   */\n  fixes?: GateFix[]\n  blocking: boolean\n}\n\nexport interface Inspection {\n  findings: GateFinding[]\n  /** 막는 것이 하나라도 있나. 화면이 이것으로 단추를 잠근다. */\n  blocked: boolean\n}\n\n/**\n * Figure model publishes the same capability for direct model consumers. Keep the service calculation\n * here as well because this package is deployed independently and receives a compiled local model package.\n * Each alternative is remeasured; prose from `how` is never parsed into an edit.\n */\nfunction measuredFixes(source: FigureSource, factor: number): GateFix[] {\n  const baseline = sizingReport(compile(source), factor)\n  const baselineCount = baseline.findings.filter(finding => finding.code === 'sizing-splits').length\n  const seen = new Set<string>()\n  const fixes: GateFix[] = []\n\n  for (const finding of baseline.findings) {\n    if (finding.code !== 'sizing-splits' || !finding.way) continue\n    const axes = finding.way.split('-').filter((axis): axis is Axis => ['x', 'y', 'z'].includes(axis))\n    const names = new Set(finding.clumps.flat())\n\n    for (const part of source.parts) {\n      if (!names.has(part.name)) continue\n      for (const axis of axes) {\n        for (const to of ['min', 'center', 'max', 'span'] as const) {\n          if (part.anchor?.[axis] === to) continue\n          const changed: FigureSource = {\n            ...source,\n            parts: source.parts.map(one => one.name === part.name ? { ...one, anchor: { ...(one.anchor ?? {}), [axis]: to } } : one)\n          }\n          const afterCount = sizingReport(compile(changed), factor).findings.filter(one => one.code === 'sizing-splits').length\n          const resolved = baselineCount - afterCount\n          const key = `${finding.way}:${part.name}:${axis}:${to}`\n          if (resolved <= 0 || seen.has(key)) continue\n          seen.add(key)\n          fixes.push({\n            findingWay: finding.way,\n            part: part.name,\n            axis,\n            from: part.anchor?.[axis],\n            to,\n            resolved,\n            /* 한 finding만 없앤 것이 아니라 전수 검사에서 막는 split이 0일 때만 원클릭 후보가 된다. */\n            safe: afterCount === 0\n          })\n        }\n      }\n    }\n  }\n\n  return fixes.sort((a, b) => b.resolved - a.resolved || a.part.localeCompare(b.part)).slice(0, 12)\n}\n\n/**\n * 정본 하나를 판정한다.\n *\n * 정본이 없거나(아직 저장 전) JSON 이 아니면 **막는다** — 발행할 대상이 없는 것이다. 그 경우를\n * 조용히 통과시키면 빈 것이 발행된다.\n *\n * `releasedJson` 은 **직전 발행판의 정본**이다. 주면 그것과 견주어 「이미 놓인 인스턴스를 깨는\n * 발행인가」를 함께 낸다(ADR-0063 결정 3). 한 번도 발행된 적 없으면 견줄 것이 없으므로 안 준다.\n */\nexport function inspectSource(sourceJson?: string | null, releasedJson?: string | null): Inspection {\n  if (!sourceJson) {\n    return {\n      blocked: true,\n      findings: [\n        {\n          code: 'no-source',\n          message: '저장된 정본이 없다. 저장하면 발행할 수 있다',\n          blocking: true\n        }\n      ]\n    }\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(sourceJson)\n  } catch (e) {\n    return {\n      blocked: true,\n      findings: [{ code: 'source-not-json', message: `정본이 JSON 이 아니다: ${(e as Error).message}`, blocking: true }]\n    }\n  }\n\n  const result = validate(parsed)\n  const findings: GateFinding[] = []\n\n  /*\n    형식 오류는 **저장을 통과할 수 없다**(`parseSource` 가 거절한다). 그래도 여기서 다시 보는 이유는,\n    이 판정이 저장 경로와 독립이어야 하기 때문이다 — 옛 정본이 남아 있거나 형식이 엄해진 뒤라면\n    저장 때는 맞았던 것이 지금은 틀릴 수 있다. 그때 발행이 통과하면 안 된다.\n  */\n  for (const error of result.errors) {\n    findings.push({ code: error.code, message: error.message, at: error.path, blocking: true })\n  }\n\n  for (const violation of result.violations) {\n    findings.push({\n      code: violation.code,\n      message: violation.message,\n      /* 어느 위반이 막나는 형식이 안다 — 여기 목록을 또 들면 둘이 갈린다(ADR-0044 결정 ②). */\n      blocking: blocksRelease(violation.code)\n    })\n  }\n\n  if (result.errors.length === 0) {\n    const source = parsed as FigureSource\n    const report = sizingReport(compile(source))\n    const fixes = measuredFixes(source, report.factor)\n\n    for (const finding of report.findings) {\n      findings.push({\n        code: finding.code,\n        message: finding.message,\n        /* 왜·어떻게는 형식이 소유한다. 서버가 다시 쓰면 두 벌이 되고 곧 어긋난다. */\n        why: finding.why,\n        how: finding.how,\n        /* 숫자가 아니라 자리를 말한다 — 어느 부품들이 갈라져 나왔나. */\n        at: finding.clumps.map(clump => [...clump].sort().join('+')).join(' | ') || undefined,\n          fixes: finding.code === 'sizing-splits' ? fixes.filter(fix => fix.findingWay === finding.way) : undefined,\n        blocking: finding.code === 'sizing-splits'\n      })\n    }\n\n    findings.push(...contractFindings(source, releasedJson))\n  }\n\n  return { findings, blocked: findings.some(finding => finding.blocking) }\n}\n\n/**\n * 직전 발행판과 견준 것 — **약속을 깨는 발행인가**(ADR-0063 결정 3).\n *\n * 무엇이 달라졌고 그것이 막는 것인지는 형식이 정한다(`contractChanges`). 여기서는 화면과 발행 문이\n * 읽는 모양으로 옮기기만 한다.\n *\n * **앞 판을 오늘 형식으로 못 읽으면 조용히 넘어가지 않는다.** 판 1 은 오늘 형식이 거절하는 판으로\n * 적혀 있을 수 있고, 그때 견주기를 건너뛰면 아무 말 없이 관문이 없는 것이 된다. 막지는 않는다 —\n * 그러면 그 도형은 영영 다시 발행할 수 없다.\n */\nfunction contractFindings(source: FigureSource, releasedJson?: string | null): GateFinding[] {\n  if (!releasedJson) return []\n\n  let released: FigureSource\n  try {\n    released = JSON.parse(releasedJson) as FigureSource\n    return contractChanges(released, source).map(change => ({\n      code: change.code,\n      message: change.message,\n      why: change.why,\n      at: change.subject,\n      blocking: change.blocking\n    }))\n  } catch (e) {\n    return [\n      {\n        code: 'released-unreadable',\n        message: `직전 발행판을 오늘 형식으로 읽을 수 없어 견주지 못했다: ${(e as Error).message}`,\n        why: '이 발행이 이미 놓인 인스턴스를 깨는지는 확인되지 않았다.',\n        blocking: false\n      }\n    ]\n  }\n}\n"]}
+{"version":3,"file":"figure-gate.js","sourceRoot":"","sources":["../../../server/service/figure/figure-gate.ts"],"names":[],"mappings":"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","sourcesContent":["import { blocksRelease, compile, contractChanges, sizingReport, validate } from '@hatiolab/figure-model'\nimport type { Axis, FigureSource } from '@hatiolab/figure-model'\n\n/** Service transport shape. It deliberately contains only an explicit, reversible FigureSource edit. */\nexport interface GateFix {\n  findingWay: string\n  part: string\n  axis: Axis\n  from?: string\n  to: 'min' | 'center' | 'max' | 'span'\n  resolved: number\n  /** True only when rechecking every sizing case leaves no release-blocking split. */\n  safe: boolean\n}\n\n/**\n * 발행해도 되나 — **서버가 판정한다.**\n *\n * ## 왜 서버인가\n *\n * 이 검사는 브라우저 하네스에만 있었다(`test/browser/check-figure-scaling.mjs`). 사람이 돌릴 때만\n * 돌았고, 발행 경로에는 아무 검사도 없었다 — 형식만 맞으면 무엇이든 발행되었다. 발행은 소비처에게\n * 하는 약속이므로, 그 약속을 지킬 수 있는지는 약속하는 자리가 재야 한다.\n *\n * ## 무엇을 막고 무엇을 알리나\n *\n * 판정은 `figure-model` 의 `gate.ts` 가 이미 문서로 정해 두었다. 여기서 새로 정하지 않는다.\n *\n *   sizing-splits              크기를 바꾸면 조각이 갈라진다      **막는다**\n *   part-outside-base          부품이 기준 상자를 넘는다          **막는다**\n *   parts-off-placement-face   기준면에 안 닿는다                 **막는다**\n *   sizing-loose               1배에서 이미 여러 조각이다         알린다\n *   그 밖의 violations          형식이 권하지 않는 것              알린다 (저장 때 이미 보여 준 것들)\n *\n * 갈라짐을 막는 이유는 사람 눈에 「부서졌다」로 보이기 때문이다 — 시그널타워를 3배로 세우니 램프가\n * 기둥 위 공중에 떴던 그것이고, 앵커 규칙이 생긴 이유다. 소비처가 형상을 늘려 쓰는 것은 막을 수\n * 없으니(그것이 이 형식의 값이다), 늘려도 견디는지를 발행 전에 본다.\n *\n * ## 몇 개가 걸리나는 여기 안 적는다\n *\n * 한동안 「표본 15개 중 갈라짐 1 · 조용함 14」를 적어 두고 **게이트가 벽이 아니라는 근거**로\n * 삼았다. 수는 굳고 카탈로그는 움직인다 — 기준 상자 판정이 붙자 그 비율이 하루 만에 뒤집혔다.\n * 굳은 수를 근거로 든 문장은 그때부터 사실이 아닌 채로 사람을 안심시킨다.\n *\n * 무엇이 걸리고 얼마나 넘쳤나는 **저작 도구가 재서 보여 준다.** 그것을 볼 사람은 고치는\n * 사람이고, 그 사람이 보는 자리는 여기가 아니다.\n */\n\n/** 게이트가 낸 한 가지. `blocking` 이 참이면 발행이 안 된다. */\nexport interface GateFinding {\n  code: string\n  message: string\n  /**\n   * **왜 그것이 문제인가.** 잰 것만 보여 주면 읽는 사람이 「그래서?」에서 멈춘다 — 화면에\n   * 「1 조각이 2 조각으로 갈라진다」만 떴을 때 실제로 그랬다.\n   */\n  why?: string\n  /** **무엇을 바꾸면 되나.** 부품 이름과 값으로. 형식이 만든 문장을 그대로 옮긴다. */\n  how?: string\n  /** 어디를 가리키나 — 갈라짐은 갈라진 부품 이름들, 형식 위반은 정본 안의 경로. */\n  at?: string\n  /**\n   * 실제로 재 본, 되돌릴 수 있는 한 앵커 수정안들. 문장을 파싱해서 고치는 것이 아니라\n   * FigureSource 에 적용할 정확한 값만 내보낸다. 화면은 이것을 후보로만 보여 주고 저작자가\n   * 수락하기 전에는 정본을 바꾸지 않는다.\n   */\n  fixes?: GateFix[]\n  blocking: boolean\n}\n\nexport interface Inspection {\n  findings: GateFinding[]\n  /** 막는 것이 하나라도 있나. 화면이 이것으로 단추를 잠근다. */\n  blocked: boolean\n}\n\n/**\n * Figure model publishes the same capability for direct model consumers. Keep the service calculation\n * here as well because this package is deployed independently and receives a compiled local model package.\n * Each alternative is remeasured; prose from `how` is never parsed into an edit.\n */\nfunction measuredFixes(source: FigureSource, factor: number): GateFix[] {\n  const baseline = sizingReport(compile(source), factor)\n  const baselineCount = baseline.findings.filter(finding => finding.code === 'sizing-splits').length\n  const seen = new Set<string>()\n  const fixes: GateFix[] = []\n\n  for (const finding of baseline.findings) {\n    if (finding.code !== 'sizing-splits' || !finding.way) continue\n    const axes = finding.way.split('-').filter((axis): axis is Axis => ['x', 'y', 'z'].includes(axis))\n    const names = new Set(finding.clumps.flat())\n\n    for (const part of source.parts) {\n      if (!names.has(part.name)) continue\n      for (const axis of axes) {\n        for (const to of ['min', 'center', 'max', 'span'] as const) {\n          if (part.anchor?.[axis] === to) continue\n          const changed: FigureSource = {\n            ...source,\n            parts: source.parts.map(one => one.name === part.name ? { ...one, anchor: { ...(one.anchor ?? {}), [axis]: to } } : one)\n          }\n          const afterCount = sizingReport(compile(changed), factor).findings.filter(one => one.code === 'sizing-splits').length\n          const resolved = baselineCount - afterCount\n          const key = `${finding.way}:${part.name}:${axis}:${to}`\n          if (resolved <= 0 || seen.has(key)) continue\n          seen.add(key)\n          fixes.push({\n            findingWay: finding.way,\n            part: part.name,\n            axis,\n            from: part.anchor?.[axis],\n            to,\n            resolved,\n            /* 한 finding만 없앤 것이 아니라 전수 검사에서 막는 split이 0일 때만 원클릭 후보가 된다. */\n            safe: afterCount === 0\n          })\n        }\n      }\n    }\n  }\n\n  return fixes.sort((a, b) => b.resolved - a.resolved || a.part.localeCompare(b.part)).slice(0, 12)\n}\n\n/**\n * 정본 하나를 판정한다.\n *\n * 정본이 없거나(아직 저장 전) JSON 이 아니면 **막는다** — 발행할 대상이 없는 것이다. 그 경우를\n * 조용히 통과시키면 빈 것이 발행된다.\n *\n * `releasedJson` 은 **직전 발행판의 정본**이다. 주면 그것과 견주어 「이미 놓인 인스턴스를 깨는\n * 발행인가」를 함께 낸다(ADR-0063 결정 3). 한 번도 발행된 적 없으면 견줄 것이 없으므로 안 준다.\n */\nexport function inspectSource(sourceJson?: string | null, releasedJson?: string | null): Inspection {\n  if (!sourceJson) {\n    return {\n      blocked: true,\n      findings: [\n        {\n          code: 'no-source',\n          message: '저장된 정본이 없다. 저장하면 발행할 수 있다',\n          blocking: true\n        }\n      ]\n    }\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(sourceJson)\n  } catch (e) {\n    return {\n      blocked: true,\n      findings: [{ code: 'source-not-json', message: `정본이 JSON 이 아니다: ${(e as Error).message}`, blocking: true }]\n    }\n  }\n\n  const result = validate(parsed)\n  const findings: GateFinding[] = []\n\n  /*\n    형식 오류는 **저장을 통과할 수 없다**(`parseSource` 가 거절한다). 그래도 여기서 다시 보는 이유는,\n    이 판정이 저장 경로와 독립이어야 하기 때문이다 — 옛 정본이 남아 있거나 형식이 엄해진 뒤라면\n    저장 때는 맞았던 것이 지금은 틀릴 수 있다. 그때 발행이 통과하면 안 된다.\n  */\n  for (const error of result.errors) {\n    findings.push({ code: error.code, message: error.message, at: error.path, blocking: true })\n  }\n\n  for (const violation of result.violations) {\n    findings.push({\n      code: violation.code,\n      message: violation.message,\n      /*\n        왜·어떻게는 형식이 만든 것을 그대로 옮긴다. 여기서 서버가 다시 쓰면 두 벌이 되고 곧 어긋난다 —\n        크기 반응 판정이 이미 그 규율이다(아래 `report.findings`).\n\n        이 두 줄이 없던 동안 발행 화면은 막는 위반에 문장 하나만 보여 줬다. 표본 47 개를 게이트에 넣어\n        보니 막는 판정 99 건 중 왜·어떻게를 가진 것이 2 건이었고, 나머지 97 건은 저작자가 상자를 키울지\n        부품을 옮길지 알 길이 없었다(2026-09-19, figure-model 0.1.29 가 그 값을 싣기 시작했다).\n      */\n      why: violation.why,\n      how: violation.how,\n      /* 어느 위반이 막나는 형식이 안다 — 여기 목록을 또 들면 둘이 갈린다(ADR-0044 결정 ②). */\n      blocking: blocksRelease(violation.code)\n    })\n  }\n\n  if (result.errors.length === 0) {\n    const source = parsed as FigureSource\n    const report = sizingReport(compile(source))\n    const fixes = measuredFixes(source, report.factor)\n\n    for (const finding of report.findings) {\n      findings.push({\n        code: finding.code,\n        message: finding.message,\n        /* 왜·어떻게는 형식이 소유한다. 서버가 다시 쓰면 두 벌이 되고 곧 어긋난다. */\n        why: finding.why,\n        how: finding.how,\n        /* 숫자가 아니라 자리를 말한다 — 어느 부품들이 갈라져 나왔나. */\n        at: finding.clumps.map(clump => [...clump].sort().join('+')).join(' | ') || undefined,\n          fixes: finding.code === 'sizing-splits' ? fixes.filter(fix => fix.findingWay === finding.way) : undefined,\n        blocking: finding.code === 'sizing-splits'\n      })\n    }\n\n    findings.push(...contractFindings(source, releasedJson))\n  }\n\n  return { findings, blocked: findings.some(finding => finding.blocking) }\n}\n\n/**\n * 직전 발행판과 견준 것 — **약속을 깨는 발행인가**(ADR-0063 결정 3).\n *\n * 무엇이 달라졌고 그것이 막는 것인지는 형식이 정한다(`contractChanges`). 여기서는 화면과 발행 문이\n * 읽는 모양으로 옮기기만 한다.\n *\n * **앞 판을 오늘 형식으로 못 읽으면 조용히 넘어가지 않는다.** 판 1 은 오늘 형식이 거절하는 판으로\n * 적혀 있을 수 있고, 그때 견주기를 건너뛰면 아무 말 없이 관문이 없는 것이 된다. 막지는 않는다 —\n * 그러면 그 도형은 영영 다시 발행할 수 없다.\n */\nfunction contractFindings(source: FigureSource, releasedJson?: string | null): GateFinding[] {\n  if (!releasedJson) return []\n\n  let released: FigureSource\n  try {\n    released = JSON.parse(releasedJson) as FigureSource\n    return contractChanges(released, source).map(change => ({\n      code: change.code,\n      message: change.message,\n      why: change.why,\n      at: change.subject,\n      blocking: change.blocking\n    }))\n  } catch (e) {\n    return [\n      {\n        code: 'released-unreadable',\n        message: `직전 발행판을 오늘 형식으로 읽을 수 없어 견주지 못했다: ${(e as Error).message}`,\n        why: '이 발행이 이미 놓인 인스턴스를 깨는지는 확인되지 않았다.',\n        blocking: false\n      }\n    ]\n  }\n}\n"]}

package/dist-server/service/figure/figure-query.js

@@ -152,14 +152,23 @@ let FigureQuery = class FigureQuery {
         if (!found) {
             return null;
         }
-        const { figure, source: sourceToCompile } = found;
+        const { figure, source: sourceToCompile, version } = found;
         try {
             const parsed = typeof sourceToCompile === 'string' ? JSON.parse(sourceToCompile) : sourceToCompile;
             return (0, figure_model_1.compile)(parsed);
         }
         catch (err) {
             console.error(`[figureBlueprint] 타입 '${type}' (figure id: ${figure.id}) 청사진 컴파일 실패:`, err);
-            return null;
+            /*
+              Null says one thing here: nobody published this type (ADR-0063 결정 2 보탬). A released figure
+              whose stored source no longer compiles is a different fact, and answering null for it makes the
+              board draw a stand-in with the reason nowhere on screen — the author published, the catalogue
+              says released, and the only trace is the line above. That is the silence ADR-0053 refuses.
+      
+              The board asks per type inside a Promise.all and collects a rejection into `failed`, so this
+              refusal costs that one figure its drawing and the scene still opens.
+            */
+            throw new shell_1.Refusal('figure-release-does-not-compile', { type, figureId: figure.id, version }, 'the released source of {type} does not compile. open it in the modeller and release it again.');
         }
     }
 };
@@ -230,7 +239,8 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:returntype", Promise)
 ], FigureQuery.prototype, "figureBlueprint", null);
 exports.FigureQuery = FigureQuery = tslib_1.__decorate([
-    (0, type_graphql_1.Resolver)(figure_js_1.Figure)
+    (0, type_graphql_1.Resolver)(figure_js_1.Figure),
+    (0, type_graphql_1.UseMiddleware)(shell_1.SpeakRefusals)
 ], FigureQuery);
 /**
  * Finds the released source of a type in one domain, or null.
@@ -243,12 +253,16 @@ async function releasedSourceOf(domainId, type) {
     if (!figure)
         return null;
     if (figure.state === 'released' && figure.source) {
-        return { figure, source: figure.source };
+        return { figure, source: figure.source, version: figure.version };
     }
     const latestReleased = await (0, shell_1.getRepository)(figure_history_js_1.FigureHistory).findOne({
         where: { domain: { id: domainId }, originalId: figure.id, state: 'released' },
         order: { version: 'DESC' }
     });
-    return latestReleased?.source ? { figure, source: latestReleased.source } : null;
+    /* The version travels with the source: a refusal names the edition that does not compile, and the
+       row's own version is the draft being edited, not the one the board was handed. */
+    return latestReleased?.source
+        ? { figure, source: latestReleased.source, version: latestReleased.version }
+        : null;
 }
 //# sourceMappingURL=figure-query.js.map

package/dist-server/service/figure/figure-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-query.js","sourceRoot":"","sources":["../../../server/service/figure/figure-query.ts"],"names":[],"mappings":";;;;AAAA,qCAA4B;AAC5B,+CAAyE;AACzE,qDAA6C;AAC7C,yDAAgD;AAEhD,iDAAuG;AAEvG,2CAAoC;AACpC,2DAAmD;AACnD,qDAAgD;AAChD,qDAA+D;AAGxD,IAAM,WAAW,GAAjB,MAAM,WAAW;IAGhB,AAAN,KAAK,CAAC,MAAM,CAAY,EAAU,EAAS,OAAwB;QACjE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,6CAA6C;QAC7C,OAAO,MAAM,IAAA,qBAAa,EAAC,kBAAM,CAAC,CAAC,OAAO,CAAC;YACzC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;SAChF,CAAC,CAAA;IACJ,CAAC;IAIK,AAAN,KAAK,CAAC,OAAO,CAAS,MAAiB,EAAS,OAAwB;QACtE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,YAAY,GAAG,IAAA,qCAA6B,EAAC;YACjD,UAAU,EAAE,IAAA,qBAAa,EAAC,kBAAM,CAAC;YACjC,MAAM;YACN,MAAM;YACN,KAAK,EAAE,QAAQ;YACf;;;;;;cAME;YACF,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC;SACjE,CAAC,CAAA;QAEF,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,YAAY,CAAC,eAAe,EAAE,CAAA;QAE3D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IACzB,CAAC;IAED;;;;;;;OAOG;IACH;;;;;OAKG;IAGG,AAAN,KAAK,CAAC,cAAc,CAAY,EAAU,EAAS,OAAwB;QACzE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,OAAO,MAAM,IAAA,qBAAa,EAAC,iCAAa,CAAC,CAAC,IAAI,CAAC;YAC7C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;YAC3F,SAAS,EAAE,CAAC,SAAS,CAAC;YACtB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;YAC1B,IAAI,EAAE,EAAE;SACT,CAAC,CAAA;IACJ,CAAC;IAED;;;;;OAKG;IAGG,AAAN,KAAK,CAAC,cAAc,CAAY,EAAU,EAAS,OAAwB;QACzE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,OAAO,MAAM,IAAA,qBAAa,EAAC,iCAAa,CAAC,CAAC,OAAO,CAAC;YAChD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;YAC3F,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;SAC3B,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;OAMG;IAGG,AAAN,KAAK,CAAC,aAAa,CAAY,EAAU,EAAS,OAAwB;QACxE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAa,EAAC,kBAAM,CAAC,CAAC,OAAO,CAAC;YACjD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YAC/E,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;SACnC,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAC3C,CAAC;QAED;;;UAGE;QACF,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAa,EAAC,iCAAa,CAAC;aAChD,kBAAkB,CAAC,SAAS,CAAC;aAC7B,KAAK,CAAC,0BAA0B,EAAE,EAAE,EAAE,EAAE,CAAC;aACzC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC;aAClC,KAAK,CAAC,CAAC,CAAC;aACR,MAAM,EAAE,CAAA;QAEX,OAAO,IAAA,8BAAa,EAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IACvD,CAAC;IAIK,AAAN,KAAK,CAAC,eAAe,CAAQ,OAAwB;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAa,EAAC,kBAAM,CAAC,CAAC,IAAI,CAAC;YAC5C,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAA,YAAE,EAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE;YAC3E,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;SACvB,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH;;;;MAIE;IAMI,AAAN,KAAK,CAAC,eAAe,CACN,IAAY,EAClB,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEhC;;;;;;UAME;QACF,MAAM,KAAK,GACT,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAEvH,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,CAAA;QAEjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAA;YAClG,OAAO,IAAA,sBAAO,EAAC,MAAM,CAAC,CAAA;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,IAAI,iBAAiB,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,CAAA;YAC1F,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;CACF,CAAA;AAjMY,kCAAW;AAGhB;IAFL,IAAA,wBAAS,EAAC,8EAA8E,CAAC;IACzF,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,kBAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC;IAChF,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IAAc,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;yCAOzC;AAIK;IAFL,IAAA,wBAAS,EAAC,8EAA8E,CAAC;IACzF,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,2BAAU,EAAE,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC;IAChG,mBAAA,IAAA,mBAAI,GAAE,CAAA;IAAqB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CAAjB,iBAAS;;0CAqBtC;AAkBK;IAFL,IAAA,wBAAS,EAAC,8EAA8E,CAAC;IACzF,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,iCAAa,CAAC,EAAE,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;IAC7E,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IAAc,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;iDASjD;AAUK;IAFL,IAAA,wBAAS,EAAC,8EAA8E,CAAC;IACzF,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC;IAC9F,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IAAc,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;iDAOjD;AAWK;IAFL,IAAA,wBAAS,EAAC,8EAA8E,CAAC;IACzF,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAgB,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;IACtF,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IAAc,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;gDAwBhD;AAIK;IAFL,IAAA,wBAAS,EAAC,8EAA8E,CAAC;IACzF,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,+EAA+E,EAAE,CAAC;IACtG,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;kDAS3B;AAoCK;IALL,IAAA,wBAAS,EAAC,wFAAwF,CAAC;IACnG,IAAA,oBAAK,EAAC,OAAO,CAAC,EAAE,CAAC,6BAAW,EAAE;QAC7B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,6GAA6G;KAC3H,CAAC;IAEC,mBAAA,IAAA,kBAAG,EAAC,MAAM,CAAC,CAAA;IACX,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;kDA2BP;sBAhMU,WAAW;IADvB,IAAA,uBAAQ,EAAC,kBAAM,CAAC;GACJ,WAAW,CAiMvB;AAED;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAAY;IAC5D,MAAM,MAAM,GAAG,MAAM,IAAA,qBAAa,EAAC,kBAAM,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;IACjG,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,IAAA,qBAAa,EAAC,iCAAa,CAAC,CAAC,OAAO,CAAC;QAChE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;QAC7E,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;KAC3B,CAAC,CAAA;IAEF,OAAO,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAClF,CAAC","sourcesContent":["import { In } from 'typeorm'\nimport { Args, Arg, Ctx, Directive, Query, Resolver } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport { compile } from '@hatiolab/figure-model'\n\nimport { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { inspectSource } from './figure-gate.js'\nimport { FigureInspection, FigureList } from './figure-type.js'\n\n@Resolver(Figure)\nexport class FigureQuery {\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => Figure, { nullable: true, description: 'Finds a single figure by its ID.' })\n  async figure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Figure> {\n    const { domain } = context.state\n\n    // 부모 도메인의 Figure 도 보인다 — Board 와 같은 범위 규칙이다.\n    return await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureList, { description: 'Lists figures. Sortable by score, triangles, name, updatedAt.' })\n  async figures(@Args() params: ListParam, @Ctx() context: ResolverContext): Promise<FigureList> {\n    const { domain } = context.state\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(Figure),\n      params,\n      domain,\n      alias: 'figure',\n      /*\n        `tags` 도 찾을 수 있어야 한다 — 태그의 값은 붙이는 데 있지 않고 **찾는 데** 있다.\n\n        `simple-json` 이라 칸에는 `[\"반출\",\"자동\"]` 이 통째로 들어 있고, LIKE 는 그 글자를\n        본다. 「반출」로 찾으면 걸린다. 정확히 그 태그만 걸리는 것은 아니지만(이름에 「반출」이\n        든 도형도 걸린다) 찾기로는 그것이 오히려 낫다.\n      */\n      searchables: ['type', 'name', 'description', 'category', 'tags']\n    })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  /**\n   * 등록된 타입 이름 목록.\n   *\n   * 저작 화면이 **새 타입 이름이 이미 쓰이는지** 물어보는 데 쓴다. `type` 은 저장되는\n   * 식별자라 만든 뒤에 고칠 수 없으므로, 만들기 전에 알려 줘야 한다.\n   *\n   * `state` 로 걸러지지 않는다 — `draft` 인 Figure 의 이름도 이미 점유된 것이다.\n   */\n  /**\n   * 발행된 판들 — 최근 것부터.\n   *\n   * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧\n   * 「이 도형이 몇 번 약속되었나」다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureHistory], { description: 'Released versions of a figure, newest first.' })\n  async figureVersions(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory[]> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      relations: ['updater'],\n      order: { version: 'DESC' },\n      take: 10\n    })\n  }\n\n  /**\n   * 지금 소비처가 쓰는 판.\n   *\n   * 도형의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,\n   * 그것을 이 자리가 답한다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureHistory, { nullable: true, description: 'The most recently released version of a figure.' })\n  async figureReleased(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      order: { version: 'DESC' }\n    })\n  }\n\n  /**\n   * 발행해도 되나 — **누르기 전에** 묻는 자리.\n   *\n   * 판정은 `figure-gate.ts` 가 하고 이 자리는 정본을 꺼내 넘긴다. 같은 판정을 `releaseFigure` 도\n   * 부른다 — 화면이 물어 보고 통과했더라도 그 사이에 정본이 바뀌었을 수 있으므로, 막는 것은 언제나\n   * 뮤테이션이다. 이 질의는 **이유를 미리 보여 주기 위한 것**이고 허가증이 아니다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureInspection, { description: 'Whether a figure may be released, with the reasons.' })\n  async inspectFigure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureInspection> {\n    const { domain } = context.state\n\n    const figure = await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id },\n      select: { id: true, source: true }\n    })\n\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    /*\n      **화면이 발행 문과 같은 것을 본다.** 직전 발행판을 여기서도 함께 넘기지 않으면, 저작 화면은\n      조용한데 발행을 누른 순간 계약 위반으로 막힌다 — 그때는 이미 열 군데를 고친 뒤다.\n    */\n    const released = await getRepository(FigureHistory)\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    return inspectSource(figure.source, released?.source)\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [String], { description: 'All figure type names in scope — used to check name collisions before create.' })\n  async figureTypeNames(@Ctx() context: ResolverContext): Promise<string[]> {\n    const { domain } = context.state\n\n    const rows = await getRepository(Figure).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) } },\n      select: { type: true }\n    })\n\n    return rows.map(r => r.type).filter(Boolean)\n  }\n\n  /**\n   * 소비처(operato-board, operato-twin, things-scene)를 위한 컴파일된 청사진(FigureBlueprint) 질의.\n   *\n   * ## 규칙\n   * 1. 소비처는 초안(draft)을 볼 수 없다 — **반드시 발행된(released) 판만 전달**한다.\n   * 2. 현재 Figure가 released 상태이면 현재 source를 컴파일한다.\n   * 3. 현재 Figure가 저작 중(draft)이더라도 이전에 발행된 이력(FigureHistory)이 있으면\n   *    가장 최근의 released 판본을 컴파일하여 하위 호환성을 유지한다.\n   * 4. 한 번도 발행된 적 없는 초안 자산이거나 존재하지 않는 타입인 경우 null을 반환하여\n   *    미완성 자산이 씬 화면에 유출되는 것을 엄격히 차단한다.\n   * 5. 도메인 상속 시 자식 도메인의 타입이 부모 도메인의 동일 타입을 항상 오버라이드한다.\n   * 6. 권한은 저작(`figure`)과 **다른 category** 인 `figure-published` 다. 소비처 사용자에게\n   *    저작 권한을 요구하면 board·twin 의 팔레트가 안 뜨고, 그렇다고 선언을 비우면 이 집에서는\n   *    로그인조차 안 한 사람에게 열린다(`auth-rebuild.md` §1). `<module>-published` 는\n   *    「그 모듈이 발행한 것을 남이 읽는 문」이라는 규약이다 — 아키텍트 판정(2026-09-15).\n   *\n   * ## 열거는 막혀 있다 — 지금은 우연이다\n   *\n   * 이 문의 열쇠는 `type` 하나뿐이라 이름을 모르면 못 꺼낸다. 그런데 그것이 **설계가 아니다** —\n   * 목록을 내는 `figures`·`figureTypeNames` 가 `figure` category 로 잠겨 있어서 결과적으로\n   * 그런 것뿐이다. 나중에 누가 소비처용 목록 문을 하나 더 열고 `figure-published` 를 붙이면\n   * 열거가 함께 열리고, 「이름을 알아야 한다」에 기대고 있던 가정이 조용히 사라진다.\n   * 그 문을 낼 사람이 이 단락을 읽고 그때 정하면 된다.\n   */\n  /*\n    This directive is attached by schema assembly, so a test that calls the resolver method\n    directly never exercises it. `figure-blueprint-query.test.ts` reads this source for the\n    declaration instead — see the test named for it there.\n  */\n  @Directive('@privilege(category: \"figure-published\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    nullable: true,\n    description: 'Compiled FigureBlueprint for external consumers (board, twin, things-scene). Only returns released figures.'\n  })\n  async figureBlueprint(\n    @Arg('type') type: string,\n    @Ctx() context: ResolverContext\n  ): Promise<any> {\n    const { domain } = context.state\n\n    /*\n      A child domain shadows the same type in its parent, which is how a tenant replaces the standard\n      CONVEYOR with its own. Only a released version shadows. When the child has just a draft, the\n      parent's release is used, so starting a draft never makes placed figures disappear (chief\n      architect ruling, 2026-09-17). This used to skip the fallback as soon as a child row existed and\n      return null.\n    */\n    const found =\n      (await releasedSourceOf(domain.id, type)) ?? (domain.parentId ? await releasedSourceOf(domain.parentId, type) : null)\n\n    if (!found) {\n      return null\n    }\n\n    const { figure, source: sourceToCompile } = found\n\n    try {\n      const parsed = typeof sourceToCompile === 'string' ? JSON.parse(sourceToCompile) : sourceToCompile\n      return compile(parsed)\n    } catch (err) {\n      console.error(`[figureBlueprint] 타입 '${type}' (figure id: ${figure.id}) 청사진 컴파일 실패:`, err)\n      return null\n    }\n  }\n}\n\n/**\n * Finds the released source of a type in one domain, or null.\n *\n * A released row gives its own source; a draft row gives the source of its latest released history.\n * A figure that was never released gives null, because drafts never reach consumers.\n */\nasync function releasedSourceOf(domainId: string, type: string): Promise<{ figure: Figure; source: string } | null> {\n  const figure = await getRepository(Figure).findOne({ where: { domain: { id: domainId }, type } })\n  if (!figure) return null\n\n  if (figure.state === 'released' && figure.source) {\n    return { figure, source: figure.source }\n  }\n\n  const latestReleased = await getRepository(FigureHistory).findOne({\n    where: { domain: { id: domainId }, originalId: figure.id, state: 'released' },\n    order: { version: 'DESC' }\n  })\n\n  return latestReleased?.source ? { figure, source: latestReleased.source } : null\n}\n"]}
+{"version":3,"file":"figure-query.js","sourceRoot":"","sources":["../../../server/service/figure/figure-query.ts"],"names":[],"mappings":"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","sourcesContent":["import { In } from 'typeorm'\nimport { Args, Arg, Ctx, Directive, Query, Resolver, UseMiddleware } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport { compile } from '@hatiolab/figure-model'\n\nimport {\n  Domain,\n  getQueryBuilderFromListParams,\n  getRepository,\n  ListParam,\n  Refusal,\n  SpeakRefusals\n} from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { inspectSource } from './figure-gate.js'\nimport { FigureInspection, FigureList } from './figure-type.js'\n\n@Resolver(Figure)\n@UseMiddleware(SpeakRefusals)\nexport class FigureQuery {\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => Figure, { nullable: true, description: 'Finds a single figure by its ID.' })\n  async figure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<Figure> {\n    const { domain } = context.state\n\n    // 부모 도메인의 Figure 도 보인다 — Board 와 같은 범위 규칙이다.\n    return await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureList, { description: 'Lists figures. Sortable by score, triangles, name, updatedAt.' })\n  async figures(@Args() params: ListParam, @Ctx() context: ResolverContext): Promise<FigureList> {\n    const { domain } = context.state\n\n    const queryBuilder = getQueryBuilderFromListParams({\n      repository: getRepository(Figure),\n      params,\n      domain,\n      alias: 'figure',\n      /*\n        `tags` 도 찾을 수 있어야 한다 — 태그의 값은 붙이는 데 있지 않고 **찾는 데** 있다.\n\n        `simple-json` 이라 칸에는 `[\"반출\",\"자동\"]` 이 통째로 들어 있고, LIKE 는 그 글자를\n        본다. 「반출」로 찾으면 걸린다. 정확히 그 태그만 걸리는 것은 아니지만(이름에 「반출」이\n        든 도형도 걸린다) 찾기로는 그것이 오히려 낫다.\n      */\n      searchables: ['type', 'name', 'description', 'category', 'tags']\n    })\n\n    const [items, total] = await queryBuilder.getManyAndCount()\n\n    return { items, total }\n  }\n\n  /**\n   * 등록된 타입 이름 목록.\n   *\n   * 저작 화면이 **새 타입 이름이 이미 쓰이는지** 물어보는 데 쓴다. `type` 은 저장되는\n   * 식별자라 만든 뒤에 고칠 수 없으므로, 만들기 전에 알려 줘야 한다.\n   *\n   * `state` 로 걸러지지 않는다 — `draft` 인 Figure 의 이름도 이미 점유된 것이다.\n   */\n  /**\n   * 발행된 판들 — 최근 것부터.\n   *\n   * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧\n   * 「이 도형이 몇 번 약속되었나」다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [FigureHistory], { description: 'Released versions of a figure, newest first.' })\n  async figureVersions(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory[]> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      relations: ['updater'],\n      order: { version: 'DESC' },\n      take: 10\n    })\n  }\n\n  /**\n   * 지금 소비처가 쓰는 판.\n   *\n   * 도형의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,\n   * 그것을 이 자리가 답한다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureHistory, { nullable: true, description: 'The most recently released version of a figure.' })\n  async figureReleased(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureHistory> {\n    const { domain } = context.state\n\n    return await getRepository(FigureHistory).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },\n      order: { version: 'DESC' }\n    })\n  }\n\n  /**\n   * 발행해도 되나 — **누르기 전에** 묻는 자리.\n   *\n   * 판정은 `figure-gate.ts` 가 하고 이 자리는 정본을 꺼내 넘긴다. 같은 판정을 `releaseFigure` 도\n   * 부른다 — 화면이 물어 보고 통과했더라도 그 사이에 정본이 바뀌었을 수 있으므로, 막는 것은 언제나\n   * 뮤테이션이다. 이 질의는 **이유를 미리 보여 주기 위한 것**이고 허가증이 아니다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => FigureInspection, { description: 'Whether a figure may be released, with the reasons.' })\n  async inspectFigure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<FigureInspection> {\n    const { domain } = context.state\n\n    const figure = await getRepository(Figure).findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id },\n      select: { id: true, source: true }\n    })\n\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    /*\n      **화면이 발행 문과 같은 것을 본다.** 직전 발행판을 여기서도 함께 넘기지 않으면, 저작 화면은\n      조용한데 발행을 누른 순간 계약 위반으로 막힌다 — 그때는 이미 열 군데를 고친 뒤다.\n    */\n    const released = await getRepository(FigureHistory)\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    return inspectSource(figure.source, released?.source)\n  }\n\n  @Directive('@privilege(category: \"figure\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => [String], { description: 'All figure type names in scope — used to check name collisions before create.' })\n  async figureTypeNames(@Ctx() context: ResolverContext): Promise<string[]> {\n    const { domain } = context.state\n\n    const rows = await getRepository(Figure).find({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) } },\n      select: { type: true }\n    })\n\n    return rows.map(r => r.type).filter(Boolean)\n  }\n\n  /**\n   * 소비처(operato-board, operato-twin, things-scene)를 위한 컴파일된 청사진(FigureBlueprint) 질의.\n   *\n   * ## 규칙\n   * 1. 소비처는 초안(draft)을 볼 수 없다 — **반드시 발행된(released) 판만 전달**한다.\n   * 2. 현재 Figure가 released 상태이면 현재 source를 컴파일한다.\n   * 3. 현재 Figure가 저작 중(draft)이더라도 이전에 발행된 이력(FigureHistory)이 있으면\n   *    가장 최근의 released 판본을 컴파일하여 하위 호환성을 유지한다.\n   * 4. 한 번도 발행된 적 없는 초안 자산이거나 존재하지 않는 타입인 경우 null을 반환하여\n   *    미완성 자산이 씬 화면에 유출되는 것을 엄격히 차단한다.\n   * 5. 도메인 상속 시 자식 도메인의 타입이 부모 도메인의 동일 타입을 항상 오버라이드한다.\n   * 6. 권한은 저작(`figure`)과 **다른 category** 인 `figure-published` 다. 소비처 사용자에게\n   *    저작 권한을 요구하면 board·twin 의 팔레트가 안 뜨고, 그렇다고 선언을 비우면 이 집에서는\n   *    로그인조차 안 한 사람에게 열린다(`auth-rebuild.md` §1). `<module>-published` 는\n   *    「그 모듈이 발행한 것을 남이 읽는 문」이라는 규약이다 — 아키텍트 판정(2026-09-15).\n   *\n   * ## 열거는 막혀 있다 — 지금은 우연이다\n   *\n   * 이 문의 열쇠는 `type` 하나뿐이라 이름을 모르면 못 꺼낸다. 그런데 그것이 **설계가 아니다** —\n   * 목록을 내는 `figures`·`figureTypeNames` 가 `figure` category 로 잠겨 있어서 결과적으로\n   * 그런 것뿐이다. 나중에 누가 소비처용 목록 문을 하나 더 열고 `figure-published` 를 붙이면\n   * 열거가 함께 열리고, 「이름을 알아야 한다」에 기대고 있던 가정이 조용히 사라진다.\n   * 그 문을 낼 사람이 이 단락을 읽고 그때 정하면 된다.\n   */\n  /*\n    This directive is attached by schema assembly, so a test that calls the resolver method\n    directly never exercises it. `figure-blueprint-query.test.ts` reads this source for the\n    declaration instead — see the test named for it there.\n  */\n  @Directive('@privilege(category: \"figure-published\", privilege: \"query\", domainOwnerGranted: true)')\n  @Query(returns => GraphQLJSON, {\n    nullable: true,\n    description: 'Compiled FigureBlueprint for external consumers (board, twin, things-scene). Only returns released figures.'\n  })\n  async figureBlueprint(\n    @Arg('type') type: string,\n    @Ctx() context: ResolverContext\n  ): Promise<any> {\n    const { domain } = context.state\n\n    /*\n      A child domain shadows the same type in its parent, which is how a tenant replaces the standard\n      CONVEYOR with its own. Only a released version shadows. When the child has just a draft, the\n      parent's release is used, so starting a draft never makes placed figures disappear (chief\n      architect ruling, 2026-09-17). This used to skip the fallback as soon as a child row existed and\n      return null.\n    */\n    const found =\n      (await releasedSourceOf(domain.id, type)) ?? (domain.parentId ? await releasedSourceOf(domain.parentId, type) : null)\n\n    if (!found) {\n      return null\n    }\n\n    const { figure, source: sourceToCompile, version } = found\n\n    try {\n      const parsed = typeof sourceToCompile === 'string' ? JSON.parse(sourceToCompile) : sourceToCompile\n      return compile(parsed)\n    } catch (err) {\n      console.error(`[figureBlueprint] 타입 '${type}' (figure id: ${figure.id}) 청사진 컴파일 실패:`, err)\n\n      /*\n        Null says one thing here: nobody published this type (ADR-0063 결정 2 보탬). A released figure\n        whose stored source no longer compiles is a different fact, and answering null for it makes the\n        board draw a stand-in with the reason nowhere on screen — the author published, the catalogue\n        says released, and the only trace is the line above. That is the silence ADR-0053 refuses.\n\n        The board asks per type inside a Promise.all and collects a rejection into `failed`, so this\n        refusal costs that one figure its drawing and the scene still opens.\n      */\n      throw new Refusal(\n        'figure-release-does-not-compile',\n        { type, figureId: figure.id, version },\n        'the released source of {type} does not compile. open it in the modeller and release it again.'\n      )\n    }\n  }\n}\n\n/**\n * Finds the released source of a type in one domain, or null.\n *\n * A released row gives its own source; a draft row gives the source of its latest released history.\n * A figure that was never released gives null, because drafts never reach consumers.\n */\nasync function releasedSourceOf(\n  domainId: string,\n  type: string\n): Promise<{ figure: Figure; source: string; version: number } | null> {\n  const figure = await getRepository(Figure).findOne({ where: { domain: { id: domainId }, type } })\n  if (!figure) return null\n\n  if (figure.state === 'released' && figure.source) {\n    return { figure, source: figure.source, version: figure.version }\n  }\n\n  const latestReleased = await getRepository(FigureHistory).findOne({\n    where: { domain: { id: domainId }, originalId: figure.id, state: 'released' },\n    order: { version: 'DESC' }\n  })\n\n  /* The version travels with the source: a refusal names the edition that does not compile, and the\n     row's own version is the draft being edited, not the one the board was handed. */\n  return latestReleased?.source\n    ? { figure, source: latestReleased.source, version: latestReleased.version }\n    : null\n}\n"]}

package/dist-server/service/figure/figure-tools.js

@@ -22,6 +22,12 @@ exports.registerFigureToolCategories = registerFigureToolCategories;
  * `ai-assistant:mutation` 이 지킨다 — 서로 다른 질문이라 서로 다른 권한이 지킨다. figure 가 board
  * 의 권한을 빌리지 않는다.
  *
+ * ── 권한은 적지 않는다. 문에 적힌 것을 관문이 읽는다 ────────────────────────
+ * 2026-09-18 까지 도구마다 `privilege: { category: 'figure', ... }` 를 적어 두었다. 문의 지시자와
+ * 같은 값이라 그때는 맞았고, 문이 선언을 바꾸는 날 어긋난다 — 어긋나면 느슨한 쪽이 이긴다. 이제
+ * 관문이 `doors` 에 적힌 문의 선언을 AUTH 의 표에서 읽어 묻는다(ADR-0071 결정 2 보탬). 여기 남길
+ * 것은 **닿는 문**뿐이다.
+ *
  * ── 규율을 도구와 함께 보낸다 ───────────────────────────────────────────────
  * 도구 목록만으로는 「언제 반드시 불러야 하는지」를 모른다. twin 이 그 공백에서 사고를 냈다 —
  * 조치 요청에 도구를 부르지 않고 「제안해 두었습니다」라고만 답해, 사용자에게 **없는 버튼을 누르라고
@@ -233,7 +239,6 @@ function figureToolSpecs() {
             name: 'listFigures',
             /* 이 도메인의 도형 목록 — 저장소를 직접 읽지만 같은 일을 하는 문은 이것이다. */
             doors: ['Query.figures'],
-            privilege: { category: 'figure', privilege: 'query', owner: true },
             description: 'Lists the figures in this tenant with their type names, states and part counts. ' +
                 'Call it before naming a type — type names are stored identifiers and must not be invented.',
             schema: { type: 'object', properties: {} },
@@ -263,7 +268,6 @@ function figureToolSpecs() {
             /* 저장된 도형의 원본. **저장 전 초안**을 물으면 저장소에 갈 것이 없어 화면이 보낸 것을 그대로 돌려준다 —
              * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 도형을 읽는 권한 검사가 선언에서 사라진다. */
             doors: ['Query.figure'],
-            privilege: { category: 'figure', privilege: 'query', owner: true },
             description: 'Returns the canonical FigureSource 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.',
@@ -298,7 +302,6 @@ function figureToolSpecs() {
             name: 'inspectFigure',
             /* 검사 결과 — 같은 일을 하는 문. */
             doors: ['Query.inspectFigure'],
-            privilege: { category: 'figure', privilege: 'query', owner: true },
             description: 'Says whether a figure may be released and, when it may not, what is wrong — each finding ' +
                 'carries why it is a problem and what to change. Call it when asked about releasing, or ' +
                 'when asked to fix a figure that will not release.',
@@ -319,7 +322,6 @@ function figureToolSpecs() {
             name: 'proposeFigureCandidate',
             /* 후보 생성 — 저장은 하지 않지만 같은 문의 권한을 쓴다. */
             doors: ['Mutation.proposeFigure'],
-            privilege: { category: 'figure', privilege: 'mutation', owner: true },
             description: 'Asks for a figure candidate from a description, optionally revising an existing one. ' +
                 'Returns the candidate with its score and cost. NOTHING IS SAVED — the author accepts or ' +
                 'discards it on screen. This is the only way a candidate reaches the screen.',

package/dist-server/service/figure/figure-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-tools.js","sourceRoot":"","sources":["../../../server/service/figure/figure-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * figure 저작 도구를 어시스턴트 도구 레지스트리에 등록 — **대화면(도크)에서 저작을 돕기 위함.**\n *\n * 왜 필요한가: `proposeFigure` 는 한 번 시키고 한 번 받는다. 그것으로 되는 일이 있지만, 저작은\n * 대개 「이걸 이렇게 고쳐 봐 → 무게가 얼마나 되나 → 발행은 되나」처럼 여러 차례 오간다. 그 대화를\n * 하려면 어시스턴트가 **지금 무엇이 있는지 읽을 수 있어야** 한다. 읽지 못하면 매번 사람이 정본을\n * 붙여 넣어야 하고, 그러면 대화가 아니다.\n *\n * 능력을 복제하지 않는다. figure-service 가 이미 가진 진입점(`inspectSource` · `proposeFigure` ·\n * 조회)을 레지스트리에 투영한다.\n *\n * ── 전부 조회·제안 전용이다 ─────────────────────────────────────────────────\n * 정본을 고치는 도구를 넣지 않는다. 형식의 설계가 그렇게 정해져 있다 — 어시스턴트는 **후보**를\n * 내고, 받을지 버릴지는 저작자가 정한다(`figure-propose.ts`). 되돌릴 수 없는 조작이 대화면으로\n * 새지 않으므로 전부 `kind: 'read'` 다.\n *\n * 저장은 저작면이 `updateFigure` 로 한다. 그 mutation 은 `figure:mutation` 이 지키고, 대화는\n * `ai-assistant:mutation` 이 지킨다 — 서로 다른 질문이라 서로 다른 권한이 지킨다. figure 가 board\n * 의 권한을 빌리지 않는다.\n *\n * ── 규율을 도구와 함께 보낸다 ───────────────────────────────────────────────\n * 도구 목록만으로는 「언제 반드시 불러야 하는지」를 모른다. twin 이 그 공백에서 사고를 냈다 —\n * 조치 요청에 도구를 부르지 않고 「제안해 두었습니다」라고만 답해, 사용자에게 **없는 버튼을 누르라고\n * 안내했다.** figure 도 똑같은 자리가 있다: 후보 화면(「지금 / 후보」 두 칸)은 **도구 호출 결과에서만**\n * 만들어진다. 문장으로는 아무 일도 일어나지 않는다.\n *\n * ── LLM 이 넘긴 id 를 믿지 않는다 ───────────────────────────────────────────\n * 사람이 목록에서 고르는 길에서는 드러나지 않지만, 모델은 대화 내용에 이끌려 임의의 id 를 넘길 수\n * 있다. 그래서 호출자 도메인 소속을 먼저 확인한다.\n */\nimport { registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'\n\n/*\n  서버 의존성은 lazy require 다. 등록은 부팅 초반에 평가되고 그때 typeorm DataSource 가 준비되지\n  않았을 수 있다(board-import · twin-ai 와 같은 정책).\n*/\nlet _deps: any | undefined\n\nfunction getDeps(): any {\n  if (!_deps) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const shell = require('@things-factory/shell')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const model = require('@hatiolab/figure-model')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const entity = require('./figure.js')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const gate = require('./figure-gate.js')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const propose = require('./figure-propose.js')\n    _deps = {\n      getRepository: shell.getRepository,\n      Figure: entity.Figure,\n      inspectSource: gate.inspectSource,\n      proposeFigure: propose.proposeFigure,\n      compile: model.compile,\n      costOf: model.costOf,\n      scoreOf: model.scoreOf,\n      validate: model.validate,\n      isPlaceholderType: model.isPlaceholderType\n    }\n  }\n  return _deps\n}\n\n/** 시험·검증 하네스 전용 주입 시임. 운영 경로에서 호출 금지. */\nexport function __setFigureToolDepsForTest(deps: any): void {\n  _deps = deps\n}\n\nfunction requireDomainId(state: any): string {\n  const id = state?.domain?.id\n  if (!id) {\n    // 도메인을 모르면 무엇을 읽어도 남의 것일 수 있다. 조용히 넘기지 않는다.\n    throw new Error('domain context is missing — the figure tools cannot resolve tenant scope')\n  }\n  return id\n}\n\n/**\n * 이 도형이 호출자 도메인 것인가.\n *\n * 모델이 넘긴 id 를 그대로 쓰지 않는다. 없으면 못 찾았다고 말한다 — 「권한이 없다」와 구별해\n * 알려 줄 것이 없다(다른 테넌트에 그 id 가 있다는 사실 자체가 알려 줄 것이 아니다).\n */\nasync function figureInDomain(figureId: string, domainId: string): Promise<any> {\n  const { getRepository, Figure } = getDeps()\n  const found = await getRepository(Figure).findOne({\n    where: { id: figureId, domain: { id: domainId } }\n  })\n  if (!found) {\n    throw new Error(`figure not found in this tenant: ${figureId}`)\n  }\n  return found\n}\n\n/**\n * figureId 또는 hostContext로부터 대상 Figure row(또는 미저장 초안 가상 row)를 해소한다.\n */\nasync function resolveFigureTarget(figureId: string | undefined, domainId: string, host: any): Promise<any> {\n  if (\n    host?.editorMode === 'new' &&\n    host?.draftSource &&\n    (!figureId || figureId === host.draftSource.type || figureId.startsWith('FIGURE'))\n  ) {\n    return unsavedFigure(host)\n  }\n\n  if (figureId) {\n    const { getRepository, Figure } = getDeps()\n    let found = await getRepository(Figure).findOne({\n      where: { id: figureId, domain: { id: domainId } }\n    })\n    if (!found) {\n      found = await getRepository(Figure).findOne({\n        where: { type: figureId, domain: { id: domainId } }\n      })\n    }\n    if (!found) {\n      if (\n        host?.editorMode === 'new' ||\n        (host?.draftSource &&\n          (host.draftSource.type === figureId ||\n            figureId.startsWith('FIGURE') ||\n            !host.figureId ||\n            host.figureId === figureId))\n      ) {\n        const unsaved = unsavedFigure(host)\n        if (unsaved) return unsaved\n      }\n      throw new Error(`figure not found in this tenant: ${figureId}`)\n    }\n    return found\n  }\n\n  return unsavedFigure(host)\n}\n\n/**\n * 모델러가 아직 저장하지 않은 source를 도구가 읽는 유일한 길.\n *\n * host context는 브라우저가 보낸 값이므로 권한 근거가 될 수 없다. 먼저 `row`를 현재 도메인에서\n * 찾은 뒤에만 보며, Figure의 불변 type과 형식 검증을 다시 확인한다. 검증되지 않은 큰 객체를 LLM\n * 프롬프트로 옮기면 비용만 태우고, DB에 있던 Figure와 다른 것을 고친다고 잘못 말할 수 있다.\n */\nfunction sourceForTool(row: any, host: any): { source: any; draft: boolean } {\n  const isMatch = host?.figureId === row.id || (!row.id && host?.editorMode === 'new') || (!row.id && !host?.figureId)\n  const draft = isMatch ? host?.draftSource : undefined\n  if (!draft) {\n    return { source: row.source ? JSON.parse(row.source) : null, draft: false }\n  }\n\n  if (typeof draft !== 'object' || Array.isArray(draft)) {\n    throw new Error('the unsaved draft is not a FigureSource object')\n  }\n\n  const serialized = JSON.stringify(draft)\n  if (serialized.length > 100_000) {\n    throw new Error('the unsaved draft is too large to safely review')\n  }\n\n  const { validate, isPlaceholderType } = getDeps()\n  const checked = validate(draft)\n  if (checked.errors.length > 0) {\n    throw new Error(`the unsaved draft is invalid: ${checked.errors.map((one: any) => one.message).join(' · ')}`)\n  }\n\n  let normalizedDraft = draft\n  if (draft.type !== row.type) {\n    // 템플릿 기본값 'FIGURE', 임시 draftType('FIGURE_...'), 또는 빈 값인 경우\n    // 현재 열려 있는 Figure의 실제 type으로 보정/정규화한다.\n    const isGenericOrTempType = !draft.type || draft.type === 'FIGURE' || isPlaceholderType(draft.type)\n    if (isGenericOrTempType && row.type) {\n      normalizedDraft = { ...draft, type: row.type }\n    } else {\n      throw new Error(`the unsaved draft type '${draft.type}' does not match Figure '${row.type}'`)\n    }\n  }\n\n  return { source: normalizedDraft, draft: true }\n}\n\n/**\n * 후보를 냈던 바로 그 Figure의 세션 반응만 후보 생성기에 넘긴다.\n *\n * 도크의 host context는 브라우저 값이므로 이 함수는 접근 권한을 판단하지 않는다. 이미 현재\n * 도메인에서 Figure를 찾은 뒤, `proposeFigure`가 다시 길이·형식을 정리할 참고 데이터만 건넨다.\n */\nfunction feedbackForTool(host: any, figureId?: string): unknown[] | undefined {\n  if (!Array.isArray(host?.proposalFeedback)) return undefined\n  if (figureId && host?.figureId === figureId) {\n    return host.proposalFeedback.slice(-5)\n  }\n  if (host?.editorMode === 'new' || !host?.figureId) {\n    return host.proposalFeedback.slice(-5)\n  }\n  return undefined\n}\n\n/**\n * 무엇을 고치라는 것인지 대화면 문맥에서 해소한다.\n *\n * 모델이 대상을 안 줬으면 **저작면이 지금 열고 있는 도형**이다. 사용자에게 식별자를 되묻지\n * 않는다 — 화면에 그 도형이 떠 있는데 「어느 도형입니까」를 묻는 것은 문맥을 안 읽은 것이다.\n */\nfunction figureIdFrom(args: any, host: any): string | undefined {\n  const said = typeof args?.figureId === 'string' ? args.figureId.trim() : ''\n  if (said) return said\n\n  const open = typeof host?.figureId === 'string' ? host.figureId.trim() : ''\n  if (open) return open\n\n  return undefined\n}\n\nfunction missingFigureTarget() {\n  return {\n    error: 'FIGURE_TARGET_REQUIRED',\n    message: '현재 화면에는 선택된 도형이 없습니다.',\n    nextStep: 'For an existing figure, call listFigures and match the user’s requested name or type; ask which figure only if ambiguous. For a new figure, call proposeFigureCandidate with create: true and the user’s prompt. Do not invent an id or repeat this call without a target.'\n  }\n}\n\nfunction unsavedFigure(host: any): any | undefined {\n  if (host?.editorMode !== 'new' || !host?.draftSource) return undefined\n  const row = { id: host.figureId, type: host.draftSource.type || 'FIGURE', name: '', state: 'draft' }\n  // Reuse size, shape and vocabulary validation before trusting browser content.\n  const current = sourceForTool(row, host)\n  return { ...row, source: JSON.stringify(current.source) }\n}\n\nconst FIGURE_ID_ARG = {\n  figureId: {\n    type: 'string',\n    description: 'The figure to read. Omit to read the one the person has open, saved or not — the server fills it in, and you cannot see which it is. On the catalog nothing is open, so resolve the figure the person asked for with listFigures first.'\n  }\n} as const\n\n/**\n * 도구 넷.\n *\n * 목록 · 정본 · 발행 판정 · 후보. 저작 대화에서 실제로 묻는 것이 그 넷이다 — 「무엇이 있나」\n * 「지금 어떻게 생겼나」 「발행이 왜 안 되나」 「이렇게 고쳐 봐」.\n */\nfunction figureToolSpecs(): ToolSpec[] {\n  return [\n    {\n      kind: 'read',\n      name: 'listFigures',\n      /* 이 도메인의 도형 목록 — 저장소를 직접 읽지만 같은 일을 하는 문은 이것이다. */\n      doors: ['Query.figures'],\n      privilege: { category: 'figure', privilege: 'query', owner: true },\n      description:\n        'Lists the figures in this tenant with their type names, states and part counts. ' +\n        'Call it before naming a type — type names are stored identifiers and must not be invented.',\n      schema: { type: 'object', properties: {} },\n      builder: async (_args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const { getRepository, Figure } = getDeps()\n        const rows = await getRepository(Figure).find({\n          where: { domain: { id: domainId } },\n          order: { updatedAt: 'DESC' },\n          take: 200\n        })\n        return {\n          figures: rows.map((row: any) => ({\n            id: row.id,\n            type: row.type,\n            name: row.name,\n            state: row.state,\n            score: row.score,\n            triangles: row.triangles\n          }))\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'getFigureSource',\n      /* 저장된 도형의 원본. **저장 전 초안**을 물으면 저장소에 갈 것이 없어 화면이 보낸 것을 그대로 돌려준다 —\n       * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 도형을 읽는 권한 검사가 선언에서 사라진다. */\n      doors: ['Query.figure'],\n      privilege: { category: 'figure', privilege: 'query', owner: true },\n      description:\n        'Returns the canonical FigureSource of one figure, with its measured cost ' +\n        '(triangles, part groups, and how many of it hold 60fps on one screen). Call it before proposing a revision — ' +\n        'revising without reading it means proposing against a guess.',\n      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const figureId = figureIdFrom(args, ctx?.host)\n        const row = await resolveFigureTarget(figureId, domainId, ctx?.host)\n        if (!row) return missingFigureTarget()\n\n        const current = sourceForTool(row, ctx?.host)\n        if (!current.source) {\n          // 저장된 정본이 없는 상태가 실제로 있다(새로 만들고 저장 안 한 것). 지어내지 않는다.\n          return { id: row.id, type: row.type, name: row.name, source: null, cost: null }\n        }\n\n        const { compile, costOf, scoreOf } = getDeps()\n        const blueprint = compile(current.source)\n\n        return {\n          id: row.id,\n          type: row.type,\n          name: row.name,\n          state: row.state,\n          source: current.source,\n          draft: current.draft,\n          cost: costOf(blueprint, 100),\n          score: scoreOf(blueprint)\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'inspectFigure',\n      /* 검사 결과 — 같은 일을 하는 문. */\n      doors: ['Query.inspectFigure'],\n      privilege: { category: 'figure', privilege: 'query', owner: true },\n      description:\n        'Says whether a figure may be released and, when it may not, what is wrong — each finding ' +\n        'carries why it is a problem and what to change. Call it when asked about releasing, or ' +\n        'when asked to fix a figure that will not release.',\n      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const figureId = figureIdFrom(args, ctx?.host)\n        const row = await resolveFigureTarget(figureId, domainId, ctx?.host)\n        if (!row) return missingFigureTarget()\n\n        const current = sourceForTool(row, ctx?.host)\n        const { inspectSource } = getDeps()\n        return { ...inspectSource(current.source ? JSON.stringify(current.source) : null), draft: current.draft }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'proposeFigureCandidate',\n      /* 후보 생성 — 저장은 하지 않지만 같은 문의 권한을 쓴다. */\n      doors: ['Mutation.proposeFigure'],\n      privilege: { category: 'figure', privilege: 'mutation', owner: true },\n      description:\n        'Asks for a figure candidate from a description, optionally revising an existing one. ' +\n        'Returns the candidate with its score and cost. NOTHING IS SAVED — the author accepts or ' +\n        'discards it on screen. This is the only way a candidate reaches the screen.',\n      schema: {\n        type: 'object',\n        properties: {\n          prompt: {\n            type: 'string',\n            description: 'What to make or change, in the words the author used.'\n          },\n          figureId: {\n            type: 'string',\n            description: 'Revise this figure. Omit to revise the one open in the editor; pass null to create anew.'\n          },\n          type: {\n            type: 'string',\n            description: 'Type name for a new figure. Check listFigures first — it is a stored identifier.'\n          },\n          create: {\n            type: 'boolean',\n            description: 'True to create rather than revise, even with a figure open.'\n          }\n        },\n        required: ['prompt']\n      },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const prompt = typeof args?.prompt === 'string' ? args.prompt.trim() : ''\n        if (!prompt) throw new Error('prompt is required: there is nothing to ask for')\n\n        /*\n          고치는 것인지 만드는 것인지를 **문맥에서 정한다.** 열린 도형이 있으면 고치는 것이 기본이고,\n          모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 도형을 덮어쓰는\n          후보가 온다.\n        */\n        let base: unknown\n        if (!args?.create && args?.figureId !== null) {\n          const open = typeof args?.figureId === 'string' ? args.figureId : ctx?.host?.figureId\n          const row = await resolveFigureTarget(open ? open.trim() : undefined, domainId, ctx?.host)\n          if (row) {\n            base = sourceForTool(row, ctx?.host).source ?? undefined\n          }\n        }\n\n        const palette = Array.isArray(ctx?.host?.palette) ? ctx.host.palette : []\n        if (palette.length === 0) {\n          /*\n            팔레트를 모르면 모델이 색을 지어내고, 그 후보는 그리는 시점에 `resolveToken` 이 던진다 —\n            저장까지 되고 나서 화면에서 죽는다. 빈 목록으로 진행하지 않는다.\n          */\n          throw new Error('the palette is missing from the host context — the candidate would invent colours')\n        }\n\n        const { proposeFigure } = getDeps()\n        const feedback = feedbackForTool(ctx?.host, base ? figureIdFrom(args, ctx?.host) : undefined)\n\n        let hostImage: { data: Buffer; mediaType: any } | undefined\n        const rawImage = ctx?.host?.image || (Array.isArray(ctx?.host?.attachments) ? ctx.host.attachments.find((a: any) => a?.mediaType?.startsWith('image/')) : undefined)\n        if (rawImage?.data) {\n          const rawData = typeof rawImage.data === 'string' ? rawImage.data.replace(/^data:image\\/[a-zA-Z]+;base64,/, '') : rawImage.data\n          const buf = typeof rawData === 'string' ? Buffer.from(rawData, 'base64') : Buffer.from(rawData)\n          hostImage = { data: buf, mediaType: rawImage.mediaType || 'image/png' }\n        }\n\n        const result = await proposeFigure({\n          prompt,\n          palette,\n          base,\n          type: typeof args?.type === 'string' ? args.type : undefined,\n          feedback,\n          refine: !!feedback?.length,\n          image: hostImage\n        })\n\n        /*\n          **`proposed: true` 가 카드를 만든다.** 이 표시가 없으면 후보는 도구 추적 안에 묻히고,\n          화면에는 아무것도 생기지 않는다 — 그러면 모델이 「후보를 만들었습니다」라고 쓴 것이\n          거짓말이 된다(사용자가 없는 단추를 찾는다).\n\n          `label`·`reason` 이 카드에 그려지는 두 줄이고, `args` 는 같은 제안을 두 번 세지 않기\n          위한 열쇠의 일부다 — 같은 요청을 두 번 내면 카드가 하나로 접힌다.\n        */\n        return {\n          proposed: true,\n          label: base ? `${result.source.type} 고치기` : `${result.source.type} 만들기`,\n          reason:\n            `등급 ${result.score.grade} · 삼각형 ${result.cost.triangles} · ` +\n            `한 도면 ${result.cost.at.drawCalls}회 · ${result.attempts}번에 만들었다`,\n          choices: [\n            { id: 'save', action: 'save', label: '초안 저장', icon: 'save', primary: true },\n            { id: 'repropose', action: 'prompt', label: '다른 콘셉트 재제안', icon: 'refresh', prompt: '현재 제안과 완전히 다른 스타일과 콘셉트로 새로 제안해줘' },\n            { id: 'slim', action: 'prompt', label: '비율 슬림 조정', icon: 'aspect_ratio', prompt: '전체적인 가로세로 비율을 좀 더 슬림하고 날렵하게 조정해줘' },\n            { id: 'palette', action: 'prompt', label: '색상 테마 변경', icon: 'palette', prompt: '다른 팔레트 색상 테마로 부품 색상을 변경해줘' },\n            { id: 'detail', action: 'prompt', label: '디테일 보강', icon: 'extension', prompt: '주요 디테일과 센서 부품을 좀 더 풍부하게 보강해줘' }\n          ],\n          args: {\n            baseSource: base ? JSON.stringify(base) : undefined,\n            prompt, figureId: base ? figureIdFrom(args, ctx?.host) : undefined,\n            draftType: base && ctx?.host?.editorMode === 'new' && !figureIdFrom(args, ctx?.host)\n              ? (base as any).type : undefined\n          },\n          source: result.source,\n          score: result.score,\n          cost: result.cost,\n          quality: result.quality,\n          violations: result.violations,\n          attempts: result.attempts\n        }\n      }\n    }\n  ] as ToolSpec[]\n}\n\n/**\n * 등록 — 부팅 시 1회.\n *\n * 범주가 하나다. twin 은 관찰과 생성을 둘로 갈랐는데(운영 협의에 생성 도구가 들려 있으면 대화의\n * 성격이 흐려진다), figure 의 대화면은 저작면 하나뿐이고 그 자리에서 읽기와 후보 요청이 함께 필요하다.\n * 대화면이 늘면 그때 가른다.\n */\nexport function registerFigureToolCategories(): void {\n  const authoring: ToolCategory = {\n    name: 'figure-authoring',\n    description: '저작 중인 Figure 의 정본·비용·발행 판정 조회와 후보 제안(저장 아님).',\n    guidance: [\n      '- **도형을 만들거나 고쳐 달라는 요청에는 반드시 `proposeFigureCandidate` 를 호출한다.**',\n      '  후보는 도구 호출 결과에서만 생긴다.',\n      '  호출 없이 \"후보를 만들었습니다\" · \"적용 버튼을 누르세요\" 라고 쓰는 것은 **거짓이다** — 화면에 후보 칸이 생기지 않으므로 사용자는 존재하지 않는 버튼을 찾는다.',\n      '  도크에서는 후보 카드의 버튼을 눌러야 모델러 비교 화면이 열린다. 아직 열지 않은 비교 화면이 이미 보인다고 말하지 않는다.',\n      '  요청한 부품만 바뀌었다고 추측하지 않는다. 후보와 원본을 비교한 근거가 없으면 변경 범위는 비교 화면에서 확인하도록 안내한다.',\n      '- 정본을 직접 저장하지 않는다. 후보만 내고, 받을지 버릴지는 저작자가 화면에서 정한다.',\n      '- 좌표와 크기는 X/Y/Z 축 이름으로 정확하게 표시한다. 확인되지 않은 가로·세로·높이 의미를 임의로 붙이지 않는다.',\n      '- **고치라는 요청이면 먼저 `getFigureSource` 를 부른다.** 읽지 않고 고치면 짐작을 상대로 후보를 내게 되고, 부품 이름이 갈려 이미 배치된 보드의 바인딩이 끊긴다.',\n      '- 목록 화면에는 열린 도형이 없다. 기존 도형을 조회·수정할 때는 `listFigures`에서 사용자가 말한 이름·타입의 id를 찾는다. 대상이 모호할 때만 어느 도형인지 묻는다. 새 제작 요청에는 기존 정본을 조회하지 않고 `proposeFigureCandidate`를 create: true로 호출한다.',\n      '- 타입 이름을 지어내지 않는다 — `listFigures` 로 확인한다. **타입 이름은 저장되는 식별자**이고 보드가 그 이름으로 도형을 찾는다.',\n      '- 발행이 안 되는 이유를 물으면 `inspectFigure` 를 부른다. 판정 없이 \"발행할 수 있습니다\"라고 말하지 않는다.',\n      '  판정의 각 항목은 **왜 문제인지와 무엇을 바꾸면 되는지**를 함께 담고 있다. 그대로 전한다 — 요약하면 저작자가 어느 부품의 어느 축을 고칠지 다시 찾아야 한다.',\n      '- 무게·삼각형 수를 물으면 `getFigureSource` 의 `cost` 를 쓴다. 눈대중으로 세지 않는다.'\n    ].join('\\n'),\n    specs: figureToolSpecs()\n  }\n\n  registerToolCategory(authoring)\n}\n"]}
+{"version":3,"file":"figure-tools.js","sourceRoot":"","sources":["../../../server/service/figure/figure-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * figure 저작 도구를 어시스턴트 도구 레지스트리에 등록 — **대화면(도크)에서 저작을 돕기 위함.**\n *\n * 왜 필요한가: `proposeFigure` 는 한 번 시키고 한 번 받는다. 그것으로 되는 일이 있지만, 저작은\n * 대개 「이걸 이렇게 고쳐 봐 → 무게가 얼마나 되나 → 발행은 되나」처럼 여러 차례 오간다. 그 대화를\n * 하려면 어시스턴트가 **지금 무엇이 있는지 읽을 수 있어야** 한다. 읽지 못하면 매번 사람이 정본을\n * 붙여 넣어야 하고, 그러면 대화가 아니다.\n *\n * 능력을 복제하지 않는다. figure-service 가 이미 가진 진입점(`inspectSource` · `proposeFigure` ·\n * 조회)을 레지스트리에 투영한다.\n *\n * ── 전부 조회·제안 전용이다 ─────────────────────────────────────────────────\n * 정본을 고치는 도구를 넣지 않는다. 형식의 설계가 그렇게 정해져 있다 — 어시스턴트는 **후보**를\n * 내고, 받을지 버릴지는 저작자가 정한다(`figure-propose.ts`). 되돌릴 수 없는 조작이 대화면으로\n * 새지 않으므로 전부 `kind: 'read'` 다.\n *\n * 저장은 저작면이 `updateFigure` 로 한다. 그 mutation 은 `figure:mutation` 이 지키고, 대화는\n * `ai-assistant:mutation` 이 지킨다 — 서로 다른 질문이라 서로 다른 권한이 지킨다. figure 가 board\n * 의 권한을 빌리지 않는다.\n *\n * ── 권한은 적지 않는다. 문에 적힌 것을 관문이 읽는다 ────────────────────────\n * 2026-09-18 까지 도구마다 `privilege: { category: 'figure', ... }` 를 적어 두었다. 문의 지시자와\n * 같은 값이라 그때는 맞았고, 문이 선언을 바꾸는 날 어긋난다 — 어긋나면 느슨한 쪽이 이긴다. 이제\n * 관문이 `doors` 에 적힌 문의 선언을 AUTH 의 표에서 읽어 묻는다(ADR-0071 결정 2 보탬). 여기 남길\n * 것은 **닿는 문**뿐이다.\n *\n * ── 규율을 도구와 함께 보낸다 ───────────────────────────────────────────────\n * 도구 목록만으로는 「언제 반드시 불러야 하는지」를 모른다. twin 이 그 공백에서 사고를 냈다 —\n * 조치 요청에 도구를 부르지 않고 「제안해 두었습니다」라고만 답해, 사용자에게 **없는 버튼을 누르라고\n * 안내했다.** figure 도 똑같은 자리가 있다: 후보 화면(「지금 / 후보」 두 칸)은 **도구 호출 결과에서만**\n * 만들어진다. 문장으로는 아무 일도 일어나지 않는다.\n *\n * ── LLM 이 넘긴 id 를 믿지 않는다 ───────────────────────────────────────────\n * 사람이 목록에서 고르는 길에서는 드러나지 않지만, 모델은 대화 내용에 이끌려 임의의 id 를 넘길 수\n * 있다. 그래서 호출자 도메인 소속을 먼저 확인한다.\n */\nimport { registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'\n\n/*\n  서버 의존성은 lazy require 다. 등록은 부팅 초반에 평가되고 그때 typeorm DataSource 가 준비되지\n  않았을 수 있다(board-import · twin-ai 와 같은 정책).\n*/\nlet _deps: any | undefined\n\nfunction getDeps(): any {\n  if (!_deps) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const shell = require('@things-factory/shell')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const model = require('@hatiolab/figure-model')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const entity = require('./figure.js')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const gate = require('./figure-gate.js')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const propose = require('./figure-propose.js')\n    _deps = {\n      getRepository: shell.getRepository,\n      Figure: entity.Figure,\n      inspectSource: gate.inspectSource,\n      proposeFigure: propose.proposeFigure,\n      compile: model.compile,\n      costOf: model.costOf,\n      scoreOf: model.scoreOf,\n      validate: model.validate,\n      isPlaceholderType: model.isPlaceholderType\n    }\n  }\n  return _deps\n}\n\n/** 시험·검증 하네스 전용 주입 시임. 운영 경로에서 호출 금지. */\nexport function __setFigureToolDepsForTest(deps: any): void {\n  _deps = deps\n}\n\nfunction requireDomainId(state: any): string {\n  const id = state?.domain?.id\n  if (!id) {\n    // 도메인을 모르면 무엇을 읽어도 남의 것일 수 있다. 조용히 넘기지 않는다.\n    throw new Error('domain context is missing — the figure tools cannot resolve tenant scope')\n  }\n  return id\n}\n\n/**\n * 이 도형이 호출자 도메인 것인가.\n *\n * 모델이 넘긴 id 를 그대로 쓰지 않는다. 없으면 못 찾았다고 말한다 — 「권한이 없다」와 구별해\n * 알려 줄 것이 없다(다른 테넌트에 그 id 가 있다는 사실 자체가 알려 줄 것이 아니다).\n */\nasync function figureInDomain(figureId: string, domainId: string): Promise<any> {\n  const { getRepository, Figure } = getDeps()\n  const found = await getRepository(Figure).findOne({\n    where: { id: figureId, domain: { id: domainId } }\n  })\n  if (!found) {\n    throw new Error(`figure not found in this tenant: ${figureId}`)\n  }\n  return found\n}\n\n/**\n * figureId 또는 hostContext로부터 대상 Figure row(또는 미저장 초안 가상 row)를 해소한다.\n */\nasync function resolveFigureTarget(figureId: string | undefined, domainId: string, host: any): Promise<any> {\n  if (\n    host?.editorMode === 'new' &&\n    host?.draftSource &&\n    (!figureId || figureId === host.draftSource.type || figureId.startsWith('FIGURE'))\n  ) {\n    return unsavedFigure(host)\n  }\n\n  if (figureId) {\n    const { getRepository, Figure } = getDeps()\n    let found = await getRepository(Figure).findOne({\n      where: { id: figureId, domain: { id: domainId } }\n    })\n    if (!found) {\n      found = await getRepository(Figure).findOne({\n        where: { type: figureId, domain: { id: domainId } }\n      })\n    }\n    if (!found) {\n      if (\n        host?.editorMode === 'new' ||\n        (host?.draftSource &&\n          (host.draftSource.type === figureId ||\n            figureId.startsWith('FIGURE') ||\n            !host.figureId ||\n            host.figureId === figureId))\n      ) {\n        const unsaved = unsavedFigure(host)\n        if (unsaved) return unsaved\n      }\n      throw new Error(`figure not found in this tenant: ${figureId}`)\n    }\n    return found\n  }\n\n  return unsavedFigure(host)\n}\n\n/**\n * 모델러가 아직 저장하지 않은 source를 도구가 읽는 유일한 길.\n *\n * host context는 브라우저가 보낸 값이므로 권한 근거가 될 수 없다. 먼저 `row`를 현재 도메인에서\n * 찾은 뒤에만 보며, Figure의 불변 type과 형식 검증을 다시 확인한다. 검증되지 않은 큰 객체를 LLM\n * 프롬프트로 옮기면 비용만 태우고, DB에 있던 Figure와 다른 것을 고친다고 잘못 말할 수 있다.\n */\nfunction sourceForTool(row: any, host: any): { source: any; draft: boolean } {\n  const isMatch = host?.figureId === row.id || (!row.id && host?.editorMode === 'new') || (!row.id && !host?.figureId)\n  const draft = isMatch ? host?.draftSource : undefined\n  if (!draft) {\n    return { source: row.source ? JSON.parse(row.source) : null, draft: false }\n  }\n\n  if (typeof draft !== 'object' || Array.isArray(draft)) {\n    throw new Error('the unsaved draft is not a FigureSource object')\n  }\n\n  const serialized = JSON.stringify(draft)\n  if (serialized.length > 100_000) {\n    throw new Error('the unsaved draft is too large to safely review')\n  }\n\n  const { validate, isPlaceholderType } = getDeps()\n  const checked = validate(draft)\n  if (checked.errors.length > 0) {\n    throw new Error(`the unsaved draft is invalid: ${checked.errors.map((one: any) => one.message).join(' · ')}`)\n  }\n\n  let normalizedDraft = draft\n  if (draft.type !== row.type) {\n    // 템플릿 기본값 'FIGURE', 임시 draftType('FIGURE_...'), 또는 빈 값인 경우\n    // 현재 열려 있는 Figure의 실제 type으로 보정/정규화한다.\n    const isGenericOrTempType = !draft.type || draft.type === 'FIGURE' || isPlaceholderType(draft.type)\n    if (isGenericOrTempType && row.type) {\n      normalizedDraft = { ...draft, type: row.type }\n    } else {\n      throw new Error(`the unsaved draft type '${draft.type}' does not match Figure '${row.type}'`)\n    }\n  }\n\n  return { source: normalizedDraft, draft: true }\n}\n\n/**\n * 후보를 냈던 바로 그 Figure의 세션 반응만 후보 생성기에 넘긴다.\n *\n * 도크의 host context는 브라우저 값이므로 이 함수는 접근 권한을 판단하지 않는다. 이미 현재\n * 도메인에서 Figure를 찾은 뒤, `proposeFigure`가 다시 길이·형식을 정리할 참고 데이터만 건넨다.\n */\nfunction feedbackForTool(host: any, figureId?: string): unknown[] | undefined {\n  if (!Array.isArray(host?.proposalFeedback)) return undefined\n  if (figureId && host?.figureId === figureId) {\n    return host.proposalFeedback.slice(-5)\n  }\n  if (host?.editorMode === 'new' || !host?.figureId) {\n    return host.proposalFeedback.slice(-5)\n  }\n  return undefined\n}\n\n/**\n * 무엇을 고치라는 것인지 대화면 문맥에서 해소한다.\n *\n * 모델이 대상을 안 줬으면 **저작면이 지금 열고 있는 도형**이다. 사용자에게 식별자를 되묻지\n * 않는다 — 화면에 그 도형이 떠 있는데 「어느 도형입니까」를 묻는 것은 문맥을 안 읽은 것이다.\n */\nfunction figureIdFrom(args: any, host: any): string | undefined {\n  const said = typeof args?.figureId === 'string' ? args.figureId.trim() : ''\n  if (said) return said\n\n  const open = typeof host?.figureId === 'string' ? host.figureId.trim() : ''\n  if (open) return open\n\n  return undefined\n}\n\nfunction missingFigureTarget() {\n  return {\n    error: 'FIGURE_TARGET_REQUIRED',\n    message: '현재 화면에는 선택된 도형이 없습니다.',\n    nextStep: 'For an existing figure, call listFigures and match the user’s requested name or type; ask which figure only if ambiguous. For a new figure, call proposeFigureCandidate with create: true and the user’s prompt. Do not invent an id or repeat this call without a target.'\n  }\n}\n\nfunction unsavedFigure(host: any): any | undefined {\n  if (host?.editorMode !== 'new' || !host?.draftSource) return undefined\n  const row = { id: host.figureId, type: host.draftSource.type || 'FIGURE', name: '', state: 'draft' }\n  // Reuse size, shape and vocabulary validation before trusting browser content.\n  const current = sourceForTool(row, host)\n  return { ...row, source: JSON.stringify(current.source) }\n}\n\nconst FIGURE_ID_ARG = {\n  figureId: {\n    type: 'string',\n    description: 'The figure to read. Omit to read the one the person has open, saved or not — the server fills it in, and you cannot see which it is. On the catalog nothing is open, so resolve the figure the person asked for with listFigures first.'\n  }\n} as const\n\n/**\n * 도구 넷.\n *\n * 목록 · 정본 · 발행 판정 · 후보. 저작 대화에서 실제로 묻는 것이 그 넷이다 — 「무엇이 있나」\n * 「지금 어떻게 생겼나」 「발행이 왜 안 되나」 「이렇게 고쳐 봐」.\n */\nfunction figureToolSpecs(): ToolSpec[] {\n  return [\n    {\n      kind: 'read',\n      name: 'listFigures',\n      /* 이 도메인의 도형 목록 — 저장소를 직접 읽지만 같은 일을 하는 문은 이것이다. */\n      doors: ['Query.figures'],\n      description:\n        'Lists the figures in this tenant with their type names, states and part counts. ' +\n        'Call it before naming a type — type names are stored identifiers and must not be invented.',\n      schema: { type: 'object', properties: {} },\n      builder: async (_args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const { getRepository, Figure } = getDeps()\n        const rows = await getRepository(Figure).find({\n          where: { domain: { id: domainId } },\n          order: { updatedAt: 'DESC' },\n          take: 200\n        })\n        return {\n          figures: rows.map((row: any) => ({\n            id: row.id,\n            type: row.type,\n            name: row.name,\n            state: row.state,\n            score: row.score,\n            triangles: row.triangles\n          }))\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'getFigureSource',\n      /* 저장된 도형의 원본. **저장 전 초안**을 물으면 저장소에 갈 것이 없어 화면이 보낸 것을 그대로 돌려준다 —\n       * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 도형을 읽는 권한 검사가 선언에서 사라진다. */\n      doors: ['Query.figure'],\n      description:\n        'Returns the canonical FigureSource of one figure, with its measured cost ' +\n        '(triangles, part groups, and how many of it hold 60fps on one screen). Call it before proposing a revision — ' +\n        'revising without reading it means proposing against a guess.',\n      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const figureId = figureIdFrom(args, ctx?.host)\n        const row = await resolveFigureTarget(figureId, domainId, ctx?.host)\n        if (!row) return missingFigureTarget()\n\n        const current = sourceForTool(row, ctx?.host)\n        if (!current.source) {\n          // 저장된 정본이 없는 상태가 실제로 있다(새로 만들고 저장 안 한 것). 지어내지 않는다.\n          return { id: row.id, type: row.type, name: row.name, source: null, cost: null }\n        }\n\n        const { compile, costOf, scoreOf } = getDeps()\n        const blueprint = compile(current.source)\n\n        return {\n          id: row.id,\n          type: row.type,\n          name: row.name,\n          state: row.state,\n          source: current.source,\n          draft: current.draft,\n          cost: costOf(blueprint, 100),\n          score: scoreOf(blueprint)\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'inspectFigure',\n      /* 검사 결과 — 같은 일을 하는 문. */\n      doors: ['Query.inspectFigure'],\n      description:\n        'Says whether a figure may be released and, when it may not, what is wrong — each finding ' +\n        'carries why it is a problem and what to change. Call it when asked about releasing, or ' +\n        'when asked to fix a figure that will not release.',\n      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const figureId = figureIdFrom(args, ctx?.host)\n        const row = await resolveFigureTarget(figureId, domainId, ctx?.host)\n        if (!row) return missingFigureTarget()\n\n        const current = sourceForTool(row, ctx?.host)\n        const { inspectSource } = getDeps()\n        return { ...inspectSource(current.source ? JSON.stringify(current.source) : null), draft: current.draft }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'proposeFigureCandidate',\n      /* 후보 생성 — 저장은 하지 않지만 같은 문의 권한을 쓴다. */\n      doors: ['Mutation.proposeFigure'],\n      description:\n        'Asks for a figure candidate from a description, optionally revising an existing one. ' +\n        'Returns the candidate with its score and cost. NOTHING IS SAVED — the author accepts or ' +\n        'discards it on screen. This is the only way a candidate reaches the screen.',\n      schema: {\n        type: 'object',\n        properties: {\n          prompt: {\n            type: 'string',\n            description: 'What to make or change, in the words the author used.'\n          },\n          figureId: {\n            type: 'string',\n            description: 'Revise this figure. Omit to revise the one open in the editor; pass null to create anew.'\n          },\n          type: {\n            type: 'string',\n            description: 'Type name for a new figure. Check listFigures first — it is a stored identifier.'\n          },\n          create: {\n            type: 'boolean',\n            description: 'True to create rather than revise, even with a figure open.'\n          }\n        },\n        required: ['prompt']\n      },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const prompt = typeof args?.prompt === 'string' ? args.prompt.trim() : ''\n        if (!prompt) throw new Error('prompt is required: there is nothing to ask for')\n\n        /*\n          고치는 것인지 만드는 것인지를 **문맥에서 정한다.** 열린 도형이 있으면 고치는 것이 기본이고,\n          모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 도형을 덮어쓰는\n          후보가 온다.\n        */\n        let base: unknown\n        if (!args?.create && args?.figureId !== null) {\n          const open = typeof args?.figureId === 'string' ? args.figureId : ctx?.host?.figureId\n          const row = await resolveFigureTarget(open ? open.trim() : undefined, domainId, ctx?.host)\n          if (row) {\n            base = sourceForTool(row, ctx?.host).source ?? undefined\n          }\n        }\n\n        const palette = Array.isArray(ctx?.host?.palette) ? ctx.host.palette : []\n        if (palette.length === 0) {\n          /*\n            팔레트를 모르면 모델이 색을 지어내고, 그 후보는 그리는 시점에 `resolveToken` 이 던진다 —\n            저장까지 되고 나서 화면에서 죽는다. 빈 목록으로 진행하지 않는다.\n          */\n          throw new Error('the palette is missing from the host context — the candidate would invent colours')\n        }\n\n        const { proposeFigure } = getDeps()\n        const feedback = feedbackForTool(ctx?.host, base ? figureIdFrom(args, ctx?.host) : undefined)\n\n        let hostImage: { data: Buffer; mediaType: any } | undefined\n        const rawImage = ctx?.host?.image || (Array.isArray(ctx?.host?.attachments) ? ctx.host.attachments.find((a: any) => a?.mediaType?.startsWith('image/')) : undefined)\n        if (rawImage?.data) {\n          const rawData = typeof rawImage.data === 'string' ? rawImage.data.replace(/^data:image\\/[a-zA-Z]+;base64,/, '') : rawImage.data\n          const buf = typeof rawData === 'string' ? Buffer.from(rawData, 'base64') : Buffer.from(rawData)\n          hostImage = { data: buf, mediaType: rawImage.mediaType || 'image/png' }\n        }\n\n        const result = await proposeFigure({\n          prompt,\n          palette,\n          base,\n          type: typeof args?.type === 'string' ? args.type : undefined,\n          feedback,\n          refine: !!feedback?.length,\n          image: hostImage\n        })\n\n        /*\n          **`proposed: true` 가 카드를 만든다.** 이 표시가 없으면 후보는 도구 추적 안에 묻히고,\n          화면에는 아무것도 생기지 않는다 — 그러면 모델이 「후보를 만들었습니다」라고 쓴 것이\n          거짓말이 된다(사용자가 없는 단추를 찾는다).\n\n          `label`·`reason` 이 카드에 그려지는 두 줄이고, `args` 는 같은 제안을 두 번 세지 않기\n          위한 열쇠의 일부다 — 같은 요청을 두 번 내면 카드가 하나로 접힌다.\n        */\n        return {\n          proposed: true,\n          label: base ? `${result.source.type} 고치기` : `${result.source.type} 만들기`,\n          reason:\n            `등급 ${result.score.grade} · 삼각형 ${result.cost.triangles} · ` +\n            `한 도면 ${result.cost.at.drawCalls}회 · ${result.attempts}번에 만들었다`,\n          choices: [\n            { id: 'save', action: 'save', label: '초안 저장', icon: 'save', primary: true },\n            { id: 'repropose', action: 'prompt', label: '다른 콘셉트 재제안', icon: 'refresh', prompt: '현재 제안과 완전히 다른 스타일과 콘셉트로 새로 제안해줘' },\n            { id: 'slim', action: 'prompt', label: '비율 슬림 조정', icon: 'aspect_ratio', prompt: '전체적인 가로세로 비율을 좀 더 슬림하고 날렵하게 조정해줘' },\n            { id: 'palette', action: 'prompt', label: '색상 테마 변경', icon: 'palette', prompt: '다른 팔레트 색상 테마로 부품 색상을 변경해줘' },\n            { id: 'detail', action: 'prompt', label: '디테일 보강', icon: 'extension', prompt: '주요 디테일과 센서 부품을 좀 더 풍부하게 보강해줘' }\n          ],\n          args: {\n            baseSource: base ? JSON.stringify(base) : undefined,\n            prompt, figureId: base ? figureIdFrom(args, ctx?.host) : undefined,\n            draftType: base && ctx?.host?.editorMode === 'new' && !figureIdFrom(args, ctx?.host)\n              ? (base as any).type : undefined\n          },\n          source: result.source,\n          score: result.score,\n          cost: result.cost,\n          quality: result.quality,\n          violations: result.violations,\n          attempts: result.attempts\n        }\n      }\n    }\n  ] as ToolSpec[]\n}\n\n/**\n * 등록 — 부팅 시 1회.\n *\n * 범주가 하나다. twin 은 관찰과 생성을 둘로 갈랐는데(운영 협의에 생성 도구가 들려 있으면 대화의\n * 성격이 흐려진다), figure 의 대화면은 저작면 하나뿐이고 그 자리에서 읽기와 후보 요청이 함께 필요하다.\n * 대화면이 늘면 그때 가른다.\n */\nexport function registerFigureToolCategories(): void {\n  const authoring: ToolCategory = {\n    name: 'figure-authoring',\n    description: '저작 중인 Figure 의 정본·비용·발행 판정 조회와 후보 제안(저장 아님).',\n    guidance: [\n      '- **도형을 만들거나 고쳐 달라는 요청에는 반드시 `proposeFigureCandidate` 를 호출한다.**',\n      '  후보는 도구 호출 결과에서만 생긴다.',\n      '  호출 없이 \"후보를 만들었습니다\" · \"적용 버튼을 누르세요\" 라고 쓰는 것은 **거짓이다** — 화면에 후보 칸이 생기지 않으므로 사용자는 존재하지 않는 버튼을 찾는다.',\n      '  도크에서는 후보 카드의 버튼을 눌러야 모델러 비교 화면이 열린다. 아직 열지 않은 비교 화면이 이미 보인다고 말하지 않는다.',\n      '  요청한 부품만 바뀌었다고 추측하지 않는다. 후보와 원본을 비교한 근거가 없으면 변경 범위는 비교 화면에서 확인하도록 안내한다.',\n      '- 정본을 직접 저장하지 않는다. 후보만 내고, 받을지 버릴지는 저작자가 화면에서 정한다.',\n      '- 좌표와 크기는 X/Y/Z 축 이름으로 정확하게 표시한다. 확인되지 않은 가로·세로·높이 의미를 임의로 붙이지 않는다.',\n      '- **고치라는 요청이면 먼저 `getFigureSource` 를 부른다.** 읽지 않고 고치면 짐작을 상대로 후보를 내게 되고, 부품 이름이 갈려 이미 배치된 보드의 바인딩이 끊긴다.',\n      '- 목록 화면에는 열린 도형이 없다. 기존 도형을 조회·수정할 때는 `listFigures`에서 사용자가 말한 이름·타입의 id를 찾는다. 대상이 모호할 때만 어느 도형인지 묻는다. 새 제작 요청에는 기존 정본을 조회하지 않고 `proposeFigureCandidate`를 create: true로 호출한다.',\n      '- 타입 이름을 지어내지 않는다 — `listFigures` 로 확인한다. **타입 이름은 저장되는 식별자**이고 보드가 그 이름으로 도형을 찾는다.',\n      '- 발행이 안 되는 이유를 물으면 `inspectFigure` 를 부른다. 판정 없이 \"발행할 수 있습니다\"라고 말하지 않는다.',\n      '  판정의 각 항목은 **왜 문제인지와 무엇을 바꾸면 되는지**를 함께 담고 있다. 그대로 전한다 — 요약하면 저작자가 어느 부품의 어느 축을 고칠지 다시 찾아야 한다.',\n      '- 무게·삼각형 수를 물으면 `getFigureSource` 의 `cost` 를 쓴다. 눈대중으로 세지 않는다.'\n    ].join('\\n'),\n    specs: figureToolSpecs()\n  }\n\n  registerToolCategory(authoring)\n}\n"]}