@stalfh233/omc-cli 0.4.71 → 0.4.72

package/dist/artifacts.js

@@ -1,5 +1,5 @@
 import { createHash, randomUUID } from "node:crypto";
-import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
 export const CLI_DEFAULT_OUTPUT_BYTES = 64 * 1024;
 export const CLI_MAX_OUTPUT_BYTES = 4 * 1024 * 1024;
@@ -13,8 +13,30 @@ function ensureRoot(root) {
     mkdirSync(resolved, { recursive: true, mode: 0o700 });
     return resolved;
 }
+const PRUNE_STAMP = ".prune-stamp";
+const PRUNE_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const PRUNE_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Opportunistic hygiene: at most once per day, drop artifacts untouched for a
+ * week and enforce the size budget. Hooked into createArtifact so a long-running
+ * project never needs a manual sweep; the stamp keeps the scan off the hot path
+ * (one readdir per day, not per call).
+ */
+function maybeAutoPrune(resolvedRoot) {
+    const stampPath = join(resolvedRoot, PRUNE_STAMP);
+    try {
+        if (existsSync(stampPath) && Date.now() - statSync(stampPath).mtimeMs < PRUNE_INTERVAL_MS)
+            return;
+        pruneArtifacts(resolvedRoot, { olderThanMs: PRUNE_AGE_MS });
+        writeFileSync(stampPath, `${new Date().toISOString()}\n`, { mode: 0o600 });
+    }
+    catch {
+        // Hygiene is best-effort: never fail a write because cleanup did.
+    }
+}
 export function createArtifact(root, content) {
     const resolvedRoot = ensureRoot(root);
+    maybeAutoPrune(resolvedRoot);
     const artifactId = randomUUID();
     const path = artifactPath(resolvedRoot, artifactId);
     const bytes = typeof content === "string" ? Buffer.from(content, "utf8") : content;
@@ -116,4 +138,57 @@ export function assertSafeInputPath(root, candidate, label) {
     }
     return normalized;
 }
+export function pruneArtifacts(root, options = {}) {
+    const resolvedRoot = resolve(root);
+    if (!existsSync(resolvedRoot))
+        return { removed: 0, freedBytes: 0, kept: 0, keptBytes: 0 };
+    const now = options.now ?? Date.now();
+    const olderThanMs = options.olderThanMs;
+    const maxBytes = options.maxBytes ?? 256 * 1024 * 1024;
+    const entries = [];
+    let keptBytes = 0;
+    let removed = 0;
+    let freedBytes = 0;
+    const removePair = (path, size) => {
+        try {
+            rmSync(path, { force: true });
+            rmSync(`${path}.sha256`, { force: true });
+            removed += 1;
+            freedBytes += size;
+        }
+        catch { /* best effort */ }
+    };
+    for (const name of readdirSync(resolvedRoot)) {
+        if (!/^[a-f0-9-]{36}\.artifact$/u.test(name))
+            continue;
+        const path = join(resolvedRoot, name);
+        let stat;
+        try {
+            stat = lstatSync(path);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isSymbolicLink() || !stat.isFile())
+            continue;
+        if (olderThanMs !== undefined && now - stat.mtimeMs > olderThanMs) {
+            removePair(path, stat.size);
+            continue;
+        }
+        entries.push({ path, size: stat.size, mtimeMs: stat.mtimeMs });
+        keptBytes += stat.size;
+    }
+    // Budget sweep: oldest first until the store fits.
+    if (keptBytes > maxBytes) {
+        entries.sort((left, right) => left.mtimeMs - right.mtimeMs);
+        for (const entry of entries) {
+            if (keptBytes <= maxBytes)
+                break;
+            removePair(entry.path, entry.size);
+            keptBytes -= entry.size;
+        }
+    }
+    const kept = entries.filter((entry) => existsSync(entry.path)).length;
+    return { removed, freedBytes, kept, keptBytes };
+}
 //# sourceMappingURL=artifacts.js.map

package/dist/bench/evals.js

@@ -76,6 +76,11 @@ const GOLDEN_CASES = [
         async run(harness) {
             await call(harness, "model.create", { name: "金轨迹回填源", code: "omc_mcp_gd2" });
             await call(harness, "model.create", { name: "金轨迹回填目标", code: "omc_mcp_gp" });
+            // The platform's rule self-check resolves UPDATE targets against the
+            // TARGET model's PUBLISHED fields; an unseeded target would 550018 here
+            // and never exercise the DYNAMIC wire this case exists to pin.
+            await call(harness, "field.create", { schemaCode: "omc_mcp_gp", code: "latestPeriod", name: "最近申报期", propertyType: "SHORT_TEXT" });
+            await call(harness, "field.publish", { schemaCode: "omc_mcp_gp" });
             harness.fake.seedDataRow("omc_mcp_gp", { latestPeriod: "" }, "omc_mcp_gp_row");
             await call(harness, "rule.save", {
                 schemaCode: "omc_mcp_gd2",
@@ -107,6 +112,9 @@ const GOLDEN_CASES = [
         async run(harness) {
             await call(harness, "model.create", { name: "金轨迹固定值源", code: "omc_mcp_gf2" });
             await call(harness, "model.create", { name: "金轨迹固定值目标", code: "omc_mcp_gf" });
+            await call(harness, "field.create", { schemaCode: "omc_mcp_gf", code: "state", name: "状态", propertyType: "SHORT_TEXT" });
+            await call(harness, "field.create", { schemaCode: "omc_mcp_gf", code: "count", name: "次数", propertyType: "NUMERICAL", options: { scale: 0 } });
+            await call(harness, "field.publish", { schemaCode: "omc_mcp_gf" });
             harness.fake.seedDataRow("omc_mcp_gf", { state: "old", count: 0 }, "omc_mcp_gf_row");
             await call(harness, "rule.save", {
                 schemaCode: "omc_mcp_gf2",

package/dist/cli.js

@@ -16,7 +16,7 @@ import { CLI_EXIT_CODES, classifyResult, envelope, errorEnvelope, requestId } fr
 import { configureOutput, humanSummary, stripOutputFlags, writeEnvelope } from "./cli-output.js";
 import { beginUsage, completeUsage, recordUsageOutput, usageReport } from "./usage-log.js";
 import { artifactFetchHint, artifactRoot, boundResult, emitInvalid, emitResult, emitTransportResult, outputBudget, readArtifact, withTransport, } from "./command-transport.js";
-import { CLI_DEFAULT_OUTPUT_BYTES, assertSafeOutputPath } from "./artifacts.js";
+import { CLI_DEFAULT_OUTPUT_BYTES, assertSafeOutputPath, pruneArtifacts } from "./artifacts.js";
 import { resolve } from "node:path";
 import { buildToolRegistry } from "./tools.js";
 import { acquireWriteLock } from "./write-lock.js";
@@ -437,6 +437,22 @@ function projectJsonPath(value, path) {
     }
     return { missed: false, value: current };
 }
+function parseDurationMs(text) {
+    const match = /^\s*(\d+)\s*(ms|s|m|h|d|w)?\s*$/u.exec(text);
+    if (!match)
+        return undefined;
+    const amount = Number(match[1]);
+    const unit = match[2] ?? "d";
+    const factor = unit === "ms" ? 1 : unit === "s" ? 1000 : unit === "m" ? 60_000 : unit === "h" ? 3_600_000 : unit === "d" ? 86_400_000 : 604_800_000;
+    return amount * factor;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
+}
 async function cmdArtifactGet(id, transport, options = {}) {
     try {
         const artifact = readArtifact(artifactRoot(), id);
@@ -1071,7 +1087,34 @@ async function main() {
     rollbackCommand.command("apply <ref>").option("--env <environment>").option("--environment <environment>").option("--confirm-production").action(async (ref, options) => {
         commandExitCode = await withTransport(options, "rollback apply", (transport) => cmdRollbackApply(ref, { environment: options.env ?? options.environment, confirmProduction: options.confirmProduction === true }, transport));
     });
-    command.command("artifact").command("get <id>").option("--jq <path>").option("--path-only").option("--summary").option("--keys [a,b]").option("--max-output-bytes <bytes>").action(async (id, options) => {
+    const artifactCommand = command.command("artifact");
+    artifactCommand.command("prune").option("--older-than <duration>", "删除超过该时长的读回产物（如 7d/12h/30m）").option("--max-bytes <bytes>", "产物目录预算；超出时按最旧优先删除").option("--json").action((options) => {
+        // Machine-global store: oversized readbacks pile up (504 files / 3.4 MB
+        // after one sandbox round). Pruning is deterministic and safe to run at
+        // any time — it only removes this store's own artifact files.
+        const olderThanMs = options.olderThan === undefined ? undefined : parseDurationMs(options.olderThan);
+        if (options.olderThan !== undefined && olderThanMs === undefined) {
+            console.error("用法：omc artifact prune [--older-than 7d] [--max-bytes 268435456] [--json]");
+            commandExitCode = CLI_EXIT_CODES.invalidInput;
+            return;
+        }
+        const maxBytes = options.maxBytes === undefined ? undefined : Number(options.maxBytes);
+        if (options.maxBytes !== undefined && (!Number.isFinite(maxBytes) || Number(maxBytes) < 0)) {
+            console.error("--max-bytes 必须是非负整数");
+            commandExitCode = CLI_EXIT_CODES.invalidInput;
+            return;
+        }
+        const result = pruneArtifacts(artifactRoot(), {
+            ...(olderThanMs !== undefined ? { olderThanMs } : {}),
+            ...(maxBytes !== undefined ? { maxBytes } : {}),
+        });
+        if (options.json)
+            process.stdout.write(JSON.stringify({ ok: true, ...result }, null, 2) + "\n");
+        else
+            console.error(`已清理 ${result.removed} 个读回产物，释放 ${formatBytes(result.freedBytes)}；保留 ${result.kept} 个（${formatBytes(result.keptBytes)}）`);
+        commandExitCode = CLI_EXIT_CODES.ok;
+    });
+    artifactCommand.command("get <id>").option("--jq <path>").option("--path-only").option("--summary").option("--keys [a,b]").option("--max-output-bytes <bytes>").action(async (id, options) => {
         commandExitCode = await withTransport(options, request, (transport) => cmdArtifactGet(id, transport, { ...(options.jq ? { jq: options.jq } : {}), pathOnly: options.pathOnly === true, summary: options.summary === true || options.keys === true, ...(typeof options.keys === "string" ? { keys: options.keys } : {}) }));
     });
     command.command("bench").option("--live-sample").option("--env <environment>").action(async (options) => { commandExitCode = await cmdBench([...(options.liveSample ? ["--live-sample"] : []), ...(options.env ? ["--env", options.env] : [])]); });

package/dist/lanes/rule-graph.js

@@ -615,6 +615,55 @@ export function graphGeometryNeedsLayout(nodesInput, routesInput) {
     const boxes = nodes.map(boxOf);
     return boxes.some((a, ai) => boxes.some((b, bi) => bi > ai && a.x < b.x + b.width && b.x < a.x + a.width && a.y < b.y + b.height && b.y < a.y + a.height));
 }
+/**
+ * System persistence nodes belong to the TOOL, never to the caller.
+ *
+ * `SYSTEM_CREATE/SYSTEM_UPDATE/SYSTEM_DELETE` are the platform's trigger-row
+ * persistence nodes: the correct one is a function of the rule code
+ * (Create→SYSTEM_CREATE, …) and its position is a function of the action nodes.
+ * A caller who hand-writes one can only get it wrong:
+ *
+ *  - wrong type inside a preset rule → data.submit 50000 (live 2026-09-25);
+ *  - any type inside a CUSTOM rule bound to a workflow event → the end/cancel
+ *    agenda has no serializable current object and every run throws
+ *    `Object <id> is not serialized` (live 2026-10-22, r8: 33 occurrences,
+ *    nothing written, every step still reported DELIVERED);
+ *  - right type but wrong seat → the merged result is persisted before the
+ *    action writes it (ASSIGN/BIZ_ACTION must precede the system node).
+ *
+ * So strip whatever the caller supplied and let `injectDefaultSystemNode` place
+ * the one platform default (preset rules only). Routes through the stripped
+ * node are bridged pre→post so the chain stays connected.
+ */
+export function stripCallerSystemNodes(nodesInput, routesInput) {
+    const nodes = asRecordArray(parseMaybeJson(nodesInput));
+    const routes = asRecordArray(parseMaybeJson(routesInput));
+    const systemTypes = new Set(["SYSTEM_CREATE", "SYSTEM_UPDATE", "SYSTEM_DELETE"]);
+    const stripped = nodes
+        .filter((node) => systemTypes.has(String(node.nodeType ?? "")))
+        .map((node) => String(node.nodeCode ?? ""));
+    if (stripped.length === 0)
+        return { nodes, routes, stripped };
+    let nextRoutes = routes;
+    for (const code of stripped) {
+        const incoming = nextRoutes.filter((route) => String(route.postNode ?? "") === code).map((route) => String(route.preNode ?? ""));
+        const outgoing = nextRoutes.filter((route) => String(route.preNode ?? "") === code).map((route) => String(route.postNode ?? ""));
+        nextRoutes = nextRoutes.filter((route) => String(route.preNode ?? "") !== code && String(route.postNode ?? "") !== code);
+        for (const pre of incoming)
+            for (const post of outgoing)
+                nextRoutes.push({ preNode: pre, postNode: post });
+    }
+    // Collapse duplicate edges produced by bridging (same endpoints + condition).
+    const seen = new Set();
+    nextRoutes = nextRoutes.filter((route) => {
+        const key = `${String(route.preNode ?? "")}->${String(route.postNode ?? "")}#${JSON.stringify(route.routeCondition ?? null)}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    return { nodes: nodes.filter((node) => !systemTypes.has(String(node.nodeType ?? ""))), routes: nextRoutes, stripped };
+}
 /**
  * The single rule-graph normalization used by BOTH the write preflight and the
  * executor, so preview and execute validate the SAME prepared graph (CFG-02
@@ -632,10 +681,20 @@ export function graphGeometryNeedsLayout(nodesInput, routesInput) {
  * in `warnings` (never gating) so the caller can replace it with a domain name.
  */
 export function prepareRuleGraph(ruleCode, graph, customTrigger, schemaCode) {
-    const injected = injectDefaultSystemNode(ruleCode, graph.nodes ?? graph.node, graph.routes ?? graph.route);
+    const warnings = [];
+    // The caller never owns a persistence node (see stripCallerSystemNodes).
+    const stripped = stripCallerSystemNodes(graph.nodes ?? graph.node, graph.routes ?? graph.route);
+    for (const nodeCode of stripped.stripped)
+        warnings.push({
+            code: "rule-graph-system-node-tool-owned",
+            nodeCode,
+            key: "nodes",
+            severity: "warning",
+            message: `已忽略调用方传入的系统持久化节点 ${nodeCode}：SYSTEM_CREATE/SYSTEM_UPDATE/SYSTEM_DELETE 由工具按规则类型注入，手写只会错配类型或位置（预置规则错配 → submit 50000；自定义规则/流程事件 → Object is not serialized 且静默不生效）`,
+        });
+    const injected = injectDefaultSystemNode(ruleCode, stripped.nodes, stripped.routes);
     let finalNodes = injected.nodes;
     let finalRoutes = injected.routes;
-    const warnings = [];
     // SCHEDULER ⇒ TIMING_TASK: the platform dispatches a schedule ONLY when the
     // RULE ROW's bizRuleType = 2 (BizRuleScheduling.java:202-205; see
     // lanes/businessrule-contract.ts:42). A caller who authors a SCHEDULER node but

package/dist/lanes/workflow.js

@@ -913,7 +913,15 @@ function activityCodeOf(record) {
   * change still mints a collision-free fresh code. Returns the rewritten
   * activities plus the original→final code map for route remapping.
   */
-function reconcileCallerActivityCodes(callerActivities, draftActivities) {
+function reconcileCallerActivityCodes(callerActivities, draftActivities, options = {}) {
+    // 8.6 pins activityType on an existing code (live 2026-09-23), so a retype
+    // there needs a fresh code. AI-Platform 1.1.x does NOT pin it: a raw
+    // workflow/update that keeps the code and changes activityType returns
+    // errcode 0 and the draft reads back with the new type (live 2026-10-21,
+    // 1.1.25, END→PARTICIPANT in place). Minting `_2` there is OMC's own
+    // invention and churns every downstream reference (routes, buttons, logs),
+    // so only the pinned family mints.
+    const mintOnTypeChange = options.mintOnTypeChange !== false;
     const draftByCode = new Map(draftActivities.map((activity) => [String(activity.activityCode ?? ""), activity]));
     const used = new Set(draftActivities.map((activity) => String(activity.activityCode ?? "")));
     const codeMap = new Map();
@@ -941,7 +949,7 @@ function reconcileCallerActivityCodes(callerActivities, draftActivities) {
             // the designer's own rename posts exactly that and activityName stays
             // the first-created value). Only a TYPE change still needs a fresh code
             // (activityType is pinned for existing codes).
-            if (typeChanged) {
+            if (typeChanged && mintOnTypeChange) {
                 let suffix = 2;
                 while (used.has(`${original}_${suffix}`))
                     suffix += 1;
@@ -1229,7 +1237,7 @@ async function refuseRequiredOnChildTableFields(session, schemaCode, template, t
  * same edge). This is the "read back, then send the delta" path — without it a
  * subset silently REPLACED the whole activity list and dropped nodes.
  */
-function mergeCallerDelta(template, draft) {
+function mergeCallerDelta(template, draft, options = {}) {
     const { routes: routesRaw, activities: _raw, edges: edgesRaw, ...rest } = template;
     const routes = routesRaw ?? edgesRaw;
     const draftActivities = Array.isArray(draft.activities) ? draft.activities : [];
@@ -1258,7 +1266,7 @@ function mergeCallerDelta(template, draft) {
     // that under the same code). reconcileCallerActivityCodes keeps the code for
     // a name change and stamps name_i18n; only a type change still mints a fresh
     // code and DROPS the old node (a retype, not a rename).
-    const { activities: reconciledCaller, codeMap } = reconcileCallerActivityCodes(caller, draftActivities);
+    const { activities: reconciledCaller, codeMap } = reconcileCallerActivityCodes(caller, draftActivities, options);
     const draftByCode = new Map(draftActivities.map((activity) => [String(activity.activityCode ?? ""), activity]));
     const originalOf = new Map();
     for (const [original, final] of codeMap)
@@ -1342,7 +1350,7 @@ function mergeCallerDelta(template, draft) {
     });
     return { ...rest, activities: laidOut.activities, rules };
 }
-function normalizeWorkflowTemplate(template, draft) {
+function normalizeWorkflowTemplate(template, draft, options = {}) {
     if (template === undefined || template === null)
         return {};
     const { routes: routesRaw, activities: rawActivities, edges: edgesRaw, ...rest } = template;
@@ -1356,7 +1364,7 @@ function normalizeWorkflowTemplate(template, draft) {
     // The platform cannot rename an existing activityCode (see the reconcile
     // comment); give every changed/new node a fresh code, and remap caller routes
     // so they follow.
-    const reconciled = rawCaller ? reconcileCallerActivityCodes(rawCaller, draftActivities) : undefined;
+    const reconciled = rawCaller ? reconcileCallerActivityCodes(rawCaller, draftActivities, options) : undefined;
     const activities = reconciled?.activities;
     const codeMap = reconciled?.codeMap ?? new Map();
     const remapCode = (value) => codeMap.get(String(value ?? "")) ?? value;
@@ -1477,7 +1485,13 @@ async function mergedTemplateBody(session, schemaCode, code, template, merge = f
             workflowCode: code,
             message: `流程 ${code} 不存在（get_draft 401001 缺席）——先 workflow.create 再 update/publish`,
         });
-    const normalized = merge ? mergeCallerDelta(template, draft) : normalizeWorkflowTemplate(template, draft);
+    // Type changes are only pinned on the 8.x family (see reconcileCallerActivityCodes).
+    // Unknown versions keep the conservative 8.x behaviour (mint) — writes fail
+    // closed elsewhere, and a spurious `_2` is recoverable while a silent
+    // in-place retype on a pinned platform is not.
+    const version = session.detectedVersion();
+    const mintOnTypeChange = !(version !== undefined && version.startsWith("1."));
+    const normalized = merge ? mergeCallerDelta(template, draft, { mintOnTypeChange }) : normalizeWorkflowTemplate(template, draft, { mintOnTypeChange });
     // S29 contract: a PARTICIPANT activity requires sheetCode = the schema's
     // sheet, else validate/publish answers 401026 WORKFLOW_ACTIVITY_NO_SHEET. The
     // platform's own draft sets each participant's sheetCode to the model code;

package/dist/rule-support.js

@@ -4,7 +4,7 @@ import { ENDPOINTS } from "./endpoints.js";
 import { ToolRefusalError } from "./tool-types.js";
 import { decodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "./json-column.js";
 import { RULE_BIZ_RULE_TYPE_DESCRIPTION, RULE_CREATE_BODY, RULE_ROUTES_DESCRIPTION, ruleNodeGraphDescription, schedulerSettingDescription, } from "./lanes/businessrule-contract.js";
-import { validateRuleNodeGraph, prepareRuleGraph, PLATFORM_TRIGGER_RULE_CODES } from "./lanes/rule-graph.js";
+import { validateRuleNodeGraph, prepareRuleGraph, PLATFORM_TRIGGER_RULE_CODES, DEFAULT_SYSTEM_NODE_BY_RULE_CODE } from "./lanes/rule-graph.js";
 import { compileMethodConfigPlain } from "./bizservice-config.js";
 import { RESERVED_CODES } from "./code-rules.js";
 /** Business-rule node graph. Platform trigger rules are addressed by ruleCode: Create / Update / Delete / Available / Cancel / GetList / Load. */
@@ -624,10 +624,36 @@ export async function executeRuleSaveWrite(session, args) {
         : typeof schedulerInput === "string"
             ? schedulerInput
             : JSON.stringify(schedulerInput);
-    const nodeJson = typeof nodes === "string" ? nodes : JSON.stringify(nodes);
-    const routeJson = typeof routes === "string" ? routes : JSON.stringify(routes);
     const list = await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode: args.schemaCode } });
     const existing = wireRows(list.data).find((row) => row.code === args.ruleCode);
+    // Persistence nodes belong to the PLATFORM, not to us and not to the caller.
+    // The preset row already carries its own (Start → Create(SYSTEM_CREATE) →
+    // End). Copy that node verbatim instead of fabricating our own: nodeCode,
+    // nodeName, isSystemNode and geometry then always match what the designer
+    // itself writes. Only its SEAT (relative to the caller's action nodes) is
+    // ours, and the fingerprint of a hand-made replica drifting from the
+    // platform's is exactly what breaks publish later.
+    const systemSpec = DEFAULT_SYSTEM_NODE_BY_RULE_CODE[args.ruleCode];
+    if (existing?.id && systemSpec) {
+        try {
+            const baselineRow = (await wireCall(session, { path: ENDPOINTS.businessRuleGet, query: { id: String(existing.id) } })).data;
+            const baselineNodes = parseJsonColumn(baselineRow?.node);
+            const platformNode = Array.isArray(baselineNodes)
+                ? baselineNodes.find((node) => String(node.nodeType ?? "") === systemSpec.nodeType)
+                : undefined;
+            if (platformNode) {
+                const index = nodes.findIndex((node) => String(node.nodeType ?? "") === systemSpec.nodeType);
+                if (index >= 0)
+                    nodes[index] = { ...platformNode, isSystemNode: true };
+            }
+        }
+        catch {
+            // Best-effort: the documented default keeps the chain valid if the
+            // baseline cannot be read (the save itself will report the real error).
+        }
+    }
+    const nodeJson = typeof nodes === "string" ? nodes : JSON.stringify(nodes);
+    const routeJson = typeof routes === "string" ? routes : JSON.stringify(routes);
     const schedulerField = schedulerSetting === undefined ? {} : { schedulerSetting };
     // Preset trigger rules (Create/Update/Delete/Load/GetList/Available/Cancel
     // and 流程 code) are platform-managed: their `name` is a platform default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.71",
+  "version": "0.4.72",
   "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.71",
+    "@stalfh233/omc-fake-platform": "0.4.72",
     "commander": "14.0.3",
-    "omc-core": "0.4.71",
+    "omc-core": "0.4.72",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-business-configuration.md

@@ -151,7 +151,9 @@ rules:
 - **两条路**：模型+表单+流程一揽子交付走**意图**（`intent` 的 `workflow` 能力，声明式一次 apply）；只动流程或想逐步控制走**低层链** `workflow.create → workflow.update（权限/节点）→ workflow.publish`，标准链配方见 `omc describe workflow.update`（含多级审批/participant 三形态/自动回填说明）。流程权限细节见下节。
 - 一个模型只能有一个流程；已有流程的模型直接 `workflow.update`，不要另建。
 - **清理测试数据用批量删除**：`data.delete --args '{"schemaCode":"<code>","bizObjectIds":["id1","id2"]}'` 一次往返删多条（真机 r6：207 次逐条 `data.delete` 占 13.5% 调用）。
+- **系统持久化节点是平台自带的，不要手写**：预置 `Create/Update/Delete` 行本来就带 `SYSTEM_CREATE/SYSTEM_UPDATE/SYSTEM_DELETE`（实测基线 `Start → Create(SYSTEM_CREATE) → End`）。`rule.save` 会丢弃调用方传入的 `SYSTEM_*` 并**从平台基线原样携带**那一个节点（code/name/几何都不由我们猜）。手写的后果：预置规则里类型错配 → `data.submit` 50000；自定义规则/流程事件里带系统节点 → 结束事件无当前对象，`Object <id> is not serialized`，每步仍回 DELIVERED 但什么都没写。只写平台允许配置的业务节点（UPDATE/CREATE/DELETE/BRANCH/ASSIGN/MESSAGE/BIZ_ACTION…）。
 - **取 artifact 先投影**：`artifact get <id> --summary` 看形状 → `--jq '<path>'` 取那一段；只有确实要整份时才裸取（r6：47 次整包拉取 650KB，0 次用投影）。
+- **读回产物会自动清理，也可手动清**：每次大结果落一个 artifact（机器级目录，跨项目累积；实测一轮沙盒 504 个/3.4MB）。`createArtifact` 每 24h 顺手删 7 天未动的；要立刻回收用 `omc artifact prune --older-than 7d --max-bytes 268435456`（默认预算 256MB，超出按最旧优先删），`--json` 回 removed/freedBytes/kept。
 - **核验状态用投影，别重复整条读**：`data.load --args '{"schemaCode":..,"bizObjectId":..,"fields":["sequenceStatus","<业务状态字段>"]}'` 只回指定字段（缺失项在 `missingFields`）——r4 实测同一对象被整条读 74 次；大结果先 `artifact get <id> --summary` → `--keys/--jq`，别整包内联进推理。
 - **流程第一个节点必须是 `{Originator}` 填写节点**：平台 `WorkflowTemplateValidateUtility.validateStartActivity` 对「START 后直接接审批」报 401035「发起节点的参与者只能是{Originator}」，publish 回 errcode 0 但一个 ValidateMessage[] 就把模板挡在门外、不落库（真机 2026-10-21）。OMC 0.4.65 起在 `workflow.update`/`publish` 出门前拒绝（`workflow-first-activity-not-originator`）。
 - **跨模型回写的目标行必须已提交（COMPLETED）**：DRAFT 行不参与目标查询，运行 0 行命中且日志只有「查找范围不存在数据」。单跳关联字段可直接作 DYNAMIC 来源（引擎取关联对象 id）；点号路径按子表解析，`关联字段.id` / 两跳路径都不支持。