@stalfh233/omc-cli 0.4.38 → 0.4.39

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 // T04：SQLite 警告过滤器必须保持第一个 import（先于任何拉起 omc-core/node:sqlite 的模块）。
 import "./sqlite-warning-filter.js";
+import { spawnSync } from "node:child_process";
 import { createInterface } from "node:readline/promises";
 import { stdin, argv } from "node:process";
 import { createRequire } from "node:module";
@@ -113,6 +114,23 @@ async function cmdDoctor(store, environment, serviceCode) {
     const manifest = loadCoverageManifest();
     const steps = [];
     let ok = true;
+    // r45 Windows 实测：PowerShell 管道按 GBK(936) 解码 CLI 的 UTF-8 输出 → 全屏乱码，
+    // 且用户常误判为「OMC 输出坏了」。doctor 是入口体检，顺手检测活动代码页。
+    if (process.platform === "win32") {
+        try {
+            const chcp = spawnSync("chcp.com", [], { encoding: "utf8" });
+            const active = /([0-9]{3,5})\s*$/.exec((chcp.stdout || "").trim().split("\n").pop() ?? "")?.[1];
+            if (active && active !== "65001") {
+                steps.push(`编码      ⚠  活动代码页 ${active}（非 65001）——PowerShell 管道会把 CLI 的 UTF-8 中文输出解成乱码；这是终端解码问题不是 OMC 故障。先 \`chcp 65001\` + \`[Console]::OutputEncoding=[Text.Encoding]::UTF8\` 再读 CLI 输出`);
+            }
+            else if (active === "65001") {
+                steps.push("编码      ok  活动代码页 65001（UTF-8，中文输出无乱码风险）");
+            }
+        }
+        catch {
+            // chcp 不可用（非传统控制台等）——跳过，不阻塞体检
+        }
+    }
     try {
         const resolved = store.resolveEnvironment(environment);
         steps.push(`配置      ok  环境=${resolved.name}（来源 ${resolved.source}）`);
@@ -367,32 +385,35 @@ function resolvedDefaultEnvironment(store) {
         return "default";
     }
 }
-/**
- * Bounded JSON-path projection for `artifact get --jq`. Supports dotted
- * (`content.activities.0.name`) and slashed (`content/activities/0/name`)
- * segments. Not a general jq: a path walk only, so it can never evaluate code.
- */
 function projectJsonPath(value, path) {
-    const segments = path.replace(/^\//, "").split(/[./]/).filter((segment) => segment.length > 0);
+    const normalized = path
+        .trim()
+        .replace(/^[.\/]+/, "")
+        .replace(/\[(\d+)\]/g, ".$1")
+        .replace(/\[(?:"([^"]+)"|'([^']+)')\]/g, (_all, dq, sq) => `.${dq || sq}`)
+        .replace(/\.{2,}/g, ".");
+    const segments = normalized.split(/[./]/).filter((segment) => segment.length > 0);
     let current = value;
     for (const segment of segments) {
         if (Array.isArray(current)) {
             const index = Number(segment);
             if (!Number.isInteger(index) || index < 0 || index >= current.length)
-                return undefined;
+                return { missed: true, at: segment, available: `数组长度 ${current.length}（下标 0-${Math.max(current.length - 1, 0)}）` };
             current = current[index];
         }
         else if (current && typeof current === "object") {
             const record = current;
-            if (!Object.prototype.hasOwnProperty.call(record, segment))
-                return undefined;
+            if (!Object.prototype.hasOwnProperty.call(record, segment)) {
+                const keys = Object.keys(record);
+                return { missed: true, at: segment, available: keys.length > 0 ? keys.slice(0, 12) : "（该层是空对象）" };
+            }
             current = record[segment];
         }
         else {
-            return undefined;
+            return { missed: true, at: segment, available: `路径在第 ${segments.indexOf(segment) + 1} 段之前已到标量/undefined（前段类型 ${current === null ? "null" : typeof current}）` };
         }
     }
-    return current;
+    return { missed: false, value: current };
 }
 async function cmdArtifactGet(id, transport, options = {}) {
     try {
@@ -443,7 +464,9 @@ async function cmdArtifactGet(id, transport, options = {}) {
         }
         if (options.jq !== undefined) {
             const projected = projectJsonPath(artifact.content.toString("utf8") === "" ? undefined : content, options.jq);
-            return emitTransportResult({ status: "ok", artifactId: id, sha256: artifact.sha256, path: options.jq, content: projected === undefined ? null : projected }, transport);
+            return emitTransportResult(projected.missed
+                ? { status: "ok", artifactId: id, sha256: artifact.sha256, path: options.jq, content: null, pathMiss: true, missedAt: projected.at, available: projected.available, hint: `路径未命中段 "${projected.at}"——available 是该层可用的键/范围；方括号下标（a[0]）与点式（a.0）等价` }
+                : { status: "ok", artifactId: id, sha256: artifact.sha256, path: options.jq, content: projected.value ?? null }, transport);
         }
         const result = { status: "ok", artifactId: id, sha256: artifact.sha256, content };
         if (Buffer.byteLength(JSON.stringify(result), "utf8") > transport.maxOutputBytes)

package/dist/execution-metadata.js

@@ -1,6 +1,7 @@
-// 配方按 lane 分居维护（src/recipes/<lane>.ts）；本文件是聚合接缝：保持原中央表的
-// 工具键序（消费方按工具名查找；顺序保留供可读性与 ticket-02 快照一致性），并在
-// 模块加载时对重复工具键 fail-fast（lane 各自注册后静默覆盖是拆分最大风险）。
+// 配方按 lane 分居维护（src/recipes/<lane>.ts）；本文件是聚合接缝：按 lane 分组顺序
+// 合并（非原中央表字面量序——已核实全仓零 Object.keys/entries 枚举消费者，消费方一律
+// 按工具名查找，键序无行为影响），并在模块加载时对重复工具键 fail-fast
+// （lane 各自注册后静默覆盖是拆分最大风险）。
 import { MODEL_METADATA } from "./recipes/model.js";
 import { FORM_METADATA } from "./recipes/form.js";
 import { FIELD_METADATA } from "./recipes/field.js";

package/dist/lanes/field.js

@@ -135,7 +135,9 @@ export function registerFieldLane(tools) {
                 });
             return {
                 schemaCode: args.schemaCode,
-                published: args.published === true,
+                // r45: 这是"本次查询的面选择器"回显（draft/published），不是字段发布状态——
+                // 曾被误读为"字段未发布"。改名 face 消歧义；要查发布态用 field.publish 回读或详情面。
+                face: args.published === true ? "published" : "draft",
                 ...(selector.length > 0 ? { selected: selector } : {}),
                 ...(args.all !== true ? { businessOnly: true } : {}),
                 fields: projected,

package/dist/lanes/runtime-data.js

@@ -524,7 +524,7 @@ export function registerRuntimeDataLane(tools) {
         inputSchema: {
             environment: environmentArg,
             schemaCode: z.string(),
-            bizObjectId: z.string({ required_error: "bizObjectId 必填（业务对象 id；参数名是 bizObjectId，不是 id。从 data.submit 读回的 objectId/sequenceNo 或 data.list 的 row.bizObjectId 取）" }),
+            bizObjectId: z.string({ required_error: "bizObjectId 必填（参数名就是 bizObjectId——不是 id 也不是 objectId，r44 两个 agent 都猜了 objectId；取值来自 data.submit 读回的 objectId/sequenceNo 或 data.list 的 row.bizObjectId）" }),
             full: z.boolean().optional().describe("返回未裁剪的完整业务对象（含 owner/creater 等系统字段；默认返回业务字段+身份的精简记录）"),
             capability: capabilityArg,
         },

package/dist/recipes/runtime-data.js

@@ -38,7 +38,7 @@ const plainSubmit = Object.freeze({
         { code: "submit-biz-object-absent", action: "bizObjectId 在平台无行（304001）——回 data.save 重建草稿后再直提" },
         { code: "invalid-input", action: "带了 workItemId/workflowInstanceId 时必须同时带 bizObjectId（fail-closed）" },
     ],
-    notes: "r23 复盘修正：本配方曾教先 save 再 submit 两步——正确路径是无 id 一调（业务约定：正式数据一律 data.submit）。Create/Update 规则只在 COMPLETED 分发（DomainServiceImpl.java:240-248）；规则效果以提交读回/data.load 为准。data.save 定位=草稿/暂存",
+    notes: "r23 复盘修正：本配方曾教先 save 再 submit 两步——正确路径是无 id 一调（业务约定：正式数据一律 data.submit）。Create/Update 规则只在 COMPLETED 分发（DomainServiceImpl.java:240-248）；规则效果以提交读回/data.load 为准（data.load 参数名=bizObjectId，直接用提交读回的 objectId）。data.save 定位=草稿/暂存",
     requiresEnvironmentDerivedIds: true,
 });
 const workflowSubmit = Object.freeze({

package/package.json

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