@cairn-tool/cairn 2.0.0

package/dist/commands/check-snippets.js.map

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

package/dist/commands/check-urls.d.ts

@@ -0,0 +1,52 @@
+import { type RawUrlResult } from "../url-cache.js";
+interface CheckUrlsOptions {
+    envelope?: boolean;
+    format: string;
+    timeout: string;
+    concurrency: string;
+    retry: string;
+    includeOk: boolean;
+    include: string[];
+    exclude: string[];
+    stdinName?: string;
+    changedSince?: string;
+    ignore: string[];
+    ignoreDomain: string[];
+    allowedStatus: Array<string | number>;
+    cache: boolean;
+    cacheTtl: string | number;
+    headFallbackStatus: Array<string | number>;
+    reportRedirects: boolean;
+}
+export interface UrlResult {
+    file: string;
+    line: number;
+    url: string;
+    status: number | null;
+    ok: boolean;
+    error?: string;
+    redirected?: boolean;
+    finalUrl?: string;
+}
+export interface UrlOccurrence {
+    file: string;
+    line: number;
+    url: string;
+}
+export interface UrlCheckOptions {
+    timeout: number;
+    concurrency: number;
+    retries: number;
+    allowedStatuses?: readonly number[];
+    headFallbackStatuses?: readonly number[];
+    cache?: boolean;
+    cacheTtl?: number;
+    cachePath?: string;
+}
+export declare function checkUrlRaw(url: string, timeout: number, retries: number, headFallbackStatuses?: readonly number[]): Promise<RawUrlResult>;
+export declare function checkUrl(url: string, timeout: number, retries: number, allowedStatuses?: readonly number[], headFallbackStatuses?: readonly number[]): Promise<RawUrlResult & {
+    ok: boolean;
+}>;
+export declare function checkUrlOccurrences(occurrences: UrlOccurrence[], options: UrlCheckOptions): Promise<UrlResult[]>;
+export declare function checkUrlsAction(inputs: string | string[], opts: CheckUrlsOptions): Promise<void>;
+export {};

package/dist/commands/check-urls.js

@@ -0,0 +1,205 @@
+import { minimatch } from "minimatch";
+import { formatSarif } from "../automation.js";
+import { resolveMarkdownInputs } from "../input-selection.js";
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { jsonPayload } from "../result.js";
+import { getUrlCachePath, readUrlCache, urlCacheKey, writeUrlCache, } from "../url-cache.js";
+function format(opts) {
+    return ["llm", "human", "json", "jsonl", "sarif"].includes(opts.format)
+        ? opts.format
+        : "llm";
+}
+function statusCodes(values, fallback) {
+    if (!values.length)
+        return [...fallback];
+    const parsed = values.map(Number);
+    if (parsed.some((value) => !Number.isInteger(value) || value < 100 || value > 599)) {
+        throw new Error("HTTP statuses must be integers from 100 to 599");
+    }
+    return parsed;
+}
+export async function checkUrlRaw(url, timeout, retries, headFallbackStatuses = [400, 403, 405, 501]) {
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            let response = await fetch(url, {
+                method: "HEAD",
+                signal: AbortSignal.timeout(timeout),
+                redirect: "follow",
+            });
+            if (headFallbackStatuses.includes(response.status)) {
+                response = await fetch(url, {
+                    method: "GET",
+                    signal: AbortSignal.timeout(timeout),
+                    redirect: "follow",
+                });
+            }
+            if (response.status === 429 && attempt < retries)
+                continue;
+            const finalUrl = response.url || url;
+            return {
+                status: response.status,
+                redirected: response.redirected || finalUrl !== url,
+                finalUrl,
+            };
+        }
+        catch (error) {
+            if (attempt < retries)
+                continue;
+            return {
+                status: null,
+                error: error instanceof Error
+                    ? (error.code ?? error.message)
+                    : String(error),
+                redirected: false,
+                finalUrl: url,
+            };
+        }
+    }
+    return { status: null, error: "Max retries exceeded", redirected: false, finalUrl: url };
+}
+export async function checkUrl(url, timeout, retries, allowedStatuses = [], headFallbackStatuses = [400, 403, 405, 501]) {
+    const result = await checkUrlRaw(url, timeout, retries, headFallbackStatuses);
+    return {
+        ...result,
+        ok: result.status !== null &&
+            ((result.status >= 200 && result.status < 400) || allowedStatuses.includes(result.status)),
+    };
+}
+async function concurrent(items, limit, fn) {
+    let next = 0;
+    const worker = async () => {
+        while (next < items.length)
+            await fn(items[next++]);
+    };
+    await Promise.all(Array.from({ length: Math.min(Math.max(1, limit), items.length) }, worker));
+}
+export async function checkUrlOccurrences(occurrences, options) {
+    const allowed = options.allowedStatuses ?? runtime().config.urls.allowedStatuses;
+    const fallback = options.headFallbackStatuses ?? runtime().config.urls.headFallbackStatuses;
+    const cacheEnabled = options.cache ?? runtime().config.urls.cache;
+    const ttl = options.cacheTtl ?? runtime().config.urls.cacheTtl;
+    const cachePath = options.cachePath ?? getUrlCachePath();
+    const unique = [...new Set(occurrences.map((item) => item.url))].sort();
+    const checked = new Map();
+    await concurrent(unique, options.concurrency, async (url) => {
+        const key = urlCacheKey(url, {
+            timeout: options.timeout,
+            retries: options.retries,
+            headFallbackStatuses: fallback,
+        });
+        const cached = cacheEnabled ? readUrlCache(cachePath, key, ttl) : undefined;
+        if (cached) {
+            checked.set(url, cached);
+            return;
+        }
+        const result = await checkUrlRaw(url, options.timeout, options.retries, fallback);
+        checked.set(url, result);
+        if (cacheEnabled)
+            writeUrlCache(cachePath, key, result);
+    });
+    return occurrences.map((occurrence) => {
+        const raw = checked.get(occurrence.url);
+        return {
+            ...occurrence,
+            ...raw,
+            ok: raw.status !== null &&
+                ((raw.status >= 200 && raw.status < 400) || allowed.includes(raw.status)),
+        };
+    });
+}
+function ignoredDomain(url, domains) {
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        return domains.some((value) => {
+            const domain = value.toLowerCase().replace(/^\*\./, "");
+            return host === domain || host.endsWith(`.${domain}`);
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export async function checkUrlsAction(inputs, opts) {
+    const files = resolveMarkdownInputs(Array.isArray(inputs) ? inputs : [inputs], {
+        ...opts,
+        requireStdinName: true,
+    });
+    const configured = runtime().config.urls;
+    const parsedCacheTtl = Number(opts.cacheTtl);
+    if (!Number.isInteger(parsedCacheTtl) || parsedCacheTtl < 0) {
+        throw new Error("--cache-ttl must be a non-negative integer");
+    }
+    const occurrences = files.flatMap((file) => runtime()
+        .workspace.document(file)
+        .references.filter((ref) => ref.isExternal && /^https?:/i.test(ref.target))
+        .filter((ref) => !opts.ignore.some((pattern) => minimatch(ref.target, pattern, { nonegate: true })))
+        .filter((ref) => !ignoredDomain(ref.target, opts.ignoreDomain))
+        .map((ref) => ({ file, line: ref.line, url: ref.target })));
+    const results = await checkUrlOccurrences(occurrences, {
+        timeout: Math.max(1, parseInt(opts.timeout, 10) || 5000),
+        concurrency: Math.max(1, parseInt(opts.concurrency, 10) || 5),
+        retries: Math.max(0, parseInt(opts.retry, 10) || 0),
+        allowedStatuses: statusCodes(opts.allowedStatus, configured.allowedStatuses),
+        headFallbackStatuses: statusCodes(opts.headFallbackStatus, configured.headFallbackStatuses),
+        cache: opts.cache,
+        cacheTtl: parsedCacheTtl,
+    });
+    results.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.url.localeCompare(b.url));
+    const shown = results.map((result) => ({
+        ...result,
+        file: outputPath(result.file, opts),
+        ...(!opts.reportRedirects ? { redirected: undefined, finalUrl: undefined } : {}),
+    }));
+    const broken = shown.filter((result) => !result.ok);
+    const payloadResults = opts.includeOk ? shown : broken;
+    const summary = {
+        type: "summary",
+        files: files.length,
+        total: shown.length,
+        ok: shown.length - broken.length,
+        broken: broken.length,
+    };
+    let payload;
+    const outputFormat = format(opts);
+    if (outputFormat === "json")
+        payload = jsonPayload("md check-urls", {
+            ...(files.length === 1 ? { file: outputPath(files[0], opts) } : {}),
+            files: files.length,
+            total: shown.length,
+            ok: shown.length - broken.length,
+            broken: broken.length,
+            results: shown,
+        }, opts, { exitCode: broken.length ? 2 : 0, summary: { total: shown.length, broken: broken.length } }).trimEnd();
+    else if (outputFormat === "jsonl")
+        payload = [
+            ...payloadResults.map((result) => JSON.stringify({ type: "result", ...result })),
+            JSON.stringify(summary),
+        ].join("\n");
+    else if (outputFormat === "sarif") {
+        const issues = broken.map((result) => ({
+            file: result.file,
+            line: result.line,
+            checker: "external",
+            message: `${result.url}: ${result.status ?? result.error ?? "request failed"}`,
+        }));
+        payload = formatSarif(issues);
+    }
+    else if (!shown.length)
+        payload = `No external URLs found in ${files.length} file(s)`;
+    else if (!payloadResults.length)
+        payload = `All ${shown.length} URL(s) in ${files.length} file(s) are reachable`;
+    else
+        payload = [
+            `${broken.length} broken URL(s) across ${files.length} file(s):`,
+            ...payloadResults.map((result) => {
+                const detail = result.error ? ` (${result.error})` : "";
+                const redirect = opts.reportRedirects && result.redirected ? ` → ${result.finalUrl}` : "";
+                return `  ${result.file}:L${result.line} [${result.status ?? "fail"}] ${result.url}${redirect}${detail}`;
+            }),
+        ].join("\n");
+    (broken.length ? process.stderr : process.stdout).write(payload + "\n");
+    if (broken.length)
+        terminate(2);
+}
+//# sourceMappingURL=check-urls.js.map

package/dist/commands/check-urls.js.map

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

package/dist/commands/code-blocks.d.ts

@@ -0,0 +1,8 @@
+interface CodeBlocksOptions {
+    envelope?: boolean;
+    format: string;
+    lang?: string;
+    content: boolean;
+}
+export declare function codeBlocksAction(file: string, opts: CodeBlocksOptions): Promise<void>;
+export {};

package/dist/commands/code-blocks.js

@@ -0,0 +1,66 @@
+import { extractCodeBlocks } from "../markdown-ast.js";
+import { outputPath, runtime } from "../runtime.js";
+import { requireFile } from "../input.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+export async function codeBlocksAction(file, opts) {
+    const format = resolveFormat(opts);
+    const filePath = requireFile(file, opts);
+    const shownPath = outputPath(filePath, opts);
+    let blocks = extractCodeBlocks(runtime().workspace.document(filePath).tree);
+    if (opts.lang) {
+        blocks = blocks.filter((b) => b.lang === opts.lang);
+    }
+    if (format === "json") {
+        const output = blocks.map((b) => ({
+            line: b.line,
+            endLine: b.endLine,
+            lang: b.lang,
+            lines: b.endLine - b.line + 1,
+            ...(opts.content ? { content: b.value } : {}),
+        }));
+        process.stdout.write(jsonPayload("md code-blocks", output, opts));
+        return;
+    }
+    if (blocks.length === 0) {
+        if (format === "human") {
+            process.stdout.write(`\x1b[33mNo code blocks found in ${shownPath}\x1b[0m\n`);
+        }
+        else {
+            process.stdout.write(`No code blocks found in ${shownPath}\n`);
+        }
+        return;
+    }
+    const lines = [];
+    const isHuman = format === "human";
+    if (isHuman) {
+        lines.push(`\n\x1b[1m${blocks.length} code block(s) in ${shownPath}\x1b[0m\n`);
+    }
+    else {
+        lines.push(`${blocks.length} code block(s) in ${shownPath}:`);
+    }
+    for (const b of blocks) {
+        const lineCount = b.endLine - b.line + 1;
+        const lang = b.lang ?? "(none)";
+        if (isHuman) {
+            lines.push(`  \x1b[36mL${b.line}-L${b.endLine}\x1b[0m  \x1b[33m${lang}\x1b[0m  (${lineCount} lines)`);
+        }
+        else {
+            lines.push(`  L${b.line}-L${b.endLine}  ${lang}  (${lineCount} lines)`);
+        }
+        if (opts.content) {
+            const contentLines = b.value.split("\n");
+            for (const cl of contentLines) {
+                lines.push(`    ${cl}`);
+            }
+            lines.push("");
+        }
+    }
+    process.stdout.write(lines.join("\n") + "\n");
+}
+//# sourceMappingURL=code-blocks.js.map

package/dist/commands/code-blocks.js.map

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

package/dist/commands/completion.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from "commander";
+export interface CompletionOptions {
+    format: string;
+    toolName: string;
+    toolVersion: string;
+}
+/**
+ * Writes a shell completion script to stdout.
+ *
+ * `--format` is validated but does not change the output, matching
+ * `schema <id>`: the script *is* the payload, and there is no JSON form of it
+ * worth publishing — `describe --format json` already emits the same command
+ * tree this is generated from.
+ */
+export declare function completionAction(program: Command, shell: string | undefined, opts: CompletionOptions): void;

package/dist/commands/completion.js

@@ -0,0 +1,20 @@
+import { BASE_FORMATS } from "../formats.js";
+import { SHELLS, buildModel } from "../completion/model.js";
+import { generateCompletion } from "../completion/shells.js";
+/**
+ * Writes a shell completion script to stdout.
+ *
+ * `--format` is validated but does not change the output, matching
+ * `schema <id>`: the script *is* the payload, and there is no JSON form of it
+ * worth publishing — `describe --format json` already emits the same command
+ * tree this is generated from.
+ */
+export function completionAction(program, shell, opts) {
+    if (!BASE_FORMATS.includes(opts.format))
+        throw new Error(`Invalid output format: ${opts.format}`);
+    if (!shell || !SHELLS.includes(shell))
+        throw new Error(`Unknown shell: ${shell ?? ""}. Supported: ${SHELLS.join(", ")}`);
+    const model = buildModel(program, { name: opts.toolName, version: opts.toolVersion });
+    process.stdout.write(generateCompletion(model, shell));
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAc,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAQ7D;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgB,EAChB,KAAyB,EACzB,IAAuB;IAEvB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAsB,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAc,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,IAAI,EAAE,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAc,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,16 @@
+interface ContextOptions {
+    envelope?: boolean;
+    format: string;
+    paths?: string;
+    depth: string;
+    section: string[];
+    target?: string;
+    budget: string;
+    backlinks: boolean;
+    children: boolean;
+    frontmatter: boolean;
+    include: string[];
+    exclude: string[];
+}
+export declare function contextAction(seeds: string[], opts: ContextOptions): Promise<void>;
+export {};

package/dist/commands/context.js

@@ -0,0 +1,131 @@
+import path from "node:path";
+import { buildContextPack, selectSections, } from "../context.js";
+import { documentSections } from "../sections.js";
+import { documentsReferencing } from "../backlinks.js";
+import { splitLocalTarget } from "../link-target.js";
+import { resolveMarkdownInputs } from "../input-selection.js";
+import { outputPath, runtime } from "../runtime.js";
+import { jsonPayload } from "../result.js";
+import { boundedInteger } from "../option-utils.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+/**
+ * Documents that reference `--target`, in workspace order.
+ *
+ * A fragment on the target narrows the match to references carrying that
+ * anchor, which is the rule `md query links-to --target` already uses.
+ */
+function targetSeeds(target, files) {
+    const parsed = splitLocalTarget(target);
+    const resolved = path.resolve(parsed.path);
+    const references = documentsReferencing(files, resolved).filter((reference) => parsed.fragment === undefined || reference.fragment === parsed.fragment);
+    return [...new Set(references.map((reference) => reference.sourceFile))];
+}
+function renderText(pack, human) {
+    const bold = (value) => (human ? `\x1b[1m${value}\x1b[0m` : value);
+    const dim = (value) => (human ? `\x1b[2m${value}\x1b[0m` : value);
+    const yellow = (value) => (human ? `\x1b[33m${value}\x1b[0m` : value);
+    const lines = [
+        bold(`# Context pack: ${pack.totals.files} document(s), ${pack.totals.units} unit(s), ` +
+            `${pack.totals.bytes} bytes (~${pack.budget.tokenEstimate} tokens, estimate: bytes/4)`),
+        bold("# Order: graph distance, then discovery order, then document order."),
+    ];
+    if (pack.budget.truncated) {
+        lines.push(yellow(`# Truncated at ${pack.budget.limitBytes} bytes; ${pack.omitted.length} unit(s) omitted.`));
+    }
+    for (const unit of pack.units) {
+        const where = `${unit.id} (L${unit.startLine}-L${unit.endLine})`;
+        const { distance, direction, via, viaLine } = unit.provenance;
+        let origin = "seed";
+        if (distance > 0) {
+            // A backlink's line lives in this document, not in `via`, so it is worded
+            // the other way round.
+            origin =
+                direction === "backlink"
+                    ? `distance ${distance}, links to ${via} at L${viaLine}`
+                    : `distance ${distance} via ${via}:${viaLine}`;
+        }
+        lines.push("", dim(`<!-- ${where} ${origin} -->`), unit.content.replace(/\n$/, ""));
+    }
+    if (pack.broken.length) {
+        lines.push("", yellow(`# Broken dependencies (${pack.broken.length})`));
+        for (const edge of pack.broken) {
+            lines.push(`${edge.source}:${edge.line} -> ${edge.target}`);
+        }
+    }
+    if (pack.omitted.length) {
+        lines.push("", yellow(`# Omitted for budget (${pack.omitted.length}, ${pack.budget.omittedBytes} bytes)`));
+        for (const omission of pack.omitted) {
+            lines.push(`${omission.id} (${omission.bytes} bytes)`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function contextAction(seeds, opts) {
+    const format = resolveFormat(opts);
+    const depth = boundedInteger(opts.depth, "depth", 6);
+    const budget = boundedInteger(opts.budget, "budget");
+    if (seeds.includes("-"))
+        throw new Error("md context does not accept stdin");
+    if (!seeds.length && !opts.target) {
+        throw new Error("md context requires at least one seed file or --target <path>");
+    }
+    const workspace = runtime().workspace;
+    const files = workspace.markdownFiles(workspace.root, {
+        include: opts.include,
+        exclude: opts.exclude,
+    });
+    const seedFiles = seeds.length
+        ? resolveMarkdownInputs(seeds, { include: opts.include, exclude: opts.exclude })
+        : [];
+    const fromTarget = opts.target ? targetSeeds(opts.target, files) : [];
+    const ordered = [...new Set([...seedFiles, ...fromTarget])];
+    if (!ordered.length) {
+        throw new Error(opts.target && !seeds.length
+            ? `No documents reference ${opts.target}`
+            : "No documents matched the requested seeds");
+    }
+    // `--section` restricts each seed to the named sections. A name matching
+    // nothing anywhere is a usage error rather than a silently smaller pack.
+    const resolvedSeeds = [];
+    const matched = new Set();
+    for (const file of ordered) {
+        if (!opts.section.length) {
+            resolvedSeeds.push({ file });
+            continue;
+        }
+        const sections = documentSections(workspace.document(file));
+        const chosen = new Set();
+        for (const heading of opts.section) {
+            const indices = selectSections(sections, heading, opts.children);
+            if (indices.length)
+                matched.add(heading);
+            for (const index of indices)
+                chosen.add(index);
+        }
+        if (chosen.size)
+            resolvedSeeds.push({ file, sections: [...chosen] });
+    }
+    for (const heading of opts.section) {
+        if (!matched.has(heading))
+            throw new Error(`Heading not found in any seed: ${heading}`);
+    }
+    const pack = buildContextPack({
+        workspace,
+        seeds: resolvedSeeds,
+        files,
+        depth,
+        backlinks: opts.backlinks,
+        frontmatter: opts.frontmatter,
+        budgetBytes: budget,
+        path: (file) => outputPath(file, opts),
+    });
+    process.stdout.write(format === "json"
+        ? jsonPayload("md context", pack, opts)
+        : renderText(pack, format === "human") + "\n");
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,cAAc,GAGf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAiBpD,SAAS,aAAa,CAAC,IAAoB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,MAAc,EAAE,KAAe;IAClD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,CAC7D,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CACvF,CAAC;IACF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CAAC,IAAiB,EAAE,KAAc;IACnD,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3E,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAE9E,MAAM,KAAK,GAAG;QACZ,IAAI,CACF,mBAAmB,IAAI,CAAC,MAAM,CAAC,KAAK,iBAAiB,IAAI,CAAC,MAAM,CAAC,KAAK,YAAY;YAChF,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,aAAa,6BAA6B,CACzF;QACD,IAAI,CAAC,qEAAqE,CAAC;KAC5E,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,kBAAkB,IAAI,CAAC,MAAM,CAAC,UAAU,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,mBAAmB,CAC1F,CACF,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC;QACjE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9D,IAAI,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,0EAA0E;YAC1E,uBAAuB;YACvB,MAAM;gBACJ,SAAS,KAAK,UAAU;oBACtB,CAAC,CAAC,YAAY,QAAQ,cAAc,GAAG,QAAQ,OAAO,EAAE;oBACxD,CAAC,CAAC,YAAY,QAAQ,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI,MAAM,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,0BAA0B,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,MAAM,CAAC,yBAAyB,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,YAAY,SAAS,CAAC,CAC3F,CAAC;QACF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAe,EAAE,IAAoB;IACvE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC7E,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE;QACpD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM;QAC5B,CAAC,CAAC,qBAAqB,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAChF,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM;YAC1B,CAAC,CAAC,0BAA0B,IAAI,CAAC,MAAM,EAAE;YACzC,CAAC,CAAC,0CAA0C,CAC/C,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,aAAa,GAAkB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjE,IAAI,OAAO,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,MAAM,KAAK,IAAI,OAAO;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI;YAAE,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC;QAC5B,SAAS;QACT,KAAK,EAAE,aAAa;QACpB,KAAK;QACL,KAAK;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;KACvC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,KAAK,MAAM;QACf,CAAC,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC;QACvC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAChD,CAAC;AACJ,CAAC"}

package/dist/commands/describe.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from "commander";
+export interface DescribeOptions {
+    format: string;
+    toolName: string;
+    toolVersion: string;
+}
+/**
+ * Describes the CLI contract. Reports the static contract: project
+ * configuration is deliberately not applied, so a consumer sees the same answer
+ * regardless of the directory it runs in.
+ */
+export declare function describeAction(program: Command, commandPath: string[], opts: DescribeOptions): Promise<void>;