@stalfh233/omc-cli 0.4.102 → 0.5.1

package/dist/lanes/businessrule.js

@@ -4,6 +4,7 @@ import { capabilityArg, environmentArg } from "../args.js";
 import { governedRead } from "../read.js";
 import { writeTool } from "../write.js";
 import { decodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "../json-column.js";
+import { flattenTreeRows, resolveApplicationCode } from "../support.js";
 import { executeRuleSaveWrite, ruleNodeGraphArg } from "../rule-support.js";
 import { defineTool, ToolInputError, ToolRefusalError } from "../tool-types.js";
 import { resolveRuleRowId } from "../identity.js";
@@ -135,8 +136,13 @@ export function registerBusinessRuleLane(tools) {
             // schema×ruleCode 组合（171 次 rule.get / 229KB）。没有引用检索面时，
             // 全库枚举是理性选择——所以给它一个。客户端聚合：模型清单 → 每模型
             // rule.list → 每规则 rule.get → 图内匹配，一次调用、只回命中行。
+            // Model enumeration mirrors `model.list`: the bare modelList endpoint
+            // returns EMPTY rows on a real platform (live 2026-10-29: a full scan
+            // "found" 0 models → false zero-hit), so walk the application tree.
             const scoped = args.schemaCodes === undefined
-                ? wireRows((await wireCall(session, { path: ENDPOINTS.modelList })).data).map((row) => String(row.schemaCode ?? "")).filter((code) => code !== "")
+                ? flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode: await resolveApplicationCode(session, undefined).catch(() => "") } })).data))
+                    .filter((row) => row.type === "BizModel" && typeof row.code === "string" && row.code !== "")
+                    .map((row) => String(row.code))
                 : (Array.isArray(args.schemaCodes) ? args.schemaCodes : [args.schemaCodes]);
             const wanted = args.code;
             const matches = [];

package/dist/lanes/field.js

@@ -412,7 +412,10 @@ export function registerFieldLane(tools) {
         // wire body (src/field-change.ts), so configure_model and intent share it.
         assertNoSelfSchemaAggregation(args, published);
         await assertNoChildSchemaAggregation(session, args.schemaCode, args.propertyType, args.options ?? {});
-        const prepared = prepareFieldChange(args);
+        // 目标版本决定 optionsSet 形状：8.2 以下要补 optionStructure/treeSelect
+        // （cpdocs issue #8：缺键让设计器选项弹窗硬崩）。
+        const targetVersion = session.detectedVersion();
+        const prepared = prepareFieldChange({ ...args, ...(targetVersion ? { targetVersion } : {}) });
         let performed;
         try {
             performed = await wireCall(session, { path: ENDPOINTS.fieldCreate, method: "POST", body: fieldChangeWireBody(args, prepared) });
@@ -515,10 +518,12 @@ async function runFieldUpdate(session, args) {
         assertNoSelfSchemaAggregation({ schemaCode: args.schemaCode, propertyType: record.type ?? record.propertyType, options: args.options }, publishedRows);
         await assertNoChildSchemaAggregation(session, args.schemaCode, record.type ?? record.propertyType, args.options);
     }
+    const targetVersion = session.detectedVersion();
     const update = {
         schemaCode: args.schemaCode,
         code: args.code,
         base: record,
+        ...(targetVersion ? { targetVersion } : {}),
         ...(args.name !== undefined ? { name: args.name } : {}),
         ...(args.name_i18n !== undefined ? { name_i18n: args.name_i18n } : {}),
         ...(args.options !== undefined ? { options: args.options } : {}),

package/dist/lanes/meta.js

@@ -239,6 +239,12 @@ export function registerMetaLane(tools) {
                 const session = await ctx.sessions.session(args.environment);
                 const version = session.detectedVersion();
                 steps.push({ step: "登录", ok: true, enterpriseId: session.enterpriseId(), administrator: session.administrator() });
+                // A deployment whose system/config carries an unusual/absent `client`
+                // blob still logs in (client_secret is optional). Report it as a WARN
+                // instead of letting it read as a failed self-check.
+                const loginNotes = session.loginNotes();
+                if (loginNotes.length > 0)
+                    steps.push({ step: "OAuth 客户端配置", ok: null, notes: loginNotes });
                 const familyOk = version ? version.startsWith(ctx.manifest.version_family + ".") : null;
                 steps.push({
                     step: "版本族",

package/dist/lanes/model.js

@@ -1120,8 +1120,9 @@ export function registerModelLane(tools) {
                 for (const row of wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.code, isPublish } })).data))
                     existingFields.set(String(row.code ?? row.propertyCode ?? ""), row);
             }
+            const configureTargetVersion = session.detectedVersion();
             for (const entry of entries) {
-                const input = fieldChangeInputOf(args.code, entry);
+                const input = fieldChangeInputOf(args.code, entry, configureTargetVersion);
                 failed = await run(results.length, "field.create", async () => {
                     const existing = existingFields.get(entry.code);
                     if (existing !== undefined) {
@@ -1237,12 +1238,13 @@ function fieldEntriesOf(args) {
     assertFieldFamilyAllowed(legacy);
     return [legacy];
 }
-function fieldChangeInputOf(schemaCode, entry) {
+function fieldChangeInputOf(schemaCode, entry, targetVersion) {
     return {
         schemaCode,
         code: entry.code,
         name: entry.name,
         propertyType: entry.propertyType,
+        ...(targetVersion ? { targetVersion } : {}),
         ...(entry.options ? { options: entry.options } : {}),
         ...(entry.choices ? { choices: entry.choices } : {}),
         ...(entry.relativeCode ? { relativeCode: entry.relativeCode } : {}),

package/dist/online-js-source.js

@@ -15,34 +15,34 @@ import { ToolRefusalError } from "./tool-types.js";
  * to replace it.
  */
 export const PLATFORM_LIFECYCLE_WRAPPER_MARKER = "(function(form)";
-export const PLATFORM_DEFAULT_LIFECYCLE_SCRIPT = `/**
- * 用户自定义JS区域;
- * 注：外部链接的JS统一放置在HTML中，原有script标签下的js统一放置在当前编码区域
- * 使用环境变量，可通过"$env("唤醒提示框，并通过$env(分类名称.变量名称)的方式使用
- */
-(function(form){
-    /**
-     * 事件绑定，form.on
-     * @param eventType 事件类型
-     * @params function 事件
-     * @param  cover    true, false 是否覆盖root的生命周期 默认不覆盖 
-     */
-    //数据加载后，渲染之前，this为window
-    form.on('onLoad',function(data, dataPermission){},'cover');
-    //渲染完成后
-    form.on('onRendered',function(data){});
-    //内置校验完成后，返回false阻止提交
-    form.on('onValidate',function(action,data){});
-    //操作前（包含自定义按钮）执行，返回false阻止按钮操作
-    form.on('onPreAction',function(action,data){});
-    //自定义按钮执行
-    form.on('onCustomAction',function(action,data){});
-    //操作完成后执行
-    form.on('onActionDone',function(action,data,httpRes){});
-    //表单字段打印数据格式扩展，可自行定义调用打印模板时，表单字段对应所打印数据的内容
-    form.on('onPrintFormDataHandle',function(vm, printData, sourceData, formValues, key, locale, printTemplateCode, control, dataType, sheetData){});
-    //流程日志打印数据格式扩展，可自行定义调用打印模板时，流程日志对应所打印数据的内容
-    form.on('onPrintWorkflowLogDataHandle',function(vm, sourceData, printData, locale, printTemplateCode){});
+export const PLATFORM_DEFAULT_LIFECYCLE_SCRIPT = `/**
+ * 用户自定义JS区域;
+ * 注：外部链接的JS统一放置在HTML中，原有script标签下的js统一放置在当前编码区域
+ * 使用环境变量，可通过"$env("唤醒提示框，并通过$env(分类名称.变量名称)的方式使用
+ */
+(function(form){
+    /**
+     * 事件绑定，form.on
+     * @param eventType 事件类型
+     * @params function 事件
+     * @param  cover    true, false 是否覆盖root的生命周期 默认不覆盖 
+     */
+    //数据加载后，渲染之前，this为window
+    form.on('onLoad',function(data, dataPermission){},'cover');
+    //渲染完成后
+    form.on('onRendered',function(data){});
+    //内置校验完成后，返回false阻止提交
+    form.on('onValidate',function(action,data){});
+    //操作前（包含自定义按钮）执行，返回false阻止按钮操作
+    form.on('onPreAction',function(action,data){});
+    //自定义按钮执行
+    form.on('onCustomAction',function(action,data){});
+    //操作完成后执行
+    form.on('onActionDone',function(action,data,httpRes){});
+    //表单字段打印数据格式扩展，可自行定义调用打印模板时，表单字段对应所打印数据的内容
+    form.on('onPrintFormDataHandle',function(vm, printData, sourceData, formValues, key, locale, printTemplateCode, control, dataType, sheetData){});
+    //流程日志打印数据格式扩展，可自行定义调用打印模板时，流程日志对应所打印数据的内容
+    form.on('onPrintWorkflowLogDataHandle',function(vm, sourceData, printData, locale, printTemplateCode){});
 })`;
 /** The lifecycle events the platform dispatches; anything else is a typo the runtime silently drops (or throws on). */
 export const ONLINE_JS_EVENTS = new Set([

package/dist/recipes/field.js

@@ -277,8 +277,62 @@ const formulaAggregationCrossModel = Object.freeze({
     requiresEnvironmentDerivedIds: true,
     prerequisiteData: { source: "field.list(published:true) ×2（来源模型 + 目标模型）", fields: ["source.model", "source.dataItemCode", "source.matchField", "target.matchField"] },
 });
+/**
+ * r29（2026-10-29 中冶终轮）+ 用户领域知识：外部数据（企查查/NC 等）在表单上
+ * 「填表时即带出」的标准模式——两段式组合。此前三轮探针（r24/r28b/r29）都发明
+ * 了「按钮触发规则回写」的重方案，因为没人知道标准模式；r29 实证 GetList 规则
+ * 实时调接口替换数据源在 1.1.25 不成立（CREATE 节点被校验器禁止指向本模型），
+ * 但「数据段落表 + 表单段关联下拉查表带出」完全成立且是平台正解。
+ *
+ * 2026-10-29 用户定案修正：GetList/Load 规则**实时调接口也是成立的**——触发点是
+ * 填表时**前端发起**的关联控件查询链（接口方法配 frontEndExtensionEnable:true，
+ * 前端直调）；r29 判「不成立」是因为用 data.list（后端 REST 查询）验证，该链不
+ * 执行 BIZ_ACTION 出参替换。验证必须走门户填表（关键字回车→候选→选中带出）。
+ */
+const externalLookupModel = Object.freeze({
+    id: "external-lookup-model",
+    title: "外部数据映射模型：接口数据落表 + 关联单选下拉带出（填表时即映射）",
+    aliases: ["外部数据源", "接口映射模型", "企查查下拉", "关联带出", "映射模型", "外部数据带出"],
+    status: "requires-prior-readback",
+    tool: "field.create",
+    args: {
+        environment,
+        schemaCode: model,
+        code: "ext_lookup_ref",
+        name: "外部数据引用",
+        propertyType: "WORK_SHEET",
+        options: {
+            schemaCode: "<映射模型code>",
+            queryCode: "<映射模型code>",
+            displayField: "<映射模型显示字段>",
+            mappings: [{ source: "<映射模型.业务字段>", target: "<本模型.落点字段>" }],
+        },
+    },
+    preconditions: [
+        "映射模型已建且字段与接口返回字段一一对应（如 qcc_company: company_name/credit_code）",
+        "数据段已通：接口数据已能落进映射模型表（见 conditionalRequirements 第 1 条的三个已验证组合）",
+    ],
+    conditionalRequirements: [
+        "**数据段首选（平台标准模式，2026-10-29 playwright 门户实证定案）**：映射模型的 GetList/Load 规则挂 BIZ_ACTION 实时调接口（接口方法配 frontEndExtensionEnable:true）——门户关联控件**打开即触发**前端查询链→GetList 规则→BIZ_ACTION 实时调外部接口（引擎日志 bizBusService.invoke + 外部网关日志双侧铁证）。**验证必须走门户填表；data.list 后端查询不反映此链，别用它判死**（r29 曾据此误判不成立）。配置侧三个收尾点：① WORK_SHEET 字段必须带 relativeCode（仅 options.schemaCode 发布表单会 301015 关联业务模型为空）；② GetList 规则的 BIZ_ACTION 入参映射要接前端搜索词（实测未配词时 invoke 参数为空 {}）；③ 出参→列表行的映射配完候选才回显（未配时弹窗 Total 0 但接口已调）。「下拉框形态（输关键字回车查询）」是表单 attributes 层的控件形态设置，默认弹窗形态。备选（不需要实时时）：预置 Create/Update 规则落映射表 / TIMING 定时同步。图内「BIZ_ACTION→CREATE 落表→再查」回环在 1.1.25 不可表达，不要走这条岔路。",
+        "**表单段是平台原生能力**：关联单选指向映射模型后，门户上输入关键字回车即查映射表、选中即 mappings 带出——前台填表时映射自然出现，无需按钮/脚本。",
+        "下拉框形态（输入关键字回车查询而非弹窗选择）在表单 attributes 层配置（form.draft 改控件形态），不在字段 options。",
+        "映射模型表要有数据下拉才有选项——空表=空下拉；数据段先通再配表单段。",
+    ],
+    priorToolReferences: [
+        { tool: "model.create", args: { environment }, purpose: "建映射模型（字段与接口返回一一对应）" },
+        { tool: "rule.save", args: { environment }, purpose: "数据段规则（三选一，见 conditionalRequirements）" },
+    ],
+    dryRun: { supported: true, command: `omc call field.create --env ${environment} --dry-run --args '<recipe.args>'`, notes: "校验 WORK_SHEET options 与 mappings 形状" },
+    expectedReadback: { readback: { field: { propertyType: "WORK_SHEET", options: { mappings: [{ source: "<映射模型.业务字段>" }] } } }, next: ["field.publish", "form.draft（控件形态配下拉框）", "form.publish", "门户填表验证：输关键字回车→选中→字段带出"] },
+    refusalRecovery: [
+        { code: "field-family-options-invalid", action: "WORK_SHEET options 必带 schemaCode/queryCode/displayField；mappings 用数组或 JSON 字符串均可（CLI 就地归一）" },
+        ...commonRecovery,
+    ],
+    notes: "r29 终轮定案：此模式是「外部数据填表带出」的平台正解；按钮触发回写是下策（多一次交互且体验差）。映射模型数据段的三个组合全部基于已验证的出参回写三前提（平铺端点/预置规则上下文/data 触发）。",
+    requiresEnvironmentDerivedIds: true,
+});
 export const FIELD_METADATA = Object.freeze({
     "field.update": Object.freeze({ recipes: [fieldSerialNumber, formConditionalRequired, formAlwaysReadonly, formConditionalReadonly], relatedTools: ["field.list", "field.publish", "form.draft", "form.publish"] }),
-    "field.create": Object.freeze({ recipes: [numericTwoDecimals, dictionarySelection, childTable, businessModelDropdown, formulaAggregationCrossModel], relatedTools: ["dictionary.names", "dictionary.records", "discover_environment", "field.list", "field.publish", "form.draft", "configure_form", "form.publish"] }),
+    "field.create": Object.freeze({ recipes: [numericTwoDecimals, dictionarySelection, childTable, businessModelDropdown, formulaAggregationCrossModel, externalLookupModel], relatedTools: ["dictionary.names", "dictionary.records", "discover_environment", "field.list", "field.publish", "form.draft", "configure_form", "form.publish"] }),
 });
 //# sourceMappingURL=field.js.map

package/dist/server.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { randomBytes } from "node:crypto";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { buildToolRegistry, makeToolContext } from "./tools.js";
+import { SessionManager } from "./session-manager.js";
+import { redact, redactError } from "./redact.js";
+import { ConfigStore } from "./config-store.js";
+import { contractMarkdown, contractResourceUri, LANE_CONTRACTS, shortToolDescription } from "./contract-resources.js";
+import { listSkills, readSkill } from "./skills.js";
+export function createMcpServer(options = {}) {
+    const context = makeToolContext({
+        sessions: options.sessions ?? new SessionManager(new ConfigStore()),
+        artifactsDir: options.artifactsDir,
+        tokenKey: options.tokenKey ?? randomBytes(32).toString("base64"),
+        tokenTtlMs: options.tokenTtlMs,
+    });
+    const secrets = options.secrets ?? (() => []);
+    const server = new McpServer({ name: "omc-cli", version: "0.1.0" }, {
+        capabilities: { tools: {}, resources: {} },
+        instructions: "Governed CloudPivot 8.6 configuration server. Tool schemas are self-describing (field families, relation options, rule nodeGraph, workflow template, formData, and the two-step approval flow). Methodology is served as MCP resources under omc://skills/ (five-piece flow, tool selection, acceptance criteria, requirement analysis, capability scouting, glossary, config draft review); read them with resources/list + resources/read rather than reading repository source. Before ANY write, read omc://skills/omc-config-draft-review: present the design (exact names/codes/types, layout, rule graph, view) as a plain-language draft and get explicit human approval first — the conversational human gate (approval granularity is the enumerated change package; an interrupted package loses its approval and resuming needs a fresh draft and go-ahead). Then: call without approvalToken to preview the plan, approval.request to get a token (the machine gate — it carries no human check), re-call with it. Production environments refuse writes by default (dual-key grant). Deliver ONE closing report per run — never interrupt per step.",
+    });
+    const register = server.tool.bind(server);
+    for (const definition of buildToolRegistry()) {
+        register(definition.name, shortToolDescription(definition.name, definition.kind, definition.lane) ?? definition.description, definition.inputSchema, async (args) => {
+            try {
+                const result = await definition.handler(context, args, definition);
+                return { content: [{ type: "text", text: redact(result, secrets()) }] };
+            }
+            catch (error) {
+                const refusal = error.payload;
+                if (refusal)
+                    return { content: [{ type: "text", text: redact(refusal, secrets()) }] };
+                const redacted = redactError(error, secrets());
+                return { content: [{ type: "text", text: redact({ status: "error", message: redacted.message }, secrets()) }], isError: true };
+            }
+        });
+    }
+    registerSkillResources(server);
+    registerContractResources(server);
+    return { server, context };
+}
+/**
+ * Serve the package's methodology notes as MCP resources so any client can
+ * read them on demand (host-agnostic) instead of the agent globbing the
+ * filesystem for them. Each skill file's YAML frontmatter supplies its name
+ * and description.
+ */
+function registerSkillResources(server) {
+    for (const entry of listSkills()) {
+        const document = readSkill(entry.name);
+        if (document === undefined)
+            continue;
+        server.registerResource(entry.name, entry.uri, { title: entry.name, description: entry.description, mimeType: "text/markdown" }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text: document.content }] }));
+    }
+}
+function registerContractResources(server) {
+    for (const contract of LANE_CONTRACTS) {
+        const text = contractMarkdown(contract);
+        server.registerResource(`contract-${contract.lane}`, contractResourceUri(contract), {
+            title: `${contract.lane} contract`,
+            description: `CloudPivot ${contract.family} contract for ${contract.lane}; reference ${contract.referenceVersion}`,
+            mimeType: "text/markdown",
+        }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text }] }));
+    }
+}
+export async function runStdioServer(options = {}) {
+    const { server } = createMcpServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function isProcessEntryPoint() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(entry) === fileURLToPath(import.meta.url);
+    }
+    catch {
+        return false;
+    }
+}
+if (isProcessEntryPoint()) {
+    runStdioServer().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    });
+}
+export { buildToolRegistry, makeToolContext };
+//# sourceMappingURL=server.js.map