@mrmtsu/mcms-cli 0.1.0 → 0.2.1

package/dist/core/docs/mcp-provider.js

@@ -0,0 +1,435 @@
+import { readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, extname, resolve } from "node:path";
+import { CliError } from "../errors.js";
+import { EXIT_CODE } from "../exit-codes.js";
+const MCP_COMMAND_OVERRIDE = process.env.MICROCMS_DOC_MCP_COMMAND;
+const MCP_STARTUP_TIMEOUT_MS = 2_000;
+const MCP_REQUEST_TIMEOUT_MS = 5_000;
+export function createMcpDocsProvider() {
+    const client = createMcpClient(resolveMcpRuntime());
+    return {
+        async healthcheck() {
+            await callTool(client, "fetch_general");
+        },
+        async listDocuments(params) {
+            const args = params.category ? { category: params.category } : undefined;
+            const raw = await callTool(client, "list_documents", args);
+            const payload = parseListDocumentsPayload(raw);
+            const categoryRows = payload.categories ?? [];
+            const docs = categoryRows
+                .flatMap((row) => {
+                const category = typeof row.category === "string" ? row.category : undefined;
+                const files = Array.isArray(row.files) ? row.files : [];
+                if (!category) {
+                    return [];
+                }
+                return files
+                    .filter((file) => typeof file === "string")
+                    .map((filename) => ({ category, filename }));
+            })
+                .slice(0, params.limit);
+            const counts = new Map();
+            for (const doc of docs) {
+                counts.set(doc.category, (counts.get(doc.category) ?? 0) + 1);
+            }
+            return {
+                categories: [...counts.entries()].map(([category, count]) => ({ category, count })),
+                docs,
+                total: docs.length
+            };
+        },
+        async getDocument(params) {
+            const raw = await callTool(client, "search_document", {
+                category: params.category,
+                filename: params.filename
+            });
+            return {
+                category: params.category,
+                filename: params.filename,
+                markdown: normalizeSearchDocumentOutput(raw)
+            };
+        },
+        async dispose() {
+            await client.close();
+        }
+    };
+}
+function createMcpClient(runtime) {
+    let nextId = 1;
+    const pending = new Map();
+    const stderrChunks = [];
+    let processRef = null;
+    let initialized = false;
+    let startupPromise = null;
+    let startupTimer = null;
+    let startupResolve = null;
+    let startupReject = null;
+    let buffer = Buffer.alloc(0);
+    function ensureStarted() {
+        if (processRef) {
+            return processRef;
+        }
+        const child = spawn(runtime.command, runtime.args, {
+            stdio: "pipe",
+            env: buildMcpEnv()
+        });
+        processRef = child;
+        startupPromise = new Promise((resolve, reject) => {
+            startupResolve = resolve;
+            startupReject = reject;
+            startupTimer = setTimeout(() => {
+                reject(new Error(`MCP server startup timed out after ${MCP_STARTUP_TIMEOUT_MS}ms`));
+            }, MCP_STARTUP_TIMEOUT_MS);
+        });
+        child.once("spawn", () => {
+            clearStartupTimer();
+            startupResolve?.();
+        });
+        child.on("error", (error) => {
+            const wrapped = new Error(`Failed to launch MCP server command "${runtime.command}": ${error.message}`);
+            clearStartupTimer();
+            startupReject?.(wrapped);
+            throwFromPending(wrapped);
+        });
+        child.on("exit", (code, signal) => {
+            const suffix = stderrChunks.length > 0 ? ` (${stderrChunks.join("").trim()})` : "";
+            const wrapped = new Error(`MCP server exited (code=${code ?? "null"}, signal=${signal ?? "null"})${suffix}`);
+            clearStartupTimer();
+            startupReject?.(wrapped);
+            throwFromPending(wrapped);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderrChunks.push(Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk));
+        });
+        child.stdout.on("data", (chunk) => {
+            const part = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            buffer = Buffer.concat([buffer, part]);
+            try {
+                for (const message of readTransportMessages(() => buffer, (next) => {
+                    buffer = next;
+                })) {
+                    onMessage(message);
+                }
+            }
+            catch (error) {
+                const wrapped = new Error(`Failed to parse MCP response: ${error instanceof Error ? error.message : "unknown error"}`);
+                throwFromPending(wrapped);
+            }
+        });
+        return child;
+    }
+    async function request(method, params) {
+        const child = ensureStarted();
+        await startupPromise;
+        if (!initialized) {
+            await initialize(child);
+            initialized = true;
+        }
+        return requestRaw(child, method, params);
+    }
+    async function initialize(child) {
+        await requestRaw(child, "initialize", {
+            protocolVersion: "2025-06-18",
+            capabilities: {},
+            clientInfo: {
+                name: "mcms-cli",
+                version: "0.1.0"
+            }
+        });
+        const initializedNotification = serializeTransportMessage({
+            jsonrpc: "2.0",
+            method: "notifications/initialized",
+            params: {}
+        });
+        child.stdin.write(initializedNotification, (error) => {
+            if (error) {
+                throwFromPending(new Error(`Failed to send MCP initialized notification: ${error.message}`));
+            }
+        });
+    }
+    async function requestRaw(child, method, params) {
+        const id = nextId++;
+        const payload = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params
+        };
+        const serialized = serializeTransportMessage(payload);
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                pending.delete(id);
+                reject(new Error(`MCP request timed out: ${method}`));
+            }, MCP_REQUEST_TIMEOUT_MS);
+            pending.set(id, {
+                resolve,
+                reject,
+                timer
+            });
+            child.stdin.write(serialized, (error) => {
+                if (!error) {
+                    return;
+                }
+                const entry = pending.get(id);
+                if (!entry) {
+                    return;
+                }
+                clearTimeout(entry.timer);
+                pending.delete(id);
+                reject(new Error(`Failed to write MCP request (${method}): ${error.message}`));
+            });
+        });
+    }
+    function onMessage(message) {
+        if (typeof message !== "object" || message === null) {
+            return;
+        }
+        const response = message;
+        if (typeof response.id !== "number") {
+            return;
+        }
+        const entry = pending.get(response.id);
+        if (!entry) {
+            return;
+        }
+        clearTimeout(entry.timer);
+        pending.delete(response.id);
+        if (response.error) {
+            const details = response.error.data === undefined ? "" : ` (${JSON.stringify(response.error.data)})`;
+            entry.reject(new Error(`${response.error.message ?? "MCP request failed"}${details}`));
+            return;
+        }
+        entry.resolve(response.result);
+    }
+    async function close() {
+        if (!processRef) {
+            return;
+        }
+        const child = processRef;
+        processRef = null;
+        initialized = false;
+        throwFromPending(new Error("MCP client closed"));
+        if (!child.killed) {
+            child.kill();
+        }
+    }
+    function throwFromPending(error) {
+        for (const [id, entry] of pending.entries()) {
+            clearTimeout(entry.timer);
+            entry.reject(error);
+            pending.delete(id);
+        }
+    }
+    function clearStartupTimer() {
+        if (startupTimer) {
+            clearTimeout(startupTimer);
+            startupTimer = null;
+        }
+    }
+    return {
+        request,
+        close
+    };
+}
+function resolveMcpRuntime() {
+    const overridden = MCP_COMMAND_OVERRIDE?.trim();
+    if (overridden && overridden.length > 0) {
+        const extension = extname(overridden).toLowerCase();
+        if (extension === ".js" || extension === ".mjs" || extension === ".cjs") {
+            return {
+                command: process.execPath,
+                args: [overridden]
+            };
+        }
+        return {
+            command: overridden,
+            args: []
+        };
+    }
+    try {
+        const require = createRequire(import.meta.url);
+        const packageJsonPath = require.resolve("microcms-document-mcp-server/package.json");
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+        const binRelative = typeof packageJson.bin === "string"
+            ? packageJson.bin
+            : packageJson.bin?.["microcms-document-mcp-server"] ?? (packageJson.bin ? Object.values(packageJson.bin)[0] : undefined);
+        if (!binRelative) {
+            throw new Error("bin field is missing");
+        }
+        return {
+            command: process.execPath,
+            args: [resolve(dirname(packageJsonPath), binRelative)]
+        };
+    }
+    catch {
+        return {
+            command: "microcms-document-mcp-server",
+            args: []
+        };
+    }
+}
+function buildMcpEnv() {
+    const keys = ["PATH", "HOME", "USERPROFILE", "TMPDIR", "TMP", "TEMP", "SYSTEMROOT", "COMSPEC", "WINDIR", "LANG", "LC_ALL"];
+    const env = {};
+    for (const key of keys) {
+        const value = process.env[key];
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    return env;
+}
+async function callTool(client, name, args) {
+    try {
+        const result = await client.request("tools/call", {
+            name,
+            arguments: args ?? {}
+        });
+        const text = extractToolText(result);
+        if (text === null) {
+            throw new Error(`MCP tool "${name}" returned unsupported response payload`);
+        }
+        return text;
+    }
+    catch (error) {
+        throw new CliError({
+            code: "INVALID_INPUT",
+            message: `MCP tool call failed (${name}): ${error instanceof Error ? error.message : "unknown error"}`,
+            exitCode: EXIT_CODE.INVALID_INPUT
+        });
+    }
+}
+function extractToolText(result) {
+    if (typeof result === "string") {
+        return result;
+    }
+    if (typeof result !== "object" || result === null) {
+        return null;
+    }
+    const maybeContent = result.content;
+    if (!Array.isArray(maybeContent)) {
+        return null;
+    }
+    const texts = maybeContent
+        .map((entry) => {
+        if (typeof entry !== "object" || entry === null) {
+            return null;
+        }
+        const item = entry;
+        if (item.type !== "text" || typeof item.text !== "string") {
+            return null;
+        }
+        return item.text;
+    })
+        .filter((text) => text !== null);
+    if (texts.length === 0) {
+        return null;
+    }
+    return texts.join("\n");
+}
+function parseListDocumentsPayload(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new CliError({
+            code: "INVALID_INPUT",
+            message: "MCP list_documents returned non-JSON payload",
+            exitCode: EXIT_CODE.INVALID_INPUT
+        });
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+        throw new CliError({
+            code: "INVALID_INPUT",
+            message: "MCP list_documents returned invalid payload",
+            exitCode: EXIT_CODE.INVALID_INPUT
+        });
+    }
+    return parsed;
+}
+function normalizeSearchDocumentOutput(raw) {
+    const normalized = raw.replace(/\r\n/g, "\n").trim();
+    const marker = "\n---\n";
+    if (!normalized.startsWith("カテゴリー:") || !normalized.includes(marker)) {
+        return normalized;
+    }
+    const start = normalized.indexOf(marker);
+    return normalized.slice(start + 1).trim();
+}
+function serializeTransportMessage(payload) {
+    return Buffer.from(`${JSON.stringify(payload)}\n`, "utf8");
+}
+function* readTransportMessages(readBuffer, setBuffer) {
+    while (true) {
+        const current = readBuffer();
+        if (current.length === 0) {
+            return;
+        }
+        if (startsWithContentLengthHeader(current)) {
+            const separatorIndex = current.indexOf("\r\n\r\n");
+            if (separatorIndex < 0) {
+                return;
+            }
+            const headerText = current.slice(0, separatorIndex).toString("utf8");
+            const length = parseContentLength(headerText);
+            if (length === null) {
+                throw new Error("MCP framing error: missing Content-Length");
+            }
+            const bodyStart = separatorIndex + 4;
+            const bodyEnd = bodyStart + length;
+            if (current.length < bodyEnd) {
+                return;
+            }
+            const body = current.slice(bodyStart, bodyEnd).toString("utf8");
+            setBuffer(current.slice(bodyEnd));
+            yield parseJsonMessage(body);
+            continue;
+        }
+        const lineBreakIndex = current.indexOf(0x0a);
+        if (lineBreakIndex < 0) {
+            return;
+        }
+        const line = current.slice(0, lineBreakIndex).toString("utf8").replace(/\r$/, "").trim();
+        setBuffer(current.slice(lineBreakIndex + 1));
+        if (line.length === 0) {
+            continue;
+        }
+        yield parseJsonMessage(line);
+    }
+}
+function parseJsonMessage(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`MCP transport error: invalid JSON payload (${error instanceof Error ? error.message : "unknown"})`);
+    }
+}
+function startsWithContentLengthHeader(buffer) {
+    const probe = buffer.subarray(0, 32).toString("utf8").toLowerCase();
+    return probe.startsWith("content-length:");
+}
+function parseContentLength(headerText) {
+    const lines = headerText.split(/\r\n/);
+    for (const line of lines) {
+        const separator = line.indexOf(":");
+        if (separator < 0) {
+            continue;
+        }
+        const key = line.slice(0, separator).trim().toLowerCase();
+        if (key !== "content-length") {
+            continue;
+        }
+        const raw = line.slice(separator + 1).trim();
+        const parsed = Number.parseInt(raw, 10);
+        if (!Number.isFinite(parsed) || parsed < 0) {
+            return null;
+        }
+        return parsed;
+    }
+    return null;
+}
+//# sourceMappingURL=mcp-provider.js.map

package/dist/core/docs/mcp-provider.js.map

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

package/dist/core/docs/provider.d.ts

@@ -0,0 +1,42 @@
+export type DocsSourceMode = "auto" | "mcp" | "local";
+export type DocsSourceResolved = "mcp" | "local";
+export type DocsDocument = {
+    category: string;
+    filename: string;
+};
+export type DocsListResult = {
+    categories: Array<{
+        category: string;
+        count: number;
+    }>;
+    docs: DocsDocument[];
+    total: number;
+};
+export type DocsGetResult = {
+    category: string;
+    filename: string;
+    markdown: string;
+};
+export type DocsProvider = {
+    listDocuments(params: {
+        category?: string;
+        limit: number;
+    }): Promise<DocsListResult>;
+    getDocument(params: {
+        category: string;
+        filename: string;
+    }): Promise<DocsGetResult>;
+    dispose?(): Promise<void>;
+};
+export type ResolvedDocsProvider = {
+    provider: DocsProvider;
+    sourceResolved: DocsSourceResolved;
+    warnings: string[];
+};
+export declare function resolveDocsProvider(source: DocsSourceMode): Promise<ResolvedDocsProvider>;
+export declare function parseDocsSourceOption(value: string | undefined): DocsSourceMode;
+export declare function truncateMarkdown(markdown: string, maxChars: number | undefined): {
+    markdown: string;
+    truncated: boolean;
+    originalLength: number;
+};

package/dist/core/docs/provider.js

@@ -0,0 +1,76 @@
+import { CliError } from "../errors.js";
+import { EXIT_CODE } from "../exit-codes.js";
+import { createLocalDocsProvider } from "./local-provider.js";
+import { createMcpDocsProvider } from "./mcp-provider.js";
+export async function resolveDocsProvider(source) {
+    if (source === "local") {
+        return {
+            provider: createLocalDocsProvider(),
+            sourceResolved: "local",
+            warnings: []
+        };
+    }
+    if (source === "mcp") {
+        const provider = createMcpDocsProvider();
+        await provider.healthcheck();
+        return {
+            provider,
+            sourceResolved: "mcp",
+            warnings: []
+        };
+    }
+    const mcpProvider = createMcpDocsProvider();
+    try {
+        await mcpProvider.healthcheck();
+        return {
+            provider: mcpProvider,
+            sourceResolved: "mcp",
+            warnings: []
+        };
+    }
+    catch (error) {
+        await mcpProvider.dispose?.();
+        const reason = toWarningMessage(error);
+        return {
+            provider: createLocalDocsProvider(),
+            sourceResolved: "local",
+            warnings: [`MCP source is unavailable, fell back to local source: ${reason}`]
+        };
+    }
+}
+export function parseDocsSourceOption(value) {
+    const normalized = value?.trim().toLowerCase() ?? "auto";
+    if (normalized === "auto" || normalized === "mcp" || normalized === "local") {
+        return normalized;
+    }
+    throw new CliError({
+        code: "INVALID_INPUT",
+        message: `Invalid source: ${value}. Expected auto, mcp, or local.`,
+        exitCode: EXIT_CODE.INVALID_INPUT
+    });
+}
+export function truncateMarkdown(markdown, maxChars) {
+    const originalLength = markdown.length;
+    if (!maxChars || originalLength <= maxChars) {
+        return {
+            markdown,
+            truncated: false,
+            originalLength
+        };
+    }
+    return {
+        markdown: `${markdown.slice(0, maxChars)}\n\n<!-- truncated -->`,
+        truncated: true,
+        originalLength
+    };
+}
+function toWarningMessage(error) {
+    if (error instanceof CliError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "unknown error";
+}
+//# sourceMappingURL=provider.js.map

package/dist/core/docs/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/core/docs/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAkC1D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAsB;IAC9D,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO;YACL,QAAQ,EAAE,uBAAuB,EAAE;YACnC,cAAc,EAAE,OAAO;YACvB,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO;YACL,QAAQ;YACR,cAAc,EAAE,KAAK;YACrB,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO;YACL,QAAQ,EAAE,WAAW;YACrB,cAAc,EAAE,KAAK;YACrB,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO;YACL,QAAQ,EAAE,uBAAuB,EAAE;YACnC,cAAc,EAAE,OAAO;YACvB,QAAQ,EAAE,CAAC,yDAAyD,MAAM,EAAE,CAAC;SAC9E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC;IACzD,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC5E,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,QAAQ,CAAC;QACjB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,mBAAmB,KAAK,iCAAiC;QAClE,QAAQ,EAAE,SAAS,CAAC,aAAa;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAA4B;IAK7E,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;IACvC,IAAI,CAAC,QAAQ,IAAI,cAAc,IAAI,QAAQ,EAAE,CAAC;QAC5C,OAAO;YACL,QAAQ;YACR,SAAS,EAAE,KAAK;YAChB,cAAc;SACf,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,wBAAwB;QAChE,SAAS,EAAE,IAAI;QACf,cAAc;KACf,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/core/search.d.ts

@@ -0,0 +1,11 @@
+export type SearchHit = {
+    kind: "command" | "doc";
+    title: string;
+    ref: string;
+    snippet: string;
+    score: number;
+    source: "local" | "mcp";
+    category?: string;
+    filename?: string;
+};
+export declare function rankSearchHits(query: string, hits: SearchHit[], limit: number): SearchHit[];

package/dist/core/search.js

@@ -0,0 +1,48 @@
+export function rankSearchHits(query, hits, limit) {
+    const normalizedQuery = normalize(query);
+    const tokens = tokenize(normalizedQuery);
+    const scored = hits
+        .map((hit) => ({
+        hit,
+        score: computeScore(tokens, normalizedQuery, `${hit.title}\n${hit.ref}\n${hit.snippet}`)
+    }))
+        .filter((item) => item.score > 0)
+        .sort((a, b) => {
+        if (b.score !== a.score) {
+            return b.score - a.score;
+        }
+        return a.hit.title.localeCompare(b.hit.title);
+    })
+        .slice(0, limit)
+        .map((item) => ({
+        ...item.hit,
+        score: item.score
+    }));
+    return scored;
+}
+function computeScore(tokens, normalizedQuery, haystackRaw) {
+    const haystack = normalize(haystackRaw);
+    let score = 0;
+    if (normalizedQuery.length > 0 && haystack.includes(normalizedQuery)) {
+        score += 5;
+    }
+    for (const token of tokens) {
+        if (token.length < 2) {
+            continue;
+        }
+        if (haystack.includes(token)) {
+            score += 2;
+        }
+    }
+    return score;
+}
+function normalize(value) {
+    return value.toLowerCase().normalize("NFKC");
+}
+function tokenize(value) {
+    return value
+        .split(/[^\p{L}\p{N}_-]+/u)
+        .map((token) => token.trim())
+        .filter((token) => token.length > 0);
+}
+//# sourceMappingURL=search.js.map

package/dist/core/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAiB,EAAE,KAAa;IAC5E,MAAM,eAAe,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI;SAChB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,GAAG;QACH,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;KACzF,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAC3B,CAAC;QAED,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,GAAG,IAAI,CAAC,GAAG;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC,CAAC;IAEN,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,MAAgB,EAAE,eAAuB,EAAE,WAAmB;IAClF,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAExC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QACrE,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK;SACT,KAAK,CAAC,mBAAmB,CAAC;SAC1B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/spec.d.ts

@@ -0,0 +1,20 @@
+export type GlobalOptionSpec = {
+    name: string;
+    description: string;
+};
+export type CommandSpec = {
+    path: string;
+    description: string;
+    args: string[];
+    options: string[];
+    readOnly: boolean;
+};
+export type CliSpec = {
+    name: string;
+    version: string;
+    jsonContractVersion: string;
+    globalOptions: GlobalOptionSpec[];
+    exitCodes: Record<string, number>;
+    commands: CommandSpec[];
+};
+export declare function getCliSpec(): CliSpec;