@stalfh233/omc-cli 0.0.0-stage → 0.4.10

package/dist/lanes/online-js-contract.js

@@ -0,0 +1,99 @@
+import { assertDescriptionCarries, assertLaneContract, behaviorBinding, CONTRACT_FAMILY, CONTRACT_REFERENCE_VERSION, emitterBinding } from "./contract-support.js";
+import { assertPlatformOnlineJsComposition, PLATFORM_DEFAULT_LIFECYCLE_SCRIPT, PLATFORM_LIFECYCLE_WRAPPER_MARKER } from "../online-js-source.js";
+import { assertPlatformOnlineJsLayout } from "../online-js-layout.js";
+import { LANES } from "./lane-ids.js";
+/**
+ * online-js wire facts (live-proven). The customScript element composition,
+ * the complete-array preservation, and the verbatim readback are the single
+ * source for the handler descriptions and the coverage declarations.
+ */
+export const ONLINE_JS_WIRE = Object.freeze({
+    composeElement: `canonical customScript element {tagName:'script', id:'customScript', innerHTML:<platform lifecycle wrapper containing source>, attrs:[]} (must contain ${PLATFORM_LIFECYCLE_WRAPPER_MARKER}; designer chunk 54286 calls e.attrs.some(...): attrs MUST be an array)`,
+    composePreserve: `reads the existing draftHtmlJson, JSON-parses the COMPLETE element array, preserves the platform template including the ${PLATFORM_LIFECYCLE_WRAPPER_MARKER} lifecycle body — the style, toolbar, template, beforeCustomScript, and afterCustomScript elements verbatim (attrs included), plus every other layout/control element — fills in missing skeleton elements with platform defaults, replaces ONLY the customScript element, then stringifies the COMPLETE array`,
+    composePublish: "bizsheet/update then bizsheet/publish (force:true) promoting the full layout; publishedHtmlJson is read back verbatim and SHA-256-fingerprinted for byte-equality verification",
+    regression: "issue 11: never overwrite the layout with a standalone script object or a partial [customScript]-only array",
+    programmingRemoved: "the former onlinejs.draft/publish tools wrapped the design-time 在线开发 face (POST /api/api/programming/get_source|saveSourceCode|publish; base is the DOUBLED /api/api/programming under the /api context-path, live 2026-09-21; the earlier single-/api guess 404s). That face authors backend JAVA (business-rule/SPI/service-component source), which is written through 二开扩展包, NOT form Online JS — so the CLI exposes no tool for it and the two misleadingly-named tools were removed. onlinejs.compose is the only Online JS tool",
+});
+const ONLINE_JS_SCOPE = "draft promotion publish verbatim readback";
+export const ONLINE_JS_LANE_CONTRACT = Object.freeze({
+    lane: LANES.onlineJs,
+    family: CONTRACT_FAMILY,
+    referenceVersion: CONTRACT_REFERENCE_VERSION,
+    endpoints: Object.freeze({
+        sheetGet: "sheetGet",
+        sheetUpdate: "sheetUpdate",
+        sheetPublish: "sheetPublish",
+    }),
+    wire: Object.freeze({
+        composeElement: ONLINE_JS_WIRE.composeElement,
+        composePreserve: ONLINE_JS_WIRE.composePreserve,
+        composePublish: ONLINE_JS_WIRE.composePublish,
+        regression: ONLINE_JS_WIRE.regression,
+        programmingRemoved: ONLINE_JS_WIRE.programmingRemoved,
+    }),
+    wireBindings: Object.freeze({
+        composeElement: Object.freeze([
+            Object.freeze({
+                kind: "emitter-constant",
+                ref: "online-js-source.PLATFORM_DEFAULT_LIFECYCLE_SCRIPT",
+                verify: () => {
+                    if (!PLATFORM_DEFAULT_LIFECYCLE_SCRIPT.includes(PLATFORM_LIFECYCLE_WRAPPER_MARKER))
+                        throw new Error("platform lifecycle wrapper is missing");
+                },
+            }),
+            Object.freeze({
+                kind: "behavior-test",
+                ref: "online-js-source.assertPlatformOnlineJsComposition",
+                verify: assertPlatformOnlineJsComposition,
+            }),
+            Object.freeze({
+                kind: "behavior-test",
+                ref: "online-js-layout.assertPlatformOnlineJsLayout",
+                verify: assertPlatformOnlineJsLayout,
+            }),
+        ]),
+        composePreserve: Object.freeze([
+            emitterBinding("online-js-layout.composeLayoutElements", assertOnlineJsContract),
+            behaviorBinding("test/issue-11-online-js.test.ts#onlinejs.compose merges customScript into the existing draftHtmlJson layout", assertOnlineJsContract),
+        ]),
+        composePublish: Object.freeze([
+            behaviorBinding("test/issue-11-online-js.test.ts#onlinejs.compose merges customScript into the existing draftHtmlJson layout", assertOnlineJsContract),
+        ]),
+        regression: Object.freeze([
+            behaviorBinding("test/issue-11-online-js.test.ts#onlinejs.compose refuses to overwrite the layout with a standalone script object", assertOnlineJsContract),
+        ]),
+        programmingRemoved: Object.freeze([
+            behaviorBinding("test/onlinejs-no-programming-tool.test.ts#the removed online-development tools are absent from the registry", assertOnlineJsContract),
+        ]),
+    }),
+    evidence: Object.freeze([
+        "packages/omc-cli/src/lanes/online-js.ts",
+        ".scratch/omc-route-wayfinder/leg4-closeout.md",
+        "packages/omc-cli/test/issue-11-online-js.test.ts",
+    ]),
+    tools: Object.freeze({
+        "onlinejs.compose": Object.freeze({
+            scope: ONLINE_JS_SCOPE,
+            description: `Compose the Online JS source as the customScript element into the form's draftHtmlJson layout array (then publish, promoting it verbatim to publishedHtmlJson). Core contract: preserve the platform template and only extend customScript.innerHTML — the six-element skeleton includes the ${PLATFORM_LIFECYCLE_WRAPPER_MARKER} lifecycle wrapper; the style, toolbar, template, beforeCustomScript, customScript, and afterCustomScript elements are kept or synthesized with platform defaults, while every layout/control element is preserved. customScript is rebuilt canonically as {tagName:'script', id:'customScript', innerHTML:<platform lifecycle wrapper containing source>, attrs:[]} because the designer requires an ARRAY attrs (e.attrs.some) and tagName, else the Online JS editor fails with t.some is not a function. Drives bizsheet/update + bizsheet/publish; publishedHtmlJson is read back verbatim and SHA-256-fingerprinted so the caller can verify byte equality. Never overwrites the layout with a standalone script object or a partial [customScript]-only array (regression for issue 11's root cause).`,
+        }),
+    }),
+});
+export function assertOnlineJsContract() {
+    assertLaneContract(ONLINE_JS_LANE_CONTRACT);
+    if (!ONLINE_JS_WIRE.composePreserve.includes("COMPLETE"))
+        throw new Error("online-js contract pins the complete-array preservation");
+    if (!ONLINE_JS_WIRE.composePublish.includes("bizsheet/publish"))
+        throw new Error("online-js contract must pin the publish chain");
+    if (!ONLINE_JS_WIRE.regression.includes("partial [customScript]-only"))
+        throw new Error("online-js contract must pin the issue-11 regression shape");
+    if (!ONLINE_JS_WIRE.programmingRemoved.includes("二开扩展包"))
+        throw new Error("online-js contract must record why the programming tools are absent");
+    if (!PLATFORM_DEFAULT_LIFECYCLE_SCRIPT.includes(PLATFORM_LIFECYCLE_WRAPPER_MARKER))
+        throw new Error("online-js emitter must contain the platform lifecycle wrapper");
+    if (!ONLINE_JS_WIRE.composeElement.includes(PLATFORM_LIFECYCLE_WRAPPER_MARKER))
+        throw new Error("online-js contract must pin the platform lifecycle wrapper");
+    assertDescriptionCarries(ONLINE_JS_LANE_CONTRACT, "onlinejs.compose", ["customScript", "draftHtmlJson", "publishedHtmlJson", "SHA-256", "issue 11", PLATFORM_LIFECYCLE_WRAPPER_MARKER]);
+    if ("onlinejs.draft" in ONLINE_JS_LANE_CONTRACT.tools || "onlinejs.publish" in ONLINE_JS_LANE_CONTRACT.tools)
+        throw new Error("online-js contract must not carry the removed programming tools");
+}
+//# sourceMappingURL=online-js-contract.js.map

package/dist/lanes/online-js-coverage.js

@@ -0,0 +1,28 @@
+import { claim, declareLaneCoverage } from "./coverage-declaration.js";
+import { ONLINE_JS_LANE_CONTRACT } from "./online-js-contract.js";
+const T = ONLINE_JS_LANE_CONTRACT.tools;
+/**
+ * The lane is a single EXECUTABLE composer: onlinejs.compose drives the
+ * live-verified bizsheet html chain (draft carrying the layout skeleton →
+ * publish → verbatim publishedHtmlJson; ticket 73 pinned skeleton fidelity and
+ * ticket 110 upgraded it to the SIX-element platform skeleton: style +
+ * section#toolbar + section#template + before/custom/afterCustomScript, live row
+ * dev_repair_order).
+ *
+ * The former onlinejs.draft/publish tools wrapped the design-time 在线开发 face
+ * (/api/api/programming/*, backend JAVA source) and were removed: that face is
+ * authored through 二开扩展包, not form Online JS, so it is out of this CLI's
+ * scope rather than a blocked capability.
+ */
+export const ONLINE_JS_COVERAGE = declareLaneCoverage(ONLINE_JS_LANE_CONTRACT.lane, [
+    {
+        capability: "Online JS composer (onlinejs.compose, draftHtmlJson customScript element)",
+        evidence: [
+            "packages/omc-cli/src/lanes/online-js.ts",
+            ".scratch/omc-route-wayfinder/leg4-closeout.md",
+            "packages/omc-cli/test/ticket-73-onlinejs-template-fidelity.test.ts",
+        ],
+        tools: [claim("onlinejs.compose", T["onlinejs.compose"].scope)],
+    },
+]);
+//# sourceMappingURL=online-js-coverage.js.map

package/dist/lanes/online-js.js

@@ -0,0 +1,127 @@
+import { z } from "zod";
+import { createHash } from "node:crypto";
+import { ENDPOINTS } from "../endpoints.js";
+import { assertHtmlRender, executeFormDraftWrite, executeFormPublishWrite, validateHtmlRender } from "../form-support.js";
+import { writeTool } from "../write.js";
+import { wireCall } from "../wire.js";
+import { composeCustomScript, lintOnlineJsSource } from "../online-js-source.js";
+import { composeLayoutElements } from "../online-js-layout.js";
+import { ONLINE_JS_LANE_CONTRACT } from "./online-js-contract.js";
+const ONLINE_JS_LANE = ONLINE_JS_LANE_CONTRACT.lane;
+const ONLINE_JS_TOOLS = ONLINE_JS_LANE_CONTRACT.tools;
+/**
+ * Parse a draftHtmlJson / publishedHtmlJson string into a well-formed
+ * element array. Handles the legacy "{}" case (empty object → empty array)
+ * and filters out non-object entries so compose/verify can rely on the
+ * array shape without per-call defensive parsing.
+ */
+function parseLayoutElements(rawHtml) {
+    if (rawHtml === undefined || rawHtml === null || rawHtml.trim() === "")
+        return [];
+    try {
+        const parsed = JSON.parse(rawHtml);
+        if (Array.isArray(parsed))
+            return parsed;
+    }
+    catch {
+        // The caller reports malformed persisted HTML before composition.
+    }
+    return [];
+}
+/**
+ * Platform layout skeleton (live capture of the designer's own save,
+ * POST /api/api/app/bizsheet/update; designer chunk 54286 + ticket 110 live
+ * row dev_repair_order, h_biz_sheet):
+ * [style, section#toolbar, section#template, beforeCustomScript,
+ *  customScript, afterCustomScript] — every element carries tagName and an
+ * ARRAY attrs. The designer's isLinkScript/findElementsByClass call
+ * e.attrs.some(...), so a missing tagName or a non-array attrs breaks the
+ * Online JS editor with `TypeError: t.some is not a function`; the template
+ * section is what convertElement keys on (id === "template") to render the
+ * template area — omitting toolbar/template leaves the panel regions empty.
+ */
+export function registerOnlineJsLane(tools) {
+    writeTool(tools, "onlinejs.compose", ONLINE_JS_LANE, ONLINE_JS_TOOLS["onlinejs.compose"].scope, ONLINE_JS_TOOLS["onlinejs.compose"].description, {
+        schemaCode: z.string().min(1),
+        sheetCode: z.string().min(1),
+        source: z.string().min(1).describe("在线 JS 代码。默认 INCREMENTAL：并入平台 (function(form){…}) 模板的既有脚本，模板与既有注册全部保留；配 replace:true 才是整段替换。脚本不得使用 export/import；事件名必须是平台事件（onLoad/onRendered/onValidate/onPreAction/onCustomAction/onActionDone/onPrintFormDataHandle/onPrintWorkflowLogDataHandle）"),
+        replace: z.boolean().optional().describe("true = 以 source 整体替换 customScript（含完整 (function(form){…}) 脚本）。默认 false = 增量并入既有脚本，保留平台模板与既有逻辑"),
+        publish: z.boolean().optional(),
+    }, async (session, args) => {
+        const shouldPublish = args.publish !== false;
+        // 1. Read the existing draftHtmlJson.
+        const current = await wireCall(session, { path: ENDPOINTS.sheetGet, query: { schemaCode: args.schemaCode, sheetCode: args.sheetCode } });
+        const existingSheet = (current.data ?? null);
+        const existingRaw = typeof existingSheet?.draftHtmlJson === "string" ? existingSheet.draftHtmlJson : undefined;
+        const existingCompat = validateHtmlRender(existingRaw);
+        // A persisted legacy face may contain an object or malformed elements.
+        // Do not pass any of it through: discard the unproven face and rebuild
+        // only the canonical platform skeleton below.
+        const existingElements = existingCompat.ok ? parseLayoutElements(existingRaw) : [];
+        // 2. Script-level INCREMENTAL merge. The layout read-modify-write above
+        //    preserved the element skeleton, but the customScript innerHTML was
+        //    being replaced wholesale — that is how a bare `form.on(...)` (or an
+        //    `export function`) landed as the ENTIRE script, leaving `form`
+        //    undefined / a SyntaxError and rendering the form BLANK. Read the
+        //    existing script and merge the caller's code into it; the platform
+        //    default (an empty script) is seeded with the lifecycle scaffold.
+        const existingScript = String(existingElements.find((element) => element.id === "customScript")?.innerHTML ?? "");
+        const composedScript = composeCustomScript(existingScript, args.source, args.replace === true ? "replace" : "merge");
+        // 3. Preserve the platform template read-modify-write: keep the
+        //    style/beforeCustomScript/afterCustomScript skeleton and every
+        //    layout/control element; customScript carries the MERGED script.
+        const composedElements = composeLayoutElements(existingElements, composedScript);
+        assertHtmlRender(JSON.stringify(composedElements), { schemaCode: args.schemaCode, sheetCode: args.sheetCode, face: "composedDraftHtmlJson" }, true);
+        // 4. Stringify the COMPLETE element array (never partial).
+        const composedDraftHtml = JSON.stringify(composedElements);
+        // 5. bizsheet/update with the new draftHtmlJson (delegated to the
+        //    shared form.draft write body so view/attributes scaffolds stay
+        //    intact when present).
+        await executeFormDraftWrite(session, {
+            schemaCode: args.schemaCode,
+            sheetCode: args.sheetCode,
+            draftHtmlJson: composedDraftHtml,
+        });
+        // 6. publish promotes the FULL layout (including customScript). Use
+        //    force:true so compose re-promotes even when the form was
+        //    previously published — otherwise onlinejs.compose would
+        //    leave the stale publishedHtmlJson in place after the user
+        //    already published once.
+        let published = false;
+        if (shouldPublish) {
+            const publishOutcome = await executeFormPublishWrite(session, {
+                schemaCode: args.schemaCode,
+                sheetCode: args.sheetCode,
+                force: true,
+            });
+            published = publishOutcome.readback.published === true;
+        }
+        // 7. Readback publishedHtmlJson VERBATIM.
+        const readback = await wireCall(session, { path: ENDPOINTS.sheetGet, query: { schemaCode: args.schemaCode, sheetCode: args.sheetCode } });
+        const publishedSheet = (readback.data ?? {});
+        const publishedRaw = typeof publishedSheet.publishedHtmlJson === "string" ? publishedSheet.publishedHtmlJson : "";
+        if (publishedRaw !== "")
+            assertHtmlRender(publishedRaw, { schemaCode: args.schemaCode, sheetCode: args.sheetCode, face: "publishedHtmlJson" }, true);
+        const publishedElements = parseLayoutElements(publishedRaw);
+        // 8. SHA-256 of the verbatim content.
+        const publishedSha256 = createHash("sha256").update(publishedRaw).digest("hex");
+        return {
+            performed: { errcode: 0, published },
+            readback: {
+                composedDraftHtmlJson: composedDraftHtml,
+                publishedHtmlJson: publishedRaw,
+                publishedSha256,
+                publishedElementCount: publishedElements.length,
+                scriptElementPresent: publishedElements.some((element) => element.id === "customScript"),
+                customScript: composedScript,
+                customScriptMerged: args.replace !== true,
+                htmlRenderCompat: { draft: validateHtmlRender(composedDraftHtml, true), published: validateHtmlRender(publishedRaw, true) },
+            },
+        };
+    }, 
+    // Refuse a source that cannot run in the script slot (export/import, unknown
+    // form.on event) BEFORE the write permission gate. This is the exact
+    // class of mistake that blanked a live form page with no harness signal.
+    (args) => lintOnlineJsSource(args.source));
+}
+//# sourceMappingURL=online-js.js.map

package/dist/lanes/report-contract.js

@@ -0,0 +1,144 @@
+import { assertDescriptionCarries, assertLaneContract, behaviorBinding, CONTRACT_FAMILY, CONTRACT_REFERENCE_VERSION } from "./contract-support.js";
+import { LANES } from "./lane-ids.js";
+/**
+ * R1-report wire facts (live-proven on the aozhe tenant, AI-Platform-v1.1.22,
+ * engineCode aozhe). The report surface is two channels glued by the report
+ * page: the platform channel `/api/api/report/*` (errcode envelope) owns the
+ * design-time page/menu entry; the BI channel `/dashboard/v1/*` (NO errcode
+ * envelope) owns the dashboard config and charts. See
+ * `.scratch/omc-report/recon.md` for the full capture.
+ */
+export const REPORT_WIRE = Object.freeze({
+    surface: "报表是两层：平台通道 /api/api/report/* 维护报表页(app 功能树 type=Report，errcode 信封)；BI 通道 /dashboard/v1/* 维护 dashboard 配置与图表（成功 {data}，失败 {errorCode,errorMessage,errorType:BIZ}，HTTP 仍 200）。BI 的 objectId = report/get 的 data.id（首次保存后 reportObjectId 同值）。",
+    authConfig: "BI 每个请求 body 必须带 config:{token,reportCode,appCode} 与外层 corpId（实测缺 config 的写会返回 {data:true} 但不生效——静默 no-op）；token 取会话登录 token，corpId 为该部署 BI corp id（aozhe 实测 \"a\"）。平台通道照旧 Authorization + X-LowCode-Corpid。",
+    reportPage: "report/create body {code,name,name_i18n:'{\"zh\":\"...\"}',parentId:<folder id>,icon,pcAble,mobileAble,appCode}（parentId 必填，否则断言失败）；report/update 同形再加 id；report/logical_delete?code=。",
+    reportPageSave: "report/v2/reportpage body {report:{objectId,title,attributes:'<json字符串>',global:'<json字符串>'},corpId,config} → {data:'<objectId>'}；用于首次创建 BI dashboard（全新报表页在 BI 侧不存在，需先 save 再读写图表）。",
+    chartWrite: "chart/addChart body {charts:[...]}、chart/updateChart body {charts:[...]}、chart/removeCharts body {objectIds:[<chart uuid>...]}、chart/removeChart body {objectId:<uuid>}（均需 corpId+config）。图表字段 uuid/type/position/dataSourceId/mainTable/data 等，position/data/styles 多为 JSON 字符串。",
+    globalAttributes: "report/saveGlobal body {objectId,global}、report/saveAttributes body {attributes,objectId}（均需 corpId+config）；global/attributes 自身是 JSON 字符串。",
+    readback: "BI 配置读 report/v2/config body {corpId,objectId,config} → {data:{title,global,attributes,charts[]}}；BI 侧不存在时返回 errorCode dashboard.not.exist（读时应报 present:false，不当作错误）。删除后以报表树(queryReportChartTreeByApp)缺席为准。",
+    datasource: "数据集读：report/v3/datasourcelist {}（业务模型表，nodeType=0）、dashboard/datasource/v2/datasource_list {}（同）、dashboard/datasource/advanced_list {}（自定义 SQL 数据集，nodeType=100/200）→ {data:[{dataSourceId,displayName,nodeType,useType,objectId,...}]}。关联：report/v3/datasource body {dataSourceInfos:[{dataSourceId,useType:1}]} → 返回该报表可用数据集模型（幂等重链）。",
+    chartdata: "图表数据读 datalogic/v3/chartdata body {chart,dataSourceId,corpId,config}：chart 是存储图表的 data 展平后（dimension/metric/filter/sort 提到顶层）且 limit 归一为 Integer（存储里是 {value,showOthers} 对象，直接回放会被拒 server.error）；id 取 uuid。",
+});
+const REPORT_SCOPE = "report tree read page metadata BI config chart data create update delete configure";
+export const REPORT_LANE_CONTRACT = Object.freeze({
+    lane: LANES.report,
+    family: CONTRACT_FAMILY,
+    referenceVersion: CONTRACT_REFERENCE_VERSION,
+    endpoints: Object.freeze({
+        treeAll: "reportTreeAll",
+        treeByApp: "reportTreeByApp",
+        get: "reportGet",
+        create: "reportCreate",
+        update: "reportUpdate",
+        delete: "reportDelete",
+        biConfig: "biReportConfig",
+        biPageSave: "biReportPageSave",
+        biRemove: "biReportRemove",
+        biSaveGlobal: "biReportSaveGlobal",
+        biSaveAttributes: "biReportSaveAttributes",
+        biChartAdd: "biChartAdd",
+        biChartUpdate: "biChartUpdate",
+        biChartRemove: "biChartRemove",
+        biChartRemoveMany: "biChartRemoveMany",
+        biChartData: "biChartData",
+        biDatasourceModelList: "biDatasourceModelList",
+        biDatasourceModelLink: "biDatasourceModelLink",
+        biDatasourceAdvancedList: "biDatasourceAdvancedList",
+        biDatasourceList: "biDatasourceList",
+    }),
+    wire: Object.freeze({
+        surface: REPORT_WIRE.surface,
+        authConfig: REPORT_WIRE.authConfig,
+        reportPage: REPORT_WIRE.reportPage,
+        reportPageSave: REPORT_WIRE.reportPageSave,
+        chartWrite: REPORT_WIRE.chartWrite,
+        globalAttributes: REPORT_WIRE.globalAttributes,
+        readback: REPORT_WIRE.readback,
+        datasource: REPORT_WIRE.datasource,
+        chartdata: REPORT_WIRE.chartdata,
+    }),
+    wireBindings: Object.freeze({
+        surface: Object.freeze([behaviorBinding("test/report.test.ts#report lane pins the platform + BI channel split", assertReportContract)]),
+        authConfig: Object.freeze([behaviorBinding("test/report.test.ts#report lane pins the platform + BI channel split", assertReportContract)]),
+        reportPage: Object.freeze([behaviorBinding("test/report.test.ts#report.create creates the page then seeds the BI dashboard", assertReportContract)]),
+        reportPageSave: Object.freeze([behaviorBinding("test/report.test.ts#report.create creates the page then seeds the BI dashboard", assertReportContract)]),
+        chartWrite: Object.freeze([behaviorBinding("test/report.test.ts#report.configure diffs charts and saves global/attributes", assertReportContract)]),
+        globalAttributes: Object.freeze([behaviorBinding("test/report.test.ts#report.configure diffs charts and saves global/attributes", assertReportContract)]),
+        readback: Object.freeze([behaviorBinding("test/report.test.ts#report.get reports present:false when the BI dashboard is missing", assertReportContract)]),
+        datasource: Object.freeze([behaviorBinding("test/report.test.ts#report.datasource.list reads the three sources and link posts dataSourceInfos", assertReportContract)]),
+        chartdata: Object.freeze([behaviorBinding("test/report.test.ts#report.chartdata flattens the stored chart and normalizes limit", assertReportContract)]),
+    }),
+    evidence: Object.freeze([
+        ".scratch/omc-report/recon.md",
+        "packages/omc-cli/src/lanes/report.ts",
+        "packages/omc-cli/src/bi-wire.ts",
+        "packages/omc-cli/test/report.test.ts",
+    ]),
+    tools: Object.freeze({
+        "report.tree": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "读取报表树：`appCode` 省略时读全量（app/folders/queryReportChartTree），提供时读该应用（runtime/app/queryReportChartTreeByApp）。返回报表页扁平清单（appCode/code/name/objectId）及其图表摘要（uuid/title/type）。只读。",
+        }),
+        "report.get": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "读取报表页元数据（/api/api/report/get，code）并合读 BI 配置（report/v2/config，objectId=元数据 id）：present、title、图表清单、global/attributes 是否非空。BI dashboard 不存在时 present:false（errorCode dashboard.not.exist 非错误）。`full:true` 返回两侧原始报文。只读。",
+        }),
+        "report.chartdata": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "按图表定义取运行时数据（datalogic/v3/chartdata）：入参 reportCode/appCode/chart（来自 report.get 的图表对象）/dataSourceId。工具把存储图表的 data 展平并归一化 limit 为 Integer 后查询（查看器同款），返回平台原始 {data}。运行时读，不占写锁。",
+        }),
+        "report.datasource.list": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "读取报表可用数据集：kind 取 model（report/v3/datasourcelist，业务模型表 nodeType=0）/ advanced（dashboard/datasource/advanced_list，自定义 SQL 数据集 nodeType=100/200）/ all（两者合并去重）。返回 dataSourceId/displayName/nodeType/useType。只读。",
+        }),
+        "report.datasource.link": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "把数据集关联到报表页（report/v3/datasource，body {dataSourceInfos:[{dataSourceId,useType}]}）；返回该报表可用的数据集模型。幂等重链。",
+        }),
+        "report.create": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "新建报表页：平台 report/create（code,name,appCode,parentId 必填；parentId 取所属分组 folder id）再 BI report/v2/reportpage 初始化 dashboard（global 用默认主题）。readback 见 report.get。",
+        }),
+        "report.update": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "更新报表页元数据（report/update）：name/name_i18n/icon/pcAble/mobileAble/parentId；先 report/get 取 id。readback 见 report/get。",
+        }),
+        "report.delete": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "删除报表页：先 BI report/removeReport 删 dashboard，再平台 report/logical_delete?code=。readback 以报表树缺席为准（report/get 可能仍返回软删记录）。",
+        }),
+        "report.configure": Object.freeze({
+            scope: REPORT_SCOPE,
+            description: "配置既有报表页：`global`→saveGlobal、`attributes`→saveAttributes（对象或 JSON 字符串，缺省不触碰）；`charts` 按 uuid diff——已存在 updateChart、缺失 addChart、`removeUnlistedCharts` 为真时删除未列出的既有图表（removeCharts）；执行后 report/v2/config 读回。BI 侧不存在则先报错提示用 report.create。",
+        }),
+    }),
+});
+export function assertReportContract() {
+    assertLaneContract(REPORT_LANE_CONTRACT);
+    if (!REPORT_WIRE.surface.includes("/dashboard/v1/"))
+        throw new Error("report contract must pin the BI channel");
+    if (!REPORT_WIRE.authConfig.includes("config"))
+        throw new Error("report contract must pin the in-body config auth");
+    if (!REPORT_WIRE.reportPage.includes("parentId"))
+        throw new Error("report contract must pin the required parentId");
+    if (!REPORT_WIRE.reportPageSave.includes("report/v2/reportpage"))
+        throw new Error("report contract must pin the BI page save");
+    if (!REPORT_WIRE.chartWrite.includes("addChart"))
+        throw new Error("report contract must pin addChart");
+    if (!REPORT_WIRE.chartWrite.includes("removeCharts"))
+        throw new Error("report contract must pin removeCharts");
+    if (!REPORT_WIRE.globalAttributes.includes("saveGlobal"))
+        throw new Error("report contract must pin saveGlobal");
+    if (!REPORT_WIRE.readback.includes("dashboard.not.exist"))
+        throw new Error("report contract must pin the missing-dashboard read");
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.tree", ["queryReportChartTree", "queryReportChartTreeByApp"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.get", ["report/get", "report/v2/config", "present"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.chartdata", ["chartdata", "report.get", "limit"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.create", ["report/create", "parentId"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.update", ["report/update"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.delete", ["removeReport", "logical_delete"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.configure", ["saveGlobal", "addChart", "updateChart", "removeCharts"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.datasource.list", ["datasourcelist", "advanced_list"]);
+    assertDescriptionCarries(REPORT_LANE_CONTRACT, "report.datasource.link", ["v3/datasource", "dataSourceInfos"]);
+}
+//# sourceMappingURL=report-contract.js.map

package/dist/lanes/report-coverage.js

@@ -0,0 +1,21 @@
+import { claim, declareLaneCoverage } from "./coverage-declaration.js";
+import { REPORT_LANE_CONTRACT } from "./report-contract.js";
+const T = REPORT_LANE_CONTRACT.tools;
+export const REPORT_COVERAGE = declareLaneCoverage(REPORT_LANE_CONTRACT.lane, [
+    {
+        capability: "R1 report page and BI chart lifecycle",
+        evidence: ["packages/omc-cli/src/lanes/report.ts", "packages/omc-cli/test/report.test.ts", ".scratch/omc-report/recon.md"],
+        tools: [
+            claim("report.tree", T["report.tree"].scope),
+            claim("report.get", T["report.get"].scope),
+            claim("report.chartdata", T["report.chartdata"].scope),
+            claim("report.datasource.list", T["report.datasource.list"].scope),
+            claim("report.datasource.link", T["report.datasource.link"].scope),
+            claim("report.create", T["report.create"].scope),
+            claim("report.update", T["report.update"].scope),
+            claim("report.delete", T["report.delete"].scope),
+            claim("report.configure", T["report.configure"].scope),
+        ],
+    },
+]);
+//# sourceMappingURL=report-coverage.js.map