@stalfh233/omc-cli 0.6.7 → 0.6.10

package/dist/lanes/meta.js

@@ -3,6 +3,7 @@ import { environmentArg } from "../args.js";
 import { environmentNotice, environmentWritable, requiresProductionConfirmation } from "../environment-policy.js";
 import { removedProfileKeys } from "../config-store.js";
 import { defineTool } from "../tool-types.js";
+import { unsupportedCapabilities } from "../version-family-gaps.js";
 import { META_LANE_CONTRACT } from "./meta-contract.js";
 const META_TOOLS = META_LANE_CONTRACT.tools;
 export function registerMetaLane(tools) {
@@ -10,11 +11,29 @@ export function registerMetaLane(tools) {
         name: "coverage.manifest",
         layer: "meta",
         kind: "meta",
-        description: META_TOOLS["coverage.manifest"].description,
-        inputSchema: { full: z.boolean().optional().describe("返回完整覆盖投影；默认返回紧凑摘要") },
+        // r28k F5：manifest 是 lane 粒度，不是 capability id（放首句，避免 summary 截断吞掉）。
+        description: `Indexed by lane (not capability id, one lane may have multiple rows) — for "can X be used?" use omc capability <id>. ${META_TOOLS["coverage.manifest"].description}`,
+        inputSchema: {
+            full: z.boolean().optional().describe("返回完整覆盖投影；默认返回紧凑摘要"),
+            // r28k F6（真机 2026-11-05）：探针传 `{"capability":"report"}` 想按能力过滤，
+            // schema 只有 full，参数被**静默丢弃**，拿到 46 项还以为已过滤——多读 6.3KB。
+            // 与其拒绝，不如真的过滤：manifest 行本身就有 capability 字段（免费）。
+            capability: z.string().optional().describe("按能力名过滤（大小写不敏感，子串匹配 capability 字段）；lane 请用 omc capability <id>"),
+            lane: z.string().optional().describe("按 lane 名过滤（子串匹配）"),
+        },
         handler: async (ctx, args) => {
             const full = args.full === true;
-            const items = ctx.manifest.items.map((item) => full
+            const capabilityFilter = typeof args.capability === "string" && args.capability.trim() !== "" ? args.capability.trim().toLowerCase() : undefined;
+            const laneFilter = typeof args.lane === "string" && args.lane.trim() !== "" ? args.lane.trim().toLowerCase() : undefined;
+            // r28k F6：过滤后为空要当成**没命中**说出来，别回一个看起来正常的空清单。
+            const matched = ctx.manifest.items.filter((item) => (capabilityFilter === undefined || String(item.capability ?? "").toLowerCase().includes(capabilityFilter)) &&
+                (laneFilter === undefined || String(item.lane ?? "").toLowerCase().includes(laneFilter)));
+            const filterNote = capabilityFilter === undefined && laneFilter === undefined
+                ? undefined
+                : matched.length === 0
+                    ? { filtered: { capability: capabilityFilter ?? null, lane: laneFilter ?? null }, matched: 0, hint: `没有 capability/lane 命中「${capabilityFilter ?? laneFilter}」。manifest 的 capability 是**能力描述名**（如 "Report builder"），不是能力 id；按 id 查用 omc capability <id>` }
+                    : { filtered: { capability: capabilityFilter ?? null, lane: laneFilter ?? null }, matched: matched.length, total: ctx.manifest.items.length };
+            const items = matched.map((item) => full
                 ? {
                     lane: item.lane,
                     capability: item.capability,
@@ -36,6 +55,7 @@ export function registerMetaLane(tools) {
                         version_family: ctx.manifest.version_family,
                         anchor_version: ctx.manifest.anchor_version,
                         items,
+                        ...(filterNote !== undefined ? { filter: filterNote } : {}),
                     },
                 };
             }
@@ -50,7 +70,8 @@ export function registerMetaLane(tools) {
                     anchor_version: ctx.manifest.anchor_version,
                     counts: { total: items.length, byStatus },
                     items,
-                    hint: "coverage.manifest full:true 取完整投影（含 scope/reason/tools/scopes）；lane 能力面用 omc capabilities / omc capability <id>；工具清单用 commands --json --compact",
+                    ...(filterNote !== undefined ? { filter: filterNote } : {}),
+                    hint: "manifest 按 lane 索引（同一 lane 可有多行细项，status 不统一），不是 capability id；答「X 能力能不能用」请用 omc capability <id> / omc capabilities。full:true 取完整投影（scope/reason/tools）；工具清单用 commands --json --compact",
                 },
             };
         },
@@ -59,7 +80,8 @@ export function registerMetaLane(tools) {
         name: "get_status",
         layer: "high",
         kind: "meta",
-        description: META_TOOLS["get_status"].description,
+        // r28k F4：doctor vs get_status 分流（放首句，避免 summary 截断吞掉）。
+        description: `分流：覆盖率/环境边界/租约用本工具，逐项中文 checks 与缺口明细用 doctor。 ${META_TOOLS["get_status"].description}`,
         inputSchema: { environment: environmentArg },
         handler: async (ctx, args, self) => {
             const store = ctx.sessions.config();
@@ -103,6 +125,8 @@ export function registerMetaLane(tools) {
                 credentialsMode: store.credentialsMode(),
                 session: sessionState,
                 coverage: { total: ctx.manifest.items.length, byStatus: statusCounts },
+                // r28k F9：与 doctor 同形挂一份（含 coverageClaimMeaning），避免只跑 get_status 就看不到缺口语义。
+                unsupportedCapabilities: unsupportedCapabilities(ctx.manifest, typeof sessionState.version === "string" ? sessionState.version : undefined),
                 writeLease: { activeHolder: ctx.lease.holder(resolved.name) ?? null },
             };
         },
@@ -202,7 +226,8 @@ export function registerMetaLane(tools) {
         name: "doctor",
         layer: "meta",
         kind: "meta",
-        description: META_TOOLS["doctor"].description,
+        // r28k F4：与 get_status 分流（放首句）。
+        description: `分流：体检用本工具（逐项中文 checks + unsupportedCapabilities），覆盖率/环境边界/租约用 get_status。 ${META_TOOLS["doctor"].description}`,
         inputSchema: { environment: environmentArg, serviceCode: z.string().min(1).optional().describe("可选：体检单个业务集成服务的鉴权参数形状（掩码/占位/全 0 检出；非致命 WARN）") },
         handler: async (ctx, args, self) => {
             const store = ctx.sessions.config();

package/dist/lanes/model-contract.js

@@ -7,7 +7,7 @@ import { LANES } from "./lane-ids.js";
  */
 export const MODEL_WIRE = Object.freeze({
     createBody: "bizmodels/create carries appCode, parentId (folder), modelType, bizSchemaCode, icon, name_i18n, pcAble/mobileAble, options{statisticEnabled:false}",
-    readback: "exits_bizschema readback via apppackage/trees (type==='BizModel' && code===schemaCode)",
+    readback: "exits_bizschema readback via apppackage/trees (type==='BizModel' && code===schemaCode); model.create readback carries {present,schemaCode,folderId,path[,displayPath]} using the same flattenFolders path face as folder.tree",
     folderResolution: "explicit folderId（树行 id 或目录 code，经 applicationTree 归一为树行 id；未命中 → model-create-folder-unresolved）> first non-BizModel tree node (auto-default-folder)；none found → 302001。注意 apppackage/list 的目录键是 code、trees 的键是 id，跨读面传值必须归一",
     deleteBody: "apppackage/physically_delete body [{id,code,type:'BizModel'}] where id MUST be the app-tree node id (AppFunction id)",
     deleteIdNamespace: "physically_delete resolves each row id as an AppFunction id (removeBizModel → getAppFunction(id), AppIntegrationFacadeImpl) and answers 601003 业务模型不存在 for a biz-model record id; the two id spaces are NOT interchangeable. model.delete/deleteMany resolve the node across applications (default app first, then applicationList per-app trees) and refuse fail-closed with model-application-unresolved when the record exists but no tree node does — never guessing a record id",