@skillit/cli 0.4.0

package/dist/help-parser.js

@@ -0,0 +1,314 @@
+/**
+ * Parse standard `--help` text output into an {@link ExtractedConfigSurface}.
+ *
+ * This is the framework-agnostic fallback used when runtime introspection of a
+ * commander/yargs program is not available.
+ *
+ * @param text        Raw text emitted by `program --help`
+ * @param commandName Canonical name for this surface (e.g. `"generate"`)
+ *
+ * @category Fallback
+ * @useWhen
+ * - Runtime introspection is unavailable (no access to the program object)
+ * - The CLI uses a framework other than Commander (yargs, oclif, custom)
+ */
+export function parseHelpOutput(text, commandName) {
+    if (!text.trim()) {
+        return {
+            name: commandName,
+            description: '',
+            sourceType: 'cli',
+            options: [],
+            arguments: []
+        };
+    }
+    const lines = text.split('\n');
+    let usageString;
+    let description = '';
+    let inOptionsBlock = false;
+    let inArgumentsBlock = false;
+    const options = [];
+    const args = [];
+    const argumentDescriptions = new Map();
+    // Track whether we have seen the first non-usage, non-blank line for
+    // the description. We stop collecting description lines once we hit an
+    // options block or another section header.
+    let descriptionCandidateIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i] ?? '';
+        const trimmed = raw.trim();
+        // -----------------------------------------------------------------------
+        // Usage line
+        // -----------------------------------------------------------------------
+        if (trimmed.startsWith('Usage:')) {
+            usageString = trimmed.slice('Usage:'.length).trim();
+            args.push(...parsePositionalArgs(usageString));
+            inOptionsBlock = false;
+            descriptionCandidateIndex = i + 1; // description may follow
+            continue;
+        }
+        // -----------------------------------------------------------------------
+        // Options block header
+        // -----------------------------------------------------------------------
+        if (/^Options\s*:/i.test(trimmed) || trimmed === 'Options') {
+            inOptionsBlock = true;
+            inArgumentsBlock = false;
+            continue;
+        }
+        if (/^Arguments\s*:/i.test(trimmed) || trimmed === 'Arguments') {
+            inOptionsBlock = false;
+            inArgumentsBlock = true;
+            continue;
+        }
+        // -----------------------------------------------------------------------
+        // Any other section header (Arguments:, Commands:, Examples:, …) ends
+        // the options block and description collection.
+        // -----------------------------------------------------------------------
+        if (/^[A-Z][A-Za-z ]+:/.test(trimmed) && !trimmed.startsWith('-')) {
+            inOptionsBlock = false;
+            inArgumentsBlock = false;
+            descriptionCandidateIndex = -1;
+            continue;
+        }
+        // -----------------------------------------------------------------------
+        // Description: first non-empty line after Usage that is not a section
+        // -----------------------------------------------------------------------
+        if (!inOptionsBlock &&
+            description === '' &&
+            descriptionCandidateIndex >= 0 &&
+            i === descriptionCandidateIndex &&
+            trimmed !== '' &&
+            !trimmed.startsWith('-')) {
+            description = trimmed;
+            continue;
+        }
+        // Advance the candidate index over blank lines between Usage and desc
+        if (!inOptionsBlock &&
+            description === '' &&
+            descriptionCandidateIndex >= 0 &&
+            i === descriptionCandidateIndex &&
+            trimmed === '') {
+            descriptionCandidateIndex++;
+            continue;
+        }
+        // -----------------------------------------------------------------------
+        // Option line inside Options block
+        // -----------------------------------------------------------------------
+        if (inOptionsBlock && trimmed.startsWith('-')) {
+            const opt = parseOptionLine(raw);
+            if (opt) {
+                options.push(opt);
+            }
+            continue;
+        }
+        if (inArgumentsBlock) {
+            const arg = parseArgumentLine(raw);
+            if (arg) {
+                argumentDescriptions.set(normalizeArgumentName(arg.name), arg.description);
+                if (!args.some((existing) => normalizeArgumentName(existing.name) === normalizeArgumentName(arg.name))) {
+                    args.push({
+                        name: arg.name,
+                        description: arg.description,
+                        required: arg.required,
+                        variadic: arg.variadic
+                    });
+                }
+            }
+        }
+    }
+    for (const arg of args) {
+        const descriptionForArg = argumentDescriptions.get(normalizeArgumentName(arg.name));
+        if (descriptionForArg) {
+            arg.description = descriptionForArg;
+        }
+    }
+    return {
+        name: commandName,
+        description,
+        sourceType: 'cli',
+        ...(usageString !== undefined ? { usage: usageString } : {}),
+        options,
+        arguments: args
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parse positional arguments from a usage string.
+ *
+ * Recognises:
+ *   `<required-arg>`   → required, non-variadic
+ *   `[optional-arg]`   → optional, non-variadic
+ *   `<arg...>` / `<...arg>` / `[arg...]` → variadic variants
+ *
+ * Flags (`-f` / `--flag`) and meta-tokens like `[options]` / `[command]` are
+ * ignored.
+ */
+function parsePositionalArgs(usage) {
+    const result = [];
+    // Match <name> or [name] tokens, capturing the inner text
+    const re = /(<([^>]+)>|\[([^\]]+)\])/g;
+    let match;
+    while ((match = re.exec(usage)) !== null) {
+        const full = match[0];
+        const inner = (match[2] ?? match[3] ?? '').trim();
+        // Skip meta-placeholders that aren't real positional args
+        if (/^options?$/i.test(inner) || /^commands?$/i.test(inner)) {
+            continue;
+        }
+        // Skip flag-like tokens (shouldn't appear here, but be defensive)
+        if (inner.startsWith('-')) {
+            continue;
+        }
+        const required = full.startsWith('<');
+        const variadic = inner.endsWith('...') || inner.startsWith('...');
+        const name = inner.replace(/\.{3}/g, '').trim();
+        result.push({
+            name,
+            description: '',
+            required,
+            variadic
+        });
+    }
+    return result;
+}
+/**
+ * Parse a single option line from a `--help` block.
+ *
+ * Handles formats:
+ *   `-c, --config <path>   Description text (required)`
+ *   `--dry-run              Preview mode (default: false)`
+ *   `    --verbose          Verbose output`
+ *
+ * Returns `null` if the line should be skipped (e.g. `-h, --help` or
+ * `--version`).
+ */
+function parseOptionLine(raw) {
+    const trimmed = raw.trim();
+    // -------------------------------------------------------------------------
+    // Extract flags portion vs description portion.
+    //
+    // Flags appear at the start; description follows after ≥2 spaces (or a tab).
+    // We split on the first run of 2+ spaces after the flags/arg portion.
+    // -------------------------------------------------------------------------
+    // 1. Strip leading whitespace
+    // 2. Match the flags+arg group: everything up to 2+ spaces or tab
+    const flagsAndRest = trimmed.match(/^(-[^\s].*?)(?:\s{2,}|\t)(.*)$/) ?? null;
+    let flagsPart;
+    let descPart;
+    if (flagsAndRest) {
+        flagsPart = (flagsAndRest[1] ?? '').trim();
+        descPart = (flagsAndRest[2] ?? '').trim();
+    }
+    else {
+        // No description separator found — the whole trimmed line is the flags
+        flagsPart = trimmed;
+        descPart = '';
+    }
+    // -------------------------------------------------------------------------
+    // Parse flags: optional short flag, long flag, optional argument
+    //   -c, --config <path>
+    //   --dry-run
+    //   -o, --out <dir>
+    // -------------------------------------------------------------------------
+    let cliShort;
+    let cliFlag;
+    let argName; // <arg> after the flag
+    // Match short flag
+    const shortMatch = flagsPart.match(/^(-[a-zA-Z]),?\s*/);
+    if (shortMatch) {
+        cliShort = shortMatch[1];
+        flagsPart = flagsPart.slice(shortMatch[0].length);
+    }
+    // Match long flag with optional required/optional value:
+    //   --config <path>
+    //   --config [path]
+    const longMatch = flagsPart.match(/^(--[a-zA-Z][\w-]*)(?:\s+(?:<([^>]+)>|\[([^\]]+)\]))?/);
+    if (!longMatch) {
+        // No long flag found — not a valid option line
+        return null;
+    }
+    cliFlag = longMatch[1];
+    argName = longMatch[2] ?? longMatch[3]; // undefined when flag is boolean
+    // -------------------------------------------------------------------------
+    // Skip internal / noise flags
+    // -------------------------------------------------------------------------
+    if (cliFlag === '--help' || cliFlag === '--version') {
+        return null;
+    }
+    if (cliShort === '-h' || cliShort === '-V') {
+        return null;
+    }
+    // -------------------------------------------------------------------------
+    // Extract default value from description: (default: value)
+    // -------------------------------------------------------------------------
+    let defaultValue;
+    const defaultMatch = descPart.match(/\(default:\s*([^)]+)\)/i);
+    if (defaultMatch) {
+        defaultValue = defaultMatch[1]?.trim();
+        descPart = descPart.replace(defaultMatch[0], '').trim();
+    }
+    // -------------------------------------------------------------------------
+    // Detect required flag from description: (required)
+    // -------------------------------------------------------------------------
+    let required = false;
+    const requiredMatch = descPart.match(/\(required\)/i);
+    if (requiredMatch) {
+        required = true;
+        descPart = descPart.replace(requiredMatch[0], '').trim();
+    }
+    // Clean up any trailing punctuation left after stripping annotations
+    descPart = descPart.replace(/\s+$/, '');
+    // -------------------------------------------------------------------------
+    // Infer type: boolean when no <arg>, string otherwise
+    // -------------------------------------------------------------------------
+    const type = argName ? 'string' : 'boolean';
+    // -------------------------------------------------------------------------
+    // Derive canonical name from long flag (strip leading --)
+    // -------------------------------------------------------------------------
+    const name = cliFlag ? cliFlag.replace(/^--/, '') : '';
+    const option = {
+        name,
+        cliFlag,
+        type,
+        description: descPart,
+        required
+    };
+    if (cliShort !== undefined) {
+        option.cliShort = cliShort;
+    }
+    if (defaultValue !== undefined) {
+        option.defaultValue = defaultValue;
+    }
+    return option;
+}
+function parseArgumentLine(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0 || trimmed.startsWith('-')) {
+        return null;
+    }
+    const match = trimmed.match(/^([<[.\]>\w-]+)\s{2,}(.*)$/);
+    if (!match) {
+        return null;
+    }
+    const token = (match[1] ?? '').trim();
+    const name = normalizeArgumentName(token);
+    const description = (match[2] ?? '').trim();
+    if (name.length === 0) {
+        return null;
+    }
+    return {
+        name,
+        description,
+        required: token.startsWith('<'),
+        variadic: token.includes('...')
+    };
+}
+function normalizeArgumentName(name) {
+    return name
+        .replace(/[<>[\]]/g, '')
+        .replace(/\.{3}/g, '')
+        .trim();
+}
+//# sourceMappingURL=help-parser.js.map

package/dist/help-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-parser.js","sourceRoot":"","sources":["../src/help-parser.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CLI extraction for commander/yargs programs.
+ *
+ * Provides a three-phase pipeline for extracting structured skill data from CLI tools:
+ * 1. **Introspect** — walk a Commander program tree to extract commands, options, and arguments
+ * 2. **Parse** — fallback: parse `--help` text output when runtime introspection is unavailable
+ * 3. **Correlate** — merge JSDoc metadata from typed config interfaces into CLI option metadata
+ *
+ * The result is an `ExtractedSkill` that can be rendered by `@skillit/core`.
+ *
+ * @remarks
+ * Commander introspection is preferred over help-text parsing because it captures
+ * default values, variadic arguments, and required/optional distinctions precisely.
+ * Help-text parsing is a best-effort fallback with known limitations around multi-line
+ * descriptions and non-standard help formatting.
+ *
+ * @packageDocumentation
+ */
+export { introspectCommander } from './introspect-commander.js';
+export { parseHelpOutput } from './help-parser.js';
+export { correlateFlags } from './correlator.js';
+export { runCliAudit } from './audit.js';
+export { extractCliSkill, writeCliSkill } from './extract.js';
+export type { CliExtractionOptions, CliWriteOptions } from './extract.js';
+export type { CliAuditIssue } from './audit.js';
+export { loadProgram } from './program-loader.js';
+export type { LoadProgramOptions } from './program-loader.js';
+export { readOptionsTags } from './options-jsdoc.js';
+export { CliRefineSource } from './refine-source.js';
+export type { CliRefineSourceOptions } from './refine-source.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * CLI extraction for commander/yargs programs.
+ *
+ * Provides a three-phase pipeline for extracting structured skill data from CLI tools:
+ * 1. **Introspect** — walk a Commander program tree to extract commands, options, and arguments
+ * 2. **Parse** — fallback: parse `--help` text output when runtime introspection is unavailable
+ * 3. **Correlate** — merge JSDoc metadata from typed config interfaces into CLI option metadata
+ *
+ * The result is an `ExtractedSkill` that can be rendered by `@skillit/core`.
+ *
+ * @remarks
+ * Commander introspection is preferred over help-text parsing because it captures
+ * default values, variadic arguments, and required/optional distinctions precisely.
+ * Help-text parsing is a best-effort fallback with known limitations around multi-line
+ * descriptions and non-standard help formatting.
+ *
+ * @packageDocumentation
+ */
+export { introspectCommander } from './introspect-commander.js';
+export { parseHelpOutput } from './help-parser.js';
+export { correlateFlags } from './correlator.js';
+export { runCliAudit } from './audit.js';
+export { extractCliSkill, writeCliSkill } from './extract.js';
+export { loadProgram } from './program-loader.js';
+export { readOptionsTags } from './options-jsdoc.js';
+export { CliRefineSource } from './refine-source.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/introspect-commander.d.ts

@@ -0,0 +1,18 @@
+import type { ExtractedConfigSurface } from '@skillit/core';
+/**
+ * Introspects a commander Program object and extracts all top-level command
+ * definitions as ExtractedConfigSurface[].
+ *
+ * @param program - A commander `Command` instance (typed as `any` to avoid
+ *   a hard dependency on the commander package at the call site).
+ * @returns An array of extracted config surfaces, one per top-level command.
+ *   Returns an empty array if the program has no subcommands.
+ *
+ * @category Commander
+ * @useWhen
+ * - You have a Commander program and want structured option/argument extraction with full fidelity
+ * @avoidWhen
+ * - Your CLI uses yargs, oclif, or another framework — use parseHelpOutput as a fallback instead
+ */
+export declare function introspectCommander(program: any): ExtractedConfigSurface[];
+//# sourceMappingURL=introspect-commander.d.ts.map

package/dist/introspect-commander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect-commander.d.ts","sourceRoot":"","sources":["../src/introspect-commander.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,eAAe,CAAC;AA8FvB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,sBAAsB,EAAE,CAI1E"}

package/dist/introspect-commander.js

@@ -0,0 +1,96 @@
+/**
+ * Converts a kebab-case string to camelCase.
+ * e.g. "output-dir" → "outputDir"
+ */
+function kebabToCamelCase(str) {
+    return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
+/**
+ * Infers the type of a CLI option from its flags string.
+ * If the flags contain `<` or `[`, it accepts a value → 'string'.
+ * Otherwise it is a boolean toggle.
+ */
+function inferType(flags) {
+    return flags.includes('<') || flags.includes('[') ? 'string' : 'boolean';
+}
+/**
+ * Extracts a single commander Command into an ExtractedConfigSurface.
+ */
+function extractCommand(cmd, parentName) {
+    const name = cmd.name?.() ?? '';
+    const fullName = parentName ? `${parentName} ${name}` : name;
+    const options = (cmd.options ?? []).map((opt) => {
+        const longFlag = opt.long ?? '';
+        const canonicalName = kebabToCamelCase(longFlag.replace(/^--/, ''));
+        const result = {
+            name: canonicalName,
+            cliFlag: longFlag || undefined,
+            cliShort: opt.short ?? undefined,
+            type: inferType(opt.flags ?? ''),
+            description: opt.description ?? '',
+            // commander's `opt.required` only describes the VALUE syntax: it is true for
+            // `--flag <x>` (value required when the flag is present) and false for
+            // `--flag [x]` (value optional). It says nothing about whether the option
+            // itself must be supplied — that is `opt.mandatory`, set only by
+            // `.requiredOption()`. Use mandatory so optional `--flag <value>` opts are
+            // not mismarked as required.
+            required: !!opt.mandatory
+        };
+        if (opt.defaultValue !== undefined) {
+            result.defaultValue = String(opt.defaultValue);
+        }
+        if (opt.envVar) {
+            result.envVar = opt.envVar;
+        }
+        return result;
+    });
+    const args = (cmd.registeredArguments ?? []).map((arg) => {
+        const result = {
+            name: arg.name?.() ?? '',
+            description: arg.description ?? '',
+            required: !!arg.required,
+            variadic: !!arg.variadic
+        };
+        if (arg.defaultValue !== undefined) {
+            result.defaultValue = String(arg.defaultValue);
+        }
+        return result;
+    });
+    const subcommands = (cmd.commands ?? []).map((sub) => extractCommand(sub, fullName));
+    const surface = {
+        name,
+        description: cmd.description?.() ?? '',
+        sourceType: 'cli',
+        usage: cmd.usage?.() ?? undefined,
+        options
+    };
+    if (args.length > 0) {
+        surface.arguments = args;
+    }
+    if (subcommands.length > 0) {
+        surface.subcommands = subcommands;
+    }
+    return surface;
+}
+/**
+ * Introspects a commander Program object and extracts all top-level command
+ * definitions as ExtractedConfigSurface[].
+ *
+ * @param program - A commander `Command` instance (typed as `any` to avoid
+ *   a hard dependency on the commander package at the call site).
+ * @returns An array of extracted config surfaces, one per top-level command.
+ *   Returns an empty array if the program has no subcommands.
+ *
+ * @category Commander
+ * @useWhen
+ * - You have a Commander program and want structured option/argument extraction with full fidelity
+ * @avoidWhen
+ * - Your CLI uses yargs, oclif, or another framework — use parseHelpOutput as a fallback instead
+ */
+export function introspectCommander(program) {
+    const commands = program.commands ?? [];
+    if (commands.length === 0)
+        return [];
+    return commands.map((cmd) => extractCommand(cmd, program.name?.() ?? ''));
+}
+//# sourceMappingURL=introspect-commander.js.map

package/dist/introspect-commander.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect-commander.js","sourceRoot":"","sources":["../src/introspect-commander.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,GAAQ,EAAE,UAAkB;IAClD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7D,MAAM,OAAO,GAA4B,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE;QAC5E,MAAM,QAAQ,GAAW,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAEpE,MAAM,MAAM,GAA0B;YACpC,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,QAAQ,IAAI,SAAS;YAC9B,QAAQ,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;YAChC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;YAClC,6EAA6E;YAC7E,uEAAuE;YACvE,0EAA0E;YAC1E,iEAAiE;YACjE,2EAA2E;YAC3E,6BAA6B;YAC7B,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS;SAC1B,CAAC;QAEF,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC7B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAA8B,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE;QACvF,MAAM,MAAM,GAA4B;YACtC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE;YACxB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;YAClC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ;YACxB,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ;SACzB,CAAC;QAEF,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAA6B,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAClF,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAC9B,CAAC;IAEF,MAAM,OAAO,GAA2B;QACtC,IAAI;QACJ,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE;QACtC,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,SAAS;QACjC,OAAO;KACR,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAY;IAC9C,MAAM,QAAQ,GAAU,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/options-jsdoc.d.ts

@@ -0,0 +1,10 @@
+import { type RefineTag } from '@skillit/core';
+/**
+ * Reads routing tags (`@useWhen`/`@avoidWhen`/`@pitfalls`/`@remarks`/`@example`)
+ * from the JSDoc attached to a `<Command>Options` interface.
+ *
+ * Thin wrapper over core's {@link readJsDocTags} that keeps the CLI package's
+ * call-site intent explicit and provides a seam for CLI-specific behavior.
+ */
+export declare function readOptionsTags(interfaceName: string, source: string): Partial<Record<RefineTag, string>>;
+//# sourceMappingURL=options-jsdoc.d.ts.map

package/dist/options-jsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-jsdoc.d.ts","sourceRoot":"","sources":["../src/options-jsdoc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAEpC"}

package/dist/options-jsdoc.js

@@ -0,0 +1,12 @@
+import { readJsDocTags } from '@skillit/core';
+/**
+ * Reads routing tags (`@useWhen`/`@avoidWhen`/`@pitfalls`/`@remarks`/`@example`)
+ * from the JSDoc attached to a `<Command>Options` interface.
+ *
+ * Thin wrapper over core's {@link readJsDocTags} that keeps the CLI package's
+ * call-site intent explicit and provides a seam for CLI-specific behavior.
+ */
+export function readOptionsTags(interfaceName, source) {
+    return readJsDocTags(source, interfaceName);
+}
+//# sourceMappingURL=options-jsdoc.js.map

package/dist/options-jsdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-jsdoc.js","sourceRoot":"","sources":["../src/options-jsdoc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,eAAe,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,MAAc;IAEd,OAAO,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC"}

package/dist/program-loader.d.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+export interface LoadProgramOptions {
+    /** Explicit `file#export` reference to a Command or zero-arg factory. */
+    program?: string;
+    /** Directory to resolve relative paths and `package.json` against. */
+    cwd: string;
+}
+/**
+ * Loads a commander program for refinement.
+ *
+ * When `opts.program` is provided as `file#export`, the file is resolved
+ * against `cwd`, imported, and the named export is used (a `Command` or a
+ * zero-arg factory). Otherwise the program is auto-discovered from the
+ * consumer's `package.json` `bin` entry, probing the exports `buildProgram`,
+ * `createProgram`, `program`, then `default`.
+ *
+ * @throws Error advising `--program <file#export>` when no program can be loaded.
+ */
+export declare function loadProgram(opts: LoadProgramOptions): Promise<Command>;
+//# sourceMappingURL=program-loader.d.ts.map

package/dist/program-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-loader.d.ts","sourceRoot":"","sources":["../src/program-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;CACb;AAkCD;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuD5E"}