@mandujs/core 0.18.12 → 0.18.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/core",
-  "version": "0.18.12",
+  "version": "0.18.14",
   "description": "Mandu Framework Core - Spec, Generator, Guard, Runtime",
   "type": "module",
   "main": "./src/index.ts",

package/src/guard/negotiation.ts

@@ -37,6 +37,13 @@ export interface NegotiationRequest {
   /** 구현하려는 기능의 의도 */
   intent: string;
 
+  /**
+   * 영문 feature name slug (에이전트가 제공).
+   * 제공되면 extractFeatureName()을 건너뛰고 이 값을 그대로 사용.
+   * 예: "chat", "user-auth", "payment", "file-upload"
+   */
+  featureName?: string;
+
   /** 요구사항 목록 */
   requirements?: string[];
 
@@ -1010,30 +1017,49 @@ function toCamelCase(str: string): string {
     .replace(/^(.)/, (_, c) => c.toLowerCase());
 }
 
+/** 에이전트 제공 slug 정리: lowercase kebab-case, 빈 문자열이면 falsy */
+function sanitizeSlug(slug: string | undefined): string {
+  if (!slug) return "";
+  return slug
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, "-")
+    .replace(/[^a-z0-9-]/g, "")
+    .replace(/-{2,}/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+/**
+ * intent에서 feature name 추출 (featureName 미제공 시 fallback)
+ *
+ * MCP 에이전트는 항상 featureName을 영문으로 제공하므로,
+ * 이 함수는 CLI/프로그래밍 직접 호출 시 fallback으로만 사용.
+ */
 function extractFeatureName(intent: string): string {
-  // 한글/영문에서 핵심 명사 추출 시도
-  const patterns = [
-    /(?:추가|구현|만들)(?:어|해)[줘요]?\s*[:\-]?\s*(.+)/,
-    /(.+?)\s*(?:기능|시스템|모듈)/,
-    /(?:add|implement|create)\s+(.+)/i,
+  // 1. 영문 패턴 추출
+  const englishPatterns = [
+    /(?:add|implement|create|build)\s+(.+)/i,
+    /(.+?)\s+(?:feature|system|module|service)/i,
   ];
 
-  for (const pattern of patterns) {
+  for (const pattern of englishPatterns) {
     const match = intent.match(pattern);
     if (match) {
-      return match[1]
+      const slug = match[1]
         .trim()
         .toLowerCase()
         .replace(/\s+/g, "-")
-        .replace(/[^a-z0-9-]/g, "");
+        .replace(/[^a-z0-9-]/g, "")
+        .replace(/^-+|-+$/g, "");
+      if (slug) return slug;
     }
   }
 
-  // 기본값: 첫 단어
-  return intent
-    .split(/\s+/)[0]
-    .toLowerCase()
-    .replace(/[^a-z0-9]/g, "") || "feature";
+  // 2. intent 내 영문 단어 추출
+  const englishWord = intent.match(/[a-z][a-z0-9-]{2,}/i)?.[0]?.toLowerCase();
+  if (englishWord) return englishWord;
+
+  return "feature";
 }
 
 /**
@@ -1131,8 +1157,8 @@ export async function negotiate(
   // 1. 카테고리 감지
   const category = request.category || detectCategory(intent);
 
-  // 2. 기능 이름 추출
-  const featureName = extractFeatureName(intent);
+  // 2. 기능 이름: 에이전트 제공 값 우선, 없으면 자동 추출
+  const featureName = sanitizeSlug(request.featureName) || extractFeatureName(intent);
 
   // 3. 관련 결정 검색
   const categoryTags = CATEGORY_KEYWORDS[category] || [];