@bimatrix-aud-platform/aud_mcp_server 1.1.52 → 1.1.56

package/dist/utils/mtsd-file-ref.js

@@ -0,0 +1,174 @@
+/**
+ * MTSD/SC 파일 경로 참조 유틸리티
+ *
+ * 로컬 .mtsd/.sc 파일에서 인라인 스크립트/SQL을 파일 경로 참조로 대체하고,
+ * 서버 전송 시 파일 경로를 실제 콘텐츠로 복원하는 기능을 제공합니다.
+ *
+ * report-publisher.ts 에서 사용합니다.
+ */
+import { readFileSync, existsSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+/**
+ * 값이 파일 경로 참조인지 판별합니다.
+ * - "./"로 시작하고 줄바꿈이 없으면 파일 경로로 판별
+ * - SQL/JS/암호화 문자열은 "./"로 시작하지 않으므로 오판 없음
+ */
+export function isFilePath(value) {
+    if (!value || typeof value !== "string") {
+        return false;
+    }
+    return value.startsWith("./") && !value.includes("\n");
+}
+/**
+ * ReportModel의 인라인 콘텐츠를 파일 경로 참조로 치환합니다.
+ * Pull/Save 응답을 로컬 .mtsd에 저장할 때 사용합니다.
+ *
+ * @param reportModel 서버에서 받은 전체 ReportModel (인라인 콘텐츠 포함)
+ * @param reportFolder 보고서 폴더 절대 경로 (.mtsd이 있는 폴더)
+ * @param reportCode 보고서 코드 (스크립트 파일명 탐색용)
+ * @returns 파일 경로 참조가 적용된 deep clone
+ */
+export function replaceContentWithFilePaths(reportModel, reportFolder, reportCode) {
+    const model = JSON.parse(JSON.stringify(reportModel));
+    // 1. ScriptText → 파일 경로
+    if (model.ScriptText && typeof model.ScriptText === "string" && model.ScriptText.trim().length > 0) {
+        const scriptFile = findScriptFile(reportFolder);
+        if (scriptFile) {
+            model.ScriptText = "./" + scriptFile;
+        }
+    }
+    // 2. ServerScriptText[] → 파일 경로
+    if (model.ServerScriptText && Array.isArray(model.ServerScriptText)) {
+        for (const ss of model.ServerScriptText) {
+            if (ss.ScriptText && typeof ss.ScriptText === "string" && ss.ScriptText.trim().length > 0) {
+                const ssFile = findServerScriptFile(reportFolder, ss.Name);
+                if (ssFile) {
+                    ss.ScriptText = "./" + ssFile;
+                }
+            }
+        }
+    }
+    // 3. DataSources.Datas[] → 파일 경로
+    if (model.DataSources?.Datas && Array.isArray(model.DataSources.Datas)) {
+        for (const ds of model.DataSources.Datas) {
+            if (ds.SQL && typeof ds.SQL === "string" && ds.SQL.trim().length > 0) {
+                const dsFile = findDataSourceFile(reportFolder, ds.Name);
+                if (dsFile) {
+                    ds.SQL = "./" + dsFile;
+                }
+            }
+        }
+    }
+    return model;
+}
+/**
+ * ReportModel의 파일 경로 참조를 실제 파일 콘텐츠로 복원합니다.
+ * UploadReport(ZIP 빌드) 시 서버에 전송하기 전에 사용합니다.
+ * 인라인 콘텐츠(파일 경로가 아닌 값)는 그대로 유지됩니다.
+ *
+ * .ts 파일 경로인 경우 빌드된 .js를 outputFolder에서 읽습니다.
+ * .sql, .js, .json 파일은 소스 폴더에서 직접 읽습니다.
+ *
+ * @param reportModel 파일 경로 참조가 포함된 ReportModel
+ * @param reportFolder 보고서 소스 폴더 절대 경로
+ * @param outputFolder 빌드 출력 폴더 절대 경로 (.ts → .js 매핑용)
+ * @returns 인라인 콘텐츠가 복원된 deep clone
+ */
+export function resolveFilePathsToContent(reportModel, reportFolder, outputFolder) {
+    const model = JSON.parse(JSON.stringify(reportModel));
+    // 1. ScriptText — .script.ts → 빌드된 .script.js 읽기
+    if (isFilePath(model.ScriptText)) {
+        model.ScriptText = readResolvedFile(model.ScriptText, reportFolder, outputFolder);
+    }
+    // 2. ServerScriptText[]
+    if (model.ServerScriptText && Array.isArray(model.ServerScriptText)) {
+        for (const ss of model.ServerScriptText) {
+            if (isFilePath(ss.ScriptText)) {
+                ss.ScriptText = readResolvedFile(ss.ScriptText, reportFolder, outputFolder);
+            }
+        }
+    }
+    // 3. DataSources.Datas[]
+    if (model.DataSources?.Datas && Array.isArray(model.DataSources.Datas)) {
+        for (const ds of model.DataSources.Datas) {
+            if (isFilePath(ds.SQL)) {
+                ds.SQL = readResolvedFile(ds.SQL, reportFolder, outputFolder);
+            }
+        }
+    }
+    return model;
+}
+/**
+ * 파일 경로 참조에서 실제 콘텐츠를 읽습니다.
+ * .ts 파일이면 outputFolder의 빌드된 .js를 읽고,
+ * 그 외(.sql, .js, .json 등)는 소스 폴더에서 직접 읽습니다.
+ */
+function readResolvedFile(refPath, reportFolder, outputFolder) {
+    if (refPath.toLowerCase().endsWith(".ts")) {
+        // .ts → 빌드 출력 폴더의 .js 파일 읽기
+        const jsRefPath = refPath.replace(/\.ts$/i, ".js");
+        const builtPath = resolve(outputFolder, jsRefPath);
+        if (existsSync(builtPath)) {
+            return readFileSync(builtPath, "utf-8");
+        }
+        // 빌드 파일이 없으면 에러
+        throw new Error(`빌드된 파일을 찾을 수 없습니다: ${jsRefPath}\n`
+            + `경로: ${builtPath}\n`
+            + "tsc 명령어로 빌드를 실행해 주세요.");
+    }
+    // .sql, .js, .json 등은 소스 폴더에서 직접 읽기
+    const fullPath = resolve(reportFolder, refPath);
+    if (!existsSync(fullPath)) {
+        throw new Error(`참조된 파일을 찾을 수 없습니다: ${refPath}\n경로: ${fullPath}`);
+    }
+    return readFileSync(fullPath, "utf-8");
+}
+// ─── 내부 헬퍼 함수 ────────────────────────────────────────
+/** 보고서 폴더에서 .script.ts 또는 .script.js 파일을 찾습니다 */
+function findScriptFile(reportFolder) {
+    if (!existsSync(reportFolder)) {
+        return null;
+    }
+    const files = readdirSync(reportFolder);
+    for (const f of files) {
+        const lower = f.toLowerCase();
+        if (lower.endsWith(".script.ts") || lower.endsWith(".script.js")) {
+            return f;
+        }
+    }
+    return null;
+}
+/** ServerScript 폴더에서 해당 이름의 파일을 찾습니다 (.ts → .js → .json 우선순위) */
+function findServerScriptFile(reportFolder, scriptName) {
+    const ssFolder = join(reportFolder, "ServerScript");
+    if (!existsSync(ssFolder)) {
+        return null;
+    }
+    const safeName = sanitizeFileName(scriptName);
+    for (const ext of [".ts", ".js", ".json"]) {
+        const candidate = join(ssFolder, safeName + ext);
+        if (existsSync(candidate)) {
+            return "ServerScript/" + safeName + ext;
+        }
+    }
+    return null;
+}
+/** DataSource 폴더에서 해당 이름의 파일을 찾습니다 (.sql → .ts → .js 우선순위) */
+function findDataSourceFile(reportFolder, dsName) {
+    const dsFolder = join(reportFolder, "DataSource");
+    if (!existsSync(dsFolder)) {
+        return null;
+    }
+    const safeName = sanitizeFileName(dsName);
+    for (const ext of [".sql", ".SQL", ".ts", ".js"]) {
+        const candidate = join(dsFolder, safeName + ext);
+        if (existsSync(candidate)) {
+            return "DataSource/" + safeName + ext;
+        }
+    }
+    return null;
+}
+/** 파일명에서 Windows 금지 문자를 제거합니다 */
+function sanitizeFileName(fileName) {
+    return fileName.replace(/[\\\/:*?"<>|]/g, "_");
+}

package/dist/utils/report-publisher.d.ts

@@ -10,11 +10,6 @@
  *   - ISaveReportModel 조립
  *   - 서버 응답으로 로컬 파일 업데이트
  */
-export interface AudJson {
-    ReportCode: string;
-    ReportName?: string;
-    ModuleCode?: string;
-}
 export interface DataSourceItem {
     Id?: string;
     Name: string;
@@ -45,9 +40,7 @@ export declare function sanitizeFileName(fileName: string): string;
  * outDir 기반으로 source → output 경로를 계산합니다.
  */
 export declare function resolveOutputPath(reportPath: string, sourcePath?: string): string;
-/** .aud.json 읽기 */
-export declare function readAudJson(reportPath: string): AudJson;
-/** .mtsd 또는 .sc 파일 읽기 */
+/** 보고서 문서 파일 읽기 (.design.json → .mtsd → .sc 우선순위) */
 export declare function readReportDocument(reportPath: string): any;
 /**
  * DataSource 파일 수집
@@ -89,7 +82,6 @@ export declare function writeReportResponse(reportPath: string, response: any):
  * Extension의 writeReportInfo() + writeAudJson() 로직 재구현 (Pull 용)
  *
  * writeReportResponse와의 차이점:
- *   1. .aud.json에 FolderCode, DocumentVersion, Description, ModifyDate, Modifier 추가 반영
  *   2. JScript 파일이 없으면 서버에서 받은 JScript로 .script.js 생성
  */
 export declare function writePullResponse(reportPath: string, response: any): string[];

package/dist/utils/report-publisher.js

@@ -12,6 +12,7 @@
  */
 import { readFileSync, existsSync, readdirSync, writeFileSync, mkdirSync } from "fs";
 import { join, parse, resolve, dirname, extname, basename } from "path";
+import { replaceContentWithFilePaths } from "./mtsd-file-ref.js";
 // ─── Utility ───────────────────────────────────────────────
 /** Windows 금지 문자를 _ 로 치환 */
 export function sanitizeFileName(fileName) {
@@ -96,27 +97,24 @@ export function resolveOutputPath(reportPath, sourcePath) {
     return join(resolvedOut, relativePart);
 }
 // ─── File Readers ──────────────────────────────────────────
-/** .aud.json 읽기 */
-export function readAudJson(reportPath) {
-    const configPath = join(reportPath, ".aud.json");
-    if (!existsSync(configPath)) {
-        throw new Error(`.aud.json 파일을 찾을 수 없습니다.\n경로: ${reportPath}`);
-    }
-    const text = readFileSync(configPath, "utf-8");
-    return JSON.parse(text);
-}
-/** .mtsd 또는 .sc 파일 읽기 */
+/** 보고서 문서 파일 읽기 (.design.json → .mtsd → .sc 우선순위) */
 export function readReportDocument(reportPath) {
+    // 1순위: .design.json (고정 파일명)
+    const designPath = join(reportPath, ".design.json");
+    if (existsSync(designPath)) {
+        const text = readFileSync(designPath, "utf-8");
+        return JSON.parse(text);
+    }
+    // 2순위: .mtsd, .sc
     const files = readdirSync(reportPath);
     for (const f of files) {
         const lower = f.toLowerCase();
         if (lower.endsWith(".mtsd") || lower.endsWith(".sc")) {
-            const filePath = join(reportPath, f);
-            const text = readFileSync(filePath, "utf-8");
+            const text = readFileSync(join(reportPath, f), "utf-8");
             return JSON.parse(text);
         }
     }
-    throw new Error("보고서 파일(.mtsd 또는 .sc)을 찾을 수 없습니다.");
+    throw new Error("보고서 파일(.design.json, .mtsd 또는 .sc)을 찾을 수 없습니다.");
 }
 /**
  * DataSource 파일 수집
@@ -303,13 +301,15 @@ export function detectDeletedServerScripts(srcPath, outPath, reportDoc) {
  */
 export function buildSaveModel(reportPath) {
     const resolvedPath = resolve(reportPath);
-    // 1. .aud.json 읽기
-    const audJson = readAudJson(resolvedPath);
-    if (!audJson.ReportCode) {
-        throw new Error(".aud.json에 ReportCode가 없습니다.");
-    }
-    // 2. MTSD 문서 읽기
+    // 1. 보고서 문서 읽기 (.design.json → .mtsd → .sc)
     const reportDoc = readReportDocument(resolvedPath);
+    const repInfo = reportDoc?.ReportInfo;
+    if (!repInfo?.ReportCode) {
+        throw new Error("보고서 문서에 ReportInfo.ReportCode가 없습니다.");
+    }
+    // 2. ModuleCode: ReportInfo.SavePath 확장자로 판별 (.sc → "SC", .mtsd → "SD")
+    const savePath = (repInfo.SavePath || "").toLowerCase();
+    const moduleCode = savePath.endsWith(".sc") ? "SC" : "SD";
     // 3. .out 경로 해석
     const outPath = resolveOutputPath(resolvedPath);
     // 4. 파일 수집
@@ -321,9 +321,9 @@ export function buildSaveModel(reportPath) {
     const deletedSS = detectDeletedServerScripts(resolvedPath, outPath, reportDoc);
     // 6. 모델 조립
     return {
-        REPORT_CODE: audJson.ReportCode,
-        MODULE_CODE: audJson.ModuleCode || "",
-        REPORT_NAME: audJson.ReportName || reportDoc?.ReportInfo?.ReportName || audJson.ReportCode,
+        REPORT_CODE: repInfo.ReportCode,
+        MODULE_CODE: moduleCode,
+        REPORT_NAME: repInfo.ReportName || repInfo.ReportCode,
         JScript: jScript,
         DataSource: dataSources,
         ServerScript: serverScripts,
@@ -341,10 +341,10 @@ export function buildSaveModel(reportPath) {
 export function writeReportResponse(reportPath, response) {
     const resolvedPath = resolve(reportPath);
     const written = [];
-    // 1. MTSD 파일 갱신
+    // 1. mtsd 경로 결정 (MTSD 쓰기는 모든 파일 생성 후 수행)
+    let mtsdPath = "";
     if (response.ReportModel) {
         const files = readdirSync(resolvedPath);
-        let mtsdPath = "";
         for (const f of files) {
             const lower = f.toLowerCase();
             if (lower.endsWith(".mtsd") || lower.endsWith(".sc")) {
@@ -357,19 +357,6 @@ export function writeReportResponse(reportPath, response) {
             const ext = moduleCode === "SC" ? ".sc" : ".mtsd";
             mtsdPath = join(resolvedPath, (response.REPORT_CODE || "report") + ext);
         }
-        writeFileSync(mtsdPath, JSON.stringify(response.ReportModel, null, "  "), "utf-8");
-        written.push(mtsdPath);
-        // .aud.json 업데이트
-        const audJsonPath = join(resolvedPath, ".aud.json");
-        if (existsSync(audJsonPath)) {
-            const audJson = JSON.parse(readFileSync(audJsonPath, "utf-8"));
-            audJson.ReportCode = response.REPORT_CODE || audJson.ReportCode;
-            if (response.REPORT_NAME)
-                audJson.ReportName = response.REPORT_NAME;
-            if (response.MODULE_CODE)
-                audJson.ModuleCode = response.MODULE_CODE;
-            writeFileSync(audJsonPath, JSON.stringify(audJson, null, "  "), "utf-8");
-        }
     }
     // 2. 새 DataSource 파일 생성 (이미 존재하면 skip)
     if (response.DataSource && response.DataSource.length > 0) {
@@ -399,6 +386,17 @@ export function writeReportResponse(reportPath, response) {
             }
         }
     }
+    // 4. 모든 파일 생성 후 .mtsd + .design.json 저장
+    if (response.ReportModel && mtsdPath) {
+        // .mtsd — 서버 원본 그대로 저장
+        writeFileSync(mtsdPath, JSON.stringify(response.ReportModel, null, "  "), "utf-8");
+        written.push(mtsdPath);
+        // .design.json — 파일 경로 참조 버전 저장 (AI/개발용)
+        const designModel = replaceContentWithFilePaths(response.ReportModel, resolvedPath, response.REPORT_CODE || "");
+        const designPath = join(resolvedPath, ".design.json");
+        writeFileSync(designPath, JSON.stringify(designModel, null, "  "), "utf-8");
+        written.push(designPath);
+    }
     return written;
 }
 // ─── Pull Response Writer ──────────────────────────────────
@@ -407,16 +405,15 @@ export function writeReportResponse(reportPath, response) {
  * Extension의 writeReportInfo() + writeAudJson() 로직 재구현 (Pull 용)
  *
  * writeReportResponse와의 차이점:
- *   1. .aud.json에 FolderCode, DocumentVersion, Description, ModifyDate, Modifier 추가 반영
  *   2. JScript 파일이 없으면 서버에서 받은 JScript로 .script.js 생성
  */
 export function writePullResponse(reportPath, response) {
     const resolvedPath = resolve(reportPath);
     const written = [];
-    // 1. MTSD 파일 갱신
+    // 1. mtsd 경로 결정 (MTSD 쓰기는 모든 파일 생성 후 수행)
+    let mtsdPath = "";
     if (response.ReportModel) {
         const files = readdirSync(resolvedPath);
-        let mtsdPath = "";
         for (const f of files) {
             const lower = f.toLowerCase();
             if (lower.endsWith(".mtsd") || lower.endsWith(".sc")) {
@@ -429,25 +426,6 @@ export function writePullResponse(reportPath, response) {
             const ext = moduleCode === "SC" ? ".sc" : ".mtsd";
             mtsdPath = join(resolvedPath, (response.REPORT_CODE || "report") + ext);
         }
-        writeFileSync(mtsdPath, JSON.stringify(response.ReportModel, null, "  "), "utf-8");
-        written.push(mtsdPath);
-        // .aud.json 업데이트 (Pull은 서버 ReportInfo의 모든 메타데이터 반영)
-        const audJsonPath = join(resolvedPath, ".aud.json");
-        const repInfo = response.ReportModel?.ReportInfo;
-        if (repInfo) {
-            const audJson = {
-                ReportCode: response.REPORT_CODE || "",
-                ReportName: repInfo.ReportName || "",
-                FolderCode: repInfo.FolderCode || "",
-                ModuleCode: response.MODULE_CODE || "",
-                DocumentVersion: repInfo.DocumentVersion || "",
-                Description: repInfo.Description || "",
-                ModifyDate: repInfo.EditDate || "",
-                Modifier: repInfo.Editor || "",
-            };
-            writeFileSync(audJsonPath, JSON.stringify(audJson, null, "  "), "utf-8");
-            written.push(audJsonPath);
-        }
     }
     // 2. 새 DataSource 파일 생성 (이미 존재하면 skip)
     if (response.DataSource && response.DataSource.length > 0) {
@@ -492,6 +470,17 @@ export function writePullResponse(reportPath, response) {
         writeFileSync(scriptPath, response.JScript, "utf-8");
         written.push(scriptPath);
     }
+    // 5. 모든 파일 생성 후 .mtsd + .design.json 저장
+    if (response.ReportModel && mtsdPath) {
+        // .mtsd — 서버 원본 그대로 저장
+        writeFileSync(mtsdPath, JSON.stringify(response.ReportModel, null, "  "), "utf-8");
+        written.push(mtsdPath);
+        // .design.json — 파일 경로 참조 버전 저장 (AI/개발용)
+        const designModel = replaceContentWithFilePaths(response.ReportModel, resolvedPath, response.REPORT_CODE || "");
+        const designPath = join(resolvedPath, ".design.json");
+        writeFileSync(designPath, JSON.stringify(designModel, null, "  "), "utf-8");
+        written.push(designPath);
+    }
     return written;
 }
 // ─── Helpers (private) ─────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bimatrix-aud-platform/aud_mcp_server",
-  "version": "1.1.52",
+  "version": "1.1.56",
   "description": "MCP Server for i-AUD MTSD document validation, generation, schema querying, control info extraction, and database operations",
   "type": "module",
   "main": "dist/index.js",

package/schemas/mtsd.interface.ts

@@ -15,9 +15,9 @@ export interface IMTSDDocument {
   ReportInfo: IReportInfo;
   /** 보고서에서 사용하는 데이터소스 목록 */
   DataSources: IDataSources;
-  /** 클라이언트에서 실행되는 JavaScript 코드 (이벤트 핸들러 포함) */
+  /** 클라이언트에서 실행되는 JavaScript 코드. 로컬 .mtsd에서는 상대 경로 참조(예: "./report.script.ts")가 될 수 있음 */
   ScriptText: string;
-  /** 서버에서 실행되는 JavaScript 코드 배열 */
+  /** 서버에서 실행되는 JavaScript 코드 배열. 각 항목의 ScriptText가 로컬에서 상대 경로(예: "./ServerScript/@name.ts")가 될 수 있음 */
   ServerScriptText: IServerScript[];
   /** 화면 양식(탭) 목록 */
   Forms: IForm[];
@@ -117,7 +117,7 @@ export interface IDataSource {
   Encrypted:  boolean;
   /** 데이터소스 타입 (0:메타 템플릿,1:메타 쿼리, 2:일반 SQL,3:OLAP Drill to Detail,4:공통데이터소스,5:메타 필터) */
   DSType: number;
-  /** 실행할 SQL 쿼리문 */
+  /** 실행할 SQL 쿼리문. 로컬 .mtsd에서는 상대 경로 참조(예: "./DataSource/name.sql")가 될 수 있음 */
   SQL: string;
   /** SQL 파라미터 배열 */
   Params: IDataSourceParam[];
@@ -160,7 +160,7 @@ export interface IServerScript {
   Key: string;
   /** 스크립트 암호화 여부 */
   Encrypted: boolean;
-  /** 스크립트 본문 (JavaScript 코드) */
+  /** 스크립트 본문 (JavaScript 코드). 로컬 .mtsd에서는 상대 경로 참조(예: "./ServerScript/@name.ts")가 될 수 있음 */
   ScriptText: string;
 }
 

package/schemas/mtsd.schema.json

@@ -8,7 +8,7 @@
   "properties": {
     "ReportInfo": { "$ref": "#/$defs/ReportInfo" },
     "DataSources": { "$ref": "#/$defs/DataSources" },
-    "ScriptText": { "type": "string", "description": "클라이언트에서 실행되는 JavaScript 코드" },
+    "ScriptText": { "type": "string", "description": "클라이언트에서 실행되는 JavaScript 코드. 로컬에서는 상대 경로 참조(예: ./report.script.ts)가 될 수 있음" },
     "ServerScriptText": {
       "type": "array",
       "items": { "$ref": "#/$defs/ServerScript" },
@@ -107,7 +107,7 @@
         "ConnectionCode": { "type": "string", "description": "연결된 DB 커넥션 코드" },
         "Encrypted": { "type": "boolean", "description": "SQL 쿼리 암호화 여부" },
         "DSType": { "type": "integer", "enum": [0, 1, 2, 3,4,5], "description": "데이터소스 타입 (0:메타 템플릿,1:메타 쿼리, 2:일반 SQL,3:OLAP Drill to Detail,4:공통데이터소스,5:메타 필터)" },
-        "SQL": { "type": "string", "description": "실행할 SQL 쿼리문" },
+        "SQL": { "type": "string", "description": "실행할 SQL 쿼리문. 로컬에서는 상대 경로 참조(예: ./DataSource/name.sql)가 될 수 있음" },
         "Params": {
           "type": "array",
           "items": { "$ref": "#/$defs/DataSourceParam" }
@@ -144,7 +144,7 @@
         "Name": { "type": "string", "description": "스크립트명" },
         "Key": { "type": "string", "description": "스크립트 키 (고유 식별자)" },
         "Encrypted": { "type": "boolean", "description": "스크립트 암호화 여부" },
-        "ScriptText": { "type": "string", "description": "스크립트 본문 (JavaScript 코드)" }
+        "ScriptText": { "type": "string", "description": "스크립트 본문 (JavaScript 코드). 로컬에서는 상대 경로 참조(예: ./ServerScript/@name.ts)가 될 수 있음" }
       }
     },
     "Form": {