@stalfh233/omc-cli 0.4.29 → 0.4.31

package/dist/cli.js

@@ -791,7 +791,12 @@ function cmdIntentValidate(file, transport, showIntent = false) {
     return emitResult({ status: "ok", valid: true, errors: [], digest: intentDigest(read.intent), ...(warnings.length > 0 ? { warnings } : {}), ...(showIntent ? { intent: read.intent } : {}) }, transport);
 }
 /** Round 16b — `omc intent schema [--example <id>]`: the offline DSL discovery face. */
-function cmdIntentSchema(transport, example) {
+function cmdIntentSchema(transport, example, exampleRequested) {
+    // r25 finding: `intent schema --example` with NO id was a commander argument
+    // error, while `describe <tool> --example` lists available ids — align: no
+    // id lists the runnable ids.
+    if (example === undefined && exampleRequested === true)
+        return emitResult({ status: "ok", found: false, available: intentExampleIds(), next: intentExampleIds()[0] !== undefined ? `omc intent schema --example ${intentExampleIds()[0]}` : undefined }, transport);
     if (example !== undefined) {
         const found = intentExample(example);
         if (!found)
@@ -1113,7 +1118,10 @@ async function cmdIntentApply(planPath, options, transport) {
         const toolCounts = new Map();
         for (const change of plan.changes)
             toolCounts.set(change.tool, (toolCounts.get(change.tool) ?? 0) + 1);
-        console.error(`intent apply ${planId} --dry-run：${plan.changes.length} 项变更预览，零环境写入`);
+        // r25 finding: this hint taught `intent apply <planId>` — apply only
+        // accepts a plan FILE / JSON / the source YAML (planId is a hash for
+        // reference, not an apply input). Point at the real re-entry.
+        console.error(`intent apply <意图.yaml> --env ${plan.environment} --dry-run：${plan.changes.length} 项变更预览，零环境写入（apply 收文件/YAML，不收 planId）`);
         return emit({
             status: "dry-run",
             wouldChange: plan.changes.length > 0,
@@ -1445,7 +1453,7 @@ async function main() {
         commandExitCode = await withTransport(options, request, (transport) => cmdCapability(id, transport, options.executable === true));
     });
     const intentCommand = command.command("intent");
-    intentCommand.command("schema").option("--example <id>").action((options) => { commandExitCode = cmdIntentSchema({ request, maxOutputBytes: CLI_DEFAULT_OUTPUT_BYTES }, typeof options.example === "string" ? options.example : undefined); });
+    intentCommand.command("schema").option("--example [id]").action((options) => { commandExitCode = cmdIntentSchema({ request, maxOutputBytes: CLI_DEFAULT_OUTPUT_BYTES }, typeof options.example === "string" ? options.example : undefined, options.example !== undefined); });
     intentCommand.command("validate <file>").option("--show-intent").action((file, options) => { commandExitCode = cmdIntentValidate(file, { request, maxOutputBytes: CLI_DEFAULT_OUTPUT_BYTES }, options.showIntent === true); });
     intentCommand.command("plan <file>").option("--env <environment>").option("--plan-out <file>").option("--max-output-bytes <bytes>").action(async (file, options) => {
         commandExitCode = await withTransport(options, request, (transport) => cmdIntentPlan(file, options.env, options.planOut, transport));

package/dist/execution-metadata.js

@@ -421,22 +421,20 @@ const workflowSave = Object.freeze({
 });
 const plainSubmit = Object.freeze({
     id: "plain-data-submit",
-    title: "无流程模型：草稿直提（DRAFT→COMPLETED，触发 Create 规则）",
-    status: "requires-prior-readback",
+    title: "无流程模型：新建并提交一调完成（COMPLETED，触发 Create 规则）——正式数据的标准路径",
+    status: "offline-valid",
     tool: "data.submit",
-    args: { environment, schemaCode: model, bizObjectId: "<data.save.performed.bizObjectId>", formData: { name: "recipe draft" } },
-    preconditions: ["模型无 workflowCode（有流程走 workflow-backed-data-submit）", "data.save 已成功并读回 DRAFT 草稿", "bizObjectId 取 data.save 读回，不要手造"],
-    conditionalRequirements: ["无需 workflowInstanceId/workItemId——无流程模型 submit 自持久化（runtime/form/submit 就地置 COMPLETED）"],
-    priorToolReferences: [
-        { tool: "data.save", args: { environment, schemaCode: model, formData: { name: "recipe draft" } }, purpose: "建 DRAFT 草稿并读回 bizObjectId（其 draftRuleHint 会指回本链）" },
-    ],
+    args: { environment, schemaCode: model, formData: { name: "正式记录" } },
+    preconditions: ["模型无已发布流程（有流程走 workflow-backed-data-submit）", "模型+表单已发布"],
+    conditionalRequirements: ["**不带 bizObjectId 即新建并提交**（工具内部建稿+直提，一次调用 COMPLETED）；已有草稿要直提时才带 data.save 读回的 bizObjectId；不要手造 id"],
+    priorToolReferences: [],
     dryRun: { supported: true, command: `omc call data.submit --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 验证参数关系，不推进状态" },
     expectedReadback: { performed: { errcode: 0 }, readback: { sequenceStatus: "COMPLETED" } },
     refusalRecovery: [
         { code: "submit-biz-object-absent", action: "bizObjectId 在平台无行（304001）——回 data.save 重建草稿后再直提" },
         { code: "invalid-input", action: "带了 workItemId/workflowInstanceId 时必须同时带 bizObjectId（fail-closed）" },
     ],
-    notes: "规则验证路径：Create/Update 规则只在 COMPLETED 分发——plain save 是 DRAFT 不触发（DomainServiceImpl.java:240-248）；要验证规则效果就用本链提交后 data.load 核对",
+    notes: "r23 复盘修正：本配方曾教先 save 再 submit 两步——正确路径是无 id 一调（业务约定：正式数据一律 data.submit）。Create/Update 规则只在 COMPLETED 分发（DomainServiceImpl.java:240-248）；规则效果以提交读回/data.load 为准。data.save 定位=草稿/暂存",
     requiresEnvironmentDerivedIds: true,
 });
 const workflowSubmit = Object.freeze({

package/package.json

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