@things-factory/figure-service 10.1.167 → 10.1.169

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

@@ -35,7 +35,22 @@
  * 있다. 그래서 호출자 도메인 소속을 먼저 확인한다.
  */
 import { randomUUID } from 'crypto'
-import { aiClientFor, registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'
+import { ILike } from 'typeorm'
+import {
+  aiClientFor,
+  registerToolCategory,
+  type AIImageMediaType,
+  type ToolAttachment,
+  type ToolCallContext,
+  type ToolCategory,
+  type ToolImageAttachment,
+  type ToolSpec
+} from '@things-factory/ai-client-base'
+
+import { FIGURE_CONTEXT_BUDGET, figureViewOf, type FigureReadRequest } from './figure-context.js'
+
+/** How many figures a list without search names. */
+const LIST_LIMIT = 200
 
 /*
   서버 의존성은 lazy require 다. 등록은 부팅 초반에 평가되고 그때 typeorm DataSource 가 준비되지
@@ -101,17 +116,29 @@ async function figureInDomain(figureId: string, domainId: string): Promise<any>
   return found
 }
 
+/** The form of a creation id: the row id a new figure's first save inserts it under (`figure-mutation.ts`). */
+const CREATION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i
+
 /**
  * The figure a tool is about: by id, or by its type name, in the caller's domain. None named: none.
+ *
+ * A figure not saved yet is a subject too (ADR-0061 decision 3): the modeller names it by its creation id, which its first
+ * save inserts the row under (ADR-0072 decision 6), so before that save there is no row. It is the figure open on that
+ * screen and nothing else: the id the screen has open, with the draft the screen sent. What is read is that draft, put
+ * through the save's door like any draft (`sourceForTool`); nothing the server holds is read for it.
  */
-async function resolveFigureTarget(figureId: string | undefined, domainId: string, _host: any): Promise<any> {
+async function resolveFigureTarget(figureId: string | undefined, domainId: string, host: any): Promise<any> {
   if (!figureId) return undefined
   const { getRepository, Figure } = getDeps()
   const found =
     (await getRepository(Figure).findOne({ where: { id: figureId, domain: { id: domainId } } })) ??
     (await getRepository(Figure).findOne({ where: { type: figureId, domain: { id: domainId } } }))
-  if (!found) throw new Error(`figure not found in this tenant: ${figureId}`)
-  return found
+  if (found) return found
+  const draft = host?.draftSource
+  if (CREATION_ID.test(figureId) && host?.figureId === figureId && draft && typeof draft === 'object') {
+    return { id: figureId, name: typeof draft.name === 'string' ? draft.name : undefined, source: null }
+  }
+  throw new Error(`figure not found in this tenant: ${figureId}`)
 }
 
 /**
@@ -129,7 +156,7 @@ const isFigure = (source: any) => source?.version === 'figure-asset-1'
 function figureNotOpen() {
   return {
     error: 'FIGURE_NOT_OPEN',
-    message: '고치는 제안은 모델러에 열려 있는 도형에만 낼 수 있습니다.',
+    message: 'A revision can be proposed only for the figure open in the modeller.',
     nextStep:
       'Tell the person to open the figure in the modeller and ask again there. A new figure needs no open one: call proposeFigureCandidate with create: true.'
   }
@@ -141,7 +168,7 @@ function sourceForTool(row: any, host: any): { source: any; draft: boolean } {
 
   if (typeof draft !== 'object' || Array.isArray(draft)) throw new Error('the unsaved draft is not a figure asset')
   const serialized = JSON.stringify(draft)
-  if (serialized.length > 100_000) throw new Error('the unsaved draft is too large to safely review')
+  /* Validity is the save door's (the kernel's 1 MiB); how much the model is shown is `figure-context`'s. */
   try {
     getDeps().parseSource(serialized)
   } catch (e: any) {
@@ -151,6 +178,36 @@ function sourceForTool(row: any, host: any): { source: any; draft: boolean } {
   return { source: draft, draft: true }
 }
 
+/** The finite numbers of an untrusted record, by name; none: undefined. */
+function numbersOf(record: any): Record<string, number> | undefined {
+  if (!record || typeof record !== 'object' || Array.isArray(record)) return undefined
+  const kept = Object.entries(record).filter((entry): entry is [string, number] => typeof entry[1] === 'number' && Number.isFinite(entry[1]))
+  return kept.length ? Object.fromEntries(kept) : undefined
+}
+
+/**
+ * What the person has in view on the open draft: the part selected and what the preview is trying (ADR-0097 §5.6
+ * item 5). The model hears it only here, through a read (ADR-0061 decision 3). Told only when it was seen on the version
+ * being read -- a selection from another version may name a part that is gone -- and a part only when the draft has it.
+ */
+function focusOf(host: any, source: any): { selection?: { part: string }; trying?: { clips?: Record<string, number>; controls?: Record<string, number> } } {
+  const onThisVersion = (seen: any) => typeof host?.context === 'string' && seen?.context === host.context && seen?.revision === host.revision
+  const focus: ReturnType<typeof focusOf> = {}
+
+  const part = host?.selection?.part
+  const nodes = source?.document?.model?.nodes
+  if (typeof part === 'string' && onThisVersion(host.selection) && Array.isArray(nodes) && nodes.some((node: any) => node?.id === part)) {
+    focus.selection = { part }
+  }
+
+  if (onThisVersion(host?.trying)) {
+    const clips = numbersOf(host.trying.clips)
+    const controls = numbersOf(host.trying.controls)
+    if (clips || controls) focus.trying = { ...(clips ? { clips } : {}), ...(controls ? { controls } : {}) }
+  }
+  return focus
+}
+
 /**
  * 무엇을 고치라는 것인지 대화면 문맥에서 해소한다.
  *
@@ -170,7 +227,7 @@ function figureIdFrom(args: any, host: any): string | undefined {
 function missingFigureTarget() {
   return {
     error: 'FIGURE_TARGET_REQUIRED',
-    message: '현재 화면에는 선택된 도형이 없습니다.',
+    message: 'No figure is open on this screen.',
     nextStep: 'For an existing figure, call listFigures and match the user’s requested name or type; ask which figure only if ambiguous. For a new figure, call proposeFigureCandidate with create: true and the user’s prompt. Do not invent an id or repeat this call without a target.'
   }
 }
@@ -178,10 +235,63 @@ function missingFigureTarget() {
 const FIGURE_ID_ARG = {
   figureId: {
     type: 'string',
-    description: 'The figure to read. Omit to read the one the person has open, saved or not — the server fills it in, and you cannot see which it is. On the catalog nothing is open, so resolve the figure the person asked for with listFigures first.'
+    description: 'The figure to read. Omit to read the one open in the modeller — with its unsaved changes, and also when it is a new figure not saved yet; the server fills it in, and you cannot see which it is. A figure not saved yet is readable only while it is open in the modeller. On the catalog nothing is open, so resolve the figure the person asked for with listFigures first.'
   }
 } as const
 
+const PARTS_ARG = {
+  parts: {
+    type: 'array',
+    items: { type: 'string' },
+    description:
+      'Only for a figure too large to read whole (the answer then has `outline` and no `source`): the ids of the parts to read in full, from `outline.parts`. Omit to read the part selected.'
+  },
+  sections: {
+    type: 'array',
+    items: { type: 'string' },
+    description:
+      'Only for a figure too large to read whole: JSON Pointers of sections to read, such as one named in `outline.omitted` or its `entries` (for example /document/capabilities/bindings/0).'
+  }
+} as const
+
+/**
+ * A figure too large to show whole, as the model reads it (ADR-0061 2026-10-16 decision 4): its outline and the parts
+ * asked for. The full source stays here; what is measured is measured on it.
+ */
+function partialRead(source: any, request: FigureReadRequest) {
+  const view = figureViewOf(source, request)
+  if (view.whole) return { source }
+  return {
+    outline: view.outline,
+    partSources: view.parts,
+    ...(Object.keys(view.sections ?? {}).length ? { sectionSources: view.sections } : {}),
+    ...(view.notRead ? { notRead: view.notRead } : {}),
+    note:
+      `This figure is too large to read whole (${view.outline!.chars} characters; ${FIGURE_CONTEXT_BUDGET} are read at once), so this is its outline, the parts in partSources and the sections in sectionSources. ` +
+      'Read what a change touches with parts and sections, then pass the same to proposeFigureCandidate: only parts read in full may be changed, and nothing in a section in outline.omitted that was not read.'
+  }
+}
+
+/** The parts the model named, as strings; anything else is dropped. */
+const stringsOf = (list: unknown): string[] =>
+  Array.isArray(list) ? list.filter((one: unknown): one is string => typeof one === 'string' && !!one.trim()).map((one: string) => one.trim()) : []
+
+/** An inspection whose findings would crowd the model's context, cut to the budget with how many there were. */
+function findingsWithinBudget(inspection: any) {
+  const findings = Array.isArray(inspection?.findings) ? inspection.findings : []
+  if (JSON.stringify(inspection).length <= FIGURE_CONTEXT_BUDGET) return inspection
+  const head = JSON.stringify({ ...inspection, findings: [], truncated: { shown: findings.length, total: findings.length } }).length
+  let room = FIGURE_CONTEXT_BUDGET - head
+  const shown: any[] = []
+  for (const finding of findings) {
+    const cost = JSON.stringify(finding).length + 1
+    if (cost > room) break
+    shown.push(finding)
+    room -= cost
+  }
+  return { ...inspection, findings: shown, truncated: { shown: shown.length, total: findings.length } }
+}
+
 /**
  * 도구 넷.
  *
@@ -197,18 +307,40 @@ function figureToolSpecs(): ToolSpec[] {
       doors: ['Query.figures'],
       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: any, ctx: any) => {
+        'Call it before naming a type — type names are stored identifiers and must not be invented. ' +
+        `Without search it lists the ${LIST_LIMIT} most recently changed; when there are more it says truncated, and a figure the person names may be among the rest - list again with search.`,
+      schema: {
+        type: 'object',
+        properties: {
+          search: {
+            type: 'string',
+            description: 'Part of a figure name or type name, in any case. Omit to list the most recently changed.'
+          }
+        }
+      },
+      builder: async (args: any, ctx: any) => {
         const domainId = requireDomainId(ctx?.state)
         const { getRepository, Figure } = getDeps()
-        const rows = await getRepository(Figure).find({
-          where: { domain: { id: domainId } },
-          order: { updatedAt: 'DESC' },
-          take: 200
-        })
+        const search = typeof args?.search === 'string' ? args.search.trim() : ''
+        const domain = { id: domainId }
+        /* `_` and `%` in the words are LIKE wildcards: they can only widen what is found, never hide a match. */
+        const where = search
+          ? [
+              { domain, name: ILike(`%${search}%`) },
+              { domain, type: ILike(`%${search}%`) }
+            ]
+          : { domain }
+        /* One more than is shown, to know whether there is more without counting the table. */
+        const rows = await getRepository(Figure).find({ where, order: { updatedAt: 'DESC' }, take: LIST_LIMIT + 1 })
+        const truncated = rows.length > LIST_LIMIT
         return {
-          figures: rows.map((row: any) => ({
+          ...(truncated
+            ? {
+                truncated: true,
+                note: `Only the ${LIST_LIMIT} most recently changed are listed. A figure not here may still exist: call listFigures again with search.`
+              }
+            : {}),
+          figures: rows.slice(0, LIST_LIMIT).map((row: any) => ({
             id: row.id,
             type: row.type,
             name: row.name,
@@ -228,8 +360,12 @@ function figureToolSpecs(): ToolSpec[] {
       description:
         'Returns the source (the figure asset) of one figure, with its measured cost ' +
         '(triangles, part groups, and how many of it hold 60fps on one screen). Call it before proposing a revision — ' +
-        'revising without reading it means proposing against a guess.',
-      schema: { type: 'object', properties: { ...FIGURE_ID_ARG } },
+        'revising without reading it means proposing against a guess. On the figure open in the modeller it also says what ' +
+        'the person has in view: `selection.part` is the part selected - "this part" or "the selected one" means it - and ' +
+        '`trying` the clip and control values the preview is trying, which are not part of the figure. ' +
+        'A figure too large to read whole comes as `outline` (every part by name, shape and what it is fastened to) and ' +
+        '`partSources` (the parts read in full) instead of `source`.',
+      schema: { type: 'object', properties: { ...FIGURE_ID_ARG, ...PARTS_ARG } },
       builder: async (args: any, ctx: any) => {
         const domainId = requireDomainId(ctx?.state)
         const figureId = figureIdFrom(args, ctx?.host)
@@ -244,15 +380,19 @@ function figureToolSpecs(): ToolSpec[] {
 
         /* Measured as the catalogue measures it: triangles, draw groups, and its grade against one screen. */
         const { figureCostOf, figureScoreOf } = getDeps()
+        /* What is in view belongs to the draft on screen; the stored source may be another figure than the one open. */
+        const focus = current.draft ? focusOf(ctx?.host, current.source) : {}
+        const asked = stringsOf(args?.parts)
         return {
           id: row.id,
           type: row.type,
           name: row.name,
           state: row.state,
-          source: current.source,
+          ...partialRead(current.source, { parts: asked.length ? asked : focus.selection ? [focus.selection.part] : [], sections: stringsOf(args?.sections) }),
           draft: current.draft,
           cost: figureCostOf(current.source),
-          score: figureScoreOf(current.source) ?? null
+          score: figureScoreOf(current.source) ?? null,
+          ...focus
         }
       }
     },
@@ -274,7 +414,8 @@ function figureToolSpecs(): ToolSpec[] {
 
         const current = sourceForTool(row, ctx?.host)
         const { inspectSource } = getDeps()
-        return { ...inspectSource(current.source ? JSON.stringify(current.source) : null, null, undefined, row.type), draft: current.draft }
+        /* Inspected whole, here; only what the model is told is held to its budget. */
+        return { ...findingsWithinBudget(inspectSource(current.source ? JSON.stringify(current.source) : null, null, undefined, row.type)), draft: current.draft }
       }
     },
     {
@@ -304,11 +445,23 @@ function figureToolSpecs(): ToolSpec[] {
           create: {
             type: 'boolean',
             description: 'True to create rather than revise, even with a figure open.'
+          },
+          parts: {
+            type: 'array',
+            items: { type: 'string' },
+            description:
+              'Only for a figure too large to read whole: the parts this change touches, read first with getFigureSource parts. Only these and the part selected may be changed; new parts may be added and fastened to any part.'
+          },
+          sections: {
+            type: 'array',
+            items: { type: 'string' },
+            description:
+              'Only for a figure too large to read whole: JSON Pointers of the sections in outline.omitted this change touches, read first with getFigureSource sections. Nothing else in those sections may be changed.'
           }
         },
         required: ['prompt']
       },
-      builder: async (args: any, ctx: any) => {
+      builder: async (args: any, ctx: ToolCallContext) => {
         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')
@@ -325,6 +478,7 @@ function figureToolSpecs(): ToolSpec[] {
         const create = args?.create === true || args?.figureId === null
         let base: unknown
         let figureId: string | undefined
+        let focus: ReturnType<typeof focusOf> | undefined
         if (!create) {
           const said = typeof args?.figureId === 'string' ? args.figureId.trim() : ''
           const open = typeof host?.figureId === 'string' ? host.figureId.trim() : ''
@@ -335,19 +489,22 @@ function figureToolSpecs(): ToolSpec[] {
           if (!open) return missingFigureTarget()
           const row = await resolveFigureTarget(open, domainId, host)
           if (!row) return missingFigureTarget()
-          base = sourceForTool(row, host).source ?? undefined
+          const current = sourceForTool(row, host)
+          base = current.source ?? undefined
           if (!isFigure(base)) return figureNotOpen()
           if (typeof host?.context !== 'string' || !Number.isInteger(host?.revision)) return figureNotOpen()
           figureId = open
+          /* "Make this one bigger": the part selected is what the request points at. */
+          if (current.draft) focus = focusOf(host, base)
         }
 
-        let hostImage: { data: Buffer; mediaType: any } | undefined
-        const rawImage = host?.image || (Array.isArray(host?.attachments) ? host.attachments.find((a: any) => a?.mediaType?.startsWith('image/')) : undefined)
-        if (rawImage?.data) {
-          const rawData = typeof rawImage.data === 'string' ? rawImage.data.replace(/^data:image\/[a-zA-Z]+;base64,/, '') : rawImage.data
-          const buf = typeof rawData === 'string' ? Buffer.from(rawData, 'base64') : Buffer.from(rawData)
-          hostImage = { data: buf, mediaType: rawImage.mediaType || 'image/png' }
-        }
+        /*
+          The pictures the person sent with this turn, as the server checked them (ADR-0061, 2026-10-16 decision 2) --
+          every one, in the order attached. Never from the host context: the client fills it.
+        */
+        const images = (ctx?.attachments ?? [])
+          .filter((file: ToolAttachment): file is ToolImageAttachment => file.kind === 'image')
+          .map(file => ({ data: file.data, mediaType: file.mediaType as AIImageMediaType }))
 
         const { proposeFigureSteps } = getDeps()
         let result: any
@@ -363,7 +520,11 @@ function figureToolSpecs(): ToolSpec[] {
             prompt,
             base,
             name: typeof args?.name === 'string' && args.name.trim() ? args.name.trim() : undefined,
-            image: hostImage
+            ...(images.length ? { images } : {}),
+            ...(focus && Object.keys(focus).length ? { focus } : {}),
+            ...(!create && (stringsOf(args?.parts).length || stringsOf(args?.sections).length)
+              ? { read: { parts: stringsOf(args?.parts), sections: stringsOf(args?.sections) } }
+              : {})
           })
         } catch (error) {
           /*
@@ -382,6 +543,8 @@ function figureToolSpecs(): ToolSpec[] {
           목록을 한 단계로 적용한다. `args` 는 같은 제안을 두 번 세지 않기 위한 열쇠의 일부다.
         */
         const name = result.source.name || 'Figure'
+        /* The card is read by a person, so the server writes it in the request's language (ADR-0061, 2026-10-16 decision 1). */
+        const t = ctx.t
         return {
           proposed: true,
           /*
@@ -391,10 +554,16 @@ function figureToolSpecs(): ToolSpec[] {
           */
           key: randomUUID(),
           icon: 'view_in_ar',
-          label: create ? `${name} 만들기` : `${name} 고치기`,
-          reason:
-            `명령 ${result.steps.length}개 · 등급 ${result.score?.grade ?? '-'} · 삼각형 ${result.cost.triangles} · ` +
-            `${result.attempts}번에 만들었다`,
+          label: create
+            ? t('figure.proposal.label-create', { name, defaultValue: 'Make {name}' })
+            : t('figure.proposal.label-revise', { name, defaultValue: 'Revise {name}' }),
+          reason: t('figure.proposal.reason', {
+            steps: result.steps.length,
+            grade: result.score?.grade ?? '-',
+            triangles: result.cost.triangles,
+            attempts: result.attempts,
+            defaultValue: '{steps} commands · grade {grade} · {triangles} triangles · made in {attempts} tries'
+          }),
           args: { prompt, figureId, create },
           create,
           figureId,
@@ -420,21 +589,20 @@ function figureToolSpecs(): ToolSpec[] {
 export function registerFigureToolCategories(): void {
   const authoring: ToolCategory = {
     name: 'figure-authoring',
-    description: '저작 중인 Figure 의 정본·비용·발행 판정 조회와 후보 제안(저장 아님).',
+    description: 'Reads the source, cost and release verdict of the figure being authored, and proposes changes (nothing is saved).',
     guidance: [
-      '- **도형을 만들거나 고쳐 달라는 요청에는 반드시 `proposeFigureCandidate` 를 호출한다.**',
-      '  후보는 도구 호출 결과에서만 생긴다.',
-      '  호출 없이 "후보를 만들었습니다" · "적용 버튼을 누르세요" 라고 쓰는 것은 **거짓이다** — 화면에 후보 칸이 생기지 않으므로 사용자는 존재하지 않는 버튼을 찾는다.',
-      '  후보는 모델러 명령 목록이다. 도크 카드의 실행 단추를 눌러야 모델러에 한 단계로 적용되고, 되돌리기 한 번에 통째로 돌아간다. 적용 전에 이미 바뀌었다고 말하지 않는다.',
-      '  고치는 제안은 모델러에 열린 도형에만 낼 수 있다. 결과의 `steps` 가 무엇을 하는지 그대로 전한다 — 명령에 없는 변경을 지어내지 않는다.',
-      '- 정본을 직접 저장하지 않는다. 후보만 내고, 받을지 버릴지는 저작자가 화면에서 정한다.',
-      '- 좌표와 크기는 X/Y/Z 축 이름으로 정확하게 표시한다. 확인되지 않은 가로·세로·높이 의미를 임의로 붙이지 않는다.',
-      '- **고치라는 요청이면 먼저 `getFigureSource` 를 부른다.** 읽지 않고 고치면 짐작을 상대로 후보를 내게 되고, 부품 이름이 갈려 이미 배치된 보드의 바인딩이 끊긴다.',
-      '- 목록 화면에는 열린 도형이 없다. 기존 도형을 조회할 때는 `listFigures`에서 사용자가 말한 이름·타입의 id를 찾는다. 대상이 모호할 때만 어느 도형인지 묻는다. 기존 도형을 고치려면 모델러에서 그 도형을 열고 거기서 요청하도록 안내한다. 새 제작 요청에는 기존 정본을 조회하지 않고 `proposeFigureCandidate`를 create: true로 호출한다.',
-      '- 타입 이름을 지어내지 않는다 — `listFigures` 로 확인한다. **타입 이름은 저장되는 식별자**이고 보드가 그 이름으로 도형을 찾는다. 새 도형의 타입은 첫 저장 때 사람이 정한다.',
-      '- 발행이 안 되는 이유를 물으면 `inspectFigure` 를 부른다. 판정 없이 "발행할 수 있습니다"라고 말하지 않는다.',
-      '  판정의 각 항목은 **왜 문제인지와 무엇을 바꾸면 되는지**를 함께 담고 있다. 그대로 전한다 — 요약하면 저작자가 어느 부품의 어느 축을 고칠지 다시 찾아야 한다.',
-      '- 무게·삼각형 수를 물으면 `getFigureSource` 의 `cost` 를 쓴다. 눈대중으로 세지 않는다.'
+      '- **For a request to make or change a figure, always call `proposeFigureCandidate`.** A proposal exists only as the result of that call.',
+      '  Writing "I made a proposal" or "press apply" without the call is **false**: no card appears, and the person looks for a button that does not exist.',
+      '  A proposal is a list of modeller commands. The modeller applies it as one step only when the person runs it from the dock card, and one undo takes it all back. Do not say the figure has changed before that.',
+      '  A revision can be proposed only for the figure open in the modeller. Say what the result\'s `steps` do as they are; do not invent changes the commands do not make.',
+      '- Never save the source yourself. Propose; the author decides on the screen whether to take it.',
+      '- Name coordinates and sizes by their X/Y/Z axes. Do not attach width, depth or height meanings that have not been confirmed.',
+      '- **For a request to change a figure, call `getFigureSource` first.** Revising without reading proposes against a guess, and a renamed part breaks the bindings of the boards it is already placed on.',
+      '- On the catalog nothing is open. To read an existing figure, find the id of the name or type the person said with `listFigures`; ask which figure only when it is ambiguous. To revise an existing figure, tell the person to open it in the modeller and ask there. For a new figure, do not read existing sources: call `proposeFigureCandidate` with create: true.',
+      '- Do not invent type names; check them with `listFigures`. **A type name is a stored identifier**, and boards find the figure by it. A new figure\'s type is set by a person at its first save.',
+      '- When asked why a figure will not release, call `inspectFigure`. Do not say it can be released without its verdict.',
+      '  Each finding carries **why it is a problem and what to change**. Pass it on as it is; a summary makes the author look again for which axis of which part to fix.',
+      '- For weight or triangle counts, use `cost` from `getFigureSource`. Do not estimate.'
     ].join('\n'),
     specs: figureToolSpecs()
   }

package/translations/en.json

@@ -1,4 +1,5 @@
 {
+  "error.figure-proposal-failed": "The figure could not be made.",
   "error.figure-release-does-not-compile": "the released source of {type} (version {version}) does not compile. open it in the modeller, fix it and release it again before it draws on a board.",
   "figure.gate.occupancy-empty-axis.message": "The declared space is empty on {axis}.",
   "figure.gate.occupancy-undeclared.how": "Use \"fit to parts\" to declare the space from the parts as they are now.",
@@ -75,14 +76,12 @@
   "figure.gate.contract.public-input-range-narrowed.why": "An instance may have set a value outside the new range. Which values are placed is not recorded.",
   "figure.gate.contract.public-input-added.message": "'{input}' can now be set on a board.",
   "figure.gate.contract.public-input-added.why": "Placed instances that give no value stand at its default.",
-  "figure.gate.contract.carrier-gone.message": "The figure is no longer carrier type {type}.",
-  "figure.gate.contract.carrier-gone.why": "Live data names carriers by this code. After this release carriers of this type find no figure.",
-  "figure.gate.contract.carrier-type-changed.message": "The carrier type changed from {before} to {after}.",
-  "figure.gate.contract.carrier-type-changed.why": "Live data names carriers by this code. After this release carriers of the old type find no figure.",
-  "figure.gate.contract.carrier-dimensions-changed.message": "The carrier size changed from {before} to {after} mm.",
-  "figure.gate.contract.carrier-dimensions-changed.why": "Holders fit and stack carriers by this size. Where they stand and what fits is judged again once the map takes this release.",
-  "figure.gate.contract.carrier-added.message": "The figure is now carrier type {type}.",
-  "figure.gate.contract.carrier-added.why": "Live data with this code finds this figure once the type map takes this release.",
+  "figure.gate.contract.extension-gone.message": "The extension '{key}' is gone.",
+  "figure.gate.contract.extension-gone.why": "Another product reads this value by its key. After this release it finds none.",
+  "figure.gate.contract.extension-changed.message": "The value of the extension '{key}' changed.",
+  "figure.gate.contract.extension-changed.why": "The product that owns this key reads the new value and judges the change.",
+  "figure.gate.contract.extension-added.message": "The extension '{key}' is new.",
+  "figure.gate.contract.extension-added.why": "The product that owns this key reads this value.",
   "figure.gate.contract.joints-none": "nothing",
   "figure.gate.contract.state-input-joints-changed.message": "The control '{id}' moved {before}. It now moves {after}.",
   "figure.gate.contract.state-input-joints-changed.why": "A controller writes this value to drive those joints. After this release the same value moves other joints, or by other amounts.",
@@ -150,5 +149,8 @@
   "figure.gate.contract.slot-anchor-gone.message": "The anchor '{anchor}' that slots stand on is gone.",
   "figure.gate.contract.slot-anchor-gone.why": "A placement that lays its own slots on this anchor holds nothing after this release.",
   "figure.gate.contract.slot-anchor-moved.message": "The anchor '{anchor}' moved from the {before} face to the {after} face.",
-  "figure.gate.contract.slot-anchor-moved.why": "Every slot on it, and what sits there, stands on the new face after this release."
+  "figure.gate.contract.slot-anchor-moved.why": "Every slot on it, and what sits there, stands on the new face after this release.",
+  "figure.proposal.label-create": "Make {name}",
+  "figure.proposal.label-revise": "Revise {name}",
+  "figure.proposal.reason": "{steps} commands · grade {grade} · {triangles} triangles · made in {attempts} tries"
 }

package/translations/es.json

@@ -1,4 +1,5 @@
 {
+  "error.figure-proposal-failed": "No se pudo crear la figura.",
   "error.figure-release-does-not-compile": "el código fuente publicado de {type} (versión {version}) no compila. Ábralo en el modelador, corríjalo y vuelva a publicarlo para que se dibuje en un tablero.",
   "figure.gate.occupancy-empty-axis.message": "El espacio declarado está vacío en {axis}.",
   "figure.gate.occupancy-undeclared.how": "Use «ajustar a las piezas» para declarar el espacio a partir de las piezas tal como están ahora.",
@@ -75,14 +76,12 @@
   "figure.gate.contract.public-input-range-narrowed.why": "Puede que una instancia haya definido un valor fuera del nuevo rango. No se registra qué valores se colocaron.",
   "figure.gate.contract.public-input-added.message": "'{input}' ahora se puede definir en un tablero.",
   "figure.gate.contract.public-input-added.why": "Las instancias colocadas que no dan ningún valor quedan en su valor predeterminado.",
-  "figure.gate.contract.carrier-gone.message": "La figura ya no es del tipo de carrier {type}.",
-  "figure.gate.contract.carrier-gone.why": "Los datos en tiempo real identifican los carriers por este código. Tras esta publicación, los carriers de este tipo no encuentran ninguna figura.",
-  "figure.gate.contract.carrier-type-changed.message": "El tipo de carrier cambió de {before} a {after}.",
-  "figure.gate.contract.carrier-type-changed.why": "Los datos en tiempo real identifican los carriers por este código. Tras esta publicación, los carriers del tipo anterior no encuentran ninguna figura.",
-  "figure.gate.contract.carrier-dimensions-changed.message": "El tamaño del carrier cambió de {before} a {after} mm.",
-  "figure.gate.contract.carrier-dimensions-changed.why": "Los soportes alojan y apilan los carriers según este tamaño. Su posición y lo que cabe se vuelven a evaluar cuando el mapa adopte esta publicación.",
-  "figure.gate.contract.carrier-added.message": "La figura es ahora del tipo de carrier {type}.",
-  "figure.gate.contract.carrier-added.why": "Los datos en tiempo real con este código encuentran esta figura cuando el mapa de tipos adopte esta publicación.",
+  "figure.gate.contract.extension-gone.message": "La extensión '{key}' ya no está.",
+  "figure.gate.contract.extension-gone.why": "Otro producto lee este valor por su clave. Tras esta publicación no lo encuentra.",
+  "figure.gate.contract.extension-changed.message": "El valor de la extensión '{key}' cambió.",
+  "figure.gate.contract.extension-changed.why": "El producto dueño de esta clave lee el nuevo valor y juzga el cambio.",
+  "figure.gate.contract.extension-added.message": "La extensión '{key}' es nueva.",
+  "figure.gate.contract.extension-added.why": "El producto dueño de esta clave lee este valor.",
   "figure.gate.contract.joints-none": "ninguna",
   "figure.gate.contract.state-input-joints-changed.message": "El control '{id}' movía {before}. Ahora mueve {after}.",
   "figure.gate.contract.state-input-joints-changed.why": "Un controlador escribe este valor para accionar esas articulaciones. Tras esta publicación, el mismo valor mueve otras articulaciones, o en otra medida.",
@@ -150,5 +149,8 @@
   "figure.gate.contract.slot-anchor-gone.message": "El anclaje '{anchor}' sobre el que están las ranuras ya no existe.",
   "figure.gate.contract.slot-anchor-gone.why": "Una colocación que pone sus propias ranuras en este anclaje no contiene nada tras esta publicación.",
   "figure.gate.contract.slot-anchor-moved.message": "El anclaje '{anchor}' pasó de la cara {before} a la cara {after}.",
-  "figure.gate.contract.slot-anchor-moved.why": "Cada ranura sobre él, y lo que contiene, queda en la nueva cara tras esta publicación."
+  "figure.gate.contract.slot-anchor-moved.why": "Cada ranura sobre él, y lo que contiene, queda en la nueva cara tras esta publicación.",
+  "figure.proposal.label-create": "Crear {name}",
+  "figure.proposal.label-revise": "Corregir {name}",
+  "figure.proposal.reason": "{steps} comandos · grado {grade} · {triangles} triángulos · hecho en {attempts} intentos"
 }

package/translations/ja.json

@@ -1,4 +1,5 @@
 {
+  "error.figure-proposal-failed": "フィギュアを作成できませんでした。",
   "error.figure-release-does-not-compile": "{type} のリリース版(バージョン {version})のソースがコンパイルできません。モデラーで開いて修正し、もう一度リリースするとボードに表示されます。",
   "figure.gate.occupancy-empty-axis.message": "空間宣言の {axis} が空です。",
   "figure.gate.occupancy-undeclared.how": "「部品に合わせる」を使うと、現在の部品から空間を宣言します。",
@@ -75,14 +76,12 @@
   "figure.gate.contract.public-input-range-narrowed.why": "新しい範囲外の値を設定したインスタンスがある可能性があります。どの値が設定されたかは記録されていません。",
   "figure.gate.contract.public-input-added.message": "'{input}' をボードで設定できるようになりました。",
   "figure.gate.contract.public-input-added.why": "値を渡していない配置済みのインスタンスは既定値になります。",
-  "figure.gate.contract.carrier-gone.message": "この Figure は Carrier タイプ {type} ではなくなりました。",
-  "figure.gate.contract.carrier-gone.why": "リアルタイムデータはこのコードで Carrier を呼びます。このリリース以降、このタイプの Carrier は Figure を見つけられません。",
-  "figure.gate.contract.carrier-type-changed.message": "Carrier タイプが {before} から {after} に変わりました。",
-  "figure.gate.contract.carrier-type-changed.why": "リアルタイムデータはこのコードで Carrier を呼びます。このリリース以降、以前のタイプの Carrier は Figure を見つけられません。",
-  "figure.gate.contract.carrier-dimensions-changed.message": "Carrier の寸法が {before} から {after} mm に変わりました。",
-  "figure.gate.contract.carrier-dimensions-changed.why": "ホルダーはこの寸法で Carrier を置き、積み重ねます。タイプマップがこのリリースを採用すると、置き場所と収まるかどうかが改めて判定されます。",
-  "figure.gate.contract.carrier-added.message": "この Figure は Carrier タイプ {type} になりました。",
-  "figure.gate.contract.carrier-added.why": "タイプマップがこのリリースを採用すると、このコードのリアルタイムデータがこの Figure を見つけます。",
+  "figure.gate.contract.extension-gone.message": "拡張プロパティ '{key}' がなくなりました。",
+  "figure.gate.contract.extension-gone.why": "他の製品がこのキーで値を読みます。このリリース以降、値が見つかりません。",
+  "figure.gate.contract.extension-changed.message": "拡張プロパティ '{key}' の値が変わりました。",
+  "figure.gate.contract.extension-changed.why": "このキーを定めた製品が新しい値を読み、変更を判定します。",
+  "figure.gate.contract.extension-added.message": "拡張プロパティ '{key}' が追加されました。",
+  "figure.gate.contract.extension-added.why": "このキーを定めた製品がこの値を読みます。",
   "figure.gate.contract.joints-none": "なし",
   "figure.gate.contract.state-input-joints-changed.message": "'{id}' 操作値が動かす関節が {before} から {after} に変わりました。",
   "figure.gate.contract.state-input-joints-changed.why": "コントローラーはこの値を書いてそれらの関節を動かします。このリリース以降、同じ値で別の関節が動くか、別の量だけ動きます。",
@@ -150,5 +149,8 @@
   "figure.gate.contract.slot-anchor-gone.message": "スロットが立つ '{anchor}' 基準面がなくなりました。",
   "figure.gate.contract.slot-anchor-gone.why": "この基準面に独自のスロットを置いた配置は、このリリース以降何も保持できません。",
   "figure.gate.contract.slot-anchor-moved.message": "'{anchor}' 基準面が {before} 面から {after} 面に移りました。",
-  "figure.gate.contract.slot-anchor-moved.why": "その上のすべてのスロットと置かれたものは、このリリース以降新しい面に立ちます。"
+  "figure.gate.contract.slot-anchor-moved.why": "その上のすべてのスロットと置かれたものは、このリリース以降新しい面に立ちます。",
+  "figure.proposal.label-create": "{name} を作る",
+  "figure.proposal.label-revise": "{name} を直す",
+  "figure.proposal.reason": "コマンド {steps} 件 · 等級 {grade} · 三角形 {triangles} · {attempts} 回で作成"
 }

package/translations/ko.json

@@ -1,4 +1,5 @@
 {
+  "error.figure-proposal-failed": "도형을 만들지 못했습니다.",
   "error.figure-release-does-not-compile": "{type} 의 발행판({version})이 지금 컴파일되지 않습니다. 저작 화면에서 열어 수정한 후 다시 발행해야 보드에 나옵니다.",
   "figure.gate.occupancy-empty-axis.message": "공간 선언의 {axis} 가 비어 있습니다.",
   "figure.gate.occupancy-undeclared.how": "「부품에 맞추기」를 누르면 지금 부품으로 공간을 선언합니다.",
@@ -75,14 +76,12 @@
   "figure.gate.contract.public-input-range-narrowed.why": "새 범위 밖의 값을 준 인스턴스가 있을 수 있습니다. 어떤 값이 놓였는지는 기록하지 않습니다.",
   "figure.gate.contract.public-input-added.message": "'{input}' 값을 이제 보드에서 정할 수 있습니다.",
   "figure.gate.contract.public-input-added.why": "값이 지정되지 않은 인스턴스에는 기본값이 적용됩니다.",
-  "figure.gate.contract.carrier-gone.message": "이 Figure는 이제 Carrier 타입 {type}이 아닙니다.",
-  "figure.gate.contract.carrier-gone.why": "실시간 데이터는 이 코드로 Carrier를 부릅니다. 이 발행 뒤 이 타입의 Carrier는 Figure를 찾지 못합니다.",
-  "figure.gate.contract.carrier-type-changed.message": "Carrier 타입이 {before}에서 {after}로 바뀌었습니다.",
-  "figure.gate.contract.carrier-type-changed.why": "실시간 데이터는 이 코드로 Carrier를 부릅니다. 이 발행 뒤 예전 타입의 Carrier는 Figure를 찾지 못합니다.",
-  "figure.gate.contract.carrier-dimensions-changed.message": "Carrier 치수가 {before}에서 {after} mm로 바뀌었습니다.",
-  "figure.gate.contract.carrier-dimensions-changed.why": "홀더는 이 치수로 Carrier를 놓고 쌓습니다. 타입 맵이 이 발행본을 쓰면 자리와 적재 판정을 다시 합니다.",
-  "figure.gate.contract.carrier-added.message": "이 Figure는 이제 Carrier 타입 {type}입니다.",
-  "figure.gate.contract.carrier-added.why": "타입 맵이 이 발행본을 쓰면 이 코드의 실시간 데이터가 이 Figure를 찾습니다.",
+  "figure.gate.contract.extension-gone.message": "'{key}' 확장 속성이 없어졌습니다.",
+  "figure.gate.contract.extension-gone.why": "다른 제품이 이 키로 값을 읽습니다. 이 발행 뒤에는 값을 찾지 못합니다.",
+  "figure.gate.contract.extension-changed.message": "'{key}' 확장 속성의 값이 바뀌었습니다.",
+  "figure.gate.contract.extension-changed.why": "이 키를 정한 제품이 새 값을 읽고 바뀐 점을 판정합니다.",
+  "figure.gate.contract.extension-added.message": "'{key}' 확장 속성이 새로 생겼습니다.",
+  "figure.gate.contract.extension-added.why": "이 키를 정한 제품이 이 값을 읽습니다.",
   "figure.gate.contract.joints-none": "없음",
   "figure.gate.contract.state-input-joints-changed.message": "'{id}' 조작값이 움직이던 관절이 {before} 에서 {after} 로 바뀌었습니다.",
   "figure.gate.contract.state-input-joints-changed.why": "컨트롤러는 이 값을 써서 그 관절들을 움직입니다. 이 발행 뒤에는 같은 값이 다른 관절을 움직이거나 다른 양만큼 움직입니다.",
@@ -150,5 +149,8 @@
   "figure.gate.contract.slot-anchor-gone.message": "적재 위치의 '{anchor}' 기준면이 없어졌습니다.",
   "figure.gate.contract.slot-anchor-gone.why": "이 기준면을 사용하는 적재 위치는 발행 후 물품을 수용할 수 없습니다.",
   "figure.gate.contract.slot-anchor-moved.message": "'{anchor}' 기준면이 {before} 면에서 {after} 면으로 옮겨졌습니다.",
-  "figure.gate.contract.slot-anchor-moved.why": "발행 후 해당 기준면의 모든 슬롯과 배치된 항목이 새 기준면으로 이동합니다."
+  "figure.gate.contract.slot-anchor-moved.why": "발행 후 해당 기준면의 모든 슬롯과 배치된 항목이 새 기준면으로 이동합니다.",
+  "figure.proposal.label-create": "{name} 만들기",
+  "figure.proposal.label-revise": "{name} 고치기",
+  "figure.proposal.reason": "명령 {steps}개 · 등급 {grade} · 삼각형 {triangles} · {attempts}번에 만들었다"
 }