@stalfh233/omc-cli 0.6.20 → 0.6.22

package/dist/cli.js

@@ -23,7 +23,7 @@ import { formatDoctorHumanSummary, unsupportedCapabilities } from "./version-fam
 import { beginWriteFace, configureOutput, endWriteFace, humanSummary, maybeWarnMergedStreams, stripOutputFlags, writeEnvelope } from "./cli-output.js";
 import { beginUsage, completeUsage, currentUsageArgsDigest, ensureProjectIgnore, priorIdenticalSuccess, recordUsageOutput, usageReport } from "./usage-log.js";
 import { artifactFetchHint, artifactRoot, boundResult, emitInvalid, emitResult, emitThrown, emitTransportResult, outputBudget, readArtifact, withTransport, } from "./command-transport.js";
-import { CLI_DEFAULT_OUTPUT_BYTES, assertSafeOutputPath, pruneArtifacts } from "./artifacts.js";
+import { CLI_DEFAULT_OUTPUT_BYTES, assertSafeOutputPath, createArtifact, pruneArtifacts } from "./artifacts.js";
 import { artifactPathMissHint, nullProjectionHint, partialPathMissHint, projectJsonPath, projectJsonPathFanout, projectResultExtract } from "./path-projection.js";
 import { basename, join, resolve } from "node:path";
 import { buildToolRegistry } from "./tools.js";
@@ -56,7 +56,7 @@ import { planIntent, readbackIntent, applyIntent, intentWarnings } from "./inten
 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";
+import { DEFAULT_PULL_CONCURRENCY, GraphIndexAbsentError, GraphPullLockHeldError, MAX_PULL_CONCURRENCY, impactGraph, publishGraphPull, queryGraphReferences, queryGraphReferencesBatch, queryGraphEdges, readGraphStatus, searchGraphRules, } from "./graph.js";
 import { cmdResidue } from "./residue.js";
 import { ENDPOINTS } from "./endpoints.js";
 import { makeToolContext } from "./context.js";
@@ -802,6 +802,24 @@ async function cmdCall(store, args) {
         // Do not also copy the single-path value to top-level content.
         if (extractPaths.length > 0 && !extractKeys && typeof result === "object" && result !== null)
             delete result.content;
+        // r40a: unsupported jq language is an input error, never an `ok:true`
+        // projection with a null value.  Keep the path engine's detailed hint but
+        // make the CLI contract actionable and machine-classifiable.
+        if (typeof result === "object" && result !== null && Array.isArray(result.extract)) {
+            for (const entry of result.extract)
+                delete entry.autoStripped;
+            const unsupported = result.extract.filter((entry) => entry.unsupportedSyntax === true);
+            if (unsupported.length > 0) {
+                const first = unsupported[0];
+                const message = `--jq 只接受路径选择器，不支持对象构造或管道语法（${String(first?.path ?? "")}）。可运行示例：--jq 'fields[].code,fields[].typeName'`;
+                const invalid = { status: "error", blocker: "tool-input-invalid", unsupportedSyntax: true, paths: unsupported.map((entry) => entry.path), message, nextCommand: "omc call <tool> --args '<json>' --jq 'fields[].code,fields[].typeName'" };
+                return emit("error", invalid, CLI_EXIT_CODES.invalidInput);
+            }
+        }
+        // `extract[]` is the canonical multi-path result.  Do not emit the second
+        // row-alignment copy: callers can align the explicitly named path values.
+        if (typeof result === "object" && result !== null && extractPaths.length > 1)
+            delete result.rows;
     }
     // 读面未知键的非阻断回显：放在投影**之后**，否则会被 --jq 的窄投影吞掉。
     if (ignoredReadKeys.length > 0 && typeof result === "object" && result !== null) {
@@ -1586,14 +1604,20 @@ async function cmdIntentReadback(file, environment, transport) {
  * registry or `commands --json`. Results are candidate pointers only — plan /
  * apply / readback keep reading the live baseline.
  */
-async function cmdGraphPull(environment, concurrency, transport) {
+async function cmdGraphPull(environment, concurrency, transport, path, applicationCodes, allApplications = false) {
     const workers = concurrency ?? DEFAULT_PULL_CONCURRENCY;
     if (!Number.isSafeInteger(workers) || workers < 1 || workers > MAX_PULL_CONCURRENCY)
         return emitInvalid(transport, { message: `--concurrency 必须是 1–${MAX_PULL_CONCURRENCY} 的整数（平台负载有界；默认 ${DEFAULT_PULL_CONCURRENCY}）` });
     const context = makeToolContext({ sessions: new SessionManager(new ConfigStore(defaultPaths())) });
     try {
         const session = await context.sessions.session(environment);
-        const data = await publishGraphPull(session, workers);
+        let selected = applicationCodes;
+        if (allApplications) {
+            const apps = (await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data;
+            const rows = Array.isArray(apps) ? apps : (apps && typeof apps === "object" && Array.isArray(apps.data) ? apps.data : []);
+            selected = rows.map((row) => String(row.appCode ?? row.code ?? "")).filter(Boolean);
+        }
+        const data = await publishGraphPull(session, workers, { ...(selected ? { applicationCodes: selected } : {}) });
         // issue#9 C4：扫到 0 模型仍回 ok，让调用者误以为索引就绪（随后 search 报
         // graph-index-absent 才发现）。0 模型 fail-fast，点名 env/applicationCode
         // 与解析来源，把「索引没建成」和「建成了但为空」分开。
@@ -1626,13 +1650,15 @@ async function cmdGraphPull(environment, concurrency, transport) {
             identityFingerprint: data.meta.identityFingerprint,
             pulledAtIso: data.meta.pulledAtIso,
             scope: data.meta.scope,
-            coverage: { applicationCodes: [data.meta.applicationCode] },
+            coverage: { applicationCodes: data.meta.coverage.applicationCodes, ...(data.meta.coverage.tenantApplications ? { tenantApplications: data.meta.coverage.tenantApplications } : {}) },
             freshness: data.gaps.length === 0 ? "complete" : "partial",
             scanned: { models: data.scanned.models, rules: data.scanned.rules, datarules: data.scanned.datarules, views: data.scanned.views, ...(data.scanned.parseFailures > 0 ? { parseFailures: data.scanned.parseFailures } : {}) },
             edges: edgesByKind,
             ...(data.gaps.length > 0 ? { gaps: { count: data.gaps.length, byKind: gapsByKind } } : {}),
             dbBytes: data.dbBytes,
             timings: data.timings,
+            dbPath: path ? `${path}/.omc/graph/graph.db` : undefined,
+            mcpHint: `MCP 工具按注册时的 --path 读库；要让 MCP 看到本次拉取：omc graph pull --path <MCP 的配置根> --env <env>`,
             nextCommand: "omc graph references <kind> <code>",
         }, transport);
     }
@@ -1670,6 +1696,32 @@ function cmdGraphReferences(kind, code, transport, requestedEnvironment) {
         return emitThrown(error, transport);
     }
 }
+function cmdGraphReferencesBatch(kind, codeList, transport) {
+    if (!["service", "model", "field"].includes(kind))
+        return emitInvalid(transport, { message: "kind 必须是 service / model / field" });
+    try {
+        const result = queryGraphReferencesBatch(kind, codeList.split(",").map((code) => code.trim()));
+        return emitResult({ status: "ok", ...result }, transport);
+    }
+    catch (error) {
+        return emitThrown(error, transport);
+    }
+}
+function cmdGraphEdges(fromSchema, toSchema, requestedEnvironment, transport) {
+    try {
+        const result = queryGraphEdges(fromSchema, toSchema);
+        if (requestedEnvironment !== undefined && requestedEnvironment !== result.index.environmentName)
+            return emitResult({ status: "refused", blocker: "graph-environment-mismatch", message: `索引已绑定环境 ${result.index.environmentName}，不是 ${requestedEnvironment}；请先 omc graph pull --env ${requestedEnvironment}`, index: result.index }, transport);
+        if (result.total > 200) {
+            const artifact = createArtifact(artifactRoot(), JSON.stringify(result.edges, null, 2));
+            return emitResult({ status: "ok", total: result.total, index: result.index, artifactId: artifact.artifactId, sha256: artifact.sha256, edges: { count: result.edges.length, truncated: true } }, transport);
+        }
+        return emitResult({ status: "ok", ...result }, transport);
+    }
+    catch (error) {
+        return emitThrown(error, transport);
+    }
+}
 function cmdGraphStatus(transport) {
     try {
         const status = readGraphStatus();
@@ -2470,7 +2522,7 @@ async function main() {
             pureKeys: (options.keys === true || bareJq) && options.summary !== true, ...(typeof options.keys === "string" ? { keys: options.keys } : {}), full: options.full === true }));
     });
     command.command("bench").option("--live-sample").option("--env <environment>").action(async (options) => { commandExitCode = await cmdBench([...(options.liveSample ? ["--live-sample"] : []), ...(options.env ? ["--env", options.env] : [])]); });
-    command.command("residue <prefix>").description("跨面前缀残留扫描（model 全租户/folder/custompage；默认 deep 再查命中模型的 rule/datarule/onlinejs）——收尾「删净」一次证明，clean:true 即零残留。只读零写入；report 面暂停维护未扫描").option("--env <environment>", "环境名（默认按 cwd 的 .omc-env 解析）").option("--apps <codes>", "all（默认，全租户）或逗号分隔应用码").option("--no-deep", "只扫 model/folder/custompage，不深查命中模型").option("--max-output-bytes <bytes>").action(async (prefix, options) => { commandExitCode = await withTransport(options, request, (transport) => cmdResidue(prefix, { env: options.env, apps: options.apps, ...(options.deep === false ? { noDeep: true } : {}) }, transport)); });
+    command.command("residue <prefix>").description("跨面前缀残留扫描（model 全租户/folder/custompage；默认 deep 再查命中模型的 rule/datarule/onlinejs）——收尾「删净」一次证明，clean:true 即零残留。清理入口：omc model-purge --code <schemaCode>（按依赖倒序，默认 dry-run）。只读零写入；report 面暂停维护未扫描").option("--env <environment>", "环境名（默认按 cwd 的 .omc-env 解析）").option("--apps <codes>", "all（默认，全租户）或逗号分隔应用码").option("--no-deep", "只扫 model/folder/custompage，不深查命中模型").option("--max-output-bytes <bytes>").action(async (prefix, options) => { commandExitCode = await withTransport(options, request, (transport) => cmdResidue(prefix, { env: options.env, apps: options.apps, ...(options.deep === false ? { noDeep: true } : {}) }, transport)); });
     const jqOption = () => new Option("--jq [path]", "路径投影（与 call --jq 同 DSL；可逗号多路径；裸 --jq 列顶层键）").argParser((value, previous = []) => [...previous, value]).default([]);
     command.command("commands").option("--json").option("--compact").option("--filter <keyword>").option("--lane <id>").option("--max-output-bytes <bytes>").addOption(jqOption()).action(async (options) => { commandExitCode = await withTransport(options, request, (transport) => cmdDiscovery("commands", transport, undefined, { json: options.json === true, compact: options.compact === true, ...(options.filter ? { filter: options.filter } : {}), ...(options.lane ? { lane: options.lane } : {}), ...(options.jq !== undefined ? { jq: options.jq } : {}) })); });
     command.command("describe <tool>").option("--full").option("--cache-ok", "允许 --full 在同会话重复读时短路为 artifact 指针（默认每次回全文）").option("--schema-only").option("--param <name>").option("--example [id]").option("--max-output-bytes <bytes>").addOption(jqOption()).action(async (tool, options) => {
@@ -2535,13 +2587,22 @@ async function main() {
     });
     // ADR-0008: local derived rule-graph index — CLI management face, not a call
     // tool (so it stays out of `commands --json`/coverage by construction).
-    const graphCommand = command.command("graph").description("本地派生规则图索引（ADR-0008）：pull 全量重建（有界并发）/ references 离线引用 / impact 影响面 / search 规则 code+name 检索（非规则体）/ status 完整性与新鲜度。候选定位器——不进 baseline/plan/写门禁");
-    graphCommand.command("pull").option("--env <environment>").option("--environment <environment>").option("--concurrency <n>", "并发 wire 读数（1–32，默认 16）：拉取已流水线化，墙钟 ≈ max(模型面,规则面)/并发 × 延迟；过高可能触发平台限流形成缺口").option("--max-output-bytes <bytes>").addHelpText("after", "\n只读远端（model.list → 每模型 rule.list+datarule.list → 每规则 rule.get，统一任务池流水线并发）+ 本地原子重建；不写环境、不占环境写锁。新鲜度随结果回报（complete|partial），查询走 graph references / impact / search。\n").action(async (options) => {
+    const graphCommand = command.command("graph").description("本地派生规则图索引（ADR-0008）");
+    graphCommand.command("pull").option("--env <environment>").option("--environment <environment>").option("--path <dir>").option("--application-codes <codes>").option("--all-applications").option("--concurrency <n>").option("--max-output-bytes <bytes>").action(async (options) => {
         const parsed = options.concurrency === undefined ? undefined : Number.parseInt(String(options.concurrency), 10);
-        commandExitCode = await withTransport(options, request, (transport) => cmdGraphPull(options.environment ?? options.env, parsed, transport));
+        if (options.path)
+            process.env.OMC_GRAPH_PATH = options.path;
+        const codes = options.applicationCodes ? String(options.applicationCodes).split(",").map((code) => code.trim()).filter(Boolean) : undefined;
+        commandExitCode = await withTransport(options, request, (transport) => cmdGraphPull(options.environment ?? options.env, parsed, transport, options.path, codes, options.allApplications === true));
+    });
+    graphCommand.command("references [kind] [code]").option("--batch <codes>").option("--env <environment>", "本子命令不接触环境；该参数仅用于提示索引绑定环境").option("--max-output-bytes <bytes>").addHelpText("after", "\n离线查询（零 wire）：kind = service|model|field，语义同 rule.references 第一版边界；支持 --batch code1,code2 共享同一 index 块。\n").action(async (kind, code, options) => {
+        commandExitCode = await withTransport(options, request, (transport) => options.batch ? cmdGraphReferencesBatch(kind ?? "model", options.batch, transport) : cmdGraphReferences(kind ?? "", code ?? "", transport, options.environment ?? options.env));
+    });
+    graphCommand.command("references-batch <kind> <code>").option("--max-output-bytes <bytes>").action(async (kind, code, options) => {
+        commandExitCode = await withTransport(options, request, (transport) => cmdGraphReferencesBatch(kind, code, transport));
     });
-    graphCommand.command("references <kind> <code>").option("--env <environment>", "本子命令不接触环境；该参数仅用于提示索引绑定环境").option("--max-output-bytes <bytes>").addHelpText("after", "\n离线查询（零 wire）：kind = service|model|field，语义同 rule.references 第一版边界；结果带索引新鲜度与扫描缺口（有缺口时零命中不构成「无引用」证明）。覆盖：规则图/数据规则/视图；不含表单、workflow.permissions、流程绑定、在线 JS。在线版 rule.references 不含数据规则；两者都不含上述未扫描面。\n").action(async (kind, code, options) => {
-        commandExitCode = await withTransport(options, request, (transport) => cmdGraphReferences(kind, code, transport, options.environment ?? options.env));
+    graphCommand.command("edges").option("--env <environment>", "本子命令不接触环境；该参数仅用于提示索引绑定环境").option("--from-schema <code>").option("--to-schema <code>").option("--max-output-bytes <bytes>").addHelpText("after", "\n离线全图边清单（零 wire）；--env 仅校验索引绑定环境，与 references 一致。\n").action(async (options) => {
+        commandExitCode = await withTransport(options, request, (transport) => cmdGraphEdges(options.fromSchema, options.toSchema, options.environment ?? options.env, transport));
     });
     graphCommand.command("impact <kind> <code>").option("--max-output-bytes <bytes>").addHelpText("after", "\n影响面（离线）：跳1=引用该编码的规则（同 references），跳2=这些规则还读写哪些 service/model/field——改前看爆炸半径。截断上限 50 规则×每类 20 码。\n").action(async (kind, code, options) => {
         commandExitCode = await withTransport(options, request, (transport) => cmdGraphImpact(kind, code, transport));

package/dist/command-transport.js

@@ -120,6 +120,15 @@ function sanitizePaths(value) {
             }
             continue;
         }
+        // r41a 接线（2026-11-08，E2E F34 三撞收口）：graph 回执的 dbPath 是「索引身份」
+        // 字段——MCP 面（omc mcp-graph --path）本就明文回显自己的库路径，CLI 侧把它
+        // 脱成 [local-path-redacted] 后两面无法比对（探针正是靠比对 dbPath 才发现
+        // 「MCP 读的是 ext-mcc 目录的旧库」）；graph-index-absent 的拒绝消息也在叫用户
+        // 「比对 dbId/dbPath」。仅豁免这一个键，其余路径照脱敏不放松。
+        if (key === "dbPath" && typeof entry === "string") {
+            output[key] = entry;
+            continue;
+        }
         output[key] = sanitizePaths(entry);
     }
     return output;

package/dist/graph.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { chmodSync, closeSync, existsSync, mkdirSync, openSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { joinConfigRoot } from "./command-transport.js";
 import { decodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "./json-column.js";
 import { ENDPOINTS } from "./endpoints.js";
@@ -46,7 +46,7 @@ function nodeSqlite() {
  *   staleness is handled by reporting pulledAt + identity, refreshed by an
  *   explicit re-pull (no incremental watermarks, no write-back hooks).
  */
-const GRAPH_SCHEMA_VERSION = "5";
+export const GRAPH_SCHEMA_VERSION = "6";
 const STALE_LOCK_MS = 15 * 60 * 1000;
 export const DEFAULT_PULL_CONCURRENCY = 16;
 export const MAX_PULL_CONCURRENCY = 32;
@@ -77,8 +77,8 @@ export class GraphPullLockHeldError extends Error {
         this.name = "GraphPullLockHeldError";
     }
 }
-export function graphDbPath() {
-    return join(joinConfigRoot(), ".omc", "graph", "graph.db");
+export function graphDbPath(root) {
+    return join(resolve(root ?? process.env.OMC_GRAPH_PATH ?? joinConfigRoot()), ".omc", "graph", "graph.db");
 }
 /**
  * Extract api-fact reference edges from one rule's stored node graph. The
@@ -181,7 +181,7 @@ export function extractListViewEdges(schemaCode, viewCode, model) {
  * `datarule-list`) and vice versa (`rule-list`). Output is sorted so the
  * published DB is byte-stable regardless of completion order.
  */
-export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRENCY) {
+export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRENCY, requestedApplication) {
     const identity = session.environmentFingerprint();
     const pulledAtIso = new Date().toISOString();
     const totalStart = Date.now();
@@ -192,11 +192,11 @@ export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRE
     // returns EMPTY data on a real platform (works only against the fake face)
     // — using it here made the first live pull enumerate zero models and (pre-
     // zero-guard) wedge the scheduler.
-    const scope = await resolveApplicationScope(session, undefined).catch(() => undefined);
+    const scope = await resolveApplicationScope(session, requestedApplication).catch(() => undefined);
     const applicationCode = scope?.code ?? "";
     const gaps = [];
     const treeRows = flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode: applicationCode } })).data));
-    const modelEntities = treeRows.filter((row) => row.type === "BizModel" && typeof row.code === "string" && row.code !== "").map((row) => ({ schemaCode: String(row.code), name: String(row.name ?? row.code) })).sort((a, b) => a.schemaCode.localeCompare(b.schemaCode));
+    const modelEntities = treeRows.filter((row) => row.type === "BizModel" && typeof row.code === "string" && row.code !== "").map((row) => ({ schemaCode: String(row.code), name: String(row.name ?? row.code), applicationCode })).sort((a, b) => a.schemaCode.localeCompare(b.schemaCode));
     const schemaCodes = modelEntities.map((row) => row.schemaCode);
     const fields = [];
     const services = [];
@@ -206,7 +206,7 @@ export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRE
             for (const row of rows) {
                 const code = String(row.code ?? row.propertyCode ?? "");
                 if (code)
-                    fields.push({ schemaCode, code, name: String(row.name ?? row.propertyName ?? code) });
+                    fields.push({ schemaCode, code, name: String(row.name ?? row.propertyName ?? code), applicationCode });
             }
         }
         catch (error) {
@@ -302,7 +302,7 @@ export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRE
             dataruleRows = wireRows((await wireCall(session, { path: ENDPOINTS.dataRuleList, query: { schemaCode } })).data);
             dataruleCount += dataruleRows.length;
             for (const row of dataruleRows)
-                edges.push(...extractDataRuleEdges(schemaCode, row));
+                edges.push(...extractDataRuleEdges(schemaCode, row).map((edge) => ({ ...edge, applicationCode })));
         }
         catch (error) {
             gaps.push({ kind: "datarule-list", ref: schemaCode, note: error instanceof Error ? error.message : String(error) });
@@ -361,7 +361,7 @@ export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRE
                 rowId: ruleId,
                 graphSha256: sha256({ nodes, routes: decodeJsonColumn(record.route, JSON_COLUMN_NULL_COALESCE) }),
             });
-            edges.push(...extractReferenceEdges(schemaCode, ruleCode, nodes));
+            edges.push(...extractReferenceEdges(schemaCode, ruleCode, nodes).map((edge) => ({ ...edge, applicationCode })));
         }
         catch (error) {
             gaps.push({ kind: "rule-get", ref: `${schemaCode}/${ruleCode}`, note: error instanceof Error ? error.message : String(error) });
@@ -378,7 +378,7 @@ export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRE
                 return;
             }
             viewCount += 1;
-            edges.push(...extractListViewEdges(schemaCode, viewCode, got));
+            edges.push(...extractListViewEdges(schemaCode, viewCode, got).map((edge) => ({ ...edge, applicationCode })));
         }
         catch (error) {
             gaps.push({ kind: "listview-get", ref: `${schemaCode}/${viewCode}`, note: error instanceof Error ? error.message : String(error) });
@@ -496,10 +496,24 @@ async function withGraphPullLock(run) {
     }
 }
 /** Wholesalerebuild + atomic publish (staging file + rename), 0600. */
-export async function publishGraphPull(session, concurrency = DEFAULT_PULL_CONCURRENCY) {
+export async function publishGraphPull(session, concurrency = DEFAULT_PULL_CONCURRENCY, options = {}) {
     try {
         return await withGraphPullLock(async () => {
-            const data = await pullRuleGraph(session, concurrency);
+            const requested = options.applicationCodes?.length ? options.applicationCodes : [undefined];
+            const parts = await Promise.all(requested.map((application) => pullRuleGraph(session, concurrency, application)));
+            const first = parts[0];
+            const data = parts.length === 1 ? first : {
+                ...first,
+                meta: { ...first.meta, applicationCode: "*", coverage: { applicationCodes: parts.flatMap((part) => part.meta.coverage.applicationCodes), tenantApplications: parts.flatMap((part) => part.meta.coverage.applicationCodes) } },
+                rules: parts.flatMap((part) => part.rules),
+                edges: parts.flatMap((part) => part.edges),
+                models: parts.flatMap((part) => part.models),
+                fields: parts.flatMap((part) => part.fields),
+                services: parts.flatMap((part) => part.services),
+                gaps: parts.flatMap((part) => part.gaps),
+                scanned: parts.reduce((sum, part) => ({ models: sum.models + part.scanned.models, rules: sum.rules + part.scanned.rules, datarules: sum.datarules + part.scanned.datarules, views: sum.views + part.scanned.views, parseFailures: sum.parseFailures + part.scanned.parseFailures }), { models: 0, rules: 0, datarules: 0, views: 0, parseFailures: 0 }),
+                timings: { listMs: parts.reduce((n, part) => n + part.timings.listMs, 0), readMs: parts.reduce((n, part) => n + part.timings.readMs, 0), totalMs: parts.reduce((n, part) => n + part.timings.totalMs, 0) },
+            };
             const staging = `${graphDbPath()}.staging-${process.pid}`;
             rmSync(staging, { force: true });
             const DatabaseSyncCtor = nodeSqlite().DatabaseSync;
@@ -531,13 +545,14 @@ export async function publishGraphPull(session, concurrency = DEFAULT_PULL_CONCU
           rule_code TEXT NOT NULL,
           node_code TEXT,
           node_type TEXT,
-          via TEXT NOT NULL
+           via TEXT NOT NULL,
+           application_code TEXT
         );
         CREATE INDEX edges_lookup ON edges(kind, code);
          CREATE TABLE gaps (kind TEXT NOT NULL, ref TEXT NOT NULL, note TEXT);
-         CREATE TABLE models (schema_code TEXT PRIMARY KEY, name TEXT NOT NULL);
-         CREATE TABLE fields (schema_code TEXT NOT NULL, code TEXT NOT NULL, name TEXT NOT NULL);
-         CREATE TABLE services (code TEXT PRIMARY KEY, name TEXT NOT NULL);
+          CREATE TABLE models (schema_code TEXT PRIMARY KEY, name TEXT NOT NULL, application_code TEXT);
+          CREATE TABLE fields (schema_code TEXT NOT NULL, code TEXT NOT NULL, name TEXT NOT NULL, application_code TEXT);
+          CREATE TABLE services (code TEXT PRIMARY KEY, name TEXT NOT NULL);
       `);
                 const insertMeta = db.prepare("INSERT INTO meta (key, value) VALUES (?, ?)");
                 // `applicationResolution` is an object; String(value) would persist
@@ -548,19 +563,19 @@ export async function publishGraphPull(session, concurrency = DEFAULT_PULL_CONCU
                 const insertRule = db.prepare("INSERT INTO rules (schema_code, rule_code, name, enabled, status, default_rule, row_id, graph_sha256) VALUES (?, ?, ?, ?, ?, ?, ?, ?)");
                 for (const rule of data.rules)
                     insertRule.run(rule.schemaCode, rule.ruleCode, rule.name, rule.enabled === null ? null : rule.enabled ? 1 : 0, rule.status, rule.defaultRule === null ? null : rule.defaultRule ? 1 : 0, rule.rowId, rule.graphSha256);
-                const insertEdge = db.prepare("INSERT INTO edges (kind, code, schema_code, rule_code, node_code, node_type, via) VALUES (?, ?, ?, ?, ?, ?, ?)");
+                const insertEdge = db.prepare("INSERT INTO edges (kind, code, schema_code, rule_code, node_code, node_type, via, application_code) VALUES (?, ?, ?, ?, ?, ?, ?, ?)");
                 for (const edge of data.edges)
-                    insertEdge.run(edge.kind, edge.code, edge.schemaCode, edge.ruleCode, edge.nodeCode, edge.nodeType, edge.via);
+                    insertEdge.run(edge.kind, edge.code, edge.schemaCode, edge.ruleCode, edge.nodeCode, edge.nodeType, edge.via, edge.applicationCode ?? null);
                 const insertGap = db.prepare("INSERT INTO gaps (kind, ref, note) VALUES (?, ?, ?)");
                 for (const gap of data.gaps)
                     insertGap.run(gap.kind, gap.ref, gap.note ?? null);
-                const insertModel = db.prepare("INSERT INTO models (schema_code, name) VALUES (?, ?)");
+                const insertModel = db.prepare("INSERT INTO models (schema_code, name, application_code) VALUES (?, ?, ?)");
                 for (const row of data.models)
-                    insertModel.run(row.schemaCode, row.name);
-                const insertField = db.prepare("INSERT INTO fields (schema_code, code, name) VALUES (?, ?, ?)");
+                    insertModel.run(row.schemaCode, row.name, row.applicationCode ?? null);
+                const insertField = db.prepare("INSERT INTO fields (schema_code, code, name, application_code) VALUES (?, ?, ?, ?)");
                 for (const row of data.fields)
-                    insertField.run(row.schemaCode, row.code, row.name);
-                const insertService = db.prepare("INSERT INTO services (code, name) VALUES (?, ?)");
+                    insertField.run(row.schemaCode, row.code, row.name, row.applicationCode ?? null);
+                const insertService = db.prepare("INSERT OR IGNORE INTO services (code, name) VALUES (?, ?)");
                 for (const row of data.services)
                     insertService.run(row.code, row.name);
                 // FTS5 mirrors rules (code+name) for `graph search`; one rebuild after
@@ -598,7 +613,7 @@ function openGraphIndex() {
         for (const row of db.prepare("SELECT key, value FROM meta").all())
             meta[row.key] = row.value;
         if (meta.schemaVersion !== GRAPH_SCHEMA_VERSION)
-            throw new GraphIndexAbsentError(`索引 schema 版本不匹配（${meta.schemaVersion} ≠ ${GRAPH_SCHEMA_VERSION}）；重跑 omc graph pull`);
+            throw new GraphIndexAbsentError(`索引 schema 版本不匹配（${meta.schemaVersion ?? "unknown"} ≠ ${GRAPH_SCHEMA_VERSION}）；旧版索引已作废，请重跑 omc graph pull（schema 升版需重拉）`);
         const ruleCount = db.prepare("SELECT COUNT(*) AS n FROM rules").get().n;
         const modelCount = db.prepare("SELECT COUNT(DISTINCT schema_code) AS n FROM rules").get().n;
         const entityCounts = {
@@ -620,7 +635,21 @@ function openGraphIndex() {
         const pulledAtIso = meta.pulledAtIso ?? "";
         const ageDays = indexAgeDays(pulledAtIso);
         const ageMinutes = indexAgeMinutes(pulledAtIso);
-        const coverage = { applicationCodes: meta.applicationCode ? [meta.applicationCode] : [] };
+        let applicationCodes = meta.applicationCode ? [meta.applicationCode] : [];
+        try {
+            const parsedCoverage = JSON.parse(meta.coverage ?? "null");
+            if (Array.isArray(parsedCoverage.applicationCodes))
+                applicationCodes = parsedCoverage.applicationCodes.filter((code) => typeof code === "string");
+        }
+        catch { /* legacy index */ }
+        let tenantApplications;
+        try {
+            const parsedCoverage = JSON.parse(meta.coverage ?? "null");
+            if (Array.isArray(parsedCoverage.tenantApplications))
+                tenantApplications = parsedCoverage.tenantApplications.filter((code) => typeof code === "string");
+        }
+        catch { /* legacy index */ }
+        const coverage = { applicationCodes, ...(tenantApplications ? { tenantApplications } : {}) };
         return {
             db,
             summary: {
@@ -663,6 +692,14 @@ function openGraphIndex() {
 export const GRAPH_COVERAGE = Object.freeze({
     scanned: Object.freeze(["businessrule", "datarule", "listview"]),
     notScanned: Object.freeze(["form", "workflow.permissions", "workflow.bindings", "onlinejs", "rule.conditions"]),
+    answerable: Object.freeze(["businessrule", "datarule", "listview"]),
+    mustCheckManually: Object.freeze([
+        { surface: "form", why: "表单控件关联未扫描，可能仍引用目标字段", how: "omc call form.get --args '{\"schemaCode\":\"<x>\"}'" },
+        { surface: "workflow.permissions", why: "流程权限未扫描，无法判断谁能发起/操作", how: "omc call workflow.get --args '{\"schemaCode\":\"<x>\"}'" },
+        { surface: "workflow.bindings", why: "流程规则绑定未扫描，规则删除可能留下绑定", how: "omc call workflow.get --args '{\"schemaCode\":\"<x>\"}'" },
+        { surface: "onlinejs", why: "在线 JS 可能通过字符串引用字段", how: "omc call onlinejs.get --args '{\"schemaCode\":\"<x>\"}'" },
+        { surface: "rule.conditions", why: "规则条件叶子未扫描，命中可能不完整", how: "omc call rule.list --args '{\"schemaCode\":\"<x>\"}' 后人工检查条件公式" },
+    ]),
     note: "零命中/全零 totals 只代表 scanned 面没有命中；notScanned 面（尤其 form 与 workflow.permissions）未扫描，不可据此判定可安全删除或无影响",
 });
 /**
@@ -692,6 +729,8 @@ export function queryGraphReferences(kind, code) {
             nodeCode: row.node_code ?? "",
             nodeType: row.node_type ?? "",
             via: row.via,
+            referrer: { schemaCode: row.schema_code, ruleCode: row.rule_code },
+            isSelf: row.schema_code === code,
         }));
         const gapped = summary.gaps.count > 0;
         // r35a-F4（真机 2026-11-06）：探针拿 matches:[] 差点把一个**被表单引用**的
@@ -722,6 +761,39 @@ export function queryGraphReferences(kind, code) {
         db.close();
     }
 }
+export function queryGraphReferencesBatch(kind, codes) {
+    const { db, summary } = openGraphIndex();
+    try {
+        const wanted = [...new Set(codes.filter(Boolean))];
+        const rows = wanted.length === 0 ? [] : db.prepare(`SELECT code, schema_code, rule_code, node_code, node_type, via FROM edges WHERE kind = ? AND code IN (${wanted.map(() => "?").join(",")}) ORDER BY code, schema_code, rule_code, node_code, via`).all(kind, ...wanted);
+        return { kind, codes: wanted, matches: rows.map((row) => ({ targetCode: row.code, schemaCode: row.schema_code, ruleCode: row.rule_code, nodeCode: row.node_code ?? "", nodeType: row.node_type ?? "", via: row.via, referrer: { schemaCode: row.schema_code, ruleCode: row.rule_code }, isSelf: row.schema_code === row.code })), index: summary, coverage: GRAPH_COVERAGE };
+    }
+    finally {
+        db.close();
+    }
+}
+export function queryGraphEdges(fromSchema, toSchema) {
+    const { db, summary } = openGraphIndex();
+    try {
+        const conditions = [];
+        const params = [];
+        if (fromSchema) {
+            conditions.push("schema_code = ?");
+            params.push(fromSchema);
+        }
+        if (toSchema) {
+            conditions.push("code = ?");
+            params.push(toSchema);
+        }
+        const where = conditions.length ? ` WHERE ${conditions.join(" AND ")}` : "";
+        const total = Number(db.prepare(`SELECT COUNT(*) AS n FROM edges${where}`).get(...params).n);
+        const rows = db.prepare(`SELECT kind, code, schema_code, rule_code, node_code, node_type, via, application_code FROM edges${where} ORDER BY schema_code, code, rule_code, node_code, via`).all(...params);
+        return { edges: rows.map((row) => ({ kind: row.kind, code: row.code, schemaCode: row.schema_code, ruleCode: row.rule_code, nodeCode: row.node_code ?? "", nodeType: row.node_type ?? "", via: row.via, ...(row.application_code ? { applicationCode: row.application_code } : {}) })), index: summary, total };
+    }
+    finally {
+        db.close();
+    }
+}
 export function readGraphStatus() {
     const { db, summary } = openGraphIndex();
     try {
@@ -732,10 +804,13 @@ export function readGraphStatus() {
             dbBytes: statSync(dbPath).size,
             dbPath,
             dbId: sha256(dbPath).slice(0, 12),
+            mcpHint: `MCP 工具按注册时的 --path 读库；要让 MCP 看到本次拉取，请执行 omc graph pull --path <MCP 的配置根> --env <env>。`,
             ageMinutes: summary.ageMinutes,
             staleAfterMinutes: summary.staleAfterMinutes,
             ...(summary.staleWarning ? { warning: summary.staleWarning } : {}),
             coverage: summary.coverage,
+            coveredApplications: summary.coverage.applicationCodes,
+            tenantApplications: summary.coverage.tenantApplications ?? summary.coverage.applicationCodes,
             gaps,
         };
     }
@@ -794,8 +869,8 @@ export function searchGraphRules(term, limit = 20, offset = 0) {
                     ...(offset + rows.length < total ? { truncated: true, nextOffset: offset + rows.length } : {}),
                 };
             };
-            entityMatches.model = searchEntity("SELECT COUNT(*) AS n FROM models WHERE instr(name, ?) > 0 OR instr(schema_code, ?) > 0", "SELECT schema_code, name FROM models WHERE instr(name, ?) > 0 OR instr(schema_code, ?) > 0 ORDER BY schema_code LIMIT ?", [term.trim(), term.trim()], (row) => ({ schemaCode: row.schema_code, name: row.name }));
-            entityMatches.field = searchEntity("SELECT COUNT(*) AS n FROM fields WHERE instr(name, ?) > 0 OR instr(code, ?) > 0", "SELECT schema_code, code, name FROM fields WHERE instr(name, ?) > 0 OR instr(code, ?) > 0 ORDER BY schema_code, code LIMIT ?", [term.trim(), term.trim()], (row) => ({ schemaCode: row.schema_code, code: row.code, name: row.name }));
+            entityMatches.model = searchEntity("SELECT COUNT(*) AS n FROM models WHERE instr(name, ?) > 0 OR instr(schema_code, ?) > 0", "SELECT schema_code, name, application_code FROM models WHERE instr(name, ?) > 0 OR instr(schema_code, ?) > 0 ORDER BY schema_code LIMIT ?", [term.trim(), term.trim()], (row) => ({ schemaCode: row.schema_code, name: row.name, applicationCode: row.application_code ?? undefined }));
+            entityMatches.field = searchEntity("SELECT COUNT(*) AS n FROM fields WHERE instr(name, ?) > 0 OR instr(code, ?) > 0", "SELECT schema_code, code, name, application_code FROM fields WHERE instr(name, ?) > 0 OR instr(code, ?) > 0 ORDER BY schema_code, code LIMIT ?", [term.trim(), term.trim()], (row) => ({ schemaCode: row.schema_code, code: row.code, name: row.name, applicationCode: row.application_code ?? undefined }));
             entityMatches.service = searchEntity("SELECT COUNT(*) AS n FROM services WHERE instr(name, ?) > 0 OR instr(code, ?) > 0", "SELECT code, name FROM services WHERE instr(name, ?) > 0 OR instr(code, ?) > 0 ORDER BY code LIMIT ?", [term.trim(), term.trim()], (row) => ({ code: row.code, name: row.name }));
         }
         const gapped = summary.gaps.count > 0;
@@ -804,7 +879,7 @@ export function searchGraphRules(term, limit = 20, offset = 0) {
             rules: matches,
             matches: entityMatches,
             index: summary,
-            coverage: { scanned: ["rule.code", "rule.name", "model.code", "model.name", "field.code", "field.name", "service.code", "service.name"], notScanned: ["rule.body", "form", "workflow.permissions"], note: "检索覆盖规则与实体的 code/name；规则体、表单与流程权限未扫描" },
+            coverage: { scanned: ["rule.code", "rule.name", "model.code", "model.name", "field.code", "field.name", "service.code", "service.name"], notScanned: ["rule.body", "form", "workflow.permissions"], answerable: ["rule.code", "rule.name", "model.code", "model.name", "field.code", "field.name", "service.code", "service.name"], mustCheckManually: [{ surface: "rule.body", why: "规则体未检索", how: "omc call rule.list --args '{\"schemaCode\":\"<x>\"}'" }, { surface: "form", why: "表单控件未扫描", how: "omc call form.get --args '{\"schemaCode\":\"<x>\"}'" }, { surface: "workflow.permissions", why: "流程权限未扫描", how: "omc call workflow.get --args '{\"schemaCode\":\"<x>\"}'" }], note: "检索覆盖规则与实体的 code/name；规则体、表单与流程权限未扫描" },
             ...(term.trim() !== "" && !/^[A-Za-z][A-Za-z0-9_.-]*$/.test(term.trim()) ? { note: "疑似业务词；本工具同时检索实体 name/code 与规则 code/name，引用明细请使用匹配到的 code 再查 references/impact" } : {}),
             ...(matches.length === 0 && entityMatches.model.total === 0 && entityMatches.field.total === 0 && entityMatches.service.total === 0
                 ? {

package/dist/human-summary.js

@@ -191,7 +191,7 @@ function phraseOf(tool, args, outcome) {
         case "workflow.delete":
             return `删除流程 ${stringArg(args, "code") ?? "?"}`;
         case "onlinejs.compose":
-            return `编排并发布表单脚本 customScript（模型 ${schemaCode ?? "?"} / 表单 ${stringArg(args, "sheetCode") ?? "?"}）`;
+            return `编排并发布表单脚本 customScript（模型 ${schemaCode ?? "?"} / 表单 ${stringArg(args, "sheetCode") ?? `sheetCodeFromSchema:${String(outcome?.readback?.sheetCodeFromSchema ?? schemaCode ?? "?")}`}）`;
         case "service.register":
             return `注册后端服务 ${stringArg(args, "serviceCode") ?? "?"}`;
         case "service.delete":

package/dist/lanes/field.js

@@ -134,6 +134,10 @@ function childSchemaCodes(rows) {
     const codes = new Set(rows.map((row) => String(row.code ?? row.propertyCode ?? "")));
     return codes.has("parentId") && codes.has("sortKey");
 }
+function isSystemFieldCode(code) {
+    const value = String(code ?? "");
+    return SYSTEM_FIELD_CODES.has(value) || value === "parentId" || value === "sortKey";
+}
 /**
  * r17 (2026-10-25, live + decompiled A/B): a FORMULA field CANNOT aggregate its
  * own model's child table. `BizPropertyManagerImpl.publishFormula` rewrites
@@ -232,8 +236,10 @@ export function registerFieldLane(tools) {
                 // Round 4 (ADR 0005): read-side annotation for stored scale-less
                 // NUMERICAL landmines (the platform accepted them for years).
                 const scaleWarning = numericalScaleWarning(type, options);
+                const fieldCode = row.code ?? row.propertyCode;
+                const system = isSystemFieldCode(fieldCode);
                 return {
-                    code: row.code ?? row.propertyCode,
+                    code: fieldCode,
                     name: row.name,
                     ...(redundantNameI18n(row.name_i18n, row.name) ? {} : typeof row.name_i18n === "string" ? { name_i18n: row.name_i18n } : {}),
                     type: row.type ?? row.propertyType,
@@ -261,7 +267,8 @@ export function registerFieldLane(tools) {
                     // readback.committed。
                     ...(Object.prototype.hasOwnProperty.call(row, "propertyEmpty") ? { propertyEmpty: row.propertyEmpty } : {}),
                     ...(options !== undefined ? { options } : {}),
-                    ...(scaleWarning !== undefined ? { shapeWarning: scaleWarning } : {}),
+                    ...(scaleWarning !== undefined ? { shapeWarning: scaleWarning, ...(system ? { origin: "system" } : {}) } : {}),
+                    ...(system && scaleWarning === undefined ? { origin: "system" } : {}),
                 };
             });
             // Projection: ask for one field (`--code`) or a named set (`--fields`) so a
@@ -281,7 +288,7 @@ export function registerFieldLane(tools) {
             // does this model have" paid for noise it then had to filter. `all:true`
             // restores the previous full list (uses the SAME SYSTEM_FIELD_CODES set the
             // list-view/form scaffolds already filter with).
-            const visible = args.all === true ? selected : selected.filter((field) => !SYSTEM_FIELD_CODES.has(String(field.code)));
+            const visible = args.all === true ? selected : selected.filter((field) => !isSystemFieldCode(field.code));
             const projected = detailed
                 ? visible
                 : visible.map((field) => {
@@ -306,6 +313,7 @@ export function registerFieldLane(tools) {
                         ...(Array.isArray(subColumns) && subColumns.length > businessCodes.length ? { systemSubColumnCount: subColumns.length - businessCodes.length } : {}),
                         ...(conditions.length > 0 ? { conditions } : {}),
                         ...(field.shapeWarning !== undefined ? { shapeWarning: field.shapeWarning } : {}),
+                        ...(field.origin !== undefined ? { origin: field.origin } : {}),
                     };
                 });
             return {
@@ -363,6 +371,7 @@ export function registerFieldLane(tools) {
                             ...(Array.isArray(field.subColumns) ? { subColumns: field.subColumns } : {}),
                             ...(conditions.length > 0 ? { conditions } : {}),
                             ...(field.shapeWarning !== undefined ? { shapeWarning: field.shapeWarning } : {}),
+                            ...(field.origin !== undefined ? { origin: field.origin } : {}),
                         };
                     }),
                     hint: "字段详情（options/subSchema）用 omc call field.list --args '{\"schemaCode\":\"...\",\"published\":true,\"code\":\"<field>\"}'",

package/dist/lanes/list-view-contract.js

@@ -12,7 +12,7 @@ export const LIST_VIEW_WIRE = Object.freeze({
     configureDefault: "code omitted means the default view (code=schemaCode)",
     configureColumns: "query/get then query/update: for each fieldCodes entry, append a missing column as visible, or repair an existing column's name/propertyType/displayFormat/visible in place (never skip an already-present column), then query/get readback; propertyType comes from published field metadata; NUMERICAL displayFormat is derived from the field's 0-based `options.scale` (0=integer,1=1dp,2=2dp,3=3dp…8=8dp) through the platform parseNumber table ({0:1,1:2,2:3,3:11,4:12,23:…, percent 0..:4/5/6/13/14/27..30, currency ¥ 2dp..:7/15/16/31..34} — verified live: scale 2 → displayFormat 3 = 2 decimals) and DATE displayFormat from options.format (1=yyyy-MM-dd,2=datetime,3=minute,4=yyyy-MM); the readback columns array carries {propertyCode,propertyType,displayFormat,visible,sumType} and added/updated name the fieldCodes touched",
     configureSorts: "sorts -> querySorts [{propertyCode,propertyType,direction,sortKey,clientType}]; direction SortDirectionType numeric ASC(1)/DESC(2); omitted leaves the existing sorts untouched, provided replaces them",
-    configureConditions: "conditions -> queryConditions [{propertyCode,propertyType,displayType,filterType,defaultValue,options,startValue,endValue,shortcutFilter,choiceType,dateType,accurateSearch,showNull,includeSubData,buildTreeBy,visible}]; filterType is the comparison OPERATOR (QueryFilterType STRING enum: Eq/NotEq/Gt/Lt/Gte/Lte/Like/NotLike/IsNull/IsNotNull/In/NotIn/Between/NotBetween/Of/NotOf/…; omitted → the platform default for the propertyType; aliases operator/op and legacy options.op); displayType INPUT(0)/RADIO(1)/CHECKBOX(2)/SELECT(3)/RANGE(4); choiceType SELECT(1)/POPUP(2)/TREE_LEFT(3); options is a JSON string (decoded on readback); conditionReadback is equivalent only for field-by-field equality, otherwise coerced with from/to details; viewConditionsAppliedRest:false records that REST data.list --queryCode does not apply fixed conditions",
+    configureConditions: "conditions -> queryConditions [{propertyCode,propertyType,displayType,filterType,defaultValue,options,startValue,endValue,shortcutFilter,choiceType,dateType,accurateSearch,showNull,includeSubData,buildTreeBy,visible}]; minimum --param shape: {\"conditions\":[{\"propertyCode\":\"<code>\",\"filterType\":\"Eq\",\"defaultValue\":<value>}]}; filterType is the comparison OPERATOR (QueryFilterType STRING enum: Eq/NotEq/Gt/Lt/Gte/Lte/Like/NotLike/IsNull/IsNotNull/In/NotIn/Between/NotBetween/Of/NotOf/…; omitted → the platform default for the propertyType; aliases operator/op and legacy options.op); displayType INPUT(0)/RADIO(1)/CHECKBOX(2)/SELECT(3)/RANGE(4); choiceType SELECT(1)/POPUP(2)/TREE_LEFT(3); options is a JSON string (decoded on readback); conditionReadback is equivalent only for field-by-field equality, otherwise coerced with from/to details; viewConditionsAppliedRest:false records that REST data.list --queryCode does not apply fixed conditions",
     configureConditionMap: "queryConditionMap {<schemaCode>: queryConditions[]} is read-derived (query/get with a formCode child-table filter); BizQueryDetailConfig persists queryConditions/querySorts only, so the map is not a configure input",
     configureActions: "actions -> queryActions [{actionCode,name,icon,queryActionType,systemAction,serviceCode,serviceMethod,customService,associationCode,associationType,sortKey}]; queryActionType QueryActionType numeric QUERY(1)/ADD(2)/.../BATCH_SUBMIT(23); associationType QueryActionRelativeType numeric BIZSHEET(0)/WORKFLOW(1); associationCode/associationType are the JSON names of the DTO fields relativeCode/queryActionRelativeType (@JsonProperty); omitted leaves the existing actions untouched, provided MERGES into the effective set by actionCode (live 2026-09-17: query/update replaces-then-re-adds the submitted list, so a merge keeps the platform's built-in 新增/删除/导入/导出 and updates a matching actionCode — replaceActions:true restores the authoritative full set, defaultActions:true re-seeds the platform default set); query/get auto-injects default actions (qr_code/batch_print/batch_update/import_attachment/export_attachment/batch_submit) and query/update resets sortKey to i+1",
     configurePresentation: "presentation -> queryPresentation {clientType,htmlJson,actionsJson,columnsJson,queryViewDataSource,schemaRelations,options}; htmlJson/actionsJson/columnsJson JSON strings are decoded once before render-shape validation (html element tagName+attrs, action actionCode/name/icon, column propertyCode/propertyType); invalid input refuses with listview-presentation-render-invalid before wire and is never double-encoded; clientType is forced to PC by query/update; schemaRelations is platform-derived from the queryColumns tree (resolveRelations) and overwrites your input; a non-empty htmlJson updates the environment record, which query/delete cleans up; omitted leaves the existing presentation untouched (the read-face object must be echoed, because saveBizQueryDetail removes every presentation whose clientType matches before re-adding), provided replaces it",

package/dist/lanes/list-view.js

@@ -920,7 +920,15 @@ export function registerListViewLane(tools) {
                         : `omc call field.list --args '${JSON.stringify({ schemaCode: args.schemaCode, published: true })}'`,
                 });
             }
-            return { wouldChange: true, summary: `即将配置列表视图 ${args.schemaCode}/${code} 的列` };
+            const normalizedFieldCodes = args.fieldCodes.map((ref) => resolveFieldRef(fieldRows, ref)?.code ?? ref);
+            return {
+                wouldChange: true,
+                summary: `即将配置列表视图 ${args.schemaCode}/${code} 的列`,
+                fieldCodes: normalizedFieldCodes.length > 20
+                    ? { count: normalizedFieldCodes.length, sha256: createHash("sha256").update(JSON.stringify(normalizedFieldCodes)).digest("hex"), note: "超过 20 项才摘要；顺序复核请分批配置" }
+                    : normalizedFieldCodes,
+                ...(args.conditions !== undefined ? { conditions: args.conditions } : {}),
+            };
         },
         rollback: listviewRollbackSpec("listview.configure"),
     });