@stalfh233/omc-cli 0.6.7 → 0.6.10

package/dist/lanes/dictionary.js

@@ -86,26 +86,89 @@ function normalizeRecord(record, dictionaryId, parentId) {
         sortKey: Number.isInteger(record.sortKey) ? record.sortKey : 0,
     };
 }
-function dictionaryView(value) {
+/**
+ * r28a F1：默认读面只留身份/决策字段。`name_i18n` 在中文环境里与 `name`
+ * 冗余（二次序列化 JSON 串），每条多 ~60B；真翻译用 `full:true` / artifact。
+ */
+function dictionaryView(value, options = {}) {
     const row = (value && typeof value === "object" ? value : {});
-    return {
+    const view = {
         id: row.id,
         code: row.code,
         name: row.name,
-        name_i18n: row.name_i18n,
         dictionaryType: row.dictionaryType,
         status: row.status,
         sortKey: row.sortKey,
         classificationId: row.classificationId,
         classificationName: row.classificationName,
     };
+    if (options.full)
+        view.name_i18n = row.name_i18n;
+    else if (!redundantNameI18n(row.name_i18n, row.name))
+        view.name_i18n = row.name_i18n;
+    return view;
 }
-function recordsPage(value) {
+/**
+ * r28a F3/F6：记录瘦投影——绑定字段只要 id/code/name；审计列与冗余
+ * name_i18n 默认丢掉。`full:true` 保留原生行。
+ */
+function recordView(value, options = {}) {
+    const row = (value && typeof value === "object" ? value : {});
+    if (options.full)
+        return { ...row };
+    const view = {
+        id: row.id,
+        code: row.code,
+        name: row.name,
+        status: row.status,
+        sortKey: row.sortKey,
+        parentId: row.parentId ?? null,
+    };
+    if (!redundantNameI18n(row.name_i18n, row.name) && row.name_i18n !== undefined)
+        view.name_i18n = row.name_i18n;
+    if (Array.isArray(row.children) && row.children.length > 0) {
+        view.children = row.children.map((child) => recordView(child, options));
+    }
+    return view;
+}
+function redundantNameI18n(nameI18n, name) {
+    if (typeof name !== "string")
+        return false;
+    let parsed = nameI18n;
+    if (typeof nameI18n === "string") {
+        try {
+            parsed = JSON.parse(nameI18n);
+        }
+        catch {
+            return false;
+        }
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+        return false;
+    const values = Object.values(parsed);
+    return values.length > 0 && values.every((value) => value === name);
+}
+/** Stable order for readbacks: sortKey asc, then code. Platform order is not submission order (r28a F3). */
+function sortRecordsBySortKey(rows) {
+    return [...rows]
+        .map((row) => (row && typeof row === "object" ? row : {}))
+        .sort((left, right) => {
+        const leftKey = Number(left.sortKey ?? 0);
+        const rightKey = Number(right.sortKey ?? 0);
+        if (leftKey !== rightKey)
+            return leftKey - rightKey;
+        return String(left.code ?? "").localeCompare(String(right.code ?? ""));
+    });
+}
+const RECORDS_ORDER_NOTE = "records 顺序不保证与提交一致；顺序请用 sortKey（回读已按 sortKey 升序，同值再按 code）";
+function recordsPage(value, options = {}) {
     const page = (value && typeof value === "object" ? value : {});
+    const raw = Array.isArray(page.content) ? page.content : [];
+    const ordered = options.sort === false ? raw : sortRecordsBySortKey(raw);
     return {
-        totalElements: page.totalElements ?? 0,
+        totalElements: page.totalElements ?? ordered.length,
         totalPages: page.totalPages ?? 0,
-        content: Array.isArray(page.content) ? page.content : [],
+        content: ordered.map((row) => recordView(row, options)),
     };
 }
 function requireExactlyOne(id, code) {
@@ -120,11 +183,20 @@ export function registerDictionaryLane(tools) {
         lane: LANE,
         scope: TOOLS["dictionary.list"].scope,
         description: TOOLS["dictionary.list"].description,
-        inputSchema: { environment: environmentArg, capability: capabilityArg, classificationId: z.string().optional(), searchWord: z.string().optional(), page: z.number().int().min(1).default(1), size: z.number().int().min(1).max(200).default(20), sortColumn: z.string().optional(), sortDirection: z.enum(["asc", "desc"]).optional() },
+        inputSchema: { environment: environmentArg, capability: capabilityArg, classificationId: z.string().optional(), searchWord: z.string().optional(), page: z.number().int().min(1).default(1), size: z.number().int().min(1).max(200).default(20), sortColumn: z.string().optional(), sortDirection: z.enum(["asc", "desc"]).optional(), full: z.boolean().default(false) },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
             const data = await wireCall(session, { path: ENDPOINTS.dictionarySearch, query: { classificationId: args.classificationId ?? "", searchWord: args.searchWord ?? "", page: String(args.page), size: String(args.size), sortColumn: args.sortColumn ?? "", sortDirection: args.sortDirection ?? "desc" } });
-            return { dictionaries: recordsPage(data.data) };
-        }),
+            // r28a F1/F2：分页 envelope 保留；顶层再给 total，避免 --jq totalElements 路径迷失。
+            // list 的 content 是字典头（不是 records），用 dictionaryView 瘦投影。
+            const page = (data.data && typeof data.data === "object" ? data.data : {});
+            const raw = Array.isArray(page.content) ? page.content : [];
+            const dictionaries = {
+                totalElements: page.totalElements ?? raw.length,
+                totalPages: page.totalPages ?? 0,
+                content: raw.map((row) => dictionaryView(row, { full: args.full })),
+            };
+            return { dictionaries, total: Number(dictionaries.totalElements ?? 0) };
+        }, { full: args.full }),
     }));
     tools.push(defineTool({
         name: "dictionary.type",
@@ -133,11 +205,12 @@ export function registerDictionaryLane(tools) {
         lane: LANE,
         scope: TOOLS["dictionary.type"].scope,
         description: TOOLS["dictionary.type"].description,
-        inputSchema: { environment: environmentArg, capability: capabilityArg, type: dictionaryType },
+        inputSchema: { environment: environmentArg, capability: capabilityArg, type: dictionaryType, full: z.boolean().default(false) },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
             const data = await wireCall(session, { path: ENDPOINTS.dictionaryGetByType, query: { type: String(args.type) } });
-            return { dictionaryType: args.type, dictionaries: Array.isArray(data.data) ? data.data.map(dictionaryView) : [] };
-        }),
+            const dictionaries = Array.isArray(data.data) ? data.data.map((row) => dictionaryView(row, { full: args.full })) : [];
+            return { dictionaryType: args.type, dictionaries, total: dictionaries.length };
+        }, { full: args.full }),
     }));
     tools.push(defineTool({
         name: "dictionary.names",
@@ -146,11 +219,19 @@ export function registerDictionaryLane(tools) {
         lane: LANE,
         scope: TOOLS["dictionary.names"].scope,
         description: TOOLS["dictionary.names"].description,
-        inputSchema: { environment: environmentArg, capability: capabilityArg },
+        inputSchema: { environment: environmentArg, capability: capabilityArg, full: z.boolean().default(false) },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            // r28a F4/F5：平台 getDictionaryIdAndNames 的覆盖可能小于 searchDictionary
+            // （真机 7 vs 18）。CLI 如实回传平台数组并显式给 total + coverageNote；
+            // 全量/防冲突请用 dictionary.list（可分页）。
             const data = await wireCall(session, { path: ENDPOINTS.dictionaryIdAndNames, query: {} });
-            return { dictionaries: Array.isArray(data.data) ? data.data.map(dictionaryView) : [] };
-        }),
+            const dictionaries = Array.isArray(data.data) ? data.data.map((row) => dictionaryView(row, { full: args.full })) : [];
+            return {
+                dictionaries,
+                total: dictionaries.length,
+                coverageNote: "dictionary.names 透传平台 getDictionaryIdAndNames；其覆盖可能小于 dictionary.list（searchDictionary）。全量清单/防 code 冲突请用 dictionary.list（--jq 'dictionaries.totalElements,dictionaries.content[].code' 或看顶层 total）。",
+            };
+        }, { full: args.full }),
     }));
     tools.push(defineTool({
         name: "dictionary.get",
@@ -159,12 +240,12 @@ export function registerDictionaryLane(tools) {
         lane: LANE,
         scope: TOOLS["dictionary.get"].scope,
         description: TOOLS["dictionary.get"].description,
-        inputSchema: { environment: environmentArg, capability: capabilityArg, id: z.string().optional(), code: z.string().optional() },
+        inputSchema: { environment: environmentArg, capability: capabilityArg, id: z.string().optional(), code: z.string().optional(), full: z.boolean().default(false) },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
             requireExactlyOne(args.id, args.code);
             const data = await wireCall(session, { path: args.id ? ENDPOINTS.dictionaryGet : ENDPOINTS.dictionaryGetByCode, query: args.id ? { id: args.id } : { code: args.code } });
-            return { dictionary: dictionaryView(data.data) };
-        }),
+            return { dictionary: dictionaryView(data.data, { full: args.full }) };
+        }, { full: args.full }),
     }));
     tools.push(defineTool({
         name: "dictionary.records",
@@ -173,12 +254,14 @@ export function registerDictionaryLane(tools) {
         lane: LANE,
         scope: TOOLS["dictionary.records"].scope,
         description: TOOLS["dictionary.records"].description,
-        inputSchema: { environment: environmentArg, capability: capabilityArg, id: z.string().optional(), code: z.string().optional(), parentId: z.string().optional(), searchWord: z.string().optional(), enabledOnly: z.boolean().default(false), page: z.number().int().min(1).default(1), size: z.number().int().min(1).max(200).default(200) },
+        inputSchema: { environment: environmentArg, capability: capabilityArg, id: z.string().optional(), code: z.string().optional(), parentId: z.string().optional(), searchWord: z.string().optional(), enabledOnly: z.boolean().default(false), page: z.number().int().min(1).default(1), size: z.number().int().min(1).max(200).default(200), full: z.boolean().default(false) },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
             requireExactlyOne(args.id, args.code);
+            const projectRows = (rows) => sortRecordsBySortKey(rows).map((row) => recordView(row, { full: args.full }));
             if (args.parentId) {
                 const data = await wireCall(session, { path: ENDPOINTS.dictionaryParentRecords, query: { parentId: args.parentId } });
-                return { parentId: args.parentId, records: Array.isArray(data.data) ? data.data : [] };
+                const records = Array.isArray(data.data) ? projectRows(data.data) : [];
+                return { parentId: args.parentId, records, total: records.length, orderNote: RECORDS_ORDER_NOTE };
             }
             if (args.enabledOnly) {
                 const dictionary = args.id ? { id: args.id } : (await wireCall(session, { path: ENDPOINTS.dictionaryGetByCode, query: { code: args.code } })).data;
@@ -186,57 +269,99 @@ export function registerDictionaryLane(tools) {
                 if (!id)
                     throw new WireError("business", "dictionary code not found", 301001);
                 const data = await wireCall(session, { path: ENDPOINTS.dictionaryEnabledRecords, query: { dicId: id } });
-                return { dictionaryId: id, enabledOnly: true, records: Array.isArray(data.data) ? data.data : [] };
+                const records = Array.isArray(data.data) ? projectRows(data.data) : [];
+                return { dictionaryId: id, enabledOnly: true, records, total: records.length, orderNote: RECORDS_ORDER_NOTE };
             }
             const path = args.code ? ENDPOINTS.dictionaryRecordsByCode : ENDPOINTS.dictionaryRecords;
             const query = args.code
                 ? { code: args.code, searchWord: args.searchWord ?? "", page: String(args.page), size: String(args.size) }
                 : { id: args.id, searchWord: args.searchWord ?? "", page: String(args.page), size: String(args.size) };
             const data = await wireCall(session, { path, query });
-            return { records: recordsPage(data.data) };
-        }),
+            const page = recordsPage(data.data, { full: args.full });
+            return { records: page, total: Number(page.totalElements ?? 0), orderNote: RECORDS_ORDER_NOTE };
+        }, { full: args.full }),
     }));
-    writeTool(tools, "dictionary.save", LANE, TOOLS["dictionary.save"].scope, TOOLS["dictionary.save"].description, {
-        id: z.string().optional(), code: z.string().min(1), name: z.string().min(1), name_i18n: nameI18n, dictionaryType, classificationId: z.string().optional(), sortKey: z.number().int().optional(), status: z.boolean().optional(), records: recordsArg,
-    }, async (session, args) => {
-        const existing = (await wireCall(session, { path: ENDPOINTS.dictionaryGetByCode, query: { code: args.code } })).data;
-        if (!args.id && existing && typeof existing === "object" && Object.keys(existing).length > 0)
-            throw new ToolRefusalError({ status: "refused", blocker: "dictionary-create-duplicate", code: args.code, message: `字典 ${args.code} 已存在；更新请传 id` });
-        const body = {
-            ...(args.id ? { id: args.id } : {}), code: args.code, name: args.name, name_i18n: JSON.stringify(args.name_i18n ?? { "zh-CN": args.name, en: args.name }), dictionaryType: args.dictionaryType,
-            classificationId: args.classificationId ?? "", sortKey: args.sortKey ?? 0, status: args.status ?? true,
-            records: (args.records ?? []).map((record) => normalizeRecord(record)),
-        };
-        const performed = await wireCall(session, { path: ENDPOINTS.dictionarySave, method: "POST", body });
-        const after = (await wireCall(session, { path: ENDPOINTS.dictionaryGetByCode, query: { code: args.code } })).data;
-        // The create/update response only carries the header; the records the caller
-        // just sent are invisible unless they make another call (dogfood R3). Read
-        // them back here so "the header saved" cannot be mistaken for "the records
-        // were verified".
-        let recordsReadback = { totalElements: 0, totalPages: 0, content: [] };
-        try {
-            const stored = (await wireCall(session, { path: ENDPOINTS.dictionaryEnabledRecordsByCode, query: { code: args.code } })).data;
-            const all = (await wireCall(session, { path: ENDPOINTS.dictionaryRecordsByCode, query: { code: args.code, searchWord: "", page: "1", size: "200" } })).data;
-            recordsReadback = { ...recordsPage(all), enabledCount: Array.isArray(stored) ? stored.length : 0 };
-        }
-        catch {
-            // best-effort: the save itself is already authoritative; a record-read
-            // failure must not turn a landed write into a failure.
-        }
-        return { performed: { errcode: performed.errcode }, readback: { present: Boolean(after && Object.keys(after).length > 0), dictionary: dictionaryView(after), records: recordsReadback } };
-    }, undefined, undefined, dictionaryRollbackSpec("dictionary.save"));
-    writeTool(tools, "dictionary.status", LANE, TOOLS["dictionary.status"].scope, TOOLS["dictionary.status"].description, {
-        target: z.enum(["dictionary", "record"]), id: z.string().min(1), status: z.boolean(),
-    }, async (session, args) => {
-        const path = args.target === "dictionary" ? ENDPOINTS.dictionaryUpdateStatus : ENDPOINTS.dictionaryRecordStatus;
-        const performed = await wireCall(session, { path, method: "POST", body: { id: args.id, status: args.status } });
-        return { performed: { errcode: performed.errcode }, readback: { id: args.id, status: args.status } };
+    writeTool({
+        tools,
+        name: "dictionary.save",
+        lane: LANE,
+        scope: TOOLS["dictionary.save"].scope,
+        description: TOOLS["dictionary.save"].description,
+        inputSchema: {
+            id: z.string().optional(), code: z.string().min(1), name: z.string().min(1), name_i18n: nameI18n, dictionaryType, classificationId: z.string().optional(), sortKey: z.number().int().optional(), status: z.boolean().optional(), records: recordsArg,
+        },
+        execute: async (session, args) => {
+            const existing = (await wireCall(session, { path: ENDPOINTS.dictionaryGetByCode, query: { code: args.code } })).data;
+            if (!args.id && existing && typeof existing === "object" && Object.keys(existing).length > 0)
+                throw new ToolRefusalError({ status: "refused", blocker: "dictionary-create-duplicate", code: args.code, message: `字典 ${args.code} 已存在；更新请传 id` });
+            const submittedRecords = args.records;
+            const body = {
+                ...(args.id ? { id: args.id } : {}), code: args.code, name: args.name, name_i18n: JSON.stringify(args.name_i18n ?? { "zh-CN": args.name, en: args.name }), dictionaryType: args.dictionaryType,
+                classificationId: args.classificationId ?? "", sortKey: args.sortKey ?? 0, status: args.status ?? true,
+                records: (submittedRecords ?? []).map((record) => normalizeRecord(record)),
+            };
+            const performed = await wireCall(session, { path: ENDPOINTS.dictionarySave, method: "POST", body });
+            const after = (await wireCall(session, { path: ENDPOINTS.dictionaryGetByCode, query: { code: args.code } })).data;
+            // The create/update response only carries the header; the records the caller
+            // just sent are invisible unless they make another call (dogfood R3). Read
+            // them back here so "the header saved" cannot be mistaken for "the records
+            // were verified".
+            let recordsReadback = { totalElements: 0, totalPages: 0, content: [] };
+            try {
+                const stored = (await wireCall(session, { path: ENDPOINTS.dictionaryEnabledRecordsByCode, query: { code: args.code } })).data;
+                const all = (await wireCall(session, { path: ENDPOINTS.dictionaryRecordsByCode, query: { code: args.code, searchWord: "", page: "1", size: "200" } })).data;
+                // r28a F3：瘦投影 + 按 sortKey 排序；顺序不可依赖提交顺序。
+                recordsReadback = { ...recordsPage(all), enabledCount: Array.isArray(stored) ? stored.length : 0 };
+            }
+            catch {
+                // best-effort: the save itself is already authoritative; a record-read
+                // failure must not turn a landed write into a failure.
+            }
+            const readback = {
+                present: Boolean(after && Object.keys(after).length > 0),
+                dictionary: dictionaryView(after),
+                records: recordsReadback,
+                orderNote: RECORDS_ORDER_NOTE,
+            };
+            // r28a F13：records:[] 是增量 upsert 空操作，不会清空既有记录；顶层 ok 会
+            // 伪装成「清空成功」。只要调用方显式传了 []，就标 intentUnmet（不依赖
+            // 读回条数——部分 fake/版本族可能把 [] 当全量替换，平台真机不会）。
+            if (Array.isArray(submittedRecords) && submittedRecords.length === 0) {
+                readback.intentUnmet = true;
+                readback.intentUnmetReason = "records:[] 不会删除既有记录（平台无字典/记录删除端点，save 是增量 upsert）；请用 dictionary.status 逐条停用。";
+            }
+            return { performed: { errcode: performed.errcode }, readback };
+        },
+        rollback: dictionaryRollbackSpec("dictionary.save"),
     });
-    writeTool(tools, "dictionary.usage", LANE, TOOLS["dictionary.usage"].scope, TOOLS["dictionary.usage"].description, {
-        ids: z.array(z.string().min(1)).min(1).max(1000),
-    }, async (session, args) => {
-        const performed = await wireCall(session, { path: ENDPOINTS.dictionaryRecordUsed, method: "POST", body: { id: args.ids.join(";") } });
-        return { performed: { errcode: performed.errcode, ids: args.ids }, readback: { ids: args.ids, initialUsed: true } };
+    writeTool({
+        tools,
+        name: "dictionary.status",
+        lane: LANE,
+        scope: TOOLS["dictionary.status"].scope,
+        description: TOOLS["dictionary.status"].description,
+        inputSchema: {
+            target: z.enum(["dictionary", "record"]), id: z.string().min(1), status: z.boolean(),
+        },
+        execute: async (session, args) => {
+            const path = args.target === "dictionary" ? ENDPOINTS.dictionaryUpdateStatus : ENDPOINTS.dictionaryRecordStatus;
+            const performed = await wireCall(session, { path, method: "POST", body: { id: args.id, status: args.status } });
+            return { performed: { errcode: performed.errcode }, readback: { id: args.id, status: args.status } };
+        },
+    });
+    writeTool({
+        tools,
+        name: "dictionary.usage",
+        lane: LANE,
+        scope: TOOLS["dictionary.usage"].scope,
+        description: TOOLS["dictionary.usage"].description,
+        inputSchema: {
+            ids: z.array(z.string().min(1)).min(1).max(1000),
+        },
+        execute: async (session, args) => {
+            const performed = await wireCall(session, { path: ENDPOINTS.dictionaryRecordUsed, method: "POST", body: { id: args.ids.join(";") } });
+            return { performed: { errcode: performed.errcode, ids: args.ids }, readback: { ids: args.ids, initialUsed: true } };
+        },
     });
     tools.push(defineTool({
         name: "dictionary.parent",
@@ -264,53 +389,71 @@ export function registerDictionaryLane(tools) {
             return { detail: args.detail, classes: Array.isArray(data.data) ? data.data : [] };
         }),
     }));
-    writeTool(tools, "dictionary.class.save", LANE, TOOLS["dictionary.class.save"].scope, TOOLS["dictionary.class.save"].description, {
-        id: z.string().optional(), name: z.string().min(1), dictionaryIds: z.array(z.string()).optional(), sortKey: z.number().int().optional(),
-    }, async (session, args) => {
-        const performed = await wireCall(session, { path: ENDPOINTS.dictionaryClassSave, method: "POST", body: { ...(args.id ? { id: args.id } : {}), name: args.name, dictionaryIds: args.dictionaryIds ?? [], sortKey: args.sortKey ?? 0 } });
-        // Read back the created/updated class so the caller (and the audit trail)
-        // gets its id, not just the name it sent.
-        const listed = (await wireCall(session, { path: ENDPOINTS.dictionaryClasses, query: {} })).data;
-        const classes = Array.isArray(listed) ? listed : [];
-        const saved = classes.find((entry) => entry.name === args.name && (args.id === undefined || entry.id === args.id)) ?? classes.find((entry) => entry.name === args.name);
-        return { performed: { errcode: performed.errcode }, readback: { present: saved !== undefined, id: saved?.id, name: args.name, dictionaryIds: args.dictionaryIds ?? [] } };
-    }, undefined, undefined, dictionaryRollbackSpec("dictionary.class.save"));
-    writeTool(tools, "dictionary.class.delete", LANE, TOOLS["dictionary.class.delete"].scope, TOOLS["dictionary.class.delete"].description, {
-        ids: z.array(z.string().min(1)).min(1),
-    }, async (session, args) => {
-        // The platform's deleteDictionaryClass(Batch) answers errcode 0 for ANY id —
-        // a dictionary id, a typo, anything — while deleting nothing. Writing
-        // `absent: true` unconditionally turned that into a silent false success
-        // (2026-10-30 probe: passing a dictionary id reported success and left the
-        // object in place). Verify the inputs are class ids BEFORE the write and
-        // derive absence from a post-delete read.
-        const classIds = async () => {
+    writeTool({
+        tools,
+        name: "dictionary.class.save",
+        lane: LANE,
+        scope: TOOLS["dictionary.class.save"].scope,
+        description: TOOLS["dictionary.class.save"].description,
+        inputSchema: {
+            id: z.string().optional(), name: z.string().min(1), dictionaryIds: z.array(z.string()).optional(), sortKey: z.number().int().optional(),
+        },
+        execute: async (session, args) => {
+            const performed = await wireCall(session, { path: ENDPOINTS.dictionaryClassSave, method: "POST", body: { ...(args.id ? { id: args.id } : {}), name: args.name, dictionaryIds: args.dictionaryIds ?? [], sortKey: args.sortKey ?? 0 } });
+            // Read back the created/updated class so the caller (and the audit trail)
+            // gets its id, not just the name it sent.
             const listed = (await wireCall(session, { path: ENDPOINTS.dictionaryClasses, query: {} })).data;
-            return new Set((Array.isArray(listed) ? listed : [])
-                .map((entry) => (typeof entry.id === "string" ? entry.id : ""))
-                .filter((id) => id !== ""));
-        };
-        const before = await classIds();
-        const unmatched = args.ids.filter((id) => !before.has(id));
-        if (unmatched.length > 0) {
-            throw new ToolRefusalError({
-                status: "refused",
-                blocker: "dictionary-class-absent",
-                ids: args.ids,
-                unmatched,
-                candidates: [...before].slice(0, 20),
-                message: `${unmatched.join("、")} 不是字典分类 id（删前分类列表里没有它）。平台 deleteDictionaryClass 对任意 id 都回 errcode 0 却不删任何行——传字典 id 会假成功。现有分类候选：${[...before].slice(0, 20).join("、") || "（当前没有分类）"}。另：字典本体与字典项平台无删除端点，只能 dictionary.status 停用。`,
-            });
-        }
-        const path = args.ids.length === 1 ? ENDPOINTS.dictionaryClassDelete : ENDPOINTS.dictionaryClassDeleteBatch;
-        const body = args.ids.length === 1 ? { id: args.ids[0] } : { ids: args.ids };
-        const performed = await wireCall(session, { path, method: "POST", body });
-        const after = await classIds();
-        const stillPresent = args.ids.filter((id) => after.has(id));
-        return {
-            performed: { errcode: performed.errcode, ids: args.ids },
-            readback: { absent: stillPresent.length === 0, ids: args.ids, ...(stillPresent.length > 0 ? { stillPresent } : {}) },
-        };
-    }, undefined, undefined, dictionaryRollbackSpec("dictionary.class.delete"));
+            const classes = Array.isArray(listed) ? listed : [];
+            const saved = classes.find((entry) => entry.name === args.name && (args.id === undefined || entry.id === args.id)) ?? classes.find((entry) => entry.name === args.name);
+            return { performed: { errcode: performed.errcode }, readback: { present: saved !== undefined, id: saved?.id, name: args.name, dictionaryIds: args.dictionaryIds ?? [] } };
+        },
+        rollback: dictionaryRollbackSpec("dictionary.class.save"),
+    });
+    writeTool({
+        tools,
+        name: "dictionary.class.delete",
+        lane: LANE,
+        scope: TOOLS["dictionary.class.delete"].scope,
+        description: TOOLS["dictionary.class.delete"].description,
+        inputSchema: {
+            ids: z.array(z.string().min(1)).min(1),
+        },
+        execute: async (session, args) => {
+            // The platform's deleteDictionaryClass(Batch) answers errcode 0 for ANY id —
+            // a dictionary id, a typo, anything — while deleting nothing. Writing
+            // `absent: true` unconditionally turned that into a silent false success
+            // (2026-10-30 probe: passing a dictionary id reported success and left the
+            // object in place). Verify the inputs are class ids BEFORE the write and
+            // derive absence from a post-delete read.
+            const classIds = async () => {
+                const listed = (await wireCall(session, { path: ENDPOINTS.dictionaryClasses, query: {} })).data;
+                return new Set((Array.isArray(listed) ? listed : [])
+                    .map((entry) => (typeof entry.id === "string" ? entry.id : ""))
+                    .filter((id) => id !== ""));
+            };
+            const before = await classIds();
+            const unmatched = args.ids.filter((id) => !before.has(id));
+            if (unmatched.length > 0) {
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "dictionary-class-absent",
+                    ids: args.ids,
+                    unmatched,
+                    candidates: [...before].slice(0, 20),
+                    message: `${unmatched.join("、")} 不是字典分类 id（删前分类列表里没有它）。平台 deleteDictionaryClass 对任意 id 都回 errcode 0 却不删任何行——传字典 id 会假成功。现有分类候选：${[...before].slice(0, 20).join("、") || "（当前没有分类）"}。另：字典本体与字典项平台无删除端点，只能 dictionary.status 停用。`,
+                });
+            }
+            const path = args.ids.length === 1 ? ENDPOINTS.dictionaryClassDelete : ENDPOINTS.dictionaryClassDeleteBatch;
+            const body = args.ids.length === 1 ? { id: args.ids[0] } : { ids: args.ids };
+            const performed = await wireCall(session, { path, method: "POST", body });
+            const after = await classIds();
+            const stillPresent = args.ids.filter((id) => after.has(id));
+            return {
+                performed: { errcode: performed.errcode, ids: args.ids },
+                readback: { absent: stillPresent.length === 0, ids: args.ids, ...(stillPresent.length > 0 ? { stillPresent } : {}) },
+            };
+        },
+        rollback: dictionaryRollbackSpec("dictionary.class.delete"),
+    });
 }
 //# sourceMappingURL=dictionary.js.map

package/dist/lanes/environment.js

@@ -31,8 +31,19 @@ export function registerEnvironmentLane(tools) {
             // 2–3 次 wire（r31–r37 每会话重新盘点的纯浪费）。refresh:true 强制重查。
             if (args.refresh !== true && args.applicationCode === undefined && args.modelCode === undefined && args.full !== true) {
                 const cached = readProjectCard(ctx.artifactsDir, String(args.environment ?? session.environmentName ?? ""));
-                if (cached !== undefined)
-                    return { ...cached, status: "ok", fromCache: true };
+                if (cached !== undefined) {
+                    // r28b F16（真机 2026-11-05，本轮复现）：实时读回给 `modelsCount`，
+                    // 缓存命中给 `modelCount`——同一个键换条路径就换名字，脚本 `r["modelsCount"]`
+                    // 直接 KeyError，基线对比也说不清是模型变了还是口径变了。
+                    // 缓存是加速，不是第二套契约：键名与实时读对齐，旧键保留不破既有调用方。
+                    const { modelCount, ...rest } = cached;
+                    return {
+                        ...rest,
+                        ...(typeof modelCount === "number" ? { modelsCount: modelCount, modelCount } : {}),
+                        status: "ok",
+                        fromCache: true,
+                    };
+                }
             }
             // List every application the tenant exposes — the configured
             // applicationCode is a default, never the only application. Resolve
@@ -146,6 +157,11 @@ export function registerEnvironmentLane(tools) {
                     writeProjectCard(ctx.artifactsDir, {
                         environment: envName,
                         applicationCode: selected,
+                        // r28k F2：缓存命中必须与实时读**同形**，否则同工具同参数第二次
+                        // 调用的 result 键集就变了（applications 消失 → --jq 直接 pathMiss）。
+                        applications: apps,
+                        groups,
+                        applicationGroups: { status: groupStatus.status },
                         ...(applicationResolution !== undefined ? { applicationResolution: { code: String(selected ?? applicationResolution.requested ?? ""), source: String(applicationResolution.source ?? "") } } : {}),
                         models: discovered.models.slice(0, 300).map((row) => ({ code: String(row.schemaCode), name: String(row.name ?? "") })),
                         modelCount: discovered.models.length,
@@ -153,18 +169,46 @@ export function registerEnvironmentLane(tools) {
                     });
                 }
             }
-            return discovered;
+            return {
+                ...discovered,
+                // r28k F3：裸 hex 不解自用。指纹是 (env, origin, application, enterprise)
+                // 的规范 sha256——绑定写计划 / intent plan 漂移门 / draft 写前复核 /
+                // 读回缓存键；它不是审批令牌。
+                fingerprintHint: FINGERPRINT_HINT,
+            };
         }, {
             full: args.full === true,
             target: `discover_environment:${args.applicationCode ?? ""}:${args.modelCode ?? ""}`,
             compact: (result) => {
+                // r28k F1（真机 2026-11-05）：旧 compact 把 applications/foldersAndModels/models
+                // 全删掉，再由 read.ts 的占位补回 `[]`——与「确实没有应用」同形，只能靠
+                // truncated:true 旁证。应用通常个位数，内联完全值得；大表才标 *Omitted。
                 const compact = { ...result };
-                for (const key of ["applications", "groups", "foldersAndModels", "models"]) {
+                const apps = compact.applications;
+                if (Array.isArray(apps)) {
+                    compact.applicationsCount = apps.length;
+                    // 保留完整 applications（个位数）；不删 key，避免占位 [] 覆盖。
+                }
+                const groups = compact.groups;
+                if (Array.isArray(groups)) {
+                    compact.groupsCount = groups.length;
+                    // groups 通常更小，一并内联。
+                }
+                for (const key of ["foldersAndModels", "models"]) {
                     const value = compact[key];
-                    if (Array.isArray(value)) {
-                        compact[`${key}Count`] = value.length;
-                        delete compact[key];
-                    }
+                    if (!Array.isArray(value))
+                        continue;
+                    compact[`${key}Count`] = value.length;
+                    // 保留 key 但置 null + *Omitted，形状上区别于真实空数组 []；
+                    // key 仍在 payload 里，read.ts 不会再补空占位。
+                    compact[key] = null;
+                    compact[`${key}Omitted`] = true;
+                }
+                if (compact.foldersAndModelsOmitted === true || compact.modelsOmitted === true) {
+                    compact.tablesHint = "foldersAndModels/models 已外置（*Omitted:true，不是空表）；用 detailArtifactId 的 `omc artifact get <id> --jq <key>` 或同次 call 加 --jq/--extract 取回。applications/groups 已内联。";
+                }
+                if (typeof compact.environmentFingerprint === "string" && compact.fingerprintHint === undefined) {
+                    compact.fingerprintHint = FINGERPRINT_HINT;
                 }
                 return compact;
             },
@@ -176,12 +220,16 @@ export function registerEnvironmentLane(tools) {
         kind: "read",
         lane: ENVIRONMENT_LANE,
         scope: ENVIRONMENT_TOOLS["environment.fingerprint"].scope,
-        description: ENVIRONMENT_TOOLS["environment.fingerprint"].description,
+        // r28k F3：用途放首句，避免 summary 在第一个英文句号处截断。
+        description: `${FINGERPRINT_HINT} ${ENVIRONMENT_TOOLS["environment.fingerprint"].description}`,
         inputSchema: { environment: environmentArg, capability: capabilityArg },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => ({
             environment: session.environmentName,
             fingerprint: session.environmentFingerprint(),
+            fingerprintHint: FINGERPRINT_HINT,
         })),
     }));
 }
+/** r28k F3 — 指纹用途一句话（回执 + describe 共用，避免两处漂移）。 */
+const FINGERPRINT_HINT = "用途：写前/写后漂移检测（intent plan、draft 复核）、写计划与审计 artifact 绑定、读回缓存键，随 env/origin/application/enterprise 变，不是审批令牌。";
 //# sourceMappingURL=environment.js.map