@stalfh233/omc-cli 0.4.36 → 0.4.38

package/dist/json-column.js

@@ -1,68 +1,3 @@
-/**
- * Ticket 52 — one explicit home for "a platform JSON column may arrive as a
- * string (or an object)" decoding/encoding. Previously every lane carried a
- * local copy with subtly different behaviour; the deliberate differences are
- * now NAMED POLICIES chosen at each call site:
- *
- * - `JSON_COLUMN_PASSTHROUGH` — non-strings pass through untouched
- *   (undefined stays undefined); unparseable strings return verbatim.
- *   (datarule options, field.list readback)
- * - `JSON_COLUMN_NULL_COALESCE` — non-strings null-coalesce (undefined →
- *   null); blank/unparseable strings return verbatim ("" stays "").
- *   (businessrule node/route/schedulerSetting, b2 configJson/parameter faces,
- *   rule-support parameter faces, list-view condition options)
- * - `{ invalid: "throw" }` — a corrupt column is a hard error
- *   (field.update merge base reads the stored options strictly).
- *
- * Blank strings ("", "   ") are not valid JSON, so they always take the
- * `invalid` branch; at every previous site that meant passthrough.
- */
-export const JSON_COLUMN_PASSTHROUGH = { nonString: "passthrough", invalid: "passthrough" };
-export const JSON_COLUMN_NULL_COALESCE = { nonString: "null", invalid: "passthrough" };
-export function decodeJsonColumn(value, policy) {
-    if (typeof value !== "string")
-        return policy.nonString === "null" ? value ?? null : value;
-    try {
-        return JSON.parse(value);
-    }
-    catch (error) {
-        if (policy.invalid === "throw")
-            throw error;
-        return value;
-    }
-}
-/** Wire encode: a string is sent as-is, anything else is JSON-stringified. */
-export function encodeJsonColumn(value) {
-    return typeof value === "string" ? value : JSON.stringify(value);
-}
-/**
- * Decode an options face that may be a JSON string or already an object into
- * a plain record (or undefined). Policies preserve the previous per-site
- * semantics: relation options accept strings/objects/arrays loosely; the
- * FORMULA formulaConfig validator only accepts strings that parse to a
- * non-array object; field.update/form-scaffold strict reads throw on corrupt
- * strings.
- */
-export function decodeJsonObjectColumn(value, policy) {
-    const asRecord = (parsed) => {
-        if (!parsed || typeof parsed !== "object")
-            return undefined;
-        if (Array.isArray(parsed))
-            return policy.array === "reject" ? undefined : parsed;
-        return parsed;
-    };
-    if (typeof value === "string") {
-        try {
-            return asRecord(JSON.parse(value));
-        }
-        catch (error) {
-            if (policy.invalid === "throw")
-                throw error;
-            return undefined;
-        }
-    }
-    if (policy.object === "reject")
-        return undefined;
-    return asRecord(value);
-}
+// C1 拆分：json-column 已下沉 omc-core（真 lane 与 @stalfh233/omc-fake-platform 共用唯一事实源）；此处 re-export 保持既有 import 路径不变。
+export * from "omc-core/json-column";
 //# sourceMappingURL=json-column.js.map

package/dist/lanes/businessrule-contract.js

@@ -1,8 +1,9 @@
+export { RULE_STATUS } from "omc-core/wire-facts";
+import { RULE_STATUS } from "omc-core/wire-facts";
 import { behaviorBinding, CONTRACT_FAMILY, CONTRACT_REFERENCE_VERSION, assertDescriptionCarries, assertLaneContract, describeTool, emitterBinding } from "./contract-support.js";
 import { LANES } from "./lane-ids.js";
 import { RULE_ACTION_TYPES, RULE_CODE_TYPES, RULE_CONDITION_TYPES, RULE_DATA_SOURCE_TYPES, RULE_NODE_TEMPLATES, RULE_NODE_TYPES, RULE_SCHEDULER_CYCLE_TYPES, RULE_SCHEDULER_END_TYPES, RULE_SCHEDULER_EXECUTE_TYPES, RULE_SCHEDULER_SETTING_TEMPLATE, RULE_SCHEDULER_TRIGGER_TIME_TYPES, RULE_VALUE_TYPES } from "./rule-graph.js";
 /** Rule `enabled` is the runtime dispatch truth; `status` may lag (platform quirk). */
-export const RULE_STATUS = Object.freeze({ enabled: "ENABLE", disabled: "DISABLED" });
 /** Enum re-exports: rule-graph.ts is the single source (validator + fake + contract all import it). */
 export { RULE_VALUE_TYPES, RULE_ACTION_TYPES, RULE_CONDITION_TYPES, RULE_NODE_TYPES, RULE_NODE_TEMPLATES };
 /** The DISABLED dead-state body every fresh rule.save upsert writes. */
@@ -120,8 +121,8 @@ export const BUSINESSRULE_LANE_CONTRACT = Object.freeze({
         bizActionPersistence: Object.freeze([behaviorBinding("test/rule-list.test.ts#DYNAMIC UPDATE uses the production source-field wire and backfills the related target row", assertBusinessRuleContract)]),
         triggerConditions: Object.freeze([behaviorBinding("test/rule-graph-validation.test.ts#C.2: UPDATE with an empty filterCondition is flagged (warning) as a whole-table operation", assertBusinessRuleContract)]),
         compatibilityMatrix: Object.freeze([behaviorBinding("test/ticket-05-rule-compatibility-preflight.test.ts#known-invalid CREATE plus dictionary selection is refused before rule mutation", assertBusinessRuleContract)]),
-        dynamicConditionSource: Object.freeze([emitterBinding("lanes/rule-graph.DYNAMIC_CONDITION_SOURCE_KEY", assertBusinessRuleContract)]),
-        dynamicActionSource: Object.freeze([emitterBinding("lanes/rule-graph.DYNAMIC_ACTION_SOURCE_KEY", assertBusinessRuleContract)]),
+        dynamicConditionSource: Object.freeze([emitterBinding("omc-core/wire-facts.DYNAMIC_CONDITION_SOURCE_KEY", assertBusinessRuleContract)]),
+        dynamicActionSource: Object.freeze([emitterBinding("omc-core/wire-facts.DYNAMIC_ACTION_SOURCE_KEY", assertBusinessRuleContract)]),
         dynamicConditionValue: Object.freeze([behaviorBinding("test/rule-graph-validation.test.ts#negative: ticket 09 lesion", assertBusinessRuleContract)]),
         dynamicActionValue: Object.freeze([behaviorBinding("test/rule-graph-validation.test.ts#negative: ticket 09 lesion", assertBusinessRuleContract)]),
         dynamicNameKeys: Object.freeze([behaviorBinding("test/rule-list.test.ts#DYNAMIC UPDATE uses the production source-field wire", assertBusinessRuleContract)]),

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

@@ -1,15 +1,20 @@
+export { QUERY_ACTION_TYPE, QUERY_ACTION_RELATIVE, validateButtonActionConfig } from "omc-core/list-view-wire";
+import { QUERY_ACTION_TYPE, QUERY_ACTION_RELATIVE, validateButtonActionConfig, wireEnum } from "omc-core/list-view-wire";
 import { z } from "zod";
 import { ToolRefusalError } from "../tool-types.js";
 import { decodeJsonColumn, encodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "../json-column.js";
 import { FIELD_PROPERTY_TYPES } from "../field-families.js";
-function wireEnum(key, index) {
-    return {
-        key,
-        names: Object.keys(index),
-        index,
-        name: Object.fromEntries(Object.entries(index).map(([name, value]) => [value, name])),
-    };
-}
+/**
+ * Ticket 53 — each list-view concept (its wire enums, its input schema, its
+ * encode to the wire, its decode from readback, and its dry lint) is described
+ * ONCE here. `src/lanes/list-view.ts` consumes these descriptors to register
+ * the tools and `src/fake/list-view.ts` reuses the same enum constants, so a
+ * per-shape change is a one-file edit instead of four.
+ *
+ * Everything in this module is moved verbatim from list-view.ts; wire payloads
+ * and readback objects stay byte-identical (proven by the registry-dump hash,
+ * the existing list-view tests, and the bench +0.0 gate).
+ */
 /** Encode an enum name to its wire numeric index (undefined when unknown). */
 export function encodeEnumName(descriptor, name) {
     return typeof name === "string" ? descriptor.index[name] : undefined;
@@ -70,40 +75,6 @@ function defaultQueryFilterType(propertyType) {
 export const SORT_DIRECTION = wireEnum("SortDirectionType", { ASC: 1, DESC: 2 });
 export const DISPLAY_TYPE = wireEnum("DisplayType", { INPUT: 0, RADIO: 1, CHECKBOX: 2, SELECT: 3, RANGE: 4 });
 export const CHOICE_TYPE = wireEnum("ChoiceType", { SELECT: 1, POPUP: 2, TREE_LEFT: 3 });
-/**
- * BizQueryActionModel enums. `QueryActionType` (QueryActionType.java:13-35) and
- * `QueryActionRelativeType` (BIZSHEET 0/WORKFLOW 1) both carry
- * `@JsonValue getIndex()` so the wire body is numeric; the tool speaks the enum
- * name and decodes on readback. `associationType`/`associationCode` are the
- * JSON names of the DTO fields `queryActionRelativeType`/`relativeCode`
- * (`@JsonProperty`, BizQueryActionModel.java:31-35).
- */
-export const QUERY_ACTION_TYPE = wireEnum("QueryActionType", {
-    QUERY: 1,
-    ADD: 2,
-    EDIT: 3,
-    DELETE: 4,
-    IMPORT: 5,
-    EXPORT: 6,
-    CUSTOM: 7,
-    QR_CODE: 8,
-    EDITOWNER: 9,
-    BATCH_PRINT: 10,
-    BATCH_UPDATE: 11,
-    CUSTOMIZE_BTN: 12,
-    PRINT: 13,
-    COPY: 14,
-    TEMPORARY: 15,
-    SUBMIT: 16,
-    CLEAR_ROW: 17,
-    ADD_BEFORE: 18,
-    ADD_AFTER: 19,
-    MANUAL_SYNC: 20,
-    IMPORT_ATTACHMENT: 21,
-    EXPORT_ATTACHMENT: 22,
-    BATCH_SUBMIT: 23,
-});
-export const QUERY_ACTION_RELATIVE = wireEnum("QueryActionRelativeType", { BIZSHEET: 0, WORKFLOW: 1 });
 /**
  * `BizButtonModel` enums (listview custom buttons). Unlike the query DTOs
  * above, these implement `IStringEnum` with no `@JsonValue`, so Hutool parses
@@ -391,62 +362,6 @@ export function validatePresentationRenderShape(presentation) {
             presentationShape(presentation[key], key);
     }
 }
-function decodeButtonActionConfig(value, code) {
-    if (value === undefined)
-        return undefined;
-    if (typeof value === "string") {
-        try {
-            value = JSON.parse(value);
-        }
-        catch (error) {
-            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: actionConfig must be valid JSON (${error.message})` });
-        }
-    }
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: actionConfig must decode to an object` });
-    }
-    return value;
-}
-function requireButtonConfig(config, code, bindAction) {
-    const required = bindAction === "SCRIPT" ? ["scriptData"] : bindAction === "BUSINESS_RULE" || bindAction === "FLOW" ? ["targetCode"] : bindAction === "ADD_DATA" || bindAction === "FORM" ? ["schemaCodeVal", "formListData", "configureList"] : [];
-    for (const key of required) {
-        if (config?.[key] === undefined || config[key] === null) {
-            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: ${bindAction} actionConfig requires ${key}` });
-        }
-    }
-    if (bindAction === "SCRIPT" && typeof config?.scriptData !== "string") {
-        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: SCRIPT actionConfig.scriptData must be a string` });
-    }
-    if ((bindAction === "ADD_DATA" || bindAction === "FORM") && (typeof config?.schemaCodeVal !== "object" || config.schemaCodeVal === null || Array.isArray(config.schemaCodeVal) || !Array.isArray(config.formListData) || !Array.isArray(config.configureList))) {
-        throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: ${bindAction} actionConfig requires object schemaCodeVal and array formListData/configureList` });
-    }
-}
-export function validateButtonActionConfig(entry) {
-    const bindAction = typeof entry.bindAction === "string" ? entry.bindAction : "";
-    const code = String(entry.code ?? "");
-    const config = decodeButtonActionConfig(entry.actionConfig, code);
-    if (bindAction === "BUSINESS_RULE") {
-        if (typeof entry.targetCode !== "string" || entry.targetCode.length === 0) {
-            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: BUSINESS_RULE requires targetCode` });
-        }
-        return;
-    }
-    if (bindAction === "FLOW") {
-        if (typeof entry.targetCode !== "string" || entry.targetCode.length === 0) {
-            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: FLOW requires targetCode (workflow code)` });
-        }
-        // A caller-supplied FLOW actionConfig must carry WorkflowListData; the
-        // runtime indexes [0].workflowCode and iterates configureList. Omitted is
-        // fine — expandButtonActionConfigs derives both from targetCode.
-        if (config !== undefined && (typeof config !== "object" || config === null || !Array.isArray(config.WorkflowListData))) {
-            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-invalid", message: `buttons ${code}: FLOW actionConfig requires a WorkflowListData array (or omit actionConfig and the tool derives it from targetCode)` });
-        }
-        return;
-    }
-    if ((bindAction === "ADD_DATA" || bindAction === "FORM") && (entry.targetModel !== undefined || entry.targetForm !== undefined || entry.configureList !== undefined) && entry.actionConfig === undefined)
-        return;
-    requireButtonConfig(config, code, bindAction);
-}
 export function columnsRenderCompat(columns) {
     const violations = [];
     for (const [index, column] of columns.entries()) {

package/dist/lanes/model-contract.js

@@ -26,7 +26,7 @@ export const MODEL_WIRE = Object.freeze({
  * bypasses the tool precheck; 50000 stands for the generic ServiceException
  * envelope family and the authoritative signal is the verbatim errmsg text.
  */
-export const MODEL_REFERENCED_DELETE_ERRCODE = 50000;
+export { MODEL_REFERENCED_DELETE_ERRCODE } from "omc-core/wire-facts";
 /**
  * The platform create-body defaults the emitter sends verbatim. The emitter
  * imports THIS constant to build the wire body (model.create and the
@@ -86,7 +86,7 @@ export const MODEL_LANE_CONTRACT = Object.freeze({
         deleteIdNamespace: Object.freeze([behaviorBinding("test/model-delete-cross-app.test.ts#model.delete refuses fail-closed when the record exists", assertModelContract)]),
         deleteTolerance: Object.freeze([behaviorBinding("test/model-delete-many.test.ts#model.deleteMany short-circuits already-absent codes", assertModelContract)]),
         referencePrecheck: Object.freeze([
-            emitterBinding("lanes/model-contract.MODEL_REFERENCED_DELETE_ERRCODE", assertModelContract),
+            emitterBinding("omc-core/wire-facts.MODEL_REFERENCED_DELETE_ERRCODE", assertModelContract),
             behaviorBinding("test/model-delete-reference-block.test.ts#model.delete refuses with model-referenced-by", assertModelContract),
         ]),
         dependencyInvertedDelete: Object.freeze([behaviorBinding("test/model-delete-reference-block.test.ts#dependency-inverted cleanup chain passes", assertModelContract)]),

package/dist/lanes/rule-graph.js

@@ -9,6 +9,8 @@
  * node, the key, and what is missing. It runs client-side before any wire
  * call (dry lint) so a mis-shaped graph cannot reach the platform.
  */
+export { DYNAMIC_CONDITION_SOURCE_KEY, DYNAMIC_ACTION_SOURCE_KEY } from "omc-core/wire-facts";
+import { DYNAMIC_CONDITION_SOURCE_KEY, DYNAMIC_ACTION_SOURCE_KEY } from "omc-core/wire-facts";
 import { decodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "../json-column.js";
 export const RULE_VALUE_TYPES = ["DYNAMIC", "FIXED", "EMPTY", "VARIABLE", "EXPRESSION", "SYSTEM", "AGGREGATION"];
 /**
@@ -107,8 +109,6 @@ export const RULE_NODES_NEEDING_INPUT_PARAM = Object.freeze([
     "MESSAGE",
     "QUERY",
 ]);
-export const DYNAMIC_CONDITION_SOURCE_KEY = "currentSchemaDataItem";
-export const DYNAMIC_ACTION_SOURCE_KEY = "currentDataItemValue";
 /**
  * BRANCH `exitConditionGroups` deserialize into `DataFilterCondition`, whose
  * operator property is `ruleDataConditionType` and whose left/source property

package/dist/lanes/runtime-data-contract.js

@@ -1,85 +1,8 @@
 import { z } from "zod";
 import { assertDescriptionCarries, assertLaneContract, behaviorBinding, CONTRACT_FAMILY, CONTRACT_REFERENCE_VERSION, describeTool, emitterBinding } from "./contract-support.js";
 import { LANES } from "./lane-ids.js";
-/**
- * M2 runtime-data wire facts (live-proven). The submit chain, the replayToken
- * gate, the three-layer queryCondition, and the propertyType injection are the
- * single source for the handler, the arg schemas, and the fake.
- */
-export const RUNTIME_DATA_WIRE = Object.freeze({
-    queryConditionShape: "List<List<List<FilterModel>>>（level 1 AND across groups, level 2 OR across and-groups, level 3 AND across leaves）",
-    dslShape: "or>and>叶子",
-    queryBodyCanon: "filters:[], queryVersion:1, queryCode=schemaCode, showTotal",
-    typeCastErrcode: 10009,
-    emptyModelErrcode: 301005,
-    absenceErrcode: 304001,
-    formTypeNoWorkflow: "2",
-    formTypeWorkflow: "1",
-    replayTokenEndpoint: "/api/api/runtime/form/getReplayToken",
-    replayTokenErrcode: 100005,
-    approvalNpeErrcode: 50000,
-    workflowStartDuplicateErrcode: 40000,
-    submitChain: "submit 自持久化（ticket 18 源码证据）：form/submit 持久化 bizObject.data——formType=2 submitBizSheet→saveBizObject（置 COMPLETED，mergeObject 合并）；formType=1 workItem→SubmitDataChangeHandlerImpl.updateBizObject；payload {id,schemaCode,sheetCode,ownerId?,data}+actionCode:\"submit\"，owner 服务端以库内行回填，data 剥 engine 键（sequenceStatus/sequenceNo）",
-    submitInPlace: "无流程且 bizObjectId 有值时先 form/load 预检（缺席 304001 拒绝），再以预检行+formData 合成最小对象直提 runtime/form/submit（submit 自持久化，无预 save/构建 load）；submit 返回 objectId 必须仍是目标 id，否则拒绝；仅无 workflowCode/workItemId/workflowInstanceId 的无 id 便捷链先 form/save 建稿再直提（新建记录）；带 workItemId 或 workflowInstanceId 而缺 bizObjectId 时 fail-closed 拒绝（submit-biz-object-id-required）；workflowCode + 既有无实例 bizObjectId 在 8.6.26 无 REST 就地面（见 workflowStartCreateOnly），持续拒绝并指向 workflowDraftSave 两段式",
-    workflowDraftSave: "门户暂存形状（ticket 13）：POST runtime/form/save 顶层带 workflowCode（无 workflowInstanceId/workItemId）→ FormRuntimeController.saveWorkflow→startWorkflow(finishStart=FALSE)：同 id 建 DRAFT 行 + DRAFT 流程实例 + 发起 workItem，FormSaveVO 返回 {objectId,workflowInstanceId,workItem:{id}}；必须先 GET getReplayToken（isStartWf 分支 verifyReplay，否则 100005），且 data 显式 sequenceStatus:\"DRAFT\"（createAndGetBizObject 空缺省按 PROCESSING 建实例）；提交该草稿 = form/submit formType=1 + workItemId + workflowInstanceId + bizObject.id（submitWorkflowByInstanceIdAndItemId），同 id 就地 PROCESSING，绝不走 workflowCode 分支",
-    workflowStartCreateOnly: "form/submit formType=1 + workflowCode（无 workItemId）→ submitWorkflowByWorkflowCode→startWorkflowInstance(create)→BizObjectFacadeImpl.createAndGetBizObject 纯 INSERT（BizObjectInsertModel 无存在性检查）→ 既有 id 必 40000 Duplicate entry（TID 771f64ee 全栈：ExecutorBase INSERT→BizObjectServiceImplCompanion:275→40000）；8.6.26 唯一 load+update 型就地发起是 WorkflowInstanceFacade 5 参重载（908 行，facade 层供二开扩展消费），无 REST 面",
-    sheetResolution: "explicit caller arg > default-form sheetCode from bizsheet/get > schemaCode fallback",
-    updateBranch: "POST runtime/form/save 更新既有记录：目标 id 必须放进 bizObject.data[\"id\"]（平台 BizObjectModel.getId() 读 data 的 id 键；顶层 bizObject.id 会被忽略并退化为新建）；命中既有记录时 FormRuntimeController.saveBizSheet→BizObjectFacadeImpl.updateBizObject，未命中则 createBizObject 插入",
-    updateStatusRule: "既有记录的 DRAFT/COMPLETED 状态在未显式传 sequenceStatus 时原样保留（saveBizSheet 分支），COMPLETED 记录可直接 update，无需流程",
-    updateMergeRule: "updateBizObject.mergeObject 以库内旧值打底、以本次 data 覆盖 → 部分字段（patch）更新，未传字段保持不变",
-    childRowStatusNote: "子表行（CHILD_TABLE(8)）在 form-save 路径按每行 `rowStatus` 分派（BizObjectUpdateModel.convertBizObjectOpItem）：Added=插入 / Modified=更新 / Deleted=删除；**缺失或其它值=immutable（静默忽略）**。门户前端会为改动行标 `rowStatus:\"Modified\"`；手拼载荷漏了它，子表改动不落库、但写仍返回 errcode 0（真机 2026-10-08：data.update 改子表行无 rowStatus，process_name/计划时间读回全不变）。OMC 自动补：带自身 id 的行→\"Modified\"，无 id 的行→\"Added\"，显式 rowStatus 原样保留。",
-    updateAbsentGuard: "平台对\"带 id 但库内不存在\"不报错而是静默插入（createBizObject），故 data.update 先 form/load 预检，命中缺席则以 304001 拒绝，绝不静默转新增",
-    projectionHint: "所选列在默认视图未配置（值可能存在但列表投影为 null）；先用 listview.configure 配置列，或用 data.load 读单条权威值",
-    formulaFieldNote: "计算字段（FORMULA / 表单「计算」控件、子表计算规则）**不在服务端 API 路径回填/重算**：门户是**前端**算好再提交，API save/update/submit 都不会替它算（真机 2026-09-25：子表计算规则字段落库仍 null；纯主表表达式会算）。OMC 的定位是「字段配好即默认它在前台会算」——**写测试数据时应在 formData 里显式带上预算好的计算值**（让数据与预期自洽），**不要指望平台在 API 保存时替它算，也不要用 API 回读值去断言公式/计算是否正确**。**这类纯前台行为最终由人工在前台（配表单→填表）确认。** 另：带**子表计算字段**的模型，API data.save/data.update 可能因服务端重算（CalculateHandler→FormulaProcessor）NPE 而 50000（真机 2026-10-07，前台路径正常）——此类模型请改用门户录入或避开该字段，别据此判定配置错误。",
-});
-function encodeScalar(value) {
-    if (value === null || value === undefined)
-        return "";
-    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
-        return String(value);
-    if (value instanceof Date)
-        return value.toISOString();
-    return JSON.stringify(value);
-}
-function encodeList(value) {
-    if (Array.isArray(value))
-        return value.map(encodeScalar).join(";");
-    if (typeof value === "string")
-        return value;
-    return encodeScalar(value);
-}
-const numeric = (value) => Number(value);
-function betweenBounds(expected) {
-    const [low, high] = expected.split(";").map(Number);
-    return [low ?? 0, high ?? 0];
-}
-export const RUNTIME_QUERY_OPERATORS = Object.freeze({
-    Eq: { encode: encodeScalar, matches: (actual, expected) => String(actual ?? "") === expected },
-    NotEq: { encode: encodeScalar, matches: (actual, expected) => String(actual ?? "") !== expected },
-    Gt: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) > numeric(expected) },
-    Lt: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) < numeric(expected) },
-    Gte: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) >= numeric(expected) },
-    Lte: { encode: encodeScalar, matches: (actual, expected) => numeric(actual) <= numeric(expected) },
-    Like: { encode: encodeScalar, matches: (actual, expected) => String(actual ?? "").includes(expected) },
-    NotLike: { encode: encodeScalar, matches: (actual, expected) => !String(actual ?? "").includes(expected) },
-    In: { encode: encodeList, matches: (actual, expected) => expected.split(";").includes(String(actual ?? "")) },
-    NotIn: { encode: encodeList, matches: (actual, expected) => !expected.split(";").includes(String(actual ?? "")) },
-    Between: { encode: encodeList, matches: (actual, expected) => { const [low, high] = betweenBounds(expected); return numeric(actual) >= low && numeric(actual) <= high; } },
-    NotBetween: { encode: encodeList, matches: (actual, expected) => { const [low, high] = betweenBounds(expected); return !(numeric(actual) >= low && numeric(actual) <= high); } },
-    IsNull: { encode: () => "", matches: (actual) => actual === null || actual === undefined },
-    IsNotNull: { encode: () => "", matches: (actual) => actual !== null && actual !== undefined },
-});
-export const ENGINE_OWNED_KEYS = Object.freeze(["sequenceStatus", "2147483647_sequenceNo"]);
-export const SUBMIT_STATUS_TRANSITIONS = Object.freeze({
-    /** Start submit / start-item finish moves the row DRAFT -> PROCESSING. */
-    workflowStart: "PROCESSING",
-    /** Approval submit with agree!==false completes the row. */
-    approvalAgree: "COMPLETED",
-    /** Approval submit with agree===false cancels the row. */
-    approvalReject: "CANCELED",
-    /** formType=2 submitBizSheet -> saveBizObject completes in place. */
-    inPlaceSubmit: "COMPLETED",
-});
+export { RUNTIME_DATA_WIRE, RUNTIME_QUERY_OPERATORS, ENGINE_OWNED_KEYS, SUBMIT_STATUS_TRANSITIONS } from "omc-core/wire-facts";
+import { RUNTIME_DATA_WIRE } from "omc-core/wire-facts";
 export function dataListDescription() {
     const wire = RUNTIME_DATA_WIRE;
     return `按简化过滤 DSL 查询业务对象（runtime/query/list）；DSL 在 CLI 内翻译为平台 queryCondition（${wire.dslShape}），并按发布字段元数据为每个条件注入 propertyType（未知过滤字段将被拒绝，可用 rawCondition 逃生）；响应仅返回选定 fields 与分页元数据；空模型返回空列表；未配列的自定义字段投影为 null——这是显示面缺列配置、不是数据缺失（data.load 有值），显式选列在结果中全为 null 而发布字段元数据显示其存在时，readback 追加 projectionHint（先用 listview.configure 配置该模型的默认视图列，或用 data.load 读单条权威值）。`;
@@ -167,10 +90,10 @@ export const RUNTIME_DATA_LANE_CONTRACT = Object.freeze({
         dslShape: Object.freeze([emitterBinding("data-list-filter.SIMPLE_OP_MAP", assertRuntimeDataContract)]),
         queryBodyCanon: Object.freeze([behaviorBinding("test/data-list.test.ts#data.list translates simplified filters", assertRuntimeDataContract)]),
         typeCastErrcode: Object.freeze([emitterBinding("data-list-filter.injectPropertyTypes", assertRuntimeDataContract)]),
-        emptyModelErrcode: Object.freeze([emitterBinding("lanes/runtime-data-contract.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
-        absenceErrcode: Object.freeze([emitterBinding("lanes/runtime-data-contract.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
-        replayTokenErrcode: Object.freeze([emitterBinding("lanes/runtime-data-contract.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
-        approvalNpeErrcode: Object.freeze([emitterBinding("lanes/runtime-data-contract.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
+        emptyModelErrcode: Object.freeze([emitterBinding("omc-core/wire-facts.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
+        absenceErrcode: Object.freeze([emitterBinding("omc-core/wire-facts.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
+        replayTokenErrcode: Object.freeze([emitterBinding("omc-core/wire-facts.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
+        approvalNpeErrcode: Object.freeze([emitterBinding("omc-core/wire-facts.RUNTIME_DATA_WIRE", assertRuntimeDataContract)]),
         submitChain: Object.freeze([behaviorBinding("test/issue-13-data-submit.test.ts#data.submit with formType=2 issues a WorkItemSubmitVO", assertRuntimeDataContract)]),
         submitInPlace: Object.freeze([behaviorBinding("test/issue-13-data-submit.test.ts#data.submit with bizObjectId submits an existing no-workflow record in place", assertRuntimeDataContract)]),
         workflowDraftSave: Object.freeze([behaviorBinding("test/issue-13-data-submit.test.ts#data.save with workflowCode creates a DRAFT row", assertRuntimeDataContract)]),

package/dist/recipes/b2-registration.js

@@ -0,0 +1,87 @@
+import { environment, commonRecovery } from "./shared.js";
+const restfulQueryService = Object.freeze({
+    id: "restful-query-service",
+    title: "注册 RESTFUL 查询服务 + 一个方法（含参数面）",
+    status: "requires-prior-readback",
+    tool: "service.register",
+    args: {
+        environment,
+        serviceCode: "<service_code>",
+        name: "供应商查询服务",
+        adapterCode: "RESTFUL",
+        serviceCategoryId: "<category.id>",
+        serviceConfig: {
+            auth: { code: "customer", parameterlist: [] },
+            commonlist: [{ code: "url", value: "http://<host>/api" }],
+        },
+        methodName: "querySupplier",
+        methodConfig: { httpType: "Post", requestBodyType: "JSON", url: "/supplier/query", frontEndExtensionEnable: true },
+        methodInputParameters: [{ code: "keyword", name: "关键字", required: true, configJson: { position: "REQUEST_BODY" } }],
+        methodOutputParameters: [{ code: "name", name: "供应商名称", configJson: { position: "REQUEST_BODY" } }],
+    },
+    preconditions: ["serviceCategoryId 由 service.category.list 解析（「全部」是空 id 虚拟项不可用）；RESTFUL 服务 configJson 需要 auth 与 commonlist[url]；带 methodName 时必须有 methodConfig"],
+    conditionalRequirements: [
+        "RESTFUL auth.code ∈ customer(parameterlist=[]) / basic(client… username/password) / oauth_password / oauth_client；parameterlist 每项 {code,value} 且必须与 auth.code 期望参数完全一致",
+        "RESTFUL 方法 configJson 必需键：httpType(Post/Get/Put/Patch/Delete)、requestBodyType(Form-urlencoded/JSON/Text)、url、frontEndExtensionEnable(布尔)",
+        "RESTFUL 每个输入/输出参数必须带 configJson.position ∈ QUERY_PARAMS/REQUEST_HEADER/REQUEST_BODY/PATH_PARAMS（URL_VARIABLE 被运行时拒 501007）",
+        "一次写只建一个方法；给既有服务加方法走 method.create（escape hatch）",
+    ],
+    priorToolReferences: [
+        { tool: "service.category.list", args: { environment }, purpose: "取服务分类 id（所属目录必填）" },
+        { tool: "service.adapter_config", args: { environment }, purpose: "确认 RESTFUL 适配器的 commonList/authList 必需键与当前实例一致" },
+    ],
+    dryRun: { supported: true, command: `omc call service.register --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 做 adapter/serviceConfig/methodConfig/参数面本地预检，零 wire；用它一次性看清缺哪个键" },
+    expectedReadback: { performed: { errcode: 0 }, readback: { servicePresent: true, methodPresent: true, methodCount: 1 }, next: ["service.get 复核（凭据已脱敏）"] },
+    refusalRecovery: [
+        { code: "bizservice-service-config-invalid", action: "serviceConfig 需要 auth{code,parameterlist[]}+commonlist[{code:'url',value}]；按消息补键" },
+        { code: "bizservice-method-config-invalid", action: "methodConfig 需要 httpType/requestBodyType/url/frontEndExtensionEnable 四键" },
+        { code: "bizservice-parameter-face-invalid", action: "每个参数补 configJson.position；URL_VARIABLE 换 QUERY_PARAMS/REQUEST_BODY" },
+        { code: "bizservice-required-field-missing", action: "name/adapterCode/serviceCategoryId 是设计器必填；分类 id 不能为空" },
+        { code: "duplicate-service", action: "serviceCode 已存在；改用 service.update" },
+        { code: "bizservice-adapter-not-whitelisted", action: "写面仅 RESTFUL/DATA_SQL/DATA_TABLE/SAP/KAFKA/SOAP；INTERNAL 走二开扩展包" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "service.category.list", fields: ["category.id"] },
+});
+const bizserviceSelfCallCorp = Object.freeze({
+    id: "bizservice-self-call-corp",
+    title: "业务规则自调本实例：oauth_password 为基础；X-LowCode-Corpid 头视环境而定（token 是否自带 corpId，8.5+ 部分配置才需要）——非铁律，真机判定",
+    status: "offline-valid",
+    tool: "method.update",
+    args: {
+        environment,
+        serviceCode: "<service_code>",
+        methodCode: "<method_code>",
+        inputParameters: [
+            { code: "X-LowCode-Corpid", name: "corpId头", required: false, codeType: 0, bizCode: "<corpId 常量值>", configJson: { position: "REQUEST_HEADER" } },
+        ],
+    },
+    preconditions: [
+        "自调本实例（commonlist.url 指回本平台 /api）鉴权以 oauth_password 为基础（Authorization Bearer）。**X-LowCode-Corpid 头非铁律**：token 自带 corpId claim 的环境（生产多数）不配任何 corpid；token corpId=null 的环境（本沙盒 api 客户端；8.5+ 部分配置）缺头会 HTTP 200 但响应体 errcode:50000（corpId can not be blank，r5 实测 2026-10-10）。",
+        "**判定法（先做再配）**：带 token 直调一次扩展端点看**响应体 errcode**（HTTP 200 不代表成功，平台错误包在体里）；errcode:0 则不配 corpid；errcode:50000 则按本配方补方法参数（code=X-LowCode-Corpid、configJson.position=REQUEST_HEADER、codeType:0 CONST、值放 bizCode——平台注入，调用方无需传；手动 curl 加请求头即可）。",
+        "出站第三方接口按对方要求配鉴权，与本配方无关。",
+    ],
+    conditionalRequirements: [
+        "**参数 code 必须精确等于 `X-LowCode-Corpid`**——适配器按「参数 code = header 名」加入请求头（headerParam.add(key, value)）。",
+        "**corpid 传递有两种实证形状**：①方法级入参 code 为 X-LowCode-Corpid、configJson.position 为 REQUEST_HEADER 整数 2（r3-wms 实证可用）；②规则 BIZ_ACTION 的 inputMappings 加 CONST 映射（serviceMethodParameterCode 为 X-LowCode-Corpid、codeType 为 0、bizCode 放真实 corpId——r4-fin 实证：该环境下方法级 position:2 注入为空头值 [\"\"]，此形状才生效）。**先用 ②，双跑验证头值；①失效（头空）就换 ②**。CONST 值必须放 bizCode（平台只读 bizCode）。",
+        "**corpid 头非空即可（r6-onlinejs R19 实证）**：沙盒 token corpId=null 时，全 0 corpId 头（RELEVANCE-0000…）也 errcode:0；仅空头才 50000。多租户路由才需真值。凭据值不可从读回抄（读面按 ticket 115 掩码——0.4.16 起为结构化 {masked:true,hint}，旧版 ***），必须用任务环境事实真值（doctor 显示的 corpId、任务提供的 client_secret）。",
+        "configJson.position 用 REQUEST_HEADER 名即可（工具写侧编码为整数索引 2；wire 上是整数——写名字平台侧反序列化失败、header 根本不进，源码 @JsonCreator get(int)）。",
+        "BIZ_ACTION 节点调用该方法**无需传该常量参数**（方法级常量由平台注入）；只需照常映射业务参数。",
+    ],
+    priorToolReferences: [{ tool: "method.get", args: { environment, serviceCode: "<service_code>", methodCode: "<method_code>" }, purpose: "取现有参数面，update 时整组带回（含本常量头）" }],
+    dryRun: { supported: true, command: `omc call method.update --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验参数面/CONST 形状，零 wire" },
+    expectedReadback: { readback: { methodPresent: true, corpHeaderParam: "code=X-LowCode-Corpid position=REQUEST_HEADER(2) codeType=0 bizCode=<corpId>" }, next: ["BIZ_ACTION 规则触发后 E2E：被调接口不再回 50000 corpId can not be blank"] },
+    refusalRecovery: [
+        { code: "bizservice-parameter-face-invalid", action: "常量头也是参数：configJson.position=REQUEST_HEADER 必带" },
+        { code: "runtime-50000-corpId-blank", action: "header 仍空 = 常量值放错槽（须 bizCode）或参数 code 不是精确的 X-LowCode-Corpid；method.get 读回核对" },
+        { code: "bizservice-auth-credential-placeholder", action: "凭据被掩码/占位值守卫拦截——读回掩码 *** 或自造 RELEVANCE-xxx/全 0 不可注册；凭据必须从任务环境事实取真值（doctor 显示的 corpId、任务提供的 client_secret），不可从读回抄" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: false,
+});
+export const B2_METADATA = Object.freeze({
+    "service.register": Object.freeze({ recipes: [restfulQueryService], relatedTools: ["service.category.list", "service.adapter_config", "service.get", "method.get"] }),
+    "method.update": Object.freeze({ recipes: [bizserviceSelfCallCorp], relatedTools: ["method.get", "method.create", "service.get"] }),
+});
+//# sourceMappingURL=b2-registration.js.map