@stalfh233/omc-cli 0.4.30 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.30",
+  "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.30",
+    "omc-core": "0.4.31",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",