burgee 0.13.2 → 0.14.0

package/dist/argv.js

@@ -8,5 +8,5 @@ export function isJsonFlag(arg) {
 export function mayServe(argv) {
     const head = beforeTerminator(argv);
     const first = argv[0];
-    return first === '__complete' || first === 'completion' || first === 'help' || head[0] === '--mcp' || (head[0] === 'config' && head[1] === 'explain') || head.includes('--schema');
+    return first === '__complete' || first === 'completion' || first === 'help' || first === 'schema' || head[0] === '--mcp' || (head[0] === 'config' && head[1] === 'explain') || head.includes('--schema');
 }

package/dist/help.js

@@ -39,6 +39,7 @@ const GLOBAL = [
     { term: '--json', text: 'machine-readable output', kind: 'flag' },
     { term: '--help', text: 'show this help', kind: 'flag' },
 ];
+const ROOT_GLOBAL = [...GLOBAL, { term: '--schema', text: 'the program as data', kind: 'flag' }];
 function deprecation(d) {
     if (d === undefined || d === false)
         return '';
@@ -194,13 +195,14 @@ export function renderHelp(manifest, node, opts = {}) {
     const args = argumentRows(node.arguments ?? []);
     const options = optionRows(node.options, verbose);
     const env = environmentRows(node.options);
-    const column = termColumn([...args, ...options, ...GLOBAL, ...commands.flatMap((s) => s.rows), ...env], width);
+    const global = node.path.length === root.length ? ROOT_GLOBAL : GLOBAL;
+    const column = termColumn([...args, ...options, ...global, ...commands.flatMap((s) => s.rows), ...env], width);
     const lines = [usageLine(node, root, commands.length > 0, paint), ''];
     if (node.description !== undefined)
         lines.push(...wrap(`${node.description}${deprecation(node.deprecated)}`, width), '');
     lines.push(...section('Arguments:', layout(args, width, column, paint), paint));
     lines.push(...section('Options:', layout(options, width, column, paint), paint));
-    lines.push(...section('Global options:', layout(GLOBAL, width, column, paint), paint));
+    lines.push(...section('Global options:', layout(global, width, column, paint), paint));
     for (const s of commands)
         lines.push(...section(s.title, layout(s.rows, width, column, paint), paint));
     lines.push(...section('Examples:', exampleLines(node.examples ?? [], width), paint));

package/dist/surfaces.js

@@ -69,6 +69,13 @@ async function helpCommand(manifest, argv, root, io) {
     const { node } = manifest.resolve(argv, root);
     return renderHelp(manifest, node ?? rootNode(manifest, root), io);
 }
+function schemaAlias(manifest, argv) {
+    const top = manifest.find(manifest.rootPath);
+    const takesWords = (top?.run ?? top?.load) !== undefined && (top?.arguments?.length ?? 0) > 0;
+    if (argv[0] !== 'schema' || takesWords || manifest.find([...manifest.rootPath, 'schema']) !== undefined)
+        return undefined;
+    return ['--schema', ...argv.slice(1)];
+}
 export async function serve(manifest, argv, io, engine) {
     const head = beforeTerminator(argv);
     if (argv[0] === '__complete') {
@@ -87,9 +94,11 @@ export async function serve(manifest, argv, io, engine) {
         io.out.write(await helpCommand(manifest, argv.slice(1), manifest.rootPath, io));
         return true;
     }
-    if (head.includes('--schema')) {
+    const asked = schemaAlias(manifest, argv) ?? argv;
+    const askedHead = beforeTerminator(asked);
+    if (askedHead.includes('--schema')) {
         const { schemaSurface } = await import('./schema-surface.js');
-        io.out.write(`${await machineJson(await schemaSurface(manifest, argv), head)}\n`);
+        io.out.write(`${await machineJson(await schemaSurface(manifest, asked), askedHead)}\n`);
         return true;
     }
     if (head[0] === '--mcp') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burgee",
-  "version": "0.13.2",
+  "version": "0.14.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",