@things-factory/ai-assistant 10.1.221 → 10.1.223

package/dist-server/service/data-read/read-target.d.ts

@@ -30,6 +30,12 @@ export interface ReadColumn {
      * currencies are never added into one number.
      */
     currency?: string;
+    /**
+     * The i18n prefix that names this column's codes - `<words><code>` (`announcement.category.` reads `HR` as
+     * `announcement.category.HR`). The rows keep the code, so a filter or a card's match means the same in every
+     * language; the model is given the words (`legendOf`) and a table or chart shows them (`wordOf`).
+     */
+    words?: string;
 }
 export interface ReadScreen {
     /** A URL-bound grid accepts the same predicates used by readRows, including conditions outside its form. */
@@ -166,13 +172,29 @@ export declare function readCriteria(target: ReadTarget, args: any): {
 };
 export declare function filtersOf(target: ReadTarget, criteria: Record<string, unknown>): ReadFilter[];
 export declare const valueAt: (row: any, path: string) => any;
-/** One row as the columns say - a number column as a number, a missing value as null. */
-export declare function rowOf(target: Pick<ReadTarget, 'columns'>, item: any): Record<string, string | number | null>;
+/**
+ * A date column's moment as people read it - `YYYY-MM-DD HH:mm` in the domain's time zone. A day (`YYYY-MM-DD`) or
+ * month stays as it is; anything that is not a moment is left alone. Still ordered as text, so a card's comparison
+ * with a day keeps working.
+ */
+export declare function localDateTime(value: string, timeZone?: string): string;
+/** How the reader's words are asked - `(key, fallback)`, the fallback when the key has no word. */
+export type SayWord = (key: string | undefined, fallback: string) => string;
+/** The word a coded value is read as, in the reader's language - the value itself when its column has no words. */
+export declare function wordOf(column: Pick<ReadColumn, 'words'> | undefined, value: unknown, say: SayWord): unknown;
+/** The words of the coded values the rows hold, column by column - what the model reads the codes by. */
+export declare function legendOf(columns: readonly Pick<ReadColumn, 'name' | 'words'>[], rows: Record<string, any>[], say: SayWord): Record<string, Record<string, string>>;
+/** What shapes a row besides its columns - the domain's time zone, for a moment. */
+export type RowOptions = {
+    timeZone?: string;
+};
+/** One row as the columns say - a number column as a number, a moment in the domain's time zone, a missing value as null. */
+export declare function rowOf(target: Pick<ReadTarget, 'columns'>, item: any, options?: RowOptions): Record<string, string | number | null>;
 /**
  * Reads the rows through the application's query, page by page, up to MAX_READ_ROWS. `complete` is false when the
  * list holds more - a sum of the rows read is then not the sum of the list, and is never said as one.
  */
-export declare function readRows(target: ReadTarget, filters: ReadFilter[], run: GraphqlRunner, search?: string): Promise<{
+export declare function readRows(target: ReadTarget, filters: ReadFilter[], run: GraphqlRunner, search?: string, options?: RowOptions): Promise<{
     rows: Record<string, any>[];
     total: number;
     complete: boolean;

package/dist-server/service/data-read/read-target.js

@@ -10,6 +10,9 @@ exports.declareDetailRead = declareDetailRead;
 exports.detailReadOf = detailReadOf;
 exports.readCriteria = readCriteria;
 exports.filtersOf = filtersOf;
+exports.localDateTime = localDateTime;
+exports.wordOf = wordOf;
+exports.legendOf = legendOf;
 exports.rowOf = rowOf;
 exports.readRows = readRows;
 exports.sumsOf = sumsOf;
@@ -198,8 +201,50 @@ function filtersOf(target, criteria) {
 }
 const valueAt = (row, path) => path.split('.').reduce((at, part) => (at === null || at === undefined ? undefined : at[part]), row);
 exports.valueAt = valueAt;
-/** One row as the columns say - a number column as a number, a missing value as null. */
-function rowOf(target, item) {
+/**
+ * A date column's moment as people read it - `YYYY-MM-DD HH:mm` in the domain's time zone. A day (`YYYY-MM-DD`) or
+ * month stays as it is; anything that is not a moment is left alone. Still ordered as text, so a card's comparison
+ * with a day keeps working.
+ */
+function localDateTime(value, timeZone) {
+    if (!/^\d{4}-\d{2}-\d{2}T/.test(value))
+        return value;
+    const moment = new Date(value);
+    if (Number.isNaN(moment.getTime()))
+        return value;
+    try {
+        const parts = Object.fromEntries(new Intl.DateTimeFormat('en-CA', { timeZone: timeZone || undefined, year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', hourCycle: 'h23' })
+            .formatToParts(moment)
+            .map(part => [part.type, part.value]));
+        return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}`;
+    }
+    catch {
+        return value;
+    }
+}
+/** The word a coded value is read as, in the reader's language - the value itself when its column has no words. */
+function wordOf(column, value, say) {
+    if (!column?.words || value === null || value === undefined || value === '')
+        return value;
+    return say(`${column.words}${value}`, String(value));
+}
+/** The words of the coded values the rows hold, column by column - what the model reads the codes by. */
+function legendOf(columns, rows, say) {
+    const legend = {};
+    for (const column of columns) {
+        if (!column.words)
+            continue;
+        for (const row of rows) {
+            const code = row[column.name];
+            if (code === null || code === undefined || code === '')
+                continue;
+            (legend[column.name] ??= {})[String(code)] = String(wordOf(column, code, say));
+        }
+    }
+    return legend;
+}
+/** One row as the columns say - a number column as a number, a moment in the domain's time zone, a missing value as null. */
+function rowOf(target, item, options = {}) {
     return Object.fromEntries([
         /* The id names the record to the model - for one record's detail, a change, or its screen. */
         ...(item?.id ? [['id', String(item.id)]] : []),
@@ -211,7 +256,7 @@ function rowOf(target, item) {
                 const number = Number(raw);
                 return [column.name, Number.isFinite(number) ? number : null];
             }
-            return [column.name, String(raw)];
+            return [column.name, column.type === 'date' ? localDateTime(String(raw), options.timeZone) : String(raw)];
         })
     ]);
 }
@@ -219,7 +264,7 @@ function rowOf(target, item) {
  * Reads the rows through the application's query, page by page, up to MAX_READ_ROWS. `complete` is false when the
  * list holds more - a sum of the rows read is then not the sum of the list, and is never said as one.
  */
-async function readRows(target, filters, run, search) {
+async function readRows(target, filters, run, search, options = {}) {
     const rows = [];
     let total = 0;
     for (let page = 1; rows.length < exports.MAX_READ_ROWS; page++) {
@@ -234,7 +279,7 @@ async function readRows(target, filters, run, search) {
         const read = target.rowsOf(answer.data);
         total = Number(read?.total) || 0;
         const items = read?.rows ?? [];
-        rows.push(...items.slice(0, exports.MAX_READ_ROWS - rows.length).map(item => rowOf(target, item)));
+        rows.push(...items.slice(0, exports.MAX_READ_ROWS - rows.length).map(item => rowOf(target, item, options)));
         if (items.length < exports.READ_PAGE || rows.length >= total)
             break;
     }

package/dist-server/service/data-read/read-target.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-target.js","sourceRoot":"","sources":["../../../server/service/data-read/read-target.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * AI 조회 - an application's list, read through its own query as the person (operato-application/design/ai/read-targets.md).\n *\n * The application declares what it lets the assistant read: its list query, the conditions the model may set and\n * how each becomes one of the query's filters, the columns to show, and the screen that lists the same records.\n * The framework reads the rows through that query with the person's request state - the same @privilege and\n * domain as the screen - counts and sums them itself, and puts a long result on the AI 작업판 as the query returned\n * it. The model is told the count, the sums and a few rows; it never copies a table.\n *\n * Pure but for the GraphQL runner, which comes in as an argument - the rules are tested without a server.\n */\nimport { readFieldValue, recordIdOfKey, rootFieldOf, type EntryField } from '../data-entry/entry-target.js'\nimport { encodeListQuery } from '@operato/utils/list-query.js'\nimport type { GraphqlRunner } from '../data-entry/entry-update.js'\nimport { parse } from 'graphql'\n\nexport interface ReadFilter {\n  name: string\n  operator: string\n  value: unknown\n}\n\n/** A condition the model may set - read with the entry fields' rules, turned into the query's filters by the application. */\nexport interface ReadCriterion extends Omit<EntryField, 'required' | 'reference' | 'total'> {\n  filter: (value: any) => ReadFilter | ReadFilter[]\n  /** A string condition holding a month as YYYY-MM - a value of another shape is refused (`not-a-month`). */\n  format?: 'month'\n  /**\n   * The condition takes several values at once - its filter is given the list. Asked for the expenditure requests not\n   * approved, rejected or withdrawn, the model read the list once per status and stopped (2026-10-25).\n   */\n  many?: boolean\n}\n\nexport interface ReadColumn {\n  /** The key in the workspace table. */\n  name: string\n  /** Where the value is in a row - a dotted path into the query's item (`account.name`). Defaults to `name`. */\n  path?: string\n  type: 'string' | 'number' | 'date'\n  labelKey?: string\n  /** A number column the server sums. */\n  total?: boolean\n  /**\n   * The column that holds this amount's currency (ISO 4217, `KRW`). Its sums are kept per currency - amounts of two\n   * currencies are never added into one number.\n   */\n  currency?: string\n}\n\nexport interface ReadScreen {\n  /** A URL-bound grid accepts the same predicates used by readRows, including conditions outside its form. */\n  queryState?: boolean\n  /** The application's route of the list screen (`cash-transaction-list`). */\n  route: string\n  /** The conditions the screen takes, as its address's query arguments. A condition left out is said on the card. */\n  params: (criteria: Record<string, any>) => Record<string, string | number | undefined>\n  /** The conditions `params` carries - the card names the others as not applied on the screen. */\n  takes: string[]\n  labelKey?: string\n}\n\nexport interface ReadTarget {\n  /** `<app>.<record>` - the tools are named after it. */\n  key: string\n  /** i18n key naming the records (「은행 입출금」). */\n  labelKey?: string\n  /** What the records are, for the model. */\n  description: string\n  /**\n   * The list query - takes `$filters: [Filter!]`, `$pagination: Pagination` and `$sortings: [Sorting!]`, and\n   * `$search: String` when `search` is declared.\n   */\n  query: string\n  /**\n   * The list takes ListParam's free-text term, matched by the resolver across its own searchable fields - the\n   * condition `text`. Say what it finds in, for the model.\n   */\n  search?: { description: string }\n  criteria: ReadCriterion[]\n  /**\n   * Filters every read of this list applies - the records it is of (a book's confirmed lines, not its forecasts). Not\n   * a condition: the model neither sees nor sets them, so a read can narrow the list but never widen it.\n   */\n  fixedFilters?: ReadFilter[]\n  columns: ReadColumn[]\n  rowsOf: (data: any) => { rows: any[]; total: number }\n  /** Orders the rows; the query's own order when left out. */\n  sortings?: { name: string; desc?: boolean }[]\n  screen?: ReadScreen\n  /**\n   * The rows are the person's own, whoever reads them (내 지출결의) - the query answers for the one asking. A dashboard\n   * card of it shows each viewer their own rows and takes no filter on a person (ADR-0160).\n   */\n  mine?: boolean\n}\n\n/** At most this many rows are read - the AI 작업판 table's own limit (workspace-blocks MAX_TABLE_ROWS). */\nexport const MAX_READ_ROWS = 1000\n/** Rows the model is shown; the rest stay on the card. */\nexport const ROWS_FOR_MODEL = 20\n/** A page of the list query. */\nexport const READ_PAGE = 200\n\nconst registry = new Map<string, ReadTarget>()\n\nconst pascalOf = (key: string) =>\n  key\n    .split(/[^a-zA-Z0-9]+/)\n    .filter(Boolean)\n    .map(part => part[0].toUpperCase() + part.slice(1))\n    .join('')\n\nexport const queryToolName = (key: string) => `query${pascalOf(key)}`\nexport const screenToolName = (key: string) => `open${pascalOf(key)}Screen`\nexport const readCategoryName = (key: string) => `data-read:${key}`\n\n/** The columns of a list - shown, each named once, a currency only on a summed number and taken from a string column. */\nfunction checkColumns(of: string, columns: ReadColumn[]): void {\n  if (!columns.length) throw new Error(`read target '${of}' shows no column`)\n  const names = new Set<string>()\n  for (const column of columns) {\n    if (names.has(column.name)) throw new Error(`read target '${of}' names the column '${column.name}' twice`)\n    names.add(column.name)\n  }\n  for (const column of columns.filter(one => one.currency)) {\n    if (!column.total || column.type !== 'number') throw new Error(`column '${column.name}' of '${of}' names a currency but is not a summed number`)\n    if (columns.find(one => one.name === column.currency)?.type !== 'string') throw new Error(`column '${column.name}' of '${of}' takes its currency from '${column.currency}', which is no string column`)\n  }\n}\n\nexport function declareReadTarget(target: ReadTarget): void {\n  if (!/^[a-z0-9-]+\\.[a-z0-9-]+$/.test(target.key)) throw new Error(`read target key '${target.key}' is not <app>.<record>`)\n  if (registry.has(target.key) || details.has(target.key)) throw new Error(`read target '${target.key}' is declared twice`)\n  rootFieldOf(target.query, 'query')\n  checkColumns(target.key, target.columns)\n  const names = new Set<string>(['id'])\n  for (const criterion of target.criteria) {\n    if (criterion.name === 'id') throw new Error(`read target '${target.key}' declares 'id' - every target takes it`)\n    if (criterion.name === 'text' && target.search) throw new Error(`read target '${target.key}' declares 'text' and search - search is the text condition`)\n    if (names.has(criterion.name)) throw new Error(`read target '${target.key}' names the condition '${criterion.name}' twice`)\n    names.add(criterion.name)\n    if (criterion.type === 'enum' && !criterion.values?.length) throw new Error(`condition '${criterion.name}' of '${target.key}' lists no values`)\n  }\n  if (target.search) names.add('text')\n  for (const taken of target.screen?.takes ?? []) if (!names.has(taken)) throw new Error(`the screen of '${target.key}' takes '${taken}', which is no condition`)\n  registry.set(target.key, target)\n}\n\nexport function readTargetOf(key: string | undefined): ReadTarget | undefined {\n  return key ? registry.get(key) : undefined\n}\n\n/** Every list read target declared - what else reads the declarations (a dashboard card, ADR-0160) lists them by key. */\nexport function readTargetKeys(): string[] {\n  return [...registry.keys()]\n}\n\n/** Every detail read declared. */\nexport function detailReadKeys(): string[] {\n  return [...details.keys()]\n}\n\nexport function clearReadTargets(): void {\n  registry.clear()\n  details.clear()\n}\n\n/* ── One answer of a query ──────────────────────────────────────────────────────────────────────────────────── */\n\n/** An argument of a detail read - one variable of its query, read with the entry fields' rules. */\nexport interface DetailArg {\n  name: string\n  type: 'string' | 'integer' | 'number' | 'boolean' | 'date' | 'enum'\n  values?: string[]\n  description?: string\n  required?: boolean\n  /** A record's id: the axis (or axes) of the record, whose key `<axis>:<id>` the model may have been shown (EntryField.axis). */\n  axis?: string | readonly string[]\n  /** A string argument holding a month as YYYY-MM. */\n  format?: 'month'\n}\n\n/**\n * A query whose answer is one thing, not a list - a 360's summary, the receivables, a statement (design/ai/read-targets.md\n * §9). The application declares the query with the fields its screen reads; the framework runs it as the person, with\n * the arguments the model set, and hands the answer over as the query returned it. Nothing is summed or cut here: the\n * selection is the projection, and an answer too long to hand over is refused, never cut.\n */\nexport interface DetailRead {\n  /** `<app>.<thing>` - the tool is named after it. */\n  key: string\n  labelKey?: string\n  /** What it answers, for the model. */\n  description: string\n  /** One query with one root field. Its variables are the arguments - each declared in `args`. */\n  query: string\n  args?: DetailArg[]\n  /**\n   * The records the answer is about, whose screens put it in front (EntryTarget.axes) - the management check answers\n   * for any ledger record; asked on a deposit's 360 why it was in the check, the model never opened it (2026-10-24).\n   */\n  axes?: string[]\n  /**\n   * The lists the answer holds, each a table of typed columns - what a dashboard card may draw from a one-answer read\n   * (ADR-0160 decision 2). The card keeps only `key`; where the rows are and what their columns are is read here.\n   */\n  lists?: DetailList[]\n  /** The answer is the person's own, whoever asks (나의 전략 업무, 내 급여) - ReadTarget.mine. */\n  mine?: boolean\n}\n\n/** A list inside a detail read's answer. */\nexport interface DetailList {\n  /** A name stable within the read (`by-contract`) - what a card keeps. */\n  key: string\n  /** A dotted path inside the value of the query's root field (`rows`); '' when the root field is the list. */\n  at: string\n  labelKey?: string\n  /** What the rows are, for the model. */\n  description?: string\n  columns: ReadColumn[]\n}\n\n/** Characters of an answer handed to the model - a longer one is refused, and the model narrows it. */\nexport const MAX_DETAIL_CHARS = 60_000\n\nconst details = new Map<string, DetailRead>()\n\nexport const detailToolName = (key: string) => `read${pascalOf(key)}`\n\n/** The variables a query declares, and whether each is required (`!`). */\nfunction variablesOf(document: string): { name: string; required: boolean }[] {\n  const operation: any = parse(document).definitions.find((one: any) => one.kind === 'OperationDefinition')\n  return (operation?.variableDefinitions ?? []).map((one: any) => ({ name: one.variable.name.value, required: one.type.kind === 'NonNullType' && !one.defaultValue }))\n}\n\nexport function declareDetailRead(target: DetailRead): void {\n  if (!/^[a-z0-9-]+\\.[a-z0-9-]+$/.test(target.key)) throw new Error(`detail read key '${target.key}' is not <app>.<thing>`)\n  if (details.has(target.key) || registry.has(target.key)) throw new Error(`read target '${target.key}' is declared twice`)\n  rootFieldOf(target.query, 'query')\n  const args = target.args ?? []\n  for (const variable of variablesOf(target.query)) {\n    const arg = args.find(one => one.name === variable.name)\n    if (!arg) throw new Error(`detail read '${target.key}' takes $${variable.name}, which is no argument`)\n    if (variable.required && !arg.required) throw new Error(`detail read '${target.key}': $${variable.name} is required by the query - declare it required`)\n  }\n  for (const arg of args) {\n    if (!variablesOf(target.query).some(one => one.name === arg.name)) throw new Error(`detail read '${target.key}' declares '${arg.name}', which its query does not take`)\n    if (arg.type === 'enum' && !arg.values?.length) throw new Error(`argument '${arg.name}' of '${target.key}' lists no values`)\n  }\n  const lists = new Set<string>()\n  for (const list of target.lists ?? []) {\n    if (!/^[a-z0-9-]+$/.test(list.key)) throw new Error(`list '${list.key}' of '${target.key}' is not a lowercase key`)\n    if (lists.has(list.key)) throw new Error(`detail read '${target.key}' names the list '${list.key}' twice`)\n    lists.add(list.key)\n    if (!/^([A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)?$/.test(list.at)) throw new Error(`list '${list.key}' of '${target.key}' is at '${list.at}', which is no dotted path`)\n    checkColumns(`${target.key}/${list.key}`, list.columns)\n  }\n  details.set(target.key, target)\n}\n\nexport function detailReadOf(key: string | undefined): DetailRead | undefined {\n  return key ? details.get(key) : undefined\n}\n\n/** A month as a `month` condition holds it. */\nconst MONTH = /^\\d{4}-(0[1-9]|1[0-2])$/\n\n/** The conditions the model set, read by their declared types; a value that does not fit is said, never guessed at. */\nexport function readCriteria(target: ReadTarget, args: any): { criteria: Record<string, unknown>; refused: { name: string; code: string }[] } {\n  const criteria: Record<string, unknown> = {}\n  const refused: { name: string; code: string }[] = []\n  /* One record by its id - every target takes it (the id a list answer or a find tool gave, or the key `<axis>:<id>` an open record is shown by, the axis being the key's last part). */\n  if (typeof args?.id === 'string' && args.id.trim()) criteria.id = recordIdOfKey(target.key.split('.').pop()!, args.id) ?? args.id.trim()\n  if (target.search && typeof args?.text === 'string' && args.text.trim()) criteria.text = args.text.trim()\n  for (const criterion of target.criteria) {\n    const value = args?.[criterion.name]\n    if (value === undefined || value === null || value === '' || (Array.isArray(value) && !value.length)) continue\n    if (criterion.many && Array.isArray(value)) {\n      const each = value.map(one => readFieldValue(criterion as EntryField, one))\n      const wrong = each.find(one => one.read === undefined)\n      if (wrong) refused.push({ name: criterion.name, code: wrong.code ?? 'unreadable' })\n      else criteria[criterion.name] = [...new Set(each.map(one => one.read))]\n      continue\n    }\n    if (Array.isArray(value)) {\n      refused.push({ name: criterion.name, code: 'one-value' })\n      continue\n    }\n    const { read, code } = readFieldValue(criterion as EntryField, value)\n    if (read === undefined) refused.push({ name: criterion.name, code: code ?? 'unreadable' })\n    else if (criterion.format === 'month' && !MONTH.test(String(read))) refused.push({ name: criterion.name, code: 'not-a-month' })\n    else criteria[criterion.name] = read\n  }\n  return { criteria, refused }\n}\n\nexport function filtersOf(target: ReadTarget, criteria: Record<string, unknown>): ReadFilter[] {\n  return [\n    ...(typeof criteria.id === 'string' ? [{ name: 'id', operator: 'eq', value: criteria.id }] : []),\n    ...target.criteria.flatMap(criterion =>\n      criterion.name in criteria ? [criterion.filter(criteria[criterion.name])].flat() : []\n    )\n  ]\n}\n\nexport const valueAt = (row: any, path: string) => path.split('.').reduce((at, part) => (at === null || at === undefined ? undefined : at[part]), row)\n\n/** One row as the columns say - a number column as a number, a missing value as null. */\nexport function rowOf(target: Pick<ReadTarget, 'columns'>, item: any): Record<string, string | number | null> {\n  return Object.fromEntries([\n    /* The id names the record to the model - for one record's detail, a change, or its screen. */\n    ...(item?.id ? [['id', String(item.id)] as [string, string]] : []),\n    ...target.columns.map(column => {\n      const raw = valueAt(item, column.path ?? column.name)\n      if (raw === undefined || raw === null || raw === '') return [column.name, null]\n      if (column.type === 'number') {\n        const number = Number(raw)\n        return [column.name, Number.isFinite(number) ? number : null]\n      }\n      return [column.name, String(raw)]\n    })\n  ])\n}\n\n/**\n * Reads the rows through the application's query, page by page, up to MAX_READ_ROWS. `complete` is false when the\n * list holds more - a sum of the rows read is then not the sum of the list, and is never said as one.\n */\nexport async function readRows(target: ReadTarget, filters: ReadFilter[], run: GraphqlRunner, search?: string): Promise<{ rows: Record<string, any>[]; total: number; complete: boolean }> {\n  const rows: Record<string, any>[] = []\n  let total = 0\n  for (let page = 1; rows.length < MAX_READ_ROWS; page++) {\n    const answer = await run(target.query, {\n      filters: [...filters, ...(target.fixedFilters ?? [])],\n      ...(search ? { search } : {}),\n      pagination: { page, limit: READ_PAGE },\n      ...(target.sortings ? { sortings: target.sortings } : {})\n    })\n    if (answer.errors?.length) throw new Error(answer.errors.map(one => one.message).join('; '))\n    const read = target.rowsOf(answer.data)\n    total = Number(read?.total) || 0\n    const items = read?.rows ?? []\n    rows.push(...items.slice(0, MAX_READ_ROWS - rows.length).map(item => rowOf(target, item)))\n    if (items.length < READ_PAGE || rows.length >= total) break\n  }\n  return { rows, total, complete: rows.length >= total }\n}\n\n/** A column's sum - one number, or one per currency when the column names its currency (`{ KRW: 1000, USD: 100 }`). */\nexport type ReadSum = number | Record<string, number>\n\nexport interface ReadGroup {\n  key: string\n  count: number\n  sums: Record<string, ReadSum>\n}\n\n/** The currency a row without one is summed under - said as it is, never taken for the domain's own. */\nexport const UNKNOWN_CURRENCY = 'unknown'\n\nconst sumOf = (rows: Record<string, any>[], name: string) => Math.round(rows.reduce((sum, row) => sum + (typeof row[name] === 'number' ? row[name] : 0), 0) * 100) / 100\n\n/** The sums of the number columns marked total - the server's, never the model's; a column with a currency per currency. */\nexport function sumsOf(target: Pick<ReadTarget, 'columns'>, rows: Record<string, any>[]): Record<string, ReadSum> {\n  const sums: Record<string, ReadSum> = {}\n  for (const column of target.columns.filter(one => one.total && one.type === 'number')) {\n    if (!column.currency) {\n      sums[column.name] = sumOf(rows, column.name)\n      continue\n    }\n    const byCurrency = new Map<string, Record<string, any>[]>()\n    for (const row of rows) {\n      const code = typeof row[column.currency] === 'string' && row[column.currency] ? row[column.currency] : UNKNOWN_CURRENCY\n      byCurrency.set(code, [...(byCurrency.get(code) ?? []), row])\n    }\n    sums[column.name] = Object.fromEntries([...byCurrency].sort(([a], [b]) => a.localeCompare(b)).map(([code, members]) => [code, sumOf(members, column.name)]))\n  }\n  return sums\n}\n\n/** The currencies a set of sums holds for one column - none for a column summed as one number. */\nexport function currenciesOf(sums: Record<string, ReadSum>[], column: string): string[] {\n  const codes = new Set<string>()\n  for (const one of sums) if (one[column] && typeof one[column] === 'object') for (const code of Object.keys(one[column] as object)) codes.add(code)\n  return [...codes].sort()\n}\n\n/** The rows grouped by one column - a date column by its month - each with its count and sums, largest first. */\nexport function groupsOf(target: Pick<ReadTarget, 'columns'>, rows: Record<string, any>[], by: string): ReadGroup[] | undefined {\n  const column = target.columns.find(one => one.name === by)\n  if (!column) return undefined\n  const groups = new Map<string, Record<string, any>[]>()\n  for (const row of rows) {\n    const value = row[by]\n    const key = value === null || value === undefined ? '' : column.type === 'date' ? String(value).slice(0, 7) : String(value)\n    groups.set(key, [...(groups.get(key) ?? []), row])\n  }\n  const list = [...groups].map(([key, members]) => ({ key, count: members.length, sums: sumsOf(target, members) }))\n  if (column.type === 'date') return list.sort((a, b) => a.key.localeCompare(b.key))\n  /* Largest first by the first sum - in its one currency; groups in two currencies have no common size, so by count. */\n  const first = target.columns.find(one => one.total)?.name\n  const codes = first ? currenciesOf(list.map(group => group.sums), first) : []\n  const size = (group: ReadGroup) => {\n    const sum = first ? group.sums[first] : undefined\n    return typeof sum === 'number' ? Math.abs(sum) : codes.length === 1 && sum ? Math.abs(sum[codes[0]] ?? 0) : undefined\n  }\n  return list.sort((a, b) => {\n    const [x, y] = [size(a), size(b)]\n    return x !== undefined && y !== undefined && codes.length <= 1 ? y - x : b.count - a.count\n  })\n}\n\n/** The address of the target's list screen with the conditions it takes, and the conditions it does not. */\nexport function screenAddress(target: ReadTarget, criteria: Record<string, unknown>): { href: string; applied: string[]; notApplied: string[] } | undefined {\n  const screen = target.screen\n  if (!screen) return undefined\n  const params = new URLSearchParams()\n  for (const [name, value] of Object.entries(screen.params(criteria))) if (value !== undefined && value !== null && value !== '') params.set(name, String(value))\n  const given = Object.keys(criteria)\n  const applicable = Object.fromEntries(Object.entries(criteria).filter(([name]) => screen.takes.includes(name)))\n  const query = screen.queryState\n    ? encodeListQuery({\n        filters: filtersOf(target, applicable),\n        search: typeof applicable.text === 'string' ? applicable.text : undefined,\n        sorters: target.sortings\n      })\n    : params.toString()\n  return {\n    href: query ? `${screen.route}?${query}` : screen.route,\n    applied: given.filter(name => screen.takes.includes(name)),\n    notApplied: given.filter(name => !screen.takes.includes(name))\n  }\n}\n"]}
+{"version":3,"file":"read-target.js","sourceRoot":"","sources":["../../../server/service/data-read/read-target.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * AI 조회 - an application's list, read through its own query as the person (operato-application/design/ai/read-targets.md).\n *\n * The application declares what it lets the assistant read: its list query, the conditions the model may set and\n * how each becomes one of the query's filters, the columns to show, and the screen that lists the same records.\n * The framework reads the rows through that query with the person's request state - the same @privilege and\n * domain as the screen - counts and sums them itself, and puts a long result on the AI 작업판 as the query returned\n * it. The model is told the count, the sums and a few rows; it never copies a table.\n *\n * Pure but for the GraphQL runner, which comes in as an argument - the rules are tested without a server.\n */\nimport { readFieldValue, recordIdOfKey, rootFieldOf, type EntryField } from '../data-entry/entry-target.js'\nimport { encodeListQuery } from '@operato/utils/list-query.js'\nimport type { GraphqlRunner } from '../data-entry/entry-update.js'\nimport { parse } from 'graphql'\n\nexport interface ReadFilter {\n  name: string\n  operator: string\n  value: unknown\n}\n\n/** A condition the model may set - read with the entry fields' rules, turned into the query's filters by the application. */\nexport interface ReadCriterion extends Omit<EntryField, 'required' | 'reference' | 'total'> {\n  filter: (value: any) => ReadFilter | ReadFilter[]\n  /** A string condition holding a month as YYYY-MM - a value of another shape is refused (`not-a-month`). */\n  format?: 'month'\n  /**\n   * The condition takes several values at once - its filter is given the list. Asked for the expenditure requests not\n   * approved, rejected or withdrawn, the model read the list once per status and stopped (2026-10-25).\n   */\n  many?: boolean\n}\n\nexport interface ReadColumn {\n  /** The key in the workspace table. */\n  name: string\n  /** Where the value is in a row - a dotted path into the query's item (`account.name`). Defaults to `name`. */\n  path?: string\n  type: 'string' | 'number' | 'date'\n  labelKey?: string\n  /** A number column the server sums. */\n  total?: boolean\n  /**\n   * The column that holds this amount's currency (ISO 4217, `KRW`). Its sums are kept per currency - amounts of two\n   * currencies are never added into one number.\n   */\n  currency?: string\n  /**\n   * The i18n prefix that names this column's codes - `<words><code>` (`announcement.category.` reads `HR` as\n   * `announcement.category.HR`). The rows keep the code, so a filter or a card's match means the same in every\n   * language; the model is given the words (`legendOf`) and a table or chart shows them (`wordOf`).\n   */\n  words?: string\n}\n\nexport interface ReadScreen {\n  /** A URL-bound grid accepts the same predicates used by readRows, including conditions outside its form. */\n  queryState?: boolean\n  /** The application's route of the list screen (`cash-transaction-list`). */\n  route: string\n  /** The conditions the screen takes, as its address's query arguments. A condition left out is said on the card. */\n  params: (criteria: Record<string, any>) => Record<string, string | number | undefined>\n  /** The conditions `params` carries - the card names the others as not applied on the screen. */\n  takes: string[]\n  labelKey?: string\n}\n\nexport interface ReadTarget {\n  /** `<app>.<record>` - the tools are named after it. */\n  key: string\n  /** i18n key naming the records (「은행 입출금」). */\n  labelKey?: string\n  /** What the records are, for the model. */\n  description: string\n  /**\n   * The list query - takes `$filters: [Filter!]`, `$pagination: Pagination` and `$sortings: [Sorting!]`, and\n   * `$search: String` when `search` is declared.\n   */\n  query: string\n  /**\n   * The list takes ListParam's free-text term, matched by the resolver across its own searchable fields - the\n   * condition `text`. Say what it finds in, for the model.\n   */\n  search?: { description: string }\n  criteria: ReadCriterion[]\n  /**\n   * Filters every read of this list applies - the records it is of (a book's confirmed lines, not its forecasts). Not\n   * a condition: the model neither sees nor sets them, so a read can narrow the list but never widen it.\n   */\n  fixedFilters?: ReadFilter[]\n  columns: ReadColumn[]\n  rowsOf: (data: any) => { rows: any[]; total: number }\n  /** Orders the rows; the query's own order when left out. */\n  sortings?: { name: string; desc?: boolean }[]\n  screen?: ReadScreen\n  /**\n   * The rows are the person's own, whoever reads them (내 지출결의) - the query answers for the one asking. A dashboard\n   * card of it shows each viewer their own rows and takes no filter on a person (ADR-0160).\n   */\n  mine?: boolean\n}\n\n/** At most this many rows are read - the AI 작업판 table's own limit (workspace-blocks MAX_TABLE_ROWS). */\nexport const MAX_READ_ROWS = 1000\n/** Rows the model is shown; the rest stay on the card. */\nexport const ROWS_FOR_MODEL = 20\n/** A page of the list query. */\nexport const READ_PAGE = 200\n\nconst registry = new Map<string, ReadTarget>()\n\nconst pascalOf = (key: string) =>\n  key\n    .split(/[^a-zA-Z0-9]+/)\n    .filter(Boolean)\n    .map(part => part[0].toUpperCase() + part.slice(1))\n    .join('')\n\nexport const queryToolName = (key: string) => `query${pascalOf(key)}`\nexport const screenToolName = (key: string) => `open${pascalOf(key)}Screen`\nexport const readCategoryName = (key: string) => `data-read:${key}`\n\n/** The columns of a list - shown, each named once, a currency only on a summed number and taken from a string column. */\nfunction checkColumns(of: string, columns: ReadColumn[]): void {\n  if (!columns.length) throw new Error(`read target '${of}' shows no column`)\n  const names = new Set<string>()\n  for (const column of columns) {\n    if (names.has(column.name)) throw new Error(`read target '${of}' names the column '${column.name}' twice`)\n    names.add(column.name)\n  }\n  for (const column of columns.filter(one => one.currency)) {\n    if (!column.total || column.type !== 'number') throw new Error(`column '${column.name}' of '${of}' names a currency but is not a summed number`)\n    if (columns.find(one => one.name === column.currency)?.type !== 'string') throw new Error(`column '${column.name}' of '${of}' takes its currency from '${column.currency}', which is no string column`)\n  }\n}\n\nexport function declareReadTarget(target: ReadTarget): void {\n  if (!/^[a-z0-9-]+\\.[a-z0-9-]+$/.test(target.key)) throw new Error(`read target key '${target.key}' is not <app>.<record>`)\n  if (registry.has(target.key) || details.has(target.key)) throw new Error(`read target '${target.key}' is declared twice`)\n  rootFieldOf(target.query, 'query')\n  checkColumns(target.key, target.columns)\n  const names = new Set<string>(['id'])\n  for (const criterion of target.criteria) {\n    if (criterion.name === 'id') throw new Error(`read target '${target.key}' declares 'id' - every target takes it`)\n    if (criterion.name === 'text' && target.search) throw new Error(`read target '${target.key}' declares 'text' and search - search is the text condition`)\n    if (names.has(criterion.name)) throw new Error(`read target '${target.key}' names the condition '${criterion.name}' twice`)\n    names.add(criterion.name)\n    if (criterion.type === 'enum' && !criterion.values?.length) throw new Error(`condition '${criterion.name}' of '${target.key}' lists no values`)\n  }\n  if (target.search) names.add('text')\n  for (const taken of target.screen?.takes ?? []) if (!names.has(taken)) throw new Error(`the screen of '${target.key}' takes '${taken}', which is no condition`)\n  registry.set(target.key, target)\n}\n\nexport function readTargetOf(key: string | undefined): ReadTarget | undefined {\n  return key ? registry.get(key) : undefined\n}\n\n/** Every list read target declared - what else reads the declarations (a dashboard card, ADR-0160) lists them by key. */\nexport function readTargetKeys(): string[] {\n  return [...registry.keys()]\n}\n\n/** Every detail read declared. */\nexport function detailReadKeys(): string[] {\n  return [...details.keys()]\n}\n\nexport function clearReadTargets(): void {\n  registry.clear()\n  details.clear()\n}\n\n/* ── One answer of a query ──────────────────────────────────────────────────────────────────────────────────── */\n\n/** An argument of a detail read - one variable of its query, read with the entry fields' rules. */\nexport interface DetailArg {\n  name: string\n  type: 'string' | 'integer' | 'number' | 'boolean' | 'date' | 'enum'\n  values?: string[]\n  description?: string\n  required?: boolean\n  /** A record's id: the axis (or axes) of the record, whose key `<axis>:<id>` the model may have been shown (EntryField.axis). */\n  axis?: string | readonly string[]\n  /** A string argument holding a month as YYYY-MM. */\n  format?: 'month'\n}\n\n/**\n * A query whose answer is one thing, not a list - a 360's summary, the receivables, a statement (design/ai/read-targets.md\n * §9). The application declares the query with the fields its screen reads; the framework runs it as the person, with\n * the arguments the model set, and hands the answer over as the query returned it. Nothing is summed or cut here: the\n * selection is the projection, and an answer too long to hand over is refused, never cut.\n */\nexport interface DetailRead {\n  /** `<app>.<thing>` - the tool is named after it. */\n  key: string\n  labelKey?: string\n  /** What it answers, for the model. */\n  description: string\n  /** One query with one root field. Its variables are the arguments - each declared in `args`. */\n  query: string\n  args?: DetailArg[]\n  /**\n   * The records the answer is about, whose screens put it in front (EntryTarget.axes) - the management check answers\n   * for any ledger record; asked on a deposit's 360 why it was in the check, the model never opened it (2026-10-24).\n   */\n  axes?: string[]\n  /**\n   * The lists the answer holds, each a table of typed columns - what a dashboard card may draw from a one-answer read\n   * (ADR-0160 decision 2). The card keeps only `key`; where the rows are and what their columns are is read here.\n   */\n  lists?: DetailList[]\n  /** The answer is the person's own, whoever asks (나의 전략 업무, 내 급여) - ReadTarget.mine. */\n  mine?: boolean\n}\n\n/** A list inside a detail read's answer. */\nexport interface DetailList {\n  /** A name stable within the read (`by-contract`) - what a card keeps. */\n  key: string\n  /** A dotted path inside the value of the query's root field (`rows`); '' when the root field is the list. */\n  at: string\n  labelKey?: string\n  /** What the rows are, for the model. */\n  description?: string\n  columns: ReadColumn[]\n}\n\n/** Characters of an answer handed to the model - a longer one is refused, and the model narrows it. */\nexport const MAX_DETAIL_CHARS = 60_000\n\nconst details = new Map<string, DetailRead>()\n\nexport const detailToolName = (key: string) => `read${pascalOf(key)}`\n\n/** The variables a query declares, and whether each is required (`!`). */\nfunction variablesOf(document: string): { name: string; required: boolean }[] {\n  const operation: any = parse(document).definitions.find((one: any) => one.kind === 'OperationDefinition')\n  return (operation?.variableDefinitions ?? []).map((one: any) => ({ name: one.variable.name.value, required: one.type.kind === 'NonNullType' && !one.defaultValue }))\n}\n\nexport function declareDetailRead(target: DetailRead): void {\n  if (!/^[a-z0-9-]+\\.[a-z0-9-]+$/.test(target.key)) throw new Error(`detail read key '${target.key}' is not <app>.<thing>`)\n  if (details.has(target.key) || registry.has(target.key)) throw new Error(`read target '${target.key}' is declared twice`)\n  rootFieldOf(target.query, 'query')\n  const args = target.args ?? []\n  for (const variable of variablesOf(target.query)) {\n    const arg = args.find(one => one.name === variable.name)\n    if (!arg) throw new Error(`detail read '${target.key}' takes $${variable.name}, which is no argument`)\n    if (variable.required && !arg.required) throw new Error(`detail read '${target.key}': $${variable.name} is required by the query - declare it required`)\n  }\n  for (const arg of args) {\n    if (!variablesOf(target.query).some(one => one.name === arg.name)) throw new Error(`detail read '${target.key}' declares '${arg.name}', which its query does not take`)\n    if (arg.type === 'enum' && !arg.values?.length) throw new Error(`argument '${arg.name}' of '${target.key}' lists no values`)\n  }\n  const lists = new Set<string>()\n  for (const list of target.lists ?? []) {\n    if (!/^[a-z0-9-]+$/.test(list.key)) throw new Error(`list '${list.key}' of '${target.key}' is not a lowercase key`)\n    if (lists.has(list.key)) throw new Error(`detail read '${target.key}' names the list '${list.key}' twice`)\n    lists.add(list.key)\n    if (!/^([A-Za-z0-9_]+(\\.[A-Za-z0-9_]+)*)?$/.test(list.at)) throw new Error(`list '${list.key}' of '${target.key}' is at '${list.at}', which is no dotted path`)\n    checkColumns(`${target.key}/${list.key}`, list.columns)\n  }\n  details.set(target.key, target)\n}\n\nexport function detailReadOf(key: string | undefined): DetailRead | undefined {\n  return key ? details.get(key) : undefined\n}\n\n/** A month as a `month` condition holds it. */\nconst MONTH = /^\\d{4}-(0[1-9]|1[0-2])$/\n\n/** The conditions the model set, read by their declared types; a value that does not fit is said, never guessed at. */\nexport function readCriteria(target: ReadTarget, args: any): { criteria: Record<string, unknown>; refused: { name: string; code: string }[] } {\n  const criteria: Record<string, unknown> = {}\n  const refused: { name: string; code: string }[] = []\n  /* One record by its id - every target takes it (the id a list answer or a find tool gave, or the key `<axis>:<id>` an open record is shown by, the axis being the key's last part). */\n  if (typeof args?.id === 'string' && args.id.trim()) criteria.id = recordIdOfKey(target.key.split('.').pop()!, args.id) ?? args.id.trim()\n  if (target.search && typeof args?.text === 'string' && args.text.trim()) criteria.text = args.text.trim()\n  for (const criterion of target.criteria) {\n    const value = args?.[criterion.name]\n    if (value === undefined || value === null || value === '' || (Array.isArray(value) && !value.length)) continue\n    if (criterion.many && Array.isArray(value)) {\n      const each = value.map(one => readFieldValue(criterion as EntryField, one))\n      const wrong = each.find(one => one.read === undefined)\n      if (wrong) refused.push({ name: criterion.name, code: wrong.code ?? 'unreadable' })\n      else criteria[criterion.name] = [...new Set(each.map(one => one.read))]\n      continue\n    }\n    if (Array.isArray(value)) {\n      refused.push({ name: criterion.name, code: 'one-value' })\n      continue\n    }\n    const { read, code } = readFieldValue(criterion as EntryField, value)\n    if (read === undefined) refused.push({ name: criterion.name, code: code ?? 'unreadable' })\n    else if (criterion.format === 'month' && !MONTH.test(String(read))) refused.push({ name: criterion.name, code: 'not-a-month' })\n    else criteria[criterion.name] = read\n  }\n  return { criteria, refused }\n}\n\nexport function filtersOf(target: ReadTarget, criteria: Record<string, unknown>): ReadFilter[] {\n  return [\n    ...(typeof criteria.id === 'string' ? [{ name: 'id', operator: 'eq', value: criteria.id }] : []),\n    ...target.criteria.flatMap(criterion =>\n      criterion.name in criteria ? [criterion.filter(criteria[criterion.name])].flat() : []\n    )\n  ]\n}\n\nexport const valueAt = (row: any, path: string) => path.split('.').reduce((at, part) => (at === null || at === undefined ? undefined : at[part]), row)\n\n/**\n * A date column's moment as people read it - `YYYY-MM-DD HH:mm` in the domain's time zone. A day (`YYYY-MM-DD`) or\n * month stays as it is; anything that is not a moment is left alone. Still ordered as text, so a card's comparison\n * with a day keeps working.\n */\nexport function localDateTime(value: string, timeZone?: string): string {\n  if (!/^\\d{4}-\\d{2}-\\d{2}T/.test(value)) return value\n  const moment = new Date(value)\n  if (Number.isNaN(moment.getTime())) return value\n  try {\n    const parts = Object.fromEntries(\n      new Intl.DateTimeFormat('en-CA', { timeZone: timeZone || undefined, year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', hourCycle: 'h23' })\n        .formatToParts(moment)\n        .map(part => [part.type, part.value])\n    )\n    return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}`\n  } catch {\n    return value\n  }\n}\n\n/** How the reader's words are asked - `(key, fallback)`, the fallback when the key has no word. */\nexport type SayWord = (key: string | undefined, fallback: string) => string\n\n/** The word a coded value is read as, in the reader's language - the value itself when its column has no words. */\nexport function wordOf(column: Pick<ReadColumn, 'words'> | undefined, value: unknown, say: SayWord): unknown {\n  if (!column?.words || value === null || value === undefined || value === '') return value\n  return say(`${column.words}${value}`, String(value))\n}\n\n/** The words of the coded values the rows hold, column by column - what the model reads the codes by. */\nexport function legendOf(columns: readonly Pick<ReadColumn, 'name' | 'words'>[], rows: Record<string, any>[], say: SayWord): Record<string, Record<string, string>> {\n  const legend: Record<string, Record<string, string>> = {}\n  for (const column of columns) {\n    if (!column.words) continue\n    for (const row of rows) {\n      const code = row[column.name]\n      if (code === null || code === undefined || code === '') continue\n      ;(legend[column.name] ??= {})[String(code)] = String(wordOf(column, code, say))\n    }\n  }\n  return legend\n}\n\n/** What shapes a row besides its columns - the domain's time zone, for a moment. */\nexport type RowOptions = { timeZone?: string }\n\n/** One row as the columns say - a number column as a number, a moment in the domain's time zone, a missing value as null. */\nexport function rowOf(target: Pick<ReadTarget, 'columns'>, item: any, options: RowOptions = {}): Record<string, string | number | null> {\n  return Object.fromEntries([\n    /* The id names the record to the model - for one record's detail, a change, or its screen. */\n    ...(item?.id ? [['id', String(item.id)] as [string, string]] : []),\n    ...target.columns.map(column => {\n      const raw = valueAt(item, column.path ?? column.name)\n      if (raw === undefined || raw === null || raw === '') return [column.name, null]\n      if (column.type === 'number') {\n        const number = Number(raw)\n        return [column.name, Number.isFinite(number) ? number : null]\n      }\n      return [column.name, column.type === 'date' ? localDateTime(String(raw), options.timeZone) : String(raw)]\n    })\n  ])\n}\n\n/**\n * Reads the rows through the application's query, page by page, up to MAX_READ_ROWS. `complete` is false when the\n * list holds more - a sum of the rows read is then not the sum of the list, and is never said as one.\n */\nexport async function readRows(\n  target: ReadTarget,\n  filters: ReadFilter[],\n  run: GraphqlRunner,\n  search?: string,\n  options: RowOptions = {}\n): Promise<{ rows: Record<string, any>[]; total: number; complete: boolean }> {\n  const rows: Record<string, any>[] = []\n  let total = 0\n  for (let page = 1; rows.length < MAX_READ_ROWS; page++) {\n    const answer = await run(target.query, {\n      filters: [...filters, ...(target.fixedFilters ?? [])],\n      ...(search ? { search } : {}),\n      pagination: { page, limit: READ_PAGE },\n      ...(target.sortings ? { sortings: target.sortings } : {})\n    })\n    if (answer.errors?.length) throw new Error(answer.errors.map(one => one.message).join('; '))\n    const read = target.rowsOf(answer.data)\n    total = Number(read?.total) || 0\n    const items = read?.rows ?? []\n    rows.push(...items.slice(0, MAX_READ_ROWS - rows.length).map(item => rowOf(target, item, options)))\n    if (items.length < READ_PAGE || rows.length >= total) break\n  }\n  return { rows, total, complete: rows.length >= total }\n}\n\n/** A column's sum - one number, or one per currency when the column names its currency (`{ KRW: 1000, USD: 100 }`). */\nexport type ReadSum = number | Record<string, number>\n\nexport interface ReadGroup {\n  key: string\n  count: number\n  sums: Record<string, ReadSum>\n}\n\n/** The currency a row without one is summed under - said as it is, never taken for the domain's own. */\nexport const UNKNOWN_CURRENCY = 'unknown'\n\nconst sumOf = (rows: Record<string, any>[], name: string) => Math.round(rows.reduce((sum, row) => sum + (typeof row[name] === 'number' ? row[name] : 0), 0) * 100) / 100\n\n/** The sums of the number columns marked total - the server's, never the model's; a column with a currency per currency. */\nexport function sumsOf(target: Pick<ReadTarget, 'columns'>, rows: Record<string, any>[]): Record<string, ReadSum> {\n  const sums: Record<string, ReadSum> = {}\n  for (const column of target.columns.filter(one => one.total && one.type === 'number')) {\n    if (!column.currency) {\n      sums[column.name] = sumOf(rows, column.name)\n      continue\n    }\n    const byCurrency = new Map<string, Record<string, any>[]>()\n    for (const row of rows) {\n      const code = typeof row[column.currency] === 'string' && row[column.currency] ? row[column.currency] : UNKNOWN_CURRENCY\n      byCurrency.set(code, [...(byCurrency.get(code) ?? []), row])\n    }\n    sums[column.name] = Object.fromEntries([...byCurrency].sort(([a], [b]) => a.localeCompare(b)).map(([code, members]) => [code, sumOf(members, column.name)]))\n  }\n  return sums\n}\n\n/** The currencies a set of sums holds for one column - none for a column summed as one number. */\nexport function currenciesOf(sums: Record<string, ReadSum>[], column: string): string[] {\n  const codes = new Set<string>()\n  for (const one of sums) if (one[column] && typeof one[column] === 'object') for (const code of Object.keys(one[column] as object)) codes.add(code)\n  return [...codes].sort()\n}\n\n/** The rows grouped by one column - a date column by its month - each with its count and sums, largest first. */\nexport function groupsOf(target: Pick<ReadTarget, 'columns'>, rows: Record<string, any>[], by: string): ReadGroup[] | undefined {\n  const column = target.columns.find(one => one.name === by)\n  if (!column) return undefined\n  const groups = new Map<string, Record<string, any>[]>()\n  for (const row of rows) {\n    const value = row[by]\n    const key = value === null || value === undefined ? '' : column.type === 'date' ? String(value).slice(0, 7) : String(value)\n    groups.set(key, [...(groups.get(key) ?? []), row])\n  }\n  const list = [...groups].map(([key, members]) => ({ key, count: members.length, sums: sumsOf(target, members) }))\n  if (column.type === 'date') return list.sort((a, b) => a.key.localeCompare(b.key))\n  /* Largest first by the first sum - in its one currency; groups in two currencies have no common size, so by count. */\n  const first = target.columns.find(one => one.total)?.name\n  const codes = first ? currenciesOf(list.map(group => group.sums), first) : []\n  const size = (group: ReadGroup) => {\n    const sum = first ? group.sums[first] : undefined\n    return typeof sum === 'number' ? Math.abs(sum) : codes.length === 1 && sum ? Math.abs(sum[codes[0]] ?? 0) : undefined\n  }\n  return list.sort((a, b) => {\n    const [x, y] = [size(a), size(b)]\n    return x !== undefined && y !== undefined && codes.length <= 1 ? y - x : b.count - a.count\n  })\n}\n\n/** The address of the target's list screen with the conditions it takes, and the conditions it does not. */\nexport function screenAddress(target: ReadTarget, criteria: Record<string, unknown>): { href: string; applied: string[]; notApplied: string[] } | undefined {\n  const screen = target.screen\n  if (!screen) return undefined\n  const params = new URLSearchParams()\n  for (const [name, value] of Object.entries(screen.params(criteria))) if (value !== undefined && value !== null && value !== '') params.set(name, String(value))\n  const given = Object.keys(criteria)\n  const applicable = Object.fromEntries(Object.entries(criteria).filter(([name]) => screen.takes.includes(name)))\n  const query = screen.queryState\n    ? encodeListQuery({\n        filters: filtersOf(target, applicable),\n        search: typeof applicable.text === 'string' ? applicable.text : undefined,\n        sorters: target.sortings\n      })\n    : params.toString()\n  return {\n    href: query ? `${screen.route}?${query}` : screen.route,\n    applied: given.filter(name => screen.takes.includes(name)),\n    notApplied: given.filter(name => !screen.takes.includes(name))\n  }\n}\n"]}

package/dist-server/service/data-read/read-tools.d.ts

@@ -17,6 +17,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
 } | {
     record: any;
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     moreGroups?: number;
@@ -34,6 +36,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
 } | {
     record: any;
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     groupBy: any;
@@ -50,6 +54,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
 } | {
     record: any;
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     target: string;
@@ -63,6 +69,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
     refused?: undefined;
 } | {
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     moreGroups?: number;
@@ -79,6 +87,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
     refused?: undefined;
 } | {
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     groupBy: any;
@@ -94,6 +104,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
     refused?: undefined;
 } | {
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     target: string;
@@ -111,6 +123,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
         contents: Record<string, number>;
     };
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     moreGroups?: number;
@@ -135,6 +149,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
         contents: Record<string, number>;
     };
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     groupBy: any;
@@ -158,6 +174,8 @@ export declare function queryRecords(target: ReadTarget, args: any, context: any
         contents: Record<string, number>;
     };
     message: string;
+    legend?: Record<string, Record<string, string>>;
+    legendNote?: string;
     rowsNotShown?: number;
     rows: any;
     target: string;

package/dist-server/service/data-read/read-tools.js

@@ -50,7 +50,9 @@ async function queryRecords(target, args, context, run) {
     }
     let read;
     try {
-        read = await (0, read_target_js_1.readRows)(target, (0, read_target_js_1.filtersOf)(target, criteria), run, typeof criteria.text === 'string' && target.search ? criteria.text : undefined);
+        read = await (0, read_target_js_1.readRows)(target, (0, read_target_js_1.filtersOf)(target, criteria), run, typeof criteria.text === 'string' && target.search ? criteria.text : undefined, {
+            timeZone: context?.state?.domain?.timezone
+        });
     }
     catch (error) {
         return { rejected: true, error: 'query-failed', message: `the list could not be read: ${error?.message ?? error}` };
@@ -61,6 +63,8 @@ async function queryRecords(target, args, context, run) {
     const groups = groupBy ? (0, read_target_js_1.groupsOf)(target, rows, groupBy) : undefined;
     const words = wordsOf(context);
     const label = words(target.labelKey, target.key);
+    /* The rows keep their codes - a condition names them; the person is told the words (ADR-0163, 2026-10-26). */
+    const legend = (0, read_target_js_1.legendOf)(target.columns, rows, words);
     const said = {
         target: target.key,
         criteria,
@@ -70,7 +74,8 @@ async function queryRecords(target, args, context, run) {
         sums,
         ...(groupBy ? (groups ? { groupBy, groups: groups.slice(0, 50), ...(groups.length > 50 ? { moreGroups: groups.length - 50 } : {}) } : { groupBy, groupRefused: 'no such column' }) : {}),
         rows: rows.slice(0, read_target_js_1.ROWS_FOR_MODEL),
-        ...(rows.length > read_target_js_1.ROWS_FOR_MODEL ? { rowsNotShown: rows.length - read_target_js_1.ROWS_FOR_MODEL } : {})
+        ...(rows.length > read_target_js_1.ROWS_FOR_MODEL ? { rowsNotShown: rows.length - read_target_js_1.ROWS_FOR_MODEL } : {}),
+        ...(Object.keys(legend).length ? { legend, legendNote: 'a coded value is said by its word in legend, never by its code' } : {})
     };
     const incomplete = complete
         ? ''
@@ -83,6 +88,8 @@ async function queryRecords(target, args, context, run) {
     }
     /* The workspace is built here from the rows as read - the model never copies the table. */
     const columns = target.columns.map(column => ({ name: column.name, label: words(column.labelKey, column.name), type: column.type }));
+    const shownRows = rows.map(row => Object.fromEntries(Object.entries(row).map(([name, value]) => [name, (0, read_target_js_1.wordOf)(target.columns.find(one => one.name === name), value, words)])));
+    const groupColumn = target.columns.find(one => one.name === groupBy);
     const totalColumns = target.columns.filter(one => one.total);
     /* A sum per currency is one figure and one group column per currency it holds - 「계약금액 (USD)」. */
     const sumColumns = totalColumns.flatMap(column => {
@@ -108,11 +115,11 @@ async function queryRecords(target, args, context, run) {
                         kind: 'table',
                         caption: words(target.columns.find(one => one.name === groupBy)?.labelKey, groupBy),
                         columns: [{ name: 'key', label: words(target.columns.find(one => one.name === groupBy)?.labelKey, groupBy), type: 'string' }, { name: 'count', label: words('ai-assistant.read.count', 'rows'), type: 'number' }, ...sumColumns.map(column => ({ name: column.name, label: column.label, type: 'number' }))],
-                        rows: groups.map(group => ({ key: group.key, count: group.count, ...Object.fromEntries(sumColumns.map(column => [column.name, column.of(group.sums)])) }))
+                        rows: groups.map(group => ({ key: (0, read_target_js_1.wordOf)(groupColumn, group.key, words), count: group.count, ...Object.fromEntries(sumColumns.map(column => [column.name, column.of(group.sums)])) }))
                     }
                 ]
                 : []),
-            { kind: 'table', caption: label, columns, rows }
+            { kind: 'table', caption: label, columns, rows: shownRows }
         ]
     });
     return {