@stalfh233/omc-cli 0.6.7 → 0.6.11

package/dist/lanes/app.js

@@ -4,8 +4,9 @@ import { capabilityArg, environmentArg } from "../args.js";
 import { governedRead } from "../read.js";
 import { writeTool } from "../write.js";
 import { defineTool, ToolRefusalError } from "../tool-types.js";
-import { wireCall, wireRows } from "../wire.js";
+import { wireCall, wireRows, WireError } from "../wire.js";
 import { APP_LANE_CONTRACT } from "./app-contract.js";
+import { readAppTree } from "./folder.js";
 const APP_LANE = APP_LANE_CONTRACT.lane;
 const APP_TOOLS = APP_LANE_CONTRACT.tools;
 function appRollbackSpec(toolName) {
@@ -55,144 +56,230 @@ export function registerAppLane(tools) {
             return { applications };
         }),
     }));
-    writeTool(tools, "app.create", APP_LANE, APP_TOOLS["app.create"].scope, APP_TOOLS["app.create"].description, { code: z.string().min(1), name: z.string().min(1), groupId: z.string().optional() }, async (session, args) => {
-        const existing = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data).find((row) => (row.appCode ?? row.code) === args.code);
-        if (existing)
-            throw new ToolRefusalError({ status: "refused", blocker: "app-create-duplicate", code: args.code, message: `应用 ${args.code} 已存在；拒绝重复 POST，不能用写后存在证明本次创建` });
-        let groupId = args.groupId;
-        let resolvedFrom = args.groupId ? "explicit" : undefined;
-        let warning;
-        let groups = [];
-        const readGroups = async () => wireRows((await wireCall(session, { path: ENDPOINTS.applicationGroupList, query: {} })).data);
-        if (!groupId) {
-            const configured = session.profile.applicationCode?.trim();
-            const apps = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data);
-            const configuredApp = configured ? apps.find((row) => (row.appCode ?? row.code) === configured) : undefined;
-            if (configuredApp && typeof configuredApp.groupId === "string" && configuredApp.groupId) {
-                groupId = configuredApp.groupId;
-                resolvedFrom = "auto-configured-app-group";
+    writeTool({
+        tools,
+        name: "app.create",
+        lane: APP_LANE,
+        scope: APP_TOOLS["app.create"].scope,
+        description: APP_TOOLS["app.create"].description,
+        inputSchema: { code: z.string().min(1), name: z.string().min(1), groupId: z.string().optional() },
+        execute: async (session, args) => {
+            const existing = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data).find((row) => (row.appCode ?? row.code) === args.code);
+            if (existing)
+                throw new ToolRefusalError({ status: "refused", blocker: "app-create-duplicate", code: args.code, message: `应用 ${args.code} 已存在；拒绝重复 POST，不能用写后存在证明本次创建` });
+            let groupId = args.groupId;
+            let resolvedFrom = args.groupId ? "explicit" : undefined;
+            let warning;
+            let groups = [];
+            const readGroups = async () => wireRows((await wireCall(session, { path: ENDPOINTS.applicationGroupList, query: {} })).data);
+            if (!groupId) {
+                const configured = session.profile.applicationCode?.trim();
+                const apps = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data);
+                const configuredApp = configured ? apps.find((row) => (row.appCode ?? row.code) === configured) : undefined;
+                if (configuredApp && typeof configuredApp.groupId === "string" && configuredApp.groupId) {
+                    groupId = configuredApp.groupId;
+                    resolvedFrom = "auto-configured-app-group";
+                }
+                else {
+                    groups = await readGroups();
+                    const withId = groups.filter((row) => typeof row.id === "string" && String(row.id));
+                    // Prefer a named non-fallback group. The tenant normally has one (e.g.
+                    // code=default); landing in the fallback group `all` makes the app
+                    // portal-hidden, which the user cannot see and the create cannot undo
+                    // without app.update.
+                    const named = withId.find((row) => String(row.code ?? "").toLowerCase() !== "all");
+                    const group = named ?? withId[0];
+                    if (!group)
+                        throw new ToolRefusalError({
+                            status: "refused",
+                            blocker: "app-create-prerequisite-missing",
+                            preconditions: [{ code: "application-group-required", satisfied: false }],
+                            recovery: [{ code: "application-group-missing", action: "由管理侧创建应用分组后重新 discover_environment" }],
+                            message: "创建应用前置条件不满足：租户没有可用应用分组；零 create wire",
+                        });
+                    groupId = String(group.id);
+                    resolvedFrom = "auto-first-group";
+                    const fallback = String(group.code ?? "").toLowerCase() === "all";
+                    warning = fallback ? "resolved-to-fallback-group; portalHidden:true" : "resolved-to-first-group";
+                }
             }
-            else {
+            if (groups.length === 0)
                 groups = await readGroups();
-                const withId = groups.filter((row) => typeof row.id === "string" && String(row.id));
-                // Prefer a named non-fallback group. The tenant normally has one (e.g.
-                // code=default); landing in the fallback group `all` makes the app
-                // portal-hidden, which the user cannot see and the create cannot undo
-                // without app.update.
-                const named = withId.find((row) => String(row.code ?? "").toLowerCase() !== "all");
-                const group = named ?? withId[0];
-                if (!group)
+            const selectedGroup = groups.find((row) => String(row.id ?? "") === String(groupId));
+            if (!selectedGroup)
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "app-create-prerequisite-missing",
+                    groupId,
+                    preconditions: [{ code: "application-group-required", satisfied: false, groupId }],
+                    recovery: [{ code: "application-group-missing", action: "改用 discover_environment 返回的有效 groupId，或由管理侧修复分组" }],
+                    message: `创建应用前置条件不满足：分组 ${String(groupId)} 无法解析；零 create wire`,
+                });
+            const performed = await wireCall(session, {
+                path: ENDPOINTS.applicationCreate,
+                method: "POST",
+                body: {
+                    groupId,
+                    code: args.code,
+                    name: args.name,
+                    name_i18n: JSON.stringify({ "zh-CN": args.name }),
+                },
+            });
+            const present = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data).some((row) => (row.appCode ?? row.code) === args.code);
+            // Portal visibility is a DERIVED FACT (group membership), reported on
+            // every readback so a caller never has to infer it from `warning` and
+            // never reports `ok` while claiming visibility it did not verify.
+            const portalHidden = isFallbackGroup(selectedGroup);
+            // r28d F2: platform seeds a default Folder (name_i18n.en=defaultGroup).
+            // Surface it on create so callers don't mistake it for a user folder.
+            const tree = present ? await readAppTree(session, args.code) : [];
+            const defaultFolder = tree.find((row) => row.type === "Folder" && row.isDefault === true);
+            return {
+                performed: { errcode: performed.errcode, groupId, resolvedFrom, selectedGroup: { id: selectedGroup.id, code: selectedGroup.code, name: selectedGroup.name } },
+                readback: {
+                    present,
+                    selectedGroup: { id: selectedGroup.id, code: selectedGroup.code, name: selectedGroup.name },
+                    ...(defaultFolder
+                        ? {
+                            defaultFolder: {
+                                id: defaultFolder.id,
+                                path: defaultFolder.path,
+                                name: defaultFolder.name,
+                                isDefault: true,
+                            },
+                        }
+                        : {}),
+                    postconditions: { created: present, published: false, portalVisible: !portalHidden, portalHidden },
+                    portalHidden,
+                    ...(warning ? { warning } : {}),
+                    publishBoundary: { inScope: false, nextAction: "publish-in-designer", reason: "app publish is outside the CLI configuration boundary" },
+                    manualActions: [
+                        { action: "publish-in-designer", detail: "在设计器发布应用，否则门户不可见" },
+                        { action: "portal-visibility-check", detail: "发布后核对应用位于具名分组并在门户可见" },
+                    ],
+                    recovery: [{ code: "publish-in-designer", action: "在设计器发布应用并核对其位于具名分组；再做门户可见性验证" }],
+                    note: "应用发布属边界外：建成后需人工在设计器发布并核对该分组，否则门户不可见。" +
+                        (defaultFolder
+                            ? ` 平台已自动生成默认分组（folderId=${String(defaultFolder.id)}，isDefault:true）；空目录不挡 app.delete，有模型/报表/自定义页才需先清。`
+                            : ""),
+                },
+            };
+        },
+        rollback: appRollbackSpec("app.create"),
+    });
+    writeTool({
+        tools,
+        name: "app.update",
+        lane: APP_LANE,
+        scope: APP_TOOLS["app.update"].scope,
+        description: APP_TOOLS["app.update"].description,
+        inputSchema: { code: z.string().min(1), groupId: z.string().min(1) },
+        execute: async (session, args) => {
+            const record = (await wireCall(session, { path: ENDPOINTS.applicationGet, query: { appCode: args.code } })).data;
+            if (!record || (typeof record === "object" && Object.keys(record).length === 0))
+                return { performed: { skipped: "already-absent" }, readback: { absent: true } };
+            const previousGroupId = typeof record.groupId === "string" ? record.groupId : null;
+            const performed = await wireCall(session, {
+                path: ENDPOINTS.applicationUpdate,
+                method: "POST",
+                body: {
+                    ...record,
+                    groupId: args.groupId,
+                    enabled: record.enabled,
+                },
+            });
+            // Two independent reads: apppackage/list rows carry `published` (and the
+            // group), while the whole-record `get` carries `enabled`. Merge them so
+            // the readback can assert portal visibility without a second caller round.
+            const listRow = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data).find((row) => (row.appCode ?? row.code) === args.code);
+            const groupRow = wireRows((await wireCall(session, { path: ENDPOINTS.applicationGroupList, query: {} })).data).find((row) => String(row.id ?? "") === String(args.groupId));
+            const after = (await wireCall(session, { path: ENDPOINTS.applicationGet, query: { appCode: args.code } })).data;
+            const portalHiddenByGroup = groupRow === undefined || isFallbackGroup(groupRow);
+            // `groupChanged` must reflect a REAL change: comparing the stored value
+            // against the requested one — an update that lands on the same group is
+            // not a change, and reporting it as one made the flag untrustworthy
+            // (dogfood R3: groupChanged:true while previousGroupId === groupId).
+            const storedGroupId = typeof after?.groupId === "string" ? after.groupId : listRow?.groupId ?? null;
+            const groupChanged = String(storedGroupId ?? "") !== String(previousGroupId ?? "");
+            return {
+                performed: { errcode: performed.errcode, code: args.code, groupId: args.groupId, previousGroupId },
+                readback: {
+                    present: listRow !== undefined || after !== null,
+                    groupId: storedGroupId,
+                    previousGroupId,
+                    groupChanged,
+                    groupCode: groupRow?.code ?? null,
+                    published: listRow?.published === true,
+                    portalHidden: portalHiddenByGroup,
+                },
+            };
+        },
+        rollback: appRollbackSpec("app.update"),
+    });
+    writeTool({
+        tools,
+        name: "app.delete",
+        lane: APP_LANE,
+        scope: APP_TOOLS["app.delete"].scope,
+        description: APP_TOOLS["app.delete"].description,
+        inputSchema: { code: z.string().min(1) },
+        execute: async (session, args) => {
+            const readApps = async () => wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data);
+            const target = (await readApps()).find((row) => (row.appCode ?? row.code) === args.code);
+            if (!target)
+                return { performed: { skipped: "already-absent" }, readback: { absent: true } };
+            // r28d F8: live 600006 APP_PACKAGE_HAS_NODE fires when non-Folder nodes
+            // remain (models / reports / custom pages). Empty folders — including the
+            // platform default group — do NOT block. Pre-check with the same tree face
+            // folder.delete uses, so the refusal lists children + a runnable nextCommand
+            // instead of a bare wire-business 600006 → omc-refusals.
+            const tree = await readAppTree(session, args.code);
+            const blockers = tree.filter((row) => String(row.type ?? "") !== "Folder");
+            if (blockers.length > 0) {
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "app-not-empty",
+                    errcode: 600006,
+                    code: args.code,
+                    children: blockers.map((row) => ({ id: row.id, type: row.type, code: row.code ?? null, path: row.path })).slice(0, 40),
+                    nextCommand: `omc call folder.tree --env <env> --args '{"applicationCode":"${args.code}"}'`,
+                    message: `应用 ${args.code} 还有 ${blockers.length} 个非目录下属节点（平台 APP_PACKAGE_HAS_NODE / 600006）。` +
+                        "先 model.delete / report.delete / custompage.delete 清掉这些节点；空目录（含 isDefault 默认分组）可留着，app.delete 会一并带走。" +
+                        `下一步：${`omc call folder.tree --env <env> --args '{"applicationCode":"${args.code}"}'`} 看完整树。`,
+                });
+            }
+            let performed;
+            try {
+                performed = await wireCall(session, { path: ENDPOINTS.applicationDelete, method: "POST", query: { appCode: args.code } });
+            }
+            catch (error) {
+                // Race: a non-Folder node appeared between our tree read and the delete.
+                if (error instanceof WireError && error.kind === "business" && error.errcode === 600006) {
+                    const late = await readAppTree(session, args.code);
+                    const lateBlockers = late.filter((row) => String(row.type ?? "") !== "Folder");
                     throw new ToolRefusalError({
                         status: "refused",
-                        blocker: "app-create-prerequisite-missing",
-                        preconditions: [{ code: "application-group-required", satisfied: false }],
-                        recovery: [{ code: "application-group-missing", action: "由管理侧创建应用分组后重新 discover_environment" }],
-                        message: "创建应用前置条件不满足：租户没有可用应用分组；零 create wire",
+                        blocker: "app-not-empty",
+                        errcode: 600006,
+                        code: args.code,
+                        children: lateBlockers.map((row) => ({ id: row.id, type: row.type, code: row.code ?? null, path: row.path })).slice(0, 40),
+                        nextCommand: `omc call folder.tree --env <env> --args '{"applicationCode":"${args.code}"}'`,
+                        message: `应用 ${args.code} 删除被平台拒绝（600006 应用存在下属节点）。` +
+                            `当前非目录节点 ${lateBlockers.length} 个——先清模型/报表/自定义页再删应用；空目录含默认分组可留。` +
+                            `下一步：omc call folder.tree --env <env> --args '{"applicationCode":"${args.code}"}'`,
                     });
-                groupId = String(group.id);
-                resolvedFrom = "auto-first-group";
-                const fallback = String(group.code ?? "").toLowerCase() === "all";
-                warning = fallback ? "resolved-to-fallback-group; portalHidden:true" : "resolved-to-first-group";
+                }
+                throw error;
             }
-        }
-        if (groups.length === 0)
-            groups = await readGroups();
-        const selectedGroup = groups.find((row) => String(row.id ?? "") === String(groupId));
-        if (!selectedGroup)
-            throw new ToolRefusalError({
-                status: "refused",
-                blocker: "app-create-prerequisite-missing",
-                groupId,
-                preconditions: [{ code: "application-group-required", satisfied: false, groupId }],
-                recovery: [{ code: "application-group-missing", action: "改用 discover_environment 返回的有效 groupId，或由管理侧修复分组" }],
-                message: `创建应用前置条件不满足：分组 ${String(groupId)} 无法解析；零 create wire`,
-            });
-        const performed = await wireCall(session, {
-            path: ENDPOINTS.applicationCreate,
-            method: "POST",
-            body: {
-                groupId,
-                code: args.code,
-                name: args.name,
-                name_i18n: JSON.stringify({ "zh-CN": args.name }),
-            },
-        });
-        const present = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data).some((row) => (row.appCode ?? row.code) === args.code);
-        // Portal visibility is a DERIVED FACT (group membership), reported on
-        // every readback so a caller never has to infer it from `warning` and
-        // never reports `ok` while claiming visibility it did not verify.
-        const portalHidden = isFallbackGroup(selectedGroup);
-        return {
-            performed: { errcode: performed.errcode, groupId, resolvedFrom, selectedGroup: { id: selectedGroup.id, code: selectedGroup.code, name: selectedGroup.name } },
-            readback: {
-                present,
-                selectedGroup: { id: selectedGroup.id, code: selectedGroup.code, name: selectedGroup.name },
-                postconditions: { created: present, published: false, portalVisible: !portalHidden, portalHidden },
-                portalHidden,
-                ...(warning ? { warning } : {}),
-                publishBoundary: { inScope: false, nextAction: "publish-in-designer", reason: "app publish is outside the CLI configuration boundary" },
-                manualActions: [
-                    { action: "publish-in-designer", detail: "在设计器发布应用，否则门户不可见" },
-                    { action: "portal-visibility-check", detail: "发布后核对应用位于具名分组并在门户可见" },
-                ],
-                recovery: [{ code: "publish-in-designer", action: "在设计器发布应用并核对其位于具名分组；再做门户可见性验证" }],
-                note: "应用发布属边界外：建成后需人工在设计器发布并核对该分组，否则门户不可见",
-            },
-        };
-    }, undefined, undefined, appRollbackSpec("app.create"));
-    writeTool(tools, "app.update", APP_LANE, APP_TOOLS["app.update"].scope, APP_TOOLS["app.update"].description, { code: z.string().min(1), groupId: z.string().min(1) }, async (session, args) => {
-        const record = (await wireCall(session, { path: ENDPOINTS.applicationGet, query: { appCode: args.code } })).data;
-        if (!record || (typeof record === "object" && Object.keys(record).length === 0))
-            return { performed: { skipped: "already-absent" }, readback: { absent: true } };
-        const previousGroupId = typeof record.groupId === "string" ? record.groupId : null;
-        const performed = await wireCall(session, {
-            path: ENDPOINTS.applicationUpdate,
-            method: "POST",
-            body: {
-                ...record,
-                groupId: args.groupId,
-                enabled: record.enabled,
-            },
-        });
-        // Two independent reads: apppackage/list rows carry `published` (and the
-        // group), while the whole-record `get` carries `enabled`. Merge them so
-        // the readback can assert portal visibility without a second caller round.
-        const listRow = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data).find((row) => (row.appCode ?? row.code) === args.code);
-        const groupRow = wireRows((await wireCall(session, { path: ENDPOINTS.applicationGroupList, query: {} })).data).find((row) => String(row.id ?? "") === String(args.groupId));
-        const after = (await wireCall(session, { path: ENDPOINTS.applicationGet, query: { appCode: args.code } })).data;
-        const portalHiddenByGroup = groupRow === undefined || isFallbackGroup(groupRow);
-        // `groupChanged` must reflect a REAL change: comparing the stored value
-        // against the requested one — an update that lands on the same group is
-        // not a change, and reporting it as one made the flag untrustworthy
-        // (dogfood R3: groupChanged:true while previousGroupId === groupId).
-        const storedGroupId = typeof after?.groupId === "string" ? after.groupId : listRow?.groupId ?? null;
-        const groupChanged = String(storedGroupId ?? "") !== String(previousGroupId ?? "");
-        return {
-            performed: { errcode: performed.errcode, code: args.code, groupId: args.groupId, previousGroupId },
-            readback: {
-                present: listRow !== undefined || after !== null,
-                groupId: storedGroupId,
-                previousGroupId,
-                groupChanged,
-                groupCode: groupRow?.code ?? null,
-                published: listRow?.published === true,
-                portalHidden: portalHiddenByGroup,
-            },
-        };
-    }, undefined, undefined, appRollbackSpec("app.update"));
-    writeTool(tools, "app.delete", APP_LANE, APP_TOOLS["app.delete"].scope, APP_TOOLS["app.delete"].description, { code: z.string().min(1) }, async (session, args) => {
-        const readApps = async () => wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data);
-        const target = (await readApps()).find((row) => (row.appCode ?? row.code) === args.code);
-        if (!target)
-            return { performed: { skipped: "already-absent" }, readback: { absent: true } };
-        const performed = await wireCall(session, { path: ENDPOINTS.applicationDelete, method: "POST", query: { appCode: args.code } });
-        let absent = false;
-        for (let attempt = 0; attempt < 12 && !absent; attempt += 1) {
-            if (attempt > 0)
-                await new Promise((resolve) => setTimeout(resolve, Math.min(1000 * attempt, 3000)));
-            absent = !(await readApps()).some((row) => (row.appCode ?? row.code) === args.code);
-        }
-        return { performed: { errcode: performed.errcode, code: args.code }, readback: { absent } };
-    }, undefined, undefined, appRollbackSpec("app.delete"));
+            let absent = false;
+            for (let attempt = 0; attempt < 12 && !absent; attempt += 1) {
+                if (attempt > 0)
+                    await new Promise((resolve) => setTimeout(resolve, Math.min(1000 * attempt, 3000)));
+                absent = !(await readApps()).some((row) => (row.appCode ?? row.code) === args.code);
+            }
+            return { performed: { errcode: performed.errcode, code: args.code }, readback: { absent } };
+        },
+        rollback: appRollbackSpec("app.delete"),
+    });
 }
 //# sourceMappingURL=app.js.map

package/dist/lanes/apply-changes.js

@@ -38,7 +38,8 @@ export function registerApplyChangesLane(tools) {
         name: "apply_changes",
         layer: "high",
         kind: "write",
-        description: `批量写入：changes:[{tool,args}]（仅低层原子工具，configure_* 拒收）；一次权限检查、按序读回、首败即停；长批量回传 progressFile（totalTimeoutMs 设整批预算）。 ${WRITE_PROTOCOL}`,
+        // r28k F7：选用时机写进 describe 首句——一次审批 N 个有序变更；单条调试用 omc call。
+        description: `何时用：一次审批 N 个有序变更、按序执行、首败即停（已完成步骤在 steps[]，失败步在 failedStep；续跑看 progressFile/resumeFromIndex）。单条调试或需中间读回再决策 → 用 omc call，不要塞进本工具。changes:[{tool,args}]（仅低层原子工具，configure_* 拒收）；长批量回传 progressFile（totalTimeoutMs 设整批预算）。 ${WRITE_PROTOCOL}`,
         inputSchema: {
             environment: environmentArg,
             changes: z

package/dist/lanes/b2-registration-contract.js

@@ -113,7 +113,7 @@ export const B2_LANE_CONTRACT = Object.freeze({
         }),
         "service.list": Object.freeze({
             scope: "readback",
-            description: "列出业务集成服务（/bizservice/service/list_by_category_id；categoryId 省略或空串=全部；keyword 走 list_by_category_id_find 仅匹配 name/code 大小写无关包含）。响应是字段白名单投影（id/code/name/adapterCode/serviceCategoryId/description/shared）——平台行携带完整 configJson（授权配置，可能带凭据），工具层永不回显 configJson。",
+            description: "列出业务集成服务（/bizservice/service/list_by_category_id；categoryId 省略或空串=全部；keyword 走 list_by_category_id_find 仅匹配 name/code 大小写无关包含）。响应是字段白名单投影（id/code/name/adapterCode/serviceCategoryId/description/shared）+ 顶栏 adapterDistribution 聚合——平台行携带完整 configJson（授权配置，可能带凭据），工具层永不回显 configJson。紧凑面仍保留 services[].adapterCode（选型闭环）。",
         }),
         "service.register": Object.freeze({
             scope: B2_SCOPE,
@@ -125,7 +125,7 @@ export const B2_LANE_CONTRACT = Object.freeze({
         }),
         "method.get": Object.freeze({
             scope: "method readback",
-            description: "按 serviceCode + methodCode 读取单个业务集成方法；解码 configJson 与 input/output 参数面为结构化对象。",
+            description: "按 serviceCode + methodCode 读取单个业务集成方法；解码 configJson 与 input/output 参数面为结构化对象。单条读面：code/name/configJson/inputParameters/outputParameters 内联（参数面是本工具存在意义），其余大字段可外置到 detailArtifactId。",
         }),
         "method.update": Object.freeze({
             scope: "method update readback",
@@ -173,7 +173,7 @@ export const B2_LANE_CONTRACT = Object.freeze({
         }),
         "service.adapter_config": Object.freeze({
             scope: "readback",
-            description: "适配器配置发现（设计器同源）：`/bizservice/service/adapter_config` 返回 JSON 字符串（已解码），每个适配器 {code,name,config:{authList,commonList,serviceActionList,methodActionList}}——commonList/authList 的 code+required 就是 service.register 预检所依据的必需键（同源无漂移）。RESTFUL：url 必填 + basic/oauth_password/oauth_client/customer 鉴权面；DATA_SQL：databaseConnectionPoolCode 必填、无服务级鉴权（sqlConfigEnabled 开启时平台会移除 DATA_SQL/DATA_TABLE，读回原样）。纯只读。",
+            description: "适配器配置发现（设计器同源）：`/bizservice/service/adapter_config` 返回 JSON 字符串（已解码），每个适配器 {code,name,config:{authList,commonList,serviceActionList,methodActionList}}——commonList/authList 的 code+required 就是 service.register 预检所依据的必需键（同源无漂移）。顶栏恒带 adapterCodes 摘要；compact:true 只回 code/name/description（选型）。RESTFUL：url 必填 + basic/oauth_password/oauth_client/customer 鉴权面；DATA_SQL：databaseConnectionPoolCode 必填、无服务级鉴权（sqlConfigEnabled 开启时平台会移除 DATA_SQL/DATA_TABLE，读回原样）。纯只读。",
         }),
         "service.table_list": Object.freeze({
             scope: "readback",