@stalfh233/omc-cli 0.6.7 → 0.6.11

package/dist/lanes/list-view.js

@@ -289,10 +289,13 @@ export function registerListViewLane(tools) {
                 code,
                 present: true,
                 name: model.name ?? null,
-                // r18 retro (G5): the placeholder flag misleads ("is my view
-                // inactive?"). Views are ALWAYS-LIVE on save; keep the legacy key
-                // null-ed for shape compatibility and name the lifecycle instead.
-                published: null,
+                // r27 F5 / r18 G5: list views have no draft/publish lifecycle —
+                // save IS live. Previously `published:null` meant both "unpublished"
+                // and "N/A", so probes had to infer from `lifecycle`. Give an
+                // explicit published:true (save == effective; no separate publish
+                // step) plus effective:true so "does this view open?" is one field.
+                published: true, // 视图保存即生效，无需单独发布；不再用 null 兼表「未发布/不适用」
+                effective: true,
                 lifecycle: "always-live",
                 presentationType: model.queryPresentationType ?? null,
                 columnCount: columns.length,
@@ -445,381 +448,414 @@ export function registerListViewLane(tools) {
             };
         }),
     }));
-    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 } };
-        }
-    }, undefined, undefined, listviewRollbackSpec("listview.create"));
-    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)"),
-        buttonScripts: z
-            .array(z.object({ code: z.string().min(1), script: z.string() }))
-            .optional()
-            .describe("直接改按钮脚本：按 code 把 actionConfig.scriptData 换成 script（不改其它按钮/字段）。内部读回现有按钮再回写，因此不必先 listview.get 再整表重发；与 buttons 互斥"),
-        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;
+    writeTool({
+        tools,
+        name: "listview.create",
+        lane: LIST_VIEW_LANE,
+        scope: LIST_VIEW_TOOLS["listview.create"].scope,
+        description: LIST_VIEW_TOOLS["listview.create"].description,
+        inputSchema: { schemaCode: z.string().min(1), name: z.string().min(1), code: z.string().optional().describe("视图 code；省略时**默认取 schemaCode**（与 listview.get / listview.list / rollback 的默认视图口径一致）。平台侧 code 必填，本工具会替你填，不要再依赖不回执的猜测（r26 真机：不传直接被 errcode 10005「编码不能为空」拒绝，白跑一轮线上往返）") },
+        execute: async (session, args) => {
+            // r26 真机：`code` 在 schema 里可选，但三处读面/rollback 都用
+            // `args.code ?? schemaCode`，唯独 create 把 undefined 原样发给平台 →
+            // `errcode 10005 编码不能为空`，探针白跑一轮。默认视图 code 就是
+            // schemaCode（listview.list 的 hint 也这么写），这里对齐。
+            const code = args.code ?? args.schemaCode;
+            // 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 } });
+            if (existing.data != null) {
+                return { performed: { skipped: "already-present" }, readback: { alreadyPresent: true, header: existing.data } };
             }
-            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;
+            try {
+                const performed = await wireCall(session, {
+                    path: ENDPOINTS.listQueryCreate,
+                    method: "POST",
+                    body: { schemaCode: args.schemaCode, name: args.name, code, type: "LIST", showOnPc: false, published: false },
+                });
+                const readback = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code } });
+                return { performed: { errcode: performed.errcode }, readback: { header: readback.data } };
             }
-            else {
-                const seeded = args.defaultActions === true
-                    ? normalizeActions(PLATFORM_DEFAULT_LIST_ACTIONS.map((action) => ({ ...action })), args.schemaCode)
-                    : [];
-                body.queryActions = mergeActions([...seeded, ...readArray(model, "queryActions")], normalized);
+            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 } });
+                if (!header.data)
+                    throw error;
+                return { performed: { skipped: "already-present" }, readback: { alreadyPresent: true, header: header.data } };
             }
-        }
-        // 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 && args.buttonScripts !== undefined)
-            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-ambiguous", message: "buttons 与 buttonScripts 互斥：整表重配用 buttons，只改脚本用 buttonScripts" });
-        if (args.buttonScripts !== undefined) {
-            // Patch ONE field of ONE button in place: read the stored rows, rewrite
-            // actionConfig.scriptData by code, and send the full list back. This is
-            // the write counterpart of `listview.get --buttons`.
-            const existing = readArray(model, "customButtons");
-            if (existing.length === 0)
-                throw new ToolRefusalError({ status: "refused", blocker: "listview-button-absent", schemaCode: args.schemaCode, message: `视图 ${code} 没有自定义按钮——先用 listview.configure 的 buttons 建按钮（bindAction:SCRIPT）` });
-            const byCode = new Map(existing.map((button) => [String(button.code ?? ""), button]));
-            const missing = args.buttonScripts.map((entry) => entry.code).filter((buttonCode) => !byCode.has(buttonCode));
-            if (missing.length > 0)
+        },
+        rollback: listviewRollbackSpec("listview.create"),
+    });
+    writeTool({
+        tools,
+        name: "listview.configure",
+        lane: LIST_VIEW_LANE,
+        scope: LIST_VIEW_TOOLS["listview.configure"].scope,
+        description: LIST_VIEW_TOOLS["listview.configure"].description,
+        inputSchema: {
+            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)"),
+            buttonScripts: z
+                .array(z.object({ code: z.string().min(1), script: z.string() }))
+                .optional()
+                .describe("直接改按钮脚本：按 code 把 actionConfig.scriptData 换成 script（不改其它按钮/字段）。内部读回现有按钮再回写，因此不必先 listview.get 再整表重发；与 buttons 互斥"),
+            options: listViewOptionsArg.optional(),
+            presentationType: presentationTypeArg.optional(),
+            gantt: listViewGanttArg.optional(),
+            queryLayer: listViewQueryLayerArg.optional(),
+            multiTableHeaderConfig: listViewMultiTableHeaderArg.optional(),
+        },
+        execute: 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-button-absent",
-                    schemaCode: args.schemaCode,
-                    buttonCodes: missing,
-                    available: existing.map((button) => String(button.code ?? "")),
-                    message: `视图 ${code} 没有按钮 ${missing.join("、")}；可用：${existing.map((button) => String(button.code ?? "")).join("、")}`,
+                    blocker: "listview-columns-unknown-field",
+                    unknown: unknownRefs,
+                    message: `fieldCodes 引用了模型 ${args.schemaCode} 发布面上不存在的字段（可给 propertyCode 或字段名）：${unknownRefs.join("、")}；先 field.create + field.publish，或修正引用`,
                 });
-            const patched = existing.map((button) => {
-                const entry = args.buttonScripts.find((candidate) => candidate.code === String(button.code ?? ""));
-                if (!entry)
-                    return button;
-                const rawConfig = button.actionConfig;
-                let config = {};
-                if (typeof rawConfig === "string" && rawConfig.trim() !== "") {
-                    try {
-                        const parsed = JSON.parse(rawConfig);
-                        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
-                            config = parsed;
-                    }
-                    catch {
-                        config = {};
-                    }
+            // 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;
                 }
-                else if (rawConfig !== null && typeof rawConfig === "object" && !Array.isArray(rawConfig)) {
-                    config = { ...rawConfig };
+                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;
                 }
-                return { ...button, actionConfig: encodeJsonColumn({ ...config, scriptData: entry.script }) };
-            });
-            body.customButtonJson = JSON.stringify(normalizeButtons(patched, args.schemaCode, code));
-        }
-        else 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 };
-        // r35（2026-10-31 真机）：视图固定条件读回正确，但 `data.list --queryCode <视图>`
-        // 不应用该过滤（4 条未过滤返回）——视图条件的运行时过滤语义未取证（门户 vs
-        // REST queryCode），coverage 已声明 "filtering … not probed"。前置声明省 3 轮排查。
-        if (conditions.length > 0)
-            readback.conditionRuntimeNote =
-                "视图条件的运行时过滤语义未取证：REST `data.list --queryCode <本视图>` 实测不应用固定条件（r35：读回 Gte/5000 正确、返回未过滤 4 条）。别用 queryCode 断言过滤生效；REST 侧过滤用 `data.list` 显式 `filter`。";
-        // 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));
+                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 && args.buttonScripts !== undefined)
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-ambiguous", message: "buttons 与 buttonScripts 互斥：整表重配用 buttons，只改脚本用 buttonScripts" });
             if (args.buttonScripts !== undefined) {
-                const decoded = buttons.map((button) => decodeButtonScript(button));
-                readback.buttonScripts = decoded
-                    .filter((button) => (args.buttonScripts ?? []).some((entry) => entry.code === button.code))
-                    .map((button) => ({ code: button.code, bindAction: button.bindAction, scriptBytes: button.scriptBytes ?? 0, scriptSha256: button.scriptSha256 ?? null, scriptData: button.scriptData ?? null }));
+                // Patch ONE field of ONE button in place: read the stored rows, rewrite
+                // actionConfig.scriptData by code, and send the full list back. This is
+                // the write counterpart of `listview.get --buttons`.
+                const existing = readArray(model, "customButtons");
+                if (existing.length === 0)
+                    throw new ToolRefusalError({ status: "refused", blocker: "listview-button-absent", schemaCode: args.schemaCode, message: `视图 ${code} 没有自定义按钮——先用 listview.configure 的 buttons 建按钮（bindAction:SCRIPT）` });
+                const byCode = new Map(existing.map((button) => [String(button.code ?? ""), button]));
+                const missing = args.buttonScripts.map((entry) => entry.code).filter((buttonCode) => !byCode.has(buttonCode));
+                if (missing.length > 0)
+                    throw new ToolRefusalError({
+                        status: "refused",
+                        blocker: "listview-button-absent",
+                        schemaCode: args.schemaCode,
+                        buttonCodes: missing,
+                        available: existing.map((button) => String(button.code ?? "")),
+                        message: `视图 ${code} 没有按钮 ${missing.join("、")}；可用：${existing.map((button) => String(button.code ?? "")).join("、")}`,
+                    });
+                const patched = existing.map((button) => {
+                    const entry = args.buttonScripts.find((candidate) => candidate.code === String(button.code ?? ""));
+                    if (!entry)
+                        return button;
+                    const rawConfig = button.actionConfig;
+                    let config = {};
+                    if (typeof rawConfig === "string" && rawConfig.trim() !== "") {
+                        try {
+                            const parsed = JSON.parse(rawConfig);
+                            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
+                                config = parsed;
+                        }
+                        catch {
+                            config = {};
+                        }
+                    }
+                    else if (rawConfig !== null && typeof rawConfig === "object" && !Array.isArray(rawConfig)) {
+                        config = { ...rawConfig };
+                    }
+                    return { ...button, actionConfig: encodeJsonColumn({ ...config, scriptData: entry.script }) };
+                });
+                body.customButtonJson = JSON.stringify(normalizeButtons(patched, args.schemaCode, code));
             }
-            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, undefined, listviewRollbackSpec("listview.configure"));
-    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 } };
-        let performed;
-        try {
-            performed = await wireCall(session, { path: ENDPOINTS.listQueryDelete, method: "POST", query: { schemaCode: args.schemaCode, code: args.code } });
-        }
-        catch (error) {
-            // 306103 删除后将无可用视图 — the platform requires at least one visible
-            // list view per model. r15's `nextCommand` fell back to the generic
-            // refusal router; name the constraint and the only real deletion path.
-            if (error instanceof WireError && error.kind === "business" && (error.errcode === 306103 || /无可用视图/.test(error.message)))
-                throw new ToolRefusalError({
-                    status: "refused",
-                    blocker: "listview-last-visible",
-                    schemaCode: args.schemaCode,
-                    code: args.code,
-                    nextCommand: `omc model-purge --code ${args.schemaCode}`,
-                    message: `不能删除视图 ${args.code}：平台要求每个模型至少保留一条可见列表视图（306103）。` +
-                        `单独删最后一条视图没有意义——视图会随模型一起级联删除。要继续用这个模型就**就地改**（listview.configure 省略 code 即改默认视图），` +
-                        `要整体清理就用 model-purge（默认 dry-run，先看计划）。`,
+            else 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 },
                 });
-            throw error;
-        }
-        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 } };
-    }, undefined, undefined, listviewRollbackSpec("listview.delete"));
+            }
+            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 };
+            // r35（2026-10-31 真机）：视图固定条件读回正确，但 `data.list --queryCode <视图>`
+            // 不应用该过滤（4 条未过滤返回）——视图条件的运行时过滤语义未取证（门户 vs
+            // REST queryCode），coverage 已声明 "filtering … not probed"。前置声明省 3 轮排查。
+            if (conditions.length > 0)
+                readback.conditionRuntimeNote =
+                    "视图条件的运行时过滤语义未取证：REST `data.list --queryCode <本视图>` 实测不应用固定条件（r35：读回 Gte/5000 正确、返回未过滤 4 条）。别用 queryCode 断言过滤生效；REST 侧过滤用 `data.list` 显式 `filter`。";
+            // 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));
+                if (args.buttonScripts !== undefined) {
+                    const decoded = buttons.map((button) => decodeButtonScript(button));
+                    readback.buttonScripts = decoded
+                        .filter((button) => (args.buttonScripts ?? []).some((entry) => entry.code === button.code))
+                        .map((button) => ({ code: button.code, bindAction: button.bindAction, scriptBytes: button.scriptBytes ?? 0, scriptSha256: button.scriptSha256 ?? null, scriptData: button.scriptData ?? null }));
+                }
+                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 };
+        },
+        preflight: assertListViewConfigureShape,
+        rollback: listviewRollbackSpec("listview.configure"),
+    });
+    writeTool({
+        tools,
+        name: "listview.delete",
+        lane: LIST_VIEW_LANE,
+        scope: LIST_VIEW_TOOLS["listview.delete"].scope,
+        description: LIST_VIEW_TOOLS["listview.delete"].description,
+        inputSchema: { schemaCode: z.string().min(1), code: z.string().min(1) },
+        execute: 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 } };
+            let performed;
+            try {
+                performed = await wireCall(session, { path: ENDPOINTS.listQueryDelete, method: "POST", query: { schemaCode: args.schemaCode, code: args.code } });
+            }
+            catch (error) {
+                // 306103 删除后将无可用视图 — the platform requires at least one visible
+                // list view per model. r15's `nextCommand` fell back to the generic
+                // refusal router; name the constraint and the only real deletion path.
+                if (error instanceof WireError && error.kind === "business" && (error.errcode === 306103 || /无可用视图/.test(error.message)))
+                    throw new ToolRefusalError({
+                        status: "refused",
+                        blocker: "listview-last-visible",
+                        schemaCode: args.schemaCode,
+                        code: args.code,
+                        nextCommand: `omc model-purge --code ${args.schemaCode}`,
+                        message: `不能删除视图 ${args.code}：平台要求每个模型至少保留一条可见列表视图（306103）。` +
+                            `单独删最后一条视图没有意义——视图会随模型一起级联删除。要继续用这个模型就**就地改**（listview.configure 省略 code 即改默认视图），` +
+                            `要整体清理就用 model-purge（默认 dry-run，先看计划）。`,
+                    });
+                throw error;
+            }
+            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 } };
+        },
+        rollback: listviewRollbackSpec("listview.delete"),
+    });
 }
 //# sourceMappingURL=list-view.js.map