@stalfh233/omc-cli 0.0.0-stage → 0.4.0

package/dist/lanes/list-view.js

@@ -0,0 +1,578 @@
+import { z } from "zod";
+import { ENDPOINTS } from "../endpoints.js";
+import { capabilityArg, environmentArg } from "../args.js";
+import { governedRead } from "../read.js";
+import { writeTool } from "../write.js";
+import { encodeJsonColumn } from "../json-column.js";
+import { defineTool, ToolRefusalError } from "../tool-types.js";
+import { wireCall, wireRows, WireError } from "../wire.js";
+import { resolveModelTreeNode } from "./model.js";
+import { SYSTEM_FIELD_CODES } from "../field-families.js";
+import { LIST_VIEW_LANE_CONTRACT } from "./list-view-contract.js";
+import { assertListViewConfigureShape, decodeActionRow, decodeButtonRow, decodeConditionRow, decodeGantt, decodePresentation, decodeSortRow, listViewActionArg, listViewButtonArg, listViewConditionArg, listViewGanttArg, listViewMultiTableHeaderArg, listViewOptionsArg, listViewPresentationArg, listViewQueryLayerArg, listViewSortArg, mergeActions, PLATFORM_DEFAULT_LIST_ACTIONS, normalizeActions, normalizeButtons, normalizeConditions, normalizeGantt, normalizePresentation, normalizeSorts, parseConditionOptions, presentationTypeArg, readArray, resolveFieldRef, buttonsRenderCompat, columnsRenderCompat, } from "./list-view-shapes.js";
+// Ticket 53: every shape (enum/zod/encode/decode/lint) lives once in
+// ./list-view-shapes.ts and is re-exported for existing import paths.
+export { assertListViewConfigureShape } from "./list-view-shapes.js";
+const LIST_VIEW_LANE = LIST_VIEW_LANE_CONTRACT.lane;
+const LIST_VIEW_TOOLS = LIST_VIEW_LANE_CONTRACT.tools;
+function fieldOptions(options) {
+    if (typeof options === "string") {
+        try {
+            return JSON.parse(options);
+        }
+        catch {
+            return {};
+        }
+    }
+    return options && typeof options === "object" ? options : {};
+}
+/**
+ * QueryRuntimeController.parseNumber keys its formatting off displayFormat with
+ * no case 0 (valid values start at 1): 1=integer, 2=1dp, 3=2dp, 11=3dp,
+ * 12=4dp, 27..30=5..8dp; currency 7/15/16/31..34; percent 4/5/6/13/14.
+ */
+export function numericDisplayFormat(options) {
+    const opts = fieldOptions(options);
+    const format = String(opts.format ?? "decimal");
+    const scale = Number(opts.scale ?? 0) || 0;
+    const decimalByScale = { 0: 1, 1: 2, 2: 3, 3: 11, 4: 12, 5: 27, 6: 28, 7: 29, 8: 30 };
+    const currencyByScale = { 2: 7, 3: 15, 4: 16, 5: 31, 6: 32, 7: 33, 8: 34 };
+    const percentByScale = { 0: 4, 1: 5, 2: 6, 3: 13, 4: 14 };
+    if (format === "currency" || format === "rmb" || format === "¥")
+        return currencyByScale[scale] ?? 7;
+    if (format === "percent" || format === "percentage")
+        return percentByScale[scale] ?? 6;
+    if (format === "dollar" || format === "$")
+        return 8;
+    return decimalByScale[scale] ?? 3;
+}
+/** QueryRuntimeController.parseDate: 1=yyyy-MM-dd, 2=datetime, 3=minute, 4=yyyy-MM. */
+export function dateDisplayFormat(options) {
+    const format = String(fieldOptions(options).format ?? "YYYY-MM-DD");
+    if (/HH:mm:ss/i.test(format))
+        return 2;
+    if (/HH:mm$/i.test(format))
+        return 3;
+    if (/^YYYY-MM$/i.test(format))
+        return 4;
+    return 1;
+}
+function columnDisplayFormat(type, options) {
+    if (type === 2)
+        return numericDisplayFormat(options);
+    if (type === 3)
+        return dateDisplayFormat(options);
+    return null;
+}
+/**
+ * Ticket 75 — expand high-level button params (targetModel/targetForm/
+ * configureList) into the authoritative actionConfig shape from readback:
+ * - schemaCodeVal: the target model object (app-tree node id, app metadata,
+ *   published derived from the model having published fields — field.publish
+ *   publishes the whole schema);
+ * - formListData: the target default form (bizsheet/get; only sheetType 0
+ *   默认表单 binding has live evidence);
+ * - configureList: data assignments with the inline field-object copies
+ *   (array-wrapped, as captured) and the evidenced literals
+ *   isConst:"false" / OptionType:"Eq".
+ * Fails closed (listview-button-target-unresolved) BEFORE the query/update
+ * write when the model node, form, or any assignment field is not found.
+ */
+async function expandButtonActionConfigs(session, viewSchemaCode, buttons) {
+    const appRows = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data);
+    const appNameOf = (appCode) => {
+        const row = appRows.find((candidate) => String(candidate.appCode ?? candidate.code ?? "") === appCode);
+        return typeof row?.appName === "string" ? row.appName : "";
+    };
+    const publishedFieldsOf = async (schemaCode) => wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode, isPublish: "true" } })).data);
+    const expanded = [];
+    for (const button of buttons) {
+        // FLOW: the list runtime reads actionConfig.schemaCodeVal.code and
+        // actionConfig.WorkflowListData[0].workflowCode and ITERATES
+        // actionConfig.configureList (decompiled 8.6.34 7926.js case 17). Expand
+        // the high-level targetCode (workflow code) into that shape.
+        if (button.bindAction === "FLOW" && button.actionConfig === undefined && typeof button.targetCode === "string" && button.targetCode) {
+            expanded.push({
+                ...button,
+                actionConfig: {
+                    schemaCodeVal: { code: viewSchemaCode, value: viewSchemaCode },
+                    WorkflowListData: [{ workflowCode: button.targetCode }],
+                    configureList: [],
+                },
+            });
+            continue;
+        }
+        if (button.targetModel === undefined && button.targetForm === undefined && button.configureList === undefined) {
+            expanded.push(button);
+            continue;
+        }
+        const targetModel = button.targetModel ?? viewSchemaCode;
+        const unresolved = (what) => {
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "listview-button-target-unresolved",
+                schemaCode: viewSchemaCode,
+                targetModel,
+                message: `按钮目标解析失败（零副作用）：${what}。用 discover_environment / form.get 确认目标模型与默认表单存在并已发布后再配置。`,
+            });
+        };
+        // 1. Target model node (AppFunction id via the app trees — ticket 68 fact).
+        const resolvedNode = await resolveModelTreeNode(session, targetModel);
+        if (!resolvedNode.node)
+            unresolved(`模型 ${targetModel} 在任何应用树中都找不到节点`);
+        const node = resolvedNode.node;
+        const appCode = resolvedNode.applicationCode;
+        // 2. Published face of the target model (drives schemaCodeVal.published
+        //    and the configureList target-field inline copies).
+        const targetFieldRows = await publishedFieldsOf(targetModel);
+        if (targetFieldRows.length === 0)
+            unresolved(`模型 ${targetModel} 没有已发布字段（schemaCodeVal.published 无法为真）`);
+        const schemaCodeVal = {
+            code: targetModel,
+            id: node.id ?? null,
+            name: typeof node.name === "string" && node.name ? node.name : targetModel,
+            type: "BizModel",
+            appCode,
+            appName: appNameOf(appCode),
+            published: true,
+        };
+        // 3. Target default form (formListData; sheetType 0 默认表单 only — the
+        //    sole live-evidenced binding).
+        const formCode = button.targetForm ?? targetModel;
+        let sheet = null;
+        try {
+            sheet = ((await wireCall(session, { path: ENDPOINTS.sheetGet, query: { schemaCode: targetModel, sheetCode: formCode } })).data ?? null);
+        }
+        catch (error) {
+            if (!(error instanceof WireError && error.errcode === 302024))
+                throw error;
+        }
+        if (!sheet || !sheet.id)
+            unresolved(`模型 ${targetModel} 的表单 ${formCode} 不存在（formListData 无从展开）`);
+        const resolvedSheet = sheet;
+        if (resolvedSheet.sheetType !== undefined && resolvedSheet.sheetType !== null && Number(resolvedSheet.sheetType) !== 0)
+            unresolved(`表单 ${formCode} 的 sheetType=${String(resolvedSheet.sheetType)} 非默认表单——仅 sheetType 0（默认表单）绑定有 live 取证`);
+        const formListData = [
+            {
+                code: resolvedSheet.code ?? formCode,
+                schemaCode: targetModel,
+                id: resolvedSheet.id,
+                name: resolvedSheet.name ?? formCode,
+                sheetType: 0,
+                sheetTypeName: "默认表单",
+                published: resolvedSheet.published === true,
+            },
+        ];
+        // 4. configureList — inline field copies array-wrapped (captured shape).
+        const configureList = [];
+        if (button.configureList !== undefined) {
+            const sourceFieldRows = await publishedFieldsOf(viewSchemaCode);
+            for (const assignment of button.configureList) {
+                const sourceRow = sourceFieldRows.find((row) => String(row.code ?? row.propertyCode ?? "") === assignment.currentDataItemId);
+                if (!sourceRow)
+                    unresolved(`赋值源字段 ${viewSchemaCode}.${assignment.currentDataItemId} 不在发布面上`);
+                const targetRow = targetFieldRows.find((row) => String(row.code ?? row.propertyCode ?? "") === assignment.targetDataItemId);
+                if (!targetRow)
+                    unresolved(`赋值目标字段 ${targetModel}.${assignment.targetDataItemId} 不在发布面上`);
+                configureList.push({
+                    currentDataItemId: assignment.currentDataItemId,
+                    targetDataItemId: assignment.targetDataItemId,
+                    targetDataItem: [{ ...targetRow, schemaCode: targetModel }],
+                    currentDataItem: [{ ...sourceRow, schemaCode: viewSchemaCode }],
+                    isConst: "false",
+                    OptionType: "Eq",
+                });
+            }
+        }
+        const { targetModel: _tm, targetForm: _tf, configureList: _cl, ...rest } = button;
+        expanded.push({ ...rest, actionConfig: { schemaCodeVal, formListData, configureList } });
+    }
+    return expanded;
+}
+export function filterDefaultSystemColumns(columns, hideDefaultSystemFields) {
+    if (!hideDefaultSystemFields)
+        return [...columns];
+    return columns.filter((column) => typeof column.propertyCode !== "string" || !SYSTEM_FIELD_CODES.has(column.propertyCode));
+}
+export function registerListViewLane(tools) {
+    tools.push(defineTool({
+        name: "listview.get",
+        layer: "low",
+        kind: "read",
+        lane: LIST_VIEW_LANE,
+        scope: LIST_VIEW_TOOLS["listview.get"].scope,
+        description: LIST_VIEW_TOOLS["listview.get"].description,
+        inputSchema: {
+            environment: environmentArg,
+            schemaCode: z.string().min(1),
+            code: z.string().optional().describe("视图 code；省略时用默认视图（=schemaCode）"),
+            full: z.boolean().optional().describe("返回 query/get 原始报文（大体积）；默认返回列/排序/条件/动作/按钮的紧凑清单"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const code = args.code ?? args.schemaCode;
+            const got = await wireCall(session, { path: ENDPOINTS.listQueryGet, query: { schemaCode: args.schemaCode, code, clientType: "PC" } });
+            const model = (got.data ?? null);
+            if (model === null || !model.id)
+                return { schemaCode: args.schemaCode, code, present: false, note: "视图不存在（query/get 空或 302025）；先 listview.create 或 listview.configure" };
+            if (args.full === true)
+                return { schemaCode: args.schemaCode, code, present: true, data: model };
+            const columns = readArray(model, "queryColumns").map((column) => ({
+                propertyCode: column.propertyCode,
+                propertyType: column.propertyType,
+                displayFormat: column.displayFormat,
+                visible: column.visible,
+            }));
+            // Direction is decoded to the enum NAME (ASC/DESC) — the same shape
+            // `listview.configure` reads back, so a get→configure round-trip does not
+            // surprise the caller with a raw numeric index (dogfood R2 round17b).
+            const sorts = readArray(model, "querySorts")
+                .map(decodeSortRow)
+                .sort((a, b) => Number(a.sortKey ?? 0) - Number(b.sortKey ?? 0));
+            // Round 16 (bench67 feedback): `conditionCount` alone cannot verify a
+            // declared filter (e.g. "status != 已归档") — expose the decoded rows
+            // (same projector listview.configure reads back) so acceptance can see
+            // the property/operator/default the view actually carries.
+            const conditions = readArray(model, "queryConditions")
+                .map(decodeConditionRow)
+                .sort((a, b) => String(a.propertyCode ?? "").localeCompare(String(b.propertyCode ?? "")));
+            return {
+                schemaCode: args.schemaCode,
+                code,
+                present: true,
+                name: model.name ?? null,
+                published: model.published === true,
+                presentationType: model.queryPresentationType ?? null,
+                columnCount: columns.length,
+                columns,
+                sorts,
+                conditionCount: conditions.length,
+                conditions,
+                actionCodes: readArray(model, "queryActions").map((action) => action.actionCode).filter((value) => value !== undefined),
+                buttonCount: readArray(model, "customButtons").length,
+                options: model.options !== undefined && model.options !== null ? parseConditionOptions(model.options) : null,
+                // Round 16 (bench65 feedback): the query row's `published=false` is NOT
+                // an "inactive view" signal — a list view has no draft/publish
+                // lifecycle; this column is a design-time placeholder. The view is
+                // live as soon as it is saved. Say so, so the flag is not misread.
+                hint: "published 是设计态占位（列表视图无草稿/发布生命周期），false 不代表视图未生效；列/排序/条件/动作/按钮是否落成以 columns/sorts/conditionCount/actionCodes 与 field.list 为准。完整报文加 full:true。NUMERICAL 列的 displayFormat 是平台数值格式枚举（decimal scale2→3、currency→7、percent→6…），不是字段 scale；列的小数位以字段 options.scale 为准（用 field.list 读回）",
+            };
+        }),
+    }));
+    tools.push(defineTool({
+        name: "listview.list",
+        layer: "low",
+        kind: "read",
+        lane: LIST_VIEW_LANE,
+        scope: LIST_VIEW_TOOLS["listview.list"].scope,
+        description: LIST_VIEW_TOOLS["listview.list"].description,
+        inputSchema: { environment: environmentArg, schemaCode: z.string().min(1), capability: capabilityArg },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const rows = wireRows((await wireCall(session, { path: ENDPOINTS.listQueryList, query: { schemaCode: args.schemaCode, clientType: "PC" } })).data);
+            return {
+                schemaCode: args.schemaCode,
+                count: rows.length,
+                views: rows.map((row) => ({ code: row.code ?? null, name: row.name ?? null, type: row.type ?? null, published: row.published === true })),
+                hint: "默认视图 code = schemaCode；读单个视图用 listview.get",
+            };
+        }),
+    }));
+    writeTool(tools, "listview.create", LIST_VIEW_LANE, LIST_VIEW_TOOLS["listview.create"].scope, LIST_VIEW_TOOLS["listview.create"].description, { schemaCode: z.string().min(1), name: z.string().min(1), code: z.string().optional() }, async (session, args) => {
+        // Ticket 81: read the header FIRST — a same-code retry short-circuits
+        // with the existing view and sends ZERO create wires (the live
+        // post-timeout retry otherwise answers 303002 编码重复).
+        const existing = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code ?? "" } });
+        if (existing.data != null) {
+            return { performed: { skipped: "already-present" }, readback: { alreadyPresent: true, header: existing.data } };
+        }
+        try {
+            const performed = await wireCall(session, {
+                path: ENDPOINTS.listQueryCreate,
+                method: "POST",
+                body: { schemaCode: args.schemaCode, name: args.name, code: args.code, type: "LIST", showOnPc: false, published: false },
+            });
+            const readback = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code ?? "" } });
+            return { performed: { errcode: performed.errcode }, readback: { header: readback.data } };
+        }
+        catch (error) {
+            // Race path: another writer created the view between the pre-check and
+            // the create — the platform's 303002 is absence of work, not failure.
+            if (!(error instanceof WireError && error.kind === "business" && error.errcode === 303002))
+                throw error;
+            const header = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code ?? "" } });
+            if (!header.data)
+                throw error;
+            return { performed: { skipped: "already-present" }, readback: { alreadyPresent: true, header: header.data } };
+        }
+    });
+    writeTool(tools, "listview.configure", LIST_VIEW_LANE, LIST_VIEW_TOOLS["listview.configure"].scope, LIST_VIEW_TOOLS["listview.configure"].description, {
+        schemaCode: z.string().min(1),
+        code: z.string().optional(),
+        fieldCodes: z.array(z.string()).min(1).describe("要展示的字段：可给 propertyCode 或字段显示名（唯一匹配时自动解析，歧义或不存在则拒绝，不静默跳过）"),
+        hideDefaultSystemFields: z.boolean().optional().describe("是否隐藏平台默认系统列（createdTime/creater/name/sequenceNo 等）；平台 update 按提交列集合决定，不能靠 visible:false"),
+        replaceColumns: z.boolean().optional().describe("把 fieldCodes 当作列集合的权威全集：未列出的已有列（含系统列）全部移除，最终列 = fieldCodes（按给定顺序）。默认 false 为增量（保留已有列）。系统列与业务列一视同仁——想要 createdTime/sequenceNo 就把它写进 fieldCodes"),
+        sorts: z.array(listViewSortArg).optional().describe("querySorts; omitted leaves the existing sorts untouched, provided replaces them"),
+        conditions: z.array(listViewConditionArg).optional().describe("queryConditions; omitted leaves the existing conditions untouched, provided replaces them"),
+        actions: z.array(listViewActionArg).optional().describe("queryActions; omitted leaves the existing actions untouched, provided MERGES into the effective set by actionCode (existing platform defaults like 新增/删除/导入/导出 are preserved, a matching actionCode is updated). Use replaceActions:true for the authoritative full set"),
+        replaceActions: z.boolean().optional().describe("把 actions 当作权威全集：未列出的已有动作（含平台内置的 add/删除/导入/导出/修改拥有者）全部移除。默认 false 为合并（保留内置动作，按 actionCode 更新/追加）"),
+        defaultActions: z.boolean().optional().describe("先并入平台对 PC LIST 视图的默认动作集（add/delete/batch_update/batch_submit/import/export/batch_print/qr_code/editowner/import_attachment/export_attachment，常用于把被替换掉的内置按钮找回），再叠加 actions"),
+        presentation: listViewPresentationArg.optional(),
+        buttons: z
+            .array(listViewButtonArg)
+            .optional()
+            .describe("customButtons; sent as the customButtonJson JSON array string; omitted leaves the existing buttons untouched, provided replaces every button under the QUERY trigger (schema + child tables)"),
+        options: listViewOptionsArg.optional(),
+        presentationType: presentationTypeArg.optional(),
+        gantt: listViewGanttArg.optional(),
+        queryLayer: listViewQueryLayerArg.optional(),
+        multiTableHeaderConfig: listViewMultiTableHeaderArg.optional(),
+    }, async (session, args) => {
+        const code = args.code ?? args.schemaCode;
+        const got = await wireCall(session, { path: ENDPOINTS.listQueryGet, query: { schemaCode: args.schemaCode, code, clientType: "PC" } });
+        const model = (got.data ?? {});
+        if (!model.id)
+            throw new WireError("business", `list view ${code} not found on ${args.schemaCode}`, 302025);
+        const columns = Array.isArray(model.queryColumns) ? ([...model.queryColumns]) : [];
+        const fieldRows = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } })).data);
+        let sortKey = columns.reduce((max, c) => Math.max(max, Number(c.sortKey) || 0), 0);
+        const added = [];
+        const updated = [];
+        // A `fieldCodes` entry may be a propertyCode OR a display name (cpdocs
+        // base3.0 parity); an unresolvable reference is REFUSED, never silently
+        // skipped — a silently dropped column reported as success is the
+        // "declared a column, nothing appeared" trap.
+        const unknownRefs = args.fieldCodes.filter((ref) => resolveFieldRef(fieldRows, ref) === undefined);
+        if (unknownRefs.length > 0)
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "listview-columns-unknown-field",
+                unknown: unknownRefs,
+                message: `fieldCodes 引用了模型 ${args.schemaCode} 发布面上不存在的字段（可给 propertyCode 或字段名）：${unknownRefs.join("、")}；先 field.create + field.publish，或修正引用`,
+            });
+        // replaceColumns: the caller's fieldCodes ARE the view. Start from an
+        // empty set so system columns fall away unless listed — a system field
+        // can still be shown by naming its code in fieldCodes (createdTime etc.
+        // are published fields too), so the caller controls the exact set.
+        if (args.replaceColumns === true)
+            columns.length = 0;
+        for (const ref of args.fieldCodes) {
+            const fieldCode = resolveFieldRef(fieldRows, ref).code;
+            const field = fieldRows.find((row) => (row.code ?? row.propertyCode) === fieldCode);
+            const type = Number(field.type ?? field.propertyType);
+            const displayFormat = columnDisplayFormat(type, field.options);
+            const existing = columns.find((c) => c.propertyCode === fieldCode);
+            if (existing) {
+                existing.name = field.name;
+                existing.propertyType = type;
+                existing.displayFormat = displayFormat;
+                existing.visible = true;
+                updated.push(fieldCode);
+                continue;
+            }
+            sortKey += 1;
+            columns.push({ name: field.name, propertyCode: fieldCode, propertyType: type, isDefaultProperty: false, displayFormat, width: "160", sortKey, sumType: null, relativeSchemaCode: null, childColumns: null, clientType: "PC", schemaAlias: "a_1", propertyAlias: fieldCode, syncDefaultFormat: false, displayFields: null, queryLevel: 1, options: null, visible: true, virtualField: false, enableEncrypt: false, autoFilled: false });
+            added.push(fieldCode);
+        }
+        // replaceColumns already reduced the set to fieldCodes; hideDefaultSystemFields
+        // additionally drops any system column that slipped in (an echoed system
+        // column in incremental mode, or one the caller listed only to name its
+        // display). Both act by OMITTING columns from the submitted PC collection:
+        // the platform forces every submitted column visible=true
+        // (BizQueryController.reSetQueryColumns:1000-1027), so visible:false is
+        // not an option.
+        const configuredColumns = filterDefaultSystemColumns(columns, args.hideDefaultSystemFields === true);
+        const body = { ...model, queryColumns: configuredColumns };
+        if (args.presentation !== undefined)
+            body.queryPresentation = normalizePresentation(args.presentation);
+        if (args.sorts !== undefined)
+            body.querySorts = normalizeSorts(args.sorts, fieldRows, args.schemaCode);
+        // Keep the normalized requested conditions so the post-write readback can
+        // compare what was ASKED for against what the platform stored, rather than
+        // reporting a write-side `ok` that silently lost fields (dogfood R2).
+        let requestedConditionKeys;
+        let requestedConditionSpec;
+        if (args.conditions !== undefined) {
+            const normalizedConditions = normalizeConditions(args.conditions, fieldRows, args.schemaCode);
+            body.queryConditions = normalizedConditions;
+            requestedConditionKeys = normalizedConditions.map((row) => String(row.propertyCode ?? ""));
+            requestedConditionSpec = normalizedConditions.map((row) => ({ propertyCode: String(row.propertyCode ?? ""), filterType: row.filterType }));
+        }
+        // saveBizQueryDetail removes every action whose clientType matches the
+        // update and re-adds the submitted list, so an omitted `actions` must echo
+        // the read-face effective set (stored + platform-injected) rather than
+        // sending an empty list, which would delete the view's actions.
+        //
+        // Live 2026-09-17: because it is replace-then-re-add, passing ONE action
+        // used to delete the built-in 新增/删除/导入/导出 and the list rendered
+        // with no Add button. `actions` now MERGES into the effective set by
+        // actionCode; replaceActions:true restores the authoritative-set
+        // behaviour, and defaultActions:true re-seeds the platform's own default
+        // set (the repair path for a view that already lost its buttons).
+        if (args.actions === undefined) {
+            body.queryActions = readArray(model, "queryActions");
+        }
+        else {
+            const normalized = normalizeActions(args.actions, args.schemaCode);
+            if (args.replaceActions === true) {
+                body.queryActions = normalized;
+            }
+            else {
+                const seeded = args.defaultActions === true
+                    ? normalizeActions(PLATFORM_DEFAULT_LIST_ACTIONS.map((action) => ({ ...action })), args.schemaCode)
+                    : [];
+                body.queryActions = mergeActions([...seeded, ...readArray(model, "queryActions")], normalized);
+            }
+        }
+        // BizButtonFacadeImpl.addBizButtonList runs only when the update body
+        // carries a JSON array in customButtonJson; it then deletes every button
+        // under the QUERY trigger for the schema (+ its child tables) and re-adds
+        // the submitted list. An omitted `buttons` therefore leaves the stored
+        // buttons untouched (no customButtonJson key), while `buttons: []` clears.
+        // Ticket 75: high-level targetModel/targetForm/configureList params are
+        // expanded into the authoritative actionConfig shape from readback
+        // BEFORE normalizeButtons (targetCode/targetObjCode never emitted for
+        // ADD_DATA/FORM — measured ineffective, see dry-lint).
+        if (args.buttons !== undefined) {
+            const expandedButtons = await expandButtonActionConfigs(session, args.schemaCode, args.buttons);
+            body.customButtonJson = JSON.stringify(normalizeButtons(expandedButtons, args.schemaCode, code));
+        }
+        else {
+            delete body.customButtonJson;
+        }
+        // BizQueryModel.options is a single String column. BizQueryController.update
+        // sets publish=TRUE before updateBizQuery, so after the first configure the
+        // store's publish is TRUE and only the name/options-diff branch
+        // (ModelManagementFacadeImpl:1966-1973) persists options — an omitted body
+        // key (null) would overwrite a non-null stored value. `{...model}` already
+        // echoes the read-face options, so only a provided value replaces it.
+        if (args.options !== undefined)
+            body.options = encodeJsonColumn(args.options);
+        // QueryPresentationType is a header enum always assignable by
+        // updateBizQuery (:1955, not gated), so an omitted body key (null) would
+        // overwrite a stored type; `{...model}` echoes the read-face value. GANTT
+        // requires queryGanttModel (controller validateNotEmptyGantt :1121-1136).
+        if (args.presentationType !== undefined)
+            body.queryPresentationType = args.presentationType;
+        // saveBizQueryDetail only swaps queryGantt when non-null (:178-183), so an
+        // omitted gantt leaves the stored one untouched.
+        if (args.gantt !== undefined)
+            body.queryGanttModel = normalizeGantt(args.gantt, args.schemaCode);
+        // saveBizQueryDetail assigns queryLayer and multiTableHeaderConfig
+        // unconditionally (:184-186); the read face always carries them
+        // (BizQueryFacadeImpl:344-345), so an omitted arg relies on the
+        // `{...model}` echo while a provided value replaces it.
+        if (args.queryLayer !== undefined)
+            body.queryLayer = args.queryLayer;
+        if (args.multiTableHeaderConfig !== undefined) {
+            body.multiTableHeaderConfig = encodeJsonColumn(args.multiTableHeaderConfig);
+        }
+        const performed = await wireCall(session, { path: ENDPOINTS.listQueryUpdate, method: "POST", body });
+        // BUG-11 (live, docker+source verified): the controller's /query/update
+        // forces publish=TRUE and the engine's updateBizQuery SKIPS the entity
+        // update block once the STORED view is published
+        // (ModelManagementFacadeImpl:1998-2010), so a body-driven
+        // queryPresentationType is silently dropped for a published view (the
+        // default view is published). The designer switches view type through
+        // /query/update_header (a plain header update, no publish gate) — drive
+        // the same path whenever presentationType is provided.
+        if (args.presentationType !== undefined) {
+            const header = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code } });
+            const headerModel = (header.data ?? {});
+            await wireCall(session, {
+                path: ENDPOINTS.listQueryUpdateHeader,
+                method: "POST",
+                body: { ...headerModel, code, schemaCode: args.schemaCode, queryPresentationType: args.presentationType },
+            });
+        }
+        const after = await wireCall(session, { path: ENDPOINTS.listQueryGet, query: { schemaCode: args.schemaCode, code, clientType: "PC" } });
+        const afterModel = (after.data ?? {});
+        const afterCols = readArray(afterModel, "queryColumns").map((c) => ({
+            propertyCode: c.propertyCode,
+            propertyType: c.propertyType,
+            displayFormat: c.displayFormat ?? null,
+            visible: c.visible ?? null,
+            sumType: c.sumType ?? null,
+        }));
+        const sorts = readArray(afterModel, "querySorts")
+            .map(decodeSortRow)
+            .sort((a, b) => Number(a.sortKey ?? 0) - Number(b.sortKey ?? 0));
+        const conditions = readArray(afterModel, "queryConditions")
+            .map(decodeConditionRow)
+            .sort((a, b) => String(a.propertyCode ?? "").localeCompare(String(b.propertyCode ?? "")));
+        const readback = { code, added, updated, columns: afterCols, sorts, conditions };
+        // Post-write semantic readback (dogfood R2): the platform MODELS a list
+        // condition as a filter CONTROL definition, so a requested condition whose
+        // propertyCode does not survive the round-trip was lost. Surface that as
+        // `conditionReadbackStatus` (not a business `ok`) so a caller never
+        // mistakes the success envelope for the filter having landed.
+        if (requestedConditionKeys !== undefined) {
+            const storedKeys = new Set(conditions.map((condition) => String(condition.propertyCode ?? "")));
+            const missingConditions = requestedConditionKeys.filter((key) => !storedKeys.has(key));
+            // Also verify the OPERATOR (filterType) survived — a propertyCode that
+            // lands with the WRONG comparison is just as wrong as one that is
+            // dropped (dogfood R2 follow-up).
+            const storedByCode = new Map(conditions.map((condition) => [String(condition.propertyCode ?? ""), condition]));
+            const filterTypeMismatches = (requestedConditionSpec ?? [])
+                .filter((spec) => storedByCode.has(spec.propertyCode))
+                .filter((spec) => String(storedByCode.get(spec.propertyCode)?.filterType ?? "") !== String(spec.filterType ?? ""))
+                .map((spec) => ({ propertyCode: spec.propertyCode, requested: spec.filterType ?? null, stored: storedByCode.get(spec.propertyCode)?.filterType ?? null }));
+            const equivalent = missingConditions.length === 0 && filterTypeMismatches.length === 0;
+            readback.conditionReadback = {
+                status: equivalent ? "equivalent" : "listview-condition-readback-mismatch",
+                requested: requestedConditionKeys,
+                stored: [...storedKeys],
+                // Operator-level summary so "operator + value" acceptance needs no
+                // `--full`/artifact fetch (dogfood R2 round17b).
+                operators: (requestedConditionSpec ?? []).map((spec) => ({
+                    propertyCode: spec.propertyCode,
+                    requested: spec.filterType ?? null,
+                    stored: storedByCode.get(spec.propertyCode)?.filterType ?? null,
+                    defaultValue: storedByCode.get(spec.propertyCode)?.defaultValue ?? null,
+                })),
+                ...(missingConditions.length > 0 ? { missing: missingConditions } : {}),
+                ...(filterTypeMismatches.length > 0 ? { filterTypeMismatches } : {}),
+            };
+        }
+        readback.columnsRenderCompat = columnsRenderCompat(readArray(afterModel, "queryColumns"));
+        if (args.actions !== undefined) {
+            readback.actions = readArray(afterModel, "queryActions")
+                .map(decodeActionRow)
+                .sort((a, b) => Number(a.sortKey ?? 0) - Number(b.sortKey ?? 0));
+        }
+        if (afterModel.queryPresentation && typeof afterModel.queryPresentation === "object") {
+            readback.presentation = decodePresentation(afterModel.queryPresentation);
+        }
+        if (Array.isArray(afterModel.customButtons)) {
+            const buttons = readArray(afterModel, "customButtons");
+            readback.buttons = buttons
+                .map(decodeButtonRow)
+                .sort((a, b) => Number(a.sortKey ?? 0) - Number(b.sortKey ?? 0));
+            readback.buttonsRenderCompat = buttonsRenderCompat(buttons);
+        }
+        if (afterModel.options !== undefined && afterModel.options !== null) {
+            readback.options = parseConditionOptions(afterModel.options);
+        }
+        if (afterModel.queryPresentationType !== undefined && afterModel.queryPresentationType !== null) {
+            readback.presentationType = afterModel.queryPresentationType;
+        }
+        if (afterModel.queryGanttModel && typeof afterModel.queryGanttModel === "object") {
+            readback.gantt = decodeGantt(afterModel.queryGanttModel);
+        }
+        if (afterModel.queryLayer !== undefined && afterModel.queryLayer !== null) {
+            readback.queryLayer = afterModel.queryLayer;
+        }
+        if (afterModel.multiTableHeaderConfig !== undefined && afterModel.multiTableHeaderConfig !== null && afterModel.multiTableHeaderConfig !== "") {
+            readback.multiTableHeaderConfig = parseConditionOptions(afterModel.multiTableHeaderConfig);
+        }
+        return { performed: { errcode: performed.errcode }, readback };
+    }, assertListViewConfigureShape);
+    writeTool(tools, "listview.delete", LIST_VIEW_LANE, LIST_VIEW_TOOLS["listview.delete"].scope, LIST_VIEW_TOOLS["listview.delete"].description, { schemaCode: z.string().min(1), code: z.string().min(1) }, async (session, args) => {
+        const before = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code } });
+        if (before.data == null)
+            return { performed: { skipped: "already-absent" }, readback: { absent: true, header: null } };
+        const performed = await wireCall(session, { path: ENDPOINTS.listQueryDelete, method: "POST", query: { schemaCode: args.schemaCode, code: args.code } });
+        const readback = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code } });
+        return { performed: { errcode: performed.errcode }, readback: { absent: readback.data == null, header: readback.data ?? null } };
+    });
+}
+//# sourceMappingURL=list-view.js.map