@koda-sl/baker-cli 0.329.0 → 0.330.0

package/README.md

@@ -99,8 +99,9 @@ An option a command does not declare stops the run with `UNKNOWN_ARGUMENT`, nami
 closest real one. Previously such an option was accepted and ignored, so a call that
 looked like it had filtered or narrowed a result was in fact answering the unfiltered
 question — and nothing in the output said so. Both spellings of an option work
-(`--run-id` and `--runId`), as they always did. Run `baker schema <command>` to see
-every option a command takes.
+(`--run-id` and `--runId`), as they always did. The error's `fix` names the exact call
+that lists every option: `baker schema <command>` (`check_schema`) when the command
+registers a schema, `baker <command> --help` (`check_help`) when it does not.
 
 ### Fresh reads: `--no-cache`
 
@@ -3661,8 +3662,9 @@ Inspect command argument schemas for AI agent introspection.
 
 ```bash
 baker schema                    # List all commands
-baker schema ads.google.query   # Get query command schema
-baker schema images.search      # Get image search schema
+baker schema ads google query   # Get query command schema, path as typed
+baker schema ads.google.query   # Same schema, dotted name
+baker schema tag-manager read   # Kebab-case paths resolve to their registered name (tagManager.read)
 ```
 
 Not every command registers a schema. On `NOT_FOUND` the error carries a structured `fix` pointing at `--help` and the family's agent doc (`__tooling__/docs/tools/baker/<family>.md` in sandboxes). Every top-level family's `--help` also ends with a `Full guide:` line pointing at that doc; `packages/cli/__tests__/doc-coverage.test.ts` fails CI if a mounted command is missing from its family doc.

package/dist/cli.js

@@ -578,12 +578,24 @@ var registry = /* @__PURE__ */ new Map();
 function registerSchema(schema) {
   registry.set(schema.command, schema);
 }
-function getSchema(command) {
-  return registry.get(command);
-}
 function listSchemas() {
   return [...registry.keys()];
 }
+function spellingKey(name) {
+  return name.toLowerCase().replaceAll("-", "");
+}
+function resolveSchemaName(words2, names) {
+  const joined = words2.join(".");
+  if (names.includes(joined)) {
+    return joined;
+  }
+  const matches = names.filter((name) => spellingKey(name) === spellingKey(joined));
+  return matches.length === 1 ? matches[0] : void 0;
+}
+function findSchema(words2) {
+  const name = resolveSchemaName(words2, listSchemas());
+  return name === void 0 ? void 0 : registry.get(name);
+}
 
 // ../api/src/actions.ts
 import { z } from "zod";
@@ -62386,23 +62398,24 @@ function narrowToFamily(commandName, available) {
 var schemaCommand2 = defineCommand204({
   meta: {
     name: "schema",
-    description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images.search"
+    description: "Inspect command argument schemas (for AI agent introspection). Lists all commands if no argument given. Example: baker schema images search (or images.search)"
   },
   args: {
     command: {
       type: "positional",
-      description: "Command name (e.g. images.list). Omit to list all.",
+      description: "Command path, as typed (images list) or dotted (images.list). Omit to list all.",
       required: false
     }
   },
   run: ({ args: args4 }) => {
-    const commandName = args4.command;
-    if (!commandName) {
+    const words2 = args4._.filter((word) => typeof word === "string" && word.length > 0);
+    if (words2.length === 0) {
       const schemas = listSchemas();
       writeJson({ ok: true, data: { commands: schemas } });
       return;
     }
-    const schema = getSchema(commandName);
+    const commandName = words2.join(".");
+    const schema = findSchema(words2);
     if (!schema) {
       const all = listSchemas();
       const available = narrowToFamily(commandName, all);
@@ -66995,7 +67008,7 @@ function commandFor(root, argv) {
   const { command, resolved } = resolveCommand2(root, argv);
   return resolved ? command : null;
 }
-function unknownFlagEnvelope(unknown, commandPath, suggestion) {
+function unknownFlagEnvelope(unknown, commandPath, suggestion, hasSchema) {
   const list = unknown.join(", ");
   return {
     ok: false,
@@ -67003,8 +67016,8 @@ function unknownFlagEnvelope(unknown, commandPath, suggestion) {
       code: "UNKNOWN_ARGUMENT",
       message: `${list} ${unknown.length > 1 ? "are not options" : "is not an option"} of \`baker ${commandPath}\`.`,
       fix: {
-        action: "check_schema",
-        explanation: (suggestion ? `Did you mean ${suggestion}? ` : "") + `Run \`baker schema ${commandPath}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
+        action: hasSchema ? "check_schema" : "check_help",
+        explanation: (suggestion ? `Did you mean ${suggestion}? ` : "") + `Run \`${hasSchema ? `baker schema ${commandPath}` : `baker ${commandPath} --help`}\` to see every option this command takes. Do not re-run the same call: until this version an unrecognised option was accepted and ignored, so a command that looked like it had filtered or narrowed the result was in fact answering the unfiltered question.`
       },
       retryable: false
     }
@@ -67035,8 +67048,9 @@ function refuseUnknownFlags(root, argv) {
   const command = commandFor(root, argv);
   const first = unknown[0];
   const suggestion = command && first ? closestFlag(first, command) : null;
+  const path48 = commandPathOf(root, argv);
   process.stdout.write(
-    `${JSON.stringify(unknownFlagEnvelope(unknown, commandPathOf(root, argv), suggestion), null, 2)}
+    `${JSON.stringify(unknownFlagEnvelope(unknown, path48, suggestion, findSchema(path48.split(" ")) !== void 0), null, 2)}
 `
   );
   process.exit(1);