burgee 0.8.0 → 0.9.1

package/dist/testing-helpers.js

@@ -133,7 +133,9 @@ export async function runBurgee(program, opts) {
         await execute(program, {
             argv: rt.argv,
             env: rt.env,
-            stdout: rt.stdout,
+            cwd: rt.cwd,
+            stdin: rt.stdin,
+            stdout: { write: rt.stdout.write, isTTY: rt.isTTY.stdout },
             stderr: rt.stderr,
             exit: (c) => rt.exit(c),
             root: program.rootPath,

package/dist/validate.d.ts

@@ -11,6 +11,21 @@ export declare class UsageError extends Error {
     readonly hint?: string | undefined;
     constructor(message: string, hint?: string | undefined);
 }
+/**
+ * E6 — the far side said no. Throw this and the run leaves with `ExitCode.AUTH`.
+ *
+ * The one error class whose *response* is unambiguous: not "read the message and decide" but
+ * "get a credential and run it again". A handler that throws a bare `Error` for a 401 gets
+ * `RUNTIME`, which is the code for everything, and a caller retrying on it retries forever.
+ *
+ * `fix` is the exact command that gets the credential, where the program knows it — `hint` is
+ * prose a person reads and `fix` is a line a caller runs, which is the turn the field saves.
+ */
+export declare class AuthError extends Error {
+    readonly hint?: string | undefined;
+    readonly fix?: string | undefined;
+    constructor(message: string, hint?: string | undefined, fix?: string | undefined);
+}
 type Sources = Record<string, {
     source: string;
 }>;

package/dist/validate.js

@@ -6,6 +6,16 @@ export class UsageError extends Error {
         this.hint = hint;
     }
 }
+export class AuthError extends Error {
+    hint;
+    fix;
+    constructor(message, hint, fix) {
+        super(message);
+        this.hint = hint;
+        this.fix = fix;
+        this.name = 'AuthError';
+    }
+}
 const isSet = (values, key, sources) => values[key] !== undefined && sources[key]?.source !== 'default';
 const flagList = (keys) => flagsOf(keys).join(', ');
 function exactlyOne(keys, on) {

package/dist/yargs/factory.js

@@ -1,7 +1,6 @@
 var _a;
 import { ExitCode } from '../exit-code.js';
 import { Manifest } from '../manifest.js';
-import { serveMcp } from '../mcp.js';
 import { machineJson, schemaOf } from '../schema.js';
 import { tokenizeArgString } from '../yargs-parser.js';
 import { projectManifest, render } from './burgee.js';
@@ -1288,7 +1287,9 @@ export class YargsInstance {
                 return { stdout: out.join(''), stderr: err.join(''), code };
             };
             const write = this.#burgee?.stdout ?? this.#shim.process.stdout();
-            return serveMcp(this.manifest, { input: this.#shim.process.stdin(), output: { write: (s) => void write.write(s) }, invoke }).then(() => {
+            return import('../mcp.js')
+                .then(async ({ serveMcp }) => serveMcp(this.manifest, { input: this.#shim.process.stdin(), output: { write: (s) => void write.write(s) }, invoke }))
+                .then(() => {
                 this.exit(0);
                 return true;
             });
@@ -1315,6 +1316,10 @@ export class YargsInstance {
             .then(async (value) => {
             await manifest.fire('postRun', name, options);
             return settle(value);
+        })
+            .catch(async (cause) => {
+            await manifest.fire('onError', name, options);
+            throw cause;
         });
     }
     #settle(value, argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burgee",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "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",
@@ -22,6 +22,26 @@
       "import": "./dist/plugin.js",
       "default": "./dist/plugin.js"
     },
+    "./help": {
+      "types": "./dist/help-entry.d.ts",
+      "import": "./dist/help-entry.js",
+      "default": "./dist/help-entry.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp-entry.d.ts",
+      "import": "./dist/mcp-entry.js",
+      "default": "./dist/mcp-entry.js"
+    },
+    "./schema": {
+      "types": "./dist/schema-entry.d.ts",
+      "import": "./dist/schema-entry.js",
+      "default": "./dist/schema-entry.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
     "./brand": {
       "types": "./dist/brand.d.ts",
       "import": "./dist/brand.js",
@@ -47,6 +67,11 @@
       "import": "./dist/commander.js",
       "default": "./dist/commander.js"
     },
+    "./meow": {
+      "types": "./dist/meow.d.ts",
+      "import": "./dist/meow.js",
+      "default": "./dist/meow.js"
+    },
     "./completions": {
       "types": "./dist/completions.d.ts",
       "import": "./dist/completions.js",
@@ -86,7 +111,7 @@
     "url": "git+https://github.com/ofri-peretz/burgee.git",
     "directory": "packages/burgee"
   },
-  "homepage": "https://github.com/ofri-peretz/burgee#readme",
+  "homepage": "https://burgee.interlace.tools/docs/packages/burgee",
   "bugs": {
     "url": "https://github.com/ofri-peretz/burgee/issues"
   },
@@ -98,21 +123,37 @@
     "yargs",
     "mcp",
     "agent",
-    "framework"
+    "framework",
+    "plugin",
+    "plugins",
+    "extensible",
+    "cli-framework",
+    "argument-parser",
+    "subcommands",
+    "json-schema",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "llm",
+    "shell-completion",
+    "typescript",
+    "zero-dependency",
+    "commander-alternative",
+    "yargs-alternative"
   ],
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "bellpull": "^0.1.1",
-    "closeout": "^0.2.1",
-    "linegauge": "^0.3.2",
-    "roundel": "^0.3.1",
-    "seniority": "^0.3.1"
+    "bellpull": "^0.2.1",
+    "closeout": "^0.3.1",
+    "linegauge": "^0.4.1",
+    "roundel": "^0.4.1",
+    "seniority": "^0.4.1"
   },
   "devDependencies": {
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "bin": {
     "burgee": "./dist/cli.js"