burgee 0.12.0 → 0.13.0

package/dist/yargs/factory.js

@@ -66,6 +66,7 @@ export class YargsInstance {
     #versionOpt = null;
     #validation;
     #burgee = undefined;
+    #floor = false;
     #effects = undefined;
     #manifest = undefined;
     constructor(processArgs = [], cwd, parentRequire, shim) {
@@ -356,7 +357,7 @@ export class YargsInstance {
             return;
         }
         if (this.#exitProcess)
-            this.#shim.process.exit(burgee?.json === true ? e1 : code);
+            this.#shim.process.exit(burgee?.json === true || this.#floor ? e1 : code);
     }
     exitProcess(enabled = true) {
         argsert('[boolean]', [enabled], arguments.length);
@@ -602,11 +603,11 @@ export class YargsInstance {
         const seam = this.#burgee?.exit === undefined ? undefined : this.#burgee;
         if (seam === undefined) {
             const escape = (err) => {
-                const json = this.#burgee?.json === true && !(err instanceof YError);
-                if (json)
-                    this.#failJson(err);
+                const report = (this.#burgee?.json === true || this.#floor) && !(err instanceof YError);
+                if (report)
+                    this.#failHandler(err);
                 restore();
-                if (!json)
+                if (!report)
                     throw err;
                 return undefined;
             };
@@ -1159,8 +1160,11 @@ export class YargsInstance {
         this.manifest.use(plugin);
         return this;
     }
-    burgee(seam) {
-        this.#burgee = { ...(this.#burgee ?? { json: false, lastError: '' }), ...seam };
+    burgee({ floor, ...seam }) {
+        if (floor !== undefined)
+            this.#floor = floor;
+        if (Object.keys(seam).length > 0)
+            this.#burgee = { ...(this.#burgee ?? { json: false, lastError: '' }), ...seam };
         return this;
     }
     #snapshot() {
@@ -1279,7 +1283,8 @@ export class YargsInstance {
             });
         }
         if (head.includes('--schema') && !this.#declares('schema')) {
-            this.#logger.log(machineJson(schemaOf(this.manifest), head));
+            const shadows = ['--json', '--mcp', 'completion'].filter((name) => (name === 'completion' && this.#completionCommand !== null) || this.#declares(name.replace(/^--/, '')));
+            this.#logger.log(machineJson({ ...schemaOf(this.manifest), ...(shadows.length > 0 && { shadows }) }, head));
             this.exit(0);
             return true;
         }
@@ -1314,9 +1319,14 @@ export class YargsInstance {
             this.#settle(value, argv);
             return value;
         };
+        const failed = (cause) => {
+            if (!this.#floor || this.#burgee?.exit)
+                throw cause;
+            return this.#failHandler(cause);
+        };
         if (manifest === undefined || manifest.plugins.length === 0) {
             const result = handler(argv);
-            return isPromise(result) ? result.then(settle) : settle(result);
+            return isPromise(result) ? result.then(settle, failed) : settle(result);
         }
         const name = original.replace(/^\$0 ?/, '').split(' ')[0] ?? '';
         const options = {};
@@ -1331,7 +1341,7 @@ export class YargsInstance {
         })
             .catch(async (cause) => {
             await manifest.fire('onError', name, options);
-            throw cause;
+            return failed(cause);
         });
     }
     #settle(value, argv) {
@@ -1358,9 +1368,12 @@ export class YargsInstance {
         burgee.reported = true;
         this.#logger.log(JSON.stringify({ ok: false, error: this.#failureOf(err).error }));
     }
-    #failJson(err) {
-        this.#failureEnvelope(err);
-        const { exit } = this.#failureOf(err);
+    #failHandler(err) {
+        const { exit, error } = this.#failureOf(err);
+        if (this.#burgee?.json)
+            this.#failureEnvelope(err);
+        else
+            this.#logger.error(error.message);
         if (this.#exitProcess)
             this.#shim.process.exit(exit);
         else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burgee",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "An agent-native CLI framework, drop-in compatible with commander and yargs. One declaration; help, --json, --schema, --mcp and completions all projected from it.",
   "license": "MIT",
   "type": "module",
@@ -147,11 +147,11 @@
     "provenance": true
   },
   "dependencies": {
-    "bellpull": "^0.4.0",
+    "bellpull": "^0.4.1",
     "closeout": "^0.5.2",
-    "linegauge": "^0.5.2",
+    "linegauge": "^0.5.3",
     "roundel": "^0.5.2",
-    "seniority": "^0.6.0"
+    "seniority": "^0.6.1"
   },
   "devDependencies": {
     "vitest": "^5.0.1"