@things-factory/figure-service 10.1.3 → 10.1.6

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

@@ -6,6 +6,8 @@ const typeorm_1 = require("typeorm");
 const type_graphql_1 = require("type-graphql");
 const shell_1 = require("@things-factory/shell");
 const figure_js_1 = require("./figure.js");
+const figure_history_js_1 = require("./figure-history.js");
+const figure_gate_js_1 = require("./figure-gate.js");
 const figure_type_js_1 = require("./figure-type.js");
 let FigureQuery = class FigureQuery {
     async figure(id, context) {
@@ -35,6 +37,52 @@ let FigureQuery = class FigureQuery {
      *
      * `state` 로 걸러지지 않는다 — `draft` 인 Figure 의 이름도 이미 점유된 것이다.
      */
+    /**
+     * 발행된 판들 — 최근 것부터.
+     *
+     * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧
+     * 「이 도형이 몇 번 약속되었나」다.
+     */
+    async figureVersions(id, context) {
+        const { domain } = context.state;
+        return await (0, shell_1.getRepository)(figure_history_js_1.FigureHistory).find({
+            where: { domain: { id: (0, typeorm_1.In)([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },
+            relations: ['updater'],
+            order: { version: 'DESC' },
+            take: 10
+        });
+    }
+    /**
+     * 지금 소비처가 쓰는 판.
+     *
+     * 도형의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,
+     * 그것을 이 자리가 답한다.
+     */
+    async figureReleased(id, context) {
+        const { domain } = context.state;
+        return await (0, shell_1.getRepository)(figure_history_js_1.FigureHistory).findOne({
+            where: { domain: { id: (0, typeorm_1.In)([domain.id, domain.parentId].filter(Boolean)) }, originalId: id },
+            order: { version: 'DESC' }
+        });
+    }
+    /**
+     * 발행해도 되나 — **누르기 전에** 묻는 자리.
+     *
+     * 판정은 `figure-gate.ts` 가 하고 이 자리는 정본을 꺼내 넘긴다. 같은 판정을 `releaseFigure` 도
+     * 부른다 — 화면이 물어 보고 통과했더라도 그 사이에 정본이 바뀌었을 수 있으므로, 막는 것은 언제나
+     * 뮤테이션이다. 이 질의는 **이유를 미리 보여 주기 위한 것**이고 허가증이 아니다.
+     */
+    async inspectFigure(id, context) {
+        const { domain } = context.state;
+        const figure = await (0, shell_1.getRepository)(figure_js_1.Figure).findOne({
+            where: { domain: { id: (0, typeorm_1.In)([domain.id, domain.parentId].filter(Boolean)) }, id },
+            select: { id: true, source: true }
+        });
+        if (!figure) {
+            throw new Error(`Figure ${id} 를 찾을 수 없다`);
+        }
+        return (0, figure_gate_js_1.inspectSource)(figure.source);
+    }
     async figureTypeNames(context) {
         const { domain } = context.state;
         const rows = await (0, shell_1.getRepository)(figure_js_1.Figure).find({
@@ -63,6 +111,33 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [shell_1.ListParam, Object]),
     tslib_1.__metadata("design:returntype", Promise)
 ], FigureQuery.prototype, "figures", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => [figure_history_js_1.FigureHistory], { description: 'Released versions of a figure, newest first.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureQuery.prototype, "figureVersions", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => figure_history_js_1.FigureHistory, { nullable: true, description: 'The most recently released version of a figure.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureQuery.prototype, "figureReleased", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)'),
+    (0, type_graphql_1.Query)(returns => figure_type_js_1.FigureInspection, { description: 'Whether a figure may be released, with the reasons.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FigureQuery.prototype, "inspectFigure", null);
 tslib_1.__decorate([
     (0, type_graphql_1.Directive)('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)'),
     (0, type_graphql_1.Query)(returns => [String], { description: 'All figure type names in scope — used to check name collisions before create.' }),

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'\n\nimport { Domain, getQueryBuilderFromListParams, getRepository, ListParam } from '@things-factory/shell'\n\nimport { Figure } from './figure.js'\nimport { 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      searchables: ['type', 'name', 'description', 'category']\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  @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"]}
+{"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'\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      searchables: ['type', 'name', 'description', 'category']\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"]}

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

@@ -0,0 +1,10 @@
+/** 시험·검증 하네스 전용 주입 시임. 운영 경로에서 호출 금지. */
+export declare function __setFigureToolDepsForTest(deps: any): void;
+/**
+ * 등록 — 부팅 시 1회.
+ *
+ * 범주가 하나다. twin 은 관찰과 생성을 둘로 갈랐는데(운영 협의에 생성 도구가 들려 있으면 대화의
+ * 성격이 흐려진다), figure 의 대화면은 저작면 하나뿐이고 그 자리에서 읽기와 후보 요청이 함께 필요하다.
+ * 대화면이 늘면 그때 가른다.
+ */
+export declare function registerFigureToolCategories(): void;

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

@@ -0,0 +1,304 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__setFigureToolDepsForTest = __setFigureToolDepsForTest;
+exports.registerFigureToolCategories = registerFigureToolCategories;
+/*
+ * figure 저작 도구를 어시스턴트 도구 레지스트리에 등록 — **대화면(도크)에서 저작을 돕기 위함.**
+ *
+ * 왜 필요한가: `proposeFigure` 는 한 번 시키고 한 번 받는다. 그것으로 되는 일이 있지만, 저작은
+ * 대개 「이걸 이렇게 고쳐 봐 → 무게가 얼마나 되나 → 발행은 되나」처럼 여러 차례 오간다. 그 대화를
+ * 하려면 어시스턴트가 **지금 무엇이 있는지 읽을 수 있어야** 한다. 읽지 못하면 매번 사람이 정본을
+ * 붙여 넣어야 하고, 그러면 대화가 아니다.
+ *
+ * 능력을 복제하지 않는다. figure-service 가 이미 가진 진입점(`inspectSource` · `proposeFigure` ·
+ * 조회)을 레지스트리에 투영한다.
+ *
+ * ── 전부 조회·제안 전용이다 ─────────────────────────────────────────────────
+ * 정본을 고치는 도구를 넣지 않는다. 형식의 설계가 그렇게 정해져 있다 — 어시스턴트는 **후보**를
+ * 내고, 받을지 버릴지는 저작자가 정한다(`figure-propose.ts`). 되돌릴 수 없는 조작이 대화면으로
+ * 새지 않으므로 전부 `kind: 'read'` 다.
+ *
+ * 저장은 저작면이 `updateFigure` 로 한다. 그 mutation 은 `figure:mutation` 이 지키고, 대화는
+ * `ai-assistant:mutation` 이 지킨다 — 서로 다른 질문이라 서로 다른 권한이 지킨다. figure 가 board
+ * 의 권한을 빌리지 않는다.
+ *
+ * ── 규율을 도구와 함께 보낸다 ───────────────────────────────────────────────
+ * 도구 목록만으로는 「언제 반드시 불러야 하는지」를 모른다. twin 이 그 공백에서 사고를 냈다 —
+ * 조치 요청에 도구를 부르지 않고 「제안해 두었습니다」라고만 답해, 사용자에게 **없는 버튼을 누르라고
+ * 안내했다.** figure 도 똑같은 자리가 있다: 후보 화면(「지금 / 후보」 두 칸)은 **도구 호출 결과에서만**
+ * 만들어진다. 문장으로는 아무 일도 일어나지 않는다.
+ *
+ * ── LLM 이 넘긴 id 를 믿지 않는다 ───────────────────────────────────────────
+ * 사람이 목록에서 고르는 길에서는 드러나지 않지만, 모델은 대화 내용에 이끌려 임의의 id 를 넘길 수
+ * 있다. 그래서 호출자 도메인 소속을 먼저 확인한다.
+ */
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+/*
+  서버 의존성은 lazy require 다. 등록은 부팅 초반에 평가되고 그때 typeorm DataSource 가 준비되지
+  않았을 수 있다(board-import · twin-ai 와 같은 정책).
+*/
+let _deps;
+function getDeps() {
+    if (!_deps) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const shell = require('@things-factory/shell');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const model = require('@hatiolab/figure-model');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const entity = require('./figure.js');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const gate = require('./figure-gate.js');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const propose = require('./figure-propose.js');
+        _deps = {
+            getRepository: shell.getRepository,
+            Figure: entity.Figure,
+            inspectSource: gate.inspectSource,
+            proposeFigure: propose.proposeFigure,
+            compile: model.compile,
+            costOf: model.costOf,
+            scoreOf: model.scoreOf
+        };
+    }
+    return _deps;
+}
+/** 시험·검증 하네스 전용 주입 시임. 운영 경로에서 호출 금지. */
+function __setFigureToolDepsForTest(deps) {
+    _deps = deps;
+}
+function requireDomainId(state) {
+    const id = state?.domain?.id;
+    if (!id) {
+        // 도메인을 모르면 무엇을 읽어도 남의 것일 수 있다. 조용히 넘기지 않는다.
+        throw new Error('domain context is missing — the figure tools cannot resolve tenant scope');
+    }
+    return id;
+}
+/**
+ * 이 도형이 호출자 도메인 것인가.
+ *
+ * 모델이 넘긴 id 를 그대로 쓰지 않는다. 없으면 못 찾았다고 말한다 — 「권한이 없다」와 구별해
+ * 알려 줄 것이 없다(다른 테넌트에 그 id 가 있다는 사실 자체가 알려 줄 것이 아니다).
+ */
+async function figureInDomain(figureId, domainId) {
+    const { getRepository, Figure } = getDeps();
+    const found = await getRepository(Figure).findOne({
+        where: { id: figureId, domain: { id: domainId } }
+    });
+    if (!found) {
+        throw new Error(`figure not found in this tenant: ${figureId}`);
+    }
+    return found;
+}
+/**
+ * 무엇을 고치라는 것인지 대화면 문맥에서 해소한다.
+ *
+ * 모델이 대상을 안 줬으면 **저작면이 지금 열고 있는 도형**이다. 사용자에게 식별자를 되묻지
+ * 않는다 — 화면에 그 도형이 떠 있는데 「어느 도형입니까」를 묻는 것은 문맥을 안 읽은 것이다.
+ */
+function figureIdFrom(args, host) {
+    const said = typeof args?.figureId === 'string' ? args.figureId.trim() : '';
+    if (said)
+        return said;
+    const open = typeof host?.figureId === 'string' ? host.figureId.trim() : '';
+    if (open)
+        return open;
+    throw new Error('figureId is required: this surface has no figure open to resolve it from');
+}
+const FIGURE_ID_ARG = {
+    figureId: {
+        type: 'string',
+        description: 'The figure to read. Omit to use the one open in the editor.'
+    }
+};
+/**
+ * 도구 넷.
+ *
+ * 목록 · 정본 · 발행 판정 · 후보. 저작 대화에서 실제로 묻는 것이 그 넷이다 — 「무엇이 있나」
+ * 「지금 어떻게 생겼나」 「발행이 왜 안 되나」 「이렇게 고쳐 봐」.
+ */
+function figureToolSpecs() {
+    return [
+        {
+            kind: 'read',
+            name: 'listFigures',
+            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: {} },
+            builder: async (_args, ctx) => {
+                const domainId = requireDomainId(ctx?.state);
+                const { getRepository, Figure } = getDeps();
+                const rows = await getRepository(Figure).find({
+                    where: { domain: { id: domainId } },
+                    order: { updatedAt: 'DESC' },
+                    take: 200
+                });
+                return {
+                    figures: rows.map((row) => ({
+                        id: row.id,
+                        type: row.type,
+                        name: row.name,
+                        state: row.state,
+                        score: row.score,
+                        triangles: row.triangles
+                    }))
+                };
+            }
+        },
+        {
+            kind: 'read',
+            name: 'getFigureSource',
+            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 — ' +
+                'revising without reading it means proposing against a guess.',
+            schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },
+            builder: async (args, ctx) => {
+                const domainId = requireDomainId(ctx?.state);
+                const figureId = figureIdFrom(args, ctx?.state?.host);
+                const row = await figureInDomain(figureId, domainId);
+                if (!row.source) {
+                    // 저장된 정본이 없는 상태가 실제로 있다(새로 만들고 저장 안 한 것). 지어내지 않는다.
+                    return { id: row.id, type: row.type, name: row.name, source: null, cost: null };
+                }
+                const { compile, costOf, scoreOf } = getDeps();
+                const source = JSON.parse(row.source);
+                const blueprint = compile(source);
+                return {
+                    id: row.id,
+                    type: row.type,
+                    name: row.name,
+                    state: row.state,
+                    source,
+                    cost: costOf(blueprint, 100),
+                    score: scoreOf(blueprint)
+                };
+            }
+        },
+        {
+            kind: 'read',
+            name: 'inspectFigure',
+            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.',
+            schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },
+            builder: async (args, ctx) => {
+                const domainId = requireDomainId(ctx?.state);
+                const figureId = figureIdFrom(args, ctx?.state?.host);
+                const row = await figureInDomain(figureId, domainId);
+                const { inspectSource } = getDeps();
+                return inspectSource(row.source);
+            }
+        },
+        {
+            kind: 'read',
+            name: 'proposeFigureCandidate',
+            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.',
+            schema: {
+                type: 'object',
+                properties: {
+                    prompt: {
+                        type: 'string',
+                        description: 'What to make or change, in the words the author used.'
+                    },
+                    figureId: {
+                        type: 'string',
+                        description: 'Revise this figure. Omit to revise the one open in the editor; pass null to create anew.'
+                    },
+                    type: {
+                        type: 'string',
+                        description: 'Type name for a new figure. Check listFigures first — it is a stored identifier.'
+                    },
+                    create: {
+                        type: 'boolean',
+                        description: 'True to create rather than revise, even with a figure open.'
+                    }
+                },
+                required: ['prompt']
+            },
+            builder: async (args, ctx) => {
+                const domainId = requireDomainId(ctx?.state);
+                const prompt = typeof args?.prompt === 'string' ? args.prompt.trim() : '';
+                if (!prompt)
+                    throw new Error('prompt is required: there is nothing to ask for');
+                /*
+                  고치는 것인지 만드는 것인지를 **문맥에서 정한다.** 열린 도형이 있으면 고치는 것이 기본이고,
+                  모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 도형을 덮어쓰는
+                  후보가 온다.
+                */
+                let base;
+                if (!args?.create) {
+                    const open = typeof args?.figureId === 'string' ? args.figureId : ctx?.state?.host?.figureId;
+                    if (typeof open === 'string' && open.trim()) {
+                        const row = await figureInDomain(open.trim(), domainId);
+                        if (row.source)
+                            base = JSON.parse(row.source);
+                    }
+                }
+                const palette = Array.isArray(ctx?.state?.host?.palette) ? ctx.state.host.palette : [];
+                if (palette.length === 0) {
+                    /*
+                      팔레트를 모르면 모델이 색을 지어내고, 그 후보는 그리는 시점에 `resolveToken` 이 던진다 —
+                      저장까지 되고 나서 화면에서 죽는다. 빈 목록으로 진행하지 않는다.
+                    */
+                    throw new Error('the palette is missing from the host context — the candidate would invent colours');
+                }
+                const { proposeFigure } = getDeps();
+                const result = await proposeFigure({
+                    prompt,
+                    palette,
+                    base,
+                    type: typeof args?.type === 'string' ? args.type : undefined
+                });
+                /*
+                  **`proposed: true` 가 카드를 만든다.** 이 표시가 없으면 후보는 도구 추적 안에 묻히고,
+                  화면에는 아무것도 생기지 않는다 — 그러면 모델이 「후보를 만들었습니다」라고 쓴 것이
+                  거짓말이 된다(사용자가 없는 단추를 찾는다).
+        
+                  `label`·`reason` 이 카드에 그려지는 두 줄이고, `args` 는 같은 제안을 두 번 세지 않기
+                  위한 열쇠의 일부다 — 같은 요청을 두 번 내면 카드가 하나로 접힌다.
+                */
+                return {
+                    proposed: true,
+                    label: base ? `${result.source.type} 고치기` : `${result.source.type} 만들기`,
+                    reason: `등급 ${result.score.grade} · 삼각형 ${result.cost.triangles} · ` +
+                        `한 도면 ${result.cost.at.drawCalls}회 · ${result.attempts}번에 만들었다`,
+                    args: { prompt, figureId: base ? figureIdFrom(args, ctx?.state?.host) : undefined },
+                    source: result.source,
+                    score: result.score,
+                    cost: result.cost,
+                    violations: result.violations,
+                    attempts: result.attempts
+                };
+            }
+        }
+    ];
+}
+/**
+ * 등록 — 부팅 시 1회.
+ *
+ * 범주가 하나다. twin 은 관찰과 생성을 둘로 갈랐는데(운영 협의에 생성 도구가 들려 있으면 대화의
+ * 성격이 흐려진다), figure 의 대화면은 저작면 하나뿐이고 그 자리에서 읽기와 후보 요청이 함께 필요하다.
+ * 대화면이 늘면 그때 가른다.
+ */
+function registerFigureToolCategories() {
+    const authoring = {
+        name: 'figure-authoring',
+        description: '저작 중인 Figure 의 정본·비용·발행 판정 조회와 후보 제안(저장 아님).',
+        guidance: [
+            '- **도형을 만들거나 고쳐 달라는 요청에는 반드시 `proposeFigureCandidate` 를 호출한다.**',
+            '  호출 없이 "후보를 만들었습니다" · "적용 버튼을 누르세요" 라고 쓰는 것은 **거짓이다** — 화면에 후보 칸이 생기지 않으므로 사용자는 존재하지 않는 버튼을 찾는다.',
+            '  후보 화면(「지금 / 후보」 두 칸)은 **도구 호출 결과에서만** 만들어진다. 문장으로는 아무 일도 일어나지 않는다.',
+            '- 정본을 직접 저장하지 않는다. 후보만 내고, 받을지 버릴지는 저작자가 화면에서 정한다.',
+            '- **고치라는 요청이면 먼저 `getFigureSource` 를 부른다.** 읽지 않고 고치면 짐작을 상대로 후보를 내게 되고, 부품 이름이 갈려 이미 배치된 보드의 바인딩이 끊긴다.',
+            '- 타입 이름을 지어내지 않는다 — `listFigures` 로 확인한다. **타입 이름은 저장되는 식별자**이고 보드가 그 이름으로 도형을 찾는다.',
+            '- 발행이 안 되는 이유를 물으면 `inspectFigure` 를 부른다. 판정 없이 "발행할 수 있습니다"라고 말하지 않는다.',
+            '  판정의 각 항목은 **왜 문제인지와 무엇을 바꾸면 되는지**를 함께 담고 있다. 그대로 전한다 — 요약하면 저작자가 어느 부품의 어느 축을 고칠지 다시 찾아야 한다.',
+            '- 무게·삼각형 수를 물으면 `getFigureSource` 의 `cost` 를 쓴다. 눈대중으로 세지 않는다.'
+        ].join('\n'),
+        specs: figureToolSpecs()
+    };
+    (0, ai_client_base_1.registerToolCategory)(authoring);
+}
+//# sourceMappingURL=figure-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-tools.js","sourceRoot":"","sources":["../../../server/service/figure/figure-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * figure 저작 도구를 어시스턴트 도구 레지스트리에 등록 — **대화면(도크)에서 저작을 돕기 위함.**\n *\n * 왜 필요한가: `proposeFigure` 는 한 번 시키고 한 번 받는다. 그것으로 되는 일이 있지만, 저작은\n * 대개 「이걸 이렇게 고쳐 봐 → 무게가 얼마나 되나 → 발행은 되나」처럼 여러 차례 오간다. 그 대화를\n * 하려면 어시스턴트가 **지금 무엇이 있는지 읽을 수 있어야** 한다. 읽지 못하면 매번 사람이 정본을\n * 붙여 넣어야 하고, 그러면 대화가 아니다.\n *\n * 능력을 복제하지 않는다. figure-service 가 이미 가진 진입점(`inspectSource` · `proposeFigure` ·\n * 조회)을 레지스트리에 투영한다.\n *\n * ── 전부 조회·제안 전용이다 ─────────────────────────────────────────────────\n * 정본을 고치는 도구를 넣지 않는다. 형식의 설계가 그렇게 정해져 있다 — 어시스턴트는 **후보**를\n * 내고, 받을지 버릴지는 저작자가 정한다(`figure-propose.ts`). 되돌릴 수 없는 조작이 대화면으로\n * 새지 않으므로 전부 `kind: 'read'` 다.\n *\n * 저장은 저작면이 `updateFigure` 로 한다. 그 mutation 은 `figure:mutation` 이 지키고, 대화는\n * `ai-assistant:mutation` 이 지킨다 — 서로 다른 질문이라 서로 다른 권한이 지킨다. figure 가 board\n * 의 권한을 빌리지 않는다.\n *\n * ── 규율을 도구와 함께 보낸다 ───────────────────────────────────────────────\n * 도구 목록만으로는 「언제 반드시 불러야 하는지」를 모른다. twin 이 그 공백에서 사고를 냈다 —\n * 조치 요청에 도구를 부르지 않고 「제안해 두었습니다」라고만 답해, 사용자에게 **없는 버튼을 누르라고\n * 안내했다.** figure 도 똑같은 자리가 있다: 후보 화면(「지금 / 후보」 두 칸)은 **도구 호출 결과에서만**\n * 만들어진다. 문장으로는 아무 일도 일어나지 않는다.\n *\n * ── LLM 이 넘긴 id 를 믿지 않는다 ───────────────────────────────────────────\n * 사람이 목록에서 고르는 길에서는 드러나지 않지만, 모델은 대화 내용에 이끌려 임의의 id 를 넘길 수\n * 있다. 그래서 호출자 도메인 소속을 먼저 확인한다.\n */\nimport { registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'\n\n/*\n  서버 의존성은 lazy require 다. 등록은 부팅 초반에 평가되고 그때 typeorm DataSource 가 준비되지\n  않았을 수 있다(board-import · twin-ai 와 같은 정책).\n*/\nlet _deps: any | undefined\n\nfunction getDeps(): any {\n  if (!_deps) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const shell = require('@things-factory/shell')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const model = require('@hatiolab/figure-model')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const entity = require('./figure.js')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const gate = require('./figure-gate.js')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const propose = require('./figure-propose.js')\n    _deps = {\n      getRepository: shell.getRepository,\n      Figure: entity.Figure,\n      inspectSource: gate.inspectSource,\n      proposeFigure: propose.proposeFigure,\n      compile: model.compile,\n      costOf: model.costOf,\n      scoreOf: model.scoreOf\n    }\n  }\n  return _deps\n}\n\n/** 시험·검증 하네스 전용 주입 시임. 운영 경로에서 호출 금지. */\nexport function __setFigureToolDepsForTest(deps: any): void {\n  _deps = deps\n}\n\nfunction requireDomainId(state: any): string {\n  const id = state?.domain?.id\n  if (!id) {\n    // 도메인을 모르면 무엇을 읽어도 남의 것일 수 있다. 조용히 넘기지 않는다.\n    throw new Error('domain context is missing — the figure tools cannot resolve tenant scope')\n  }\n  return id\n}\n\n/**\n * 이 도형이 호출자 도메인 것인가.\n *\n * 모델이 넘긴 id 를 그대로 쓰지 않는다. 없으면 못 찾았다고 말한다 — 「권한이 없다」와 구별해\n * 알려 줄 것이 없다(다른 테넌트에 그 id 가 있다는 사실 자체가 알려 줄 것이 아니다).\n */\nasync function figureInDomain(figureId: string, domainId: string): Promise<any> {\n  const { getRepository, Figure } = getDeps()\n  const found = await getRepository(Figure).findOne({\n    where: { id: figureId, domain: { id: domainId } }\n  })\n  if (!found) {\n    throw new Error(`figure not found in this tenant: ${figureId}`)\n  }\n  return found\n}\n\n/**\n * 무엇을 고치라는 것인지 대화면 문맥에서 해소한다.\n *\n * 모델이 대상을 안 줬으면 **저작면이 지금 열고 있는 도형**이다. 사용자에게 식별자를 되묻지\n * 않는다 — 화면에 그 도형이 떠 있는데 「어느 도형입니까」를 묻는 것은 문맥을 안 읽은 것이다.\n */\nfunction figureIdFrom(args: any, host: any): string {\n  const said = typeof args?.figureId === 'string' ? args.figureId.trim() : ''\n  if (said) return said\n\n  const open = typeof host?.figureId === 'string' ? host.figureId.trim() : ''\n  if (open) return open\n\n  throw new Error('figureId is required: this surface has no figure open to resolve it from')\n}\n\nconst FIGURE_ID_ARG = {\n  figureId: {\n    type: 'string',\n    description: 'The figure to read. Omit to use the one open in the editor.'\n  }\n} as const\n\n/**\n * 도구 넷.\n *\n * 목록 · 정본 · 발행 판정 · 후보. 저작 대화에서 실제로 묻는 것이 그 넷이다 — 「무엇이 있나」\n * 「지금 어떻게 생겼나」 「발행이 왜 안 되나」 「이렇게 고쳐 봐」.\n */\nfunction figureToolSpecs(): ToolSpec[] {\n  return [\n    {\n      kind: 'read',\n      name: 'listFigures',\n      description:\n        'Lists the figures in this tenant with their type names, states and part counts. ' +\n        'Call it before naming a type — type names are stored identifiers and must not be invented.',\n      schema: { type: 'object', properties: {} },\n      builder: async (_args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const { getRepository, Figure } = getDeps()\n        const rows = await getRepository(Figure).find({\n          where: { domain: { id: domainId } },\n          order: { updatedAt: 'DESC' },\n          take: 200\n        })\n        return {\n          figures: rows.map((row: any) => ({\n            id: row.id,\n            type: row.type,\n            name: row.name,\n            state: row.state,\n            score: row.score,\n            triangles: row.triangles\n          }))\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'getFigureSource',\n      description:\n        'Returns the canonical FigureSource of one figure, with its measured cost ' +\n        '(triangles, draw calls, how many fit on one board). Call it before proposing a revision — ' +\n        'revising without reading it means proposing against a guess.',\n      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const figureId = figureIdFrom(args, ctx?.state?.host)\n        const row = await figureInDomain(figureId, domainId)\n\n        if (!row.source) {\n          // 저장된 정본이 없는 상태가 실제로 있다(새로 만들고 저장 안 한 것). 지어내지 않는다.\n          return { id: row.id, type: row.type, name: row.name, source: null, cost: null }\n        }\n\n        const { compile, costOf, scoreOf } = getDeps()\n        const source = JSON.parse(row.source)\n        const blueprint = compile(source)\n\n        return {\n          id: row.id,\n          type: row.type,\n          name: row.name,\n          state: row.state,\n          source,\n          cost: costOf(blueprint, 100),\n          score: scoreOf(blueprint)\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'inspectFigure',\n      description:\n        'Says whether a figure may be released and, when it may not, what is wrong — each finding ' +\n        'carries why it is a problem and what to change. Call it when asked about releasing, or ' +\n        'when asked to fix a figure that will not release.',\n      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const figureId = figureIdFrom(args, ctx?.state?.host)\n        const row = await figureInDomain(figureId, domainId)\n\n        const { inspectSource } = getDeps()\n        return inspectSource(row.source)\n      }\n    },\n    {\n      kind: 'read',\n      name: 'proposeFigureCandidate',\n      description:\n        'Asks for a figure candidate from a description, optionally revising an existing one. ' +\n        'Returns the candidate with its score and cost. NOTHING IS SAVED — the author accepts or ' +\n        'discards it on screen. This is the only way a candidate reaches the screen.',\n      schema: {\n        type: 'object',\n        properties: {\n          prompt: {\n            type: 'string',\n            description: 'What to make or change, in the words the author used.'\n          },\n          figureId: {\n            type: 'string',\n            description: 'Revise this figure. Omit to revise the one open in the editor; pass null to create anew.'\n          },\n          type: {\n            type: 'string',\n            description: 'Type name for a new figure. Check listFigures first — it is a stored identifier.'\n          },\n          create: {\n            type: 'boolean',\n            description: 'True to create rather than revise, even with a figure open.'\n          }\n        },\n        required: ['prompt']\n      },\n      builder: async (args: any, ctx: any) => {\n        const domainId = requireDomainId(ctx?.state)\n        const prompt = typeof args?.prompt === 'string' ? args.prompt.trim() : ''\n        if (!prompt) throw new Error('prompt is required: there is nothing to ask for')\n\n        /*\n          고치는 것인지 만드는 것인지를 **문맥에서 정한다.** 열린 도형이 있으면 고치는 것이 기본이고,\n          모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 도형을 덮어쓰는\n          후보가 온다.\n        */\n        let base: unknown\n        if (!args?.create) {\n          const open = typeof args?.figureId === 'string' ? args.figureId : ctx?.state?.host?.figureId\n          if (typeof open === 'string' && open.trim()) {\n            const row = await figureInDomain(open.trim(), domainId)\n            if (row.source) base = JSON.parse(row.source)\n          }\n        }\n\n        const palette = Array.isArray(ctx?.state?.host?.palette) ? ctx.state.host.palette : []\n        if (palette.length === 0) {\n          /*\n            팔레트를 모르면 모델이 색을 지어내고, 그 후보는 그리는 시점에 `resolveToken` 이 던진다 —\n            저장까지 되고 나서 화면에서 죽는다. 빈 목록으로 진행하지 않는다.\n          */\n          throw new Error('the palette is missing from the host context — the candidate would invent colours')\n        }\n\n        const { proposeFigure } = getDeps()\n        const result = await proposeFigure({\n          prompt,\n          palette,\n          base,\n          type: typeof args?.type === 'string' ? args.type : undefined\n        })\n\n        /*\n          **`proposed: true` 가 카드를 만든다.** 이 표시가 없으면 후보는 도구 추적 안에 묻히고,\n          화면에는 아무것도 생기지 않는다 — 그러면 모델이 「후보를 만들었습니다」라고 쓴 것이\n          거짓말이 된다(사용자가 없는 단추를 찾는다).\n\n          `label`·`reason` 이 카드에 그려지는 두 줄이고, `args` 는 같은 제안을 두 번 세지 않기\n          위한 열쇠의 일부다 — 같은 요청을 두 번 내면 카드가 하나로 접힌다.\n        */\n        return {\n          proposed: true,\n          label: base ? `${result.source.type} 고치기` : `${result.source.type} 만들기`,\n          reason:\n            `등급 ${result.score.grade} · 삼각형 ${result.cost.triangles} · ` +\n            `한 도면 ${result.cost.at.drawCalls}회 · ${result.attempts}번에 만들었다`,\n          args: { prompt, figureId: base ? figureIdFrom(args, ctx?.state?.host) : undefined },\n          source: result.source,\n          score: result.score,\n          cost: result.cost,\n          violations: result.violations,\n          attempts: result.attempts\n        }\n      }\n    }\n  ] as ToolSpec[]\n}\n\n/**\n * 등록 — 부팅 시 1회.\n *\n * 범주가 하나다. twin 은 관찰과 생성을 둘로 갈랐는데(운영 협의에 생성 도구가 들려 있으면 대화의\n * 성격이 흐려진다), figure 의 대화면은 저작면 하나뿐이고 그 자리에서 읽기와 후보 요청이 함께 필요하다.\n * 대화면이 늘면 그때 가른다.\n */\nexport function registerFigureToolCategories(): void {\n  const authoring: ToolCategory = {\n    name: 'figure-authoring',\n    description: '저작 중인 Figure 의 정본·비용·발행 판정 조회와 후보 제안(저장 아님).',\n    guidance: [\n      '- **도형을 만들거나 고쳐 달라는 요청에는 반드시 `proposeFigureCandidate` 를 호출한다.**',\n      '  호출 없이 \"후보를 만들었습니다\" · \"적용 버튼을 누르세요\" 라고 쓰는 것은 **거짓이다** — 화면에 후보 칸이 생기지 않으므로 사용자는 존재하지 않는 버튼을 찾는다.',\n      '  후보 화면(「지금 / 후보」 두 칸)은 **도구 호출 결과에서만** 만들어진다. 문장으로는 아무 일도 일어나지 않는다.',\n      '- 정본을 직접 저장하지 않는다. 후보만 내고, 받을지 버릴지는 저작자가 화면에서 정한다.',\n      '- **고치라는 요청이면 먼저 `getFigureSource` 를 부른다.** 읽지 않고 고치면 짐작을 상대로 후보를 내게 되고, 부품 이름이 갈려 이미 배치된 보드의 바인딩이 끊긴다.',\n      '- 타입 이름을 지어내지 않는다 — `listFigures` 로 확인한다. **타입 이름은 저장되는 식별자**이고 보드가 그 이름으로 도형을 찾는다.',\n      '- 발행이 안 되는 이유를 물으면 `inspectFigure` 를 부른다. 판정 없이 \"발행할 수 있습니다\"라고 말하지 않는다.',\n      '  판정의 각 항목은 **왜 문제인지와 무엇을 바꾸면 되는지**를 함께 담고 있다. 그대로 전한다 — 요약하면 저작자가 어느 부품의 어느 축을 고칠지 다시 찾아야 한다.',\n      '- 무게·삼각형 수를 물으면 `getFigureSource` 의 `cost` 를 쓴다. 눈대중으로 세지 않는다.'\n    ].join('\\n'),\n    specs: figureToolSpecs()\n  }\n\n  registerToolCategory(authoring)\n}\n"]}

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

@@ -27,7 +27,6 @@ export declare class FigurePatch {
     category?: string;
     source?: string;
     properties?: string;
-    state?: 'draft' | 'released';
     thumbnail?: string;
 }
 export declare class FigureList {
@@ -55,3 +54,28 @@ export declare class FigureSaveResult {
     figure: Figure;
     violations: FigureFinding[];
 }
+/**
+ * 발행 판정 한 줄.
+ *
+ * `FigureFinding` 과 칸이 겹치지만 **`blocking` 이 하나 더 있다.** 저장 쪽 발견은 정의상 막지 않는
+ * 것들이라 그 칸이 필요 없었다. 발행 판정은 막는 것과 알리는 것을 함께 내므로, 어느 쪽인지를 값이
+ * 스스로 말해야 한다 — 코드를 보고 화면이 다시 분류하면 규칙이 두 벌이 된다.
+ */
+export declare class FigureGateFinding {
+    code: string;
+    message: string;
+    why?: string;
+    how?: string;
+    at?: string;
+    blocking: boolean;
+}
+/**
+ * 발행 판정.
+ *
+ * 화면이 **발행을 누르기 전에** 물어보는 자리다. 눌러 보고 거절당하는 것으로 알게 되면, 무엇을
+ * 고쳐야 하는지 모른 채 단추만 두드리게 된다.
+ */
+export declare class FigureInspection {
+    blocked: boolean;
+    findings: FigureGateFinding[];
+}

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FigureSaveResult = exports.FigureFinding = exports.FigureList = exports.FigurePatch = exports.NewFigure = void 0;
+exports.FigureInspection = exports.FigureGateFinding = exports.FigureSaveResult = exports.FigureFinding = exports.FigureList = exports.FigurePatch = exports.NewFigure = void 0;
 const tslib_1 = require("tslib");
 const type_graphql_1 = require("type-graphql");
 const figure_js_1 = require("./figure.js");
@@ -77,10 +77,6 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)({ nullable: true, description: 'The new master-data field definition.' }),
     tslib_1.__metadata("design:type", String)
 ], FigurePatch.prototype, "properties", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true, description: 'The new lifecycle state.' }),
-    tslib_1.__metadata("design:type", String)
-], FigurePatch.prototype, "state", void 0);
 tslib_1.__decorate([
     (0, type_graphql_1.Field)({ nullable: true, description: 'A base64 encoded thumbnail image.' }),
     tslib_1.__metadata("design:type", String)
@@ -146,4 +142,61 @@ tslib_1.__decorate([
 exports.FigureSaveResult = FigureSaveResult = tslib_1.__decorate([
     (0, type_graphql_1.ObjectType)({ description: 'Result of saving a figure, carrying non-blocking violations.' })
 ], FigureSaveResult);
+/**
+ * 발행 판정 한 줄.
+ *
+ * `FigureFinding` 과 칸이 겹치지만 **`blocking` 이 하나 더 있다.** 저장 쪽 발견은 정의상 막지 않는
+ * 것들이라 그 칸이 필요 없었다. 발행 판정은 막는 것과 알리는 것을 함께 내므로, 어느 쪽인지를 값이
+ * 스스로 말해야 한다 — 코드를 보고 화면이 다시 분류하면 규칙이 두 벌이 된다.
+ */
+let FigureGateFinding = class FigureGateFinding {
+};
+exports.FigureGateFinding = FigureGateFinding;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Stable code — figure-model validation codes, or sizing-splits / sizing-loose.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureGateFinding.prototype, "code", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Human-readable message.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureGateFinding.prototype, "message", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Why this is a problem — what a person sees when it happens.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureGateFinding.prototype, "why", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What to change, naming the part and the value.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureGateFinding.prototype, "how", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Where it points: part names that came apart, or a path in the source.' }),
+    tslib_1.__metadata("design:type", String)
+], FigureGateFinding.prototype, "at", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'True when this finding blocks the release.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], FigureGateFinding.prototype, "blocking", void 0);
+exports.FigureGateFinding = FigureGateFinding = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'One finding from the release gate.' })
+], FigureGateFinding);
+/**
+ * 발행 판정.
+ *
+ * 화면이 **발행을 누르기 전에** 물어보는 자리다. 눌러 보고 거절당하는 것으로 알게 되면, 무엇을
+ * 고쳐야 하는지 모른 채 단추만 두드리게 된다.
+ */
+let FigureInspection = class FigureInspection {
+};
+exports.FigureInspection = FigureInspection;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'True when at least one finding blocks the release.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], FigureInspection.prototype, "blocked", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => [FigureGateFinding], { description: 'Findings, blocking and advisory together.' }),
+    tslib_1.__metadata("design:type", Array)
+], FigureInspection.prototype, "findings", void 0);
+exports.FigureInspection = FigureInspection = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'Whether a figure may be released, and why not.' })
+], FigureInspection);
 //# sourceMappingURL=figure-type.js.map