@stalfh233/omc-cli 0.6.7 → 0.6.11

package/dist/lanes/field.js

@@ -387,114 +387,167 @@ export function registerFieldLane(tools) {
             },
         }),
     }));
-    writeTool(tools, "field.create", FIELD_LANE, FIELD_TOOLS["field.create"].scope, FIELD_TOOLS["field.create"].description, {
-        schemaCode: z.string().min(1),
-        code: z.string().min(1),
-        name: z.string().min(1),
-        propertyType: propertyTypeArg,
-        options: fieldOptionsArg.optional(),
-        relativeCode: relativeCodeArg,
-        choices: choicesArg,
-        subFields: subFieldArg,
-        skipExisting: z.boolean().optional().describe("幂等重入：code 已存在于本模型时跳过并返回 existed:true（批量脚本重跑不再被 schema-code-taken 打断）；跨模型占用仍拒绝"),
-        propertyEmpty: z.boolean().optional().describe("数据模型层是否声明该字段不可为空；默认 false（可为空）。必填/只读请在表单设计与流程节点权限配置，不要在模型层设置——平台会据此把流程各节点强制成可见+可编辑+必填"),
-    }, async (session, args) => {
-        const draft = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } })).data);
-        const published = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } })).data);
-        if ([...draft, ...published].some((row) => (row.code ?? row.propertyCode) === args.code)) {
-            // r28b 账本（2026-10-28）：批量脚本重入被重复拒绝打断 69 次——skipExisting
-            // 让幂等重跑返回 existed:true 而不是拒（跨模型占用仍走 wire 层教学拒绝）。
-            if (args.skipExisting === true)
-                return { performed: { errcode: 0, skipped: true, reason: "duplicate-field" }, readback: { draftFieldPresent: true, existed: true, note: "skipExisting:true 命中已存在字段，幂等跳过（无写入）" } };
-            throw new ToolRefusalError({ status: "refused", blocker: "duplicate-field", schemaCode: args.schemaCode, propertyCode: args.code, message: `字段 ${args.schemaCode}.${args.code} 已存在于草稿或发布面；拒绝重复 POST；批量重入加 skipExisting:true 幂等跳过`, nextCommand: `omc call field.list --args '${JSON.stringify({ schemaCode: args.schemaCode, published: true, code: args.code })}'` });
-        }
-        // One seam owns field-change normalization, every reproduced gate, and the
-        // wire body (src/field-change.ts), so configure_model and intent share it.
-        assertNoSelfSchemaAggregation(args, published);
-        await assertNoChildSchemaAggregation(session, args.schemaCode, args.propertyType, args.options ?? {});
-        // 目标版本决定 optionsSet 形状：8.2 以下要补 optionStructure/treeSelect
-        // （cpdocs issue #8：缺键让设计器选项弹窗硬崩）。
-        const targetVersion = session.detectedVersion();
-        const prepared = prepareFieldChange({ ...args, ...(targetVersion ? { targetVersion } : {}) });
-        let performed;
-        try {
-            performed = await wireCall(session, { path: ENDPOINTS.fieldCreate, method: "POST", body: fieldChangeWireBody(args, prepared) });
-        }
-        catch (error) {
-            // r12 A5: the platform answers a bare 300005「数据模型已经存在！」when the
-            // code collides. BizObjectSchemaManagerImpl#addBizSchema looks the code up
-            // in the GLOBAL schema registry (`getBizObjectSchema(code)`), and child
-            // tables are registered there too (`schema.isSubSchema()` →
-            // `_addSubBizSchema`) — so a subtable code shares the model namespace and
-            // collides across models, not just inside this one. The registry lookup is
-            // not exposed over REST, so the occupier cannot be listed here; say that
-            // instead of leaving a bare platform code.
-            if (error instanceof WireError && error.kind === "business" && error.errcode === 300005 && args.skipExisting === true) {
-                // r28b 账本（2026-10-28）：批量重入 69 次 field.create 拒绝的大头是 code 已占——
-                // 幂等跳过让批量脚本可重跑，只有跨模型占用才走拒绝教学。
-                const existing = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
-                const present = wireRows(existing.data).some((row) => (row.code ?? row.propertyCode) === args.code);
-                if (present)
-                    return { performed: { errcode: 0, skipped: true, reason: "schema-code-taken" }, readback: { draftFieldPresent: true, existed: true, note: "skipExisting:true 命中已存在字段，幂等跳过（无写入）" } };
+    writeTool({
+        tools,
+        name: "field.create",
+        lane: FIELD_LANE,
+        scope: FIELD_TOOLS["field.create"].scope,
+        description: FIELD_TOOLS["field.create"].description,
+        inputSchema: {
+            schemaCode: z.string().min(1),
+            code: z.string().min(1),
+            name: z.string().min(1),
+            propertyType: propertyTypeArg,
+            options: fieldOptionsArg.optional(),
+            relativeCode: relativeCodeArg,
+            choices: choicesArg,
+            subFields: subFieldArg,
+            skipExisting: z.boolean().optional().describe("幂等重入：code 已存在于本模型时跳过并返回 existed:true（批量脚本重跑不再被 schema-code-taken 打断）；跨模型占用仍拒绝"),
+            propertyEmpty: z.boolean().optional().describe("数据模型层是否声明该字段不可为空；默认 false（可为空）。必填/只读请在表单设计与流程节点权限配置，不要在模型层设置——平台会据此把流程各节点强制成可见+可编辑+必填"),
+        },
+        execute: async (session, args) => {
+            const draft = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } })).data);
+            const published = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } })).data);
+            if ([...draft, ...published].some((row) => (row.code ?? row.propertyCode) === args.code)) {
+                // r28b 账本（2026-10-28）：批量脚本重入被重复拒绝打断 69 次——skipExisting
+                // 让幂等重跑返回 existed:true 而不是拒（跨模型占用仍走 wire 层教学拒绝）。
+                if (args.skipExisting === true)
+                    return { performed: { errcode: 0, skipped: true, reason: "duplicate-field" }, readback: { draftFieldPresent: true, existed: true, note: "skipExisting:true 命中已存在字段，幂等跳过（无写入）" } };
+                throw new ToolRefusalError({ status: "refused", blocker: "duplicate-field", schemaCode: args.schemaCode, propertyCode: args.code, message: `字段 ${args.schemaCode}.${args.code} 已存在于草稿或发布面；拒绝重复 POST；批量重入加 skipExisting:true 幂等跳过`, nextCommand: `omc call field.list --args '${JSON.stringify({ schemaCode: args.schemaCode, published: true, code: args.code })}'` });
             }
-            if (error instanceof WireError && error.kind === "business" && error.errcode === 300005)
-                throw new ToolRefusalError({
-                    status: "refused",
-                    blocker: "schema-code-taken",
-                    schemaCode: args.schemaCode,
-                    code: args.code,
-                    nextCommand: `omc call field.list --args '${JSON.stringify({ schemaCode: args.schemaCode, published: false })}'`,
-                    message: `code ${args.code} 已被占用（300005 数据模型已经存在）。**模型与子表共用同一个全局 code 命名空间**——` +
-                        `反编译取证的判定点是 BizObjectSchemaManagerImpl#addBizSchema 的 getBizObjectSchema(code)，子表走同一注册表（isSubSchema → _addSubBizSchema），` +
-                        `所以子表 code 与别的模型的子表/模型 code 撞了也会报这条，而不只是本模型内重复。` +
-                        `本模型内的重复本工具已提前拦住；剩下的是跨模型占用。平台没有「按 code 查占用者」的 REST 读面（只有 _addSubBizSchema 内部注册表），所以这里列不出占用者。` +
-                        `处理：换一个更具体的 code（建议 <模型前缀>_<语义>）；如果确信是上一轮残留，用 model-purge 清掉那个模型后再试。`,
-                });
-            throw error;
-        }
-        const readback = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
-        const rows = wireRows(readback.data);
-        return {
-            performed: { errcode: performed.errcode },
-            readback: { draftFieldPresent: rows.some((row) => (row.code ?? row.propertyCode) === args.code) },
-        };
-    }, undefined, undefined, fieldRollbackSpec("field.create"));
-    writeTool(tools, "field.update", FIELD_LANE, FIELD_TOOLS["field.update"].scope, FIELD_TOOLS["field.update"].description, {
-        schemaCode: z.string().min(1),
-        code: z.string().min(1),
-        name: z.string().min(1).optional().describe("new display name; also rewrites name_i18n to a valid JSON object string"),
-        name_i18n: z.union([z.record(z.string(), z.unknown()), z.string()]).optional().describe("explicit i18n object (or JSON object string) to store verbatim; must parse to an object"),
-        options: fieldOptionsArg.optional(),
-        choices: choicesArg,
-        relativeCode: relativeCodeArg,
-        subFields: subFieldArg,
-        propertyEmpty: z.boolean().optional().describe("覆盖数据模型层的不可为空声明；传 false 可把历史误建的字段改回可为空（必填/只读应在表单与流程节点配置）"),
-        cascadeRepublish: z
-            .boolean()
-            .optional()
-            .describe("true 时一调级联生效：field.update → field.publish → form.draft(rebuild) → form.publish(force)。表单按 published fields 全量重建默认表单脚手架（保留 non-structural 控件 options）；无跨端点事务，中途失败按 partial steps（failedStep+envelope）如实报告，默认不级联"),
-    }, async (session, args) => {
-        const outcome = await runFieldUpdate(session, args);
-        if (args.cascadeRepublish !== true)
-            return outcome;
-        return runFieldUpdateCascade(session, args, outcome);
-    }, (args) => assertNameI18nArg(args.name_i18n), undefined, fieldRollbackSpec("field.update"));
-    writeTool(tools, "field.publish", FIELD_LANE, FIELD_TOOLS["field.publish"].scope, FIELD_TOOLS["field.publish"].description, {
-        schemaCode: z.string().min(1),
-        code: z.string().min(1).optional().describe("optional single field to verify on the published face"),
-        codes: z.array(z.string().min(1)).optional().describe("optional list of fields to verify; publishing is model-scoped, do NOT call once per field"),
-    }, async (session, args) => executeFieldPublish(session, args));
-    writeTool(tools, "field.delete", FIELD_LANE, FIELD_TOOLS["field.delete"].scope, FIELD_TOOLS["field.delete"].description, { schemaCode: z.string().min(1), code: z.string().min(1) }, async (session, args) => {
-        const performed = await wireCall(session, {
-            path: ENDPOINTS.fieldForceDelete,
-            method: "POST",
-            query: { bizSchemaCode: args.schemaCode, bizPropertyCode: args.code },
-        });
-        const draft = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
-        const published = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } });
-        const gone = (value) => !wireRows(value).some((row) => (row.code ?? row.propertyCode) === args.code);
-        return { performed: { errcode: performed.errcode }, readback: { absentDraft: gone(draft.data), absentPublished: gone(published.data) } };
-    }, undefined, undefined, fieldRollbackSpec("field.delete"));
+            // One seam owns field-change normalization, every reproduced gate, and the
+            // wire body (src/field-change.ts), so configure_model and intent share it.
+            assertNoSelfSchemaAggregation(args, published);
+            await assertNoChildSchemaAggregation(session, args.schemaCode, args.propertyType, args.options ?? {});
+            // 目标版本决定 optionsSet 形状：8.2 以下要补 optionStructure/treeSelect
+            // （cpdocs issue #8：缺键让设计器选项弹窗硬崩）。
+            const targetVersion = session.detectedVersion();
+            const prepared = prepareFieldChange({ ...args, ...(targetVersion ? { targetVersion } : {}) });
+            let performed;
+            try {
+                performed = await wireCall(session, { path: ENDPOINTS.fieldCreate, method: "POST", body: fieldChangeWireBody(args, prepared) });
+            }
+            catch (error) {
+                // r12 A5: the platform answers a bare 300005「数据模型已经存在！」when the
+                // code collides. BizObjectSchemaManagerImpl#addBizSchema looks the code up
+                // in the GLOBAL schema registry (`getBizObjectSchema(code)`), and child
+                // tables are registered there too (`schema.isSubSchema()` →
+                // `_addSubBizSchema`) — so a subtable code shares the model namespace and
+                // collides across models, not just inside this one. The registry lookup is
+                // not exposed over REST, so the occupier cannot be listed here; say that
+                // instead of leaving a bare platform code.
+                if (error instanceof WireError && error.kind === "business" && error.errcode === 300005 && args.skipExisting === true) {
+                    // r28b 账本（2026-10-28）：批量重入 69 次 field.create 拒绝的大头是 code 已占——
+                    // 幂等跳过让批量脚本可重跑，只有跨模型占用才走拒绝教学。
+                    const existing = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
+                    const present = wireRows(existing.data).some((row) => (row.code ?? row.propertyCode) === args.code);
+                    if (present)
+                        return { performed: { errcode: 0, skipped: true, reason: "schema-code-taken" }, readback: { draftFieldPresent: true, existed: true, note: "skipExisting:true 命中已存在字段，幂等跳过（无写入）" } };
+                }
+                if (error instanceof WireError && error.kind === "business" && error.errcode === 300005)
+                    throw new ToolRefusalError({
+                        status: "refused",
+                        blocker: "schema-code-taken",
+                        schemaCode: args.schemaCode,
+                        code: args.code,
+                        nextCommand: `omc call field.list --args '${JSON.stringify({ schemaCode: args.schemaCode, published: false })}'`,
+                        message: `code ${args.code} 已被占用（300005 数据模型已经存在）。**模型与子表共用同一个全局 code 命名空间**——` +
+                            `反编译取证的判定点是 BizObjectSchemaManagerImpl#addBizSchema 的 getBizObjectSchema(code)，子表走同一注册表（isSubSchema → _addSubBizSchema），` +
+                            `所以子表 code 与别的模型的子表/模型 code 撞了也会报这条，而不只是本模型内重复。` +
+                            `本模型内的重复本工具已提前拦住；剩下的是跨模型占用。平台没有「按 code 查占用者」的 REST 读面（只有 _addSubBizSchema 内部注册表），所以这里列不出占用者。` +
+                            `处理：换一个更具体的 code（建议 <模型前缀>_<语义>）；如果确信是上一轮残留，用 model-purge 清掉那个模型后再试。`,
+                    });
+                throw error;
+            }
+            const readback = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
+            const rows = wireRows(readback.data);
+            // r28g F14：平台对 SHORT_TEXT/DROPDOWN 等文本族常自动落一条 type1
+            // checkType=4 maxLength=200 的 datarule；field.create 以前不提，list 多
+            // 出「我没建过」的行会让清理/对账猜。只作 advisory，不承诺平台一定写。
+            const textLike = String(args.propertyType) === "SHORT_TEXT" ||
+                String(args.propertyType) === "LONG_TEXT" ||
+                String(args.propertyType) === "DROPDOWN_BOX" ||
+                String(args.propertyType) === "DROPDOWN_MULTI_BOX" ||
+                String(args.propertyType) === "RADIO" ||
+                String(args.propertyType) === "CHECKBOX" ||
+                String(args.propertyType) === "SELECTION";
+            return {
+                performed: { errcode: performed.errcode },
+                readback: {
+                    draftFieldPresent: rows.some((row) => (row.code ?? row.propertyCode) === args.code),
+                    ...(textLike
+                        ? {
+                            sideEffectsNote: "平台可能为文本/下拉字段自动生成一条 datarule type1 checkType=4（maxLength≈200）；本调用未显式创建。清理/对账请用 datarule.list 核对，不要把自动行当成重复写入。",
+                        }
+                        : {}),
+                },
+            };
+        },
+        rollback: fieldRollbackSpec("field.create"),
+    });
+    writeTool({
+        tools,
+        name: "field.update",
+        lane: FIELD_LANE,
+        scope: FIELD_TOOLS["field.update"].scope,
+        description: FIELD_TOOLS["field.update"].description,
+        inputSchema: {
+            schemaCode: z.string().min(1),
+            code: z.string().min(1),
+            name: z.string().min(1).optional().describe("new display name; also rewrites name_i18n to a valid JSON object string"),
+            name_i18n: z.union([z.record(z.string(), z.unknown()), z.string()]).optional().describe("explicit i18n object (or JSON object string) to store verbatim; must parse to an object"),
+            options: fieldOptionsArg.optional(),
+            choices: choicesArg,
+            relativeCode: relativeCodeArg,
+            subFields: subFieldArg,
+            propertyEmpty: z.boolean().optional().describe("覆盖数据模型层的不可为空声明；传 false 可把历史误建的字段改回可为空（必填/只读应在表单与流程节点配置）"),
+            cascadeRepublish: z
+                .boolean()
+                .optional()
+                .describe("true 时一调级联生效：field.update → field.publish → form.draft(rebuild) → form.publish(force)。表单按 published fields 全量重建默认表单脚手架（保留 non-structural 控件 options）；无跨端点事务，中途失败按 partial steps（failedStep+envelope）如实报告，默认不级联"),
+        },
+        execute: async (session, args) => {
+            const outcome = await runFieldUpdate(session, args);
+            if (args.cascadeRepublish !== true)
+                return outcome;
+            return runFieldUpdateCascade(session, args, outcome);
+        },
+        preflight: (args) => assertNameI18nArg(args.name_i18n),
+        rollback: fieldRollbackSpec("field.update"),
+    });
+    writeTool({
+        tools,
+        name: "field.publish",
+        lane: FIELD_LANE,
+        scope: FIELD_TOOLS["field.publish"].scope,
+        description: FIELD_TOOLS["field.publish"].description,
+        inputSchema: {
+            schemaCode: z.string().min(1),
+            code: z.string().min(1).optional().describe("optional single field to verify on the published face"),
+            codes: z.array(z.string().min(1)).optional().describe("optional list of fields to verify; publishing is model-scoped, do NOT call once per field"),
+        },
+        execute: async (session, args) => executeFieldPublish(session, args),
+    });
+    writeTool({
+        tools,
+        name: "field.delete",
+        lane: FIELD_LANE,
+        scope: FIELD_TOOLS["field.delete"].scope,
+        description: FIELD_TOOLS["field.delete"].description,
+        inputSchema: { schemaCode: z.string().min(1), code: z.string().min(1) },
+        execute: async (session, args) => {
+            const performed = await wireCall(session, {
+                path: ENDPOINTS.fieldForceDelete,
+                method: "POST",
+                query: { bizSchemaCode: args.schemaCode, bizPropertyCode: args.code },
+            });
+            const draft = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
+            const published = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } });
+            const gone = (value) => !wireRows(value).some((row) => (row.code ?? row.propertyCode) === args.code);
+            return { performed: { errcode: performed.errcode }, readback: { absentDraft: gone(draft.data), absentPublished: gone(published.data) } };
+        },
+        rollback: fieldRollbackSpec("field.delete"),
+    });
 }
 /** The proven field.update write body — shared by the write tool and the cascade path. */
 async function runFieldUpdate(session, args) {

package/dist/lanes/folder-contract.js

@@ -13,7 +13,7 @@ export const FOLDER_WIRE = Object.freeze({
         delete: "POST /api/api/app/folders/delete?folderId=",
     }),
     defaults: "createFolder forces type=Folder, defaults parentId to the app package id (root) and does NOT reject duplicate names; updateFolder refuses parentId===id and only writes parentId when non-empty; deleteFolder refuses a non-empty folder (DIRECTORY_NOT_EMPTY) — delete is NOT recursive",
-    tree: "apppackage/trees?appCode= returns a NESTED tree (folders carry children[]); reading only the top-level array makes a freshly created child folder look absent — flatten recursively and report path/depth",
+    tree: "apppackage/trees?appCode= returns a NESTED tree (folders carry children[]); reading only the top-level array makes a freshly created child folder look absent — flatten recursively and report path/depth; missing app → applicationExists:false + empty nodes (still ok); default folder marked isDefault via name_i18n.en=defaultGroup; BizModel gets displayPath",
     live: "2026-10-23 customer HAR replay: folders/create answered errcode 0 成功创建目录; after the token was attached apppackage/trees returned the full tree",
     customPage: "CustomPageController(8.6.26, @RequestMapping \"/api/custom\"): POST /create takes AppFunctionVO and requires parentId + a non-null menuPointType (getMenuPointType().toString() NPEs to 50000 otherwise) and forces type=Page; POST /page/content/update writes draftContent (existDraft=true) and /page/content/publish writes publishedContent (published=true); BOTH first do getAppFunctionByCode(code) and throw BIZ_SCHEMA_NOT_EXIST when the tree node is missing — node first, then body",
 });
@@ -48,7 +48,7 @@ export const FOLDER_LANE_CONTRACT = Object.freeze({
         "issue/2026-10-23-omc-app-folder-create-and-move.md",
     ]),
     tools: Object.freeze({
-        "folder.tree": Object.freeze({ scope: "app-tree folder/model tree (flattened with path/depth)", description: "读应用树（目录/分组 + 模型）：平台 apppackage/trees 返回嵌套 children，本工具递归展平并给每节点 path/depth" }),
+        "folder.tree": Object.freeze({ scope: "app-tree folder/model tree (flattened with path/depth)", description: "读应用内目录树（folder 节点 + 模型，不是应用包）：平台 apppackage/trees 返回嵌套 children，本工具递归展平并给每节点 path/depth；不存在应用回 applicationExists:false；默认分组带 isDefault" }),
         "folder.create": Object.freeze({ scope: "app-tree folder create (folders/create)", description: "新建目录：folders/create 省略 parentId 建顶层目录；同父同名默认拒绝（folder-duplicate）" }),
         "folder.update": Object.freeze({ scope: "app-tree folder rename/move (folders/update)", description: "重命名/挂载目录（不移动目录内模型，模型用 model.move）；parentId 不可等于自身" }),
         "folder.delete": Object.freeze({ scope: "app-tree folder delete (folders/delete, non-recursive)", description: "删除空目录：非递归，有子节点回 DIRECTORY_NOT_EMPTY（工具先查子节点，拒 folder-not-empty）" }),
@@ -67,7 +67,7 @@ export const FOLDER_LANE_CONTRACT = Object.freeze({
     }),
 });
 export function assertFolderContract() {
-    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.tree", ["children", "path", "depth"]);
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.tree", ["children", "path", "depth", "applicationExists", "isDefault"]);
     assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.create", ["parentId", "顶层", "folder-duplicate"]);
     assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.update", ["parentId", "model.move"]);
     assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.delete", ["非递归", "folder-not-empty"]);
@@ -75,6 +75,10 @@ export function assertFolderContract() {
         throw new Error("folder contract must pin the non-recursive delete refusal");
     if (!FOLDER_WIRE.tree.includes("NESTED"))
         throw new Error("folder contract must pin the nested tree shape");
+    if (!FOLDER_WIRE.tree.includes("applicationExists"))
+        throw new Error("folder contract must pin missing-app distinction");
+    if (!FOLDER_WIRE.tree.includes("defaultGroup"))
+        throw new Error("folder contract must pin default-folder isDefault token");
     // Custom pages: the two-row model (tree node + body row) and the NPE-on-null
     // menuPointType are the facts a future edit must not lose.
     if (!FOLDER_WIRE.customPage.includes("menuPointType"))