@obov/mext 0.0.0-stage → 0.2.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,78 @@
+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;
+/** cli.errors formatter 입력: 오류 하나 + mext 기본 출력 */
+export interface CliErrorInfo {
+    /** MextErrorCode · EXECUTION_ERROR · INTERRUPTED · REMOTE_ERROR · 서버 핸들러 오류 code 등 (= body.code) */
+    code: string;
+    message: string;
+    /** 오류 상세 (MextError.details · 서버 오류 본문의 code · message 외 필드) */
+    details: Record<string, unknown>;
+    /** INVALID_ARGUMENT issues 의 "경로: 메시지" (경로 없으면 메시지). 그 외 [] */
+    reasons: string[];
+    /** mext 기본 --json 오류 본문 */
+    body: Record<string, unknown>;
+    /** mext 기본 사람용 텍스트 (끝 줄바꿈 포함) */
+    text: string;
+    /** mext 기본 exit code (0 · 1 · 2 · 77 · 130) */
+    exitCode: number;
+    /** --json 지정 여부 */
+    json: boolean;
+}
+/** formatter 출력. 지정한 필드만 기본값 대체 (stderr 기본 = json ? body JSON : text, stdout 기본 = 없음) */
+export interface CliErrorOutput {
+    exitCode?: number;
+    stderr?: string;
+    stdout?: string;
+}
+/** cli.errors 모듈의 default export. undefined 반환 = mext 기본 */
+export type CliErrorFormatter = (error: CliErrorInfo) => CliErrorOutput | undefined | void;
+export interface CliErrorWriter {
+    stdout: {
+        write(chunk: string): unknown;
+    };
+    stderr: {
+        write(chunk: string): unknown;
+    };
+}
+/**
+ * 오류 출력 (기본 = json ? body : text) + formatter 적용 → exit code.
+ * formatter 예외 · 잘못된 exitCode = 기본값 + stderr 경고 1줄
+ */
+export declare function emitError(io: CliErrorWriter, error: {
+    body: Record<string, unknown>;
+    text: string;
+    exitCode: number;
+    json: boolean;
+}, formatter: CliErrorFormatter | undefined): number;

package/dist/cli/output.js

@@ -0,0 +1,229 @@
+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`;
+}
+/**
+ * 오류 출력 (기본 = json ? body : text) + formatter 적용 → exit code.
+ * formatter 예외 · 잘못된 exitCode = 기본값 + stderr 경고 1줄
+ */
+export function emitError(io, error, formatter) {
+    const fallback = error.json ? formatJson(error.body) : error.text;
+    if (!formatter) {
+        io.stderr.write(fallback);
+        return error.exitCode;
+    }
+    const { code, message, ...rest } = error.body;
+    const details = isRecord(rest.details) ? rest.details : rest;
+    const info = {
+        code: typeof code === "string" ? code : "EXECUTION_ERROR",
+        message: typeof message === "string" ? message : String(message ?? ""),
+        details,
+        reasons: reasonsOf(details),
+        body: error.body,
+        text: error.text,
+        exitCode: error.exitCode,
+        json: error.json,
+    };
+    let out;
+    try {
+        out = formatter(info);
+    }
+    catch (e) {
+        io.stderr.write(fallback);
+        io.stderr.write(`warning: cli.errors formatter failed: ${e instanceof Error ? e.message : String(e)}\n`);
+        return error.exitCode;
+    }
+    if (out === undefined || out === null) {
+        io.stderr.write(fallback);
+        return error.exitCode;
+    }
+    if (out.stdout !== undefined)
+        io.stdout.write(out.stdout);
+    io.stderr.write(out.stderr ?? fallback);
+    if (out.exitCode === undefined)
+        return error.exitCode;
+    if (!Number.isInteger(out.exitCode) || out.exitCode < 0 || out.exitCode > 255) {
+        io.stderr.write(`warning: cli.errors formatter returned an invalid exitCode (${String(out.exitCode)})\n`);
+        return error.exitCode;
+    }
+    return out.exitCode;
+}
+/** INVALID_ARGUMENT details.issues → "경로: 메시지" */
+function reasonsOf(details) {
+    const issues = details.issues;
+    if (!Array.isArray(issues))
+        return [];
+    return issues.flatMap((i) => {
+        if (!isRecord(i) || typeof i.message !== "string")
+            return [];
+        return [typeof i.path === "string" && i.path !== "" ? `${i.path}: ${i.message}` : i.message];
+    });
+}
+//# 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\n/* ---------------------------------------------------------------- 오류 출력 커스텀 (cli.errors, spec §5) */\n\n/** cli.errors formatter 입력: 오류 하나 + mext 기본 출력 */\nexport interface CliErrorInfo {\n  /** MextErrorCode · EXECUTION_ERROR · INTERRUPTED · REMOTE_ERROR · 서버 핸들러 오류 code 등 (= body.code) */\n  code: string\n  message: string\n  /** 오류 상세 (MextError.details · 서버 오류 본문의 code · message 외 필드) */\n  details: Record<string, unknown>\n  /** INVALID_ARGUMENT issues 의 \"경로: 메시지\" (경로 없으면 메시지). 그 외 [] */\n  reasons: string[]\n  /** mext 기본 --json 오류 본문 */\n  body: Record<string, unknown>\n  /** mext 기본 사람용 텍스트 (끝 줄바꿈 포함) */\n  text: string\n  /** mext 기본 exit code (0 · 1 · 2 · 77 · 130) */\n  exitCode: number\n  /** --json 지정 여부 */\n  json: boolean\n}\n\n/** formatter 출력. 지정한 필드만 기본값 대체 (stderr 기본 = json ? body JSON : text, stdout 기본 = 없음) */\nexport interface CliErrorOutput {\n  exitCode?: number\n  stderr?: string\n  stdout?: string\n}\n\n/** cli.errors 모듈의 default export. undefined 반환 = mext 기본 */\nexport type CliErrorFormatter = (error: CliErrorInfo) => CliErrorOutput | undefined | void\n\nexport interface CliErrorWriter {\n  stdout: { write(chunk: string): unknown }\n  stderr: { write(chunk: string): unknown }\n}\n\n/**\n * 오류 출력 (기본 = json ? body : text) + formatter 적용 → exit code.\n * formatter 예외 · 잘못된 exitCode = 기본값 + stderr 경고 1줄\n */\nexport function emitError(\n  io: CliErrorWriter,\n  error: { body: Record<string, unknown>; text: string; exitCode: number; json: boolean },\n  formatter: CliErrorFormatter | undefined,\n): number {\n  const fallback = error.json ? formatJson(error.body) : error.text\n  if (!formatter) {\n    io.stderr.write(fallback)\n    return error.exitCode\n  }\n  const { code, message, ...rest } = error.body\n  const details = isRecord(rest.details) ? rest.details : rest\n  const info: CliErrorInfo = {\n    code: typeof code === \"string\" ? code : \"EXECUTION_ERROR\",\n    message: typeof message === \"string\" ? message : String(message ?? \"\"),\n    details,\n    reasons: reasonsOf(details),\n    body: error.body,\n    text: error.text,\n    exitCode: error.exitCode,\n    json: error.json,\n  }\n  let out: CliErrorOutput | undefined | void\n  try {\n    out = formatter(info)\n  } catch (e) {\n    io.stderr.write(fallback)\n    io.stderr.write(`warning: cli.errors formatter failed: ${e instanceof Error ? e.message : String(e)}\\n`)\n    return error.exitCode\n  }\n  if (out === undefined || out === null) {\n    io.stderr.write(fallback)\n    return error.exitCode\n  }\n  if (out.stdout !== undefined) io.stdout.write(out.stdout)\n  io.stderr.write(out.stderr ?? fallback)\n  if (out.exitCode === undefined) return error.exitCode\n  if (!Number.isInteger(out.exitCode) || out.exitCode < 0 || out.exitCode > 255) {\n    io.stderr.write(`warning: cli.errors formatter returned an invalid exitCode (${String(out.exitCode)})\\n`)\n    return error.exitCode\n  }\n  return out.exitCode\n}\n\n/** INVALID_ARGUMENT details.issues → \"경로: 메시지\" */\nfunction reasonsOf(details: Record<string, unknown>): string[] {\n  const issues = details.issues\n  if (!Array.isArray(issues)) return []\n  return issues.flatMap((i) => {\n    if (!isRecord(i) || typeof i.message !== \"string\") return []\n    return [typeof i.path === \"string\" && i.path !== \"\" ? `${i.path}: ${i.message}` : i.message]\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;
+};