@things-factory/figure-service 10.1.7 → 10.1.8

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

@@ -1,3 +1,15 @@
+import type { Axis } from '@hatiolab/figure-model';
+/** Service transport shape. It deliberately contains only an explicit, reversible FigureSource edit. */
+export interface GateFix {
+    findingWay: string;
+    part: string;
+    axis: Axis;
+    from?: string;
+    to: 'min' | 'center' | 'max' | 'span';
+    resolved: number;
+    /** True only when rechecking every sizing case leaves no release-blocking split. */
+    safe: boolean;
+}
 /**
  * 발행해도 되나 — **서버가 판정한다.**
  *
@@ -39,6 +51,12 @@ export interface GateFinding {
     how?: string;
     /** 어디를 가리키나 — 갈라짐은 갈라진 부품 이름들, 형식 위반은 정본 안의 경로. */
     at?: string;
+    /**
+     * 실제로 재 본, 되돌릴 수 있는 한 앵커 수정안들. 문장을 파싱해서 고치는 것이 아니라
+     * FigureSource 에 적용할 정확한 값만 내보낸다. 화면은 이것을 후보로만 보여 주고 저작자가
+     * 수락하기 전에는 정본을 바꾸지 않는다.
+     */
+    fixes?: GateFix[];
     blocking: boolean;
 }
 export interface Inspection {

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

@@ -2,6 +2,54 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.inspectSource = inspectSource;
 const figure_model_1 = require("@hatiolab/figure-model");
+/**
+ * Figure model publishes the same capability for direct model consumers. Keep the service calculation
+ * here as well because this package is deployed independently and receives a compiled local model package.
+ * Each alternative is remeasured; prose from `how` is never parsed into an edit.
+ */
+function measuredFixes(source, factor) {
+    const baseline = (0, figure_model_1.sizingReport)((0, figure_model_1.compile)(source), factor);
+    const baselineCount = baseline.findings.filter(finding => finding.code === 'sizing-splits').length;
+    const seen = new Set();
+    const fixes = [];
+    for (const finding of baseline.findings) {
+        if (finding.code !== 'sizing-splits' || !finding.way)
+            continue;
+        const axes = finding.way.split('-').filter((axis) => ['x', 'y', 'z'].includes(axis));
+        const names = new Set(finding.clumps.flat());
+        for (const part of source.parts) {
+            if (!names.has(part.name))
+                continue;
+            for (const axis of axes) {
+                for (const to of ['min', 'center', 'max', 'span']) {
+                    if (part.anchor?.[axis] === to)
+                        continue;
+                    const changed = {
+                        ...source,
+                        parts: source.parts.map(one => one.name === part.name ? { ...one, anchor: { ...(one.anchor ?? {}), [axis]: to } } : one)
+                    };
+                    const afterCount = (0, figure_model_1.sizingReport)((0, figure_model_1.compile)(changed), factor).findings.filter(one => one.code === 'sizing-splits').length;
+                    const resolved = baselineCount - afterCount;
+                    const key = `${finding.way}:${part.name}:${axis}:${to}`;
+                    if (resolved <= 0 || seen.has(key))
+                        continue;
+                    seen.add(key);
+                    fixes.push({
+                        findingWay: finding.way,
+                        part: part.name,
+                        axis,
+                        from: part.anchor?.[axis],
+                        to,
+                        resolved,
+                        /* 한 finding만 없앤 것이 아니라 전수 검사에서 막는 split이 0일 때만 원클릭 후보가 된다. */
+                        safe: afterCount === 0
+                    });
+                }
+            }
+        }
+    }
+    return fixes.sort((a, b) => b.resolved - a.resolved || a.part.localeCompare(b.part)).slice(0, 12);
+}
 /**
  * 정본 하나를 판정한다.
  *
@@ -45,7 +93,9 @@ function inspectSource(sourceJson) {
         findings.push({ code: violation.code, message: violation.message, blocking: false });
     }
     if (result.errors.length === 0) {
-        const report = (0, figure_model_1.sizingReport)((0, figure_model_1.compile)(parsed));
+        const source = parsed;
+        const report = (0, figure_model_1.sizingReport)((0, figure_model_1.compile)(source));
+        const fixes = measuredFixes(source, report.factor);
         for (const finding of report.findings) {
             findings.push({
                 code: finding.code,
@@ -55,6 +105,7 @@ function inspectSource(sourceJson) {
                 how: finding.how,
                 /* 숫자가 아니라 자리를 말한다 — 어느 부품들이 갈라져 나왔나. */
                 at: finding.clumps.map(clump => [...clump].sort().join('+')).join(' | ') || undefined,
+                fixes: finding.code === 'sizing-splits' ? fixes.filter(fix => fix.findingWay === finding.way) : undefined,
                 blocking: finding.code === 'sizing-splits'
             });
         }

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":";;AA4DA,sCA0DC;AAtHD,yDAAwE;AAsDxE;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,UAA0B;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,2BAA2B;oBACpC,QAAQ,EAAE,IAAI;iBACf;aACF;SACF,CAAA;IACH,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAoB,CAAW,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SAC5G,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,uBAAQ,EAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAkB,EAAE,CAAA;IAElC;;;;MAIE;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7F,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAA,2BAAY,EAAC,IAAA,sBAAO,EAAC,MAAsB,CAAC,CAAC,CAAA;QAE5D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,gDAAgD;gBAChD,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,wCAAwC;gBACxC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS;gBACrF,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,eAAe;aAC3C,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAA;AAC1E,CAAC","sourcesContent":["import { compile, sizingReport, validate } from '@hatiolab/figure-model'\nimport type { FigureSource } from '@hatiolab/figure-model'\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 *   sizing-loose    1배에서 이미 여러 조각이다      알린다\n *   violations      형식이 권하지 않는 것          알린다 (저장 때 이미 보여 준 것들)\n *\n * 갈라짐을 막는 이유는 사람 눈에 「부서졌다」로 보이기 때문이다 — 시그널타워를 3배로 세우니 램프가\n * 기둥 위 공중에 떴던 그것이고, 앵커 규칙이 생긴 이유다. 소비처가 형상을 늘려 쓰는 것은 막을 수\n * 없으니(그것이 이 형식의 값이다), 늘려도 견디는지를 발행 전에 본다.\n *\n * ## 재 본 값\n *\n * [확인함] 2026-09-09 · 표본 15개(시드 14 + 저작 1)\n *   형식 오류 0 · 1배 분리 0 · **갈라짐 1**(MIXER, z·y-z 조합) · 조용함 14\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  blocking: boolean\n}\n\nexport interface Inspection {\n  findings: GateFinding[]\n  /** 막는 것이 하나라도 있나. 화면이 이것으로 단추를 잠근다. */\n  blocked: boolean\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({ code: violation.code, message: violation.message, blocking: false })\n  }\n\n  if (result.errors.length === 0) {\n    const report = sizingReport(compile(parsed as FigureSource))\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        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":";;AA8HA,sCA6DC;AA3LD,yDAAwE;AAwExE;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAoB,EAAE,MAAc;IACzD,MAAM,QAAQ,GAAG,IAAA,2BAAY,EAAC,IAAA,sBAAO,EAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;IACtD,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,MAAM,CAAA;IAClG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,KAAK,GAAc,EAAE,CAAA;IAE3B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,OAAO,CAAC,GAAG;YAAE,SAAQ;QAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAgB,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QAClG,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAE5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAQ;YACnC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;gBACxB,KAAK,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAU,EAAE,CAAC;oBAC3D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE;wBAAE,SAAQ;oBACxC,MAAM,OAAO,GAAiB;wBAC5B,GAAG,MAAM;wBACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;qBACzH,CAAA;oBACD,MAAM,UAAU,GAAG,IAAA,2BAAY,EAAC,IAAA,sBAAO,EAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,MAAM,CAAA;oBACrH,MAAM,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAA;oBAC3C,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,EAAE,CAAA;oBACvD,IAAI,QAAQ,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;wBAAE,SAAQ;oBAC5C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;oBACb,KAAK,CAAC,IAAI,CAAC;wBACT,UAAU,EAAE,OAAO,CAAC,GAAG;wBACvB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,IAAI;wBACJ,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;wBACzB,EAAE;wBACF,QAAQ;wBACR,8DAA8D;wBAC9D,IAAI,EAAE,UAAU,KAAK,CAAC;qBACvB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AACnG,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,UAA0B;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,2BAA2B;oBACpC,QAAQ,EAAE,IAAI;iBACf;aACF;SACF,CAAA;IACH,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAoB,CAAW,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SAC5G,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,uBAAQ,EAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAkB,EAAE,CAAA;IAElC;;;;MAIE;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7F,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAsB,CAAA;QACrC,MAAM,MAAM,GAAG,IAAA,2BAAY,EAAC,IAAA,sBAAO,EAAC,MAAM,CAAC,CAAC,CAAA;QAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAElD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,gDAAgD;gBAChD,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,wCAAwC;gBACxC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS;gBACrF,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;gBACzG,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,eAAe;aAC3C,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAA;AAC1E,CAAC","sourcesContent":["import { 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 *   sizing-loose    1배에서 이미 여러 조각이다      알린다\n *   violations      형식이 권하지 않는 것          알린다 (저장 때 이미 보여 준 것들)\n *\n * 갈라짐을 막는 이유는 사람 눈에 「부서졌다」로 보이기 때문이다 — 시그널타워를 3배로 세우니 램프가\n * 기둥 위 공중에 떴던 그것이고, 앵커 규칙이 생긴 이유다. 소비처가 형상을 늘려 쓰는 것은 막을 수\n * 없으니(그것이 이 형식의 값이다), 늘려도 견디는지를 발행 전에 본다.\n *\n * ## 재 본 값\n *\n * [확인함] 2026-09-09 · 표본 15개(시드 14 + 저작 1)\n *   형식 오류 0 · 1배 분리 0 · **갈라짐 1**(MIXER, z·y-z 조합) · 조용함 14\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({ code: violation.code, message: violation.message, blocking: false })\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"]}

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

@@ -253,6 +253,8 @@ let FigureMutation = class FigureMutation {
                 base: request.base ? JSON.parse(request.base) : undefined,
                 type: request.type,
                 palette: request.palette,
+                refine: request.refine,
+                feedback: request.feedback,
                 image
             });
             return {
@@ -261,6 +263,12 @@ let FigureMutation = class FigureMutation {
                 grade: result.score.grade,
                 triangles: result.cost.triangles,
                 groups: result.cost.groups,
+                quality: {
+                    ...result.quality,
+                    visualRegions: result.quality.visual.regions,
+                    visualCoverage: result.quality.visual.coverage,
+                    visualReadability: result.quality.visual.readability
+                },
                 violations: result.violations,
                 attempts: result.attempts
             };

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":";;;;AAAA,qCAA4B;AAC5B,+CAAsE;AAItE,2CAAoC;AACpC,2DAAmD;AACnD,qDAA2E;AAC3E,qEAAyE;AACzE,qDAAgD;AAChD,yDAAgD;AAChD,2DAAmE;AAG5D,IAAM,cAAc,GAApB,MAAM,cAAc;IAInB,AAAN,KAAK,CAAC,YAAY,CACD,MAAiB,EACzB,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,kBAAM,CAAC,CAAA;QAE3C,gDAAgD;QAChD,kCAAkC;QAClC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACnG,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,4CAA4C,CAAC,CAAA;QACpF,CAAC;QAED,kCAAkC;QAClC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAA,8BAAW,EAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAElE,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;YAClC,GAAG,MAAM;YACT,MAAM;YACN,GAAG,OAAO;YACV,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO;YAC9B,kBAAkB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YAC7D,MAAM;YACN,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;SACd,CAAC,CAAA;QAEF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IACtC,CAAC;IAKK,AAAN,KAAK,CAAC,YAAY,CACL,EAAU,EACP,KAAkB,EACzB,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,kBAAM,CAAC,CAAA;QAE3C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;YACtC,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;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAC3C,CAAC;QAED,0CAA0C;QAC1C,sCAAsC;QACtC,IAAI,OAAyE,CAAA;QAC7E,IAAI,UAAU,GAAG,EAAE,CAAA;QACnB,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAE1B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;YACjE,MAAM,MAAM,GAAG,IAAA,8BAAW,EAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACxC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;YACtB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;YACxB,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;QAChC,CAAC;QAED;;;UAGE;QACF,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;YAClC;;;;;;cAME;YACF,MAAM;YACN,GAAG,MAAM;YACT,GAAG,KAAK;YACR,MAAM;YACN;;;;;;cAME;YACF,KAAK,EAAE,OAAO;YACd,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;YAClB,oDAAoD;YACpD,kBAAkB,EAChB,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;gBACnE,CAAC,CAAC,IAAI,IAAI,EAAE;gBACZ,CAAC,CAAC,MAAM,CAAC,kBAAkB;YAC/B,OAAO,EAAE,IAAI;SACd,CAAC,CAAA;QAEF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IACtC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IAIG,AAAN,KAAK,CAAC,aAAa,CACN,EAAU,EACe,OAAe,EAC5C,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,kBAAM,CAAC,CAAA;QAC3C,MAAM,iBAAiB,GAAG,EAAE,CAAC,aAAa,CAAC,iCAAa,CAAC,CAAA;QAEzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;YACtC,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;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAC3C,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,4CAA4C,CAAC,CAAA;QACrF,CAAC;QAED;;;;;;UAME;QACF,MAAM,UAAU,GAAG,IAAA,8BAAa,EAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC/C,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ;iBAChC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;iBACnC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;YAExF,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,qBAAqB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACnF,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,iBAAiB;aACpC,kBAAkB,CAAC,SAAS,CAAC;aAC7B,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC;aACrC,KAAK,CAAC,0BAA0B,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;aACpD,SAAS,EAAE,CAAA;QAEd,MAAM,WAAW,GAAG,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAE9D,OAAO,MAAM,UAAU,CAAC,IAAI,CAAC;YAC3B;;;;;;cAME;YACF,MAAM;YACN,GAAG,MAAM;YACT,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,IAAI;YACb,qDAAqD;YACrD,gBAAgB,EAAE,OAAO,IAAI,IAAI;SAC3B,CAAC,CAAA;IACX,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IAIG,AAAN,KAAK,CAAC,mBAAmB,CACZ,EAAU,EACL,OAAe,EACxB,OAAwB;QAE/B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,CAAC,kBAAM,CAAC,CAAA;QAC3C,MAAM,iBAAiB,GAAG,EAAE,CAAC,aAAa,CAAC,iCAAa,CAAC,CAAA;QAEzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;YACtC,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;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC;YAC9C,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,OAAO,EAAE;SACrG,CAAC,CAAA;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,OAAO,OAAO,QAAQ,CAAC,CAAA;QAC/D,CAAC;QAED,4DAA4D;QAC5D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAA,8BAAW,EAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAEnE,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;YAClC;;;;;;cAME;YACF,MAAM;YACN,GAAG,MAAM;YACT,MAAM;YACN,GAAG,OAAO;YACV,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,kBAAkB,EAAE,OAAO,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;YACnG,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAA;QAEF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;IACtC,CAAC;IAKK,AAAN,KAAK,CAAC,YAAY,CAAY,EAAU,EAAS,OAAwB;QACvE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;QAEpC,+CAA+C;QAC/C,mBAAmB;QACnB,MAAM,EAAE,CAAC,aAAa,CAAC,kBAAM,CAAC,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QAE5E,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;;OAUG;IAKG,AAAN,KAAK,CAAC,aAAa,CAAiB,OAAuB;QACzD,gDAAgD;QAChD,IAAI,KAAK,CAAA;QACT,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAA;YAChC,MAAM,MAAM,GAAa,EAAE,CAAA;YAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;gBAClD,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;YAC9B,CAAC;YACD,KAAK,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,QAAiB,EAAE,CAAA;QAC5E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAa,EAAC;gBACjC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBACzD,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK;aACN,CAAC,CAAA;YAEF,OAAO;gBACL,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;gBACrC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBACrC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;gBACzB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS;gBAChC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;gBAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAA;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,kCAAc,EAAE,CAAC;gBAChC,+CAA+C;gBAC/C,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YACvD,CAAC;YACD,MAAM,CAAC,CAAA;QACT,CAAC;IACH,CAAC;CAEF,CAAA;AAvUY,wCAAc;AAInB;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,iFAAiF,CAAC;IAC5F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAgB,EAAE,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC;IAEtH,mBAAA,IAAA,kBAAG,EAAC,QAAQ,CAAC,CAAA;IACb,mBAAA,IAAA,kBAAG,GAAE,CAAA;;6CADiB,0BAAS;;kDA4BjC;AAKK;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,iFAAiF,CAAC;IAC5F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAgB,EAAE,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC;IAE7G,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IACT,mBAAA,IAAA,kBAAG,EAAC,OAAO,CAAC,CAAA;IACZ,mBAAA,IAAA,kBAAG,GAAE,CAAA;;qDADe,4BAAW;;kDA4DjC;AA6BK;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,iFAAiF,CAAC;IAC5F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,kBAAM,EAAE,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;IAE7H,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IACT,mBAAA,IAAA,kBAAG,EAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAClC,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;mDAyDP;AAuBK;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,iFAAiF,CAAC;IAC5F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,iCAAgB,EAAE,EAAE,WAAW,EAAE,6EAA6E,EAAE,CAAC;IAEnI,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IACT,mBAAA,IAAA,kBAAG,EAAC,SAAS,CAAC,CAAA;IACd,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;yDA2CP;AAKK;IAHL,IAAA,wBAAS,EAAC,cAAc,CAAC;IACzB,IAAA,wBAAS,EAAC,iFAAiF,CAAC;IAC5F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACpD,mBAAA,IAAA,kBAAG,EAAC,IAAI,CAAC,CAAA;IAAc,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;kDAQ/C;AAiBK;IAJL,IAAA,wBAAS,EAAC,iFAAiF,CAAC;IAC5F,IAAA,uBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC,uCAAc,EAAE;QACnC,WAAW,EAAE,oFAAoF;KAClG,CAAC;IACmB,mBAAA,IAAA,kBAAG,EAAC,SAAS,CAAC,CAAA;;6CAAU,uCAAc;;mDAqC1D;yBArUU,cAAc;IAD1B,IAAA,uBAAQ,EAAC,kBAAM,CAAC;GACJ,cAAc,CAuU1B","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        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        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    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"]}

package/dist-server/service/figure/figure-propose-type.d.ts

@@ -1,5 +1,32 @@
 import type { FileUpload } from 'graphql-upload/GraphQLUpload.js';
 import { FigureFinding } from './figure-type.js';
+export declare class FigureQualityFinding {
+    dimension: string;
+    code: string;
+    message: string;
+}
+export declare class FigureQualityReview {
+    status: string;
+    summary: string;
+    findings: FigureQualityFinding[];
+    visualRegions: number;
+    visualCoverage: number;
+    visualReadability: number;
+}
+/** 제한된 후보 품질 코드. 현재 요청의 참고 데이터이며 어떤 Figure에도 저장되지 않는다. */
+export declare class ProposalFeedbackQualityInput {
+    status?: string;
+    findingCodes?: string[];
+}
+/** 사람이 명시적으로 수락하거나 거절한 후보의 제한된 세션 반응. */
+export declare class ProposalFeedbackInput {
+    outcome: string;
+    selectedChanges: number;
+    totalChanges: number;
+    note?: string;
+    grade?: string;
+    quality?: ProposalFeedbackQualityInput;
+}
 /**
  * 저작 보조에 넘기는 것.
  *
@@ -25,6 +52,8 @@ export declare class ProposeRequest {
      */
     image?: FileUpload;
     palette: string[];
+    refine?: boolean;
+    feedback?: ProposalFeedbackInput[];
 }
 /**
  * 후보 하나.
@@ -38,6 +67,7 @@ export declare class FigureProposal {
     grade: string;
     triangles: number;
     groups: number;
+    quality: FigureQualityReview;
     violations: FigureFinding[];
     attempts: number;
 }

package/dist-server/service/figure/figure-propose-type.js

@@ -1,10 +1,104 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FigureProposal = exports.ProposeRequest = void 0;
+exports.FigureProposal = exports.ProposeRequest = exports.ProposalFeedbackInput = exports.ProposalFeedbackQualityInput = exports.FigureQualityReview = exports.FigureQualityFinding = void 0;
 const tslib_1 = require("tslib");
 const GraphQLUpload_js_1 = tslib_1.__importDefault(require("graphql-upload/GraphQLUpload.js"));
 const type_graphql_1 = require("type-graphql");
 const figure_type_js_1 = require("./figure-type.js");
+let FigureQualityFinding = class FigureQualityFinding {
+};
+exports.FigureQualityFinding = FigureQualityFinding;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'What the consideration concerns: identity, silhouette, palette, performance, or resilience.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureQualityFinding.prototype, "dimension", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Stable machine-readable review code.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureQualityFinding.prototype, "code", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Human-readable evidence and recommended review.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureQualityFinding.prototype, "message", void 0);
+exports.FigureQualityFinding = FigureQualityFinding = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'One explainable consideration from the model-grounded candidate review.' })
+], FigureQualityFinding);
+let FigureQualityReview = class FigureQualityReview {
+};
+exports.FigureQualityReview = FigureQualityReview;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'ready when measurable checks are clear; review when author attention is recommended.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureQualityReview.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Compact explanation of this review.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureQualityReview.prototype, "summary", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [FigureQualityFinding], { description: 'Measured considerations for the author and assistant.' }),
+    tslib_1.__metadata("design:type", Array)
+], FigureQualityReview.prototype, "findings", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Visible material regions in the reproducible top-view evidence.' }),
+    tslib_1.__metadata("design:type", Number)
+], FigureQualityReview.prototype, "visualRegions", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Top-view footprint coverage from 0 to 1.' }),
+    tslib_1.__metadata("design:type", Number)
+], FigureQualityReview.prototype, "visualCoverage", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Normalized top-view readability evidence from 0 to 1.' }),
+    tslib_1.__metadata("design:type", Number)
+], FigureQualityReview.prototype, "visualReadability", void 0);
+exports.FigureQualityReview = FigureQualityReview = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Explainable design review based on Figure-model evidence, not a visual aesthetic claim.' })
+], FigureQualityReview);
+/** 제한된 후보 품질 코드. 현재 요청의 참고 데이터이며 어떤 Figure에도 저장되지 않는다. */
+let ProposalFeedbackQualityInput = class ProposalFeedbackQualityInput {
+};
+exports.ProposalFeedbackQualityInput = ProposalFeedbackQualityInput;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ProposalFeedbackQualityInput.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [String], { nullable: true }),
+    tslib_1.__metadata("design:type", Array)
+], ProposalFeedbackQualityInput.prototype, "findingCodes", void 0);
+exports.ProposalFeedbackQualityInput = ProposalFeedbackQualityInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'Measured review summary from an earlier candidate in this authoring session.' })
+], ProposalFeedbackQualityInput);
+/** 사람이 명시적으로 수락하거나 거절한 후보의 제한된 세션 반응. */
+let ProposalFeedbackInput = class ProposalFeedbackInput {
+};
+exports.ProposalFeedbackInput = ProposalFeedbackInput;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(),
+    tslib_1.__metadata("design:type", String)
+], ProposalFeedbackInput.prototype, "outcome", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], ProposalFeedbackInput.prototype, "selectedChanges", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    tslib_1.__metadata("design:type", Number)
+], ProposalFeedbackInput.prototype, "totalChanges", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ProposalFeedbackInput.prototype, "note", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ProposalFeedbackInput.prototype, "grade", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => ProposalFeedbackQualityInput, { nullable: true }),
+    tslib_1.__metadata("design:type", ProposalFeedbackQualityInput)
+], ProposalFeedbackInput.prototype, "quality", void 0);
+exports.ProposalFeedbackInput = ProposalFeedbackInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'Explicit author feedback for the next candidate. Session-only; never persisted.' })
+], ProposalFeedbackInput);
 /**
  * 저작 보조에 넘기는 것.
  *
@@ -41,6 +135,17 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)(type => [String], { description: 'Palette tokens the client can resolve. Anything else is rejected.' }),
     tslib_1.__metadata("design:type", Array)
 ], ProposeRequest.prototype, "palette", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Ask for one evidence-grounded refinement when the first valid candidate needs review.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ProposeRequest.prototype, "refine", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [ProposalFeedbackInput], {
+        nullable: true,
+        description: 'Explicit session-only feedback on earlier candidates. It is constrained again before prompting and never stored.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], ProposeRequest.prototype, "feedback", void 0);
 exports.ProposeRequest = ProposeRequest = tslib_1.__decorate([
     (0, type_graphql_1.InputType)({ description: 'What to ask the authoring assistant for' })
 ], ProposeRequest);
@@ -73,6 +178,12 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Material groups — the draw calls one instance costs' }),
     tslib_1.__metadata("design:type", Number)
 ], FigureProposal.prototype, "groups", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => FigureQualityReview, {
+        description: 'Explainable design review. It advises the author and never saves or rejects the candidate.'
+    }),
+    tslib_1.__metadata("design:type", FigureQualityReview)
+], FigureProposal.prototype, "quality", void 0);
 tslib_1.__decorate([
     (0, type_graphql_1.Field)(type => [figure_type_js_1.FigureFinding], {
         description: 'Policy violations. These do not block the proposal — the author decides.'

package/dist-server/service/figure/figure-propose-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-propose-type.js","sourceRoot":"","sources":["../../../server/service/figure/figure-propose-type.ts"],"names":[],"mappings":";;;;AACA,+FAA2D;AAC3D,+CAAgE;AAEhE,qDAAgD;AAEhD;;;;;;;;;;;;GAYG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;CAqB1B,CAAA;AArBY,wCAAc;AAEzB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;;8CAC1D;AAGd;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iEAAiE,EAAE,CAAC;;4CAC7F;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;;4CACrF;AASb;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,0BAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;6CACzE;AAGlB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,mEAAmE,EAAE,CAAC;;+CAC7F;yBApBN,cAAc;IAD1B,IAAA,wBAAS,EAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;GACzD,cAAc,CAqB1B;AAED;;;;;GAKG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;CAuB1B,CAAA;AAvBY,wCAAc;AAEzB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;;8CAChD;AAGd;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;;6CACjD;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;;6CACjD;AAGb;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;iDAChD;AAGjB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;;8CAC7E;AAKd;IAHC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,8BAAa,CAAC,EAAE;QAC9B,WAAW,EAAE,0EAA0E;KACxF,CAAC;;kDACyB;AAG3B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;;gDAC3E;yBAtBL,cAAc;IAD1B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;GAClG,cAAc,CAuB1B","sourcesContent":["import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'\nimport GraphQLUpload from 'graphql-upload/GraphQLUpload.js'\nimport { Field, InputType, Int, ObjectType } from 'type-graphql'\n\nimport { FigureFinding } from './figure-type.js'\n\n/**\n * 저작 보조에 넘기는 것.\n *\n * ## 팔레트를 클라이언트가 보낸다\n *\n * 서버가 팔레트를 알 수 없다. 팔레트는 things-scene 이 갖고 있는데, 그 패키지의\n * node 조건은 transfer 번들로 가고 거기에는 `activePalette` 이 없다 [확인함].\n * 그리는 쪽이 어떤 토큰을 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.\n *\n * **그래서 저장 문(`parseSource`)은 토큰을 검사하지 못한다.** `validate()` 도\n * 못 한다 — figure-model 이 형식은 갖고 있지만 색 어휘는 things-scene 에 있다.\n * 색 어휘가 형식의 일부라면 figure-model 이 갖는 것이 맞다. **figure-model 에 올릴 것.**\n */\n@InputType({ description: 'What to ask the authoring assistant for' })\nexport class ProposeRequest {\n  @Field({ description: 'What the author asked for, in their own words' })\n  prompt: string\n\n  @Field({ nullable: true, description: 'The figure source to revise, as JSON. Omit to create a new one.' })\n  base?: string\n\n  @Field({ nullable: true, description: 'Type name for a new figure. Ignored when base is given.' })\n  type?: string\n\n  /**\n   * 그림.\n   *\n   * 비율과 덩어리를 읽는 데 쓴다. 표면 무늬를 옮기는 데 쓰지 않는다 — 로우폴리는\n   * 텍스처가 0 인 것이 목표다.\n   */\n  @Field(type => GraphQLUpload, { nullable: true, description: 'Reference photo or render' })\n  image?: FileUpload\n\n  @Field(type => [String], { description: 'Palette tokens the client can resolve. Anything else is rejected.' })\n  palette: string[]\n}\n\n/**\n * 후보 하나.\n *\n * **정본이 아니다.** 저작자가 보고 받아야 정본이 된다. 그래서 서버는 저장하지 않고\n * 돌려주기만 한다.\n */\n@ObjectType({ description: 'A figure the assistant proposes. Not saved — the author accepts or discards it.' })\nexport class FigureProposal {\n  @Field({ description: 'The proposed figure source, as JSON' })\n  source: string\n\n  @Field(type => Int, { description: 'Reuse score out of 100' })\n  score: number\n\n  @Field({ description: 'Grade from the score — A, B, C or D' })\n  grade: string\n\n  @Field(type => Int, { description: 'Triangles in one instance' })\n  triangles: number\n\n  @Field(type => Int, { description: 'Material groups — the draw calls one instance costs' })\n  groups: number\n\n  @Field(type => [FigureFinding], {\n    description: 'Policy violations. These do not block the proposal — the author decides.'\n  })\n  violations: FigureFinding[]\n\n  @Field(type => Int, { description: 'How many attempts the assistant needed. Diagnostic.' })\n  attempts: number\n}\n"]}
+{"version":3,"file":"figure-propose-type.js","sourceRoot":"","sources":["../../../server/service/figure/figure-propose-type.ts"],"names":[],"mappings":";;;;AACA,+FAA2D;AAC3D,+CAAgE;AAEhE,qDAAgD;AAGzC,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;CAShC,CAAA;AATY,oDAAoB;AAE/B;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,6FAA6F,EAAE,CAAC;;uDACrG;AAGjB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;;kDACnD;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC;;qDAC3D;+BARJ,oBAAoB;IADhC,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,yEAAyE,EAAE,CAAC;GAC1F,oBAAoB,CAShC;AAGM,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAmB/B,CAAA;AAnBY,kDAAmB;AAE9B;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,sFAAsF,EAAE,CAAC;;mDACjG;AAGd;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;;oDAC/C;AAGf;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC;;qDAChF;AAGhC;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,iEAAiE,EAAE,CAAC;;0DAClF;AAGrB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;;2DAC7C;AAGtB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC;;8DACvD;8BAjBd,mBAAmB;IAD/B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,yFAAyF,EAAE,CAAC;GAC1G,mBAAmB,CAmB/B;AAED,0DAA0D;AAEnD,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;CAMxC,CAAA;AANY,oEAA4B;AAEvC;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4DACX;AAGf;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kEACrB;uCALZ,4BAA4B;IADxC,IAAA,wBAAS,EAAC,EAAE,WAAW,EAAE,8EAA8E,EAAE,CAAC;GAC9F,4BAA4B,CAMxC;AAED,yCAAyC;AAElC,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;CAkBjC,CAAA;AAlBY,sDAAqB;AAEhC;IADC,IAAA,oBAAK,GAAE;;sDACO;AAGf;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;8DACI;AAGvB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;2DACC;AAGpB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACb;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;oDACZ;AAGd;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;sCACtD,4BAA4B;sDAAA;gCAjB3B,qBAAqB;IADjC,IAAA,wBAAS,EAAC,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;GACjG,qBAAqB,CAkBjC;AAED;;;;;;;;;;;;GAYG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;CA8B1B,CAAA;AA9BY,wCAAc;AAEzB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;;8CAC1D;AAGd;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iEAAiE,EAAE,CAAC;;4CAC7F;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;;4CACrF;AASb;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,0BAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;6CACzE;AAGlB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,mEAAmE,EAAE,CAAC;;+CAC7F;AAGjB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uFAAuF,EAAE,CAAC;;8CAChH;AAMhB;IAJC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,EAAE;QACtC,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,kHAAkH;KAChI,CAAC;;gDACgC;yBA7BvB,cAAc;IAD1B,IAAA,wBAAS,EAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;GACzD,cAAc,CA8B1B;AAED;;;;;GAKG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;CA4B1B,CAAA;AA5BY,wCAAc;AAEzB;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;;8CAChD;AAGd;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;;6CACjD;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;;6CACjD;AAGb;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,CAAC;;iDAChD;AAGjB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;;8CAC7E;AAKd;IAHC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,mBAAmB,EAAE;QAClC,WAAW,EAAE,4FAA4F;KAC1G,CAAC;sCACO,mBAAmB;+CAAA;AAK5B;IAHC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,8BAAa,CAAC,EAAE;QAC9B,WAAW,EAAE,0EAA0E;KACxF,CAAC;;kDACyB;AAG3B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;;gDAC3E;yBA3BL,cAAc;IAD1B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;GAClG,cAAc,CA4B1B","sourcesContent":["import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'\nimport GraphQLUpload from 'graphql-upload/GraphQLUpload.js'\nimport { Field, InputType, Int, ObjectType } from 'type-graphql'\n\nimport { FigureFinding } from './figure-type.js'\n\n@ObjectType({ description: 'One explainable consideration from the model-grounded candidate review.' })\nexport class FigureQualityFinding {\n  @Field({ description: 'What the consideration concerns: identity, silhouette, palette, performance, or resilience.' })\n  dimension: string\n\n  @Field({ description: 'Stable machine-readable review code.' })\n  code: string\n\n  @Field({ description: 'Human-readable evidence and recommended review.' })\n  message: string\n}\n\n@ObjectType({ description: 'Explainable design review based on Figure-model evidence, not a visual aesthetic claim.' })\nexport class FigureQualityReview {\n  @Field({ description: 'ready when measurable checks are clear; review when author attention is recommended.' })\n  status: string\n\n  @Field({ description: 'Compact explanation of this review.' })\n  summary: string\n\n  @Field(type => [FigureQualityFinding], { description: 'Measured considerations for the author and assistant.' })\n  findings: FigureQualityFinding[]\n\n  @Field(type => Int, { description: 'Visible material regions in the reproducible top-view evidence.' })\n  visualRegions: number\n\n  @Field({ description: 'Top-view footprint coverage from 0 to 1.' })\n  visualCoverage: number\n\n  @Field({ description: 'Normalized top-view readability evidence from 0 to 1.' })\n  visualReadability: number\n\n}\n\n/** 제한된 후보 품질 코드. 현재 요청의 참고 데이터이며 어떤 Figure에도 저장되지 않는다. */\n@InputType({ description: 'Measured review summary from an earlier candidate in this authoring session.' })\nexport class ProposalFeedbackQualityInput {\n  @Field({ nullable: true })\n  status?: string\n\n  @Field(type => [String], { nullable: true })\n  findingCodes?: string[]\n}\n\n/** 사람이 명시적으로 수락하거나 거절한 후보의 제한된 세션 반응. */\n@InputType({ description: 'Explicit author feedback for the next candidate. Session-only; never persisted.' })\nexport class ProposalFeedbackInput {\n  @Field()\n  outcome: string\n\n  @Field(type => Int)\n  selectedChanges: number\n\n  @Field(type => Int)\n  totalChanges: number\n\n  @Field({ nullable: true })\n  note?: string\n\n  @Field({ nullable: true })\n  grade?: string\n\n  @Field(type => ProposalFeedbackQualityInput, { nullable: true })\n  quality?: ProposalFeedbackQualityInput\n}\n\n/**\n * 저작 보조에 넘기는 것.\n *\n * ## 팔레트를 클라이언트가 보낸다\n *\n * 서버가 팔레트를 알 수 없다. 팔레트는 things-scene 이 갖고 있는데, 그 패키지의\n * node 조건은 transfer 번들로 가고 거기에는 `activePalette` 이 없다 [확인함].\n * 그리는 쪽이 어떤 토큰을 풀 수 있는지 아는 유일한 자리이므로 그쪽이 보낸다.\n *\n * **그래서 저장 문(`parseSource`)은 토큰을 검사하지 못한다.** `validate()` 도\n * 못 한다 — figure-model 이 형식은 갖고 있지만 색 어휘는 things-scene 에 있다.\n * 색 어휘가 형식의 일부라면 figure-model 이 갖는 것이 맞다. **figure-model 에 올릴 것.**\n */\n@InputType({ description: 'What to ask the authoring assistant for' })\nexport class ProposeRequest {\n  @Field({ description: 'What the author asked for, in their own words' })\n  prompt: string\n\n  @Field({ nullable: true, description: 'The figure source to revise, as JSON. Omit to create a new one.' })\n  base?: string\n\n  @Field({ nullable: true, description: 'Type name for a new figure. Ignored when base is given.' })\n  type?: string\n\n  /**\n   * 그림.\n   *\n   * 비율과 덩어리를 읽는 데 쓴다. 표면 무늬를 옮기는 데 쓰지 않는다 — 로우폴리는\n   * 텍스처가 0 인 것이 목표다.\n   */\n  @Field(type => GraphQLUpload, { nullable: true, description: 'Reference photo or render' })\n  image?: FileUpload\n\n  @Field(type => [String], { description: 'Palette tokens the client can resolve. Anything else is rejected.' })\n  palette: string[]\n\n  @Field({ nullable: true, description: 'Ask for one evidence-grounded refinement when the first valid candidate needs review.' })\n  refine?: boolean\n\n  @Field(type => [ProposalFeedbackInput], {\n    nullable: true,\n    description: 'Explicit session-only feedback on earlier candidates. It is constrained again before prompting and never stored.'\n  })\n  feedback?: ProposalFeedbackInput[]\n}\n\n/**\n * 후보 하나.\n *\n * **정본이 아니다.** 저작자가 보고 받아야 정본이 된다. 그래서 서버는 저장하지 않고\n * 돌려주기만 한다.\n */\n@ObjectType({ description: 'A figure the assistant proposes. Not saved — the author accepts or discards it.' })\nexport class FigureProposal {\n  @Field({ description: 'The proposed figure source, as JSON' })\n  source: string\n\n  @Field(type => Int, { description: 'Reuse score out of 100' })\n  score: number\n\n  @Field({ description: 'Grade from the score — A, B, C or D' })\n  grade: string\n\n  @Field(type => Int, { description: 'Triangles in one instance' })\n  triangles: number\n\n  @Field(type => Int, { description: 'Material groups — the draw calls one instance costs' })\n  groups: number\n\n  @Field(type => FigureQualityReview, {\n    description: 'Explainable design review. It advises the author and never saves or rejects the candidate.'\n  })\n  quality: FigureQualityReview\n\n  @Field(type => [FigureFinding], {\n    description: 'Policy violations. These do not block the proposal — the author decides.'\n  })\n  violations: FigureFinding[]\n\n  @Field(type => Int, { description: 'How many attempts the assistant needed. Diagnostic.' })\n  attempts: number\n}\n"]}

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

@@ -1,6 +1,7 @@
 import { costOf, scoreOf } from '@hatiolab/figure-model';
 import type { FigureSource } from '@hatiolab/figure-model';
 import type { AIImageMediaType } from '@things-factory/ai-client-base';
+import type { FigureQualityReview } from './figure-quality.js';
 export interface ProposeInput {
     /** 사람이 시킨 말. */
     prompt: string;
@@ -15,6 +16,27 @@ export interface ProposeInput {
     type?: string;
     /** 쓸 수 있는 팔레트 토큰. 여기 없는 토큰은 거절한다. */
     palette: string[];
+    /** Measurable concerns warrant one more candidate attempt; never writes a Figure. */
+    refine?: boolean;
+    /** Explicit, session-only author reactions to earlier candidates; never persisted. */
+    feedback?: unknown;
+}
+/**
+ * 후보 하나에 대한 저작자의 명시적 반응.
+ *
+ * 브라우저 문맥에서 온 참고 데이터다. 권한·저장·자동 변경의 근거가 될 수 없고, 다음 JSON 후보의
+ * 방향을 잡는 데만 쓴다. 경계에서 다시 정규화해 프롬프트를 길게 하거나 명령을 주입하지 못하게 한다.
+ */
+export interface ProposalFeedback {
+    outcome: 'accepted' | 'discarded';
+    selectedChanges: number;
+    totalChanges: number;
+    note?: string;
+    grade?: string;
+    quality?: {
+        status?: 'ready' | 'review';
+        findingCodes?: string[];
+    };
 }
 export interface ProposeResult {
     source: FigureSource;
@@ -22,6 +44,8 @@ export interface ProposeResult {
     score: ReturnType<typeof scoreOf>;
     /** 무게. */
     cost: ReturnType<typeof costOf>;
+    /** Explainable authoring review; JSON cannot certify visual aesthetics. */
+    quality: FigureQualityReview;
     /** 형식은 맞으나 정책을 넘은 것. 막지 않고 알린다. */
     violations: {
         code: string;
@@ -52,7 +76,7 @@ export declare function rulesPrompt(palette: string[]): string;
  * 던지는 것이 아니라 **사유를 모아 돌려준다** — 사유가 다음 시도의 입력이 되기
  * 때문이다. 사람에게 보여 줄 것과 모델에 돌려줄 것이 같은 글이다.
  */
-export declare function inspect(parsed: unknown, palette: string[]): {
+export declare function inspect(parsed: unknown, palette: string[], expectedType?: string): {
     source?: FigureSource;
     reasons: string[];
 };