@obov/mext 0.0.0-stage → 0.1.0

package/dist/cli/mcp.js

@@ -0,0 +1,92 @@
+import { loadConfig } from "../config.js";
+import { DEFAULT_HOST, DEFAULT_PORT, MCP_PATH } from "../mcp/constants.js";
+import { mcpInstallText } from "../mcp/install.js";
+import { table } from "./help.js";
+import { EXIT, exitCodeOf, formatError } from "./output.js";
+export const MCP_PROG = "mext mcp";
+/**
+ * mext mcp install [--name] [--url]  MCP 클라이언트 등록 안내 출력 (설정 파일은 쓰지 않음)
+ * 서버 형태 (mext mcp · mext mcp --stdio) 는 제거: mext dev · mext dev --stdio (운영 = mext start)
+ */
+export async function mcpCommand(argv, io) {
+    const parsed = parseMcpArgs(argv);
+    if (typeof parsed === "string") {
+        io.stderr.write(`error: ${parsed}\nRun "${MCP_PROG} --help" for usage.\n`);
+        return EXIT.usage;
+    }
+    if (parsed.help) {
+        io.stdout.write(mcpHelp());
+        return EXIT.ok;
+    }
+    return install(parsed, io);
+}
+/** 반환 문자열 = 사용법 오류 메시지 */
+export function parseMcpArgs(argv) {
+    const [first, ...rest] = argv;
+    if (first === "--help" || first === "-h")
+        return { help: true };
+    if (first !== "install") {
+        if (argv.includes("--stdio"))
+            return `"${MCP_PROG} --stdio" was removed. Use "mext dev --stdio"`;
+        if (first === undefined || first.startsWith("--")) {
+            return `the "${MCP_PROG}" server was removed. Use "mext dev" (development) or "mext start" (production)`;
+        }
+        return `unknown subcommand "${first}"`;
+    }
+    const args = { help: false };
+    for (let i = 0; i < rest.length; i++) {
+        const tok = rest[i];
+        if (tok === "--help" || tok === "-h") {
+            args.help = true;
+            continue;
+        }
+        if (!tok.startsWith("--"))
+            return `unexpected argument "${tok}"`;
+        const eq = tok.indexOf("=");
+        const name = eq < 0 ? tok.slice(2) : tok.slice(2, eq);
+        if (name !== "name" && name !== "url")
+            return `unknown flag --${name} for ${MCP_PROG} install`;
+        const value = eq < 0 ? rest[++i] : tok.slice(eq + 1);
+        if (value === undefined || value === "")
+            return `--${name} requires a value`;
+        if (name === "name")
+            args.name = value;
+        else
+            args.url = value;
+    }
+    return args;
+}
+async function install(args, io) {
+    let config;
+    try {
+        config = await loadConfig(io.cwd);
+    }
+    catch (error) {
+        io.stderr.write(formatError(error, MCP_PROG));
+        return exitCodeOf(error);
+    }
+    const host = config.server?.host ?? DEFAULT_HOST;
+    const port = config.server?.port ?? DEFAULT_PORT;
+    const url = args.url ?? `http://${host.includes(":") ? `[${host}]` : host}:${port}${MCP_PATH}`;
+    io.stdout.write(`${mcpInstallText({ name: args.name ?? "mext", url, auth: config.auth !== undefined })}\n`);
+    return EXIT.ok;
+}
+export function mcpHelp() {
+    const lines = [
+        "Print MCP client registration commands (does not modify client config files).",
+        "",
+        "Usage:",
+        `  ${MCP_PROG} install [--name <name>] [--url <url>]`,
+        "",
+        "Flags:",
+        ...table([
+            ["--name <name>", 'Server name to register (default "mext")'],
+            ["--url <url>", "Streamable HTTP endpoint (default from mext.config.ts server)"],
+            ["-h, --help", "Show help"],
+        ]).map((l) => `  ${l}`),
+        "",
+        'The MCP server itself runs with "mext dev" (development; --stdio for stdio) or "mext start" (production).',
+    ];
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/cli/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"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","sourcesContent":["import { loadConfig, type MextConfig } from \"../config.ts\"\nimport { DEFAULT_HOST, DEFAULT_PORT, MCP_PATH } from \"../mcp/constants.ts\"\nimport { mcpInstallText } from \"../mcp/install.ts\"\nimport { table } from \"./help.ts\"\nimport type { CliIo } from \"./io.ts\"\nimport { EXIT, exitCodeOf, formatError } from \"./output.ts\"\n\nexport const MCP_PROG = \"mext mcp\"\n\n/**\n * mext mcp install [--name] [--url]  MCP 클라이언트 등록 안내 출력 (설정 파일은 쓰지 않음)\n * 서버 형태 (mext mcp · mext mcp --stdio) 는 제거: mext dev · mext dev --stdio (운영 = mext start)\n */\nexport async function mcpCommand(argv: readonly string[], io: CliIo): Promise<number> {\n  const parsed = parseMcpArgs(argv)\n  if (typeof parsed === \"string\") {\n    io.stderr.write(`error: ${parsed}\\nRun \"${MCP_PROG} --help\" for usage.\\n`)\n    return EXIT.usage\n  }\n  if (parsed.help) {\n    io.stdout.write(mcpHelp())\n    return EXIT.ok\n  }\n  return install(parsed, io)\n}\n\ninterface McpArgs {\n  help: boolean\n  name?: string\n  url?: string\n}\n\n/** 반환 문자열 = 사용법 오류 메시지 */\nexport function parseMcpArgs(argv: readonly string[]): McpArgs | string {\n  const [first, ...rest] = argv\n  if (first === \"--help\" || first === \"-h\") return { help: true }\n  if (first !== \"install\") {\n    if (argv.includes(\"--stdio\")) return `\"${MCP_PROG} --stdio\" was removed. Use \"mext dev --stdio\"`\n    if (first === undefined || first.startsWith(\"--\")) {\n      return `the \"${MCP_PROG}\" server was removed. Use \"mext dev\" (development) or \"mext start\" (production)`\n    }\n    return `unknown subcommand \"${first}\"`\n  }\n  const args: McpArgs = { help: false }\n  for (let i = 0; i < rest.length; i++) {\n    const tok = rest[i]!\n    if (tok === \"--help\" || tok === \"-h\") {\n      args.help = true\n      continue\n    }\n    if (!tok.startsWith(\"--\")) return `unexpected argument \"${tok}\"`\n    const eq = tok.indexOf(\"=\")\n    const name = eq < 0 ? tok.slice(2) : tok.slice(2, eq)\n    if (name !== \"name\" && name !== \"url\") return `unknown flag --${name} for ${MCP_PROG} install`\n    const value = eq < 0 ? rest[++i] : tok.slice(eq + 1)\n    if (value === undefined || value === \"\") return `--${name} requires a value`\n    if (name === \"name\") args.name = value\n    else args.url = value\n  }\n  return args\n}\n\nasync function install(args: McpArgs, io: CliIo): Promise<number> {\n  let config: MextConfig\n  try {\n    config = await loadConfig(io.cwd)\n  } catch (error) {\n    io.stderr.write(formatError(error, MCP_PROG))\n    return exitCodeOf(error)\n  }\n  const host = config.server?.host ?? DEFAULT_HOST\n  const port = config.server?.port ?? DEFAULT_PORT\n  const url = args.url ?? `http://${host.includes(\":\") ? `[${host}]` : host}:${port}${MCP_PATH}`\n  io.stdout.write(`${mcpInstallText({ name: args.name ?? \"mext\", url, auth: config.auth !== undefined })}\\n`)\n  return EXIT.ok\n}\n\nexport function mcpHelp(): string {\n  const lines = [\n    \"Print MCP client registration commands (does not modify client config files).\",\n    \"\",\n    \"Usage:\",\n    `  ${MCP_PROG} install [--name <name>] [--url <url>]`,\n    \"\",\n    \"Flags:\",\n    ...table([\n      [\"--name <name>\", 'Server name to register (default \"mext\")'],\n      [\"--url <url>\", \"Streamable HTTP endpoint (default from mext.config.ts server)\"],\n      [\"-h, --help\", \"Show help\"],\n    ]).map((l) => `  ${l}`),\n    \"\",\n    'The MCP server itself runs with \"mext dev\" (development; --stdio for stdio) or \"mext start\" (production).',\n  ]\n  return `${lines.join(\"\\n\")}\\n`\n}\n"]}

package/dist/cli/output.d.ts

@@ -0,0 +1,34 @@
+import type { ProgressUpdate } from "../command.ts";
+/** exit code (spec §5) */
+export declare const EXIT: {
+    readonly ok: 0;
+    readonly error: 1;
+    readonly usage: 2;
+    readonly auth: 77;
+    readonly interrupted: 130;
+};
+/** 실행 중 SIGINT (ctx.signal abort) 를 나타내는 CLI 내부 오류 */
+export declare class CliInterrupted extends Error {
+    constructor();
+}
+/**
+ * 오류 → exit code.
+ * INVALID_ARGUMENT · UNKNOWN_COMMAND · INPUT_UNAVAILABLE = 2 · UNAUTHENTICATED · PERMISSION_DENIED = 77 · SIGINT = 130 · 그 외 = 1
+ */
+export declare function exitCodeOf(error: unknown): number;
+/**
+ * --json 오류 본문. MextError = toJSON(), 빌드 오류 = BUILD_ERROR + issues,
+ * SIGINT = INTERRUPTED, 핸들러 예외 = EXECUTION_ERROR
+ */
+export declare function errorJson(error: unknown): Record<string, unknown>;
+/** 사람용 오류 텍스트 (끝 줄바꿈 포함) */
+export declare function formatError(error: unknown, prog: string): string;
+/**
+ * 사람용 결과 텍스트 (끝 줄바꿈 포함, undefined = 빈 문자열).
+ * 문자열 = 그대로 · 원시 값 = String · 객체 배열 = 표 · 원시 배열 = 줄마다 · 객체 = 키 값 정렬. 중첩 값은 JSON 한 줄
+ */
+export declare function formatResult(value: unknown): string;
+/** --json 결과 */
+export declare function formatJson(value: unknown): string;
+/** ctx.progress → stderr 한 줄 */
+export declare function formatProgress(update: ProgressUpdate): string;

package/dist/cli/output.js

@@ -0,0 +1,172 @@
+import { isMextError, MextBuildError, MextError } from "../errors.js";
+import { toKebab } from "./args.js";
+import { cliPath, table } from "./help.js";
+/** exit code (spec §5) */
+export const EXIT = {
+    ok: 0,
+    error: 1,
+    usage: 2,
+    auth: 77,
+    interrupted: 130,
+};
+/** 실행 중 SIGINT (ctx.signal abort) 를 나타내는 CLI 내부 오류 */
+export class CliInterrupted extends Error {
+    constructor() {
+        super("Interrupted.");
+        this.name = "CliInterrupted";
+    }
+}
+/**
+ * 오류 → exit code.
+ * INVALID_ARGUMENT · UNKNOWN_COMMAND · INPUT_UNAVAILABLE = 2 · UNAUTHENTICATED · PERMISSION_DENIED = 77 · SIGINT = 130 · 그 외 = 1
+ */
+export function exitCodeOf(error) {
+    if (error instanceof CliInterrupted)
+        return EXIT.interrupted;
+    if (error instanceof MextError) {
+        switch (error.code) {
+            case "INVALID_ARGUMENT":
+            case "UNKNOWN_COMMAND":
+            case "INPUT_UNAVAILABLE":
+                return EXIT.usage;
+            case "UNAUTHENTICATED":
+            case "PERMISSION_DENIED":
+                return EXIT.auth;
+        }
+    }
+    return EXIT.error;
+}
+/**
+ * --json 오류 본문. MextError = toJSON(), 빌드 오류 = BUILD_ERROR + issues,
+ * SIGINT = INTERRUPTED, 핸들러 예외 = EXECUTION_ERROR
+ */
+export function errorJson(error) {
+    if (error instanceof MextError)
+        return error.toJSON();
+    if (error instanceof MextBuildError)
+        return { code: "BUILD_ERROR", message: error.message, issues: error.issues };
+    if (error instanceof CliInterrupted)
+        return { code: "INTERRUPTED", message: error.message };
+    return { code: "EXECUTION_ERROR", message: error instanceof Error ? error.message : String(error) };
+}
+/** 사람용 오류 텍스트 (끝 줄바꿈 포함) */
+export function formatError(error, prog) {
+    const lines = [];
+    if (isMextError(error, "INVALID_ARGUMENT")) {
+        const d = error.details;
+        lines.push(d.command === "" ? "error: invalid arguments" : `error: invalid arguments for ${cliPath(d.command)}`);
+        const rows = d.issues.map((i) => {
+            if (i.path === "")
+                return [i.message];
+            return [flagOf(i.path), d.missing_fields.includes(i.path) ? "required" : i.message];
+        });
+        lines.push(...table(rows.filter((r) => r.length === 2)).map((l) => `  ${l}`));
+        lines.push(...rows.filter((r) => r.length === 1).map((r) => `  ${r[0]}`));
+        if (d.command !== "")
+            lines.push(`Run "${prog} ${cliPath(d.command)} --help" for usage.`);
+    }
+    else if (isMextError(error, "UNKNOWN_COMMAND")) {
+        const d = error.details;
+        if (d.command === "")
+            lines.push("error: no command given");
+        else if (error.message.startsWith("Unknown command"))
+            lines.push(`error: unknown command "${cliPath(d.command)}"`);
+        else
+            lines.push(`error: ${error.message}`);
+        if (d.suggested.length > 0)
+            lines.push(`Did you mean: ${d.suggested.map((s) => `${prog} ${cliPath(s)}`).join(", ")}?`);
+        lines.push(`Run "${usageCommand(prog, d.usage)}" for available commands.`);
+    }
+    else if (isMextError(error, "PERMISSION_DENIED")) {
+        const d = error.details;
+        lines.push(`error: ${error.message}`);
+        lines.push(`  required scopes: ${d.required_scopes.join(", ") || "(none)"}`);
+        lines.push(`  held scopes: ${d.held_scopes.join(", ") || "(none)"}`);
+    }
+    else if (isMextError(error, "UNAUTHENTICATED")) {
+        lines.push(`error: ${error.message}`);
+        if (error.details.login !== undefined)
+            lines.push(`Run "${error.details.login}" to log in.`);
+    }
+    else if (isMextError(error, "INPUT_UNAVAILABLE")) {
+        lines.push(`error: ${error.message}`);
+    }
+    else if (error instanceof Error) {
+        lines.push(`error: ${error.message}`);
+    }
+    else {
+        lines.push(`error: ${String(error)}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/** "help" → "mext run help" · "help users" → "mext run users --help" */
+function usageCommand(prog, usage) {
+    const target = usage.replace(/^help\s*/, "");
+    return target === "" ? `${prog} help` : `${prog} ${cliPath(target)} --help`;
+}
+/** 입력 경로 → 플래그 표기 ("filter.minAge" → "--filter.min-age") */
+function flagOf(path) {
+    return `--${path
+        .split(".")
+        .map((s) => (/^\d+$/.test(s) ? s : toKebab(s)))
+        .join(".")}`;
+}
+/**
+ * 사람용 결과 텍스트 (끝 줄바꿈 포함, undefined = 빈 문자열).
+ * 문자열 = 그대로 · 원시 값 = String · 객체 배열 = 표 · 원시 배열 = 줄마다 · 객체 = 키 값 정렬. 중첩 값은 JSON 한 줄
+ */
+export function formatResult(value) {
+    if (value === undefined)
+        return "";
+    if (value === null)
+        return "null\n";
+    if (typeof value === "string")
+        return value.endsWith("\n") ? value : `${value}\n`;
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "(empty)\n";
+        if (value.every(isRecord)) {
+            const columns = [];
+            for (const row of value)
+                for (const k of Object.keys(row))
+                    if (!columns.includes(k))
+                        columns.push(k);
+            return lines(table([columns, ...value.map((row) => columns.map((c) => cell(row[c])))]));
+        }
+        return lines(value.map(cell));
+    }
+    if (isRecord(value)) {
+        const entries = Object.entries(value).filter(([, v]) => v !== undefined);
+        if (entries.length === 0)
+            return "(empty)\n";
+        return lines(table(entries.map(([k, v]) => [k, cell(v)])));
+    }
+    return `${cell(value)}\n`;
+}
+/** --json 결과 */
+export function formatJson(value) {
+    return `${JSON.stringify(value === undefined ? null : value, null, 2)}\n`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) && !(value instanceof Date);
+}
+function cell(value) {
+    if (value === undefined || value === null)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
+        return String(value);
+    if (value instanceof Date)
+        return value.toISOString();
+    return JSON.stringify(value) ?? "";
+}
+function lines(list) {
+    return `${list.join("\n")}\n`;
+}
+/** ctx.progress → stderr 한 줄 */
+export function formatProgress(update) {
+    const head = update.total !== undefined ? `[${update.progress}/${update.total}]` : `[${update.progress}]`;
+    return `${update.message ? `${head} ${update.message}` : head}\n`;
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ProgressUpdate } from \"../command.ts\"\nimport { isMextError, MextBuildError, MextError } from \"../errors.ts\"\nimport { toKebab } from \"./args.ts\"\nimport { cliPath, table } from \"./help.ts\"\n\n/** exit code (spec §5) */\nexport const EXIT = {\n  ok: 0,\n  error: 1,\n  usage: 2,\n  auth: 77,\n  interrupted: 130,\n} as const\n\n/** 실행 중 SIGINT (ctx.signal abort) 를 나타내는 CLI 내부 오류 */\nexport class CliInterrupted extends Error {\n  constructor() {\n    super(\"Interrupted.\")\n    this.name = \"CliInterrupted\"\n  }\n}\n\n/**\n * 오류 → exit code.\n * INVALID_ARGUMENT · UNKNOWN_COMMAND · INPUT_UNAVAILABLE = 2 · UNAUTHENTICATED · PERMISSION_DENIED = 77 · SIGINT = 130 · 그 외 = 1\n */\nexport function exitCodeOf(error: unknown): number {\n  if (error instanceof CliInterrupted) return EXIT.interrupted\n  if (error instanceof MextError) {\n    switch (error.code) {\n      case \"INVALID_ARGUMENT\":\n      case \"UNKNOWN_COMMAND\":\n      case \"INPUT_UNAVAILABLE\":\n        return EXIT.usage\n      case \"UNAUTHENTICATED\":\n      case \"PERMISSION_DENIED\":\n        return EXIT.auth\n    }\n  }\n  return EXIT.error\n}\n\n/**\n * --json 오류 본문. MextError = toJSON(), 빌드 오류 = BUILD_ERROR + issues,\n * SIGINT = INTERRUPTED, 핸들러 예외 = EXECUTION_ERROR\n */\nexport function errorJson(error: unknown): Record<string, unknown> {\n  if (error instanceof MextError) return error.toJSON()\n  if (error instanceof MextBuildError) return { code: \"BUILD_ERROR\", message: error.message, issues: error.issues }\n  if (error instanceof CliInterrupted) return { code: \"INTERRUPTED\", message: error.message }\n  return { code: \"EXECUTION_ERROR\", message: error instanceof Error ? error.message : String(error) }\n}\n\n/** 사람용 오류 텍스트 (끝 줄바꿈 포함) */\nexport function formatError(error: unknown, prog: string): string {\n  const lines: string[] = []\n  if (isMextError(error, \"INVALID_ARGUMENT\")) {\n    const d = error.details\n    lines.push(d.command === \"\" ? \"error: invalid arguments\" : `error: invalid arguments for ${cliPath(d.command)}`)\n    const rows = d.issues.map((i) => {\n      if (i.path === \"\") return [i.message]\n      return [flagOf(i.path), d.missing_fields.includes(i.path) ? \"required\" : i.message]\n    })\n    lines.push(...table(rows.filter((r) => r.length === 2)).map((l) => `  ${l}`))\n    lines.push(...rows.filter((r) => r.length === 1).map((r) => `  ${r[0]}`))\n    if (d.command !== \"\") lines.push(`Run \"${prog} ${cliPath(d.command)} --help\" for usage.`)\n  } else if (isMextError(error, \"UNKNOWN_COMMAND\")) {\n    const d = error.details\n    if (d.command === \"\") lines.push(\"error: no command given\")\n    else if (error.message.startsWith(\"Unknown command\")) lines.push(`error: unknown command \"${cliPath(d.command)}\"`)\n    else lines.push(`error: ${error.message}`)\n    if (d.suggested.length > 0) lines.push(`Did you mean: ${d.suggested.map((s) => `${prog} ${cliPath(s)}`).join(\", \")}?`)\n    lines.push(`Run \"${usageCommand(prog, d.usage)}\" for available commands.`)\n  } else if (isMextError(error, \"PERMISSION_DENIED\")) {\n    const d = error.details\n    lines.push(`error: ${error.message}`)\n    lines.push(`  required scopes: ${d.required_scopes.join(\", \") || \"(none)\"}`)\n    lines.push(`  held scopes: ${d.held_scopes.join(\", \") || \"(none)\"}`)\n  } else if (isMextError(error, \"UNAUTHENTICATED\")) {\n    lines.push(`error: ${error.message}`)\n    if (error.details.login !== undefined) lines.push(`Run \"${error.details.login}\" to log in.`)\n  } else if (isMextError(error, \"INPUT_UNAVAILABLE\")) {\n    lines.push(`error: ${error.message}`)\n  } else if (error instanceof Error) {\n    lines.push(`error: ${error.message}`)\n  } else {\n    lines.push(`error: ${String(error)}`)\n  }\n  return `${lines.join(\"\\n\")}\\n`\n}\n\n/** \"help\" → \"mext run help\" · \"help users\" → \"mext run users --help\" */\nfunction usageCommand(prog: string, usage: string): string {\n  const target = usage.replace(/^help\\s*/, \"\")\n  return target === \"\" ? `${prog} help` : `${prog} ${cliPath(target)} --help`\n}\n\n/** 입력 경로 → 플래그 표기 (\"filter.minAge\" → \"--filter.min-age\") */\nfunction flagOf(path: string): string {\n  return `--${path\n    .split(\".\")\n    .map((s) => (/^\\d+$/.test(s) ? s : toKebab(s)))\n    .join(\".\")}`\n}\n\n/**\n * 사람용 결과 텍스트 (끝 줄바꿈 포함, undefined = 빈 문자열).\n * 문자열 = 그대로 · 원시 값 = String · 객체 배열 = 표 · 원시 배열 = 줄마다 · 객체 = 키 값 정렬. 중첩 값은 JSON 한 줄\n */\nexport function formatResult(value: unknown): string {\n  if (value === undefined) return \"\"\n  if (value === null) return \"null\\n\"\n  if (typeof value === \"string\") return value.endsWith(\"\\n\") ? value : `${value}\\n`\n  if (Array.isArray(value)) {\n    if (value.length === 0) return \"(empty)\\n\"\n    if (value.every(isRecord)) {\n      const columns: string[] = []\n      for (const row of value) for (const k of Object.keys(row)) if (!columns.includes(k)) columns.push(k)\n      return lines(table([columns, ...value.map((row) => columns.map((c) => cell(row[c])))]))\n    }\n    return lines(value.map(cell))\n  }\n  if (isRecord(value)) {\n    const entries = Object.entries(value).filter(([, v]) => v !== undefined)\n    if (entries.length === 0) return \"(empty)\\n\"\n    return lines(table(entries.map(([k, v]) => [k, cell(v)])))\n  }\n  return `${cell(value)}\\n`\n}\n\n/** --json 결과 */\nexport function formatJson(value: unknown): string {\n  return `${JSON.stringify(value === undefined ? null : value, null, 2)}\\n`\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value) && !(value instanceof Date)\n}\n\nfunction cell(value: unknown): string {\n  if (value === undefined || value === null) return \"\"\n  if (typeof value === \"string\") return value\n  if (typeof value === \"number\" || typeof value === \"boolean\" || typeof value === \"bigint\") return String(value)\n  if (value instanceof Date) return value.toISOString()\n  return JSON.stringify(value) ?? \"\"\n}\n\nfunction lines(list: string[]): string {\n  return `${list.join(\"\\n\")}\\n`\n}\n\n/** ctx.progress → stderr 한 줄 */\nexport function formatProgress(update: ProgressUpdate): string {\n  const head = update.total !== undefined ? `[${update.progress}/${update.total}]` : `[${update.progress}]`\n  return `${update.message ? `${head} ${update.message}` : head}\\n`\n}\n"]}

package/dist/cli/remote.d.ts

@@ -0,0 +1,17 @@
+import type { CliIo } from "./io.ts";
+/**
+ * mext run --url <url> (또는 MEXT_URL) — 원격 실행. 고객 CLI 와 같은 runner (client/runner.ts, bin = mext, 서버 help).
+ * 토큰 = MEXT_TOKEN, 없으면 저장된 토큰 (mext login --url). 출력 · exit code 는 로컬 모드와 같다.
+ */
+export interface RemoteTarget {
+    url: string;
+    /** --url 을 뺀 mext run argv */
+    argv: string[];
+    /** MEXT_URL 에서 왔는지 (help 의 prog 표기) */
+    fromEnv: boolean;
+}
+/** mext run argv 앞쪽 플래그의 --url <url> · --url=<url>, 없으면 MEXT_URL. 둘 다 없으면 undefined (로컬) */
+export declare function remoteTarget(argv: readonly string[], env: Record<string, string | undefined>): RemoteTarget | undefined;
+/** mext login 안내 문구 */
+export declare function loginCommand(url: string): string;
+export declare function runRemoteCommand(target: RemoteTarget, io: CliIo): Promise<number>;

package/dist/cli/remote.js

@@ -0,0 +1,35 @@
+import { runRemote } from "../client/runner.js";
+import { VERSION } from "../version.js";
+import { RUN_PROG } from "./run.js";
+/** mext run argv 앞쪽 플래그의 --url <url> · --url=<url>, 없으면 MEXT_URL. 둘 다 없으면 undefined (로컬) */
+export function remoteTarget(argv, env) {
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (!tok.startsWith("-") || tok === "-" || tok === "--")
+            break;
+        if (tok === "--url" || tok.startsWith("--url=")) {
+            const url = tok === "--url" ? argv[i + 1] : tok.slice("--url=".length);
+            const rest = [...argv.slice(0, i), ...argv.slice(i + (tok === "--url" ? 2 : 1))];
+            return { url: url ?? "", argv: rest, fromEnv: false };
+        }
+    }
+    const url = env.MEXT_URL;
+    if (url !== undefined && url !== "")
+        return { url, argv: [...argv], fromEnv: true };
+    return undefined;
+}
+/** mext login 안내 문구 */
+export function loginCommand(url) {
+    return `mext login --url ${url}`;
+}
+export function runRemoteCommand(target, io) {
+    const { url } = target;
+    return runRemote({
+        bin: "mext",
+        url,
+        prog: target.fromEnv ? RUN_PROG : `${RUN_PROG} --url ${url}`,
+        login: loginCommand(url),
+        version: VERSION,
+    }, target.argv, io);
+}
+//# sourceMappingURL=remote.js.map

package/dist/cli/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../src/cli/remote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAenC,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,IAAuB,EAAE,GAAuC;IAC3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;QACpB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI;YAAE,MAAK;QAC9D,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YACtE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAChF,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QACvD,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAA;IACxB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACnF,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,oBAAoB,GAAG,EAAE,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,EAAS;IAC9D,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IACtB,OAAO,SAAS,CACd;QACE,GAAG,EAAE,MAAM;QACX,GAAG;QACH,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,UAAU,GAAG,EAAE;QAC5D,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC;QACxB,OAAO,EAAE,OAAO;KACjB,EACD,MAAM,CAAC,IAAI,EACX,EAAE,CACH,CAAA;AACH,CAAC","sourcesContent":["import { runRemote } from \"../client/runner.ts\"\nimport { VERSION } from \"../version.ts\"\nimport type { CliIo } from \"./io.ts\"\nimport { RUN_PROG } from \"./run.ts\"\n\n/**\n * mext run --url <url> (또는 MEXT_URL) — 원격 실행. 고객 CLI 와 같은 runner (client/runner.ts, bin = mext, 서버 help).\n * 토큰 = MEXT_TOKEN, 없으면 저장된 토큰 (mext login --url). 출력 · exit code 는 로컬 모드와 같다.\n */\n\nexport interface RemoteTarget {\n  url: string\n  /** --url 을 뺀 mext run argv */\n  argv: string[]\n  /** MEXT_URL 에서 왔는지 (help 의 prog 표기) */\n  fromEnv: boolean\n}\n\n/** mext run argv 앞쪽 플래그의 --url <url> · --url=<url>, 없으면 MEXT_URL. 둘 다 없으면 undefined (로컬) */\nexport function remoteTarget(argv: readonly string[], env: Record<string, string | undefined>): RemoteTarget | undefined {\n  for (let i = 0; i < argv.length; i++) {\n    const tok = argv[i]!\n    if (!tok.startsWith(\"-\") || tok === \"-\" || tok === \"--\") break\n    if (tok === \"--url\" || tok.startsWith(\"--url=\")) {\n      const url = tok === \"--url\" ? argv[i + 1] : tok.slice(\"--url=\".length)\n      const rest = [...argv.slice(0, i), ...argv.slice(i + (tok === \"--url\" ? 2 : 1))]\n      return { url: url ?? \"\", argv: rest, fromEnv: false }\n    }\n  }\n  const url = env.MEXT_URL\n  if (url !== undefined && url !== \"\") return { url, argv: [...argv], fromEnv: true }\n  return undefined\n}\n\n/** mext login 안내 문구 */\nexport function loginCommand(url: string): string {\n  return `mext login --url ${url}`\n}\n\nexport function runRemoteCommand(target: RemoteTarget, io: CliIo): Promise<number> {\n  const { url } = target\n  return runRemote(\n    {\n      bin: \"mext\",\n      url,\n      prog: target.fromEnv ? RUN_PROG : `${RUN_PROG} --url ${url}`,\n      login: loginCommand(url),\n      version: VERSION,\n    },\n    target.argv,\n    io,\n  )\n}\n"]}

package/dist/cli/run.d.ts

@@ -0,0 +1,14 @@
+import { type Registry } from "../registry.ts";
+import { type CliIo } from "./io.ts";
+export declare const RUN_PROG = "mext run";
+/**
+ * mext run <ns> <cmd> [flags] — 로컬 실행 (ctx.principal.kind = local, mext.config.ts 의 localPrincipal 로 변경 가능).
+ * mext run help [target] · mext run [<ns> [<cmd>]] --help · --json · --yes.
+ * --url <url> (또는 MEXT_URL) = 원격 실행 (cli/remote.ts)
+ */
+export declare function runCommand(argv: readonly string[], io: CliIo): Promise<number>;
+/** 앞쪽 경로 토큰 → 가장 긴 네임스페이스 · 명령어 (별칭 포함) ID */
+export declare function resolvePath(registry: Registry, tokens: readonly string[]): {
+    id: string;
+    consumed: number;
+};

package/dist/cli/run.js

@@ -0,0 +1,218 @@
+import { createApp, loadConfig, resolveCommandsDir, resolveLocalPrincipal } from "../config.js";
+import { MextError } from "../errors.js";
+import { isSegment } from "../ids.js";
+import { loadProjectInstrumentation } from "../instrumentation.js";
+import { authorize, findCommand, invoke } from "../invoke.js";
+import { help } from "../mcp/help.js";
+import { resolveCommand } from "../registry.js";
+import { loadRegistry } from "../scan.js";
+import { analyzeInput, assertCliConvertible, coerceValue, parseArgs } from "./args.js";
+import { cliPath, renderHelp } from "./help.js";
+import { createLineReader, readAll } from "./io.js";
+import { CliInterrupted, EXIT, errorJson, exitCodeOf, formatError, formatJson, formatProgress, formatResult } from "./output.js";
+import { remoteTarget, runRemoteCommand } from "./remote.js";
+export const RUN_PROG = "mext run";
+/**
+ * mext run <ns> <cmd> [flags] — 로컬 실행 (ctx.principal.kind = local, mext.config.ts 의 localPrincipal 로 변경 가능).
+ * mext run help [target] · mext run [<ns> [<cmd>]] --help · --json · --yes.
+ * --url <url> (또는 MEXT_URL) = 원격 실행 (cli/remote.ts)
+ */
+export async function runCommand(argv, io) {
+    const remote = remoteTarget(argv, io.env);
+    if (remote)
+        return runRemoteCommand(remote, io);
+    const prog = RUN_PROG;
+    const lead = { json: false, yes: false, help: false };
+    let i = 0;
+    for (; i < argv.length; i++) {
+        const tok = argv[i];
+        if (!tok.startsWith("-") || tok === "-")
+            break;
+        if (tok === "--json")
+            lead.json = true;
+        else if (tok === "--yes")
+            lead.yes = true;
+        else if (tok === "--help" || tok === "-h")
+            lead.help = true;
+        else {
+            return report(usageError(`unknown flag ${tok} before the command`), io, prog, argv.includes("--json"));
+        }
+    }
+    const rest = argv.slice(i);
+    const beforeDashDash = rest.indexOf("--") < 0 ? rest : rest.slice(0, rest.indexOf("--"));
+    const json = lead.json || beforeDashDash.includes("--json");
+    const lines = createLineReader(io);
+    try {
+        // instrumentation.ts register() = 설정 · 명령어 모듈 import 전 (프로세스당 1회)
+        const instrumentation = await loadProjectInstrumentation(io.cwd);
+        const config = await loadConfig(io.cwd);
+        const registry = await loadRegistry(resolveCommandsDir(io.cwd, config));
+        assertCliConvertible(registry);
+        // mext run help [target...]
+        if (rest[0] === "help") {
+            const targetTokens = rest.slice(1).filter((t) => !t.startsWith("-"));
+            const { id, consumed } = resolvePath(registry, targetTokens);
+            if (consumed < targetTokens.length)
+                throw unknownAt(registry, id, targetTokens.slice(consumed));
+            return printHelp(registry, id, io, prog, json, config.tools);
+        }
+        const { id, consumed } = resolvePath(registry, rest);
+        const entry = id === "" ? undefined : resolveCommand(registry, id);
+        const next = rest[consumed];
+        const acceptsPositional = entry !== undefined && entry.command.positional.length > 0;
+        if (registry.namespaces.has(id) && next !== undefined && !next.startsWith("-") && !acceptsPositional) {
+            throw unknownAt(registry, id, rest.slice(consumed));
+        }
+        if (entry === undefined && next !== undefined && !next.startsWith("-")) {
+            throw unknownAt(registry, id, rest.slice(consumed));
+        }
+        const help = lead.help || beforeDashDash.includes("--help") || beforeDashDash.includes("-h");
+        if (help)
+            return printHelp(registry, id, io, prog, json, config.tools);
+        if (!entry) {
+            // 네임스페이스 (루트 포함) 만 지정 = 명령어 없음
+            const error = new MextError("UNKNOWN_COMMAND", id === "" ? "No command given." : `"${cliPath(id)}" is a namespace. Specify a command.`, { command: id, suggested: [], usage: id === "" ? "help" : `help ${id}` });
+            if (json)
+                return report(error, io, prog, true);
+            io.stderr.write(formatError(error, prog));
+            io.stderr.write(`\n${renderHelp(registry, id, { prog })}`);
+            return EXIT.usage;
+        }
+        const principal = await resolveLocalPrincipal(config);
+        authorize(entry, principal); // 권한 → 입력 검증 순서 (invoke 와 같음)
+        const parsed = await parseArgs(entry, rest.slice(consumed), { readStdin: () => readAll(io.stdin) });
+        const yes = lead.yes || parsed.yes;
+        const app = await createApp(config);
+        const controller = new AbortController();
+        const onAbort = () => controller.abort(io.signal?.reason);
+        if (io.signal?.aborted)
+            onAbort();
+        io.signal?.addEventListener("abort", onAbort, { once: true });
+        try {
+            const result = await invoke(registry, entry.id, parsed.input, {
+                principal,
+                signal: controller.signal,
+                progress: (update) => io.stderr.write(formatProgress(update)),
+                ask: askHandler(io, lines, yes, controller.signal),
+                app,
+                instrumentation,
+                transport: "local",
+            });
+            if (controller.signal.aborted)
+                throw new CliInterrupted();
+            io.stdout.write(json ? formatJson(result.value) : formatResult(result.value));
+            return EXIT.ok;
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new CliInterrupted();
+            throw error;
+        }
+        finally {
+            io.signal?.removeEventListener("abort", onAbort);
+        }
+    }
+    catch (error) {
+        return report(error, io, prog, json);
+    }
+    finally {
+        lines.close();
+    }
+}
+/** 앞쪽 경로 토큰 → 가장 긴 네임스페이스 · 명령어 (별칭 포함) ID */
+export function resolvePath(registry, tokens) {
+    let id = "";
+    let consumed = 0;
+    for (const tok of tokens) {
+        if (!isSegment(tok))
+            break;
+        const candidate = id === "" ? tok : `${id}.${tok}`;
+        if (!registry.namespaces.has(candidate) && !resolveCommand(registry, candidate))
+            break;
+        id = candidate;
+        consumed++;
+    }
+    return { id, consumed };
+}
+/** 해석되지 않은 경로 토큰 → UNKNOWN_COMMAND (suggested · usage) */
+function unknownAt(registry, id, tail) {
+    const segs = [];
+    for (const t of tail) {
+        if (t.startsWith("-") || (segs.length > 0 && !isSegment(t)))
+            break;
+        segs.push(t);
+        if (!isSegment(t))
+            break;
+    }
+    const unknown = [id, ...segs].filter((s) => s !== "").join(".");
+    try {
+        findCommand(registry, unknown);
+    }
+    catch (error) {
+        if (error instanceof MextError)
+            return error;
+        throw error;
+    }
+    return new MextError("UNKNOWN_COMMAND", `Unknown command "${unknown}".`, { command: unknown, suggested: [], usage: "help" });
+}
+/** --help --json = MCP help 의 structuredContent 와 같은 데이터 (mext mcp 의 tools 노출 기준) */
+function printHelp(registry, id, io, prog, json, tools) {
+    const toolFor = tools === "split" ? (e) => (e.command.readOnly ? "query" : "mutate") : undefined;
+    io.stdout.write(json ? formatJson(help(registry, id, toolFor ? { toolFor } : {})) : renderHelp(registry, id, { prog }));
+    return EXIT.ok;
+}
+function report(error, io, prog, json) {
+    io.stderr.write(json ? formatJson(errorJson(error)) : formatError(error, prog));
+    return exitCodeOf(error);
+}
+function usageError(message) {
+    return new MextError("INVALID_ARGUMENT", message, {
+        command: "",
+        missing_fields: [],
+        issues: [{ path: "", code: "unknown_flag", message }],
+        expected_schema: {},
+        examples: [],
+    });
+}
+/**
+ * ctx.ask. --yes = confirm 승인. TTY 없음 = 즉시 INPUT_UNAVAILABLE.
+ * TTY = stderr 프롬프트 + stdin 한 줄 (confirm = y/yes, input = 필드별 입력을 스키마 모양으로 변환)
+ */
+function askHandler(io, lines, yes, signal) {
+    return async (request) => {
+        if (request.kind === "confirm" && yes)
+            return true;
+        if (!io.isTTY) {
+            const hint = request.kind === "confirm" ? " Pass --yes to approve." : " Run it in an interactive terminal.";
+            throw new MextError("INPUT_UNAVAILABLE", `${request.command} asked "${request.message}", but stdin is not a terminal.${hint}`, { command: request.command });
+        }
+        if (request.kind === "confirm") {
+            const answer = await lines.question(`${request.message} [y/N] `, signal);
+            if (signal.aborted)
+                throw new CliInterrupted();
+            return /^y(es)?$/i.test((answer ?? "").trim());
+        }
+        io.stderr.write(`${request.message}\n`);
+        const { spec } = analyzeInput(request.schema, request.requestedSchema);
+        const out = {};
+        for (const f of spec.fields) {
+            const answer = await lines.question(`  ${f.key}${f.required ? "" : " (optional)"}: `, signal);
+            if (signal.aborted)
+                throw new CliInterrupted();
+            if (answer === undefined || answer === "")
+                continue;
+            if (f.kind.type === "array") {
+                const kind = f.kind;
+                out[f.key] = answer.split(",").map((s) => {
+                    const r = coerceValue(kind, s.trim());
+                    return r.ok ? r.value : s;
+                });
+                continue;
+            }
+            const r = coerceValue(f.kind, answer);
+            out[f.key] = r.ok ? r.value : answer;
+        }
+        return out;
+    };
+}
+//# sourceMappingURL=run.js.map