@qvac/harness 0.8.10 → 0.8.11

package/CHANGELOG.md

@@ -8,6 +8,16 @@ While the major version is `0`, a breaking change bumps the minor version.
 
 ## [Unreleased]
 
+## [0.8.11] - 2026-10-16
+
+### Fixed
+
+- A skill CLI call the schema rejects names what the command accepts: an
+  `unknown parameter`, `unknown flag` or `unexpected argument` error now ends
+  with the node's parameters or subcommands, e.g.
+  `unknown parameter "title"; create takes: name, path, …`. The message
+  prefixes are unchanged. (#523)
+
 ## [0.8.10] - 2026-10-16
 
 ### Added
@@ -2068,7 +2078,8 @@ Install 0.2.12 or later to get them.
 - Every dependency installs from the public npm registry: GPU stats are read
   through `bare-gpu-info`. (#12)
 
-[Unreleased]: https://github.com/tetherto/qvac-harness/compare/v0.8.10...HEAD
+[Unreleased]: https://github.com/tetherto/qvac-harness/compare/v0.8.11...HEAD
+[0.8.11]: https://github.com/tetherto/qvac-harness/compare/v0.8.10...v0.8.11
 [0.8.10]: https://github.com/tetherto/qvac-harness/compare/v0.8.9...v0.8.10
 [0.8.9]: https://github.com/tetherto/qvac-harness/compare/v0.8.8...v0.8.9
 [0.8.8]: https://github.com/tetherto/qvac-harness/compare/v0.8.7...v0.8.8

package/dist-lib/lib/tools/skills/cli-argv.js

@@ -19,7 +19,7 @@ export function walkCommands(argv, schema) {
 }
 export function argvToObject(argv, schema) {
     const { node, pathSegs, index } = walkCommands(argv, schema);
-    const leaf = parseParams(argv.slice(index), node);
+    const leaf = parseParams(argv.slice(index), node, pathSegs.join(' '));
     if (typeof leaf === 'string') {
         return leaf;
     }
@@ -52,7 +52,27 @@ function flagParts(tok) {
     }
     return { key: body.slice(0, ieq), inline: body.slice(ieq + 1) };
 }
-function parseParams(tokens, schema) {
+function accepted(schema, command) {
+    const commands = [];
+    const params = [];
+    for (const [key, prop] of Object.entries(objectProps(schema))) {
+        if (isObjectSchema(prop)) {
+            commands.push(key);
+        }
+        else {
+            params.push(key);
+        }
+    }
+    const parts = [];
+    if (commands.length) {
+        parts.push(`commands: ${commands.join(', ')}`);
+    }
+    if (params.length) {
+        parts.push(`${command || 'it'} takes: ${params.join(', ')}`);
+    }
+    return parts.length ? `; ${parts.join('; ')}` : '';
+}
+function parseParams(tokens, schema, command) {
     const props = objectProps(schema);
     const propSchemas = new Map(Object.entries(props));
     const boolKeys = new Set(Object.entries(props)
@@ -77,7 +97,7 @@ function parseParams(tokens, schema) {
                 continue;
             }
             if (!canAbsorb) {
-                return `unknown parameter "${key}"`;
+                return `unknown parameter "${key}"${accepted(schema, command)}`;
             }
         }
         const flag = tok.startsWith('-') ? flagParts(tok) : null;
@@ -103,7 +123,7 @@ function parseParams(tokens, schema) {
             continue;
         }
         if (flag && !canAbsorb) {
-            return `unknown flag "--${flag.key}"`;
+            return `unknown flag "--${flag.key}"${accepted(schema, command)}`;
         }
         if (boolKeys.has(tok)) {
             out[tok] = true;
@@ -131,7 +151,7 @@ function parseParams(tokens, schema) {
             i++;
             continue;
         }
-        return `unexpected argument "${tok}"`;
+        return `unexpected argument "${tok}"${accepted(schema, command)}`;
     }
     if (restName && restVals.length > 0) {
         out[restName] = restVals;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/harness",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "type": "module",
   "engines": {
     "bare": ">=1.34.0"
@@ -789,7 +789,7 @@
     "@qvac/langdetect-text": "^0.1.2",
     "@qvac/logging": "0.1.1",
     "@qvac/sdk": "^0.21.0",
-    "@qvac/skills": "0.1.15",
+    "@qvac/skills": "^0.1.16",
     "@xmldom/xmldom": "^0.9.12",
     "asenion": "^0.1.0",
     "b4a": "^1.9.0",