@stalfh233/omc-cli 0.0.0-stage → 0.4.0

package/dist/lanes/form.js

@@ -0,0 +1,185 @@
+import { z } from "zod";
+import { ENDPOINTS } from "../endpoints.js";
+import { executeFormDraftWrite, executeFormPublishWrite, validateHtmlRender } from "../form-support.js";
+import { capabilityArg, environmentArg } from "../args.js";
+import { governedRead } from "../read.js";
+import { writeTool } from "../write.js";
+import { registerPackageTool } from "../package-tool.js";
+import { writeSummary } from "../human-summary.js";
+import { defineTool } from "../tool-types.js";
+import { wireCall } from "../wire.js";
+import { FORM_LANE_CONTRACT } from "./form-contract.js";
+const FORM_LANE = FORM_LANE_CONTRACT.lane;
+const FORM_TOOLS = FORM_LANE_CONTRACT.tools;
+/**
+ * The default form slot is named after the model: every observed
+ * `configure_form`/`form.draft`/`form.publish` success used sheetCode ===
+ * schemaCode, and an agent that omits `sheetCode` is asking for that default
+ * slot (bench9: 3 wasted invalid-input calls for the omitted arg). Only the
+ * explicit case is a real caller decision; omitting means "the model's default
+ * sheet". Multi-sheet models still pass sheetCode explicitly.
+ */
+function resolveSheetCode(schemaCode, sheetCode) {
+    return sheetCode ?? schemaCode;
+}
+/** Control codes present in a form attributes JSON face (sorted, stable). */
+function parseControlCodes(face) {
+    if (typeof face !== "string")
+        return [];
+    try {
+        const parsed = JSON.parse(face);
+        return Object.keys(parsed).sort();
+    }
+    catch {
+        return [];
+    }
+}
+export function registerFormLane(tools) {
+    tools.push(defineTool({
+        name: "form.get",
+        layer: "low",
+        kind: "read",
+        lane: FORM_LANE,
+        scope: FORM_TOOLS["form.get"].scope,
+        description: FORM_TOOLS["form.get"].description,
+        inputSchema: {
+            environment: environmentArg,
+            schemaCode: z.string().min(1),
+            sheetCode: z.string().min(1).optional().describe("表单槽位码；省略时默认 = schemaCode（模型码即默认表单槽位）；多表单模型显式传"),
+            controls: z
+                .union([z.boolean(), z.array(z.string().min(1))])
+                .optional()
+                .describe("控件定义投影：true = 返回全部控件的 draft/published 定义；字符串数组 = 只返回这些控件码的定义；省略 = 只回控件码清单"),
+            full: z.boolean().optional().describe("返回全部六份布局 JSON 原文（大体积）"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const sheetCode = resolveSheetCode(args.schemaCode, args.sheetCode);
+            const sheet = (await wireCall(session, { path: ENDPOINTS.sheetGet, query: { schemaCode: args.schemaCode, sheetCode } })).data;
+            if (!sheet)
+                return { schemaCode: args.schemaCode, sheetCode, present: false };
+            const base = {
+                schemaCode: args.schemaCode,
+                sheetCode,
+                present: true,
+                published: sheet.published === true,
+                existDraft: sheet.existDraft === true,
+            };
+            if (args.full === true)
+                return {
+                    ...base,
+                    draftViewJson: sheet.draftViewJson ?? null,
+                    draftAttributesJson: sheet.draftAttributesJson ?? null,
+                    draftHtmlJson: sheet.draftHtmlJson ?? null,
+                    // Ticket 100: real bizsheet columns (BizForm.java:95-100) the
+                    // designer writes (save → draftActionsJson; publish → both). They
+                    // were previously dropped by this projection, which is why the
+                    // 2026-09-14 fwb readback "saw no top-level actions field".
+                    draftActionsJson: sheet.draftActionsJson ?? null,
+                    publishedViewJson: sheet.publishedViewJson ?? null,
+                    publishedAttributesJson: sheet.publishedAttributesJson ?? null,
+                    publishedHtmlJson: sheet.publishedHtmlJson ?? null,
+                    publishedActionsJson: sheet.publishedActionsJson ?? null,
+                    // Ticket 109 — render compatibility: the Online JS panel resolves
+                    // generateCodeType(e) whose first line is `if(!e||!e.tagName)
+                    // return ""` and then does o[type].push(...) (54286.fbbb415f.js)
+                    // — an element missing tagName (or with a non-array attrs) throws
+                    // TypeError and kills rendering while the data layer stays green.
+                    // The full readback reports per-face violations instead of a
+                    // silent "data ok".
+                    htmlRenderCompat: {
+                        draft: validateHtmlRender(sheet.draftHtmlJson),
+                        published: validateHtmlRender(sheet.publishedHtmlJson),
+                    },
+                };
+            const draftControls = parseControlCodes(sheet.draftAttributesJson);
+            const publishedControls = parseControlCodes(sheet.publishedAttributesJson);
+            // `controls:true` (dogfood R2: the caller sent a boolean and got
+            // `controls: Expected array`) means "all controls" — it is the natural
+            // shorthand and maps to the full control-code list.
+            const wanted = args.controls === true ? [...new Set([...draftControls, ...publishedControls])].sort() : args.controls;
+            const pick = (face) => {
+                if (!wanted || typeof face !== "string")
+                    return undefined;
+                let parsed;
+                try {
+                    parsed = JSON.parse(face);
+                }
+                catch {
+                    return undefined;
+                }
+                return Object.fromEntries(wanted.filter((code) => code in parsed).map((code) => [code, parsed[code]]));
+            };
+            return {
+                ...base,
+                draftControlCodes: draftControls,
+                publishedControlCodes: publishedControls,
+                ...(wanted ? { draftControls: pick(sheet.draftAttributesJson), publishedControls: pick(sheet.publishedAttributesJson) } : {}),
+            };
+        }),
+    }));
+    writeTool(tools, "form.draft", FORM_LANE, FORM_TOOLS["form.draft"].scope, FORM_TOOLS["form.draft"].description, {
+        schemaCode: z.string().min(1),
+        sheetCode: z.string().min(1).optional().describe("表单槽位码；省略时默认 = schemaCode（模型码即默认表单槽位）"),
+        draftViewJson: z.string().optional(),
+        draftAttributesJson: z.string().optional(),
+        draftHtmlJson: z.string().optional(),
+        fieldCodes: z.array(z.string().min(1)).optional().describe("脚手架绑定的已发布字段（按此顺序）；由 configure_form/intent 显式传入"),
+        rebuild: z.boolean().optional().describe("true 时丢弃现有草稿布局，按已发布字段重新生成（新增字段/子表要用它；默认保留现有草稿）"),
+        allowEmptyLayout: z.boolean().optional().describe("显式放行空布局（\"[]\"/\"{}\"）写入；默认拒绝（form-empty-layout），防设计器 Save 清空后照写丢控件"),
+    }, async (session, args) => executeFormDraftWrite(session, { ...args, sheetCode: resolveSheetCode(args.schemaCode, args.sheetCode) }));
+    writeTool(tools, "form.publish", FORM_LANE, FORM_TOOLS["form.publish"].scope, FORM_TOOLS["form.publish"].description, {
+        schemaCode: z.string().min(1),
+        sheetCode: z.string().min(1).optional().describe("表单槽位码；省略时默认 = schemaCode（模型码即默认表单槽位）"),
+        publishRemarks: z.string().optional(),
+        force: z.boolean().optional().describe("强制重新提拔（跳过 already-published 短路）；重写草稿后的再发布需要它"),
+        allowDegrade: z.boolean().optional().describe("显式放行降级提拔（草稿控件数 < 已发布面）；默认拒绝（form-publish-degrade），防把空/残草稿提拔成发布版"),
+    }, async (session, args) => executeFormPublishWrite(session, { ...args, sheetCode: resolveSheetCode(args.schemaCode, args.sheetCode) }));
+    registerPackageTool(tools, {
+        name: "configure_form",
+        lane: FORM_LANE,
+        scope: FORM_TOOLS["configure_form"].scope,
+        description: FORM_TOOLS["configure_form"].description,
+        inputSchema: {
+            schemaCode: z.string().min(1),
+            sheetCode: z.string().min(1).optional().describe("表单槽位码；省略时默认 = schemaCode（模型码即默认表单槽位）"),
+            fieldCodes: z
+                .array(z.string().min(1))
+                .optional()
+                .describe("表单要绑定的已发布字段（按此顺序）；省略则脚手架绑定全部已发布字段；未知 code 拒绝（form-fieldcodes-unknown）"),
+            rebuild: z.boolean().optional().describe("true 时丢弃现有草稿布局，按已发布字段重新生成（新增字段/子表要用它；默认保留现有草稿）"),
+            draftHtmlJson: z.string().optional(),
+        },
+        plan: (args) => ({
+            summary: writeSummary("configure_form", args, undefined, "plan"),
+            actions: [
+                { tool: "form.draft", args: { schemaCode: args.schemaCode, sheetCode: resolveSheetCode(args.schemaCode, args.sheetCode), ...(args.fieldCodes ? { fieldCodes: args.fieldCodes } : {}), ...(args.rebuild === true ? { rebuild: true } : {}), ...(typeof args.draftHtmlJson === "string" ? { draftHtmlJson: args.draftHtmlJson } : {}) } },
+                { tool: "form.publish", args: { schemaCode: args.schemaCode, sheetCode: resolveSheetCode(args.schemaCode, args.sheetCode) } },
+            ],
+        }),
+        execute: async (session, args) => {
+            const results = [];
+            const sheetCode = resolveSheetCode(args.schemaCode, args.sheetCode);
+            // configure_form MUST delegate to the proven form.draft/form.publish
+            // paths so the real empty-form scaffold and draftHtmlJson are written;
+            // never shortcut with {schemaCode,sheetCode,fieldCodes}-only bodies.
+            const draftOutcome = await executeFormDraftWrite(session, {
+                schemaCode: args.schemaCode,
+                sheetCode,
+                ...(args.fieldCodes ? { fieldCodes: args.fieldCodes } : {}),
+                ...(args.rebuild === true ? { rebuild: true } : {}),
+                ...(typeof args.draftHtmlJson === "string" ? { draftHtmlJson: args.draftHtmlJson } : {}),
+            });
+            results.push({ step: "form.draft", errcode: draftOutcome.performed.errcode });
+            const publishOutcome = await executeFormPublishWrite(session, {
+                schemaCode: args.schemaCode,
+                sheetCode,
+            });
+            results.push({ step: "form.publish", errcode: publishOutcome.performed.errcode });
+            const published = await wireCall(session, { path: ENDPOINTS.sheetGet, query: { schemaCode: args.schemaCode, sheetCode } });
+            return { steps: results, readback: { formPublished: (published.data ?? {}).published === true, publishedHtmlJsonPresent: typeof (published.data ?? {}).publishedHtmlJson === "string" } };
+        },
+        summarize: (args, _outcome, phase) => writeSummary("configure_form", args, undefined, phase),
+    });
+}
+//# sourceMappingURL=form.js.map

package/dist/lanes/lane-ids.js

@@ -0,0 +1,34 @@
+/**
+ * The single source of lane identity. Every lane declaration and every tool
+ * registration draws its lane from this frozen map, so a lane typo is a
+ * compile-time error (`LaneId`) rather than a runtime coverage refusal.
+ *
+ * The values are the manifest lane strings the M1 coverage ledger already
+ * uses; `assertCoverageConsistency()` proves every registered tool's lane is
+ * declared, and the manifest generator injects the declared tool/scope sets
+ * into the matching manifest items. `meta` is the governance surface (approval
+ * / setup / status) that has no coverage declaration and no lane-bound tools.
+ */
+export const LANES = Object.freeze({
+    meta: "meta-governance",
+    environment: "environment-governance",
+    app: "app-management",
+    dictionary: "dictionary-management",
+    model: "model-management",
+    field: "field-families",
+    dataRule: "G1-datarule",
+    form: "form-publish-chain",
+    businessrule: "B1-businessrule",
+    ruleLifecycle: "S25-rule-lifecycle",
+    runtimeData: "M2-runtime-data",
+    workflow: "W7-S29-greenfield",
+    onlineJs: "online-js",
+    b2: "B2-registration",
+    listView: "W1-list-view",
+    report: "R1-report",
+});
+export const LANE_IDS = Object.freeze(Object.values(LANES));
+export function isLaneId(value) {
+    return LANE_IDS.includes(value);
+}
+//# sourceMappingURL=lane-ids.js.map

package/dist/lanes/list-view-contract.js

@@ -0,0 +1,175 @@
+import { assertDescriptionCarries, assertLaneContract, behaviorBinding, CONTRACT_FAMILY, CONTRACT_REFERENCE_VERSION } from "./contract-support.js";
+import { LANES } from "./lane-ids.js";
+import { mergeActions, PLATFORM_DEFAULT_LIST_ACTIONS } from "./list-view-shapes.js";
+/**
+ * W1 list-view design-time wire facts (live-proven). The forced create
+ * defaults, the column configuration, and the header-absence readback are the
+ * single source for the handler descriptions and the coverage declarations.
+ */
+export const LIST_VIEW_WIRE = Object.freeze({
+    createBody: "query/create body {schemaCode, name, code, type:'LIST', showOnPc:false, published:false} (forced design-time defaults)",
+    createReadback: "query/get_header readback",
+    configureDefault: "code omitted means the default view (code=schemaCode)",
+    configureColumns: "query/get then query/update: for each fieldCodes entry, append a missing column as visible, or repair an existing column's name/propertyType/displayFormat/visible in place (never skip an already-present column), then query/get readback; propertyType comes from published field metadata; NUMERICAL displayFormat is derived from the field's 0-based `options.scale` (0=integer,1=1dp,2=2dp,3=3dp…8=8dp) through the platform parseNumber table ({0:1,1:2,2:3,3:11,4:12,23:…, percent 0..:4/5/6/13/14/27..30, currency ¥ 2dp..:7/15/16/31..34} — verified live: scale 2 → displayFormat 3 = 2 decimals) and DATE displayFormat from options.format (1=yyyy-MM-dd,2=datetime,3=minute,4=yyyy-MM); the readback columns array carries {propertyCode,propertyType,displayFormat,visible,sumType} and added/updated name the fieldCodes touched",
+    configureSorts: "sorts -> querySorts [{propertyCode,propertyType,direction,sortKey,clientType}]; direction SortDirectionType numeric ASC(1)/DESC(2); omitted leaves the existing sorts untouched, provided replaces them",
+    configureConditions: "conditions -> queryConditions [{propertyCode,propertyType,displayType,filterType,defaultValue,options,startValue,endValue,shortcutFilter,choiceType,dateType,accurateSearch,showNull,includeSubData,buildTreeBy,visible}]; filterType is the comparison OPERATOR (QueryFilterType STRING enum: Eq/NotEq/Gt/Lt/Gte/Lte/Like/NotLike/IsNull/IsNotNull/In/NotIn/Between/NotBetween/Of/NotOf/…; omitted → the platform default for the propertyType; aliases operator/op); displayType INPUT(0)/RADIO(1)/CHECKBOX(2)/SELECT(3)/RANGE(4); choiceType SELECT(1)/POPUP(2)/TREE_LEFT(3); options is a JSON string (decoded on readback)",
+    configureConditionMap: "queryConditionMap {<schemaCode>: queryConditions[]} is read-derived (query/get with a formCode child-table filter); BizQueryDetailConfig persists queryConditions/querySorts only, so the map is not a configure input",
+    configureActions: "actions -> queryActions [{actionCode,name,icon,queryActionType,systemAction,serviceCode,serviceMethod,customService,associationCode,associationType,sortKey}]; queryActionType QueryActionType numeric QUERY(1)/ADD(2)/.../BATCH_SUBMIT(23); associationType QueryActionRelativeType numeric BIZSHEET(0)/WORKFLOW(1); associationCode/associationType are the JSON names of the DTO fields relativeCode/queryActionRelativeType (@JsonProperty); omitted leaves the existing actions untouched, provided MERGES into the effective set by actionCode (live 2026-09-17: query/update replaces-then-re-adds the submitted list, so a merge keeps the platform's built-in 新增/删除/导入/导出 and updates a matching actionCode — replaceActions:true restores the authoritative full set, defaultActions:true re-seeds the platform default set); query/get auto-injects default actions (qr_code/batch_print/batch_update/import_attachment/export_attachment/batch_submit) and query/update resets sortKey to i+1",
+    configurePresentation: "presentation -> queryPresentation {clientType,htmlJson,actionsJson,columnsJson,queryViewDataSource,schemaRelations,options}; htmlJson/actionsJson/columnsJson JSON strings are decoded once before render-shape validation (html element tagName+attrs, action actionCode/name/icon, column propertyCode/propertyType); invalid input refuses with listview-presentation-render-invalid before wire and is never double-encoded; clientType is forced to PC by query/update; schemaRelations is platform-derived from the queryColumns tree (resolveRelations) and overwrites your input; a non-empty htmlJson updates the environment record, which query/delete cleans up; omitted leaves the existing presentation untouched (the read-face object must be echoed, because saveBizQueryDetail removes every presentation whose clientType matches before re-adding), provided replaces it",
+    configureButtons: "buttons -> customButtons [{code,name,useLocation,bindAction,operateType,showPermCode,showPermType,hint,targetCode,targetObjCode,description,actionConfig}]; actionConfig is fail-closed for rendering: SCRIPT requires scriptData, BUSINESS_RULE/FLOW requires targetCode, ADD_DATA/FORM requires expanded schemaCodeVal/formListData/configureList; invalid input refuses before wire; readback includes buttonsRenderCompat; sent as the query/update body customButtonJson JSON array string; BizButtonFacadeImpl.addBizButtonList(String,...) runs only when customButtonJson is a JSON array, then batchDeleteByTrigger over the schema and its published child-table codes and re-adds (so provided replaces every button under the QUERY trigger, while omitted/absent customButtonJson changes nothing); triggerType is forced to QUERY, triggerCode to the view code, schemaCode backfilled, sortKey reset to the array index; name/code/useLocation/bindAction/operateType are required; bindAction ButtonBindAction name LIST(1)/FORM(2)/ADD_DATA(3)/FLOW(4)/BUSINESS_RULE(5)/SCRIPT(6)/CUSTOM_PAGE(7)/WORKFLOW_CENTER_PAGE(8)/FRONT_EVENT(9)/AGENT(10); useLocation ButtonUseLocation name LIST(1)/FORM(2)/ROW(3); operateType ButtonOperateType name WITH_VIEW(1)/WITH_OUT_VIEW(2); showPermType ButtonShowPermType name BIND_SYS_BUTTON(1)/BIND_BUSINESS_RULE(2)/BIND_FRONT_EVENT_BUTTON(3); duplicate code fails BIZ_QUERY_ACTION_CODE_EXIST; query/get returns customButtons[] (non-admin users are filtered by the permission combination); ModelManagementFacadeImpl.removeBizQuery deletes QUERY buttons for the schema and its child tables on query/delete",
+    buttonsActionConfig: "ticket 75: an ADD_DATA/FORM button's model/form target binding lives in actionConfig — schemaCodeVal (target model object {code,id:<app-tree node id>,name,type:'BizModel',appCode,appName,published}) + formListData[] (target forms, sheetType 0 默认表单 only evidenced) + configureList[] (data assignments; isConst is STRING 'true'/'false', operator key is OptionType capital O, only 'Eq' evidenced, constant-value key not evidenced/unimplemented; currentDataItem/targetDataItem are array-wrapped inline field copies) — while targetCode/targetObjCode are measured always-null and NOT consumed for these bind actions (refused as listview-button-target-ineffective; FLOW keeps them); high-level button params targetModel/targetForm/configureList expand into that shape from authoritative readback (app tree node, bizsheet/get, published field rows) and fail closed (listview-button-target-unresolved) before any query/update",
+    configureOptions: "options -> the query header BizQueryModel.options String column (h_biz_query.options TEXT), parsed by the platform as BizQueryOption {pagingSetting:{pageSize,showTotal}, listViewModeSetting:{mode,canSwitch}} (8.6.26 defaultOption = pageSize 20 / showTotal true / mode \"spreadsheet\" / canSwitch false); a raw JSON string is sent verbatim, an object is JSON-stringified; rowColorSetting has no 8.6.26 class so the object form refuses unknown keys; BizQueryController.update sets publish=TRUE before updateBizQuery, so after the first configure only the name/options-diff branch (ModelManagementFacadeImpl:1966-1973) persists options: an omitted body key (null) would overwrite a non-null stored value, so omitted must echo the read-face options (the tool spreads query/get) while provided replaces the whole string; BizQueryFacadeImpl.getBizQuery copies options from the entity on readback (no controller parse); BizObjectFacadeImpl.getShowTotal reads pagingSetting.showTotal (so pagingSetting must not be null)",
+    configurePresentationType: "presentationType -> the query header BizQueryHeaderModel.queryPresentationType QueryPresentationType enum; sent as the name LIST/BOARD/CALENDAR/GANTT (@JsonValue getIndex() whose index equals the name, @JsonCreator get(String) parses); updateBizQuery always assigns it (:1955, not gated by publish or any diff), so an omitted body key (null) would overwrite a stored type and the tool must echo the read-face value (query/get inherits it via BeanUtils.copyProperties at BizQueryFacadeImpl:346); gantt -> queryGanttModel BizQueryGanttModel {queryId,schemaCode,startTimePropertyCode,endTimePropertyCode,progressPropertyCode,titlePropertyCode,preDependencyPropertyCode,endDependencyPropertyCode,levelPropertyCode,milepostCode,sortKey,configJson,liableManCode,statusCode,defaultPrecision}; saveBizQueryDetail only swaps the gantt when the submitted model is non-null (:178-183), so an omitted gantt leaves the stored one untouched; when presentationType is GANTT the controller requires the gantt with non-null startTimePropertyCode/endTimePropertyCode/titlePropertyCode (validateNotEmptyGantt :1121-1136); updateBizQuery forces levelPropertyCode=parentId for TREE models (:1999-2001) and saveBizQueryDetail backfills queryId (:179-181); addBizQuery allows at most one GANTT view per schema (BIZ_QUERY_GANTT_EXIST :1787)",
+    configureLayer: "queryLayer -> BizQueryModel.queryLayer List<BizQueryLayer> (name,layerType,fieldCode,displayField[],layerFieldList[{schemaCode,schemaName,fieldCode,fieldName,displayField[],children[]}]); a real JSON array (not a String column), sent as an array; multiTableHeaderConfig -> BizQueryModel.multiTableHeaderConfig String (HeaderConfig[] JSON {type,name,field,propertyType,children[]} parsed by EasyExcelUtils/DefaultDataIEFileOperateServiceImpl via JSONObject.parseArray); a raw JSON string is sent verbatim, an array is JSON-stringified; saveBizQueryDetail assigns both unconditionally (:184-186, unlike the gantt non-null guard), so an omitted key would overwrite the stored value and the tool must echo the read-face values (BizQueryFacadeImpl.getBizQuery always carries them: queryLayer from the detail config or null, multiTableHeaderConfig from the config or \"\", :283-293/344-345); provided replaces the whole value. NOTE: \"按字段分组\" (field grouping) is NOT a proven capability on this surface — queryLayer is a passthrough (no schema/enum validation) and every real 8.6.26 view read back an empty queryLayer, so layerType semantics/grouping behavior are UNVERIFIED; do not guess-write queryLayer to satisfy a grouping requirement (2026-10-06 sandbox: agent correctly refused to fabricate it).",
+    configureNotFound: 302025,
+    deleteBody: "query/delete?schemaCode=&code=; query/get_header confirms exact absence",
+});
+const LIST_VIEW_SCOPE = "create list readback header forced defaults delete";
+export const LIST_VIEW_LANE_CONTRACT = Object.freeze({
+    lane: LANES.listView,
+    family: CONTRACT_FAMILY,
+    referenceVersion: CONTRACT_REFERENCE_VERSION,
+    endpoints: Object.freeze({
+        create: "listQueryCreate",
+        get: "listQueryGet",
+        update: "listQueryUpdate",
+        getHeader: "listQueryGetHeader",
+        delete: "listQueryDelete",
+        fieldList: "fieldList",
+    }),
+    wire: Object.freeze({
+        createBody: LIST_VIEW_WIRE.createBody,
+        createReadback: LIST_VIEW_WIRE.createReadback,
+        configureDefault: LIST_VIEW_WIRE.configureDefault,
+        configureColumns: LIST_VIEW_WIRE.configureColumns,
+        configureSorts: LIST_VIEW_WIRE.configureSorts,
+        configureConditions: LIST_VIEW_WIRE.configureConditions,
+        configureConditionMap: LIST_VIEW_WIRE.configureConditionMap,
+        configureActions: LIST_VIEW_WIRE.configureActions,
+        buttonsActionConfig: LIST_VIEW_WIRE.buttonsActionConfig,
+        configurePresentation: LIST_VIEW_WIRE.configurePresentation,
+        configureButtons: LIST_VIEW_WIRE.configureButtons,
+        configureOptions: LIST_VIEW_WIRE.configureOptions,
+        configurePresentationType: LIST_VIEW_WIRE.configurePresentationType,
+        configureLayer: LIST_VIEW_WIRE.configureLayer,
+        configureNotFound: LIST_VIEW_WIRE.configureNotFound,
+        deleteBody: LIST_VIEW_WIRE.deleteBody,
+    }),
+    wireBindings: Object.freeze({
+        configureActions: Object.freeze([
+            Object.freeze({
+                kind: "emitter-constant",
+                ref: "lanes/list-view-shapes.PLATFORM_DEFAULT_LIST_ACTIONS",
+                verify: () => {
+                    const codes = PLATFORM_DEFAULT_LIST_ACTIONS.map((action) => action.actionCode);
+                    for (const required of ["add", "delete", "import", "export", "editowner"]) {
+                        if (!codes.includes(required))
+                            throw new Error(`platform default PC LIST action ${required} is missing`);
+                    }
+                },
+            }),
+            Object.freeze({
+                kind: "emitter-constant",
+                ref: "lanes/list-view-shapes.mergeActions",
+                verify: () => {
+                    const merged = mergeActions([{ actionCode: "add" }], [{ actionCode: "custom", name: "自定义" }]);
+                    if (!merged.some((action) => action.actionCode === "add"))
+                        throw new Error("mergeActions must preserve an existing action (add)");
+                    if (!merged.some((action) => action.actionCode === "custom"))
+                        throw new Error("mergeActions must append an incoming action");
+                },
+            }),
+            Object.freeze({
+                kind: "behavior-test",
+                ref: "test/list-view-configure.test.ts#listview.configure actions MERGE by default",
+                verify: () => {
+                    const merged = mergeActions([{ actionCode: "add", name: "新增" }], [{ actionCode: "add", name: "覆盖" }]);
+                    const add = merged.find((action) => action.actionCode === "add");
+                    if (add?.name !== "覆盖")
+                        throw new Error("mergeActions must let an incoming actionCode update the existing row in place");
+                },
+            }),
+        ]),
+        createBody: Object.freeze([behaviorBinding("test/ticket-81-timeout-idempotent-recovery.test.ts#ticket 81: listview.create on a duplicate code", assertListViewContract)]),
+        createReadback: Object.freeze([behaviorBinding("test/ticket-81-timeout-idempotent-recovery.test.ts#ticket 81: listview.create on a duplicate code", assertListViewContract)]),
+        configureDefault: Object.freeze([behaviorBinding("test/lane-contracts.test.ts#list-view lane contract pins the forced defaults/column config", assertListViewContract)]),
+        configureColumns: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure repairs an existing column instead of skipping it", assertListViewContract)]),
+        configureSorts: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure sorts+conditions", assertListViewContract)]),
+        configureConditions: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure sorts+conditions", assertListViewContract)]),
+        configureConditionMap: Object.freeze([behaviorBinding("test/lane-contracts.test.ts#list-view lane contract pins the forced defaults/column config", assertListViewContract)]),
+        buttonsActionConfig: Object.freeze([behaviorBinding("test/ticket-75-listview-button-action-config.test.ts#ticket 75: targetModel/targetForm/configureList expand into the authoritative actionConfig shape", assertListViewContract)]),
+        configurePresentation: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure presentation", assertListViewContract)]),
+        configureButtons: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure buttons", assertListViewContract)]),
+        configureOptions: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure options", assertListViewContract)]),
+        configurePresentationType: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure presentationType+gantt", assertListViewContract)]),
+        configureLayer: Object.freeze([behaviorBinding("test/list-view-configure.test.ts#listview.configure queryLayer+multiTableHeaderConfig", assertListViewContract)]),
+        configureNotFound: Object.freeze([behaviorBinding("test/lane-contracts.test.ts#list-view lane contract pins the forced defaults/column config", assertListViewContract)]),
+        deleteBody: Object.freeze([behaviorBinding("test/write-preflight-governance.test.ts#listview.delete is absent-idempotent", assertListViewContract)]),
+    }),
+    evidence: Object.freeze([
+        ".scratch/omc-route-wayfinder/research/list-view-static-scout.md",
+        "packages/omc-cli/src/lanes/list-view.ts",
+        ".scratch/omc-app-management/issues/07-datalist-projection-hint.md",
+    ]),
+    tools: Object.freeze({
+        "listview.get": Object.freeze({
+            scope: LIST_VIEW_SCOPE,
+            description: "读取一个列表视图（query/get，clientType PC）的紧凑清单：present、name、published、presentationType、列（propertyCode/propertyType/displayFormat/visible）、排序、条件数、动作码、按钮数与 options；`code` 省略时用默认视图（=schemaCode，与 listview.configure 同款解析）。`full:true` 返回 query/get 原始报文。本工具只读，不触发写锁；视图不存在返回 present:false（302025 语义）。",
+        }),
+        "listview.list": Object.freeze({
+            scope: LIST_VIEW_SCOPE,
+            description: "列出模型下的列表视图（query/list，clientType PC）：每个视图的 code/name/type/published。用于在一个模型可能有多视图时先定位 code，再用 listview.get 读单个。只读。",
+        }),
+        "listview.create": Object.freeze({
+            scope: LIST_VIEW_SCOPE,
+            description: "创建自定义列表视图（query/create，强制 LIST/showOnPc/unpublished 默认）。**业务展示的默认入口就是自定义视图**：平台在 model.create 时自动生成的默认视图（code = schemaCode，系统自带）**不作为业务展示用**——列别在默认视图上堆、也别带系统字段；按需求建自定义视图（listview.create 命名业务视图），列**只用业务字段**，筛选条件**按需求选少数几个**（不要照搬全部字段/默认条件）。readback 见 get_header。",
+        }),
+        "listview.configure": Object.freeze({
+            scope: LIST_VIEW_SCOPE,
+            description: "（**列汇总**：数值列 `sumType` wire 为整数——0=不统计/1=求和/2=平均/3=最小/4=最大/5=计数，写进 presentation.columnsJson 的列对象，8.6.26 反编译 SumType 实证）配置列表视图（code 指向**自定义业务视图**——业务展示用 listview.create 建的自定义视图，**不在系统自动生成的默认视图（code=schemaCode）上配业务列/筛选**；仅当明确要改默认视图时才省略 code）。在既有（默认）列表视图上配置列、排序、查询条件、行/列表按钮、呈现、自定义按钮、视图头扩展选项与视图类型：读回 query，按 `fieldCodes` 追加缺失列或**原地修正**已存在列的 name/propertyType/displayFormat/visible（不再跳过既有列），置为可见；数值列 displayFormat 由字段 0 基 `options.scale` 推导（0=整数,1=1位,2=2位,3=3位…8=8位；实测 scale 2 → displayFormat 3 = 两位小数）、日期列由 `options.format` 推导（1/2/3/4），回显 `columns` 为完整列对象并给出 `added`/`updated`；`sorts`→querySorts（direction ASC/DESC）、`conditions`→queryConditions（**比较符是 `filterType`（QueryFilterType 字符串枚举 Eq/NotEq/…；别名 operator/op；省略时按 propertyType 取平台默认）**、displayType/choiceType/options 字符串解码；写后条件回读等价校验给出 conditionReadback）、`actions`→queryActions（queryActionType QUERY(1)…BATCH_SUBMIT(23)、associationType BIZSHEET(0)/WORKFLOW(1)）、`presentation`→queryPresentation（htmlJson/actionsJson/columnsJson/queryViewDataSource/schemaRelations/options 均为 JSON 字符串，合法 JSON 读回解码）、`buttons`→customButtons（写面 customButtonJson JSON 数组字符串；bindAction/useLocation/operateType/showPermType 以枚举名发送；triggerType 强制 QUERY、triggerCode=视图 code、sortKey 按数组位，缺省回传读面 customButtons 有效集；ADD_DATA/FORM 目标绑定走 actionConfig——schemaCodeVal+formListData+configureList，targetCode/targetObjCode 对其无效会被拒；高层参数 targetModel/targetForm/configureList 从读回元数据展开，未解析即 listview-button-target-unresolved 零副作用拒）、`options`→视图头 BizQueryOption（`pagingSetting`{pageSize,showTotal} 分页、`listViewModeSetting`{mode,canSwitch} 列表模式，缺省回传读面有效 options、提供时整体替换，rowColorSetting 无 8.6.26 类证据故对象形态拒绝）与 `presentationType`→QueryPresentationType（LIST/BOARD/CALENDAR/GANTT，缺省回传读面有效值；GANTT 必须同时提供 `gantt`→queryGanttModel 且 startTimePropertyCode/endTimePropertyCode/titlePropertyCode 非空，缺省不触碰既有 gantt）与 `queryLayer`→层级展示（BizQueryLayer[] 数组原样发送）及 `multiTableHeaderConfig`→多级表头（HeaderConfig[] JSON 字符串；缺省回传读面有效值、提供时整体替换）省略时不触碰既有值，提供时整体替换并经出门前 dry-lint；`query/update` 后回读（`query/get` 自动注入的默认动作、平台 sortKey 重排与 schemaRelations 派生需还原）。`code` 省略时用默认视图（=schemaCode）。`queryConditionMap` 为只读派生（query/get 带 formCode 子表条件时才出现），非配置输入。**发布语义**：`query/update` 自动置 publish=TRUE——视图无草稿/发布两态、无需独立发布步骤（与表单/规则的 draft→publish 不同）。**依赖顺序**：视图与表单脚手架都依赖**已发布字段**，规范顺序 model.create → field.create → field.publish（模型级）→ form.draft → form.publish → listview.create（自定义业务视图）→ listview.configure（code 指向它）→ rule.save → rule.enable → workflow。",
+        }),
+        "listview.delete": Object.freeze({
+            scope: LIST_VIEW_SCOPE,
+            description: "Delete a design-time list view (query/delete) with exact absence readback.",
+        }),
+    }),
+});
+export function assertListViewContract() {
+    assertLaneContract(LIST_VIEW_LANE_CONTRACT);
+    if (LIST_VIEW_WIRE.configureNotFound !== 302025)
+        throw new Error("list-view contract pins the missing-view errcode to 302025");
+    if (!LIST_VIEW_WIRE.createBody.includes("query/create"))
+        throw new Error("list-view contract must pin the create endpoint");
+    if (!LIST_VIEW_WIRE.createReadback.includes("query/get_header"))
+        throw new Error("list-view contract must pin the header readback");
+    if (!LIST_VIEW_WIRE.configureDefault.includes("default view"))
+        throw new Error("list-view contract must pin the default-view resolution");
+    if (!LIST_VIEW_WIRE.configureColumns.includes("query/update"))
+        throw new Error("list-view contract must pin the column configure write");
+    if (!LIST_VIEW_WIRE.configureSorts.includes("querySorts"))
+        throw new Error("list-view contract must pin querySorts");
+    if (!LIST_VIEW_WIRE.configureConditions.includes("queryConditions"))
+        throw new Error("list-view contract must pin queryConditions");
+    if (!LIST_VIEW_WIRE.configureConditionMap.includes("queryConditionMap"))
+        throw new Error("list-view contract must pin the condition-map read derivation");
+    if (!LIST_VIEW_WIRE.buttonsActionConfig.includes("actionConfig"))
+        throw new Error("list-view contract must pin the button actionConfig shape");
+    if (!LIST_VIEW_WIRE.configurePresentation.includes("queryPresentation"))
+        throw new Error("list-view contract must pin queryPresentation");
+    if (!LIST_VIEW_WIRE.configureButtons.includes("customButtons"))
+        throw new Error("list-view contract must pin customButtons");
+    if (!LIST_VIEW_WIRE.configureOptions.includes("pagingSetting"))
+        throw new Error("list-view contract must pin the options shape");
+    if (!LIST_VIEW_WIRE.configurePresentationType.includes("QueryPresentationType"))
+        throw new Error("list-view contract must pin the presentation-type enum");
+    if (!LIST_VIEW_WIRE.configureLayer.includes("queryLayer"))
+        throw new Error("list-view contract must pin queryLayer");
+    if (!LIST_VIEW_WIRE.deleteBody.includes("query/delete"))
+        throw new Error("list-view contract must pin the delete endpoint");
+    assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.create", ["query/create", "LIST", "get_header"]);
+    assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.get", ["query/get", "code", "默认视图", "present"]);
+    assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.list", ["query/list", "code"]);
+    assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.configure", ["query/update", "fieldCodes", "默认视图", "querySorts", "queryConditions", "queryActions", "queryActionType", "associationType", "options", "queryPresentation", "htmlJson", "schemaRelations", "customButtons", "customButtonJson", "bindAction", "useLocation", "operateType", "showPermType", "QUERY", "pagingSetting", "listViewModeSetting", "presentationType", "queryGanttModel", "GANTT", "queryLayer", "multiTableHeaderConfig", "publish=TRUE", "field.publish", "rule.enable", "actionConfig", "targetModel", "listview-button-target-unresolved"]);
+    assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.delete", ["query/delete", "absence"]);
+}
+//# sourceMappingURL=list-view-contract.js.map

package/dist/lanes/list-view-coverage.js

@@ -0,0 +1,20 @@
+import { claim, declareLaneCoverage } from "./coverage-declaration.js";
+import { LIST_VIEW_LANE_CONTRACT } from "./list-view-contract.js";
+const T = LIST_VIEW_LANE_CONTRACT.tools;
+export const LIST_VIEW_COVERAGE = declareLaneCoverage(LIST_VIEW_LANE_CONTRACT.lane, [
+    {
+        capability: "W1 list-view design-time header lifecycle",
+        evidence: [
+            ".scratch/omc-route-wayfinder/research/list-view-static-scout.md",
+            "packages/omc-cli/src/lanes/list-view.ts",
+        ],
+        tools: [
+            claim("listview.get", T["listview.get"].scope),
+            claim("listview.list", T["listview.list"].scope),
+            claim("listview.create", T["listview.create"].scope),
+            claim("listview.configure", T["listview.configure"].scope),
+            claim("listview.delete", T["listview.delete"].scope),
+        ],
+    },
+]);
+//# sourceMappingURL=list-view-coverage.js.map