@bimatrix-aud-platform/aud_mcp_server 1.1.52 → 1.1.56

package/dist/generators/fixer.js

@@ -1,4 +1,5 @@
 import { readFileSync, writeFileSync } from "fs";
+import { randomBytes } from "crypto";
 import { createDefaultOlapField, isNumericColumnType } from "./olap-field.js";
 /**
  * MTSD 파일을 읽고, 자동 보정 규칙을 적용한 뒤, 파일을 덮어씁니다.
@@ -60,6 +61,8 @@ export function fixMtsd(filePath) {
     fixEnumAndRangeValues(doc, datas, fixes);
     // Rule 4: Tab > TabItems 내 ChildElements → Controls 노드 이름 보정
     fixTabItemChildElements(doc, fixes);
+    // Rule 5: ServerScriptText Key 누락 보정
+    fixServerScriptKey(doc, fixes);
     // Rule (disabled): DataSource Params에 Value 누락 보정
     //fixParamsMissingValue(datas, fixes);
     // Rule 4: DataSource Columns에 Type 누락 보정
@@ -710,6 +713,28 @@ function fixTabItemChildElements(doc, fixes) {
         walk(elements, "");
     }
 }
+// ---- Rule 5: ServerScriptText Key 누락 보정 ----
+// Key가 없으면: Name이 @로 시작하면 Name을 그대로 Key로, 아니면 UUID 생성
+function fixServerScriptKey(doc, fixes) {
+    const scripts = doc.ServerScriptText;
+    if (!scripts || !Array.isArray(scripts))
+        return;
+    for (let i = 0; i < scripts.length; i++) {
+        const script = scripts[i];
+        if (script.Key)
+            continue; // Key가 이미 있으면 스킵
+        const name = script.Name || "";
+        if (name.startsWith("@")) {
+            script.Key = name;
+            fixes.push(`[Rule5] ServerScriptText[${i}]("${name}"): Key 누락 → Name "${name}" 사용`);
+        }
+        else {
+            const uuid = randomBytes(16).toString("hex").toUpperCase();
+            script.Key = uuid;
+            fixes.push(`[Rule5] ServerScriptText[${i}]("${name}"): Key 누락 → UUID "${uuid}" 생성`);
+        }
+    }
+}
 // ---- 유틸: Element 트리 순회 ----
 function walkElements(elements, callback, parentPath = "") {
     for (const el of elements) {

package/dist/index.js

@@ -16,7 +16,7 @@ import { generateOlapFields } from "./generators/olap-field.js";
 import { executeMtsdScript } from "./generators/mtsd-builder.js";
 import { generateId } from "./utils/uuid.js";
 import { callSchemaService, callDbmsList, callBoxStyleService, callBoxStyleSaveService, callSaveReportService, callReadReportService, downloadReportResources, getAudConfig, isAudConfigured, setWorkspaceRoots, callModuleService } from "./utils/aud-api-client.js";
-import { buildSaveModel, writeReportResponse, writePullResponse } from "./utils/report-publisher.js";
+import { buildSaveModel, writeReportResponse, writePullResponse, readReportDocument } from "./utils/report-publisher.js";
 import { execSync, execFile } from "child_process";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -549,13 +549,13 @@ const tools = [
     },
     {
         name: "fix_mtsd",
-        description: "MTSD 파일을 읽어 자동 보정 규칙을 적용하고 파일을 덮어씁니다. [Rule1] DataSource Name→Id 참조 보정, [Rule2] OlapGrid DataSource 기반 Fields 자동 생성, [Rule2-2] OlapGrid Fields 내 CreateType=1 중복 보정 (#MEASURES_HEADER#만 허용), [Rule3] Enum/Range 값 범위 초과 보정 (Border.LineType, Font 정렬, Color RGBA clamp, GridColumn 속성, OlapField 속성 등), Params ParamType 누락 보정을 수행합니다.",
+        description: "MTSD 문서 파일(.design.json, .mtsd, .sc)을 읽어 자동 보정 규칙을 적용하고 파일을 덮어씁니다. [Rule1] DataSource Name→Id 참조 보정, [Rule2] OlapGrid DataSource 기반 Fields 자동 생성, [Rule2-2] OlapGrid Fields 내 CreateType=1 중복 보정 (#MEASURES_HEADER#만 허용), [Rule3] Enum/Range 값 범위 초과 보정 (Border.LineType, Font 정렬, Color RGBA clamp, GridColumn 속성, OlapField 속성 등), Params ParamType 누락 보정을 수행합니다.",
         inputSchema: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "MTSD 파일의 전체 경로 (예: C:/reports/sample/sample.mtsd)",
+                    description: "MTSD 문서 파일의 전체 경로 (.design.json 우선, 예: C:/reports/sample/sample.design.json)",
                 },
             },
             required: ["path"],
@@ -833,13 +833,13 @@ const tools = [
     // ── i-AUD Save Report (Publish) Tool ──────────────
     {
         name: "save_report",
-        description: "보고서를 i-AUD 서버에 저장(Publish)합니다. 보고서 폴더의 MTSD, DataSource, ServerScript, JScript를 수집하여 서버에 전송하고 응답으로 로컬 파일을 업데이트합니다.",
+        description: "보고서를 i-AUD 서버에 저장(Publish)합니다. 보고서 폴더의 MTSD(.design.json 또는 .mtsd), DataSource, ServerScript, JScript를 수집하여 서버에 전송하고 응답으로 .mtsd(서버 원본) 및 .design.json(개발용 파일 경로 참조) 파일을 갱신합니다. .design.json이 없는 보고서에서 실행하면 자동 생성됩니다.",
         inputSchema: {
             type: "object",
             properties: {
                 reportPath: {
                     type: "string",
-                    description: "보고서 폴더 경로 (.aud.json이 있는 폴더)",
+                    description: "보고서 폴더 경로 (.design.json 또는 .mtsd 파일이 있는 폴더)",
                 },
                 build: {
                     type: "boolean",
@@ -853,13 +853,13 @@ const tools = [
     // ── i-AUD Pull Report (서버→로컬 동기화) Tool ──────────────
     {
         name: "pull_report",
-        description: "i-AUD 서버에서 보고서의 최신 내용을 가져옵니다. 서버의 MTSD, DataSource, ServerScript, JScript를 로컬 폴더에 동기화합니다.",
+        description: "i-AUD 서버에서 보고서의 최신 내용을 가져옵니다. 서버의 MTSD, DataSource, ServerScript, JScript를 로컬 폴더에 동기화하고, .mtsd(서버 원본) 및 .design.json(개발용 파일 경로 참조)을 생성/갱신합니다. .design.json이 없는 보고서에서 실행하면 자동 생성됩니다.",
         inputSchema: {
             type: "object",
             properties: {
                 reportPath: {
                     type: "string",
-                    description: "보고서 폴더 경로 (.aud.json이 있는 폴더)",
+                    description: "보고서 폴더 경로 (.design.json 또는 .mtsd 파일이 있는 폴더)",
                 },
             },
             required: ["reportPath"],
@@ -874,7 +874,7 @@ const tools = [
             properties: {
                 reportPath: {
                     type: "string",
-                    description: "보고서 폴더 경로 (.aud.json이 있는 폴더)",
+                    description: "보고서 폴더 경로 (.design.json 또는 .mtsd 파일이 있는 폴더)",
                 },
             },
             required: ["reportPath"],
@@ -883,7 +883,7 @@ const tools = [
     // ── MTSD Builder Script Executor Tool ──────────────
     {
         name: "build_mtsd",
-        description: "MtsdBuilder Fluent API를 사용하는 JavaScript 스크립트를 실행하여 MTSD 문서를 생성합니다. AI가 JS 스크립트를 작성하면, 이 도구가 실행하여 스키마를 준수하는 완전한 MTSD JSON을 반환합니다.",
+        description: "MtsdBuilder Fluent API를 사용하는 JavaScript 스크립트를 실행하여 MTSD 문서(화면 UI 디자인)를 생성합니다. AI가 JS 스크립트를 작성하면, 이 도구가 실행하여 스키마를 준수하는 완전한 MTSD JSON을 반환합니다. 반환된 JSON은 .design.json 파일로 저장합니다.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2014,17 +2014,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             }],
                     };
                 }
-                // .aud.json 존재 확인
-                const audJsonPath = join(reportPath, ".aud.json");
+                // 보고서 문서 존재 확인
                 try {
-                    readFileSync(audJsonPath, "utf-8");
+                    readReportDocument(reportPath);
                 }
                 catch {
                     return {
                         content: [{
                                 type: "text",
                                 text: JSON.stringify({
-                                    error: `보고서 폴더에 .aud.json 파일이 없습니다: ${audJsonPath}`,
+                                    error: `보고서 폴더에 문서 파일(.design.json, .mtsd, .sc)이 없습니다: ${reportPath}`,
                                 }),
                             }],
                     };
@@ -2110,29 +2109,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             }],
                     };
                 }
-                // .aud.json 존재 확인 및 ReportCode 읽기
-                const audJsonPath = join(reportPath, ".aud.json");
-                let audJson;
+                // 보고서 문서에서 ReportCode 읽기
+                let reportDoc;
                 try {
-                    audJson = JSON.parse(readFileSync(audJsonPath, "utf-8"));
+                    reportDoc = readReportDocument(reportPath);
                 }
                 catch {
                     return {
                         content: [{
                                 type: "text",
                                 text: JSON.stringify({
-                                    error: `보고서 폴더에 .aud.json 파일이 없습니다: ${audJsonPath}`,
+                                    error: `보고서 폴더에 문서 파일(.design.json, .mtsd, .sc)이 없습니다: ${reportPath}`,
                                 }),
                             }],
                     };
                 }
-                const reportCode = audJson.ReportCode;
+                const reportCode = reportDoc?.ReportInfo?.ReportCode;
                 if (!reportCode) {
                     return {
                         content: [{
                                 type: "text",
                                 text: JSON.stringify({
-                                    error: ".aud.json에 ReportCode가 없습니다.",
+                                    error: "보고서 문서에 ReportInfo.ReportCode가 없습니다.",
                                 }),
                             }],
                     };
@@ -2166,7 +2164,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (resModel.MX_GRID_ZIP_PATH) {
                     mxGridFiles = await downloadReportResources(reportPath, resModel.MX_GRID_ZIP_PATH);
                 }
-                const reportName = resModel.ReportModel?.ReportInfo?.ReportName || audJson.ReportName || "";
+                const reportName = resModel.ReportModel?.ReportInfo?.ReportName || reportDoc?.ReportInfo?.ReportName || "";
                 return {
                     content: [{
                             type: "text",
@@ -2199,26 +2197,25 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             }],
                     };
                 }
-                // .aud.json 읽기
-                const audJsonPath = join(reportPath, ".aud.json");
-                let audJson;
+                // 보고서 문서에서 ReportCode 읽기
+                let runDoc;
                 try {
-                    audJson = JSON.parse(readFileSync(audJsonPath, "utf-8"));
+                    runDoc = readReportDocument(reportPath);
                 }
                 catch {
                     return {
                         content: [{
                                 type: "text",
-                                text: JSON.stringify({ error: `보고서 폴더에 .aud.json 파일이 없습니다: ${audJsonPath}` }),
+                                text: JSON.stringify({ error: `보고서 폴더에 문서 파일(.design.json, .mtsd, .sc)이 없습니다: ${reportPath}` }),
                             }],
                     };
                 }
-                const reportCode = audJson.ReportCode;
+                const reportCode = runDoc?.ReportInfo?.ReportCode;
                 if (!reportCode) {
                     return {
                         content: [{
                                 type: "text",
-                                text: JSON.stringify({ error: ".aud.json에 ReportCode가 없습니다." }),
+                                text: JSON.stringify({ error: "보고서 문서에 ReportInfo.ReportCode가 없습니다." }),
                             }],
                     };
                 }
@@ -2293,7 +2290,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                                 success: true,
                                 message: `${browserName} 브라우저에서 Designer를 실행했습니다.`,
                                 reportCode,
-                                reportName: audJson.ReportName || "",
+                                reportName: runDoc?.ReportInfo?.ReportName || "",
                                 url: designerUrl,
                             }, null, 2),
                         }],