aui-agent-builder 0.3.122 → 0.3.124

package/dist/utils/help-json.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Serialize a Commander `Command` tree into a plain JSON-friendly shape.
+ *
+ * Powers `aui --help --json` (and `aui <command> --help --json`): instead of
+ * the human-formatted help text, emit a structured description of every
+ * command, its arguments, options, and nested subcommands. This is intended
+ * for tooling and coding agents (Claude/Cursor) that want to discover the
+ * full CLI surface programmatically.
+ */
+import type { Command } from "commander";
+export interface HelpJsonOption {
+    flags: string;
+    description: string;
+    /** Default value when the option was registered with one. */
+    default: unknown;
+    /** True when the flag takes a value that is required (`--flag <v>`). */
+    takesRequiredValue: boolean;
+    /** True when the flag takes an optional value (`--flag [v]`). */
+    takesOptionalValue: boolean;
+}
+export interface HelpJsonArgument {
+    name: string;
+    description: string;
+    required: boolean;
+    variadic: boolean;
+}
+export interface HelpJsonCommand {
+    name: string;
+    aliases: string[];
+    description: string;
+    usage: string;
+    arguments: HelpJsonArgument[];
+    options: HelpJsonOption[];
+    commands: HelpJsonCommand[];
+}
+/** Recursively serialize a command and all of its subcommands. */
+export declare function serializeCommand(cmd: Command): HelpJsonCommand;
+/**
+ * Walk into the command tree following the non-flag tokens in argv, returning
+ * the deepest command that matches (so `aui integration test --help --json`
+ * scopes the output to the `test` command). Falls back to `root`.
+ */
+export declare function resolveCommandFromArgv(root: Command, argv: string[]): Command;
+//# sourceMappingURL=help-json.d.ts.map

package/dist/utils/help-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-json.d.ts","sourceRoot":"","sources":["../../src/utils/help-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iEAAiE;IACjE,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAcD,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAgC9D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAWT"}

package/dist/utils/help-json.js

@@ -0,0 +1,62 @@
+/**
+ * Serialize a Commander `Command` tree into a plain JSON-friendly shape.
+ *
+ * Powers `aui --help --json` (and `aui <command> --help --json`): instead of
+ * the human-formatted help text, emit a structured description of every
+ * command, its arguments, options, and nested subcommands. This is intended
+ * for tooling and coding agents (Claude/Cursor) that want to discover the
+ * full CLI surface programmatically.
+ */
+function serializeOption(o) {
+    return {
+        flags: o.flags,
+        description: o.description || "",
+        default: o.defaultValue,
+        // These describe whether the option *takes* a required or optional value
+        // (Commander semantics), NOT whether the option itself is mandatory.
+        takesRequiredValue: !!o.required,
+        takesOptionalValue: !!o.optional,
+    };
+}
+/** Recursively serialize a command and all of its subcommands. */
+export function serializeCommand(cmd) {
+    // Commander 12 exposes positional args via `registeredArguments`; fall back
+    // to the older `_args` for resilience across minor versions.
+    const cmdAny = cmd;
+    const args = (cmdAny.registeredArguments ?? cmdAny._args ?? []);
+    return {
+        name: cmd.name(),
+        aliases: cmd.aliases(),
+        description: cmd.description() || "",
+        usage: cmd.usage(),
+        arguments: args.map((a) => ({
+            name: typeof a.name === "function" ? a.name() : a._name || "",
+            description: a.description || "",
+            required: !!a.required,
+            variadic: !!a.variadic,
+        })),
+        options: cmd.options.map(serializeOption),
+        commands: cmd.commands
+            // Skip Commander's auto-generated `help` subcommand — it's noise.
+            .filter((c) => c.name() !== "help")
+            .map(serializeCommand),
+    };
+}
+/**
+ * Walk into the command tree following the non-flag tokens in argv, returning
+ * the deepest command that matches (so `aui integration test --help --json`
+ * scopes the output to the `test` command). Falls back to `root`.
+ */
+export function resolveCommandFromArgv(root, argv) {
+    let target = root;
+    for (const tok of argv) {
+        if (tok.startsWith("-"))
+            continue;
+        const sub = target.commands.find((c) => c.name() === tok || c.aliases().includes(tok));
+        if (!sub)
+            break;
+        target = sub;
+    }
+    return target;
+}
+//# sourceMappingURL=help-json.js.map

package/dist/utils/help-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-json.js","sourceRoot":"","sources":["../../src/utils/help-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgCH,SAAS,eAAe,CAAC,CAAS;IAChC,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;QAChC,OAAO,EAAE,CAAC,CAAC,YAAY;QACvB,yEAAyE;QACzE,qEAAqE;QACrE,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;QAChC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;KACjC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,4EAA4E;IAC5E,6DAA6D;IAC7D,MAAM,MAAM,GAAG,GAGd,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,mBAAmB,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAM5D,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QACtB,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE;QACpC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;YAC7D,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;YAChC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;YACtB,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;SACvB,CAAC,CAAC;QACH,OAAO,EAAG,GAAG,CAAC,OAAoB,CAAC,GAAG,CAAC,eAAe,CAAC;QACvD,QAAQ,EAAG,GAAG,CAAC,QAAsB;YACnC,kEAAkE;aACjE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;aAClC,GAAG,CAAC,gBAAgB,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAa,EACb,IAAc;IAEd,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClC,MAAM,GAAG,GAAI,MAAM,CAAC,QAAsB,CAAC,IAAI,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CACrD,CAAC;QACF,IAAI,CAAC,GAAG;YAAE,MAAM;QAChB,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aui-agent-builder",
-  "version": "0.3.122",
+  "version": "0.3.124",
   "description": "CLI for building, managing, and deploying AUI AI agent configurations",
   "type": "module",
   "main": "dist/index.js",