isthmus-cli 0.6.0 → 0.7.0

package/dist/cli/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\nimport { readFile } from 'node:fs/promises';\n\nimport { writeTextAtomically } from './atomic-write.ts';\nimport { checkUsage, runCheckCommand } from './check-command.ts';\nimport type { CommandResult } from './command-support.ts';\nimport { graphUsage, runGraphCommand } from './graph-command.ts';\nimport { diffUsage, runDiffCommand } from './diff-command.ts';\nimport { queryUsage, runQueryCommand } from './query-command.ts';\nimport { impactUsage, runImpactCommand } from './impact-command.ts';\nimport { runtimeUsage, runRuntimeCommand } from './runtime-command.ts';\nimport { preflightUsage, runPreflightCommand } from './preflight-command.ts';\nimport {\n  retentionUsage,\n  runRetentionsCommand,\n} from './retentions-command.ts';\n\nprocess.stdout.on('error', handleStreamError);\nprocess.stderr.on('error', handleStreamError);\n\nconst commandUsages = new Map([\n  ['check', checkUsage],\n  ['graph', graphUsage],\n  ['diff', diffUsage],\n  ['query', queryUsage],\n  ['impact', impactUsage],\n  ['preflight', preflightUsage],\n  ['verify-runtime', runtimeUsage],\n  ['retentions', retentionUsage],\n]);\n\nconst rootHelp = `Usage: isthmus <command> [options]\n\nCommands:\n  check        Report unmatched bridge calls and handlers\n  query        Find both sides of a channel or method\n  impact       Inspect bridge dependencies before changing files or symbols\n  preflight    Trace cross-language impact from producer analysis context\n  verify-runtime  Verify recorded calls against scenario expectations\n  graph        Render matched boundary edges\n  diff         Compare bridge observations before and after a change\n  retentions   Produce external retention evidence\n  help         Show command help\n\nOptions:\n  -h, --help   Show help; after a command it shows that command's usage\n  --version    Show version\n`;\n\nconst arguments_ = process.argv.slice(2);\nconst readTextFile = (path: string) => readFile(path, 'utf8');\nconst writeTextFile = (path: string, text: string) =>\n  writeTextAtomically(path, text);\nconst informationalResult = await runInformationalCommand(arguments_);\nconst result = informationalResult ?? await dispatchCommand(arguments_);\n\nprocess.stdout.write(result.standardOutput);\nprocess.stderr.write(result.standardError);\nprocess.exitCode = result.exitCode;\n\n/** 파이프 소비자가 먼저 닫힌 정상 상황만 조용히 종료한다. */\nfunction handleStreamError(error: NodeJS.ErrnoException): void {\n  if (error.code === 'EPIPE') {\n    process.exitCode = 0;\n    return;\n  }\n  throw error;\n}\n\n/** 도움말과 버전처럼 입력 문서가 필요 없는 명령을 실행한다. */\nasync function runInformationalCommand(\n  commandArguments: readonly string[],\n): Promise<CommandResult | undefined> {\n  // 도움말 플래그는 어느 위치에 있든 이긴다. 긴 호출 끝에 붙여도 사용법을 본다.\n  const helpFlagIndex = commandArguments.findIndex(\n    (argument) => argument === '--help' || argument === '-h',\n  );\n  if (helpFlagIndex >= 0) return commandHelp(commandArguments[0]);\n  if (commandArguments[0] === 'help') {\n    return commandHelp(commandArguments[1]);\n  }\n  if (\n    commandArguments.length === 1 &&\n    commandArguments[0] === '--version'\n  ) {\n    return readVersion();\n  }\n  return undefined;\n}\n\n/** 명령 이름에 맞는 사용법을, 모르면 루트 도움말을 돌려준다. */\nfunction commandHelp(command: string | undefined): CommandResult {\n  if (command === undefined) return successfulText(rootHelp);\n  const usage = commandUsages.get(command);\n  return usage === undefined\n    ? successfulText(rootHelp)\n    : successfulText(`${usage}\\n`);\n}\n\n/** 알려진 분석 하위 명령으로만 라우팅한다. */\nasync function dispatchCommand(\n  commandArguments: readonly string[],\n): Promise<CommandResult> {\n  switch (commandArguments[0]) {\n    case 'check':\n      // SARIF driver에만 필요하므로 메타데이터 부재는 json 보고서를 막지 않는다.\n      return runCheckCommand(\n        commandArguments,\n        readTextFile,\n        writeTextFile,\n        undefined,\n        await readPackageVersion(),\n      );\n    case 'graph':\n      return runGraphCommand(commandArguments, readTextFile);\n    case 'diff':\n      return runDiffCommand(commandArguments, readTextFile);\n    case 'query':\n      return runQueryCommand(commandArguments, readTextFile);\n    case 'impact':\n      return runImpactCommand(commandArguments, readTextFile);\n    case 'preflight':\n      return runPreflightCommand(commandArguments, readTextFile);\n    case 'verify-runtime':\n      return runRuntimeCommand(commandArguments, readTextFile);\n    case 'retentions': {\n      const version = await readPackageVersion();\n      return version === undefined\n        ? packageMetadataError()\n        : runRetentionsCommand(\n            commandArguments,\n            readTextFile,\n            () => new Date(),\n            version,\n          );\n    }\n    default:\n      return {\n        standardOutput: '',\n        standardError: rootHelp,\n        exitCode: 64,\n      };\n  }\n}\n\n/** 설치된 package.json을 단일 출처로 사용해 버전을 출력한다. */\nasync function readVersion(): Promise<CommandResult> {\n  const version = await readPackageVersion();\n  return version === undefined\n    ? packageMetadataError()\n    : successfulText(`${version}\\n`);\n}\n\n/** 설치된 package.json에서 검증된 버전 문자열을 읽는다. */\nasync function readPackageVersion(): Promise<string | undefined> {\n  try {\n    const text = await readFile(new URL('../../package.json', import.meta.url), 'utf8');\n    const document: unknown = JSON.parse(text);\n    return isVersionDocument(document) ? document.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** package metadata가 비어 있지 않은 버전을 제공하는지 확인한다. */\nfunction isVersionDocument(value: unknown): value is { readonly version: string } {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'version' in value &&\n    typeof value.version === 'string' &&\n    value.version.length > 0\n  );\n}\n\n/** stdout 텍스트와 성공 종료 코드를 만든다. */\nfunction successfulText(standardOutput: string): CommandResult {\n  return { standardOutput, standardError: '', exitCode: 0 };\n}\n\n/** package metadata 실패를 민감정보 없는 코드 2로 바꾼다. */\nfunction packageMetadataError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: 'Unable to read package metadata.\\n',\n    exitCode: 2,\n  };\n}\n"]}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n\nimport { readdir, readFile, realpath, stat } from 'node:fs/promises';\n\nimport { writeTextAtomically } from './atomic-write.ts';\nimport { checkUsage, runCheckCommand } from './check-command.ts';\nimport type { CaptureFileSystem, CommandResult } from './command-support.ts';\nimport { doctorUsage, runDoctorCommand } from './doctor-command.ts';\nimport { initUsage, runInitCommand } from './init-command.ts';\nimport {\n  extractJsUsage,\n  type ExtractJsFileSystem,\n  runExtractJsCommand,\n} from './extract-js-command.ts';\nimport { graphUsage, runGraphCommand } from './graph-command.ts';\nimport { diffUsage, runDiffCommand } from './diff-command.ts';\nimport { queryUsage, runQueryCommand } from './query-command.ts';\nimport { impactUsage, runImpactCommand } from './impact-command.ts';\nimport { runtimeUsage, runRuntimeCommand } from './runtime-command.ts';\nimport { preflightUsage, runPreflightCommand } from './preflight-command.ts';\nimport {\n  retentionUsage,\n  runRetentionsCommand,\n} from './retentions-command.ts';\nimport { runServeCommand, serveUsage } from './serve-command.ts';\n\nprocess.stdout.on('error', handleStreamError);\nprocess.stderr.on('error', handleStreamError);\n\nconst commandUsages = new Map([\n  ['check', checkUsage],\n  ['graph', graphUsage],\n  ['diff', diffUsage],\n  ['query', queryUsage],\n  ['impact', impactUsage],\n  ['preflight', preflightUsage],\n  ['verify-runtime', runtimeUsage],\n  ['retentions', retentionUsage],\n  ['serve', serveUsage],\n  ['extract-js', extractJsUsage],\n  ['doctor', doctorUsage],\n  ['init', initUsage],\n]);\n\nconst rootHelp = `Usage: isthmus <command> [options]\n\nCommands:\n  check        Report unmatched bridge calls and handlers\n  query        Find both sides of a channel or method\n  impact       Inspect bridge dependencies before changing files or symbols\n  preflight    Trace cross-language impact from producer analysis context\n  verify-runtime  Verify recorded calls against scenario expectations\n  graph        Render matched boundary edges\n  diff         Compare bridge observations before and after a change\n  retentions   Produce external retention evidence\n  extract-js   Extract React Native caller-side bridge facts from JS/TS\n  doctor       Validate a capture config and its executable paths\n  init         Write a capture config scaffold\n  serve        Speak MCP over stdio for agent clients\n  help         Show command help\n\nOptions:\n  -h, --help   Show help; after a command it shows that command's usage\n  --version    Show version\n`;\n\nconst arguments_ = process.argv.slice(2);\nconst readTextFile = (path: string) => readFile(path, 'utf8');\nconst writeTextFile = (path: string, text: string) =>\n  writeTextAtomically(path, text);\n\n/** extract-js가 쓰는 실제 파일시스템 구현이다 — 테스트는 계약만 주입한다. */\nconst extractJsFileSystem: ExtractJsFileSystem = {\n  statPath: async (path) => {\n    try {\n      const entry = await stat(path);\n      return entry.isDirectory() ? 'directory' : 'file';\n    } catch {\n      return 'missing';\n    }\n  },\n  listDirectory: async (path) =>\n    (await readdir(path, { withFileTypes: true })).map((entry) => ({\n      name: entry.name,\n      isFile: entry.isFile(),\n      isDirectory: entry.isDirectory(),\n    })),\n  realPath: (path) => realpath(path),\n};\n/** doctor·init이 쓰는 실제 파일시스템이다. producer는 실행하지 않는다. */\nconst captureFileSystem: CaptureFileSystem = {\n  statPath: async (path) => {\n    try {\n      const entry = await stat(path);\n      return entry.isDirectory() ? 'directory' : 'file';\n    } catch {\n      return 'missing';\n    }\n  },\n  realPath: (path) => realpath(path),\n};\nconst informationalResult = await runInformationalCommand(arguments_);\nconst result = informationalResult ?? await dispatchCommand(arguments_);\n\nprocess.stdout.write(result.standardOutput);\nprocess.stderr.write(result.standardError);\nprocess.exitCode = result.exitCode;\n\n/** 파이프 소비자가 먼저 닫힌 정상 상황만 조용히 종료한다. */\nfunction handleStreamError(error: NodeJS.ErrnoException): void {\n  if (error.code === 'EPIPE') {\n    process.exitCode = 0;\n    return;\n  }\n  throw error;\n}\n\n/** 도움말과 버전처럼 입력 문서가 필요 없는 명령을 실행한다. */\nasync function runInformationalCommand(\n  commandArguments: readonly string[],\n): Promise<CommandResult | undefined> {\n  // 도움말 플래그는 어느 위치에 있든 이긴다. 긴 호출 끝에 붙여도 사용법을 본다.\n  const helpFlagIndex = commandArguments.findIndex(\n    (argument) => argument === '--help' || argument === '-h',\n  );\n  if (helpFlagIndex >= 0) return commandHelp(commandArguments[0]);\n  if (commandArguments[0] === 'help') {\n    return commandHelp(commandArguments[1]);\n  }\n  if (\n    commandArguments.length === 1 &&\n    commandArguments[0] === '--version'\n  ) {\n    return readVersion();\n  }\n  return undefined;\n}\n\n/** 명령 이름에 맞는 사용법을, 모르면 루트 도움말을 돌려준다. */\nfunction commandHelp(command: string | undefined): CommandResult {\n  if (command === undefined) return successfulText(rootHelp);\n  const usage = commandUsages.get(command);\n  return usage === undefined\n    ? successfulText(rootHelp)\n    : successfulText(`${usage}\\n`);\n}\n\n/** 알려진 분석 하위 명령으로만 라우팅한다. */\nasync function dispatchCommand(\n  commandArguments: readonly string[],\n): Promise<CommandResult> {\n  switch (commandArguments[0]) {\n    case 'check':\n      // SARIF driver에만 필요하므로 메타데이터 부재는 json 보고서를 막지 않는다.\n      return runCheckCommand(\n        commandArguments,\n        readTextFile,\n        writeTextFile,\n        undefined,\n        await readPackageVersion(),\n      );\n    case 'graph':\n      return runGraphCommand(commandArguments, readTextFile);\n    case 'diff':\n      return runDiffCommand(commandArguments, readTextFile);\n    case 'query':\n      return runQueryCommand(commandArguments, readTextFile);\n    case 'impact':\n      return runImpactCommand(commandArguments, readTextFile);\n    case 'preflight':\n      return runPreflightCommand(commandArguments, readTextFile);\n    case 'verify-runtime':\n      return runRuntimeCommand(commandArguments, readTextFile);\n    case 'extract-js':\n      return runExtractJsCommand(\n        commandArguments,\n        extractJsFileSystem,\n        readTextFile,\n        () => new Date(),\n        await readPackageVersion(),\n      );\n    case 'doctor':\n      return runDoctorCommand(\n        commandArguments,\n        readTextFile,\n        captureFileSystem,\n        process.cwd(),\n        process.env.PATH ?? '',\n      );\n    case 'init':\n      return runInitCommand(\n        commandArguments,\n        readTextFile,\n        writeTextFile,\n        captureFileSystem,\n        process.cwd(),\n      );\n    case 'serve':\n      return runServeCommand(\n        commandArguments,\n        readTextFile,\n        writeTextFile,\n        await readPackageVersion(),\n      );\n    case 'retentions': {\n      const version = await readPackageVersion();\n      return version === undefined\n        ? packageMetadataError()\n        : runRetentionsCommand(\n            commandArguments,\n            readTextFile,\n            () => new Date(),\n            version,\n          );\n    }\n    default:\n      return {\n        standardOutput: '',\n        standardError: rootHelp,\n        exitCode: 64,\n      };\n  }\n}\n\n/** 설치된 package.json을 단일 출처로 사용해 버전을 출력한다. */\nasync function readVersion(): Promise<CommandResult> {\n  const version = await readPackageVersion();\n  return version === undefined\n    ? packageMetadataError()\n    : successfulText(`${version}\\n`);\n}\n\n/** 설치된 package.json에서 검증된 버전 문자열을 읽는다. */\nasync function readPackageVersion(): Promise<string | undefined> {\n  try {\n    const text = await readFile(new URL('../../package.json', import.meta.url), 'utf8');\n    const document: unknown = JSON.parse(text);\n    return isVersionDocument(document) ? document.version : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** package metadata가 비어 있지 않은 버전을 제공하는지 확인한다. */\nfunction isVersionDocument(value: unknown): value is { readonly version: string } {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'version' in value &&\n    typeof value.version === 'string' &&\n    value.version.length > 0\n  );\n}\n\n/** stdout 텍스트와 성공 종료 코드를 만든다. */\nfunction successfulText(standardOutput: string): CommandResult {\n  return { standardOutput, standardError: '', exitCode: 0 };\n}\n\n/** package metadata 실패를 민감정보 없는 코드 2로 바꾼다. */\nfunction packageMetadataError(): CommandResult {\n  return {\n    standardOutput: '',\n    standardError: 'Unable to read package metadata.\\n',\n    exitCode: 2,\n  };\n}\n"]}

package/dist/cli/mcp-server.d.ts

@@ -0,0 +1,16 @@
+import type { ReadTextFile, WriteTextFile } from './command-support.ts';
+/** 세션이 외부에 필요로 하는 주입이다. */
+export interface McpServerDependencies {
+    readonly readTextFile: ReadTextFile;
+    readonly writeTextFile?: WriteTextFile | undefined;
+    readonly producerVersion?: string | undefined;
+}
+/** JSON-RPC 메시지 한 건을 처리해 응답 라인을 반환하는 세션이다. */
+export interface McpSession {
+    readonly handleLine: (line: string) => Promise<string | undefined>;
+}
+/**
+ * MCP 세션을 만든다. 반환된 handleLine은 한 줄의 JSON-RPC 메시지를 받아
+ * 응답이 필요하면 직렬화된 한 줄을, 알림이면 undefined를 돌려준다.
+ */
+export declare function createMcpSession(dependencies: McpServerDependencies): McpSession;

package/dist/cli/mcp-server.js

@@ -0,0 +1,534 @@
+import { runCheckCommand } from "./check-command.js";
+import { runDiffCommand } from "./diff-command.js";
+import { runGraphCommand } from "./graph-command.js";
+import { runImpactCommand } from "./impact-command.js";
+import { runPreflightCommand } from "./preflight-command.js";
+import { runQueryCommand } from "./query-command.js";
+import { runRetentionsCommand } from "./retentions-command.js";
+/**
+ * stdio 위의 newline-delimited JSON-RPC 2.0 세션이다.
+ *
+ * MCP(Model Context Protocol) 클라이언트가 `isthmus serve`를 자식 프로세스로
+ * 띄우고 한 줄에 메시지 하나씩 주고받는다. 이 모듈은 프레이밍만 담고, 각
+ * 도구 호출은 CLI 명령의 argv로 변환해 같은 실행 경로를 재사용한다 —
+ * 보고서 형식·종료 코드·한계 보고가 명령과 정확히 일치하도록 하기 위해서다.
+ */
+/** 현재 서버가 협상할 수 있는 MCP 프로토콜 개정 목록이다. */
+const SUPPORTED_PROTOCOL_VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'];
+/** JSON-RPC 오류 코드다. 알 수 없는 상수를 만들지 않는다. */
+const PARSE_ERROR = -32700;
+const INVALID_REQUEST = -32600;
+const METHOD_NOT_FOUND = -32601;
+const INVALID_PARAMS = -32602;
+const INTERNAL_ERROR = -32603;
+const DOCUMENTS_PROPERTY = {
+    type: 'array',
+    items: { type: 'string' },
+    minItems: 2,
+    description: 'Bridge fact document paths to join (GRAPH-EXCHANGE v1/v2 JSON).',
+};
+const TOOL_DEFINITIONS = [
+    {
+        name: 'check',
+        description: 'Join bridge fact documents and report unmatched calls and handlers. '
+            + 'Findings are review candidates with limitations preserved, not '
+            + 'delete approvals.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                documents: DOCUMENTS_PROPERTY,
+                strict: {
+                    type: 'boolean',
+                    description: 'Exit nonzero when any finding exists.',
+                },
+            },
+            required: ['documents'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'query',
+        description: 'Find both sides of a bridge channel or method name across the joined '
+            + 'documents.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    minLength: 1,
+                    description: 'Channel, method, or qualifiedName to look up.',
+                },
+                documents: DOCUMENTS_PROPERTY,
+            },
+            required: ['name', 'documents'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'graph',
+        description: 'Render matched bridge boundary edges as a JSON, DOT, or Mermaid graph.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                documents: DOCUMENTS_PROPERTY,
+                format: {
+                    type: 'string',
+                    enum: ['json', 'dot', 'mermaid'],
+                },
+            },
+            required: ['documents'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'diff',
+        description: 'Compare bridge observations before and after a change. Reports '
+            + 'observed differences only; it does not infer revision order.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                before: DOCUMENTS_PROPERTY,
+                after: DOCUMENTS_PROPERTY,
+                strict: {
+                    type: 'boolean',
+                    description: 'Exit nonzero only for new errors.',
+                },
+            },
+            required: ['before', 'after'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'impact',
+        description: 'Inspect which bridge dependencies a changed file or symbol reaches. '
+            + 'Exactly one of file, symbol, or changes selects the subject.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                documents: DOCUMENTS_PROPERTY,
+                file: { type: 'string', description: 'Changed relative file path.' },
+                symbol: { type: 'string', description: 'Changed symbol name or USR.' },
+                changes: {
+                    type: 'string',
+                    description: 'Path to a changes.json document.',
+                },
+                runtime: {
+                    type: 'string',
+                    description: 'Optional runtime evidence document path.',
+                },
+                revision: { type: 'string' },
+                strict: { type: 'boolean' },
+                compact: { type: 'boolean' },
+            },
+            required: ['documents'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'preflight',
+        description: 'Trace cross-language impact from a producer analysis context. The '
+            + 'context JSON is produced by scripts/capture-preflight.mjs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                context: {
+                    type: 'string',
+                    description: 'Path to the captured preflight context JSON.',
+                },
+                runtime: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional runtime evidence document paths.',
+                },
+                expectations: { type: 'string' },
+                revision: { type: 'string' },
+                summary: { type: 'boolean' },
+                limit: { type: 'integer', minimum: 1, maximum: 100 },
+                explain: { type: 'string' },
+                strict: { type: 'boolean' },
+                compact: { type: 'boolean' },
+            },
+            required: ['context'],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: 'retentions',
+        description: 'Produce external retention evidence for a native analyzer. Pass the '
+            + 'result to cartograph dead --external-retentions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                documents: DOCUMENTS_PROPERTY,
+                producer: {
+                    type: 'string',
+                    enum: ['cartograph'],
+                    description: 'Only cartograph is supported today.',
+                },
+            },
+            required: ['documents', 'producer'],
+            additionalProperties: false,
+        },
+    },
+];
+const TOOL_NAMES = new Map(TOOL_DEFINITIONS.map((tool) => [tool.name, tool]));
+/**
+ * MCP 세션을 만든다. 반환된 handleLine은 한 줄의 JSON-RPC 메시지를 받아
+ * 응답이 필요하면 직렬화된 한 줄을, 알림이면 undefined를 돌려준다.
+ */
+export function createMcpSession(dependencies) {
+    return {
+        handleLine: (line) => handleMessage(dependencies, line),
+    };
+}
+async function handleMessage(dependencies, line) {
+    let message;
+    try {
+        message = JSON.parse(line);
+    }
+    catch {
+        return JSON.stringify(errorResponse(undefined, PARSE_ERROR, 'Parse error'));
+    }
+    if (Array.isArray(message)) {
+        // MCP는 배치를 쓰지 않는다. 첫 요소의 id도 모르므로 요청 전체를 거부한다.
+        return JSON.stringify(errorResponse(undefined, INVALID_REQUEST, 'Batch requests are not supported'));
+    }
+    if (!isRequestMessage(message)) {
+        // JSON-RPC 2.0은 검출 가능한 id를 그대로 에코하라고 요구한다 — 형식이
+        // 스칼라인 요청의 id는 거절 응답에도 보존한다.
+        return JSON.stringify(errorResponse(scalarId(message), INVALID_REQUEST, 'Invalid request'));
+    }
+    if (message.id === undefined) {
+        // 알림은 응답하지 않는다. initialized 등 어떤 알림이든 조용히 무시한다.
+        return undefined;
+    }
+    if (!isScalarId(message.id)) {
+        return JSON.stringify(errorResponse(null, INVALID_REQUEST, 'Request id must be a string, number, or null'));
+    }
+    let response;
+    try {
+        response = await dispatchRequest(dependencies, message.method, message.id, message.params);
+    }
+    catch {
+        // 명령 실행이나 파일 읽기의 내부 예외로 서버가 죽으면 안 된다 — 세션을 유지하며
+        // -32603으로 돌려준다. 원인 본문은 입력 경로·내용을 담을 수 있어 노출하지 않는다.
+        response = errorResponse(message.id, INTERNAL_ERROR, 'Internal error');
+    }
+    return JSON.stringify(response);
+}
+function isScalarId(value) {
+    return value === null || typeof value === 'string' || typeof value === 'number';
+}
+function scalarId(message) {
+    if (typeof message !== 'object' || message === null)
+        return null;
+    const id = message.id;
+    return isScalarId(id) ? id : null;
+}
+function isRequestMessage(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return candidate.jsonrpc === '2.0' && typeof candidate.method === 'string';
+}
+async function dispatchRequest(dependencies, method, id, params) {
+    switch (method) {
+        case 'initialize':
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: initializeResult(dependencies, params),
+            };
+        case 'ping':
+            return { jsonrpc: '2.0', id, result: {} };
+        case 'tools/list':
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: { tools: TOOL_DEFINITIONS },
+            };
+        case 'tools/call':
+            return toolsCallResult(dependencies, id, params);
+        default:
+            return errorResponse(id, METHOD_NOT_FOUND, 'Method not found');
+    }
+}
+/** initialize 요청의 프로토콜 버전을 협상하고 서버 정보를 돌려준다. */
+function initializeResult(dependencies, params) {
+    const requested = isInitializeParams(params) ? params.protocolVersion : undefined;
+    const protocolVersion = requested !== undefined
+        && SUPPORTED_PROTOCOL_VERSIONS.includes(requested)
+        ? requested
+        : SUPPORTED_PROTOCOL_VERSIONS[0];
+    return {
+        protocolVersion,
+        capabilities: { tools: {} },
+        serverInfo: {
+            name: 'isthmus',
+            version: dependencies.producerVersion ?? 'unknown',
+        },
+    };
+}
+function isInitializeParams(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return typeof value.protocolVersion === 'string';
+}
+async function toolsCallResult(dependencies, id, params) {
+    if (!isToolsCallParams(params)) {
+        return errorResponse(id, INVALID_PARAMS, 'tools/call requires name and arguments');
+    }
+    const tool = TOOL_NAMES.get(params.name);
+    if (tool === undefined) {
+        return errorResponse(id, INVALID_PARAMS, `Unknown tool: ${params.name}`);
+    }
+    const invalid = validateToolArguments(tool, params.arguments ?? {});
+    if (invalid !== undefined) {
+        return errorResponse(id, INVALID_PARAMS, invalid);
+    }
+    const argv = buildToolArgv(params.name, params.arguments ?? {});
+    if (argv === undefined) {
+        return errorResponse(id, INVALID_PARAMS, 'Invalid tool arguments');
+    }
+    const result = await runToolCommand(dependencies, argv);
+    return { jsonrpc: '2.0', id, result: commandResultContent(result) };
+}
+function isToolsCallParams(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.name === 'string';
+}
+/**
+ * tools/list에 광고한 inputSchema 그대로 인자를 검증한다. 스키마와 검증이
+ * 같은 정의에서 파생되므로 둘이 어긋날 수 없다 — 알 수 없는 키·타입 위반·
+ * enum 밖 값·범위 밖 정수는 명령 실행 전에 -32602로 거부한다.
+ */
+function validateToolArguments(tool, args) {
+    const { properties, required = [] } = tool.inputSchema;
+    for (const key of Object.keys(args)) {
+        if (!(key in properties))
+            return `Unknown argument: ${key}`;
+    }
+    for (const key of required) {
+        if (args[key] === undefined)
+            return `Missing required argument: ${key}`;
+    }
+    for (const [key, value] of Object.entries(args)) {
+        const property = properties[key];
+        switch (property.type) {
+            case 'boolean':
+                if (typeof value !== 'boolean')
+                    return `Argument ${key} must be a boolean`;
+                break;
+            case 'string':
+                if (typeof value !== 'string')
+                    return `Argument ${key} must be a string`;
+                if (property.minLength !== undefined && value.length < property.minLength) {
+                    return `Argument ${key} is too short`;
+                }
+                break;
+            case 'integer':
+                if (typeof value !== 'number' || !Number.isInteger(value)) {
+                    return `Argument ${key} must be an integer`;
+                }
+                if (property.minimum !== undefined && value < property.minimum) {
+                    return `Argument ${key} is below the minimum`;
+                }
+                if (property.maximum !== undefined && value > property.maximum) {
+                    return `Argument ${key} exceeds the maximum`;
+                }
+                break;
+            case 'array':
+                if (!Array.isArray(value) || (property.items?.type === 'string'
+                    && !value.every((item) => typeof item === 'string'))) {
+                    return `Argument ${key} must be an array of strings`;
+                }
+                break;
+            default:
+                break;
+        }
+        if (property.enum !== undefined && !property.enum.includes(value)) {
+            return `Argument ${key} is not an allowed value`;
+        }
+    }
+    return undefined;
+}
+/**
+ * 도구 인자를 CLI argv로 변환한다. 스키마 검증을 통과한 인자만 들어오지만,
+ * selector 조합처럼 스키마로 표현 못 하는 제약은 여기서도 거른다.
+ */
+function buildToolArgv(toolName, args) {
+    switch (toolName) {
+        case 'check':
+            return withDocuments('check', args, (documents) => [
+                ...booleanFlag('--strict', args.strict),
+                ...documents,
+            ]);
+        case 'query':
+            return typeof args.name === 'string' && args.name.length > 0
+                ? withDocuments('query', args, (documents) => [args.name, ...documents])
+                : undefined;
+        case 'graph':
+            return withDocuments('graph', args, (documents) => [
+                ...enumFlag('--format', args.format, ['json', 'dot', 'mermaid']),
+                ...documents,
+            ]);
+        case 'diff': {
+            const before = stringArray(args.before);
+            const after = stringArray(args.after);
+            if (before === undefined || after === undefined)
+                return undefined;
+            return [
+                'diff',
+                '--before',
+                ...before,
+                '--after',
+                ...after,
+                ...booleanFlag('--strict', args.strict),
+            ];
+        }
+        case 'impact': {
+            const selectorCount = ['file', 'symbol', 'changes']
+                .filter((key) => args[key] !== undefined).length;
+            if (selectorCount !== 1)
+                return undefined;
+            return withDocuments('impact', args, (documents) => [
+                ...valueFlag('--file', args.file),
+                ...valueFlag('--symbol', args.symbol),
+                ...valueFlag('--changes', args.changes),
+                ...documents,
+                ...valueFlag('--runtime', args.runtime),
+                ...valueFlag('--revision', args.revision),
+                ...booleanFlag('--strict', args.strict),
+                ...booleanFlag('--compact', args.compact),
+            ]);
+        }
+        case 'preflight': {
+            if (typeof args.context !== 'string' || args.context.length === 0) {
+                return undefined;
+            }
+            const runtimePaths = args.runtime === undefined
+                ? []
+                : stringArray(args.runtime);
+            if (runtimePaths === undefined)
+                return undefined;
+            const argv = [
+                'preflight',
+                args.context,
+                ...runtimePaths,
+                ...valueFlag('--expectations', args.expectations),
+                ...valueFlag('--revision', args.revision),
+                ...booleanFlag('--summary', args.summary),
+                ...booleanFlag('--strict', args.strict),
+                ...booleanFlag('--compact', args.compact),
+            ];
+            if (typeof args.limit === 'number' && Number.isInteger(args.limit)) {
+                argv.push('--limit', String(args.limit));
+            }
+            argv.push(...valueFlag('--explain', args.explain));
+            return argv;
+        }
+        case 'retentions':
+            if (args.producer !== 'cartograph')
+                return undefined;
+            return withDocuments('retentions', args, (documents) => [
+                ...documents,
+                '--for',
+                'cartograph',
+            ]);
+        default:
+            return undefined;
+    }
+}
+/** documents 인자를 검증하고 argv 앞에 명령 이름을 붙인다. */
+function withDocuments(command, args, build) {
+    const documents = stringArray(args.documents);
+    if (documents === undefined || documents.length < 2)
+        return undefined;
+    return [command, ...build(documents)];
+}
+function stringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    return value.every((item) => typeof item === 'string')
+        ? value
+        : undefined;
+}
+function booleanFlag(flag, value) {
+    return value === true ? [flag] : [];
+}
+function valueFlag(flag, value) {
+    return typeof value === 'string' && value.length > 0 ? [flag, value] : [];
+}
+function enumFlag(flag, value, allowed) {
+    return typeof value === 'string' && allowed.includes(value)
+        ? [flag, value]
+        : [];
+}
+/** 변환된 argv를 대응하는 명령 실행 함수로 라우팅한다. */
+async function runToolCommand(dependencies, argv) {
+    switch (argv[0]) {
+        case 'check':
+            return runCheckCommand(argv, dependencies.readTextFile, dependencies.writeTextFile, undefined, dependencies.producerVersion);
+        case 'query':
+            return runQueryCommand(argv, dependencies.readTextFile);
+        case 'graph':
+            return runGraphCommand(argv, dependencies.readTextFile);
+        case 'diff':
+            return runDiffCommand(argv, dependencies.readTextFile);
+        case 'impact':
+            return runImpactCommand(argv, dependencies.readTextFile);
+        case 'preflight':
+            return runPreflightCommand(argv, dependencies.readTextFile);
+        case 'retentions':
+            return dependencies.producerVersion === undefined
+                ? {
+                    standardOutput: '',
+                    standardError: 'Unable to read package metadata.\n',
+                    exitCode: 2,
+                }
+                : runRetentionsCommand(argv, dependencies.readTextFile, () => new Date(), dependencies.producerVersion);
+        default:
+            return {
+                standardOutput: '',
+                standardError: 'Unknown command.\n',
+                exitCode: 64,
+            };
+    }
+}
+/**
+ * 명령 결과를 MCP 도구 응답으로 옮긴다.
+ *
+ * stdout에 보고서 문서가 있으면 도구는 일을 한 것이므로 isError를 세지 않는다 —
+ * query notFound(64)나 check strict(1)의 정답 문서를 프로토콜 오류로 보내면
+ * 소비자가 한계와 조사 결과를 놓친다. 문서가 없는 실패(usage 64·internal 2)만
+ * isError로 표시하고 stderr를 함께 실어 원인을 남긴다.
+ */
+function commandResultContent(result) {
+    const content = [];
+    if (result.standardOutput.length > 0) {
+        content.push({ type: 'text', text: result.standardOutput });
+    }
+    if (result.standardError.length > 0) {
+        content.push({ type: 'text', text: result.standardError });
+    }
+    if (content.length === 0) {
+        content.push({ type: 'text', text: '(no output)\n' });
+    }
+    return {
+        content,
+        // 종료 코드 2는 항상 내부 오류다 — 부분 stdout이 있어도 도구 오류로 표시한다.
+        // 1/64는 문서가 있으면 정답(조사 결과·notFound)이고, 문서 없는 실패만 오류다.
+        isError: result.exitCode === 2
+            || (result.exitCode !== 0 && result.standardOutput.length === 0),
+    };
+}
+function errorResponse(id, code, message) {
+    return {
+        jsonrpc: '2.0',
+        id: id ?? null,
+        error: { code, message },
+    };
+}
+//# sourceMappingURL=mcp-server.js.map