@c4a/mcp-client 0.3.7-beta.2 → 0.3.8-beta.1

package/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// @bun
+import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
@@ -26,7 +26,7 @@ var __export = (target, all) => {
       set: (newValue) => all[name2] = () => newValue
     });
 };
-var __require = import.meta.require;
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../node_modules/.bun/ajv@8.17.1/node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS((exports) => {
@@ -7517,7 +7517,7 @@ var require_constants = __commonJS((exports, module2) => {
     CHAR_LEFT_SQUARE_BRACKET: "[",
     CHAR_LINE_FEED: `
 `,
-    CHAR_NO_BREAK_SPACE: "\xA0",
+    CHAR_NO_BREAK_SPACE: " ",
     CHAR_PERCENT: "%",
     CHAR_PLUS: "+",
     CHAR_QUESTION_MARK: "?",
@@ -18989,17 +18989,17 @@ m2: ${this.mapper2.__debugToString().split(`
         }
         let BoxCharacter;
         ((BoxCharacter2) => {
-          BoxCharacter2["lr"] = "\u2500";
-          BoxCharacter2["ud"] = "\u2502";
-          BoxCharacter2["dr"] = "\u256D";
-          BoxCharacter2["dl"] = "\u256E";
-          BoxCharacter2["ul"] = "\u256F";
-          BoxCharacter2["ur"] = "\u2570";
-          BoxCharacter2["udr"] = "\u251C";
-          BoxCharacter2["udl"] = "\u2524";
-          BoxCharacter2["dlr"] = "\u252C";
-          BoxCharacter2["ulr"] = "\u2534";
-          BoxCharacter2["udlr"] = "\u256B";
+          BoxCharacter2["lr"] = "─";
+          BoxCharacter2["ud"] = "│";
+          BoxCharacter2["dr"] = "╭";
+          BoxCharacter2["dl"] = "╮";
+          BoxCharacter2["ul"] = "╯";
+          BoxCharacter2["ur"] = "╰";
+          BoxCharacter2["udr"] = "├";
+          BoxCharacter2["udl"] = "┤";
+          BoxCharacter2["dlr"] = "┬";
+          BoxCharacter2["ulr"] = "┴";
+          BoxCharacter2["udlr"] = "╫";
         })(BoxCharacter || (BoxCharacter = {}));
         let Connection;
         ((Connection2) => {
@@ -19250,7 +19250,7 @@ m2: ${this.mapper2.__debugToString().split(`
           for (let column = 0;column < columnCount; column++) {
             for (let lane = 0;lane < lanes.length; lane++) {
               const connector = connectors[column][lane];
-              const fill2 = connector & 4 ? "\u2500" : " ";
+              const fill2 = connector & 4 ? "─" : " ";
               const node = grid[column][lane];
               if (!node) {
                 if (column < columnCount - 1) {
@@ -19264,7 +19264,7 @@ m2: ${this.mapper2.__debugToString().split(`
                 }
               }
               writeLane(lane, getBoxCharacter(connector));
-              writeLane(lane, connector & 8 && column < columnCount - 1 && !grid[column + 1][lane] ? "\u2500" : " ");
+              writeLane(lane, connector & 8 && column < columnCount - 1 && !grid[column + 1][lane] ? "─" : " ");
             }
           }
           return `
@@ -19278,27 +19278,27 @@ ${lanes.join(`
         function getBoxCharacter(connector) {
           switch (connector) {
             case 3:
-              return "\u2502";
+              return "│";
             case 12:
-              return "\u2500";
+              return "─";
             case 5:
-              return "\u256F";
+              return "╯";
             case 9:
-              return "\u2570";
+              return "╰";
             case 6:
-              return "\u256E";
+              return "╮";
             case 10:
-              return "\u256D";
+              return "╭";
             case 7:
-              return "\u2524";
+              return "┤";
             case 11:
-              return "\u251C";
+              return "├";
             case 13:
-              return "\u2534";
+              return "┴";
             case 14:
-              return "\u252C";
+              return "┬";
             case 15:
-              return "\u256B";
+              return "╫";
           }
           return " ";
         }
@@ -26364,7 +26364,7 @@ ${lanes.join(`
         Object.defineProperty(scanner2, "__debugShowCurrentPositionInText", {
           get: () => {
             const text2 = scanner2.getText();
-            return text2.slice(0, scanner2.getTokenFullStart()) + "\u2551" + text2.slice(scanner2.getTokenFullStart());
+            return text2.slice(0, scanner2.getTokenFullStart()) + "║" + text2.slice(scanner2.getTokenFullStart());
           }
         });
       }
@@ -33868,7 +33868,7 @@ ${lanes.join(`
       "`": "\\`",
       "\u2028": "\\u2028",
       "\u2029": "\\u2029",
-      "\x85": "\\u0085",
+      "…": "\\u0085",
       "\r\n": "\\r\\n"
     }));
     function encodeUtf16EscapeSequence(charCode) {
@@ -127698,7 +127698,7 @@ ${lanes.join(`
       return contains(screenStartingMessageCodes, diagnostic.code) ? newLine + newLine : newLine;
     }
     function getLocaleTimeString(system) {
-      return !system.now ? (/* @__PURE__ */ new Date()).toLocaleTimeString() : system.now().toLocaleTimeString("en-US", { timeZone: "UTC" }).replace("\u202F", " ");
+      return !system.now ? (/* @__PURE__ */ new Date()).toLocaleTimeString() : system.now().toLocaleTimeString("en-US", { timeZone: "UTC" }).replace(" ", " ");
     }
     function createWatchStatusReporter(system, pretty) {
       return pretty ? (diagnostic, newLine, options) => {
@@ -186770,15 +186770,15 @@ var require_errors2 = __commonJS((exports) => {
     let lineStr = src.substring(lc.lineStarts[line - 1], lc.lineStarts[line]).replace(/[\n\r]+$/, "");
     if (ci >= 60 && lineStr.length > 80) {
       const trimStart = Math.min(ci - 39, lineStr.length - 79);
-      lineStr = "\u2026" + lineStr.substring(trimStart);
+      lineStr = "…" + lineStr.substring(trimStart);
       ci -= trimStart - 1;
     }
     if (lineStr.length > 80)
-      lineStr = lineStr.substring(0, 79) + "\u2026";
+      lineStr = lineStr.substring(0, 79) + "…";
     if (line > 1 && /^ *$/.test(lineStr.substring(0, ci))) {
       let prev = src.substring(lc.lineStarts[line - 2], lc.lineStarts[line - 1]);
       if (prev.length > 80)
-        prev = prev.substring(0, 79) + `\u2026
+        prev = prev.substring(0, 79) + `…
 `;
       lineStr = prev + lineStr;
     }
@@ -187833,8 +187833,8 @@ var require_resolve_flow_scalar = __commonJS((exports) => {
     r: "\r",
     t: "\t",
     v: "\v",
-    N: "\x85",
-    _: "\xA0",
+    N: "…",
+    _: " ",
     L: "\u2028",
     P: "\u2029",
     " ": " ",
@@ -188105,7 +188105,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors4 = require_errors2();
+  var errors5 = require_errors2();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -188156,9 +188156,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors5.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors4.YAMLParseError(pos, code, message));
+          this.errors.push(new errors5.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -188242,7 +188242,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error2 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error2 = new errors5.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error2);
           else
@@ -188252,7 +188252,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors5.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -188267,7 +188267,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors5.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -188293,7 +188293,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors4 = require_errors2();
+  var errors5 = require_errors2();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -188302,7 +188302,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors5.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -190164,7 +190164,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors4 = require_errors2();
+  var errors5 = require_errors2();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -190181,8 +190181,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors5.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors5.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -190197,13 +190197,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors5.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors5.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors5.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -190255,7 +190255,7 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/@modelcontextprotocol+sdk@1.25.1+fde825ba4efdc684/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
-import process2 from "process";
+import process2 from "node:process";
 
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v4/core/core.js
 var NEVER = Object.freeze({
@@ -203178,11 +203178,11 @@ var ContractInputSchema = exports_external.object({
 
 // ../extract/src/extract-interfaces.ts
 var import_fast_glob = __toESM(require_out4(), 1);
-import { stat as stat2 } from "fs/promises";
+import { stat as stat2 } from "node:fs/promises";
 
 // ../extract/src/parsers/codeParser.ts
-import { readFile } from "fs/promises";
-import { extname as extname2 } from "path";
+import { readFile } from "node:fs/promises";
+import { extname as extname2 } from "node:path";
 
 // ../extract/src/parsers/astBuilder.ts
 function buildSimplifiedAST(content, analysis, maxDepth) {
@@ -203301,12 +203301,12 @@ function calculateMetrics(content, interfaces, functions, imports, exports) {
 
 // ../extract/src/parsers/treeSitter.ts
 var import_web_tree_sitter = __toESM(require_tree_sitter(), 1);
-import { existsSync } from "fs";
-import { stat } from "fs/promises";
-import { createRequire } from "module";
-import { dirname, join } from "path";
-import { fileURLToPath } from "url";
-var require2 = createRequire(import.meta.url);
+import { existsSync } from "node:fs";
+import { stat } from "node:fs/promises";
+import { createRequire as createRequire2 } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+var require2 = createRequire2(import.meta.url);
 var initPromise2 = null;
 var languageCache = new Map;
 async function parseWithTreeSitter(languageKey, wasmFileName, content) {
@@ -203372,7 +203372,7 @@ async function resolveLanguageWasm(languageKey, wasmFileName) {
       return candidate;
     } catch {}
   }
-  throw new Error(`WASM not found for ${languageKey}. \u8BF7\u63D0\u4F9B ${envKey} \u6216 C4A_TREE_SITTER_WASM_DIR`);
+  throw new Error(`WASM not found for ${languageKey}. 请提供 ${envKey} 或 C4A_TREE_SITTER_WASM_DIR`);
 }
 function resolveLocalWasmDir() {
   return fileURLToPath(new URL("../../wasm", import.meta.url));
@@ -203388,7 +203388,7 @@ async function parseGo(filePath, content) {
   } catch (error2) {
     const analysis = parseGoWithRegex(filePath, content);
     analysis.warnings = [
-      `tree-sitter-go \u4E0D\u53EF\u7528\uFF0C\u5DF2\u56DE\u9000\u5230\u6B63\u5219\u89E3\u6790: ${error2 instanceof Error ? error2.message : String(error2)}`
+      `tree-sitter-go 不可用，已回退到正则解析: ${error2 instanceof Error ? error2.message : String(error2)}`
     ];
     return analysis;
   }
@@ -203791,7 +203791,7 @@ function walk(node, visit) {
 
 // ../extract/src/parsers/typescriptParser.ts
 var import_typescript = __toESM(require_typescript(), 1);
-import { extname } from "path";
+import { extname } from "node:path";
 function parseTypeScript(filePath, content) {
   const sourceFile = import_typescript.default.createSourceFile(filePath, content, import_typescript.default.ScriptTarget.Latest, true, getScriptKind(filePath));
   const imports = [];
@@ -204155,57 +204155,22 @@ async function extractAST(filePath, content, maxDepth = 10, language) {
   return buildSimplifiedAST(fileContent, analysis, maxDepth);
 }
 // ../extract/src/utils/pathGuard.ts
-import { resolve as resolve2, relative as relative2 } from "path";
-
-// ../../node_modules/.bun/yaml@2.8.2/node_modules/yaml/dist/index.js
-var composer = require_composer();
-var Document = require_Document();
-var Schema = require_Schema();
-var errors4 = require_errors2();
-var Alias = require_Alias();
-var identity = require_identity();
-var Pair = require_Pair();
-var Scalar = require_Scalar();
-var YAMLMap = require_YAMLMap();
-var YAMLSeq = require_YAMLSeq();
-var cst = require_cst();
-var lexer = require_lexer();
-var lineCounter = require_line_counter();
-var parser = require_parser();
-var publicApi = require_public_api();
-var visit = require_visit();
-var $Composer = composer.Composer;
-var $Document = Document.Document;
-var $Schema = Schema.Schema;
-var $YAMLError = errors4.YAMLError;
-var $YAMLParseError = errors4.YAMLParseError;
-var $YAMLWarning = errors4.YAMLWarning;
-var $Alias = Alias.Alias;
-var $isAlias = identity.isAlias;
-var $isCollection = identity.isCollection;
-var $isDocument = identity.isDocument;
-var $isMap = identity.isMap;
-var $isNode = identity.isNode;
-var $isPair = identity.isPair;
-var $isScalar = identity.isScalar;
-var $isSeq = identity.isSeq;
-var $Pair = Pair.Pair;
-var $Scalar = Scalar.Scalar;
-var $YAMLMap = YAMLMap.YAMLMap;
-var $YAMLSeq = YAMLSeq.YAMLSeq;
-var $Lexer = lexer.Lexer;
-var $LineCounter = lineCounter.LineCounter;
-var $Parser = parser.Parser;
-var $parse = publicApi.parse;
-var $parseAllDocuments = publicApi.parseAllDocuments;
-var $parseDocument = publicApi.parseDocument;
-var $stringify = publicApi.stringify;
-var $visit = visit.visit;
-var $visitAsync = visit.visitAsync;
-// ../core/src/utils/security.ts
-import { lstat, open, realpath } from "fs/promises";
-import { isAbsolute, relative, resolve } from "path";
+import { resolve as resolve2, relative as relative2 } from "node:path";
 
+// ../core/src/types/base.ts
+var ENTITY_TYPE_DEFS = {
+  product: { dir: "products", perspective: "business", kind: "concept", scope: null },
+  system: { dir: "systems", perspective: "technical", kind: "implementation", scope: "project" },
+  container: { dir: "containers", perspective: "technical", kind: "implementation", scope: "project" },
+  component: { dir: "components", perspective: "technical", kind: "implementation", scope: "project" },
+  process: { dir: "processes", perspective: null, kind: "concept", scope: null },
+  sor: { dir: "sors", perspective: null, kind: "concept", scope: null },
+  contract: { dir: "contracts", perspective: "technical", kind: "implementation", scope: "project" },
+  document: { dir: "documents", perspective: null, kind: null, scope: null },
+  feat: { dir: "feats", perspective: null, kind: null, scope: null }
+};
+var ENTITY_TYPE_TO_DIR = Object.fromEntries(Object.entries(ENTITY_TYPE_DEFS).map(([type, def]) => [type, def.dir]));
+var DIR_TO_ENTITY_TYPE = Object.fromEntries(Object.entries(ENTITY_TYPE_DEFS).map(([type, def]) => [def.dir, type]));
 // ../core/src/types/errors.ts
 var INPUT_ERROR_CODES = {
   MISSING_REQUIRED_FIELD: "C4A-INPUT-001",
@@ -204350,69 +204315,69 @@ var ERROR_CODE_TO_HTTP_STATUS = {
   "C4A-VISUAL-001": 500
 };
 var ERROR_MESSAGES = {
-  "C4A-INPUT-001": { zh: "\u7F3A\u5C11\u5FC5\u586B\u5B57\u6BB5", en: "Missing required field" },
-  "C4A-INPUT-002": { zh: "\u5B57\u6BB5\u683C\u5F0F\u9519\u8BEF", en: "Invalid field format" },
-  "C4A-INPUT-003": { zh: "\u5B57\u6BB5\u503C\u8D85\u51FA\u8303\u56F4", en: "Field value out of range" },
-  "C4A-INPUT-004": { zh: "\u65E0\u6548\u7684\u5B9E\u4F53\u7C7B\u578B", en: "Invalid entity type" },
-  "C4A-INPUT-005": { zh: "\u65E0\u6548\u7684 ID \u683C\u5F0F", en: "Invalid ID format" },
-  "C4A-INPUT-006": { zh: "\u8DEF\u5F84\u5FC5\u987B\u5728\u9879\u76EE\u6839\u76EE\u5F55\u5185", en: "Path must be within project root" },
-  "C4A-INPUT-007": { zh: "\u8DEF\u5F84\u5305\u542B\u975E\u6CD5\u5B57\u7B26", en: "Path contains invalid characters" },
-  "C4A-DATA-001": { zh: "\u5F15\u7528\u7684\u5B9E\u4F53\u4E0D\u5B58\u5728", en: "Referenced entity not found" },
-  "C4A-DATA-002": { zh: "\u5B9E\u4F53\u5DF2\u5B58\u5728", en: "Entity already exists" },
-  "C4A-DATA-003": { zh: "\u68C0\u6D4B\u5230\u5FAA\u73AF\u4F9D\u8D56", en: "Circular dependency detected" },
-  "C4A-DATA-004": { zh: "\u5B58\u5728\u60AC\u7A7A\u5F15\u7528", en: "Dangling reference detected" },
-  "C4A-DATA-005": { zh: "\u7248\u672C\u51B2\u7A81\uFF0C\u8BF7\u83B7\u53D6\u6700\u65B0\u7248\u672C", en: "Version conflict, please fetch latest" },
-  "C4A-DATA-006": { zh: "\u5173\u7CFB\u7C7B\u578B\u4E0D\u5339\u914D", en: "Relation type mismatch" },
-  "C4A-DATA-007": { zh: "\u8DE8\u5C42\u7EA7\u5F15\u7528\u65E0\u6548", en: "Invalid cross-scope reference" },
-  "C4A-SYS-001": { zh: "\u6570\u636E\u5E93\u8FDE\u63A5\u5931\u8D25", en: "Database connection failed" },
-  "C4A-SYS-002": { zh: "MCP \u5DE5\u5177\u8C03\u7528\u8D85\u65F6", en: "MCP tool call timeout" },
-  "C4A-SYS-003": { zh: "\u5185\u90E8\u670D\u52A1\u9519\u8BEF", en: "Internal service error" },
-  "C4A-SYS-004": { zh: "\u5411\u91CF\u641C\u7D22\u670D\u52A1\u4E0D\u53EF\u7528", en: "Vector search service unavailable" },
-  "C4A-SYS-005": { zh: "\u8FDC\u7A0B\u670D\u52A1\u4E0D\u53EF\u7528", en: "Remote service unavailable" },
-  "C4A-SYS-006": { zh: "Gateway \u8D85\u65F6", en: "Gateway timeout" },
-  "C4A-SYS-007": { zh: "\u4E0A\u6E38\u670D\u52A1\u9519\u8BEF", en: "Bad gateway" },
-  "C4A-SYS-008": { zh: "Gateway \u670D\u52A1\u4E0D\u53EF\u7528", en: "Gateway service unavailable" },
-  "C4A-SYS-009": { zh: "\u4F20\u8F93\u5C42\u9519\u8BEF", en: "Transport error" },
-  "C4A-BIZ-003": { zh: "\u4E00\u81F4\u6027\u68C0\u67E5\u5931\u8D25", en: "Consistency check failed" },
-  "C4A-BIZ-004": { zh: "\u5408\u5E76\u51B2\u7A81", en: "Merge conflict" },
-  "C4A-BIZ-005": { zh: "\u5B9E\u4F53\u88AB\u5F15\u7528\uFF0C\u65E0\u6CD5\u5220\u9664", en: "Entity is referenced, cannot delete" },
+  "C4A-INPUT-001": { zh: "缺少必填字段", en: "Missing required field" },
+  "C4A-INPUT-002": { zh: "字段格式错误", en: "Invalid field format" },
+  "C4A-INPUT-003": { zh: "字段值超出范围", en: "Field value out of range" },
+  "C4A-INPUT-004": { zh: "无效的实体类型", en: "Invalid entity type" },
+  "C4A-INPUT-005": { zh: "无效的 ID 格式", en: "Invalid ID format" },
+  "C4A-INPUT-006": { zh: "路径必须在项目根目录内", en: "Path must be within project root" },
+  "C4A-INPUT-007": { zh: "路径包含非法字符", en: "Path contains invalid characters" },
+  "C4A-DATA-001": { zh: "引用的实体不存在", en: "Referenced entity not found" },
+  "C4A-DATA-002": { zh: "实体已存在", en: "Entity already exists" },
+  "C4A-DATA-003": { zh: "检测到循环依赖", en: "Circular dependency detected" },
+  "C4A-DATA-004": { zh: "存在悬空引用", en: "Dangling reference detected" },
+  "C4A-DATA-005": { zh: "版本冲突，请获取最新版本", en: "Version conflict, please fetch latest" },
+  "C4A-DATA-006": { zh: "关系类型不匹配", en: "Relation type mismatch" },
+  "C4A-DATA-007": { zh: "跨层级引用无效", en: "Invalid cross-scope reference" },
+  "C4A-SYS-001": { zh: "数据库连接失败", en: "Database connection failed" },
+  "C4A-SYS-002": { zh: "MCP 工具调用超时", en: "MCP tool call timeout" },
+  "C4A-SYS-003": { zh: "内部服务错误", en: "Internal service error" },
+  "C4A-SYS-004": { zh: "向量搜索服务不可用", en: "Vector search service unavailable" },
+  "C4A-SYS-005": { zh: "远程服务不可用", en: "Remote service unavailable" },
+  "C4A-SYS-006": { zh: "Gateway 超时", en: "Gateway timeout" },
+  "C4A-SYS-007": { zh: "上游服务错误", en: "Bad gateway" },
+  "C4A-SYS-008": { zh: "Gateway 服务不可用", en: "Gateway service unavailable" },
+  "C4A-SYS-009": { zh: "传输层错误", en: "Transport error" },
+  "C4A-BIZ-003": { zh: "一致性检查失败", en: "Consistency check failed" },
+  "C4A-BIZ-004": { zh: "合并冲突", en: "Merge conflict" },
+  "C4A-BIZ-005": { zh: "实体被引用，无法删除", en: "Entity is referenced, cannot delete" },
   "C4A-STORE-001": {
-    zh: "\u68C0\u6D4B\u5230\u5E76\u53D1\u4FEE\u6539\uFF0C\u8BF7\u534F\u8C03\u53D8\u66F4\u8303\u56F4",
+    zh: "检测到并发修改，请协调变更范围",
     en: "Concurrent modification detected"
   },
-  "C4A-STORE-002": { zh: "\u7F3A\u5C11\u5173\u8054\u7684 ADR", en: "Missing related ADR" },
-  "C4A-STORE-003": { zh: "\u5B9E\u4F53\u88AB\u5176\u4ED6\u5B9E\u4F53\u5F15\u7528\uFF0C\u65E0\u6CD5\u5220\u9664", en: "Entity is referenced, cannot delete" },
-  "C4A-DEL-001": { zh: "\u5B9E\u4F53\u5B58\u5728\u4E0B\u6E38\u4F9D\u8D56\uFF0C\u65E0\u6CD5\u5220\u9664", en: "Entity has downstream dependencies" },
-  "C4A-PERM-001": { zh: "\u65E0\u5199\u6743\u9650", en: "No write permission" },
-  "C4A-PERM-002": { zh: "\u65E0\u6279\u51C6\u6743\u9650", en: "No approve permission" },
-  "C4A-PERM-003": { zh: "\u65E0\u8BFB\u6743\u9650", en: "No read permission" },
-  "C4A-PERM-004": { zh: "\u8BA4\u8BC1\u5931\u8D25", en: "Authentication failed" },
-  "C4A-PERM-005": { zh: "\u8DE8\u9879\u76EE\u64CD\u4F5C\u6743\u9650\u4E0D\u8DB3", en: "Insufficient cross-project permission" },
-  "C4A-MIGRATE-001": { zh: "\u7F3A\u5C11 root_id \u5B57\u6BB5", en: "Missing root_id field" },
-  "C4A-MIGRATE-002": { zh: "\u7F3A\u5C11 source_repo \u5B57\u6BB5", en: "Missing source_repo field" },
-  "C4A-MIGRATE-003": { zh: "root_id \u683C\u5F0F\u4E0D\u6B63\u786E", en: "Invalid root_id format" },
-  "C4A-MIGRATE-004": { zh: "source_repo \u683C\u5F0F\u5EFA\u8BAE\u6539\u8FDB", en: "source_repo format should be owner/repo" },
+  "C4A-STORE-002": { zh: "缺少关联的 ADR", en: "Missing related ADR" },
+  "C4A-STORE-003": { zh: "实体被其他实体引用，无法删除", en: "Entity is referenced, cannot delete" },
+  "C4A-DEL-001": { zh: "实体存在下游依赖，无法删除", en: "Entity has downstream dependencies" },
+  "C4A-PERM-001": { zh: "无写权限", en: "No write permission" },
+  "C4A-PERM-002": { zh: "无批准权限", en: "No approve permission" },
+  "C4A-PERM-003": { zh: "无读权限", en: "No read permission" },
+  "C4A-PERM-004": { zh: "认证失败", en: "Authentication failed" },
+  "C4A-PERM-005": { zh: "跨项目操作权限不足", en: "Insufficient cross-project permission" },
+  "C4A-MIGRATE-001": { zh: "缺少 root_id 字段", en: "Missing root_id field" },
+  "C4A-MIGRATE-002": { zh: "缺少 source_repo 字段", en: "Missing source_repo field" },
+  "C4A-MIGRATE-003": { zh: "root_id 格式不正确", en: "Invalid root_id format" },
+  "C4A-MIGRATE-004": { zh: "source_repo 格式建议改进", en: "source_repo format should be owner/repo" },
   "C4A-MIGRATE-005": {
-    zh: "Domain/Enterprise \u5C42\u7EA7\u4E0D\u5E94\u6709 root_id",
+    zh: "Domain/Enterprise 层级不应有 root_id",
     en: "Domain/Enterprise scope should not have root_id"
   },
   "C4A-MIGRATE-006": {
-    zh: "Domain/Enterprise \u5C42\u7EA7\u4E0D\u5E94\u6709 source_repo",
+    zh: "Domain/Enterprise 层级不应有 source_repo",
     en: "Domain/Enterprise scope should not have source_repo"
   },
   "C4A-MIGRATE-007": {
-    zh: "external \u5B9E\u4F53\u4E0D\u5E94\u6709 root_id",
+    zh: "external 实体不应有 root_id",
     en: "External entity should not have root_id"
   },
-  "C4A-MIGRATE-008": { zh: "external \u5B9E\u4F53\u7F3A\u5C11 external_url", en: "External entity missing external_url" },
-  "C4A-VERSION-002": { zh: "\u7248\u672C\u683C\u5F0F\u65E0\u6548", en: "Invalid version format" },
-  "C4A-VERSION-003": { zh: "\u7248\u672C\u4E0D\u5B58\u5728", en: "Version not found" },
-  "C4A-VERSION-004": { zh: "\u65E0\u53EF\u56DE\u9000\u7684\u6B63\u5F0F\u7248\u672C", en: "No fallback stable version" },
-  "C4A-VERSION-005": { zh: "\u4E0D\u5141\u8BB8\u624B\u52A8\u6DFB\u52A0 0.0.0", en: "Cannot manually add 0.0.0" },
-  "C4A-VERSION-010": { zh: "\u6B63\u5F0F\u7248\u4E0D\u53EF\u4FEE\u6539", en: "Stable version is write-protected" },
-  "C4A-EXTRACT-001": { zh: "Extract MCP \u5185\u90E8\u9519\u8BEF", en: "Extract MCP internal error" },
-  "C4A-QUERY-001": { zh: "Query MCP \u5185\u90E8\u9519\u8BEF", en: "Query MCP internal error" },
-  "C4A-VISUAL-001": { zh: "Visual MCP \u5185\u90E8\u9519\u8BEF", en: "Visual MCP internal error" }
+  "C4A-MIGRATE-008": { zh: "external 实体缺少 external_url", en: "External entity missing external_url" },
+  "C4A-VERSION-002": { zh: "版本格式无效", en: "Invalid version format" },
+  "C4A-VERSION-003": { zh: "版本不存在", en: "Version not found" },
+  "C4A-VERSION-004": { zh: "无可回退的正式版本", en: "No fallback stable version" },
+  "C4A-VERSION-005": { zh: "不允许手动添加 0.0.0", en: "Cannot manually add 0.0.0" },
+  "C4A-VERSION-010": { zh: "正式版不可修改", en: "Stable version is write-protected" },
+  "C4A-EXTRACT-001": { zh: "Extract MCP 内部错误", en: "Extract MCP internal error" },
+  "C4A-QUERY-001": { zh: "Query MCP 内部错误", en: "Query MCP internal error" },
+  "C4A-VISUAL-001": { zh: "Visual MCP 内部错误", en: "Visual MCP internal error" }
 };
 
 class C4AError extends Error {
@@ -204464,12 +204429,58 @@ function errorToMcpResponse(error2) {
   const message = error2 instanceof Error ? error2.message : String(error2);
   return {
     code: SYS_ERROR_CODES.INTERNAL_ERROR,
-    message: `\u5185\u90E8\u9519\u8BEF: ${message}`,
+    message: `内部错误: ${message}`,
     timestamp: new Date().toISOString()
   };
 }
-
+// ../../node_modules/.bun/yaml@2.8.2/node_modules/yaml/dist/index.js
+var composer = require_composer();
+var Document = require_Document();
+var Schema = require_Schema();
+var errors5 = require_errors2();
+var Alias = require_Alias();
+var identity = require_identity();
+var Pair = require_Pair();
+var Scalar = require_Scalar();
+var YAMLMap = require_YAMLMap();
+var YAMLSeq = require_YAMLSeq();
+var cst = require_cst();
+var lexer = require_lexer();
+var lineCounter = require_line_counter();
+var parser = require_parser();
+var publicApi = require_public_api();
+var visit = require_visit();
+var $Composer = composer.Composer;
+var $Document = Document.Document;
+var $Schema = Schema.Schema;
+var $YAMLError = errors5.YAMLError;
+var $YAMLParseError = errors5.YAMLParseError;
+var $YAMLWarning = errors5.YAMLWarning;
+var $Alias = Alias.Alias;
+var $isAlias = identity.isAlias;
+var $isCollection = identity.isCollection;
+var $isDocument = identity.isDocument;
+var $isMap = identity.isMap;
+var $isNode = identity.isNode;
+var $isPair = identity.isPair;
+var $isScalar = identity.isScalar;
+var $isSeq = identity.isSeq;
+var $Pair = Pair.Pair;
+var $Scalar = Scalar.Scalar;
+var $YAMLMap = YAMLMap.YAMLMap;
+var $YAMLSeq = YAMLSeq.YAMLSeq;
+var $Lexer = lexer.Lexer;
+var $LineCounter = lineCounter.LineCounter;
+var $Parser = parser.Parser;
+var $parse = publicApi.parse;
+var $parseAllDocuments = publicApi.parseAllDocuments;
+var $parseDocument = publicApi.parseDocument;
+var $stringify = publicApi.stringify;
+var $visit = visit.visit;
+var $visitAsync = visit.visitAsync;
 // ../core/src/utils/security.ts
+import { lstat, open, realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve } from "node:path";
 var WINDOWS_DRIVE_REGEX = /^[a-zA-Z]:[\\/]/;
 function normalizeInputPath(inputPath) {
   let normalized = inputPath.replace(/\\/g, "/");
@@ -204504,33 +204515,33 @@ async function resolveRealPathIfExists(targetPath) {
 }
 async function validatePath(inputPath, projectRoot) {
   if (!inputPath || typeof inputPath !== "string") {
-    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A");
+    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "路径不能为空");
   }
   const normalized = normalizeInputPath(inputPath);
   if (!normalized || normalized === ".") {
-    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A");
+    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "路径不能为空");
   }
   if (normalized.startsWith("/") || normalized.startsWith("//") || WINDOWS_DRIVE_REGEX.test(normalized)) {
-    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "\u4E0D\u5141\u8BB8\u7EDD\u5BF9\u8DEF\u5F84");
+    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "不允许绝对路径");
   }
   const segments = normalized.split("/");
   if (segments.includes("..")) {
-    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "\u4E0D\u5141\u8BB8\u7236\u76EE\u5F55\u5F15\u7528 (..)");
+    return buildInvalid(INPUT_ERROR_CODES.INVALID_PATH_CHARS, "不允许父目录引用 (..)");
   }
   const resolvedRoot = resolve(projectRoot);
   const resolvedPath = resolve(resolvedRoot, normalized);
   if (isOutsideRoot(resolvedRoot, resolvedPath)) {
-    return buildInvalid(INPUT_ERROR_CODES.PATH_TRAVERSAL, "\u8DEF\u5F84\u5FC5\u987B\u5728\u9879\u76EE\u6839\u76EE\u5F55\u5185");
+    return buildInvalid(INPUT_ERROR_CODES.PATH_TRAVERSAL, "路径必须在项目根目录内");
   }
   const realRoot = await realpath(resolvedRoot).catch(() => resolvedRoot);
   let realResolved = null;
   try {
     realResolved = await resolveRealPathIfExists(resolvedPath);
   } catch {
-    return buildInvalid(INPUT_ERROR_CODES.PATH_TRAVERSAL, "\u65E0\u6CD5\u89E3\u6790\u8DEF\u5F84");
+    return buildInvalid(INPUT_ERROR_CODES.PATH_TRAVERSAL, "无法解析路径");
   }
   if (realResolved && isOutsideRoot(realRoot, realResolved)) {
-    return buildInvalid(INPUT_ERROR_CODES.PATH_TRAVERSAL, "\u7B26\u53F7\u94FE\u63A5\u6307\u5411\u9879\u76EE\u5916");
+    return buildInvalid(INPUT_ERROR_CODES.PATH_TRAVERSAL, "符号链接指向项目外");
   }
   return { valid: true };
 }
@@ -204559,7 +204570,21 @@ async function resolveCodePath(inputPath) {
   const normalized = normalizeInputPath2(inputPath);
   const validation = await validatePath(normalized, root);
   if (!validation.valid) {
-    throw new Error(validation.error ?? "Invalid path");
+    throw new C4AError(SYS_ERROR_CODES.INTERNAL_ERROR, {
+      field: "path",
+      expected: "relative path within project root",
+      actual: inputPath,
+      suggestion: validation.error ?? "Invalid path",
+      recoverable_actions: [
+        {
+          action: "retry",
+          label: "改用相对路径重试",
+          params: {
+            path: "<project-relative-path>"
+          }
+        }
+      ]
+    }, `内部错误: ${validation.error ?? "Invalid path"}`);
   }
   return resolve2(root, normalized);
 }
@@ -204698,7 +204723,7 @@ function getDefaultPatterns(language) {
 }
 // ../extract/src/extract-analyze.ts
 var import_fast_glob2 = __toESM(require_out4(), 1);
-import { stat as stat3 } from "fs/promises";
+import { stat as stat3 } from "node:fs/promises";
 async function extractAnalyze(input) {
   const {
     path,
@@ -204898,7 +204923,7 @@ function isExternalDependency(source) {
   return true;
 }
 // ../extract/src/extract-ast.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile2 } from "node:fs/promises";
 async function extractAST2(input) {
   const { path, language, maxDepth = 10, nodeTypes } = input;
   const resolvedPath = await resolveCodePath(path);
@@ -204982,7 +205007,7 @@ function updateAstFile(node, filePath) {
 }
 // ../extract/src/extract-contract.ts
 var import_fast_glob3 = __toESM(require_out4(), 1);
-import { stat as stat4 } from "fs/promises";
+import { stat as stat4 } from "node:fs/promises";
 
 // ../extract/src/extract-contract-asyncapi.ts
 function generateAsyncApiContract(analyses, options) {
@@ -204990,7 +205015,7 @@ function generateAsyncApiContract(analyses, options) {
     version: version3 = "2.6.0",
     title = "Async API",
     description = "",
-    errors: errors5
+    errors: errors6
   } = options;
   const allInterfaces = [];
   const allMethods = [];
@@ -205036,7 +205061,7 @@ function generateAsyncApiContract(analyses, options) {
     content: JSON.stringify(spec, null, 2),
     endpoints,
     schemas: allInterfaces.map((iface) => iface.name),
-    errors: errors5 && errors5.length > 0 ? errors5 : undefined
+    errors: errors6 && errors6.length > 0 ? errors6 : undefined
   };
 }
 function buildAsyncApiChannels(methods) {
@@ -205106,7 +205131,7 @@ function generateOpenApiContract(analyses, options) {
     title = "API",
     description = "",
     baseUrl = "/",
-    errors: errors5
+    errors: errors6
   } = options;
   const allInterfaces = [];
   const allMethods = [];
@@ -205147,7 +205172,7 @@ function generateOpenApiContract(analyses, options) {
     content: JSON.stringify(spec, null, 2),
     endpoints,
     schemas: allInterfaces.map((iface) => iface.name),
-    errors: errors5 && errors5.length > 0 ? errors5 : undefined
+    errors: errors6 && errors6.length > 0 ? errors6 : undefined
   };
 }
 function buildOpenApiPaths(methods) {
@@ -205247,7 +205272,7 @@ function mapTypeToOpenApi2(type) {
 
 // ../extract/src/extract-contract-proto.ts
 function generateProtoContract(analyses, options) {
-  const { title = "api", errors: errors5 } = options;
+  const { title = "api", errors: errors6 } = options;
   const allInterfaces = [];
   const allMethods = [];
   for (const analysis of analyses) {
@@ -205318,7 +205343,7 @@ function generateProtoContract(analyses, options) {
 `),
     endpoints,
     schemas: allInterfaces.map((iface) => iface.name),
-    errors: errors5 && errors5.length > 0 ? errors5 : undefined
+    errors: errors6 && errors6.length > 0 ? errors6 : undefined
   };
 }
 function mapTypeToProto(type) {
@@ -205356,7 +205381,7 @@ async function extractContract(input) {
     baseUrl
   } = input;
   const resolvedPath = await resolveCodePath(path);
-  const errors5 = [];
+  const errors6 = [];
   const analyses = [];
   const pathStat = await stat4(resolvedPath);
   if (pathStat.isFile()) {
@@ -205364,14 +205389,14 @@ async function extractContract(input) {
       const analysis = await parseFile(resolvedPath);
       analysis.file = getDisplayPath(resolvedPath, resolvedPath, false);
       if (analysis.warnings) {
-        errors5.push(...analysis.warnings.map((warning) => ({
+        errors6.push(...analysis.warnings.map((warning) => ({
           file: analysis.file,
           error: `warning: ${warning}`
         })));
       }
       analyses.push(analysis);
     } catch (error2) {
-      errors5.push({
+      errors6.push({
         file: getDisplayPath(resolvedPath, resolvedPath, false),
         error: error2 instanceof Error ? error2.message : String(error2)
       });
@@ -205391,14 +205416,14 @@ async function extractContract(input) {
         const analysis = await parseFile(file, undefined, lang);
         analysis.file = getDisplayPath(file, resolvedPath, true);
         if (analysis.warnings) {
-          errors5.push(...analysis.warnings.map((warning) => ({
+          errors6.push(...analysis.warnings.map((warning) => ({
             file: analysis.file,
             error: `warning: ${warning}`
           })));
         }
         analyses.push(analysis);
       } catch (error2) {
-        errors5.push({
+        errors6.push({
           file: getDisplayPath(file, resolvedPath, true),
           error: error2 instanceof Error ? error2.message : String(error2)
         });
@@ -205412,35 +205437,21 @@ async function extractContract(input) {
         title,
         description,
         baseUrl,
-        errors: errors5
+        errors: errors6
       });
     case "asyncapi":
       return generateAsyncApiContract(analyses, {
         version: version3,
         title,
         description,
-        errors: errors5
+        errors: errors6
       });
     case "proto":
-      return generateProtoContract(analyses, { title, errors: errors5 });
+      return generateProtoContract(analyses, { title, errors: errors6 });
     default:
       throw new Error(`Unsupported format: ${format}`);
   }
 }
-// ../core/src/types/base.ts
-var ENTITY_TYPE_DEFS = {
-  product: { dir: "products", perspective: "business", kind: "concept", scope: null },
-  system: { dir: "systems", perspective: "technical", kind: "implementation", scope: "project" },
-  container: { dir: "containers", perspective: "technical", kind: "implementation", scope: "project" },
-  component: { dir: "components", perspective: "technical", kind: "implementation", scope: "project" },
-  process: { dir: "processes", perspective: null, kind: "concept", scope: null },
-  sor: { dir: "sors", perspective: null, kind: "concept", scope: null },
-  contract: { dir: "contracts", perspective: "technical", kind: "implementation", scope: "project" },
-  document: { dir: "documents", perspective: null, kind: null, scope: null },
-  feat: { dir: "feats", perspective: null, kind: null, scope: null }
-};
-var ENTITY_TYPE_TO_DIR = Object.fromEntries(Object.entries(ENTITY_TYPE_DEFS).map(([type, def]) => [type, def.dir]));
-var DIR_TO_ENTITY_TYPE = Object.fromEntries(Object.entries(ENTITY_TYPE_DEFS).map(([type, def]) => [def.dir, type]));
 // src/shared/handler.ts
 function formatSuccess(result) {
   return {
@@ -205474,12 +205485,38 @@ function buildToolHandler(handler) {
   };
 }
 
+// src/tools/extractPath.ts
+import { isAbsolute as isAbsolute2, relative as relative3, resolve as resolve3, sep } from "node:path";
+function normalizeExtractPath(inputPath) {
+  const trimmed = inputPath.trim();
+  if (!trimmed || !isAbsolute2(trimmed)) {
+    return trimmed;
+  }
+  const root = resolve3(process.env.C4A_EXTRACT_ROOT ?? process.env.C4A_CODE_ROOT ?? process.cwd());
+  const resolved = resolve3(trimmed);
+  if (resolved === root) {
+    return ".";
+  }
+  const rootPrefix = root.endsWith(sep) ? root : `${root}${sep}`;
+  if (resolved.startsWith(rootPrefix)) {
+    const relPath = relative3(root, resolved);
+    return relPath || ".";
+  }
+  return trimmed;
+}
+
 // src/tools/extract.ts
+function normalizePathArg(args2) {
+  return {
+    ...args2,
+    path: normalizeExtractPath(args2.path)
+  };
+}
 function registerExtractTools(server2) {
-  server2.tool("extract_interfaces", "\u4ECE\u4EE3\u7801\u6587\u4EF6\u4E2D\u63D0\u53D6\u63A5\u53E3\u3001\u7C7B\u578B\u3001\u7C7B\u7B49\u5B9A\u4E49", ExtractInputSchema.shape, buildToolHandler((args2) => extractInterfaces(args2)));
-  server2.tool("extract_analyze", "\u5206\u6790\u4EE3\u7801\u7ED3\u6784\u548C\u4F9D\u8D56\u5173\u7CFB", AnalyzeInputSchema.shape, buildToolHandler((args2) => extractAnalyze(args2)));
-  server2.tool("extract_ast", "\u83B7\u53D6\u4EE3\u7801\u6587\u4EF6\u7684 AST \u62BD\u8C61\u8BED\u6CD5\u6811\u7ED3\u6784", ASTInputSchema.shape, buildToolHandler((args2) => extractAST2(args2)));
-  server2.tool("extract_contract", "\u4ECE\u4EE3\u7801\u751F\u6210 API \u5951\u7EA6\uFF08OpenAPI\u3001AsyncAPI\u3001Proto\uFF09", ContractInputSchema.shape, buildToolHandler((args2) => extractContract(args2)));
+  server2.tool("extract_interfaces", "从代码文件中提取接口、类型、类等定义", ExtractInputSchema.shape, buildToolHandler((args2) => extractInterfaces(normalizePathArg(args2))));
+  server2.tool("extract_analyze", "分析代码结构和依赖关系", AnalyzeInputSchema.shape, buildToolHandler((args2) => extractAnalyze(normalizePathArg(args2))));
+  server2.tool("extract_ast", "获取代码文件的 AST 抽象语法树结构", ASTInputSchema.shape, buildToolHandler((args2) => extractAST2(normalizePathArg(args2))));
+  server2.tool("extract_contract", "从代码生成 API 契约（OpenAPI、AsyncAPI、Proto）", ContractInputSchema.shape, buildToolHandler((args2) => extractContract(normalizePathArg(args2))));
 }
 
 // src/server.ts
@@ -205502,7 +205539,7 @@ async function startStdioServer() {
 }
 async function main() {
   if (transport !== "stdio") {
-    console.error(`c4a-mcp-client \u4EC5\u652F\u6301 stdio \u6A21\u5F0F\uFF0C\u5F53\u524D MCP_TRANSPORT=${transport}`);
+    console.error(`c4a-mcp-client 仅支持 stdio 模式，当前 MCP_TRANSPORT=${transport}`);
     process.exit(1);
   }
   await startStdioServer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/mcp-client",
-  "version": "0.3.7-beta.2",
+  "version": "0.3.8-beta.1",
   "type": "module",
   "bin": {
     "c4a-mcp-client": "./index.js"