@things-factory/figure-service 10.1.27 → 10.1.28

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

@@ -73,5 +73,8 @@ export interface Inspection {
  *
  * 정본이 없거나(아직 저장 전) JSON 이 아니면 **막는다** — 발행할 대상이 없는 것이다. 그 경우를
  * 조용히 통과시키면 빈 것이 발행된다.
+ *
+ * `releasedJson` 은 **직전 발행판의 정본**이다. 주면 그것과 견주어 「이미 놓인 인스턴스를 깨는
+ * 발행인가」를 함께 낸다(ADR-0063 결정 3). 한 번도 발행된 적 없으면 견줄 것이 없으므로 안 준다.
  */
-export declare function inspectSource(sourceJson?: string | null): Inspection;
+export declare function inspectSource(sourceJson?: string | null, releasedJson?: string | null): Inspection;

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

@@ -55,8 +55,11 @@ function measuredFixes(source, factor) {
  *
  * 정본이 없거나(아직 저장 전) JSON 이 아니면 **막는다** — 발행할 대상이 없는 것이다. 그 경우를
  * 조용히 통과시키면 빈 것이 발행된다.
+ *
+ * `releasedJson` 은 **직전 발행판의 정본**이다. 주면 그것과 견주어 「이미 놓인 인스턴스를 깨는
+ * 발행인가」를 함께 낸다(ADR-0063 결정 3). 한 번도 발행된 적 없으면 견줄 것이 없으므로 안 준다.
  */
-function inspectSource(sourceJson) {
+function inspectSource(sourceJson, releasedJson) {
     if (!sourceJson) {
         return {
             blocked: true,
@@ -114,7 +117,43 @@ function inspectSource(sourceJson) {
                 blocking: finding.code === 'sizing-splits'
             });
         }
+        findings.push(...contractFindings(source, releasedJson));
     }
     return { findings, blocked: findings.some(finding => finding.blocking) };
 }
+/**
+ * 직전 발행판과 견준 것 — **약속을 깨는 발행인가**(ADR-0063 결정 3).
+ *
+ * 무엇이 달라졌고 그것이 막는 것인지는 형식이 정한다(`contractChanges`). 여기서는 화면과 발행 문이
+ * 읽는 모양으로 옮기기만 한다.
+ *
+ * **앞 판을 오늘 형식으로 못 읽으면 조용히 넘어가지 않는다.** 판 1 은 오늘 형식이 거절하는 판으로
+ * 적혀 있을 수 있고, 그때 견주기를 건너뛰면 아무 말 없이 관문이 없는 것이 된다. 막지는 않는다 —
+ * 그러면 그 도형은 영영 다시 발행할 수 없다.
+ */
+function contractFindings(source, releasedJson) {
+    if (!releasedJson)
+        return [];
+    let released;
+    try {
+        released = JSON.parse(releasedJson);
+        return (0, figure_model_1.contractChanges)(released, source).map(change => ({
+            code: change.code,
+            message: change.message,
+            why: change.why,
+            at: change.subject,
+            blocking: change.blocking
+        }));
+    }
+    catch (e) {
+        return [
+            {
+                code: 'released-unreadable',
+                message: `직전 발행판을 오늘 형식으로 읽을 수 없어 견주지 못했다: ${e.message}`,
+                why: '이 발행이 이미 놓인 인스턴스를 깨는지는 확인되지 않았다.',
+                blocking: false
+            }
+        ];
+    }
+}
 //# sourceMappingURL=figure-gate.js.map

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, 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 */\nexport function inspectSource(sourceJson?: 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\n  return { findings, blocked: findings.some(finding => finding.blocking) }\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      /* 어느 위반이 막나는 형식이 안다 — 여기 목록을 또 들면 둘이 갈린다(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-mutation.js

@@ -132,19 +132,25 @@ let FigureMutation = class FigureMutation {
     
           막는 이유는 사유와 함께 낸다. 「발행할 수 없습니다」로 뭉치면 무엇을 고쳐야 하는지 모른다.
         */
-        const inspection = (0, figure_gate_js_1.inspectSource)(figure.source);
+        /*
+          직전 발행판을 먼저 꺼낸다. 판 번호를 세는 데도 쓰고, **약속을 깨는 발행인가**를 견주는 데도
+          쓴다(ADR-0063 결정 3) — 도면은 type 만 적고 늘 최신 발행판을 그리므로, 다시 발행하는 것은
+          그 type 을 놓아 둔 모든 도면에게 같은 약속을 다시 하는 일이다.
+        */
+        const released = await historyRepository
+            .createQueryBuilder('history')
+            .where('history.originalId = :id', { id: figure.id })
+            .orderBy('history.version', 'DESC')
+            .limit(1)
+            .getOne();
+        const inspection = (0, figure_gate_js_1.inspectSource)(figure.source, released?.source);
         if (inspection.blocked) {
             const reasons = inspection.findings
                 .filter(finding => finding.blocking)
                 .map(finding => (finding.at ? `${finding.message} (${finding.at})` : finding.message));
             throw new Error(`Figure '${figure.type}' 은 아직 발행할 수 없다 — ${reasons.join(' · ')}`);
         }
-        const highest = await historyRepository
-            .createQueryBuilder('history')
-            .select('MAX(history.version)', 'max')
-            .where('history.originalId = :id', { id: figure.id })
-            .getRawOne();
-        const nextVersion = highest?.max ? Number(highest.max) + 1 : 1;
+        const nextVersion = released?.version ? Number(released.version) + 1 : 1;
         return await repository.save({
             /*
               `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.

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

@@ -1 +1 @@
-{"version":3,"file":"figure-mutation.js","sourceRoot":"","sources":["../../../server/service/figure/figure-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import { In } from 'typeorm'\nimport { Arg, Ctx, Directive, Mutation, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { FigurePatch, FigureSaveResult, NewFigure } from './figure-type.js'\nimport { FigureProposal, ProposeRequest } from './figure-propose-type.js'\nimport { inspectSource } from './figure-gate.js'\nimport { parseSource } from './figure-source.js'\nimport { ProposeFailure, proposeFigure } from './figure-propose.js'\n\n@Resolver(Figure)\nexport class FigureMutation {\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureSaveResult, { description: 'Creates a figure. Rejects when the source violates the format.' })\n  async createFigure(\n    @Arg('figure') figure: NewFigure,\n    @Ctx() context: ResolverContext\n  ): Promise<FigureSaveResult> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n\n    // 타입 이름은 도메인 안에서 유일하다. 유니크 인덱스가 있지만 여기서 먼저 본다 —\n    // DB 오류 문구는 저작자에게 아무 말도 해 주지 못한다.\n    const taken = await repository.findOne({ where: { domain: { id: domain.id }, type: figure.type } })\n    if (taken) {\n      throw new Error(`타입 이름 '${figure.type}' 은 이미 쓰이고 있다. 만든 뒤에는 고칠 수 없으므로 다른 이름을 고른다`)\n    }\n\n    // 형식을 어기면 여기서 던진다. 파생값은 서버가 계산한다.\n    const { source, derived, violations } = parseSource(figure.source)\n\n    const saved = await repository.save({\n      ...figure,\n      source,\n      ...derived,\n      state: figure.state ?? 'draft',\n      thumbnailUpdatedAt: figure.thumbnail ? new Date() : undefined,\n      domain,\n      creator: user,\n      updater: user\n    })\n\n    return { figure: saved, violations }\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureSaveResult, { description: 'Updates a figure. The `type` field cannot be changed.' })\n  async updateFigure(\n    @Arg('id') id: string,\n    @Arg('patch') patch: FigurePatch,\n    @Ctx() context: ResolverContext\n  ): Promise<FigureSaveResult> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n\n    const figure = await repository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    // 정본이 바뀌면 파생값도 다시 계산한다. 안 바뀌었으면 손대지 않는다 —\n    // 이름만 고쳤는데 점수가 흔들리면 읽는 사람이 원인을 못 찾는다.\n    let derived: { score: number; triangles: number; groups: number } | undefined\n    let violations = []\n    let source = figure.source\n\n    if (patch.source !== undefined && patch.source !== figure.source) {\n      const parsed = parseSource(patch.source)\n      source = parsed.source\n      derived = parsed.derived\n      violations = parsed.violations\n    }\n\n    /*\n      **판 번호는 여기서 손대지 않는다.** 저장은 저작이고, 판은 발행에서 생긴다(`releaseFigure`).\n      board 의 `updateBoard` 도 같다 — 저장 경로에는 version 이 없다.\n    */\n    const saved = await repository.save({\n      /*\n        `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.\n\n        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은\n        도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은\n        자리에서 domain 을 함께 넣는다.\n      */\n      domain,\n      ...figure,\n      ...patch,\n      source,\n      /*\n        **고치면 발행이 풀린다.**\n\n        발행은 「이 판을 써도 된다」는 약속이고, 그 뒤에 정본이 바뀌면 약속한 것과 배포된 것이\n        달라진다. 그래서 저장은 언제나 초안으로 되돌리고, 다시 내보내려면 발행을 한 번 더 한다\n        (판 번호가 하나 오르고 판본이 하나 더 남는다). board 의 `updateBoard` 가 같은 한 줄을 쓴다.\n      */\n      state: 'draft',\n      ...(derived ?? {}),\n      // 썸네일이 **썸네일로서** 바뀐 때만 시각을 갱신한다. 이름·설명 변경에는 안 건드린다.\n      thumbnailUpdatedAt:\n        patch.thumbnail !== undefined && patch.thumbnail !== figure.thumbnail\n          ? new Date()\n          : figure.thumbnailUpdatedAt,\n      updater: user\n    })\n\n    return { figure: saved, violations }\n  }\n\n  /**\n   * 발행한다 — **판이 생기는 유일한 자리.**\n   *\n   * ## 무엇이 일어나나\n   *\n   * `state` 가 `released` 가 되고, 판 번호가 하나 오르고, 그 순간의 도형이 판본으로 남는다\n   * (`FigureHistory` — 스냅샷은 구독자가 뜬다). 저작 중 저장은 이 셋 중 아무것도 하지 않는다.\n   *\n   * ## 왜 이미 발행된 것을 거절하나\n   *\n   * 발행은 소비처에게 하는 약속이다. 같은 판을 두 번 발행하면 무엇이 약속인지 흐려진다. 고쳐서\n   * 다시 내려면 초안으로 되돌린 뒤 발행한다 — board 가 같은 규칙이다.\n   *\n   * ## 번호는 판본에서 센다\n   *\n   * 도형의 현재 번호가 아니라 **판본의 최대 번호 + 1** 이다. 되돌리기로 옛 판이 현재가 되어도\n   * 다음 발행이 이미 쓴 번호를 다시 쓰지 않는다.\n   *\n   * ## 게이트를 통과해야 한다\n   *\n   * 크기를 바꿨을 때 조각이 갈라지는 도형은 발행되지 않는다(`figure-gate.ts`). 소비처는 형상을\n   * 늘려 쓰므로 — 그것이 이 형식의 값이다 — 늘려도 견디는지가 약속의 일부다. 화면은 같은 판정을\n   * `inspectFigure` 로 미리 물어 이유를 보여 준다.\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Figure, { description: 'Releases a figure — raises its version and keeps the released state as history.' })\n  async releaseFigure(\n    @Arg('id') id: string,\n    @Arg('comment', { nullable: true }) comment: string,\n    @Ctx() context: ResolverContext\n  ): Promise<Figure> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n    const historyRepository = tx.getRepository(FigureHistory)\n\n    const figure = await repository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    if (figure.state === 'released') {\n      throw new Error(`Figure '${figure.type}' 은 이미 발행되어 있다. 고쳐서 다시 내려면 초안으로 되돌린 뒤 발행한다`)\n    }\n\n    /*\n      ── 게이트는 여기 있어야 한다 ────────────────────────────────────────────\n      화면도 같은 판정을 미리 물어(`inspectFigure`) 이유를 보여 주지만, **막는 자리는 이곳뿐이다.**\n      물어본 뒤 정본이 바뀌었을 수 있고, 화면을 거치지 않는 부름도 있다.\n\n      막는 이유는 사유와 함께 낸다. 「발행할 수 없습니다」로 뭉치면 무엇을 고쳐야 하는지 모른다.\n    */\n    const inspection = inspectSource(figure.source)\n    if (inspection.blocked) {\n      const reasons = inspection.findings\n        .filter(finding => finding.blocking)\n        .map(finding => (finding.at ? `${finding.message} (${finding.at})` : finding.message))\n\n      throw new Error(`Figure '${figure.type}' 은 아직 발행할 수 없다 — ${reasons.join(' · ')}`)\n    }\n\n    const highest = await historyRepository\n      .createQueryBuilder('history')\n      .select('MAX(history.version)', 'max')\n      .where('history.originalId = :id', { id: figure.id })\n      .getRawOne()\n\n    const nextVersion = highest?.max ? Number(highest.max) + 1 : 1\n\n    return await repository.save({\n      /*\n        `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.\n\n        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은\n        도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은\n        자리에서 domain 을 함께 넣는다.\n      */\n      domain,\n      ...figure,\n      version: nextVersion,\n      state: 'released',\n      updater: user,\n      /* 판본 구독자가 이것을 판본의 comment 로 옮긴다. Figure 의 칸이 아니다. */\n      __releaseComment: comment ?? null\n    } as any)\n  }\n\n  /**\n   * 옛 판으로 되돌린다.\n   *\n   * ## 무엇이 돌아오나\n   *\n   * 그 판의 **정본과 속성 정의, 그리고 그림**이다. 이름·설명·분류는 그대로 둔다 — 그것들은 언제든\n   * 바꿔도 안전한 카탈로그의 말이고, 되돌리기가 개명까지 되돌리면 사람이 시키지 않은 일을 한다.\n   *\n   * ## 되돌려도 발행은 아니다\n   *\n   * 초안으로 돌아온다. 다시 내보내려면 발행을 한 번 더 하고, 그때 판 번호는 **이미 쓴 번호 다음**을\n   * 받는다 — 3판을 되살렸다고 다시 3판이 되지 않는다. board 도 같다.\n   *\n   * ## 비용은 다시 잰다\n   *\n   * 판본이 든 점수·삼각형은 **그때의 형식**으로 잰 값이다. 지금 이 도형이 그 내용이 되었으므로\n   * 오늘 기준으로 다시 계산한다. 옛 값은 판본에 그대로 남아 있다.\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureSaveResult, { description: 'Reverts a figure to one of its released versions. It comes back as a draft.' })\n  async revertFigureVersion(\n    @Arg('id') id: string,\n    @Arg('version') version: number,\n    @Ctx() context: ResolverContext\n  ): Promise<FigureSaveResult> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n    const historyRepository = tx.getRepository(FigureHistory)\n\n    const figure = await repository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    const history = await historyRepository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id, version }\n    })\n    if (!history) {\n      throw new Error(`Figure '${figure.type}' 에 ${version} 판이 없다`)\n    }\n\n    /* 형식 검사도 다시 받는다 — 옛 판이 오늘의 형식을 어길 수 있고, 그것을 조용히 들이지 않는다. */\n    const { source, derived, violations } = parseSource(history.source)\n\n    const saved = await repository.save({\n      /*\n        `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.\n\n        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은\n        도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은\n        자리에서 domain 을 함께 넣는다.\n      */\n      domain,\n      ...figure,\n      source,\n      ...derived,\n      properties: history.properties,\n      thumbnail: history.thumbnail,\n      thumbnailUpdatedAt: history.thumbnail === figure.thumbnail ? figure.thumbnailUpdatedAt : new Date(),\n      state: 'draft',\n      updater: user\n    })\n\n    return { figure: saved, violations }\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Boolean, { description: 'Soft-deletes a figure.' })\n  async deleteFigure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    const { domain, tx } = context.state\n\n    // 소프트 삭제다 — 이미 배치된 도면이 이 타입을 참조할 수 있으므로 행을 지우지\n    // 않는다. 되살릴 길을 남긴다.\n    await tx.getRepository(Figure).softDelete({ domain: { id: domain.id }, id })\n\n    return true\n  }\n\n  /**\n   * 저작 보조에게 후보를 시킨다.\n   *\n   * **저장하지 않는다.** 후보를 돌려줄 뿐이고, 정본이 되는 것은 저작자가 보고 받은\n   * 뒤다. AI 가 정본에 직접 쓰면 저작자가 무엇이 자기 것이고 무엇이 기계 것인지\n   * 모르게 된다.\n   *\n   * 형식을 어긴 후보는 여기까지 오지 않는다 — `proposeFigure` 가 사유를 모델에\n   * 돌려주고 다시 시킨다. 끝내 못 만들면 **사유와 함께 던진다.** 반쯤 만든 것을\n   * 돌려주지 않는다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureProposal, {\n    description: 'Asks the authoring assistant for a figure. Returns a candidate — nothing is saved.'\n  })\n  async proposeFigure(@Arg('request') request: ProposeRequest): Promise<FigureProposal> {\n    // 그림은 메모리로 받는다. 참고용이라 저장하지 않는다 — 남기면 지울 사람이 없다.\n    let image\n    if (request.image) {\n      const file = await request.image\n      const chunks: Buffer[] = []\n      for await (const chunk of file.createReadStream()) {\n        chunks.push(chunk as Buffer)\n      }\n      image = { data: Buffer.concat(chunks), mediaType: file.mimetype as never }\n    }\n\n    try {\n      const result = await proposeFigure({\n        prompt: request.prompt,\n        base: request.base ? JSON.parse(request.base) : undefined,\n        type: request.type,\n        palette: request.palette,\n        refine: request.refine,\n        feedback: request.feedback,\n        image\n      })\n\n      return {\n        source: JSON.stringify(result.source),\n        score: Math.round(result.score.score),\n        grade: result.score.grade,\n        triangles: result.cost.triangles,\n        groups: result.cost.groups,\n        quality: {\n          ...result.quality,\n          visualRegions: result.quality.visual.regions,\n          visualCoverage: result.quality.visual.coverage,\n          visualReadability: result.quality.visual.readability\n        },\n        violations: result.violations,\n        attempts: result.attempts\n      }\n    } catch (e) {\n      if (e instanceof ProposeFailure) {\n        // 사유를 삼키지 않는다. 저작자가 무엇이 막혔는지 알아야 말을 고쳐 다시 시킨다.\n        throw new Error([e.message, ...e.reasons].join('\\n'))\n      }\n      throw e\n    }\n  }\n\n}\n"]}
+{"version":3,"file":"figure-mutation.js","sourceRoot":"","sources":["../../../server/service/figure/figure-mutation.ts"],"names":[],"mappings":"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","sourcesContent":["import { In } from 'typeorm'\nimport { Arg, Ctx, Directive, Mutation, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { FigureHistory } from './figure-history.js'\nimport { FigurePatch, FigureSaveResult, NewFigure } from './figure-type.js'\nimport { FigureProposal, ProposeRequest } from './figure-propose-type.js'\nimport { inspectSource } from './figure-gate.js'\nimport { parseSource } from './figure-source.js'\nimport { ProposeFailure, proposeFigure } from './figure-propose.js'\n\n@Resolver(Figure)\nexport class FigureMutation {\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureSaveResult, { description: 'Creates a figure. Rejects when the source violates the format.' })\n  async createFigure(\n    @Arg('figure') figure: NewFigure,\n    @Ctx() context: ResolverContext\n  ): Promise<FigureSaveResult> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n\n    // 타입 이름은 도메인 안에서 유일하다. 유니크 인덱스가 있지만 여기서 먼저 본다 —\n    // DB 오류 문구는 저작자에게 아무 말도 해 주지 못한다.\n    const taken = await repository.findOne({ where: { domain: { id: domain.id }, type: figure.type } })\n    if (taken) {\n      throw new Error(`타입 이름 '${figure.type}' 은 이미 쓰이고 있다. 만든 뒤에는 고칠 수 없으므로 다른 이름을 고른다`)\n    }\n\n    // 형식을 어기면 여기서 던진다. 파생값은 서버가 계산한다.\n    const { source, derived, violations } = parseSource(figure.source)\n\n    const saved = await repository.save({\n      ...figure,\n      source,\n      ...derived,\n      state: figure.state ?? 'draft',\n      thumbnailUpdatedAt: figure.thumbnail ? new Date() : undefined,\n      domain,\n      creator: user,\n      updater: user\n    })\n\n    return { figure: saved, violations }\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureSaveResult, { description: 'Updates a figure. The `type` field cannot be changed.' })\n  async updateFigure(\n    @Arg('id') id: string,\n    @Arg('patch') patch: FigurePatch,\n    @Ctx() context: ResolverContext\n  ): Promise<FigureSaveResult> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n\n    const figure = await repository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    // 정본이 바뀌면 파생값도 다시 계산한다. 안 바뀌었으면 손대지 않는다 —\n    // 이름만 고쳤는데 점수가 흔들리면 읽는 사람이 원인을 못 찾는다.\n    let derived: { score: number; triangles: number; groups: number } | undefined\n    let violations = []\n    let source = figure.source\n\n    if (patch.source !== undefined && patch.source !== figure.source) {\n      const parsed = parseSource(patch.source)\n      source = parsed.source\n      derived = parsed.derived\n      violations = parsed.violations\n    }\n\n    /*\n      **판 번호는 여기서 손대지 않는다.** 저장은 저작이고, 판은 발행에서 생긴다(`releaseFigure`).\n      board 의 `updateBoard` 도 같다 — 저장 경로에는 version 이 없다.\n    */\n    const saved = await repository.save({\n      /*\n        `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.\n\n        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은\n        도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은\n        자리에서 domain 을 함께 넣는다.\n      */\n      domain,\n      ...figure,\n      ...patch,\n      source,\n      /*\n        **고치면 발행이 풀린다.**\n\n        발행은 「이 판을 써도 된다」는 약속이고, 그 뒤에 정본이 바뀌면 약속한 것과 배포된 것이\n        달라진다. 그래서 저장은 언제나 초안으로 되돌리고, 다시 내보내려면 발행을 한 번 더 한다\n        (판 번호가 하나 오르고 판본이 하나 더 남는다). board 의 `updateBoard` 가 같은 한 줄을 쓴다.\n      */\n      state: 'draft',\n      ...(derived ?? {}),\n      // 썸네일이 **썸네일로서** 바뀐 때만 시각을 갱신한다. 이름·설명 변경에는 안 건드린다.\n      thumbnailUpdatedAt:\n        patch.thumbnail !== undefined && patch.thumbnail !== figure.thumbnail\n          ? new Date()\n          : figure.thumbnailUpdatedAt,\n      updater: user\n    })\n\n    return { figure: saved, violations }\n  }\n\n  /**\n   * 발행한다 — **판이 생기는 유일한 자리.**\n   *\n   * ## 무엇이 일어나나\n   *\n   * `state` 가 `released` 가 되고, 판 번호가 하나 오르고, 그 순간의 도형이 판본으로 남는다\n   * (`FigureHistory` — 스냅샷은 구독자가 뜬다). 저작 중 저장은 이 셋 중 아무것도 하지 않는다.\n   *\n   * ## 왜 이미 발행된 것을 거절하나\n   *\n   * 발행은 소비처에게 하는 약속이다. 같은 판을 두 번 발행하면 무엇이 약속인지 흐려진다. 고쳐서\n   * 다시 내려면 초안으로 되돌린 뒤 발행한다 — board 가 같은 규칙이다.\n   *\n   * ## 번호는 판본에서 센다\n   *\n   * 도형의 현재 번호가 아니라 **판본의 최대 번호 + 1** 이다. 되돌리기로 옛 판이 현재가 되어도\n   * 다음 발행이 이미 쓴 번호를 다시 쓰지 않는다.\n   *\n   * ## 게이트를 통과해야 한다\n   *\n   * 크기를 바꿨을 때 조각이 갈라지는 도형은 발행되지 않는다(`figure-gate.ts`). 소비처는 형상을\n   * 늘려 쓰므로 — 그것이 이 형식의 값이다 — 늘려도 견디는지가 약속의 일부다. 화면은 같은 판정을\n   * `inspectFigure` 로 미리 물어 이유를 보여 준다.\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Figure, { description: 'Releases a figure — raises its version and keeps the released state as history.' })\n  async releaseFigure(\n    @Arg('id') id: string,\n    @Arg('comment', { nullable: true }) comment: string,\n    @Ctx() context: ResolverContext\n  ): Promise<Figure> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n    const historyRepository = tx.getRepository(FigureHistory)\n\n    const figure = await repository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    if (figure.state === 'released') {\n      throw new Error(`Figure '${figure.type}' 은 이미 발행되어 있다. 고쳐서 다시 내려면 초안으로 되돌린 뒤 발행한다`)\n    }\n\n    /*\n      ── 게이트는 여기 있어야 한다 ────────────────────────────────────────────\n      화면도 같은 판정을 미리 물어(`inspectFigure`) 이유를 보여 주지만, **막는 자리는 이곳뿐이다.**\n      물어본 뒤 정본이 바뀌었을 수 있고, 화면을 거치지 않는 부름도 있다.\n\n      막는 이유는 사유와 함께 낸다. 「발행할 수 없습니다」로 뭉치면 무엇을 고쳐야 하는지 모른다.\n    */\n    /*\n      직전 발행판을 먼저 꺼낸다. 판 번호를 세는 데도 쓰고, **약속을 깨는 발행인가**를 견주는 데도\n      쓴다(ADR-0063 결정 3) — 도면은 type 만 적고 늘 최신 발행판을 그리므로, 다시 발행하는 것은\n      그 type 을 놓아 둔 모든 도면에게 같은 약속을 다시 하는 일이다.\n    */\n    const released = await historyRepository\n      .createQueryBuilder('history')\n      .where('history.originalId = :id', { id: figure.id })\n      .orderBy('history.version', 'DESC')\n      .limit(1)\n      .getOne()\n\n    const inspection = inspectSource(figure.source, released?.source)\n    if (inspection.blocked) {\n      const reasons = inspection.findings\n        .filter(finding => finding.blocking)\n        .map(finding => (finding.at ? `${finding.message} (${finding.at})` : finding.message))\n\n      throw new Error(`Figure '${figure.type}' 은 아직 발행할 수 없다 — ${reasons.join(' · ')}`)\n    }\n\n    const nextVersion = released?.version ? Number(released.version) + 1 : 1\n\n    return await repository.save({\n      /*\n        `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.\n\n        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은\n        도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은\n        자리에서 domain 을 함께 넣는다.\n      */\n      domain,\n      ...figure,\n      version: nextVersion,\n      state: 'released',\n      updater: user,\n      /* 판본 구독자가 이것을 판본의 comment 로 옮긴다. Figure 의 칸이 아니다. */\n      __releaseComment: comment ?? null\n    } as any)\n  }\n\n  /**\n   * 옛 판으로 되돌린다.\n   *\n   * ## 무엇이 돌아오나\n   *\n   * 그 판의 **정본과 속성 정의, 그리고 그림**이다. 이름·설명·분류는 그대로 둔다 — 그것들은 언제든\n   * 바꿔도 안전한 카탈로그의 말이고, 되돌리기가 개명까지 되돌리면 사람이 시키지 않은 일을 한다.\n   *\n   * ## 되돌려도 발행은 아니다\n   *\n   * 초안으로 돌아온다. 다시 내보내려면 발행을 한 번 더 하고, 그때 판 번호는 **이미 쓴 번호 다음**을\n   * 받는다 — 3판을 되살렸다고 다시 3판이 되지 않는다. board 도 같다.\n   *\n   * ## 비용은 다시 잰다\n   *\n   * 판본이 든 점수·삼각형은 **그때의 형식**으로 잰 값이다. 지금 이 도형이 그 내용이 되었으므로\n   * 오늘 기준으로 다시 계산한다. 옛 값은 판본에 그대로 남아 있다.\n   */\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureSaveResult, { description: 'Reverts a figure to one of its released versions. It comes back as a draft.' })\n  async revertFigureVersion(\n    @Arg('id') id: string,\n    @Arg('version') version: number,\n    @Ctx() context: ResolverContext\n  ): Promise<FigureSaveResult> {\n    const { domain, user, tx } = context.state\n    const repository = tx.getRepository(Figure)\n    const historyRepository = tx.getRepository(FigureHistory)\n\n    const figure = await repository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, id }\n    })\n    if (!figure) {\n      throw new Error(`Figure ${id} 를 찾을 수 없다`)\n    }\n\n    const history = await historyRepository.findOne({\n      where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean)) }, originalId: id, version }\n    })\n    if (!history) {\n      throw new Error(`Figure '${figure.type}' 에 ${version} 판이 없다`)\n    }\n\n    /* 형식 검사도 다시 받는다 — 옛 판이 오늘의 형식을 어길 수 있고, 그것을 조용히 들이지 않는다. */\n    const { source, derived, violations } = parseSource(history.source)\n\n    const saved = await repository.save({\n      /*\n        `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.\n\n        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은\n        도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은\n        자리에서 domain 을 함께 넣는다.\n      */\n      domain,\n      ...figure,\n      source,\n      ...derived,\n      properties: history.properties,\n      thumbnail: history.thumbnail,\n      thumbnailUpdatedAt: history.thumbnail === figure.thumbnail ? figure.thumbnailUpdatedAt : new Date(),\n      state: 'draft',\n      updater: user\n    })\n\n    return { figure: saved, violations }\n  }\n\n  @Directive('@transaction')\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => Boolean, { description: 'Soft-deletes a figure.' })\n  async deleteFigure(@Arg('id') id: string, @Ctx() context: ResolverContext): Promise<boolean> {\n    const { domain, tx } = context.state\n\n    // 소프트 삭제다 — 이미 배치된 도면이 이 타입을 참조할 수 있으므로 행을 지우지\n    // 않는다. 되살릴 길을 남긴다.\n    await tx.getRepository(Figure).softDelete({ domain: { id: domain.id }, id })\n\n    return true\n  }\n\n  /**\n   * 저작 보조에게 후보를 시킨다.\n   *\n   * **저장하지 않는다.** 후보를 돌려줄 뿐이고, 정본이 되는 것은 저작자가 보고 받은\n   * 뒤다. AI 가 정본에 직접 쓰면 저작자가 무엇이 자기 것이고 무엇이 기계 것인지\n   * 모르게 된다.\n   *\n   * 형식을 어긴 후보는 여기까지 오지 않는다 — `proposeFigure` 가 사유를 모델에\n   * 돌려주고 다시 시킨다. 끝내 못 만들면 **사유와 함께 던진다.** 반쯤 만든 것을\n   * 돌려주지 않는다.\n   */\n  @Directive('@privilege(category: \"figure\", privilege: \"mutation\", domainOwnerGranted: true)')\n  @Mutation(returns => FigureProposal, {\n    description: 'Asks the authoring assistant for a figure. Returns a candidate — nothing is saved.'\n  })\n  async proposeFigure(@Arg('request') request: ProposeRequest): Promise<FigureProposal> {\n    // 그림은 메모리로 받는다. 참고용이라 저장하지 않는다 — 남기면 지울 사람이 없다.\n    let image\n    if (request.image) {\n      const file = await request.image\n      const chunks: Buffer[] = []\n      for await (const chunk of file.createReadStream()) {\n        chunks.push(chunk as Buffer)\n      }\n      image = { data: Buffer.concat(chunks), mediaType: file.mimetype as never }\n    }\n\n    try {\n      const result = await proposeFigure({\n        prompt: request.prompt,\n        base: request.base ? JSON.parse(request.base) : undefined,\n        type: request.type,\n        palette: request.palette,\n        refine: request.refine,\n        feedback: request.feedback,\n        image\n      })\n\n      return {\n        source: JSON.stringify(result.source),\n        score: Math.round(result.score.score),\n        grade: result.score.grade,\n        triangles: result.cost.triangles,\n        groups: result.cost.groups,\n        quality: {\n          ...result.quality,\n          visualRegions: result.quality.visual.regions,\n          visualCoverage: result.quality.visual.coverage,\n          visualReadability: result.quality.visual.readability\n        },\n        violations: result.violations,\n        attempts: result.attempts\n      }\n    } catch (e) {\n      if (e instanceof ProposeFailure) {\n        // 사유를 삼키지 않는다. 저작자가 무엇이 막혔는지 알아야 말을 고쳐 다시 시킨다.\n        throw new Error([e.message, ...e.reasons].join('\\n'))\n      }\n      throw e\n    }\n  }\n\n}\n"]}

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

@@ -90,7 +90,17 @@ let FigureQuery = class FigureQuery {
         if (!figure) {
             throw new Error(`Figure ${id} 를 찾을 수 없다`);
         }
-        return (0, figure_gate_js_1.inspectSource)(figure.source);
+        /*
+          **화면이 발행 문과 같은 것을 본다.** 직전 발행판을 여기서도 함께 넘기지 않으면, 저작 화면은
+          조용한데 발행을 누른 순간 계약 위반으로 막힌다 — 그때는 이미 열 군데를 고친 뒤다.
+        */
+        const released = await (0, shell_1.getRepository)(figure_history_js_1.FigureHistory)
+            .createQueryBuilder('history')
+            .where('history.originalId = :id', { id })
+            .orderBy('history.version', 'DESC')
+            .limit(1)
+            .getOne();
+        return (0, figure_gate_js_1.inspectSource)(figure.source, released?.source);
     }
     async figureTypeNames(context) {
         const { domain } = context.state;

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":"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","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    return inspectSource(figure.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 } 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"]}

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

@@ -217,7 +217,7 @@ function unsavedFigure(host) {
 const FIGURE_ID_ARG = {
     figureId: {
         type: 'string',
-        description: 'The figure to read. Omit when host context has an open figureId or an unsaved new editor draft. On the catalog, first resolve the user’s requested figure with listFigures.'
+        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.'
     }
 };
 /**
@@ -231,6 +231,9 @@ function figureToolSpecs() {
         {
             kind: 'read',
             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: {} },
@@ -257,8 +260,12 @@ function figureToolSpecs() {
         {
             kind: 'read',
             name: 'getFigureSource',
+            /* 저장된 도형의 원본. **저장 전 초안**을 물으면 저장소에 갈 것이 없어 화면이 보낸 것을 그대로 돌려준다 —
+             * 그 갈래에는 닿는 문이 없지만 `doors: []` 로 적지 않는다. 그러면 저장된 도형을 읽는 권한 검사가 선언에서 사라진다. */
+            doors: ['Query.figure'],
+            privilege: { category: 'figure', privilege: 'query', owner: true },
             description: 'Returns the canonical FigureSource of one figure, with its measured cost ' +
-                '(triangles, draw calls, how many fit on one board). Call it before proposing a revision — ' +
+                '(triangles, part groups, and how many of it hold 60fps on one screen). Call it before proposing a revision — ' +
                 'revising without reading it means proposing against a guess.',
             schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },
             builder: async (args, ctx) => {
@@ -289,6 +296,9 @@ function figureToolSpecs() {
         {
             kind: 'read',
             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.',
@@ -307,6 +317,9 @@ function figureToolSpecs() {
         {
             kind: 'read',
             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.',