@to-skills/cli 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Pradeep Mouli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @to-skills/cli
+
+> Extract CLI command structure from commander/yargs for AI agent skill generation.
+
+Part of the [to-skills](https://github.com/pradeepmouli/to-skills) ecosystem.
+
+## Features
+
+- **Commander introspection** — enumerate commands, options, arguments from a Program object
+- **`--help` fallback** — parse standard help text for any CLI framework
+- **Flag-to-property correlation** — merge JSDoc tags from typed options interfaces into CLI metadata
+- **Token-budgeted output** — generated skills fit LLM context windows
+
+## Install
+
+```bash
+pnpm add -D @to-skills/cli
+```
+
+## Usage
+
+```typescript
+import { extractCliSkill } from '@to-skills/cli';
+import { renderSkill } from '@to-skills/core';
+
+const skill = await extractCliSkill({
+  program, // commander Program object
+  metadata: { name: 'my-tool', keywords: ['build', 'deploy'] }
+});
+
+const rendered = renderSkill(skill);
+```
+
+## License
+
+MIT

package/dist/correlator.d.ts

@@ -0,0 +1,16 @@
+import type { ExtractedConfigSurface } from '@to-skills/core';
+/**
+ * Merges JSDoc tag metadata from a typed config interface surface into CLI
+ * option metadata extracted from commander/--help output.
+ *
+ * The CLI surface is treated as authoritative for structural fields (flags,
+ * description, required, defaultValue). The config surface contributes rich
+ * JSDoc metadata (remarks, useWhen, avoidWhen, pitfalls, category) that the
+ * CLI help text does not capture.
+ *
+ * @param cliSurface   - The surface extracted from CLI introspection/help parsing
+ * @param configSurface - The surface extracted from a typed config interface (optional)
+ * @returns A new ExtractedConfigSurface combining both sources
+ */
+export declare function correlateFlags(cliSurface: ExtractedConfigSurface, configSurface: ExtractedConfigSurface | undefined): ExtractedConfigSurface;
+//# sourceMappingURL=correlator.d.ts.map

package/dist/correlator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlator.d.ts","sourceRoot":"","sources":["../src/correlator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAyB,MAAM,iBAAiB,CAAC;AAErF;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,sBAAsB,EAClC,aAAa,EAAE,sBAAsB,GAAG,SAAS,GAChD,sBAAsB,CAqCxB"}

package/dist/correlator.js

@@ -0,0 +1,50 @@
+/**
+ * Merges JSDoc tag metadata from a typed config interface surface into CLI
+ * option metadata extracted from commander/--help output.
+ *
+ * The CLI surface is treated as authoritative for structural fields (flags,
+ * description, required, defaultValue). The config surface contributes rich
+ * JSDoc metadata (remarks, useWhen, avoidWhen, pitfalls, category) that the
+ * CLI help text does not capture.
+ *
+ * @param cliSurface   - The surface extracted from CLI introspection/help parsing
+ * @param configSurface - The surface extracted from a typed config interface (optional)
+ * @returns A new ExtractedConfigSurface combining both sources
+ */
+export function correlateFlags(cliSurface, configSurface) {
+    if (!configSurface)
+        return cliSurface;
+    // Build lookup: lowercase property name → config option
+    const configLookup = new Map();
+    for (const opt of configSurface.options) {
+        configLookup.set(opt.name.toLowerCase(), opt);
+    }
+    // Merge each CLI option with matching config property
+    const mergedOptions = cliSurface.options.map((cliOpt) => {
+        const configOpt = configLookup.get(cliOpt.name.toLowerCase());
+        if (!configOpt)
+            return cliOpt;
+        return {
+            // CLI is authoritative for structural/presentation fields
+            ...cliOpt,
+            // Use config description as fallback when CLI description is empty
+            description: cliOpt.description || configOpt.description,
+            // Config provides JSDoc-enriched metadata
+            remarks: cliOpt.remarks ?? configOpt.remarks,
+            useWhen: cliOpt.useWhen ?? configOpt.useWhen,
+            avoidWhen: cliOpt.avoidWhen ?? configOpt.avoidWhen,
+            pitfalls: cliOpt.pitfalls ?? configOpt.pitfalls,
+            category: cliOpt.category ?? configOpt.category,
+        };
+    });
+    // Merge command-level tags from config surface into CLI surface
+    return {
+        ...cliSurface,
+        options: mergedOptions,
+        useWhen: cliSurface.useWhen ?? configSurface.useWhen,
+        avoidWhen: cliSurface.avoidWhen ?? configSurface.avoidWhen,
+        pitfalls: cliSurface.pitfalls ?? configSurface.pitfalls,
+        remarks: cliSurface.remarks ?? configSurface.remarks,
+    };
+}
+//# sourceMappingURL=correlator.js.map

package/dist/correlator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlator.js","sourceRoot":"","sources":["../src/correlator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAkC,EAClC,aAAiD;IAEjD,IAAI,CAAC,aAAa;QAAE,OAAO,UAAU,CAAC;IAEtC,wDAAwD;IACxD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC9D,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;QACxC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IAED,sDAAsD;IACtD,MAAM,aAAa,GAA4B,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/E,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QAE9B,OAAO;YACL,0DAA0D;YAC1D,GAAG,MAAM;YACT,mEAAmE;YACnE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW;YACxD,0CAA0C;YAC1C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO;YAC5C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO;YAC5C,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS;YAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ;YAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ;SAChD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,gEAAgE;IAChE,OAAO;QACL,GAAG,UAAU;QACb,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;QACpD,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS;QAC1D,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;QACvD,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;KACrD,CAAC;AACJ,CAAC"}

package/dist/extract.d.ts

@@ -0,0 +1,19 @@
+import type { ExtractedSkill, ExtractedConfigSurface } from '@to-skills/core';
+export interface CliExtractionOptions {
+    /** Commander program object (preferred) */
+    program?: any;
+    /** Help text per command (fallback) */
+    helpTexts?: Record<string, string>;
+    /** Package metadata */
+    metadata?: {
+        name?: string;
+        description?: string;
+        keywords?: string[];
+        repository?: string;
+        author?: string;
+    };
+    /** Config surfaces from TypeDoc for JSDoc correlation */
+    configSurfaces?: ExtractedConfigSurface[];
+}
+export declare function extractCliSkill(options: CliExtractionOptions): Promise<ExtractedSkill>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAK9E,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,uBAAuB;IACvB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,yDAAyD;IACzD,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC3C;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiE5F"}

package/dist/extract.js

@@ -0,0 +1,58 @@
+import { introspectCommander } from './introspect-commander.js';
+import { parseHelpOutput } from './help-parser.js';
+import { correlateFlags } from './correlator.js';
+export async function extractCliSkill(options) {
+    const { program, helpTexts, metadata = {}, configSurfaces = [] } = options;
+    // Phase 1: Extract command structure (introspection or help)
+    let cliSurfaces = [];
+    if (program !== undefined) {
+        cliSurfaces = introspectCommander(program);
+    }
+    else if (helpTexts !== undefined) {
+        cliSurfaces = Object.entries(helpTexts).map(([commandName, text]) => parseHelpOutput(text, commandName));
+    }
+    // Phase 2: Correlate with typed interfaces
+    // Build lookup from config surfaces by their name (case-insensitive)
+    const configSurfaceLookup = new Map();
+    for (const surface of configSurfaces) {
+        configSurfaceLookup.set(surface.name.toLowerCase(), surface);
+    }
+    // For each CLI surface, find a matching config surface by convention:
+    // command "generate" → look for "GenerateOptions" or "generateoptions" (case-insensitive)
+    const correlatedCliSurfaces = cliSurfaces.map((cliSurface) => {
+        const commandNameLower = cliSurface.name.toLowerCase();
+        // Try exact name match first
+        let matchingConfig = configSurfaceLookup.get(commandNameLower);
+        // If not found, try "<commandName>options" convention
+        if (!matchingConfig) {
+            matchingConfig = configSurfaceLookup.get(`${commandNameLower}options`);
+        }
+        // Phase 3: Call correlateFlags to merge JSDoc
+        return correlateFlags(cliSurface, matchingConfig);
+    });
+    // Collect non-CLI config surfaces (sourceType === 'config') from configSurfaces
+    const nonCliConfigSurfaces = configSurfaces.filter((s) => s.sourceType !== 'cli');
+    // Build the final configSurfaces array: correlated CLI surfaces + non-CLI config surfaces
+    const allConfigSurfaces = [
+        ...correlatedCliSurfaces,
+        ...nonCliConfigSurfaces
+    ];
+    // Phase 3: Build ExtractedSkill with empty functions/classes/types/enums/variables
+    // but populated configSurfaces
+    const skill = {
+        name: metadata.name ?? '',
+        description: metadata.description ?? '',
+        keywords: metadata.keywords,
+        repository: metadata.repository,
+        author: metadata.author,
+        functions: [],
+        classes: [],
+        types: [],
+        enums: [],
+        variables: [],
+        examples: [],
+        ...(allConfigSurfaces.length > 0 ? { configSurfaces: allConfigSurfaces } : {})
+    };
+    return skill;
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAmBjD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA6B;IACjE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,GAAG,EAAE,EAAE,cAAc,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE3E,6DAA6D;IAC7D,IAAI,WAAW,GAA6B,EAAE,CAAC;IAE/C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;SAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE,CAClE,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CACnC,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,qEAAqE;IACrE,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkC,CAAC;IACtE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,sEAAsE;IACtE,0FAA0F;IAC1F,MAAM,qBAAqB,GAA6B,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACrF,MAAM,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAEvD,6BAA6B;QAC7B,IAAI,cAAc,GAAG,mBAAmB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAE/D,sDAAsD;QACtD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,cAAc,GAAG,mBAAmB,CAAC,GAAG,CAAC,GAAG,gBAAgB,SAAS,CAAC,CAAC;QACzE,CAAC;QAED,8CAA8C;QAC9C,OAAO,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,gFAAgF;IAChF,MAAM,oBAAoB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC;IAElF,0FAA0F;IAC1F,MAAM,iBAAiB,GAA6B;QAClD,GAAG,qBAAqB;QACxB,GAAG,oBAAoB;KACxB,CAAC;IAEF,mFAAmF;IACnF,+BAA+B;IAC/B,MAAM,KAAK,GAAmB;QAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;QACzB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,GAAG,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/E,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/help-parser.d.ts

@@ -0,0 +1,12 @@
+import type { ExtractedConfigSurface } from '@to-skills/core';
+/**
+ * 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"`)
+ */
+export declare function parseHelpOutput(text: string, commandName: string): ExtractedConfigSurface;
+//# sourceMappingURL=help-parser.d.ts.map

package/dist/help-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-parser.d.ts","sourceRoot":"","sources":["../src/help-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EAGvB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAwGzF"}

package/dist/help-parser.js

@@ -0,0 +1,249 @@
+/**
+ * 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"`)
+ */
+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;
+    const options = [];
+    const args = [];
+    // 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;
+            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;
+            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);
+            }
+        }
+    }
+    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 argument)
+    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]; // 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;
+}
+//# 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,6 @@
+export { introspectCommander } from './introspect-commander.js';
+export { parseHelpOutput } from './help-parser.js';
+export { correlateFlags } from './correlator.js';
+export { extractCliSkill } from './extract.js';
+export type { CliExtractionOptions } from './extract.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":"AACA,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,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// CLI extraction for commander/yargs programs
+export { introspectCommander } from './introspect-commander.js';
+export { parseHelpOutput } from './help-parser.js';
+export { correlateFlags } from './correlator.js';
+export { extractCliSkill } from './extract.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,8CAA8C;AAC9C,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,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/introspect-commander.d.ts

@@ -0,0 +1,12 @@
+import type { ExtractedConfigSurface } from '@to-skills/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.
+ */
+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,iBAAiB,CAAC;AAwFzB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,sBAAsB,EAAE,CAI1E"}

package/dist/introspect-commander.js

@@ -0,0 +1,84 @@
+/**
+ * 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 ?? '',
+            required: !!(opt.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.
+ */
+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":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@to-skills/cli",
+  "version": "0.2.1",
+  "description": "Extract CLI command structure from commander/yargs for AI agent skill generation",
+  "keywords": [
+    "agent-skills",
+    "cli",
+    "commander",
+    "documentation",
+    "skill-generation",
+    "yargs"
+  ],
+  "license": "MIT",
+  "author": "Pradeep Mouli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pradeepmouli/to-skills.git",
+    "directory": "packages/cli"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/pradeepmouli"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@to-skills/core": "0.10.0"
+  },
+  "devDependencies": {
+    "commander": "^14.0.0"
+  },
+  "peerDependencies": {
+    "commander": ">=12.0.0"
+  },
+  "peerDependenciesMeta": {
+    "commander": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsgo -p tsconfig.build.json",
+    "type-check": "tsgo --noEmit"
+  }
+}