@stalfh233/omc-cli 0.5.11 → 0.5.12

package/dist/cli-contract.js

@@ -256,7 +256,7 @@ export function classifyResult(result) {
         const suffix = candidates.length > 0 ? `；did you mean: ${candidates.join("、")}` : "；用 `omc commands --json --compact --lane <lane>` 或 `omc next` 定位工具";
         return { status: "error", error: withNext({ code: "invalid-input", message: `unknown tool ${String(result.tool ?? "")}${suffix}`, retryable: false }), exitCode: CLI_EXIT_CODES.invalidInput };
     }
-    if (result.blocker === "tool-input-invalid")
+    if (result.blocker === "tool-input-invalid" || result.blocker === "tool-input-unknown-keys")
         return {
             status: "error",
             error: { ...withNext({ code: "invalid-input", message: String(result.message ?? "tool input is invalid"), retryable: false }), nextCommand: `omc describe ${String(result.tool ?? "<tool>")}` },

package/dist/cli.js

@@ -42,7 +42,7 @@ import { absencePointer } from "./capability-absences.js";
 import { intentConfigRoot, readIntentFile, validateIntentText } from "./intent/cli.js";
 import { intentSchemaBlock, intentExample, intentExampleIds } from "./intent/schema.js";
 import { planIntent, readbackIntent, applyIntent, intentWarnings } from "./intent/plan-apply.js";
-import { listSkills, readSkill, readSkillOutline, readSkillSection, searchSkills } from "./skills.js";
+import { listSkills, readSkill, readSkillOutline, readSkillSection, searchSkills, suggestHelpTopics } from "./skills.js";
 import { parseToolInput, ToolInputError } from "./tool-types.js";
 import { WireError, wireCall } from "./wire.js";
 import { DEFAULT_PULL_CONCURRENCY, GraphIndexAbsentError, GraphPullLockHeldError, MAX_PULL_CONCURRENCY, impactGraph, publishGraphPull, queryGraphReferences, readGraphStatus, searchGraphRules, } from "./graph.js";
@@ -204,7 +204,7 @@ async function cmdDoctor(store, environment, serviceCode) {
             const errcode = error instanceof WireError ? error.errcode : undefined;
             if (errcode === 109001 || /许可证|license/i.test(error.message)) {
                 ok = false;
-                steps.push(`许可证    FAIL 已过期（平台拒绝 apppackage/list：${String(errcode ?? "")}）——续期或更换环境；否则几乎全部读面与所有写面都会被 109001 拒绝`);
+                steps.push(`许可证    FAIL 已过期（平台拒绝 apppackage/list：${String(errcode ?? "")}）——续期或更换环境。注意：109001 是**分面拦截**不是全环境不可用（r40 实证：报表/集成/部分读面被拒，模型/字段/数据面仍可交付）——不要因本项 FAIL 一刀切停步，按需逐面探测并用最小写验证`);
             }
             else {
                 ok = false;
@@ -1361,7 +1361,8 @@ function cmdHelpSearch(topic, query, transport, searchMode, limit) {
     if (singleSection !== undefined) {
         const sliced = readSkillSection(topic, singleSection);
         if (sliced === undefined) {
-            const message = `未知 topic "${topic}"；可用 topic：${topics.map((entry) => entry.name).join("、")}（命令清单见 omc help commands）${commandPointer}`;
+            const suggestions = suggestHelpTopics(topic);
+            const message = `未知 topic "${topic}"；可用 topic：${topics.map((entry) => entry.name).join("、")}（命令清单见 omc help commands）${commandPointer}${suggestions.length > 0 ? `；你可能要找：${suggestions.join("、")}` : ""}`;
             console.error(`help: ${message}`);
             return emitInvalid(transport, { message });
         }
@@ -1382,7 +1383,8 @@ function cmdHelpSearch(topic, query, transport, searchMode, limit) {
     }
     const document = readSkill(topic);
     if (document === undefined) {
-        const message = `未知 topic "${topic}"；可用 topic：${topics.map((entry) => entry.name).join("、")}（命令清单见 omc help commands）${commandPointer}`;
+        const suggestions = suggestHelpTopics(topic);
+        const message = `未知 topic "${topic}"；可用 topic：${topics.map((entry) => entry.name).join("、")}（命令清单见 omc help commands）${commandPointer}${suggestions.length > 0 ? `；你可能要找：${suggestions.join("、")}` : ""}`;
         console.error(`help: ${message}`);
         return emitInvalid(transport, { message });
     }

package/dist/lanes/workflow.js

@@ -1423,6 +1423,23 @@ async function refuseRequiredOnChildTableFields(session, schemaCode, template, t
  * same edge). This is the "read back, then send the delta" path — without it a
  * subset silently REPLACED the whole activity list and dropped nodes.
  */
+function refusePartialBtnConfigList(activities) {
+    // r32 实证（backlog 清算批）：btnConfigList 局部行=整行替换——只传 {code, remark}
+    // 会把 enabled 静默置 false、commentPermission 置 null（驳回意见必填丢失）。
+    // fail-closed：按钮行不带显式 enabled 一律拒绝，指路 hazards 的整行回写法。
+    for (const activity of activities) {
+        const rows = activity.btnConfigList;
+        if (!Array.isArray(rows))
+            continue;
+        const partial = rows.filter((row) => row !== null && typeof row === "object" && !("enabled" in row));
+        if (partial.length > 0)
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "workflow-btnconfig-partial-row",
+                message: `workflow.update: 节点 ${String(activity.activityCode ?? activity.id ?? "")} 的 btnConfigList 存在不带 enabled 的按钮行（${partial.map((row) => String(row.code ?? "?")).join("、")}）——该平台按**整行替换**处理，缺省键会被静默重置（enabled→false、commentPermission→null）。先 workflow.get_published/get_draft 取该按钮整行，改目标属性后整条回写（见 omc help omc-write-hazards --section 按钮）。`,
+            });
+    }
+}
 function mergeCallerDelta(template, draft, options = {}) {
     const { routes: routesRaw, rules: rulesRaw, activities: _raw, edges: edgesRaw, ...rest } = template;
     // `routes` and `edges` are the recipe spellings; `rules` is the platform DTO
@@ -1486,6 +1503,7 @@ function mergeCallerDelta(template, draft, options = {}) {
         return { ...activity, ...override };
     });
     const newActivities = [...callerByOriginal.values()];
+    refusePartialBtnConfigList([...mergedActivities, ...newActivities]);
     // A caller-only code that arrived WITHOUT a type has no draft row to inherit
     // from — refuse it here (the lint allows type-less permission-shape rows
     // precisely because they are expected to match an existing node).
@@ -1595,6 +1613,8 @@ function normalizeWorkflowTemplate(template, draft, options = {}) {
     // comment); give every changed/new node a fresh code, and remap caller routes
     // so they follow.
     const reconciled = rawCaller ? reconcileCallerActivityCodes(rawCaller, draftActivities, options) : undefined;
+    if (rawCaller !== undefined)
+        refusePartialBtnConfigList(rawCaller);
     const activities = reconciled?.activities;
     const codeMap = reconciled?.codeMap ?? new Map();
     const remapCode = (value) => codeMap.get(String(value ?? "")) ?? value;

package/dist/skills.js

@@ -48,6 +48,57 @@ export function listSkills() {
         return { name, description };
     });
 }
+/**
+ * r43 后 backlog：`omc help 编号` 曾零命中（高频中文业务词不是 topic 名）。
+ * 双路建议：①精选同义词表（高频业务词→topic，r24–r43 探针实测检索失败样本）
+ * ②全 topic 节标题子串扫描（自维护——节名改了建议跟着变）。
+ */
+const HELP_TOPIC_SYNONYMS = Object.freeze({
+    编号: ["omc-capabilities"],
+    序列号: ["omc-capabilities"],
+    单号: ["omc-capabilities"],
+    流水号: ["omc-capabilities"],
+    自动编号: ["omc-capabilities"],
+    审批: ["omc-five-piece-flow"],
+    流程: ["omc-five-piece-flow"],
+    回写: ["omc-business-configuration"],
+    跨模型: ["omc-business-configuration"],
+    规则: ["omc-business-configuration"],
+    字典: ["omc-business-configuration"],
+    权限: ["omc-business-configuration"],
+    视图: ["omc-write-hazards"],
+    过滤: ["omc-write-hazards"],
+    条件: ["omc-write-hazards"],
+    删除: ["omc-write-hazards"],
+    清理: ["omc-write-hazards"],
+    子表: ["omc-write-hazards"],
+    表单: ["omc-write-hazards"],
+    验收: ["omc-acceptance-criteria"],
+    入门: ["omc-start-here"],
+    拒绝: ["omc-refusals"],
+});
+export function suggestHelpTopics(query) {
+    if (query === undefined || query.length === 0)
+        return [];
+    const hits = new Set(HELP_TOPIC_SYNONYMS[query] ?? []);
+    for (const skill of listSkills()) {
+        if (skill.name.includes(query) || (skill.description ?? "").includes(query))
+            hits.add(skill.name);
+    }
+    // 节标题扫描：`omc help <topic> --section "<heading>"` 直达
+    for (const name of listSkills().map((skill) => skill.name)) {
+        const outline = readSkillOutline(name);
+        if (outline === undefined)
+            continue;
+        for (const section of outline.sections) {
+            if (section.heading.includes(query)) {
+                hits.add(`omc help ${name} --section "${section.heading}"`);
+                break;
+            }
+        }
+    }
+    return [...hits].slice(0, 5);
+}
 /** Read one methodology topic for `omc help <topic>`. */
 export function readSkill(name) {
     if (!/^[a-z0-9-]+$/.test(name))

package/dist/tool-types.js

@@ -91,6 +91,9 @@ function applyInputAliases(tool, input) {
             continue;
         normalized ??= { ...input };
         normalized[canonical] = input[hit];
+        // 同义词键就地删除：归一后的输入只留规范键——写面未知键 fail-closed
+        // （r43 后）不把已消费的同义词误报成未知键。
+        delete normalized[hit];
     }
     return normalized ?? input;
 }
@@ -111,8 +114,53 @@ function keyRenameHint(issuePath, input, tool) {
     // "你传的是 schemaCode", which pointed at the wrong key.
     return `（该对象在本工具里的键是 ${key}，你传的是 ${synonyms.join("/")}；键名对照见 omc-tool-selection 的 Key-name table）`;
 }
+/** Cheap closest-key suggestion: exact→prefix→shared-start bigrams, threshold keeps it honest. */
+function closestSchemaKey(key, schemaKeys) {
+    if (schemaKeys.has(key))
+        return key;
+    let best;
+    let bestScore = 0;
+    for (const candidate of schemaKeys) {
+        const lower = key.toLowerCase();
+        const candLower = candidate.toLowerCase();
+        let score = 0;
+        if (candLower.startsWith(lower) || lower.startsWith(candLower))
+            score = 0.9;
+        else if (candLower.includes(lower) || lower.includes(candLower))
+            score = 0.7;
+        else {
+            let shared = 0;
+            for (let i = 0; i + 2 <= lower.length; i++)
+                if (candLower.includes(lower.slice(i, i + 2)))
+                    shared++;
+            score = lower.length > 2 ? shared / (lower.length - 1) : 0;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            best = candidate;
+        }
+    }
+    return bestScore >= 0.4 ? best : undefined;
+}
 export function parseToolInput(tool, input) {
     const normalized = applyInputAliases(tool, input);
+    // r30 引出、r42/r43 再证：静默丢弃错键是头号返工源（dictionary.save items
+    // 未知键、跨模型 filterCondition 错键同族）。写面 fail-closed——未知顶层键
+    // 当场拒绝并给最接近的合法键提示；读面保持宽松（探查性调用常见无害附加）。
+    if (tool.kind === "write") {
+        const schemaKeys = new Set(Object.keys(tool.inputSchema));
+        const unknown = Object.keys(normalized).filter((key) => !schemaKeys.has(key));
+        if (unknown.length > 0) {
+            const suggestions = unknown.map((key) => `${key}→${closestSchemaKey(key, schemaKeys) ?? "（无相近键，omc describe <tool> 看参数表）"}`);
+            throw new ToolInputError({
+                status: "error",
+                blocker: "tool-input-unknown-keys",
+                tool: tool.name,
+                message: `写面工具不接受未知键（会被静默丢弃）：${unknown.join("、")}。最接近的合法键：${suggestions.join("；")}。参数表：omc describe ${tool.name}`,
+                issues: unknown.map((key) => ({ path: [key], code: "unrecognized_key", message: `unknown key; closest: ${closestSchemaKey(key, schemaKeys) ?? "none"}` })),
+            });
+        }
+    }
     const result = z.object(tool.inputSchema).safeParse(normalized);
     if (result.success)
         return result.data;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -52,9 +52,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@stalfh233/omc-fake-platform": "0.5.11",
+    "@stalfh233/omc-fake-platform": "0.5.12",
     "commander": "14.0.3",
-    "omc-core": "0.5.11",
+    "omc-core": "0.5.12",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",