padrone 1.8.2 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
+## padrone@2.0.0
+
+### Externalize optional integrations to dedicated subpath entry points
+
+Optional integrations are now exported from dedicated subpath entry points so bundlers that don't tree-shake re-exports keep their dependencies out of the main bundle. Update imports as follows:
+
+- `padroneInk`, `isReactElement`, `InkOptions` → `'padrone/ink'`
+- `padroneMcp`, `WithMcp`, `PadroneMcpPreferences` → `'padrone/mcp'`
+- `padroneServe`, `WithServe` → `'padrone/serve'`
+- `padroneTracing`, `WithTracing`, `PadroneTracer`, `PadroneTracingConfig`, `OtelSpan`, `OtelTracer`, `OtelTracerProvider` → `'padrone/tracing'`
+- `padroneCompletion`, `WithCompletion` → `'padrone/completion'`
+- `padroneMan`, `WithMan` → `'padrone/man'`
+
 # padrone
 
+## 1.9.0
+
+### Minor Changes
+
+- [`8114f98`](https://github.com/KurtGokhan/padrone/commit/8114f98ce3ae46cb6cdfa152d39e78e35d6ebe7d) Thanks [@KurtGokhan](https://github.com/KurtGokhan)! - Auto-coerce CLI string values for union types (e.g. `z.union([z.boolean(), z.string()])`) — `--flag true` now correctly passes boolean `true` instead of the string `"true"`
+
 ## 1.8.2
 
 ### Patch Changes
@@ -140,7 +159,7 @@
   - Empty string indicators hide the icon prefix entirely
   - Graceful fallback in non-TTY/CI environments
 
-  **New types**: `PadroneProgressIndicator`, `PadroneProgressConfig`, `PadroneProgressMessage`, `PadroneProgressOptions`, `PadroneSpinnerConfig`, `PadroneSpinnerPreset`
+  **New types**: `PadroneProgress`, `PadroneProgressConfig`, `PadroneProgressMessage`, `PadroneProgressOptions`, `PadroneSpinnerConfig`, `PadroneSpinnerPreset`
 
 - [`6851b48`](https://github.com/KurtGokhan/padrone/commit/6851b4878ab0fc8d48f40e93c2f8924236a40165) Thanks [@KurtGokhan](https://github.com/KurtGokhan)! - Add REST server (`program.serve()`) and `mutation` command config.
 

package/README.md

@@ -9,7 +9,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/padrone"><img src="https://img.shields.io/npm/v/padrone.svg" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/padrone"><img src="https://img.shields.io/npm/dm/padrone.svg" alt="npm downloads"></a>
-  <a href="https://github.com/KurtGokhan/padrone/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/padrone.svg" alt="license"></a>
+  <a href="https://github.com/gkurt/padrone/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/padrone.svg" alt="license"></a>
 </p>
 
 ---
@@ -185,7 +185,7 @@ program.help('greet', { format: 'json' });   // json, markdown, html, ansi
 Give your AI coding agent knowledge of the Padrone API:
 
 ```bash
-npx skills add KurtGokhan/padrone
+npx skills add gkurt/padrone
 ```
 
 ## Requirements

package/dist/codegen/code-builder.d.mts

@@ -0,0 +1,10 @@
+import { CodeBuilder } from "./types.mjs";
+
+//#region src/codegen/code-builder.d.ts
+/**
+ * Create a new CodeBuilder for constructing TypeScript source files.
+ */
+declare function createCodeBuilder(): CodeBuilder;
+//#endregion
+export { createCodeBuilder };
+//# sourceMappingURL=code-builder.d.mts.map

package/dist/codegen/code-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-builder.d.mts","names":[],"sources":["../../src/codegen/code-builder.ts"],"mappings":";;;;;AA+NA;iBAAgB,iBAAA,IAAqB,WAAW"}

package/dist/codegen/code-builder.mjs

@@ -0,0 +1,185 @@
+//#region src/codegen/code-builder.ts
+var CodeBuilderImpl = class CodeBuilderImpl {
+	imports = /* @__PURE__ */ new Map();
+	lines = [];
+	indent;
+	constructor(indent = 0) {
+		this.indent = indent;
+	}
+	import(specifier, source) {
+		const specs = Array.isArray(specifier) ? specifier : [specifier];
+		const existing = this.imports.get(source);
+		if (existing) {
+			for (const s of specs) existing.specifiers.add(s);
+			existing.typeOnly = false;
+		} else this.imports.set(source, {
+			specifiers: new Set(specs),
+			typeOnly: false
+		});
+		return this;
+	}
+	importDefault(name, source) {
+		const existing = this.imports.get(source);
+		if (existing) {
+			existing.defaultSpecifier = name;
+			existing.typeOnly = false;
+		} else this.imports.set(source, {
+			specifiers: /* @__PURE__ */ new Set(),
+			defaultSpecifier: name,
+			typeOnly: false
+		});
+		return this;
+	}
+	importType(specifier, source) {
+		const specs = Array.isArray(specifier) ? specifier : [specifier];
+		const existing = this.imports.get(source);
+		if (existing) for (const s of specs) existing.specifiers.add(s);
+		else this.imports.set(source, {
+			specifiers: new Set(specs),
+			typeOnly: true
+		});
+		return this;
+	}
+	line(code) {
+		this.lines.push({
+			type: "line",
+			content: code ?? ""
+		});
+		return this;
+	}
+	block(openOrBuilder, builderOrClose, closeOrBuilder) {
+		let open;
+		let close;
+		let builder;
+		if (typeof openOrBuilder === "function") builder = openOrBuilder;
+		else if (typeof builderOrClose === "function") {
+			open = openOrBuilder;
+			builder = builderOrClose;
+			close = typeof closeOrBuilder === "string" ? closeOrBuilder : void 0;
+		} else if (typeof closeOrBuilder === "function") {
+			open = openOrBuilder;
+			close = typeof builderOrClose === "string" ? builderOrClose : void 0;
+			builder = closeOrBuilder;
+		} else throw new Error("Invalid block() arguments");
+		this.lines.push({
+			type: "block-open",
+			content: open ?? ""
+		});
+		const inner = new CodeBuilderImpl(this.indent + 1);
+		builder(inner);
+		for (const [source, entry] of inner.imports) {
+			const existing = this.imports.get(source);
+			if (existing) {
+				for (const s of entry.specifiers) existing.specifiers.add(s);
+				if (entry.defaultSpecifier) existing.defaultSpecifier = entry.defaultSpecifier;
+				if (!entry.typeOnly) existing.typeOnly = false;
+			} else this.imports.set(source, {
+				specifiers: new Set(entry.specifiers),
+				defaultSpecifier: entry.defaultSpecifier,
+				typeOnly: entry.typeOnly
+			});
+		}
+		for (const line of inner.lines) this.lines.push(line);
+		this.lines.push({
+			type: "block-close",
+			content: close ?? ""
+		});
+		return this;
+	}
+	comment(text) {
+		this.lines.push({
+			type: "line",
+			content: `// ${text}`
+		});
+		return this;
+	}
+	docComment(text) {
+		const lines = text.split("\n");
+		if (lines.length === 1) this.lines.push({
+			type: "line",
+			content: `/** ${text} */`
+		});
+		else {
+			this.lines.push({
+				type: "line",
+				content: "/**"
+			});
+			for (const line of lines) this.lines.push({
+				type: "line",
+				content: ` * ${line}`
+			});
+			this.lines.push({
+				type: "line",
+				content: " */"
+			});
+		}
+		return this;
+	}
+	todoComment(text) {
+		this.lines.push({
+			type: "line",
+			content: `// TODO: ${text}`
+		});
+		return this;
+	}
+	raw(code) {
+		this.lines.push({
+			type: "raw",
+			content: code
+		});
+		return this;
+	}
+	build() {
+		const parts = [];
+		if (this.imports.size > 0) {
+			const typeImports = [];
+			const valueImports = [];
+			for (const [source, entry] of this.imports) {
+				const specs = [...entry.specifiers].sort();
+				const namedPart = specs.length > 0 ? specs.length === 1 && !specs[0].includes(" ") ? `{ ${specs[0]} }` : `{ ${specs.join(", ")} }` : null;
+				const specStr = entry.defaultSpecifier ? namedPart ? `${entry.defaultSpecifier}, ${namedPart}` : entry.defaultSpecifier : namedPart;
+				const line = entry.typeOnly ? `import type ${specStr} from '${source}'` : `import ${specStr} from '${source}'`;
+				if (entry.typeOnly) typeImports.push(line);
+				else valueImports.push(line);
+			}
+			parts.push([...valueImports, ...typeImports].join("\n"));
+			parts.push("");
+		}
+		let currentIndent = this.indent;
+		for (const line of this.lines) if (line.type === "raw") parts.push(line.content);
+		else if (line.type === "block-open") {
+			if (line.content) {
+				const indent = "  ".repeat(currentIndent);
+				parts.push(`${indent}${line.content}`);
+			}
+			currentIndent++;
+		} else if (line.type === "block-close") {
+			currentIndent--;
+			if (line.content) {
+				const indent = "  ".repeat(currentIndent);
+				parts.push(`${indent}${line.content}`);
+			}
+		} else if (line.content === "") parts.push("");
+		else {
+			const indent = "  ".repeat(currentIndent);
+			parts.push(`${indent}${line.content}`);
+		}
+		return {
+			text: parts.join("\n"),
+			imports: new Map([...this.imports].map(([source, entry]) => [source, {
+				specifiers: new Set(entry.specifiers),
+				typeOnly: entry.typeOnly
+			}]))
+		};
+	}
+};
+/**
+* Create a new CodeBuilder for constructing TypeScript source files.
+*/
+function createCodeBuilder() {
+	return new CodeBuilderImpl();
+}
+//#endregion
+export { createCodeBuilder };
+
+//# sourceMappingURL=code-builder.mjs.map

package/dist/codegen/code-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-builder.mjs","names":[],"sources":["../../src/codegen/code-builder.ts"],"sourcesContent":["import type { CodeBuilder, CodeBuildResult } from './types.ts';\n\ninterface ImportEntry {\n  specifiers: Set<string>;\n  defaultSpecifier?: string;\n  typeOnly: boolean;\n}\n\ninterface CodeLine {\n  type: 'line' | 'raw' | 'block-open' | 'block-close';\n  content: string;\n}\n\nclass CodeBuilderImpl implements CodeBuilder {\n  private imports = new Map<string, ImportEntry>();\n  private lines: CodeLine[] = [];\n  private indent: number;\n\n  constructor(indent = 0) {\n    this.indent = indent;\n  }\n\n  import(specifier: string | string[], source: string): CodeBuilder {\n    const specs = Array.isArray(specifier) ? specifier : [specifier];\n    const existing = this.imports.get(source);\n    if (existing) {\n      for (const s of specs) existing.specifiers.add(s);\n      // If we're adding a value import and existing was type-only, downgrade to value\n      existing.typeOnly = false;\n    } else {\n      this.imports.set(source, { specifiers: new Set(specs), typeOnly: false });\n    }\n    return this;\n  }\n\n  importDefault(name: string, source: string): CodeBuilder {\n    const existing = this.imports.get(source);\n    if (existing) {\n      existing.defaultSpecifier = name;\n      existing.typeOnly = false;\n    } else {\n      this.imports.set(source, { specifiers: new Set(), defaultSpecifier: name, typeOnly: false });\n    }\n    return this;\n  }\n\n  importType(specifier: string | string[], source: string): CodeBuilder {\n    const specs = Array.isArray(specifier) ? specifier : [specifier];\n    const existing = this.imports.get(source);\n    if (existing) {\n      for (const s of specs) existing.specifiers.add(s);\n      // Don't downgrade: if existing is value import, keep it as value\n    } else {\n      this.imports.set(source, { specifiers: new Set(specs), typeOnly: true });\n    }\n    return this;\n  }\n\n  line(code?: string): CodeBuilder {\n    this.lines.push({ type: 'line', content: code ?? '' });\n    return this;\n  }\n\n  block(\n    openOrBuilder: string | ((b: CodeBuilder) => CodeBuilder),\n    builderOrClose?: string | ((b: CodeBuilder) => CodeBuilder),\n    closeOrBuilder?: string | ((b: CodeBuilder) => CodeBuilder),\n  ): CodeBuilder {\n    let open: string | undefined;\n    let close: string | undefined;\n    let builder: (b: CodeBuilder) => CodeBuilder;\n\n    if (typeof openOrBuilder === 'function') {\n      // block(builder)\n      builder = openOrBuilder;\n    } else if (typeof builderOrClose === 'function') {\n      // block(open, builder, close?)\n      open = openOrBuilder;\n      builder = builderOrClose;\n      close = typeof closeOrBuilder === 'string' ? closeOrBuilder : undefined;\n    } else if (typeof closeOrBuilder === 'function') {\n      // block(open, close, builder)\n      open = openOrBuilder;\n      close = typeof builderOrClose === 'string' ? builderOrClose : undefined;\n      builder = closeOrBuilder;\n    } else {\n      throw new Error('Invalid block() arguments');\n    }\n\n    // Always push block-open to increment indent\n    this.lines.push({ type: 'block-open', content: open ?? '' });\n\n    const inner = new CodeBuilderImpl(this.indent + 1);\n    builder(inner);\n\n    // Merge inner imports into ours\n    for (const [source, entry] of inner.imports) {\n      const existing = this.imports.get(source);\n      if (existing) {\n        for (const s of entry.specifiers) existing.specifiers.add(s);\n        if (entry.defaultSpecifier) existing.defaultSpecifier = entry.defaultSpecifier;\n        if (!entry.typeOnly) existing.typeOnly = false;\n      } else {\n        this.imports.set(source, {\n          specifiers: new Set(entry.specifiers),\n          defaultSpecifier: entry.defaultSpecifier,\n          typeOnly: entry.typeOnly,\n        });\n      }\n    }\n\n    // Merge inner lines with extra indentation\n    for (const line of inner.lines) {\n      this.lines.push(line);\n    }\n\n    // Always push block-close to decrement indent\n    this.lines.push({ type: 'block-close', content: close ?? '' });\n\n    return this;\n  }\n\n  comment(text: string): CodeBuilder {\n    this.lines.push({ type: 'line', content: `// ${text}` });\n    return this;\n  }\n\n  docComment(text: string): CodeBuilder {\n    const lines = text.split('\\n');\n    if (lines.length === 1) {\n      this.lines.push({ type: 'line', content: `/** ${text} */` });\n    } else {\n      this.lines.push({ type: 'line', content: '/**' });\n      for (const line of lines) {\n        this.lines.push({ type: 'line', content: ` * ${line}` });\n      }\n      this.lines.push({ type: 'line', content: ' */' });\n    }\n    return this;\n  }\n\n  todoComment(text: string): CodeBuilder {\n    this.lines.push({ type: 'line', content: `// TODO: ${text}` });\n    return this;\n  }\n\n  raw(code: string): CodeBuilder {\n    this.lines.push({ type: 'raw', content: code });\n    return this;\n  }\n\n  build(): CodeBuildResult {\n    const parts: string[] = [];\n\n    // Emit imports first\n    if (this.imports.size > 0) {\n      const typeImports: string[] = [];\n      const valueImports: string[] = [];\n\n      for (const [source, entry] of this.imports) {\n        const specs = [...entry.specifiers].sort();\n        const namedPart =\n          specs.length > 0 ? (specs.length === 1 && !specs[0]!.includes(' ') ? `{ ${specs[0]} }` : `{ ${specs.join(', ')} }`) : null;\n        const specStr = entry.defaultSpecifier\n          ? namedPart\n            ? `${entry.defaultSpecifier}, ${namedPart}`\n            : entry.defaultSpecifier\n          : namedPart!;\n\n        const line = entry.typeOnly ? `import type ${specStr} from '${source}'` : `import ${specStr} from '${source}'`;\n\n        if (entry.typeOnly) {\n          typeImports.push(line);\n        } else {\n          valueImports.push(line);\n        }\n      }\n\n      // Value imports first, then type imports\n      parts.push([...valueImports, ...typeImports].join('\\n'));\n      parts.push('');\n    }\n\n    // Emit code lines\n    let currentIndent = this.indent;\n    for (const line of this.lines) {\n      if (line.type === 'raw') {\n        parts.push(line.content);\n      } else if (line.type === 'block-open') {\n        if (line.content) {\n          const indent = '  '.repeat(currentIndent);\n          parts.push(`${indent}${line.content}`);\n        }\n        currentIndent++;\n      } else if (line.type === 'block-close') {\n        currentIndent--;\n        if (line.content) {\n          const indent = '  '.repeat(currentIndent);\n          parts.push(`${indent}${line.content}`);\n        }\n      } else {\n        // Regular line\n        if (line.content === '') {\n          parts.push('');\n        } else {\n          const indent = '  '.repeat(currentIndent);\n          parts.push(`${indent}${line.content}`);\n        }\n      }\n    }\n\n    return {\n      text: parts.join('\\n'),\n      imports: new Map(\n        [...this.imports].map(([source, entry]) => [source, { specifiers: new Set(entry.specifiers), typeOnly: entry.typeOnly }]),\n      ),\n    };\n  }\n}\n\n/**\n * Create a new CodeBuilder for constructing TypeScript source files.\n */\nexport function createCodeBuilder(): CodeBuilder {\n  return new CodeBuilderImpl();\n}\n"],"mappings":"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"}

package/dist/codegen/discovery.d.mts

@@ -0,0 +1,44 @@
+import { CommandMeta, GeneratorLogger } from "./types.mjs";
+
+//#region src/codegen/discovery.d.ts
+type DiscoverySource = 'help' | 'completion' | 'bash' | 'fish' | 'zsh';
+interface DiscoveryOptions {
+  /** The command to discover (e.g. 'gh', 'docker', 'kubectl'). */
+  command: string;
+  /**
+   * Which parsing sources to use. Default: ['help'].
+   * Use `'completion'` to auto-detect the best shell completion source
+   * by probing `<cmd> completion <shell>` (bash → fish → zsh).
+   */
+  sources?: DiscoverySource[];
+  /** Max subcommand depth. 0 = root only, undefined = unlimited. */
+  depth?: number;
+  /** Delay in ms between help invocations. Default: 50 */
+  delay?: number;
+  /** Logger for progress reporting. */
+  log?: GeneratorLogger;
+  /** Timeout per help invocation in ms. Default: 10000 */
+  timeout?: number;
+}
+interface DiscoveryResult {
+  /** The discovered command tree. */
+  command: CommandMeta;
+  /** Number of help invocations made. */
+  invocations: number;
+  /** Errors encountered (non-fatal). */
+  warnings: string[];
+}
+/**
+ * Discover CLI structure by running --help recursively and optionally
+ * parsing shell completion scripts.
+ */
+declare function discoverCli(options: DiscoveryOptions): Promise<DiscoveryResult>;
+/**
+ * Detect the best shell for completion parsing by probing the command.
+ * Tries `<cmd> completion <shell>` for bash, fish, zsh (in that order).
+ * Returns the shell name if successful, or null if no completion command exists.
+ */
+declare function detectCompletionShell(command: string, timeout?: number): Promise<'bash' | 'fish' | 'zsh' | null>;
+//#endregion
+export { DiscoveryOptions, DiscoveryResult, DiscoverySource, detectCompletionShell, discoverCli };
+//# sourceMappingURL=discovery.d.mts.map

package/dist/codegen/discovery.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.mts","names":[],"sources":["../../src/codegen/discovery.ts"],"mappings":";;;KAUY,eAAA;AAAA,UAEK,gBAAA;EAFL;EAIV,OAAA;;;AAJyB;AAE3B;;EAQE,OAAA,GAAU,eAAA;EAMW;EAJrB,KAAA;EAFA;EAIA,KAAA;EAFA;EAIA,GAAA,GAAM,eAAe;EAArB;EAEA,OAAA;AAAA;AAAA,UAGe,eAAA;EAHR;EAKP,OAAA,EAAS,WAAW;EAFU;EAI9B,WAAA;EAFoB;EAIpB,QAAA;AAAA;;;;AAAQ;iBAOY,WAAA,CAAY,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA;;;;;;iBA2MhD,qBAAA,CAAsB,OAAA,UAAiB,OAAA,YAAiB,OAAO"}

package/dist/codegen/discovery.mjs

@@ -0,0 +1,179 @@
+import { parseBashCompletions } from "./parsers/bash.mjs";
+import { parseFishCompletions } from "./parsers/fish.mjs";
+import { parseHelpOutput } from "./parsers/help.mjs";
+import { mergeCommandMeta } from "./parsers/merge.mjs";
+import { parseZshCompletions } from "./parsers/zsh.mjs";
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+//#region src/codegen/discovery.ts
+/**
+* Discover CLI structure by running --help recursively and optionally
+* parsing shell completion scripts.
+*/
+async function discoverCli(options) {
+	const { command, sources: rawSources = ["help"], depth, delay = 50, log, timeout = 1e4 } = options;
+	const sources = await resolveSources(rawSources, command, timeout, log);
+	const warnings = [];
+	let invocations = 0;
+	const results = [];
+	if (sources.includes("help")) {
+		log?.info(`Discovering ${command} via --help...`);
+		const helpResult = await crawlHelp(command, [], {
+			depth,
+			delay,
+			timeout,
+			log,
+			onInvocation: () => {
+				invocations++;
+			},
+			onWarning: (msg) => {
+				warnings.push(msg);
+			}
+		});
+		results.push(helpResult);
+	}
+	if (sources.includes("bash")) {
+		log?.info(`Parsing bash completions for ${command}...`);
+		const bashText = await getCompletionScript(command, "bash", timeout);
+		if (bashText) results.push(parseBashCompletions(bashText));
+		else warnings.push("Could not obtain bash completion script");
+	}
+	if (sources.includes("fish")) {
+		log?.info(`Parsing fish completions for ${command}...`);
+		const fishText = await getCompletionScript(command, "fish", timeout);
+		if (fishText) results.push(parseFishCompletions(fishText));
+		else warnings.push("Could not obtain fish completion script");
+	}
+	if (sources.includes("zsh")) {
+		log?.info(`Parsing zsh completions for ${command}...`);
+		const zshText = await getCompletionScript(command, "zsh", timeout);
+		if (zshText) results.push(parseZshCompletions(zshText));
+		else warnings.push("Could not obtain zsh completion script");
+	}
+	const merged = results.length > 0 ? mergeCommandMeta(...results) : { name: command };
+	if (!merged.name) merged.name = command;
+	return {
+		command: merged,
+		invocations,
+		warnings
+	};
+}
+/**
+* Breadth-first crawl of --help output.
+*/
+async function crawlHelp(command, prefixArgs, options) {
+	const fullCmd = [command, ...prefixArgs].join(" ");
+	options.onInvocation();
+	const helpText = await runHelp(command, prefixArgs, options.timeout);
+	if (!helpText) {
+		options.onWarning(`No help output from: ${fullCmd} --help`);
+		return { name: prefixArgs[prefixArgs.length - 1] || command };
+	}
+	const parsed = parseHelpOutput(helpText, { name: prefixArgs[prefixArgs.length - 1] || command });
+	options.log?.info(`  ${fullCmd}: ${parsed.subcommands?.length || 0} subcommands, ${parsed.arguments?.length || 0} options`);
+	const currentDepth = prefixArgs.length;
+	if (parsed.subcommands && parsed.subcommands.length > 0 && (options.depth === void 0 || currentDepth < options.depth)) {
+		const resolvedSubs = [];
+		for (const sub of parsed.subcommands) {
+			if (options.delay > 0) await sleep(options.delay);
+			const resolved = await crawlHelp(command, [...prefixArgs, sub.name], options);
+			if (!resolved.description && sub.description) resolved.description = sub.description;
+			resolvedSubs.push(resolved);
+		}
+		parsed.subcommands = resolvedSubs;
+	}
+	return parsed;
+}
+/**
+* Run `<cmd> --help` or `<cmd> help` and return combined stdout+stderr.
+*/
+async function runHelp(command, args, timeout) {
+	let result = await runCommand(command, [...args, "--help"], timeout);
+	if (result) return result;
+	if (args.length > 0) {
+		result = await runCommand(command, ["help", ...args], timeout);
+		if (result) return result;
+	}
+	return null;
+}
+/**
+* Run a command and return its combined output, or null on failure.
+*/
+async function runCommand(command, args, timeout) {
+	try {
+		const { stdout, stderr } = await new Promise((resolve) => {
+			execFile(command, args, {
+				timeout,
+				maxBuffer: 10 * 1024 * 1024
+			}, (_error, stdout, stderr) => {
+				resolve({
+					stdout: (stdout ?? "").trim(),
+					stderr: (stderr ?? "").trim()
+				});
+			});
+		});
+		const combined = stdout || stderr;
+		if (!combined) return null;
+		if (combined.length < 10) return null;
+		return combined;
+	} catch {
+		return null;
+	}
+}
+/**
+* Try to get a shell completion script for a command.
+* Checks both `<cmd> completion <shell>` and well-known file paths.
+*/
+async function getCompletionScript(command, shell, timeout) {
+	let result = await runCommand(command, ["completion", shell], timeout);
+	if (result) return result;
+	result = await runCommand(command, ["completions", shell], timeout);
+	if (result) return result;
+	const paths = shell === "fish" ? [`/usr/share/fish/vendor_completions.d/${command}.fish`, `/usr/local/share/fish/vendor_completions.d/${command}.fish`] : shell === "bash" ? [
+		`/usr/share/bash-completion/completions/${command}`,
+		`/usr/local/share/bash-completion/completions/${command}`,
+		`/etc/bash_completion.d/${command}`
+	] : [`/usr/share/zsh/site-functions/_${command}`, `/usr/local/share/zsh/site-functions/_${command}`];
+	for (const path of paths) try {
+		return await readFile(path, "utf-8");
+	} catch {}
+	return null;
+}
+/**
+* Detect the best shell for completion parsing by probing the command.
+* Tries `<cmd> completion <shell>` for bash, fish, zsh (in that order).
+* Returns the shell name if successful, or null if no completion command exists.
+*/
+async function detectCompletionShell(command, timeout = 5e3) {
+	for (const shell of [
+		"bash",
+		"fish",
+		"zsh"
+	]) if (await getCompletionScript(command, shell, timeout)) return shell;
+	return null;
+}
+/**
+* Resolve 'completion' entries in the sources array by probing for the best available shell.
+* Other sources are passed through unchanged.
+*/
+async function resolveSources(sources, command, timeout, log) {
+	if (!sources.includes("completion")) return sources;
+	log?.info(`Probing ${command} for completion command...`);
+	const shell = await detectCompletionShell(command, timeout);
+	return sources.flatMap((s) => {
+		if (s !== "completion") return s;
+		if (shell) {
+			log?.info(`  Found ${shell} completion support`);
+			return shell;
+		}
+		log?.info("  No completion command found, skipping");
+		return [];
+	});
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+export { detectCompletionShell, discoverCli };
+
+//# sourceMappingURL=discovery.mjs.map

package/dist/codegen/discovery.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.mjs","names":[],"sources":["../../src/codegen/discovery.ts"],"sourcesContent":["import { execFile } from 'node:child_process';\nimport { readFile } from 'node:fs/promises';\n\nimport { parseBashCompletions } from './parsers/bash.ts';\nimport { parseFishCompletions } from './parsers/fish.ts';\nimport { parseHelpOutput } from './parsers/help.ts';\nimport { mergeCommandMeta } from './parsers/merge.ts';\nimport { parseZshCompletions } from './parsers/zsh.ts';\nimport type { CommandMeta, GeneratorLogger } from './types.ts';\n\nexport type DiscoverySource = 'help' | 'completion' | 'bash' | 'fish' | 'zsh';\n\nexport interface DiscoveryOptions {\n  /** The command to discover (e.g. 'gh', 'docker', 'kubectl'). */\n  command: string;\n  /**\n   * Which parsing sources to use. Default: ['help'].\n   * Use `'completion'` to auto-detect the best shell completion source\n   * by probing `<cmd> completion <shell>` (bash → fish → zsh).\n   */\n  sources?: DiscoverySource[];\n  /** Max subcommand depth. 0 = root only, undefined = unlimited. */\n  depth?: number;\n  /** Delay in ms between help invocations. Default: 50 */\n  delay?: number;\n  /** Logger for progress reporting. */\n  log?: GeneratorLogger;\n  /** Timeout per help invocation in ms. Default: 10000 */\n  timeout?: number;\n}\n\nexport interface DiscoveryResult {\n  /** The discovered command tree. */\n  command: CommandMeta;\n  /** Number of help invocations made. */\n  invocations: number;\n  /** Errors encountered (non-fatal). */\n  warnings: string[];\n}\n\n/**\n * Discover CLI structure by running --help recursively and optionally\n * parsing shell completion scripts.\n */\nexport async function discoverCli(options: DiscoveryOptions): Promise<DiscoveryResult> {\n  const { command, sources: rawSources = ['help'], depth, delay = 50, log, timeout = 10000 } = options;\n\n  // Resolve 'completion' source by probing for the best available shell\n  const sources = await resolveSources(rawSources, command, timeout, log);\n\n  const warnings: string[] = [];\n  let invocations = 0;\n\n  const results: CommandMeta[] = [];\n\n  // Source 1: --help recursive crawl\n  if (sources.includes('help')) {\n    log?.info(`Discovering ${command} via --help...`);\n    const helpResult = await crawlHelp(command, [], {\n      depth,\n      delay,\n      timeout,\n      log,\n      onInvocation: () => {\n        invocations++;\n      },\n      onWarning: (msg) => {\n        warnings.push(msg);\n      },\n    });\n    results.push(helpResult);\n  }\n\n  // Source 2: Bash completions\n  if (sources.includes('bash')) {\n    log?.info(`Parsing bash completions for ${command}...`);\n    const bashText = await getCompletionScript(command, 'bash', timeout);\n    if (bashText) {\n      results.push(parseBashCompletions(bashText));\n    } else {\n      warnings.push('Could not obtain bash completion script');\n    }\n  }\n\n  // Source 3: Fish completions\n  if (sources.includes('fish')) {\n    log?.info(`Parsing fish completions for ${command}...`);\n    const fishText = await getCompletionScript(command, 'fish', timeout);\n    if (fishText) {\n      results.push(parseFishCompletions(fishText));\n    } else {\n      warnings.push('Could not obtain fish completion script');\n    }\n  }\n\n  // Source 4: Zsh completions\n  if (sources.includes('zsh')) {\n    log?.info(`Parsing zsh completions for ${command}...`);\n    const zshText = await getCompletionScript(command, 'zsh', timeout);\n    if (zshText) {\n      results.push(parseZshCompletions(zshText));\n    } else {\n      warnings.push('Could not obtain zsh completion script');\n    }\n  }\n\n  const merged = results.length > 0 ? mergeCommandMeta(...results) : { name: command };\n\n  // Ensure the root has the correct name\n  if (!merged.name) merged.name = command;\n\n  return { command: merged, invocations, warnings };\n}\n\ninterface CrawlOptions {\n  depth?: number;\n  delay: number;\n  timeout: number;\n  log?: GeneratorLogger;\n  onInvocation: () => void;\n  onWarning: (msg: string) => void;\n}\n\n/**\n * Breadth-first crawl of --help output.\n */\nasync function crawlHelp(command: string, prefixArgs: string[], options: CrawlOptions): Promise<CommandMeta> {\n  const fullCmd = [command, ...prefixArgs].join(' ');\n\n  options.onInvocation();\n  const helpText = await runHelp(command, prefixArgs, options.timeout);\n\n  if (!helpText) {\n    options.onWarning(`No help output from: ${fullCmd} --help`);\n    return { name: prefixArgs[prefixArgs.length - 1] || command };\n  }\n\n  const name = prefixArgs[prefixArgs.length - 1] || command;\n  const parsed = parseHelpOutput(helpText, { name });\n\n  options.log?.info(`  ${fullCmd}: ${parsed.subcommands?.length || 0} subcommands, ${parsed.arguments?.length || 0} options`);\n\n  // Recurse into subcommands breadth-first\n  const currentDepth = prefixArgs.length;\n  if (parsed.subcommands && parsed.subcommands.length > 0 && (options.depth === undefined || currentDepth < options.depth)) {\n    const resolvedSubs: CommandMeta[] = [];\n\n    for (const sub of parsed.subcommands) {\n      if (options.delay > 0) {\n        await sleep(options.delay);\n      }\n      const resolved = await crawlHelp(command, [...prefixArgs, sub.name], options);\n      // Preserve description from parent's subcommand list if child didn't have one\n      if (!resolved.description && sub.description) {\n        resolved.description = sub.description;\n      }\n      resolvedSubs.push(resolved);\n    }\n\n    parsed.subcommands = resolvedSubs;\n  }\n\n  return parsed;\n}\n\n/**\n * Run `<cmd> --help` or `<cmd> help` and return combined stdout+stderr.\n */\nasync function runHelp(command: string, args: string[], timeout: number): Promise<string | null> {\n  // Try --help first\n  let result = await runCommand(command, [...args, '--help'], timeout);\n  if (result) return result;\n\n  // Some CLIs use `help <cmd>` instead\n  if (args.length > 0) {\n    result = await runCommand(command, ['help', ...args], timeout);\n    if (result) return result;\n  }\n\n  return null;\n}\n\n/**\n * Run a command and return its combined output, or null on failure.\n */\nasync function runCommand(command: string, args: string[], timeout: number): Promise<string | null> {\n  try {\n    const { stdout, stderr } = await new Promise<{ stdout: string; stderr: string }>((resolve) => {\n      execFile(command, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (_error, stdout, stderr) => {\n        // Resolve even on non-zero exit — many CLIs exit non-zero on --help\n        resolve({ stdout: (stdout ?? '').trim(), stderr: (stderr ?? '').trim() });\n      });\n    });\n\n    // Some CLIs output help to stderr, some exit non-zero on --help\n    const combined = stdout || stderr;\n    if (!combined) return null;\n\n    // Basic sanity check: help text usually has some structure\n    if (combined.length < 10) return null;\n\n    return combined;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Try to get a shell completion script for a command.\n * Checks both `<cmd> completion <shell>` and well-known file paths.\n */\nasync function getCompletionScript(command: string, shell: 'bash' | 'fish' | 'zsh', timeout: number): Promise<string | null> {\n  // Try `<cmd> completion <shell>`\n  const completionArgs = ['completion', shell];\n  let result = await runCommand(command, completionArgs, timeout);\n  if (result) return result;\n\n  // Try `<cmd> completions <shell>`\n  result = await runCommand(command, ['completions', shell], timeout);\n  if (result) return result;\n\n  // Try reading from well-known paths\n  const paths =\n    shell === 'fish'\n      ? [`/usr/share/fish/vendor_completions.d/${command}.fish`, `/usr/local/share/fish/vendor_completions.d/${command}.fish`]\n      : shell === 'bash'\n        ? [\n            `/usr/share/bash-completion/completions/${command}`,\n            `/usr/local/share/bash-completion/completions/${command}`,\n            `/etc/bash_completion.d/${command}`,\n          ]\n        : [`/usr/share/zsh/site-functions/_${command}`, `/usr/local/share/zsh/site-functions/_${command}`];\n\n  for (const path of paths) {\n    try {\n      return await readFile(path, 'utf-8');\n    } catch {}\n  }\n\n  return null;\n}\n\n/**\n * Detect the best shell for completion parsing by probing the command.\n * Tries `<cmd> completion <shell>` for bash, fish, zsh (in that order).\n * Returns the shell name if successful, or null if no completion command exists.\n */\nexport async function detectCompletionShell(command: string, timeout = 5000): Promise<'bash' | 'fish' | 'zsh' | null> {\n  for (const shell of ['bash', 'fish', 'zsh'] as const) {\n    const result = await getCompletionScript(command, shell, timeout);\n    if (result) return shell;\n  }\n  return null;\n}\n\n/**\n * Resolve 'completion' entries in the sources array by probing for the best available shell.\n * Other sources are passed through unchanged.\n */\nasync function resolveSources(\n  sources: DiscoverySource[],\n  command: string,\n  timeout: number,\n  log?: GeneratorLogger,\n): Promise<DiscoverySource[]> {\n  if (!sources.includes('completion')) return sources;\n\n  log?.info(`Probing ${command} for completion command...`);\n  const shell = await detectCompletionShell(command, timeout);\n\n  return sources.flatMap((s) => {\n    if (s !== 'completion') return s;\n    if (shell) {\n      log?.info(`  Found ${shell} completion support`);\n      return shell;\n    }\n    log?.info('  No completion command found, skipping');\n    return [];\n  });\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"mappings":"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"}

package/dist/codegen/file-emitter.d.mts

@@ -0,0 +1,10 @@
+import { FileEmitter, FileEmitterOptions } from "./types.mjs";
+
+//#region src/codegen/file-emitter.d.ts
+/**
+ * Create a FileEmitter for writing multiple generated files to disk.
+ */
+declare function createFileEmitter(options: FileEmitterOptions): FileEmitter;
+//#endregion
+export { createFileEmitter };
+//# sourceMappingURL=file-emitter.d.mts.map

package/dist/codegen/file-emitter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-emitter.d.mts","names":[],"sources":["../../src/codegen/file-emitter.ts"],"mappings":";;;;;AAsEA;iBAAgB,iBAAA,CAAkB,OAAA,EAAS,kBAAA,GAAqB,WAAW"}

package/dist/codegen/file-emitter.mjs

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+//#region src/codegen/file-emitter.ts
+var FileEmitterImpl = class {
+	files = [];
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	addFile(path, content) {
+		const text = typeof content === "string" ? content : content.text;
+		const fullContent = this.options.header ? `${this.options.header}\n\n${text}` : text;
+		this.files.push({
+			path,
+			content: fullContent
+		});
+	}
+	async emit() {
+		const result = {
+			written: [],
+			skipped: [],
+			errors: []
+		};
+		const outDir = resolve(this.options.outDir);
+		for (const file of this.files) {
+			const fullPath = join(outDir, file.path);
+			try {
+				if (existsSync(fullPath) && !this.options.overwrite) {
+					result.skipped.push(file.path);
+					continue;
+				}
+				if (this.options.dryRun) {
+					result.written.push(file.path);
+					continue;
+				}
+				mkdirSync(dirname(fullPath), { recursive: true });
+				writeFileSync(fullPath, file.content, "utf-8");
+				result.written.push(file.path);
+			} catch (err) {
+				result.errors.push({
+					file: file.path,
+					error: err instanceof Error ? err : new Error(String(err))
+				});
+			}
+		}
+		return result;
+	}
+};
+/**
+* Create a FileEmitter for writing multiple generated files to disk.
+*/
+function createFileEmitter(options) {
+	return new FileEmitterImpl(options);
+}
+//#endregion
+export { createFileEmitter };
+
+//# sourceMappingURL=file-emitter.mjs.map

package/dist/codegen/file-emitter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-emitter.mjs","names":[],"sources":["../../src/codegen/file-emitter.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport type { CodeBuildResult, EmitResult, FileEmitter, FileEmitterOptions } from './types.ts';\n\ninterface QueuedFile {\n  path: string;\n  content: string;\n}\n\nclass FileEmitterImpl implements FileEmitter {\n  private files: QueuedFile[] = [];\n  private options: FileEmitterOptions;\n\n  constructor(options: FileEmitterOptions) {\n    this.options = options;\n  }\n\n  addFile(path: string, content: string | CodeBuildResult): void {\n    const text = typeof content === 'string' ? content : content.text;\n    const fullContent = this.options.header ? `${this.options.header}\\n\\n${text}` : text;\n\n    this.files.push({ path, content: fullContent });\n  }\n\n  async emit(): Promise<EmitResult> {\n    const result: EmitResult = {\n      written: [],\n      skipped: [],\n      errors: [],\n    };\n\n    const outDir = resolve(this.options.outDir);\n\n    for (const file of this.files) {\n      const fullPath = join(outDir, file.path);\n\n      try {\n        // Check if file already exists\n        if (existsSync(fullPath) && !this.options.overwrite) {\n          result.skipped.push(file.path);\n          continue;\n        }\n\n        if (this.options.dryRun) {\n          result.written.push(file.path);\n          continue;\n        }\n\n        // Ensure directory exists\n        const dir = dirname(fullPath);\n        mkdirSync(dir, { recursive: true });\n\n        // Write the file\n        writeFileSync(fullPath, file.content, 'utf-8');\n        result.written.push(file.path);\n      } catch (err) {\n        result.errors.push({\n          file: file.path,\n          error: err instanceof Error ? err : new Error(String(err)),\n        });\n      }\n    }\n\n    return result;\n  }\n}\n\n/**\n * Create a FileEmitter for writing multiple generated files to disk.\n */\nexport function createFileEmitter(options: FileEmitterOptions): FileEmitter {\n  return new FileEmitterImpl(options);\n}\n"],"mappings":";;;AASA,IAAM,kBAAN,MAA6C;CAC3C,QAA8B,CAAC;CAC/B;CAEA,YAAY,SAA6B;EACvC,KAAK,UAAU;CACjB;CAEA,QAAQ,MAAc,SAAyC;EAC7D,MAAM,OAAO,OAAO,YAAY,WAAW,UAAU,QAAQ;EAC7D,MAAM,cAAc,KAAK,QAAQ,SAAS,GAAG,KAAK,QAAQ,OAAO,MAAM,SAAS;EAEhF,KAAK,MAAM,KAAK;GAAE;GAAM,SAAS;EAAY,CAAC;CAChD;CAEA,MAAM,OAA4B;EAChC,MAAM,SAAqB;GACzB,SAAS,CAAC;GACV,SAAS,CAAC;GACV,QAAQ,CAAC;EACX;EAEA,MAAM,SAAS,QAAQ,KAAK,QAAQ,MAAM;EAE1C,KAAK,MAAM,QAAQ,KAAK,OAAO;GAC7B,MAAM,WAAW,KAAK,QAAQ,KAAK,IAAI;GAEvC,IAAI;IAEF,IAAI,WAAW,QAAQ,KAAK,CAAC,KAAK,QAAQ,WAAW;KACnD,OAAO,QAAQ,KAAK,KAAK,IAAI;KAC7B;IACF;IAEA,IAAI,KAAK,QAAQ,QAAQ;KACvB,OAAO,QAAQ,KAAK,KAAK,IAAI;KAC7B;IACF;IAIA,UADY,QAAQ,QACR,GAAG,EAAE,WAAW,KAAK,CAAC;IAGlC,cAAc,UAAU,KAAK,SAAS,OAAO;IAC7C,OAAO,QAAQ,KAAK,KAAK,IAAI;GAC/B,SAAS,KAAK;IACZ,OAAO,OAAO,KAAK;KACjB,MAAM,KAAK;KACX,OAAO,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;IAC3D,CAAC;GACH;EACF;EAEA,OAAO;CACT;AACF;;;;AAKA,SAAgB,kBAAkB,SAA0C;CAC1E,OAAO,IAAI,gBAAgB,OAAO;AACpC"}

package/dist/codegen/generators/barrel-file.d.mts

@@ -0,0 +1,10 @@
+import { CodeBuilder, GeneratorContext } from "../types.mjs";
+
+//#region src/codegen/generators/barrel-file.d.ts
+/**
+ * Generate an index.ts barrel file that re-exports all given files.
+ */
+declare function generateBarrelFile(files: string[], ctx: GeneratorContext): CodeBuilder;
+//#endregion
+export { generateBarrelFile };
+//# sourceMappingURL=barrel-file.d.mts.map

package/dist/codegen/generators/barrel-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel-file.d.mts","names":[],"sources":["../../../src/codegen/generators/barrel-file.ts"],"mappings":";;;;;AAKA;iBAAgB,kBAAA,CAAmB,KAAA,YAAiB,GAAA,EAAK,gBAAA,GAAmB,WAAW"}

package/dist/codegen/generators/barrel-file.mjs

@@ -0,0 +1,16 @@
+//#region src/codegen/generators/barrel-file.ts
+/**
+* Generate an index.ts barrel file that re-exports all given files.
+*/
+function generateBarrelFile(files, ctx) {
+	const code = ctx.createCodeBuilder();
+	for (const file of files) {
+		const importPath = file.startsWith("./") ? file : `./${file}`;
+		code.line(`export * from '${importPath}'`);
+	}
+	return code;
+}
+//#endregion
+export { generateBarrelFile };
+
+//# sourceMappingURL=barrel-file.mjs.map

package/dist/codegen/generators/barrel-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel-file.mjs","names":[],"sources":["../../../src/codegen/generators/barrel-file.ts"],"sourcesContent":["import type { CodeBuilder, GeneratorContext } from '../types.ts';\n\n/**\n * Generate an index.ts barrel file that re-exports all given files.\n */\nexport function generateBarrelFile(files: string[], ctx: GeneratorContext): CodeBuilder {\n  const code = ctx.createCodeBuilder();\n\n  for (const file of files) {\n    // Strip .ts extension for the import path and ensure relative path\n    const importPath = file.startsWith('./') ? file : `./${file}`;\n    code.line(`export * from '${importPath}'`);\n  }\n\n  return code;\n}\n"],"mappings":";;;;AAKA,SAAgB,mBAAmB,OAAiB,KAAoC;CACtF,MAAM,OAAO,IAAI,kBAAkB;CAEnC,KAAK,MAAM,QAAQ,OAAO;EAExB,MAAM,aAAa,KAAK,WAAW,IAAI,IAAI,OAAO,KAAK;EACvD,KAAK,KAAK,kBAAkB,WAAW,EAAE;CAC3C;CAEA,OAAO;AACT"}