@stalfh233/omc-cli 0.6.18 → 0.6.19

package/dist/cli-stdout.js

@@ -34,6 +34,7 @@ export const CLI_STDOUT_OWNERS = {
     intent: "envelope",
     help: "envelope",
     graph: "envelope",
+    residue: "envelope",
     programming: "envelope",
     rollback: "envelope",
     setup: "envelope",

package/dist/cli.js

@@ -57,6 +57,7 @@ import { listSkills, readSkill, readSkillOutline, readSkillSection, searchSkills
 import { parseToolInput, ToolInputError } from "./tool-types.js";
 import { WireError, wireCall } from "./wire.js";
 import { DEFAULT_PULL_CONCURRENCY, GraphIndexAbsentError, GraphPullLockHeldError, MAX_PULL_CONCURRENCY, impactGraph, publishGraphPull, queryGraphReferences, readGraphStatus, searchGraphRules, } from "./graph.js";
+import { cmdResidue } from "./residue.js";
 import { ENDPOINTS } from "./endpoints.js";
 import { makeToolContext } from "./context.js";
 import { cmdRollbackList, cmdRollbackPlan, cmdRollbackApply } from "./rollback.js";
@@ -986,7 +987,6 @@ async function cmdArtifactGet(id, transport, options = {}) {
                         ...artifactProjectionMetadata(content),
                         keys,
                         path: options.jq,
-                        content: projected.content ?? null,
                         projections: [{ path: options.jq, content: projected.content ?? null, ...(projected.mapped !== undefined ? { mapped: projected.mapped } : {}), ...(projected.missedEntries !== undefined ? { missedEntries: projected.missedEntries } : {}), ...(projected.nullEntries !== undefined && projected.nullEntries > 0 ? { nullEntries: projected.nullEntries } : {}) }],
                         ...(projected.mapped !== undefined ? { mapped: projected.mapped } : {}),
                         ...(projected.nullEntries !== undefined && projected.nullEntries > 0 ? { nullEntries: projected.nullEntries } : {}),
@@ -1038,7 +1038,7 @@ async function cmdArtifactGet(id, transport, options = {}) {
             const projected = projectArtifactPath(artifactContent, options.jq);
             return emitTransportResult(projected.missed
                 ? { status: "ok", artifactId: id, sha256: artifact.sha256, ...artifactProjectionMetadata(content), path: options.jq, content: null, pathMiss: true, missedAt: projected.at, available: projected.available, unanswered: true, hint: artifactPathMissHint(projected.at) }
-                : { status: "ok", artifactId: id, sha256: artifact.sha256, ...artifactProjectionMetadata(content), path: options.jq, content: projected.content ?? null, projections: [{ path: options.jq, content: projected.content ?? null, ...(projected.mapped !== undefined ? { mapped: projected.mapped } : {}), ...(projected.missedEntries !== undefined ? { missedEntries: projected.missedEntries } : {}), ...(projected.nullEntries !== undefined && projected.nullEntries > 0 ? { nullEntries: projected.nullEntries } : {}) }], ...(projected.mapped !== undefined ? { mapped: projected.mapped } : {}), ...(projected.missedEntries !== undefined ? { missedEntries: projected.missedEntries } : {}), ...(projected.nullEntries !== undefined && projected.nullEntries > 0 ? { nullEntries: projected.nullEntries } : {}), ...(artifactNullHint(projected.content, projected.nullEntries) !== undefined ? { hint: artifactNullHint(projected.content, projected.nullEntries) } : {}) }, transport);
+                : { status: "ok", artifactId: id, sha256: artifact.sha256, ...artifactProjectionMetadata(content), path: options.jq, projections: [{ path: options.jq, content: projected.content ?? null, ...(projected.mapped !== undefined ? { mapped: projected.mapped } : {}), ...(projected.missedEntries !== undefined ? { missedEntries: projected.missedEntries } : {}), ...(projected.nullEntries !== undefined && projected.nullEntries > 0 ? { nullEntries: projected.nullEntries } : {}) }], ...(projected.mapped !== undefined ? { mapped: projected.mapped } : {}), ...(projected.missedEntries !== undefined ? { missedEntries: projected.missedEntries } : {}), ...(projected.nullEntries !== undefined && projected.nullEntries > 0 ? { nullEntries: projected.nullEntries } : {}), ...(artifactNullHint(projected.content, projected.nullEntries) !== undefined ? { hint: artifactNullHint(projected.content, projected.nullEntries) } : {}) }, transport);
         }
         // r6-onboarding 2026-10-21: 47 artifact fetches, 0 used a projection; the 10
         // large ones (up to 55 KB) pulled whole workflow templates just to read one
@@ -2470,6 +2470,7 @@ async function main() {
             pureKeys: (options.keys === true || bareJq) && options.summary !== true, ...(typeof options.keys === "string" ? { keys: options.keys } : {}), full: options.full === true }));
     });
     command.command("bench").option("--live-sample").option("--env <environment>").action(async (options) => { commandExitCode = await cmdBench([...(options.liveSample ? ["--live-sample"] : []), ...(options.env ? ["--env", options.env] : [])]); });
+    command.command("residue <prefix>").description("跨面前缀残留扫描（model 全租户/folder/custompage；默认 deep 再查命中模型的 rule/datarule/onlinejs）——收尾「删净」一次证明，clean:true 即零残留。只读零写入；report 面暂停维护未扫描").option("--env <environment>", "环境名（默认按 cwd 的 .omc-env 解析）").option("--apps <codes>", "all（默认，全租户）或逗号分隔应用码").option("--no-deep", "只扫 model/folder/custompage，不深查命中模型").option("--max-output-bytes <bytes>").action(async (prefix, options) => { commandExitCode = await withTransport(options, request, (transport) => cmdResidue(prefix, { env: options.env, apps: options.apps, ...(options.deep === false ? { noDeep: true } : {}) }, transport)); });
     const jqOption = () => new Option("--jq [path]", "路径投影（与 call --jq 同 DSL；可逗号多路径；裸 --jq 列顶层键）").argParser((value, previous = []) => [...previous, value]).default([]);
     command.command("commands").option("--json").option("--compact").option("--filter <keyword>").option("--lane <id>").option("--max-output-bytes <bytes>").addOption(jqOption()).action(async (options) => { commandExitCode = await withTransport(options, request, (transport) => cmdDiscovery("commands", transport, undefined, { json: options.json === true, compact: options.compact === true, ...(options.filter ? { filter: options.filter } : {}), ...(options.lane ? { lane: options.lane } : {}), ...(options.jq !== undefined ? { jq: options.jq } : {}) })); });
     command.command("describe <tool>").option("--full").option("--cache-ok", "允许 --full 在同会话重复读时短路为 artifact 指针（默认每次回全文）").option("--schema-only").option("--param <name>").option("--example [id]").option("--max-output-bytes <bytes>").addOption(jqOption()).action(async (tool, options) => {

package/dist/field-families.js

@@ -15,7 +15,7 @@ export const propertyTypeArg = z
 export const relativeCodeArg = z
     .string()
     .optional()
-    .describe("relation target model code；WORK_SHEET/MULT_WORK_SHEET 必填，且与 options.schemaCode 相同");
+    .describe("关联目标 code；租户唯一、按 code 全局解析，可跨应用");
 /**
  * Ticket 59 (P0): the wire `name_i18n` column must be a *parseable JSON object
  * string*, never a bare display string. The admin designer runs an unguarded
@@ -167,7 +167,7 @@ export const subFieldArg = z
  */
 export const fieldOptionsArg = z
     .object({
-    schemaCode: z.string().optional().describe("relation target model code（WORK_SHEET/MULT_WORK_SHEET；与 relativeCode 都填且必须相同）"),
+    schemaCode: z.string().optional().describe("关联目标 code；租户唯一、按 code 全局解析，可跨应用"),
     queryCode: z.string().optional().describe("relation query code (usually the target model code)"),
     displayField: z.string().optional().describe("relation display field (usually 'name')"),
     mappings: z
@@ -301,9 +301,9 @@ export function assertRelationTargetExists(args, candidates) {
         : typeof raw === "string" && raw in FIELD_PROPERTY_TYPES ? FIELD_PROPERTY_TYPES[raw] : undefined;
     if (type !== FIELD_PROPERTY_TYPES.WORK_SHEET && type !== FIELD_PROPERTY_TYPES.MULT_WORK_SHEET)
         return;
-    const optionsCode = typeof args.options?.schemaCode === "string" ? args.options.schemaCode.trim() : "";
     const relativeCode = typeof args.relativeCode === "string" ? args.relativeCode.trim() : "";
-    const target = optionsCode || relativeCode;
+    const optionsCode = typeof args.options?.schemaCode === "string" ? args.options.schemaCode.trim() : "";
+    const target = relativeCode || optionsCode;
     // Some offline/fake transports do not expose a model-list face.  An empty
     // candidate set is therefore "unknown", not proof of absence; live model
     // lists are non-empty and get the strict pre-write gate.
@@ -336,7 +336,8 @@ export function relationPublishFailureMessage(fields, candidates) {
         const type = typeof raw === "number" ? raw : typeof raw === "string" && raw in FIELD_PROPERTY_TYPES ? FIELD_PROPERTY_TYPES[raw] : undefined;
         if (type !== FIELD_PROPERTY_TYPES.WORK_SHEET && type !== FIELD_PROPERTY_TYPES.MULT_WORK_SHEET)
             continue;
-        const target = typeof options?.schemaCode === "string" ? options.schemaCode.trim() : typeof field.relativeCode === "string" ? field.relativeCode.trim() : "";
+        const relativeCode = typeof field.relativeCode === "string" ? field.relativeCode.trim() : "";
+        const target = relativeCode || (typeof options?.schemaCode === "string" ? options.schemaCode.trim() : "");
         if (typeof options?.schemaCode === "string" && options.schemaCode.trim() && (!field.relativeCode || String(field.relativeCode).trim() === "")) {
             return `字段 ${String(field.code ?? "(未知)")} 的关联目标 ${options.schemaCode} 仅写在 options.schemaCode；发布面不解析该位置（平台原始 errcode 300010「数据模型编码不能为空！」）。请重建/归一化为顶层 relativeCode=${options.schemaCode}`;
         }

package/dist/lanes/field.js

@@ -12,16 +12,21 @@ import { defineTool, ToolRefusalError } from "../tool-types.js";
 import { wireCall, wireRows, WireError } from "../wire.js";
 import { executeFormDraftWrite, executeFormPublishWrite, readFormOrNull } from "../form-support.js";
 import { FIELD_LANE_CONTRACT } from "./field-contract.js";
-import { flattenTreeRows, mapBounded, resolveApplicationScope } from "../support.js";
+import { flattenTreeRows, mapBounded } from "../support.js";
 import { extractBizObjectPage } from "./runtime-data.js";
 const FIELD_LANE = FIELD_LANE_CONTRACT.lane;
 const FIELD_TOOLS = FIELD_LANE_CONTRACT.tools;
 /** Read actual model schema codes; bare modelList may expose internal node ids. */
 export async function modelSchemaCodes(session) {
     try {
-        const scope = await resolveApplicationScope(session);
-        const tree = flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode: scope.code } })).data));
-        const codes = tree
+        // Relation codes are tenant-global on the platform, not application-scoped.
+        // Enumerate every application for this call only; deliberately do not cache
+        // this merged candidate set across calls because model writes can change it.
+        const apps = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data)
+            .map((row) => row.appCode ?? row.code)
+            .filter((code) => typeof code === "string" && code.length > 0);
+        const trees = await mapBounded(apps, 4, async (appCode) => flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode } })).data)));
+        const codes = trees.flat()
             .filter((row) => row.type === "BizModel")
             .map((row) => String(row.code ?? row.schemaCode ?? row.bizSchemaCode ?? ""))
             .filter((code) => code.length > 0);
@@ -29,7 +34,8 @@ export async function modelSchemaCodes(session) {
             return codes;
     }
     catch {
-        // Fall through to the compatibility endpoint below.
+        // Fall through to the compatibility endpoint below when the tenant-wide
+        // discovery face is unavailable (older/fake transports).
     }
     return wireRows((await wireCall(session, { path: ENDPOINTS.modelList, query: {} })).data)
         .map((row) => String(row.schemaCode ?? row.bizSchemaCode ?? row.code ?? ""))

package/dist/lanes/folder.js

@@ -5,7 +5,7 @@ import { writeTool } from "../write.js";
 import { wireCall, wireRows } from "../wire.js";
 import { ENDPOINTS } from "../endpoints.js";
 import { capabilityArg, environmentArg } from "../args.js";
-import { resolveApplicationCode } from "../support.js";
+import { jsonBytes, resolveApplicationCode } from "../support.js";
 import { LANES } from "./lane-ids.js";
 import { FOLDER_LANE_CONTRACT } from "./folder-contract.js";
 /**
@@ -38,6 +38,33 @@ import { FOLDER_LANE_CONTRACT } from "./folder-contract.js";
  */
 const LANE = LANES.folder;
 const T = FOLDER_LANE_CONTRACT.tools;
+/**
+ * folder.tree is a node inventory, so its useful inline budget is node-count
+ * first rather than the generic read compact threshold.  Keep the existing
+ * byte guard as a second gate: a pathological 50-node tree still belongs in
+ * the artifact when the node payload itself is too large.
+ */
+export const FOLDER_TREE_INLINE_NODE_LIMIT = 50;
+export const FOLDER_TREE_NODE_INLINE_CEILING_BYTES = 8192;
+export function compactFolderTree(result) {
+    const nodes = Array.isArray(result.nodes) ? result.nodes : undefined;
+    if (nodes === undefined)
+        return { ...result };
+    if (nodes.length <= FOLDER_TREE_INLINE_NODE_LIMIT && jsonBytes(nodes) <= FOLDER_TREE_NODE_INLINE_CEILING_BYTES) {
+        return { ...result, nodes };
+    }
+    const countGate = nodes.length > FOLDER_TREE_INLINE_NODE_LIMIT;
+    const { nodes: _nodes, ...withoutNodes } = result;
+    return {
+        ...withoutNodes,
+        nodesPreview: nodes.slice(0, 5),
+        note: `${String(result.note ?? "")} ${countGate
+            ? `nodes 超过 ${FOLDER_TREE_INLINE_NODE_LIMIT} 条，完整节点已外置到 detailArtifactId；nodesPreview 仅展示前 5 条。`
+            : `nodes 正文超过 ${FOLDER_TREE_NODE_INLINE_CEILING_BYTES}B 字节闸，完整节点已外置到 detailArtifactId；这是字节闸，不是节点数限制。`}`.trim(),
+        // Deliberately omit nodes so governedRead adds the standard empty
+        // placeholder/truncatedKeys while the preview remains available.
+    };
+}
 /**
  * Live 1.1.25 (r28d F2): platform `apppackage/create` seeds one top-level Folder
  * whose `name_i18n.en` is the stable token `defaultGroup` (zh display is「默认分组」).
@@ -202,7 +229,7 @@ function folderTools(tools) {
                         : " applicationExists:false——应用不在 apppackage/list；空树不等于「空应用」。") +
                     " nodeCount/folderCount/modelCount 是全应用聚合，共享环境含其它会话资源；核对自己的资源请按 code 前缀过滤 nodes[]，不要只比计数。",
             };
-        }),
+        }, { compact: compactFolderTree }),
     }));
     writeTool({
         tools,

package/dist/residue.js

@@ -0,0 +1,116 @@
+import { createHash } from "node:crypto";
+import { ENDPOINTS } from "./endpoints.js";
+import { wireCall, wireRows } from "./wire.js";
+import { flattenTreeRows } from "./support.js";
+import { ConfigStore, defaultPaths } from "./config-store.js";
+import { SessionManager } from "./session-manager.js";
+import { makeToolContext } from "./context.js";
+import { emitInvalid, emitResult } from "./command-transport.js";
+const MAX_ITEMS = 20;
+function face(faceName, rows, extra = {}) {
+    return { face: faceName, ...extra, count: rows.length, items: rows.slice(0, MAX_ITEMS) };
+}
+function codeOf(row) {
+    return String(row.code ?? row.schemaCode ?? row.bizSchemaCode ?? "");
+}
+function nameOf(row, code) {
+    return String(row.name ?? row.displayName ?? row.title ?? code);
+}
+function codeStarts(row, prefix) {
+    return codeOf(row).startsWith(prefix);
+}
+function folderStarts(row, prefix) {
+    return codeStarts(row, prefix) || String(row.name ?? "").startsWith(prefix);
+}
+function scriptPresent(raw) {
+    if (typeof raw !== "string")
+        return false;
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return false;
+        return parsed.some((element) => {
+            const row = element;
+            return row.id === "customScript" && typeof row.innerHTML === "string" && row.innerHTML.trim() !== "";
+        });
+    }
+    catch {
+        return false;
+    }
+}
+async function tree(session, app) {
+    return flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode: app } })).data));
+}
+async function modelRows(session, app) {
+    return (await tree(session, app)).filter((row) => row.type === "BizModel");
+}
+async function customPages(session, appSet) {
+    const rows = wireRows((await wireCall(session, { path: ENDPOINTS.customPageList, query: { modeType: "VUE_MODE" } })).data);
+    return rows.filter((row) => appSet.has(String(row.appCode ?? "")));
+}
+async function deepFaces(session, model) {
+    const schemaCode = codeOf(model);
+    const rules = wireRows((await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode } })).data);
+    const datarules = wireRows((await wireCall(session, { path: ENDPOINTS.dataRuleList, query: { schemaCode } })).data);
+    let online = [];
+    try {
+        const sheet = (await wireCall(session, { path: ENDPOINTS.sheetGet, query: { schemaCode, sheetCode: schemaCode } })).data;
+        if (sheet && (scriptPresent(sheet.draftHtmlJson) || scriptPresent(sheet.publishedHtmlJson))) {
+            const raw = typeof sheet.publishedHtmlJson === "string" && scriptPresent(sheet.publishedHtmlJson) ? sheet.publishedHtmlJson : sheet.draftHtmlJson;
+            online = [{ present: true, ...(typeof raw === "string" ? { sha256: createHash("sha256").update(raw).digest("hex") } : {}) }];
+        }
+    }
+    catch {
+        // A missing form is an absent online-js face, not a scan failure.
+    }
+    return [
+        face("rule", rules.map((row) => ({ code: codeOf(row), name: nameOf(row, codeOf(row)) })), { model: schemaCode }),
+        face("datarule", datarules.map((row) => ({ code: codeOf(row), name: nameOf(row, codeOf(row)) })), { model: schemaCode }),
+        face("onlinejs", online, { model: schemaCode }),
+    ];
+}
+export async function scanResidues(session, prefix, options = {}) {
+    const apps = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data)
+        .map((row) => String(row.appCode ?? row.code ?? ""))
+        .filter(Boolean);
+    const selected = options.apps && options.apps !== "all" ? options.apps.split(",").map((app) => app.trim()).filter(Boolean) : apps;
+    const appSet = new Set(selected);
+    const faces = [];
+    const models = [];
+    for (const app of selected) {
+        const rows = await tree(session, app);
+        const matchingModels = rows.filter((row) => row.type === "BizModel" && codeStarts(row, prefix));
+        models.push(...matchingModels.map((row) => ({ ...row, appCode: app })));
+        faces.push(face("model", matchingModels.map((row) => ({ code: codeOf(row), name: nameOf(row, codeOf(row)) })), { app }));
+        faces.push(face("folder", rows.filter((row) => row.type === "Folder" && folderStarts(row, prefix)).map((row) => ({ code: codeOf(row), name: nameOf(row, codeOf(row)) })), { app }));
+    }
+    const pages = (await customPages(session, appSet)).filter((row) => codeStarts(row, prefix));
+    for (const app of selected) {
+        faces.push(face("custompage", pages.filter((row) => String(row.appCode ?? "") === app).map((row) => ({ code: codeOf(row), name: nameOf(row, codeOf(row)) })), { app }));
+    }
+    if (options.deep !== false) {
+        for (const model of models)
+            faces.push(...await deepFaces(session, model));
+    }
+    const totalResidues = faces.reduce((sum, item) => sum + item.count, 0);
+    return {
+        prefix,
+        faces,
+        totalResidues,
+        clean: totalResidues === 0,
+        note: "report 面暂停维护未扫描；workflow 模板跟模型走（模型删即删）",
+    };
+}
+export async function cmdResidue(prefix, options, transport) {
+    if (!prefix || prefix.trim() === "")
+        return emitInvalid(transport, { message: "residue 的 prefix 必填" });
+    try {
+        const context = makeToolContext({ sessions: new SessionManager(new ConfigStore(defaultPaths())) });
+        const session = await context.sessions.session(options.env);
+        return emitResult(await scanResidues(session, prefix, { apps: options.apps, deep: options.noDeep !== true }), transport);
+    }
+    catch (error) {
+        return emitResult({ status: "error", blocker: "residue-scan-failed", message: error instanceof Error ? error.message : String(error) }, transport);
+    }
+}
+//# sourceMappingURL=residue.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -55,7 +55,7 @@
   },
   "dependencies": {
     "commander": "14.0.3",
-    "omc-core": "0.6.18",
+    "omc-core": "0.6.19",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",
@@ -73,6 +73,6 @@
     "directory": "packages/omc-cli"
   },
   "optionalDependencies": {
-    "@stalfh233/omc-fake-platform": "0.6.18"
+    "@stalfh233/omc-fake-platform": "0.6.19"
   }
 }