@obov/mext 0.0.0-stage → 0.1.0

package/dist/cli/run.js.map

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

package/dist/cli/start.d.ts

@@ -0,0 +1,8 @@
+import type { CliIo } from "./io.ts";
+export declare const START_PROG = "mext start";
+/**
+ * mext start [--stdio] [--port <n>] [--host <h>] = startFromBuild(<cwd>/.mext) (node .mext/server.js 와 같음).
+ * .mext/ 만 읽는다 (소스 스캔 · 감시 · TypeScript 없음). 종료 = SIGINT · SIGTERM
+ */
+export declare function startCommand(argv: readonly string[], io: CliIo): Promise<number>;
+export declare function startHelp(): string;

package/dist/cli/start.js

@@ -0,0 +1,37 @@
+import { join } from "node:path";
+import { BUILD_DIR } from "../build.js";
+import { startFromBuild } from "../start.js";
+import { table } from "./help.js";
+import { EXIT } from "./output.js";
+export const START_PROG = "mext start";
+/**
+ * mext start [--stdio] [--port <n>] [--host <h>] = startFromBuild(<cwd>/.mext) (node .mext/server.js 와 같음).
+ * .mext/ 만 읽는다 (소스 스캔 · 감시 · TypeScript 없음). 종료 = SIGINT · SIGTERM
+ */
+export async function startCommand(argv, io) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        io.stdout.write(startHelp());
+        return EXIT.ok;
+    }
+    return startFromBuild(join(io.cwd, BUILD_DIR), { argv, env: io.env, stderr: io.stderr });
+}
+export function startHelp() {
+    const lines = [
+        "Production MCP server from .mext/ (run mext build first). No source scan, no file watching.",
+        "",
+        "Usage:",
+        `  ${START_PROG} [--port <n>] [--host <h>]   Streamable HTTP (POST /mcp)`,
+        `  ${START_PROG} --stdio                     stdio`,
+        "",
+        "Flags:",
+        ...table([
+            ["--stdio", "Serve MCP over stdin/stdout"],
+            ["--port <n>", "HTTP port (default: PORT, then mext.config.ts server.port, then 3100)"],
+            ["--host <h>", "HTTP host (default: HOST, then mext.config.ts server.host, then 127.0.0.1)"],
+        ]).map((l) => `  ${l}`),
+        "",
+        "Same as: node .mext/server.js [--stdio]",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAElC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAA;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAuB,EAAE,EAAS;IACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;QAC5B,OAAO,IAAI,CAAC,EAAE,CAAA;IAChB,CAAC;IACD,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GAAG;QACZ,6FAA6F;QAC7F,EAAE;QACF,QAAQ;QACR,KAAK,UAAU,0DAA0D;QACzE,KAAK,UAAU,oCAAoC;QACnD,EAAE;QACF,QAAQ;QACR,GAAG,KAAK,CAAC;YACP,CAAC,SAAS,EAAE,6BAA6B,CAAC;YAC1C,CAAC,YAAY,EAAE,uEAAuE,CAAC;YACvF,CAAC,YAAY,EAAE,4EAA4E,CAAC;SAC7F,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,EAAE;QACF,yCAAyC;KAC1C,CAAA;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAChC,CAAC","sourcesContent":["import { join } from \"node:path\"\nimport { BUILD_DIR } from \"../build.ts\"\nimport { startFromBuild } from \"../start.ts\"\nimport { table } from \"./help.ts\"\nimport type { CliIo } from \"./io.ts\"\nimport { EXIT } from \"./output.ts\"\n\nexport const START_PROG = \"mext start\"\n\n/**\n * mext start [--stdio] [--port <n>] [--host <h>] = startFromBuild(<cwd>/.mext) (node .mext/server.js 와 같음).\n * .mext/ 만 읽는다 (소스 스캔 · 감시 · TypeScript 없음). 종료 = SIGINT · SIGTERM\n */\nexport async function startCommand(argv: readonly string[], io: CliIo): Promise<number> {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    io.stdout.write(startHelp())\n    return EXIT.ok\n  }\n  return startFromBuild(join(io.cwd, BUILD_DIR), { argv, env: io.env, stderr: io.stderr })\n}\n\nexport function startHelp(): string {\n  const lines = [\n    \"Production MCP server from .mext/ (run mext build first). No source scan, no file watching.\",\n    \"\",\n    \"Usage:\",\n    `  ${START_PROG} [--port <n>] [--host <h>]   Streamable HTTP (POST /mcp)`,\n    `  ${START_PROG} --stdio                     stdio`,\n    \"\",\n    \"Flags:\",\n    ...table([\n      [\"--stdio\", \"Serve MCP over stdin/stdout\"],\n      [\"--port <n>\", \"HTTP port (default: PORT, then mext.config.ts server.port, then 3100)\"],\n      [\"--host <h>\", \"HTTP host (default: HOST, then mext.config.ts server.host, then 127.0.0.1)\"],\n    ]).map((l) => `  ${l}`),\n    \"\",\n    \"Same as: node .mext/server.js [--stdio]\",\n  ]\n  return `${lines.join(\"\\n\")}\\n`\n}\n"]}

package/dist/client/cache.d.ts

@@ -0,0 +1,104 @@
+import type { Help } from "../mcp/help.ts";
+import { type RemoteTool } from "../remote/client.ts";
+import { type ClientManifest } from "./manifest.ts";
+/**
+ * 원격 스키마 캐시 · drift 감지 (§5 스키마 drift). 고객 CLI · mext run --url 공용 (번들 포함, Node 내장만 import).
+ *
+ * D4. 파일 = <cache dir>/<sha256(정규화 서버 URL) 앞 16 hex>.json, 쓰기 = 같은 폴더 임시 파일 → rename (원자적).
+ * cache dir = <BIN>_CACHE_DIR → $XDG_CACHE_HOME/<bin> → $HOME/.cache/<bin>. 셋 다 없음 = 캐시 없음.
+ * 내용 = SchemaCacheEntry. url · client (bin · version · mext 버전) 가 다르면 무효, 수명 = tools/list ttlMs.
+ *
+ * 이번 실행의 help 출처 (mode):
+ *   cache     유효 캐시 (수명 안 · stale 아님). help = 캐시 → (해시 = 내장 manifest 면) 내장 manifest → 서버 (캐시에 추가)
+ *   embedded  번들 형태 · 유효 캐시 없음 · 서버가 내장 manifest 와 다르다는 기록 없음. help = 내장 manifest
+ *   server    그 외 (범용 · stale · 서버가 내장 manifest 와 다름). help = 서버 (tools/list + help), 캐시 새로 씀
+ * tools/call 결과 _meta 의 manifestHash ≠ 이번 help 의 해시 = stale 표시 (이번 결과는 그대로, 다음 실행이 server).
+ * 로컬 파싱 실패 = refetch() 로 server 전환 후 1회 재시도 (runner). 오프라인 = 남은 캐시 · 내장 manifest 로 help 만
+ */
+export declare const SCHEMA_CACHE_FORMAT = 1;
+/** 캐시 무효화 단위. 하나라도 다르면 캐시 무시 */
+export interface CacheClient {
+    /** 실행 파일 이름 (clientInfo.name) */
+    bin: string;
+    /** clientInfo.version (고객 CLI = cli.version, mext = mext 버전) */
+    version: string;
+    /** 클라이언트 런타임의 @obov/mext 버전 (help 해석 코드) */
+    mext: string;
+}
+/** help 결과 또는 UNKNOWN_COMMAND (경로 해석이 가장 긴 접두부터 시도하므로 없는 대상도 기록) */
+export type CachedHelp = {
+    help: Help;
+} | {
+    error: Record<string, unknown> & {
+        code: string;
+        message: string;
+    };
+};
+export interface SchemaCacheEntry {
+    format: typeof SCHEMA_CACHE_FORMAT;
+    /** 정규화 서버 URL (파일 이름 해시 충돌 확인) */
+    url: string;
+    client: CacheClient;
+    /** help · tools 가 속한 서버 manifestHash. 없음 = 서버가 보내지 않음 */
+    manifestHash?: string;
+    /** tools/list 받은 시각 (epoch ms) */
+    fetchedAt: number;
+    /** tools/list ttlMs. 0 = 매 실행 재조회 (오프라인 help 용으로만 남김) */
+    ttlMs: number;
+    /** 서버 manifestHash 가 help 와 다름을 관찰. 다음 실행에서 서버 help 재조회 */
+    stale?: true;
+    /** tools/list 결과 */
+    tools: RemoteTool[];
+    /** help 대상 ("" = 루트) → 결과 */
+    help: Record<string, CachedHelp>;
+}
+/** <BIN>_CACHE_DIR → $XDG_CACHE_HOME/<bin> → $HOME/.cache/<bin> (USERPROFILE). 없으면 undefined (캐시 없음) */
+export declare function schemaCacheDir(bin: string, env: Record<string, string | undefined>): string | undefined;
+/** <dir>/<sha256(canonicalServerUrl(url)) 앞 16 hex>.json */
+export declare function schemaCacheFile(dir: string, url: string): string;
+/** 읽기 + 형식 · url · client 확인. 없음 · 깨짐 · 불일치 = undefined */
+export declare function readSchemaCache(file: string, url: string, client: CacheClient): Promise<SchemaCacheEntry | undefined>;
+/** 원자적 쓰기 (임시 파일 → rename). 실패는 호출자가 무시 (캐시는 최선) */
+export declare function writeSchemaCache(file: string, entry: SchemaCacheEntry): Promise<void>;
+export declare function isFresh(entry: SchemaCacheEntry, now: number): boolean;
+export type SchemaMode = "cache" | "embedded" | "server";
+export interface FetchedHelp {
+    value: CachedHelp;
+    /** 응답 _meta["dev.mext/manifestHash"] */
+    hash: string | undefined;
+}
+export interface SchemaOptions {
+    /** 캐시 파일. undefined = 캐시 없음 (읽기 · 쓰기 안 함) */
+    file: string | undefined;
+    url: string;
+    client: CacheClient;
+    /** 번들 형태의 내장 manifest + 빌드 시 manifestHash */
+    embedded?: {
+        manifest: ClientManifest;
+        hash: string;
+    };
+    /** 서버 help (tools/call help). UNKNOWN_COMMAND 는 value.error, 그 외 오류 = throw */
+    fetchHelp(target: string, tools: () => Promise<RemoteTool[]>): Promise<FetchedHelp>;
+    /** 서버 tools/list */
+    fetchTools(): Promise<{
+        tools: RemoteTool[];
+        ttlMs?: number;
+    }>;
+    /** 오프라인 help 안내 (stderr) */
+    warn(message: string): void;
+    now?: () => number;
+}
+export interface Schema {
+    readonly mode: SchemaMode;
+    /** HelpSource: 대상 → help. 없는 대상 = MextError UNKNOWN_COMMAND */
+    help(target: string): Promise<Help>;
+    /** 로컬 (cache · embedded) 파싱 실패 후 서버 help 로 전환. 이미 server = false (재시도 안 함) */
+    refetch(): boolean;
+    /** dispatcher 도구 목록 (유효 캐시 = 네트워크 없음) */
+    tools(): Promise<RemoteTool[]>;
+    /** tools/call 결과 _meta 의 manifestHash 관찰. 이번 help 의 해시와 다르면 stale */
+    observe(hash: string | undefined): void;
+    /** 바뀐 내용이 있으면 캐시 파일 쓰기 (실패 무시) */
+    save(): Promise<void>;
+}
+export declare function openSchema(options: SchemaOptions): Promise<Schema>;

package/dist/client/cache.js

@@ -0,0 +1,208 @@
+import { createHash, randomBytes } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { MextError } from "../errors.js";
+import { isRecord, RemoteTransportError } from "../remote/client.js";
+import { canonicalServerUrl, envPrefix } from "../remote/credentials.js";
+import { manifestHelp } from "./manifest.js";
+/**
+ * 원격 스키마 캐시 · drift 감지 (§5 스키마 drift). 고객 CLI · mext run --url 공용 (번들 포함, Node 내장만 import).
+ *
+ * D4. 파일 = <cache dir>/<sha256(정규화 서버 URL) 앞 16 hex>.json, 쓰기 = 같은 폴더 임시 파일 → rename (원자적).
+ * cache dir = <BIN>_CACHE_DIR → $XDG_CACHE_HOME/<bin> → $HOME/.cache/<bin>. 셋 다 없음 = 캐시 없음.
+ * 내용 = SchemaCacheEntry. url · client (bin · version · mext 버전) 가 다르면 무효, 수명 = tools/list ttlMs.
+ *
+ * 이번 실행의 help 출처 (mode):
+ *   cache     유효 캐시 (수명 안 · stale 아님). help = 캐시 → (해시 = 내장 manifest 면) 내장 manifest → 서버 (캐시에 추가)
+ *   embedded  번들 형태 · 유효 캐시 없음 · 서버가 내장 manifest 와 다르다는 기록 없음. help = 내장 manifest
+ *   server    그 외 (범용 · stale · 서버가 내장 manifest 와 다름). help = 서버 (tools/list + help), 캐시 새로 씀
+ * tools/call 결과 _meta 의 manifestHash ≠ 이번 help 의 해시 = stale 표시 (이번 결과는 그대로, 다음 실행이 server).
+ * 로컬 파싱 실패 = refetch() 로 server 전환 후 1회 재시도 (runner). 오프라인 = 남은 캐시 · 내장 manifest 로 help 만
+ */
+export const SCHEMA_CACHE_FORMAT = 1;
+/** <BIN>_CACHE_DIR → $XDG_CACHE_HOME/<bin> → $HOME/.cache/<bin> (USERPROFILE). 없으면 undefined (캐시 없음) */
+export function schemaCacheDir(bin, env) {
+    const forced = env[`${envPrefix(bin)}_CACHE_DIR`];
+    if (forced)
+        return forced;
+    if (env.XDG_CACHE_HOME)
+        return join(env.XDG_CACHE_HOME, bin);
+    const home = env.HOME || env.USERPROFILE;
+    return home ? join(home, ".cache", bin) : undefined;
+}
+/** <dir>/<sha256(canonicalServerUrl(url)) 앞 16 hex>.json */
+export function schemaCacheFile(dir, url) {
+    return join(dir, `${createHash("sha256").update(canonicalServerUrl(url)).digest("hex").slice(0, 16)}.json`);
+}
+/** 읽기 + 형식 · url · client 확인. 없음 · 깨짐 · 불일치 = undefined */
+export async function readSchemaCache(file, url, client) {
+    let value;
+    try {
+        value = JSON.parse(await readFile(file, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRecord(value) || value.format !== SCHEMA_CACHE_FORMAT || value.url !== canonicalServerUrl(url))
+        return undefined;
+    const c = value.client;
+    if (!isRecord(c) || c.bin !== client.bin || c.version !== client.version || c.mext !== client.mext)
+        return undefined;
+    if (typeof value.fetchedAt !== "number" || typeof value.ttlMs !== "number")
+        return undefined;
+    if (!Array.isArray(value.tools) || !isRecord(value.help))
+        return undefined;
+    if (value.manifestHash !== undefined && typeof value.manifestHash !== "string")
+        return undefined;
+    return value;
+}
+/** 원자적 쓰기 (임시 파일 → rename). 실패는 호출자가 무시 (캐시는 최선) */
+export async function writeSchemaCache(file, entry) {
+    const dir = join(file, "..");
+    await mkdir(dir, { recursive: true });
+    const tmp = `${file}.${process.pid}.${randomBytes(4).toString("hex")}.tmp`;
+    try {
+        await writeFile(tmp, `${JSON.stringify(entry)}\n`);
+        await rename(tmp, file);
+    }
+    catch (error) {
+        await rm(tmp, { force: true }).catch(() => { });
+        throw error;
+    }
+}
+export function isFresh(entry, now) {
+    return entry.stale !== true && entry.ttlMs > 0 && now >= entry.fetchedAt && now < entry.fetchedAt + entry.ttlMs;
+}
+export async function openSchema(options) {
+    const clock = options.now ?? Date.now;
+    const started = clock();
+    const { embedded } = options;
+    const previous = options.file ? await readSchemaCache(options.file, options.url, options.client) : undefined;
+    const diverged = previous !== undefined &&
+        (previous.stale === true || (embedded !== undefined && previous.manifestHash !== undefined && previous.manifestHash !== embedded.hash));
+    let mode = previous !== undefined && isFresh(previous, started) ? "cache" : embedded && !diverged ? "embedded" : "server";
+    const cached = mode === "cache" ? previous : undefined;
+    let hash = cached ? cached.manifestHash : mode === "embedded" ? embedded.hash : undefined;
+    let help = cached ? { ...cached.help } : {};
+    let tools = cached?.tools;
+    let fetchedAt = cached?.fetchedAt ?? started;
+    let ttlMs = cached?.ttlMs ?? 0;
+    let stale = false;
+    let dirty = false;
+    let refetched = false;
+    let warned = false;
+    let pendingTools;
+    const loadTools = () => {
+        if (tools)
+            return Promise.resolve(tools);
+        return (pendingTools ??= options
+            .fetchTools()
+            .then((r) => {
+            tools = r.tools;
+            ttlMs = r.ttlMs ?? 0;
+            fetchedAt = clock();
+            dirty = true;
+            return r.tools;
+        })
+            .finally(() => {
+            pendingTools = undefined;
+        }));
+    };
+    const local = (target) => {
+        const hit = help[target];
+        if (hit)
+            return unpack(hit);
+        if (embedded && mode !== "server" && hash === embedded.hash)
+            return manifestHelp(embedded.manifest, target);
+        return undefined;
+    };
+    return {
+        get mode() {
+            return mode;
+        },
+        async help(target) {
+            const found = local(target);
+            if (found)
+                return found;
+            let fetched;
+            try {
+                fetched = await options.fetchHelp(target, loadTools);
+            }
+            catch (error) {
+                // 오프라인: 남은 캐시 (수명 지남 · stale) → 내장 manifest. refetch 중이면 runner 가 원래 로컬 오류를 낸다
+                if (error instanceof RemoteTransportError && !refetched) {
+                    const old = previous?.help[target];
+                    if (old || embedded) {
+                        if (!warned)
+                            options.warn(`warning: ${error.message} Showing ${old ? "cached" : "built-in"} help.\n`);
+                        warned = true;
+                        return old ? unpack(old) : manifestHelp(embedded.manifest, target);
+                    }
+                }
+                throw error;
+            }
+            if (fetched.hash !== undefined) {
+                if (hash === undefined)
+                    hash = fetched.hash;
+                else if (fetched.hash !== hash) {
+                    if (mode === "server") {
+                        // 실행 중 서버 교체: 이전 응답 버림
+                        help = {};
+                        hash = fetched.hash;
+                    }
+                    else
+                        stale = true;
+                }
+            }
+            help[target] = fetched.value;
+            dirty = true;
+            return unpack(fetched.value);
+        },
+        refetch() {
+            if (mode === "server")
+                return false;
+            mode = "server";
+            refetched = true;
+            help = {};
+            hash = undefined;
+            return true;
+        },
+        tools: loadTools,
+        observe(observed) {
+            if (observed === undefined)
+                return;
+            if (hash === undefined) {
+                hash = observed;
+                dirty = true;
+            }
+            else if (observed !== hash) {
+                hash = observed;
+                stale = true;
+                dirty = true;
+            }
+        },
+        async save() {
+            if (!options.file || !dirty || !tools)
+                return;
+            const entry = {
+                format: SCHEMA_CACHE_FORMAT,
+                url: canonicalServerUrl(options.url),
+                client: options.client,
+                ...(hash !== undefined ? { manifestHash: hash } : {}),
+                fetchedAt,
+                ttlMs,
+                ...(stale ? { stale: true } : {}),
+                tools,
+                help,
+            };
+            await writeSchemaCache(options.file, entry).catch(() => { });
+        },
+    };
+}
+function unpack(cached) {
+    if ("help" in cached)
+        return cached.help;
+    const { code, message, ...details } = cached.error;
+    throw new MextError(code, message, details);
+}
+//# sourceMappingURL=cache.js.map

package/dist/client/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/client/cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash, randomBytes } from \"node:crypto\"\nimport { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\"\nimport { join } from \"node:path\"\nimport { MextError, type MextErrorCode } from \"../errors.ts\"\nimport type { Help } from \"../mcp/help.ts\"\nimport { isRecord, RemoteTransportError, type RemoteTool } from \"../remote/client.ts\"\nimport { canonicalServerUrl, envPrefix } from \"../remote/credentials.ts\"\nimport { manifestHelp, type ClientManifest } from \"./manifest.ts\"\n\n/**\n * 원격 스키마 캐시 · drift 감지 (§5 스키마 drift). 고객 CLI · mext run --url 공용 (번들 포함, Node 내장만 import).\n *\n * D4. 파일 = <cache dir>/<sha256(정규화 서버 URL) 앞 16 hex>.json, 쓰기 = 같은 폴더 임시 파일 → rename (원자적).\n * cache dir = <BIN>_CACHE_DIR → $XDG_CACHE_HOME/<bin> → $HOME/.cache/<bin>. 셋 다 없음 = 캐시 없음.\n * 내용 = SchemaCacheEntry. url · client (bin · version · mext 버전) 가 다르면 무효, 수명 = tools/list ttlMs.\n *\n * 이번 실행의 help 출처 (mode):\n *   cache     유효 캐시 (수명 안 · stale 아님). help = 캐시 → (해시 = 내장 manifest 면) 내장 manifest → 서버 (캐시에 추가)\n *   embedded  번들 형태 · 유효 캐시 없음 · 서버가 내장 manifest 와 다르다는 기록 없음. help = 내장 manifest\n *   server    그 외 (범용 · stale · 서버가 내장 manifest 와 다름). help = 서버 (tools/list + help), 캐시 새로 씀\n * tools/call 결과 _meta 의 manifestHash ≠ 이번 help 의 해시 = stale 표시 (이번 결과는 그대로, 다음 실행이 server).\n * 로컬 파싱 실패 = refetch() 로 server 전환 후 1회 재시도 (runner). 오프라인 = 남은 캐시 · 내장 manifest 로 help 만\n */\n\nexport const SCHEMA_CACHE_FORMAT = 1\n\n/** 캐시 무효화 단위. 하나라도 다르면 캐시 무시 */\nexport interface CacheClient {\n  /** 실행 파일 이름 (clientInfo.name) */\n  bin: string\n  /** clientInfo.version (고객 CLI = cli.version, mext = mext 버전) */\n  version: string\n  /** 클라이언트 런타임의 @obov/mext 버전 (help 해석 코드) */\n  mext: string\n}\n\n/** help 결과 또는 UNKNOWN_COMMAND (경로 해석이 가장 긴 접두부터 시도하므로 없는 대상도 기록) */\nexport type CachedHelp = { help: Help } | { error: Record<string, unknown> & { code: string; message: string } }\n\nexport interface SchemaCacheEntry {\n  format: typeof SCHEMA_CACHE_FORMAT\n  /** 정규화 서버 URL (파일 이름 해시 충돌 확인) */\n  url: string\n  client: CacheClient\n  /** help · tools 가 속한 서버 manifestHash. 없음 = 서버가 보내지 않음 */\n  manifestHash?: string\n  /** tools/list 받은 시각 (epoch ms) */\n  fetchedAt: number\n  /** tools/list ttlMs. 0 = 매 실행 재조회 (오프라인 help 용으로만 남김) */\n  ttlMs: number\n  /** 서버 manifestHash 가 help 와 다름을 관찰. 다음 실행에서 서버 help 재조회 */\n  stale?: true\n  /** tools/list 결과 */\n  tools: RemoteTool[]\n  /** help 대상 (\"\" = 루트) → 결과 */\n  help: Record<string, CachedHelp>\n}\n\n/** <BIN>_CACHE_DIR → $XDG_CACHE_HOME/<bin> → $HOME/.cache/<bin> (USERPROFILE). 없으면 undefined (캐시 없음) */\nexport function schemaCacheDir(bin: string, env: Record<string, string | undefined>): string | undefined {\n  const forced = env[`${envPrefix(bin)}_CACHE_DIR`]\n  if (forced) return forced\n  if (env.XDG_CACHE_HOME) return join(env.XDG_CACHE_HOME, bin)\n  const home = env.HOME || env.USERPROFILE\n  return home ? join(home, \".cache\", bin) : undefined\n}\n\n/** <dir>/<sha256(canonicalServerUrl(url)) 앞 16 hex>.json */\nexport function schemaCacheFile(dir: string, url: string): string {\n  return join(dir, `${createHash(\"sha256\").update(canonicalServerUrl(url)).digest(\"hex\").slice(0, 16)}.json`)\n}\n\n/** 읽기 + 형식 · url · client 확인. 없음 · 깨짐 · 불일치 = undefined */\nexport async function readSchemaCache(file: string, url: string, client: CacheClient): Promise<SchemaCacheEntry | undefined> {\n  let value: unknown\n  try {\n    value = JSON.parse(await readFile(file, \"utf8\"))\n  } catch {\n    return undefined\n  }\n  if (!isRecord(value) || value.format !== SCHEMA_CACHE_FORMAT || value.url !== canonicalServerUrl(url)) return undefined\n  const c = value.client\n  if (!isRecord(c) || c.bin !== client.bin || c.version !== client.version || c.mext !== client.mext) return undefined\n  if (typeof value.fetchedAt !== \"number\" || typeof value.ttlMs !== \"number\") return undefined\n  if (!Array.isArray(value.tools) || !isRecord(value.help)) return undefined\n  if (value.manifestHash !== undefined && typeof value.manifestHash !== \"string\") return undefined\n  return value as unknown as SchemaCacheEntry\n}\n\n/** 원자적 쓰기 (임시 파일 → rename). 실패는 호출자가 무시 (캐시는 최선) */\nexport async function writeSchemaCache(file: string, entry: SchemaCacheEntry): Promise<void> {\n  const dir = join(file, \"..\")\n  await mkdir(dir, { recursive: true })\n  const tmp = `${file}.${process.pid}.${randomBytes(4).toString(\"hex\")}.tmp`\n  try {\n    await writeFile(tmp, `${JSON.stringify(entry)}\\n`)\n    await rename(tmp, file)\n  } catch (error) {\n    await rm(tmp, { force: true }).catch(() => {})\n    throw error\n  }\n}\n\nexport function isFresh(entry: SchemaCacheEntry, now: number): boolean {\n  return entry.stale !== true && entry.ttlMs > 0 && now >= entry.fetchedAt && now < entry.fetchedAt + entry.ttlMs\n}\n\n/* 실행 하나의 스키마 상태 */\n\nexport type SchemaMode = \"cache\" | \"embedded\" | \"server\"\n\nexport interface FetchedHelp {\n  value: CachedHelp\n  /** 응답 _meta[\"dev.mext/manifestHash\"] */\n  hash: string | undefined\n}\n\nexport interface SchemaOptions {\n  /** 캐시 파일. undefined = 캐시 없음 (읽기 · 쓰기 안 함) */\n  file: string | undefined\n  url: string\n  client: CacheClient\n  /** 번들 형태의 내장 manifest + 빌드 시 manifestHash */\n  embedded?: { manifest: ClientManifest; hash: string }\n  /** 서버 help (tools/call help). UNKNOWN_COMMAND 는 value.error, 그 외 오류 = throw */\n  fetchHelp(target: string, tools: () => Promise<RemoteTool[]>): Promise<FetchedHelp>\n  /** 서버 tools/list */\n  fetchTools(): Promise<{ tools: RemoteTool[]; ttlMs?: number }>\n  /** 오프라인 help 안내 (stderr) */\n  warn(message: string): void\n  now?: () => number\n}\n\nexport interface Schema {\n  readonly mode: SchemaMode\n  /** HelpSource: 대상 → help. 없는 대상 = MextError UNKNOWN_COMMAND */\n  help(target: string): Promise<Help>\n  /** 로컬 (cache · embedded) 파싱 실패 후 서버 help 로 전환. 이미 server = false (재시도 안 함) */\n  refetch(): boolean\n  /** dispatcher 도구 목록 (유효 캐시 = 네트워크 없음) */\n  tools(): Promise<RemoteTool[]>\n  /** tools/call 결과 _meta 의 manifestHash 관찰. 이번 help 의 해시와 다르면 stale */\n  observe(hash: string | undefined): void\n  /** 바뀐 내용이 있으면 캐시 파일 쓰기 (실패 무시) */\n  save(): Promise<void>\n}\n\nexport async function openSchema(options: SchemaOptions): Promise<Schema> {\n  const clock = options.now ?? Date.now\n  const started = clock()\n  const { embedded } = options\n  const previous = options.file ? await readSchemaCache(options.file, options.url, options.client) : undefined\n  const diverged =\n    previous !== undefined &&\n    (previous.stale === true || (embedded !== undefined && previous.manifestHash !== undefined && previous.manifestHash !== embedded.hash))\n  let mode: SchemaMode =\n    previous !== undefined && isFresh(previous, started) ? \"cache\" : embedded && !diverged ? \"embedded\" : \"server\"\n  const cached = mode === \"cache\" ? previous : undefined\n\n  let hash = cached ? cached.manifestHash : mode === \"embedded\" ? embedded!.hash : undefined\n  let help: Record<string, CachedHelp> = cached ? { ...cached.help } : {}\n  let tools: RemoteTool[] | undefined = cached?.tools\n  let fetchedAt = cached?.fetchedAt ?? started\n  let ttlMs = cached?.ttlMs ?? 0\n  let stale = false\n  let dirty = false\n  let refetched = false\n  let warned = false\n  let pendingTools: Promise<RemoteTool[]> | undefined\n\n  const loadTools = (): Promise<RemoteTool[]> => {\n    if (tools) return Promise.resolve(tools)\n    return (pendingTools ??= options\n      .fetchTools()\n      .then((r) => {\n        tools = r.tools\n        ttlMs = r.ttlMs ?? 0\n        fetchedAt = clock()\n        dirty = true\n        return r.tools\n      })\n      .finally(() => {\n        pendingTools = undefined\n      }))\n  }\n\n  const local = (target: string): Help | undefined => {\n    const hit = help[target]\n    if (hit) return unpack(hit)\n    if (embedded && mode !== \"server\" && hash === embedded.hash) return manifestHelp(embedded.manifest, target)\n    return undefined\n  }\n\n  return {\n    get mode() {\n      return mode\n    },\n    async help(target) {\n      const found = local(target)\n      if (found) return found\n      let fetched: FetchedHelp\n      try {\n        fetched = await options.fetchHelp(target, loadTools)\n      } catch (error) {\n        // 오프라인: 남은 캐시 (수명 지남 · stale) → 내장 manifest. refetch 중이면 runner 가 원래 로컬 오류를 낸다\n        if (error instanceof RemoteTransportError && !refetched) {\n          const old = previous?.help[target]\n          if (old || embedded) {\n            if (!warned) options.warn(`warning: ${error.message} Showing ${old ? \"cached\" : \"built-in\"} help.\\n`)\n            warned = true\n            return old ? unpack(old) : manifestHelp(embedded!.manifest, target)\n          }\n        }\n        throw error\n      }\n      if (fetched.hash !== undefined) {\n        if (hash === undefined) hash = fetched.hash\n        else if (fetched.hash !== hash) {\n          if (mode === \"server\") {\n            // 실행 중 서버 교체: 이전 응답 버림\n            help = {}\n            hash = fetched.hash\n          } else stale = true\n        }\n      }\n      help[target] = fetched.value\n      dirty = true\n      return unpack(fetched.value)\n    },\n    refetch() {\n      if (mode === \"server\") return false\n      mode = \"server\"\n      refetched = true\n      help = {}\n      hash = undefined\n      return true\n    },\n    tools: loadTools,\n    observe(observed) {\n      if (observed === undefined) return\n      if (hash === undefined) {\n        hash = observed\n        dirty = true\n      } else if (observed !== hash) {\n        hash = observed\n        stale = true\n        dirty = true\n      }\n    },\n    async save() {\n      if (!options.file || !dirty || !tools) return\n      const entry: SchemaCacheEntry = {\n        format: SCHEMA_CACHE_FORMAT,\n        url: canonicalServerUrl(options.url),\n        client: options.client,\n        ...(hash !== undefined ? { manifestHash: hash } : {}),\n        fetchedAt,\n        ttlMs,\n        ...(stale ? { stale: true as const } : {}),\n        tools,\n        help,\n      }\n      await writeSchemaCache(options.file, entry).catch(() => {})\n    },\n  }\n}\n\nfunction unpack(cached: CachedHelp): Help {\n  if (\"help\" in cached) return cached.help\n  const { code, message, ...details } = cached.error\n  throw new MextError(code as MextErrorCode, message, details as never)\n}\n"]}

package/dist/client/main.d.ts

@@ -0,0 +1,25 @@
+import { type CliIo } from "../cli/io.ts";
+import type { ClientManifest } from "./manifest.ts";
+/**
+ * 고객 CLI 런타임 (§5). mext build 가 이 모듈 + 설정 (CustomerCliConfig) 을 .mext/cli/bin.js 하나로 번들한다.
+ * 번들 · 범용 형태가 같은 코드: manifest 가 있으면 help · 플래그 파싱을 내장 manifest 로, 없으면 서버 help 로.
+ * 명령: <bin> help · <bin> <ns> <cmd> [flags] · login · logout · mcp install · --version. 원격 실행 = mext run --url 과 같은 runner
+ */
+/** bin.js 에 인라인되는 설정 (mext build 가 생성) */
+export interface CustomerCliConfig {
+    bin: string;
+    /** 빌드 설정의 서버 MCP 엔드포인트. 실행 시 <BIN>_URL 이 있으면 그 값 */
+    url: string;
+    /** --version · clientInfo.version */
+    version: string;
+    packageName: string;
+    /** 빌드한 @obov/mext 버전 */
+    mextVersion: string;
+    /** 빌드 시 manifestHash. 번들 형태 = 내장 manifest 의 해시 (서버 _meta["dev.mext/manifestHash"] 와 비교) */
+    manifestHash: string;
+    /** 번들 형태의 내장 manifest. 없음 = 범용 형태 */
+    manifest?: ClientManifest;
+}
+export declare function runCustomerCli(config: CustomerCliConfig, argv: readonly string[], partialIo?: Partial<CliIo>): Promise<number>;
+/** 프로세스 진입점 (bin.js). 첫 SIGINT = 진행 중 요청 abort (exit 130), 두 번째 = 즉시 종료 */
+export declare function main(config: CustomerCliConfig): Promise<void>;

package/dist/client/main.js

@@ -0,0 +1,100 @@
+import { table } from "../cli/help.js";
+import { resolveIo } from "../cli/io.js";
+import { loginCommand } from "../cli/login.js";
+import { logoutCommand } from "../cli/logout.js";
+import { EXIT, formatJson } from "../cli/output.js";
+import { mcpInstallText } from "../mcp/install.js";
+import { envPrefix } from "../remote/credentials.js";
+import { runRemote } from "./runner.js";
+export async function runCustomerCli(config, argv, partialIo = {}) {
+    const io = resolveIo(partialIo);
+    const { bin } = config;
+    const prefix = envPrefix(bin);
+    const url = io.env[`${prefix}_URL`] || config.url;
+    if (!/^https?:\/\//i.test(url)) {
+        io.stderr.write(`error: ${prefix}_URL must be an http(s) URL (got "${url}")\n`);
+        return EXIT.usage;
+    }
+    const [first, ...rest] = argv;
+    switch (first) {
+        case "--version":
+        case "-v":
+            io.stdout.write(`${config.version}\n`);
+            return EXIT.ok;
+        case "login":
+            return loginCommand({ bin, url })(rest, io);
+        case "logout":
+            return logoutCommand({ bin, url })(rest, io);
+        case "mcp":
+            return mcp(config, url, rest, io);
+        case "__mext_inspect":
+            // 숨김: 지원 · 디버깅용 내장 설정 (토큰 없음)
+            io.stdout.write(formatJson({
+                bin,
+                url,
+                version: config.version,
+                packageName: config.packageName,
+                mextVersion: config.mextVersion,
+                manifestHash: config.manifestHash,
+                form: config.manifest ? "bundled" : "universal",
+            }));
+            return EXIT.ok;
+    }
+    return runRemote({
+        bin,
+        url,
+        prog: bin,
+        login: `${bin} login`,
+        version: config.version,
+        ...(config.manifest ? { manifest: config.manifest, manifestHash: config.manifestHash } : {}),
+        rootHelpFooter: builtinHelp(config, url),
+    }, argv, io);
+}
+/** 프로세스 진입점 (bin.js). 첫 SIGINT = 진행 중 요청 abort (exit 130), 두 번째 = 즉시 종료 */
+export async function main(config) {
+    const controller = new AbortController();
+    process.on("SIGINT", () => {
+        if (controller.signal.aborted)
+            process.exit(130);
+        controller.abort();
+    });
+    const code = await runCustomerCli(config, process.argv.slice(2), { signal: controller.signal });
+    process.stdout.write("", () => process.stderr.write("", () => process.exit(code)));
+}
+function mcp(config, url, argv, io) {
+    const [sub, ...rest] = argv;
+    const isHelp = (t) => t === "--help" || t === "-h";
+    const usage = `Usage:\n  ${config.bin} mcp install    Print MCP client registration commands (does not modify client config files)\n`;
+    if (sub !== undefined && (isHelp(sub) || (sub === "install" && rest.some(isHelp)))) {
+        io.stdout.write(usage);
+        return EXIT.ok;
+    }
+    if (sub === "install" && rest.length === 0) {
+        io.stdout.write(`${mcpInstallText({ name: config.bin, url, stdioCommand: false, auth: true })}\n`);
+        return EXIT.ok;
+    }
+    io.stderr.write(`error: ${sub === undefined ? "missing subcommand" : `unknown argument "${argv.join(" ")}"`}\n\n${usage}`);
+    return EXIT.usage;
+}
+/** 사람용 루트 help 뒤의 내장 명령 · 환경변수 */
+function builtinHelp(config, url) {
+    const { bin } = config;
+    const prefix = envPrefix(bin);
+    return [
+        "CLI commands:",
+        ...table([
+            ["login", `Log in to ${url} (${bin} login --help)`],
+            ["logout", "Revoke and remove the stored token"],
+            ["mcp install", "Print MCP client registration commands"],
+            ["--version", "Print the version"],
+        ]).map((l) => `  ${l}`),
+        "",
+        "Environment:",
+        ...table([
+            [`${prefix}_TOKEN`, `API token (instead of ${bin} login)`],
+            [`${prefix}_URL`, `Server URL (default: ${config.url})`],
+        ]).map((l) => `  ${l}`),
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=main.js.map

package/dist/client/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/client/main.ts"],"names":[],"mappings":"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","sourcesContent":["import { table } from \"../cli/help.ts\"\nimport { resolveIo, type CliIo } from \"../cli/io.ts\"\nimport { loginCommand } from \"../cli/login.ts\"\nimport { logoutCommand } from \"../cli/logout.ts\"\nimport { EXIT, formatJson } from \"../cli/output.ts\"\nimport { mcpInstallText } from \"../mcp/install.ts\"\nimport { envPrefix } from \"../remote/credentials.ts\"\nimport type { ClientManifest } from \"./manifest.ts\"\nimport { runRemote } from \"./runner.ts\"\n\n/**\n * 고객 CLI 런타임 (§5). mext build 가 이 모듈 + 설정 (CustomerCliConfig) 을 .mext/cli/bin.js 하나로 번들한다.\n * 번들 · 범용 형태가 같은 코드: manifest 가 있으면 help · 플래그 파싱을 내장 manifest 로, 없으면 서버 help 로.\n * 명령: <bin> help · <bin> <ns> <cmd> [flags] · login · logout · mcp install · --version. 원격 실행 = mext run --url 과 같은 runner\n */\n\n/** bin.js 에 인라인되는 설정 (mext build 가 생성) */\nexport interface CustomerCliConfig {\n  bin: string\n  /** 빌드 설정의 서버 MCP 엔드포인트. 실행 시 <BIN>_URL 이 있으면 그 값 */\n  url: string\n  /** --version · clientInfo.version */\n  version: string\n  packageName: string\n  /** 빌드한 @obov/mext 버전 */\n  mextVersion: string\n  /** 빌드 시 manifestHash. 번들 형태 = 내장 manifest 의 해시 (서버 _meta[\"dev.mext/manifestHash\"] 와 비교) */\n  manifestHash: string\n  /** 번들 형태의 내장 manifest. 없음 = 범용 형태 */\n  manifest?: ClientManifest\n}\n\nexport async function runCustomerCli(\n  config: CustomerCliConfig,\n  argv: readonly string[],\n  partialIo: Partial<CliIo> = {},\n): Promise<number> {\n  const io = resolveIo(partialIo)\n  const { bin } = config\n  const prefix = envPrefix(bin)\n  const url = io.env[`${prefix}_URL`] || config.url\n  if (!/^https?:\\/\\//i.test(url)) {\n    io.stderr.write(`error: ${prefix}_URL must be an http(s) URL (got \"${url}\")\\n`)\n    return EXIT.usage\n  }\n  const [first, ...rest] = argv\n  switch (first) {\n    case \"--version\":\n    case \"-v\":\n      io.stdout.write(`${config.version}\\n`)\n      return EXIT.ok\n    case \"login\":\n      return loginCommand({ bin, url })(rest, io)\n    case \"logout\":\n      return logoutCommand({ bin, url })(rest, io)\n    case \"mcp\":\n      return mcp(config, url, rest, io)\n    case \"__mext_inspect\":\n      // 숨김: 지원 · 디버깅용 내장 설정 (토큰 없음)\n      io.stdout.write(\n        formatJson({\n          bin,\n          url,\n          version: config.version,\n          packageName: config.packageName,\n          mextVersion: config.mextVersion,\n          manifestHash: config.manifestHash,\n          form: config.manifest ? \"bundled\" : \"universal\",\n        }),\n      )\n      return EXIT.ok\n  }\n  return runRemote(\n    {\n      bin,\n      url,\n      prog: bin,\n      login: `${bin} login`,\n      version: config.version,\n      ...(config.manifest ? { manifest: config.manifest, manifestHash: config.manifestHash } : {}),\n      rootHelpFooter: builtinHelp(config, url),\n    },\n    argv,\n    io,\n  )\n}\n\n/** 프로세스 진입점 (bin.js). 첫 SIGINT = 진행 중 요청 abort (exit 130), 두 번째 = 즉시 종료 */\nexport async function main(config: CustomerCliConfig): Promise<void> {\n  const controller = new AbortController()\n  process.on(\"SIGINT\", () => {\n    if (controller.signal.aborted) process.exit(130)\n    controller.abort()\n  })\n  const code = await runCustomerCli(config, process.argv.slice(2), { signal: controller.signal })\n  process.stdout.write(\"\", () => process.stderr.write(\"\", () => process.exit(code)))\n}\n\nfunction mcp(config: CustomerCliConfig, url: string, argv: readonly string[], io: CliIo): number {\n  const [sub, ...rest] = argv\n  const isHelp = (t: string) => t === \"--help\" || t === \"-h\"\n  const usage = `Usage:\\n  ${config.bin} mcp install    Print MCP client registration commands (does not modify client config files)\\n`\n  if (sub !== undefined && (isHelp(sub) || (sub === \"install\" && rest.some(isHelp)))) {\n    io.stdout.write(usage)\n    return EXIT.ok\n  }\n  if (sub === \"install\" && rest.length === 0) {\n    io.stdout.write(`${mcpInstallText({ name: config.bin, url, stdioCommand: false, auth: true })}\\n`)\n    return EXIT.ok\n  }\n  io.stderr.write(`error: ${sub === undefined ? \"missing subcommand\" : `unknown argument \"${argv.join(\" \")}\"`}\\n\\n${usage}`)\n  return EXIT.usage\n}\n\n/** 사람용 루트 help 뒤의 내장 명령 · 환경변수 */\nfunction builtinHelp(config: CustomerCliConfig, url: string): string {\n  const { bin } = config\n  const prefix = envPrefix(bin)\n  return [\n    \"CLI commands:\",\n    ...table([\n      [\"login\", `Log in to ${url} (${bin} login --help)`],\n      [\"logout\", \"Revoke and remove the stored token\"],\n      [\"mcp install\", \"Print MCP client registration commands\"],\n      [\"--version\", \"Print the version\"],\n    ]).map((l) => `  ${l}`),\n    \"\",\n    \"Environment:\",\n    ...table([\n      [`${prefix}_TOKEN`, `API token (instead of ${bin} login)`],\n      [`${prefix}_URL`, `Server URL (default: ${config.url})`],\n    ]).map((l) => `  ${l}`),\n    \"\",\n  ].join(\"\\n\")\n}\n"]}

package/dist/client/manifest.d.ts

@@ -0,0 +1,19 @@
+import type { Manifest, ManifestCommand, ManifestNamespace } from "../manifest.ts";
+import type { Help } from "../mcp/help.ts";
+/**
+ * 고객 CLI 번들 형태의 내장 manifest = 빌드 manifest 에서 서버 전용 항목 (file · module · 빌드 경로) 을 뺀 것.
+ * help 결과는 서버 help (mcp/help.ts help()) 와 같은 모양 (split 노출의 tool 필드 제외)
+ */
+export type ClientManifestCommand = Omit<ManifestCommand, "file">;
+export interface ClientManifest {
+    /** commands/_index.md */
+    description?: string;
+    /** 루트 제외, ID 순 */
+    namespaces: ManifestNamespace[];
+    /** ID 순 */
+    commands: ClientManifestCommand[];
+}
+/** 빌드 manifest → 내장 manifest (mext build 가 호출) */
+export declare function clientManifest(manifest: Pick<Manifest, "description" | "namespaces" | "commands">): ClientManifest;
+/** 내장 manifest 의 help (target "" = 루트 · 네임스페이스 · 명령어 ID · 별칭). 없는 target = UNKNOWN_COMMAND */
+export declare function manifestHelp(manifest: ClientManifest, target: string): Help;