@stalfh233/omc-cli 0.4.42 → 0.4.43

package/dist/lanes/field.js

@@ -36,8 +36,8 @@ function fieldRollbackSpec(toolName) {
             const row = before;
             const options = row.options !== undefined ? decodeJsonColumn(row.options, JSON_COLUMN_PASSTHROUGH) : undefined;
             if (toolName === "field.delete")
-                return { kind: "calls", calls: [{ tool: "field.create", args: { schemaCode, code, name: String(row.name ?? code), propertyType: String(row.propertyType ?? row.type), ...(options !== undefined ? { options } : {}), ...(row.choices !== undefined ? { choices: row.choices } : {}), ...(row.relativeCode !== undefined ? { relativeCode: row.relativeCode } : {}), ...(row.subFields !== undefined ? { subFields: row.subFields } : {}) } }] };
-            return { kind: "calls", calls: [{ tool: "field.update", args: { schemaCode, code, ...(row.name !== undefined ? { name: row.name } : {}), ...(row.name_i18n !== undefined ? { name_i18n: row.name_i18n } : {}), ...(options !== undefined ? { options } : {}), ...(row.choices !== undefined ? { choices: row.choices } : {}), ...(row.relativeCode !== undefined ? { relativeCode: row.relativeCode } : {}), ...(row.subFields !== undefined ? { subFields: row.subFields } : {}), ...(row.propertyEmpty !== undefined ? { propertyEmpty: row.propertyEmpty } : {}) } }] };
+                return { kind: "calls", calls: [{ tool: "field.create", args: { schemaCode, code, name: String(row.name ?? code), propertyType: String(row.propertyType ?? row.type), ...(options !== undefined ? { options } : {}), ...(row.choices !== undefined ? { choices: row.choices } : {}), ...(row.relativeCode != null ? { relativeCode: row.relativeCode } : {}), ...(row.subFields !== undefined ? { subFields: row.subFields } : {}) } }] };
+            return { kind: "calls", calls: [{ tool: "field.update", args: { schemaCode, code, ...(row.name !== undefined ? { name: row.name } : {}), ...(row.name_i18n != null ? { name_i18n: row.name_i18n } : {}), ...(options !== undefined ? { options } : {}), ...(row.choices !== undefined ? { choices: row.choices } : {}), ...(row.relativeCode != null ? { relativeCode: row.relativeCode } : {}), ...(row.subFields !== undefined ? { subFields: row.subFields } : {}), ...(row.propertyEmpty !== undefined ? { propertyEmpty: row.propertyEmpty } : {}) } }] };
         },
     };
 }

package/dist/lanes/workflow.js

@@ -967,6 +967,23 @@ async function backfillDesignerDefaults(session, schemaCode, body, callerTemplat
         }
     }
 }
+/**
+ * Rename pairs surfaced in the readback (live r51 2026-10-14): a rename mints
+ * `<original>_<n>` and DROPS the original code — re-sending the OLD code then
+ * reads as a brand-new node and APPENDS it, silently growing the flow. The
+ * readback names the pairs so the caller switches to the new code.
+ */
+function renamedActivityPairs(template, data) {
+    const callerCodes = new Set((callerActivities(template) ?? []).map((row) => activityCodeOf(row)).filter((code) => code !== ""));
+    const bodyCodes = new Set((Array.isArray(data.activities) ? data.activities : []).map((row) => String(row.activityCode ?? "")));
+    const pairs = [];
+    for (const code of bodyCodes) {
+        const match = /^(.+)_\d+$/.exec(code);
+        if (match && callerCodes.has(match[1]) && !bodyCodes.has(match[1]))
+            pairs.push({ from: match[1], to: code });
+    }
+    return pairs;
+}
 /**
  * Live 2026-10-14: a workflow node's propertyPermissions ACCEPTS
  * `required:true` on a CHILD_TABLE (子表) property at the wire level, but the
@@ -1633,7 +1650,8 @@ export function registerWorkflowLane(tools) {
             throw new ToolRefusalError({ status: "refused", blocker: "workflow-render-readback-invalid", message: "workflow.update returned no draft" });
         validateWorkflowRender(data, "workflow.update readback");
         const participantWarnings = participantReferenceWarnings(data);
-        return { performed: { errcode: performed.errcode }, readback: { workflowCode: args.code, activities: Array.isArray(data.activities) ? data.activities.length : 0, templateType: data.templateType ?? null, ...(participantWarnings.length ? { participantWarnings } : {}), workflowRenderCompat: workflowRenderCompat(data) } };
+        const renamedActivities = renamedActivityPairs(template, data);
+        return { performed: { errcode: performed.errcode }, readback: { workflowCode: args.code, activities: Array.isArray(data.activities) ? data.activities.length : 0, templateType: data.templateType ?? null, ...(participantWarnings.length ? { participantWarnings } : {}), ...(renamedActivities.length ? { renamedActivities, renamedHint: "改名会铸新码（上表 from→to）且旧码已失效——后续读写一律用 to；再用旧码 from 会被当作新节点追加" } : {}), workflowRenderCompat: workflowRenderCompat(data) } };
     }, (args) => {
         // Zero-wire refusal (ticket 77): fires in semanticGate BEFORE the
         // governed pipeline — including the rollback before-capture read.

package/dist/recipes/online-js.js

@@ -8,12 +8,12 @@ const onlinejsHighlightScript = Object.freeze({
         environment,
         schemaCode: model,
         sheetCode: "<默认表单 code == 模型 code>",
-        mode: "replace",
+        replace: true,
         source: "(function(form){ var amt = form.getControl('amountCode'); var party = form.getControl('targetCode'); function refresh(v){ party.options.style = Number(v) > 100000 ? 'color: red;' : ''; } form.on('onRendered', function(){ refresh(amt.getValue()); amt.valueChange.subscribe(function(change){ refresh(change.value); }); }); })",
     },
     preconditions: [
         "控件编码先 model.inspect/field.list 确认（示例 amountCode/targetCode 换成真实字段 code）",
-        "完整 `(function(form){…})` 生命周期外壳必须 mode:'replace'（merge 模式收外壳会被拒并指路 replace——r38 实证）",
+        "完整 `(function(form){…})` 生命周期外壳必须配 `replace:true`（默认 INCREMENTAL merge 收外壳会被拒并指路 replace——r38 实证）",
     ],
     conditionalRequirements: [
         "事件模型：`form.on('onRendered', …)` 初始化 + `<控件>.valueChange.subscribe(function(change){ change.value })` 监听；改样式用 `control.options.style`",
@@ -23,7 +23,7 @@ const onlinejsHighlightScript = Object.freeze({
     priorToolReferences: [{ tool: "form.get", args: { environment, schemaCode: model }, purpose: "确认表单已发布与控件编码" }],
     dryRun: { supported: true, command: `omc call onlinejs.compose --env ${environment} --dry-run --args-file compose.json`, notes: "dry-run 校验外壳/合并模式，不写平台" },
     expectedReadback: { readback: { deliveryState: "DELIVERED", published: true, scriptElementPresent: true, htmlRenderCompat: { draft: { ok: true }, published: { ok: true } } } },
-    refusalRecovery: [{ code: "merge-mode-requires-shell", action: "完整外壳改 mode:'replace'（六元素模板保留，仅整体替换 customScript）" }],
+    refusalRecovery: [{ code: "onlinejs-source-invalid", action: "完整外壳改 `replace:true`（六元素模板保留，仅整体替换 customScript）" }],
     requiresEnvironmentDerivedIds: false,
 });
 export const ONLINEJS_METADATA = Object.freeze({

package/dist/rollback-spec.js

@@ -59,6 +59,28 @@ export function deepDiff(before, current, path = "", limit = 40, acc = []) {
     walk(before, current, path);
     return { changes: acc, total: acc.length };
 }
+/**
+ * Drop null/undefined values from inverse-call args, recursively (live r55
+ * 2026-10-14): the wire rows carry explicit nulls (`relativeCode:null`) and
+ * `!== undefined` guards let them through — the target tool's input schema then
+ * rejects the replay as input-invalid (exit 10) and the restore stops. A null
+ * in the before row means "no value", and for every replayable config tool an
+ * ABSENT key is the same meaning with a schema the tool accepts.
+ */
+export function pruneNullish(value) {
+    if (Array.isArray(value))
+        return value.map(pruneNullish);
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (item === null || item === undefined)
+                continue;
+            out[key] = pruneNullish(item);
+        }
+        return out;
+    }
+    return value;
+}
 /**
  * Canonical projection for restore verification: a replayed restore will
  * NEVER be byte-equal to the before snapshot — the platform stamps

package/dist/rollback.js

@@ -5,13 +5,20 @@ import { SessionManager } from "./session-manager.js";
 import { makeToolContext, buildToolRegistry } from "./tools.js";
 import { runToolCall } from "./call.js";
 import { readJournal, resolveJournalEntry, laterWritesOnTarget } from "./journal.js";
-import { canonicalForVerify, deepDiff } from "./rollback-spec.js";
+import { canonicalForVerify, deepDiff, pruneNullish } from "./rollback-spec.js";
 import { sha256 } from "./support.js";
 import { emitTransportResult } from "./command-transport.js";
 /** Pure runtime assembly: an injected context (tests) or the default one. */
 function runtime(context) {
     return context ?? makeToolContext({ sessions: new SessionManager(new ConfigStore(defaultPaths())) });
 }
+/** Nullish-prune every call arg set in an inverse plan (see pruneNullish). */
+function pruneInversePlan(plan) {
+    const pruneCalls = (calls) => calls.map((call) => ({ tool: call.tool, args: pruneNullish(call.args) }));
+    if (plan.kind === "calls")
+        return { ...plan, calls: pruneCalls(plan.calls) };
+    return plan.partial ? { ...plan, partial: pruneCalls(plan.partial) } : plan;
+}
 function resolvedEnvironment(environment) {
     return new ConfigStore(defaultPaths()).resolveEnvironment(environment).name;
 }
@@ -94,17 +101,31 @@ async function buildPlan(ref, environmentOption, context) {
             currentFingerprint,
             diff: deepDiff(before, current),
             laterWrites,
-            inverse: spec.inverse({ before, args: artifactArgs, readback: (artifact.readback ?? {}) }),
+            // Every inverse call's args are nullish-pruned centrally: wire-row nulls
+            // must never reach a tool's input schema (r55 field.update relativeCode:null).
+            inverse: pruneInversePlan(spec.inverse({ before, args: artifactArgs, readback: (artifact.readback ?? {}) })),
         },
     };
 }
 export async function planRollback(ref, options, context) {
     const loaded = await buildPlan(ref, options.environment, context);
     const { entry, plan } = loaded;
+    // Preview values are for READING — full before templates run to tens of KB
+    // and used to blow the envelope budget (live r51: plan had to be fetched
+    // back from an artifact). Truncate previews; `apply` executes the full
+    // parameters regardless.
+    const preview = (value) => {
+        if (value === undefined || value === null)
+            return value;
+        const text = typeof value === "string" ? value : JSON.stringify(value);
+        return text !== undefined && text.length > 200 ? `${text.slice(0, 200)}…（省略 ${text.length - 200}B，apply 用完整参数）` : value;
+    };
+    const script = plan.inverse.kind === "calls" ? plan.inverse.calls.map((call) => JSON.stringify({ tool: call.tool, args: { ...call.args, environment: entry.environment } })) : [];
+    const scriptOmitted = script.join("").length > 6000;
     return {
         status: "ok",
         rollbackOf: { seq: entry.seq, tool: entry.tool, target: entry.target, ts: entry.ts },
-        diff: { changedPaths: plan.diff.changes, total: plan.diff.total },
+        diff: { changedPaths: plan.diff.changes.map((change) => ({ path: change.path, before: preview(change.before), current: preview(change.current) })), total: plan.diff.total },
         ...(plan.laterWrites.length > 0
             ? { warning: `该目标在此写之后还有 ${plan.laterWrites.length} 次写（seq ${plan.laterWrites.map((w) => w.seq).join(", ")}）；本次回滚会用 before 参数覆盖这些后续变更`, laterWrites: plan.laterWrites.map((w) => ({ seq: w.seq, tool: w.tool, ts: w.ts })) }
             : {}),
@@ -113,7 +134,9 @@ export async function planRollback(ref, options, context) {
                 kind: "calls",
                 count: plan.inverse.calls.length,
                 ...(plan.inverse.notes ? { notes: plan.inverse.notes } : {}),
-                script: plan.inverse.calls.map((call) => JSON.stringify({ tool: call.tool, args: { ...call.args, environment: entry.environment } })),
+                ...(scriptOmitted
+                    ? { scriptOmitted: true, scriptHint: "恢复调用参数较大（含完整 before 模板）已省略——直接 omc rollback apply <seq> 执行即用完整参数" }
+                    : { script }),
             }
             : { kind: "irreversible", reason: plan.inverse.reason, ...(plan.inverse.partial ? { partial: plan.inverse.partial } : {}) },
         hint: "预览不写入；确认后 omc rollback apply <seq>（恢复走完整写闸门，回滚本身也会记 journal，可再回滚）",
@@ -137,7 +160,16 @@ export async function applyRollback(ref, options, context) {
             context: ctx,
             print: () => undefined,
         });
-        results.push({ tool: call.tool, exitCode, status: result.status, ...(result.deliveryState ? { deliveryState: result.deliveryState } : {}), ...(result.summary ? { summary: result.summary } : {}) });
+        results.push({
+            tool: call.tool,
+            exitCode,
+            status: result.status,
+            ...(result.deliveryState ? { deliveryState: result.deliveryState } : {}),
+            ...(result.summary ? { summary: result.summary } : {}),
+            // r55: exit-code-only results hid the reason a restore call failed
+            // (input-invalid showed as a bare "status=error"). Surface the shape.
+            ...(exitCode === 0 ? {} : { blocker: result.blocker ?? null, message: result.message ?? null, ...(result.issues !== undefined ? { issues: result.issues } : {}), ...(result.diagnostic !== undefined ? { diagnostic: result.diagnostic } : {}) }),
+        });
         if (exitCode !== 0)
             return { status: "stopped", rollbackOf: { seq: entry.seq, tool: entry.tool }, step: index + 1, results, message: `恢复调用 ${call.tool} 未成功（status=${result.status}）；已执行的调用已各自记 journal，可对已完成步骤再 plan` };
     }

package/package.json

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

package/skills/omc-business-configuration.md

@@ -42,6 +42,7 @@ node "$CLI" help omc-five-piece-flow
 
 ## 模型与字段
 
+- **code 长度平台硬限**：模型 code ≤26 字符、字段 code ≤28（`business-code-invalid` 出门校验；长业务名先起短 code，长名放 name）。
 - 模型层字段默认可空；必填、只读、可见性在表单和流程节点配置。
 - `propertyEmpty` 默认 `false`，不要把业务必填硬编码在数据模型。
 - 关联单选优先读目标模型已发布字段，明确显示字段；无映射不要写空数组字符串。